audio.h

Go to the documentation of this file.

 
/*
 * Copyright (c) 2020 Intel Corporation
 * Copyright (c) 2020-2022 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_AUDIO_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_AUDIO_H_
 
#include <zephyr/sys/atomic.h>
#include <zephyr/bluetooth/buf.h>
#include <zephyr/bluetooth/conn.h>
#include <zephyr/bluetooth/hci.h>
#include <zephyr/bluetooth/iso.h>
#include <zephyr/bluetooth/gatt.h>
#include <zephyr/bluetooth/audio/lc3.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define BT_AUDIO_BROADCAST_ID_SIZE               3 /* octets */
 
#define BT_AUDIO_CONTEXT_TYPE_PROHIBITED         0
#define BT_AUDIO_CONTEXT_TYPE_UNSPECIFIED        BIT(0)
#define BT_AUDIO_CONTEXT_TYPE_CONVERSATIONAL     BIT(1)
#define BT_AUDIO_CONTEXT_TYPE_MEDIA              BIT(2)
#define BT_AUDIO_CONTEXT_TYPE_GAME               BIT(3)
#define BT_AUDIO_CONTEXT_TYPE_INSTRUCTIONAL      BIT(4)
#define BT_AUDIO_CONTEXT_TYPE_VOICE_ASSISTANTS   BIT(5)
#define BT_AUDIO_CONTEXT_TYPE_LIVE               BIT(6)
#define BT_AUDIO_CONTEXT_TYPE_SOUND_EFFECTS      BIT(7)
#define BT_AUDIO_CONTEXT_TYPE_NOTIFICATIONS      BIT(8)
#define BT_AUDIO_CONTEXT_TYPE_RINGTONE           BIT(9)
#define BT_AUDIO_CONTEXT_TYPE_ALERTS             BIT(10)
#define BT_AUDIO_CONTEXT_TYPE_EMERGENCY_ALARM    BIT(11)
#define BT_AUDIO_CONTEXT_TYPE_ANY        (BT_AUDIO_CONTEXT_TYPE_UNSPECIFIED | \
                                          BT_AUDIO_CONTEXT_TYPE_CONVERSATIONAL | \
                                          BT_AUDIO_CONTEXT_TYPE_MEDIA | \
                                          BT_AUDIO_CONTEXT_TYPE_GAME | \
                                          BT_AUDIO_CONTEXT_TYPE_INSTRUCTIONAL | \
                                          BT_AUDIO_CONTEXT_TYPE_VOICE_ASSISTANTS | \
                                          BT_AUDIO_CONTEXT_TYPE_LIVE | \
                                          BT_AUDIO_CONTEXT_TYPE_SOUND_EFFECTS | \
                                          BT_AUDIO_CONTEXT_TYPE_NOTIFICATIONS | \
                                          BT_AUDIO_CONTEXT_TYPE_RINGTONE | \
                                          BT_AUDIO_CONTEXT_TYPE_ALERTS | \
                                          BT_AUDIO_CONTEXT_TYPE_EMERGENCY_ALARM)
 
 
/* Unicast Announcement Type, Generic Audio */
#define BT_AUDIO_UNICAST_ANNOUNCEMENT_GENERAL    0x00
#define BT_AUDIO_UNICAST_ANNOUNCEMENT_TARGETED   0x01
 
#if defined(CONFIG_BT_AUDIO_BROADCAST_SINK)
#define BROADCAST_SNK_STREAM_CNT CONFIG_BT_AUDIO_BROADCAST_SNK_STREAM_COUNT
#define BROADCAST_SNK_SUBGROUP_CNT CONFIG_BT_AUDIO_BROADCAST_SNK_SUBGROUP_COUNT
#else /* !CONFIG_BT_AUDIO_BROADCAST_SINK */
#define BROADCAST_SNK_STREAM_CNT 0
#define BROADCAST_SNK_SUBGROUP_CNT 0
#endif /* CONFIG_BT_AUDIO_BROADCAST_SINK*/
 
