Test Mode#

Functions#

int32_t

rsi_bt_per_stats(uint8_t cmd_type, struct rsi_bt_per_stats_s *per_stats)

Request the local device for BT PER operation.

int32_t

rsi_bt_per_cw_mode(struct rsi_bt_per_cw_mode_s *bt_cw_mode)

Keep the device in continuous wave mode.
Not necessary to be called if transmit_mode is set to 2 - CONTINUOUS_WAVE_MODE in rsi_bt_tx_per_params_s structure.

int32_t

rsi_bt_vendor_avdtp_stats_enable(uint16_t avdtp_stats_enable, uint32_t avdtp_stats_rate)

Issue vendor specific command for setting avdtp stats enable in controller, to receive the Stats.
This is a blocking API. A received event rsi_bt_on_avdtp_stats_t has AVDTP Stats.

int32_t

rsi_bt_vendor_ar_enable(uint16_t enable)

Issue vendor specific command for setting AutoRate in controller on given inputs.
This is a blocking API. A received event rsi_bt_on_ar_stats_t has AutoRate Stats.

int32_t

rsi_bt_vendor_set_hapi_rect_val(uint8_t value)

Issue vendor specific command for setting respective RECT defines in HAPI/DOTC.
This is a blocking API. The division of rect_val is as follows - BITS[7:6] - RECT selection for LR (Default value -> 0b00), BITS[5:4] - RECT selection for LE 2 Mbps (Default value -> 0b00), BITS[3:2] - RECT selection for LE 1 Mbps (Default value -> 0b00), BITS[1:0] - reserved (Default -> 0b01)

int32_t

rsi_bt_vendor_dynamic_pwr(uint16_t enable, uint8_t *remote_addr, uint8_t power_index_br, uint8_t power_index_2m, uint8_t power_index_3m)

Issue vendor specific command for setting dynamic_tx_power_index in controller on given inputs.
This is a blocking API.

int32_t

rsi_bt_vendor_set_afh_classification_intervals(uint16_t afh_min, uint16_t afh_max)

Issue vendor specific command for setting afh min and max in controller on given inputs.

int32_t

rsi_bt_enable_device_under_testmode(void)

LMP has PDUs to support different test modes used for certification and compliance testing
of the Bluetooth radio and baseband. We can activate locally (via a HW or SW interface),
or using the air interface. For activation over the air interface, entering the test mode shall be
locally enabled for security and type approval reasons. So, to keep the device in test_mode locally, will call this API.
This is a blocking API.

int32_t

rsi_bt_per_rx(uint32_t *bt_perrx)

Configure the per receive parameters in the controller and start/stop the PER.

int32_t

rsi_bt_per_tx(uint32_t *bt_pertx)

Configure the per transmit parameters in the controller and start/stop the PER.

Function Documentation#

rsi_bt_per_stats#

int32_t rsi_bt_per_stats (uint8_t cmd_type, struct rsi_bt_per_stats_s * rsi_bt_per_stats)

Request the local device for BT PER operation.

Parameters

[in]	cmd_type	- Parameter to define the command id type for PER operation. BT_PER_STATS_CMD_ID (0x08) - Command id enables PER statistics BT_TRANSMIT_CMD_ID (0x15) - Command id enables PER transmit BT_RECEIVE_CMD_ID (0x16) - Command id enables PER receive
[in]	rsi_bt_per_stats	- reference to the response structure. Please refer to rsi_bt_per_stats_s structure for more info.

Call rsi_bt_per_tx() or rsi_bt_per_rx() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 387 of file bluetooth/rsi_bt_common_apis.c

References SL_PRINTF , and rsi_bt_driver_send_cmd

rsi_bt_per_cw_mode#

int32_t rsi_bt_per_cw_mode (struct rsi_bt_per_cw_mode_s * bt_cw_mode)

Keep the device in continuous wave mode.
Not necessary to be called if transmit_mode is set to 2 - CONTINUOUS_WAVE_MODE in rsi_bt_tx_per_params_s structure.

Parameters

[in]

bt_cw_mode

- continuous wave mode information needs to filled in this structure. Please refer rsi_bt_per_cw_mode_s for more info.

Call rsi_bt_per_tx() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 404 of file bluetooth/rsi_bt_common_apis.c

References SL_PRINTF , and rsi_bt_driver_send_cmd

rsi_bt_vendor_avdtp_stats_enable#

int32_t rsi_bt_vendor_avdtp_stats_enable (uint16_t avdtp_stats_enable, uint32_t avdtp_stats_rate)

Issue vendor specific command for setting avdtp stats enable in controller, to receive the Stats.
This is a blocking API. A received event rsi_bt_on_avdtp_stats_t has AVDTP Stats.

Parameters

[in]	avdtp_stats_enable	- stats enable, Enables the AVDTP stats in Controller
[in]	avdtp_stats_rate	- stats rate, The rate for which the stats received to Host.

Call rsi_wireless_init() before calling this API.

Note

Presently stats rate is defined with 30000 milisec. This is the minimum time will be fine tunes by running all the possible modes.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 429 of file bluetooth/rsi_bt_common_apis.c

