tbs.h

Go to the documentation of this file.

 
#ifndef ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_TBS_H_
#define ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_TBS_H_
 
#include <zephyr/types.h>
#include <zephyr/bluetooth/conn.h>
 
/* Call States */
#define BT_TBS_CALL_STATE_INCOMING                      0x00
#define BT_TBS_CALL_STATE_DIALING                       0x01
#define BT_TBS_CALL_STATE_ALERTING                      0x02
#define BT_TBS_CALL_STATE_ACTIVE                        0x03
#define BT_TBS_CALL_STATE_LOCALLY_HELD                  0x04
#define BT_TBS_CALL_STATE_REMOTELY_HELD                 0x05
#define BT_TBS_CALL_STATE_LOCALLY_AND_REMOTELY_HELD     0x06
 
/* Terminate Reason */
#define BT_TBS_REASON_BAD_REMOTE_URI                    0x00
#define BT_TBS_REASON_CALL_FAILED                       0x01
#define BT_TBS_REASON_REMOTE_ENDED_CALL                 0x02
#define BT_TBS_REASON_SERVER_ENDED_CALL                 0x03
#define BT_TBS_REASON_LINE_BUSY                         0x04
#define BT_TBS_REASON_NETWORK_CONGESTED                 0x05
#define BT_TBS_REASON_CLIENT_TERMINATED                 0x06
#define BT_TBS_REASON_UNSPECIFIED                       0x07
 
/* Application error codes */
#define BT_TBS_RESULT_CODE_SUCCESS                      0x00
#define BT_TBS_RESULT_CODE_OPCODE_NOT_SUPPORTED         0x01
#define BT_TBS_RESULT_CODE_OPERATION_NOT_POSSIBLE       0x02
#define BT_TBS_RESULT_CODE_INVALID_CALL_INDEX           0x03
#define BT_TBS_RESULT_CODE_STATE_MISMATCH               0x04
#define BT_TBS_RESULT_CODE_OUT_OF_RESOURCES             0x05
#define BT_TBS_RESULT_CODE_INVALID_URI                  0x06
 
#define BT_TBS_FEATURE_HOLD                             BIT(0)
#define BT_TBS_FEATURE_JOIN                             BIT(1)
 
#define BT_TBS_CALL_FLAG_SET_INCOMING(flag)            (flag &= ~BIT(0))
#define BT_TBS_CALL_FLAG_SET_OUTGOING(flag)            (flag |= BIT(0))
 
#define BT_TBS_SIGNAL_STRENGTH_NO_SERVICE               0
#define BT_TBS_SIGNAL_STRENGTH_MAX                      100
#define BT_TBS_SIGNAL_STRENGTH_UNKNOWN                  255
 
/* Bearer Technology */
#define BT_TBS_TECHNOLOGY_3G                       0x01
#define BT_TBS_TECHNOLOGY_4G                       0x02
#define BT_TBS_TECHNOLOGY_LTE                      0x03
#define BT_TBS_TECHNOLOGY_WIFI                     0x04
#define BT_TBS_TECHNOLOGY_5G                       0x05
#define BT_TBS_TECHNOLOGY_GSM                      0x06
#define BT_TBS_TECHNOLOGY_CDMA                     0x07
#define BT_TBS_TECHNOLOGY_2G                       0x08
#define BT_TBS_TECHNOLOGY_WCDMA                    0x09
#define BT_TBS_TECHNOLOGY_IP                       0x0a
 
#define BT_TBS_GTBS_INDEX                               0xFF
 
typedef bool (*bt_tbs_originate_call_cb)(struct bt_conn *conn,
                                         uint8_t call_index,
                                         const char *uri);
 
typedef void (*bt_tbs_terminate_call_cb)(struct bt_conn *conn,
                                         uint8_t call_index,
                                         uint8_t reason);
 
typedef void (*bt_tbs_join_calls_cb)(struct bt_conn *conn,
                                     uint8_t call_index_count,
                                     const uint8_t *call_indexes);
 
typedef void (*bt_tbs_call_change_cb)(struct bt_conn *conn,
                                      uint8_t call_index);
 
typedef bool (*bt_tbs_authorize_cb)(struct bt_conn *conn);
 
struct bt_tbs_cb {
        bt_tbs_originate_call_cb      originate_call;
        bt_tbs_terminate_call_cb      terminate_call;
        bt_tbs_call_change_cb         hold_call;
        bt_tbs_call_change_cb         accept_call;
        bt_tbs_call_change_cb         retrieve_call;
        bt_tbs_join_calls_cb          join_calls;
        bt_tbs_authorize_cb           authorize;
};
 
int bt_tbs_accept(uint8_t call_index);
 
int bt_tbs_hold(uint8_t call_index);
 
int bt_tbs_retrieve(uint8_t call_index);
 
int bt_tbs_terminate(uint8_t call_index);
 
int bt_tbs_originate(uint8_t bearer_index, char *uri, uint8_t *call_index);
 
int bt_tbs_join(uint8_t call_index_cnt, uint8_t *call_indexes);
 
int bt_tbs_remote_answer(uint8_t call_index);
 
int bt_tbs_remote_hold(uint8_t call_index);
 
int bt_tbs_remote_retrieve(uint8_t call_index);
 
int bt_tbs_remote_terminate(uint8_t call_index);
 
int bt_tbs_remote_incoming(uint8_t bearer_index, const char *to,
                           const char *from, const char *friendly_name);
 
int bt_tbs_set_bearer_provider_name(uint8_t bearer_index, const char *name);
 
int bt_tbs_set_bearer_technology(uint8_t bearer_index, uint8_t new_technology);
 
int bt_tbs_set_signal_strength(uint8_t bearer_index,
                               uint8_t new_signal_strength);
 