struct bt_audio_unicast_group;
 
struct bt_audio_broadcast_sink;
 
struct bt_audio_broadcast_source;
 
struct bt_codec_data {
        struct bt_data data;
        uint8_t  value[CONFIG_BT_CODEC_MAX_DATA_LEN];
};
 
#define BT_CODEC_DATA(_type, _bytes...) \
        { \
                .data = BT_DATA(_type, ((uint8_t []) { _bytes }), \
                                sizeof((uint8_t []) { _bytes })) \
        }
 
#define BT_CODEC(_id, _cid, _vid, _data, _meta) \
        { \
                .id = _id, \
                .cid = _cid, \
                .vid = _vid, \
                .data_count = ARRAY_SIZE(((struct bt_codec_data[]) _data)), \
                .data = _data, \
                .meta_count = ARRAY_SIZE(((struct bt_codec_data[]) _meta)), \
                .meta = _meta, \
        }
 
 
enum bt_audio_meta_type {
        BT_CODEC_META_PREFER_CONTEXT     = 0x01,
        BT_CODEC_META_CONTEXT            = 0x02,
        BT_CODEC_META_PROGRAM_INFO       = 0x03,
        BT_CODEC_META_LANGUAGE           = 0x04,
        BT_CODEC_META_CCID_LIST          = 0x05,
        BT_CODEC_META_PARENTAL_RATING    = 0x06,
        BT_CODEC_META_PROGRAM_INFO_URI   = 0x07,
        BT_CODEC_META_EXTENDED_METADATA  = 0xFE,
        BT_CODEC_META_VENDOR_SPECIFIC    = 0xFF,
};
 
enum bt_audio_location {
        BT_AUDIO_LOCATION_FRONT_LEFT = BIT(0),
        BT_AUDIO_LOCATION_FRONT_RIGHT = BIT(1),
        BT_AUDIO_LOCATION_FRONT_CENTER = BIT(2),
        BT_AUDIO_LOCATION_LOW_FREQ_EFFECTS_1 = BIT(3),
        BT_AUDIO_LOCATION_BACK_LEFT = BIT(4),
        BT_AUDIO_LOCATION_BACK_RIGHT = BIT(5),
        BT_AUDIO_LOCATION_FRONT_LEFT_OF_CENTER = BIT(6),
        BT_AUDIO_LOCATION_FRONT_RIGHT_OF_CENTER = BIT(7),
        BT_AUDIO_LOCATION_BACK_CENTER = BIT(8),
        BT_AUDIO_LOCATION_LOW_FREQ_EFFECTS_2 = BIT(9),
        BT_AUDIO_LOCATION_SIDE_LEFT = BIT(10),
        BT_AUDIO_LOCATION_SIDE_RIGHT = BIT(11),
        BT_AUDIO_LOCATION_TOP_FRONT_LEFT = BIT(12),
        BT_AUDIO_LOCATION_TOP_FRONT_RIGHT = BIT(13),
        BT_AUDIO_LOCATION_TOP_FRONT_CENTER = BIT(14),
        BT_AUDIO_LOCATION_TOP_CENTER = BIT(15),
        BT_AUDIO_LOCATION_TOP_BACK_LEFT = BIT(16),
        BT_AUDIO_LOCATION_TOP_BECK_RIGHT = BIT(17),
        BT_AUDIO_LOCATION_TOP_SIDE_LEFT = BIT(18),
        BT_AUDIO_LOCATION_TOP_SIDE_RIGHT = BIT(19),
        BT_AUDIO_LOCATION_TOP_BACK_CENTER = BIT(20),
        BT_AUDIO_LOCATION_BOTTOM_FRONT_CENTER = BIT(21),
        BT_AUDIO_LOCATION_BOTTOM_FRONT_LEFT = BIT(22),
        BT_AUDIO_LOCATION_BOTTOM_FRONT_RIGHT = BIT(23),
        BT_AUDIO_LOCATION_FRONT_LEFT_WIDE = BIT(24),
        BT_AUDIO_LOCATION_FRONT_RIGHT_WIDE = BIT(25),
        BT_AUDIO_LOCATION_LEFT_SURROUND = BIT(26),
        BT_AUDIO_LOCATION_RIGHT_SURROUND = BIT(27),
};
 
