xref: /btstack/src/l2cap.c (revision d7387af38d88a0c8d4e85f60f1b0906d02cd738a)
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