CTE Receiver

CTE Receiver.

Modules

sl_bt_evt_cte_receiver_dtm_iq_report
IQ sample report from DTM CTE packets.
 
sl_bt_evt_cte_receiver_connection_iq_report
IQ sample report from connection CTE packets.
 
sl_bt_evt_cte_receiver_connectionless_iq_report
IQ sample report from connectionless CTE packets.
 
sl_bt_evt_cte_receiver_silabs_iq_report
IQ samples report from Silicon Labs CTE packets.
 

Functions

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)
 
sl_status_t sl_bt_cte_receiver_clear_dtm_parameters ()
 
sl_status_t sl_bt_cte_receiver_set_sync_cte_type (uint8_t sync_cte_type)
 
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)
 
sl_status_t sl_bt_cte_receiver_disable_connection_cte (uint8_t connection)
 
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)
 
sl_status_t sl_bt_cte_receiver_disable_connectionless_cte (uint16_t sync)
 
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)
 
sl_status_t sl_bt_cte_receiver_disable_silabs_cte ()
 

Detailed Description

CTE Receiver.

Commands and events in this class manage Constant Tone Extension (CTE) receiving.

CTE feature is only supported by specific devices. Commands from this class will return SL_STATUS_NOT_SUPPORTED on devices that do not support CTE.

Function Documentation

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

Parameters
[in]cte_length

Expected CTE length in 8 us units

  • 0: No CTE
  • 0x02 to 0x14: Expected CTE length

Default: 0 (no CTE)

[in]cte_type

Expected CTE type

  • 0: Expect AoA CTE
  • 1: Expect AoD CTE with 1 us slots
  • 2: Expect AoD CTE with 2 us slots

Default: 0

[in]slot_durations

Slot durations

  • 1: Switching and sampling slots are 1 us each
  • 2: Switching and sampling slots are 2 us each

Default: 1

[in]switching_pattern_lenLength of data in switching_pattern
[in]switching_patternAntenna switching pattern. Antennas will be switched in this order with the antenna switch pins during CTE. If the CTE is longer than the switching pattern, the pattern starts over. This can be an empty array if CTE is unused.
Returns
SL_STATUS_OK if successful. Error code otherwise.

Events

◆ 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. The set parameter takes effect immediately for all advertisers that have not already established synchronization.

Parameters
[in]sync_cte_type

Sync CTE type flags. This value can be a bitmask of multiple flags. Flags:

  • 1 (bit 0): Do not sync to packets with an AoA Constant Tone Extension
  • 2 (bit 1): Do not sync to packets with an AoD Constant Tone Extension with 1 us slots
  • 4 (bit 2): Do not sync to packets with an AoD Constant Tone Extension with 2 us slots
  • 8 (bit 3): Bit not used
  • 16 (bit 4): Do not sync to packets without a Constant Tone Extension

Default: 0

Returns
SL_STATUS_OK if successful. Error code otherwise.

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

Parameters
[in]connectionConnection handle
[in]intervalMeasurement interval. CTE requests may be sent less often. For example, if a connetion event is missed for some reason, the CTE request will be sent in the next connection event.
  • 0: No interval. The request is initiated only once.
  • Other values N: Initiate the request every N-th connection events
[in]cte_lengthMinimum CTE length requested in 8 us units.
  • Range: 0x02 to 0x14
  • Time Range: 16 us to 160 us
[in]cte_typeRequested CTE type
  • 0: AoA CTE
  • 1: AoD CTE with 1 us slots
  • 2: AoD CTE with 2 us slots
[in]slot_durationsSlot durations
  • 1: Switching and sampling slots are 1 us each
  • 2: Switching and sampling slots are 2 us each
[in]switching_pattern_lenLength of data in switching_pattern
[in]switching_patternAntenna switching pattern. Antennas will be switched in this order with the antenna switch pins during CTE. If the CTE is longer than the switching pattern, the pattern starts over.
Returns
SL_STATUS_OK if successful. Error code otherwise.

Events

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

Parameters
[in]connectionConnection handle
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.

Parameters
[in]syncPeriodic advertising synchronization handle
[in]slot_durationsSlot durations
  • 1: Switching and sampling slots are 1 us each
  • 2: Switching and sampling slots are 2 us each
[in]cte_count- 0: Sample and report all available CTEs
  • Other values: Maximum number of sampled CTEs in each periodic advertising interval
[in]switching_pattern_lenLength of data in switching_pattern
[in]switching_patternAntenna switching pattern. Antennas will be switched in this order with the antenna switch pins during CTE. If the CTE is longer than the switching pattern, the pattern starts over.
Returns
SL_STATUS_OK if successful. Error code otherwise.

Events

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

Parameters
[in]syncPeriodic advertising synchronization handle
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.

Parameters
[in]slot_durationsSlot durations
  • 1: Switching and sampling slots are 1 us each
  • 2: Switching and sampling slots are 2 us each
[in]cte_count- 0: Sample and report all available CTEs
  • Other values: Maximum number of sampled CTEs in each extended advertising interval
[in]switching_pattern_lenLength of data in switching_pattern
[in]switching_patternAntenna switching pattern. Antennas will be switched in this order with the antenna switch pins during CTE. If the CTE is longer than the switching pattern, the pattern starts over.
Returns
SL_STATUS_OK if successful. Error code otherwise.

Events

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