xref: /btstack/src/l2cap.c (revision fd0e4a3aa5a90726a5f41df0c75670b5ac0d6c58)
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                 break;
1708             case ECHO_REQUEST:
1709                 l2cap_send_signaling_packet(handle, ECHO_RESPONSE, sig_id, 0, NULL);
1710                 break;
1711             case INFORMATION_REQUEST:
1712                 switch (info_type){
1713                     case L2CAP_INFO_TYPE_CONNECTIONLESS_MTU: {
1714                             uint16_t connectionless_mtu = hci_max_acl_data_packet_length();
1715                             l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 0, sizeof(connectionless_mtu), &connectionless_mtu);
1716                         }
1717                         break;
1718                     case L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED: {
1719                             uint32_t features = l2cap_extended_features_mask();
1720                             l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 0, sizeof(features), &features);
1721                         }
1722                         break;
1723                     case L2CAP_INFO_TYPE_FIXED_CHANNELS_SUPPORTED: {
1724                             uint8_t map[8];
1725                             memset(map, 0, 8);
1726                             map[0] = 0x06;  // L2CAP Signaling Channel (0x02) + Connectionless reception (0x04)
1727                             l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 0, sizeof(map), &map);
1728                         }
1729                         break;
1730                     default:
1731                         // all other types are not supported
1732                         l2cap_send_signaling_packet(handle, INFORMATION_RESPONSE, sig_id, info_type, 1, 0, NULL);
1733                         break;
1734                 }
1735                 break;
1736             case COMMAND_REJECT:
1737                 l2cap_send_signaling_packet(handle, COMMAND_REJECT, sig_id, result, 0, NULL);
1738                 break;
1739 #endif
1740 #ifdef ENABLE_BLE
1741             case LE_CREDIT_BASED_CONNECTION_REQUEST:
1742                 l2cap_send_le_signaling_packet(handle, LE_CREDIT_BASED_CONNECTION_RESPONSE, sig_id, 0, 0, 0, 0, result);
1743                 break;
1744             case COMMAND_REJECT_LE:
1745                 l2cap_send_le_signaling_packet(handle, COMMAND_REJECT, sig_id, result, 0, NULL);
1746                 break;
1747 #endif
1748             default:
1749                 // should not happen
1750                 break;
1751         }
1752     }
1753 }
1754 
1755 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
1756 static bool l2ap_run_ertm(void){
1757     // send l2cap information request if neccessary
1758     btstack_linked_list_iterator_t it;
1759     hci_connections_get_iterator(&it);
1760     while(btstack_linked_list_iterator_has_next(&it)){
1761         hci_connection_t * connection = (hci_connection_t *) btstack_linked_list_iterator_next(&it);
1762         if (connection->l2cap_state.information_state == L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST){
1763             if (!hci_can_send_acl_packet_now(connection->con_handle)) break;
1764             connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_W4_EXTENDED_FEATURE_RESPONSE;
1765             uint8_t sig_id = l2cap_next_sig_id();
1766             uint8_t info_type = L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED;
1767             l2cap_send_signaling_packet(connection->con_handle, INFORMATION_REQUEST, sig_id, info_type);
1768             return true;
1769         }
1770     }
1771     return false;
1772 }
1773 #endif
1774 
1775 #ifdef ENABLE_LE_DATA_CHANNELS
1776 static void l2cap_run_le_data_channels(void){
1777     btstack_linked_list_iterator_t it;
1778     btstack_linked_list_iterator_init(&it, &l2cap_channels);
1779     while (btstack_linked_list_iterator_has_next(&it)){
1780         uint16_t mps;
1781         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
1782 
1783         if (channel->channel_type != L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL) continue;
1784 
1785         // log_info("l2cap_run: channel %p, state %u, var 0x%02x", channel, channel->state, channel->state_var);
1786         switch (channel->state){
1787             case L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST:
1788                 if (!hci_can_send_acl_packet_now(channel->con_handle)) break;
1789                 channel->state = L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE;
1790                 // le psm, source cid, mtu, mps, initial credits
1791                 channel->local_sig_id = l2cap_next_sig_id();
1792                 channel->credits_incoming =  channel->new_credits_incoming;
1793                 channel->new_credits_incoming = 0;
1794                 mps = btstack_min(l2cap_max_le_mtu(), channel->local_mtu);
1795                 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);
1796                 break;
1797             case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT:
1798                 if (!hci_can_send_acl_packet_now(channel->con_handle)) break;
1799                 // TODO: support larger MPS
1800                 channel->state = L2CAP_STATE_OPEN;
1801                 channel->credits_incoming =  channel->new_credits_incoming;
1802                 channel->new_credits_incoming = 0;
1803                 mps = btstack_min(l2cap_max_le_mtu(), channel->local_mtu);
1804                 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);
1805                 // notify client
1806                 l2cap_emit_le_channel_opened(channel, 0);
1807                 break;
1808             case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE:
1809                 if (!hci_can_send_acl_packet_now(channel->con_handle)) break;
1810                 channel->state = L2CAP_STATE_INVALID;
1811                 l2cap_send_le_signaling_packet(channel->con_handle, LE_CREDIT_BASED_CONNECTION_RESPONSE, channel->remote_sig_id, 0, 0, 0, 0, channel->reason);
1812                 // discard channel - l2cap_finialize_channel_close without sending l2cap close event
1813                 btstack_linked_list_iterator_remove(&it);
1814                 l2cap_free_channel_entry(channel);
1815                 break;
1816             case L2CAP_STATE_OPEN:
1817                 if (!hci_can_send_acl_packet_now(channel->con_handle)) break;
1818 
1819                 // send credits
1820                 if (channel->new_credits_incoming){
1821                     log_info("l2cap: sending %u credits", channel->new_credits_incoming);
1822                     channel->local_sig_id = l2cap_next_sig_id();
1823                     uint16_t new_credits = channel->new_credits_incoming;
1824                     channel->new_credits_incoming = 0;
1825                     channel->credits_incoming += new_credits;
1826                     l2cap_send_le_signaling_packet(channel->con_handle, LE_FLOW_CONTROL_CREDIT, channel->local_sig_id, channel->remote_cid, new_credits);
1827                 }
1828                 break;
1829 
1830             case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST:
1831                 if (!hci_can_send_acl_packet_now(channel->con_handle)) break;
1832                 channel->local_sig_id = l2cap_next_sig_id();
1833                 channel->state = L2CAP_STATE_WAIT_DISCONNECT;
1834                 l2cap_send_le_signaling_packet( channel->con_handle, DISCONNECTION_REQUEST, channel->local_sig_id, channel->remote_cid, channel->local_cid);
1835                 break;
1836             case L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE:
1837                 if (!hci_can_send_acl_packet_now(channel->con_handle)) break;
1838                 channel->state = L2CAP_STATE_INVALID;
1839                 l2cap_send_le_signaling_packet( channel->con_handle, DISCONNECTION_RESPONSE, channel->remote_sig_id, channel->local_cid, channel->remote_cid);
1840                 l2cap_le_finialize_channel_close(channel);  // -- remove from list
1841                 break;
1842             default:
1843                 break;
1844         }
1845     }
1846 }
1847 #endif
1848 
1849 // MARK: L2CAP_RUN
1850 // process outstanding signaling tasks
1851 static void l2cap_run(void){
1852 
1853     // log_info("l2cap_run: entered");
1854     l2cap_run_signaling_response();
1855 
1856 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
1857     bool done = l2ap_run_ertm();
1858     if (done) return;
1859 #endif
1860 
1861 #if defined(ENABLE_CLASSIC) || defined(ENABLE_BLE)
1862     btstack_linked_list_iterator_t it;
1863 #endif
1864 
1865 #ifdef ENABLE_CLASSIC
1866     btstack_linked_list_iterator_init(&it, &l2cap_channels);
1867     while (btstack_linked_list_iterator_has_next(&it)){
1868 
1869         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
1870 
1871         if (channel->channel_type != L2CAP_CHANNEL_TYPE_CLASSIC) continue;
1872 
1873         // log_info("l2cap_run: channel %p, state %u, var 0x%02x", channel, channel->state, channel->state_var);
1874         bool finalized = l2cap_run_for_classic_channel(channel);
1875 
1876         if (!finalized) {
1877 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
1878             l2cap_run_for_classic_channel_ertm(channel);
1879 #endif
1880         }
1881     }
1882 #endif
1883 
1884 #ifdef ENABLE_LE_DATA_CHANNELS
1885     l2cap_run_le_data_channels();
1886 #endif
1887 
1888 #ifdef ENABLE_BLE
1889     // send l2cap con paramter update if necessary
1890     hci_connections_get_iterator(&it);
1891     while(btstack_linked_list_iterator_has_next(&it)){
1892         hci_connection_t * connection = (hci_connection_t *) btstack_linked_list_iterator_next(&it);
1893         if ((connection->address_type != BD_ADDR_TYPE_LE_PUBLIC) && (connection->address_type != BD_ADDR_TYPE_LE_RANDOM)) continue;
1894         if (!hci_can_send_acl_packet_now(connection->con_handle)) continue;
1895         switch (connection->le_con_parameter_update_state){
1896             case CON_PARAMETER_UPDATE_SEND_REQUEST:
1897                 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_NONE;
1898                 l2cap_send_le_signaling_packet(connection->con_handle, CONNECTION_PARAMETER_UPDATE_REQUEST, l2cap_next_sig_id(),
1899                                                connection->le_conn_interval_min, connection->le_conn_interval_max, connection->le_conn_latency, connection->le_supervision_timeout);
1900                 break;
1901             case CON_PARAMETER_UPDATE_SEND_RESPONSE:
1902                 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_CHANGE_HCI_CON_PARAMETERS;
1903                 l2cap_send_le_signaling_packet(connection->con_handle, CONNECTION_PARAMETER_UPDATE_RESPONSE, connection->le_con_param_update_identifier, 0);
1904                 break;
1905             case CON_PARAMETER_UPDATE_DENY:
1906                 connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_NONE;
1907                 l2cap_send_le_signaling_packet(connection->con_handle, CONNECTION_PARAMETER_UPDATE_RESPONSE, connection->le_con_param_update_identifier, 1);
1908                 break;
1909             default:
1910                 break;
1911         }
1912     }
1913 #endif
1914 
1915     // log_info("l2cap_run: exit");
1916 }
1917 
1918 #ifdef ENABLE_CLASSIC
1919 static void l2cap_handle_connection_complete(hci_con_handle_t con_handle, l2cap_channel_t * channel){
1920     if ((channel->state == L2CAP_STATE_WAIT_CONNECTION_COMPLETE) || (channel->state == L2CAP_STATE_WILL_SEND_CREATE_CONNECTION)) {
1921         log_info("connection complete con_handle %04x - for channel %p cid 0x%04x", (int) con_handle, channel, channel->local_cid);
1922         // success, start l2cap handshake
1923         channel->con_handle = con_handle;
1924         // check remote SSP feature first
1925         channel->state = L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES;
1926     }
1927 }
1928 
1929 static void l2cap_ready_to_connect(l2cap_channel_t * channel){
1930 
1931 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
1932     // assumption: outgoing connection
1933     hci_connection_t * connection = hci_connection_for_handle(channel->con_handle);
1934     if (connection->l2cap_state.information_state == L2CAP_INFORMATION_STATE_IDLE){
1935         connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST;
1936         channel->state = L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES;
1937         return;
1938     }
1939 #endif
1940 
1941     // fine, go ahead
1942     channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST;
1943 }
1944 
1945 static void l2cap_handle_remote_supported_features_received(l2cap_channel_t * channel){
1946     if (channel->state != L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES) return;
1947 
1948     // abort if Secure Connections Only Mode with legacy connection
1949     if (gap_get_secure_connections_only_mode() && gap_secure_connection(channel->con_handle) == false){
1950         l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_REFUSED_SECURITY);
1951         btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t  *) channel);
1952         l2cap_free_channel_entry(channel);
1953         return;
1954     }
1955 
1956     // we have been waiting for remote supported features
1957     if (channel->required_security_level > LEVEL_0){
1958         // request security level
1959         channel->state = L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE;
1960         gap_request_security_level(channel->con_handle, channel->required_security_level);
1961         return;
1962     }
1963 
1964     l2cap_ready_to_connect(channel);
1965 }
1966 #endif
1967 
1968 #ifdef L2CAP_USES_CHANNELS
1969 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,
1970     uint16_t psm, uint16_t local_mtu, gap_security_level_t security_level){
1971 
1972     l2cap_channel_t * channel = btstack_memory_l2cap_channel_get();
1973     if (!channel) {
1974         return NULL;
1975     }
1976 
1977     // fill in
1978     channel->packet_handler = packet_handler;
1979     channel->channel_type   = channel_type;
1980     bd_addr_copy(channel->address, address);
1981     channel->address_type = address_type;
1982     channel->psm = psm;
1983     channel->local_mtu  = local_mtu;
1984     channel->remote_mtu = L2CAP_DEFAULT_MTU;
1985     channel->required_security_level = security_level;
1986 
1987     //
1988     channel->local_cid = l2cap_next_local_cid();
1989     channel->con_handle = HCI_CON_HANDLE_INVALID;
1990 
1991     // set initial state
1992     channel->state = L2CAP_STATE_WILL_SEND_CREATE_CONNECTION;
1993     channel->state_var = L2CAP_CHANNEL_STATE_VAR_NONE;
1994     channel->remote_sig_id = L2CAP_SIG_ID_INVALID;
1995     channel->local_sig_id = L2CAP_SIG_ID_INVALID;
1996 
1997     log_info("create channel %p, local_cid 0x%04x", channel, channel->local_cid);
1998 
1999     return channel;
2000 }
2001 
2002 static void l2cap_free_channel_entry(l2cap_channel_t * channel){
2003     log_info("free channel %p, local_cid 0x%04x", channel, channel->local_cid);
2004     // assert all timers are stopped
2005     l2cap_stop_rtx(channel);
2006 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2007     l2cap_ertm_stop_retransmission_timer(channel);
2008     l2cap_ertm_stop_monitor_timer(channel);
2009 #endif
2010     // free  memory
2011     btstack_memory_l2cap_channel_free(channel);
2012 }
2013 #endif
2014 
2015 #ifdef ENABLE_CLASSIC
2016 
2017 /**
2018  * @brief Creates L2CAP channel to the PSM of a remote device with baseband address. A new baseband connection will be initiated if necessary.
2019  * @param packet_handler
2020  * @param address
2021  * @param psm
2022  * @param mtu
2023  * @param local_cid
2024  */
2025 
2026 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){
2027     // limit MTU to the size of our outgoing HCI buffer
2028     uint16_t local_mtu = btstack_min(mtu, l2cap_max_mtu());
2029 
2030 	// determine security level based on psm
2031 	const gap_security_level_t security_level = l2cap_security_level_0_allowed_for_PSM(psm) ? LEVEL_0 : gap_get_security_level();
2032 	log_info("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);
2033 
2034     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);
2035     if (!channel) {
2036         return BTSTACK_MEMORY_ALLOC_FAILED;
2037     }
2038 
2039 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2040     channel->mode = L2CAP_CHANNEL_MODE_BASIC;
2041 #endif
2042 
2043     // add to connections list
2044     btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel);
2045 
2046     // store local_cid
2047     if (out_local_cid){
2048        *out_local_cid = channel->local_cid;
2049     }
2050 
2051 	// state: L2CAP_STATE_WILL_SEND_CREATE_CONNECTION
2052 
2053     // check if hci connection is already usable,
2054     hci_connection_t * conn = hci_connection_for_bd_addr_and_type(address, BD_ADDR_TYPE_ACL);
2055     if (conn && conn->state == OPEN){
2056     	// simulate connection complete
2057 	    l2cap_handle_connection_complete(conn->con_handle, channel);
2058 
2059 		// state: L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES
2060 
2061         // check if remote supported features are already received
2062         if (conn->bonding_flags & BONDING_RECEIVED_REMOTE_FEATURES) {
2063         	// simulate remote features received
2064             l2cap_handle_remote_supported_features_received(channel);
2065         }
2066     }
2067 
2068     l2cap_run();
2069 
2070     return ERROR_CODE_SUCCESS;
2071 }
2072 
2073 void l2cap_disconnect(uint16_t local_cid, uint8_t reason){
2074     log_info("disconnect local_cid 0x%x reason 0x%x", local_cid, reason);
2075     UNUSED(reason);
2076     // find channel for local_cid
2077     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
2078     if (channel) {
2079         channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
2080     }
2081     // process
2082     l2cap_run();
2083 }
2084 
2085 static void l2cap_handle_connection_failed_for_addr(bd_addr_t address, uint8_t status){
2086     // mark all channels before emitting open events as these could trigger new connetion requests to the same device
2087     btstack_linked_list_iterator_t it;
2088     btstack_linked_list_iterator_init(&it, &l2cap_channels);
2089     while (btstack_linked_list_iterator_has_next(&it)){
2090         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2091         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2092         if (bd_addr_cmp( channel->address, address) != 0) continue;
2093         // channel for this address found
2094         switch (channel->state){
2095             case L2CAP_STATE_WAIT_CONNECTION_COMPLETE:
2096             case L2CAP_STATE_WILL_SEND_CREATE_CONNECTION:
2097                 channel->state = L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD;
2098                 break;
2099             default:
2100                 break;
2101         }
2102     }
2103     // emit and free marked entries. restart loop to deal with list changes
2104     int done = 0;
2105     while (!done) {
2106         done = 1;
2107         btstack_linked_list_iterator_init(&it, &l2cap_channels);
2108         while (btstack_linked_list_iterator_has_next(&it)){
2109             l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2110             if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2111             if (channel->state == L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD){
2112                 done = 0;
2113                 // failure, forward error code
2114                 l2cap_handle_channel_open_failed(channel, status);
2115                 // discard channel
2116                 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
2117                 l2cap_free_channel_entry(channel);
2118                 break;
2119             }
2120         }
2121     }
2122 
2123 }
2124 
2125 static void l2cap_handle_connection_success_for_addr(bd_addr_t address, hci_con_handle_t handle){
2126     btstack_linked_list_iterator_t it;
2127     btstack_linked_list_iterator_init(&it, &l2cap_channels);
2128     while (btstack_linked_list_iterator_has_next(&it)){
2129         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2130         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2131         if ( ! bd_addr_cmp( channel->address, address) ){
2132             l2cap_handle_connection_complete(handle, channel);
2133         }
2134     }
2135     // process
2136     l2cap_run();
2137 }
2138 #endif
2139 
2140 static bool l2cap_channel_ready_to_send(l2cap_channel_t * channel){
2141     switch (channel->channel_type){
2142 #ifdef ENABLE_CLASSIC
2143         case L2CAP_CHANNEL_TYPE_CLASSIC:
2144             if (channel->state != L2CAP_STATE_OPEN) return false;
2145 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2146             // send if we have more data and remote windows isn't full yet
2147             if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) {
2148                 if (channel->unacked_frames >= btstack_min(channel->num_stored_tx_frames, channel->remote_tx_window_size)) return false;
2149                 return hci_can_send_acl_classic_packet_now() != 0;
2150             }
2151 #endif
2152             if (!channel->waiting_for_can_send_now) return false;
2153             return (hci_can_send_acl_classic_packet_now() != 0);
2154         case L2CAP_CHANNEL_TYPE_CONNECTIONLESS:
2155             if (!channel->waiting_for_can_send_now) return false;
2156             return hci_can_send_acl_classic_packet_now() != 0;
2157 #endif
2158 #ifdef ENABLE_BLE
2159         case L2CAP_CHANNEL_TYPE_LE_FIXED:
2160             if (!channel->waiting_for_can_send_now) return false;
2161             return hci_can_send_acl_le_packet_now() != 0;
2162 #ifdef ENABLE_LE_DATA_CHANNELS
2163         case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL:
2164             if (channel->state != L2CAP_STATE_OPEN) return false;
2165             if (channel->send_sdu_buffer == NULL) return false;
2166             if (channel->credits_outgoing == 0u) return false;
2167             return hci_can_send_acl_le_packet_now() != 0;
2168 #endif
2169 #endif
2170         default:
2171             return false;
2172     }
2173 }
2174 
2175 static void l2cap_channel_trigger_send(l2cap_channel_t * channel){
2176     switch (channel->channel_type){
2177 #ifdef ENABLE_CLASSIC
2178         case L2CAP_CHANNEL_TYPE_CLASSIC:
2179 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2180             if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) {
2181                 l2cap_ertm_channel_send_information_frame(channel);
2182                 return;
2183             }
2184 #endif
2185             channel->waiting_for_can_send_now = 0;
2186             l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid);
2187             break;
2188         case L2CAP_CHANNEL_TYPE_CONNECTIONLESS:
2189             channel->waiting_for_can_send_now = 0;
2190             l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid);
2191             break;
2192 #endif
2193 #ifdef ENABLE_BLE
2194         case L2CAP_CHANNEL_TYPE_LE_FIXED:
2195             channel->waiting_for_can_send_now = 0;
2196             l2cap_emit_can_send_now(channel->packet_handler, channel->local_cid);
2197             break;
2198 #ifdef ENABLE_LE_DATA_CHANNELS
2199         case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL:
2200             l2cap_le_send_pdu(channel);
2201             break;
2202 #endif
2203 #endif
2204         default:
2205             break;
2206     }
2207 }
2208 
2209 static void l2cap_notify_channel_can_send(void){
2210     bool done = false;
2211     while (!done){
2212         done = true;
2213         btstack_linked_list_iterator_t it;
2214         btstack_linked_list_iterator_init(&it, &l2cap_channels);
2215         while (btstack_linked_list_iterator_has_next(&it)){
2216             l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2217             bool ready = l2cap_channel_ready_to_send(channel);
2218             if (!ready) continue;
2219 
2220             // requeue channel for fairness
2221             btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
2222             btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel);
2223 
2224             // trigger sending
2225             l2cap_channel_trigger_send(channel);
2226 
2227             // exit inner loop as we just broke the iterator, but try again
2228             done = false;
2229             break;
2230         }
2231     }
2232 }
2233 
2234 #ifdef L2CAP_USES_CHANNELS
2235 
2236 static int l2cap_send_open_failed_on_hci_disconnect(l2cap_channel_t * channel){
2237     // open cannot fail for for incoming connections
2238     if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_INCOMING) return 0;
2239 
2240     // check state
2241     switch (channel->state){
2242         case L2CAP_STATE_WILL_SEND_CREATE_CONNECTION:
2243         case L2CAP_STATE_WAIT_CONNECTION_COMPLETE:
2244         case L2CAP_STATE_WAIT_REMOTE_SUPPORTED_FEATURES:
2245         case L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE:
2246         case L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT:
2247         case L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES:
2248         case L2CAP_STATE_WAIT_CONNECT_RSP:
2249         case L2CAP_STATE_CONFIG:
2250         case L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST:
2251         case L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST:
2252         case L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE:
2253         case L2CAP_STATE_EMIT_OPEN_FAILED_AND_DISCARD:
2254             return 1;
2255 
2256         case L2CAP_STATE_OPEN:
2257         case L2CAP_STATE_CLOSED:
2258         case L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES:
2259         case L2CAP_STATE_WAIT_DISCONNECT:
2260         case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_INSUFFICIENT_SECURITY:
2261         case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE:
2262         case L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT:
2263         case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST:
2264         case L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE:
2265         case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE:
2266         case L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT:
2267         case L2CAP_STATE_INVALID:
2268         case L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE:
2269             return 0;
2270 
2271         default:
2272             // get a "warning" about new states
2273             btstack_assert(false);
2274             return 0;
2275     }
2276 }
2277 #endif
2278 
2279 #ifdef ENABLE_CLASSIC
2280 static void l2cap_handle_hci_disconnect_event(l2cap_channel_t * channel){
2281     if (l2cap_send_open_failed_on_hci_disconnect(channel)){
2282         l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_BASEBAND_DISCONNECT);
2283     } else {
2284         l2cap_handle_channel_closed(channel);
2285     }
2286     l2cap_free_channel_entry(channel);
2287 }
2288 #endif
2289 
2290 #ifdef ENABLE_LE_DATA_CHANNELS
2291 static void l2cap_handle_hci_le_disconnect_event(l2cap_channel_t * channel){
2292     if (l2cap_send_open_failed_on_hci_disconnect(channel)){
2293         l2cap_emit_le_channel_opened(channel, L2CAP_CONNECTION_BASEBAND_DISCONNECT);
2294     } else {
2295         l2cap_emit_le_channel_closed(channel);
2296     }
2297     l2cap_free_channel_entry(channel);
2298 }
2299 #endif
2300 
2301 #ifdef ENABLE_CLASSIC
2302 static void l2cap_check_classic_timeout(hci_con_handle_t handle){
2303     if (gap_get_connection_type(handle) != GAP_CONNECTION_ACL) {
2304         return;
2305     }
2306     if (hci_authentication_active_for_handle(handle)) {
2307         return;
2308     }
2309     bool hci_con_used = false;
2310     btstack_linked_list_iterator_t it;
2311     btstack_linked_list_iterator_init(&it, &l2cap_channels);
2312     while (btstack_linked_list_iterator_has_next(&it)){
2313         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2314         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2315         if (channel->con_handle != handle) continue;
2316         hci_con_used = true;
2317         break;
2318     }
2319     if (hci_con_used) {
2320         return;
2321     }
2322     if (!hci_can_send_command_packet_now()) {
2323         return;
2324     }
2325     hci_send_cmd(&hci_disconnect, handle, 0x13); // remote closed connection
2326 }
2327 static void l2cap_handle_features_complete(hci_con_handle_t handle){
2328     hci_connection_t * hci_connection = hci_connection_for_handle(handle);
2329     if (hci_connection == NULL) {
2330         return;
2331     };
2332     if ((hci_connection->bonding_flags & BONDING_RECEIVED_REMOTE_FEATURES) == 0) {
2333         return;
2334     }
2335     btstack_linked_list_iterator_t it;
2336     btstack_linked_list_iterator_init(&it, &l2cap_channels);
2337     while (btstack_linked_list_iterator_has_next(&it)){
2338         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2339         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2340         if (channel->con_handle != handle) continue;
2341         log_info("remote supported features, channel %p, cid %04x - state %u", channel, channel->local_cid, channel->state);
2342         l2cap_handle_remote_supported_features_received(channel);
2343     }
2344 }
2345 
2346 static void l2cap_handle_security_level_incoming_sufficient(l2cap_channel_t * channel){
2347 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2348     // we need to know if ERTM is supported before sending a config response
2349     hci_connection_t * connection = hci_connection_for_handle(channel->con_handle);
2350     if (connection->l2cap_state.information_state != L2CAP_INFORMATION_STATE_DONE){
2351         connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST;
2352         channel->state = L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES;
2353         return;
2354     }
2355 #endif
2356     channel->state = L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT;
2357     l2cap_emit_incoming_connection(channel);
2358 }
2359 
2360 static void l2cap_handle_security_level(hci_con_handle_t handle, gap_security_level_t actual_level){
2361     log_info("security level update for handle 0x%04x", handle);
2362     btstack_linked_list_iterator_t it;
2363     btstack_linked_list_iterator_init(&it, &l2cap_channels);
2364     while (btstack_linked_list_iterator_has_next(&it)){
2365         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2366         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2367         if (channel->con_handle != handle) continue;
2368 
2369         gap_security_level_t required_level = channel->required_security_level;
2370 
2371         log_info("channel %p, cid %04x - state %u: actual %u >= required %u?", channel, channel->local_cid, channel->state, actual_level, required_level);
2372 
2373         switch (channel->state){
2374             case L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE:
2375                 if (actual_level >= required_level){
2376                     l2cap_handle_security_level_incoming_sufficient(channel);
2377                 } else {
2378                     channel->reason = 0x0003; // security block
2379                     channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE;
2380                 }
2381                 break;
2382 
2383             case L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE:
2384                 if (actual_level >= required_level){
2385                     l2cap_ready_to_connect(channel);
2386                 } else {
2387                     // security level insufficient, report error and free channel
2388                     l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_REFUSED_SECURITY);
2389                     btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t  *) channel);
2390                     l2cap_free_channel_entry(channel);
2391                 }
2392                 break;
2393 
2394             default:
2395                 break;
2396         }
2397     }
2398 }
2399 #endif
2400 
2401 #ifdef L2CAP_USES_CHANNELS
2402 static void l2cap_handle_disconnection_complete(hci_con_handle_t handle){
2403     // collect channels to close
2404     btstack_linked_list_t channels_to_close = NULL;
2405     btstack_linked_list_iterator_t it;
2406     btstack_linked_list_iterator_init(&it, &l2cap_channels);
2407     while (btstack_linked_list_iterator_has_next(&it)) {
2408         l2cap_channel_t *channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2409         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
2410         if (channel->con_handle != handle) continue;
2411         btstack_linked_list_iterator_remove(&it);
2412         btstack_linked_list_add(&channels_to_close, (btstack_linked_item_t *) channel);
2413     }
2414     // send l2cap open failed or closed events for all channels on this handle and free them
2415     btstack_linked_list_iterator_init(&it, &channels_to_close);
2416     while (btstack_linked_list_iterator_has_next(&it)) {
2417         l2cap_channel_t *channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
2418         btstack_linked_list_iterator_remove(&it);
2419         switch(channel->channel_type){
2420 #ifdef ENABLE_CLASSIC
2421             case L2CAP_CHANNEL_TYPE_CLASSIC:
2422                 l2cap_handle_hci_disconnect_event(channel);
2423                 break;
2424 #endif
2425 #ifdef ENABLE_LE_DATA_CHANNELS
2426             case L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL:
2427                 l2cap_handle_hci_le_disconnect_event(channel);
2428                 break;
2429 #endif
2430             default:
2431                 break;
2432         }
2433     }
2434 }
2435 #endif
2436 
2437 static void l2cap_hci_event_handler(uint8_t packet_type, uint16_t cid, uint8_t *packet, uint16_t size){
2438 
2439     UNUSED(packet_type); // ok: registered with hci_event_callback_registration
2440     UNUSED(cid);         // ok: there is no channel
2441     UNUSED(size);        // ok: fixed format events read from HCI buffer
2442 
2443 #ifdef ENABLE_CLASSIC
2444     bd_addr_t address;
2445     gap_security_level_t security_level;
2446 #endif
2447 #ifdef L2CAP_USES_CHANNELS
2448     hci_con_handle_t handle;
2449 #endif
2450 
2451     switch(hci_event_packet_get_type(packet)){
2452 
2453         // Notify channel packet handler if they can send now
2454         case HCI_EVENT_TRANSPORT_PACKET_SENT:
2455         case HCI_EVENT_NUMBER_OF_COMPLETED_PACKETS:
2456         case BTSTACK_EVENT_NR_CONNECTIONS_CHANGED:
2457             l2cap_run();    // try sending signaling packets first
2458             l2cap_notify_channel_can_send();
2459             break;
2460 
2461         case HCI_EVENT_COMMAND_STATUS:
2462 #ifdef ENABLE_CLASSIC
2463             // check command status for create connection for errors
2464             if (HCI_EVENT_IS_COMMAND_STATUS(packet, hci_create_connection)){
2465                 // cache outgoing address and reset
2466                 (void)memcpy(address, l2cap_outgoing_classic_addr, 6);
2467                 memset(l2cap_outgoing_classic_addr, 0, 6);
2468                 // error => outgoing connection failed
2469                 uint8_t status = hci_event_command_status_get_status(packet);
2470                 if (status){
2471                     l2cap_handle_connection_failed_for_addr(address, status);
2472                 }
2473             }
2474 #endif
2475             l2cap_run();    // try sending signaling packets first
2476             break;
2477 
2478 #ifdef ENABLE_CLASSIC
2479         // handle connection complete events
2480         case HCI_EVENT_CONNECTION_COMPLETE:
2481             reverse_bd_addr(&packet[5], address);
2482             if (packet[2] == 0){
2483                 handle = little_endian_read_16(packet, 3);
2484                 l2cap_handle_connection_success_for_addr(address, handle);
2485             } else {
2486                 l2cap_handle_connection_failed_for_addr(address, packet[2]);
2487             }
2488             break;
2489 
2490         // handle successful create connection cancel command
2491         case HCI_EVENT_COMMAND_COMPLETE:
2492             if (HCI_EVENT_IS_COMMAND_COMPLETE(packet, hci_create_connection_cancel)) {
2493                 if (packet[5] == 0){
2494                     reverse_bd_addr(&packet[6], address);
2495                     // CONNECTION TERMINATED BY LOCAL HOST (0X16)
2496                     l2cap_handle_connection_failed_for_addr(address, 0x16);
2497                 }
2498             }
2499             l2cap_run();    // try sending signaling packets first
2500             break;
2501 #endif
2502 
2503 #ifdef L2CAP_USES_CHANNELS
2504         // handle disconnection complete events
2505         case HCI_EVENT_DISCONNECTION_COMPLETE:
2506             handle = little_endian_read_16(packet, 3);
2507             l2cap_handle_disconnection_complete(handle);
2508             break;
2509 #endif
2510 
2511         // HCI Connection Timeouts
2512 #ifdef ENABLE_CLASSIC
2513         case L2CAP_EVENT_TIMEOUT_CHECK:
2514             handle = little_endian_read_16(packet, 2);
2515             l2cap_check_classic_timeout(handle);
2516             break;
2517 
2518         case HCI_EVENT_READ_REMOTE_SUPPORTED_FEATURES_COMPLETE:
2519         case HCI_EVENT_READ_REMOTE_EXTENDED_FEATURES_COMPLETE:
2520             handle = little_endian_read_16(packet, 3);
2521             l2cap_handle_features_complete(handle);
2522             break;
2523 
2524         case GAP_EVENT_SECURITY_LEVEL:
2525             handle = little_endian_read_16(packet, 2);
2526             security_level = (gap_security_level_t) packet[4];
2527             l2cap_handle_security_level(handle, security_level);
2528             break;
2529 #endif
2530         default:
2531             break;
2532     }
2533 
2534     l2cap_run();
2535 }
2536 
2537 static void l2cap_register_signaling_response(hci_con_handle_t handle, uint8_t code, uint8_t sig_id, uint16_t cid, uint16_t data){
2538     // Vol 3, Part A, 4.3: "The DCID and SCID fields shall be ignored when the result field indi- cates the connection was refused."
2539     if (signaling_responses_pending < NR_PENDING_SIGNALING_RESPONSES) {
2540         signaling_responses[signaling_responses_pending].handle = handle;
2541         signaling_responses[signaling_responses_pending].code = code;
2542         signaling_responses[signaling_responses_pending].sig_id = sig_id;
2543         signaling_responses[signaling_responses_pending].cid = cid;
2544         signaling_responses[signaling_responses_pending].data = data;
2545         signaling_responses_pending++;
2546         l2cap_run();
2547     }
2548 }
2549 
2550 #ifdef ENABLE_CLASSIC
2551 static void l2cap_handle_disconnect_request(l2cap_channel_t *channel, uint16_t identifier){
2552     switch (channel->state){
2553         case L2CAP_STATE_CONFIG:
2554         case L2CAP_STATE_OPEN:
2555         case L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST:
2556         case L2CAP_STATE_WAIT_DISCONNECT:
2557             break;
2558         default:
2559             // ignore in other states
2560             return;
2561     }
2562 
2563     channel->remote_sig_id = identifier;
2564     channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE;
2565     l2cap_run();
2566 }
2567 
2568 static void l2cap_handle_connection_request(hci_con_handle_t handle, uint8_t sig_id, uint16_t psm, uint16_t source_cid){
2569 
2570     // log_info("l2cap_handle_connection_request for handle %u, psm %u cid 0x%02x", handle, psm, source_cid);
2571     l2cap_service_t *service = l2cap_get_service(psm);
2572     if (!service) {
2573         // 0x0002 PSM not supported
2574         l2cap_register_signaling_response(handle, CONNECTION_REQUEST, sig_id, source_cid, 0x0002);
2575         return;
2576     }
2577 
2578     hci_connection_t * hci_connection = hci_connection_for_handle( handle );
2579     if (!hci_connection) {
2580         //
2581         log_error("no hci_connection for handle %u", handle);
2582         return;
2583     }
2584 
2585     // Core V5.2, Vol 3, Part C, 5.2.2.2 - Security Mode 4
2586     //   When a remote device attempts to access a service offered by a Bluetooth device that is in security mode 4
2587     //   and a sufficient link key exists and authentication has not been performed the local device shall authenticate
2588     //   the remote device and enable encryption after the channel establishment request is received but before a channel
2589     //   establishment confirmation (L2CAP_ConnectRsp with result code of 0x0000 or a higher-level channel establishment
2590     //   confirmation such as that of RFCOMM) is sent.
2591 
2592     //   If the remote device has indicated support for Secure Simple Pairing, a channel establishment request is
2593     //   received for a service other than SDP, and encryption has not yet been enabled, then the local device shall
2594     //   disconnect the ACL link with error code 0x05 - Authentication Failure.
2595 
2596     // => Disconnect if l2cap request received in mode 4 and ssp supported, non-sdp psm, not encrypted, no link key available
2597     if ((gap_get_security_mode() == GAP_SECURITY_MODE_4)
2598         && gap_ssp_supported_on_both_sides(handle)
2599         && (psm != PSM_SDP)
2600         && (gap_encryption_key_size(handle) == 0)
2601         && (gap_bonded(handle) == false)){
2602         hci_disconnect_security_block(handle);
2603         return;
2604     }
2605 
2606     // alloc structure
2607     gap_security_level_t required_level = service->required_security_level;
2608     if (gap_get_secure_connections_only_mode() && (required_level != LEVEL_0)){
2609         required_level = LEVEL_4;
2610     }
2611     l2cap_channel_t * channel = l2cap_create_channel_entry(service->packet_handler, L2CAP_CHANNEL_TYPE_CLASSIC, hci_connection->address, BD_ADDR_TYPE_ACL,
2612     psm, service->mtu, required_level);
2613     if (!channel){
2614         // 0x0004 No resources available
2615         l2cap_register_signaling_response(handle, CONNECTION_REQUEST, sig_id, source_cid, 0x0004);
2616         return;
2617     }
2618 
2619     channel->con_handle = handle;
2620     channel->remote_cid = source_cid;
2621     channel->remote_sig_id = sig_id;
2622 
2623     // limit local mtu to max acl packet length - l2cap header
2624     if (channel->local_mtu > l2cap_max_mtu()) {
2625         channel->local_mtu = l2cap_max_mtu();
2626     }
2627 
2628     // set initial state
2629     channel->state =      L2CAP_STATE_WAIT_INCOMING_SECURITY_LEVEL_UPDATE;
2630     channel->state_var  = (L2CAP_CHANNEL_STATE_VAR) (L2CAP_CHANNEL_STATE_VAR_SEND_CONN_RESP_PEND | L2CAP_CHANNEL_STATE_VAR_INCOMING);
2631 
2632     // add to connections list
2633     btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel);
2634 
2635     // assert security requirements
2636     gap_request_security_level(handle, channel->required_security_level);
2637 }
2638 
2639 void l2cap_accept_connection(uint16_t local_cid){
2640     log_info("L2CAP_ACCEPT_CONNECTION local_cid 0x%x", local_cid);
2641     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
2642     if (!channel) {
2643         log_error("accept called but local_cid 0x%x not found", local_cid);
2644         return;
2645     }
2646 
2647 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2648     // configure L2CAP Basic mode
2649     channel->mode  = L2CAP_CHANNEL_MODE_BASIC;
2650 #endif
2651 
2652     channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_ACCEPT;
2653 
2654     // process
2655     l2cap_run();
2656 }
2657 
2658 void l2cap_decline_connection(uint16_t local_cid){
2659     log_info("decline local_cid 0x%x", local_cid);
2660     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid( local_cid);
2661     if (!channel) {
2662         log_error( "l2cap_decline_connection called but local_cid 0x%x not found", local_cid);
2663         return;
2664     }
2665     channel->state  = L2CAP_STATE_WILL_SEND_CONNECTION_RESPONSE_DECLINE;
2666     channel->reason = 0x04; // no resources available
2667     l2cap_run();
2668 }
2669 
2670 // @pre command len is valid, see check in l2cap_signaling_handler_channel
2671 static void l2cap_signaling_handle_configure_request(l2cap_channel_t *channel, uint8_t *command){
2672 
2673 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2674     uint8_t use_fcs = 1;
2675 #endif
2676 
2677     channel->remote_sig_id = command[L2CAP_SIGNALING_COMMAND_SIGID_OFFSET];
2678 
2679     uint16_t flags = little_endian_read_16(command, 6);
2680     if (flags & 1) {
2681         channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT);
2682     }
2683 
2684     // accept the other's configuration options
2685     uint16_t end_pos = 4 + little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET);
2686     uint16_t pos     = 8;
2687     while (pos < end_pos){
2688         uint8_t option_hint = command[pos] >> 7;
2689         uint8_t option_type = command[pos] & 0x7f;
2690         // log_info("l2cap cid %u, hint %u, type %u", channel->local_cid, option_hint, option_type);
2691         pos++;
2692         uint8_t length = command[pos++];
2693         // MTU { type(8): 1, len(8):2, MTU(16) }
2694         if ((option_type == L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT) && (length == 2)){
2695             channel->remote_mtu = little_endian_read_16(command, pos);
2696             log_info("Remote MTU %u", channel->remote_mtu);
2697             if (channel->remote_mtu > l2cap_max_mtu()){
2698                 log_info("Remote MTU %u larger than outgoing buffer, only using MTU = %u", channel->remote_mtu, l2cap_max_mtu());
2699                 channel->remote_mtu = l2cap_max_mtu();
2700             }
2701             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_MTU);
2702         }
2703         // Flush timeout { type(8):2, len(8): 2, Flush Timeout(16)}
2704         if ((option_type == L2CAP_CONFIG_OPTION_TYPE_FLUSH_TIMEOUT) && (length == 2)){
2705             channel->flush_timeout = little_endian_read_16(command, pos);
2706             log_info("Flush timeout: %u ms", channel->flush_timeout);
2707         }
2708 
2709 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2710         // Retransmission and Flow Control Option
2711         if (option_type == L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL && length == 9){
2712             l2cap_channel_mode_t mode = (l2cap_channel_mode_t) command[pos];
2713             switch(channel->mode){
2714                 case L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION:
2715                     // Store remote config
2716                     channel->remote_tx_window_size = command[pos+1];
2717                     channel->remote_max_transmit   = command[pos+2];
2718                     channel->remote_retransmission_timeout_ms = little_endian_read_16(command, pos + 3);
2719                     channel->remote_monitor_timeout_ms = little_endian_read_16(command, pos + 5);
2720                     channel->remote_mps = little_endian_read_16(command, pos + 7);
2721                     log_info("FC&C config: tx window: %u, max transmit %u, retrans timeout %u, monitor timeout %u, mps %u",
2722                         channel->remote_tx_window_size,
2723                         channel->remote_max_transmit,
2724                         channel->remote_retransmission_timeout_ms,
2725                         channel->remote_monitor_timeout_ms,
2726                         channel->remote_mps);
2727                     // If ERTM mandatory, but remote doens't offer ERTM -> disconnect
2728                     if (channel->ertm_mandatory && mode != L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){
2729                         channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
2730                     } else {
2731                         channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM);
2732                     }
2733                     break;
2734                 case L2CAP_CHANNEL_MODE_BASIC:
2735                     switch (mode){
2736                         case L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION:
2737                             // remote asks for ERTM, but we want basic mode. disconnect if this happens a second time
2738                             if (channel->state_var & L2CAP_CHANNEL_STATE_VAR_BASIC_FALLBACK_TRIED){
2739                                 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
2740                             }
2741                             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_BASIC_FALLBACK_TRIED);
2742                             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_REJECTED);
2743                             break;
2744                         default: // case L2CAP_CHANNEL_MODE_BASIC:
2745                             // TODO store and evaluate configuration
2746                             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM);
2747                             break;
2748                     }
2749                     break;
2750                 default:
2751                     break;
2752             }
2753         }
2754         if (option_type == L2CAP_CONFIG_OPTION_TYPE_FRAME_CHECK_SEQUENCE && length == 1){
2755             use_fcs = command[pos];
2756         }
2757 #endif
2758         // check for unknown options
2759         if ((option_hint == 0) && ((option_type < L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT) || (option_type > L2CAP_CONFIG_OPTION_TYPE_EXTENDED_WINDOW_SIZE))){
2760             log_info("l2cap cid %u, unknown option 0x%02x", channel->local_cid, option_type);
2761             channel->unknown_option = option_type;
2762             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_INVALID);
2763         }
2764         pos += length;
2765     }
2766 
2767 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2768         // "FCS" has precedence over "No FCS"
2769         uint8_t update = channel->fcs_option || use_fcs;
2770         log_info("local fcs: %u, remote fcs: %u -> %u", channel->fcs_option, use_fcs, update);
2771         channel->fcs_option = update;
2772         // If ERTM mandatory, but remote didn't send Retransmission and Flowcontrol options -> disconnect
2773         if (((channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_ERTM) == 0) & (channel->ertm_mandatory)){
2774             channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
2775         }
2776 #endif
2777 }
2778 
2779 // @pre command len is valid, see check in l2cap_signaling_handler_channel
2780 static void l2cap_signaling_handle_configure_response(l2cap_channel_t *channel, uint8_t result, uint8_t *command){
2781     log_info("l2cap_signaling_handle_configure_response");
2782 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2783     uint16_t end_pos = 4 + little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET);
2784     uint16_t pos     = 10;
2785     while (pos < end_pos){
2786         uint8_t option_hint = command[pos] >> 7;
2787         uint8_t option_type = command[pos] & 0x7f;
2788         // log_info("l2cap cid %u, hint %u, type %u", channel->local_cid, option_hint, option_type);
2789         pos++;
2790         uint8_t length = command[pos++];
2791 
2792         // Retransmission and Flow Control Option
2793         if (option_type == L2CAP_CONFIG_OPTION_TYPE_RETRANSMISSION_AND_FLOW_CONTROL && length == 9){
2794             switch (channel->mode){
2795                 case L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION:
2796                     if (channel->ertm_mandatory){
2797                         // ??
2798                     } else {
2799                         // On 'Reject - Unacceptable Parameters' to our optional ERTM request, fall back to BASIC mode
2800                         if (result == L2CAP_CONF_RESULT_UNACCEPTABLE_PARAMETERS){
2801                             l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED);
2802                             channel->mode = L2CAP_CHANNEL_MODE_BASIC;
2803                         }
2804                     }
2805                     break;
2806                 case L2CAP_CHANNEL_MODE_BASIC:
2807                     if (result == L2CAP_CONF_RESULT_UNACCEPTABLE_PARAMETERS){
2808                         // On 'Reject - Unacceptable Parameters' to our Basic mode request, disconnect
2809                         channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
2810                     }
2811                     break;
2812                 default:
2813                     break;
2814             }
2815         }
2816 
2817         // check for unknown options
2818         if (option_hint == 0 && (option_type < L2CAP_CONFIG_OPTION_TYPE_MAX_TRANSMISSION_UNIT || option_type > L2CAP_CONFIG_OPTION_TYPE_EXTENDED_WINDOW_SIZE)){
2819             log_info("l2cap cid %u, unknown option 0x%02x", channel->local_cid, option_type);
2820             channel->unknown_option = option_type;
2821             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_INVALID);
2822         }
2823 
2824         pos += length;
2825     }
2826 #else
2827     UNUSED(channel);  // ok: no code
2828     UNUSED(result);   // ok: no code
2829     UNUSED(command);  // ok: no code
2830 #endif
2831 }
2832 
2833 static int l2cap_channel_ready_for_open(l2cap_channel_t *channel){
2834     // log_info("l2cap_channel_ready_for_open 0x%02x", channel->state_var);
2835     if ((channel->state_var & L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_RSP) == 0) return 0;
2836     if ((channel->state_var & L2CAP_CHANNEL_STATE_VAR_SENT_CONF_RSP) == 0) return 0;
2837     // addition check that fixes re-entrance issue causing l2cap event channel opened twice
2838     if (channel->state == L2CAP_STATE_OPEN) return 0;
2839     return 1;
2840 }
2841 
2842 
2843 // @pre command len is valid, see check in l2cap_signaling_handler_dispatch
2844 static void l2cap_signaling_handler_channel(l2cap_channel_t *channel, uint8_t *command){
2845 
2846     uint8_t  code       = command[L2CAP_SIGNALING_COMMAND_CODE_OFFSET];
2847     uint8_t  identifier = command[L2CAP_SIGNALING_COMMAND_SIGID_OFFSET];
2848     uint16_t cmd_len    = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET);
2849     uint16_t result = 0;
2850 
2851     log_info("L2CAP signaling handler code %u, state %u", code, channel->state);
2852 
2853     // handle DISCONNECT REQUESTS seperately
2854     if (code == DISCONNECTION_REQUEST){
2855         l2cap_handle_disconnect_request(channel, identifier);
2856         return;
2857     }
2858 
2859     // @STATEMACHINE(l2cap)
2860     switch (channel->state) {
2861 
2862         case L2CAP_STATE_WAIT_CONNECT_RSP:
2863             switch (code){
2864                 case CONNECTION_RESPONSE:
2865                     if (cmd_len < 8){
2866                         // command imcomplete
2867                         l2cap_register_signaling_response(channel->con_handle, COMMAND_REJECT, identifier, 0, L2CAP_REJ_CMD_UNKNOWN);
2868                         break;
2869                     }
2870                     l2cap_stop_rtx(channel);
2871                     result = little_endian_read_16 (command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4);
2872                     switch (result) {
2873                         case 0:
2874                             // successful connection
2875                             channel->remote_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET);
2876                             channel->state = L2CAP_STATE_CONFIG;
2877                             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ);
2878                             break;
2879                         case 1:
2880                             // connection pending. get some coffee, but start the ERTX
2881                             l2cap_start_ertx(channel);
2882                             break;
2883                         default:
2884                             // channel closed
2885                             channel->state = L2CAP_STATE_CLOSED;
2886                             // map l2cap connection response result to BTstack status enumeration
2887                             l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_SUCCESSFUL + result);
2888 
2889                             // drop link key if security block
2890                             if ((L2CAP_CONNECTION_RESPONSE_RESULT_SUCCESSFUL + result) == L2CAP_CONNECTION_RESPONSE_RESULT_REFUSED_SECURITY){
2891                                 gap_drop_link_key_for_bd_addr(channel->address);
2892                             }
2893 
2894                             // discard channel
2895                             btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
2896                             l2cap_free_channel_entry(channel);
2897                             break;
2898                     }
2899                     break;
2900 
2901                 default:
2902                     //@TODO: implement other signaling packets
2903                     break;
2904             }
2905             break;
2906 
2907         case L2CAP_STATE_CONFIG:
2908             switch (code) {
2909                 case CONFIGURE_REQUEST:
2910                     if (cmd_len < 4){
2911                         // command incomplete
2912                         l2cap_register_signaling_response(channel->con_handle, COMMAND_REJECT, identifier, 0, L2CAP_REJ_CMD_UNKNOWN);
2913                         break;
2914                     }
2915                     channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP);
2916                     l2cap_signaling_handle_configure_request(channel, command);
2917                     if (!(channel->state_var & L2CAP_CHANNEL_STATE_VAR_SEND_CONF_RSP_CONT)){
2918                         // only done if continuation not set
2919                         channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_REQ);
2920                     }
2921                     break;
2922                 case CONFIGURE_RESPONSE:
2923                     if (cmd_len < 6){
2924                         // command incomplete
2925                         l2cap_register_signaling_response(channel->con_handle, COMMAND_REJECT, identifier, 0, L2CAP_REJ_CMD_UNKNOWN);
2926                         break;
2927                     }
2928                     result = little_endian_read_16 (command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4);
2929                     l2cap_stop_rtx(channel);
2930                     l2cap_signaling_handle_configure_response(channel, result, command);
2931                     switch (result){
2932                         case 0: // success
2933                             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_RCVD_CONF_RSP);
2934                             break;
2935                         case 4: // pending
2936                             l2cap_start_ertx(channel);
2937                             break;
2938                         default:
2939 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2940                             if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION && channel->ertm_mandatory){
2941                                 // remote does not offer ertm but it's required
2942                                 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
2943                                 break;
2944                             }
2945 #endif
2946                             // retry on negative result
2947                             channelStateVarSetFlag(channel, L2CAP_CHANNEL_STATE_VAR_SEND_CONF_REQ);
2948                             break;
2949                     }
2950                     break;
2951                 default:
2952                     break;
2953             }
2954             if (l2cap_channel_ready_for_open(channel)){
2955 
2956 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
2957                 // assert that packet can be stored in fragment buffers in ertm
2958                 if (channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){
2959                     uint16_t effective_mps = btstack_min(channel->remote_mps, channel->local_mps);
2960                     uint16_t usable_mtu = channel->num_tx_buffers == 1 ? effective_mps : channel->num_tx_buffers * effective_mps - 2;
2961                     if (usable_mtu < channel->remote_mtu){
2962                         log_info("Remote MTU %u > max storable ERTM packet, only using MTU = %u", channel->remote_mtu, usable_mtu);
2963                         channel->remote_mtu = usable_mtu;
2964                     }
2965                 }
2966 #endif
2967                 // for open:
2968                 channel->state = L2CAP_STATE_OPEN;
2969                 l2cap_emit_channel_opened(channel, 0);
2970             }
2971             break;
2972 
2973         case L2CAP_STATE_WAIT_DISCONNECT:
2974             switch (code) {
2975                 case DISCONNECTION_RESPONSE:
2976                     l2cap_finialize_channel_close(channel);
2977                     break;
2978                 default:
2979                     //@TODO: implement other signaling packets
2980                     break;
2981             }
2982             break;
2983 
2984         case L2CAP_STATE_CLOSED:
2985             // @TODO handle incoming requests
2986             break;
2987 
2988         case L2CAP_STATE_OPEN:
2989             //@TODO: implement other signaling packets, e.g. re-configure
2990             break;
2991         default:
2992             break;
2993     }
2994     // log_info("new state %u", channel->state);
2995 }
2996 
2997 
2998 // @pre command len is valid, see check in l2cap_acl_classic_handler
2999 static void l2cap_signaling_handler_dispatch(hci_con_handle_t handle, uint8_t * command){
3000 
3001     btstack_linked_list_iterator_t it;
3002 
3003     // get code, signalind identifier and command len
3004     uint8_t code     = command[L2CAP_SIGNALING_COMMAND_CODE_OFFSET];
3005     uint8_t sig_id   = command[L2CAP_SIGNALING_COMMAND_SIGID_OFFSET];
3006     uint16_t cmd_len = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET);
3007 
3008     // not for a particular channel, and not CONNECTION_REQUEST, ECHO_[REQUEST|RESPONSE], INFORMATION_RESPONSE
3009     if ((code < 1) || (code == ECHO_RESPONSE) || (code > INFORMATION_RESPONSE)){
3010         l2cap_register_signaling_response(handle, COMMAND_REJECT, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN);
3011         return;
3012     }
3013 
3014     // general commands without an assigned channel
3015     switch(code) {
3016 
3017         case CONNECTION_REQUEST:
3018             if (cmd_len == 4){
3019                 uint16_t psm =        little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET);
3020                 uint16_t source_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+2);
3021                 l2cap_handle_connection_request(handle, sig_id, psm, source_cid);
3022             } else {
3023                 l2cap_register_signaling_response(handle, COMMAND_REJECT, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN);
3024             }
3025             return;
3026 
3027         case ECHO_REQUEST:
3028             l2cap_register_signaling_response(handle, code, sig_id, 0, 0);
3029             return;
3030 
3031         case INFORMATION_REQUEST:
3032             if (cmd_len == 2) {
3033                 uint16_t info_type = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET);
3034                 l2cap_register_signaling_response(handle, code, sig_id, 0, info_type);
3035             } else {
3036                 l2cap_register_signaling_response(handle, COMMAND_REJECT, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN);
3037             }
3038             return;
3039 
3040 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
3041         case INFORMATION_RESPONSE: {
3042             hci_connection_t * connection = hci_connection_for_handle(handle);
3043             if (!connection) return;
3044             if (connection->l2cap_state.information_state != L2CAP_INFORMATION_STATE_W4_EXTENDED_FEATURE_RESPONSE) return;
3045 
3046             // get extended features from response if valid
3047             connection->l2cap_state.extended_feature_mask = 0;
3048             if (cmd_len >= 6) {
3049                 uint16_t info_type = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET);
3050                 uint16_t result    = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+2);
3051                 if (result == 0 && info_type == L2CAP_INFO_TYPE_EXTENDED_FEATURES_SUPPORTED) {
3052                     connection->l2cap_state.extended_feature_mask = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4);
3053                 }
3054             }
3055             connection->l2cap_state.information_state = L2CAP_INFORMATION_STATE_DONE;
3056             log_info("extended features mask 0x%02x", connection->l2cap_state.extended_feature_mask);
3057 
3058             // trigger connection request
3059             btstack_linked_list_iterator_init(&it, &l2cap_channels);
3060             while (btstack_linked_list_iterator_has_next(&it)){
3061                 l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
3062                 if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
3063                 if (channel->con_handle != handle) continue;
3064 
3065                 // incoming connection: ask user for channel configuration, esp. if ertm will be mandatory
3066                 if (channel->state == L2CAP_STATE_WAIT_INCOMING_EXTENDED_FEATURES){
3067                     channel->state = L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT;
3068                     l2cap_emit_incoming_connection(channel);
3069                     continue;
3070                 }
3071 
3072                 // outgoing connection
3073                 if (channel->state == L2CAP_STATE_WAIT_OUTGOING_EXTENDED_FEATURES){
3074 
3075                     // if ERTM was requested, but is not listed in extended feature mask:
3076                     if ((channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION) && ((connection->l2cap_state.extended_feature_mask & 0x08) == 0)){
3077 
3078                         if (channel->ertm_mandatory){
3079                             // bail if ERTM is mandatory
3080                             channel->state = L2CAP_STATE_CLOSED;
3081                             // map l2cap connection response result to BTstack status enumeration
3082                             l2cap_handle_channel_open_failed(channel, L2CAP_CONNECTION_RESPONSE_RESULT_ERTM_NOT_SUPPORTED);
3083                             // discard channel
3084                             btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
3085                             l2cap_free_channel_entry(channel);
3086                             continue;
3087 
3088                         } else {
3089                             // fallback to Basic mode
3090                             l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_ERTM_BUFFER_RELEASED);
3091                             channel->mode = L2CAP_CHANNEL_MODE_BASIC;
3092                         }
3093                     }
3094 
3095                     // respond to connection request
3096                     channel->state = L2CAP_STATE_WILL_SEND_CONNECTION_REQUEST;
3097                     continue;
3098                 }
3099             }
3100             return;
3101         }
3102 #endif
3103 
3104         default:
3105             break;
3106     }
3107 
3108     // Get potential destination CID
3109     uint16_t dest_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET);
3110 
3111     // Find channel for this sig_id and connection handle
3112     btstack_linked_list_iterator_init(&it, &l2cap_channels);
3113     while (btstack_linked_list_iterator_has_next(&it)){
3114         l2cap_channel_t * channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
3115         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
3116         if (channel->con_handle != handle) continue;
3117         if (code & 1) {
3118             // match odd commands (responses) by previous signaling identifier
3119             if (channel->local_sig_id == sig_id) {
3120                 l2cap_signaling_handler_channel(channel, command);
3121                 break;
3122             }
3123         } else {
3124             // match even commands (requests) by local channel id
3125             if (channel->local_cid == dest_cid) {
3126                 l2cap_signaling_handler_channel(channel, command);
3127                 break;
3128             }
3129         }
3130     }
3131 }
3132 #endif
3133 
3134 #ifdef ENABLE_BLE
3135 
3136 static void l2cap_emit_connection_parameter_update_response(hci_con_handle_t con_handle, uint16_t result){
3137     uint8_t event[6];
3138     event[0] = L2CAP_EVENT_CONNECTION_PARAMETER_UPDATE_RESPONSE;
3139     event[1] = 4;
3140     little_endian_store_16(event, 2, con_handle);
3141     little_endian_store_16(event, 4, result);
3142     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
3143     if (!l2cap_event_packet_handler) return;
3144     (*l2cap_event_packet_handler)(HCI_EVENT_PACKET, 0, event, sizeof(event));
3145 }
3146 
3147 // @returns valid
3148 static int l2cap_le_signaling_handler_dispatch(hci_con_handle_t handle, uint8_t * command, uint8_t sig_id){
3149     hci_connection_t * connection;
3150     uint16_t result;
3151     uint8_t  event[12];
3152 
3153 #ifdef ENABLE_LE_DATA_CHANNELS
3154     btstack_linked_list_iterator_t it;
3155     l2cap_channel_t * channel;
3156     uint16_t local_cid;
3157     uint16_t le_psm;
3158     uint16_t new_credits;
3159     uint16_t credits_before;
3160     l2cap_service_t * service;
3161     uint16_t source_cid;
3162 #endif
3163 
3164     uint8_t code   = command[L2CAP_SIGNALING_COMMAND_CODE_OFFSET];
3165     uint16_t len   = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET);
3166     log_info("le dispatch: command 0x%02x, sig id %u, len %u", code, sig_id, len);
3167 
3168     switch (code){
3169 
3170         case CONNECTION_PARAMETER_UPDATE_REQUEST:
3171             // check size
3172             if (len < 8u) return 0u;
3173             connection = hci_connection_for_handle(handle);
3174             if (connection != NULL){
3175                 if (connection->role != HCI_ROLE_MASTER){
3176                     // reject command without notifying upper layer when not in master role
3177                     return 0;
3178                 }
3179                 le_connection_parameter_range_t existing_range;
3180                 gap_get_connection_parameter_range(&existing_range);
3181                 uint16_t le_conn_interval_min   = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET);
3182                 uint16_t le_conn_interval_max   = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET+2);
3183                 uint16_t le_conn_latency        = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET+4);
3184                 uint16_t le_supervision_timeout = little_endian_read_16(command,L2CAP_SIGNALING_COMMAND_DATA_OFFSET+6);
3185 
3186                 int update_parameter = gap_connection_parameter_range_included(&existing_range, le_conn_interval_min, le_conn_interval_max, le_conn_latency, le_supervision_timeout);
3187                 if (update_parameter){
3188                     connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_SEND_RESPONSE;
3189                     connection->le_conn_interval_min = le_conn_interval_min;
3190                     connection->le_conn_interval_max = le_conn_interval_max;
3191                     connection->le_conn_latency = le_conn_latency;
3192                     connection->le_supervision_timeout = le_supervision_timeout;
3193                 } else {
3194                     connection->le_con_parameter_update_state = CON_PARAMETER_UPDATE_DENY;
3195                 }
3196                 connection->le_con_param_update_identifier = sig_id;
3197             }
3198 
3199             if (!l2cap_event_packet_handler) break;
3200 
3201             event[0] = L2CAP_EVENT_CONNECTION_PARAMETER_UPDATE_REQUEST;
3202             event[1] = 8;
3203             little_endian_store_16(event, 2, handle);
3204             (void)memcpy(&event[4], &command[4], 8);
3205             hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
3206             (*l2cap_event_packet_handler)( HCI_EVENT_PACKET, 0, event, sizeof(event));
3207             break;
3208 
3209         case CONNECTION_PARAMETER_UPDATE_RESPONSE:
3210             // check size
3211             if (len < 2u) return 0u;
3212             result = little_endian_read_16(command, 4);
3213             l2cap_emit_connection_parameter_update_response(handle, result);
3214             break;
3215 
3216 #ifdef ENABLE_LE_DATA_CHANNELS
3217 
3218         case COMMAND_REJECT:
3219             // Find channel for this sig_id and connection handle
3220             channel = NULL;
3221             btstack_linked_list_iterator_init(&it, &l2cap_channels);
3222             while (btstack_linked_list_iterator_has_next(&it)){
3223                 l2cap_channel_t * a_channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
3224                 if (!l2cap_is_dynamic_channel_type(a_channel->channel_type)) continue;
3225                 if (a_channel->con_handle   != handle) continue;
3226                 if (a_channel->local_sig_id != sig_id) continue;
3227                 channel = a_channel;
3228                 break;
3229             }
3230             if (!channel) break;
3231 
3232             // if received while waiting for le connection response, assume legacy device
3233             if (channel->state == L2CAP_STATE_WAIT_LE_CONNECTION_RESPONSE){
3234                 channel->state = L2CAP_STATE_CLOSED;
3235                 // no official value for this, use: Connection refused – LE_PSM not supported - 0x0002
3236                 l2cap_emit_le_channel_opened(channel, 0x0002);
3237 
3238                 // discard channel
3239                 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
3240                 l2cap_free_channel_entry(channel);
3241                 break;
3242             }
3243             break;
3244 
3245         case LE_CREDIT_BASED_CONNECTION_REQUEST:
3246             // check size
3247             if (len < 10u) return 0u;
3248 
3249             // get hci connection, bail if not found (must not happen)
3250             connection = hci_connection_for_handle(handle);
3251             if (!connection) return 0;
3252 
3253             // check if service registered
3254             le_psm  = little_endian_read_16(command, 4);
3255             service = l2cap_le_get_service(le_psm);
3256             source_cid = little_endian_read_16(command, 6);
3257 
3258             if (service){
3259                 if (source_cid < 0x40u){
3260                     // 0x0009 Connection refused - Invalid Source CID
3261                     l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0009);
3262                     return 1;
3263                 }
3264 
3265                 // go through list of channels for this ACL connection and check if we get a match
3266                 btstack_linked_list_iterator_init(&it, &l2cap_channels);
3267                 while (btstack_linked_list_iterator_has_next(&it)){
3268                     l2cap_channel_t * a_channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
3269                     if (!l2cap_is_dynamic_channel_type(a_channel->channel_type)) continue;
3270                     if (a_channel->con_handle != handle) continue;
3271                     if (a_channel->remote_cid != source_cid) continue;
3272                     // 0x000a Connection refused - Source CID already allocated
3273                     l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x000a);
3274                     return 1;
3275                 }
3276 
3277                 // security: check encryption
3278                 if (service->required_security_level >= LEVEL_2){
3279                     if (gap_encryption_key_size(handle) == 0){
3280                         // 0x0008 Connection refused - insufficient encryption
3281                         l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0008);
3282                         return 1;
3283                     }
3284                     // anything less than 16 byte key size is insufficient
3285                     if (gap_encryption_key_size(handle) < 16){
3286                         // 0x0007 Connection refused – insufficient encryption key size
3287                         l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0007);
3288                         return 1;
3289                     }
3290                 }
3291 
3292                 // security: check authencation
3293                 if (service->required_security_level >= LEVEL_3){
3294                     if (!gap_authenticated(handle)){
3295                         // 0x0005 Connection refused – insufficient authentication
3296                         l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0005);
3297                         return 1;
3298                     }
3299                 }
3300 
3301                 // security: check authorization
3302                 if (service->required_security_level >= LEVEL_4){
3303                     if (gap_authorization_state(handle) != AUTHORIZATION_GRANTED){
3304                         // 0x0006 Connection refused – insufficient authorization
3305                         l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0006);
3306                         return 1;
3307                     }
3308                 }
3309 
3310                 // allocate channel
3311                 channel = l2cap_create_channel_entry(service->packet_handler, L2CAP_CHANNEL_TYPE_LE_DATA_CHANNEL, connection->address,
3312                     BD_ADDR_TYPE_LE_RANDOM, le_psm, service->mtu, service->required_security_level);
3313                 if (!channel){
3314                     // 0x0004 Connection refused – no resources available
3315                     l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0004);
3316                     return 1;
3317                 }
3318 
3319                 channel->con_handle = handle;
3320                 channel->remote_cid = source_cid;
3321                 channel->remote_sig_id = sig_id;
3322                 channel->remote_mtu = little_endian_read_16(command, 8);
3323                 channel->remote_mps = little_endian_read_16(command, 10);
3324                 channel->credits_outgoing = little_endian_read_16(command, 12);
3325 
3326                 // set initial state
3327                 channel->state      = L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT;
3328                 channel->state_var |= L2CAP_CHANNEL_STATE_VAR_INCOMING;
3329 
3330                 // add to connections list
3331                 btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel);
3332 
3333                 // post connection request event
3334                 l2cap_emit_le_incoming_connection(channel);
3335 
3336             } else {
3337                 // Connection refused – LE_PSM not supported
3338                 l2cap_register_signaling_response(handle, LE_CREDIT_BASED_CONNECTION_REQUEST, sig_id, source_cid, 0x0002);
3339             }
3340             break;
3341 
3342         case LE_CREDIT_BASED_CONNECTION_RESPONSE:
3343             // check size
3344             if (len < 10u) return 0u;
3345 
3346             // Find channel for this sig_id and connection handle
3347             channel = NULL;
3348             btstack_linked_list_iterator_init(&it, &l2cap_channels);
3349             while (btstack_linked_list_iterator_has_next(&it)){
3350                 l2cap_channel_t * a_channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
3351                 if (!l2cap_is_dynamic_channel_type(a_channel->channel_type)) continue;
3352                 if (a_channel->con_handle   != handle) continue;
3353                 if (a_channel->local_sig_id != sig_id) continue;
3354                 channel = a_channel;
3355                 break;
3356             }
3357             if (!channel) break;
3358 
3359             // cid + 0
3360             result = little_endian_read_16 (command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET+8);
3361             if (result){
3362                 channel->state = L2CAP_STATE_CLOSED;
3363                 // map l2cap connection response result to BTstack status enumeration
3364                 l2cap_emit_le_channel_opened(channel, result);
3365 
3366                 // discard channel
3367                 btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
3368                 l2cap_free_channel_entry(channel);
3369                 break;
3370             }
3371 
3372             // success
3373             channel->remote_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 0);
3374             channel->remote_mtu = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 2);
3375             channel->remote_mps = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 4);
3376             channel->credits_outgoing = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 6);
3377             channel->state = L2CAP_STATE_OPEN;
3378             l2cap_emit_le_channel_opened(channel, result);
3379             break;
3380 
3381         case LE_FLOW_CONTROL_CREDIT:
3382             // check size
3383             if (len < 4u) return 0u;
3384 
3385             // find channel
3386             local_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 0);
3387             channel = l2cap_get_channel_for_local_cid_and_handle(local_cid, handle);
3388             if (!channel) {
3389                 log_error("credit: no channel for cid 0x%02x", local_cid);
3390                 break;
3391             }
3392             new_credits = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 2);
3393             credits_before = channel->credits_outgoing;
3394             channel->credits_outgoing += new_credits;
3395             // check for credit overrun
3396             if (credits_before > channel->credits_outgoing){
3397                 log_error("credit: new credits caused overrrun for cid 0x%02x, disconnecting", local_cid);
3398                 channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
3399                 break;
3400             }
3401             log_info("credit: %u credits for 0x%02x, now %u", new_credits, local_cid, channel->credits_outgoing);
3402             break;
3403 
3404         case DISCONNECTION_REQUEST:
3405 
3406             // check size
3407             if (len < 4u) return 0u;
3408 
3409             // find channel
3410             local_cid = little_endian_read_16(command, L2CAP_SIGNALING_COMMAND_DATA_OFFSET + 0);
3411             channel = l2cap_get_channel_for_local_cid_and_handle(local_cid, handle);
3412             if (!channel) {
3413                 log_error("credit: no channel for cid 0x%02x", local_cid);
3414                 break;
3415             }
3416             channel->remote_sig_id = sig_id;
3417             channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_RESPONSE;
3418             break;
3419 
3420 #endif
3421 
3422         case DISCONNECTION_RESPONSE:
3423             break;
3424 
3425         default:
3426             // command unknown -> reject command
3427             return 0;
3428     }
3429     return 1;
3430 }
3431 #endif
3432 
3433 #ifdef ENABLE_CLASSIC
3434 static void l2cap_acl_classic_handler_for_channel(l2cap_channel_t * l2cap_channel, uint8_t * packet, uint16_t size){
3435 
3436     // forward data only in OPEN state
3437     if (l2cap_channel->state != L2CAP_STATE_OPEN) return;
3438 
3439 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
3440     if (l2cap_channel->mode == L2CAP_CHANNEL_MODE_ENHANCED_RETRANSMISSION){
3441 
3442         int fcs_size = l2cap_channel->fcs_option ? 2 : 0;
3443 
3444         // assert control + FCS fields are inside
3445         if (size < COMPLETE_L2CAP_HEADER+2+fcs_size) return;
3446 
3447         if (l2cap_channel->fcs_option){
3448             // verify FCS (required if one side requested it)
3449             uint16_t fcs_calculated = crc16_calc(&packet[4], size - (4+2));
3450             uint16_t fcs_packet     = little_endian_read_16(packet, size-2);
3451 
3452 #ifdef L2CAP_ERTM_SIMULATE_FCS_ERROR_INTERVAL
3453             // simulate fcs error
3454                         static int counter = 0;
3455                         if (++counter == L2CAP_ERTM_SIMULATE_FCS_ERROR_INTERVAL) {
3456                             log_info("Simulate fcs error");
3457                             fcs_calculated++;
3458                             counter = 0;
3459                         }
3460 #endif
3461 
3462             if (fcs_calculated == fcs_packet){
3463                 log_info("Packet FCS 0x%04x verified", fcs_packet);
3464             } else {
3465                 log_error("FCS mismatch! Packet 0x%04x, calculated 0x%04x", fcs_packet, fcs_calculated);
3466                 // ERTM State Machine in Bluetooth Spec does not handle 'I-Frame with invalid FCS'
3467                 return;
3468             }
3469         }
3470 
3471         // switch on packet type
3472         uint16_t control = little_endian_read_16(packet, COMPLETE_L2CAP_HEADER);
3473         uint8_t  req_seq = (control >> 8) & 0x3f;
3474         int final = (control >> 7) & 0x01;
3475         if (control & 1){
3476             // S-Frame
3477             int poll  = (control >> 4) & 0x01;
3478             l2cap_supervisory_function_t s = (l2cap_supervisory_function_t) ((control >> 2) & 0x03);
3479             log_info("Control: 0x%04x => Supervisory function %u, ReqSeq %02u", control, (int) s, req_seq);
3480             l2cap_ertm_tx_packet_state_t * tx_state;
3481             switch (s){
3482                 case L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY:
3483                     log_info("L2CAP_SUPERVISORY_FUNCTION_RR_RECEIVER_READY");
3484                     l2cap_ertm_process_req_seq(l2cap_channel, req_seq);
3485                     if (poll && final){
3486                         // S-frames shall not be transmitted with both the F-bit and the P-bit set to 1 at the same time.
3487                         log_error("P=F=1 in S-Frame");
3488                         break;
3489                     }
3490                     if (poll){
3491                         // check if we did request selective retransmission before <==> we have stored SDU segments
3492                         int i;
3493                         int num_stored_out_of_order_packets = 0;
3494                         for (i=0;i<l2cap_channel->num_rx_buffers;i++){
3495                             int index = l2cap_channel->rx_store_index + i;
3496                             if (index >= l2cap_channel->num_rx_buffers){
3497                                 index -= l2cap_channel->num_rx_buffers;
3498                             }
3499                             l2cap_ertm_rx_packet_state_t * rx_state = &l2cap_channel->rx_packets_state[index];
3500                             if (!rx_state->valid) continue;
3501                             num_stored_out_of_order_packets++;
3502                         }
3503                         if (num_stored_out_of_order_packets){
3504                             l2cap_channel->send_supervisor_frame_selective_reject = 1;
3505                         } else {
3506                             l2cap_channel->send_supervisor_frame_receiver_ready   = 1;
3507                         }
3508                         l2cap_channel->set_final_bit_after_packet_with_poll_bit_set = 1;
3509                     }
3510                     if (final){
3511                         // Stop-MonitorTimer
3512                         l2cap_ertm_stop_monitor_timer(l2cap_channel);
3513                         // If UnackedFrames > 0 then Start-RetransTimer
3514                         if (l2cap_channel->unacked_frames){
3515                             l2cap_ertm_start_retransmission_timer(l2cap_channel);
3516                         }
3517                         // final bit set <- response to RR with poll bit set. All not acknowledged packets need to be retransmitted
3518                         l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel);
3519                     }
3520                     break;
3521                 case L2CAP_SUPERVISORY_FUNCTION_REJ_REJECT:
3522                     log_info("L2CAP_SUPERVISORY_FUNCTION_REJ_REJECT");
3523                     l2cap_ertm_process_req_seq(l2cap_channel, req_seq);
3524                     // restart transmittion from last unacknowledted packet (earlier packets already freed in l2cap_ertm_process_req_seq)
3525                     l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel);
3526                     break;
3527                 case L2CAP_SUPERVISORY_FUNCTION_RNR_RECEIVER_NOT_READY:
3528                     log_error("L2CAP_SUPERVISORY_FUNCTION_RNR_RECEIVER_NOT_READY");
3529                     break;
3530                 case L2CAP_SUPERVISORY_FUNCTION_SREJ_SELECTIVE_REJECT:
3531                     log_info("L2CAP_SUPERVISORY_FUNCTION_SREJ_SELECTIVE_REJECT");
3532                     if (poll){
3533                         l2cap_ertm_process_req_seq(l2cap_channel, req_seq);
3534                     }
3535                     // find requested i-frame
3536                     tx_state = l2cap_ertm_get_tx_state(l2cap_channel, req_seq);
3537                     if (tx_state){
3538                         log_info("Retransmission for tx_seq %u requested", req_seq);
3539                         l2cap_channel->set_final_bit_after_packet_with_poll_bit_set = poll;
3540                         tx_state->retransmission_requested = 1;
3541                         l2cap_channel->srej_active = 1;
3542                     }
3543                     break;
3544                 default:
3545                     break;
3546             }
3547         } else {
3548             // I-Frame
3549             // get control
3550             l2cap_segmentation_and_reassembly_t sar = (l2cap_segmentation_and_reassembly_t) (control >> 14);
3551             uint8_t tx_seq = (control >> 1) & 0x3f;
3552             log_info("Control: 0x%04x => SAR %u, ReqSeq %02u, R?, TxSeq %02u", control, (int) sar, req_seq, tx_seq);
3553             log_info("SAR: pos %u", l2cap_channel->reassembly_pos);
3554             log_info("State: expected_tx_seq %02u, req_seq %02u", l2cap_channel->expected_tx_seq, l2cap_channel->req_seq);
3555             l2cap_ertm_process_req_seq(l2cap_channel, req_seq);
3556             if (final){
3557                 // final bit set <- response to RR with poll bit set. All not acknowledged packets need to be retransmitted
3558                 l2cap_ertm_retransmit_unacknowleded_frames(l2cap_channel);
3559             }
3560 
3561             // get SDU
3562             const uint8_t * payload_data = &packet[COMPLETE_L2CAP_HEADER+2];
3563             uint16_t        payload_len  = size-(COMPLETE_L2CAP_HEADER+2+fcs_size);
3564 
3565             // assert SDU size is smaller or equal to our buffers
3566             uint16_t max_payload_size = 0;
3567             switch (sar){
3568                 case L2CAP_SEGMENTATION_AND_REASSEMBLY_UNSEGMENTED_L2CAP_SDU:
3569                 case L2CAP_SEGMENTATION_AND_REASSEMBLY_START_OF_L2CAP_SDU:
3570                     // SDU Length + MPS
3571                     max_payload_size = l2cap_channel->local_mps + 2;
3572                     break;
3573                 case L2CAP_SEGMENTATION_AND_REASSEMBLY_CONTINUATION_OF_L2CAP_SDU:
3574                 case L2CAP_SEGMENTATION_AND_REASSEMBLY_END_OF_L2CAP_SDU:
3575                     max_payload_size = l2cap_channel->local_mps;
3576                     break;
3577                 default:
3578                     btstack_assert(false);
3579                     break;
3580             }
3581             if (payload_len > max_payload_size){
3582                 log_info("payload len %u > max payload %u -> drop packet", payload_len, max_payload_size);
3583                 return;
3584             }
3585 
3586             // check ordering
3587             if (l2cap_channel->expected_tx_seq == tx_seq){
3588                 log_info("Received expected frame with TxSeq == ExpectedTxSeq == %02u", tx_seq);
3589                 l2cap_channel->expected_tx_seq = l2cap_next_ertm_seq_nr(l2cap_channel->expected_tx_seq);
3590                 l2cap_channel->req_seq         = l2cap_channel->expected_tx_seq;
3591 
3592                 // process SDU
3593                 l2cap_ertm_handle_in_sequence_sdu(l2cap_channel, sar, payload_data, payload_len);
3594 
3595                 // process stored segments
3596                 while (true){
3597                     int index = l2cap_channel->rx_store_index;
3598                     l2cap_ertm_rx_packet_state_t * rx_state = &l2cap_channel->rx_packets_state[index];
3599                     if (!rx_state->valid) break;
3600 
3601                     log_info("Processing stored frame with TxSeq == ExpectedTxSeq == %02u", l2cap_channel->expected_tx_seq);
3602                     l2cap_channel->expected_tx_seq = l2cap_next_ertm_seq_nr(l2cap_channel->expected_tx_seq);
3603                     l2cap_channel->req_seq         = l2cap_channel->expected_tx_seq;
3604 
3605                     rx_state->valid = 0;
3606                     l2cap_ertm_handle_in_sequence_sdu(l2cap_channel, rx_state->sar, &l2cap_channel->rx_packets_data[index], rx_state->len);
3607 
3608                     // update rx store index
3609                     index++;
3610                     if (index >= l2cap_channel->num_rx_buffers){
3611                         index = 0;
3612                     }
3613                     l2cap_channel->rx_store_index = index;
3614                 }
3615 
3616                 //
3617                 l2cap_channel->send_supervisor_frame_receiver_ready = 1;
3618 
3619             } else {
3620                 int delta = (tx_seq - l2cap_channel->expected_tx_seq) & 0x3f;
3621                 if (delta < 2){
3622                     // store segment
3623                     l2cap_ertm_handle_out_of_sequence_sdu(l2cap_channel, sar, delta, payload_data, payload_len);
3624 
3625                     log_info("Received unexpected frame TxSeq %u but expected %u -> send S-SREJ", tx_seq, l2cap_channel->expected_tx_seq);
3626                     l2cap_channel->send_supervisor_frame_selective_reject = 1;
3627                 } else {
3628                     log_info("Received unexpected frame TxSeq %u but expected %u -> send S-REJ", tx_seq, l2cap_channel->expected_tx_seq);
3629                     l2cap_channel->send_supervisor_frame_reject = 1;
3630                 }
3631             }
3632         }
3633         return;
3634     }
3635 #endif
3636 
3637     // check size
3638     uint16_t payload_size = size - COMPLETE_L2CAP_HEADER;
3639     if (l2cap_channel->local_mtu < payload_size) return;
3640 
3641     l2cap_dispatch_to_channel(l2cap_channel, L2CAP_DATA_PACKET, &packet[COMPLETE_L2CAP_HEADER], payload_size);
3642 }
3643 #endif
3644 
3645 static void l2cap_acl_classic_handler(hci_con_handle_t handle, uint8_t *packet, uint16_t size){
3646 #ifdef ENABLE_CLASSIC
3647     l2cap_channel_t * l2cap_channel;
3648     l2cap_fixed_channel_t * l2cap_fixed_channel;
3649 
3650     uint16_t channel_id = READ_L2CAP_CHANNEL_ID(packet);
3651     uint8_t  broadcast_flag = READ_ACL_FLAGS(packet) >> 2;
3652     switch (channel_id) {
3653 
3654         case L2CAP_CID_SIGNALING: {
3655             if (broadcast_flag != 0) break;
3656             uint32_t command_offset = 8;
3657             while ((command_offset + L2CAP_SIGNALING_COMMAND_DATA_OFFSET) < size) {
3658                 // assert signaling command is fully inside packet
3659                 uint16_t data_len = little_endian_read_16(packet, command_offset + L2CAP_SIGNALING_COMMAND_LENGTH_OFFSET);
3660                 uint32_t next_command_offset = command_offset + L2CAP_SIGNALING_COMMAND_DATA_OFFSET + data_len;
3661                 if (next_command_offset > size){
3662                     log_error("l2cap signaling command len invalid -> drop");
3663                     break;
3664                 }
3665                 // handle signaling command
3666                 l2cap_signaling_handler_dispatch(handle, &packet[command_offset]);
3667                 // go to next command
3668                 command_offset = next_command_offset;
3669             }
3670             break;
3671         }
3672         case L2CAP_CID_CONNECTIONLESS_CHANNEL:
3673             if (broadcast_flag == 0) break;
3674             l2cap_fixed_channel = l2cap_fixed_channel_for_channel_id(L2CAP_CID_CONNECTIONLESS_CHANNEL);
3675             if (!l2cap_fixed_channel) break;
3676             if (!l2cap_fixed_channel->packet_handler) break;
3677             (*l2cap_fixed_channel->packet_handler)(UCD_DATA_PACKET, handle, &packet[COMPLETE_L2CAP_HEADER], size-COMPLETE_L2CAP_HEADER);
3678             break;
3679 
3680         default:
3681             if (broadcast_flag != 0) break;
3682             // Find channel for this channel_id and connection handle
3683             l2cap_channel = l2cap_get_channel_for_local_cid_and_handle(channel_id, handle);
3684             if (l2cap_channel != NULL){
3685                 l2cap_acl_classic_handler_for_channel(l2cap_channel, packet, size);
3686             }
3687             break;
3688     }
3689 #else
3690     UNUSED(handle); // ok: no code
3691     UNUSED(packet); // ok: no code
3692     UNUSED(size);   // ok: no code
3693 #endif
3694 }
3695 
3696 static void l2cap_acl_le_handler(hci_con_handle_t handle, uint8_t *packet, uint16_t size){
3697 #ifdef ENABLE_BLE
3698 
3699     l2cap_fixed_channel_t * l2cap_fixed_channel;
3700 
3701 #ifdef ENABLE_LE_DATA_CHANNELS
3702     l2cap_channel_t * l2cap_channel;
3703 #endif
3704     uint16_t channel_id = READ_L2CAP_CHANNEL_ID(packet);
3705     switch (channel_id) {
3706 
3707         case L2CAP_CID_SIGNALING_LE: {
3708             uint16_t sig_id = packet[COMPLETE_L2CAP_HEADER + 1];
3709             uint16_t len = little_endian_read_16(packet, COMPLETE_L2CAP_HEADER + 2);
3710             if ((COMPLETE_L2CAP_HEADER + 4u + len) > size) break;
3711             int      valid  = l2cap_le_signaling_handler_dispatch(handle, &packet[COMPLETE_L2CAP_HEADER], sig_id);
3712             if (!valid){
3713                 l2cap_register_signaling_response(handle, COMMAND_REJECT_LE, sig_id, 0, L2CAP_REJ_CMD_UNKNOWN);
3714             }
3715             break;
3716         }
3717 
3718         case L2CAP_CID_ATTRIBUTE_PROTOCOL:
3719             l2cap_fixed_channel = l2cap_fixed_channel_for_channel_id(L2CAP_CID_ATTRIBUTE_PROTOCOL);
3720             if (!l2cap_fixed_channel) break;
3721             if (!l2cap_fixed_channel->packet_handler) break;
3722             (*l2cap_fixed_channel->packet_handler)(ATT_DATA_PACKET, handle, &packet[COMPLETE_L2CAP_HEADER], size-COMPLETE_L2CAP_HEADER);
3723             break;
3724 
3725         case L2CAP_CID_SECURITY_MANAGER_PROTOCOL:
3726             l2cap_fixed_channel = l2cap_fixed_channel_for_channel_id(L2CAP_CID_SECURITY_MANAGER_PROTOCOL);
3727             if (!l2cap_fixed_channel) break;
3728             if (!l2cap_fixed_channel->packet_handler) break;
3729             (*l2cap_fixed_channel->packet_handler)(SM_DATA_PACKET, handle, &packet[COMPLETE_L2CAP_HEADER], size-COMPLETE_L2CAP_HEADER);
3730             break;
3731 
3732         default:
3733 
3734 #ifdef ENABLE_LE_DATA_CHANNELS
3735             l2cap_channel = l2cap_get_channel_for_local_cid_and_handle(channel_id, handle);
3736             if (l2cap_channel != NULL) {
3737                 // credit counting
3738                 if (l2cap_channel->credits_incoming == 0u){
3739                     log_info("LE Data Channel packet received but no incoming credits");
3740                     l2cap_channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
3741                     break;
3742                 }
3743                 l2cap_channel->credits_incoming--;
3744 
3745                 // automatic credits
3746                 if ((l2cap_channel->credits_incoming < L2CAP_LE_DATA_CHANNELS_AUTOMATIC_CREDITS_WATERMARK) && l2cap_channel->automatic_credits){
3747                     l2cap_channel->new_credits_incoming = L2CAP_LE_DATA_CHANNELS_AUTOMATIC_CREDITS_INCREMENT;
3748                 }
3749 
3750                 // first fragment
3751                 uint16_t pos = 0;
3752                 if (!l2cap_channel->receive_sdu_len){
3753                     uint16_t sdu_len = little_endian_read_16(packet, COMPLETE_L2CAP_HEADER);
3754                     if(sdu_len > l2cap_channel->local_mtu) break;   // SDU would be larger than our buffer
3755                     l2cap_channel->receive_sdu_len = sdu_len;
3756                     l2cap_channel->receive_sdu_pos = 0;
3757                     pos  += 2u;
3758                     size -= 2u;
3759                 }
3760                 uint16_t fragment_size   = size-COMPLETE_L2CAP_HEADER;
3761                 uint16_t remaining_space = l2cap_channel->local_mtu - l2cap_channel->receive_sdu_pos;
3762                 if (fragment_size > remaining_space) break;         // SDU would cause buffer overrun
3763                 (void)memcpy(&l2cap_channel->receive_sdu_buffer[l2cap_channel->receive_sdu_pos],
3764                              &packet[COMPLETE_L2CAP_HEADER + pos],
3765                              fragment_size);
3766                 l2cap_channel->receive_sdu_pos += size - COMPLETE_L2CAP_HEADER;
3767                 // done?
3768                 log_debug("le packet pos %u, len %u", l2cap_channel->receive_sdu_pos, l2cap_channel->receive_sdu_len);
3769                 if (l2cap_channel->receive_sdu_pos >= l2cap_channel->receive_sdu_len){
3770                     l2cap_dispatch_to_channel(l2cap_channel, L2CAP_DATA_PACKET, l2cap_channel->receive_sdu_buffer, l2cap_channel->receive_sdu_len);
3771                     l2cap_channel->receive_sdu_len = 0;
3772                 }
3773             }
3774 #endif
3775             break;
3776     }
3777 #else
3778     UNUSED(handle); // ok: no code
3779     UNUSED(packet); // ok: no code
3780     UNUSED(size);   // ok: no code
3781 #endif
3782 }
3783 
3784 static void l2cap_acl_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size){
3785     UNUSED(packet_type);    // ok: registered with hci_register_acl_packet_handler
3786     UNUSED(channel);        // ok: there is no channel
3787 
3788     // Assert full L2CAP header present
3789     if (size < COMPLETE_L2CAP_HEADER) return;
3790 
3791     // Dispatch to Classic or LE handler (SCO packets are not dispatched to L2CAP)
3792     hci_con_handle_t handle = READ_ACL_CONNECTION_HANDLE(packet);
3793     hci_connection_t *conn = hci_connection_for_handle(handle);
3794     if (!conn) return;
3795     if (conn->address_type == BD_ADDR_TYPE_ACL){
3796         l2cap_acl_classic_handler(handle, packet, size);
3797     } else {
3798         l2cap_acl_le_handler(handle, packet, size);
3799     }
3800 
3801     l2cap_run();
3802 }
3803 
3804 // Bluetooth 4.0 - allows to register handler for Attribute Protocol and Security Manager Protocol
3805 void l2cap_register_fixed_channel(btstack_packet_handler_t packet_handler, uint16_t channel_id) {
3806     l2cap_fixed_channel_t * channel = l2cap_fixed_channel_for_channel_id(channel_id);
3807     if (!channel) return;
3808     channel->packet_handler = packet_handler;
3809 }
3810 
3811 #ifdef ENABLE_CLASSIC
3812 // finalize closed channel - l2cap_handle_disconnect_request & DISCONNECTION_RESPONSE
3813 void l2cap_finialize_channel_close(l2cap_channel_t * channel){
3814     channel->state = L2CAP_STATE_CLOSED;
3815     l2cap_handle_channel_closed(channel);
3816     // discard channel
3817     btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
3818     l2cap_free_channel_entry(channel);
3819 }
3820 #endif
3821 
3822 #ifdef L2CAP_USES_CHANNELS
3823 static l2cap_service_t * l2cap_get_service_internal(btstack_linked_list_t * services, uint16_t psm){
3824     btstack_linked_list_iterator_t it;
3825     btstack_linked_list_iterator_init(&it, services);
3826     while (btstack_linked_list_iterator_has_next(&it)){
3827         l2cap_service_t * service = (l2cap_service_t *) btstack_linked_list_iterator_next(&it);
3828         if ( service->psm == psm){
3829             return service;
3830         };
3831     }
3832     return NULL;
3833 }
3834 #endif
3835 
3836 #ifdef ENABLE_CLASSIC
3837 static inline l2cap_service_t * l2cap_get_service(uint16_t psm){
3838     return l2cap_get_service_internal(&l2cap_services, psm);
3839 }
3840 
3841 static void l2cap_update_minimal_security_level(void){
3842     // update minimal service security level
3843     gap_security_level_t minimal_level = LEVEL_1;
3844     btstack_linked_list_iterator_t it;
3845     btstack_linked_list_iterator_init(&it, &l2cap_services);
3846     while (btstack_linked_list_iterator_has_next(&it)){
3847         l2cap_service_t * service = (l2cap_service_t *) btstack_linked_list_iterator_next(&it);
3848         if (service->required_security_level > minimal_level){
3849             minimal_level = service->required_security_level;
3850         };
3851     }
3852     gap_set_minimal_service_security_level(minimal_level);
3853 }
3854 
3855 uint8_t l2cap_register_service(btstack_packet_handler_t service_packet_handler, uint16_t psm, uint16_t mtu, gap_security_level_t security_level){
3856 
3857     log_info("L2CAP_REGISTER_SERVICE psm 0x%x mtu %u", psm, mtu);
3858 
3859     // check for alread registered psm
3860     l2cap_service_t *service = l2cap_get_service(psm);
3861     if (service) {
3862         log_error("register: PSM %u already registered", psm);
3863         return L2CAP_SERVICE_ALREADY_REGISTERED;
3864     }
3865 
3866     // alloc structure
3867     service = btstack_memory_l2cap_service_get();
3868     if (!service) {
3869         log_error("register: no memory for l2cap_service_t");
3870         return BTSTACK_MEMORY_ALLOC_FAILED;
3871     }
3872 
3873     // fill in
3874     service->psm = psm;
3875     service->mtu = mtu;
3876     service->packet_handler = service_packet_handler;
3877     service->required_security_level = security_level;
3878 
3879     // add to services list
3880     btstack_linked_list_add(&l2cap_services, (btstack_linked_item_t *) service);
3881 
3882     l2cap_update_minimal_security_level();
3883 
3884 #ifndef ENABLE_EXPLICIT_CONNECTABLE_MODE_CONTROL
3885     // enable page scan
3886     gap_connectable_control(1);
3887 #endif
3888 
3889 
3890     return ERROR_CODE_SUCCESS;
3891 }
3892 
3893 uint8_t l2cap_unregister_service(uint16_t psm){
3894 
3895     log_info("unregister psm 0x%x", psm);
3896 
3897     l2cap_service_t *service = l2cap_get_service(psm);
3898     if (!service) return L2CAP_SERVICE_DOES_NOT_EXIST;
3899     btstack_linked_list_remove(&l2cap_services, (btstack_linked_item_t *) service);
3900     btstack_memory_l2cap_service_free(service);
3901 
3902     l2cap_update_minimal_security_level();
3903 
3904 #ifndef ENABLE_EXPLICIT_CONNECTABLE_MODE_CONTROL
3905     // disable page scan when no services registered
3906     if (btstack_linked_list_empty(&l2cap_services)) {
3907         gap_connectable_control(0);
3908     }
3909 #endif
3910 
3911     return ERROR_CODE_SUCCESS;
3912 }
3913 #endif
3914 
3915 
3916 #ifdef ENABLE_LE_DATA_CHANNELS
3917 
3918 static void l2cap_le_notify_channel_can_send(l2cap_channel_t *channel){
3919     if (!channel->waiting_for_can_send_now) return;
3920     if (channel->send_sdu_buffer) return;
3921     channel->waiting_for_can_send_now = 0;
3922     log_debug("le can send now, local_cid 0x%x", channel->local_cid);
3923     l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_LE_CAN_SEND_NOW);
3924 }
3925 
3926 // 1BH2222
3927 static void l2cap_emit_le_incoming_connection(l2cap_channel_t *channel) {
3928     log_info("le incoming addr_type %u, addr %s handle 0x%x psm 0x%x local_cid 0x%x remote_cid 0x%x, remote_mtu %u",
3929              channel->address_type, bd_addr_to_str(channel->address), channel->con_handle,  channel->psm, channel->local_cid, channel->remote_cid, channel->remote_mtu);
3930     uint8_t event[19];
3931     event[0] = L2CAP_EVENT_LE_INCOMING_CONNECTION;
3932     event[1] = sizeof(event) - 2u;
3933     event[2] = channel->address_type;
3934     reverse_bd_addr(channel->address, &event[3]);
3935     little_endian_store_16(event,  9, channel->con_handle);
3936     little_endian_store_16(event, 11, channel->psm);
3937     little_endian_store_16(event, 13, channel->local_cid);
3938     little_endian_store_16(event, 15, channel->remote_cid);
3939     little_endian_store_16(event, 17, channel->remote_mtu);
3940     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
3941     l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event));
3942 }
3943 // 11BH22222
3944 static void l2cap_emit_le_channel_opened(l2cap_channel_t *channel, uint8_t status) {
3945     log_info("opened le channel 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",
3946              status, channel->address_type, bd_addr_to_str(channel->address), channel->con_handle, channel->psm,
3947              channel->local_cid, channel->remote_cid, channel->local_mtu, channel->remote_mtu);
3948     uint8_t event[23];
3949     event[0] = L2CAP_EVENT_LE_CHANNEL_OPENED;
3950     event[1] = sizeof(event) - 2u;
3951     event[2] = status;
3952     event[3] = channel->address_type;
3953     reverse_bd_addr(channel->address, &event[4]);
3954     little_endian_store_16(event, 10, channel->con_handle);
3955     event[12] = (channel->state_var & L2CAP_CHANNEL_STATE_VAR_INCOMING) ? 1 : 0;
3956     little_endian_store_16(event, 13, channel->psm);
3957     little_endian_store_16(event, 15, channel->local_cid);
3958     little_endian_store_16(event, 17, channel->remote_cid);
3959     little_endian_store_16(event, 19, channel->local_mtu);
3960     little_endian_store_16(event, 21, channel->remote_mtu);
3961     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
3962     l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event));
3963 }
3964 // 2
3965 static void l2cap_emit_le_channel_closed(l2cap_channel_t * channel){
3966     log_info("closed local_cid 0x%x", channel->local_cid);
3967     uint8_t event[4];
3968     event[0] = L2CAP_EVENT_LE_CHANNEL_CLOSED;
3969     event[1] = sizeof(event) - 2u;
3970     little_endian_store_16(event, 2, channel->local_cid);
3971     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
3972     l2cap_dispatch_to_channel(channel, HCI_EVENT_PACKET, event, sizeof(event));
3973 }
3974 
3975 static void l2cap_le_send_pdu(l2cap_channel_t *channel){
3976     btstack_assert(channel != NULL);
3977     btstack_assert(channel->send_sdu_buffer != NULL);
3978     btstack_assert(channel->credits_outgoing > 0);
3979 
3980     // send part of SDU
3981     hci_reserve_packet_buffer();
3982     uint8_t * acl_buffer = hci_get_outgoing_packet_buffer();
3983     uint8_t * l2cap_payload = acl_buffer + 8;
3984     uint16_t pos = 0;
3985     if (!channel->send_sdu_pos){
3986         // store SDU len
3987         channel->send_sdu_pos += 2u;
3988         little_endian_store_16(l2cap_payload, pos, channel->send_sdu_len);
3989         pos += 2u;
3990     }
3991     uint16_t payload_size = btstack_min(channel->send_sdu_len + 2u - channel->send_sdu_pos, channel->remote_mps - pos);
3992     log_info("len %u, pos %u => payload %u, credits %u", channel->send_sdu_len, channel->send_sdu_pos, payload_size, channel->credits_outgoing);
3993     (void)memcpy(&l2cap_payload[pos],
3994                  &channel->send_sdu_buffer[channel->send_sdu_pos - 2u],
3995                  payload_size); // -2 for virtual SDU len
3996     pos += payload_size;
3997     channel->send_sdu_pos += payload_size;
3998     l2cap_setup_header(acl_buffer, channel->con_handle, 0, channel->remote_cid, pos);
3999 
4000     channel->credits_outgoing--;
4001 
4002     hci_send_acl_packet_buffer(8u + pos);
4003 
4004     if (channel->send_sdu_pos >= (channel->send_sdu_len + 2u)){
4005         channel->send_sdu_buffer = NULL;
4006         // send done event
4007         l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_LE_PACKET_SENT);
4008         // inform about can send now
4009         l2cap_le_notify_channel_can_send(channel);
4010     }
4011 }
4012 
4013 // finalize closed channel - l2cap_handle_disconnect_request & DISCONNECTION_RESPONSE
4014 void l2cap_le_finialize_channel_close(l2cap_channel_t * channel){
4015     channel->state = L2CAP_STATE_CLOSED;
4016     l2cap_emit_simple_event_with_cid(channel, L2CAP_EVENT_CHANNEL_CLOSED);
4017     // discard channel
4018     btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
4019     l2cap_free_channel_entry(channel);
4020 }
4021 
4022 static inline l2cap_service_t * l2cap_le_get_service(uint16_t le_psm){
4023     return l2cap_get_service_internal(&l2cap_le_services, le_psm);
4024 }
4025 
4026 uint8_t l2cap_le_register_service(btstack_packet_handler_t packet_handler, uint16_t psm, gap_security_level_t security_level){
4027 
4028     log_info("L2CAP_LE_REGISTER_SERVICE psm 0x%x", psm);
4029 
4030     // check for alread registered psm
4031     l2cap_service_t *service = l2cap_le_get_service(psm);
4032     if (service) {
4033         return L2CAP_SERVICE_ALREADY_REGISTERED;
4034     }
4035 
4036     // alloc structure
4037     service = btstack_memory_l2cap_service_get();
4038     if (!service) {
4039         log_error("register: no memory for l2cap_service_t");
4040         return BTSTACK_MEMORY_ALLOC_FAILED;
4041     }
4042 
4043     // fill in
4044     service->psm = psm;
4045     service->mtu = 0;
4046     service->packet_handler = packet_handler;
4047     service->required_security_level = security_level;
4048 
4049     // add to services list
4050     btstack_linked_list_add(&l2cap_le_services, (btstack_linked_item_t *) service);
4051 
4052     // done
4053     return ERROR_CODE_SUCCESS;
4054 }
4055 
4056 uint8_t l2cap_le_unregister_service(uint16_t psm) {
4057     log_info("L2CAP_LE_UNREGISTER_SERVICE psm 0x%x", psm);
4058     l2cap_service_t *service = l2cap_le_get_service(psm);
4059     if (!service) return L2CAP_SERVICE_DOES_NOT_EXIST;
4060 
4061     btstack_linked_list_remove(&l2cap_le_services, (btstack_linked_item_t *) service);
4062     btstack_memory_l2cap_service_free(service);
4063     return ERROR_CODE_SUCCESS;
4064 }
4065 
4066 uint8_t l2cap_le_accept_connection(uint16_t local_cid, uint8_t * receive_sdu_buffer, uint16_t mtu, uint16_t initial_credits){
4067     // get channel
4068     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4069     if (!channel) return L2CAP_LOCAL_CID_DOES_NOT_EXIST;
4070 
4071     // validate state
4072     if (channel->state != L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT){
4073         return ERROR_CODE_COMMAND_DISALLOWED;
4074     }
4075 
4076     // set state accept connection
4077     channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_ACCEPT;
4078     channel->receive_sdu_buffer = receive_sdu_buffer;
4079     channel->local_mtu = mtu;
4080     channel->new_credits_incoming = initial_credits;
4081     channel->automatic_credits  = initial_credits == L2CAP_LE_AUTOMATIC_CREDITS;
4082 
4083     // test
4084     // channel->new_credits_incoming = 1;
4085 
4086     // go
4087     l2cap_run();
4088     return ERROR_CODE_SUCCESS;
4089 }
4090 
4091 /**
4092  * @brief Deny incoming LE Data Channel connection due to resource constraints
4093  * @param local_cid             L2CAP LE Data Channel Identifier
4094  */
4095 
4096 uint8_t l2cap_le_decline_connection(uint16_t local_cid){
4097     // get channel
4098     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4099     if (!channel) return L2CAP_LOCAL_CID_DOES_NOT_EXIST;
4100 
4101     // validate state
4102     if (channel->state != L2CAP_STATE_WAIT_CLIENT_ACCEPT_OR_REJECT){
4103         return ERROR_CODE_COMMAND_DISALLOWED;
4104     }
4105 
4106     // set state decline connection
4107     channel->state  = L2CAP_STATE_WILL_SEND_LE_CONNECTION_RESPONSE_DECLINE;
4108     channel->reason = 0x04; // no resources available
4109     l2cap_run();
4110     return ERROR_CODE_SUCCESS;
4111 }
4112 
4113 static gap_security_level_t l2cap_le_security_level_for_connection(hci_con_handle_t con_handle){
4114     uint8_t encryption_key_size = gap_encryption_key_size(con_handle);
4115     if (encryption_key_size == 0) return LEVEL_0;
4116 
4117     uint8_t authenticated = gap_authenticated(con_handle);
4118     if (!authenticated) return LEVEL_2;
4119 
4120     return encryption_key_size == 16 ? LEVEL_4 : LEVEL_3;
4121 }
4122 
4123 // used to handle pairing complete after triggering to increase
4124 static void l2cap_sm_packet_handler(uint8_t packet_type, uint16_t channel_nr, uint8_t *packet, uint16_t size) {
4125     UNUSED(channel_nr);
4126     UNUSED(size);
4127     UNUSED(packet_type);
4128     btstack_assert(packet_type == HCI_EVENT_PACKET);
4129     if (hci_event_packet_get_type(packet) != SM_EVENT_PAIRING_COMPLETE) return;
4130     hci_con_handle_t con_handle = sm_event_pairing_complete_get_handle(packet);
4131     btstack_linked_list_iterator_t it;
4132     btstack_linked_list_iterator_init(&it, &l2cap_channels);
4133     while (btstack_linked_list_iterator_has_next(&it)) {
4134         l2cap_channel_t *channel = (l2cap_channel_t *) btstack_linked_list_iterator_next(&it);
4135         if (!l2cap_is_dynamic_channel_type(channel->channel_type)) continue;
4136         if (channel->con_handle != con_handle) continue;
4137         if (channel->state != L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE) continue;
4138 
4139         // found channel, check security level
4140         if (l2cap_le_security_level_for_connection(con_handle) < channel->required_security_level){
4141             // pairing failed or wasn't good enough, inform user
4142             l2cap_emit_le_channel_opened(channel, ERROR_CODE_INSUFFICIENT_SECURITY);
4143             // discard channel
4144             btstack_linked_list_remove(&l2cap_channels, (btstack_linked_item_t *) channel);
4145             l2cap_free_channel_entry(channel);
4146         } else {
4147             // send conn request now
4148             channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST;
4149             l2cap_run();
4150         }
4151     }
4152 }
4153 
4154 uint8_t l2cap_le_create_channel(btstack_packet_handler_t packet_handler, hci_con_handle_t con_handle,
4155     uint16_t psm, uint8_t * receive_sdu_buffer, uint16_t mtu, uint16_t initial_credits, gap_security_level_t security_level,
4156     uint16_t * out_local_cid) {
4157 
4158     static btstack_packet_callback_registration_t sm_event_callback_registration;
4159     static bool sm_callback_registered = false;
4160 
4161     log_info("create, handle 0x%04x psm 0x%x mtu %u", con_handle, psm, mtu);
4162 
4163     hci_connection_t * connection = hci_connection_for_handle(con_handle);
4164     if (!connection) {
4165         log_error("no hci_connection for handle 0x%04x", con_handle);
4166         return ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER;
4167     }
4168 
4169     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);
4170     if (!channel) {
4171         return BTSTACK_MEMORY_ALLOC_FAILED;
4172     }
4173     log_info("created %p", channel);
4174 
4175     // store local_cid
4176     if (out_local_cid){
4177        *out_local_cid = channel->local_cid;
4178     }
4179 
4180     // setup channel entry
4181     channel->con_handle = con_handle;
4182     channel->receive_sdu_buffer = receive_sdu_buffer;
4183     channel->new_credits_incoming = initial_credits;
4184     channel->automatic_credits    = initial_credits == L2CAP_LE_AUTOMATIC_CREDITS;
4185 
4186     // add to connections list
4187     btstack_linked_list_add_tail(&l2cap_channels, (btstack_linked_item_t *) channel);
4188 
4189     // check security level
4190     if (l2cap_le_security_level_for_connection(con_handle) < channel->required_security_level){
4191         if (!sm_callback_registered){
4192             sm_callback_registered = true;
4193             // lazy registration for SM events
4194             sm_event_callback_registration.callback = &l2cap_sm_packet_handler;
4195             sm_add_event_handler(&sm_event_callback_registration);
4196         }
4197 
4198         // start pairing
4199         channel->state = L2CAP_STATE_WAIT_OUTGOING_SECURITY_LEVEL_UPDATE;
4200         sm_request_pairing(con_handle);
4201     } else {
4202         // send conn request right away
4203         channel->state = L2CAP_STATE_WILL_SEND_LE_CONNECTION_REQUEST;
4204         l2cap_run();
4205     }
4206 
4207     return ERROR_CODE_SUCCESS;
4208 }
4209 
4210 /**
4211  * @brief Provide credtis for LE Data Channel
4212  * @param local_cid             L2CAP LE Data Channel Identifier
4213  * @param credits               Number additional credits for peer
4214  */
4215 uint8_t l2cap_le_provide_credits(uint16_t local_cid, uint16_t credits){
4216 
4217     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4218     if (!channel) {
4219         log_error("le credits no channel for cid 0x%02x", local_cid);
4220         return L2CAP_LOCAL_CID_DOES_NOT_EXIST;
4221     }
4222 
4223     // check state
4224     if (channel->state != L2CAP_STATE_OPEN){
4225         log_error("le credits but channel 0x%02x not open yet", local_cid);
4226     }
4227 
4228     // assert incoming credits + credits <= 0xffff
4229     uint32_t total_credits = channel->credits_incoming;
4230     total_credits += channel->new_credits_incoming;
4231     total_credits += credits;
4232     if (total_credits > 0xffffu){
4233         log_error("le credits overrun: current %u, scheduled %u, additional %u", channel->credits_incoming,
4234             channel->new_credits_incoming, credits);
4235     }
4236 
4237     // set credits_granted
4238     channel->new_credits_incoming += credits;
4239 
4240     // go
4241     l2cap_run();
4242     return ERROR_CODE_SUCCESS;
4243 }
4244 
4245 /**
4246  * @brief Check if outgoing buffer is available and that there's space on the Bluetooth module
4247  * @param local_cid             L2CAP LE Data Channel Identifier
4248  */
4249 int l2cap_le_can_send_now(uint16_t local_cid){
4250     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4251     if (!channel) {
4252         log_error("le can send now, no channel for cid 0x%02x", local_cid);
4253         return 0;
4254     }
4255 
4256     // check state
4257     if (channel->state != L2CAP_STATE_OPEN) return 0;
4258 
4259     // check queue
4260     if (channel->send_sdu_buffer) return 0;
4261 
4262     // fine, go ahead
4263     return 1;
4264 }
4265 
4266 /**
4267  * @brief Request emission of L2CAP_EVENT_CAN_SEND_NOW as soon as possible
4268  * @note L2CAP_EVENT_CAN_SEND_NOW might be emitted during call to this function
4269  *       so packet handler should be ready to handle it
4270  * @param local_cid             L2CAP LE Data Channel Identifier
4271  */
4272 uint8_t l2cap_le_request_can_send_now_event(uint16_t local_cid){
4273     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4274     if (!channel) {
4275         log_error("can send now, no channel for cid 0x%02x", local_cid);
4276         return L2CAP_LOCAL_CID_DOES_NOT_EXIST;
4277     }
4278     channel->waiting_for_can_send_now = 1;
4279     l2cap_le_notify_channel_can_send(channel);
4280     return ERROR_CODE_SUCCESS;
4281 }
4282 
4283 /**
4284  * @brief Send data via LE Data Channel
4285  * @note Since data larger then the maximum PDU needs to be segmented into multiple PDUs, data needs to stay valid until ... event
4286  * @param local_cid             L2CAP LE Data Channel Identifier
4287  * @param data                  data to send
4288  * @param size                  data size
4289  */
4290 uint8_t l2cap_le_send_data(uint16_t local_cid, uint8_t * data, uint16_t size){
4291 
4292     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4293     if (!channel) {
4294         log_error("l2cap send, no channel for cid 0x%02x", local_cid);
4295         return L2CAP_LOCAL_CID_DOES_NOT_EXIST;
4296     }
4297 
4298     if (size > channel->remote_mtu){
4299         log_error("l2cap send, cid 0x%02x, data length exceeds remote MTU.", local_cid);
4300         return L2CAP_DATA_LEN_EXCEEDS_REMOTE_MTU;
4301     }
4302 
4303     if (channel->send_sdu_buffer){
4304         log_info("l2cap send, cid 0x%02x, cannot send", local_cid);
4305         return BTSTACK_ACL_BUFFERS_FULL;
4306     }
4307 
4308     channel->send_sdu_buffer = data;
4309     channel->send_sdu_len    = size;
4310     channel->send_sdu_pos    = 0;
4311 
4312     l2cap_notify_channel_can_send();
4313     return ERROR_CODE_SUCCESS;
4314 }
4315 
4316 /**
4317  * @brief Disconnect from LE Data Channel
4318  * @param local_cid             L2CAP LE Data Channel Identifier
4319  */
4320 uint8_t l2cap_le_disconnect(uint16_t local_cid)
4321 {
4322     l2cap_channel_t * channel = l2cap_get_channel_for_local_cid(local_cid);
4323     if (!channel) {
4324         log_error("l2cap send, no channel for cid 0x%02x", local_cid);
4325         return L2CAP_LOCAL_CID_DOES_NOT_EXIST;
4326     }
4327 
4328     channel->state = L2CAP_STATE_WILL_SEND_DISCONNECT_REQUEST;
4329     l2cap_run();
4330     return ERROR_CODE_SUCCESS;
4331 }
4332 
4333 #endif
4334