capabilities.h

Go to the documentation of this file.

/* @file
 * @brief Internal APIs for Audio Capabilities handling
 *
 * Copyright (c) 2021 Intel Corporation
 * Copyright (c) 2021-2022 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_CAPABILITIES_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_CAPABILITIES_H_
 
#include <zephyr/bluetooth/audio/audio.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* Get list of capabilities by type */
sys_slist_t *bt_audio_capability_get(enum bt_audio_dir dir);
 
 
enum bt_audio_capability_framing {
        BT_AUDIO_CAPABILITY_UNFRAMED_SUPPORTED     = 0x00,
        BT_AUDIO_CAPABILITY_UNFRAMED_NOT_SUPPORTED = 0x01,
};
 
#define BT_AUDIO_CAPABILITY_PREF(_framing, _phy, _rtn, _latency, _pd_min, \
                                 _pd_max, _pref_pd_min, _pref_pd_max) \
        { \
                .framing = _framing, \
                .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_audio_capability_pref {
        uint8_t framing;
 
        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_capability; /* Handle circular dependency */
 
struct bt_audio_capability_ops {
        struct bt_audio_stream *(*config)(struct bt_conn *conn,
                                          struct bt_audio_ep *ep,
                                          enum bt_audio_dir dir,
                                          struct bt_audio_capability *cap,
                                          struct bt_codec *codec);
 
        int (*reconfig)(struct bt_audio_stream *stream,
                        struct bt_audio_capability *cap,
                        struct bt_codec *codec);
 
        int (*qos)(struct bt_audio_stream *stream, struct bt_codec_qos *qos);
 
        int (*enable)(struct bt_audio_stream *stream,
                      struct bt_codec_data *meta,
                      size_t meta_count);
 
        int (*start)(struct bt_audio_stream *stream);
 
        int (*metadata)(struct bt_audio_stream *stream,
                        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);
};
 
struct bt_audio_capability {
        enum bt_audio_dir dir;
        uint16_t context;
        struct bt_codec *codec;
        struct bt_audio_capability_pref pref;
        struct bt_audio_capability_ops *ops;
        sys_snode_t node;
};
 
int bt_audio_capability_register(struct bt_audio_capability *cap);
 
int bt_audio_capability_unregister(struct bt_audio_capability *cap);
 
int bt_audio_capability_set_location(enum bt_audio_dir dir,
                                     enum bt_audio_location location);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_CAPABILITIES_H_ */