12#ifndef ZEPHYR_INCLUDE_BLUETOOTH_BLUETOOTH_H_
13#define ZEPHYR_INCLUDE_BLUETOOTH_BLUETOOTH_H_
73#define BT_ID_DEFAULT 0
81#define BT_LE_LOCAL_SUPPORTED_FEATURES_SIZE \
82 (BT_HCI_LE_BYTES_PAGE_0_FEATURE_PAGE + \
83 COND_CODE_1(CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE, \
84 (CONFIG_BT_LE_MAX_LOCAL_SUPPORTED_FEATURE_PAGE \
85 * BT_HCI_LE_BYTES_PER_FEATURE_PAGE), \
255#if defined(CONFIG_BT_PRIVACY)
275#if defined(CONFIG_BT_PER_ADV_RSP) || defined(__DOXYGEN__)
1000#if defined(CONFIG_BT_PER_ADV_RSP) || defined(__DOXYGEN__)
1056#define BT_LE_ADV_PARAM_INIT(_options, _int_min, _int_max, _peer) \
1058 .id = BT_ID_DEFAULT, \
1060 .secondary_max_skip = 0, \
1061 .options = (_options), \
1062 .interval_min = (_int_min), \
1063 .interval_max = (_int_max), \
1076#define BT_LE_ADV_PARAM(_options, _int_min, _int_max, _peer) \
1077 ((const struct bt_le_adv_param[]) { \
1078 BT_LE_ADV_PARAM_INIT(_options, _int_min, _int_max, _peer) \
1081#define BT_LE_ADV_CONN_DIR(_peer) BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, 0, 0, _peer)
1111#define BT_LE_ADV_CONN_FAST_1 \
1112 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_1, BT_GAP_ADV_FAST_INT_MAX_1, \
1131#define BT_LE_ADV_CONN_FAST_2 \
1132 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_2, BT_GAP_ADV_FAST_INT_MAX_2, \
1135#define BT_LE_ADV_CONN_DIR_LOW_DUTY(_peer) \
1136 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN | BT_LE_ADV_OPT_DIR_MODE_LOW_DUTY, \
1137 BT_GAP_ADV_FAST_INT_MIN_2, BT_GAP_ADV_FAST_INT_MAX_2, _peer)
1140#define BT_LE_ADV_NCONN BT_LE_ADV_PARAM(0, BT_GAP_ADV_FAST_INT_MIN_2, \
1141 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1144#define BT_LE_ADV_NCONN_IDENTITY BT_LE_ADV_PARAM(BT_LE_ADV_OPT_USE_IDENTITY, \
1145 BT_GAP_ADV_FAST_INT_MIN_2, \
1146 BT_GAP_ADV_FAST_INT_MAX_2, \
1150#define BT_LE_EXT_ADV_CONN \
1151 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | BT_LE_ADV_OPT_CONN, BT_GAP_ADV_FAST_INT_MIN_2, \
1152 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1155#define BT_LE_EXT_ADV_SCAN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1156 BT_LE_ADV_OPT_SCANNABLE, \
1157 BT_GAP_ADV_FAST_INT_MIN_2, \
1158 BT_GAP_ADV_FAST_INT_MAX_2, \
1162#define BT_LE_EXT_ADV_NCONN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV, \
1163 BT_GAP_ADV_FAST_INT_MIN_2, \
1164 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1167#define BT_LE_EXT_ADV_NCONN_IDENTITY \
1168 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1169 BT_LE_ADV_OPT_USE_IDENTITY, \
1170 BT_GAP_ADV_FAST_INT_MIN_2, \
1171 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1174#define BT_LE_EXT_ADV_CODED_NCONN BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | \
1175 BT_LE_ADV_OPT_CODED, \
1176 BT_GAP_ADV_FAST_INT_MIN_2, \
1177 BT_GAP_ADV_FAST_INT_MAX_2, \
1183#define BT_LE_EXT_ADV_CODED_NCONN_IDENTITY \
1184 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV | BT_LE_ADV_OPT_CODED | \
1185 BT_LE_ADV_OPT_USE_IDENTITY, \
1186 BT_GAP_ADV_FAST_INT_MIN_2, \
1187 BT_GAP_ADV_FAST_INT_MAX_2, NULL)
1195#define BT_LE_EXT_ADV_START_PARAM_INIT(_timeout, _n_evts) \
1197 .timeout = (_timeout), \
1198 .num_events = (_n_evts), \
1207#define BT_LE_EXT_ADV_START_PARAM(_timeout, _n_evts) \
1208 ((const struct bt_le_ext_adv_start_param[]) { \
1209 BT_LE_EXT_ADV_START_PARAM_INIT((_timeout), (_n_evts)) \
1212#define BT_LE_EXT_ADV_START_DEFAULT BT_LE_EXT_ADV_START_PARAM(0, 0)
1222#define BT_LE_PER_ADV_PARAM_INIT(_int_min, _int_max, _options) \
1224 .interval_min = (_int_min), \
1225 .interval_max = (_int_max), \
1226 .options = (_options), \
1237#define BT_LE_PER_ADV_PARAM(_int_min, _int_max, _options) \
1238 ((struct bt_le_per_adv_param[]) { \
1239 BT_LE_PER_ADV_PARAM_INIT(_int_min, _int_max, _options) \
1242#define BT_LE_PER_ADV_DEFAULT BT_LE_PER_ADV_PARAM(BT_GAP_PER_ADV_SLOW_INT_MIN, \
1243 BT_GAP_PER_ADV_SLOW_INT_MAX, \
1244 BT_LE_PER_ADV_OPT_NONE)
1275 const struct bt_data *ad,
size_t ad_len,
1276 const struct bt_data *sd,
size_t sd_len);
1291 const struct bt_data *sd,
size_t sd_len);
1452 const struct bt_data *ad,
size_t ad_len,
1453 const struct bt_data *sd,
size_t sd_len);
1597 const struct bt_data *ad,
size_t ad_len);
1736#if defined(CONFIG_BT_PER_ADV_SYNC_RSP)
1747 uint8_t response_slot_spacing;
1807#if defined(CONFIG_BT_PER_ADV_SYNC_RSP)
2513#define BT_LE_SCAN_PARAM_INIT(_type, _options, _interval, _window) \
2516 .options = (_options), \
2517 .interval = (_interval), \
2518 .window = (_window), \
2520 .interval_coded = 0, \
2521 .window_coded = 0, \
2532#define BT_LE_SCAN_PARAM(_type, _options, _interval, _window) \
2533 ((struct bt_le_scan_param[]) { \
2534 BT_LE_SCAN_PARAM_INIT(_type, _options, _interval, _window) \
2540#define BT_LE_SCAN_ACTIVE BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2541 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2542 BT_GAP_SCAN_FAST_INTERVAL, \
2543 BT_GAP_SCAN_FAST_WINDOW)
2550#define BT_LE_SCAN_ACTIVE_CONTINUOUS BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2551 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2552 BT_GAP_SCAN_FAST_INTERVAL_MIN, \
2553 BT_GAP_SCAN_FAST_WINDOW)
2555 "Continuous scanning is requested by setting window and interval equal.");
2563#define BT_LE_SCAN_PASSIVE BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2564 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2565 BT_GAP_SCAN_FAST_INTERVAL, \
2566 BT_GAP_SCAN_FAST_WINDOW)
2574#define BT_LE_SCAN_PASSIVE_CONTINUOUS BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2575 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2576 BT_GAP_SCAN_FAST_INTERVAL_MIN, \
2577 BT_GAP_SCAN_FAST_WINDOW)
2579 "Continuous scanning is requested by setting window and interval equal.");
2585#define BT_LE_SCAN_CODED_ACTIVE \
2586 BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_ACTIVE, \
2587 BT_LE_SCAN_OPT_CODED | \
2588 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2589 BT_GAP_SCAN_FAST_INTERVAL, \
2590 BT_GAP_SCAN_FAST_WINDOW)
2599#define BT_LE_SCAN_CODED_PASSIVE \
2600 BT_LE_SCAN_PARAM(BT_LE_SCAN_TYPE_PASSIVE, \
2601 BT_LE_SCAN_OPT_CODED | \
2602 BT_LE_SCAN_OPT_FILTER_DUPLICATE, \
2603 BT_GAP_SCAN_FAST_INTERVAL, \
2604 BT_GAP_SCAN_FAST_WINDOW)
2772 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:1563
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:939
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:312
bt_le_ext_adv_state
Advertising states.
Definition bluetooth.h:1495
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.
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:1504
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:2159
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:81
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.
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:2340
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:1922
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:946
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:2361
bt_le_adv_opt
Advertising options.
Definition bluetooth.h:613
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:1497
@ BT_LE_EXT_ADV_STATE_ENABLED
The advertising set is enabled.
Definition bluetooth.h:1500
@ BT_LE_PER_ADV_STATE_ENABLED
Periodic advertising is enabled.
Definition bluetooth.h:1512
@ BT_LE_PER_ADV_STATE_DISABLED
The advertising set has been configured for periodic advertising, but is not enabled.
Definition bluetooth.h:1509
@ BT_LE_PER_ADV_STATE_NONE
Not configured for periodic advertising.
Definition bluetooth.h:1506
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOA
No Angle of Arrival (AoA).
Definition bluetooth.h:2168
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_REPORTING_INITIALLY_DISABLED
Sync to received PAST packets but don't generate sync reports.
Definition bluetooth.h:2195
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOD_2US
No Angle of Departure (AoD) 2.
Definition bluetooth.h:2184
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_NO_AOD_1US
No Angle of Departure (AoD) 1 us.
Definition bluetooth.h:2176
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_FILTER_DUPLICATES
Sync to received PAST packets and generate sync reports with duplicate filtering.
Definition bluetooth.h:2203
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_SYNC_ONLY_CTE
Only sync to packets with constant tone extension.
Definition bluetooth.h:2187
@ BT_LE_PER_ADV_SYNC_TRANSFER_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2161
@ BT_LE_SCAN_OPT_FILTER_DUPLICATE
Filter duplicates.
Definition bluetooth.h:2345
@ BT_LE_SCAN_OPT_CODED
Enable scan on coded PHY (Long Range).
Definition bluetooth.h:2351
@ BT_LE_SCAN_OPT_NO_1M
Disable scan on 1M phy.
Definition bluetooth.h:2358
@ BT_LE_SCAN_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:2342
@ BT_LE_SCAN_OPT_FILTER_ACCEPT_LIST
Filter using filter accept list.
Definition bluetooth.h:2348
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOD_2US
Sync with Angle of Departure (AoD) 2 us constant tone extension.
Definition bluetooth.h:1951
@ BT_LE_PER_ADV_SYNC_OPT_SYNC_ONLY_CONST_TONE_EXT
Do not sync to packets without a constant tone extension.
Definition bluetooth.h:1954
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOD_1US
Sync with Angle of Departure (AoD) 1 us constant tone extension.
Definition bluetooth.h:1948
@ BT_LE_PER_ADV_SYNC_OPT_FILTER_DUPLICATE
Filter duplicate Periodic Advertising reports.
Definition bluetooth.h:1942
@ BT_LE_PER_ADV_SYNC_OPT_DONT_SYNC_AOA
Sync with Angle of Arrival (AoA) constant tone extension.
Definition bluetooth.h:1945
@ BT_LE_PER_ADV_SYNC_OPT_REPORTING_INITIALLY_DISABLED
Disables periodic advertising reports.
Definition bluetooth.h:1939
@ BT_LE_PER_ADV_SYNC_OPT_USE_PER_ADV_LIST
Use the periodic advertising list to sync with advertiser.
Definition bluetooth.h:1932
@ BT_LE_PER_ADV_SYNC_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:1924
@ BT_LE_PER_ADV_OPT_INCLUDE_ADI
Advertise with included AdvDataInfo (ADI).
Definition bluetooth.h:964
@ BT_LE_PER_ADV_OPT_USE_TX_POWER
Advertise with transmit power.
Definition bluetooth.h:956
@ BT_LE_PER_ADV_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:948
@ BT_LE_SCAN_TYPE_PASSIVE
Scan without requesting additional information from advertisers.
Definition bluetooth.h:2363
@ BT_LE_SCAN_TYPE_ACTIVE
Scan and request additional information from advertisers.
Definition bluetooth.h:2372
@ 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:684
@ BT_LE_ADV_OPT_ANONYMOUS
Advertise without a device address (identity address or RPA).
Definition bluetooth.h:754
@ BT_LE_ADV_OPT_USE_NRPA
Advertise using a Non-Resolvable Private Address.
Definition bluetooth.h:783
@ BT_LE_ADV_OPT_USE_IDENTITY
Advertise using identity address.
Definition bluetooth.h:649
@ BT_LE_ADV_OPT_FILTER_SCAN_REQ
Use filter accept list to filter devices that can request scan response data.
Definition bluetooth.h:676
@ BT_LE_ADV_OPT_DISABLE_CHAN_39
Disable advertising on channel index 39.
Definition bluetooth.h:771
@ BT_LE_ADV_OPT_NONE
Convenience value when no options are specified.
Definition bluetooth.h:615
@ BT_LE_ADV_OPT_REQUIRE_S2_CODING
Configures the advertiser to use the S=2 coding scheme for LE Coded PHY.
Definition bluetooth.h:800
@ BT_LE_ADV_OPT_CONN
Connectable advertising.
Definition bluetooth.h:637
@ BT_LE_ADV_OPT_REQUIRE_S8_CODING
Configures the advertiser to use the S=8 coding scheme for LE Coded PHY.
Definition bluetooth.h:817
@ BT_LE_ADV_OPT_DISABLE_CHAN_37
Disable advertising on channel index 37.
Definition bluetooth.h:765
@ BT_LE_ADV_OPT_TX_POWER
Request a specific TX power level for the advertising set.
Definition bluetooth.h:830
@ BT_LE_ADV_OPT_DISABLE_CHAN_38
Disable advertising on channel index 38.
Definition bluetooth.h:768
@ BT_LE_ADV_OPT_DIR_ADDR_RPA
Directed advertising to privacy-enabled peer.
Definition bluetooth.h:671
@ BT_LE_ADV_OPT_CODED
Advertise on the LE Coded PHY (Long Range).
Definition bluetooth.h:746
@ BT_LE_ADV_OPT_FILTER_CONN
Use filter accept list to filter devices that can connect.
Definition bluetooth.h:679
@ BT_LE_ADV_OPT_EXT_ADV
Advertise with extended advertising.
Definition bluetooth.h:716
@ BT_LE_ADV_OPT_SCANNABLE
Support scan response data.
Definition bluetooth.h:694
@ BT_LE_ADV_OPT_NO_2M
Disable use of LE 2M PHY on the secondary advertising channel.
Definition bluetooth.h:733
@ BT_LE_ADV_OPT_USE_TX_POWER
Advertise with transmit power.
Definition bluetooth.h:762
@ BT_LE_ADV_OPT_DIR_MODE_LOW_DUTY
Low duty cycle directed advertising.
Definition bluetooth.h:657
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:42
#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:49
Information about a bond with a remote device.
Definition bluetooth.h:2872
bt_addr_le_t addr
Address of the remote device.
Definition bluetooth.h:2874
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:834
int8_t tx_power
Requested TX power in dBm.
Definition bluetooth.h:876
uint32_t options
Bit-field of advertising options, see the bt_le_adv_opt field.
Definition bluetooth.h:879
const bt_addr_le_t * peer
Directed advertising to peer.
Definition bluetooth.h:924
uint8_t sid
Advertising Set Identifier, valid range is BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:854
uint8_t secondary_max_skip
Secondary channel maximum skip count.
Definition bluetooth.h:865
uint32_t interval_min
Minimum Advertising Interval (N * 0.625 milliseconds).
Definition bluetooth.h:893
uint8_t id
Local identity handle.
Definition bluetooth.h:845
uint32_t interval_max
Maximum Advertising Interval (N * 0.625 milliseconds).
Definition bluetooth.h:907
Callback struct to notify about advertiser activity.
Definition bluetooth.h:216
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:252
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:300
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:239
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:227
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:287
Info of the advertising connected event.
Definition bluetooth.h:129
struct bt_conn * conn
Connection object of the new connection.
Definition bluetooth.h:131
Advertising set info structure.
Definition bluetooth.h:1516
uint8_t id
Local identity handle.
Definition bluetooth.h:1518
enum bt_le_ext_adv_state ext_adv_state
Extended advertising state.
Definition bluetooth.h:1530
const bt_addr_le_t * addr
Current local advertising address used.
Definition bluetooth.h:1527
uint8_t sid
Advertising Set ID.
Definition bluetooth.h:1524
int8_t tx_power
Currently selected Transmit Power in dBm.
Definition bluetooth.h:1521
enum bt_le_per_adv_state per_adv_state
Periodic advertising state.
Definition bluetooth.h:1533
Info of the advertising scanned event.
Definition bluetooth.h:139
bt_addr_le_t * addr
Active scanner LE address and type.
Definition bluetooth.h:141
Info of the advertising sent event.
Definition bluetooth.h:114
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:121
Parameters for starting an extended advertising session.
Definition bluetooth.h:1338
uint16_t timeout
Maximum advertising set duration (N * 10 ms).
Definition bluetooth.h:1363
uint8_t num_events
Maximum number of extended advertising events to be sent.
Definition bluetooth.h:1383
Opaque type representing an advertiser.
Local Bluetooth LE controller features and capabilities.
Definition bluetooth.h:540
uint8_t acl_pkts
Total number of ACL data packets.
Definition bluetooth.h:568
uint16_t acl_mtu
ACL data packet length.
Definition bluetooth.h:566
uint8_t features[(8+0U)]
Local LE controller supported features.
Definition bluetooth.h:548
uint8_t iso_pkts
Total number of ISO data packets.
Definition bluetooth.h:580
uint16_t max_adv_data_len
Maximum advertising data length.
Definition bluetooth.h:596
uint64_t states
Local LE controller supported states.
Definition bluetooth.h:556
uint8_t rl_size
Maximum size of the controller resolving list.
Definition bluetooth.h:587
uint16_t iso_mtu
ISO data packet length.
Definition bluetooth.h:578
LE Secure Connections pairing Out of Band data.
Definition bluetooth.h:2776
uint8_t c[16]
Confirm Value.
Definition bluetooth.h:2781
uint8_t r[16]
Random Number.
Definition bluetooth.h:2778
LE Out of Band information.
Definition bluetooth.h:2785
bt_addr_le_t addr
LE address.
Definition bluetooth.h:2789
struct bt_le_oob_sc_data le_sc_data
LE Secure Connections pairing Out of Band data.
Definition bluetooth.h:2792
Info of the PAwR subevents.
Definition bluetooth.h:153
uint8_t count
The number of subevents data can be set for.
Definition bluetooth.h:158
uint8_t start
The first subevent data can be set for.
Definition bluetooth.h:155
Parameters for configuring periodic advertising.
Definition bluetooth.h:980
uint8_t response_slot_delay
Time between the advertising packet in a subevent and the first response slot (N * 1....
Definition bluetooth.h:1025
uint8_t num_response_slots
Number of subevent response slots.
Definition bluetooth.h:1043
uint8_t subevent_interval
Interval between subevents (N * 1.25 ms).
Definition bluetooth.h:1017
uint16_t interval_min
Minimum Periodic Advertising Interval (N * 1.25 ms).
Definition bluetooth.h:987
uint16_t interval_max
Maximum Periodic Advertising Interval (N * 1.25 ms).
Definition bluetooth.h:995
uint8_t response_slot_spacing
Time between response slots (N * 0.125 ms).
Definition bluetooth.h:1034
uint32_t options
Bit-field of periodic advertising options, see the bt_le_per_adv_opt field.
Definition bluetooth.h:998
uint8_t num_subevents
Number of subevents.
Definition bluetooth.h:1008
Info about the PAwR responses received.
Definition bluetooth.h:171
uint8_t subevent
The subevent the response was received in.
Definition bluetooth.h:173
int8_t rssi
The RSSI of the response in dBm.
Definition bluetooth.h:187
uint8_t cte_type
The Constant Tone Extension (CTE) of the advertisement (bt_df_cte_type).
Definition bluetooth.h:190
int8_t tx_power
The TX power of the response in dBm.
Definition bluetooth.h:184
uint8_t response_slot
The slot the response was received in.
Definition bluetooth.h:193
uint8_t tx_status
Status of the subevent indication.
Definition bluetooth.h:181
Parameters for sending a periodic advertising response.
Definition bluetooth.h:2956
uint8_t response_subevent
The subevent the response shall be sent in.
Definition bluetooth.h:2977
uint16_t request_event
The periodic event counter of the request the response is sent to.
Definition bluetooth.h:2966
uint8_t request_subevent
The subevent counter of the request the response is sent to.
Definition bluetooth.h:2974
uint8_t response_slot
The response slot the response shall be sent in.
Definition bluetooth.h:2980
Parameters for setting data for a specific periodic advertising with response subevent.
Definition bluetooth.h:1630
uint8_t response_slot_start
The first response slot to listen to.
Definition bluetooth.h:1635
const struct net_buf_simple * data
The data to send.
Definition bluetooth.h:1641
uint8_t subevent
The subevent to set data for.
Definition bluetooth.h:1632
uint8_t response_slot_count
The number of response slots to listen to.
Definition bluetooth.h:1638
Callback struct for periodic advertising sync events.
Definition bluetooth.h:1839
sys_snode_t node
Definition bluetooth.h:1918
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:1879
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:1893
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:1850
void(* biginfo)(struct bt_le_per_adv_sync *sync, const struct bt_iso_biginfo *biginfo)
BIGInfo advertising report received.
Definition bluetooth.h:1906
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:1863
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:1915
Periodic advertising set info structure.
Definition bluetooth.h:2035
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:2043
uint8_t phy
Advertiser PHY (see bt_gap_le_phy).
Definition bluetooth.h:2046
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bluetooth.h:2037
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:2040
Parameters for creating a periodic advertising sync object.
Definition bluetooth.h:1968
uint16_t timeout
Synchronization timeout (N * 10 ms).
Definition bluetooth.h:2004
uint32_t options
Bit-field of periodic advertising sync options, see the bt_le_adv_opt field.
Definition bluetooth.h:1987
uint8_t sid
Advertising Set Identifier.
Definition bluetooth.h:1984
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bluetooth.h:1975
uint16_t skip
Maximum event skip.
Definition bluetooth.h:1996
Information about a received periodic advertising report.
Definition bluetooth.h:1784
uint8_t cte_type
The Constant Tone Extension (CTE) of the advertisement (bt_df_cte_type).
Definition bluetooth.h:1806
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1789
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1786
int8_t tx_power
The TX power of the advertisement in dBm.
Definition bluetooth.h:1796
int8_t rssi
The RSSI of the advertisement (excluding any CTE), in dBm.
Definition bluetooth.h:1803
Information about the state of periodic advertising sync.
Definition bluetooth.h:1823
bool recv_enabled
True if receiving periodic advertisements, false otherwise.
Definition bluetooth.h:1825
Parameters for synchronizing with specific periodic advertising subevents.
Definition bluetooth.h:2916
uint8_t * subevents
The subevent(s) to synchronize with.
Definition bluetooth.h:2932
uint16_t properties
Periodic Advertising Properties.
Definition bluetooth.h:2922
uint8_t num_subevents
Number of subevents to sync to.
Definition bluetooth.h:2925
Information about the successful synchronization with periodic advertising.
Definition bluetooth.h:1706
bool recv_enabled
True if receiving periodic advertisements, false otherwise.
Definition bluetooth.h:1720
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:1714
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1711
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1708
uint8_t phy
Advertiser PHY (see bt_gap_le_phy).
Definition bluetooth.h:1717
struct bt_conn * conn
Peer that transferred the periodic advertising sync.
Definition bluetooth.h:1735
uint16_t service_data
Service Data provided by the peer when sync is transferred.
Definition bluetooth.h:1727
Information about the termination of a periodic advertising sync.
Definition bluetooth.h:1762
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:1764
uint8_t reason
Cause of periodic advertising termination (see the BT_HCI_ERR_* values).
Definition bluetooth.h:1770
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:1767
Parameters for periodic advertising sync transfer.
Definition bluetooth.h:2216
uint32_t options
Periodic Advertising Sync Transfer options, see bt_le_per_adv_sync_transfer_opt.
Definition bluetooth.h:2234
uint16_t timeout
Synchronization timeout (N * 10 ms).
Definition bluetooth.h:2231
uint16_t skip
Maximum event skip.
Definition bluetooth.h:2223
Opaque type representing a periodic advertising sync.
Listener context for (LE) scanning.
Definition bluetooth.h:2488
void(* timeout)(void)
The scanner has stopped scanning after scan timeout.
Definition bluetooth.h:2500
sys_snode_t node
Definition bluetooth.h:2502
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:2496
LE scan parameters.
Definition bluetooth.h:2376
uint8_t type
Scan type.
Definition bluetooth.h:2378
uint16_t interval
Scan interval (N * 0.625 ms).
Definition bluetooth.h:2391
uint16_t window
Scan window (N * 0.625 ms).
Definition bluetooth.h:2401
uint16_t timeout
Scan timeout (N * 10 ms).
Definition bluetooth.h:2409
uint16_t interval_coded
Scan interval LE Coded PHY (N * 0.625 MS).
Definition bluetooth.h:2416
uint16_t window_coded
Scan window LE Coded PHY (N * 0.625 MS).
Definition bluetooth.h:2423
uint8_t options
Bit-field of scanning options.
Definition bluetooth.h:2381
LE advertisement and scan response packet information.
Definition bluetooth.h:2427
uint16_t interval
Periodic advertising interval (N * 1.25 ms).
Definition bluetooth.h:2478
int8_t tx_power
Transmit power of the advertiser in dBm.
Definition bluetooth.h:2451
uint8_t sid
Advertising Set Identifier, valid range BT_GAP_SID_MIN to BT_GAP_SID_MAX.
Definition bluetooth.h:2437
uint8_t primary_phy
Primary advertising channel PHY.
Definition bluetooth.h:2481
int8_t rssi
Strength of advertiser signal in dBm.
Definition bluetooth.h:2444
const bt_addr_le_t * addr
Advertiser LE address and type.
Definition bluetooth.h:2434
uint8_t secondary_phy
Secondary advertising channel PHY.
Definition bluetooth.h:2484
uint8_t adv_type
Advertising packet type.
Definition bluetooth.h:2461
uint16_t adv_props
Advertising packet properties bitfield.
Definition bluetooth.h:2471
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