Testing Commands#
Testing Commands.
Modules#
Enumerations#
Test packet types supported by the stack.
Test PHY types.
Functions#
Macros#
Enumeration Documentation#
sl_bt_test_packet_type_t#
sl_bt_test_packet_type_t
Test packet types supported by the stack.
Enumerator | |
---|---|
sl_bt_test_pkt_prbs9 | (0x0) PRBS9 packet payload |
sl_bt_test_pkt_11110000 | (0x1) 11110000 packet payload |
sl_bt_test_pkt_10101010 | (0x2) 10101010 packet payload |
sl_bt_test_pkt_11111111 | (0x4) 11111111 packet payload |
sl_bt_test_pkt_00000000 | (0x5) 00000000 packet payload |
sl_bt_test_pkt_00001111 | (0x6) 00001111 packet payload |
sl_bt_test_pkt_01010101 | (0x7) 01010101 packet payload |
sl_bt_test_pkt_pn9 | (0xfd) PN9 continuously modulated output |
sl_bt_test_pkt_carrier | (0xfe) Unmodulated carrier |
9457
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_test_phy_t#
sl_bt_test_phy_t
Test PHY types.
Enumerator | |
---|---|
sl_bt_test_phy_1m | (0x1) 1M PHY |
sl_bt_test_phy_2m | (0x2) 2M PHY |
sl_bt_test_phy_125k | (0x3) 125k Coded PHY |
sl_bt_test_phy_500k | (0x4) 500k Coded PHY |
9473
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
Function Documentation#
sl_bt_test_dtm_tx_v4#
sl_status_t sl_bt_test_dtm_tx_v4 (uint8_t packet_type, uint8_t length, uint8_t channel, uint8_t phy, int8_t power_level)
[in] | packet_type | Enum sl_bt_test_packet_type_t. Packet type to transmit. Values:
|
[in] | length | Packet length in bytes
|
[in] | channel | Bluetooth channel. Channel is (F - 2402) / 2, where F is frequency in MHz.
|
[in] | phy | Enum sl_bt_test_phy_t. PHY to use. Values:
|
[in] | power_level | TX power level in unit dBm. Use specified or the nearest TX power level. The minimum -127 dBm is specified in the Bluetooth specification. However, a device may not support this low TX power. In addition, only some devices support 20 dBm TX power. Effective TX power will be limited by the global system TX power that can be set with the sl_bt_system_set_tx_power command. Values:
For continuous unmodulated carrier mode, the values are set in 0.1 dBm unit. If the value exceeds the range of power level value allowed by the device, the command will adjust the power level to the closest minimum or maximum value. |
Start a transmitter test against a separate Bluetooth tester device. When the command is processed by the radio, a sl_bt_evt_test_dtm_completed event is triggered. This event indicates whether the test started successfully.
In the transmitter test, the device sends packets continuously with a fixed interval. The type and length of each packet is set by packet_type
and length
parameters. The parameter phy
specifies which PHY is used to transmit the packets. All devices support at least 1M PHY. A special packet type, test_pkt_carrier , can be used to transmit continuous unmodulated carrier. The length field is ignored in this mode. As this command has the limitation within the value of power_level
, use of sl_bt_test_dtm_tx_cw for custom waves is recommended.
Stop the test using the sl_bt_test_dtm_end command.
Returns
Command result
Events
sl_bt_evt_test_dtm_completed - This event is received when the command is processed.
9576
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_test_dtm_tx_cw#
sl_status_t sl_bt_test_dtm_tx_cw (uint8_t packet_type, uint8_t channel, uint8_t phy, int16_t power_level)
[in] | packet_type | Enum sl_bt_test_packet_type_t. Packet type to transmit. Values:
|
[in] | channel | Bluetooth channel. Channel is (F - 2402) / 2,where F is frequency in MHz.
|
[in] | phy | Enum sl_bt_test_phy_t. PHY to use. Values:
|
[in] | power_level | TX power level. Unit: 0.1 dBm. If the value exceeds the range of power level value, allowed by the device, the command will adjust the power level to the closest minimum or maximum value. |
Start a transmitter test for a custom wave. When the command is processed by the radio, a sl_bt_evt_test_dtm_completed event is triggered. This event indicates whether the test started successfully.
In the custom wave transmitter test, the device continuously transmits the career. The parameter packet_type
specifies the packet type. The parameter phy
specifies which PHY is used to transmit the packets. All devices support at least 1M PHY.
Stop the test using the sl_bt_test_dtm_end command.
Returns
Command result
Events
sl_bt_evt_test_dtm_completed - This event is received when the command is processed.
9622
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_test_dtm_rx#
sl_status_t sl_bt_test_dtm_rx (uint8_t channel, uint8_t phy)
[in] | channel | Bluetooth channel. Channel is (F - 2402) / 2, where F is frequency in MHz.
|
[in] | phy | Enum sl_bt_test_phy_t. PHY to use. Values:
|
Start a receiver test against a separate Bluetooth tester device. When the command is processed by the radio, a sl_bt_evt_test_dtm_completed event is triggered. This event indicates whether the test started successfully.
Parameter phy
specifies which PHY is used to receive the packets. All devices support at least 1M PHY.
The test may be stopped using sl_bt_test_dtm_end command. This will trigger another sl_bt_evt_test_dtm_completed event, which carries the number of packets received during the test.
Returns
Command result
Events
sl_bt_evt_test_dtm_completed - This event is received when the command is processed.
9656
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_test_dtm_end#
sl_status_t sl_bt_test_dtm_end ()
End a transmitter or a receiver test. When the command is processed by the radio and the test has ended, a sl_bt_evt_test_dtm_completed event is triggered.
Returns
Command result
Events
sl_bt_evt_test_dtm_completed - Received when the command is processed by the radio and the test has ended.
9672
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
Macro Definition Documentation#
sl_bt_cmd_test_dtm_tx_v4_id#
#define sl_bt_cmd_test_dtm_tx_v4_idValue:
0x030e0020
9445
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_cmd_test_dtm_tx_cw_id#
#define sl_bt_cmd_test_dtm_tx_cw_idValue:
0x040e0020
9446
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_cmd_test_dtm_rx_id#
#define sl_bt_cmd_test_dtm_rx_idValue:
0x010e0020
9447
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_cmd_test_dtm_end_id#
#define sl_bt_cmd_test_dtm_end_idValue:
0x020e0020
9448
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_rsp_test_dtm_tx_v4_id#
#define sl_bt_rsp_test_dtm_tx_v4_idValue:
0x030e0020
9449
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_rsp_test_dtm_tx_cw_id#
#define sl_bt_rsp_test_dtm_tx_cw_idValue:
0x040e0020
9450
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_rsp_test_dtm_rx_id#
#define sl_bt_rsp_test_dtm_rx_idValue:
0x010e0020
9451
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h
sl_bt_rsp_test_dtm_end_id#
#define sl_bt_rsp_test_dtm_end_idValue:
0x020e0020
9452
of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h