CTE Receiver#

sl_bt_cte_receiver_set_dtm_parameters#

sl_status_t sl_bt_cte_receiver_set_dtm_parameters (uint8_t cte_length, uint8_t cte_type, uint8_t slot_durations, size_t switching_pattern_len, const uint8_t *switching_pattern)

Set CTE-related parameters of LE receiver test.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_cte_receiver_dtm_iq_report - Triggered when IQ samples have been received.

sl_bt_cte_receiver_clear_dtm_parameters#

sl_status_t sl_bt_cte_receiver_clear_dtm_parameters ()

Clear CTE-related parameters that were previously set for LE receiver test. Default values will be restored for these parameters.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_cte_receiver_set_sync_cte_type#

sl_status_t sl_bt_cte_receiver_set_sync_cte_type (uint8_t sync_cte_type)

Set the sync CTE type to limit what types of periodic advertisers to sync to when scanning for periodic advertising synchronization. The set parameter takes effect immediately for all advertisers that have not already established synchronization.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_cte_receiver_set_default_sync_receive_parameters#

sl_status_t sl_bt_cte_receiver_set_default_sync_receive_parameters (uint8_t mode, uint16_t skip, uint16_t timeout, uint8_t sync_cte_type, uint8_t reporting_mode)

Set the default parameters and the CTE type limitation for receiving Periodic Advertising Synchronization Transfers (PAST) over connections. The default parameters will be in effect for all subsequent connections and do not affect connections that have already opened. The parameters can be overridden for a specific connection using command sl_bt_cte_receiver_set_sync_receive_parameters after the connection is opened.

This command is relevant and available only when the application has included the bluetooth_feature_past_receiver component into the build. If the PAST receiver component is not included, this command returns the error SL_STATUS_NOT_AVAILABLE.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_sync_transfer_received - Triggered after synchronization transfer is received for a periodic advertising train that does not have subevents or response slots. This event is used only when the application does not include bluetooth_feature_periodic_sync or bluetooth_feature_pawr_sync components.

• sl_bt_evt_periodic_sync_transfer_received - If the application includes the bluetooth_feature_periodic_sync or bluetooth_feature_pawr_sync component, triggered after synchronization transfer is received for a periodic advertising train that does not have subevents or response slots.

• sl_bt_evt_pawr_sync_transfer_received - If the application includes the bluetooth_feature_pawr_sync component, triggered after synchronization transfer is received for a Periodic Advertising with Responses (PAwR) train.

sl_bt_cte_receiver_set_sync_receive_parameters#

sl_status_t sl_bt_cte_receiver_set_sync_receive_parameters (uint8_t connection, uint8_t mode, uint16_t skip, uint16_t timeout, uint8_t sync_cte_type, uint8_t reporting_mode)

Set the parameters and the CTE type limitation for receiving Periodic Advertising Synchronization Transfers (PAST) over the specified connection. The parameters do not affect periodic advertising trains that the device has already synchronized to.

This command is relevant and available only when the application has included the bluetooth_feature_past_receiver component into the build. If the PAST receiver component is not included, this command returns the error SL_STATUS_NOT_AVAILABLE.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_sync_transfer_received - Triggered after synchronization transfer is received for a periodic advertising train that does not have subevents or response slots. This event is used only when the application does not include bluetooth_feature_periodic_sync or bluetooth_feature_pawr_sync components.

• sl_bt_evt_periodic_sync_transfer_received - If the application includes the bluetooth_feature_periodic_sync or bluetooth_feature_pawr_sync component, triggered after synchronization transfer is received for a periodic advertising train that does not have subevents or response slots.

• sl_bt_evt_pawr_sync_transfer_received - If the application includes the bluetooth_feature_pawr_sync component, triggered after synchronization transfer is received for a Periodic Advertising with Responses (PAwR) train.

sl_bt_cte_receiver_configure#

sl_status_t sl_bt_cte_receiver_configure (uint8_t flags)

sl_bt_cte_receiver_enable_connection_cte#

sl_status_t sl_bt_cte_receiver_enable_connection_cte (uint8_t connection, uint16_t interval, uint8_t cte_length, uint8_t cte_type, uint8_t slot_durations, size_t switching_pattern_len, const uint8_t *switching_pattern)

Start IQ samplings on a connection. A CTE requests will be initiated periodically on the given connection and IQ sampling will be made on the received CTE responses.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_cte_receiver_connection_iq_report - Triggered when IQ samples have been received.

sl_bt_cte_receiver_disable_connection_cte#

sl_status_t sl_bt_cte_receiver_disable_connection_cte (uint8_t connection)

Stop the IQ sampling on a connection. CTEs will not be requested on the given connection.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_cte_receiver_enable_connectionless_cte#

sl_status_t sl_bt_cte_receiver_enable_connectionless_cte (uint16_t sync, uint8_t slot_durations, uint8_t cte_count, size_t switching_pattern_len, const uint8_t *switching_pattern)

Start IQ sampling on a periodic advertising synchronization. IQ samples are taken on each CTE found in the periodic advertisements.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_cte_receiver_connectionless_iq_report - Triggered when IQ samples have been received.

