Channel Sounding Test#

Enum sl_bt_cs_mode_t. Main mode type. Values :

• sl_bt_cs_mode_rtt (0x1): Round Trip Time (RTT) measurement

• sl_bt_cs_mode_pbr (0x2): Phase-Based Ranging (PBR) measurement

• sl_bt_cs_submode_disabled (0xff): Submode disabled for the procedure.

Enum sl_bt_cs_mode_t. Sub mode type. Values:

• sl_bt_cs_mode_rtt (0x1): Round Trip Time (RTT) measurement

• sl_bt_cs_mode_pbr (0x2): Phase-Based Ranging (PBR) measurement

• sl_bt_cs_submode_disabled (0xff): Submode disabled for the procedure.

Number of main mode steps taken from the end of the last CS subevent to be repeated at the beginning of the current CS subevent directly after the last Mode 0 step of that event.

• Range: 0 to 3

Number of calibration mode steps to be included at the beginning of the test CS subevent

• Range: 1 to 3

Enum sl_bt_cs_role_t. Role during CS procedure Values:

• sl_bt_cs_role_initiator (0x0): The device will initiate the procedure

• sl_bt_cs_role_reflector (0x1): The device will reciprocate transmission

Enum sl_bt_cs_rtt_type_t. RTT payload type used in the CS procedure Values:

• sl_bt_cs_rtt_type_aa_only (0x0): RTT Access Address (AA) only

• sl_bt_cs_rtt_type_fractional_96_bit_sounding (0x2): RTT Fractional with 96-bit Sounding Sequence

• sl_bt_cs_rtt_type_fractional_32_bit_random (0x3): RTT Fractional with 32-bit Random Sequence

• sl_bt_cs_rtt_type_fractional_64_bit_random (0x4): RTT Fractional with 64-bit Random Sequence

• sl_bt_cs_rtt_type_fractional_96_bit_random (0x5): RTT Fractional with 96-bit Random Sequence

• sl_bt_cs_rtt_type_fractional_128_bit_random (0x6): RTT Fractional with 128-bit Random Sequence

Enum sl_bt_gap_phy_t. Used PHY for CS_SYNC exchanges during a procedure Values:

• sl_bt_gap_phy_1m (0x1): 1M PHY

• sl_bt_gap_phy_2m (0x2): 2M PHY

• sl_bt_gap_phy_coded (0x4): Coded PHY, 125k (S=8) or 500k (S=2)

• sl_bt_gap_phy_any (0xff): Any PHYs the device supports

Antenna Identifier to be used for RTT packets

• Range: 1 to 4

CS subevent length in units of microseconds.

Interval between the start of two consecutive CS events. Units: 0.625 ms.

• Value: 0x0000. Single CS subevent

The maximum allowed number of subevents in the procedure.

• Value: 0x00. This parameter is ignored when determining the number of subevents in the procedure

• Range: 1 to 32

Transmit power level for the transmission. Units: dBm.

• Range: -127 to +20

• Value: 0x7E. Set transmitter to minimum transmit power level

• Value: 0x7F. Set transmitter to maximum transmit power level

Idle time in microseconds between the RTT packets

• Values: 10, 20, 30, 40, 50, 60, 80 or 145

Interlude time in microseconds between the CS tones

• Values: 10, 20, 30, 40, 50, 60, 80 or 145

Time in microseconds for frequency changes

• Values: 15, 20, 30, 40, 50, 60, 80, 100, 120 or 150

Time in microseconds for the phase measurement period of the CS tones

• Values: 10, 20 or 40

Time in microseconds for the antenna switch period of the CS tones

• Values: 0, 1, 2, 4 or 10

Antenna Configuration Index used during antenna switching

• Range: 0 to 7

Enum sl_bt_cs_companion_signal_status_t. Enable or disable status of the companion signal. Values:

• sl_bt_cs_companion_signal_status_disable (0x0): The companion signal is disabled

• sl_bt_cs_companion_signal_status_enable (0x1): The companion signal is enabled

Enum sl_bt_cs_snr_control_adjustment_t. The Signal Noise Ratio (SNR) control adjustment for the CS_SYNC transmissions of the initiator. Values:

• sl_bt_cs_snr_control_adjustment_18_db (0x0): SNR control adjustment of 18 dB

• sl_bt_cs_snr_control_adjustment_21_db (0x1): SNR control adjustment of 21 dB

• sl_bt_cs_snr_control_adjustment_24_db (0x2): SNR control adjustment of 24 dB

• sl_bt_cs_snr_control_adjustment_27_db (0x3): SNR control adjustment of 27 dB

• sl_bt_cs_snr_control_adjustment_30_db (0x4): SNR control adjustment of 30 dB

• sl_bt_cs_snr_control_adjustment_not_applied (0xff): SNR control adjustment not to be applied

Enum sl_bt_cs_snr_control_adjustment_t. The Signal Noise Ratio (SNR) control adjustment for the CS_SYNC transmissions of the reflector. Values:

• sl_bt_cs_snr_control_adjustment_18_db (0x0): SNR control adjustment of 18 dB

• sl_bt_cs_snr_control_adjustment_21_db (0x1): SNR control adjustment of 21 dB

• sl_bt_cs_snr_control_adjustment_24_db (0x2): SNR control adjustment of 24 dB

• sl_bt_cs_snr_control_adjustment_27_db (0x3): SNR control adjustment of 27 dB

• sl_bt_cs_snr_control_adjustment_30_db (0x4): SNR control adjustment of 30 dB

• sl_bt_cs_snr_control_adjustment_not_applied (0xff): SNR control adjustment not to be applied

Antenna Configuration Index used during antenna switching

• Range: 0 to 7

Number of times the channel_map field will be cycled through for non-Mode 0 steps within an CS procedure.

• Range: 1 to 255

Configuration of the parameters in override_parameters. Please refer to the Bluetooth Specification document on the HCI_CS_Test comamnd for more information on the override configuration details.

Length of data in override_parameters

Variable set of parameters. Please refer to the Bluetooth Specification document on the HCI_CS_Test comamnd for more information on the override parameters details.