12#ifndef ZEPHYR_INCLUDE_BLUETOOTH_BLUETOOTH_H_
13#define ZEPHYR_INCLUDE_BLUETOOTH_BLUETOOTH_H_
72#define BT_ID_DEFAULT 0
80#define BT_LE_LOCAL_SUPPORTED_FEATURES_SIZE \
81 (BT_HCI_LE_BYTES_PAGE_0_FEATURE_PAGE + \
82 COND_CODE_1(CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE, \
83 (CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE \
84 * BT_HCI_LE_BYTES_PER_FEATURE_PAGE), \
91struct bt_le_per_adv_sync;
220 void (*
sent)(
struct bt_le_ext_adv *adv,
248#if defined(CONFIG_BT_PRIVACY)
265 bool (*rpa_expired)(
struct bt_le_ext_adv *adv);
268#if defined(CONFIG_BT_PER_ADV_RSP)
278 void (*pawr_data_request)(
struct bt_le_ext_adv *adv,
529#define BT_DATA_SERIALIZED_SIZE(data_len) ((data_len) + 2)
557#define BT_DATA(_type, _data, _data_len) \
560 .data_len = (_data_len), \
561 .data = (const uint8_t *)(_data), \
573#define BT_DATA_BYTES(_type, _bytes...) \
574 BT_DATA(_type, ((uint8_t []) { _bytes }), \
575 sizeof((uint8_t []) { _bytes }))
1034#if defined(CONFIG_BT_PER_ADV_RSP)
1061 uint8_t response_slot_spacing;
1081#define BT_LE_ADV_PARAM_INIT(_options, _int_min, _int_max, _peer) \
1083 .id = BT_ID_DEFAULT, \
1085 .secondary_max_skip = 0, \
1086 .options = (_options), \
1087 .interval_min = (_int_min), \
1088 .interval_max = (_int_max), \
1101#define BT_LE_ADV_PARAM(_options, _int_min, _int_max, _peer) \
1102 ((const struct bt_le_adv_param[]) { \
1103 BT_LE_ADV_PARAM_INIT(_options, _int_min, _int_max, _peer) \
1106#define BT_LE_ADV_CONN_DIR(_peer) BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, 0, 0, _peer)
1136#define BT_LE_ADV_CONN_FAST_1 \
1137 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_1, BT_GAP_ADV_FAST_INT_MAX_1, \
1156#define BT_LE_ADV_CONN_FAST_2 \
1157 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_2, BT_GAP_ADV_FAST_INT_MAX_2, \
1160#define BT_LE_ADV_CONN_DIR_LOW_DUTY(_peer) \
1161 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN | BT_LE_ADV_OPT_DIR_MODE_LOW_DUTY, \
1162 BT_GAP_ADV_FAST_INT_MIN_2, BT_GAP_ADV_FAST_INT_MAX_2, _peer)
1165#define BT_LE_ADV_NCONN BT_LE_ADV_PARAM(0, BT_GAP_ADV_FAST_INT_MIN_2, \
1166 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1169#define BT_LE_ADV_NCONN_IDENTITY BT_LE_ADV_PARAM(BT_LE_ADV_OPT_USE_IDENTITY, \
1170 BT_GAP_ADV_FAST_INT_MIN_2, \
1171 BT_GAP_ADV_FAST_INT_MAX_2, \
1175#define BT_LE_EXT_ADV_CONN \
1176 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_2, \
1177 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1180#define BT_LE_EXT_ADV_SCAN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1181 BT_LE_ADV_OPT_SCANNABLE, \
1182 BT_GAP_ADV_FAST_INT_MIN_2, \
1183 BT_GAP_ADV_FAST_INT_MAX_2, \
1187#define BT_LE_EXT_ADV_NCONN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV, \
1188 BT_GAP_ADV_FAST_INT_MIN_2, \
1189 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1192#define BT_LE_EXT_ADV_NCONN_IDENTITY \
1193 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1194 BT_LE_ADV_OPT_USE_IDENTITY, \
1195 BT_GAP_ADV_FAST_INT_MIN_2, \
1196 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1199#define BT_LE_EXT_ADV_CODED_NCONN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1200 BT_LE_ADV_OPT_CODED, \
1201 BT_GAP_ADV_FAST_INT_MIN_2, \
1202 BT_GAP_ADV_FAST_INT_MAX_2, \
1208#define BT_LE_EXT_ADV_CODED_NCONN_IDENTITY \
1209 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | BT_LE_ADV_OPT_CODED | \
1210 BT_LE_ADV_OPT_USE_IDENTITY, \
1211 BT_GAP_ADV_FAST_INT_MIN_2, \
1212 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1220#define BT_LE_EXT_ADV_START_PARAM_INIT(_timeout, _n_evts) \
1222 .timeout = (_timeout), \
1223 .num_events = (_n_evts), \
1232#define BT_LE_EXT_ADV_START_PARAM(_timeout, _n_evts) \
1233 ((const struct bt_le_ext_adv_start_param[]) { \
1234 BT_LE_EXT_ADV_START_PARAM_INIT((_timeout), (_n_evts)) \
1237#define BT_LE_EXT_ADV_START_DEFAULT BT_LE_EXT_ADV_START_PARAM(0, 0)
1247#define BT_LE_PER_ADV_PARAM_INIT(_int_min, _int_max, _options) \
1249 .interval_min = (_int_min), \
1250 .interval_max = (_int_max), \
1251 .options = (_options), \
1262#define BT_LE_PER_ADV_PARAM(_int_min, _int_max, _options) \
1263 ((struct bt_le_per_adv_param[]) { \
1264 BT_LE_PER_ADV_PARAM_INIT(_int_min, _int_max, _options) \
1267#define BT_LE_PER_ADV_DEFAULT BT_LE_PER_ADV_PARAM(BT_GAP_PER_ADV_SLOW_INT_MIN, \
1268 BT_GAP_PER_ADV_SLOW_INT_MAX, \
1269 BT_LE_PER_ADV_OPT_NONE)
1300 const struct bt_data *ad,
size_t ad_len,
1301 const struct bt_data *sd,
size_t sd_len);
1316 const struct bt_data *sd,
size_t sd_len);
1348 struct bt_le_ext_adv **adv);
1477 const struct bt_data *ad,
size_t ad_len,
1478 const struct bt_data *sd,
size_t sd_len);
1620 const struct bt_data *ad,
size_t ad_len);
1738#if defined(CONFIG_BT_PER_ADV_SYNC_RSP)
1749 uint8_t response_slot_spacing;
1801#if defined(CONFIG_BT_PER_ADV_SYNC_RSP)
1844 void (*
synced)(
struct bt_le_per_adv_sync *sync,
1857 void (*
term)(
struct bt_le_per_adv_sync *sync,
1873 void (*
recv)(
struct bt_le_per_adv_sync *sync,
2082 struct bt_le_per_adv_sync **out_sync);
2232 const struct bt_conn *conn,
2249 const struct bt_conn *conn,
2266 const struct bt_conn *conn,
2487#define BT_LE_SCAN_PARAM_INIT(_type, _options, _interval, _window) \
2490 .options = (_options), \
2491 .interval = (_interval), \
2492 .window = (_window), \
2494 .interval_coded = 0, \
2495 .window_coded = 0, \
2506#define BT_LE_SCAN_PARAM(_type, _options, _interval, _window) \
2507 ((struct bt_le_scan_param[]) { \
2508 BT_LE_SCAN_PARAM_INIT(_type, _options, _interval, _window) \
2514#define BT_LE_SCAN_ACTIVE BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2515 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2516 BT_GAP_SCAN_FAST_INTERVAL, \
2517 BT_GAP_SCAN_FAST_WINDOW)
2524#define BT_LE_SCAN_ACTIVE_CONTINUOUS BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2525 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2526 BT_GAP_SCAN_FAST_INTERVAL_MIN, \
2527 BT_GAP_SCAN_FAST_WINDOW)
2529 "Continuous scanning is requested by setting window and interval equal.");
2537#define BT_LE_SCAN_PASSIVE BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2538 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2539 BT_GAP_SCAN_FAST_INTERVAL, \
2540 BT_GAP_SCAN_FAST_WINDOW)
2548#define BT_LE_SCAN_PASSIVE_CONTINUOUS BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2549 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2550 BT_GAP_SCAN_FAST_INTERVAL_MIN, \
2551 BT_GAP_SCAN_FAST_WINDOW)
2553 "Continuous scanning is requested by setting window and interval equal.");
2559#define BT_LE_SCAN_CODED_ACTIVE \
2560 BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2561 BT_LE_SCAN_OPT_CODED | \
2562 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2563 BT_GAP_SCAN_FAST_INTERVAL, \
2564 BT_GAP_SCAN_FAST_WINDOW)
2573#define BT_LE_SCAN_CODED_PASSIVE \
2574 BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2575 BT_LE_SCAN_OPT_CODED | \
2576 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2577 BT_GAP_SCAN_FAST_INTERVAL, \
2578 BT_GAP_SCAN_FAST_WINDOW)
2746 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 Generic Access Profile defines and Assigned Numbers.
#define BT_GAP_SCAN_FAST_WINDOW
Definition gap.h:44
#define BT_GAP_SCAN_FAST_INTERVAL_MIN
Definition gap.h:42
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:1586
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.
size_t bt_data_serialize(const struct bt_data *input, uint8_t *output)
Serialize a bt_data struct into an advertising structure (a flat array).
size_t bt_data_get_len(const struct bt_data data[], size_t data_count)
Get the total size (in octets) of a given set of bt_data structures.
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.
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:301
bt_le_ext_adv_state
Advertising states.
Definition bluetooth.h:1520
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_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:1529
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_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:2141
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:80
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.
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.
bt_le_scan_opt
Definition bluetooth.h:2322
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:1916
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:980
uint8_t bt_le_ext_adv_get_index(struct bt_le_ext_adv *adv)
Get array index of an advertising set.
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.
bt_le_scan_type
Definition bluetooth.h:2343
bt_le_adv_opt
Advertising options.
Definition bluetooth.h:690
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:1522
@ BT_LE_EXT_ADV_STATE_ENABLED
The advertising set is enabled.
Definition bluetooth.h:1525
@ BT_LE_PER_ADV_STATE_ENABLED
Periodic advertising is enabled.
Definition bluetooth.h:1537
@ BT_LE_PER_ADV_STATE_DISABLED
The advertising set has been configured for periodic advertising, but is not enabled.
Definition bluetooth.h:1534
@ BT_LE_PER_ADV_STATE_NONE
Not configured for periodic advertising.
Definition bluetooth.h:1531
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOA
No Angle of Arrival (AoA)
Definition bluetooth.h:2150
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_REPORTING_INITIALLY_DISABLED
Sync to received PAST packets but don't generate sync reports.
Definition bluetooth.h:2177
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOD_2US
No Angle of Departure (AoD) 2.
Definition bluetooth.h:2166
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOD_1US
No Angle of Departure (AoD) 1 us.
Definition bluetooth.h:2158
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_FILTER_DUPLICATES
Sync to received PAST packets and generate sync reports with duplicate filtering.
Definition bluetooth.h:2185
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_ONLY_CTE
Only sync to packets with constant tone extension.
Definition bluetooth.h:2169
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2143
@ BT_LE_SCAN_OPT_FILTER_DUPLICATE
Filter duplicates.
Definition bluetooth.h:2327
@ BT_LE_SCAN_OPT_CODED
Enable scan on coded PHY (Long Range).
Definition bluetooth.h:2333
@ BT_LE_SCAN_OPT_NO_1M
Disable scan on 1M phy.
Definition bluetooth.h:2340
@ BT_LE_SCAN_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2324
@ BT_LE_SCAN_OPT_FILTER_ACCEPT_LIST
Filter using filter accept list.
Definition bluetooth.h:2330
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOD_2US
Sync with Angle of Departure (AoD) 2 us constant tone extension.
Definition bluetooth.h:1945
@ BT_LE_PER_ADV_SYNC_OPT_SYNC_ONLY_CONST_TONE_EXT
Do not sync to packets without a constant tone extension.
Definition bluetooth.h:1948
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOD_1US
Sync with Angle of Departure (AoD) 1 us constant tone extension.
Definition bluetooth.h:1942
@ BT_LE_PER_ADV_SYNC_OPT_FILTER_DUPLICATE
Filter duplicate Periodic Advertising reports.
Definition bluetooth.h:1936
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOA
Sync with Angle of Arrival (AoA) constant tone extension.
Definition bluetooth.h:1939
@ BT_LE_PER_ADV_SYNC_OPT_REPORTING_INITIALLY_DISABLED
Disables periodic advertising reports.
Definition bluetooth.h:1933
@ BT_LE_PER_ADV_SYNC_OPT_USE_PER_ADV_LIST
Use the periodic advertising list to sync with advertiser.
Definition bluetooth.h:1926
@ BT_LE_PER_ADV_SYNC_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:1918
@ BT_LE_PER_ADV_OPT_INCLUDE_ADI
Advertise with included AdvDataInfo (ADI).
Definition bluetooth.h:998
@ BT_LE_PER_ADV_OPT_USE_TX_POWER
Advertise with transmit power.
Definition bluetooth.h:990
@ BT_LE_PER_ADV_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:982
@ BT_LE_SCAN_TYPE_PASSIVE
Scan without requesting additional information from advertisers.
Definition bluetooth.h:2345
@ BT_LE_SCAN_TYPE_ACTIVE
Scan and request additional information from advertisers.
Definition bluetooth.h:2354
@ 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:761
@ BT_LE_ADV_OPT_ANONYMOUS
Advertise without a device address (identity address or RPA).
Definition bluetooth.h:831
@ BT_LE_ADV_OPT_USE_NRPA
Advertise using a Non-Resolvable Private Address.
Definition bluetooth.h:862
@ BT_LE_ADV_OPT_USE_IDENTITY
Advertise using identity address.
Definition bluetooth.h:726
@ BT_LE_ADV_OPT_FILTER_SCAN_REQ
Use filter accept list to filter devices that can request scan response data.
Definition bluetooth.h:753
@ BT_LE_ADV_OPT_DISABLE_CHAN_39
Disable advertising on channel index 39.
Definition bluetooth.h:848
@ BT_LE_ADV_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:692
@ BT_LE_ADV_OPT_REQUIRE_S2_CODING
Configures the advertiser to use the S=2 coding scheme for LE Coded PHY.
Definition bluetooth.h:879
@ BT_LE_ADV_OPT_CONN
Connectable advertising.
Definition bluetooth.h:714
@ BT_LE_ADV_OPT_REQUIRE_S8_CODING
Configures the advertiser to use the S=8 coding scheme for LE Coded PHY.
Definition bluetooth.h:896
@ BT_LE_ADV_OPT_DISABLE_CHAN_37
Disable advertising on channel index 37.
Definition bluetooth.h:842
@ BT_LE_ADV_OPT_DISABLE_CHAN_38
Disable advertising on channel index 38.
Definition bluetooth.h:845
@ BT_LE_ADV_OPT_DIR_ADDR_RPA
Directed advertising to privacy-enabled peer.
Definition bluetooth.h:748
@ BT_LE_ADV_OPT_CODED
Advertise on the LE Coded PHY (Long Range).
Definition bluetooth.h:823
@ BT_LE_ADV_OPT_FILTER_CONN
Use filter accept list to filter devices that can connect.
Definition bluetooth.h:756
@ BT_LE_ADV_OPT_EXT_ADV
Advertise with extended advertising.
Definition bluetooth.h:793
@ BT_LE_ADV_OPT_SCANNABLE
Support scan response data.
Definition bluetooth.h:771
@ BT_LE_ADV_OPT_NO_2M
Disable use of LE 2M PHY on the secondary advertising channel.
Definition bluetooth.h:810
@ BT_LE_ADV_OPT_USE_TX_POWER
Advertise with transmit power.
Definition bluetooth.h:839
@ BT_LE_ADV_OPT_DIR_MODE_LOW_DUTY
Low duty cycle directed advertising.
Definition bluetooth.h:734
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:39
#define BIT(n)
Unsigned integer with bit position n set (signed in assembly language).
Definition util_macro.h:44
#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:49
Information about a bond with a remote device.
Definition bluetooth.h:2840
bt_addr_le_t addr
Address of the remote device.
Definition bluetooth.h:2842
Bluetooth data.
Definition bluetooth.h:538
uint8_t type
Type of scan response data or advertisement data.
Definition bluetooth.h:540
uint8_t data_len
Length of scan response data or advertisement data.
Definition bluetooth.h:542
const uint8_t * data
Pointer to Scan response or advertisement data.
Definition bluetooth.h:544
Definition direction.h:118
Broadcast Isochronous Group (BIG) information.
Definition iso.h:659
LE Advertising Parameters.
Definition bluetooth.h:900
uint32_t options
Bit-field of advertising options, see the bt_le_adv_opt field.
Definition bluetooth.h:934
const bt_addr_le_t * peer
Directed advertising to peer.
Definition bluetooth.h:975
uint8_t sid
Advertising Set Identifier, valid range is BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:920
uint8_t secondary_max_skip
Secondary channel maximum skip count.
Definition bluetooth.h:931
uint32_t interval_min
Minimum Advertising Interval (N * 0.625 milliseconds)
Definition bluetooth.h:946
uint8_t id
Local identity handle.
Definition bluetooth.h:911
uint32_t interval_max
Maximum Advertising Interval (N * 0.625 milliseconds)
Definition bluetooth.h:958
Callback struct to notify about advertiser activity.
Definition bluetooth.h:209
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:245
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:232
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:220
Info of the advertising connected event.
Definition bluetooth.h:122
struct bt_conn * conn
Connection object of the new connection.
Definition bluetooth.h:124
Advertising set info structure.
Definition bluetooth.h:1541
uint8_t id
Local identity handle.
Definition bluetooth.h:1543
enum bt_le_ext_adv_state ext_adv_state
Extended advertising state.
Definition bluetooth.h:1555
const bt_addr_le_t * addr
Current local advertising address used.
Definition bluetooth.h:1552
uint8_t sid
Advertising Set ID.
Definition bluetooth.h:1549
int8_t tx_power
Currently selected Transmit Power (dBM).
Definition bluetooth.h:1546
enum bt_le_per_adv_state per_adv_state
Periodic advertising state.
Definition bluetooth.h:1558
Info of the advertising scanned event.
Definition bluetooth.h:132
bt_addr_le_t * addr
Active scanner LE address and type.
Definition bluetooth.h:134
Info of the advertising sent event.
Definition bluetooth.h:107
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:114
Parameters for starting an extended advertising session.
Definition bluetooth.h:1363
uint16_t timeout
Maximum advertising set duration (N * 10 ms)
Definition bluetooth.h:1388
uint8_t num_events
Maximum number of extended advertising events to be sent.
Definition bluetooth.h:1408
Local Bluetooth LE controller features and capabilities.
Definition bluetooth.h:617
uint8_t acl_pkts
Total number of ACL data packets.
Definition bluetooth.h:645
uint16_t acl_mtu
ACL data packet length.
Definition bluetooth.h:643
uint8_t iso_pkts
Total number of ISO data packets.
Definition bluetooth.h:657
uint16_t max_adv_data_len
Maximum advertising data length.
Definition bluetooth.h:673
uint64_t states
Local LE controller supported states.
Definition bluetooth.h:633
uint8_t features[(BT_HCI_LE_BYTES_PAGE_0_FEATURE_PAGE+COND_CODE_1(CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE,(CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE *BT_HCI_LE_BYTES_PER_FEATURE_PAGE),(0U)))]
Local LE controller supported features.
Definition bluetooth.h:625
uint8_t rl_size
Maximum size of the controller resolving list.
Definition bluetooth.h:664
uint16_t iso_mtu
ISO data packet length.
Definition bluetooth.h:655
LE Secure Connections pairing Out of Band data.
Definition bluetooth.h:2750
uint8_t c[16]
Confirm Value.
Definition bluetooth.h:2755
uint8_t r[16]
Random Number.
Definition bluetooth.h:2752
LE Out of Band information.
Definition bluetooth.h:2759
bt_addr_le_t addr
LE address.
Definition bluetooth.h:2763
struct bt_le_oob_sc_data le_sc_data
LE Secure Connections pairing Out of Band data.
Definition bluetooth.h:2766
Info of the PAwR subevents.
Definition bluetooth.h:146
uint8_t count
The number of subevents data can be set for.
Definition bluetooth.h:151
uint8_t start
The first subevent data can be set for.
Definition bluetooth.h:148
Parameters for configuring periodic advertising.
Definition bluetooth.h:1014
uint16_t interval_min
Minimum Periodic Advertising Interval (N * 1.25 ms)
Definition bluetooth.h:1021
uint16_t interval_max
Maximum Periodic Advertising Interval (N * 1.25 ms)
Definition bluetooth.h:1029
uint32_t options
Bit-field of periodic advertising options, see the bt_le_adv_opt field.
Definition bluetooth.h:1032
Info about the PAwR responses received.
Definition bluetooth.h:164
uint8_t subevent
The subevent the response was received in.
Definition bluetooth.h:166
int8_t rssi
The RSSI of the response in dBm.
Definition bluetooth.h:180
uint8_t cte_type
The Constant Tone Extension (CTE) of the advertisement (bt_df_cte_type)
Definition bluetooth.h:183
int8_t tx_power
The TX power of the response in dBm.
Definition bluetooth.h:177
uint8_t response_slot
The slot the response was received in.
Definition bluetooth.h:186
uint8_t tx_status
Status of the subevent indication.
Definition bluetooth.h:174
Parameters for sending a periodic advertising response.
Definition bluetooth.h:2924
uint8_t response_subevent
The subevent the response shall be sent in.
Definition bluetooth.h:2945
uint16_t request_event
The periodic event counter of the request the response is sent to.
Definition bluetooth.h:2934
uint8_t request_subevent
The subevent counter of the request the response is sent to.
Definition bluetooth.h:2942
uint8_t response_slot
The response slot the response shall be sent in.
Definition bluetooth.h:2948
Parameters for setting data for a specific periodic advertising with response subevent.
Definition bluetooth.h:1632
uint8_t response_slot_start
The first response slot to listen to.
Definition bluetooth.h:1637
const struct net_buf_simple * data
The data to send.
Definition bluetooth.h:1643
uint8_t subevent
The subevent to set data for.
Definition bluetooth.h:1634
uint8_t response_slot_count
The number of response slots to listen to.
Definition bluetooth.h:1640
Callback struct for periodic advertising sync events.
Definition bluetooth.h:1833
sys_snode_t node
Definition bluetooth.h:1912
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:1873
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:1887
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:1844
void(* biginfo)(struct bt_le_per_adv_sync *sync, const struct bt_iso_biginfo *biginfo)
BIGInfo advertising report received.
Definition bluetooth.h:1900
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:1857
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:1909
Periodic advertising set info structure.
Definition bluetooth.h:2029
uint16_t interval
Periodic advertising interval (N * 1.25 ms)
Definition bluetooth.h:2037
uint8_t phy
Advertiser PHY (see bt_gap_le_phy).
Definition bluetooth.h:2040
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bluetooth.h:2031
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:2034
Parameters for creating a periodic advertising sync object.
Definition bluetooth.h:1962
uint16_t timeout
Synchronization timeout (N * 10 ms)
Definition bluetooth.h:1998
uint32_t options
Bit-field of periodic advertising sync options, see the bt_le_adv_opt field.
Definition bluetooth.h:1981
uint8_t sid
Advertising Set Identifier.
Definition bluetooth.h:1978
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bluetooth.h:1969
uint16_t skip
Maximum event skip.
Definition bluetooth.h:1990
Information about a received periodic advertising report.
Definition bluetooth.h:1786
uint8_t cte_type
The Constant Tone Extension (CTE) of the advertisement (bt_df_cte_type)
Definition bluetooth.h:1800
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1791
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1788
int8_t tx_power
The TX power of the advertisement.
Definition bluetooth.h:1794
int8_t rssi
The RSSI of the advertisement excluding any CTE.
Definition bluetooth.h:1797
Information about the state of periodic advertising sync.
Definition bluetooth.h:1817
bool recv_enabled
True if receiving periodic advertisements, false otherwise.
Definition bluetooth.h:1819
Parameters for synchronizing with specific periodic advertising subevents.
Definition bluetooth.h:2884
uint8_t * subevents
The subevent(s) to synchronize with.
Definition bluetooth.h:2900
uint16_t properties
Periodic Advertising Properties.
Definition bluetooth.h:2890
uint8_t num_subevents
Number of subevents to sync to.
Definition bluetooth.h:2893
Information about the successful synchronization with periodic advertising.
Definition bluetooth.h:1708
bool recv_enabled
True if receiving periodic advertisements, false otherwise.
Definition bluetooth.h:1722
uint16_t interval
Periodic advertising interval (N * 1.25 ms)
Definition bluetooth.h:1716
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1713
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1710
uint8_t phy
Advertiser PHY (see bt_gap_le_phy).
Definition bluetooth.h:1719
struct bt_conn * conn
Peer that transferred the periodic advertising sync.
Definition bluetooth.h:1737
uint16_t service_data
Service Data provided by the peer when sync is transferred.
Definition bluetooth.h:1729
Information about the termination of a periodic advertising sync.
Definition bluetooth.h:1764
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1766
uint8_t reason
Cause of periodic advertising termination (see the BT_HCI_ERR_* values).
Definition bluetooth.h:1772
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1769
Parameters for periodic advertising sync transfer.
Definition bluetooth.h:2198
uint32_t options
Periodic Advertising Sync Transfer options, see bt_le_per_adv_sync_transfer_opt.
Definition bluetooth.h:2216
uint16_t timeout
Synchronization timeout (N * 10 ms)
Definition bluetooth.h:2213
uint16_t skip
Maximum event skip.
Definition bluetooth.h:2205
Listener context for (LE) scanning.
Definition bluetooth.h:2462
void(* timeout)(void)
The scanner has stopped scanning after scan timeout.
Definition bluetooth.h:2474
sys_snode_t node
Definition bluetooth.h:2476
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:2470
LE scan parameters.
Definition bluetooth.h:2358
uint8_t type
Scan type.
Definition bluetooth.h:2360
uint16_t interval
Scan interval (N * 0.625 ms).
Definition bluetooth.h:2373
uint16_t window
Scan window (N * 0.625 ms)
Definition bluetooth.h:2383
uint16_t timeout
Scan timeout (N * 10 ms)
Definition bluetooth.h:2391
uint16_t interval_coded
Scan interval LE Coded PHY (N * 0.625 MS)
Definition bluetooth.h:2398
uint16_t window_coded
Scan window LE Coded PHY (N * 0.625 MS)
Definition bluetooth.h:2405
uint8_t options
Bit-field of scanning options.
Definition bluetooth.h:2363
LE advertisement and scan response packet information.
Definition bluetooth.h:2409
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:2452
int8_t tx_power
Transmit power of the advertiser.
Definition bluetooth.h:2425
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:2419
uint8_t primary_phy
Primary advertising channel PHY.
Definition bluetooth.h:2455
int8_t rssi
Strength of advertiser signal.
Definition bluetooth.h:2422
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:2416
uint8_t secondary_phy
Secondary advertising channel PHY.
Definition bluetooth.h:2458
uint8_t adv_type
Advertising packet type.
Definition bluetooth.h:2435
uint16_t adv_props
Advertising packet properties bitfield.
Definition bluetooth.h:2445
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