CTE Transmitter#

CTE Transmitter.

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

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.

Functions#

sl_status_t
sl_bt_cte_transmitter_set_dtm_parameters(uint8_t cte_length, uint8_t cte_type, size_t switching_pattern_len, const uint8_t *switching_pattern)
sl_status_t
sl_bt_cte_transmitter_enable_connection_cte(uint8_t connection, uint8_t cte_types, size_t switching_pattern_len, const uint8_t *switching_pattern)
sl_status_t
sl_bt_cte_transmitter_disable_connection_cte(uint8_t connection)
sl_status_t
sl_bt_cte_transmitter_enable_connectionless_cte(uint8_t handle, uint8_t cte_length, uint8_t cte_type, uint8_t cte_count, size_t switching_pattern_len, const uint8_t *switching_pattern)
sl_status_t
sl_bt_cte_transmitter_enable_silabs_cte(uint8_t handle, uint8_t cte_length, uint8_t cte_type, uint8_t cte_count, size_t switching_pattern_len, const uint8_t *switching_pattern)
sl_status_t
sl_bt_cte_transmitter_disable_silabs_cte(uint8_t handle)

Macros#

Function Documentation#

sl_bt_cte_transmitter_set_dtm_parameters#

sl_status_t sl_bt_cte_transmitter_set_dtm_parameters (uint8_t cte_length, uint8_t cte_type, size_t switching_pattern_len, const uint8_t * switching_pattern)
Parameters
[in]cte_length

The length of the Constant Tone Extension in 8 us units

  • 0: No CTE

  • 0x02 to 0x14: CTE length

Default: 0 (no CTE)

[in]cte_type

CTE type

  • 0: AoA CTE

  • 1: AoD CTE with 1 us slots

  • 2: AoD CTE with 2 us slots

Default: 0

[in]switching_pattern_len

Length of data in switching_pattern

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

Set the CTE-related parameters of the LE transmitter test.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13668 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_clear_dtm_parameters#

sl_status_t sl_bt_cte_transmitter_clear_dtm_parameters ()

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

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13682 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_enable_connection_cte#

sl_status_t sl_bt_cte_transmitter_enable_connection_cte (uint8_t connection, uint8_t cte_types, size_t switching_pattern_len, const uint8_t * switching_pattern)
Parameters
[in]connection

Connection handle

[in]cte_types

CTE types. Bitmask of the following:

  • Bit 0: AoA CTE response

  • Bit 1: AoD CTE response with 1 us slots

  • Bit 2: AoD CTE response with 2 us slots

[in]switching_pattern_len

Length of data in switching_pattern

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

Enable different types of CTE responses on a connection. CTE response will be sent once requested by the peer device using the CTE Request procedure.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13702 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_disable_connection_cte#

sl_status_t sl_bt_cte_transmitter_disable_connection_cte (uint8_t connection)
Parameters
[in]connection

Connection handle

Disable CTE responses on a connection.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13716 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_enable_connectionless_cte#

sl_status_t sl_bt_cte_transmitter_enable_connectionless_cte (uint8_t handle, uint8_t cte_length, uint8_t cte_type, uint8_t cte_count, size_t switching_pattern_len, const uint8_t * switching_pattern)
Parameters
[in]handle

Periodic advertising handle

[in]cte_length

CTE length in 8 us units.

  • Range: 2 to 20

  • Time Range: 16 us to 160 us

[in]cte_type

CTE type

  • 0: AoA CTE

  • 1: AoD CTE with 1 us slots

  • 2: AoD CTE with 2 us slots

[in]cte_count

The number of CTEs to be transmitted in each periodic advertising interval

[in]switching_pattern_len

Length of data in switching_pattern

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

Start a connectionless CTE transmit. CTEs will be transmitted in periodic advertisement packets. As a result, a periodic advertising has to be started prior to this command.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13745 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_disable_connectionless_cte#

sl_status_t sl_bt_cte_transmitter_disable_connectionless_cte (uint8_t handle)
Parameters
[in]handle

Periodic advertising handle

Stop the connectionless CTE transmit.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13761 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_enable_silabs_cte#

