12#ifndef ZEPHYR_INCLUDE_BLUETOOTH_BLUETOOTH_H_
13#define ZEPHYR_INCLUDE_BLUETOOTH_BLUETOOTH_H_
73#define BT_ID_DEFAULT 0
76#define BT_IRK_SIZE 16U
84 #if defined(CONFIG_BT_LE_EXTENDED_FEAT_SET)
85 #define BT_LE_LOCAL_SUPPORTED_FEATURES_SIZE \
86 (BT_HCI_LE_BYTES_PAGE_0_FEATURE_PAGE + \
87 (CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE * BT_HCI_LE_BYTES_PER_FEATURE_PAGE))
89 #define BT_LE_LOCAL_SUPPORTED_FEATURES_SIZE BT_HCI_LE_BYTES_PAGE_0_FEATURE_PAGE
266#if defined(CONFIG_BT_PRIVACY) || defined(__DOXYGEN__)
286#if defined(CONFIG_BT_PER_ADV_RSP) || defined(__DOXYGEN__)
1072#if defined(CONFIG_BT_PER_ADV_RSP) || defined(__DOXYGEN__)
1128#define BT_LE_ADV_PARAM_INIT(_options, _int_min, _int_max, _peer) \
1130 .id = BT_ID_DEFAULT, \
1132 .secondary_max_skip = 0, \
1133 .options = (_options), \
1134 .interval_min = (_int_min), \
1135 .interval_max = (_int_max), \
1148#define BT_LE_ADV_PARAM(_options, _int_min, _int_max, _peer) \
1149 ((const struct bt_le_adv_param[]) { \
1150 BT_LE_ADV_PARAM_INIT(_options, _int_min, _int_max, _peer) \
1153#define BT_LE_ADV_CONN_DIR(_peer) BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, 0, 0, _peer)
1183#define BT_LE_ADV_CONN_FAST_1 \
1184 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_1, BT_GAP_ADV_FAST_INT_MAX_1, \
1203#define BT_LE_ADV_CONN_FAST_2 \
1204 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_2, BT_GAP_ADV_FAST_INT_MAX_2, \
1207#define BT_LE_ADV_CONN_DIR_LOW_DUTY(_peer) \
1208 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN | BT_LE_ADV_OPT_DIR_MODE_LOW_DUTY, \
1209 BT_GAP_ADV_FAST_INT_MIN_2, BT_GAP_ADV_FAST_INT_MAX_2, _peer)
1212#define BT_LE_ADV_NCONN BT_LE_ADV_PARAM(0, BT_GAP_ADV_FAST_INT_MIN_2, \
1213 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1216#define BT_LE_ADV_NCONN_IDENTITY BT_LE_ADV_PARAM(BT_LE_ADV_OPT_USE_IDENTITY, \
1217 BT_GAP_ADV_FAST_INT_MIN_2, \
1218 BT_GAP_ADV_FAST_INT_MAX_2, \
1222#define BT_LE_EXT_ADV_CONN \
1223 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_2, \
1224 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1227#define BT_LE_EXT_ADV_SCAN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1228 BT_LE_ADV_OPT_SCANNABLE, \
1229 BT_GAP_ADV_FAST_INT_MIN_2, \
1230 BT_GAP_ADV_FAST_INT_MAX_2, \
1234#define BT_LE_EXT_ADV_NCONN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV, \
1235 BT_GAP_ADV_FAST_INT_MIN_2, \
1236 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1239#define BT_LE_EXT_ADV_NCONN_IDENTITY \
1240 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1241 BT_LE_ADV_OPT_USE_IDENTITY, \
1242 BT_GAP_ADV_FAST_INT_MIN_2, \
1243 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1246#define BT_LE_EXT_ADV_CODED_NCONN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1247 BT_LE_ADV_OPT_CODED, \
1248 BT_GAP_ADV_FAST_INT_MIN_2, \
1249 BT_GAP_ADV_FAST_INT_MAX_2, \
1255#define BT_LE_EXT_ADV_CODED_NCONN_IDENTITY \
1256 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | BT_LE_ADV_OPT_CODED | \
1257 BT_LE_ADV_OPT_USE_IDENTITY, \
1258 BT_GAP_ADV_FAST_INT_MIN_2, \
1259 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1267#define BT_LE_EXT_ADV_START_PARAM_INIT(_timeout, _n_evts) \
1269 .timeout = (_timeout), \
1270 .num_events = (_n_evts), \
1279#define BT_LE_EXT_ADV_START_PARAM(_timeout, _n_evts) \
1280 ((const struct bt_le_ext_adv_start_param[]) { \
1281 BT_LE_EXT_ADV_START_PARAM_INIT((_timeout), (_n_evts)) \
1284#define BT_LE_EXT_ADV_START_DEFAULT BT_LE_EXT_ADV_START_PARAM(0, 0)
1294#define BT_LE_PER_ADV_PARAM_INIT(_int_min, _int_max, _options) \
1296 .interval_min = (_int_min), \
1297 .interval_max = (_int_max), \
1298 .options = (_options), \
1309#define BT_LE_PER_ADV_PARAM(_int_min, _int_max, _options) \
1310 ((struct bt_le_per_adv_param[]) { \
1311 BT_LE_PER_ADV_PARAM_INIT(_int_min, _int_max, _options) \
1314#define BT_LE_PER_ADV_DEFAULT BT_LE_PER_ADV_PARAM(BT_GAP_PER_ADV_SLOW_INT_MIN, \
1315 BT_GAP_PER_ADV_SLOW_INT_MAX, \
1316 BT_LE_PER_ADV_OPT_NONE)
1350 const struct bt_data *ad,
size_t ad_len,
1351 const struct bt_data *sd,
size_t sd_len);
1366 const struct bt_data *sd,
size_t sd_len);
1527 const struct bt_data *ad,
size_t ad_len,
1528 const struct bt_data *sd,
size_t sd_len);
1698 const struct bt_data *ad,
size_t ad_len);
1837#if defined(CONFIG_BT_PER_ADV_SYNC_RSP) || defined(__DOXYGEN__)
1908#if defined(CONFIG_BT_PER_ADV_SYNC_RSP) || defined(__DOXYGEN__)
2663#define BT_LE_SCAN_PARAM_INIT(_type, _options, _interval, _window) \
2666 .options = (_options), \
2667 .interval = (_interval), \
2668 .window = (_window), \
2670 .interval_coded = 0, \
2671 .window_coded = 0, \
2682#define BT_LE_SCAN_PARAM(_type, _options, _interval, _window) \
2683 ((struct bt_le_scan_param[]) { \
2684 BT_LE_SCAN_PARAM_INIT(_type, _options, _interval, _window) \
2690#define BT_LE_SCAN_ACTIVE BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2691 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2692 BT_GAP_SCAN_FAST_INTERVAL, \
2693 BT_GAP_SCAN_FAST_WINDOW)
2700#define BT_LE_SCAN_ACTIVE_CONTINUOUS BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2701 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2702 BT_GAP_SCAN_FAST_INTERVAL_MIN, \
2703 BT_GAP_SCAN_FAST_WINDOW)
2705 "Continuous scanning is requested by setting window and interval equal.");
2713#define BT_LE_SCAN_PASSIVE BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2714 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2715 BT_GAP_SCAN_FAST_INTERVAL, \
2716 BT_GAP_SCAN_FAST_WINDOW)
2724#define BT_LE_SCAN_PASSIVE_CONTINUOUS BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2725 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2726 BT_GAP_SCAN_FAST_INTERVAL_MIN, \
2727 BT_GAP_SCAN_FAST_WINDOW)
2729 "Continuous scanning is requested by setting window and interval equal.");
2735#define BT_LE_SCAN_CODED_ACTIVE \
2736 BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2737 BT_LE_SCAN_OPT_CODED | \
2738 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2739 BT_GAP_SCAN_FAST_INTERVAL, \
2740 BT_GAP_SCAN_FAST_WINDOW)
2749#define BT_LE_SCAN_CODED_PASSIVE \
2750 BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2751 BT_LE_SCAN_OPT_CODED | \
2752 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2753 BT_GAP_SCAN_FAST_INTERVAL, \
2754 BT_GAP_SCAN_FAST_WINDOW)
2931 bool (*func)(
struct bt_data *
data,
void *user_data),
Bluetooth device address definitions and utilities.
Bluetooth subsystem crypto APIs.
Bluetooth subsystem classic core APIs.
Bluetooth data types and helpers.
Bluetooth Generic Access Profile defines and Assigned Numbers.
#define BT_GAP_SCAN_FAST_WINDOW
Recommended scan window for fast scanning.
Definition gap.h:48
#define BT_GAP_SCAN_FAST_INTERVAL_MIN
Recommended minimum scan interval for fast scanning.
Definition gap.h:44
int bt_le_filter_accept_list_remove(const bt_addr_le_t *addr)
Remove device (LE) from filter accept list.
int bt_le_per_adv_sync_create(const struct bt_le_per_adv_sync_param *param, struct bt_le_per_adv_sync **out_sync)
Create a periodic advertising sync object.
void bt_id_get(bt_addr_le_t *addrs, size_t *count)
Get the currently configured identity addresses.
int bt_le_per_adv_sync_recv_enable(struct bt_le_per_adv_sync *per_adv_sync)
Enables receiving periodic advertising reports for a sync.
int bt_le_per_adv_sync_transfer_unsubscribe(const struct bt_conn *conn)
Unsubscribe from periodic advertising sync transfers (PASTs).
int bt_disable(void)
Disable Bluetooth.
int bt_le_per_adv_start(struct bt_le_ext_adv *adv)
Starts periodic advertising.
int bt_le_per_adv_list_remove(const bt_addr_le_t *addr, uint8_t sid)
Remove a device from the periodic advertising list.
int bt_le_adv_stop(void)
Stop advertising.
int bt_le_ext_adv_update_param(struct bt_le_ext_adv *adv, const struct bt_le_adv_param *param)
Update advertising parameters.
int bt_le_per_adv_stop(struct bt_le_ext_adv *adv)
Stops periodic advertising.
void bt_le_scan_cb_t(const bt_addr_le_t *addr, int8_t rssi, uint8_t adv_type, struct net_buf_simple *buf)
Callback type for reporting LE scan results.
Definition bluetooth.h:1664
int bt_le_ext_adv_stop(struct bt_le_ext_adv *adv)
Stop advertising with the given advertising set.
int bt_le_per_adv_list_add(const bt_addr_le_t *addr, uint8_t sid)
Add a device to the periodic advertising list.
int bt_le_oob_get_local(uint8_t id, struct bt_le_oob *oob)
Get local LE Out of Band (OOB) information.
bool bt_le_bond_exists(uint8_t id, const bt_addr_le_t *addr)
Check if a device identified by a Bluetooth LE address is bonded.
uint16_t bt_get_appearance(void)
Get local Bluetooth appearance.
int bt_le_per_adv_sync_recv_disable(struct bt_le_per_adv_sync *per_adv_sync)
Disables receiving periodic advertising reports for a sync.
int bt_le_filter_accept_list_add(const bt_addr_le_t *addr)
Add device (LE) to filter accept list.
static void bt_le_adv_param_set_tx_power(struct bt_le_adv_param *param, int8_t tx_power)
Set the TX power in an advertising parameter struct.
Definition bluetooth.h:1011
int bt_le_per_adv_sync_cb_register(struct bt_le_per_adv_sync_cb *cb)
Register periodic advertising sync callbacks.
void(* bt_ready_cb_t)(int err)
Callback for notifying that Bluetooth has been enabled.
Definition bluetooth.h:330
bt_le_ext_adv_state
Advertising states.
Definition bluetooth.h:1572
int bt_le_per_adv_list_clear(void)
Clear the periodic advertising list.
struct bt_le_per_adv_sync * bt_le_per_adv_sync_lookup_index(uint8_t index)
Get a periodic advertising sync object from the array index.
int bt_le_per_adv_update_did(const struct bt_le_ext_adv *adv)
Update the Advertising Data Identifier (DID) for periodic advertising without changing the data.
enum bt_le_addr_res_support bt_le_bond_addr_res_support(uint8_t id, const bt_addr_le_t *peer)
Get a bonded peer's support for address resolution.
int bt_le_ext_adv_delete(struct bt_le_ext_adv *adv)
Delete advertising set.
int bt_le_get_local_features(struct bt_le_local_features *local_features)
Get local Bluetooth LE controller features.
void bt_data_parse(struct net_buf_simple *ad, bool(*func)(struct bt_data *data, void *user_data), void *user_data)
Helper for parsing advertising (or EIR or OOB) data.
bt_le_per_adv_state
Periodic Advertising states.
Definition bluetooth.h:1581
int bt_le_per_adv_sync_subevent(struct bt_le_per_adv_sync *per_adv_sync, struct bt_le_per_adv_sync_subevent_params *params)
Synchronize with a subset of subevents.
int bt_le_ext_adv_oob_get_local(struct bt_le_ext_adv *adv, struct bt_le_oob *oob)
Get local LE Out of Band (OOB) information.
int bt_id_reset_irk(uint8_t id, uint8_t *irk)
Reset the local Identity Resolving Key (IRK) for an identity.
int bt_le_per_adv_set_subevent_data(const struct bt_le_ext_adv *adv, uint8_t num_subevents, const struct bt_le_per_adv_subevent_data_params *params)
Set the periodic advertising with response subevent data.
int bt_configure_data_path(uint8_t dir, uint8_t id, uint8_t vs_config_len, const uint8_t *vs_config)
Configure vendor data path.
int bt_le_scan_cb_register(struct bt_le_scan_cb *cb)
Register scanner packet callbacks.
bt_le_per_adv_sync_transfer_opt
Periodic Advertising Sync Transfer options.
Definition bluetooth.h:2268
struct bt_le_per_adv_sync * bt_le_per_adv_sync_lookup_addr(const bt_addr_le_t *adv_addr, uint8_t sid)
Look up an existing periodic advertising sync object by advertiser address.
uint8_t bt_le_per_adv_sync_get_index(struct bt_le_per_adv_sync *per_adv_sync)
Get array index of an periodic advertising sync object.
int bt_le_adv_update_data(const struct bt_data *ad, size_t ad_len, const struct bt_data *sd, size_t sd_len)
Update advertising.
int bt_le_set_rpa_timeout(uint16_t new_rpa_timeout)
Set the Resolvable Private Address timeout in runtime.
int bt_le_per_adv_sync_transfer_subscribe(const struct bt_conn *conn, const struct bt_le_per_adv_sync_transfer_param *param)
Subscribe to periodic advertising sync transfers (PASTs).
int bt_le_per_adv_sync_delete(struct bt_le_per_adv_sync *per_adv_sync)
Delete periodic advertising sync.
#define BT_LE_LOCAL_SUPPORTED_FEATURES_SIZE
Number of octets for local supported features.
Definition bluetooth.h:89
int bt_le_scan_stop(void)
Stop (LE) scanning.
int bt_le_per_adv_set_param(struct bt_le_ext_adv *adv, const struct bt_le_per_adv_param *param)
Set or update the periodic advertising parameters.
bool bt_is_ready(void)
Check if Bluetooth is ready.
bt_le_addr_res_support
A bonded peer's support for address resolution.
Definition bluetooth.h:3049
void bt_foreach_bond(uint8_t id, void(*func)(const struct bt_bond_info *info, void *user_data), void *user_data)
Iterate through all existing bonds.
int bt_le_per_adv_set_response_data(struct bt_le_per_adv_sync *per_adv_sync, const struct bt_le_per_adv_response_params *params, const struct net_buf_simple *data)
Set the data for a response slot in a specific subevent of the PAwR.
int bt_le_per_adv_sync_cb_unregister(struct bt_le_per_adv_sync_cb *cb)
Unregister periodic advertising sync callbacks.
bt_le_scan_opt
Definition bluetooth.h:2449
int bt_id_reset(uint8_t id, bt_addr_le_t *addr, uint8_t *irk)
Reset/reclaim an identity address for reuse.
int bt_le_set_chan_map(uint8_t chan_map[5])
Set (LE) channel map.
int bt_le_per_adv_sync_get_info(struct bt_le_per_adv_sync *per_adv_sync, struct bt_le_per_adv_sync_info *info)
Get periodic adv sync information.
int bt_le_ext_adv_get_info(const struct bt_le_ext_adv *adv, struct bt_le_ext_adv_info *info)
Get advertising set info.
void bt_le_scan_cb_unregister(struct bt_le_scan_cb *cb)
Unregister scanner packet callbacks.
int bt_enable(bt_ready_cb_t cb)
Enable Bluetooth.
int bt_le_scan_start(const struct bt_le_scan_param *param, bt_le_scan_cb_t cb)
Start (LE) scanning.
int bt_le_filter_accept_list_clear(void)
Clear filter accept list.
int bt_set_name(const char *name)
Set Bluetooth Device Name.
bt_le_per_adv_sync_opt
Periodic advertising sync options.
Definition bluetooth.h:2031
int bt_le_per_adv_set_info_transfer(const struct bt_le_ext_adv *adv, const struct bt_conn *conn, uint16_t service_data)
Transfer the information about a periodic advertising set.
int bt_unpair(uint8_t id, const bt_addr_le_t *addr)
Clear pairing information.
int bt_le_ext_adv_create(const struct bt_le_adv_param *param, const struct bt_le_ext_adv_cb *cb, struct bt_le_ext_adv **adv)
Create advertising set.
int bt_le_adv_start(const struct bt_le_adv_param *param, const struct bt_data *ad, size_t ad_len, const struct bt_data *sd, size_t sd_len)
Start advertising.
int bt_le_ext_adv_set_data(struct bt_le_ext_adv *adv, const struct bt_data *ad, size_t ad_len, const struct bt_data *sd, size_t sd_len)
Set an advertising set's advertising or scan response data.
const char * bt_get_name(void)
Get Bluetooth Device Name.
int bt_id_create(bt_addr_le_t *addr, uint8_t *irk)
Create a new identity address.
bt_le_per_adv_opt
Periodic Advertising options.
Definition bluetooth.h:1018
int bt_set_appearance(uint16_t new_appearance)
Set local Bluetooth appearance.
int bt_le_ext_adv_start(struct bt_le_ext_adv *adv, const struct bt_le_ext_adv_start_param *param)
Start advertising with the given advertising set.
int bt_id_delete(uint8_t id)
Delete an identity address.
int bt_le_per_adv_sync_transfer(const struct bt_le_per_adv_sync *per_adv_sync, const struct bt_conn *conn, uint16_t service_data)
Transfer the periodic advertising sync information to a peer device.
uint8_t bt_le_ext_adv_get_index(const struct bt_le_ext_adv *adv)
Get array index of an advertising set.
bt_le_scan_type
Definition bluetooth.h:2485
bt_le_adv_opt
Advertising options.
Definition bluetooth.h:682
int bt_le_per_adv_set_data(const struct bt_le_ext_adv *adv, const struct bt_data *ad, size_t ad_len)
Set or update the periodic advertising data.
@ BT_LE_EXT_ADV_STATE_DISABLED
The advertising set has been created but not enabled.
Definition bluetooth.h:1574
@ BT_LE_EXT_ADV_STATE_ENABLED
The advertising set is enabled.
Definition bluetooth.h:1577
@ BT_LE_PER_ADV_STATE_ENABLED
Periodic advertising is enabled.
Definition bluetooth.h:1589
@ BT_LE_PER_ADV_STATE_DISABLED
The advertising set has been configured for periodic advertising, but is not enabled.
Definition bluetooth.h:1586
@ BT_LE_PER_ADV_STATE_NONE
Not configured for periodic advertising.
Definition bluetooth.h:1583
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOA
No Angle of Arrival (AoA).
Definition bluetooth.h:2277
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_REPORTING_INITIALLY_DISABLED
Sync to received PAST packets but don't generate sync reports.
Definition bluetooth.h:2304
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOD_2US
No Angle of Departure (AoD) 2.
Definition bluetooth.h:2293
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOD_1US
No Angle of Departure (AoD) 1 us.
Definition bluetooth.h:2285
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_FILTER_DUPLICATES
Sync to received PAST packets and generate sync reports with duplicate filtering.
Definition bluetooth.h:2312
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_ONLY_CTE
Only sync to packets with constant tone extension.
Definition bluetooth.h:2296
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2270
@ BT_LE_ADDR_RES_SUPPORT_YES
The peer supports address resolution.
Definition bluetooth.h:3060
@ BT_LE_ADDR_RES_SUPPORT_NO
The peer does not support address resolution.
Definition bluetooth.h:3053
@ BT_LE_ADDR_RES_SUPPORT_UNKNOWN
The peer has not been asked, or the answer could not be read.
Definition bluetooth.h:3051
@ BT_LE_SCAN_OPT_FILTER_DUPLICATE
Filter duplicates.
Definition bluetooth.h:2454
@ BT_LE_SCAN_OPT_CODED
Enable scan on coded PHY (Long Range).
Definition bluetooth.h:2460
@ BT_LE_SCAN_OPT_EXT_FILTER_POLICY
Use the extended scanner filter policy.
Definition bluetooth.h:2482
@ BT_LE_SCAN_OPT_NO_1M
Disable scan on 1M phy.
Definition bluetooth.h:2467
@ BT_LE_SCAN_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2451
@ BT_LE_SCAN_OPT_FILTER_ACCEPT_LIST
Filter using filter accept list.
Definition bluetooth.h:2457
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOD_2US
Sync with Angle of Departure (AoD) 2 us constant tone extension.
Definition bluetooth.h:2060
@ BT_LE_PER_ADV_SYNC_OPT_SYNC_ONLY_CONST_TONE_EXT
Do not sync to packets without a constant tone extension.
Definition bluetooth.h:2063
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOD_1US
Sync with Angle of Departure (AoD) 1 us constant tone extension.
Definition bluetooth.h:2057
@ BT_LE_PER_ADV_SYNC_OPT_FILTER_DUPLICATE
Filter duplicate Periodic Advertising reports.
Definition bluetooth.h:2051
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOA
Sync with Angle of Arrival (AoA) constant tone extension.
Definition bluetooth.h:2054
@ BT_LE_PER_ADV_SYNC_OPT_REPORTING_INITIALLY_DISABLED
Disables periodic advertising reports.
Definition bluetooth.h:2048
@ BT_LE_PER_ADV_SYNC_OPT_USE_PER_ADV_LIST
Use the periodic advertising list to sync with advertiser.
Definition bluetooth.h:2041
@ BT_LE_PER_ADV_SYNC_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2033
@ BT_LE_PER_ADV_OPT_INCLUDE_ADI
Advertise with included AdvDataInfo (ADI).
Definition bluetooth.h:1036
@ BT_LE_PER_ADV_OPT_USE_TX_POWER
Advertise with transmit power.
Definition bluetooth.h:1028
@ BT_LE_PER_ADV_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:1020
@ BT_LE_SCAN_TYPE_PASSIVE
Scan without requesting additional information from advertisers.
Definition bluetooth.h:2487
@ BT_LE_SCAN_TYPE_ACTIVE
Scan and request additional information from advertisers.
Definition bluetooth.h:2496
@ BT_LE_ADV_OPT_NOTIFY_SCAN_REQ
Notify the application when a scan response data has been sent to an active scanner.
Definition bluetooth.h:757
@ BT_LE_ADV_OPT_ANONYMOUS
Advertise without a device address (identity address or RPA).
Definition bluetooth.h:827
@ BT_LE_ADV_OPT_USE_NRPA
Advertise using a Non-Resolvable Private Address.
Definition bluetooth.h:856
@ BT_LE_ADV_OPT_USE_IDENTITY
Advertise using identity address.
Definition bluetooth.h:718
@ BT_LE_ADV_OPT_FILTER_SCAN_REQ
Use filter accept list to filter devices that can request scan response data.
Definition bluetooth.h:749
@ BT_LE_ADV_OPT_DISABLE_CHAN_39
Disable advertising on channel index 39.
Definition bluetooth.h:844
@ BT_LE_ADV_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:684
@ BT_LE_ADV_OPT_REQUIRE_S2_CODING
Configures the advertiser to use the S=2 coding scheme for LE Coded PHY.
Definition bluetooth.h:873
@ BT_LE_ADV_OPT_CONN
Connectable advertising.
Definition bluetooth.h:706
@ BT_LE_ADV_OPT_REQUIRE_S8_CODING
Configures the advertiser to use the S=8 coding scheme for LE Coded PHY.
Definition bluetooth.h:890
@ BT_LE_ADV_OPT_DISABLE_CHAN_37
Disable advertising on channel index 37.
Definition bluetooth.h:838
@ BT_LE_ADV_OPT_TX_POWER
Request a specific TX power level for the advertising set.
Definition bluetooth.h:903
@ BT_LE_ADV_OPT_DISABLE_CHAN_38
Disable advertising on channel index 38.
Definition bluetooth.h:841
@ BT_LE_ADV_OPT_DIR_ADDR_RPA
Directed advertising to privacy-enabled peer.
Definition bluetooth.h:744
@ BT_LE_ADV_OPT_CODED
Advertise on the LE Coded PHY (Long Range).
Definition bluetooth.h:819
@ BT_LE_ADV_OPT_FILTER_CONN
Use filter accept list to filter devices that can connect.
Definition bluetooth.h:752
@ BT_LE_ADV_OPT_EXT_ADV
Advertise with extended advertising.
Definition bluetooth.h:789
@ BT_LE_ADV_OPT_SCANNABLE
Support scan response data.
Definition bluetooth.h:767
@ BT_LE_ADV_OPT_NO_2M
Disable use of LE 2M PHY on the secondary advertising channel.
Definition bluetooth.h:806
@ BT_LE_ADV_OPT_USE_TX_POWER
Advertise with transmit power.
Definition bluetooth.h:835
@ BT_LE_ADV_OPT_DIR_MODE_LOW_DUTY
Low duty cycle directed advertising.
Definition bluetooth.h:726
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:44
#define BIT(n)
Unsigned integer with bit position n set (signed in assembly language).
Definition util_macro.h:44
Header file for the single-linked list API.
#define bool
Definition stdbool.h:13
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
__UINT64_TYPE__ uint64_t
Definition stdint.h:91
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
__UINT16_TYPE__ uint16_t
Definition stdint.h:89
__INT8_TYPE__ int8_t
Definition stdint.h:72
Bluetooth LE Device Address.
Definition addr.h:51
Information about a bond with a remote device.
Definition bluetooth.h:3031
bt_addr_le_t addr
Address of the remote device.
Definition bluetooth.h:3033
Opaque type representing a connection to a remote device.
Bluetooth data.
Definition data.h:40
Definition direction.h:118
Broadcast Isochronous Group (BIG) information.
Definition iso.h:648
LE Advertising Parameters.
Definition bluetooth.h:907
int8_t tx_power
Requested TX power in dBm.
Definition bluetooth.h:948
uint32_t options
Bit-field of advertising options, see the bt_le_adv_opt field.
Definition bluetooth.h:951
const bt_addr_le_t * peer
Directed advertising to peer.
Definition bluetooth.h:996
uint8_t sid
Advertising Set Identifier, valid range is BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:926
uint8_t secondary_max_skip
Secondary channel maximum skip count.
Definition bluetooth.h:937
uint32_t interval_min
Minimum Advertising Interval (N * 0.625 milliseconds).
Definition bluetooth.h:965
uint8_t id
Local identity handle.
Definition bluetooth.h:918
uint32_t interval_max
Maximum Advertising Interval (N * 0.625 milliseconds).
Definition bluetooth.h:979
Callback struct to notify about advertiser activity.
Definition bluetooth.h:227
bool(* rpa_expired)(struct bt_le_ext_adv *adv)
The RPA validity of the advertising set has expired.
Definition bluetooth.h:283
void(* scanned)(struct bt_le_ext_adv *adv, struct bt_le_ext_adv_scanned_info *info)
The advertising set has sent scan response data.
Definition bluetooth.h:263
void(* pawr_response)(struct bt_le_ext_adv *adv, struct bt_le_per_adv_response_info *info, struct net_buf_simple *buf)
The Controller indicates that one or more synced devices have responded to a periodic advertising sub...
Definition bluetooth.h:318
void(* connected)(struct bt_le_ext_adv *adv, struct bt_le_ext_adv_connected_info *info)
The advertising set has accepted a new connection.
Definition bluetooth.h:250
void(* sent)(struct bt_le_ext_adv *adv, struct bt_le_ext_adv_sent_info *info)
The advertising set was disabled after reaching limit.
Definition bluetooth.h:238
void(* pawr_data_request)(struct bt_le_ext_adv *adv, const struct bt_le_per_adv_data_request *request)
The Controller indicates it is ready to transmit one or more PAwR subevents.
Definition bluetooth.h:298
Info of the advertising connected event.
Definition bluetooth.h:132
struct bt_conn * conn
Connection object of the new connection.
Definition bluetooth.h:134
Advertising set info structure.
Definition bluetooth.h:1593
uint8_t id
Local identity handle.
Definition bluetooth.h:1595
enum bt_le_ext_adv_state ext_adv_state
Extended advertising state.
Definition bluetooth.h:1631
const bt_addr_le_t * addr
Current local advertising address used.
Definition bluetooth.h:1628
uint8_t sid
Advertising Set ID.
Definition bluetooth.h:1606
int8_t tx_power
Currently selected Transmit Power in dBm.
Definition bluetooth.h:1598
enum bt_le_per_adv_state per_adv_state
Periodic advertising state.
Definition bluetooth.h:1634
Info of the advertising scanned event.
Definition bluetooth.h:142
bt_addr_le_t * addr
Active scanner LE address and type.
Definition bluetooth.h:144
Info of the advertising sent event.
Definition bluetooth.h:117
uint8_t num_sent
If the advertising set was started with a non-zero bt_le_ext_adv_start_param::num_events,...
Definition bluetooth.h:124
Parameters for starting an extended advertising session.
Definition bluetooth.h:1413
uint16_t timeout
Maximum advertising set duration (N * 10 ms).
Definition bluetooth.h:1438
uint8_t num_events
Maximum number of extended advertising events to be sent.
Definition bluetooth.h:1458
Opaque type representing an advertiser.
Local Bluetooth LE controller features and capabilities.
Definition bluetooth.h:609
uint8_t acl_pkts
Total number of ACL data packets.
Definition bluetooth.h:637
uint16_t acl_mtu
ACL data packet length.
Definition bluetooth.h:635
uint8_t features[BT_HCI_LE_BYTES_PAGE_0_FEATURE_PAGE]
Local LE controller supported features.
Definition bluetooth.h:617
uint8_t iso_pkts
Total number of ISO data packets.
Definition bluetooth.h:649
uint16_t max_adv_data_len
Maximum advertising data length.
Definition bluetooth.h:665
uint64_t states
Local LE controller supported states.
Definition bluetooth.h:625
uint8_t rl_size
Maximum size of the controller resolving list.
Definition bluetooth.h:656
uint16_t iso_mtu
ISO data packet length.
Definition bluetooth.h:647
LE Secure Connections pairing Out of Band data.
Definition bluetooth.h:2935
uint8_t c[16]
Confirm Value.
Definition bluetooth.h:2940
uint8_t r[16]
Random Number.
Definition bluetooth.h:2937
LE Out of Band information.
Definition bluetooth.h:2944
bt_addr_le_t addr
LE address.
Definition bluetooth.h:2948
struct bt_le_oob_sc_data le_sc_data
LE Secure Connections pairing Out of Band data.
Definition bluetooth.h:2951
Info of the PAwR subevents.
Definition bluetooth.h:156
uint8_t count
The number of subevents data can be set for.
Definition bluetooth.h:161
uint8_t start
The first subevent data can be set for.
Definition bluetooth.h:158
Parameters for configuring periodic advertising.
Definition bluetooth.h:1052
uint8_t response_slot_delay
Time between the advertising packet in a subevent and the first response slot (N * 1....
Definition bluetooth.h:1097
uint8_t num_response_slots
Number of subevent response slots.
Definition bluetooth.h:1115
uint8_t subevent_interval
Interval between subevents (N * 1.25 ms).
Definition bluetooth.h:1089
uint16_t interval_min
Minimum Periodic Advertising Interval (N * 1.25 ms).
Definition bluetooth.h:1059
uint16_t interval_max
Maximum Periodic Advertising Interval (N * 1.25 ms).
Definition bluetooth.h:1067
uint8_t response_slot_spacing
Time between response slots (N * 0.125 ms).
Definition bluetooth.h:1106
uint32_t options
Bit-field of periodic advertising options, see the bt_le_per_adv_opt field.
Definition bluetooth.h:1070
uint8_t num_subevents
Number of subevents.
Definition bluetooth.h:1080
Info about the PAwR responses received.
Definition bluetooth.h:174
uint8_t subevent
The subevent the response was received in.
Definition bluetooth.h:176
int8_t rssi
The RSSI of the response in dBm.
Definition bluetooth.h:190
uint8_t cte_type
The Constant Tone Extension (CTE) of the advertisement (bt_df_cte_type).
Definition bluetooth.h:193
int8_t tx_power
The TX power of the response in dBm.
Definition bluetooth.h:187
uint8_t response_slot
The slot the response was received in.
Definition bluetooth.h:196
uint8_t tx_status
Status of the subevent indication.
Definition bluetooth.h:184
Parameters for sending a periodic advertising response.
Definition bluetooth.h:3152
uint8_t response_subevent
The subevent the response shall be sent in.
Definition bluetooth.h:3173
uint16_t request_event
The periodic event counter of the request the response is sent to.
Definition bluetooth.h:3162
uint8_t request_subevent
The subevent counter of the request the response is sent to.
Definition bluetooth.h:3170
uint8_t response_slot
The response slot the response shall be sent in.
Definition bluetooth.h:3176
Parameters for setting data for a specific periodic advertising with response subevent.
Definition bluetooth.h:1731
uint8_t response_slot_start
The first response slot to listen to.
Definition bluetooth.h:1736
const struct net_buf_simple * data
The data to send.
Definition bluetooth.h:1742
uint8_t subevent
The subevent to set data for.
Definition bluetooth.h:1733
uint8_t response_slot_count
The number of response slots to listen to.
Definition bluetooth.h:1739
Callback struct for periodic advertising sync events.
Definition bluetooth.h:1948
sys_snode_t node
Definition bluetooth.h:2027
void(* recv)(struct bt_le_per_adv_sync *sync, const struct bt_le_per_adv_sync_recv_info *info, struct net_buf_simple *buf)
Periodic advertising data received.
Definition bluetooth.h:1988
void(* state_changed)(struct bt_le_per_adv_sync *sync, const struct bt_le_per_adv_sync_state_info *info)
The periodic advertising sync state has changed.
Definition bluetooth.h:2002
void(* synced)(struct bt_le_per_adv_sync *sync, struct bt_le_per_adv_sync_synced_info *info)
The periodic advertising has been successfully synced.
Definition bluetooth.h:1959
void(* biginfo)(struct bt_le_per_adv_sync *sync, const struct bt_iso_biginfo *biginfo)
BIGInfo advertising report received.
Definition bluetooth.h:2015
void(* term)(struct bt_le_per_adv_sync *sync, const struct bt_le_per_adv_sync_term_info *info)
The periodic advertising sync has been terminated.
Definition bluetooth.h:1972
void(* cte_report_cb)(struct bt_le_per_adv_sync *sync, struct bt_df_per_adv_sync_iq_samples_report const *info)
Callback for IQ samples report collected when sampling CTE received with periodic advertising PDU.
Definition bluetooth.h:2024
Periodic advertising set info structure.
Definition bluetooth.h:2144
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:2152
uint8_t phy
Advertiser PHY (see bt_gap_le_phy).
Definition bluetooth.h:2155
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bluetooth.h:2146
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:2149
Parameters for creating a periodic advertising sync object.
Definition bluetooth.h:2077
uint16_t timeout
Synchronization timeout (N * 10 ms).
Definition bluetooth.h:2113
uint32_t options
Bit-field of periodic advertising sync options, see the bt_le_adv_opt field.
Definition bluetooth.h:2096
uint8_t sid
Advertising Set Identifier.
Definition bluetooth.h:2093
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bluetooth.h:2084
uint16_t skip
Maximum event skip.
Definition bluetooth.h:2105
Information about a received periodic advertising report.
Definition bluetooth.h:1885
uint8_t cte_type
The Constant Tone Extension (CTE) of the advertisement (bt_df_cte_type).
Definition bluetooth.h:1907
uint8_t subevent
The subevent where the subevent indication was received.
Definition bluetooth.h:1913
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1890
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1887
int8_t tx_power
The TX power of the advertisement in dBm.
Definition bluetooth.h:1897
uint16_t periodic_event_counter
The value of the event counter where the subevent indication was received.
Definition bluetooth.h:1910
int8_t rssi
The RSSI of the advertisement (excluding any CTE), in dBm.
Definition bluetooth.h:1904
Information about the state of periodic advertising sync.
Definition bluetooth.h:1924
bool recv_enabled
True if receiving periodic advertisements, false otherwise.
Definition bluetooth.h:1926
Parameters for synchronizing with specific periodic advertising subevents.
Definition bluetooth.h:3112
uint8_t * subevents
The subevent(s) to synchronize with.
Definition bluetooth.h:3128
uint16_t properties
Periodic Advertising Properties.
Definition bluetooth.h:3118
uint8_t num_subevents
Number of subevents to sync to.
Definition bluetooth.h:3121
Information about the successful synchronization with periodic advertising.
Definition bluetooth.h:1807
bool recv_enabled
True if receiving periodic advertisements, false otherwise.
Definition bluetooth.h:1821
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:1815
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1812
uint8_t response_slot_delay
Response slot delay (N * 1.25 ms).
Definition bluetooth.h:1845
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1809
uint8_t phy
Advertiser PHY (see bt_gap_le_phy).
Definition bluetooth.h:1818
uint8_t subevent_interval
Subevent interval (N * 1.25 ms).
Definition bluetooth.h:1842
uint8_t num_subevents
Number of subevents.
Definition bluetooth.h:1839
struct bt_conn * conn
Peer that transferred the periodic advertising sync.
Definition bluetooth.h:1836
uint16_t service_data
Service Data provided by the peer when sync is transferred.
Definition bluetooth.h:1828
uint8_t response_slot_spacing
Response slot spacing (N * 1.25 ms).
Definition bluetooth.h:1848
Information about the termination of a periodic advertising sync.
Definition bluetooth.h:1863
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1865
uint8_t reason
Cause of periodic advertising termination (see the BT_HCI_ERR_* values).
Definition bluetooth.h:1871
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1868
Parameters for periodic advertising sync transfer.
Definition bluetooth.h:2325
uint32_t options
Periodic Advertising Sync Transfer options, see bt_le_per_adv_sync_transfer_opt.
Definition bluetooth.h:2343
uint16_t timeout
Synchronization timeout (N * 10 ms).
Definition bluetooth.h:2340
uint16_t skip
Maximum event skip.
Definition bluetooth.h:2332
Opaque type representing a periodic advertising sync.
Listener context for (LE) scanning.
Definition bluetooth.h:2638
void(* timeout)(void)
The scanner has stopped scanning after scan timeout.
Definition bluetooth.h:2650
sys_snode_t node
Definition bluetooth.h:2652
void(* recv)(const struct bt_le_scan_recv_info *info, struct net_buf_simple *buf)
Advertisement packet and scan response received callback.
Definition bluetooth.h:2646
LE scan parameters.
Definition bluetooth.h:2500
uint8_t type
Scan type.
Definition bluetooth.h:2502
uint16_t interval
Scan interval (N * 0.625 ms).
Definition bluetooth.h:2515
uint16_t window
Scan window (N * 0.625 ms).
Definition bluetooth.h:2525
uint16_t timeout
Scan timeout (N * 10 ms).
Definition bluetooth.h:2533
uint16_t interval_coded
Scan interval LE Coded PHY (N * 0.625 MS).
Definition bluetooth.h:2540
uint16_t window_coded
Scan window LE Coded PHY (N * 0.625 MS).
Definition bluetooth.h:2547
uint8_t options
Bit-field of scanning options.
Definition bluetooth.h:2505
LE advertisement and scan response packet information.
Definition bluetooth.h:2551
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:2602
int8_t tx_power
Transmit power of the advertiser in dBm.
Definition bluetooth.h:2575
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:2561
uint8_t primary_phy
Primary advertising channel PHY.
Definition bluetooth.h:2605
const bt_addr_le_t * direct_addr
Target address of a directed advertisement.
Definition bluetooth.h:2625
int8_t rssi
Strength of advertiser signal in dBm.
Definition bluetooth.h:2568
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:2558
uint8_t secondary_phy
Secondary advertising channel PHY.
Definition bluetooth.h:2608
uint8_t adv_type
Advertising packet type.
Definition bluetooth.h:2585
uint16_t adv_props
Advertising packet properties bitfield.
Definition bluetooth.h:2595
Simple network buffer representation.
Definition net_buf.h:89
uint8_t * data
Pointer to the start of data in the buffer.
Definition net_buf.h:91