Bluetooth LE Profile API document
Bluetooth LE Profile API document Rev.1.00 [May 22, 2020]
st_ble_vs_tx_test_param_t Struct Reference

This is the extended transmitter test parameters used in R_BLE_VS_StartTxTest() . More...

Data Fields

uint8_t ch
 Channel used in Tx test. More...
 
uint8_t test_data_len
 Length(in bytes) of the packet used in Tx Test. More...
 
uint8_t packet_payload
 Packet Payload. More...
 
uint8_t phy
 Transmitter PHY used in test. More...
 
uint8_t tx_power
 Tx Power Level used in DTM Tx Test. More...
 
uint8_t option
 The test option configuration. More...
 
uint16_t num_of_packet
 The number of packet to be sent. More...
 

Detailed Description

This is the extended transmitter test parameters used in R_BLE_VS_StartTxTest() .

Field Documentation

◆ ch

uint8_t st_ble_vs_tx_test_param_t::ch

Channel used in Tx test.

ch = (Frequency - 2402) / 2
Valid range is 0x00 <= ch <= 0x27.
Frequency range is 2402 MHz to 2480 MHz.

◆ test_data_len

uint8_t st_ble_vs_tx_test_param_t::test_data_len

Length(in bytes) of the packet used in Tx Test.

Valid range is 0x00 <= test_data_len <= 0xFF.
If the transmission configuration specified by the option filed is "continuous transmission", this field is ignored.

◆ packet_payload

uint8_t st_ble_vs_tx_test_param_t::packet_payload

Packet Payload.

If the option filed is set to "non-modulation", this field is ignored.

macro description
BLE_VS_EH_TX_PL_PRBS9(0x00) PRBS9 sequence '11111111100000111101..'
BLE_VS_EH_TX_PL_11110000(0x01) Repeated '11110000'
BLE_VS_EH_TX_PL_10101010(0x02) Repeated '10101010'
BLE_VS_EH_TX_PL_PRBS15(0x03) PRBS15 sequence
BLE_VS_EH_TX_PL_11111111(0x04) Repeated '11111111'
BLE_VS_EH_TX_PL_00000000(0x05) Repeated '00000000'
BLE_VS_EH_TX_PL_00001111(0x06) Repeated '00001111'
BLE_VS_EH_TX_PL_01010101(0x07) Repeated '01010101'

◆ phy

uint8_t st_ble_vs_tx_test_param_t::phy

Transmitter PHY used in test.

If the option filed is set to "non-modulation", this field is ignored.
If the option field is configured to "modulation" and "continuous transmission", BLE_VS_EH_TEST_PHY_CODED_S_8(0x03) and BLE_VS_EH_TEST_PHY_CODED_S_2(0x04) are not supported.

macro description
BLE_VS_EH_TEST_PHY_1M(0x01) 1M PHY
BLE_VS_EH_TEST_PHY_2M(0x02) 2M PHY
BLE_VS_EH_TEST_PHY_CODED_S_8(0x03) Coded PHY (S=8)
BLE_VS_EH_TEST_PHY_CODED_S_2(0x04) Coded PHY (S=2)

◆ tx_power

uint8_t st_ble_vs_tx_test_param_t::tx_power

Tx Power Level used in DTM Tx Test.

Select one of the following.

macro description
BLE_VS_TX_POWER_HIGH(0x00) High
BLE_VS_TX_POWER_MID(0x01) Middle
BLE_VS_TX_POWER_LOW(0x02) Low

◆ option

uint8_t st_ble_vs_tx_test_param_t::option

The test option configuration.

The option field is set to a bitwise OR of the following values.

bit description
bit0 0:modulation, 1:non-modulation
bit1 0:packet transmission, 1:continuous transmission
bit2-bit7 reserved.

◆ num_of_packet

uint16_t st_ble_vs_tx_test_param_t::num_of_packet

The number of packet to be sent.

If the option field is configured to "continuous transmission", this field is ignored.
If this field is set to 0x0000, the packets are transmitted infinitely. R_BLE_VS_EndTest() stops the transmission.
Otherwise the BLE_VS_EVENT_TX_TEST_TERM event notifies that the extended transmitter test is terminated, after the number specified by this field of packets have been sent.