1 /* 2 * Copyright (C) 2014 BlueKitchen GmbH 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 3. Neither the name of the copyright holders nor the names of 14 * contributors may be used to endorse or promote products derived 15 * from this software without specific prior written permission. 16 * 4. Any redistribution, use, or modification is done solely for 17 * personal benefit and not for any commercial purpose or for 18 * monetary gain. 19 * 20 * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS 21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 23 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS 24 * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 26 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 27 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 28 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 29 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 30 * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31 * SUCH DAMAGE. 32 * 33 * Please inquire about commercial licensing options at 34 * [email protected] 35 * 36 */ 37 38 #define BTSTACK_FILE__ "l2cap.c" 39 40 /* 41 * l2cap.c 42 * Logical Link Control and Adaption Protocol (L2CAP) 43 */ 44 45 #include "l2cap.h" 46 #include "hci.h" 47 #include "hci_dump.h" 48 #include "bluetooth_sdp.h" 49 #include "bluetooth_psm.h" 50 #include "btstack_bool.h" 51 #include "btstack_debug.h" 52 #include "btstack_event.h" 53 #include "btstack_memory.h" 54 55 #ifdef ENABLE_LE_DATA_CHANNELS 56 // TODO avoid dependency on higher layer: used to trigger pairing for outgoing connections 57 #include "ble/sm.h" 58 #endif 59 60 #include <stdarg.h> 61 #include <string.h> 62 63 /* 64 * @brief L2CAP Supervisory function in S-Frames 65 */ 66 typedef enum { 67 L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY = 0, 68 L2CAP_SUPERVISORY_FUNCTION_REJ_REJECT, 69 L2CAP_SUPERVISORY_FUNCTION_RNR_RECEIVER_NOT_READY, 70 L2CAP_SUPERVISORY_FUNCTION_SREJ_SELECTIVE_REJECT 71 } l2cap_supervisory_function_t; 72 73 /** 74 * @brief L2CAP Information Types used in Information Request & Response 75 */ 76 typedef enum { 77 L2CAP_INFO_TYPE_CONNECTIONLESS_MTU = 1, 78 L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED, 79 L2CAP_INFO_TYPE_FIXED_CHANNELS_SUPPORTED, 80 } l2cap_info_type_t; 81 82 /** 83 * @brief L2CAP Configuration Option Types used in Configurateion Request & Response 84 */ 85 typedef enum { 86 L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT = 1, 87 L2CAP_CONFIG_OPTION_TYPE_FLUSH_TIMEOUT, 88 L2CAP_CONFIG_OPTION_TYPE_QUALITY_OF_SERVICE, 89 L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL, 90 L2CAP_CONFIG_OPTION_TYPE_FRAME_CHECK_SEQUENCE, 91 L2CAP_CONFIG_OPTION_TYPE_EXTENDED_FLOW_SPECIFICATION, 92 L2CAP_CONFIG_OPTION_TYPE_EXTENDED_WINDOW_SIZE, 93 } l2cap_config_option_type_t; 94 95 96 #define L2CAP_SIG_ID_INVALID 0 97 98 // size of HCI ACL + L2CAP Header for regular data packets (8) 99 #define COMPLETE_L2CAP_HEADER (HCI_ACL_HEADER_SIZE + L2CAP_HEADER_SIZE) 100 101 // L2CAP Configuration Result Codes 102 #define L2CAP_CONF_RESULT_SUCCESS 0x0000 103 #define L2CAP_CONF_RESULT_UNACCEPTABLE_PARAMETERS 0x0001 104 #define L2CAP_CONF_RESULT_REJECT 0x0002 105 #define L2CAP_CONF_RESULT_UNKNOWN_OPTIONS 0x0003 106 #define L2CAP_CONF_RESULT_PENDING 0x0004 107 #define L2CAP_CONF_RESULT_FLOW_SPEC_REJECTED 0x0005 108 109 // L2CAP Reject Result Codes 110 #define L2CAP_REJ_CMD_UNKNOWN 0x0000 111 112 // Response Timeout eXpired 113 #define L2CAP_RTX_TIMEOUT_MS 10000 114 115 // Extended Response Timeout eXpired 116 #define L2CAP_ERTX_TIMEOUT_MS 120000 117 118 // nr of buffered acl packets in outgoing queue to get max performance 119 #define NR_BUFFERED_ACL_PACKETS 3 120 121 // used to cache l2cap rejects, echo, and informational requests 122 #define NR_PENDING_SIGNALING_RESPONSES 3 123 124 // nr of credits provided to remote if credits fall below watermark 125 #define L2CAP_LE_DATA_CHANNELS_AUTOMATIC_CREDITS_WATERMARK 5 126 #define L2CAP_LE_DATA_CHANNELS_AUTOMATIC_CREDITS_INCREMENT 5 127 128 // offsets for L2CAP SIGNALING COMMANDS 129 #define L2CAP_SIGNALING_COMMAND_CODE_OFFSET 0 130 #define L2CAP_SIGNALING_COMMAND_SIGID_OFFSET 1 131 #define L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET 2 132 #define L2CAP_SIGNALING_COMMAND_DATA_OFFSET 4 133 134 #if defined(ENABLE_LE_DATA_CHANNELS) || defined(ENABLE_CLASSIC) 135 #define L2CAP_USES_CHANNELS 136 #endif 137 138 // prototypes 139 static void l2cap_run(void); 140 static void l2cap_hci_event_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size); 141 static void l2cap_acl_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size ); 142 static void l2cap_notify_channel_can_send(void); 143 static void l2cap_emit_can_send_now(btstack_packet_handler_t packet_handler, uint16_t channel); 144 static uint8_t l2cap_next_sig_id(void); 145 static l2cap_fixed_channel_t * l2cap_fixed_channel_for_channel_id(uint16_t local_cid); 146 #ifdef ENABLE_CLASSIC 147 static int l2cap_security_level_0_allowed_for_PSM(uint16_t psm); 148 static void l2cap_handle_remote_supported_features_received(l2cap_channel_t * channel); 149 static void l2cap_handle_connection_complete(hci_con_handle_t con_handle, l2cap_channel_t * channel); 150 static void l2cap_finialize_channel_close(l2cap_channel_t *channel); 151 static inline l2cap_service_t * l2cap_get_service(uint16_t psm); 152 static void l2cap_emit_channel_opened(l2cap_channel_t *channel, uint8_t status); 153 static void l2cap_emit_channel_closed(l2cap_channel_t *channel); 154 static void l2cap_emit_incoming_connection(l2cap_channel_t *channel); 155 static int l2cap_channel_ready_for_open(l2cap_channel_t *channel); 156 #endif 157 #ifdef ENABLE_LE_DATA_CHANNELS 158 static void l2cap_emit_le_channel_opened(l2cap_channel_t *channel, uint8_t status); 159 static void l2cap_emit_le_channel_closed(l2cap_channel_t * channel); 160 static void l2cap_emit_le_incoming_connection(l2cap_channel_t *channel); 161 static void l2cap_le_notify_channel_can_send(l2cap_channel_t *channel); 162 static void l2cap_le_finialize_channel_close(l2cap_channel_t *channel); 163 static void l2cap_le_send_pdu(l2cap_channel_t *channel); 164 static inline l2cap_service_t * l2cap_le_get_service(uint16_t psm); 165 #endif 166 #ifdef L2CAP_USES_CHANNELS 167 static uint16_t l2cap_next_local_cid(void); 168 static l2cap_channel_t * l2cap_get_channel_for_local_cid(uint16_t local_cid); 169 static void l2cap_emit_simple_event_with_cid(l2cap_channel_t * channel, uint8_t event_code); 170 static void l2cap_dispatch_to_channel(l2cap_channel_t *channel, uint8_t type, uint8_t * data, uint16_t size); 171 static l2cap_channel_t * l2cap_create_channel_entry(btstack_packet_handler_t packet_handler, l2cap_channel_type_t channel_type, bd_addr_t address, bd_addr_type_t address_type, 172 uint16_t psm, uint16_t local_mtu, gap_security_level_t security_level); 173 static void l2cap_free_channel_entry(l2cap_channel_t * channel); 174 #endif 175 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 176 static void l2cap_ertm_notify_channel_can_send(l2cap_channel_t * channel); 177 static void l2cap_ertm_monitor_timeout_callback(btstack_timer_source_t * ts); 178 static void l2cap_ertm_retransmission_timeout_callback(btstack_timer_source_t * ts); 179 #endif 180 181 // l2cap_fixed_channel_t entries 182 #ifdef ENABLE_BLE 183 static l2cap_fixed_channel_t l2cap_fixed_channel_att; 184 static l2cap_fixed_channel_t l2cap_fixed_channel_sm; 185 #endif 186 #ifdef ENABLE_CLASSIC 187 static l2cap_fixed_channel_t l2cap_fixed_channel_connectionless; 188 #endif 189 190 #ifdef ENABLE_CLASSIC 191 static btstack_linked_list_t l2cap_services; 192 static uint8_t require_security_level2_for_outgoing_sdp; 193 static bd_addr_t l2cap_outgoing_classic_addr; 194 #endif 195 196 #ifdef ENABLE_LE_DATA_CHANNELS 197 static btstack_linked_list_t l2cap_le_services; 198 #endif 199 200 // single list of channels for Classic Channels, LE Data Channels, Classic Connectionless, ATT, and SM 201 static btstack_linked_list_t l2cap_channels; 202 #ifdef L2CAP_USES_CHANNELS 203 // next channel id for new connections 204 static uint16_t local_source_cid; 205 #endif 206 // next signaling sequence number 207 static uint8_t sig_seq_nr; 208 209 // used to cache l2cap rejects, echo, and informational requests 210 static l2cap_signaling_response_t signaling_responses[NR_PENDING_SIGNALING_RESPONSES]; 211 static int signaling_responses_pending; 212 static btstack_packet_callback_registration_t hci_event_callback_registration; 213 214 #ifdef ENABLE_BLE 215 // only used for connection parameter update events 216 static btstack_packet_handler_t l2cap_event_packet_handler; 217 static uint16_t l2cap_le_custom_max_mtu; 218 #endif 219 220 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 221 222 // enable for testing 223 // #define L2CAP_ERTM_SIMULATE_FCS_ERROR_INTERVAL 16 224 225 /* 226 * CRC lookup table for generator polynom D^16 + D^15 + D^2 + 1 227 */ 228 static const uint16_t crc16_table[256] = { 229 0x0000, 0xc0c1, 0xc181, 0x0140, 0xc301, 0x03c0, 0x0280, 0xc241, 0xc601, 0x06c0, 0x0780, 0xc741, 0x0500, 0xc5c1, 0xc481, 0x0440, 230 0xcc01, 0x0cc0, 0x0d80, 0xcd41, 0x0f00, 0xcfc1, 0xce81, 0x0e40, 0x0a00, 0xcac1, 0xcb81, 0x0b40, 0xc901, 0x09c0, 0x0880, 0xc841, 231 0xd801, 0x18c0, 0x1980, 0xd941, 0x1b00, 0xdbc1, 0xda81, 0x1a40, 0x1e00, 0xdec1, 0xdf81, 0x1f40, 0xdd01, 0x1dc0, 0x1c80, 0xdc41, 232 0x1400, 0xd4c1, 0xd581, 0x1540, 0xd701, 0x17c0, 0x1680, 0xd641, 0xd201, 0x12c0, 0x1380, 0xd341, 0x1100, 0xd1c1, 0xd081, 0x1040, 233 0xf001, 0x30c0, 0x3180, 0xf141, 0x3300, 0xf3c1, 0xf281, 0x3240, 0x3600, 0xf6c1, 0xf781, 0x3740, 0xf501, 0x35c0, 0x3480, 0xf441, 234 0x3c00, 0xfcc1, 0xfd81, 0x3d40, 0xff01, 0x3fc0, 0x3e80, 0xfe41, 0xfa01, 0x3ac0, 0x3b80, 0xfb41, 0x3900, 0xf9c1, 0xf881, 0x3840, 235 0x2800, 0xe8c1, 0xe981, 0x2940, 0xeb01, 0x2bc0, 0x2a80, 0xea41, 0xee01, 0x2ec0, 0x2f80, 0xef41, 0x2d00, 0xedc1, 0xec81, 0x2c40, 236 0xe401, 0x24c0, 0x2580, 0xe541, 0x2700, 0xe7c1, 0xe681, 0x2640, 0x2200, 0xe2c1, 0xe381, 0x2340, 0xe101, 0x21c0, 0x2080, 0xe041, 237 0xa001, 0x60c0, 0x6180, 0xa141, 0x6300, 0xa3c1, 0xa281, 0x6240, 0x6600, 0xa6c1, 0xa781, 0x6740, 0xa501, 0x65c0, 0x6480, 0xa441, 238 0x6c00, 0xacc1, 0xad81, 0x6d40, 0xaf01, 0x6fc0, 0x6e80, 0xae41, 0xaa01, 0x6ac0, 0x6b80, 0xab41, 0x6900, 0xa9c1, 0xa881, 0x6840, 239 0x7800, 0xb8c1, 0xb981, 0x7940, 0xbb01, 0x7bc0, 0x7a80, 0xba41, 0xbe01, 0x7ec0, 0x7f80, 0xbf41, 0x7d00, 0xbdc1, 0xbc81, 0x7c40, 240 0xb401, 0x74c0, 0x7580, 0xb541, 0x7700, 0xb7c1, 0xb681, 0x7640, 0x7200, 0xb2c1, 0xb381, 0x7340, 0xb101, 0x71c0, 0x7080, 0xb041, 241 0x5000, 0x90c1, 0x9181, 0x5140, 0x9301, 0x53c0, 0x5280, 0x9241, 0x9601, 0x56c0, 0x5780, 0x9741, 0x5500, 0x95c1, 0x9481, 0x5440, 242 0x9c01, 0x5cc0, 0x5d80, 0x9d41, 0x5f00, 0x9fc1, 0x9e81, 0x5e40, 0x5a00, 0x9ac1, 0x9b81, 0x5b40, 0x9901, 0x59c0, 0x5880, 0x9841, 243 0x8801, 0x48c0, 0x4980, 0x8941, 0x4b00, 0x8bc1, 0x8a81, 0x4a40, 0x4e00, 0x8ec1, 0x8f81, 0x4f40, 0x8d01, 0x4dc0, 0x4c80, 0x8c41, 244 0x4400, 0x84c1, 0x8581, 0x4540, 0x8701, 0x47c0, 0x4680, 0x8641, 0x8201, 0x42c0, 0x4380, 0x8341, 0x4100, 0x81c1, 0x8081, 0x4040, 245 }; 246 247 static uint16_t crc16_calc(uint8_t * data, uint16_t len){ 248 uint16_t crc = 0; // initial value = 0 249 while (len--){ 250 crc = (crc >> 8) ^ crc16_table[ (crc ^ ((uint16_t) *data++)) & 0x00FF ]; 251 } 252 return crc; 253 } 254 255 static inline uint16_t l2cap_encanced_control_field_for_information_frame(uint8_t tx_seq, int final, uint8_t req_seq, l2cap_segmentation_and_reassembly_t sar){ 256 return (((uint16_t) sar) << 14) | (req_seq << 8) | (final << 7) | (tx_seq << 1) | 0; 257 } 258 259 static inline uint16_t l2cap_encanced_control_field_for_supevisor_frame(l2cap_supervisory_function_t supervisory_function, int poll, int final, uint8_t req_seq){ 260 return (req_seq << 8) | (final << 7) | (poll << 4) | (((int) supervisory_function) << 2) | 1; 261 } 262 263 static int l2cap_next_ertm_seq_nr(int seq_nr){ 264 return (seq_nr + 1) & 0x3f; 265 } 266 267 static int l2cap_ertm_can_store_packet_now(l2cap_channel_t * channel){ 268 // get num free tx buffers 269 int num_free_tx_buffers = channel->num_tx_buffers - channel->num_stored_tx_frames; 270 // calculate num tx buffers for remote MTU 271 int num_tx_buffers_for_max_remote_mtu; 272 uint16_t effective_mps = btstack_min(channel->remote_mps, channel->local_mps); 273 if (channel->remote_mtu <= effective_mps){ 274 // MTU fits into single packet 275 num_tx_buffers_for_max_remote_mtu = 1; 276 } else { 277 // include SDU Length 278 num_tx_buffers_for_max_remote_mtu = (channel->remote_mtu + 2 + (effective_mps - 1)) / effective_mps; 279 } 280 log_debug("num_free_tx_buffers %u, num_tx_buffers_for_max_remote_mtu %u", num_free_tx_buffers, num_tx_buffers_for_max_remote_mtu); 281 return num_tx_buffers_for_max_remote_mtu <= num_free_tx_buffers; 282 } 283 284 static void l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel_t * l2cap_channel){ 285 log_info("Retransmit unacknowleged frames"); 286 l2cap_channel->unacked_frames = 0;; 287 l2cap_channel->tx_send_index = l2cap_channel->tx_read_index; 288 } 289 290 static void l2cap_ertm_next_tx_write_index(l2cap_channel_t * channel){ 291 channel->tx_write_index++; 292 if (channel->tx_write_index < channel->num_tx_buffers) return; 293 channel->tx_write_index = 0; 294 } 295 296 static void l2cap_ertm_start_monitor_timer(l2cap_channel_t * channel){ 297 log_info("Start Monitor timer"); 298 btstack_run_loop_remove_timer(&channel->monitor_timer); 299 btstack_run_loop_set_timer_handler(&channel->monitor_timer, &l2cap_ertm_monitor_timeout_callback); 300 btstack_run_loop_set_timer_context(&channel->monitor_timer, channel); 301 btstack_run_loop_set_timer(&channel->monitor_timer, channel->local_monitor_timeout_ms); 302 btstack_run_loop_add_timer(&channel->monitor_timer); 303 } 304 305 static void l2cap_ertm_stop_monitor_timer(l2cap_channel_t * channel){ 306 log_info("Stop Monitor timer"); 307 btstack_run_loop_remove_timer(&channel->monitor_timer); 308 } 309 310 static void l2cap_ertm_start_retransmission_timer(l2cap_channel_t * channel){ 311 log_info("Start Retransmission timer"); 312 btstack_run_loop_remove_timer(&channel->retransmission_timer); 313 btstack_run_loop_set_timer_handler(&channel->retransmission_timer, &l2cap_ertm_retransmission_timeout_callback); 314 btstack_run_loop_set_timer_context(&channel->retransmission_timer, channel); 315 btstack_run_loop_set_timer(&channel->retransmission_timer, channel->local_retransmission_timeout_ms); 316 btstack_run_loop_add_timer(&channel->retransmission_timer); 317 } 318 319 static void l2cap_ertm_stop_retransmission_timer(l2cap_channel_t * l2cap_channel){ 320 log_info("Stop Retransmission timer"); 321 btstack_run_loop_remove_timer(&l2cap_channel->retransmission_timer); 322 } 323 324 static void l2cap_ertm_monitor_timeout_callback(btstack_timer_source_t * ts){ 325 log_info("Monitor timeout"); 326 l2cap_channel_t * l2cap_channel = (l2cap_channel_t *) btstack_run_loop_get_timer_context(ts); 327 328 // TODO: we assume that it's the oldest packet 329 l2cap_ertm_tx_packet_state_t * tx_state; 330 tx_state = &l2cap_channel->tx_packets_state[l2cap_channel->tx_read_index]; 331 332 // check retry count 333 if (tx_state->retry_count < l2cap_channel->remote_max_transmit){ 334 // increment retry count 335 tx_state->retry_count++; 336 337 // start retransmit 338 l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel); 339 340 // start monitor timer 341 l2cap_ertm_start_monitor_timer(l2cap_channel); 342 343 // send RR/P=1 344 l2cap_channel->send_supervisor_frame_receiver_ready_poll = 1; 345 } else { 346 log_info("Monitor timer expired & retry count >= max transmit -> disconnect"); 347 l2cap_channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 348 } 349 l2cap_run(); 350 } 351 352 static void l2cap_ertm_retransmission_timeout_callback(btstack_timer_source_t * ts){ 353 log_info("Retransmission timeout"); 354 l2cap_channel_t * l2cap_channel = (l2cap_channel_t *) btstack_run_loop_get_timer_context(ts); 355 356 // TODO: we assume that it's the oldest packet 357 l2cap_ertm_tx_packet_state_t * tx_state; 358 tx_state = &l2cap_channel->tx_packets_state[l2cap_channel->tx_read_index]; 359 360 // set retry count = 1 361 tx_state->retry_count = 1; 362 363 // start retransmit 364 l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel); 365 366 // start monitor timer 367 l2cap_ertm_start_monitor_timer(l2cap_channel); 368 369 // send RR/P=1 370 l2cap_channel->send_supervisor_frame_receiver_ready_poll = 1; 371 l2cap_run(); 372 } 373 374 static int l2cap_ertm_send_information_frame(l2cap_channel_t * channel, int index, int final){ 375 l2cap_ertm_tx_packet_state_t * tx_state = &channel->tx_packets_state[index]; 376 hci_reserve_packet_buffer(); 377 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 378 uint16_t control = l2cap_encanced_control_field_for_information_frame(tx_state->tx_seq, final, channel->req_seq, tx_state->sar); 379 log_info("I-Frame: control 0x%04x", control); 380 little_endian_store_16(acl_buffer, 8, control); 381 (void)memcpy(&acl_buffer[8 + 2], 382 &channel->tx_packets_data[index * channel->local_mps], 383 tx_state->len); 384 // (re-)start retransmission timer on 385 l2cap_ertm_start_retransmission_timer(channel); 386 // send 387 return l2cap_send_prepared(channel->local_cid, 2 + tx_state->len); 388 } 389 390 static void l2cap_ertm_store_fragment(l2cap_channel_t * channel, l2cap_segmentation_and_reassembly_t sar, uint16_t sdu_length, uint8_t * data, uint16_t len){ 391 // get next index for storing packets 392 int index = channel->tx_write_index; 393 394 l2cap_ertm_tx_packet_state_t * tx_state = &channel->tx_packets_state[index]; 395 tx_state->tx_seq = channel->next_tx_seq; 396 tx_state->sar = sar; 397 tx_state->retry_count = 0; 398 399 uint8_t * tx_packet = &channel->tx_packets_data[index * channel->local_mps]; 400 log_debug("index %u, local mps %u, remote mps %u, packet tx %p, len %u", index, channel->local_mps, channel->remote_mps, tx_packet, len); 401 int pos = 0; 402 if (sar == L2CAP_SEGMENTATION_AND_REASSEMBLY_START_OF_L2CAP_SDU){ 403 little_endian_store_16(tx_packet, 0, sdu_length); 404 pos += 2; 405 } 406 (void)memcpy(&tx_packet[pos], data, len); 407 tx_state->len = pos + len; 408 409 // update 410 channel->num_stored_tx_frames++; 411 channel->next_tx_seq = l2cap_next_ertm_seq_nr(channel->next_tx_seq); 412 l2cap_ertm_next_tx_write_index(channel); 413 414 log_info("l2cap_ertm_store_fragment: tx_read_index %u, tx_write_index %u, num stored %u", channel->tx_read_index, channel->tx_write_index, channel->num_stored_tx_frames); 415 416 } 417 418 static int l2cap_ertm_send(l2cap_channel_t * channel, uint8_t * data, uint16_t len){ 419 if (len > channel->remote_mtu){ 420 log_error("l2cap_ertm_send cid 0x%02x, data length exceeds remote MTU.", channel->local_cid); 421 return L2CAP_DATA_LEN_EXCEEDS_REMOTE_MTU; 422 } 423 424 if (!l2cap_ertm_can_store_packet_now(channel)){ 425 log_error("l2cap_ertm_send cid 0x%02x, fragment store full", channel->local_cid); 426 return BTSTACK_ACL_BUFFERS_FULL; 427 } 428 429 // check if it needs to get fragmented 430 uint16_t effective_mps = btstack_min(channel->remote_mps, channel->local_mps); 431 if (len > effective_mps){ 432 // fragmentation needed. 433 l2cap_segmentation_and_reassembly_t sar = L2CAP_SEGMENTATION_AND_REASSEMBLY_START_OF_L2CAP_SDU; 434 int chunk_len; 435 while (len){ 436 switch (sar){ 437 case L2CAP_SEGMENTATION_AND_REASSEMBLY_START_OF_L2CAP_SDU: 438 chunk_len = effective_mps - 2; // sdu_length 439 l2cap_ertm_store_fragment(channel, sar, len, data, chunk_len); 440 len -= chunk_len; 441 sar = L2CAP_SEGMENTATION_AND_REASSEMBLY_CONTINUATION_OF_L2CAP_SDU; 442 break; 443 case L2CAP_SEGMENTATION_AND_REASSEMBLY_CONTINUATION_OF_L2CAP_SDU: 444 chunk_len = effective_mps; 445 if (chunk_len >= len){ 446 sar = L2CAP_SEGMENTATION_AND_REASSEMBLY_END_OF_L2CAP_SDU; 447 chunk_len = len; 448 } 449 l2cap_ertm_store_fragment(channel, sar, len, data, chunk_len); 450 len -= chunk_len; 451 break; 452 default: 453 break; 454 } 455 } 456 457 } else { 458 l2cap_ertm_store_fragment(channel, L2CAP_SEGMENTATION_AND_REASSEMBLY_UNSEGMENTED_L2CAP_SDU, 0, data, len); 459 } 460 461 // try to send 462 l2cap_notify_channel_can_send(); 463 return 0; 464 } 465 466 static uint16_t l2cap_setup_options_ertm_request(l2cap_channel_t * channel, uint8_t * config_options){ 467 int pos = 0; 468 config_options[pos++] = L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL; 469 config_options[pos++] = 9; // length 470 config_options[pos++] = (uint8_t) channel->mode; 471 config_options[pos++] = channel->num_rx_buffers; // == TxWindows size 472 config_options[pos++] = channel->local_max_transmit; 473 little_endian_store_16( config_options, pos, channel->local_retransmission_timeout_ms); 474 pos += 2; 475 little_endian_store_16( config_options, pos, channel->local_monitor_timeout_ms); 476 pos += 2; 477 little_endian_store_16( config_options, pos, channel->local_mps); 478 pos += 2; 479 // 480 config_options[pos++] = L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT; 481 config_options[pos++] = 2; // length 482 little_endian_store_16(config_options, pos, channel->local_mtu); 483 pos += 2; 484 485 // Issue: iOS (e.g. 10.2) uses "No FCS" as default while Core 5.0 specifies "FCS" as default 486 // Workaround: try to actively negotiate FCS option 487 config_options[pos++] = L2CAP_CONFIG_OPTION_TYPE_FRAME_CHECK_SEQUENCE; 488 config_options[pos++] = 1; // length 489 config_options[pos++] = channel->fcs_option; 490 return pos; // 11+4+3=18 491 } 492 493 static uint16_t l2cap_setup_options_ertm_response(l2cap_channel_t * channel, uint8_t * config_options){ 494 int pos = 0; 495 config_options[pos++] = L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL; 496 config_options[pos++] = 9; // length 497 config_options[pos++] = (uint8_t) channel->mode; 498 // less or equal to remote tx window size 499 config_options[pos++] = btstack_min(channel->num_tx_buffers, channel->remote_tx_window_size); 500 // max transmit in response shall be ignored -> use sender values 501 config_options[pos++] = channel->remote_max_transmit; 502 // A value for the Retransmission time-out shall be sent in a positive Configuration Response 503 // and indicates the value that will be used by the sender of the Configuration Response -> use our value 504 little_endian_store_16( config_options, pos, channel->local_retransmission_timeout_ms); 505 pos += 2; 506 // A value for the Monitor time-out shall be sent in a positive Configuration Response 507 // and indicates the value that will be used by the sender of the Configuration Response -> use our value 508 little_endian_store_16( config_options, pos, channel->local_monitor_timeout_ms); 509 pos += 2; 510 // less or equal to remote mps 511 uint16_t effective_mps = btstack_min(channel->remote_mps, channel->local_mps); 512 little_endian_store_16( config_options, pos, effective_mps); 513 pos += 2; 514 // 515 config_options[pos++] = L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT; // MTU 516 config_options[pos++] = 2; // length 517 little_endian_store_16(config_options, pos, channel->remote_mtu); 518 pos += 2; 519 #if 0 520 // 521 config_options[pos++] = L2CAP_CONFIG_OPTION_TYPE_FRAME_CHECK_SEQUENCE; 522 config_options[pos++] = 1; // length 523 config_options[pos++] = channel->fcs_option; 524 #endif 525 return pos; // 11+4=15 526 } 527 528 static int l2cap_ertm_send_supervisor_frame(l2cap_channel_t * channel, uint16_t control){ 529 hci_reserve_packet_buffer(); 530 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 531 log_info("S-Frame: control 0x%04x", control); 532 little_endian_store_16(acl_buffer, 8, control); 533 return l2cap_send_prepared(channel->local_cid, 2); 534 } 535 536 static uint8_t l2cap_ertm_validate_local_config(l2cap_ertm_config_t * ertm_config){ 537 538 uint8_t result = ERROR_CODE_SUCCESS; 539 if (ertm_config->max_transmit < 1){ 540 log_error("max_transmit must be >= 1"); 541 result = ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS; 542 } 543 if (ertm_config->retransmission_timeout_ms < 2000){ 544 log_error("retransmission_timeout_ms must be >= 2000 ms"); 545 result = ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS; 546 } 547 if (ertm_config->monitor_timeout_ms < 12000){ 548 log_error("monitor_timeout_ms must be >= 12000 ms"); 549 result = ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS; 550 } 551 if (ertm_config->local_mtu < 48){ 552 log_error("local_mtu must be >= 48"); 553 result = ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS; 554 } 555 if (ertm_config->num_rx_buffers < 1){ 556 log_error("num_rx_buffers must be >= 1"); 557 result = ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS; 558 } 559 if (ertm_config->num_tx_buffers < 1){ 560 log_error("num_rx_buffers must be >= 1"); 561 result = ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS; 562 } 563 return result; 564 } 565 566 static void l2cap_ertm_configure_channel(l2cap_channel_t * channel, l2cap_ertm_config_t * ertm_config, uint8_t * buffer, uint32_t size){ 567 568 channel->mode = L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION; 569 channel->ertm_mandatory = ertm_config->ertm_mandatory; 570 channel->local_max_transmit = ertm_config->max_transmit; 571 channel->local_retransmission_timeout_ms = ertm_config->retransmission_timeout_ms; 572 channel->local_monitor_timeout_ms = ertm_config->monitor_timeout_ms; 573 channel->local_mtu = ertm_config->local_mtu; 574 channel->num_rx_buffers = ertm_config->num_rx_buffers; 575 channel->num_tx_buffers = ertm_config->num_tx_buffers; 576 577 // align buffer to 16-byte boundary to assert l2cap_ertm_rx_packet_state_t is aligned 578 int bytes_till_alignment = 16 - (((uintptr_t) buffer) & 0x0f); 579 buffer += bytes_till_alignment; 580 size -= bytes_till_alignment; 581 582 // setup state buffers - use void cast to avoid -Wcast-align warning 583 uint32_t pos = 0; 584 channel->rx_packets_state = (l2cap_ertm_rx_packet_state_t *) (void *) &buffer[pos]; 585 pos += ertm_config->num_rx_buffers * sizeof(l2cap_ertm_rx_packet_state_t); 586 channel->tx_packets_state = (l2cap_ertm_tx_packet_state_t *) (void *) &buffer[pos]; 587 pos += ertm_config->num_tx_buffers * sizeof(l2cap_ertm_tx_packet_state_t); 588 589 // setup reassembly buffer 590 channel->reassembly_buffer = &buffer[pos]; 591 pos += ertm_config->local_mtu; 592 593 // divide rest of data equally 594 channel->local_mps = (size - pos) / (ertm_config->num_rx_buffers + ertm_config->num_tx_buffers); 595 log_info("Local MPS: %u", channel->local_mps); 596 channel->rx_packets_data = &buffer[pos]; 597 pos += ertm_config->num_rx_buffers * channel->local_mps; 598 channel->tx_packets_data = &buffer[pos]; 599 600 channel->fcs_option = ertm_config->fcs_option; 601 } 602 603 uint8_t l2cap_create_ertm_channel(btstack_packet_handler_t packet_handler, bd_addr_t address, uint16_t psm, 604 l2cap_ertm_config_t * ertm_config, uint8_t * buffer, uint32_t size, uint16_t * out_local_cid){ 605 606 log_info("L2CAP_CREATE_ERTM_CHANNEL addr %s, psm 0x%x, local mtu %u", bd_addr_to_str(address), psm, ertm_config->local_mtu); 607 608 // validate local config 609 uint8_t result = l2cap_ertm_validate_local_config(ertm_config); 610 if (result) return result; 611 612 // determine security level based on psm 613 const gap_security_level_t security_level = l2cap_security_level_0_allowed_for_PSM(psm) ? LEVEL_0 : gap_get_security_level(); 614 615 l2cap_channel_t * channel = l2cap_create_channel_entry(packet_handler, L2CAP_CHANNEL_TYPE_CLASSIC, address, BD_ADDR_TYPE_ACL, psm, ertm_config->local_mtu, security_level); 616 if (!channel) { 617 return BTSTACK_MEMORY_ALLOC_FAILED; 618 } 619 620 // configure ERTM 621 l2cap_ertm_configure_channel(channel, ertm_config, buffer, size); 622 623 // add to connections list 624 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel); 625 626 // store local_cid 627 if (out_local_cid){ 628 *out_local_cid = channel->local_cid; 629 } 630 631 // check if hci connection is already usable 632 hci_connection_t * conn = hci_connection_for_bd_addr_and_type(address, BD_ADDR_TYPE_ACL); 633 if (conn){ 634 log_info("l2cap_create_channel, hci connection already exists"); 635 l2cap_handle_connection_complete(conn->con_handle, channel); 636 // check if remote supported fearures are already received 637 if (conn->bonding_flags & BONDING_RECEIVED_REMOTE_FEATURES) { 638 l2cap_handle_remote_supported_features_received(channel); 639 } 640 } 641 642 l2cap_run(); 643 644 return 0; 645 } 646 647 static void l2cap_ertm_notify_channel_can_send(l2cap_channel_t * channel){ 648 if (l2cap_ertm_can_store_packet_now(channel)){ 649 channel->waiting_for_can_send_now = 0; 650 l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid); 651 } 652 } 653 654 uint8_t l2cap_accept_ertm_connection(uint16_t local_cid, l2cap_ertm_config_t * ertm_config, uint8_t * buffer, uint32_t size){ 655 656 log_info("L2CAP_ACCEPT_ERTM_CONNECTION local_cid 0x%x", local_cid); 657 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 658 if (!channel) { 659 log_error("l2cap_accept_connection called but local_cid 0x%x not found", local_cid); 660 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 661 } 662 663 // validate local config 664 uint8_t result = l2cap_ertm_validate_local_config(ertm_config); 665 if (result) return result; 666 667 // configure L2CAP ERTM 668 l2cap_ertm_configure_channel(channel, ertm_config, buffer, size); 669 670 // default: continue 671 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT; 672 673 // verify remote ERTM support 674 hci_connection_t * connection = hci_connection_for_handle(channel->con_handle); 675 if (connection == NULL) return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER; 676 677 if ((channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) && ((connection->l2cap_state.extended_feature_mask & 0x08) == 0)){ 678 // ERTM not possible, select basic mode and release buffer 679 channel->mode = L2CAP_CHANNEL_MODE_BASIC; 680 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED); 681 682 // bail if ERTM is mandatory 683 if (channel->ertm_mandatory){ 684 // We chose 'no resources available' for "ERTM mandatory but you don't even know ERTM exists" 685 log_info("ERTM mandatory -> reject connection"); 686 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE; 687 channel->reason = 0x04; // no resources available 688 } else { 689 log_info("ERTM not supported by remote -> use Basic mode"); 690 } 691 } 692 693 // process 694 l2cap_run(); 695 696 return ERROR_CODE_SUCCESS; 697 } 698 699 uint8_t l2cap_ertm_set_busy(uint16_t local_cid){ 700 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid( local_cid); 701 if (!channel) { 702 log_error( "l2cap_decline_connection called but local_cid 0x%x not found", local_cid); 703 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 704 } 705 if (!channel->local_busy){ 706 channel->local_busy = 1; 707 channel->send_supervisor_frame_receiver_not_ready = 1; 708 l2cap_run(); 709 } 710 return ERROR_CODE_SUCCESS; 711 } 712 713 uint8_t l2cap_ertm_set_ready(uint16_t local_cid){ 714 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid( local_cid); 715 if (!channel) { 716 log_error( "l2cap_decline_connection called but local_cid 0x%x not found", local_cid); 717 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 718 } 719 if (channel->local_busy){ 720 channel->local_busy = 0; 721 channel->send_supervisor_frame_receiver_ready_poll = 1; 722 l2cap_run(); 723 } 724 return ERROR_CODE_SUCCESS; 725 } 726 727 // Process-ReqSeq 728 static void l2cap_ertm_process_req_seq(l2cap_channel_t * l2cap_channel, uint8_t req_seq){ 729 int num_buffers_acked = 0; 730 l2cap_ertm_tx_packet_state_t * tx_state; 731 log_info("l2cap_ertm_process_req_seq: tx_read_index %u, tx_write_index %u, req_seq %u", l2cap_channel->tx_read_index, l2cap_channel->tx_write_index, req_seq); 732 while (true){ 733 734 // no unack packets left 735 if (l2cap_channel->unacked_frames == 0) { 736 // stop retransmission timer 737 l2cap_ertm_stop_retransmission_timer(l2cap_channel); 738 break; 739 } 740 741 tx_state = &l2cap_channel->tx_packets_state[l2cap_channel->tx_read_index]; 742 // calc delta 743 int delta = (req_seq - tx_state->tx_seq) & 0x03f; 744 if (delta == 0) break; // all packets acknowledged 745 if (delta > l2cap_channel->remote_tx_window_size) break; 746 747 num_buffers_acked++; 748 l2cap_channel->num_stored_tx_frames--; 749 l2cap_channel->unacked_frames--; 750 log_info("RR seq %u => packet with tx_seq %u done", req_seq, tx_state->tx_seq); 751 752 l2cap_channel->tx_read_index++; 753 if (l2cap_channel->tx_read_index >= l2cap_channel->num_rx_buffers){ 754 l2cap_channel->tx_read_index = 0; 755 } 756 } 757 if (num_buffers_acked){ 758 log_info("num_buffers_acked %u", num_buffers_acked); 759 l2cap_ertm_notify_channel_can_send(l2cap_channel); 760 } 761 } 762 763 static l2cap_ertm_tx_packet_state_t * l2cap_ertm_get_tx_state(l2cap_channel_t * l2cap_channel, uint8_t tx_seq){ 764 int i; 765 for (i=0;i<l2cap_channel->num_tx_buffers;i++){ 766 l2cap_ertm_tx_packet_state_t * tx_state = &l2cap_channel->tx_packets_state[i]; 767 if (tx_state->tx_seq == tx_seq) return tx_state; 768 } 769 return NULL; 770 } 771 772 // @param delta number of frames in the future, >= 1 773 // @assumption size <= l2cap_channel->local_mps (checked in l2cap_acl_classic_handler) 774 static void l2cap_ertm_handle_out_of_sequence_sdu(l2cap_channel_t * l2cap_channel, l2cap_segmentation_and_reassembly_t sar, int delta, const uint8_t * payload, uint16_t size){ 775 log_info("Store SDU with delta %u", delta); 776 // get rx state for packet to store 777 int index = l2cap_channel->rx_store_index + delta - 1; 778 if (index > l2cap_channel->num_rx_buffers){ 779 index -= l2cap_channel->num_rx_buffers; 780 } 781 log_info("Index of packet to store %u", index); 782 l2cap_ertm_rx_packet_state_t * rx_state = &l2cap_channel->rx_packets_state[index]; 783 // check if buffer is free 784 if (rx_state->valid){ 785 log_error("Packet buffer already used"); 786 return; 787 } 788 rx_state->valid = 1; 789 rx_state->sar = sar; 790 rx_state->len = size; 791 uint8_t * rx_buffer = &l2cap_channel->rx_packets_data[index]; 792 (void)memcpy(rx_buffer, payload, size); 793 } 794 795 // @assumption size <= l2cap_channel->local_mps (checked in l2cap_acl_classic_handler) 796 static void l2cap_ertm_handle_in_sequence_sdu(l2cap_channel_t * l2cap_channel, l2cap_segmentation_and_reassembly_t sar, const uint8_t * payload, uint16_t size){ 797 uint16_t reassembly_sdu_length; 798 switch (sar){ 799 case L2CAP_SEGMENTATION_AND_REASSEMBLY_UNSEGMENTED_L2CAP_SDU: 800 // assert total packet size <= our mtu 801 if (size > l2cap_channel->local_mtu) break; 802 // packet complete -> disapatch 803 l2cap_dispatch_to_channel(l2cap_channel, L2CAP_DATA_PACKET, (uint8_t*) payload, size); 804 break; 805 case L2CAP_SEGMENTATION_AND_REASSEMBLY_START_OF_L2CAP_SDU: 806 // read SDU len 807 reassembly_sdu_length = little_endian_read_16(payload, 0); 808 payload += 2; 809 size -= 2; 810 // assert reassembled size <= our mtu 811 if (reassembly_sdu_length > l2cap_channel->local_mtu) break; 812 // store start segment 813 l2cap_channel->reassembly_sdu_length = reassembly_sdu_length; 814 (void)memcpy(&l2cap_channel->reassembly_buffer[0], payload, size); 815 l2cap_channel->reassembly_pos = size; 816 break; 817 case L2CAP_SEGMENTATION_AND_REASSEMBLY_CONTINUATION_OF_L2CAP_SDU: 818 // assert size of reassembled data <= our mtu 819 if (l2cap_channel->reassembly_pos + size > l2cap_channel->local_mtu) break; 820 // store continuation segment 821 (void)memcpy(&l2cap_channel->reassembly_buffer[l2cap_channel->reassembly_pos], 822 payload, size); 823 l2cap_channel->reassembly_pos += size; 824 break; 825 case L2CAP_SEGMENTATION_AND_REASSEMBLY_END_OF_L2CAP_SDU: 826 // assert size of reassembled data <= our mtu 827 if (l2cap_channel->reassembly_pos + size > l2cap_channel->local_mtu) break; 828 // store continuation segment 829 (void)memcpy(&l2cap_channel->reassembly_buffer[l2cap_channel->reassembly_pos], 830 payload, size); 831 l2cap_channel->reassembly_pos += size; 832 // assert size of reassembled data matches announced sdu length 833 if (l2cap_channel->reassembly_pos != l2cap_channel->reassembly_sdu_length) break; 834 // packet complete -> disapatch 835 l2cap_dispatch_to_channel(l2cap_channel, L2CAP_DATA_PACKET, l2cap_channel->reassembly_buffer, l2cap_channel->reassembly_pos); 836 l2cap_channel->reassembly_pos = 0; 837 break; 838 default: 839 btstack_assert(false); 840 break; 841 } 842 } 843 844 static void l2cap_ertm_channel_send_information_frame(l2cap_channel_t * channel){ 845 channel->unacked_frames++; 846 int index = channel->tx_send_index; 847 channel->tx_send_index++; 848 if (channel->tx_send_index >= channel->num_tx_buffers){ 849 channel->tx_send_index = 0; 850 } 851 l2cap_ertm_send_information_frame(channel, index, 0); // final = 0 852 } 853 854 #endif 855 856 #ifdef L2CAP_USES_CHANNELS 857 static uint16_t l2cap_next_local_cid(void){ 858 do { 859 if (local_source_cid == 0xffffu) { 860 local_source_cid = 0x40; 861 } else { 862 local_source_cid++; 863 } 864 } while (l2cap_get_channel_for_local_cid(local_source_cid) != NULL); 865 return local_source_cid; 866 } 867 #endif 868 869 static uint8_t l2cap_next_sig_id(void){ 870 if (sig_seq_nr == 0xffu) { 871 sig_seq_nr = 1; 872 } else { 873 sig_seq_nr++; 874 } 875 return sig_seq_nr; 876 } 877 878 void l2cap_init(void){ 879 signaling_responses_pending = 0; 880 #ifdef L2CAP_USES_CHANNELS 881 local_source_cid = 0x40; 882 #endif 883 sig_seq_nr = 0xff; 884 l2cap_channels = NULL; 885 886 #ifdef ENABLE_CLASSIC 887 l2cap_services = NULL; 888 require_security_level2_for_outgoing_sdp = 0; 889 890 // Setup Connectionless Channel 891 l2cap_fixed_channel_connectionless.local_cid = L2CAP_CID_CONNECTIONLESS_CHANNEL; 892 l2cap_fixed_channel_connectionless.channel_type = L2CAP_CHANNEL_TYPE_CONNECTIONLESS; 893 btstack_linked_list_add(&l2cap_channels, (btstack_linked_item_t *) &l2cap_fixed_channel_connectionless); 894 #endif 895 896 #ifdef ENABLE_LE_DATA_CHANNELS 897 l2cap_le_services = NULL; 898 #endif 899 900 #ifdef ENABLE_BLE 901 l2cap_event_packet_handler = NULL; 902 l2cap_le_custom_max_mtu = 0; 903 904 // Setup fixed ATT Channel 905 l2cap_fixed_channel_att.local_cid = L2CAP_CID_ATTRIBUTE_PROTOCOL; 906 l2cap_fixed_channel_att.channel_type = L2CAP_CHANNEL_TYPE_LE_FIXED; 907 btstack_linked_list_add(&l2cap_channels, (btstack_linked_item_t *) &l2cap_fixed_channel_att); 908 909 // Setup fixed SM Channel 910 l2cap_fixed_channel_sm.local_cid = L2CAP_CID_SECURITY_MANAGER_PROTOCOL; 911 l2cap_fixed_channel_sm.channel_type = L2CAP_CHANNEL_TYPE_LE_FIXED; 912 btstack_linked_list_add(&l2cap_channels, (btstack_linked_item_t *) &l2cap_fixed_channel_sm); 913 #endif 914 915 // 916 // register callback with HCI 917 // 918 hci_event_callback_registration.callback = &l2cap_hci_event_handler; 919 hci_add_event_handler(&hci_event_callback_registration); 920 921 hci_register_acl_packet_handler(&l2cap_acl_handler); 922 923 #ifndef ENABLE_EXPLICIT_CONNECTABLE_MODE_CONTROL 924 #ifdef ENABLE_CLASSIC 925 gap_connectable_control(0); // no services yet 926 #endif 927 #endif 928 } 929 930 /** 931 * @brief De-Init L2CAP 932 */ 933 void l2cap_deinit(void){ 934 #ifdef ENABLE_CLASSIC 935 memset(l2cap_outgoing_classic_addr, 0, 6); 936 #endif 937 signaling_responses_pending = 0; 938 } 939 940 void l2cap_register_packet_handler(void (*handler)(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size)){ 941 #ifdef ENABLE_BLE 942 l2cap_event_packet_handler = handler; 943 #else 944 UNUSED(handler); // ok: no code 945 #endif 946 } 947 948 void l2cap_request_can_send_fix_channel_now_event(hci_con_handle_t con_handle, uint16_t channel_id){ 949 UNUSED(con_handle); // ok: there is no con handle 950 951 l2cap_fixed_channel_t * channel = l2cap_fixed_channel_for_channel_id(channel_id); 952 if (!channel) return; 953 channel->waiting_for_can_send_now = 1; 954 l2cap_notify_channel_can_send(); 955 } 956 957 int l2cap_can_send_fixed_channel_packet_now(hci_con_handle_t con_handle, uint16_t channel_id){ 958 UNUSED(channel_id); // ok: only depends on Controller LE buffers 959 960 return hci_can_send_acl_packet_now(con_handle); 961 } 962 963 uint8_t *l2cap_get_outgoing_buffer(void){ 964 return hci_get_outgoing_packet_buffer() + COMPLETE_L2CAP_HEADER; // 8 bytes 965 } 966 967 // only for L2CAP Basic Channels 968 int l2cap_reserve_packet_buffer(void){ 969 return hci_reserve_packet_buffer(); 970 } 971 972 // only for L2CAP Basic Channels 973 void l2cap_release_packet_buffer(void){ 974 hci_release_packet_buffer(); 975 } 976 977 static void l2cap_setup_header(uint8_t * acl_buffer, hci_con_handle_t con_handle, uint8_t packet_boundary, uint16_t remote_cid, uint16_t len){ 978 // 0 - Connection handle : PB=pb : BC=00 979 little_endian_store_16(acl_buffer, 0u, con_handle | (packet_boundary << 12u) | (0u << 14u)); 980 // 2 - ACL length 981 little_endian_store_16(acl_buffer, 2u, len + 4u); 982 // 4 - L2CAP packet length 983 little_endian_store_16(acl_buffer, 4u, len + 0u); 984 // 6 - L2CAP channel DEST 985 little_endian_store_16(acl_buffer, 6, remote_cid); 986 } 987 988 // assumption - only on LE connections 989 int l2cap_send_prepared_connectionless(hci_con_handle_t con_handle, uint16_t cid, uint16_t len){ 990 991 if (!hci_is_packet_buffer_reserved()){ 992 log_error("l2cap_send_prepared_connectionless called without reserving packet first"); 993 return BTSTACK_ACL_BUFFERS_FULL; 994 } 995 996 if (!hci_can_send_prepared_acl_packet_now(con_handle)){ 997 log_info("l2cap_send_prepared_connectionless handle 0x%02x, cid 0x%02x, cannot send", con_handle, cid); 998 return BTSTACK_ACL_BUFFERS_FULL; 999 } 1000 1001 log_debug("l2cap_send_prepared_connectionless handle %u, cid 0x%02x", con_handle, cid); 1002 1003 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 1004 l2cap_setup_header(acl_buffer, con_handle, 0, cid, len); 1005 // send 1006 return hci_send_acl_packet_buffer(len+8u); 1007 } 1008 1009 // assumption - only on LE connections 1010 int l2cap_send_connectionless(hci_con_handle_t con_handle, uint16_t cid, uint8_t *data, uint16_t len){ 1011 1012 if (!hci_can_send_acl_packet_now(con_handle)){ 1013 log_info("l2cap_send cid 0x%02x, cannot send", cid); 1014 return BTSTACK_ACL_BUFFERS_FULL; 1015 } 1016 1017 hci_reserve_packet_buffer(); 1018 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 1019 1020 (void)memcpy(&acl_buffer[8], data, len); 1021 1022 return l2cap_send_prepared_connectionless(con_handle, cid, len); 1023 } 1024 1025 static void l2cap_emit_can_send_now(btstack_packet_handler_t packet_handler, uint16_t channel) { 1026 log_debug("L2CAP_EVENT_CHANNEL_CAN_SEND_NOW local_cid 0x%x", channel); 1027 uint8_t event[4]; 1028 event[0] = L2CAP_EVENT_CAN_SEND_NOW; 1029 event[1] = sizeof(event) - 2u; 1030 little_endian_store_16(event, 2, channel); 1031 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 1032 packet_handler(HCI_EVENT_PACKET, channel, event, sizeof(event)); 1033 } 1034 1035 #ifdef L2CAP_USES_CHANNELS 1036 static void l2cap_dispatch_to_channel(l2cap_channel_t *channel, uint8_t type, uint8_t * data, uint16_t size){ 1037 (* (channel->packet_handler))(type, channel->local_cid, data, size); 1038 } 1039 1040 static void l2cap_emit_simple_event_with_cid(l2cap_channel_t * channel, uint8_t event_code){ 1041 uint8_t event[4]; 1042 event[0] = event_code; 1043 event[1] = sizeof(event) - 2u; 1044 little_endian_store_16(event, 2, channel->local_cid); 1045 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 1046 l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event)); 1047 } 1048 #endif 1049 1050 #ifdef ENABLE_CLASSIC 1051 void l2cap_emit_channel_opened(l2cap_channel_t *channel, uint8_t status) { 1052 log_info("L2CAP_EVENT_CHANNEL_OPENED status 0x%x addr %s handle 0x%x psm 0x%x local_cid 0x%x remote_cid 0x%x local_mtu %u, remote_mtu %u, flush_timeout %u", 1053 status, bd_addr_to_str(channel->address), channel->con_handle, channel->psm, 1054 channel->local_cid, channel->remote_cid, channel->local_mtu, channel->remote_mtu, channel->flush_timeout); 1055 uint8_t event[26]; 1056 event[0] = L2CAP_EVENT_CHANNEL_OPENED; 1057 event[1] = sizeof(event) - 2; 1058 event[2] = status; 1059 reverse_bd_addr(channel->address, &event[3]); 1060 little_endian_store_16(event, 9, channel->con_handle); 1061 little_endian_store_16(event, 11, channel->psm); 1062 little_endian_store_16(event, 13, channel->local_cid); 1063 little_endian_store_16(event, 15, channel->remote_cid); 1064 little_endian_store_16(event, 17, channel->local_mtu); 1065 little_endian_store_16(event, 19, channel->remote_mtu); 1066 little_endian_store_16(event, 21, channel->flush_timeout); 1067 event[23] = (channel->state_var & L2CAP_CHANNEL_STATE_VAR_INCOMING) ? 1 : 0; 1068 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1069 log_info("ERTM mode %u, fcs enabled %u", channel->mode, channel->fcs_option); 1070 event[24] = channel->mode; 1071 event[25] = channel->fcs_option; 1072 1073 #else 1074 event[24] = L2CAP_CHANNEL_MODE_BASIC; 1075 event[25] = 0; 1076 #endif 1077 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 1078 l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event)); 1079 } 1080 1081 static void l2cap_emit_channel_closed(l2cap_channel_t *channel) { 1082 log_info("L2CAP_EVENT_CHANNEL_CLOSED local_cid 0x%x", channel->local_cid); 1083 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_CHANNEL_CLOSED); 1084 } 1085 1086 static void l2cap_emit_incoming_connection(l2cap_channel_t *channel) { 1087 log_info("L2CAP_EVENT_INCOMING_CONNECTION addr %s handle 0x%x psm 0x%x local_cid 0x%x remote_cid 0x%x", 1088 bd_addr_to_str(channel->address), channel->con_handle, channel->psm, channel->local_cid, channel->remote_cid); 1089 uint8_t event[16]; 1090 event[0] = L2CAP_EVENT_INCOMING_CONNECTION; 1091 event[1] = sizeof(event) - 2; 1092 reverse_bd_addr(channel->address, &event[2]); 1093 little_endian_store_16(event, 8, channel->con_handle); 1094 little_endian_store_16(event, 10, channel->psm); 1095 little_endian_store_16(event, 12, channel->local_cid); 1096 little_endian_store_16(event, 14, channel->remote_cid); 1097 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 1098 l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event)); 1099 } 1100 1101 static void l2cap_handle_channel_open_failed(l2cap_channel_t * channel, uint8_t status){ 1102 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1103 // emit ertm buffer released, as it's not needed. if in basic mode, it was either not allocated or already released 1104 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1105 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED); 1106 } 1107 #endif 1108 l2cap_emit_channel_opened(channel, status); 1109 } 1110 1111 static void l2cap_handle_channel_closed(l2cap_channel_t * channel){ 1112 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1113 // emit ertm buffer released, as it's not needed anymore. if in basic mode, it was either not allocated or already released 1114 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1115 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED); 1116 } 1117 #endif 1118 l2cap_emit_channel_closed(channel); 1119 } 1120 #endif 1121 1122 static l2cap_fixed_channel_t * l2cap_channel_item_by_cid(uint16_t cid){ 1123 btstack_linked_list_iterator_t it; 1124 btstack_linked_list_iterator_init(&it, &l2cap_channels); 1125 while (btstack_linked_list_iterator_has_next(&it)){ 1126 l2cap_fixed_channel_t * channel = (l2cap_fixed_channel_t*) btstack_linked_list_iterator_next(&it); 1127 if (channel->local_cid == cid) { 1128 return channel; 1129 } 1130 } 1131 return NULL; 1132 } 1133 1134 // used for fixed channels in LE (ATT/SM) and Classic (Connectionless Channel). CID < 0x04 1135 static l2cap_fixed_channel_t * l2cap_fixed_channel_for_channel_id(uint16_t local_cid){ 1136 if (local_cid >= 0x40u) return NULL; 1137 return (l2cap_fixed_channel_t*) l2cap_channel_item_by_cid(local_cid); 1138 } 1139 1140 // used for Classic Channels + LE Data Channels. local_cid >= 0x40 1141 #ifdef L2CAP_USES_CHANNELS 1142 static l2cap_channel_t * l2cap_get_channel_for_local_cid(uint16_t local_cid){ 1143 if (local_cid < 0x40u) return NULL; 1144 return (l2cap_channel_t*) l2cap_channel_item_by_cid(local_cid); 1145 } 1146 1147 static l2cap_channel_t * l2cap_get_channel_for_local_cid_and_handle(uint16_t local_cid, hci_con_handle_t con_handle){ 1148 if (local_cid < 0x40u) return NULL; 1149 l2cap_channel_t * l2cap_channel = (l2cap_channel_t*) l2cap_channel_item_by_cid(local_cid); 1150 if (l2cap_channel == NULL) return NULL; 1151 if (l2cap_channel->con_handle != con_handle) return NULL; 1152 return l2cap_channel; 1153 } 1154 1155 void l2cap_request_can_send_now_event(uint16_t local_cid){ 1156 l2cap_channel_t *channel = l2cap_get_channel_for_local_cid(local_cid); 1157 if (!channel) return; 1158 channel->waiting_for_can_send_now = 1; 1159 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1160 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1161 l2cap_ertm_notify_channel_can_send(channel); 1162 return; 1163 } 1164 #endif 1165 l2cap_notify_channel_can_send(); 1166 } 1167 1168 int l2cap_can_send_packet_now(uint16_t local_cid){ 1169 l2cap_channel_t *channel = l2cap_get_channel_for_local_cid(local_cid); 1170 if (!channel) return 0; 1171 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1172 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1173 return l2cap_ertm_can_store_packet_now(channel); 1174 } 1175 #endif 1176 return hci_can_send_acl_packet_now(channel->con_handle); 1177 } 1178 1179 int l2cap_can_send_prepared_packet_now(uint16_t local_cid){ 1180 l2cap_channel_t *channel = l2cap_get_channel_for_local_cid(local_cid); 1181 if (!channel) return 0; 1182 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1183 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1184 return 0; 1185 } 1186 #endif 1187 return hci_can_send_prepared_acl_packet_now(channel->con_handle); 1188 } 1189 1190 uint16_t l2cap_get_remote_mtu_for_local_cid(uint16_t local_cid){ 1191 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 1192 if (channel) { 1193 return channel->remote_mtu; 1194 } 1195 return 0; 1196 } 1197 #endif 1198 1199 #ifdef L2CAP_USES_CHANNELS 1200 static int l2cap_is_dynamic_channel_type(l2cap_channel_type_t channel_type){ 1201 switch (channel_type){ 1202 case L2CAP_CHANNEL_TYPE_CLASSIC: 1203 case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL: 1204 return 1; 1205 default: 1206 return 0; 1207 } 1208 } 1209 #endif 1210 1211 #ifdef ENABLE_CLASSIC 1212 // RTX Timer only exist for dynamic channels 1213 static l2cap_channel_t * l2cap_channel_for_rtx_timer(btstack_timer_source_t * ts){ 1214 btstack_linked_list_iterator_t it; 1215 btstack_linked_list_iterator_init(&it, &l2cap_channels); 1216 while (btstack_linked_list_iterator_has_next(&it)){ 1217 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 1218 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 1219 if (&channel->rtx == ts) { 1220 return channel; 1221 } 1222 } 1223 return NULL; 1224 } 1225 1226 static void l2cap_rtx_timeout(btstack_timer_source_t * ts){ 1227 l2cap_channel_t * channel = l2cap_channel_for_rtx_timer(ts); 1228 if (!channel) return; 1229 1230 log_info("l2cap_rtx_timeout for local cid 0x%02x", channel->local_cid); 1231 1232 // "When terminating the channel, it is not necessary to send a L2CAP_DisconnectReq 1233 // and enter WAIT_DISCONNECT state. Channels can be transitioned directly to the CLOSED state." 1234 // notify client 1235 l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_RTX_TIMEOUT); 1236 1237 // discard channel 1238 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 1239 l2cap_free_channel_entry(channel); 1240 } 1241 1242 #endif 1243 1244 #ifdef L2CAP_USES_CHANNELS 1245 static void l2cap_stop_rtx(l2cap_channel_t * channel){ 1246 log_info("l2cap_stop_rtx for local cid 0x%02x", channel->local_cid); 1247 btstack_run_loop_remove_timer(&channel->rtx); 1248 } 1249 #endif 1250 1251 #ifdef ENABLE_CLASSIC 1252 1253 static void l2cap_start_rtx(l2cap_channel_t * channel){ 1254 l2cap_stop_rtx(channel); 1255 log_info("l2cap_start_rtx for local cid 0x%02x", channel->local_cid); 1256 btstack_run_loop_set_timer_handler(&channel->rtx, l2cap_rtx_timeout); 1257 btstack_run_loop_set_timer(&channel->rtx, L2CAP_RTX_TIMEOUT_MS); 1258 btstack_run_loop_add_timer(&channel->rtx); 1259 } 1260 1261 static void l2cap_start_ertx(l2cap_channel_t * channel){ 1262 log_info("l2cap_start_ertx for local cid 0x%02x", channel->local_cid); 1263 l2cap_stop_rtx(channel); 1264 btstack_run_loop_set_timer_handler(&channel->rtx, l2cap_rtx_timeout); 1265 btstack_run_loop_set_timer(&channel->rtx, L2CAP_ERTX_TIMEOUT_MS); 1266 btstack_run_loop_add_timer(&channel->rtx); 1267 } 1268 1269 void l2cap_require_security_level_2_for_outgoing_sdp(void){ 1270 require_security_level2_for_outgoing_sdp = 1; 1271 } 1272 1273 static int l2cap_security_level_0_allowed_for_PSM(uint16_t psm){ 1274 return (psm == BLUETOOTH_PSM_SDP) && (!require_security_level2_for_outgoing_sdp); 1275 } 1276 1277 static int l2cap_send_signaling_packet(hci_con_handle_t handle, L2CAP_SIGNALING_COMMANDS cmd, int identifier, ...){ 1278 if (!hci_can_send_acl_packet_now(handle)){ 1279 log_info("l2cap_send_signaling_packet, cannot send"); 1280 return BTSTACK_ACL_BUFFERS_FULL; 1281 } 1282 1283 // log_info("l2cap_send_signaling_packet type %u", cmd); 1284 hci_reserve_packet_buffer(); 1285 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 1286 va_list argptr; 1287 va_start(argptr, identifier); 1288 uint16_t len = l2cap_create_signaling_classic(acl_buffer, handle, cmd, identifier, argptr); 1289 va_end(argptr); 1290 // log_info("l2cap_send_signaling_packet con %u!", handle); 1291 return hci_send_acl_packet_buffer(len); 1292 } 1293 1294 // assumption - only on Classic connections 1295 // cannot be used for L2CAP ERTM 1296 int l2cap_send_prepared(uint16_t local_cid, uint16_t len){ 1297 1298 if (!hci_is_packet_buffer_reserved()){ 1299 log_error("l2cap_send_prepared called without reserving packet first"); 1300 return BTSTACK_ACL_BUFFERS_FULL; 1301 } 1302 1303 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 1304 if (!channel) { 1305 log_error("l2cap_send_prepared no channel for cid 0x%02x", local_cid); 1306 return -1; // TODO: define error 1307 } 1308 1309 if (!hci_can_send_prepared_acl_packet_now(channel->con_handle)){ 1310 log_info("l2cap_send_prepared cid 0x%02x, cannot send", local_cid); 1311 return BTSTACK_ACL_BUFFERS_FULL; 1312 } 1313 1314 log_debug("l2cap_send_prepared cid 0x%02x, handle %u, 1 credit used", local_cid, channel->con_handle); 1315 1316 int fcs_size = 0; 1317 1318 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1319 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION && channel->fcs_option){ 1320 fcs_size = 2; 1321 } 1322 #endif 1323 1324 // set non-flushable packet boundary flag if supported on Controller 1325 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 1326 uint8_t packet_boundary_flag = hci_non_flushable_packet_boundary_flag_supported() ? 0x00 : 0x02; 1327 l2cap_setup_header(acl_buffer, channel->con_handle, packet_boundary_flag, channel->remote_cid, len + fcs_size); 1328 1329 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1330 if (fcs_size){ 1331 // calculate FCS over l2cap data 1332 uint16_t fcs = crc16_calc(acl_buffer + 4, 4 + len); 1333 log_info("I-Frame: fcs 0x%04x", fcs); 1334 little_endian_store_16(acl_buffer, 8 + len, fcs); 1335 } 1336 #endif 1337 1338 // send 1339 return hci_send_acl_packet_buffer(len+8+fcs_size); 1340 } 1341 1342 // assumption - only on Classic connections 1343 int l2cap_send(uint16_t local_cid, uint8_t *data, uint16_t len){ 1344 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 1345 if (!channel) { 1346 log_error("l2cap_send no channel for cid 0x%02x", local_cid); 1347 return -1; // TODO: define error 1348 } 1349 1350 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1351 // send in ERTM 1352 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1353 return l2cap_ertm_send(channel, data, len); 1354 } 1355 #endif 1356 1357 if (len > channel->remote_mtu){ 1358 log_error("l2cap_send cid 0x%02x, data length exceeds remote MTU.", local_cid); 1359 return L2CAP_DATA_LEN_EXCEEDS_REMOTE_MTU; 1360 } 1361 1362 if (!hci_can_send_acl_packet_now(channel->con_handle)){ 1363 log_info("l2cap_send cid 0x%02x, cannot send", local_cid); 1364 return BTSTACK_ACL_BUFFERS_FULL; 1365 } 1366 1367 hci_reserve_packet_buffer(); 1368 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 1369 (void)memcpy(&acl_buffer[8], data, len); 1370 return l2cap_send_prepared(local_cid, len); 1371 } 1372 1373 int l2cap_send_echo_request(hci_con_handle_t con_handle, uint8_t *data, uint16_t len){ 1374 return l2cap_send_signaling_packet(con_handle, ECHO_REQUEST, l2cap_next_sig_id(), len, data); 1375 } 1376 1377 static inline void channelStateVarSetFlag(l2cap_channel_t *channel, L2CAP_CHANNEL_STATE_VAR flag){ 1378 channel->state_var = (L2CAP_CHANNEL_STATE_VAR) (channel->state_var | flag); 1379 } 1380 1381 static inline void channelStateVarClearFlag(l2cap_channel_t *channel, L2CAP_CHANNEL_STATE_VAR flag){ 1382 channel->state_var = (L2CAP_CHANNEL_STATE_VAR) (channel->state_var & ~flag); 1383 } 1384 #endif 1385 1386 1387 #ifdef ENABLE_BLE 1388 static int l2cap_send_le_signaling_packet(hci_con_handle_t handle, L2CAP_SIGNALING_COMMANDS cmd, int identifier, ...){ 1389 1390 if (!hci_can_send_acl_packet_now(handle)){ 1391 log_info("l2cap_send_le_signaling_packet, cannot send"); 1392 return BTSTACK_ACL_BUFFERS_FULL; 1393 } 1394 1395 // log_info("l2cap_send_le_signaling_packet type %u", cmd); 1396 hci_reserve_packet_buffer(); 1397 uint8_t *acl_buffer = hci_get_outgoing_packet_buffer(); 1398 va_list argptr; 1399 va_start(argptr, identifier); 1400 uint16_t len = l2cap_create_signaling_le(acl_buffer, handle, cmd, identifier, argptr); 1401 va_end(argptr); 1402 // log_info("l2cap_send_le_signaling_packet con %u!", handle); 1403 return hci_send_acl_packet_buffer(len); 1404 } 1405 #endif 1406 1407 uint16_t l2cap_max_mtu(void){ 1408 return HCI_ACL_PAYLOAD_SIZE - L2CAP_HEADER_SIZE; 1409 } 1410 1411 #ifdef ENABLE_BLE 1412 uint16_t l2cap_max_le_mtu(void){ 1413 if (l2cap_le_custom_max_mtu != 0u) return l2cap_le_custom_max_mtu; 1414 return l2cap_max_mtu(); 1415 } 1416 1417 void l2cap_set_max_le_mtu(uint16_t max_mtu){ 1418 if (max_mtu < l2cap_max_mtu()){ 1419 l2cap_le_custom_max_mtu = max_mtu; 1420 } 1421 } 1422 #endif 1423 1424 #ifdef ENABLE_CLASSIC 1425 1426 static uint16_t l2cap_setup_options_mtu(uint8_t * config_options, uint16_t mtu){ 1427 config_options[0] = L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT; // MTU 1428 config_options[1] = 2; // len param 1429 little_endian_store_16(config_options, 2, mtu); 1430 return 4; 1431 } 1432 1433 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1434 static int l2cap_ertm_mode(l2cap_channel_t * channel){ 1435 hci_connection_t * connection = hci_connection_for_handle(channel->con_handle); 1436 return ((connection->l2cap_state.information_state == L2CAP_INFORMATION_STATE_DONE) 1437 && (connection->l2cap_state.extended_feature_mask & 0x08)); 1438 } 1439 #endif 1440 1441 static uint16_t l2cap_setup_options_request(l2cap_channel_t * channel, uint8_t * config_options){ 1442 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1443 // use ERTM options if supported by remote and channel ready to use it 1444 if (l2cap_ertm_mode(channel) && channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1445 return l2cap_setup_options_ertm_request(channel, config_options); 1446 } 1447 #endif 1448 uint16_t mtu = channel->local_mtu; 1449 return l2cap_setup_options_mtu(config_options, mtu); 1450 } 1451 1452 static uint16_t l2cap_setup_options_mtu_response(l2cap_channel_t * channel, uint8_t * config_options){ 1453 uint16_t mtu = btstack_min(channel->local_mtu, channel->remote_mtu); 1454 return l2cap_setup_options_mtu(config_options, mtu); 1455 } 1456 1457 static uint32_t l2cap_extended_features_mask(void){ 1458 // extended features request supported, features: fixed channels, unicast connectionless data reception 1459 uint32_t features = 0x280; 1460 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1461 features |= 0x0028; 1462 #endif 1463 return features; 1464 } 1465 #endif 1466 1467 // 1468 #ifdef ENABLE_CLASSIC 1469 1470 // returns true if channel was finalized 1471 static bool l2cap_run_for_classic_channel(l2cap_channel_t * channel){ 1472 1473 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1474 uint8_t config_options[18]; 1475 #else 1476 uint8_t config_options[10]; 1477 #endif 1478 1479 switch (channel->state){ 1480 1481 case L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE: 1482 case L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT: 1483 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1484 if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONN_RESP_PEND) { 1485 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONN_RESP_PEND); 1486 l2cap_send_signaling_packet(channel->con_handle, CONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->remote_cid, 1, 0); 1487 } 1488 break; 1489 1490 case L2CAP_STATE_WILL_SEND_CREATE_CONNECTION: 1491 if (!hci_can_send_command_packet_now()) break; 1492 // send connection request - set state first 1493 channel->state = L2CAP_STATE_WAIT_CONNECTION_COMPLETE; 1494 // BD_ADDR, Packet_Type, Page_Scan_Repetition_Mode, Reserved, Clock_Offset, Allow_Role_Switch 1495 (void)memcpy(l2cap_outgoing_classic_addr, channel->address, 6); 1496 hci_send_cmd(&hci_create_connection, channel->address, hci_usable_acl_packet_types(), 0, 0, 0, hci_get_allow_role_switch()); 1497 break; 1498 1499 case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE: 1500 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1501 channel->state = L2CAP_STATE_INVALID; 1502 l2cap_send_signaling_packet(channel->con_handle, CONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->remote_cid, channel->reason, 0); 1503 // discard channel - l2cap_finialize_channel_close without sending l2cap close event 1504 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 1505 l2cap_free_channel_entry(channel); 1506 channel = NULL; 1507 break; 1508 1509 case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT: 1510 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1511 channel->state = L2CAP_STATE_CONFIG; 1512 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ); 1513 l2cap_send_signaling_packet(channel->con_handle, CONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->remote_cid, 0, 0); 1514 break; 1515 1516 case L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST: 1517 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1518 // success, start l2cap handshake 1519 channel->local_sig_id = l2cap_next_sig_id(); 1520 channel->state = L2CAP_STATE_WAIT_CONNECT_RSP; 1521 l2cap_send_signaling_packet( channel->con_handle, CONNECTION_REQUEST, channel->local_sig_id, channel->psm, channel->local_cid); 1522 l2cap_start_rtx(channel); 1523 break; 1524 1525 case L2CAP_STATE_CONFIG: 1526 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1527 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1528 // fallback to basic mode if ERTM requested but not not supported by remote 1529 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 1530 if (!l2cap_ertm_mode(channel)){ 1531 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED); 1532 channel->mode = L2CAP_CHANNEL_MODE_BASIC; 1533 } 1534 } 1535 #endif 1536 if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP){ 1537 uint16_t flags = 0; 1538 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP); 1539 if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT) { 1540 flags = 1; 1541 } else { 1542 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SENT_CONF_RSP); 1543 } 1544 if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_INVALID){ 1545 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SENT_CONF_RSP); 1546 l2cap_send_signaling_packet(channel->con_handle, CONFIGURE_RESPONSE, channel->remote_sig_id, channel->remote_cid, flags, L2CAP_CONF_RESULT_UNKNOWN_OPTIONS, 1, &channel->unknown_option); 1547 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1548 } else if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_REJECTED){ 1549 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_REJECTED); 1550 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SENT_CONF_RSP); 1551 uint16_t options_size = l2cap_setup_options_ertm_response(channel, config_options); 1552 l2cap_send_signaling_packet(channel->con_handle, CONFIGURE_RESPONSE, channel->remote_sig_id, channel->remote_cid, flags, L2CAP_CONF_RESULT_UNACCEPTABLE_PARAMETERS, options_size, &config_options); 1553 } else if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM){ 1554 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM); 1555 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_MTU); 1556 uint16_t options_size = l2cap_setup_options_ertm_response(channel, config_options); 1557 l2cap_send_signaling_packet(channel->con_handle, CONFIGURE_RESPONSE, channel->remote_sig_id, channel->remote_cid, flags, L2CAP_CONF_RESULT_SUCCESS, options_size, &config_options); 1558 #endif 1559 } else if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_MTU){ 1560 channelStateVarClearFlag(channel,L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_MTU); 1561 uint16_t options_size = l2cap_setup_options_mtu_response(channel, config_options); 1562 l2cap_send_signaling_packet(channel->con_handle, CONFIGURE_RESPONSE, channel->remote_sig_id, channel->remote_cid, flags, L2CAP_CONF_RESULT_SUCCESS, options_size, &config_options); 1563 } else { 1564 l2cap_send_signaling_packet(channel->con_handle, CONFIGURE_RESPONSE, channel->remote_sig_id, channel->remote_cid, flags, L2CAP_CONF_RESULT_SUCCESS, 0, NULL); 1565 } 1566 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT); 1567 } 1568 else if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ){ 1569 channelStateVarClearFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ); 1570 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SENT_CONF_REQ); 1571 channel->local_sig_id = l2cap_next_sig_id(); 1572 uint16_t options_size = l2cap_setup_options_request(channel, config_options); 1573 l2cap_send_signaling_packet(channel->con_handle, CONFIGURE_REQUEST, channel->local_sig_id, channel->remote_cid, 0, options_size, &config_options); 1574 l2cap_start_rtx(channel); 1575 } 1576 if (l2cap_channel_ready_for_open(channel)){ 1577 channel->state = L2CAP_STATE_OPEN; 1578 l2cap_emit_channel_opened(channel, 0); // success 1579 } 1580 break; 1581 1582 case L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE: 1583 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1584 channel->state = L2CAP_STATE_INVALID; 1585 l2cap_send_signaling_packet( channel->con_handle, DISCONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->remote_cid); 1586 // we don't start an RTX timer for a disconnect - there's no point in closing the channel if the other side doesn't respond :) 1587 l2cap_finialize_channel_close(channel); // -- remove from list 1588 channel = NULL; 1589 break; 1590 1591 case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST: 1592 if (!hci_can_send_acl_packet_now(channel->con_handle)) return false; 1593 channel->local_sig_id = l2cap_next_sig_id(); 1594 channel->state = L2CAP_STATE_WAIT_DISCONNECT; 1595 l2cap_send_signaling_packet( channel->con_handle, DISCONNECTION_REQUEST, channel->local_sig_id, channel->remote_cid, channel->local_cid); 1596 break; 1597 default: 1598 break; 1599 } 1600 1601 // handle channel finalize on L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE and L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE 1602 return channel == NULL; 1603 } 1604 1605 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1606 static void l2cap_run_for_classic_channel_ertm(l2cap_channel_t * channel){ 1607 1608 // ERTM mode 1609 if (channel->mode != L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) return; 1610 1611 // check if we can still send 1612 if (channel->con_handle == HCI_CON_HANDLE_INVALID) return; 1613 if (!hci_can_send_acl_packet_now(channel->con_handle)) return; 1614 1615 if (channel->send_supervisor_frame_receiver_ready){ 1616 channel->send_supervisor_frame_receiver_ready = 0; 1617 log_info("Send S-Frame: RR %u, final %u", channel->req_seq, channel->set_final_bit_after_packet_with_poll_bit_set); 1618 uint16_t control = l2cap_encanced_control_field_for_supevisor_frame( L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY, 0, channel->set_final_bit_after_packet_with_poll_bit_set, channel->req_seq); 1619 channel->set_final_bit_after_packet_with_poll_bit_set = 0; 1620 l2cap_ertm_send_supervisor_frame(channel, control); 1621 return; 1622 } 1623 if (channel->send_supervisor_frame_receiver_ready_poll){ 1624 channel->send_supervisor_frame_receiver_ready_poll = 0; 1625 log_info("Send S-Frame: RR %u with poll=1 ", channel->req_seq); 1626 uint16_t control = l2cap_encanced_control_field_for_supevisor_frame( L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY, 1, 0, channel->req_seq); 1627 l2cap_ertm_send_supervisor_frame(channel, control); 1628 return; 1629 } 1630 if (channel->send_supervisor_frame_receiver_not_ready){ 1631 channel->send_supervisor_frame_receiver_not_ready = 0; 1632 log_info("Send S-Frame: RNR %u", channel->req_seq); 1633 uint16_t control = l2cap_encanced_control_field_for_supevisor_frame( L2CAP_SUPERVISORY_FUNCTION_RNR_RECEIVER_NOT_READY, 0, 0, channel->req_seq); 1634 l2cap_ertm_send_supervisor_frame(channel, control); 1635 return; 1636 } 1637 if (channel->send_supervisor_frame_reject){ 1638 channel->send_supervisor_frame_reject = 0; 1639 log_info("Send S-Frame: REJ %u", channel->req_seq); 1640 uint16_t control = l2cap_encanced_control_field_for_supevisor_frame( L2CAP_SUPERVISORY_FUNCTION_REJ_REJECT, 0, 0, channel->req_seq); 1641 l2cap_ertm_send_supervisor_frame(channel, control); 1642 return; 1643 } 1644 if (channel->send_supervisor_frame_selective_reject){ 1645 channel->send_supervisor_frame_selective_reject = 0; 1646 log_info("Send S-Frame: SREJ %u", channel->expected_tx_seq); 1647 uint16_t control = l2cap_encanced_control_field_for_supevisor_frame( L2CAP_SUPERVISORY_FUNCTION_SREJ_SELECTIVE_REJECT, 0, channel->set_final_bit_after_packet_with_poll_bit_set, channel->expected_tx_seq); 1648 channel->set_final_bit_after_packet_with_poll_bit_set = 0; 1649 l2cap_ertm_send_supervisor_frame(channel, control); 1650 return; 1651 } 1652 1653 if (channel->srej_active){ 1654 int i; 1655 for (i=0;i<channel->num_tx_buffers;i++){ 1656 l2cap_ertm_tx_packet_state_t * tx_state = &channel->tx_packets_state[i]; 1657 if (tx_state->retransmission_requested) { 1658 tx_state->retransmission_requested = 0; 1659 uint8_t final = channel->set_final_bit_after_packet_with_poll_bit_set; 1660 channel->set_final_bit_after_packet_with_poll_bit_set = 0; 1661 l2cap_ertm_send_information_frame(channel, i, final); 1662 break; 1663 } 1664 } 1665 if (i == channel->num_tx_buffers){ 1666 // no retransmission request found 1667 channel->srej_active = 0; 1668 } else { 1669 // packet was sent 1670 return; 1671 } 1672 } 1673 } 1674 #endif /* ERTM */ 1675 #endif /* Classic */ 1676 1677 static void l2cap_run_signaling_response(void) { 1678 1679 // check pending signaling responses 1680 while (signaling_responses_pending){ 1681 1682 hci_con_handle_t handle = signaling_responses[0].handle; 1683 1684 if (!hci_can_send_acl_packet_now(handle)) break; 1685 1686 uint8_t sig_id = signaling_responses[0].sig_id; 1687 uint8_t response_code = signaling_responses[0].code; 1688 uint16_t result = signaling_responses[0].data; // CONNECTION_REQUEST, COMMAND_REJECT 1689 #ifdef ENABLE_CLASSIC 1690 uint16_t info_type = signaling_responses[0].data; // INFORMATION_REQUEST 1691 uint16_t source_cid = signaling_responses[0].cid; // CONNECTION_REQUEST 1692 #endif 1693 1694 // remove first item before sending (to avoid sending response mutliple times) 1695 signaling_responses_pending--; 1696 int i; 1697 for (i=0; i < signaling_responses_pending; i++){ 1698 (void)memcpy(&signaling_responses[i], 1699 &signaling_responses[i + 1], 1700 sizeof(l2cap_signaling_response_t)); 1701 } 1702 1703 switch (response_code){ 1704 #ifdef ENABLE_CLASSIC 1705 case CONNECTION_REQUEST: 1706 l2cap_send_signaling_packet(handle, CONNECTION_RESPONSE, sig_id, source_cid, 0, result, 0); 1707 // also disconnect if result is 0x0003 - security blocked 1708 if (result == 0x0003){ 1709 hci_disconnect_security_block(handle); 1710 } 1711 break; 1712 case ECHO_REQUEST: 1713 l2cap_send_signaling_packet(handle, ECHO_RESPONSE, sig_id, 0, NULL); 1714 break; 1715 case INFORMATION_REQUEST: 1716 switch (info_type){ 1717 case L2CAP_INFO_TYPE_CONNECTIONLESS_MTU: { 1718 uint16_t connectionless_mtu = hci_max_acl_data_packet_length(); 1719 l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 0, sizeof(connectionless_mtu), &connectionless_mtu); 1720 } 1721 break; 1722 case L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED: { 1723 uint32_t features = l2cap_extended_features_mask(); 1724 l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 0, sizeof(features), &features); 1725 } 1726 break; 1727 case L2CAP_INFO_TYPE_FIXED_CHANNELS_SUPPORTED: { 1728 uint8_t map[8]; 1729 memset(map, 0, 8); 1730 map[0] = 0x06; // L2CAP Signaling Channel (0x02) + Connectionless reception (0x04) 1731 l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 0, sizeof(map), &map); 1732 } 1733 break; 1734 default: 1735 // all other types are not supported 1736 l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 1, 0, NULL); 1737 break; 1738 } 1739 break; 1740 case COMMAND_REJECT: 1741 l2cap_send_signaling_packet(handle, COMMAND_REJECT, sig_id, result, 0, NULL); 1742 break; 1743 #endif 1744 #ifdef ENABLE_BLE 1745 case LE_CREDIT_BASED_CONNECTION_REQUEST: 1746 l2cap_send_le_signaling_packet(handle, LE_CREDIT_BASED_CONNECTION_RESPONSE, sig_id, 0, 0, 0, 0, result); 1747 break; 1748 case COMMAND_REJECT_LE: 1749 l2cap_send_le_signaling_packet(handle, COMMAND_REJECT, sig_id, result, 0, NULL); 1750 break; 1751 #endif 1752 default: 1753 // should not happen 1754 break; 1755 } 1756 } 1757 } 1758 1759 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1760 static bool l2ap_run_ertm(void){ 1761 // send l2cap information request if neccessary 1762 btstack_linked_list_iterator_t it; 1763 hci_connections_get_iterator(&it); 1764 while(btstack_linked_list_iterator_has_next(&it)){ 1765 hci_connection_t * connection = (hci_connection_t *) btstack_linked_list_iterator_next(&it); 1766 if (connection->l2cap_state.information_state == L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST){ 1767 if (!hci_can_send_acl_packet_now(connection->con_handle)) break; 1768 connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_W4_EXTENDED_FEATURE_RESPONSE; 1769 uint8_t sig_id = l2cap_next_sig_id(); 1770 uint8_t info_type = L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED; 1771 l2cap_send_signaling_packet(connection->con_handle, INFORMATION_REQUEST, sig_id, info_type); 1772 return true; 1773 } 1774 } 1775 return false; 1776 } 1777 #endif 1778 1779 #ifdef ENABLE_LE_DATA_CHANNELS 1780 static void l2cap_run_le_data_channels(void){ 1781 btstack_linked_list_iterator_t it; 1782 btstack_linked_list_iterator_init(&it, &l2cap_channels); 1783 while (btstack_linked_list_iterator_has_next(&it)){ 1784 uint16_t mps; 1785 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 1786 1787 if (channel->channel_type != L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL) continue; 1788 1789 // log_info("l2cap_run: channel %p, state %u, var 0x%02x", channel, channel->state, channel->state_var); 1790 switch (channel->state){ 1791 case L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST: 1792 if (!hci_can_send_acl_packet_now(channel->con_handle)) break; 1793 channel->state = L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE; 1794 // le psm, source cid, mtu, mps, initial credits 1795 channel->local_sig_id = l2cap_next_sig_id(); 1796 channel->credits_incoming = channel->new_credits_incoming; 1797 channel->new_credits_incoming = 0; 1798 mps = btstack_min(l2cap_max_le_mtu(), channel->local_mtu); 1799 l2cap_send_le_signaling_packet( channel->con_handle, LE_CREDIT_BASED_CONNECTION_REQUEST, channel->local_sig_id, channel->psm, channel->local_cid, channel->local_mtu, mps, channel->credits_incoming); 1800 break; 1801 case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT: 1802 if (!hci_can_send_acl_packet_now(channel->con_handle)) break; 1803 // TODO: support larger MPS 1804 channel->state = L2CAP_STATE_OPEN; 1805 channel->credits_incoming = channel->new_credits_incoming; 1806 channel->new_credits_incoming = 0; 1807 mps = btstack_min(l2cap_max_le_mtu(), channel->local_mtu); 1808 l2cap_send_le_signaling_packet(channel->con_handle, LE_CREDIT_BASED_CONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->local_mtu, mps, channel->credits_incoming, 0); 1809 // notify client 1810 l2cap_emit_le_channel_opened(channel, 0); 1811 break; 1812 case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE: 1813 if (!hci_can_send_acl_packet_now(channel->con_handle)) break; 1814 channel->state = L2CAP_STATE_INVALID; 1815 l2cap_send_le_signaling_packet(channel->con_handle, LE_CREDIT_BASED_CONNECTION_RESPONSE, channel->remote_sig_id, 0, 0, 0, 0, channel->reason); 1816 // discard channel - l2cap_finialize_channel_close without sending l2cap close event 1817 btstack_linked_list_iterator_remove(&it); 1818 l2cap_free_channel_entry(channel); 1819 break; 1820 case L2CAP_STATE_OPEN: 1821 if (!hci_can_send_acl_packet_now(channel->con_handle)) break; 1822 1823 // send credits 1824 if (channel->new_credits_incoming){ 1825 log_info("l2cap: sending %u credits", channel->new_credits_incoming); 1826 channel->local_sig_id = l2cap_next_sig_id(); 1827 uint16_t new_credits = channel->new_credits_incoming; 1828 channel->new_credits_incoming = 0; 1829 channel->credits_incoming += new_credits; 1830 l2cap_send_le_signaling_packet(channel->con_handle, LE_FLOW_CONTROL_CREDIT, channel->local_sig_id, channel->remote_cid, new_credits); 1831 } 1832 break; 1833 1834 case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST: 1835 if (!hci_can_send_acl_packet_now(channel->con_handle)) break; 1836 channel->local_sig_id = l2cap_next_sig_id(); 1837 channel->state = L2CAP_STATE_WAIT_DISCONNECT; 1838 l2cap_send_le_signaling_packet( channel->con_handle, DISCONNECTION_REQUEST, channel->local_sig_id, channel->remote_cid, channel->local_cid); 1839 break; 1840 case L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE: 1841 if (!hci_can_send_acl_packet_now(channel->con_handle)) break; 1842 channel->state = L2CAP_STATE_INVALID; 1843 l2cap_send_le_signaling_packet( channel->con_handle, DISCONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->remote_cid); 1844 l2cap_le_finialize_channel_close(channel); // -- remove from list 1845 break; 1846 default: 1847 break; 1848 } 1849 } 1850 } 1851 #endif 1852 1853 // MARK: L2CAP_RUN 1854 // process outstanding signaling tasks 1855 static void l2cap_run(void){ 1856 1857 // log_info("l2cap_run: entered"); 1858 l2cap_run_signaling_response(); 1859 1860 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1861 bool done = l2ap_run_ertm(); 1862 if (done) return; 1863 #endif 1864 1865 #if defined(ENABLE_CLASSIC) || defined(ENABLE_BLE) 1866 btstack_linked_list_iterator_t it; 1867 #endif 1868 1869 #ifdef ENABLE_CLASSIC 1870 btstack_linked_list_iterator_init(&it, &l2cap_channels); 1871 while (btstack_linked_list_iterator_has_next(&it)){ 1872 1873 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 1874 1875 if (channel->channel_type != L2CAP_CHANNEL_TYPE_CLASSIC) continue; 1876 1877 // log_info("l2cap_run: channel %p, state %u, var 0x%02x", channel, channel->state, channel->state_var); 1878 bool finalized = l2cap_run_for_classic_channel(channel); 1879 1880 if (!finalized) { 1881 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1882 l2cap_run_for_classic_channel_ertm(channel); 1883 #endif 1884 } 1885 } 1886 #endif 1887 1888 #ifdef ENABLE_LE_DATA_CHANNELS 1889 l2cap_run_le_data_channels(); 1890 #endif 1891 1892 #ifdef ENABLE_BLE 1893 // send l2cap con paramter update if necessary 1894 hci_connections_get_iterator(&it); 1895 while(btstack_linked_list_iterator_has_next(&it)){ 1896 hci_connection_t * connection = (hci_connection_t *) btstack_linked_list_iterator_next(&it); 1897 if ((connection->address_type != BD_ADDR_TYPE_LE_PUBLIC) && (connection->address_type != BD_ADDR_TYPE_LE_RANDOM)) continue; 1898 if (!hci_can_send_acl_packet_now(connection->con_handle)) continue; 1899 switch (connection->le_con_parameter_update_state){ 1900 case CON_PARAMETER_UPDATE_SEND_REQUEST: 1901 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_NONE; 1902 l2cap_send_le_signaling_packet(connection->con_handle, CONNECTION_PARAMETER_UPDATE_REQUEST, l2cap_next_sig_id(), 1903 connection->le_conn_interval_min, connection->le_conn_interval_max, connection->le_conn_latency, connection->le_supervision_timeout); 1904 break; 1905 case CON_PARAMETER_UPDATE_SEND_RESPONSE: 1906 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_CHANGE_HCI_CON_PARAMETERS; 1907 l2cap_send_le_signaling_packet(connection->con_handle, CONNECTION_PARAMETER_UPDATE_RESPONSE, connection->le_con_param_update_identifier, 0); 1908 break; 1909 case CON_PARAMETER_UPDATE_DENY: 1910 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_NONE; 1911 l2cap_send_le_signaling_packet(connection->con_handle, CONNECTION_PARAMETER_UPDATE_RESPONSE, connection->le_con_param_update_identifier, 1); 1912 break; 1913 default: 1914 break; 1915 } 1916 } 1917 #endif 1918 1919 // log_info("l2cap_run: exit"); 1920 } 1921 1922 #ifdef ENABLE_CLASSIC 1923 static void l2cap_handle_connection_complete(hci_con_handle_t con_handle, l2cap_channel_t * channel){ 1924 if ((channel->state == L2CAP_STATE_WAIT_CONNECTION_COMPLETE) || (channel->state == L2CAP_STATE_WILL_SEND_CREATE_CONNECTION)) { 1925 log_info("connection complete con_handle %04x - for channel %p cid 0x%04x", (int) con_handle, channel, channel->local_cid); 1926 // success, start l2cap handshake 1927 channel->con_handle = con_handle; 1928 // check remote SSP feature first 1929 channel->state = L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES; 1930 } 1931 } 1932 1933 static void l2cap_ready_to_connect(l2cap_channel_t * channel){ 1934 1935 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 1936 // assumption: outgoing connection 1937 hci_connection_t * connection = hci_connection_for_handle(channel->con_handle); 1938 if (connection->l2cap_state.information_state == L2CAP_INFORMATION_STATE_IDLE){ 1939 connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST; 1940 channel->state = L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES; 1941 return; 1942 } 1943 #endif 1944 1945 // fine, go ahead 1946 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST; 1947 } 1948 1949 static void l2cap_handle_remote_supported_features_received(l2cap_channel_t * channel){ 1950 if (channel->state != L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES) return; 1951 1952 // abort if Secure Connections Only Mode with legacy connection 1953 if (gap_get_secure_connections_only_mode() && gap_secure_connection(channel->con_handle) == false){ 1954 l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_REFUSED_SECURITY); 1955 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 1956 l2cap_free_channel_entry(channel); 1957 return; 1958 } 1959 1960 // we have been waiting for remote supported features 1961 if (channel->required_security_level > LEVEL_0){ 1962 // request security level 1963 channel->state = L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE; 1964 gap_request_security_level(channel->con_handle, channel->required_security_level); 1965 return; 1966 } 1967 1968 l2cap_ready_to_connect(channel); 1969 } 1970 #endif 1971 1972 #ifdef L2CAP_USES_CHANNELS 1973 static l2cap_channel_t * l2cap_create_channel_entry(btstack_packet_handler_t packet_handler, l2cap_channel_type_t channel_type, bd_addr_t address, bd_addr_type_t address_type, 1974 uint16_t psm, uint16_t local_mtu, gap_security_level_t security_level){ 1975 1976 l2cap_channel_t * channel = btstack_memory_l2cap_channel_get(); 1977 if (!channel) { 1978 return NULL; 1979 } 1980 1981 // fill in 1982 channel->packet_handler = packet_handler; 1983 channel->channel_type = channel_type; 1984 bd_addr_copy(channel->address, address); 1985 channel->address_type = address_type; 1986 channel->psm = psm; 1987 channel->local_mtu = local_mtu; 1988 channel->remote_mtu = L2CAP_DEFAULT_MTU; 1989 channel->required_security_level = security_level; 1990 1991 // 1992 channel->local_cid = l2cap_next_local_cid(); 1993 channel->con_handle = HCI_CON_HANDLE_INVALID; 1994 1995 // set initial state 1996 channel->state = L2CAP_STATE_WILL_SEND_CREATE_CONNECTION; 1997 channel->state_var = L2CAP_CHANNEL_STATE_VAR_NONE; 1998 channel->remote_sig_id = L2CAP_SIG_ID_INVALID; 1999 channel->local_sig_id = L2CAP_SIG_ID_INVALID; 2000 2001 log_info("create channel %p, local_cid 0x%04x", channel, channel->local_cid); 2002 2003 return channel; 2004 } 2005 2006 static void l2cap_free_channel_entry(l2cap_channel_t * channel){ 2007 log_info("free channel %p, local_cid 0x%04x", channel, channel->local_cid); 2008 // assert all timers are stopped 2009 l2cap_stop_rtx(channel); 2010 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2011 l2cap_ertm_stop_retransmission_timer(channel); 2012 l2cap_ertm_stop_monitor_timer(channel); 2013 #endif 2014 // free memory 2015 btstack_memory_l2cap_channel_free(channel); 2016 } 2017 #endif 2018 2019 #ifdef ENABLE_CLASSIC 2020 2021 /** 2022 * @brief Creates L2CAP channel to the PSM of a remote device with baseband address. A new baseband connection will be initiated if necessary. 2023 * @param packet_handler 2024 * @param address 2025 * @param psm 2026 * @param mtu 2027 * @param local_cid 2028 */ 2029 2030 uint8_t l2cap_create_channel(btstack_packet_handler_t channel_packet_handler, bd_addr_t address, uint16_t psm, uint16_t mtu, uint16_t * out_local_cid){ 2031 // limit MTU to the size of our outgoing HCI buffer 2032 uint16_t local_mtu = btstack_min(mtu, l2cap_max_mtu()); 2033 2034 // determine security level based on psm 2035 const gap_security_level_t security_level = l2cap_security_level_0_allowed_for_PSM(psm) ? LEVEL_0 : gap_get_security_level(); 2036 log_info("L2CAP_CREATE_CHANNEL addr %s psm 0x%x mtu %u -> local mtu %u, sec level %u", bd_addr_to_str(address), psm, mtu, local_mtu, (int) security_level); 2037 2038 l2cap_channel_t * channel = l2cap_create_channel_entry(channel_packet_handler, L2CAP_CHANNEL_TYPE_CLASSIC, address, BD_ADDR_TYPE_ACL, psm, local_mtu, security_level); 2039 if (!channel) { 2040 return BTSTACK_MEMORY_ALLOC_FAILED; 2041 } 2042 2043 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2044 channel->mode = L2CAP_CHANNEL_MODE_BASIC; 2045 #endif 2046 2047 // add to connections list 2048 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel); 2049 2050 // store local_cid 2051 if (out_local_cid){ 2052 *out_local_cid = channel->local_cid; 2053 } 2054 2055 // state: L2CAP_STATE_WILL_SEND_CREATE_CONNECTION 2056 2057 // check if hci connection is already usable, 2058 hci_connection_t * conn = hci_connection_for_bd_addr_and_type(address, BD_ADDR_TYPE_ACL); 2059 if (conn && conn->state == OPEN){ 2060 // simulate connection complete 2061 l2cap_handle_connection_complete(conn->con_handle, channel); 2062 2063 // state: L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES 2064 2065 // check if remote supported features are already received 2066 if (conn->bonding_flags & BONDING_RECEIVED_REMOTE_FEATURES) { 2067 // simulate remote features received 2068 l2cap_handle_remote_supported_features_received(channel); 2069 } 2070 } 2071 2072 l2cap_run(); 2073 2074 return ERROR_CODE_SUCCESS; 2075 } 2076 2077 void l2cap_disconnect(uint16_t local_cid, uint8_t reason){ 2078 log_info("L2CAP_DISCONNECT local_cid 0x%x reason 0x%x", local_cid, reason); 2079 // find channel for local_cid 2080 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 2081 if (channel) { 2082 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 2083 } 2084 // process 2085 l2cap_run(); 2086 } 2087 2088 static void l2cap_handle_connection_failed_for_addr(bd_addr_t address, uint8_t status){ 2089 // mark all channels before emitting open events as these could trigger new connetion requests to the same device 2090 btstack_linked_list_iterator_t it; 2091 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2092 while (btstack_linked_list_iterator_has_next(&it)){ 2093 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2094 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2095 if (bd_addr_cmp( channel->address, address) != 0) continue; 2096 // channel for this address found 2097 switch (channel->state){ 2098 case L2CAP_STATE_WAIT_CONNECTION_COMPLETE: 2099 case L2CAP_STATE_WILL_SEND_CREATE_CONNECTION: 2100 channel->state = L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD; 2101 break; 2102 default: 2103 break; 2104 } 2105 } 2106 // emit and free marked entries. restart loop to deal with list changes 2107 int done = 0; 2108 while (!done) { 2109 done = 1; 2110 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2111 while (btstack_linked_list_iterator_has_next(&it)){ 2112 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2113 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2114 if (channel->state == L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD){ 2115 done = 0; 2116 // failure, forward error code 2117 l2cap_handle_channel_open_failed(channel, status); 2118 // discard channel 2119 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 2120 l2cap_free_channel_entry(channel); 2121 break; 2122 } 2123 } 2124 } 2125 2126 } 2127 2128 static void l2cap_handle_connection_success_for_addr(bd_addr_t address, hci_con_handle_t handle){ 2129 btstack_linked_list_iterator_t it; 2130 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2131 while (btstack_linked_list_iterator_has_next(&it)){ 2132 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2133 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2134 if ( ! bd_addr_cmp( channel->address, address) ){ 2135 l2cap_handle_connection_complete(handle, channel); 2136 } 2137 } 2138 // process 2139 l2cap_run(); 2140 } 2141 #endif 2142 2143 static bool l2cap_channel_ready_to_send(l2cap_channel_t * channel){ 2144 switch (channel->channel_type){ 2145 #ifdef ENABLE_CLASSIC 2146 case L2CAP_CHANNEL_TYPE_CLASSIC: 2147 if (channel->state != L2CAP_STATE_OPEN) return false; 2148 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2149 // send if we have more data and remote windows isn't full yet 2150 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) { 2151 if (channel->unacked_frames >= btstack_min(channel->num_stored_tx_frames, channel->remote_tx_window_size)) return false; 2152 return hci_can_send_acl_classic_packet_now() != 0; 2153 } 2154 #endif 2155 if (!channel->waiting_for_can_send_now) return false; 2156 return (hci_can_send_acl_classic_packet_now() != 0); 2157 case L2CAP_CHANNEL_TYPE_CONNECTIONLESS: 2158 if (!channel->waiting_for_can_send_now) return false; 2159 return hci_can_send_acl_classic_packet_now() != 0; 2160 #endif 2161 #ifdef ENABLE_BLE 2162 case L2CAP_CHANNEL_TYPE_LE_FIXED: 2163 if (!channel->waiting_for_can_send_now) return false; 2164 return hci_can_send_acl_le_packet_now() != 0; 2165 #ifdef ENABLE_LE_DATA_CHANNELS 2166 case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL: 2167 if (channel->state != L2CAP_STATE_OPEN) return false; 2168 if (channel->send_sdu_buffer == NULL) return false; 2169 if (channel->credits_outgoing == 0u) return false; 2170 return hci_can_send_acl_le_packet_now() != 0; 2171 #endif 2172 #endif 2173 default: 2174 return false; 2175 } 2176 } 2177 2178 static void l2cap_channel_trigger_send(l2cap_channel_t * channel){ 2179 switch (channel->channel_type){ 2180 #ifdef ENABLE_CLASSIC 2181 case L2CAP_CHANNEL_TYPE_CLASSIC: 2182 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2183 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) { 2184 l2cap_ertm_channel_send_information_frame(channel); 2185 return; 2186 } 2187 #endif 2188 channel->waiting_for_can_send_now = 0; 2189 l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid); 2190 break; 2191 case L2CAP_CHANNEL_TYPE_CONNECTIONLESS: 2192 channel->waiting_for_can_send_now = 0; 2193 l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid); 2194 break; 2195 #endif 2196 #ifdef ENABLE_BLE 2197 case L2CAP_CHANNEL_TYPE_LE_FIXED: 2198 channel->waiting_for_can_send_now = 0; 2199 l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid); 2200 break; 2201 #ifdef ENABLE_LE_DATA_CHANNELS 2202 case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL: 2203 l2cap_le_send_pdu(channel); 2204 break; 2205 #endif 2206 #endif 2207 default: 2208 break; 2209 } 2210 } 2211 2212 static void l2cap_notify_channel_can_send(void){ 2213 bool done = false; 2214 while (!done){ 2215 done = true; 2216 btstack_linked_list_iterator_t it; 2217 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2218 while (btstack_linked_list_iterator_has_next(&it)){ 2219 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2220 bool ready = l2cap_channel_ready_to_send(channel); 2221 if (!ready) continue; 2222 2223 // requeue channel for fairness 2224 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 2225 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel); 2226 2227 // trigger sending 2228 l2cap_channel_trigger_send(channel); 2229 2230 // exit inner loop as we just broke the iterator, but try again 2231 done = false; 2232 break; 2233 } 2234 } 2235 } 2236 2237 #ifdef L2CAP_USES_CHANNELS 2238 2239 static int l2cap_send_open_failed_on_hci_disconnect(l2cap_channel_t * channel){ 2240 // open cannot fail for for incoming connections 2241 if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_INCOMING) return 0; 2242 2243 // check state 2244 switch (channel->state){ 2245 case L2CAP_STATE_WILL_SEND_CREATE_CONNECTION: 2246 case L2CAP_STATE_WAIT_CONNECTION_COMPLETE: 2247 case L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES: 2248 case L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE: 2249 case L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT: 2250 case L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES: 2251 case L2CAP_STATE_WAIT_CONNECT_RSP: 2252 case L2CAP_STATE_CONFIG: 2253 case L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST: 2254 case L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST: 2255 case L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE: 2256 case L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD: 2257 return 1; 2258 2259 case L2CAP_STATE_OPEN: 2260 case L2CAP_STATE_CLOSED: 2261 case L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES: 2262 case L2CAP_STATE_WAIT_DISCONNECT: 2263 case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_INSUFFICIENT_SECURITY: 2264 case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE: 2265 case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT: 2266 case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST: 2267 case L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE: 2268 case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE: 2269 case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT: 2270 case L2CAP_STATE_INVALID: 2271 case L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE: 2272 return 0; 2273 2274 default: 2275 // get a "warning" about new states 2276 btstack_assert(false); 2277 return 0; 2278 } 2279 } 2280 #endif 2281 2282 #ifdef ENABLE_CLASSIC 2283 static void l2cap_handle_hci_disconnect_event(l2cap_channel_t * channel){ 2284 if (l2cap_send_open_failed_on_hci_disconnect(channel)){ 2285 l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_BASEBAND_DISCONNECT); 2286 } else { 2287 l2cap_handle_channel_closed(channel); 2288 } 2289 l2cap_free_channel_entry(channel); 2290 } 2291 #endif 2292 2293 #ifdef ENABLE_LE_DATA_CHANNELS 2294 static void l2cap_handle_hci_le_disconnect_event(l2cap_channel_t * channel){ 2295 if (l2cap_send_open_failed_on_hci_disconnect(channel)){ 2296 l2cap_emit_le_channel_opened(channel, L2CAP_CONNECTION_BASEBAND_DISCONNECT); 2297 } else { 2298 l2cap_emit_le_channel_closed(channel); 2299 } 2300 l2cap_free_channel_entry(channel); 2301 } 2302 #endif 2303 2304 #ifdef ENABLE_CLASSIC 2305 static void l2cap_check_classic_timeout(hci_con_handle_t handle){ 2306 if (gap_get_connection_type(handle) != GAP_CONNECTION_ACL) { 2307 return; 2308 } 2309 if (hci_authentication_active_for_handle(handle)) { 2310 return; 2311 } 2312 bool hci_con_used = false; 2313 btstack_linked_list_iterator_t it; 2314 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2315 while (btstack_linked_list_iterator_has_next(&it)){ 2316 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2317 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2318 if (channel->con_handle != handle) continue; 2319 hci_con_used = true; 2320 break; 2321 } 2322 if (hci_con_used) { 2323 return; 2324 } 2325 if (!hci_can_send_command_packet_now()) { 2326 return; 2327 } 2328 hci_send_cmd(&hci_disconnect, handle, 0x13); // remote closed connection 2329 } 2330 static void l2cap_handle_features_complete(hci_con_handle_t handle){ 2331 hci_connection_t * hci_connection = hci_connection_for_handle(handle); 2332 if (hci_connection == NULL) { 2333 return; 2334 }; 2335 if ((hci_connection->bonding_flags & BONDING_RECEIVED_REMOTE_FEATURES) == 0) { 2336 return; 2337 } 2338 btstack_linked_list_iterator_t it; 2339 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2340 while (btstack_linked_list_iterator_has_next(&it)){ 2341 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2342 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2343 if (channel->con_handle != handle) continue; 2344 log_info("remote supported features, channel %p, cid %04x - state %u", channel, channel->local_cid, channel->state); 2345 l2cap_handle_remote_supported_features_received(channel); 2346 } 2347 } 2348 static void l2cap_handle_security_level(hci_con_handle_t handle, gap_security_level_t actual_level){ 2349 log_info("l2cap - security level update for handle 0x%04x", handle); 2350 btstack_linked_list_iterator_t it; 2351 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2352 while (btstack_linked_list_iterator_has_next(&it)){ 2353 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2354 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2355 if (channel->con_handle != handle) continue; 2356 2357 gap_security_level_t required_level = channel->required_security_level; 2358 2359 log_info("channel %p, cid %04x - state %u: actual %u >= required %u?", channel, channel->local_cid, channel->state, actual_level, required_level); 2360 2361 switch (channel->state){ 2362 case L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE: 2363 if (actual_level >= required_level){ 2364 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2365 // we need to know if ERTM is supported before sending a config response 2366 hci_connection_t * connection = hci_connection_for_handle(channel->con_handle); 2367 if (connection->l2cap_state.information_state != L2CAP_INFORMATION_STATE_DONE){ 2368 connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST; 2369 channel->state = L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES; 2370 break; 2371 } 2372 #endif 2373 channel->state = L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT; 2374 l2cap_emit_incoming_connection(channel); 2375 } else { 2376 channel->reason = 0x0003; // security block 2377 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE; 2378 } 2379 break; 2380 2381 case L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE: 2382 if (actual_level >= required_level){ 2383 l2cap_ready_to_connect(channel); 2384 } else { 2385 // disconnnect, authentication not good enough 2386 hci_disconnect_security_block(handle); 2387 } 2388 break; 2389 2390 default: 2391 break; 2392 } 2393 } 2394 } 2395 #endif 2396 2397 #ifdef L2CAP_USES_CHANNELS 2398 static void l2cap_handle_disconnection_complete(hci_con_handle_t handle){ 2399 // collect channels to close 2400 btstack_linked_list_t channels_to_close = NULL; 2401 btstack_linked_list_iterator_t it; 2402 btstack_linked_list_iterator_init(&it, &l2cap_channels); 2403 while (btstack_linked_list_iterator_has_next(&it)) { 2404 l2cap_channel_t *channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2405 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 2406 if (channel->con_handle != handle) continue; 2407 btstack_linked_list_iterator_remove(&it); 2408 btstack_linked_list_add(&channels_to_close, (btstack_linked_item_t *) channel); 2409 } 2410 // send l2cap open failed or closed events for all channels on this handle and free them 2411 btstack_linked_list_iterator_init(&it, &channels_to_close); 2412 while (btstack_linked_list_iterator_has_next(&it)) { 2413 l2cap_channel_t *channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 2414 btstack_linked_list_iterator_remove(&it); 2415 switch(channel->channel_type){ 2416 #ifdef ENABLE_CLASSIC 2417 case L2CAP_CHANNEL_TYPE_CLASSIC: 2418 l2cap_handle_hci_disconnect_event(channel); 2419 break; 2420 #endif 2421 #ifdef ENABLE_LE_DATA_CHANNELS 2422 case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL: 2423 l2cap_handle_hci_le_disconnect_event(channel); 2424 break; 2425 #endif 2426 default: 2427 break; 2428 } 2429 } 2430 } 2431 #endif 2432 2433 static void l2cap_hci_event_handler(uint8_t packet_type, uint16_t cid, uint8_t *packet, uint16_t size){ 2434 2435 UNUSED(packet_type); // ok: registered with hci_event_callback_registration 2436 UNUSED(cid); // ok: there is no channel 2437 UNUSED(size); // ok: fixed format events read from HCI buffer 2438 2439 #ifdef ENABLE_CLASSIC 2440 bd_addr_t address; 2441 gap_security_level_t security_level; 2442 #endif 2443 #ifdef L2CAP_USES_CHANNELS 2444 hci_con_handle_t handle; 2445 #endif 2446 2447 switch(hci_event_packet_get_type(packet)){ 2448 2449 // Notify channel packet handler if they can send now 2450 case HCI_EVENT_TRANSPORT_PACKET_SENT: 2451 case HCI_EVENT_NUMBER_OF_COMPLETED_PACKETS: 2452 case BTSTACK_EVENT_NR_CONNECTIONS_CHANGED: 2453 l2cap_run(); // try sending signaling packets first 2454 l2cap_notify_channel_can_send(); 2455 break; 2456 2457 case HCI_EVENT_COMMAND_STATUS: 2458 #ifdef ENABLE_CLASSIC 2459 // check command status for create connection for errors 2460 if (HCI_EVENT_IS_COMMAND_STATUS(packet, hci_create_connection)){ 2461 // cache outgoing address and reset 2462 (void)memcpy(address, l2cap_outgoing_classic_addr, 6); 2463 memset(l2cap_outgoing_classic_addr, 0, 6); 2464 // error => outgoing connection failed 2465 uint8_t status = hci_event_command_status_get_status(packet); 2466 if (status){ 2467 l2cap_handle_connection_failed_for_addr(address, status); 2468 } 2469 } 2470 #endif 2471 l2cap_run(); // try sending signaling packets first 2472 break; 2473 2474 #ifdef ENABLE_CLASSIC 2475 // handle connection complete events 2476 case HCI_EVENT_CONNECTION_COMPLETE: 2477 reverse_bd_addr(&packet[5], address); 2478 if (packet[2] == 0){ 2479 handle = little_endian_read_16(packet, 3); 2480 l2cap_handle_connection_success_for_addr(address, handle); 2481 } else { 2482 l2cap_handle_connection_failed_for_addr(address, packet[2]); 2483 } 2484 break; 2485 2486 // handle successful create connection cancel command 2487 case HCI_EVENT_COMMAND_COMPLETE: 2488 if (HCI_EVENT_IS_COMMAND_COMPLETE(packet, hci_create_connection_cancel)) { 2489 if (packet[5] == 0){ 2490 reverse_bd_addr(&packet[6], address); 2491 // CONNECTION TERMINATED BY LOCAL HOST (0X16) 2492 l2cap_handle_connection_failed_for_addr(address, 0x16); 2493 } 2494 } 2495 l2cap_run(); // try sending signaling packets first 2496 break; 2497 #endif 2498 2499 #ifdef L2CAP_USES_CHANNELS 2500 // handle disconnection complete events 2501 case HCI_EVENT_DISCONNECTION_COMPLETE: 2502 handle = little_endian_read_16(packet, 3); 2503 l2cap_handle_disconnection_complete(handle); 2504 break; 2505 #endif 2506 2507 // HCI Connection Timeouts 2508 #ifdef ENABLE_CLASSIC 2509 case L2CAP_EVENT_TIMEOUT_CHECK: 2510 handle = little_endian_read_16(packet, 2); 2511 l2cap_check_classic_timeout(handle); 2512 break; 2513 2514 case HCI_EVENT_READ_REMOTE_SUPPORTED_FEATURES_COMPLETE: 2515 case HCI_EVENT_READ_REMOTE_EXTENDED_FEATURES_COMPLETE: 2516 handle = little_endian_read_16(packet, 3); 2517 l2cap_handle_features_complete(handle); 2518 break; 2519 2520 case GAP_EVENT_SECURITY_LEVEL: 2521 handle = little_endian_read_16(packet, 2); 2522 security_level = (gap_security_level_t) packet[4]; 2523 l2cap_handle_security_level(handle, security_level); 2524 break; 2525 #endif 2526 default: 2527 break; 2528 } 2529 2530 l2cap_run(); 2531 } 2532 2533 static void l2cap_register_signaling_response(hci_con_handle_t handle, uint8_t code, uint8_t sig_id, uint16_t cid, uint16_t data){ 2534 // Vol 3, Part A, 4.3: "The DCID and SCID fields shall be ignored when the result field indi- cates the connection was refused." 2535 if (signaling_responses_pending < NR_PENDING_SIGNALING_RESPONSES) { 2536 signaling_responses[signaling_responses_pending].handle = handle; 2537 signaling_responses[signaling_responses_pending].code = code; 2538 signaling_responses[signaling_responses_pending].sig_id = sig_id; 2539 signaling_responses[signaling_responses_pending].cid = cid; 2540 signaling_responses[signaling_responses_pending].data = data; 2541 signaling_responses_pending++; 2542 l2cap_run(); 2543 } 2544 } 2545 2546 #ifdef ENABLE_CLASSIC 2547 static void l2cap_handle_disconnect_request(l2cap_channel_t *channel, uint16_t identifier){ 2548 switch (channel->state){ 2549 case L2CAP_STATE_CONFIG: 2550 case L2CAP_STATE_OPEN: 2551 case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST: 2552 case L2CAP_STATE_WAIT_DISCONNECT: 2553 break; 2554 default: 2555 // ignore in other states 2556 return; 2557 } 2558 2559 channel->remote_sig_id = identifier; 2560 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE; 2561 l2cap_run(); 2562 } 2563 2564 static void l2cap_handle_connection_request(hci_con_handle_t handle, uint8_t sig_id, uint16_t psm, uint16_t source_cid){ 2565 2566 // log_info("l2cap_handle_connection_request for handle %u, psm %u cid 0x%02x", handle, psm, source_cid); 2567 l2cap_service_t *service = l2cap_get_service(psm); 2568 if (!service) { 2569 // 0x0002 PSM not supported 2570 l2cap_register_signaling_response(handle, CONNECTION_REQUEST, sig_id, source_cid, 0x0002); 2571 return; 2572 } 2573 2574 hci_connection_t * hci_connection = hci_connection_for_handle( handle ); 2575 if (!hci_connection) { 2576 // 2577 log_error("no hci_connection for handle %u", handle); 2578 return; 2579 } 2580 2581 // Core V5.2, Vol 3, Part C, 5.2.2.2 - Security Mode 4 2582 // When a remote device attempts to access a service offered by a Bluetooth device that is in security mode 4 2583 // and a sufficient link key exists and authentication has not been performed the local device shall authenticate 2584 // the remote device and enable encryption after the channel establishment request is received but before a channel 2585 // establishment confirmation (L2CAP_ConnectRsp with result code of 0x0000 or a higher-level channel establishment 2586 // confirmation such as that of RFCOMM) is sent. 2587 2588 // If the remote device has indicated support for Secure Simple Pairing, a channel establishment request is 2589 // received for a service other than SDP, and encryption has not yet been enabled, then the local device shall 2590 // disconnect the ACL link with error code 0x05 - Authentication Failure. 2591 2592 // => Disconnect if l2cap request received in mode 4 and ssp supported, non-sdp psm, not encrypted, no link key available 2593 if ((gap_get_security_mode() == GAP_SECURITY_MODE_4) 2594 && gap_ssp_supported_on_both_sides(handle) 2595 && (psm != PSM_SDP) 2596 && (gap_encryption_key_size(handle) == 0) 2597 && (gap_bonded(handle) == false)){ 2598 hci_disconnect_security_block(handle); 2599 return; 2600 } 2601 2602 // alloc structure 2603 gap_security_level_t required_level = service->required_security_level; 2604 if (gap_get_secure_connections_only_mode() && (required_level != LEVEL_0)){ 2605 required_level = LEVEL_4; 2606 } 2607 l2cap_channel_t * channel = l2cap_create_channel_entry(service->packet_handler, L2CAP_CHANNEL_TYPE_CLASSIC, hci_connection->address, BD_ADDR_TYPE_ACL, 2608 psm, service->mtu, required_level); 2609 if (!channel){ 2610 // 0x0004 No resources available 2611 l2cap_register_signaling_response(handle, CONNECTION_REQUEST, sig_id, source_cid, 0x0004); 2612 return; 2613 } 2614 2615 channel->con_handle = handle; 2616 channel->remote_cid = source_cid; 2617 channel->remote_sig_id = sig_id; 2618 2619 // limit local mtu to max acl packet length - l2cap header 2620 if (channel->local_mtu > l2cap_max_mtu()) { 2621 channel->local_mtu = l2cap_max_mtu(); 2622 } 2623 2624 // set initial state 2625 channel->state = L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE; 2626 channel->state_var = (L2CAP_CHANNEL_STATE_VAR) (L2CAP_CHANNEL_STATE_VAR_SEND_CONN_RESP_PEND | L2CAP_CHANNEL_STATE_VAR_INCOMING); 2627 2628 // add to connections list 2629 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel); 2630 2631 // assert security requirements 2632 gap_request_security_level(handle, channel->required_security_level); 2633 } 2634 2635 void l2cap_accept_connection(uint16_t local_cid){ 2636 log_info("L2CAP_ACCEPT_CONNECTION local_cid 0x%x", local_cid); 2637 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 2638 if (!channel) { 2639 log_error("l2cap_accept_connection called but local_cid 0x%x not found", local_cid); 2640 return; 2641 } 2642 2643 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2644 // configure L2CAP Basic mode 2645 channel->mode = L2CAP_CHANNEL_MODE_BASIC; 2646 #endif 2647 2648 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT; 2649 2650 // process 2651 l2cap_run(); 2652 } 2653 2654 void l2cap_decline_connection(uint16_t local_cid){ 2655 log_info("L2CAP_DECLINE_CONNECTION local_cid 0x%x", local_cid); 2656 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid( local_cid); 2657 if (!channel) { 2658 log_error( "l2cap_decline_connection called but local_cid 0x%x not found", local_cid); 2659 return; 2660 } 2661 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE; 2662 channel->reason = 0x04; // no resources available 2663 l2cap_run(); 2664 } 2665 2666 // @pre command len is valid, see check in l2cap_signaling_handler_channel 2667 static void l2cap_signaling_handle_configure_request(l2cap_channel_t *channel, uint8_t *command){ 2668 2669 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2670 uint8_t use_fcs = 1; 2671 #endif 2672 2673 channel->remote_sig_id = command[L2CAP_SIGNALING_COMMAND_SIGID_OFFSET]; 2674 2675 uint16_t flags = little_endian_read_16(command, 6); 2676 if (flags & 1) { 2677 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT); 2678 } 2679 2680 // accept the other's configuration options 2681 uint16_t end_pos = 4 + little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET); 2682 uint16_t pos = 8; 2683 while (pos < end_pos){ 2684 uint8_t option_hint = command[pos] >> 7; 2685 uint8_t option_type = command[pos] & 0x7f; 2686 // log_info("l2cap cid %u, hint %u, type %u", channel->local_cid, option_hint, option_type); 2687 pos++; 2688 uint8_t length = command[pos++]; 2689 // MTU { type(8): 1, len(8):2, MTU(16) } 2690 if ((option_type == L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT) && (length == 2)){ 2691 channel->remote_mtu = little_endian_read_16(command, pos); 2692 log_info("Remote MTU %u", channel->remote_mtu); 2693 if (channel->remote_mtu > l2cap_max_mtu()){ 2694 log_info("Remote MTU %u larger than outgoing buffer, only using MTU = %u", channel->remote_mtu, l2cap_max_mtu()); 2695 channel->remote_mtu = l2cap_max_mtu(); 2696 } 2697 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_MTU); 2698 } 2699 // Flush timeout { type(8):2, len(8): 2, Flush Timeout(16)} 2700 if ((option_type == L2CAP_CONFIG_OPTION_TYPE_FLUSH_TIMEOUT) && (length == 2)){ 2701 channel->flush_timeout = little_endian_read_16(command, pos); 2702 log_info("Flush timeout: %u ms", channel->flush_timeout); 2703 } 2704 2705 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2706 // Retransmission and Flow Control Option 2707 if (option_type == L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL && length == 9){ 2708 l2cap_channel_mode_t mode = (l2cap_channel_mode_t) command[pos]; 2709 switch(channel->mode){ 2710 case L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION: 2711 // Store remote config 2712 channel->remote_tx_window_size = command[pos+1]; 2713 channel->remote_max_transmit = command[pos+2]; 2714 channel->remote_retransmission_timeout_ms = little_endian_read_16(command, pos + 3); 2715 channel->remote_monitor_timeout_ms = little_endian_read_16(command, pos + 5); 2716 channel->remote_mps = little_endian_read_16(command, pos + 7); 2717 log_info("FC&C config: tx window: %u, max transmit %u, retrans timeout %u, monitor timeout %u, mps %u", 2718 channel->remote_tx_window_size, 2719 channel->remote_max_transmit, 2720 channel->remote_retransmission_timeout_ms, 2721 channel->remote_monitor_timeout_ms, 2722 channel->remote_mps); 2723 // If ERTM mandatory, but remote doens't offer ERTM -> disconnect 2724 if (channel->ertm_mandatory && mode != L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 2725 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 2726 } else { 2727 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM); 2728 } 2729 break; 2730 case L2CAP_CHANNEL_MODE_BASIC: 2731 switch (mode){ 2732 case L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION: 2733 // remote asks for ERTM, but we want basic mode. disconnect if this happens a second time 2734 if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_BASIC_FALLBACK_TRIED){ 2735 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 2736 } 2737 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_BASIC_FALLBACK_TRIED); 2738 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_REJECTED); 2739 break; 2740 default: // case L2CAP_CHANNEL_MODE_BASIC: 2741 // TODO store and evaluate configuration 2742 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM); 2743 break; 2744 } 2745 break; 2746 default: 2747 break; 2748 } 2749 } 2750 if (option_type == L2CAP_CONFIG_OPTION_TYPE_FRAME_CHECK_SEQUENCE && length == 1){ 2751 use_fcs = command[pos]; 2752 } 2753 #endif 2754 // check for unknown options 2755 if ((option_hint == 0) && ((option_type < L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT) || (option_type > L2CAP_CONFIG_OPTION_TYPE_EXTENDED_WINDOW_SIZE))){ 2756 log_info("l2cap cid %u, unknown option 0x%02x", channel->local_cid, option_type); 2757 channel->unknown_option = option_type; 2758 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_INVALID); 2759 } 2760 pos += length; 2761 } 2762 2763 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2764 // "FCS" has precedence over "No FCS" 2765 uint8_t update = channel->fcs_option || use_fcs; 2766 log_info("local fcs: %u, remote fcs: %u -> %u", channel->fcs_option, use_fcs, update); 2767 channel->fcs_option = update; 2768 // If ERTM mandatory, but remote didn't send Retransmission and Flowcontrol options -> disconnect 2769 if (((channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM) == 0) & (channel->ertm_mandatory)){ 2770 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 2771 } 2772 #endif 2773 } 2774 2775 // @pre command len is valid, see check in l2cap_signaling_handler_channel 2776 static void l2cap_signaling_handle_configure_response(l2cap_channel_t *channel, uint8_t result, uint8_t *command){ 2777 log_info("l2cap_signaling_handle_configure_response"); 2778 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2779 uint16_t end_pos = 4 + little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET); 2780 uint16_t pos = 10; 2781 while (pos < end_pos){ 2782 uint8_t option_hint = command[pos] >> 7; 2783 uint8_t option_type = command[pos] & 0x7f; 2784 // log_info("l2cap cid %u, hint %u, type %u", channel->local_cid, option_hint, option_type); 2785 pos++; 2786 uint8_t length = command[pos++]; 2787 2788 // Retransmission and Flow Control Option 2789 if (option_type == L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL && length == 9){ 2790 switch (channel->mode){ 2791 case L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION: 2792 if (channel->ertm_mandatory){ 2793 // ?? 2794 } else { 2795 // On 'Reject - Unacceptable Parameters' to our optional ERTM request, fall back to BASIC mode 2796 if (result == L2CAP_CONF_RESULT_UNACCEPTABLE_PARAMETERS){ 2797 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED); 2798 channel->mode = L2CAP_CHANNEL_MODE_BASIC; 2799 } 2800 } 2801 break; 2802 case L2CAP_CHANNEL_MODE_BASIC: 2803 if (result == L2CAP_CONF_RESULT_UNACCEPTABLE_PARAMETERS){ 2804 // On 'Reject - Unacceptable Parameters' to our Basic mode request, disconnect 2805 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 2806 } 2807 break; 2808 default: 2809 break; 2810 } 2811 } 2812 2813 // check for unknown options 2814 if (option_hint == 0 && (option_type < L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT || option_type > L2CAP_CONFIG_OPTION_TYPE_EXTENDED_WINDOW_SIZE)){ 2815 log_info("l2cap cid %u, unknown option 0x%02x", channel->local_cid, option_type); 2816 channel->unknown_option = option_type; 2817 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_INVALID); 2818 } 2819 2820 pos += length; 2821 } 2822 #else 2823 UNUSED(channel); // ok: no code 2824 UNUSED(result); // ok: no code 2825 UNUSED(command); // ok: no code 2826 #endif 2827 } 2828 2829 static int l2cap_channel_ready_for_open(l2cap_channel_t *channel){ 2830 // log_info("l2cap_channel_ready_for_open 0x%02x", channel->state_var); 2831 if ((channel->state_var & L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_RSP) == 0) return 0; 2832 if ((channel->state_var & L2CAP_CHANNEL_STATE_VAR_SENT_CONF_RSP) == 0) return 0; 2833 // addition check that fixes re-entrance issue causing l2cap event channel opened twice 2834 if (channel->state == L2CAP_STATE_OPEN) return 0; 2835 return 1; 2836 } 2837 2838 2839 // @pre command len is valid, see check in l2cap_signaling_handler_dispatch 2840 static void l2cap_signaling_handler_channel(l2cap_channel_t *channel, uint8_t *command){ 2841 2842 uint8_t code = command[L2CAP_SIGNALING_COMMAND_CODE_OFFSET]; 2843 uint8_t identifier = command[L2CAP_SIGNALING_COMMAND_SIGID_OFFSET]; 2844 uint16_t cmd_len = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET); 2845 uint16_t result = 0; 2846 2847 log_info("L2CAP signaling handler code %u, state %u", code, channel->state); 2848 2849 // handle DISCONNECT REQUESTS seperately 2850 if (code == DISCONNECTION_REQUEST){ 2851 l2cap_handle_disconnect_request(channel, identifier); 2852 return; 2853 } 2854 2855 // @STATEMACHINE(l2cap) 2856 switch (channel->state) { 2857 2858 case L2CAP_STATE_WAIT_CONNECT_RSP: 2859 switch (code){ 2860 case CONNECTION_RESPONSE: 2861 if (cmd_len < 8){ 2862 // command imcomplete 2863 l2cap_register_signaling_response(channel->con_handle, COMMAND_REJECT, identifier, 0, L2CAP_REJ_CMD_UNKNOWN); 2864 break; 2865 } 2866 l2cap_stop_rtx(channel); 2867 result = little_endian_read_16 (command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4); 2868 switch (result) { 2869 case 0: 2870 // successful connection 2871 channel->remote_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET); 2872 channel->state = L2CAP_STATE_CONFIG; 2873 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ); 2874 break; 2875 case 1: 2876 // connection pending. get some coffee, but start the ERTX 2877 l2cap_start_ertx(channel); 2878 break; 2879 default: 2880 // channel closed 2881 channel->state = L2CAP_STATE_CLOSED; 2882 // map l2cap connection response result to BTstack status enumeration 2883 l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_SUCCESSFUL + result); 2884 2885 // drop link key if security block 2886 if ((L2CAP_CONNECTION_RESPONSE_RESULT_SUCCESSFUL + result) == L2CAP_CONNECTION_RESPONSE_RESULT_REFUSED_SECURITY){ 2887 gap_drop_link_key_for_bd_addr(channel->address); 2888 } 2889 2890 // discard channel 2891 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 2892 l2cap_free_channel_entry(channel); 2893 break; 2894 } 2895 break; 2896 2897 default: 2898 //@TODO: implement other signaling packets 2899 break; 2900 } 2901 break; 2902 2903 case L2CAP_STATE_CONFIG: 2904 switch (code) { 2905 case CONFIGURE_REQUEST: 2906 if (cmd_len < 4){ 2907 // command incomplete 2908 l2cap_register_signaling_response(channel->con_handle, COMMAND_REJECT, identifier, 0, L2CAP_REJ_CMD_UNKNOWN); 2909 break; 2910 } 2911 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP); 2912 l2cap_signaling_handle_configure_request(channel, command); 2913 if (!(channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT)){ 2914 // only done if continuation not set 2915 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_REQ); 2916 } 2917 break; 2918 case CONFIGURE_RESPONSE: 2919 if (cmd_len < 6){ 2920 // command incomplete 2921 l2cap_register_signaling_response(channel->con_handle, COMMAND_REJECT, identifier, 0, L2CAP_REJ_CMD_UNKNOWN); 2922 break; 2923 } 2924 result = little_endian_read_16 (command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4); 2925 l2cap_stop_rtx(channel); 2926 l2cap_signaling_handle_configure_response(channel, result, command); 2927 switch (result){ 2928 case 0: // success 2929 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_RSP); 2930 break; 2931 case 4: // pending 2932 l2cap_start_ertx(channel); 2933 break; 2934 default: 2935 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2936 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION && channel->ertm_mandatory){ 2937 // remote does not offer ertm but it's required 2938 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 2939 break; 2940 } 2941 #endif 2942 // retry on negative result 2943 channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ); 2944 break; 2945 } 2946 break; 2947 default: 2948 break; 2949 } 2950 if (l2cap_channel_ready_for_open(channel)){ 2951 2952 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 2953 // assert that packet can be stored in fragment buffers in ertm 2954 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 2955 uint16_t effective_mps = btstack_min(channel->remote_mps, channel->local_mps); 2956 uint16_t usable_mtu = channel->num_tx_buffers == 1 ? effective_mps : channel->num_tx_buffers * effective_mps - 2; 2957 if (usable_mtu < channel->remote_mtu){ 2958 log_info("Remote MTU %u > max storable ERTM packet, only using MTU = %u", channel->remote_mtu, usable_mtu); 2959 channel->remote_mtu = usable_mtu; 2960 } 2961 } 2962 #endif 2963 // for open: 2964 channel->state = L2CAP_STATE_OPEN; 2965 l2cap_emit_channel_opened(channel, 0); 2966 } 2967 break; 2968 2969 case L2CAP_STATE_WAIT_DISCONNECT: 2970 switch (code) { 2971 case DISCONNECTION_RESPONSE: 2972 l2cap_finialize_channel_close(channel); 2973 break; 2974 default: 2975 //@TODO: implement other signaling packets 2976 break; 2977 } 2978 break; 2979 2980 case L2CAP_STATE_CLOSED: 2981 // @TODO handle incoming requests 2982 break; 2983 2984 case L2CAP_STATE_OPEN: 2985 //@TODO: implement other signaling packets, e.g. re-configure 2986 break; 2987 default: 2988 break; 2989 } 2990 // log_info("new state %u", channel->state); 2991 } 2992 2993 2994 // @pre command len is valid, see check in l2cap_acl_classic_handler 2995 static void l2cap_signaling_handler_dispatch(hci_con_handle_t handle, uint8_t * command){ 2996 2997 btstack_linked_list_iterator_t it; 2998 2999 // get code, signalind identifier and command len 3000 uint8_t code = command[L2CAP_SIGNALING_COMMAND_CODE_OFFSET]; 3001 uint8_t sig_id = command[L2CAP_SIGNALING_COMMAND_SIGID_OFFSET]; 3002 uint16_t cmd_len = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET); 3003 3004 // not for a particular channel, and not CONNECTION_REQUEST, ECHO_[REQUEST|RESPONSE], INFORMATION_RESPONSE 3005 if ((code < 1) || (code == ECHO_RESPONSE) || (code > INFORMATION_RESPONSE)){ 3006 l2cap_register_signaling_response(handle, COMMAND_REJECT, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN); 3007 return; 3008 } 3009 3010 // general commands without an assigned channel 3011 switch(code) { 3012 3013 case CONNECTION_REQUEST: 3014 if (cmd_len == 4){ 3015 uint16_t psm = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET); 3016 uint16_t source_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+2); 3017 l2cap_handle_connection_request(handle, sig_id, psm, source_cid); 3018 } else { 3019 l2cap_register_signaling_response(handle, COMMAND_REJECT, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN); 3020 } 3021 return; 3022 3023 case ECHO_REQUEST: 3024 l2cap_register_signaling_response(handle, code, sig_id, 0, 0); 3025 return; 3026 3027 case INFORMATION_REQUEST: 3028 if (cmd_len == 2) { 3029 uint16_t info_type = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET); 3030 l2cap_register_signaling_response(handle, code, sig_id, 0, info_type); 3031 } else { 3032 l2cap_register_signaling_response(handle, COMMAND_REJECT, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN); 3033 } 3034 return; 3035 3036 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 3037 case INFORMATION_RESPONSE: { 3038 hci_connection_t * connection = hci_connection_for_handle(handle); 3039 if (!connection) return; 3040 if (connection->l2cap_state.information_state != L2CAP_INFORMATION_STATE_W4_EXTENDED_FEATURE_RESPONSE) return; 3041 3042 // get extended features from response if valid 3043 connection->l2cap_state.extended_feature_mask = 0; 3044 if (cmd_len >= 6) { 3045 uint16_t info_type = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET); 3046 uint16_t result = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+2); 3047 if (result == 0 && info_type == L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED) { 3048 connection->l2cap_state.extended_feature_mask = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4); 3049 } 3050 } 3051 connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_DONE; 3052 log_info("extended features mask 0x%02x", connection->l2cap_state.extended_feature_mask); 3053 3054 // trigger connection request 3055 btstack_linked_list_iterator_init(&it, &l2cap_channels); 3056 while (btstack_linked_list_iterator_has_next(&it)){ 3057 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 3058 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 3059 if (channel->con_handle != handle) continue; 3060 3061 // incoming connection: ask user for channel configuration, esp. if ertm will be mandatory 3062 if (channel->state == L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES){ 3063 channel->state = L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT; 3064 l2cap_emit_incoming_connection(channel); 3065 continue; 3066 } 3067 3068 // outgoing connection 3069 if (channel->state == L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES){ 3070 3071 // if ERTM was requested, but is not listed in extended feature mask: 3072 if ((channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) && ((connection->l2cap_state.extended_feature_mask & 0x08) == 0)){ 3073 3074 if (channel->ertm_mandatory){ 3075 // bail if ERTM is mandatory 3076 channel->state = L2CAP_STATE_CLOSED; 3077 // map l2cap connection response result to BTstack status enumeration 3078 l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_ERTM_NOT_SUPPORTED); 3079 // discard channel 3080 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 3081 l2cap_free_channel_entry(channel); 3082 continue; 3083 3084 } else { 3085 // fallback to Basic mode 3086 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED); 3087 channel->mode = L2CAP_CHANNEL_MODE_BASIC; 3088 } 3089 } 3090 3091 // respond to connection request 3092 channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST; 3093 continue; 3094 } 3095 } 3096 return; 3097 } 3098 #endif 3099 3100 default: 3101 break; 3102 } 3103 3104 // Get potential destination CID 3105 uint16_t dest_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET); 3106 3107 // Find channel for this sig_id and connection handle 3108 btstack_linked_list_iterator_init(&it, &l2cap_channels); 3109 while (btstack_linked_list_iterator_has_next(&it)){ 3110 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 3111 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 3112 if (channel->con_handle != handle) continue; 3113 if (code & 1) { 3114 // match odd commands (responses) by previous signaling identifier 3115 if (channel->local_sig_id == sig_id) { 3116 l2cap_signaling_handler_channel(channel, command); 3117 break; 3118 } 3119 } else { 3120 // match even commands (requests) by local channel id 3121 if (channel->local_cid == dest_cid) { 3122 l2cap_signaling_handler_channel(channel, command); 3123 break; 3124 } 3125 } 3126 } 3127 } 3128 #endif 3129 3130 #ifdef ENABLE_BLE 3131 3132 static void l2cap_emit_connection_parameter_update_response(hci_con_handle_t con_handle, uint16_t result){ 3133 uint8_t event[6]; 3134 event[0] = L2CAP_EVENT_CONNECTION_PARAMETER_UPDATE_RESPONSE; 3135 event[1] = 4; 3136 little_endian_store_16(event, 2, con_handle); 3137 little_endian_store_16(event, 4, result); 3138 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 3139 if (!l2cap_event_packet_handler) return; 3140 (*l2cap_event_packet_handler)(HCI_EVENT_PACKET, 0, event, sizeof(event)); 3141 } 3142 3143 // @returns valid 3144 static int l2cap_le_signaling_handler_dispatch(hci_con_handle_t handle, uint8_t * command, uint8_t sig_id){ 3145 hci_connection_t * connection; 3146 uint16_t result; 3147 uint8_t event[12]; 3148 3149 #ifdef ENABLE_LE_DATA_CHANNELS 3150 btstack_linked_list_iterator_t it; 3151 l2cap_channel_t * channel; 3152 uint16_t local_cid; 3153 uint16_t le_psm; 3154 uint16_t new_credits; 3155 uint16_t credits_before; 3156 l2cap_service_t * service; 3157 uint16_t source_cid; 3158 #endif 3159 3160 uint8_t code = command[L2CAP_SIGNALING_COMMAND_CODE_OFFSET]; 3161 uint16_t len = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET); 3162 log_info("l2cap_le_signaling_handler_dispatch: command 0x%02x, sig id %u, len %u", code, sig_id, len); 3163 3164 switch (code){ 3165 3166 case CONNECTION_PARAMETER_UPDATE_REQUEST: 3167 // check size 3168 if (len < 8u) return 0u; 3169 connection = hci_connection_for_handle(handle); 3170 if (connection != NULL){ 3171 if (connection->role != HCI_ROLE_MASTER){ 3172 // reject command without notifying upper layer when not in master role 3173 return 0; 3174 } 3175 le_connection_parameter_range_t existing_range; 3176 gap_get_connection_parameter_range(&existing_range); 3177 uint16_t le_conn_interval_min = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET); 3178 uint16_t le_conn_interval_max = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET+2); 3179 uint16_t le_conn_latency = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4); 3180 uint16_t le_supervision_timeout = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET+6); 3181 3182 int update_parameter = gap_connection_parameter_range_included(&existing_range, le_conn_interval_min, le_conn_interval_max, le_conn_latency, le_supervision_timeout); 3183 if (update_parameter){ 3184 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_SEND_RESPONSE; 3185 connection->le_conn_interval_min = le_conn_interval_min; 3186 connection->le_conn_interval_max = le_conn_interval_max; 3187 connection->le_conn_latency = le_conn_latency; 3188 connection->le_supervision_timeout = le_supervision_timeout; 3189 } else { 3190 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_DENY; 3191 } 3192 connection->le_con_param_update_identifier = sig_id; 3193 } 3194 3195 if (!l2cap_event_packet_handler) break; 3196 3197 event[0] = L2CAP_EVENT_CONNECTION_PARAMETER_UPDATE_REQUEST; 3198 event[1] = 8; 3199 little_endian_store_16(event, 2, handle); 3200 (void)memcpy(&event[4], &command[4], 8); 3201 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 3202 (*l2cap_event_packet_handler)( HCI_EVENT_PACKET, 0, event, sizeof(event)); 3203 break; 3204 3205 case CONNECTION_PARAMETER_UPDATE_RESPONSE: 3206 // check size 3207 if (len < 2u) return 0u; 3208 result = little_endian_read_16(command, 4); 3209 l2cap_emit_connection_parameter_update_response(handle, result); 3210 break; 3211 3212 #ifdef ENABLE_LE_DATA_CHANNELS 3213 3214 case COMMAND_REJECT: 3215 // Find channel for this sig_id and connection handle 3216 channel = NULL; 3217 btstack_linked_list_iterator_init(&it, &l2cap_channels); 3218 while (btstack_linked_list_iterator_has_next(&it)){ 3219 l2cap_channel_t * a_channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 3220 if (!l2cap_is_dynamic_channel_type(a_channel->channel_type)) continue; 3221 if (a_channel->con_handle != handle) continue; 3222 if (a_channel->local_sig_id != sig_id) continue; 3223 channel = a_channel; 3224 break; 3225 } 3226 if (!channel) break; 3227 3228 // if received while waiting for le connection response, assume legacy device 3229 if (channel->state == L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE){ 3230 channel->state = L2CAP_STATE_CLOSED; 3231 // no official value for this, use: Connection refused – LE_PSM not supported - 0x0002 3232 l2cap_emit_le_channel_opened(channel, 0x0002); 3233 3234 // discard channel 3235 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 3236 l2cap_free_channel_entry(channel); 3237 break; 3238 } 3239 break; 3240 3241 case LE_CREDIT_BASED_CONNECTION_REQUEST: 3242 // check size 3243 if (len < 10u) return 0u; 3244 3245 // get hci connection, bail if not found (must not happen) 3246 connection = hci_connection_for_handle(handle); 3247 if (!connection) return 0; 3248 3249 // check if service registered 3250 le_psm = little_endian_read_16(command, 4); 3251 service = l2cap_le_get_service(le_psm); 3252 source_cid = little_endian_read_16(command, 6); 3253 3254 if (service){ 3255 if (source_cid < 0x40u){ 3256 // 0x0009 Connection refused - Invalid Source CID 3257 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0009); 3258 return 1; 3259 } 3260 3261 // go through list of channels for this ACL connection and check if we get a match 3262 btstack_linked_list_iterator_init(&it, &l2cap_channels); 3263 while (btstack_linked_list_iterator_has_next(&it)){ 3264 l2cap_channel_t * a_channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 3265 if (!l2cap_is_dynamic_channel_type(a_channel->channel_type)) continue; 3266 if (a_channel->con_handle != handle) continue; 3267 if (a_channel->remote_cid != source_cid) continue; 3268 // 0x000a Connection refused - Source CID already allocated 3269 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x000a); 3270 return 1; 3271 } 3272 3273 // security: check encryption 3274 if (service->required_security_level >= LEVEL_2){ 3275 if (gap_encryption_key_size(handle) == 0){ 3276 // 0x0008 Connection refused - insufficient encryption 3277 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0008); 3278 return 1; 3279 } 3280 // anything less than 16 byte key size is insufficient 3281 if (gap_encryption_key_size(handle) < 16){ 3282 // 0x0007 Connection refused – insufficient encryption key size 3283 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0007); 3284 return 1; 3285 } 3286 } 3287 3288 // security: check authencation 3289 if (service->required_security_level >= LEVEL_3){ 3290 if (!gap_authenticated(handle)){ 3291 // 0x0005 Connection refused – insufficient authentication 3292 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0005); 3293 return 1; 3294 } 3295 } 3296 3297 // security: check authorization 3298 if (service->required_security_level >= LEVEL_4){ 3299 if (gap_authorization_state(handle) != AUTHORIZATION_GRANTED){ 3300 // 0x0006 Connection refused – insufficient authorization 3301 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0006); 3302 return 1; 3303 } 3304 } 3305 3306 // allocate channel 3307 channel = l2cap_create_channel_entry(service->packet_handler, L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL, connection->address, 3308 BD_ADDR_TYPE_LE_RANDOM, le_psm, service->mtu, service->required_security_level); 3309 if (!channel){ 3310 // 0x0004 Connection refused – no resources available 3311 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0004); 3312 return 1; 3313 } 3314 3315 channel->con_handle = handle; 3316 channel->remote_cid = source_cid; 3317 channel->remote_sig_id = sig_id; 3318 channel->remote_mtu = little_endian_read_16(command, 8); 3319 channel->remote_mps = little_endian_read_16(command, 10); 3320 channel->credits_outgoing = little_endian_read_16(command, 12); 3321 3322 // set initial state 3323 channel->state = L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT; 3324 channel->state_var |= L2CAP_CHANNEL_STATE_VAR_INCOMING; 3325 3326 // add to connections list 3327 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel); 3328 3329 // post connection request event 3330 l2cap_emit_le_incoming_connection(channel); 3331 3332 } else { 3333 // Connection refused – LE_PSM not supported 3334 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0002); 3335 } 3336 break; 3337 3338 case LE_CREDIT_BASED_CONNECTION_RESPONSE: 3339 // check size 3340 if (len < 10u) return 0u; 3341 3342 // Find channel for this sig_id and connection handle 3343 channel = NULL; 3344 btstack_linked_list_iterator_init(&it, &l2cap_channels); 3345 while (btstack_linked_list_iterator_has_next(&it)){ 3346 l2cap_channel_t * a_channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 3347 if (!l2cap_is_dynamic_channel_type(a_channel->channel_type)) continue; 3348 if (a_channel->con_handle != handle) continue; 3349 if (a_channel->local_sig_id != sig_id) continue; 3350 channel = a_channel; 3351 break; 3352 } 3353 if (!channel) break; 3354 3355 // cid + 0 3356 result = little_endian_read_16 (command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+8); 3357 if (result){ 3358 channel->state = L2CAP_STATE_CLOSED; 3359 // map l2cap connection response result to BTstack status enumeration 3360 l2cap_emit_le_channel_opened(channel, result); 3361 3362 // discard channel 3363 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 3364 l2cap_free_channel_entry(channel); 3365 break; 3366 } 3367 3368 // success 3369 channel->remote_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 0); 3370 channel->remote_mtu = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 2); 3371 channel->remote_mps = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 4); 3372 channel->credits_outgoing = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 6); 3373 channel->state = L2CAP_STATE_OPEN; 3374 l2cap_emit_le_channel_opened(channel, result); 3375 break; 3376 3377 case LE_FLOW_CONTROL_CREDIT: 3378 // check size 3379 if (len < 4u) return 0u; 3380 3381 // find channel 3382 local_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 0); 3383 channel = l2cap_get_channel_for_local_cid_and_handle(local_cid, handle); 3384 if (!channel) { 3385 log_error("l2cap: no channel for cid 0x%02x", local_cid); 3386 break; 3387 } 3388 new_credits = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 2); 3389 credits_before = channel->credits_outgoing; 3390 channel->credits_outgoing += new_credits; 3391 // check for credit overrun 3392 if (credits_before > channel->credits_outgoing){ 3393 log_error("l2cap: new credits caused overrrun for cid 0x%02x, disconnecting", local_cid); 3394 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 3395 break; 3396 } 3397 log_info("l2cap: %u credits for 0x%02x, now %u", new_credits, local_cid, channel->credits_outgoing); 3398 break; 3399 3400 case DISCONNECTION_REQUEST: 3401 3402 // check size 3403 if (len < 4u) return 0u; 3404 3405 // find channel 3406 local_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 0); 3407 channel = l2cap_get_channel_for_local_cid_and_handle(local_cid, handle); 3408 if (!channel) { 3409 log_error("l2cap: no channel for cid 0x%02x", local_cid); 3410 break; 3411 } 3412 channel->remote_sig_id = sig_id; 3413 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE; 3414 break; 3415 3416 #endif 3417 3418 case DISCONNECTION_RESPONSE: 3419 break; 3420 3421 default: 3422 // command unknown -> reject command 3423 return 0; 3424 } 3425 return 1; 3426 } 3427 #endif 3428 3429 #ifdef ENABLE_CLASSIC 3430 static void l2cap_acl_classic_handler_for_channel(l2cap_channel_t * l2cap_channel, uint8_t * packet, uint16_t size){ 3431 3432 // forward data only in OPEN state 3433 if (l2cap_channel->state != L2CAP_STATE_OPEN) return; 3434 3435 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE 3436 if (l2cap_channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){ 3437 3438 int fcs_size = l2cap_channel->fcs_option ? 2 : 0; 3439 3440 // assert control + FCS fields are inside 3441 if (size < COMPLETE_L2CAP_HEADER+2+fcs_size) return; 3442 3443 if (l2cap_channel->fcs_option){ 3444 // verify FCS (required if one side requested it) 3445 uint16_t fcs_calculated = crc16_calc(&packet[4], size - (4+2)); 3446 uint16_t fcs_packet = little_endian_read_16(packet, size-2); 3447 3448 #ifdef L2CAP_ERTM_SIMULATE_FCS_ERROR_INTERVAL 3449 // simulate fcs error 3450 static int counter = 0; 3451 if (++counter == L2CAP_ERTM_SIMULATE_FCS_ERROR_INTERVAL) { 3452 log_info("Simulate fcs error"); 3453 fcs_calculated++; 3454 counter = 0; 3455 } 3456 #endif 3457 3458 if (fcs_calculated == fcs_packet){ 3459 log_info("Packet FCS 0x%04x verified", fcs_packet); 3460 } else { 3461 log_error("FCS mismatch! Packet 0x%04x, calculated 0x%04x", fcs_packet, fcs_calculated); 3462 // ERTM State Machine in Bluetooth Spec does not handle 'I-Frame with invalid FCS' 3463 return; 3464 } 3465 } 3466 3467 // switch on packet type 3468 uint16_t control = little_endian_read_16(packet, COMPLETE_L2CAP_HEADER); 3469 uint8_t req_seq = (control >> 8) & 0x3f; 3470 int final = (control >> 7) & 0x01; 3471 if (control & 1){ 3472 // S-Frame 3473 int poll = (control >> 4) & 0x01; 3474 l2cap_supervisory_function_t s = (l2cap_supervisory_function_t) ((control >> 2) & 0x03); 3475 log_info("Control: 0x%04x => Supervisory function %u, ReqSeq %02u", control, (int) s, req_seq); 3476 l2cap_ertm_tx_packet_state_t * tx_state; 3477 switch (s){ 3478 case L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY: 3479 log_info("L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY"); 3480 l2cap_ertm_process_req_seq(l2cap_channel, req_seq); 3481 if (poll && final){ 3482 // S-frames shall not be transmitted with both the F-bit and the P-bit set to 1 at the same time. 3483 log_error("P=F=1 in S-Frame"); 3484 break; 3485 } 3486 if (poll){ 3487 // check if we did request selective retransmission before <==> we have stored SDU segments 3488 int i; 3489 int num_stored_out_of_order_packets = 0; 3490 for (i=0;i<l2cap_channel->num_rx_buffers;i++){ 3491 int index = l2cap_channel->rx_store_index + i; 3492 if (index >= l2cap_channel->num_rx_buffers){ 3493 index -= l2cap_channel->num_rx_buffers; 3494 } 3495 l2cap_ertm_rx_packet_state_t * rx_state = &l2cap_channel->rx_packets_state[index]; 3496 if (!rx_state->valid) continue; 3497 num_stored_out_of_order_packets++; 3498 } 3499 if (num_stored_out_of_order_packets){ 3500 l2cap_channel->send_supervisor_frame_selective_reject = 1; 3501 } else { 3502 l2cap_channel->send_supervisor_frame_receiver_ready = 1; 3503 } 3504 l2cap_channel->set_final_bit_after_packet_with_poll_bit_set = 1; 3505 } 3506 if (final){ 3507 // Stop-MonitorTimer 3508 l2cap_ertm_stop_monitor_timer(l2cap_channel); 3509 // If UnackedFrames > 0 then Start-RetransTimer 3510 if (l2cap_channel->unacked_frames){ 3511 l2cap_ertm_start_retransmission_timer(l2cap_channel); 3512 } 3513 // final bit set <- response to RR with poll bit set. All not acknowledged packets need to be retransmitted 3514 l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel); 3515 } 3516 break; 3517 case L2CAP_SUPERVISORY_FUNCTION_REJ_REJECT: 3518 log_info("L2CAP_SUPERVISORY_FUNCTION_REJ_REJECT"); 3519 l2cap_ertm_process_req_seq(l2cap_channel, req_seq); 3520 // restart transmittion from last unacknowledted packet (earlier packets already freed in l2cap_ertm_process_req_seq) 3521 l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel); 3522 break; 3523 case L2CAP_SUPERVISORY_FUNCTION_RNR_RECEIVER_NOT_READY: 3524 log_error("L2CAP_SUPERVISORY_FUNCTION_RNR_RECEIVER_NOT_READY"); 3525 break; 3526 case L2CAP_SUPERVISORY_FUNCTION_SREJ_SELECTIVE_REJECT: 3527 log_info("L2CAP_SUPERVISORY_FUNCTION_SREJ_SELECTIVE_REJECT"); 3528 if (poll){ 3529 l2cap_ertm_process_req_seq(l2cap_channel, req_seq); 3530 } 3531 // find requested i-frame 3532 tx_state = l2cap_ertm_get_tx_state(l2cap_channel, req_seq); 3533 if (tx_state){ 3534 log_info("Retransmission for tx_seq %u requested", req_seq); 3535 l2cap_channel->set_final_bit_after_packet_with_poll_bit_set = poll; 3536 tx_state->retransmission_requested = 1; 3537 l2cap_channel->srej_active = 1; 3538 } 3539 break; 3540 default: 3541 break; 3542 } 3543 } else { 3544 // I-Frame 3545 // get control 3546 l2cap_segmentation_and_reassembly_t sar = (l2cap_segmentation_and_reassembly_t) (control >> 14); 3547 uint8_t tx_seq = (control >> 1) & 0x3f; 3548 log_info("Control: 0x%04x => SAR %u, ReqSeq %02u, R?, TxSeq %02u", control, (int) sar, req_seq, tx_seq); 3549 log_info("SAR: pos %u", l2cap_channel->reassembly_pos); 3550 log_info("State: expected_tx_seq %02u, req_seq %02u", l2cap_channel->expected_tx_seq, l2cap_channel->req_seq); 3551 l2cap_ertm_process_req_seq(l2cap_channel, req_seq); 3552 if (final){ 3553 // final bit set <- response to RR with poll bit set. All not acknowledged packets need to be retransmitted 3554 l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel); 3555 } 3556 3557 // get SDU 3558 const uint8_t * payload_data = &packet[COMPLETE_L2CAP_HEADER+2]; 3559 uint16_t payload_len = size-(COMPLETE_L2CAP_HEADER+2+fcs_size); 3560 3561 // assert SDU size is smaller or equal to our buffers 3562 uint16_t max_payload_size = 0; 3563 switch (sar){ 3564 case L2CAP_SEGMENTATION_AND_REASSEMBLY_UNSEGMENTED_L2CAP_SDU: 3565 case L2CAP_SEGMENTATION_AND_REASSEMBLY_START_OF_L2CAP_SDU: 3566 // SDU Length + MPS 3567 max_payload_size = l2cap_channel->local_mps + 2; 3568 break; 3569 case L2CAP_SEGMENTATION_AND_REASSEMBLY_CONTINUATION_OF_L2CAP_SDU: 3570 case L2CAP_SEGMENTATION_AND_REASSEMBLY_END_OF_L2CAP_SDU: 3571 max_payload_size = l2cap_channel->local_mps; 3572 break; 3573 default: 3574 btstack_assert(false); 3575 break; 3576 } 3577 if (payload_len > max_payload_size){ 3578 log_info("payload len %u > max payload %u -> drop packet", payload_len, max_payload_size); 3579 return; 3580 } 3581 3582 // check ordering 3583 if (l2cap_channel->expected_tx_seq == tx_seq){ 3584 log_info("Received expected frame with TxSeq == ExpectedTxSeq == %02u", tx_seq); 3585 l2cap_channel->expected_tx_seq = l2cap_next_ertm_seq_nr(l2cap_channel->expected_tx_seq); 3586 l2cap_channel->req_seq = l2cap_channel->expected_tx_seq; 3587 3588 // process SDU 3589 l2cap_ertm_handle_in_sequence_sdu(l2cap_channel, sar, payload_data, payload_len); 3590 3591 // process stored segments 3592 while (true){ 3593 int index = l2cap_channel->rx_store_index; 3594 l2cap_ertm_rx_packet_state_t * rx_state = &l2cap_channel->rx_packets_state[index]; 3595 if (!rx_state->valid) break; 3596 3597 log_info("Processing stored frame with TxSeq == ExpectedTxSeq == %02u", l2cap_channel->expected_tx_seq); 3598 l2cap_channel->expected_tx_seq = l2cap_next_ertm_seq_nr(l2cap_channel->expected_tx_seq); 3599 l2cap_channel->req_seq = l2cap_channel->expected_tx_seq; 3600 3601 rx_state->valid = 0; 3602 l2cap_ertm_handle_in_sequence_sdu(l2cap_channel, rx_state->sar, &l2cap_channel->rx_packets_data[index], rx_state->len); 3603 3604 // update rx store index 3605 index++; 3606 if (index >= l2cap_channel->num_rx_buffers){ 3607 index = 0; 3608 } 3609 l2cap_channel->rx_store_index = index; 3610 } 3611 3612 // 3613 l2cap_channel->send_supervisor_frame_receiver_ready = 1; 3614 3615 } else { 3616 int delta = (tx_seq - l2cap_channel->expected_tx_seq) & 0x3f; 3617 if (delta < 2){ 3618 // store segment 3619 l2cap_ertm_handle_out_of_sequence_sdu(l2cap_channel, sar, delta, payload_data, payload_len); 3620 3621 log_info("Received unexpected frame TxSeq %u but expected %u -> send S-SREJ", tx_seq, l2cap_channel->expected_tx_seq); 3622 l2cap_channel->send_supervisor_frame_selective_reject = 1; 3623 } else { 3624 log_info("Received unexpected frame TxSeq %u but expected %u -> send S-REJ", tx_seq, l2cap_channel->expected_tx_seq); 3625 l2cap_channel->send_supervisor_frame_reject = 1; 3626 } 3627 } 3628 } 3629 return; 3630 } 3631 #endif 3632 3633 // check size 3634 uint16_t payload_size = size - COMPLETE_L2CAP_HEADER; 3635 if (l2cap_channel->local_mtu < payload_size) return; 3636 3637 l2cap_dispatch_to_channel(l2cap_channel, L2CAP_DATA_PACKET, &packet[COMPLETE_L2CAP_HEADER], payload_size); 3638 } 3639 #endif 3640 3641 static void l2cap_acl_classic_handler(hci_con_handle_t handle, uint8_t *packet, uint16_t size){ 3642 #ifdef ENABLE_CLASSIC 3643 l2cap_channel_t * l2cap_channel; 3644 l2cap_fixed_channel_t * l2cap_fixed_channel; 3645 3646 uint16_t channel_id = READ_L2CAP_CHANNEL_ID(packet); 3647 uint8_t broadcast_flag = READ_ACL_FLAGS(packet) >> 2; 3648 switch (channel_id) { 3649 3650 case L2CAP_CID_SIGNALING: { 3651 if (broadcast_flag != 0) break; 3652 uint32_t command_offset = 8; 3653 while ((command_offset + L2CAP_SIGNALING_COMMAND_DATA_OFFSET) < size) { 3654 // assert signaling command is fully inside packet 3655 uint16_t data_len = little_endian_read_16(packet, command_offset + L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET); 3656 uint32_t next_command_offset = command_offset + L2CAP_SIGNALING_COMMAND_DATA_OFFSET + data_len; 3657 if (next_command_offset > size){ 3658 log_error("l2cap signaling command len invalid -> drop"); 3659 break; 3660 } 3661 // handle signaling command 3662 l2cap_signaling_handler_dispatch(handle, &packet[command_offset]); 3663 // go to next command 3664 command_offset = next_command_offset; 3665 } 3666 break; 3667 } 3668 case L2CAP_CID_CONNECTIONLESS_CHANNEL: 3669 if (broadcast_flag == 0) break; 3670 l2cap_fixed_channel = l2cap_fixed_channel_for_channel_id(L2CAP_CID_CONNECTIONLESS_CHANNEL); 3671 if (!l2cap_fixed_channel) break; 3672 if (!l2cap_fixed_channel->packet_handler) break; 3673 (*l2cap_fixed_channel->packet_handler)(UCD_DATA_PACKET, handle, &packet[COMPLETE_L2CAP_HEADER], size-COMPLETE_L2CAP_HEADER); 3674 break; 3675 3676 default: 3677 if (broadcast_flag != 0) break; 3678 // Find channel for this channel_id and connection handle 3679 l2cap_channel = l2cap_get_channel_for_local_cid_and_handle(channel_id, handle); 3680 if (l2cap_channel != NULL){ 3681 l2cap_acl_classic_handler_for_channel(l2cap_channel, packet, size); 3682 } 3683 break; 3684 } 3685 #else 3686 UNUSED(handle); // ok: no code 3687 UNUSED(packet); // ok: no code 3688 UNUSED(size); // ok: no code 3689 #endif 3690 } 3691 3692 static void l2cap_acl_le_handler(hci_con_handle_t handle, uint8_t *packet, uint16_t size){ 3693 #ifdef ENABLE_BLE 3694 3695 l2cap_fixed_channel_t * l2cap_fixed_channel; 3696 3697 #ifdef ENABLE_LE_DATA_CHANNELS 3698 l2cap_channel_t * l2cap_channel; 3699 #endif 3700 uint16_t channel_id = READ_L2CAP_CHANNEL_ID(packet); 3701 switch (channel_id) { 3702 3703 case L2CAP_CID_SIGNALING_LE: { 3704 uint16_t sig_id = packet[COMPLETE_L2CAP_HEADER + 1]; 3705 uint16_t len = little_endian_read_16(packet, COMPLETE_L2CAP_HEADER + 2); 3706 if ((COMPLETE_L2CAP_HEADER + 4u + len) > size) break; 3707 int valid = l2cap_le_signaling_handler_dispatch(handle, &packet[COMPLETE_L2CAP_HEADER], sig_id); 3708 if (!valid){ 3709 l2cap_register_signaling_response(handle, COMMAND_REJECT_LE, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN); 3710 } 3711 break; 3712 } 3713 3714 case L2CAP_CID_ATTRIBUTE_PROTOCOL: 3715 l2cap_fixed_channel = l2cap_fixed_channel_for_channel_id(L2CAP_CID_ATTRIBUTE_PROTOCOL); 3716 if (!l2cap_fixed_channel) break; 3717 if (!l2cap_fixed_channel->packet_handler) break; 3718 (*l2cap_fixed_channel->packet_handler)(ATT_DATA_PACKET, handle, &packet[COMPLETE_L2CAP_HEADER], size-COMPLETE_L2CAP_HEADER); 3719 break; 3720 3721 case L2CAP_CID_SECURITY_MANAGER_PROTOCOL: 3722 l2cap_fixed_channel = l2cap_fixed_channel_for_channel_id(L2CAP_CID_SECURITY_MANAGER_PROTOCOL); 3723 if (!l2cap_fixed_channel) break; 3724 if (!l2cap_fixed_channel->packet_handler) break; 3725 (*l2cap_fixed_channel->packet_handler)(SM_DATA_PACKET, handle, &packet[COMPLETE_L2CAP_HEADER], size-COMPLETE_L2CAP_HEADER); 3726 break; 3727 3728 default: 3729 3730 #ifdef ENABLE_LE_DATA_CHANNELS 3731 l2cap_channel = l2cap_get_channel_for_local_cid_and_handle(channel_id, handle); 3732 if (l2cap_channel != NULL) { 3733 // credit counting 3734 if (l2cap_channel->credits_incoming == 0u){ 3735 log_info("LE Data Channel packet received but no incoming credits"); 3736 l2cap_channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 3737 break; 3738 } 3739 l2cap_channel->credits_incoming--; 3740 3741 // automatic credits 3742 if ((l2cap_channel->credits_incoming < L2CAP_LE_DATA_CHANNELS_AUTOMATIC_CREDITS_WATERMARK) && l2cap_channel->automatic_credits){ 3743 l2cap_channel->new_credits_incoming = L2CAP_LE_DATA_CHANNELS_AUTOMATIC_CREDITS_INCREMENT; 3744 } 3745 3746 // first fragment 3747 uint16_t pos = 0; 3748 if (!l2cap_channel->receive_sdu_len){ 3749 uint16_t sdu_len = little_endian_read_16(packet, COMPLETE_L2CAP_HEADER); 3750 if(sdu_len > l2cap_channel->local_mtu) break; // SDU would be larger than our buffer 3751 l2cap_channel->receive_sdu_len = sdu_len; 3752 l2cap_channel->receive_sdu_pos = 0; 3753 pos += 2u; 3754 size -= 2u; 3755 } 3756 uint16_t fragment_size = size-COMPLETE_L2CAP_HEADER; 3757 uint16_t remaining_space = l2cap_channel->local_mtu - l2cap_channel->receive_sdu_pos; 3758 if (fragment_size > remaining_space) break; // SDU would cause buffer overrun 3759 (void)memcpy(&l2cap_channel->receive_sdu_buffer[l2cap_channel->receive_sdu_pos], 3760 &packet[COMPLETE_L2CAP_HEADER + pos], 3761 fragment_size); 3762 l2cap_channel->receive_sdu_pos += size - COMPLETE_L2CAP_HEADER; 3763 // done? 3764 log_debug("le packet pos %u, len %u", l2cap_channel->receive_sdu_pos, l2cap_channel->receive_sdu_len); 3765 if (l2cap_channel->receive_sdu_pos >= l2cap_channel->receive_sdu_len){ 3766 l2cap_dispatch_to_channel(l2cap_channel, L2CAP_DATA_PACKET, l2cap_channel->receive_sdu_buffer, l2cap_channel->receive_sdu_len); 3767 l2cap_channel->receive_sdu_len = 0; 3768 } 3769 } 3770 #endif 3771 break; 3772 } 3773 #else 3774 UNUSED(handle); // ok: no code 3775 UNUSED(packet); // ok: no code 3776 UNUSED(size); // ok: no code 3777 #endif 3778 } 3779 3780 static void l2cap_acl_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){ 3781 UNUSED(packet_type); // ok: registered with hci_register_acl_packet_handler 3782 UNUSED(channel); // ok: there is no channel 3783 3784 // Assert full L2CAP header present 3785 if (size < COMPLETE_L2CAP_HEADER) return; 3786 3787 // Dispatch to Classic or LE handler (SCO packets are not dispatched to L2CAP) 3788 hci_con_handle_t handle = READ_ACL_CONNECTION_HANDLE(packet); 3789 hci_connection_t *conn = hci_connection_for_handle(handle); 3790 if (!conn) return; 3791 if (conn->address_type == BD_ADDR_TYPE_ACL){ 3792 l2cap_acl_classic_handler(handle, packet, size); 3793 } else { 3794 l2cap_acl_le_handler(handle, packet, size); 3795 } 3796 3797 l2cap_run(); 3798 } 3799 3800 // Bluetooth 4.0 - allows to register handler for Attribute Protocol and Security Manager Protocol 3801 void l2cap_register_fixed_channel(btstack_packet_handler_t packet_handler, uint16_t channel_id) { 3802 l2cap_fixed_channel_t * channel = l2cap_fixed_channel_for_channel_id(channel_id); 3803 if (!channel) return; 3804 channel->packet_handler = packet_handler; 3805 } 3806 3807 #ifdef ENABLE_CLASSIC 3808 // finalize closed channel - l2cap_handle_disconnect_request & DISCONNECTION_RESPONSE 3809 void l2cap_finialize_channel_close(l2cap_channel_t * channel){ 3810 channel->state = L2CAP_STATE_CLOSED; 3811 l2cap_handle_channel_closed(channel); 3812 // discard channel 3813 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 3814 l2cap_free_channel_entry(channel); 3815 } 3816 #endif 3817 3818 #ifdef L2CAP_USES_CHANNELS 3819 static l2cap_service_t * l2cap_get_service_internal(btstack_linked_list_t * services, uint16_t psm){ 3820 btstack_linked_list_iterator_t it; 3821 btstack_linked_list_iterator_init(&it, services); 3822 while (btstack_linked_list_iterator_has_next(&it)){ 3823 l2cap_service_t * service = (l2cap_service_t *) btstack_linked_list_iterator_next(&it); 3824 if ( service->psm == psm){ 3825 return service; 3826 }; 3827 } 3828 return NULL; 3829 } 3830 #endif 3831 3832 #ifdef ENABLE_CLASSIC 3833 static inline l2cap_service_t * l2cap_get_service(uint16_t psm){ 3834 return l2cap_get_service_internal(&l2cap_services, psm); 3835 } 3836 3837 uint8_t l2cap_register_service(btstack_packet_handler_t service_packet_handler, uint16_t psm, uint16_t mtu, gap_security_level_t security_level){ 3838 3839 log_info("L2CAP_REGISTER_SERVICE psm 0x%x mtu %u", psm, mtu); 3840 3841 // check for alread registered psm 3842 l2cap_service_t *service = l2cap_get_service(psm); 3843 if (service) { 3844 log_error("l2cap_register_service: PSM %u already registered", psm); 3845 return L2CAP_SERVICE_ALREADY_REGISTERED; 3846 } 3847 3848 // alloc structure 3849 service = btstack_memory_l2cap_service_get(); 3850 if (!service) { 3851 log_error("l2cap_register_service: no memory for l2cap_service_t"); 3852 return BTSTACK_MEMORY_ALLOC_FAILED; 3853 } 3854 3855 // fill in 3856 service->psm = psm; 3857 service->mtu = mtu; 3858 service->packet_handler = service_packet_handler; 3859 service->required_security_level = security_level; 3860 3861 // add to services list 3862 btstack_linked_list_add(&l2cap_services, (btstack_linked_item_t *) service); 3863 3864 #ifndef ENABLE_EXPLICIT_CONNECTABLE_MODE_CONTROL 3865 // enable page scan 3866 gap_connectable_control(1); 3867 #endif 3868 3869 return ERROR_CODE_SUCCESS; 3870 } 3871 3872 uint8_t l2cap_unregister_service(uint16_t psm){ 3873 3874 log_info("L2CAP_UNREGISTER_SERVICE psm 0x%x", psm); 3875 3876 l2cap_service_t *service = l2cap_get_service(psm); 3877 if (!service) return L2CAP_SERVICE_DOES_NOT_EXIST; 3878 btstack_linked_list_remove(&l2cap_services, (btstack_linked_item_t *) service); 3879 btstack_memory_l2cap_service_free(service); 3880 3881 #ifndef ENABLE_EXPLICIT_CONNECTABLE_MODE_CONTROL 3882 // disable page scan when no services registered 3883 if (btstack_linked_list_empty(&l2cap_services)) { 3884 gap_connectable_control(0); 3885 } 3886 #endif 3887 3888 return ERROR_CODE_SUCCESS; 3889 } 3890 #endif 3891 3892 3893 #ifdef ENABLE_LE_DATA_CHANNELS 3894 3895 static void l2cap_le_notify_channel_can_send(l2cap_channel_t *channel){ 3896 if (!channel->waiting_for_can_send_now) return; 3897 if (channel->send_sdu_buffer) return; 3898 channel->waiting_for_can_send_now = 0; 3899 log_debug("L2CAP_EVENT_CHANNEL_LE_CAN_SEND_NOW local_cid 0x%x", channel->local_cid); 3900 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_LE_CAN_SEND_NOW); 3901 } 3902 3903 // 1BH2222 3904 static void l2cap_emit_le_incoming_connection(l2cap_channel_t *channel) { 3905 log_info("L2CAP_EVENT_LE_INCOMING_CONNECTION addr_type %u, addr %s handle 0x%x psm 0x%x local_cid 0x%x remote_cid 0x%x, remote_mtu %u", 3906 channel->address_type, bd_addr_to_str(channel->address), channel->con_handle, channel->psm, channel->local_cid, channel->remote_cid, channel->remote_mtu); 3907 uint8_t event[19]; 3908 event[0] = L2CAP_EVENT_LE_INCOMING_CONNECTION; 3909 event[1] = sizeof(event) - 2u; 3910 event[2] = channel->address_type; 3911 reverse_bd_addr(channel->address, &event[3]); 3912 little_endian_store_16(event, 9, channel->con_handle); 3913 little_endian_store_16(event, 11, channel->psm); 3914 little_endian_store_16(event, 13, channel->local_cid); 3915 little_endian_store_16(event, 15, channel->remote_cid); 3916 little_endian_store_16(event, 17, channel->remote_mtu); 3917 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 3918 l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event)); 3919 } 3920 // 11BH22222 3921 static void l2cap_emit_le_channel_opened(l2cap_channel_t *channel, uint8_t status) { 3922 log_info("L2CAP_EVENT_LE_CHANNEL_OPENED status 0x%x addr_type %u addr %s handle 0x%x psm 0x%x local_cid 0x%x remote_cid 0x%x local_mtu %u, remote_mtu %u", 3923 status, channel->address_type, bd_addr_to_str(channel->address), channel->con_handle, channel->psm, 3924 channel->local_cid, channel->remote_cid, channel->local_mtu, channel->remote_mtu); 3925 uint8_t event[23]; 3926 event[0] = L2CAP_EVENT_LE_CHANNEL_OPENED; 3927 event[1] = sizeof(event) - 2u; 3928 event[2] = status; 3929 event[3] = channel->address_type; 3930 reverse_bd_addr(channel->address, &event[4]); 3931 little_endian_store_16(event, 10, channel->con_handle); 3932 event[12] = (channel->state_var & L2CAP_CHANNEL_STATE_VAR_INCOMING) ? 1 : 0; 3933 little_endian_store_16(event, 13, channel->psm); 3934 little_endian_store_16(event, 15, channel->local_cid); 3935 little_endian_store_16(event, 17, channel->remote_cid); 3936 little_endian_store_16(event, 19, channel->local_mtu); 3937 little_endian_store_16(event, 21, channel->remote_mtu); 3938 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 3939 l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event)); 3940 } 3941 // 2 3942 static void l2cap_emit_le_channel_closed(l2cap_channel_t * channel){ 3943 log_info("L2CAP_EVENT_LE_CHANNEL_CLOSED local_cid 0x%x", channel->local_cid); 3944 uint8_t event[4]; 3945 event[0] = L2CAP_EVENT_LE_CHANNEL_CLOSED; 3946 event[1] = sizeof(event) - 2u; 3947 little_endian_store_16(event, 2, channel->local_cid); 3948 hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event)); 3949 l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event)); 3950 } 3951 3952 static void l2cap_le_send_pdu(l2cap_channel_t *channel){ 3953 btstack_assert(channel != NULL); 3954 btstack_assert(channel->send_sdu_buffer != NULL); 3955 btstack_assert(channel->credits_outgoing > 0); 3956 3957 // send part of SDU 3958 hci_reserve_packet_buffer(); 3959 uint8_t * acl_buffer = hci_get_outgoing_packet_buffer(); 3960 uint8_t * l2cap_payload = acl_buffer + 8; 3961 uint16_t pos = 0; 3962 if (!channel->send_sdu_pos){ 3963 // store SDU len 3964 channel->send_sdu_pos += 2u; 3965 little_endian_store_16(l2cap_payload, pos, channel->send_sdu_len); 3966 pos += 2u; 3967 } 3968 uint16_t payload_size = btstack_min(channel->send_sdu_len + 2u - channel->send_sdu_pos, channel->remote_mps - pos); 3969 log_info("len %u, pos %u => payload %u, credits %u", channel->send_sdu_len, channel->send_sdu_pos, payload_size, channel->credits_outgoing); 3970 (void)memcpy(&l2cap_payload[pos], 3971 &channel->send_sdu_buffer[channel->send_sdu_pos - 2u], 3972 payload_size); // -2 for virtual SDU len 3973 pos += payload_size; 3974 channel->send_sdu_pos += payload_size; 3975 l2cap_setup_header(acl_buffer, channel->con_handle, 0, channel->remote_cid, pos); 3976 3977 channel->credits_outgoing--; 3978 3979 hci_send_acl_packet_buffer(8u + pos); 3980 3981 if (channel->send_sdu_pos >= (channel->send_sdu_len + 2u)){ 3982 channel->send_sdu_buffer = NULL; 3983 // send done event 3984 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_LE_PACKET_SENT); 3985 // inform about can send now 3986 l2cap_le_notify_channel_can_send(channel); 3987 } 3988 } 3989 3990 // finalize closed channel - l2cap_handle_disconnect_request & DISCONNECTION_RESPONSE 3991 void l2cap_le_finialize_channel_close(l2cap_channel_t * channel){ 3992 channel->state = L2CAP_STATE_CLOSED; 3993 l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_CHANNEL_CLOSED); 3994 // discard channel 3995 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 3996 l2cap_free_channel_entry(channel); 3997 } 3998 3999 static inline l2cap_service_t * l2cap_le_get_service(uint16_t le_psm){ 4000 return l2cap_get_service_internal(&l2cap_le_services, le_psm); 4001 } 4002 4003 uint8_t l2cap_le_register_service(btstack_packet_handler_t packet_handler, uint16_t psm, gap_security_level_t security_level){ 4004 4005 log_info("L2CAP_LE_REGISTER_SERVICE psm 0x%x", psm); 4006 4007 // check for alread registered psm 4008 l2cap_service_t *service = l2cap_le_get_service(psm); 4009 if (service) { 4010 return L2CAP_SERVICE_ALREADY_REGISTERED; 4011 } 4012 4013 // alloc structure 4014 service = btstack_memory_l2cap_service_get(); 4015 if (!service) { 4016 log_error("l2cap_register_service_internal: no memory for l2cap_service_t"); 4017 return BTSTACK_MEMORY_ALLOC_FAILED; 4018 } 4019 4020 // fill in 4021 service->psm = psm; 4022 service->mtu = 0; 4023 service->packet_handler = packet_handler; 4024 service->required_security_level = security_level; 4025 4026 // add to services list 4027 btstack_linked_list_add(&l2cap_le_services, (btstack_linked_item_t *) service); 4028 4029 // done 4030 return ERROR_CODE_SUCCESS; 4031 } 4032 4033 uint8_t l2cap_le_unregister_service(uint16_t psm) { 4034 log_info("L2CAP_LE_UNREGISTER_SERVICE psm 0x%x", psm); 4035 l2cap_service_t *service = l2cap_le_get_service(psm); 4036 if (!service) return L2CAP_SERVICE_DOES_NOT_EXIST; 4037 4038 btstack_linked_list_remove(&l2cap_le_services, (btstack_linked_item_t *) service); 4039 btstack_memory_l2cap_service_free(service); 4040 return ERROR_CODE_SUCCESS; 4041 } 4042 4043 uint8_t l2cap_le_accept_connection(uint16_t local_cid, uint8_t * receive_sdu_buffer, uint16_t mtu, uint16_t initial_credits){ 4044 // get channel 4045 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4046 if (!channel) return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 4047 4048 // validate state 4049 if (channel->state != L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT){ 4050 return ERROR_CODE_COMMAND_DISALLOWED; 4051 } 4052 4053 // set state accept connection 4054 channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT; 4055 channel->receive_sdu_buffer = receive_sdu_buffer; 4056 channel->local_mtu = mtu; 4057 channel->new_credits_incoming = initial_credits; 4058 channel->automatic_credits = initial_credits == L2CAP_LE_AUTOMATIC_CREDITS; 4059 4060 // test 4061 // channel->new_credits_incoming = 1; 4062 4063 // go 4064 l2cap_run(); 4065 return ERROR_CODE_SUCCESS; 4066 } 4067 4068 /** 4069 * @brief Deny incoming LE Data Channel connection due to resource constraints 4070 * @param local_cid L2CAP LE Data Channel Identifier 4071 */ 4072 4073 uint8_t l2cap_le_decline_connection(uint16_t local_cid){ 4074 // get channel 4075 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4076 if (!channel) return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 4077 4078 // validate state 4079 if (channel->state != L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT){ 4080 return ERROR_CODE_COMMAND_DISALLOWED; 4081 } 4082 4083 // set state decline connection 4084 channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE; 4085 channel->reason = 0x04; // no resources available 4086 l2cap_run(); 4087 return ERROR_CODE_SUCCESS; 4088 } 4089 4090 static gap_security_level_t l2cap_le_security_level_for_connection(hci_con_handle_t con_handle){ 4091 uint8_t encryption_key_size = gap_encryption_key_size(con_handle); 4092 if (encryption_key_size == 0) return LEVEL_0; 4093 4094 uint8_t authenticated = gap_authenticated(con_handle); 4095 if (!authenticated) return LEVEL_2; 4096 4097 return encryption_key_size == 16 ? LEVEL_4 : LEVEL_3; 4098 } 4099 4100 // used to handle pairing complete after triggering to increase 4101 static void l2cap_sm_packet_handler(uint8_t packet_type, uint16_t channel_nr, uint8_t *packet, uint16_t size) { 4102 UNUSED(channel_nr); 4103 UNUSED(size); 4104 UNUSED(packet_type); 4105 btstack_assert(packet_type == HCI_EVENT_PACKET); 4106 if (hci_event_packet_get_type(packet) != SM_EVENT_PAIRING_COMPLETE) return; 4107 hci_con_handle_t con_handle = sm_event_pairing_complete_get_handle(packet); 4108 btstack_linked_list_iterator_t it; 4109 btstack_linked_list_iterator_init(&it, &l2cap_channels); 4110 while (btstack_linked_list_iterator_has_next(&it)) { 4111 l2cap_channel_t *channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it); 4112 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue; 4113 if (channel->con_handle != con_handle) continue; 4114 if (channel->state != L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE) continue; 4115 4116 // found channel, check security level 4117 if (l2cap_le_security_level_for_connection(con_handle) < channel->required_security_level){ 4118 // pairing failed or wasn't good enough, inform user 4119 l2cap_emit_le_channel_opened(channel, ERROR_CODE_INSUFFICIENT_SECURITY); 4120 // discard channel 4121 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel); 4122 l2cap_free_channel_entry(channel); 4123 } else { 4124 // send conn request now 4125 channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST; 4126 l2cap_run(); 4127 } 4128 } 4129 } 4130 4131 uint8_t l2cap_le_create_channel(btstack_packet_handler_t packet_handler, hci_con_handle_t con_handle, 4132 uint16_t psm, uint8_t * receive_sdu_buffer, uint16_t mtu, uint16_t initial_credits, gap_security_level_t security_level, 4133 uint16_t * out_local_cid) { 4134 4135 static btstack_packet_callback_registration_t sm_event_callback_registration; 4136 static bool sm_callback_registered = false; 4137 4138 log_info("L2CAP_LE_CREATE_CHANNEL handle 0x%04x psm 0x%x mtu %u", con_handle, psm, mtu); 4139 4140 hci_connection_t * connection = hci_connection_for_handle(con_handle); 4141 if (!connection) { 4142 log_error("no hci_connection for handle 0x%04x", con_handle); 4143 return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER; 4144 } 4145 4146 l2cap_channel_t * channel = l2cap_create_channel_entry(packet_handler, L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL, connection->address, connection->address_type, psm, mtu, security_level); 4147 if (!channel) { 4148 return BTSTACK_MEMORY_ALLOC_FAILED; 4149 } 4150 log_info("l2cap_le_create_channel %p", channel); 4151 4152 // store local_cid 4153 if (out_local_cid){ 4154 *out_local_cid = channel->local_cid; 4155 } 4156 4157 // setup channel entry 4158 channel->con_handle = con_handle; 4159 channel->receive_sdu_buffer = receive_sdu_buffer; 4160 channel->new_credits_incoming = initial_credits; 4161 channel->automatic_credits = initial_credits == L2CAP_LE_AUTOMATIC_CREDITS; 4162 4163 // add to connections list 4164 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel); 4165 4166 // check security level 4167 if (l2cap_le_security_level_for_connection(con_handle) < channel->required_security_level){ 4168 if (!sm_callback_registered){ 4169 sm_callback_registered = true; 4170 // lazy registration for SM events 4171 sm_event_callback_registration.callback = &l2cap_sm_packet_handler; 4172 sm_add_event_handler(&sm_event_callback_registration); 4173 } 4174 4175 // start pairing 4176 channel->state = L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE; 4177 sm_request_pairing(con_handle); 4178 } else { 4179 // send conn request right away 4180 channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST; 4181 l2cap_run(); 4182 } 4183 4184 return ERROR_CODE_SUCCESS; 4185 } 4186 4187 /** 4188 * @brief Provide credtis for LE Data Channel 4189 * @param local_cid L2CAP LE Data Channel Identifier 4190 * @param credits Number additional credits for peer 4191 */ 4192 uint8_t l2cap_le_provide_credits(uint16_t local_cid, uint16_t credits){ 4193 4194 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4195 if (!channel) { 4196 log_error("l2cap_le_provide_credits no channel for cid 0x%02x", local_cid); 4197 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 4198 } 4199 4200 // check state 4201 if (channel->state != L2CAP_STATE_OPEN){ 4202 log_error("l2cap_le_provide_credits but channel 0x%02x not open yet", local_cid); 4203 } 4204 4205 // assert incoming credits + credits <= 0xffff 4206 uint32_t total_credits = channel->credits_incoming; 4207 total_credits += channel->new_credits_incoming; 4208 total_credits += credits; 4209 if (total_credits > 0xffffu){ 4210 log_error("l2cap_le_provide_credits overrun: current %u, scheduled %u, additional %u", channel->credits_incoming, 4211 channel->new_credits_incoming, credits); 4212 } 4213 4214 // set credits_granted 4215 channel->new_credits_incoming += credits; 4216 4217 // go 4218 l2cap_run(); 4219 return ERROR_CODE_SUCCESS; 4220 } 4221 4222 /** 4223 * @brief Check if outgoing buffer is available and that there's space on the Bluetooth module 4224 * @param local_cid L2CAP LE Data Channel Identifier 4225 */ 4226 int l2cap_le_can_send_now(uint16_t local_cid){ 4227 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4228 if (!channel) { 4229 log_error("l2cap_le_provide_credits no channel for cid 0x%02x", local_cid); 4230 return 0; 4231 } 4232 4233 // check state 4234 if (channel->state != L2CAP_STATE_OPEN) return 0; 4235 4236 // check queue 4237 if (channel->send_sdu_buffer) return 0; 4238 4239 // fine, go ahead 4240 return 1; 4241 } 4242 4243 /** 4244 * @brief Request emission of L2CAP_EVENT_CAN_SEND_NOW as soon as possible 4245 * @note L2CAP_EVENT_CAN_SEND_NOW might be emitted during call to this function 4246 * so packet handler should be ready to handle it 4247 * @param local_cid L2CAP LE Data Channel Identifier 4248 */ 4249 uint8_t l2cap_le_request_can_send_now_event(uint16_t local_cid){ 4250 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4251 if (!channel) { 4252 log_error("l2cap_le_request_can_send_now_event no channel for cid 0x%02x", local_cid); 4253 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 4254 } 4255 channel->waiting_for_can_send_now = 1; 4256 l2cap_le_notify_channel_can_send(channel); 4257 return ERROR_CODE_SUCCESS; 4258 } 4259 4260 /** 4261 * @brief Send data via LE Data Channel 4262 * @note Since data larger then the maximum PDU needs to be segmented into multiple PDUs, data needs to stay valid until ... event 4263 * @param local_cid L2CAP LE Data Channel Identifier 4264 * @param data data to send 4265 * @param size data size 4266 */ 4267 uint8_t l2cap_le_send_data(uint16_t local_cid, uint8_t * data, uint16_t size){ 4268 4269 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4270 if (!channel) { 4271 log_error("l2cap_send no channel for cid 0x%02x", local_cid); 4272 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 4273 } 4274 4275 if (size > channel->remote_mtu){ 4276 log_error("l2cap_send cid 0x%02x, data length exceeds remote MTU.", local_cid); 4277 return L2CAP_DATA_LEN_EXCEEDS_REMOTE_MTU; 4278 } 4279 4280 if (channel->send_sdu_buffer){ 4281 log_info("l2cap_send cid 0x%02x, cannot send", local_cid); 4282 return BTSTACK_ACL_BUFFERS_FULL; 4283 } 4284 4285 channel->send_sdu_buffer = data; 4286 channel->send_sdu_len = size; 4287 channel->send_sdu_pos = 0; 4288 4289 l2cap_notify_channel_can_send(); 4290 return ERROR_CODE_SUCCESS; 4291 } 4292 4293 /** 4294 * @brief Disconnect from LE Data Channel 4295 * @param local_cid L2CAP LE Data Channel Identifier 4296 */ 4297 uint8_t l2cap_le_disconnect(uint16_t local_cid) 4298 { 4299 l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid); 4300 if (!channel) { 4301 log_error("l2cap_send no channel for cid 0x%02x", local_cid); 4302 return L2CAP_LOCAL_CID_DOES_NOT_EXIST; 4303 } 4304 4305 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST; 4306 l2cap_run(); 4307 return ERROR_CODE_SUCCESS; 4308 } 4309 4310 #endif 4311