sl_bt_cte_receiver_disable_connectionless_cte#

sl_status_t sl_bt_cte_receiver_disable_connectionless_cte (uint16_t sync)

Stop IQ sampling on a periodic advertising synchronization.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_cte_receiver_enable_silabs_cte#

sl_status_t sl_bt_cte_receiver_enable_silabs_cte (uint8_t slot_durations, uint8_t cte_count, size_t switching_pattern_len, const uint8_t *switching_pattern)

Enable IQ sampling of Silicon Labs CTE found in extended advertisements.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

Events

• sl_bt_evt_cte_receiver_silabs_iq_report - Triggered when IQ samples of Silicon Labs CTE have been received.

sl_bt_cte_receiver_disable_silabs_cte#

sl_status_t sl_bt_cte_receiver_disable_silabs_cte ()

Disable IQ sampling of Silicon Labs CTE.

Returns

• SL_STATUS_OK if successful. Error code otherwise.

sl_bt_cmd_cte_receiver_set_dtm_parameters_id#

#define sl_bt_cmd_cte_receiver_set_dtm_parameters_id

0x05450020

sl_bt_cmd_cte_receiver_clear_dtm_parameters_id#

#define sl_bt_cmd_cte_receiver_clear_dtm_parameters_id

0x06450020

sl_bt_cmd_cte_receiver_set_sync_cte_type_id#

#define sl_bt_cmd_cte_receiver_set_sync_cte_type_id

0x09450020

sl_bt_cmd_cte_receiver_set_default_sync_receive_parameters_id#

#define sl_bt_cmd_cte_receiver_set_default_sync_receive_parameters_id

0x0a450020

sl_bt_cmd_cte_receiver_set_sync_receive_parameters_id#

#define sl_bt_cmd_cte_receiver_set_sync_receive_parameters_id

0x0b450020

sl_bt_cmd_cte_receiver_configure_id#

#define sl_bt_cmd_cte_receiver_configure_id

0x00450020

sl_bt_cmd_cte_receiver_enable_connection_cte_id#

#define sl_bt_cmd_cte_receiver_enable_connection_cte_id

0x01450020

sl_bt_cmd_cte_receiver_disable_connection_cte_id#

#define sl_bt_cmd_cte_receiver_disable_connection_cte_id

0x02450020

sl_bt_cmd_cte_receiver_enable_connectionless_cte_id#

#define sl_bt_cmd_cte_receiver_enable_connectionless_cte_id

0x03450020

sl_bt_cmd_cte_receiver_disable_connectionless_cte_id#

#define sl_bt_cmd_cte_receiver_disable_connectionless_cte_id

0x04450020

sl_bt_cmd_cte_receiver_enable_silabs_cte_id#

#define sl_bt_cmd_cte_receiver_enable_silabs_cte_id

0x07450020

sl_bt_cmd_cte_receiver_disable_silabs_cte_id#

#define sl_bt_cmd_cte_receiver_disable_silabs_cte_id

0x08450020

sl_bt_rsp_cte_receiver_set_dtm_parameters_id#

#define sl_bt_rsp_cte_receiver_set_dtm_parameters_id

0x05450020

sl_bt_rsp_cte_receiver_clear_dtm_parameters_id#

#define sl_bt_rsp_cte_receiver_clear_dtm_parameters_id

0x06450020

sl_bt_rsp_cte_receiver_set_sync_cte_type_id#

#define sl_bt_rsp_cte_receiver_set_sync_cte_type_id

0x09450020

sl_bt_rsp_cte_receiver_set_default_sync_receive_parameters_id#

#define sl_bt_rsp_cte_receiver_set_default_sync_receive_parameters_id

0x0a450020

sl_bt_rsp_cte_receiver_set_sync_receive_parameters_id#

#define sl_bt_rsp_cte_receiver_set_sync_receive_parameters_id

0x0b450020

sl_bt_rsp_cte_receiver_configure_id#

#define sl_bt_rsp_cte_receiver_configure_id

0x00450020

sl_bt_rsp_cte_receiver_enable_connection_cte_id#

#define sl_bt_rsp_cte_receiver_enable_connection_cte_id

0x01450020

sl_bt_rsp_cte_receiver_disable_connection_cte_id#

#define sl_bt_rsp_cte_receiver_disable_connection_cte_id

0x02450020

sl_bt_rsp_cte_receiver_enable_connectionless_cte_id#

#define sl_bt_rsp_cte_receiver_enable_connectionless_cte_id

0x03450020

sl_bt_rsp_cte_receiver_disable_connectionless_cte_id#

#define sl_bt_rsp_cte_receiver_disable_connectionless_cte_id

0x04450020

sl_bt_rsp_cte_receiver_enable_silabs_cte_id#

#define sl_bt_rsp_cte_receiver_enable_silabs_cte_id

0x07450020

sl_bt_rsp_cte_receiver_disable_silabs_cte_id#

#define sl_bt_rsp_cte_receiver_disable_silabs_cte_id

0x08450020