ascs.h

Go to the documentation of this file.

 
/*
 * Copyright (c) 2026 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_ASCS_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_ASCS_H_

 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
 
#include <zephyr/autoconf.h>
#include <zephyr/bluetooth/assigned_numbers.h>
#include <zephyr/bluetooth/audio/audio.h>
#include <zephyr/bluetooth/conn.h>
#include <zephyr/sys/util_macro.h>
 
#ifdef __cplusplus
extern "C" {
#endif

enum bt_bap_ascs_rsp_code {
        BT_BAP_ASCS_RSP_CODE_SUCCESS = 0x00U,
        BT_BAP_ASCS_RSP_CODE_NOT_SUPPORTED = 0x01U,
        BT_BAP_ASCS_RSP_CODE_INVALID_LENGTH = 0x02U,
        BT_BAP_ASCS_RSP_CODE_INVALID_ASE = 0x03U,
        BT_BAP_ASCS_RSP_CODE_INVALID_ASE_STATE = 0x04U,
        BT_BAP_ASCS_RSP_CODE_INVALID_DIR = 0x05U,
        BT_BAP_ASCS_RSP_CODE_CAP_UNSUPPORTED = 0x06U,
        BT_BAP_ASCS_RSP_CODE_CONF_UNSUPPORTED = 0x07U,
        BT_BAP_ASCS_RSP_CODE_CONF_REJECTED = 0x08U,
        BT_BAP_ASCS_RSP_CODE_CONF_INVALID = 0x09U,
        BT_BAP_ASCS_RSP_CODE_METADATA_UNSUPPORTED = 0x0AU,
        BT_BAP_ASCS_RSP_CODE_METADATA_REJECTED = 0x0BU,
        BT_BAP_ASCS_RSP_CODE_METADATA_INVALID = 0x0CU,
        BT_BAP_ASCS_RSP_CODE_NO_MEM = 0x0DU,
        BT_BAP_ASCS_RSP_CODE_UNSPECIFIED = 0x0EU,
};

enum bt_bap_ascs_reason {
        BT_BAP_ASCS_REASON_NONE = 0x00U,
        BT_BAP_ASCS_REASON_CODEC = 0x01U,
        BT_BAP_ASCS_REASON_CODEC_DATA = 0x02U,
        BT_BAP_ASCS_REASON_INTERVAL = 0x03U,
        BT_BAP_ASCS_REASON_FRAMING = 0x04U,
        BT_BAP_ASCS_REASON_PHY = 0x05U,
        BT_BAP_ASCS_REASON_SDU = 0x06U,
        BT_BAP_ASCS_REASON_RTN = 0x07U,
        BT_BAP_ASCS_REASON_LATENCY = 0x08U,
        BT_BAP_ASCS_REASON_PD = 0x09U,
        BT_BAP_ASCS_REASON_CIS = 0x0AU,
};

struct bt_bap_ascs_rsp {
        enum bt_bap_ascs_rsp_code code;

        union {
                enum bt_bap_ascs_reason reason;

                enum bt_audio_metadata_type metadata_type;
        };
};

#define BT_BAP_ASCS_RSP(c, r)                                                                      \
        (struct bt_bap_ascs_rsp)                                                                   \
        {                                                                                          \
                .code = c, .reason = r                                                             \
        }

struct bt_bap_qos_cfg_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;
};

#define BT_BAP_QOS_CFG_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,                                                       \
        }
 
/* Temporary solution to handle circular dependencies between ascs.h and bap.h */
struct bt_bap_stream;
struct bt_bap_ep;
struct bt_bap_qos_cfg;

struct bt_ascs_cb {
        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);

        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);

        int (*qos)(struct bt_bap_stream *stream, const struct bt_bap_qos_cfg *qos,
                   struct bt_bap_ascs_rsp *rsp);

        int (*enable)(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len,
                      struct bt_bap_ascs_rsp *rsp);

        int (*start)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);

        int (*metadata)(struct bt_bap_stream *stream, const uint8_t meta[], size_t meta_len,
                        struct bt_bap_ascs_rsp *rsp);

        int (*disable)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);

        int (*stop)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);

        int (*release)(struct bt_bap_stream *stream, struct bt_bap_ascs_rsp *rsp);
};

struct bt_ascs_register_param {
        uint8_t snk_cnt;

        uint8_t src_cnt;

        const struct bt_ascs_cb *cb;
};

int bt_ascs_register(const struct bt_ascs_register_param *param);

int bt_ascs_unregister(void);
 
#ifdef __cplusplus
}
#endif

 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_ASCS_H_ */