server_store.h

Go to the documentation of this file.

/*
 * Copyright (c) 2025 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef _SERVER_STORE_H_
#define _SERVER_STORE_H_
 
#include <zephyr/bluetooth/conn.h>
#include <zephyr/bluetooth/audio/audio.h>
#include <zephyr/bluetooth/audio/csip.h>
#include <zephyr/bluetooth/audio/cap.h>
#include <zephyr/bluetooth/audio/bap.h>
#include <zephyr/bluetooth/audio/bap_lc3_preset.h>
#include <zephyr/bluetooth/addr.h>
 
struct unicast_server_snk_vars {
        bool waiting_for_disc;
        uint32_t locations;
        struct bt_bap_lc3_preset lc3_preset[CONFIG_BT_BAP_UNICAST_CLIENT_ASE_SNK_COUNT];
        struct bt_audio_codec_cap codec_caps[CONFIG_CODEC_CAP_COUNT_MAX];
        size_t num_codec_caps;
        struct bt_bap_ep *eps[CONFIG_BT_BAP_UNICAST_CLIENT_ASE_SNK_COUNT];
        size_t num_eps;
        enum bt_audio_context supported_ctx;
        enum bt_audio_context available_ctx;
        struct bt_cap_stream cap_streams[CONFIG_BT_BAP_UNICAST_CLIENT_ASE_SNK_COUNT];
};
 
struct unicast_server_src_vars {
        bool waiting_for_disc;
        uint32_t locations;
        struct bt_bap_lc3_preset lc3_preset[CONFIG_BT_BAP_UNICAST_CLIENT_ASE_SRC_COUNT];
        struct bt_audio_codec_cap codec_caps[CONFIG_CODEC_CAP_COUNT_MAX];
        size_t num_codec_caps;
        struct bt_bap_ep *eps[CONFIG_BT_BAP_UNICAST_CLIENT_ASE_SRC_COUNT];
        size_t num_eps;
        enum bt_audio_context supported_ctx;
        enum bt_audio_context available_ctx;
        struct bt_cap_stream cap_streams[CONFIG_BT_BAP_UNICAST_CLIENT_ASE_SRC_COUNT];
};
 
/* This struct holds the parameters for a given unicast server/headset device */
struct server_store {
        char *name;
        bt_addr_le_t addr;
        struct bt_conn *conn;
        const struct bt_csip_set_coordinator_set_member *member;
        struct unicast_server_snk_vars snk;
        struct unicast_server_src_vars src;
};
 
struct client_supp_configs {
        enum bt_audio_codec_cap_freq freq;
        enum bt_audio_codec_cap_frame_dur dur;
        enum bt_audio_codec_cap_chan_count chan_count;
        struct bt_audio_codec_octets_per_codec_frame oct_per_codec_frame;
};
 
typedef bool (*srv_store_foreach_func_t)(struct server_store *server, void *user_data);
 
int srv_store_foreach_server(srv_store_foreach_func_t func, void *user_data);
 
bool srv_store_preset_validated(struct bt_audio_codec_cfg const *const new,
                                struct bt_audio_codec_cfg const *const existing,
                                uint8_t pref_sample_rate_value);
 
int srv_store_pres_dly_find(struct bt_bap_stream *stream, uint32_t *computed_pres_dly_us,
                            uint32_t *existing_pres_dly_us,
                            struct bt_bap_qos_cfg_pref const *server_qos_pref,
                            bool *group_reconfig_needed,
                            struct bt_cap_unicast_group *unicast_group);
 
int srv_store_location_set(struct bt_conn const *const conn, enum bt_audio_dir dir,
                           enum bt_audio_location loc);
 
int srv_store_valid_codec_cap_check(struct bt_conn const *const conn, enum bt_audio_dir dir,
                                    uint32_t *valid_codec_caps,
                                    struct client_supp_configs const **const client_supp_cfgs,
                                    uint8_t num_client_supp_cfgs);
 
int srv_store_from_stream_get(struct bt_bap_stream const *const stream,
                              struct server_store **server);
 
int srv_store_all_ep_state_count(enum bt_bap_ep_state state, enum bt_audio_dir dir);
 
int srv_store_avail_context_set(struct bt_conn *conn, enum bt_audio_context snk_ctx,
                                enum bt_audio_context src_ctx);
 
int srv_store_codec_cap_set(struct bt_conn const *const conn, enum bt_audio_dir dir,
                            struct bt_audio_codec_cap const *const codec);
 
int srv_store_from_addr_get(bt_addr_le_t const *const addr, struct server_store **server);
 
bool srv_store_server_exists(bt_addr_le_t const *const addr);
 
int srv_store_from_conn_get(struct bt_conn const *const conn, struct server_store **server);
 
int srv_store_num_get(void);
 
int srv_store_add_by_conn(struct bt_conn *conn);
 
int srv_store_add_by_addr(const bt_addr_le_t *addr);
 
int srv_store_conn_update(struct bt_conn *conn, bt_addr_le_t const *const addr);
 
int srv_store_clear_by_conn(struct bt_conn const *const conn);
 
int srv_store_remove_by_conn(struct bt_conn const *const conn);
 
int srv_store_remove_by_addr(bt_addr_le_t const *const addr);
 
int srv_store_remove_all(bool force);
 
int _srv_store_lock(k_timeout_t timeout, const char *file, int line);
 
#ifdef CONFIG_DEBUG
#define srv_store_lock(timeout) _srv_store_lock(timeout, __func__, __LINE__)
#else
#define srv_store_lock(timeout) _srv_store_lock(timeout, NULL, 0)
#endif
 
void srv_store_unlock(void);
 
int srv_store_init(void);
 
#endif /* _SERVER_STORE_H_ */