373 lines
10 KiB
C
373 lines
10 KiB
C
/** @file
|
|
* @brief Internal APIs for Bluetooth L2CAP handling.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (c) 2015-2016 Intel Corporation
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#include <bluetooth/l2cap.h>
|
|
|
|
enum l2cap_conn_list_action {
|
|
BT_L2CAP_CHAN_LOOKUP,
|
|
BT_L2CAP_CHAN_DETACH,
|
|
};
|
|
|
|
#define BT_L2CAP_CID_BR_SIG 0x0001
|
|
#define BT_L2CAP_CID_ATT 0x0004
|
|
#define BT_L2CAP_CID_LE_SIG 0x0005
|
|
#define BT_L2CAP_CID_SMP 0x0006
|
|
#define BT_L2CAP_CID_BR_SMP 0x0007
|
|
|
|
#define BT_L2CAP_PSM_RFCOMM 0x0003
|
|
|
|
struct bt_l2cap_hdr {
|
|
uint16_t len;
|
|
uint16_t cid;
|
|
} __packed;
|
|
|
|
struct bt_l2cap_sig_hdr {
|
|
uint8_t code;
|
|
uint8_t ident;
|
|
uint16_t len;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_REJ_NOT_UNDERSTOOD 0x0000
|
|
#define BT_L2CAP_REJ_MTU_EXCEEDED 0x0001
|
|
#define BT_L2CAP_REJ_INVALID_CID 0x0002
|
|
|
|
#define BT_L2CAP_CMD_REJECT 0x01
|
|
struct bt_l2cap_cmd_reject {
|
|
uint16_t reason;
|
|
uint8_t data[0];
|
|
} __packed;
|
|
|
|
struct bt_l2cap_cmd_reject_cid_data {
|
|
uint16_t scid;
|
|
uint16_t dcid;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_CONN_REQ 0x02
|
|
struct bt_l2cap_conn_req {
|
|
uint16_t psm;
|
|
uint16_t scid;
|
|
} __packed;
|
|
|
|
/* command statuses in response */
|
|
#define BT_L2CAP_CS_NO_INFO 0x0000
|
|
#define BT_L2CAP_CS_AUTHEN_PEND 0x0001
|
|
|
|
/* valid results in conn response on BR/EDR */
|
|
#define BT_L2CAP_BR_SUCCESS 0x0000
|
|
#define BT_L2CAP_BR_PENDING 0x0001
|
|
#define BT_L2CAP_BR_ERR_PSM_NOT_SUPP 0x0002
|
|
#define BT_L2CAP_BR_ERR_SEC_BLOCK 0x0003
|
|
#define BT_L2CAP_BR_ERR_NO_RESOURCES 0x0004
|
|
#define BT_L2CAP_BR_ERR_INVALID_SCID 0x0006
|
|
#define BT_L2CAP_BR_ERR_SCID_IN_USE 0x0007
|
|
|
|
#define BT_L2CAP_CONN_RSP 0x03
|
|
struct bt_l2cap_conn_rsp {
|
|
uint16_t dcid;
|
|
uint16_t scid;
|
|
uint16_t result;
|
|
uint16_t status;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_CONF_SUCCESS 0x0000
|
|
#define BT_L2CAP_CONF_UNACCEPT 0x0001
|
|
#define BT_L2CAP_CONF_REJECT 0x0002
|
|
|
|
#define BT_L2CAP_CONF_REQ 0x04
|
|
struct bt_l2cap_conf_req {
|
|
uint16_t dcid;
|
|
uint16_t flags;
|
|
uint8_t data[0];
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_CONF_RSP 0x05
|
|
struct bt_l2cap_conf_rsp {
|
|
uint16_t scid;
|
|
uint16_t flags;
|
|
uint16_t result;
|
|
uint8_t data[0];
|
|
} __packed;
|
|
|
|
/* Option type used by MTU config request data */
|
|
#define BT_L2CAP_CONF_OPT_MTU 0x01
|
|
/* Options bits selecting most significant bit (hint) in type field */
|
|
#define BT_L2CAP_CONF_HINT 0x80
|
|
#define BT_L2CAP_CONF_MASK 0x7f
|
|
|
|
struct bt_l2cap_conf_opt {
|
|
uint8_t type;
|
|
uint8_t len;
|
|
uint8_t data[0];
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_DISCONN_REQ 0x06
|
|
struct bt_l2cap_disconn_req {
|
|
uint16_t dcid;
|
|
uint16_t scid;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_DISCONN_RSP 0x07
|
|
struct bt_l2cap_disconn_rsp {
|
|
uint16_t dcid;
|
|
uint16_t scid;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_INFO_FEAT_MASK 0x0002
|
|
#define BT_L2CAP_INFO_FIXED_CHAN 0x0003
|
|
|
|
#define BT_L2CAP_INFO_REQ 0x0a
|
|
struct bt_l2cap_info_req {
|
|
uint16_t type;
|
|
} __packed;
|
|
|
|
/* info result */
|
|
#define BT_L2CAP_INFO_SUCCESS 0x0000
|
|
#define BT_L2CAP_INFO_NOTSUPP 0x0001
|
|
|
|
#define BT_L2CAP_INFO_RSP 0x0b
|
|
struct bt_l2cap_info_rsp {
|
|
uint16_t type;
|
|
uint16_t result;
|
|
uint8_t data[0];
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_CONN_PARAM_REQ 0x12
|
|
struct bt_l2cap_conn_param_req {
|
|
uint16_t min_interval;
|
|
uint16_t max_interval;
|
|
uint16_t latency;
|
|
uint16_t timeout;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_CONN_PARAM_ACCEPTED 0x0000
|
|
#define BT_L2CAP_CONN_PARAM_REJECTED 0x0001
|
|
|
|
#define BT_L2CAP_CONN_PARAM_RSP 0x13
|
|
struct bt_l2cap_conn_param_rsp {
|
|
uint16_t result;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_LE_CONN_REQ 0x14
|
|
struct bt_l2cap_le_conn_req {
|
|
uint16_t psm;
|
|
uint16_t scid;
|
|
uint16_t mtu;
|
|
uint16_t mps;
|
|
uint16_t credits;
|
|
} __packed;
|
|
|
|
/* valid results in conn response on LE */
|
|
#define BT_L2CAP_LE_SUCCESS 0x0000
|
|
#define BT_L2CAP_LE_ERR_PSM_NOT_SUPP 0x0002
|
|
#define BT_L2CAP_LE_ERR_NO_RESOURCES 0x0004
|
|
#define BT_L2CAP_LE_ERR_AUTHENTICATION 0x0005
|
|
#define BT_L2CAP_LE_ERR_AUTHORIZATION 0x0006
|
|
#define BT_L2CAP_LE_ERR_KEY_SIZE 0x0007
|
|
#define BT_L2CAP_LE_ERR_ENCRYPTION 0x0008
|
|
#define BT_L2CAP_LE_ERR_INVALID_SCID 0x0009
|
|
#define BT_L2CAP_LE_ERR_SCID_IN_USE 0x000A
|
|
#define BT_L2CAP_LE_ERR_UNACCEPT_PARAMS 0x000B
|
|
#define BT_L2CAP_LE_ERR_INVALID_PARAMS 0x000C
|
|
|
|
#define BT_L2CAP_LE_CONN_RSP 0x15
|
|
struct bt_l2cap_le_conn_rsp {
|
|
uint16_t dcid;
|
|
uint16_t mtu;
|
|
uint16_t mps;
|
|
uint16_t credits;
|
|
uint16_t result;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_LE_CREDITS 0x16
|
|
struct bt_l2cap_le_credits {
|
|
uint16_t cid;
|
|
uint16_t credits;
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_ECRED_CONN_REQ 0x17
|
|
struct bt_l2cap_ecred_conn_req {
|
|
uint16_t psm;
|
|
uint16_t mtu;
|
|
uint16_t mps;
|
|
uint16_t credits;
|
|
uint16_t scid[0];
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_ECRED_CONN_RSP 0x18
|
|
struct bt_l2cap_ecred_conn_rsp {
|
|
uint16_t mtu;
|
|
uint16_t mps;
|
|
uint16_t credits;
|
|
uint16_t result;
|
|
uint16_t dcid[0];
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_ECRED_RECONF_REQ 0x19
|
|
struct bt_l2cap_ecred_reconf_req {
|
|
uint16_t mtu;
|
|
uint16_t mps;
|
|
uint16_t scid[0];
|
|
} __packed;
|
|
|
|
#define BT_L2CAP_RECONF_SUCCESS 0x0000
|
|
#define BT_L2CAP_RECONF_INVALID_MTU 0x0001
|
|
#define BT_L2CAP_RECONF_INVALID_MPS 0x0002
|
|
#define BT_L2CAP_RECONF_INVALID_CID 0x0003
|
|
#define BT_L2CAP_RECONF_OTHER_UNACCEPT 0x0004
|
|
|
|
#define BT_L2CAP_ECRED_RECONF_RSP 0x1a
|
|
struct bt_l2cap_ecred_reconf_rsp {
|
|
uint16_t result;
|
|
} __packed;
|
|
|
|
struct bt_l2cap_fixed_chan {
|
|
uint16_t cid;
|
|
int (*accept)(struct bt_conn *conn, struct bt_l2cap_chan **chan);
|
|
bt_l2cap_chan_destroy_t destroy;
|
|
};
|
|
|
|
#define BT_L2CAP_CHANNEL_DEFINE(_name, _cid, _accept, _destroy) \
|
|
const STRUCT_SECTION_ITERABLE(bt_l2cap_fixed_chan, _name) = { \
|
|
.cid = _cid, \
|
|
.accept = _accept, \
|
|
.destroy = _destroy, \
|
|
}
|
|
|
|
/* Need a name different than bt_l2cap_fixed_chan for a different section */
|
|
struct bt_l2cap_br_fixed_chan {
|
|
uint16_t cid;
|
|
int (*accept)(struct bt_conn *conn, struct bt_l2cap_chan **chan);
|
|
};
|
|
|
|
#define BT_L2CAP_BR_CHANNEL_DEFINE(_name, _cid, _accept) \
|
|
const STRUCT_SECTION_ITERABLE(bt_l2cap_br_fixed_chan, _name) = { \
|
|
.cid = _cid, \
|
|
.accept = _accept, \
|
|
}
|
|
|
|
/* Notify L2CAP channels of a new connection */
|
|
void bt_l2cap_connected(struct bt_conn *conn);
|
|
|
|
/* Notify L2CAP channels of a disconnect event */
|
|
void bt_l2cap_disconnected(struct bt_conn *conn);
|
|
|
|
/* Add channel to the connection */
|
|
void bt_l2cap_chan_add(struct bt_conn *conn, struct bt_l2cap_chan *chan,
|
|
bt_l2cap_chan_destroy_t destroy);
|
|
|
|
/* Remove channel from the connection */
|
|
void bt_l2cap_chan_remove(struct bt_conn *conn, struct bt_l2cap_chan *chan);
|
|
|
|
/* Delete channel */
|
|
void bt_l2cap_chan_del(struct bt_l2cap_chan *chan);
|
|
|
|
const char *bt_l2cap_chan_state_str(bt_l2cap_chan_state_t state);
|
|
|
|
#if defined(CONFIG_BT_DEBUG_L2CAP)
|
|
void bt_l2cap_chan_set_state_debug(struct bt_l2cap_chan *chan,
|
|
bt_l2cap_chan_state_t state,
|
|
const char *func, int line);
|
|
#define bt_l2cap_chan_set_state(_chan, _state) \
|
|
bt_l2cap_chan_set_state_debug(_chan, _state, __func__, __LINE__)
|
|
#else
|
|
void bt_l2cap_chan_set_state(struct bt_l2cap_chan *chan,
|
|
bt_l2cap_chan_state_t state);
|
|
#endif /* CONFIG_BT_DEBUG_L2CAP */
|
|
|
|
/*
|
|
* Notify L2CAP channels of a change in encryption state passing additionally
|
|
* HCI status of performed security procedure.
|
|
*/
|
|
void bt_l2cap_security_changed(struct bt_conn *conn, uint8_t hci_status);
|
|
|
|
/* Prepare an L2CAP PDU to be sent over a connection */
|
|
struct net_buf *bt_l2cap_create_pdu_timeout(struct net_buf_pool *pool,
|
|
size_t reserve,
|
|
k_timeout_t timeout);
|
|
|
|
#define bt_l2cap_create_pdu(_pool, _reserve) \
|
|
bt_l2cap_create_pdu_timeout(_pool, _reserve, K_FOREVER)
|
|
|
|
/* Prepare a L2CAP Response PDU to be sent over a connection */
|
|
struct net_buf *bt_l2cap_create_rsp(struct net_buf *buf, size_t reserve);
|
|
|
|
/* Send L2CAP PDU over a connection
|
|
*
|
|
* Buffer ownership is transferred to stack in case of success.
|
|
*/
|
|
int bt_l2cap_send_cb(struct bt_conn *conn, uint16_t cid, struct net_buf *buf,
|
|
bt_conn_tx_cb_t cb, void *user_data);
|
|
|
|
static inline int bt_l2cap_send(struct bt_conn *conn, uint16_t cid,
|
|
struct net_buf *buf)
|
|
{
|
|
return bt_l2cap_send_cb(conn, cid, buf, NULL, NULL);
|
|
}
|
|
|
|
/* Receive a new L2CAP PDU from a connection */
|
|
void bt_l2cap_recv(struct bt_conn *conn, struct net_buf *buf, bool complete);
|
|
|
|
/* Perform connection parameter update request */
|
|
int bt_l2cap_update_conn_param(struct bt_conn *conn,
|
|
const struct bt_le_conn_param *param);
|
|
|
|
/* Initialize L2CAP and supported channels */
|
|
void bt_l2cap_init(void);
|
|
|
|
/* Lookup channel by Transmission CID */
|
|
struct bt_l2cap_chan *bt_l2cap_le_lookup_tx_cid(struct bt_conn *conn,
|
|
uint16_t cid);
|
|
|
|
/* Lookup channel by Receiver CID */
|
|
struct bt_l2cap_chan *bt_l2cap_le_lookup_rx_cid(struct bt_conn *conn,
|
|
uint16_t cid);
|
|
|
|
/* Initialize BR/EDR L2CAP signal layer */
|
|
void bt_l2cap_br_init(void);
|
|
|
|
/* Register fixed channel */
|
|
void bt_l2cap_br_fixed_chan_register(struct bt_l2cap_fixed_chan *chan);
|
|
|
|
/* Notify BR/EDR L2CAP channels about established new ACL connection */
|
|
void bt_l2cap_br_connected(struct bt_conn *conn);
|
|
|
|
/* Lookup BR/EDR L2CAP channel by Receiver CID */
|
|
struct bt_l2cap_chan *bt_l2cap_br_lookup_rx_cid(struct bt_conn *conn,
|
|
uint16_t cid);
|
|
|
|
/* Disconnects dynamic channel */
|
|
int bt_l2cap_br_chan_disconnect(struct bt_l2cap_chan *chan);
|
|
|
|
/* Make connection to peer psm server */
|
|
int bt_l2cap_br_chan_connect(struct bt_conn *conn, struct bt_l2cap_chan *chan,
|
|
uint16_t psm);
|
|
|
|
/* Send packet data to connected peer */
|
|
int bt_l2cap_br_chan_send(struct bt_l2cap_chan *chan, struct net_buf *buf);
|
|
|
|
/*
|
|
* Handle security level changed on link passing HCI status of performed
|
|
* security procedure.
|
|
*/
|
|
void l2cap_br_encrypt_change(struct bt_conn *conn, uint8_t hci_status);
|
|
|
|
/* Handle received data */
|
|
void bt_l2cap_br_recv(struct bt_conn *conn, struct net_buf *buf);
|
|
|
|
struct bt_l2cap_ecred_cb {
|
|
void (*ecred_conn_rsp)(struct bt_conn *conn, uint16_t result, uint8_t attempted,
|
|
uint8_t succeeded);
|
|
void (*ecred_conn_req)(struct bt_conn *conn, uint16_t result, uint8_t attempted,
|
|
uint8_t succeeded);
|
|
};
|
|
|
|
/* Register callbacks for Enhanced Credit based Flow Control */
|
|
void bt_l2cap_register_ecred_cb(const struct bt_l2cap_ecred_cb *cb);
|