direction.h File Reference

Go to the source code of this file.

Data Structures
struct	bt_df_adv_cte_tx_param
	Constant Tone Extension parameters for connectionless transmission. More...
struct	bt_df_per_adv_sync_cte_rx_param
	Constant Tone Extension parameters for connectionless reception. More...
struct	bt_df_per_adv_sync_iq_samples_report

Enumerations
enum	bt_df_cte_type {   BT_DF_CTE_TYPE_NONE = 0 , BT_DF_CTE_TYPE_AOA = BIT(0) , BT_DF_CTE_TYPE_AOD_1US = BIT(1) , BT_DF_CTE_TYPE_AOD_2US = BIT(2) ,   BT_DF_CTE_TYPE_ALL = (BT_DF_CTE_TYPE_AOA | BT_DF_CTE_TYPE_AOD_1US | BT_DF_CTE_TYPE_AOD_2US) }
enum	bt_df_antenna_switching_slot { BT_DF_ANTENNA_SWITCHING_SLOT_1US = 0x1 , BT_DF_ANTENNA_SWITCHING_SLOT_2US = 0x2 }
enum	bt_df_packet_status { BT_DF_CTE_CRC_OK = 0x0 , BT_DF_CTE_CRC_ERR_CTE_BASED_TIME = 0x1 , BT_DF_CTE_CRC_ERR_CTE_BASED_OTHER = 0x2 , BT_DF_CTE_INSUFFICIENT_RESOURCES = 0xFF }

Functions
int	bt_df_set_adv_cte_tx_param (struct bt_le_ext_adv *adv, const struct bt_df_adv_cte_tx_param *params)
	Set or update the Constant Tone Extension parameters for periodic advertising set. More...
int	bt_df_adv_cte_tx_enable (struct bt_le_ext_adv *adv)
	Enable transmission of Constant Tone Extension for the given advertising set. More...
int	bt_df_adv_cte_tx_disable (struct bt_le_ext_adv *adv)
	Disable transmission of Constant Tone Extension for the given advertising set. More...
int	bt_df_per_adv_sync_cte_rx_enable (struct bt_le_per_adv_sync *sync, const struct bt_df_per_adv_sync_cte_rx_param *params)
	Enable receive and sampling of Constant Tone Extension for the given sync set. More...
int	bt_df_per_adv_sync_cte_rx_disable (struct bt_le_per_adv_sync *sync)
	Disable receive and sampling of Constant Tone Extension for the given sync set. More...

Enumeration Type Documentation

bt_df_antenna_switching_slot

enum bt_df_antenna_switching_slot

Allowed antenna switching slots: 1 us or 2 us

Enumerator
BT_DF_ANTENNA_SWITCHING_SLOT_1US
BT_DF_ANTENNA_SWITCHING_SLOT_2US

bt_df_cte_type

enum bt_df_cte_type

Constant Tone Extension (CTE) types.

Enumerator
BT_DF_CTE_TYPE_NONE	Convenience value for purposes where non of CTE types is allowed.
BT_DF_CTE_TYPE_AOA	Angle of Arrival mode. Antenna switching done on receiver site.
BT_DF_CTE_TYPE_AOD_1US	Angle of Departure mode with 1 us antenna switching slots. Antenna switching done on transmitter site.
BT_DF_CTE_TYPE_AOD_2US	Angle of Departure mode with 2 us antenna switching slots. Antenna switching done on transmitter site.
BT_DF_CTE_TYPE_ALL	Convenience value that collects all possible CTE types in one entry.

bt_df_packet_status

enum bt_df_packet_status

Possible statuses of PDU that contained reported CTE.

Enumerator
BT_DF_CTE_CRC_OK	Received PDU had CRC OK
BT_DF_CTE_CRC_ERR_CTE_BASED_TIME	Received PDU had incorrect CRC, but Radio peripheral was able to parse CTEInfo field of the PDU and process sampling of CTE.
BT_DF_CTE_CRC_ERR_CTE_BASED_OTHER	Received PDU had incorrect CRC, but Radio peripheral was able to process sampling of CTE in some other way.
BT_DF_CTE_INSUFFICIENT_RESOURCES	There were no sufficient resources to sample CTE.

Function Documentation

bt_df_adv_cte_tx_disable()

int bt_df_adv_cte_tx_disable

(

struct bt_le_ext_adv *

adv

)

Disable transmission of Constant Tone Extension for the given advertising set.

Parameters

[in]

adv

Advertising set object.

Returns

Zero on success or (negative) error code otherwise.

bt_df_adv_cte_tx_enable()

int bt_df_adv_cte_tx_enable

(

struct bt_le_ext_adv *

adv

)

Enable transmission of Constant Tone Extension for the given advertising set.

Transmission of Constant Tone Extension may be enabled only after setting periodic advertising parameters (bt_le_per_adv_set_param) and Constant Tone Extension parameters (bt_df_set_adv_cte_tx_param).

Parameters

[in]

adv

Advertising set object.

Returns

Zero on success or (negative) error code otherwise.

bt_df_per_adv_sync_cte_rx_disable()

int bt_df_per_adv_sync_cte_rx_disable

(

struct bt_le_per_adv_sync *

sync

)

Disable receive and sampling of Constant Tone Extension for the given sync set.

Parameters

sync	Periodic advertising sync object.

Returns

Zero on success or (negative) error code otherwise.

bt_df_per_adv_sync_cte_rx_enable()

int bt_df_per_adv_sync_cte_rx_enable	(	struct bt_le_per_adv_sync *	sync,
		const struct bt_df_per_adv_sync_cte_rx_param *	params
	)

Enable receive and sampling of Constant Tone Extension for the given sync set.

Receive and sampling of Constant Tone Extension may be enabled only after periodic advertising sync is established.

Parameters

sync	Periodic advertising sync object.
params	CTE receive and sampling parameters.

Returns

Zero on success or (negative) error code otherwise.

bt_df_set_adv_cte_tx_param()

int bt_df_set_adv_cte_tx_param	(	struct bt_le_ext_adv *	adv,
		const struct bt_df_adv_cte_tx_param *	params
	)

Set or update the Constant Tone Extension parameters for periodic advertising set.

Parameters

[in]	adv	Advertising set object.
[in]	params	Constant Tone Extension parameters.

Returns

Zero on success or (negative) error code otherwise.