cap.h

Go to the documentation of this file.

/*
 * Copyright (c) 2022-2023 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_CAP_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_CAP_H_
 
#include <stdint.h>
 
#include <zephyr/bluetooth/audio/csip.h>
#include <zephyr/bluetooth/iso.h>
#include <zephyr/bluetooth/audio/audio.h>
#include <zephyr/bluetooth/audio/bap.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct bt_cap_broadcast_source;
 
int bt_cap_acceptor_register(const struct bt_csip_set_member_register_param *param,
                             struct bt_csip_set_member_svc_inst **svc_inst);
 
struct bt_cap_initiator_cb {
#if defined(CONFIG_BT_BAP_UNICAST_CLIENT)
        void (*unicast_discovery_complete)(
                struct bt_conn *conn, int err,
                const struct bt_csip_set_coordinator_csis_inst *csis_inst);
 
        void (*unicast_start_complete)(struct bt_bap_unicast_group *unicast_group,
                                       int err, struct bt_conn *conn);
 
        void (*unicast_update_complete)(int err, struct bt_conn *conn);
 
        void (*unicast_stop_complete)(struct bt_bap_unicast_group *unicast_group,
                                      int err, struct bt_conn *conn);
#endif /* CONFIG_BT_BAP_UNICAST_CLIENT */
};
 
int bt_cap_initiator_unicast_discover(struct bt_conn *conn);
 
enum bt_cap_set_type {
        BT_CAP_SET_TYPE_AD_HOC,
        BT_CAP_SET_TYPE_CSIP,
};
 
union bt_cap_set_member {
        struct bt_conn *member;
 
        struct bt_csip_set_coordinator_csis_inst *csip;
};
 
struct bt_cap_stream {
        struct bt_bap_stream bap_stream;
        struct bt_bap_stream_ops *ops;
};
 
void bt_cap_stream_ops_register(struct bt_cap_stream *stream, struct bt_bap_stream_ops *ops);
 
struct bt_cap_unicast_audio_start_stream_param {
        union bt_cap_set_member member;
 
        struct bt_cap_stream *stream;
 
        struct bt_bap_ep *ep;
 
        struct bt_codec *codec;
 
        struct bt_codec_qos *qos;
};
 
struct bt_cap_unicast_audio_start_param {
        enum bt_cap_set_type type;
 
        size_t count;
 
        struct bt_cap_unicast_audio_start_stream_param *stream_params;
};
 
struct bt_cap_unicast_audio_update_param {
        struct bt_cap_stream *stream;
 
        size_t meta_count;
 
        struct bt_codec_data *meta;
};
 
int bt_cap_initiator_register_cb(const struct bt_cap_initiator_cb *cb);
 
int bt_cap_initiator_unicast_audio_start(const struct bt_cap_unicast_audio_start_param *param,
                                         struct bt_bap_unicast_group *unicast_group);
 
int bt_cap_initiator_unicast_audio_update(const struct bt_cap_unicast_audio_update_param params[],
                                          size_t count);
 
int bt_cap_initiator_unicast_audio_stop(struct bt_bap_unicast_group *unicast_group);
 
int bt_cap_initiator_unicast_audio_cancel(void);
 
struct bt_cap_initiator_broadcast_stream_param {
        struct bt_cap_stream *stream;
 
        size_t data_count;
 
        struct bt_codec_data *data;
};
 
struct bt_cap_initiator_broadcast_subgroup_param {
        size_t stream_count;
 
        struct bt_cap_initiator_broadcast_stream_param *stream_params;
 
        struct bt_codec *codec;
};
 
struct bt_cap_initiator_broadcast_create_param {
        size_t subgroup_count;
 
        struct bt_cap_initiator_broadcast_subgroup_param *subgroup_params;
 
        struct bt_codec_qos *qos;
 
        uint8_t packing;
 
        bool encryption;
 
        uint8_t broadcast_code[BT_AUDIO_BROADCAST_CODE_SIZE];
};
 
int bt_cap_initiator_broadcast_audio_create(
        const struct bt_cap_initiator_broadcast_create_param *param,
        struct bt_cap_broadcast_source **broadcast_source);
 
int bt_cap_initiator_broadcast_audio_start(struct bt_cap_broadcast_source *broadcast_source,
                                           struct bt_le_ext_adv *adv);
int bt_cap_initiator_broadcast_audio_update(struct bt_cap_broadcast_source *broadcast_source,
                                            const struct bt_codec_data meta[],
                                            size_t meta_count);
 
int bt_cap_initiator_broadcast_audio_stop(struct bt_cap_broadcast_source *broadcast_source);
 
/*
 * @brief Delete Common Audio Profile broadcast source
 *
 * This can only be done after the broadcast source has been stopped by calling
 * bt_cap_initiator_broadcast_audio_stop() and after the
 * bt_bap_stream_ops.stopped() callback has been called for all streams in the
 * broadcast source.
 *
 * @note @kconfig{CONFIG_BT_CAP_INITIATOR} and
 * @kconfig{CONFIG_BT_BAP_BROADCAST_SOURCE} must be enabled for this function
 * to be enabled.
 *
 * @param broadcast_source The broadcast source to delete.
 *                         The @p broadcast_source will be invalidated.
 *
 * @return 0 on success or negative error value on failure.
 */
int bt_cap_initiator_broadcast_audio_delete(struct bt_cap_broadcast_source *broadcast_source);
 
int bt_cap_initiator_broadcast_get_id(const struct bt_cap_broadcast_source *broadcast_source,
                                      uint32_t *const broadcast_id);
 
int bt_cap_initiator_broadcast_get_base(struct bt_cap_broadcast_source *broadcast_source,
                                        struct net_buf_simple *base_buf);
 
struct bt_cap_unicast_to_broadcast_param {
        struct bt_bap_unicast_group *unicast_group;
 
        bool encrypt;
 
        uint8_t broadcast_code[BT_ISO_BROADCAST_CODE_SIZE];
};
 
int bt_cap_initiator_unicast_to_broadcast(const struct bt_cap_unicast_to_broadcast_param *param,
                                          struct bt_cap_broadcast_source **source);
 
struct bt_cap_broadcast_to_unicast_param {
        struct bt_cap_broadcast_source *broadcast_source;
 
        enum bt_cap_set_type type;
 
        size_t count;
 
        union bt_cap_set_member **members;
};
 
int bt_cap_initiator_broadcast_to_unicast(const struct bt_cap_broadcast_to_unicast_param *param,
                                          struct bt_bap_unicast_group **unicast_group);
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_CAP_H_ */