1 /** @file 2 * @brief Internal APIs for Bluetooth L2CAP handling. 3 */ 4 5 /* 6 * Copyright (c) 2015-2016 Intel Corporation 7 * 8 * SPDX-License-Identifier: Apache-2.0 9 */ 10 11 #include <zephyr/bluetooth/l2cap.h> 12 #include <zephyr/sys/iterable_sections.h> 13 #include "host/classic/l2cap_br_interface.h" 14 15 enum l2cap_conn_list_action { 16 BT_L2CAP_CHAN_LOOKUP, 17 BT_L2CAP_CHAN_DETACH, 18 }; 19 20 #define BT_L2CAP_CID_BR_SIG 0x0001 21 #define BT_L2CAP_CID_ATT 0x0004 22 #define BT_L2CAP_CID_LE_SIG 0x0005 23 #define BT_L2CAP_CID_SMP 0x0006 24 #define BT_L2CAP_CID_BR_SMP 0x0007 25 26 #define BT_L2CAP_PSM_RFCOMM 0x0003 27 28 struct bt_l2cap_hdr { 29 uint16_t len; 30 uint16_t cid; 31 } __packed; 32 33 struct bt_l2cap_sig_hdr { 34 uint8_t code; 35 uint8_t ident; 36 uint16_t len; 37 } __packed; 38 39 #define BT_L2CAP_REJ_NOT_UNDERSTOOD 0x0000 40 #define BT_L2CAP_REJ_MTU_EXCEEDED 0x0001 41 #define BT_L2CAP_REJ_INVALID_CID 0x0002 42 43 #define BT_L2CAP_CMD_REJECT 0x01 44 struct bt_l2cap_cmd_reject { 45 uint16_t reason; 46 uint8_t data[0]; 47 } __packed; 48 49 struct bt_l2cap_cmd_reject_cid_data { 50 uint16_t scid; 51 uint16_t dcid; 52 } __packed; 53 54 #define BT_L2CAP_DISCONN_REQ 0x06 55 struct bt_l2cap_disconn_req { 56 uint16_t dcid; 57 uint16_t scid; 58 } __packed; 59 60 #define BT_L2CAP_DISCONN_RSP 0x07 61 struct bt_l2cap_disconn_rsp { 62 uint16_t dcid; 63 uint16_t scid; 64 } __packed; 65 66 #define BT_L2CAP_CONN_PARAM_REQ 0x12 67 struct bt_l2cap_conn_param_req { 68 uint16_t min_interval; 69 uint16_t max_interval; 70 uint16_t latency; 71 uint16_t timeout; 72 } __packed; 73 74 #define BT_L2CAP_CONN_PARAM_ACCEPTED 0x0000 75 #define BT_L2CAP_CONN_PARAM_REJECTED 0x0001 76 77 #define BT_L2CAP_CONN_PARAM_RSP 0x13 78 struct bt_l2cap_conn_param_rsp { 79 uint16_t result; 80 } __packed; 81 82 #define BT_L2CAP_LE_CONN_REQ 0x14 83 struct bt_l2cap_le_conn_req { 84 uint16_t psm; 85 uint16_t scid; 86 uint16_t mtu; 87 uint16_t mps; 88 uint16_t credits; 89 } __packed; 90 91 /* valid results in conn response on LE */ 92 #define BT_L2CAP_LE_SUCCESS 0x0000 93 #define BT_L2CAP_LE_ERR_PSM_NOT_SUPP 0x0002 94 #define BT_L2CAP_LE_ERR_NO_RESOURCES 0x0004 95 #define BT_L2CAP_LE_ERR_AUTHENTICATION 0x0005 96 #define BT_L2CAP_LE_ERR_AUTHORIZATION 0x0006 97 #define BT_L2CAP_LE_ERR_KEY_SIZE 0x0007 98 #define BT_L2CAP_LE_ERR_ENCRYPTION 0x0008 99 #define BT_L2CAP_LE_ERR_INVALID_SCID 0x0009 100 #define BT_L2CAP_LE_ERR_SCID_IN_USE 0x000A 101 #define BT_L2CAP_LE_ERR_UNACCEPT_PARAMS 0x000B 102 #define BT_L2CAP_LE_ERR_INVALID_PARAMS 0x000C 103 104 #define BT_L2CAP_LE_CONN_RSP 0x15 105 struct bt_l2cap_le_conn_rsp { 106 uint16_t dcid; 107 uint16_t mtu; 108 uint16_t mps; 109 uint16_t credits; 110 uint16_t result; 111 } __packed; 112 113 #define BT_L2CAP_LE_CREDITS 0x16 114 struct bt_l2cap_le_credits { 115 uint16_t cid; 116 uint16_t credits; 117 } __packed; 118 119 #define BT_L2CAP_ECRED_CONN_REQ 0x17 120 struct bt_l2cap_ecred_conn_req { 121 uint16_t psm; 122 uint16_t mtu; 123 uint16_t mps; 124 uint16_t credits; 125 uint16_t scid[0]; 126 } __packed; 127 128 #define BT_L2CAP_ECRED_CONN_RSP 0x18 129 struct bt_l2cap_ecred_conn_rsp { 130 uint16_t mtu; 131 uint16_t mps; 132 uint16_t credits; 133 uint16_t result; 134 uint16_t dcid[0]; 135 } __packed; 136 137 #define BT_L2CAP_ECRED_RECONF_REQ 0x19 138 struct bt_l2cap_ecred_reconf_req { 139 uint16_t mtu; 140 uint16_t mps; 141 uint16_t scid[0]; 142 } __packed; 143 144 #define BT_L2CAP_RECONF_SUCCESS 0x0000 145 #define BT_L2CAP_RECONF_INVALID_MTU 0x0001 146 #define BT_L2CAP_RECONF_INVALID_MPS 0x0002 147 #define BT_L2CAP_RECONF_INVALID_CID 0x0003 148 #define BT_L2CAP_RECONF_OTHER_UNACCEPT 0x0004 149 150 #define BT_L2CAP_ECRED_RECONF_RSP 0x1a 151 struct bt_l2cap_ecred_reconf_rsp { 152 uint16_t result; 153 } __packed; 154 155 struct bt_l2cap_fixed_chan { 156 uint16_t cid; 157 int (*accept)(struct bt_conn *conn, struct bt_l2cap_chan **chan); 158 bt_l2cap_chan_destroy_t destroy; 159 }; 160 161 #define BT_L2CAP_CHANNEL_DEFINE(_name, _cid, _accept, _destroy) \ 162 const STRUCT_SECTION_ITERABLE(bt_l2cap_fixed_chan, _name) = { \ 163 .cid = _cid, \ 164 .accept = _accept, \ 165 .destroy = _destroy, \ 166 } 167 168 /* Notify L2CAP channels of a new connection */ 169 void bt_l2cap_connected(struct bt_conn *conn); 170 171 /* Notify L2CAP channels of a disconnect event */ 172 void bt_l2cap_disconnected(struct bt_conn *conn); 173 174 /* Add channel to the connection */ 175 void bt_l2cap_chan_add(struct bt_conn *conn, struct bt_l2cap_chan *chan, 176 bt_l2cap_chan_destroy_t destroy); 177 178 /* Remove channel from the connection */ 179 void bt_l2cap_chan_remove(struct bt_conn *conn, struct bt_l2cap_chan *chan); 180 181 /* Delete channel */ 182 void bt_l2cap_chan_del(struct bt_l2cap_chan *chan); 183 184 const char *bt_l2cap_chan_state_str(bt_l2cap_chan_state_t state); 185 186 #if defined(CONFIG_BT_L2CAP_LOG_LEVEL_DBG) 187 void bt_l2cap_chan_set_state_debug(struct bt_l2cap_chan *chan, 188 bt_l2cap_chan_state_t state, 189 const char *func, int line); 190 #define bt_l2cap_chan_set_state(_chan, _state) \ 191 bt_l2cap_chan_set_state_debug(_chan, _state, __func__, __LINE__) 192 #else 193 void bt_l2cap_chan_set_state(struct bt_l2cap_chan *chan, 194 bt_l2cap_chan_state_t state); 195 #endif /* CONFIG_BT_L2CAP_LOG_LEVEL_DBG */ 196 197 /* 198 * Notify L2CAP channels of a change in encryption state passing additionally 199 * HCI status of performed security procedure. 200 */ 201 void bt_l2cap_security_changed(struct bt_conn *conn, uint8_t hci_status); 202 203 /* Prepare an L2CAP PDU to be sent over a connection */ 204 struct net_buf *bt_l2cap_create_pdu_timeout(struct net_buf_pool *pool, 205 size_t reserve, 206 k_timeout_t timeout); 207 208 #define bt_l2cap_create_pdu(_pool, _reserve) \ 209 bt_l2cap_create_pdu_timeout(_pool, _reserve, K_FOREVER) 210 211 /* Send L2CAP PDU over a connection 212 * 213 * Buffer ownership is transferred to stack in case of success. 214 */ 215 int bt_l2cap_send_pdu(struct bt_l2cap_le_chan *le_chan, struct net_buf *pdu, 216 bt_conn_tx_cb_t cb, void *user_data); 217 218 /* Receive a new L2CAP PDU from a connection */ 219 void bt_l2cap_recv(struct bt_conn *conn, struct net_buf *buf, bool complete); 220 221 /* Perform connection parameter update request */ 222 int bt_l2cap_update_conn_param(struct bt_conn *conn, 223 const struct bt_le_conn_param *param); 224 225 /* Initialize L2CAP and supported channels */ 226 void bt_l2cap_init(void); 227 228 /* Lookup channel by Transmission CID */ 229 struct bt_l2cap_chan *bt_l2cap_le_lookup_tx_cid(struct bt_conn *conn, 230 uint16_t cid); 231 232 /* Lookup channel by Receiver CID */ 233 struct bt_l2cap_chan *bt_l2cap_le_lookup_rx_cid(struct bt_conn *conn, 234 uint16_t cid); 235 236 struct bt_l2cap_ecred_cb { 237 void (*ecred_conn_rsp)(struct bt_conn *conn, uint16_t result, uint8_t attempted, 238 uint8_t succeeded, uint16_t psm); 239 void (*ecred_conn_req)(struct bt_conn *conn, uint16_t result, uint16_t psm); 240 }; 241 242 /* Register callbacks for Enhanced Credit based Flow Control */ 243 void bt_l2cap_register_ecred_cb(const struct bt_l2cap_ecred_cb *cb); 244 245 /* Returns a server if it exists for given psm. */ 246 struct bt_l2cap_server *bt_l2cap_server_lookup_psm(uint16_t psm); 247 248 /* Pull data from the L2CAP layer */ 249 struct net_buf *l2cap_data_pull(struct bt_conn *conn, 250 size_t amount, 251 size_t *length); 252