References rsi_bt_vendor_avdtp_stats_s::opcode , rsi_bt_vendor_avdtp_stats_s::avdtp_stats_enable , rsi_bt_vendor_avdtp_stats_s::avdtp_stats_rate , SL_PRINTF , and rsi_bt_driver_send_cmd

rsi_bt_vendor_ar_enable#

int32_t rsi_bt_vendor_ar_enable (uint16_t enable)

Issue vendor specific command for setting AutoRate in controller on given inputs.
This is a blocking API. A received event rsi_bt_on_ar_stats_t has AutoRate Stats.

Parameters

[in]

enable

- enables the AutoRate.

Call rsi_wireless_init() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 454 of file bluetooth/rsi_bt_common_apis.c

References rsi_bt_vendor_ar_cmd_s::opcode , rsi_bt_vendor_ar_cmd_s::ar_enable , rsi_bt_vendor_ar_cmd_s::_2m_state_continuous_pass_threshold , rsi_bt_vendor_ar_cmd_s::_2m_state_pass_threshold , rsi_bt_vendor_ar_cmd_s::_3m_state_absolute_fail_threshold , rsi_bt_vendor_ar_cmd_s::_3m_state_continuous_fail_threshold , rsi_bt_vendor_ar_cmd_s::_3m_state_relative_fail_threshold , SL_PRINTF , and rsi_bt_driver_send_cmd

rsi_bt_vendor_set_hapi_rect_val#

rsi_bt_vendor_set_hapi_rect_val (uint8_t value)

Parameters

[in]

value

- enables the respective RECT define in HAPI/DOTC.

Call rsi_wireless_init() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 488 of file bluetooth/rsi_bt_common_apis.c

References SL_PRINTF , rsi_bt_set_hapi_rect_val_s::opcode , rsi_bt_set_hapi_rect_val_s::rect_val , and rsi_bt_driver_send_cmd

rsi_bt_vendor_dynamic_pwr#

int32_t rsi_bt_vendor_dynamic_pwr (uint16_t enable, uint8_t * remote_addr, uint8_t power_index_br, uint8_t power_index_2m, uint8_t power_index_3m)

Issue vendor specific command for setting dynamic_tx_power_index in controller on given inputs.
This is a blocking API.

Parameters

[in]	enable	- Remote Device Address
[in]	remote_addr	- Power value sets to BR Mode .
[in]	power_index_br	- Power value sets to 2m Mode data rate
[in]	power_index_2m	- Power value sets to 3m Mode data rate
N/A	power_index_3m

Call rsi_wireless_init() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 518 of file bluetooth/rsi_bt_common_apis.c

References rsi_bt_vendor_dynamic_pwr_cmd_s::opcode , memcpy , rsi_bt_vendor_dynamic_pwr_cmd_s::set_dynamic_pwr_index , set_dynamic_pwr_index_s::remote_dev , set_dynamic_pwr_index_s::dynamic_pwr_index , dynamic_pwr_index_s::dynamic_power_enable , dynamic_pwr_index_s::pwr_index_br , dynamic_pwr_index_s::pwr_index_2m , dynamic_pwr_index_s::pwr_index_3m , SL_PRINTF , and rsi_bt_driver_send_cmd

rsi_bt_vendor_set_afh_classification_intervals#

int32_t rsi_bt_vendor_set_afh_classification_intervals (uint16_t afh_min, uint16_t afh_max)

Issue vendor specific command for setting afh min and max in controller on given inputs.

Parameters

[in]	afh_min	- afh minimum interval
[in]	afh_max	- afh maximum interval

Returns

0 - Success
Non-Zero Value - Failure

Definition at line 548 of file bluetooth/rsi_bt_common_apis.c

References rsi_bt_vendor_afh_classification_cmd_s::opcode , rsi_bt_vendor_afh_classification_cmd_s::afh_min , rsi_bt_vendor_afh_classification_cmd_s::afh_max , and rsi_bt_driver_send_cmd

rsi_bt_enable_device_under_testmode#

int32_t rsi_bt_enable_device_under_testmode (void )

Parameters

N/A

Call rsi_wireless_init() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 496 of file bluetooth/rsi_bt_gap_apis.c

rsi_bt_per_rx#

int32_t rsi_bt_per_rx (uint32_t * bt_perrx)

Configure the per receive parameters in the controller and start/stop the PER.

Parameters

[in]

bt_perrx

- Buffer to hold the structure values. Please Refer to rsi_bt_rx_per_params_s structure for more info.

Call rsi_wireless_init() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 1071 of file bluetooth/rsi_bt_gap_apis.c

rsi_bt_per_tx#

int32_t rsi_bt_per_tx (uint32_t * bt_pertx)

Configure the per transmit parameters in the controller and start/stop the PER.

Parameters

[in]

bt_pertx

- Buffer to hold the structure values. Please refer to rsi_bt_tx_per_params_s structure for more info.

Call rsi_wireless_init() before calling this API.

Returns

0 - Success
Non-Zero Value - Failure

Note

Refer Error Codes section for common error codes Error Codes .

Definition at line 1086 of file bluetooth/rsi_bt_gap_apis.c