| /** @file |
| * @brief Internal APIs for Bluetooth L2CAP handling. |
| */ |
| |
| /* |
| * Copyright (c) 2015-2016 Intel Corporation |
| * |
| * SPDX-License-Identifier: Apache-2.0 |
| */ |
| |
| #include <zephyr/bluetooth/l2cap.h> |
| #include <zephyr/sys/iterable_sections.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 L2CAP_ECRED_CHAN_MAX_PER_REQ 5 |
| |
| #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, \ |
| } |
| |
| #define BR_CHAN(_ch) CONTAINER_OF(_ch, struct bt_l2cap_br_chan, chan) |
| |
| /* 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_L2CAP_LOG_LEVEL_DBG) |
| 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_L2CAP_LOG_LEVEL_DBG */ |
| |
| /* |
| * 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); |
| } |
| |
| int bt_l2cap_chan_send_cb(struct bt_l2cap_chan *chan, struct net_buf *buf, bt_conn_tx_cb_t cb, |
| void *user_data); |
| |
| /* 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); |
| int bt_l2cap_br_chan_send_cb(struct bt_l2cap_chan *chan, struct net_buf *buf, bt_conn_tx_cb_t cb, |
| void *user_data); |
| |
| /* |
| * 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, uint16_t psm); |
| void (*ecred_conn_req)(struct bt_conn *conn, uint16_t result, uint16_t psm); |
| }; |
| |
| /* Register callbacks for Enhanced Credit based Flow Control */ |
| void bt_l2cap_register_ecred_cb(const struct bt_l2cap_ecred_cb *cb); |
| |
| /* Returns a server if it exists for given psm. */ |
| struct bt_l2cap_server *bt_l2cap_server_lookup_psm(uint16_t psm); |