struct bt_codec {
        uint8_t  id;
        uint16_t cid;
        uint16_t vid;
        size_t   data_count;
        struct bt_codec_data data[CONFIG_BT_CODEC_MAX_DATA_COUNT];
        size_t   meta_count;
        struct bt_codec_data meta[CONFIG_BT_CODEC_MAX_METADATA_COUNT];
};
 
struct bt_audio_base_bis_data {
        /* Unique index of the BIS */
        uint8_t index;
        size_t   data_count;
        struct bt_codec_data data[CONFIG_BT_CODEC_MAX_DATA_COUNT];
};
 
struct bt_audio_base_subgroup {
        /* Number of BIS in the subgroup */
        size_t bis_count;
        struct bt_codec codec;
        /* Array of BIS specific data for each BIS in the subgroup */
        struct bt_audio_base_bis_data bis_data[BROADCAST_SNK_STREAM_CNT];
};
 
struct bt_audio_base {
        /* Number of subgroups in the BASE */
        size_t subgroup_count;
        /* Array of subgroups in the BASE */
        struct bt_audio_base_subgroup subgroups[BROADCAST_SNK_SUBGROUP_CNT];
};
 
enum bt_audio_dir {
        BT_AUDIO_DIR_SINK = 0x01,
        BT_AUDIO_DIR_SOURCE = 0x02,
};
 
#define BT_CODEC_QOS(_interval, _framing, _phy, _sdu, _rtn, _latency, \
                     _pd) \
        { \
                .interval = _interval, \
                .framing = _framing, \
                .phy = _phy, \
                .sdu = _sdu, \
                .rtn = _rtn, \
                .latency = _latency, \
                .pd = _pd, \
        }
 
enum {
        BT_CODEC_QOS_UNFRAMED = 0x00,
        BT_CODEC_QOS_FRAMED = 0x01,
};
 
enum {
        BT_CODEC_QOS_1M = BIT(0),
        BT_CODEC_QOS_2M = BIT(1),
        BT_CODEC_QOS_CODED = BIT(2),
};
 
#define BT_CODEC_QOS_UNFRAMED(_interval, _sdu, _rtn, _latency, _pd) \
        BT_CODEC_QOS(_interval, BT_CODEC_QOS_UNFRAMED, BT_CODEC_QOS_2M, _sdu, \
                     _rtn, _latency, _pd)
 
#define BT_CODEC_QOS_FRAMED(_interval, _sdu, _rtn, _latency, _pd) \
        BT_CODEC_QOS(_interval, BT_CODEC_QOS_FRAMED, BT_CODEC_QOS_2M, _sdu, \
                     _rtn, _latency, _pd)
 
struct bt_codec_qos {
        uint8_t  phy;
 
        uint8_t  framing;
 
        uint8_t rtn;
 
        uint16_t sdu;
 
        uint16_t latency;
 
        uint32_t interval;
        uint32_t pd;
};
 
#define BT_CODEC_QOS_PREF(_unframed_supported, _phy, _rtn, _latency, _pd_min, \
                          _pd_max, _pref_pd_min, _pref_pd_max) \
        { \
                .unframed_supported = _unframed_supported, \
                .phy = _phy, \
                .rtn = _rtn, \
                .latency = _latency, \
                .pd_min = _pd_min, \
                .pd_max = _pd_max, \
                .pref_pd_min = _pref_pd_min, \
                .pref_pd_max = _pref_pd_max, \
        }
 