sl_status_t sl_bt_cte_transmitter_enable_silabs_cte (uint8_t handle, uint8_t cte_length, uint8_t cte_type, uint8_t cte_count, size_t switching_pattern_len, const uint8_t * switching_pattern)
Parameters
[in]handle

Advertising handle

[in]cte_length

CTE length in 8 us units.

  • Range: 2 to 20

  • Time Range: 16 us to 160 us

[in]cte_type

CTE type

  • 0: AoA CTE

  • 1: AoD CTE with 1 us slots

  • 2: AoD CTE with 2 us slots

[in]cte_count

The number of CTEs to be transmitted in each extended advertising interval. Currently, only cte_count = 1 is supported.

[in]switching_pattern_len

Length of data in switching_pattern

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

Enable Silicon Labs CTE transmit. CTEs will be transmitted in extended advertisement packets. As a result, extended advertising has to be started prior this command.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13790 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cte_transmitter_disable_silabs_cte#

sl_status_t sl_bt_cte_transmitter_disable_silabs_cte (uint8_t handle)
Parameters
[in]handle

Advertising handle

Disable Silicon Labs CTE transmit.

Returns

  • SL_STATUS_OK if successful. Error code otherwise.


Definition at line 13806 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

Macro Definition Documentation#

sl_bt_cmd_cte_transmitter_set_dtm_parameters_id#

#define sl_bt_cmd_cte_transmitter_set_dtm_parameters_id
Value:
0x04440020

Definition at line 13623 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_clear_dtm_parameters_id#

#define sl_bt_cmd_cte_transmitter_clear_dtm_parameters_id
Value:
0x05440020

Definition at line 13624 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_enable_connection_cte_id#

#define sl_bt_cmd_cte_transmitter_enable_connection_cte_id
Value:
0x00440020

Definition at line 13625 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_disable_connection_cte_id#

#define sl_bt_cmd_cte_transmitter_disable_connection_cte_id
Value:
0x01440020

Definition at line 13626 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_enable_connectionless_cte_id#

#define sl_bt_cmd_cte_transmitter_enable_connectionless_cte_id
Value:
0x02440020

Definition at line 13627 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_disable_connectionless_cte_id#

#define sl_bt_cmd_cte_transmitter_disable_connectionless_cte_id
Value:
0x03440020

Definition at line 13628 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_enable_silabs_cte_id#

#define sl_bt_cmd_cte_transmitter_enable_silabs_cte_id
Value:
0x06440020

Definition at line 13629 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_cmd_cte_transmitter_disable_silabs_cte_id#

#define sl_bt_cmd_cte_transmitter_disable_silabs_cte_id
Value:
0x07440020

Definition at line 13630 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_set_dtm_parameters_id#

#define sl_bt_rsp_cte_transmitter_set_dtm_parameters_id
Value:
0x04440020

Definition at line 13631 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_clear_dtm_parameters_id#

#define sl_bt_rsp_cte_transmitter_clear_dtm_parameters_id
Value:
0x05440020

Definition at line 13632 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_enable_connection_cte_id#

#define sl_bt_rsp_cte_transmitter_enable_connection_cte_id
Value:
0x00440020

Definition at line 13633 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_disable_connection_cte_id#

#define sl_bt_rsp_cte_transmitter_disable_connection_cte_id
Value:
0x01440020

Definition at line 13634 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_enable_connectionless_cte_id#

#define sl_bt_rsp_cte_transmitter_enable_connectionless_cte_id
Value:
0x02440020

Definition at line 13635 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_disable_connectionless_cte_id#

#define sl_bt_rsp_cte_transmitter_disable_connectionless_cte_id
Value:
0x03440020

Definition at line 13636 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_enable_silabs_cte_id#

#define sl_bt_rsp_cte_transmitter_enable_silabs_cte_id
Value:
0x06440020

Definition at line 13637 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h

sl_bt_rsp_cte_transmitter_disable_silabs_cte_id#

#define sl_bt_rsp_cte_transmitter_disable_silabs_cte_id
Value:
0x07440020

Definition at line 13638 of file /mnt/raid/workspaces/ws.iS2YF8Lrv/overlay/gsdk/protocol/bluetooth/build/native/sw/bgapi/inc/sl_bt_api.h