Accurate Bluetooth Ranging Test#
Accurate Bluetooth Ranging Test.
This class provides optional test commands and events for ABR between Bluetooth devices.
Enumerations#
Defines tone extension for ABR test.
This defines sounding sequence marker for ABR test.
Functions#
Enumeration Documentation#
sl_bt_cs_test_tone_extension_t#
sl_bt_cs_test_tone_extension_t
Defines tone extension for ABR test.
Enumerator | |
---|---|
sl_bt_cs_test_tone_extension_both_without | (0x0) Initiator and Reflector tones sent without tone extension |
sl_bt_cs_test_tone_extension_reflector_without | (0x1) Initiator tone sent with extension; Reflector tone sent without extension |
sl_bt_cs_test_tone_extension_initiator_without | (0x2) Initiator tone sent without extension; Reflector tone sent with extension |
sl_bt_cs_test_tone_extension_both_with | (0x3) Initiator and Reflector tones sent with extension |
sl_bt_cs_test_tone_extension_round_robin | (0x4) Loop through values 0x00 to 0x03 |
13499
of file /mnt/raid/workspaces/ws.XK183xwsq/overlay/gsdk/protocol/bluetooth/build_release/bt_api/sw/bgapi/inc/sl_bt_api.h
sl_bt_cs_test_sounding_sequence_marker_t#
sl_bt_cs_test_sounding_sequence_marker_t
This defines sounding sequence marker for ABR test.
Enumerator | |
---|---|
sl_bt_cs_test_sounding_sequence_marker_1 | (0x0) Use 0b0011 as the Sounding Sequence marker |
sl_bt_cs_test_sounding_sequence_marker_2 | (0x1) Use 0b1100 as the Sounding Sequence marker |
sl_bt_cs_test_sounding_sequence_marker_round_robin | (0x2) Loop through 0b0011 and 0b1100 |
13525
of file /mnt/raid/workspaces/ws.XK183xwsq/overlay/gsdk/protocol/bluetooth/build_release/bt_api/sw/bgapi/inc/sl_bt_api.h
Function Documentation#
sl_bt_cs_test_start#
sl_status_t sl_bt_cs_test_start (uint8_t main_mode_type, uint8_t sub_mode_type, uint8_t main_mode_repetition, uint8_t mode_calibration_steps, uint8_t role, uint8_t rtt_type, uint8_t cs_sync_phy, uint8_t antenna_selection, const sl_bt_cs_subevent_length_t * subevent_len, uint16_t subevent_interval, int8_t tx_power, uint8_t t_ip1_time, uint8_t t_ip2_time, uint8_t t_fcs_time, uint8_t t_pm_time, uint8_t t_sw_time, uint8_t tone_antenna_config, uint8_t companion_signal_state, uint16_t drbg_nonce, uint16_t override_config, size_t override_parameters_len, const uint8_t * override_parameters)
[in] | main_mode_type | Enum sl_bt_cs_mode_t. Main mode type. Values :
|
[in] | sub_mode_type | Enum sl_bt_cs_mode_t. Sub mode type. Values:
|
[in] | main_mode_repetition | Number of main mode steps taken from the end of the last ABR subevent to be repeated at the beginning of the current ABR subevent directly after the last Mode 0 step of that event.
|
[in] | mode_calibration_steps | Number of calibration mode steps to be included at the beginning of the test ABR subevent
|
[in] | role | Enum sl_bt_cs_role_t. Role during ABR procedure Values:
|
[in] | rtt_type | Enum sl_bt_cs_rtt_type_t. RTT payload type used in the ABR procedure Values:
|
[in] | cs_sync_phy | Enum sl_bt_gap_phy_t. Used PHY for ABR SYNC exchanges during a procedure Values:
|
[in] | antenna_selection | Antenna Identifier to be used for RTT packets
|
[in] | subevent_len | ABR subevent length in units of microseconds. |
[in] | subevent_interval | Interval between the start of two consecutive ABR events. Units: 0.625 ms.
|
[in] | tx_power | Transmit power level for the transmission. Units: dBm.
|
[in] | t_ip1_time | Idle time in microseconds between the RTT packets
|
[in] | t_ip2_time | Interlude time in microseconds between the ABR tones
|
[in] | t_fcs_time | Time in microseconds for frequency changes
|
[in] | t_pm_time | Time in microseconds for the phase measurement period of the ABR tones
|
[in] | t_sw_time | Time in microseconds for the antenna switch period of the ABR tones
|
[in] | tone_antenna_config | Antenna Configuration Index used during antenna switching
|
[in] | companion_signal_state | Enum sl_bt_cs_companion_signal_status_t. Enable or disable status of the companion signal. Values:
|
[in] | drbg_nonce | Antenna Configuration Index used during antenna switching
|
[in] | override_config | Configuration of the parameters in override_parameters
|
[in] | override_parameters_len | Length of data in |
[in] | override_parameters | Variable set of parameters which are present dependent on the bits set in the override config parameter.
|
Start a single ABR procedure using the given configuration. The reflector must be initialized before starting the initiator. To stop an ongoing test, use the sl_bt_test_dtm_end command.
Returns
SL_STATUS_OK if successful. Error code otherwise.
Events
sl_bt_evt_cs_result - Triggered when local controller has results to report for every ABR subevent within the ABR procedure
13658
of file /mnt/raid/workspaces/ws.XK183xwsq/overlay/gsdk/protocol/bluetooth/build_release/bt_api/sw/bgapi/inc/sl_bt_api.h
Macro Definition Documentation#
sl_bt_cmd_cs_test_start_id#
#define sl_bt_cmd_cs_test_start_idValue:
0x005a0020
13493
of file /mnt/raid/workspaces/ws.XK183xwsq/overlay/gsdk/protocol/bluetooth/build_release/bt_api/sw/bgapi/inc/sl_bt_api.h
sl_bt_rsp_cs_test_start_id#
#define sl_bt_rsp_cs_test_start_idValue:
0x005a0020
13494
of file /mnt/raid/workspaces/ws.XK183xwsq/overlay/gsdk/protocol/bluetooth/build_release/bt_api/sw/bgapi/inc/sl_bt_api.h