struct bt_codec_qos_pref {
        bool unframed_supported;
 
        uint8_t phy;
 
        uint8_t rtn;
 
        uint16_t latency;
 
        uint32_t pd_min;
 
        uint32_t pd_max;
 
        uint32_t pref_pd_min;
 
        uint32_t pref_pd_max;
};
 
struct bt_audio_lc3_preset {
        struct bt_codec codec;
        struct bt_codec_qos qos;
};
 
#define BT_AUDIO_LC3_PRESET(_codec, _qos) \
        { \
                .codec = _codec, \
                .qos = _qos, \
        }
 
/* LC3 Unicast presets defined by table 5.2 in the BAP v1.0 specification */
#define BT_AUDIO_LC3_UNICAST_PRESET_8_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(26u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_8_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(30u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_16_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(30u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_16_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(40u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_24_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(45u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_24_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(60u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_32_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(60u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_32_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(80u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_441_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_1, \
                BT_CODEC_QOS(8163u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 97u, 5u, 24u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_441_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_2, \
                BT_CODEC_QOS(10884u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 130u, 5u, 31u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(75u, 5u, 15u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(100u, 5u, 20u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_3_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_3, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(90u, 5u, 15u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_4_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_4, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(120u, 5u, 20u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_5_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_5, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(117u, 5u, 15u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_6_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_6, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(155u, 5u, 20u, 40000u) \
        )
 
/* Following presets are for unicast high reliability audio data */
#define BT_AUDIO_LC3_UNICAST_PRESET_8_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(26u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_8_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(30u, 13u, 95u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_16_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(30u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_16_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(40u, 13u, 95u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_24_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(45u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_24_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(60u, 13u, 95u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_32_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(60u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_32_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(80u, 13u, 95u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_441_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_1, \
                BT_CODEC_QOS(8163u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 97u, 13u, 80u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_441_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_2, \
                BT_CODEC_QOS(10884u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 130u, 13u, 85u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(75u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(100u, 13u, 95u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_3_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_3, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(90u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_4_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_4, \
        BT_CODEC_LC3_QOS_10_UNFRAMED(120u, 13u, 100u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_5_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_5, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(117u, 13u, 75u, 40000u) \
        )
 
#define BT_AUDIO_LC3_UNICAST_PRESET_48_6_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_6, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(155u, 13u, 100u, 40000u) \
        )
 
/* LC3 Broadcast presets defined by table 6.4 in the BAP v1.0 specification */
#define BT_AUDIO_LC3_BROADCAST_PRESET_8_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(26u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_8_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(30u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_16_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(30u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_16_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(40u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_24_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(45u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_24_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(60u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_32_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(60u, 2u, 8u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_32_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(80u, 2u, 10u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_441_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_1, \
                BT_CODEC_QOS(8163u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 97u, 4u, 24u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_441_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_2, \
                BT_CODEC_QOS(10884u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 130u, 4u, 31u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_1_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(75u, 4u, 15u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_2_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(100u, 4u, 20u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_3_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_3, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(90u, 4u, 15u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_4_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_4, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(120u, 4u, 20u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_5_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_5, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(117u, 4u, 15u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_6_1 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_6, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(155u, 4u, 20u, 40000u) \
        )
 
/* Following presets are for broadcast high reliability audio data */
#define BT_AUDIO_LC3_BROADCAST_PRESET_8_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(26u, 4u, 45u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_8_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_8_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(30u, 4u, 60u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_16_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(30u, 4u, 45u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_16_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_16_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(40u, 4u, 60u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_24_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(45u, 4u, 45u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_24_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_24_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(60u, 4u, 60u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_32_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(60u, 4u, 45u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_32_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_32_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(80u, 4u, 60u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_441_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_1, \
                BT_CODEC_QOS(8163u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 97u, 4u, 54u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_441_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_441_2, \
                BT_CODEC_QOS(10884u, BT_CODEC_QOS_FRAMED, \
                             BT_CODEC_QOS_2M, 130u, 4u, 60u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_1_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_1, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(75u, 4u, 50u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_2_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_2, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(100u, 4u, 65u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_3_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_3, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(90u, 4u, 50u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_4_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_4, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(120u, 4u, 65u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_5_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_5, \
                BT_CODEC_LC3_QOS_7_5_UNFRAMED(117u, 4u, 50u, 40000u) \
        )
 
#define BT_AUDIO_LC3_BROADCAST_PRESET_48_6_2 \
        BT_AUDIO_LC3_PRESET( \
                BT_CODEC_LC3_CONFIG_48_6, \
                BT_CODEC_LC3_QOS_10_UNFRAMED(155u, 4u, 65u, 40000u) \
        )
 
struct bt_audio_stream {
        struct bt_conn *conn;
        struct bt_audio_ep *ep;
        struct bt_codec *codec;
        struct bt_codec_qos *qos;
        struct bt_iso_chan *iso;
        struct bt_audio_stream_ops *ops;
        sys_snode_t node;
 
        union {
                void *group;
                struct bt_audio_unicast_group *unicast_group;
                struct bt_audio_broadcast_source *broadcast_source;
                struct bt_audio_broadcast_sink *broadcast_sink;
        };
 
        void *user_data;
};
 
struct bt_audio_unicast_server_cb {
        int (*config)(struct bt_conn *conn,
                      const struct bt_audio_ep *ep,
                      enum bt_audio_dir dir,
                      const struct bt_codec *codec,
                      struct bt_audio_stream **stream,
                      struct bt_codec_qos_pref *const pref);
 
        int (*reconfig)(struct bt_audio_stream *stream,
                        enum bt_audio_dir dir,
                        const struct bt_codec *codec,
                        struct bt_codec_qos_pref *const pref);
 
        int (*qos)(struct bt_audio_stream *stream,
                   const struct bt_codec_qos *qos);
 
        int (*enable)(struct bt_audio_stream *stream,
                      const struct bt_codec_data *meta,
                      size_t meta_count);
 
        int (*start)(struct bt_audio_stream *stream);
 
        int (*metadata)(struct bt_audio_stream *stream,
                        const struct bt_codec_data *meta,
                        size_t meta_count);
 
        int (*disable)(struct bt_audio_stream *stream);
 
        int (*stop)(struct bt_audio_stream *stream);
 
        int (*release)(struct bt_audio_stream *stream);
 
        int (*publish_capability)(struct bt_conn *conn, uint8_t type,
                                  uint8_t index, struct bt_codec *const codec);
 
#if defined(CONFIG_BT_PAC_SNK_LOC) || defined(CONFIG_BT_PAC_SRC_LOC)
        int (*publish_location)(struct bt_conn *conn,
                                enum bt_audio_dir dir,
                                enum bt_audio_location *location);
 
#if defined(CONFIG_BT_PAC_SNK_LOC_WRITEABLE) || defined(CONFIG_BT_PAC_SRC_LOC_WRITEABLE)
        int (*write_location)(struct bt_conn *conn, enum bt_audio_dir dir,
                              enum bt_audio_location location);
#endif /* CONFIG_BT_PAC_SNK_LOC_WRITEABLE || CONFIG_BT_PAC_SRC_LOC_WRITEABLE */
#endif /* CONFIG_BT_PAC_SNK_LOC || CONFIG_BT_PAC_SRC_LOC */
};
 
struct bt_audio_broadcast_sink_cb {
        bool (*scan_recv)(const struct bt_le_scan_recv_info *info,
                          uint32_t broadcast_id);
 
        void (*pa_synced)(struct bt_audio_broadcast_sink *sink,
                          struct bt_le_per_adv_sync *sync,
                          uint32_t broadcast_id);
 
        void (*base_recv)(struct bt_audio_broadcast_sink *sink,
                          const struct bt_audio_base *base);
 
        void (*syncable)(struct bt_audio_broadcast_sink *sink, bool encrypted);
 
        void (*scan_term)(int err);
 
        void (*pa_sync_lost)(struct bt_audio_broadcast_sink *sink);
 
        /* Internally used list node */
        sys_snode_t node;
};
 
struct bt_audio_stream_ops {
#if defined(CONFIG_BT_AUDIO_UNICAST)
        void (*configured)(struct bt_audio_stream *stream,
                           const struct bt_codec_qos_pref *pref);
 
        void (*qos_set)(struct bt_audio_stream *stream);
 
        void (*enabled)(struct bt_audio_stream *stream);
 
        void (*metadata_updated)(struct bt_audio_stream *stream);
 
        void (*disabled)(struct bt_audio_stream *stream);
 
        void (*released)(struct bt_audio_stream *stream);
#endif /* CONFIG_BT_AUDIO_UNICAST */
 
        void (*started)(struct bt_audio_stream *stream);
 
        void (*stopped)(struct bt_audio_stream *stream);
 
#if defined(CONFIG_BT_AUDIO_UNICAST) || defined(CONFIG_BT_AUDIO_BROADCAST_SINK)
        void (*recv)(struct bt_audio_stream *stream,
                     const struct bt_iso_recv_info *info,
                     struct net_buf *buf);
#endif /* CONFIG_BT_AUDIO_UNICAST || CONFIG_BT_AUDIO_BROADCAST_SINK */
 
#if defined(CONFIG_BT_AUDIO_UNICAST) || defined(CONFIG_BT_AUDIO_BROADCAST_SOURCE)
        void (*sent)(struct bt_audio_stream *stream);
#endif /* CONFIG_BT_AUDIO_UNICAST || CONFIG_BT_AUDIO_BROADCAST_SOURCE */
 
};
 
void bt_audio_stream_cb_register(struct bt_audio_stream *stream,
                                 struct bt_audio_stream_ops *ops);
int bt_audio_unicast_server_register_cb(const struct bt_audio_unicast_server_cb *cb);
 
int bt_audio_unicast_server_unregister_cb(const struct bt_audio_unicast_server_cb *cb);
 
int bt_audio_unicast_server_location_changed(enum bt_audio_dir dir);
 /* End of group bt_audio_server */
 
struct bt_audio_discover_params;
 
typedef void (*bt_audio_discover_func_t)(struct bt_conn *conn,
                                         struct bt_codec *codec,
                                         struct bt_audio_ep *ep,
                                         struct bt_audio_discover_params *params);
 
struct bt_audio_discover_params {
        enum bt_audio_dir dir;
        bt_audio_discover_func_t func;
        uint8_t  num_caps;
        uint8_t  num_eps;
        uint8_t  err;
        struct bt_gatt_read_params read;
        struct bt_gatt_discover_params discover;
};
 
int bt_audio_discover(struct bt_conn *conn,
                      struct bt_audio_discover_params *params);
 
int bt_audio_stream_config(struct bt_conn *conn,
                           struct bt_audio_stream *stream,
                           struct bt_audio_ep *ep,
                           struct bt_codec *codec);
 
int bt_audio_stream_reconfig(struct bt_audio_stream *stream,
                             struct bt_codec *codec);
 
int bt_audio_stream_qos(struct bt_conn *conn,
                        struct bt_audio_unicast_group *group,
                        struct bt_codec_qos *qos);
 
int bt_audio_stream_enable(struct bt_audio_stream *stream,
                           struct bt_codec_data *meta,
                           size_t meta_count);
 
int bt_audio_stream_metadata(struct bt_audio_stream *stream,
                             struct bt_codec_data *meta,
                             size_t meta_count);
 
int bt_audio_stream_disable(struct bt_audio_stream *stream);
 
int bt_audio_stream_start(struct bt_audio_stream *stream);
 
int bt_audio_stream_stop(struct bt_audio_stream *stream);
 
int bt_audio_stream_release(struct bt_audio_stream *stream, bool cache);
 
int bt_audio_stream_send(struct bt_audio_stream *stream, struct net_buf *buf);
 
int bt_audio_unicast_group_create(struct bt_audio_stream *streams[],
                                  size_t num_stream,
                                  struct bt_audio_unicast_group **unicast_group);
 
int bt_audio_unicast_group_add_streams(struct bt_audio_unicast_group *unicast_group,
                                       struct bt_audio_stream *streams[],
                                       size_t num_stream);
 
int bt_audio_unicast_group_remove_streams(struct bt_audio_unicast_group *unicast_group,
                                          struct bt_audio_stream *streams[],
                                          size_t num_stream);
 
int bt_audio_unicast_group_delete(struct bt_audio_unicast_group *unicast_group);
 /* End of group bt_audio_client */
 
 
int bt_audio_broadcast_source_create(struct bt_audio_stream *streams[],
                                     size_t num_stream,
                                     struct bt_codec *codec,
                                     struct bt_codec_qos *qos,
                                     struct bt_audio_broadcast_source **source);
 
int bt_audio_broadcast_source_reconfig(struct bt_audio_broadcast_source *source,
                                       struct bt_codec *codec,
                                       struct bt_codec_qos *qos);
 
int bt_audio_broadcast_source_start(struct bt_audio_broadcast_source *source);
 
int bt_audio_broadcast_source_stop(struct bt_audio_broadcast_source *source);
 
int bt_audio_broadcast_source_delete(struct bt_audio_broadcast_source *source);
 
void bt_audio_broadcast_sink_register_cb(struct bt_audio_broadcast_sink_cb *cb);
 
int bt_audio_broadcast_sink_scan_start(const struct bt_le_scan_param *param);
 
int bt_audio_broadcast_sink_scan_stop(void);
 
int bt_audio_broadcast_sink_sync(struct bt_audio_broadcast_sink *sink,
                                 uint32_t indexes_bitfield,
                                 struct bt_audio_stream *streams[],
                                 struct bt_codec *codec,
                                 const uint8_t broadcast_code[16]);
 
int bt_audio_broadcast_sink_stop(struct bt_audio_broadcast_sink *sink);
 
int bt_audio_broadcast_sink_delete(struct bt_audio_broadcast_sink *sink);
 /* End of bt_audio_broadcast */
 
 
enum bt_audio_codec_parse_err {
 
        BT_AUDIO_CODEC_PARSE_ERR_SUCCESS               = 0,
 
        BT_AUDIO_CODEC_PARSE_ERR_TYPE_NOT_FOUND        = -1,
 
        BT_AUDIO_CODEC_PARSE_ERR_INVALID_VALUE_FOUND   = -2,
 
        BT_AUDIO_CODEC_PARSE_ERR_INVALID_PARAM         = -3,
};
 
int bt_codec_cfg_get_freq(const struct bt_codec *codec);
 
int bt_codec_cfg_get_frame_duration_us(const struct bt_codec *codec);
 
int bt_codec_cfg_get_chan_allocation_val(const struct bt_codec *codec, uint32_t *chan_allocation);
 
int bt_codec_cfg_get_octets_per_frame(const struct bt_codec *codec);
 
int bt_codec_cfg_get_frame_blocks_per_sdu(const struct bt_codec *codec, bool fallback_to_default);
 
bool bt_codec_get_val(const struct bt_codec *codec,
                      uint8_t type,
                      const struct bt_codec_data **data);
 /* End of bt_audio_codec_cfg */
 
#ifdef __cplusplus
}
#endif
 /* end of bt_audio */
 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_H_ */