int bt_tbs_set_status_flags(uint8_t bearer_index, uint16_t status_flags);
 
int bt_tbs_set_uri_scheme_list(uint8_t bearer_index, const char **uri_list,
                               uint8_t uri_count);
void bt_tbs_register_cb(struct bt_tbs_cb *cbs);
 
#if defined(CONFIG_BT_DEBUG_TBS)
void bt_tbs_dbg_print_calls(void);
#endif /* defined(CONFIG_BT_DEBUG_TBS) */
 
struct bt_tbs_client_call_state {
        uint8_t index;
        uint8_t state;
        uint8_t flags;
} __packed;
 
struct bt_tbs_client_call {
        struct bt_tbs_client_call_state call_info;
        char remote_uri[CONFIG_BT_TBS_MAX_URI_LENGTH + 1];
} __packed;
 
typedef void (*bt_tbs_client_discover_cb)(struct bt_conn *conn, int err,
                                          uint8_t tbs_count, bool gtbs_found);
 
typedef void (*bt_tbs_client_write_value_cb)(struct bt_conn *conn, int err,
                                             uint8_t inst_index);
 
typedef void (*bt_tbs_client_cp_cb)(struct bt_conn *conn, int err,
                                    uint8_t inst_index, uint8_t call_index);
 
typedef void (*bt_tbs_client_read_string_cb)(struct bt_conn *conn, int err,
                                             uint8_t inst_index,
                                             const char *value);
 
typedef void (*bt_tbs_client_read_value_cb)(struct bt_conn *conn, int err,
                                            uint8_t inst_index, uint32_t value);
 
typedef void (*bt_tbs_client_termination_reason_cb)(struct bt_conn *conn,
                                                    int err, uint8_t inst_index,
                                                    uint8_t call_index,
                                                    uint8_t reason);
 
typedef void (*bt_tbs_client_current_calls_cb)(struct bt_conn *conn, int err,
                                               uint8_t inst_index,
                                               uint8_t call_count,
                                               const struct bt_tbs_client_call *calls);
 
typedef void (*bt_tbs_client_call_states_cb)(struct bt_conn *conn, int err,
                                             uint8_t inst_index,
                                             uint8_t call_count,
                                             const struct bt_tbs_client_call_state *call_states);
 
struct bt_tbs_client_cb {
        bt_tbs_client_discover_cb            discover;
        bt_tbs_client_cp_cb                  originate_call;
        bt_tbs_client_cp_cb                  terminate_call;
        bt_tbs_client_cp_cb                  hold_call;
        bt_tbs_client_cp_cb                  accept_call;
        bt_tbs_client_cp_cb                  retrieve_call;
        bt_tbs_client_cp_cb                  join_calls;
 
        bt_tbs_client_read_string_cb         bearer_provider_name;
        bt_tbs_client_read_string_cb         bearer_uci;
        bt_tbs_client_read_value_cb          technology;
        bt_tbs_client_read_string_cb         uri_list;
        bt_tbs_client_read_value_cb          signal_strength;
        bt_tbs_client_read_value_cb          signal_interval;
        bt_tbs_client_current_calls_cb       current_calls;
        bt_tbs_client_read_value_cb          ccid;
        bt_tbs_client_read_value_cb          status_flags;
        bt_tbs_client_read_string_cb         call_uri;
        bt_tbs_client_call_states_cb         call_state;
        bt_tbs_client_read_value_cb          optional_opcodes;
        bt_tbs_client_termination_reason_cb  termination_reason;
        bt_tbs_client_read_string_cb         remote_uri;
        bt_tbs_client_read_string_cb         friendly_name;
};
 
int bt_tbs_client_discover(struct bt_conn *conn, bool subscribe);
 
int bt_tbs_client_set_outgoing_uri(struct bt_conn *conn, uint8_t inst_index,
                                   const char *uri);
 
int bt_tbs_client_set_signal_strength_interval(struct bt_conn *conn,
                                               uint8_t inst_index,
                                               uint8_t interval);
 
int bt_tbs_client_originate_call(struct bt_conn *conn, uint8_t inst_index,
                                 const char *uri);
 
int bt_tbs_client_terminate_call(struct bt_conn *conn, uint8_t inst_index,
                                 uint8_t call_index);
 
int bt_tbs_client_hold_call(struct bt_conn *conn, uint8_t inst_index,
                            uint8_t call_index);
 
int bt_tbs_client_accept_call(struct bt_conn *conn, uint8_t inst_index,
                              uint8_t call_index);
 
int bt_tbs_client_retrieve_call(struct bt_conn *conn, uint8_t inst_index,
                                uint8_t call_index);
 
int bt_tbs_client_join_calls(struct bt_conn *conn, uint8_t inst_index,
                             const uint8_t *call_indexes, uint8_t count);
 
int bt_tbs_client_read_bearer_provider_name(struct bt_conn *conn,
                                            uint8_t inst_index);
 
int bt_tbs_client_read_bearer_uci(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_technology(struct bt_conn *conn, uint8_t inst_index);
 
 
int bt_tbs_client_read_uri_list(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_signal_strength(struct bt_conn *conn,
                                       uint8_t inst_index);
 
int bt_tbs_client_read_signal_interval(struct bt_conn *conn,
                                       uint8_t inst_index);
 
int bt_tbs_client_read_current_calls(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_ccid(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_status_flags(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_call_uri(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_call_state(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_remote_uri(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_friendly_name(struct bt_conn *conn, uint8_t inst_index);
 
int bt_tbs_client_read_optional_opcodes(struct bt_conn *conn,
                                        uint8_t inst_index);
 
void bt_tbs_client_register_cb(const struct bt_tbs_client_cb *cbs);
 
#endif /* ZEPHYR_INCLUDE_BLUETOOTH_AUDIO_TBS_H_ */