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_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

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 *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.

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

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.

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

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.

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

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.

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

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/Apower_index_3m

Returns

  • 0 - Success Non-Zero Value - Failure

Note

  • Refer Error Codes section for common error codes Error Codes .


Definition at line 490 of file bluetooth/rsi_bt_common_apis.c

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 520 of file bluetooth/rsi_bt_common_apis.c

rsi_bt_enable_device_under_testmode#

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.

Parameters
N/A

Returns

  • 0 - Success Non-Zero Value - Failure

Note

  • Refer Error Codes section for common error codes Error Codes .


Definition at line 495 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.

Returns

  • 0 - Success Non-Zero Value - Failure

Note

  • Refer Error Codes section for common error codes Error Codes .


Definition at line 1070 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.

Returns

  • 0 - Success Non-Zero Value - Failure

Note

  • Refer Error Codes section for common error codes Error Codes .


Definition at line 1085 of file bluetooth/rsi_bt_gap_apis.c