bap.h

Go to the documentation of this file.

 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_BAP_
#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_BAP_
#include <zephyr/types.h>
#include <zephyr/bluetooth/conn.h>
 
#if defined(CONFIG_BT_BAP_SCAN_DELEGATOR)
#define BT_BAP_SCAN_DELEGATOR_MAX_METADATA_LEN CONFIG_BT_BAP_SCAN_DELEGATOR_MAX_METADATA_LEN
#define BT_BAP_SCAN_DELEGATOR_MAX_SUBGROUPS    CONFIG_BT_BAP_SCAN_DELEGATOR_MAX_SUBGROUPS
#else
#define BT_BAP_SCAN_DELEGATOR_MAX_METADATA_LEN 0
#define BT_BAP_SCAN_DELEGATOR_MAX_SUBGROUPS    0
#endif
 
#define BT_BAP_BROADCAST_CODE_SIZE             16
 
#define BT_BAP_PA_STATE_NOT_SYNCED             0x00
#define BT_BAP_PA_STATE_INFO_REQ               0x01
#define BT_BAP_PA_STATE_SYNCED                 0x02
#define BT_BAP_PA_STATE_FAILED                 0x03
#define BT_BAP_PA_STATE_NO_PAST                0x04
 
#define BT_BAP_BIG_ENC_STATE_NO_ENC            0x00
#define BT_BAP_BIG_ENC_STATE_BCODE_REQ         0x01
#define BT_BAP_BIG_ENC_STATE_DEC               0x02
#define BT_BAP_BIG_ENC_STATE_BAD_CODE          0x03
 
#define BT_BAP_BASS_ERR_OPCODE_NOT_SUPPORTED   0x80
#define BT_BAP_BASS_ERR_INVALID_SRC_ID         0x81
 
#define BT_BAP_PA_INTERVAL_UNKNOWN             0xFFFF
 
#define BT_BAP_BROADCAST_MAX_ID                0xFFFFFF
 
#define BT_BAP_BIS_SYNC_NO_PREF                0xFFFFFFFF
 
/* TODO: Replace with struct bt_audio_base_subgroup */
struct bt_bap_scan_delegator_subgroup {
        uint32_t bis_sync;
        uint32_t requested_bis_sync;
        uint8_t metadata_len;
        uint8_t metadata[BT_BAP_SCAN_DELEGATOR_MAX_METADATA_LEN];
};
 
/* TODO: Only expose this as an opaque type */
struct bt_bap_scan_delegator_recv_state {
        uint8_t src_id;
        bt_addr_le_t addr;
        uint8_t adv_sid;
        uint8_t req_pa_sync_value;
        uint8_t pa_sync_state;
        uint8_t encrypt_state;
        uint32_t broadcast_id; /* 24 bits */
        uint8_t bad_code[BT_BAP_BROADCAST_CODE_SIZE];
        uint8_t num_subgroups;
        struct bt_bap_scan_delegator_subgroup subgroups[BT_BAP_SCAN_DELEGATOR_MAX_SUBGROUPS];
};
 
struct bt_bap_scan_delegator_cb {
        void (*pa_synced)(struct bt_bap_scan_delegator_recv_state *recv_state,
                          const struct bt_le_per_adv_sync_synced_info *info);
        void (*pa_term)(struct bt_bap_scan_delegator_recv_state *recv_state,
                        const struct bt_le_per_adv_sync_term_info *info);
        void (*pa_recv)(struct bt_bap_scan_delegator_recv_state *recv_state,
                        const struct bt_le_per_adv_sync_recv_info *info,
                        struct net_buf_simple *buf);
        void (*biginfo)(struct bt_bap_scan_delegator_recv_state *recv_state,
                        const struct bt_iso_biginfo *biginfo);
};
 
void bt_bap_scan_delegator_register_cb(struct bt_bap_scan_delegator_cb *cb);
 
int bt_bap_scan_delegator_set_sync_state(uint8_t src_id, uint8_t pa_sync_state,
                                         uint32_t bis_synced[BT_BAP_SCAN_DELEGATOR_MAX_SUBGROUPS],
                                         uint8_t encrypted);
 
/******************************** CLIENT API ********************************/
 
typedef void (*bt_bap_broadcast_assistant_discover_cb)(struct bt_conn *conn,
                                                       int err,
                                                       uint8_t recv_state_count);
 
typedef void (*bt_bap_broadcast_assistant_scan_cb)(const struct bt_le_scan_recv_info *info,
                                                   uint32_t broadcast_id);
 
typedef void (*bt_bap_broadcast_assistant_recv_state_cb)(
        struct bt_conn *conn, int err,
        const struct bt_bap_scan_delegator_recv_state *state);
 
typedef void (*bt_bap_broadcast_assistant_recv_state_rem_cb)(struct bt_conn *conn,
                                                             int err,
                                                             uint8_t src_id);
 
typedef void (*bt_bap_broadcast_assistant_write_cb)(struct bt_conn *conn,
                                                    int err);
 
struct bt_bap_broadcast_assistant_cb {
        bt_bap_broadcast_assistant_discover_cb        discover;
        bt_bap_broadcast_assistant_scan_cb            scan;
        bt_bap_broadcast_assistant_recv_state_cb      recv_state;
        bt_bap_broadcast_assistant_recv_state_rem_cb  recv_state_removed;
 
        bt_bap_broadcast_assistant_write_cb           scan_start;
        bt_bap_broadcast_assistant_write_cb           scan_stop;
        bt_bap_broadcast_assistant_write_cb           add_src;
        bt_bap_broadcast_assistant_write_cb           mod_src;
        bt_bap_broadcast_assistant_write_cb           broadcast_code;
        bt_bap_broadcast_assistant_write_cb           rem_src;
};
 
int bt_bap_broadcast_assistant_discover(struct bt_conn *conn);
 
int bt_bap_broadcast_assistant_scan_start(struct bt_conn *conn,
                                          bool start_scan);
 
int bt_bap_broadcast_assistant_scan_stop(struct bt_conn *conn);
 
void bt_bap_broadcast_assistant_register_cb(struct bt_bap_broadcast_assistant_cb *cb);
 
struct bt_bap_broadcast_assistant_add_src_param {
        bt_addr_le_t addr;
        uint8_t adv_sid;
        uint8_t pa_sync;
        uint32_t broadcast_id;
        uint16_t pa_interval;
        uint8_t num_subgroups;
        struct bt_bap_scan_delegator_subgroup *subgroups;
};
 
int bt_bap_broadcast_assistant_add_src(struct bt_conn *conn,
                                       struct bt_bap_broadcast_assistant_add_src_param *param);
 
struct bt_bap_broadcast_assistant_mod_src_param {
        uint8_t src_id;
        uint8_t pa_sync;
        uint16_t pa_interval;
        uint8_t num_subgroups;
        struct bt_bap_scan_delegator_subgroup *subgroups;
};
 
int bt_bap_broadcast_assistant_mod_src(struct bt_conn *conn,
                                       struct bt_bap_broadcast_assistant_mod_src_param *param);
 
int bt_bap_broadcast_assistant_set_broadcast_code(
        struct bt_conn *conn, uint8_t src_id,
        uint8_t broadcast_code[BT_BAP_BROADCAST_CODE_SIZE]);
 
int bt_bap_broadcast_assistant_rem_src(struct bt_conn *conn, uint8_t src_id);
 
int bt_bap_broadcast_assistant_read_recv_state(struct bt_conn *conn,
                                               uint8_t idx);
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_BAP_ */