Zephyr API Documentation 4.1.99
A Scalable Open Source RTOS
 4.1.99
All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
bap.h
Go to the documentation of this file.
1
11#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_BAP_
12#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_BAP_
13
27#include <stdbool.h>
28#include <stddef.h>
29#include <stdint.h>
30
31#include <zephyr/autoconf.h>
39#include <zephyr/net_buf.h>
40#include <zephyr/sys/slist.h>
42
43#ifdef __cplusplus
44extern "C" {
45#endif
46
48#define BT_BAP_BASS_MAX_SUBGROUPS \
49 COND_CODE_1(CONFIG_BT_AUDIO, (CONFIG_BT_BAP_BASS_MAX_SUBGROUPS), (0))
50
52#define BT_BASE_MAX_SIZE (UINT8_MAX - 1 /* type */ - BT_UUID_SIZE_16)
53
55#define BT_BAP_INVALID_BROADCAST_ID 0xFFFFFFFFU
56
65#define BT_BAP_ADV_PARAM_CONN_QUICK \
66 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN | BT_LE_ADV_OPT_EXT_ADV, BT_GAP_MS_TO_ADV_INTERVAL(20), \
67 BT_GAP_MS_TO_ADV_INTERVAL(30), NULL)
68
74#define BT_BAP_ADV_PARAM_CONN_REDUCED \
75 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_CONN | BT_LE_ADV_OPT_EXT_ADV, \
76 BT_GAP_MS_TO_ADV_INTERVAL(150), BT_GAP_MS_TO_ADV_INTERVAL(150), NULL)
77
86#define BT_BAP_CONN_PARAM_SHORT_7_5 \
87 BT_LE_CONN_PARAM(BT_GAP_US_TO_CONN_INTERVAL(7500), BT_GAP_MS_TO_CONN_INTERVAL(30), 0, \
88 BT_GAP_MS_TO_CONN_TIMEOUT(4000))
89
98#define BT_BAP_CONN_PARAM_SHORT_10 \
99 BT_LE_CONN_PARAM(BT_GAP_MS_TO_CONN_INTERVAL(10), BT_GAP_MS_TO_CONN_INTERVAL(30), 0, \
100 BT_GAP_MS_TO_CONN_TIMEOUT(4000))
101
107#define BT_BAP_CONN_PARAM_RELAXED \
108 BT_LE_CONN_PARAM(BT_GAP_MS_TO_CONN_INTERVAL(50), BT_GAP_MS_TO_CONN_INTERVAL(70), 0, \
109 BT_GAP_MS_TO_CONN_TIMEOUT(4000))
110
117#define BT_BAP_ADV_PARAM_BROADCAST_FAST \
118 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV, BT_GAP_MS_TO_ADV_INTERVAL(60), \
119 BT_GAP_MS_TO_ADV_INTERVAL(60), NULL)
120
127#define BT_BAP_ADV_PARAM_BROADCAST_SLOW \
128 BT_LE_ADV_PARAM(BT_LE_ADV_OPT_EXT_ADV, BT_GAP_MS_TO_ADV_INTERVAL(150), \
129 BT_GAP_MS_TO_ADV_INTERVAL(150), NULL)
130
137#define BT_BAP_PER_ADV_PARAM_BROADCAST_FAST \
138 BT_LE_PER_ADV_PARAM(BT_GAP_MS_TO_PER_ADV_INTERVAL(60), BT_GAP_MS_TO_PER_ADV_INTERVAL(60), \
139 BT_LE_PER_ADV_OPT_NONE)
140
147#define BT_BAP_PER_ADV_PARAM_BROADCAST_SLOW \
148 BT_LE_PER_ADV_PARAM(BT_GAP_MS_TO_PER_ADV_INTERVAL(150), \
149 BT_GAP_MS_TO_PER_ADV_INTERVAL(150), BT_LE_PER_ADV_OPT_NONE)
150
159#define BT_BAP_BASS_VALID_BIT_BITFIELD(_bis_bitfield) \
160 ((_bis_bitfield) == 0U || (_bis_bitfield) == BT_BAP_BIS_SYNC_NO_PREF || \
161 BT_ISO_VALID_BIS_BITFIELD(_bis_bitfield))
162
174#define BT_BAP_QOS_CFG(_interval, _framing, _phy, _sdu, _rtn, _latency, _pd) \
175 ((struct bt_bap_qos_cfg){ \
176 .interval = _interval, \
177 .framing = _framing, \
178 .phy = _phy, \
179 .sdu = _sdu, \
180 .rtn = _rtn, \
181 IF_ENABLED(UTIL_OR(IS_ENABLED(CONFIG_BT_BAP_BROADCAST_SOURCE), \
182 IS_ENABLED(CONFIG_BT_BAP_UNICAST)), \
183 (.latency = _latency,)) \
184 .pd = _pd, \
185 })
186
194
196enum {
203};
204
214#define BT_BAP_QOS_CFG_UNFRAMED(_interval, _sdu, _rtn, _latency, _pd) \
215 BT_BAP_QOS_CFG(_interval, BT_BAP_QOS_CFG_FRAMING_UNFRAMED, BT_BAP_QOS_CFG_2M, _sdu, _rtn, \
216 _latency, _pd)
217
227#define BT_BAP_QOS_CFG_FRAMED(_interval, _sdu, _rtn, _latency, _pd) \
228 BT_BAP_QOS_CFG(_interval, BT_BAP_QOS_CFG_FRAMING_FRAMED, BT_BAP_QOS_CFG_2M, _sdu, _rtn, \
229 _latency, _pd)
230
244
252 struct {
255
263
271
278
279#if defined(CONFIG_BT_BAP_BROADCAST_SOURCE) || defined(CONFIG_BT_BAP_UNICAST) || \
280 defined(__DOXYGEN__)
287#endif /* CONFIG_BT_BAP_BROADCAST_SOURCE || CONFIG_BT_BAP_UNICAST */
288
295
296#if defined(CONFIG_BT_ISO_TEST_PARAMS) || defined(__DOXYGEN__)
309
316
325#endif /* CONFIG_BT_ISO_TEST_PARAMS */
326 };
327};
328
341#define BT_BAP_QOS_CFG_PREF(_unframed_supported, _phy, _rtn, _latency, _pd_min, _pd_max, \
342 _pref_pd_min, _pref_pd_max) \
343 { \
344 .unframed_supported = _unframed_supported, .phy = _phy, .rtn = _rtn, \
345 .latency = _latency, .pd_min = _pd_min, .pd_max = _pd_max, \
346 .pref_pd_min = _pref_pd_min, .pref_pd_max = _pref_pd_max, \
347 }
348
416
434
449
458
460#define BT_BAP_PA_INTERVAL_UNKNOWN 0xFFFF
461
468#define BT_BAP_BIS_SYNC_NO_PREF 0xFFFFFFFF
470#define BT_BAP_BIS_SYNC_FAILED 0xFFFFFFFF
471
495
534
566
618
626#define BT_BAP_ASCS_RSP(c, r) (struct bt_bap_ascs_rsp) { .code = c, .reason = r }
627
629struct bt_bap_broadcast_source;
630
632struct bt_bap_broadcast_sink;
633
635struct bt_bap_unicast_group;
636
638struct bt_bap_ep;
639
644
647
648#if defined(CONFIG_BT_AUDIO_CODEC_CFG_MAX_METADATA_SIZE) || defined(__DOXYGEN__)
650 uint8_t metadata[CONFIG_BT_AUDIO_CODEC_CFG_MAX_METADATA_SIZE];
651#endif /* CONFIG_BT_AUDIO_CODEC_CFG_MAX_METADATA_SIZE */
652};
653
691
707 void (*recv_state_updated)(struct bt_conn *conn,
708 const struct bt_bap_scan_delegator_recv_state *recv_state);
709
726 int (*pa_sync_req)(struct bt_conn *conn,
727 const struct bt_bap_scan_delegator_recv_state *recv_state,
728 bool past_avail, uint16_t pa_interval);
729
743 int (*pa_sync_term_req)(struct bt_conn *conn,
744 const struct bt_bap_scan_delegator_recv_state *recv_state);
745
757 void (*broadcast_code)(struct bt_conn *conn,
758 const struct bt_bap_scan_delegator_recv_state *recv_state,
781 int (*bis_sync_req)(struct bt_conn *conn,
782 const struct bt_bap_scan_delegator_recv_state *recv_state,
793 void (*scanning_state)(struct bt_conn *conn, bool is_scanning);
807 int (*add_source)(struct bt_conn *conn,
808 const struct bt_bap_scan_delegator_recv_state *recv_state);
809
823 int (*modify_source)(struct bt_conn *conn,
824 const struct bt_bap_scan_delegator_recv_state *recv_state);
825
839 int (*remove_source)(struct bt_conn *conn, uint8_t src_id);
840};
841
846
849
852
855
858
861
865 struct bt_bap_ep *paired_ep;
866
869};
870
880int bt_bap_ep_get_info(const struct bt_bap_ep *ep, struct bt_bap_ep_info *info);
881
892 struct bt_conn *conn;
893
895 struct bt_bap_ep *ep;
896
899
902
905
908
909#if defined(CONFIG_BT_BAP_UNICAST_CLIENT) || defined(__DOXYGEN__)
916 struct bt_bap_iso *bap_iso;
917#endif /* CONFIG_BT_BAP_UNICAST_CLIENT */
918
920 void *group;
921
922#if defined(CONFIG_BT_BAP_DEBUG_STREAM_SEQ_NUM) || defined(__DOXYGEN__)
924 uint16_t _prev_seq_num;
925#endif /* CONFIG_BT_BAP_DEBUG_STREAM_SEQ_NUM */
926
928 sys_snode_t _node;
930};
931
934#if defined(CONFIG_BT_BAP_UNICAST) || defined(__DOXYGEN__)
943 void (*configured)(struct bt_bap_stream *stream, const struct bt_bap_qos_cfg_pref *pref);
944
953 void (*qos_set)(struct bt_bap_stream *stream);
954
962 void (*enabled)(struct bt_bap_stream *stream);
963
972 void (*metadata_updated)(struct bt_bap_stream *stream);
973
981 void (*disabled)(struct bt_bap_stream *stream);
982
991 void (*released)(struct bt_bap_stream *stream);
992#endif /* CONFIG_BT_BAP_UNICAST */
993
1002 void (*started)(struct bt_bap_stream *stream);
1003
1012 void (*stopped)(struct bt_bap_stream *stream, uint8_t reason);
1013
1014#if defined(CONFIG_BT_AUDIO_RX) || defined(__DOXYGEN__)
1026 void (*recv)(struct bt_bap_stream *stream, const struct bt_iso_recv_info *info,
1027 struct net_buf *buf);
1028#endif /* CONFIG_BT_AUDIO_RX */
1029
1030#if defined(CONFIG_BT_AUDIO_TX) || defined(__DOXYGEN__)
1043 void (*sent)(struct bt_bap_stream *stream);
1044#endif /* CONFIG_BT_AUDIO_TX */
1045
1058 void (*connected)(struct bt_bap_stream *stream);
1059
1072 void (*disconnected)(struct bt_bap_stream *stream, uint8_t reason);
1073};
1074
1090
1100
1114int bt_bap_stream_config(struct bt_conn *conn, struct bt_bap_stream *stream, struct bt_bap_ep *ep,
1115 struct bt_audio_codec_cfg *codec_cfg);
1116
1130int bt_bap_stream_reconfig(struct bt_bap_stream *stream, struct bt_audio_codec_cfg *codec_cfg);
1131
1144int bt_bap_stream_qos(struct bt_conn *conn, struct bt_bap_unicast_group *group);
1145
1160int bt_bap_stream_enable(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len);
1161
1173int bt_bap_stream_metadata(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len);
1174
1188
1213
1237
1262
1277
1292int bt_bap_stream_send(struct bt_bap_stream *stream, struct net_buf *buf, uint16_t seq_num);
1293
1310int bt_bap_stream_send_ts(struct bt_bap_stream *stream, struct net_buf *buf, uint16_t seq_num,
1311 uint32_t ts);
1312
1332
1359 int (*config)(struct bt_conn *conn, const struct bt_bap_ep *ep, enum bt_audio_dir dir,
1360 const struct bt_audio_codec_cfg *codec_cfg, struct bt_bap_stream **stream,
1361 struct bt_bap_qos_cfg_pref *const pref, struct bt_bap_ascs_rsp *rsp);
1362
1379 int (*reconfig)(struct bt_bap_stream *stream, enum bt_audio_dir dir,
1380 const struct bt_audio_codec_cfg *codec_cfg,
1381 struct bt_bap_qos_cfg_pref *const pref, struct bt_bap_ascs_rsp *rsp);
1382
1396 int (*qos)(struct bt_bap_stream *stream, const struct bt_bap_qos_cfg *qos,
1397 struct bt_bap_ascs_rsp *rsp);
1398
1412 int (*enable)(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len,
1413 struct bt_bap_ascs_rsp *rsp);
1414
1426 int (*start)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);
1427
1441 int (*metadata)(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len,
1442 struct bt_bap_ascs_rsp *rsp);
1443
1455 int (*disable)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);
1456
1468 int (*stop)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);
1469
1482 int (*release)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);
1483};
1484
1496
1512
1526
1541
1549typedef void (*bt_bap_ep_func_t)(struct bt_bap_ep *ep, void *user_data);
1550
1558void bt_bap_unicast_server_foreach_ep(struct bt_conn *conn, bt_bap_ep_func_t func, void *user_data);
1559
1570int bt_bap_unicast_server_config_ase(struct bt_conn *conn, struct bt_bap_stream *stream,
1571 struct bt_audio_codec_cfg *codec_cfg,
1572 const struct bt_bap_qos_cfg_pref *qos_pref);
1573
1574 /* End of group bt_bap_unicast_server */
1575
1590
1604
1609
1612
1621
1622#if defined(CONFIG_BT_ISO_TEST_PARAMS) || defined(__DOXYGEN__)
1632
1642
1651#endif /* CONFIG_BT_ISO_TEST_PARAMS */
1652};
1653
1668 struct bt_bap_unicast_group **unicast_group);
1669
1685int bt_bap_unicast_group_reconfig(struct bt_bap_unicast_group *unicast_group,
1686 const struct bt_bap_unicast_group_param *param);
1687
1707int bt_bap_unicast_group_add_streams(struct bt_bap_unicast_group *unicast_group,
1709 size_t num_param);
1710
1721int bt_bap_unicast_group_delete(struct bt_bap_unicast_group *unicast_group);
1722
1737 void (*location)(struct bt_conn *conn, enum bt_audio_dir dir, enum bt_audio_location loc);
1738
1751 void (*available_contexts)(struct bt_conn *conn, enum bt_audio_context snk_ctx,
1752 enum bt_audio_context src_ctx);
1753
1763 void (*config)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1764 enum bt_bap_ascs_reason reason);
1765
1778 void (*qos)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1779 enum bt_bap_ascs_reason reason);
1780
1791 void (*enable)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1792 enum bt_bap_ascs_reason reason);
1793
1806 void (*start)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1807 enum bt_bap_ascs_reason reason);
1808
1821 void (*stop)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1822 enum bt_bap_ascs_reason reason);
1823
1834 void (*disable)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1835 enum bt_bap_ascs_reason reason);
1836
1847 void (*metadata)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1848 enum bt_bap_ascs_reason reason);
1849
1860 void (*release)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code,
1861 enum bt_bap_ascs_reason reason);
1862
1877 void (*pac_record)(struct bt_conn *conn, enum bt_audio_dir dir,
1878 const struct bt_audio_codec_cap *codec_cap);
1879
1891 void (*endpoint)(struct bt_conn *conn, enum bt_audio_dir dir, struct bt_bap_ep *ep);
1892
1905 void (*discover)(struct bt_conn *conn, int err, enum bt_audio_dir dir);
1906
1909 sys_snode_t _node;
1911};
1912
1926
1936int bt_bap_unicast_client_discover(struct bt_conn *conn, enum bt_audio_dir dir);
1937
1938 /* End of group bt_bap_unicast_client */
1947struct bt_bap_base_subgroup;
1949struct bt_bap_base;
1950
1960
1970
1979const struct bt_bap_base *bt_bap_base_get_base_from_ad(const struct bt_data *ad);
1980
1989int bt_bap_base_get_size(const struct bt_bap_base *base);
1990
1999int bt_bap_base_get_pres_delay(const struct bt_bap_base *base);
2000
2009int bt_bap_base_get_subgroup_count(const struct bt_bap_base *base);
2010
2020int bt_bap_base_get_bis_indexes(const struct bt_bap_base *base, uint32_t *bis_indexes);
2021
2033int bt_bap_base_foreach_subgroup(const struct bt_bap_base *base,
2034 bool (*func)(const struct bt_bap_base_subgroup *subgroup,
2035 void *user_data),
2036 void *user_data);
2037
2047int bt_bap_base_get_subgroup_codec_id(const struct bt_bap_base_subgroup *subgroup,
2048 struct bt_bap_base_codec_id *codec_id);
2049
2059int bt_bap_base_get_subgroup_codec_data(const struct bt_bap_base_subgroup *subgroup,
2060 uint8_t **data);
2061
2071int bt_bap_base_get_subgroup_codec_meta(const struct bt_bap_base_subgroup *subgroup,
2072 uint8_t **meta);
2073
2084int bt_bap_base_subgroup_codec_to_codec_cfg(const struct bt_bap_base_subgroup *subgroup,
2085 struct bt_audio_codec_cfg *codec_cfg);
2086
2095int bt_bap_base_get_subgroup_bis_count(const struct bt_bap_base_subgroup *subgroup);
2096
2106int bt_bap_base_subgroup_get_bis_indexes(const struct bt_bap_base_subgroup *subgroup,
2107 uint32_t *bis_indexes);
2108
2120int bt_bap_base_subgroup_foreach_bis(const struct bt_bap_base_subgroup *subgroup,
2121 bool (*func)(const struct bt_bap_base_subgroup_bis *bis,
2122 void *user_data),
2123 void *user_data);
2124
2139 struct bt_audio_codec_cfg *codec_cfg);
2140
2141 /* End of group bt_bap_broadcast */
2142
2161 void (*started)(struct bt_bap_broadcast_source *source);
2162
2169 void (*stopped)(struct bt_bap_broadcast_source *source, uint8_t reason);
2170
2173 sys_snode_t _node;
2175};
2176
2187
2198
2203
2204#if CONFIG_BT_AUDIO_CODEC_CFG_MAX_DATA_SIZE > 0 || defined(__DOXYGEN__)
2210 size_t data_len;
2211
2214#endif /* CONFIG_BT_AUDIO_CODEC_CFG_MAX_DATA_SIZE > 0 */
2215};
2216
2228
2233
2236
2239
2248
2251
2263
2264#if defined(CONFIG_BT_ISO_TEST_PARAMS) || defined(__DOXYGEN__)
2273
2282
2291#endif /* CONFIG_BT_ISO_TEST_PARAMS */
2292};
2293
2311 struct bt_bap_broadcast_source **source);
2312
2332int bt_bap_broadcast_source_reconfig(struct bt_bap_broadcast_source *source,
2333 struct bt_bap_broadcast_source_param *param);
2334
2347int bt_bap_broadcast_source_update_metadata(struct bt_bap_broadcast_source *source,
2348 const uint8_t meta[], size_t meta_len);
2349
2361int bt_bap_broadcast_source_start(struct bt_bap_broadcast_source *source,
2362 struct bt_le_ext_adv *adv);
2363
2374int bt_bap_broadcast_source_stop(struct bt_bap_broadcast_source *source);
2375
2386int bt_bap_broadcast_source_delete(struct bt_bap_broadcast_source *source);
2387
2402int bt_bap_broadcast_source_get_base(struct bt_bap_broadcast_source *source,
2403 struct net_buf_simple *base_buf);
2404
2405 /* End of bt_bap_broadcast_source */
2406
2426 void (*base_recv)(struct bt_bap_broadcast_sink *sink, const struct bt_bap_base *base,
2427 size_t base_size);
2428
2441 void (*syncable)(struct bt_bap_broadcast_sink *sink, const struct bt_iso_biginfo *biginfo);
2442
2449 void (*started)(struct bt_bap_broadcast_sink *sink);
2450
2457 void (*stopped)(struct bt_bap_broadcast_sink *sink, uint8_t reason);
2458
2461 sys_snode_t _node;
2463};
2464
2479
2498int bt_bap_broadcast_sink_create(struct bt_le_per_adv_sync *pa_sync, uint32_t broadcast_id,
2499 struct bt_bap_broadcast_sink **sink);
2500
2520int bt_bap_broadcast_sink_sync(struct bt_bap_broadcast_sink *sink, uint32_t indexes_bitfield,
2521 struct bt_bap_stream *streams[],
2522 const uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE]);
2523
2534int bt_bap_broadcast_sink_stop(struct bt_bap_broadcast_sink *sink);
2535
2547int bt_bap_broadcast_sink_delete(struct bt_bap_broadcast_sink *sink);
2548
2549 /* End of group bt_bap_broadcast_sink */
2550
2565
2575
2590 enum bt_bap_pa_state pa_state);
2591
2602
2623
2638
2661
2676
2691
2703 const struct bt_bap_scan_delegator_recv_state *recv_state, void *user_data);
2704
2712 void *user_data);
2713
2723 bt_bap_scan_delegator_state_func_t func, void *user_data);
2724
2725/******************************** CLIENT API ********************************/
2726
2733typedef void (*bt_bap_broadcast_assistant_write_cb)(struct bt_conn *conn,
2734 int err);
2735
2751 void (*discover)(struct bt_conn *conn, int err,
2752 uint8_t recv_state_count);
2753
2763 void (*scan)(const struct bt_le_scan_recv_info *info,
2764 uint32_t broadcast_id);
2765
2775 void (*recv_state)(struct bt_conn *conn, int err,
2777
2784 void (*recv_state_removed)(struct bt_conn *conn, uint8_t src_id);
2785
2792 void (*scan_start)(struct bt_conn *conn, int err);
2793
2800 void (*scan_stop)(struct bt_conn *conn, int err);
2801
2808 void (*add_src)(struct bt_conn *conn, int err);
2809
2816 void (*mod_src)(struct bt_conn *conn, int err);
2817
2824 void (*broadcast_code)(struct bt_conn *conn, int err);
2825
2832 void (*rem_src)(struct bt_conn *conn, int err);
2833
2836 sys_snode_t _node;
2838};
2839
2855int bt_bap_broadcast_assistant_discover(struct bt_conn *conn);
2856
2882 bool start_scan);
2883
2898
2909
2920
2921
2953
2968 struct bt_conn *conn, const struct bt_bap_broadcast_assistant_add_src_param *param);
2969
2991
3006 struct bt_conn *conn, const struct bt_bap_broadcast_assistant_mod_src_param *param);
3007
3023 struct bt_conn *conn, uint8_t src_id,
3024 const uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE]);
3025
3039int bt_bap_broadcast_assistant_rem_src(struct bt_conn *conn, uint8_t src_id);
3040
3056
3057 /* end of bt_bap */
3058
3059#ifdef __cplusplus
3060}
3061#endif
3062
3063#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_BAP_ */
Bluetooth device address definitions and utilities.
Bluetooth Audio handling.
Bluetooth subsystem core APIs.
Bluetooth UUID handling.
Bluetooth connection handling.
Bluetooth Generic Access Profile defines and Assigned Numbers.
bt_audio_dir
Audio direction from the perspective of the BAP Unicast Server / BAP Broadcast Sink.
Definition audio.h:796
bt_audio_location
Location values for BT Audio.
Definition audio.h:590
bt_audio_metadata_type
Codec metadata type IDs.
Definition audio.h:432
bt_audio_context
Audio Context Type for Generic Audio.
Definition audio.h:303
int bt_bap_broadcast_sink_create(struct bt_le_per_adv_sync *pa_sync, uint32_t broadcast_id, struct bt_bap_broadcast_sink **sink)
Create a Broadcast Sink from a periodic advertising sync.
int bt_bap_broadcast_sink_stop(struct bt_bap_broadcast_sink *sink)
Stop audio broadcast sink.
int bt_bap_broadcast_sink_register_cb(struct bt_bap_broadcast_sink_cb *cb)
Register Broadcast sink callbacks.
int bt_bap_broadcast_sink_delete(struct bt_bap_broadcast_sink *sink)
Release a broadcast sink.
int bt_bap_broadcast_sink_sync(struct bt_bap_broadcast_sink *sink, uint32_t indexes_bitfield, struct bt_bap_stream *streams[], const uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE])
Sync to a broadcaster's audio.
int bt_bap_broadcast_source_delete(struct bt_bap_broadcast_source *source)
Delete audio broadcast source.
int bt_bap_broadcast_source_stop(struct bt_bap_broadcast_source *source)
Stop audio broadcast source.
int bt_bap_broadcast_source_reconfig(struct bt_bap_broadcast_source *source, struct bt_bap_broadcast_source_param *param)
Reconfigure audio broadcast source.
int bt_bap_broadcast_source_start(struct bt_bap_broadcast_source *source, struct bt_le_ext_adv *adv)
Start audio broadcast source.
int bt_bap_broadcast_source_register_cb(struct bt_bap_broadcast_source_cb *cb)
Registers callbacks for Broadcast Sources.
int bt_bap_broadcast_source_unregister_cb(struct bt_bap_broadcast_source_cb *cb)
Unregisters callbacks for Broadcast Sources.
int bt_bap_broadcast_source_create(struct bt_bap_broadcast_source_param *param, struct bt_bap_broadcast_source **source)
Create audio broadcast source.
int bt_bap_broadcast_source_get_base(struct bt_bap_broadcast_source *source, struct net_buf_simple *base_buf)
Get the Broadcast Audio Stream Endpoint of a broadcast source.
int bt_bap_broadcast_source_update_metadata(struct bt_bap_broadcast_source *source, const uint8_t meta[], size_t meta_len)
Modify the metadata of an audio broadcast source.
int bt_bap_base_get_subgroup_bis_count(const struct bt_bap_base_subgroup *subgroup)
Get the BIS count of a subgroup.
int bt_bap_base_get_subgroup_codec_data(const struct bt_bap_base_subgroup *subgroup, uint8_t **data)
Get the codec configuration data of a subgroup.
const struct bt_bap_base * bt_bap_base_get_base_from_ad(const struct bt_data *ad)
Generate a pointer to a BASE from periodic advertising data.
int bt_bap_base_subgroup_get_bis_indexes(const struct bt_bap_base_subgroup *subgroup, uint32_t *bis_indexes)
Get all BIS indexes of a subgroup.
int bt_bap_base_subgroup_foreach_bis(const struct bt_bap_base_subgroup *subgroup, bool(*func)(const struct bt_bap_base_subgroup_bis *bis, void *user_data), void *user_data)
Iterate on all BIS in the subgroup.
int bt_bap_base_get_size(const struct bt_bap_base *base)
Get the size of a BASE.
int bt_bap_base_foreach_subgroup(const struct bt_bap_base *base, bool(*func)(const struct bt_bap_base_subgroup *subgroup, void *user_data), void *user_data)
Iterate on all subgroups in the BASE.
int bt_bap_base_get_bis_indexes(const struct bt_bap_base *base, uint32_t *bis_indexes)
Get all BIS indexes of a BASE.
int bt_bap_base_subgroup_codec_to_codec_cfg(const struct bt_bap_base_subgroup *subgroup, struct bt_audio_codec_cfg *codec_cfg)
Store subgroup codec data in a Codec config parsing APIs.
int bt_bap_base_subgroup_bis_codec_to_codec_cfg(const struct bt_bap_base_subgroup_bis *bis, struct bt_audio_codec_cfg *codec_cfg)
Store BIS codec configuration data in a Codec config parsing APIs.
int bt_bap_base_get_subgroup_count(const struct bt_bap_base *base)
Get the subgroup count of a BASE.
int bt_bap_base_get_subgroup_codec_id(const struct bt_bap_base_subgroup *subgroup, struct bt_bap_base_codec_id *codec_id)
Get the codec ID of a subgroup.
int bt_bap_base_get_pres_delay(const struct bt_bap_base *base)
Get the presentation delay value of a BASE.
int bt_bap_base_get_subgroup_codec_meta(const struct bt_bap_base_subgroup *subgroup, uint8_t **meta)
Get the codec metadata of a subgroup.
int bt_bap_unicast_group_delete(struct bt_bap_unicast_group *unicast_group)
Delete audio unicast group.
int bt_bap_unicast_group_add_streams(struct bt_bap_unicast_group *unicast_group, struct bt_bap_unicast_group_stream_pair_param params[], size_t num_param)
Add streams to a unicast group as a unicast client.
int bt_bap_unicast_group_create(struct bt_bap_unicast_group_param *param, struct bt_bap_unicast_group **unicast_group)
Create unicast group.
int bt_bap_unicast_group_reconfig(struct bt_bap_unicast_group *unicast_group, const struct bt_bap_unicast_group_param *param)
Reconfigure unicast group.
int bt_bap_unicast_client_discover(struct bt_conn *conn, enum bt_audio_dir dir)
Discover remote capabilities and endpoints.
int bt_bap_unicast_client_register_cb(struct bt_bap_unicast_client_cb *cb)
Register unicast client callbacks.
void bt_bap_unicast_server_foreach_ep(struct bt_conn *conn, bt_bap_ep_func_t func, void *user_data)
Iterate through all endpoints of the given connection.
int bt_bap_unicast_server_config_ase(struct bt_conn *conn, struct bt_bap_stream *stream, struct bt_audio_codec_cfg *codec_cfg, const struct bt_bap_qos_cfg_pref *qos_pref)
Initialize and configure a new ASE.
int bt_bap_unicast_server_unregister(void)
Unregister the Unicast Server.
int bt_bap_unicast_server_register_cb(const struct bt_bap_unicast_server_cb *cb)
Register unicast server callbacks.
int bt_bap_unicast_server_register(const struct bt_bap_unicast_server_register_param *param)
Register the Unicast Server.
void(* bt_bap_ep_func_t)(struct bt_bap_ep *ep, void *user_data)
The callback function called for each endpoint.
Definition bap.h:1549
int bt_bap_unicast_server_unregister_cb(const struct bt_bap_unicast_server_cb *cb)
Unregister unicast server callbacks.
int bt_bap_broadcast_assistant_rem_src(struct bt_conn *conn, uint8_t src_id)
Remove a source from the server.
int bt_bap_stream_metadata(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len)
Change Audio Stream Metadata.
int bt_bap_stream_disable(struct bt_bap_stream *stream)
Disable Audio Stream.
int bt_bap_stream_enable(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len)
Enable Audio Stream.
bt_bap_bass_att_err
Broadcast Audio Scan Service (BASS) specific ATT error codes.
Definition bap.h:451
int bt_bap_stream_config(struct bt_conn *conn, struct bt_bap_stream *stream, struct bt_bap_ep *ep, struct bt_audio_codec_cfg *codec_cfg)
Configure Audio Stream.
bt_bap_qos_cfg_framing
QoS Framing.
Definition bap.h:188
int bt_bap_scan_delegator_set_pa_state(uint8_t src_id, enum bt_bap_pa_state pa_state)
Set the periodic advertising sync state to syncing.
#define BT_BAP_BASS_MAX_SUBGROUPS
Maximum number of subgroups supported in the BAP Scan Delegator API.
Definition bap.h:48
int bt_bap_stream_get_tx_sync(struct bt_bap_stream *stream, struct bt_iso_tx_info *info)
Get ISO transmission timing info for a Basic Audio Profile stream.
void(* bt_bap_broadcast_assistant_write_cb)(struct bt_conn *conn, int err)
Callback function for writes.
Definition bap.h:2733
bt_bap_big_enc_state
Broadcast Isochronous Group encryption state reported by the Scan Delegator.
Definition bap.h:436
int bt_bap_stream_send(struct bt_bap_stream *stream, struct net_buf *buf, uint16_t seq_num)
Send data to Audio stream without timestamp.
int bt_bap_broadcast_assistant_unregister_cb(struct bt_bap_broadcast_assistant_cb *cb)
Unregisters the callbacks used by the Broadcast Audio Scan Service client.
int bt_bap_scan_delegator_rem_src(uint8_t src_id)
Remove a receive state source.
int bt_bap_scan_delegator_add_src(const struct bt_bap_scan_delegator_add_src_param *param)
Add a receive state source locally.
int bt_bap_scan_delegator_unregister(void)
unregister the Basic Audio Profile Scan Delegator and BASS.
int bt_bap_scan_delegator_set_bis_sync_state(uint8_t src_id, uint32_t bis_synced[COND_CODE_1(CONFIG_BT_AUDIO,(CONFIG_BT_BAP_BASS_MAX_SUBGROUPS),(0))])
Set the sync state of a receive state in the server.
int bt_bap_scan_delegator_register(struct bt_bap_scan_delegator_cb *cb)
Register the Basic Audio Profile Scan Delegator and BASS.
int bt_bap_broadcast_assistant_scan_stop(struct bt_conn *conn)
Stop remote scanning for BISes for a server.
int bt_bap_stream_start(struct bt_bap_stream *stream)
Start Audio Stream.
int bt_bap_broadcast_assistant_read_recv_state(struct bt_conn *conn, uint8_t idx)
Read the specified receive state from the server.
int bt_bap_broadcast_assistant_scan_start(struct bt_conn *conn, bool start_scan)
Scan start for BISes for a remote server.
bt_bap_ascs_reason
Response Reasons.
Definition bap.h:542
bt_bap_ascs_rsp_code
Response Status Code.
Definition bap.h:502
int bt_bap_stream_send_ts(struct bt_bap_stream *stream, struct net_buf *buf, uint16_t seq_num, uint32_t ts)
Send data to Audio stream with timestamp.
int bt_bap_stream_connect(struct bt_bap_stream *stream)
Connect unicast audio stream.
int bt_bap_broadcast_assistant_mod_src(struct bt_conn *conn, const struct bt_bap_broadcast_assistant_mod_src_param *param)
Modify a source on the server.
int bt_bap_stream_reconfig(struct bt_bap_stream *stream, struct bt_audio_codec_cfg *codec_cfg)
Reconfigure Audio Stream.
int bt_bap_stream_release(struct bt_bap_stream *stream)
Release Audio Stream.
void bt_bap_stream_cb_register(struct bt_bap_stream *stream, struct bt_bap_stream_ops *ops)
Register Audio callbacks for a stream.
int bt_bap_broadcast_assistant_discover(struct bt_conn *conn)
Discover Broadcast Audio Scan Service on the server.
void bt_bap_scan_delegator_foreach_state(bt_bap_scan_delegator_state_func_t func, void *user_data)
Iterate through all existing receive states.
int bt_bap_broadcast_assistant_register_cb(struct bt_bap_broadcast_assistant_cb *cb)
Registers the callbacks used by Broadcast Audio Scan Service client.
int bt_bap_broadcast_assistant_set_broadcast_code(struct bt_conn *conn, uint8_t src_id, const uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE])
Set a broadcast code to the specified receive state.
const struct bt_bap_scan_delegator_recv_state * bt_bap_scan_delegator_find_state(bt_bap_scan_delegator_state_func_t func, void *user_data)
Find and return a receive state based on a compare function.
int bt_bap_scan_delegator_mod_src(const struct bt_bap_scan_delegator_mod_src_param *param)
Add a receive state source locally.
bt_bap_pa_state
Periodic advertising state reported by the Scan Delegator.
Definition bap.h:418
int bt_bap_stream_qos(struct bt_conn *conn, struct bt_bap_unicast_group *group)
Configure Audio Stream QoS.
int bt_bap_broadcast_assistant_add_src(struct bt_conn *conn, const struct bt_bap_broadcast_assistant_add_src_param *param)
Add a source on the server.
int bt_bap_stream_stop(struct bt_bap_stream *stream)
Stop Audio Stream.
int bt_bap_ep_get_info(const struct bt_bap_ep *ep, struct bt_bap_ep_info *info)
Return structure holding information of audio stream endpoint.
bt_bap_ep_state
Endpoint states.
Definition bap.h:473
bool(* bt_bap_scan_delegator_state_func_t)(const struct bt_bap_scan_delegator_recv_state *recv_state, void *user_data)
Callback function for Scan Delegator receive state search functions.
Definition bap.h:2702
@ BT_BAP_QOS_CFG_CODED
LE Coded PHY.
Definition bap.h:202
@ BT_BAP_QOS_CFG_2M
LE 2M PHY.
Definition bap.h:200
@ BT_BAP_QOS_CFG_1M
LE 1M PHY.
Definition bap.h:198
@ BT_BAP_BASS_ERR_OPCODE_NOT_SUPPORTED
Opcode not supported.
Definition bap.h:453
@ BT_BAP_BASS_ERR_INVALID_SRC_ID
Invalid source ID supplied.
Definition bap.h:456
@ BT_BAP_QOS_CFG_FRAMING_FRAMED
Packets are always framed.
Definition bap.h:192
@ BT_BAP_QOS_CFG_FRAMING_UNFRAMED
Packets may be framed or unframed.
Definition bap.h:190
@ BT_BAP_BIG_ENC_STATE_BCODE_REQ
The Broadcast Isochronous Group broadcast code requested.
Definition bap.h:441
@ BT_BAP_BIG_ENC_STATE_NO_ENC
The Broadcast Isochronous Group not encrypted.
Definition bap.h:438
@ BT_BAP_BIG_ENC_STATE_BAD_CODE
The Broadcast Isochronous Group bad broadcast code.
Definition bap.h:447
@ BT_BAP_BIG_ENC_STATE_DEC
The Broadcast Isochronous Group decrypted.
Definition bap.h:444
@ BT_BAP_ASCS_REASON_NONE
No reason.
Definition bap.h:544
@ BT_BAP_ASCS_REASON_PD
Presendation delay.
Definition bap.h:562
@ BT_BAP_ASCS_REASON_FRAMING
Framing.
Definition bap.h:552
@ BT_BAP_ASCS_REASON_CODEC_DATA
Codec configuration.
Definition bap.h:548
@ BT_BAP_ASCS_REASON_SDU
Maximum SDU size.
Definition bap.h:556
@ BT_BAP_ASCS_REASON_CODEC
Codec ID.
Definition bap.h:546
@ BT_BAP_ASCS_REASON_PHY
PHY.
Definition bap.h:554
@ BT_BAP_ASCS_REASON_LATENCY
Max transport latency.
Definition bap.h:560
@ BT_BAP_ASCS_REASON_CIS
Invalid CIS mapping.
Definition bap.h:564
@ BT_BAP_ASCS_REASON_RTN
RTN.
Definition bap.h:558
@ BT_BAP_ASCS_REASON_INTERVAL
SDU interval.
Definition bap.h:550
@ BT_BAP_ASCS_RSP_CODE_INVALID_ASE_STATE
Invalid ASE state.
Definition bap.h:512
@ BT_BAP_ASCS_RSP_CODE_METADATA_INVALID
Invalid metadata.
Definition bap.h:528
@ BT_BAP_ASCS_RSP_CODE_NOT_SUPPORTED
Server did not support operation by client.
Definition bap.h:506
@ BT_BAP_ASCS_RSP_CODE_CONF_UNSUPPORTED
Configuration parameters not supported by server.
Definition bap.h:518
@ BT_BAP_ASCS_RSP_CODE_INVALID_ASE
Invalid ASE ID.
Definition bap.h:510
@ BT_BAP_ASCS_RSP_CODE_INVALID_DIR
Invalid operation for direction.
Definition bap.h:514
@ BT_BAP_ASCS_RSP_CODE_CONF_INVALID
Invalid Configuration parameters.
Definition bap.h:522
@ BT_BAP_ASCS_RSP_CODE_CAP_UNSUPPORTED
Capabilities not supported by server.
Definition bap.h:516
@ BT_BAP_ASCS_RSP_CODE_NO_MEM
Server has insufficient resources.
Definition bap.h:530
@ BT_BAP_ASCS_RSP_CODE_METADATA_REJECTED
Metadata rejected by server.
Definition bap.h:526
@ BT_BAP_ASCS_RSP_CODE_UNSPECIFIED
Unspecified error.
Definition bap.h:532
@ BT_BAP_ASCS_RSP_CODE_INVALID_LENGTH
Server rejected due to invalid operation length.
Definition bap.h:508
@ BT_BAP_ASCS_RSP_CODE_METADATA_UNSUPPORTED
Unsupported metadata.
Definition bap.h:524
@ BT_BAP_ASCS_RSP_CODE_SUCCESS
Server completed operation successfully.
Definition bap.h:504
@ BT_BAP_ASCS_RSP_CODE_CONF_REJECTED
Configuration parameters rejected by server.
Definition bap.h:520
@ BT_BAP_PA_STATE_NOT_SYNCED
The periodic advertising has not been synchronized.
Definition bap.h:420
@ BT_BAP_PA_STATE_FAILED
Failed to synchronized to periodic advertising.
Definition bap.h:429
@ BT_BAP_PA_STATE_SYNCED
Synchronized to periodic advertising.
Definition bap.h:426
@ BT_BAP_PA_STATE_INFO_REQ
Waiting for SyncInfo from Broadcast Assistant.
Definition bap.h:423
@ BT_BAP_PA_STATE_NO_PAST
No periodic advertising sync transfer receiver from Broadcast Assistant.
Definition bap.h:432
@ BT_BAP_EP_STATE_ENABLING
Audio Stream Endpoint Enabling state.
Definition bap.h:484
@ BT_BAP_EP_STATE_IDLE
Audio Stream Endpoint Idle state.
Definition bap.h:475
@ BT_BAP_EP_STATE_CODEC_CONFIGURED
Audio Stream Endpoint Codec Configured state.
Definition bap.h:478
@ BT_BAP_EP_STATE_RELEASING
Audio Stream Endpoint Streaming state.
Definition bap.h:493
@ BT_BAP_EP_STATE_QOS_CONFIGURED
Audio Stream Endpoint QoS Configured state.
Definition bap.h:481
@ BT_BAP_EP_STATE_DISABLING
Audio Stream Endpoint Disabling state.
Definition bap.h:490
@ BT_BAP_EP_STATE_STREAMING
Audio Stream Endpoint Streaming state.
Definition bap.h:487
#define BT_ISO_BROADCAST_CODE_SIZE
Broadcast code size.
Definition iso.h:141
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
Bluetooth ISO handling.
Buffer management.
state
Definition parser_state.h:29
#define bool
Definition stdbool.h:13
__UINT32_TYPE__ uint32_t
Definition stdint.h:90
__UINT8_TYPE__ uint8_t
Definition stdint.h:88
__UINT16_TYPE__ uint16_t
Definition stdint.h:89
Bluetooth LE Device Address.
Definition addr.h:49
Codec capability structure.
Definition audio.h:684
Codec specific configuration structure.
Definition audio.h:718
Structure storing values of fields of ASE Control Point notification.
Definition bap.h:568
enum bt_bap_ascs_reason reason
Response reason.
Definition bap.h:605
enum bt_audio_metadata_type metadata_type
Response metadata type.
Definition bap.h:615
enum bt_bap_ascs_rsp_code code
Value of the Response Code field.
Definition bap.h:582
Codec ID structure for a Broadcast Audio Source Endpoint (BASE)
Definition bap.h:1952
uint16_t cid
Codec Company ID.
Definition bap.h:1956
uint16_t vid
Codec Company Vendor ID.
Definition bap.h:1958
uint8_t id
Codec ID.
Definition bap.h:1954
BIS structure for each BIS in a Broadcast Audio Source Endpoint (BASE) subgroup.
Definition bap.h:1962
uint8_t * data
Codec Specific Data.
Definition bap.h:1968
uint8_t data_len
Codec Specific Data length.
Definition bap.h:1966
uint8_t index
Unique index of the BIS.
Definition bap.h:1964
Struct to hold subgroup specific information for the receive state.
Definition bap.h:641
uint8_t metadata[CONFIG_BT_AUDIO_CODEC_CFG_MAX_METADATA_SIZE]
The metadata.
Definition bap.h:650
uint32_t bis_sync
BIS synced bitfield.
Definition bap.h:643
uint8_t metadata_len
Length of the metadata.
Definition bap.h:646
Parameters for adding a source to a Broadcast Audio Scan Service server.
Definition bap.h:2923
uint8_t num_subgroups
Number of subgroups.
Definition bap.h:2944
bt_addr_le_t addr
Address of the advertiser.
Definition bap.h:2925
uint8_t adv_sid
SID of the advertising set.
Definition bap.h:2928
struct bt_bap_bass_subgroup * subgroups
Pointer to array of subgroups.
Definition bap.h:2951
uint16_t pa_interval
Periodic advertising interval in milliseconds.
Definition bap.h:2941
bool pa_sync
Whether to sync to periodic advertisements.
Definition bap.h:2931
uint32_t broadcast_id
24-bit broadcast ID
Definition bap.h:2934
Struct to hold the Basic Audio Profile Broadcast Assistant callbacks.
Definition bap.h:2741
void(* discover)(struct bt_conn *conn, int err, uint8_t recv_state_count)
Callback function for bt_bap_broadcast_assistant_discover.
Definition bap.h:2751
void(* broadcast_code)(struct bt_conn *conn, int err)
Callback function for bt_bap_broadcast_assistant_set_broadcast_code().
Definition bap.h:2824
void(* recv_state)(struct bt_conn *conn, int err, const struct bt_bap_scan_delegator_recv_state *state)
Callback function for when a receive state is read or updated.
Definition bap.h:2775
void(* scan_stop)(struct bt_conn *conn, int err)
Callback function for bt_bap_broadcast_assistant_scan_stop().
Definition bap.h:2800
void(* mod_src)(struct bt_conn *conn, int err)
Callback function for bt_bap_broadcast_assistant_mod_src().
Definition bap.h:2816
void(* scan)(const struct bt_le_scan_recv_info *info, uint32_t broadcast_id)
Callback function for Broadcast Audio Scan Service client scan results.
Definition bap.h:2763
void(* scan_start)(struct bt_conn *conn, int err)
Callback function for bt_bap_broadcast_assistant_scan_start().
Definition bap.h:2792
void(* add_src)(struct bt_conn *conn, int err)
Callback function for bt_bap_broadcast_assistant_add_src().
Definition bap.h:2808
void(* rem_src)(struct bt_conn *conn, int err)
Callback function for bt_bap_broadcast_assistant_rem_src().
Definition bap.h:2832
void(* recv_state_removed)(struct bt_conn *conn, uint8_t src_id)
Callback function for when a receive state is removed.
Definition bap.h:2784
Parameters for modifying a source.
Definition bap.h:2971
struct bt_bap_bass_subgroup * subgroups
Pointer to array of subgroups.
Definition bap.h:2989
uint8_t num_subgroups
Number of subgroups.
Definition bap.h:2986
uint8_t src_id
Source ID of the receive state.
Definition bap.h:2973
bool pa_sync
Whether to sync to periodic advertisements.
Definition bap.h:2976
uint16_t pa_interval
Periodic advertising interval.
Definition bap.h:2983
Broadcast Audio Sink callback structure.
Definition bap.h:2415
void(* base_recv)(struct bt_bap_broadcast_sink *sink, const struct bt_bap_base *base, size_t base_size)
Broadcast Audio Source Endpoint (BASE) received.
Definition bap.h:2426
void(* stopped)(struct bt_bap_broadcast_sink *sink, uint8_t reason)
The Broadcast Sink has stopped and none of the streams will receive audio data.
Definition bap.h:2457
void(* syncable)(struct bt_bap_broadcast_sink *sink, const struct bt_iso_biginfo *biginfo)
Broadcast sink is syncable.
Definition bap.h:2441
void(* started)(struct bt_bap_broadcast_sink *sink)
The Broadcast Sink has started and audio data may be received from all of the streams.
Definition bap.h:2449
Struct to hold the Broadcast Source callbacks.
Definition bap.h:2155
void(* started)(struct bt_bap_broadcast_source *source)
The Broadcast Source has started and all of the streams are ready for audio data.
Definition bap.h:2161
void(* stopped)(struct bt_bap_broadcast_source *source, uint8_t reason)
The Broadcast Source has stopped and none of the streams are ready for audio data.
Definition bap.h:2169
Broadcast Source create parameters.
Definition bap.h:2230
uint16_t iso_interval
ISO interval.
Definition bap.h:2290
uint8_t packing
Broadcast Source packing mode.
Definition bap.h:2247
uint8_t pto
Pre-transmission offset.
Definition bap.h:2281
size_t params_count
The number of parameters in subgroup_params.
Definition bap.h:2232
struct bt_bap_broadcast_source_subgroup_param * params
Array of stream parameters.
Definition bap.h:2235
uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE]
Broadcast code.
Definition bap.h:2262
bool encryption
Whether or not to encrypt the streams.
Definition bap.h:2250
uint8_t irc
Immediate Repetition Count.
Definition bap.h:2272
struct bt_bap_qos_cfg * qos
Quality of Service configuration.
Definition bap.h:2238
Broadcast Source stream parameters.
Definition bap.h:2200
uint8_t * data
BIS Codec Specific Configuration.
Definition bap.h:2213
struct bt_bap_stream * stream
Audio stream.
Definition bap.h:2202
size_t data_len
The number of elements in the data array.
Definition bap.h:2210
Broadcast Source subgroup parameters.
Definition bap.h:2218
struct bt_audio_codec_cfg * codec_cfg
Subgroup Codec configuration.
Definition bap.h:2226
size_t params_count
The number of parameters in stream_params.
Definition bap.h:2220
struct bt_bap_broadcast_source_stream_param * params
Array of stream parameters.
Definition bap.h:2223
Structure holding information of audio stream endpoint.
Definition bap.h:843
uint8_t id
The ID of the endpoint.
Definition bap.h:845
bool can_recv
True if the stream associated with the endpoint is able to receive data.
Definition bap.h:860
struct bt_iso_chan * iso_chan
The isochronous channel associated with the endpoint.
Definition bap.h:854
enum bt_bap_ep_state state
The state of the endpoint.
Definition bap.h:848
struct bt_bap_ep * paired_ep
Pointer to paired endpoint if the endpoint is part of a bidirectional CIS, otherwise NULL.
Definition bap.h:865
enum bt_audio_dir dir
Capabilities type.
Definition bap.h:851
bool can_send
True if the stream associated with the endpoint is able to send data.
Definition bap.h:857
const struct bt_bap_qos_cfg_pref * qos_pref
Pointer to the preferred QoS settings associated with the endpoint.
Definition bap.h:868
Audio Stream Quality of Service Preference structure.
Definition bap.h:350
uint32_t pref_pd_min
Preferred minimum Presentation Delay in microseconds.
Definition bap.h:405
uint8_t rtn
Preferred Retransmission Number.
Definition bap.h:372
bool unframed_supported
Unframed PDUs supported.
Definition bap.h:357
uint32_t pd_min
Minimum Presentation Delay in microseconds.
Definition bap.h:388
uint32_t pd_max
Maximum Presentation Delay in microseconds.
Definition bap.h:397
uint8_t phy
Preferred PHY bitfield.
Definition bap.h:365
uint32_t pref_pd_max
Preferred maximum Presentation Delay in microseconds.
Definition bap.h:414
uint16_t latency
Preferred Transport Latency.
Definition bap.h:379
QoS configuration structure.
Definition bap.h:232
uint16_t sdu
Maximum SDU size.
Definition bap.h:277
uint8_t burst_number
Burst number.
Definition bap.h:315
enum bt_bap_qos_cfg_framing framing
QoS Framing.
Definition bap.h:254
uint16_t latency
Maximum Transport Latency.
Definition bap.h:286
uint8_t num_subevents
Number of subevents.
Definition bap.h:324
uint8_t rtn
Retransmission Number.
Definition bap.h:270
uint32_t interval
SDU Interval.
Definition bap.h:294
uint8_t phy
PHY.
Definition bap.h:262
uint16_t max_pdu
Maximum PDU size.
Definition bap.h:308
uint32_t pd
Presentation Delay in microseconds.
Definition bap.h:243
Parameters for bt_bap_scan_delegator_add_src()
Definition bap.h:2604
uint8_t num_subgroups
Number of subgroups.
Definition bap.h:2618
enum bt_bap_big_enc_state encrypt_state
The broadcast isochronous group encryption state.
Definition bap.h:2612
bt_addr_le_t addr
Periodic Advertiser Address.
Definition bap.h:2606
uint8_t sid
Advertiser SID.
Definition bap.h:2609
uint32_t broadcast_id
The 24-bit broadcast ID.
Definition bap.h:2615
struct bt_bap_bass_subgroup subgroups[COND_CODE_1(CONFIG_BT_AUDIO,(CONFIG_BT_BAP_BASS_MAX_SUBGROUPS),(0))]
Subgroup specific information.
Definition bap.h:2621
Struct to hold the Basic Audio Profile Scan Delegator callbacks.
Definition bap.h:697
int(* pa_sync_req)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state, bool past_avail, uint16_t pa_interval)
Periodic advertising sync request.
Definition bap.h:726
int(* add_source)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state)
Add Source operation callback.
Definition bap.h:807
int(* pa_sync_term_req)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state)
Periodic advertising sync termination request.
Definition bap.h:743
void(* recv_state_updated)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state)
Receive state updated.
Definition bap.h:707
void(* broadcast_code)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state, const uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE])
Broadcast code received.
Definition bap.h:757
int(* remove_source)(struct bt_conn *conn, uint8_t src_id)
Remove Source operation callback.
Definition bap.h:839
int(* bis_sync_req)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state, const uint32_t bis_sync_req[COND_CODE_1(CONFIG_BT_AUDIO,(CONFIG_BT_BAP_BASS_MAX_SUBGROUPS),(0))])
Broadcast Isochronous Stream synchronize request.
Definition bap.h:781
void(* scanning_state)(struct bt_conn *conn, bool is_scanning)
Broadcast Assistant scanning state callback.
Definition bap.h:793
int(* modify_source)(struct bt_conn *conn, const struct bt_bap_scan_delegator_recv_state *recv_state)
Modify Source operation callback.
Definition bap.h:823
Parameters for bt_bap_scan_delegator_mod_src()
Definition bap.h:2640
uint32_t broadcast_id
The 24-bit broadcast ID.
Definition bap.h:2648
struct bt_bap_bass_subgroup subgroups[COND_CODE_1(CONFIG_BT_AUDIO,(CONFIG_BT_BAP_BASS_MAX_SUBGROUPS),(0))]
Subgroup specific information.
Definition bap.h:2659
uint8_t num_subgroups
Number of subgroups.
Definition bap.h:2651
uint8_t src_id
The periodic adverting sync.
Definition bap.h:2642
enum bt_bap_big_enc_state encrypt_state
The broadcast isochronous group encryption state.
Definition bap.h:2645
Represents the Broadcast Audio Scan Service receive state.
Definition bap.h:655
uint8_t src_id
The source ID
Definition bap.h:657
uint8_t bad_code[BT_ISO_BROADCAST_CODE_SIZE]
The bad broadcast code.
Definition bap.h:679
enum bt_bap_pa_state pa_sync_state
The periodic adverting sync state.
Definition bap.h:666
bt_addr_le_t addr
The Bluetooth address.
Definition bap.h:660
struct bt_bap_bass_subgroup subgroups[COND_CODE_1(CONFIG_BT_AUDIO,(CONFIG_BT_BAP_BASS_MAX_SUBGROUPS),(0))]
Subgroup specific information.
Definition bap.h:689
uint8_t adv_sid
The advertising set ID.
Definition bap.h:663
uint8_t num_subgroups
Number of subgroups.
Definition bap.h:682
uint32_t broadcast_id
The 24-bit broadcast ID.
Definition bap.h:672
enum bt_bap_big_enc_state encrypt_state
The broadcast isochronous group encryption state.
Definition bap.h:669
Stream operation.
Definition bap.h:933
void(* recv)(struct bt_bap_stream *stream, const struct bt_iso_recv_info *info, struct net_buf *buf)
Stream audio HCI receive callback.
Definition bap.h:1026
void(* enabled)(struct bt_bap_stream *stream)
Stream enabled callback.
Definition bap.h:962
void(* sent)(struct bt_bap_stream *stream)
Stream audio HCI sent callback.
Definition bap.h:1043
void(* released)(struct bt_bap_stream *stream)
Stream released callback.
Definition bap.h:991
void(* disabled)(struct bt_bap_stream *stream)
Stream disabled callback.
Definition bap.h:981
void(* configured)(struct bt_bap_stream *stream, const struct bt_bap_qos_cfg_pref *pref)
Stream configured callback.
Definition bap.h:943
void(* connected)(struct bt_bap_stream *stream)
Isochronous channel connected callback.
Definition bap.h:1058
void(* metadata_updated)(struct bt_bap_stream *stream)
Stream metadata updated callback.
Definition bap.h:972
void(* started)(struct bt_bap_stream *stream)
Stream started callback.
Definition bap.h:1002
void(* disconnected)(struct bt_bap_stream *stream, uint8_t reason)
Isochronous channel disconnected callback.
Definition bap.h:1072
void(* stopped)(struct bt_bap_stream *stream, uint8_t reason)
Stream stopped callback.
Definition bap.h:1012
void(* qos_set)(struct bt_bap_stream *stream)
Stream QoS set callback.
Definition bap.h:953
Basic Audio Profile stream structure.
Definition bap.h:890
struct bt_audio_codec_cfg * codec_cfg
Codec Configuration.
Definition bap.h:898
struct bt_bap_qos_cfg * qos
QoS Configuration.
Definition bap.h:901
struct bt_bap_stream_ops * ops
Audio stream operations.
Definition bap.h:904
struct bt_conn * conn
Connection reference.
Definition bap.h:892
struct bt_bap_ep * ep
Endpoint reference.
Definition bap.h:895
void * user_data
Stream user data.
Definition bap.h:907
Unicast Client callback structure.
Definition bap.h:1724
void(* enable)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_enable().
Definition bap.h:1791
void(* discover)(struct bt_conn *conn, int err, enum bt_audio_dir dir)
BAP discovery callback function.
Definition bap.h:1905
void(* qos)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_qos().
Definition bap.h:1778
void(* pac_record)(struct bt_conn *conn, enum bt_audio_dir dir, const struct bt_audio_codec_cap *codec_cap)
Remote Published Audio Capability (PAC) record discovered.
Definition bap.h:1877
void(* disable)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_disable().
Definition bap.h:1834
void(* start)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_start().
Definition bap.h:1806
void(* location)(struct bt_conn *conn, enum bt_audio_dir dir, enum bt_audio_location loc)
Remote Unicast Server Audio Locations.
Definition bap.h:1737
void(* metadata)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_metadata().
Definition bap.h:1847
void(* release)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_release().
Definition bap.h:1860
void(* stop)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_stop().
Definition bap.h:1821
void(* available_contexts)(struct bt_conn *conn, enum bt_audio_context snk_ctx, enum bt_audio_context src_ctx)
Remote Unicast Server Available Contexts.
Definition bap.h:1751
void(* endpoint)(struct bt_conn *conn, enum bt_audio_dir dir, struct bt_bap_ep *ep)
Remote Audio Stream Endpoint (ASE) discovered.
Definition bap.h:1891
void(* config)(struct bt_bap_stream *stream, enum bt_bap_ascs_rsp_code rsp_code, enum bt_bap_ascs_reason reason)
Callback function for bt_bap_stream_config() and bt_bap_stream_reconfig().
Definition bap.h:1763
Parameters for the creating unicast groups with bt_bap_unicast_group_create()
Definition bap.h:1606
uint16_t iso_interval
ISO interval.
Definition bap.h:1650
uint8_t packing
Unicast Group packing mode.
Definition bap.h:1620
uint8_t p_to_c_ft
Peripheral to Central flush timeout.
Definition bap.h:1641
uint8_t c_to_p_ft
Central to Peripheral flush timeout.
Definition bap.h:1631
size_t params_count
The number of parameters in params.
Definition bap.h:1608
struct bt_bap_unicast_group_stream_pair_param * params
Array of stream parameters.
Definition bap.h:1611
Parameter struct for the unicast group functions.
Definition bap.h:1597
struct bt_bap_unicast_group_stream_param * rx_param
Pointer to a receiving stream parameters.
Definition bap.h:1599
struct bt_bap_unicast_group_stream_param * tx_param
Pointer to a transmitting stream parameters.
Definition bap.h:1602
Parameter struct for each stream in the unicast group.
Definition bap.h:1583
struct bt_bap_qos_cfg * qos
The QoS settings for the stream object.
Definition bap.h:1588
struct bt_bap_stream * stream
Pointer to a stream object.
Definition bap.h:1585
Unicast Server callback structure.
Definition bap.h:1340
int(* disable)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp)
Stream Disable request callback.
Definition bap.h:1455
int(* qos)(struct bt_bap_stream *stream, const struct bt_bap_qos_cfg *qos, struct bt_bap_ascs_rsp *rsp)
Stream QoS request callback.
Definition bap.h:1396
int(* start)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp)
Stream Start request callback.
Definition bap.h:1426
int(* metadata)(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len, struct bt_bap_ascs_rsp *rsp)
Stream Metadata update request callback.
Definition bap.h:1441
int(* enable)(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len, struct bt_bap_ascs_rsp *rsp)
Stream Enable request callback.
Definition bap.h:1412
int(* reconfig)(struct bt_bap_stream *stream, enum bt_audio_dir dir, const struct bt_audio_codec_cfg *codec_cfg, struct bt_bap_qos_cfg_pref *const pref, struct bt_bap_ascs_rsp *rsp)
Stream reconfig request callback.
Definition bap.h:1379
int(* stop)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp)
Stream Stop callback.
Definition bap.h:1468
int(* release)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp)
Stream release callback.
Definition bap.h:1482
int(* config)(struct bt_conn *conn, const struct bt_bap_ep *ep, enum bt_audio_dir dir, const struct bt_audio_codec_cfg *codec_cfg, struct bt_bap_stream **stream, struct bt_bap_qos_cfg_pref *const pref, struct bt_bap_ascs_rsp *rsp)
Endpoint config request callback.
Definition bap.h:1359
Structure for registering Unicast Server.
Definition bap.h:1076
uint8_t snk_cnt
Sink Count to register.
Definition bap.h:1082
uint8_t src_cnt
Source Count to register.
Definition bap.h:1088
Bluetooth data.
Definition bluetooth.h:531
Broadcast Isochronous Group (BIG) information.
Definition iso.h:648
ISO Channel structure.
Definition iso.h:197
ISO Meta Data structure for received ISO packets.
Definition iso.h:357
ISO Meta Data structure for transmitted ISO packets.
Definition iso.h:373
LE advertisement and scan response packet information.
Definition bluetooth.h:2576
Group structure.
Definition grp.h:18
Simple network buffer representation.
Definition net_buf.h:89
Network buffer representation.
Definition net_buf.h:1006
Macro utilities.