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 \n 0: Expect AoA CTE \n 1: Expect AoD CTE with 1 us slots \n 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_len

Array length

[in]

switching_pattern

Antenna 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]

connection

Connection handle

[in]

interval

Measurement 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_length

Minimum CTE length requested in 8 us units.

  • Range: 0x02 to 0x14

  • Time Range: 16 us to 160 us

[in]

cte_type

Requested CTE type

  • 0: AoA CTE

  • 1: AoD CTE with 1 us slots

  • 2: AoD CTE with 2 us slots

[in]

slot_durations

Slot durations

  • 1: Switching and sampling slots are 1 us each

  • 2: Switching and sampling slots are 2 us each

[in]

switching_pattern_len

Array length

[in]

switching_pattern

Antenna 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]

connection

Connection 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]

sync

Periodic advertising synchronization handle

[in]

slot_durations

Slot 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_len

Array length

[in]

switching_pattern

Antenna 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]

sync

Periodic 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_durations

Slot 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_len

Array length

[in]

switching_pattern

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