csis.h

Go to the documentation of this file.

 
#ifndef ZEPHYR_SUBSYS_BLUETOOTH_AUDIO_CSIS_H_
#define ZEPHYR_SUBSYS_BLUETOOTH_AUDIO_CSIS_H_
 
#include <zephyr/types.h>
#include <stdbool.h>
#include <zephyr/bluetooth/conn.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define CSIS_CLIENT_DISCOVER_TIMER_VALUE        K_SECONDS(10)
 
#if defined(CONFIG_BT_CSIS_CLIENT)
#define BT_CSIS_CLIENT_MAX_CSIS_INSTANCES CONFIG_BT_CSIS_CLIENT_MAX_CSIS_INSTANCES
#else
#define BT_CSIS_CLIENT_MAX_CSIS_INSTANCES 0
#endif /* CONFIG_BT_CSIS_CLIENT */
 
#define BT_CSIS_READ_SIRK_REQ_RSP_ACCEPT        0x00
#define BT_CSIS_READ_SIRK_REQ_RSP_ACCEPT_ENC    0x01
#define BT_CSIS_READ_SIRK_REQ_RSP_REJECT        0x02
#define BT_CSIS_READ_SIRK_REQ_RSP_OOB_ONLY      0x03
 
#define BT_CSIS_SET_SIRK_SIZE 16
 
#define BT_CSIS_RSI_SIZE                        6
 
/* Coordinate Set Identification Service Error codes */
#define BT_CSIS_ERROR_LOCK_DENIED               0x80
#define BT_CSIS_ERROR_LOCK_RELEASE_DENIED       0x81
#define BT_CSIS_ERROR_LOCK_INVAL_VALUE          0x82
#define BT_CSIS_ERROR_SIRK_OOB_ONLY             0x83
#define BT_CSIS_ERROR_LOCK_ALREADY_GRANTED      0x84
 
#define BT_CSIS_DATA_RSI(_rsi) BT_DATA(BT_DATA_CSIS_RSI, _rsi, BT_CSIS_RSI_SIZE)
 
struct bt_csis;
 
struct bt_csis_cb {
        void (*lock_changed)(struct bt_conn *conn, struct bt_csis *csis,
                             bool locked);
 
        uint8_t (*sirk_read_req)(struct bt_conn *conn, struct bt_csis *csis);
};
 
struct bt_csis_register_param {
        uint8_t set_size;
 
        uint8_t set_sirk[BT_CSIS_SET_SIRK_SIZE];
 
        bool lockable;
 
        uint8_t rank;
 
        struct bt_csis_cb *cb;
 
#if CONFIG_BT_CSIS_MAX_INSTANCE_COUNT > 1
        const struct bt_gatt_service *parent;
#endif /* CONFIG_BT_CSIS_MAX_INSTANCE_COUNT > 1 */
};
 
void *bt_csis_svc_decl_get(const struct bt_csis *csis);
 
int bt_csis_register(const struct bt_csis_register_param *param,
                     struct bt_csis **csis);
 
void bt_csis_print_sirk(const struct bt_csis *csis);
 
int bt_csis_generate_rsi(const struct bt_csis *csis, uint8_t rsi[BT_CSIS_RSI_SIZE]);
 
int bt_csis_lock(struct bt_csis *csis, bool lock, bool force);
 
struct bt_csis_client_set_info {
        uint8_t set_sirk[BT_CSIS_SET_SIRK_SIZE];
 
        uint8_t set_size;
 
        uint8_t rank;
};
 
struct bt_csis_client_csis_inst {
        struct bt_csis_client_set_info info;
 
        struct bt_csis *csis;
};
 
struct bt_csis_client_set_member {
        struct bt_conn *conn;
        struct bt_csis_client_csis_inst insts[BT_CSIS_CLIENT_MAX_CSIS_INSTANCES];
};
 
typedef void (*bt_csis_client_discover_cb)(struct bt_csis_client_set_member *member,
                                           int err, uint8_t set_count);
 
int bt_csis_client_discover(struct bt_csis_client_set_member *member);
 
typedef void (*bt_csis_client_lock_set_cb)(int err);
 
typedef void (*bt_csis_client_lock_changed_cb)(struct bt_csis_client_csis_inst *inst,
                                               bool locked);
 
typedef void (*bt_csis_client_ordered_access_cb_t)(const struct bt_csis_client_set_info *set_info,
                                                   int err, bool locked,
                                                   struct bt_csis_client_set_member *member);
 
struct bt_csis_client_cb {
        /* Set callbacks */
        bt_csis_client_lock_set_cb             lock_set;
        bt_csis_client_lock_set_cb             release_set;
        bt_csis_client_lock_changed_cb         lock_changed;
 
        /* Device specific callbacks */
        bt_csis_client_discover_cb             discover;
        bt_csis_client_ordered_access_cb_t     ordered_access;
};
 
bool bt_csis_client_is_set_member(uint8_t set_sirk[BT_CSIS_SET_SIRK_SIZE],
                                  struct bt_data *data);
 
void bt_csis_client_register_cb(struct bt_csis_client_cb *cb);
 
typedef bool (*bt_csis_client_ordered_access_t)(const struct bt_csis_client_set_info *set_info,
                                                struct bt_csis_client_set_member *members[],
                                                size_t count);
 
int bt_csis_client_ordered_access(struct bt_csis_client_set_member *members[],
                                  uint8_t count,
                                  const struct bt_csis_client_set_info *set_info,
                                  bt_csis_client_ordered_access_t cb);
 
int bt_csis_client_lock(struct bt_csis_client_set_member **members,
                        uint8_t count,
                        const struct bt_csis_client_set_info *set_info);
 
int bt_csis_client_release(struct bt_csis_client_set_member **members,
                           uint8_t count,
                           const struct bt_csis_client_set_info *set_info);
 
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_SUBSYS_BLUETOOTH_AUDIO_CSIS_H_ */