xref: /btstack/src/hci.c (revision 3c68dfa95270f07cc32a4a1b1e28bb5afff5d666)
1 /*
2  * Copyright (C) 2009-2012 by Matthias Ringwald
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 MATTHIAS RINGWALD 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 [email protected]
34  *
35  */
36 
37 /*
38  *  hci.c
39  *
40  *  Created by Matthias Ringwald on 4/29/09.
41  *
42  */
43 
44 #include "config.h"
45 
46 #include "hci.h"
47 #include "gap.h"
48 
49 #include <stdarg.h>
50 #include <string.h>
51 #include <stdio.h>
52 
53 #ifndef EMBEDDED
54 #include <unistd.h> // gethostbyname
55 #include <btstack/version.h>
56 #endif
57 
58 #include "btstack_memory.h"
59 #include "debug.h"
60 #include "hci_dump.h"
61 
62 #include <btstack/hci_cmds.h>
63 
64 #define HCI_CONNECTION_TIMEOUT_MS 10000
65 
66 #define HCI_INTIALIZING_SUBSTATE_AFTER_SLEEP 11
67 
68 #ifdef USE_BLUETOOL
69 #include "bt_control_iphone.h"
70 #endif
71 
72 static void hci_update_scan_enable(void);
73 
74 // the STACK is here
75 static hci_stack_t       hci_stack;
76 
77 /**
78  * get connection for a given handle
79  *
80  * @return connection OR NULL, if not found
81  */
82 hci_connection_t * hci_connection_for_handle(hci_con_handle_t con_handle){
83     linked_item_t *it;
84     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
85         if ( ((hci_connection_t *) it)->con_handle == con_handle){
86             return (hci_connection_t *) it;
87         }
88     }
89     return NULL;
90 }
91 
92 static void hci_connection_timeout_handler(timer_source_t *timer){
93     hci_connection_t * connection = (hci_connection_t *) linked_item_get_user(&timer->item);
94 #ifdef HAVE_TIME
95     struct timeval tv;
96     gettimeofday(&tv, NULL);
97     if (tv.tv_sec >= connection->timestamp.tv_sec + HCI_CONNECTION_TIMEOUT_MS/1000) {
98         // connections might be timed out
99         hci_emit_l2cap_check_timeout(connection);
100     }
101 #endif
102 #ifdef HAVE_TICK
103     if (embedded_get_ticks() > connection->timestamp + embedded_ticks_for_ms(HCI_CONNECTION_TIMEOUT_MS)){
104         // connections might be timed out
105         hci_emit_l2cap_check_timeout(connection);
106     }
107 #endif
108     run_loop_set_timer(timer, HCI_CONNECTION_TIMEOUT_MS);
109     run_loop_add_timer(timer);
110 }
111 
112 static void hci_connection_timestamp(hci_connection_t *connection){
113 #ifdef HAVE_TIME
114     gettimeofday(&connection->timestamp, NULL);
115 #endif
116 #ifdef HAVE_TICK
117     connection->timestamp = embedded_get_ticks();
118 #endif
119 }
120 
121 /**
122  * create connection for given address
123  *
124  * @return connection OR NULL, if no memory left
125  */
126 static hci_connection_t * create_connection_for_addr(bd_addr_t addr){
127     hci_connection_t * conn = (hci_connection_t *) btstack_memory_hci_connection_get();
128     if (!conn) return NULL;
129     BD_ADDR_COPY(conn->address, addr);
130     conn->con_handle = 0xffff;
131     conn->authentication_flags = AUTH_FLAGS_NONE;
132     conn->bonding_flags = 0;
133     linked_item_set_user(&conn->timeout.item, conn);
134     conn->timeout.process = hci_connection_timeout_handler;
135     hci_connection_timestamp(conn);
136     conn->acl_recombination_length = 0;
137     conn->acl_recombination_pos = 0;
138     conn->num_acl_packets_sent = 0;
139     linked_list_add(&hci_stack.connections, (linked_item_t *) conn);
140     return conn;
141 }
142 
143 /**
144  * get connection for given address
145  *
146  * @return connection OR NULL, if not found
147  */
148 static hci_connection_t * connection_for_address(bd_addr_t address){
149     linked_item_t *it;
150     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
151         if ( ! BD_ADDR_CMP( ((hci_connection_t *) it)->address, address) ){
152             return (hci_connection_t *) it;
153         }
154     }
155     return NULL;
156 }
157 
158 inline static void connectionSetAuthenticationFlags(hci_connection_t * conn, hci_authentication_flags_t flags){
159     conn->authentication_flags = (hci_authentication_flags_t)(conn->authentication_flags | flags);
160 }
161 
162 inline static void connectionClearAuthenticationFlags(hci_connection_t * conn, hci_authentication_flags_t flags){
163     conn->authentication_flags = (hci_authentication_flags_t)(conn->authentication_flags & ~flags);
164 }
165 
166 
167 /**
168  * add authentication flags and reset timer
169  */
170 static void hci_add_connection_flags_for_flipped_bd_addr(uint8_t *bd_addr, hci_authentication_flags_t flags){
171     bd_addr_t addr;
172     bt_flip_addr(addr, *(bd_addr_t *) bd_addr);
173     hci_connection_t * conn = connection_for_address(addr);
174     if (conn) {
175         connectionSetAuthenticationFlags(conn, flags);
176         hci_connection_timestamp(conn);
177     }
178 }
179 
180 int  hci_authentication_active_for_handle(hci_con_handle_t handle){
181     hci_connection_t * conn = hci_connection_for_handle(handle);
182     if (!conn) return 0;
183     if (!conn->authentication_flags) return 0;
184     if (conn->authentication_flags & SENT_LINK_KEY_REPLY) return 0;
185     if (conn->authentication_flags & RECV_LINK_KEY_NOTIFICATION) return 0;
186     return 1;
187 }
188 
189 void hci_drop_link_key_for_bd_addr(bd_addr_t *addr){
190     if (hci_stack.remote_device_db) {
191         hci_stack.remote_device_db->delete_link_key(addr);
192     }
193 }
194 
195 
196 /**
197  * count connections
198  */
199 static int nr_hci_connections(void){
200     int count = 0;
201     linked_item_t *it;
202     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next, count++);
203     return count;
204 }
205 
206 /**
207  * Dummy handler called by HCI
208  */
209 static void dummy_handler(uint8_t packet_type, uint8_t *packet, uint16_t size){
210 }
211 
212 uint8_t hci_number_outgoing_packets(hci_con_handle_t handle){
213     hci_connection_t * connection = hci_connection_for_handle(handle);
214     if (!connection) {
215         log_error("hci_number_outgoing_packets connectino for handle %u does not exist!\n", handle);
216         return 0;
217     }
218     return connection->num_acl_packets_sent;
219 }
220 
221 uint8_t hci_number_free_acl_slots(){
222     uint8_t free_slots = hci_stack.total_num_acl_packets;
223     linked_item_t *it;
224     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
225         hci_connection_t * connection = (hci_connection_t *) it;
226         if (free_slots < connection->num_acl_packets_sent) {
227             log_error("hci_number_free_acl_slots: sum of outgoing packets > total acl packets!\n");
228             return 0;
229         }
230         free_slots -= connection->num_acl_packets_sent;
231     }
232     return free_slots;
233 }
234 
235 int hci_can_send_packet_now(uint8_t packet_type){
236 
237     // check for async hci transport implementations
238     if (hci_stack.hci_transport->can_send_packet_now){
239         if (!hci_stack.hci_transport->can_send_packet_now(packet_type)){
240             return 0;
241         }
242     }
243 
244     // check regular Bluetooth flow control
245     switch (packet_type) {
246         case HCI_ACL_DATA_PACKET:
247             return hci_number_free_acl_slots();
248         case HCI_COMMAND_DATA_PACKET:
249             return hci_stack.num_cmd_packets;
250         default:
251             return 0;
252     }
253 }
254 
255 int hci_send_acl_packet(uint8_t *packet, int size){
256 
257     // check for free places on BT module
258     if (!hci_number_free_acl_slots()) return BTSTACK_ACL_BUFFERS_FULL;
259 
260     hci_con_handle_t con_handle = READ_ACL_CONNECTION_HANDLE(packet);
261     hci_connection_t *connection = hci_connection_for_handle( con_handle);
262     if (!connection) return 0;
263     hci_connection_timestamp(connection);
264 
265     // count packet
266     connection->num_acl_packets_sent++;
267     // log_info("hci_send_acl_packet - handle %u, sent %u\n", connection->con_handle, connection->num_acl_packets_sent);
268 
269     // send packet
270     int err = hci_stack.hci_transport->send_packet(HCI_ACL_DATA_PACKET, packet, size);
271 
272     return err;
273 }
274 
275 static void acl_handler(uint8_t *packet, int size){
276 
277     // log_info("acl_handler: size %u", size);
278 
279     // get info
280     hci_con_handle_t con_handle = READ_ACL_CONNECTION_HANDLE(packet);
281     hci_connection_t *conn      = hci_connection_for_handle(con_handle);
282     uint8_t  acl_flags          = READ_ACL_FLAGS(packet);
283     uint16_t acl_length         = READ_ACL_LENGTH(packet);
284 
285     // ignore non-registered handle
286     if (!conn){
287         log_error( "hci.c: acl_handler called with non-registered handle %u!\n" , con_handle);
288         return;
289     }
290 
291     // assert packet is complete
292     if (acl_length + 4 != size){
293         log_error("hci.c: acl_handler called with ACL packet of wrong size %u, expected %u => dropping packet", size, acl_length + 4);
294         return;
295     }
296 
297     // update idle timestamp
298     hci_connection_timestamp(conn);
299 
300     // handle different packet types
301     switch (acl_flags & 0x03) {
302 
303         case 0x01: // continuation fragment
304 
305             // sanity check
306             if (conn->acl_recombination_pos == 0) {
307                 log_error( "ACL Cont Fragment but no first fragment for handle 0x%02x\n", con_handle);
308                 return;
309             }
310 
311             // append fragment payload (header already stored)
312             memcpy(&conn->acl_recombination_buffer[conn->acl_recombination_pos], &packet[4], acl_length );
313             conn->acl_recombination_pos += acl_length;
314 
315             // log_error( "ACL Cont Fragment: acl_len %u, combined_len %u, l2cap_len %u\n", acl_length,
316             //        conn->acl_recombination_pos, conn->acl_recombination_length);
317 
318             // forward complete L2CAP packet if complete.
319             if (conn->acl_recombination_pos >= conn->acl_recombination_length + 4 + 4){ // pos already incl. ACL header
320 
321                 hci_stack.packet_handler(HCI_ACL_DATA_PACKET, conn->acl_recombination_buffer, conn->acl_recombination_pos);
322                 // reset recombination buffer
323                 conn->acl_recombination_length = 0;
324                 conn->acl_recombination_pos = 0;
325             }
326             break;
327 
328         case 0x02: { // first fragment
329 
330             // sanity check
331             if (conn->acl_recombination_pos) {
332                 log_error( "ACL First Fragment but data in buffer for handle 0x%02x\n", con_handle);
333                 return;
334             }
335 
336             // peek into L2CAP packet!
337             uint16_t l2cap_length = READ_L2CAP_LENGTH( packet );
338 
339             // log_info( "ACL First Fragment: acl_len %u, l2cap_len %u\n", acl_length, l2cap_length);
340 
341             // compare fragment size to L2CAP packet size
342             if (acl_length >= l2cap_length + 4){
343 
344                 // forward fragment as L2CAP packet
345                 hci_stack.packet_handler(HCI_ACL_DATA_PACKET, packet, acl_length + 4);
346 
347             } else {
348                 // store first fragment and tweak acl length for complete package
349                 memcpy(conn->acl_recombination_buffer, packet, acl_length + 4);
350                 conn->acl_recombination_pos    = acl_length + 4;
351                 conn->acl_recombination_length = l2cap_length;
352                 bt_store_16(conn->acl_recombination_buffer, 2, l2cap_length +4);
353             }
354             break;
355 
356         }
357         default:
358             log_error( "hci.c: acl_handler called with invalid packet boundary flags %u\n", acl_flags & 0x03);
359             return;
360     }
361 
362     // execute main loop
363     hci_run();
364 }
365 
366 static void hci_shutdown_connection(hci_connection_t *conn){
367     log_info("Connection closed: handle %u, %s\n", conn->con_handle, bd_addr_to_str(conn->address));
368 
369     // cancel all l2cap connections
370     hci_emit_disconnection_complete(conn->con_handle, 0x16);    // terminated by local host
371 
372     run_loop_remove_timer(&conn->timeout);
373 
374     linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
375     btstack_memory_hci_connection_free( conn );
376 
377     // now it's gone
378     hci_emit_nr_connections_changed();
379 }
380 
381 static const uint16_t packet_type_sizes[] = {
382     0, HCI_ACL_2DH1_SIZE, HCI_ACL_3DH1_SIZE, HCI_ACL_DM1_SIZE,
383     HCI_ACL_DH1_SIZE, 0, 0, 0,
384     HCI_ACL_2DH3_SIZE, HCI_ACL_3DH3_SIZE, HCI_ACL_DM3_SIZE, HCI_ACL_DH3_SIZE,
385     HCI_ACL_2DH5_SIZE, HCI_ACL_3DH5_SIZE, HCI_ACL_DM5_SIZE, HCI_ACL_DH5_SIZE
386 };
387 static const uint8_t  packet_type_feature_requirement_bit[] = {
388      0, // 3 slot packets
389      1, // 5 slot packets
390     25, // EDR 2 mpbs
391     26, // EDR 3 mbps
392     39, // 3 slot EDR packts
393     40, // 5 slot EDR packet
394 };
395 static const uint16_t packet_type_feature_packet_mask[] = {
396     0x0f00, // 3 slot packets
397     0xf000, // 5 slot packets
398     0x1102, // EDR 2 mpbs
399     0x2204, // EDR 3 mbps
400     0x0300, // 3 slot EDR packts
401     0x3000, // 5 slot EDR packet
402 };
403 
404 static uint16_t hci_acl_packet_types_for_buffer_size_and_local_features(uint16_t buffer_size, uint8_t * local_supported_features){
405     // enable packet types based on size
406     uint16_t packet_types = 0;
407     int i;
408     for (i=0;i<16;i++){
409         if (packet_type_sizes[i] == 0) continue;
410         if (packet_type_sizes[i] <= buffer_size){
411             packet_types |= 1 << i;
412         }
413     }
414     // disable packet types due to missing local supported features
415     for (i=0;i<sizeof(packet_type_feature_requirement_bit);i++){
416         int bit_idx = packet_type_feature_requirement_bit[i];
417         int feature_set = (local_supported_features[bit_idx >> 3] & (1<<(bit_idx & 7))) != 0;
418         if (feature_set) continue;
419         log_info("Features bit %02u is not set, removing packet types 0x%04x", bit_idx, packet_type_feature_packet_mask[i]);
420         packet_types &= ~packet_type_feature_packet_mask[i];
421     }
422     // flip bits for "may not be used"
423     packet_types ^= 0x3306;
424     return packet_types;
425 }
426 
427 uint16_t hci_usable_acl_packet_types(void){
428     return hci_stack.packet_types;
429 }
430 
431 uint8_t* hci_get_outgoing_acl_packet_buffer(void){
432     // hci packet buffer is >= acl data packet length
433     return hci_stack.hci_packet_buffer;
434 }
435 
436 uint16_t hci_max_acl_data_packet_length(void){
437     return hci_stack.acl_data_packet_length;
438 }
439 
440 int hci_ssp_supported(void){
441     // No 51, byte 6, bit 3
442     return (hci_stack.local_supported_features[6] & (1 << 3)) != 0;
443 }
444 
445 int hci_classic_supported(void){
446     // No 37, byte 4, bit 5, = No BR/EDR Support
447     return (hci_stack.local_supported_features[4] & (1 << 5)) == 0;
448 }
449 
450 int hci_le_supported(void){
451     // No 37, byte 4, bit 6 = LE Supported (Controller)
452 #ifdef HAVE_BLE
453     return (hci_stack.local_supported_features[4] & (1 << 6)) != 0;
454 #else
455     return 0;
456 #endif
457 }
458 
459 // get addr type and address used in advertisement packets
460 void hci_le_advertisement_address(uint8_t * addr_type, bd_addr_t * addr){
461     *addr_type = hci_stack.adv_addr_type;
462     if (hci_stack.adv_addr_type){
463         memcpy(addr, hci_stack.adv_address, 6);
464     } else {
465         memcpy(addr, hci_stack.local_bd_addr, 6);
466     }
467 }
468 
469 // avoid huge local variables
470 #ifndef EMBEDDED
471 static device_name_t device_name;
472 #endif
473 static void event_handler(uint8_t *packet, int size){
474 
475     uint16_t event_length = packet[1];
476 
477     // assert packet is complete
478     if (size != event_length + 2){
479         log_error("hci.c: event_handler called with event packet of wrong size %u, expected %u => dropping packet", size, event_length + 2);
480         return;
481     }
482 
483     bd_addr_t addr;
484     uint8_t link_type;
485     hci_con_handle_t handle;
486     hci_connection_t * conn;
487     int i;
488 
489     // printf("HCI:EVENT:%02x\n", packet[0]);
490 
491     switch (packet[0]) {
492 
493         case HCI_EVENT_COMMAND_COMPLETE:
494             // get num cmd packets
495             // log_info("HCI_EVENT_COMMAND_COMPLETE cmds old %u - new %u\n", hci_stack.num_cmd_packets, packet[2]);
496             hci_stack.num_cmd_packets = packet[2];
497 
498             if (COMMAND_COMPLETE_EVENT(packet, hci_read_buffer_size)){
499                 // from offset 5
500                 // status
501                 // "The HC_ACL_Data_Packet_Length return parameter will be used to determine the size of the L2CAP segments contained in ACL Data Packets"
502                 hci_stack.acl_data_packet_length = READ_BT_16(packet, 6);
503                 // ignore: SCO data packet len (8)
504                 hci_stack.total_num_acl_packets  = packet[9];
505                 // ignore: total num SCO packets
506                 if (hci_stack.state == HCI_STATE_INITIALIZING){
507                     // determine usable ACL payload size
508                     if (HCI_ACL_PAYLOAD_SIZE < hci_stack.acl_data_packet_length){
509                         hci_stack.acl_data_packet_length = HCI_ACL_PAYLOAD_SIZE;
510                     }
511                     log_info("hci_read_buffer_size: used size %u, count %u\n",
512                              hci_stack.acl_data_packet_length, hci_stack.total_num_acl_packets);
513                 }
514             }
515 #ifdef HAVE_BLE
516             if (COMMAND_COMPLETE_EVENT(packet, hci_le_read_buffer_size)){
517                 hci_stack.le_data_packet_length = READ_BT_16(packet, 6);
518                 hci_stack.total_num_le_packets  = packet[8];
519                 log_info("hci_le_read_buffer_size: size %u, count %u\n", hci_stack.le_data_packet_length, hci_stack.total_num_le_packets);
520             }
521 #endif
522             // Dump local address
523             if (COMMAND_COMPLETE_EVENT(packet, hci_read_bd_addr)) {
524                 bt_flip_addr(hci_stack.local_bd_addr, &packet[OFFSET_OF_DATA_IN_COMMAND_COMPLETE + 1]);
525                 log_info("Local Address, Status: 0x%02x: Addr: %s\n",
526                     packet[OFFSET_OF_DATA_IN_COMMAND_COMPLETE], bd_addr_to_str(hci_stack.local_bd_addr));
527             }
528             if (COMMAND_COMPLETE_EVENT(packet, hci_write_scan_enable)){
529                 hci_emit_discoverable_enabled(hci_stack.discoverable);
530             }
531             // Note: HCI init checks
532             if (COMMAND_COMPLETE_EVENT(packet, hci_read_local_supported_features)){
533                 memcpy(hci_stack.local_supported_features, &packet[OFFSET_OF_DATA_IN_COMMAND_COMPLETE+1], 8);
534                 log_info("Local Supported Features: 0x%02x%02x%02x%02x%02x%02x%02x%02x",
535                     hci_stack.local_supported_features[0], hci_stack.local_supported_features[1],
536                     hci_stack.local_supported_features[2], hci_stack.local_supported_features[3],
537                     hci_stack.local_supported_features[4], hci_stack.local_supported_features[5],
538                     hci_stack.local_supported_features[6], hci_stack.local_supported_features[7]);
539 
540                 // determine usable ACL packet types based buffer size and supported features
541                 hci_stack.packet_types = hci_acl_packet_types_for_buffer_size_and_local_features(hci_stack.acl_data_packet_length, &hci_stack.local_supported_features[0]);
542                 log_info("packet types %04x", hci_stack.packet_types);
543 
544                 // Classic/LE
545                 log_info("BR/EDR support %u, LE support %u", hci_classic_supported(), hci_le_supported());
546             }
547             break;
548 
549         case HCI_EVENT_COMMAND_STATUS:
550             // get num cmd packets
551             // log_info("HCI_EVENT_COMMAND_STATUS cmds - old %u - new %u\n", hci_stack.num_cmd_packets, packet[3]);
552             hci_stack.num_cmd_packets = packet[3];
553             break;
554 
555         case HCI_EVENT_NUMBER_OF_COMPLETED_PACKETS:
556             for (i=0; i<packet[2];i++){
557                 handle = READ_BT_16(packet, 3 + 2*i);
558                 uint16_t num_packets = READ_BT_16(packet, 3 + packet[2]*2 + 2*i);
559                 conn = hci_connection_for_handle(handle);
560                 if (!conn){
561                     log_error("hci_number_completed_packet lists unused con handle %u\n", handle);
562                     continue;
563                 }
564                 conn->num_acl_packets_sent -= num_packets;
565                 // log_info("hci_number_completed_packet %u processed for handle %u, outstanding %u\n", num_packets, handle, conn->num_acl_packets_sent);
566             }
567             break;
568 
569         case HCI_EVENT_CONNECTION_REQUEST:
570             bt_flip_addr(addr, &packet[2]);
571             // TODO: eval COD 8-10
572             link_type = packet[11];
573             log_info("Connection_incoming: %s, type %u\n", bd_addr_to_str(addr), link_type);
574             if (link_type == 1) { // ACL
575                 conn = connection_for_address(addr);
576                 if (!conn) {
577                     conn = create_connection_for_addr(addr);
578                 }
579                 if (!conn) {
580                     // CONNECTION REJECTED DUE TO LIMITED RESOURCES (0X0D)
581                     hci_stack.decline_reason = 0x0d;
582                     BD_ADDR_COPY(hci_stack.decline_addr, addr);
583                     break;
584                 }
585                 conn->state = RECEIVED_CONNECTION_REQUEST;
586                 hci_run();
587             } else {
588                 // SYNCHRONOUS CONNECTION LIMIT TO A DEVICE EXCEEDED (0X0A)
589                 hci_stack.decline_reason = 0x0a;
590                 BD_ADDR_COPY(hci_stack.decline_addr, addr);
591             }
592             break;
593 
594         case HCI_EVENT_CONNECTION_COMPLETE:
595             // Connection management
596             bt_flip_addr(addr, &packet[5]);
597             log_info("Connection_complete (status=%u) %s\n", packet[2], bd_addr_to_str(addr));
598             conn = connection_for_address(addr);
599             if (conn) {
600                 if (!packet[2]){
601                     conn->state = OPEN;
602                     conn->con_handle = READ_BT_16(packet, 3);
603                     conn->bonding_flags = BONDING_REQUEST_REMOTE_FEATURES;
604 
605                     // restart timer
606                     run_loop_set_timer(&conn->timeout, HCI_CONNECTION_TIMEOUT_MS);
607                     run_loop_add_timer(&conn->timeout);
608 
609                     log_info("New connection: handle %u, %s\n", conn->con_handle, bd_addr_to_str(conn->address));
610 
611                     hci_emit_nr_connections_changed();
612                 } else {
613                     // connection failed, remove entry
614                     linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
615                     btstack_memory_hci_connection_free( conn );
616 
617                     // if authentication error, also delete link key
618                     if (packet[2] == 0x05) {
619                         hci_drop_link_key_for_bd_addr(&addr);
620                     }
621                 }
622             }
623             break;
624 
625         case HCI_EVENT_READ_REMOTE_SUPPORTED_FEATURES_COMPLETE:
626             handle = READ_BT_16(packet, 3);
627             conn = hci_connection_for_handle(handle);
628             if (!conn) break;
629             if (!packet[2]){
630                 uint8_t * features = &packet[5];
631                 if (features[6] & (1 << 3)){
632                     conn->bonding_flags |= BONDING_REMOTE_SUPPORTS_SSP;
633                 }
634             }
635             conn->bonding_flags |= BONDING_RECEIVED_REMOTE_FEATURES;
636             break;
637 
638         case HCI_EVENT_LINK_KEY_REQUEST:
639             log_info("HCI_EVENT_LINK_KEY_REQUEST\n");
640             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_LINK_KEY_REQUEST);
641             // non-bondable mode: link key negative reply will be sent by HANDLE_LINK_KEY_REQUEST
642             if (hci_stack.bondable && !hci_stack.remote_device_db) break;
643             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], HANDLE_LINK_KEY_REQUEST);
644             hci_run();
645             // request handled by hci_run() as HANDLE_LINK_KEY_REQUEST gets set
646             return;
647 
648         case HCI_EVENT_LINK_KEY_NOTIFICATION: {
649             bt_flip_addr(addr, &packet[2]);
650             conn = connection_for_address(addr);
651             if (!conn) break;
652             conn->authentication_flags |= RECV_LINK_KEY_NOTIFICATION;
653             link_key_type_t link_key_type = packet[24];
654             // Change Connection Encryption keeps link key type
655             if (link_key_type != CHANGED_COMBINATION_KEY){
656                 conn->link_key_type = link_key_type;
657             }
658             if (!hci_stack.remote_device_db) break;
659             hci_stack.remote_device_db->put_link_key(&addr, (link_key_t *) &packet[8], conn->link_key_type);
660             // still forward event to allow dismiss of pairing dialog
661             break;
662         }
663 
664         case HCI_EVENT_PIN_CODE_REQUEST:
665             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_PIN_CODE_REQUEST);
666             // non-bondable mode: pin code negative reply will be sent
667             if (!hci_stack.bondable){
668                 hci_add_connection_flags_for_flipped_bd_addr(&packet[2], HANDLE_PIN_CODE_REQUEST);
669                 hci_run();
670                 return;
671             }
672             // PIN CODE REQUEST means the link key request didn't succee -> delete stored link key
673             if (!hci_stack.remote_device_db) break;
674             bt_flip_addr(addr, &packet[2]);
675             hci_stack.remote_device_db->delete_link_key(&addr);
676             break;
677 
678         case HCI_EVENT_IO_CAPABILITY_REQUEST:
679             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_IO_CAPABILITIES_REQUEST);
680             if (!hci_stack.bondable || hci_stack.ssp_io_capability == SSP_IO_CAPABILITY_UNKNOWN) break;
681             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], SEND_IO_CAPABILITIES_REPLY);
682             break;
683 
684         case HCI_EVENT_USER_CONFIRMATION_REQUEST:
685             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_USER_CONFIRM_REQUEST);
686             if (!hci_stack.ssp_auto_accept) break;
687             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], SEND_USER_CONFIRM_REPLY);
688             break;
689 
690         case HCI_EVENT_USER_PASSKEY_REQUEST:
691             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_USER_PASSKEY_REQUEST);
692             if (!hci_stack.ssp_auto_accept) break;
693             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], SEND_USER_PASSKEY_REPLY);
694             break;
695 
696         case HCI_EVENT_ENCRYPTION_CHANGE:
697             if (packet[2]) break;   // error status
698             handle = READ_BT_16(packet, 3);
699             conn = hci_connection_for_handle(handle);
700             if (!conn) break;
701             if (packet[5]){
702                 conn->authentication_flags |= CONNECTION_ENCRYPTED;
703             } else {
704                 conn->authentication_flags &= ~CONNECTION_ENCRYPTED;
705             }
706             break;
707 
708 #ifndef EMBEDDED
709         case HCI_EVENT_REMOTE_NAME_REQUEST_COMPLETE:
710             if (!hci_stack.remote_device_db) break;
711             if (packet[2]) break; // status not ok
712             bt_flip_addr(addr, &packet[3]);
713             // fix for invalid remote names - terminate on 0xff
714             for (i=0; i<248;i++){
715                 if (packet[9+i] == 0xff){
716                     packet[9+i] = 0;
717                     break;
718                 }
719             }
720             memset(&device_name, 0, sizeof(device_name_t));
721             strncpy((char*) device_name, (char*) &packet[9], 248);
722             hci_stack.remote_device_db->put_name(&addr, &device_name);
723             break;
724 
725         case HCI_EVENT_INQUIRY_RESULT:
726         case HCI_EVENT_INQUIRY_RESULT_WITH_RSSI:
727             if (!hci_stack.remote_device_db) break;
728             // first send inq result packet
729             hci_stack.packet_handler(HCI_EVENT_PACKET, packet, size);
730             // then send cached remote names
731             for (i=0; i<packet[2];i++){
732                 bt_flip_addr(addr, &packet[3+i*6]);
733                 if (hci_stack.remote_device_db->get_name(&addr, &device_name)){
734                     hci_emit_remote_name_cached(&addr, &device_name);
735                 }
736             }
737             return;
738 #endif
739 
740         case HCI_EVENT_DISCONNECTION_COMPLETE:
741             if (!packet[2]){
742                 handle = READ_BT_16(packet, 3);
743                 hci_connection_t * conn = hci_connection_for_handle(handle);
744                 if (conn) {
745                     hci_shutdown_connection(conn);
746                 }
747             }
748             break;
749 
750         case HCI_EVENT_HARDWARE_ERROR:
751             if(hci_stack.control && hci_stack.control->hw_error){
752                 (*hci_stack.control->hw_error)();
753             }
754             break;
755 
756 #ifdef HAVE_BLE
757         case HCI_EVENT_LE_META:
758             switch (packet[2]) {
759                 case HCI_SUBEVENT_LE_CONNECTION_COMPLETE:
760                     // Connection management
761                     bt_flip_addr(addr, &packet[8]);
762                     log_info("LE Connection_complete (status=%u) %s\n", packet[3], bd_addr_to_str(addr));
763                     // LE connections are auto-accepted, so just create a connection if there isn't one already
764                     conn = connection_for_address(addr);
765                     if (packet[3]){
766                         if (conn){
767                             // outgoing connection failed, remove entry
768                             linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
769                             btstack_memory_hci_connection_free( conn );
770 
771                         }
772                         // if authentication error, also delete link key
773                         if (packet[3] == 0x05) {
774                             hci_drop_link_key_for_bd_addr(&addr);
775                         }
776                         break;
777                     }
778                     if (!conn){
779                         conn = create_connection_for_addr(addr);
780                     }
781                     if (!conn){
782                         // no memory
783                         break;
784                     }
785 
786                     conn->state = OPEN;
787                     conn->con_handle = READ_BT_16(packet, 4);
788 
789                     // TODO: store - role, peer address type, conn_interval, conn_latency, supervision timeout, master clock
790 
791                     // restart timer
792                     // run_loop_set_timer(&conn->timeout, HCI_CONNECTION_TIMEOUT_MS);
793                     // run_loop_add_timer(&conn->timeout);
794 
795                     log_info("New connection: handle %u, %s\n", conn->con_handle, bd_addr_to_str(conn->address));
796 
797                     hci_emit_nr_connections_changed();
798                     break;
799 
800             // printf("LE buffer size: %u, count %u\n", READ_BT_16(packet,6), packet[8]);
801 
802                 default:
803                     break;
804             }
805             break;
806 #endif
807 
808         default:
809             break;
810     }
811 
812     // handle BT initialization
813     if (hci_stack.state == HCI_STATE_INITIALIZING){
814         if (hci_stack.substate % 2){
815             // odd: waiting for event
816             if (packet[0] == HCI_EVENT_COMMAND_COMPLETE || packet[0] == HCI_EVENT_COMMAND_STATUS){
817                 // wait for explicit COMMAND COMPLETE on RESET
818                 if (hci_stack.substate > 1 || COMMAND_COMPLETE_EVENT(packet, hci_reset)) {
819                     hci_stack.substate++;
820                 }
821             }
822         }
823     }
824 
825     // help with BT sleep
826     if (hci_stack.state == HCI_STATE_FALLING_ASLEEP
827         && hci_stack.substate == 1
828         && COMMAND_COMPLETE_EVENT(packet, hci_write_scan_enable)){
829         hci_stack.substate++;
830     }
831 
832     hci_stack.packet_handler(HCI_EVENT_PACKET, packet, size);
833 
834 	// execute main loop
835 	hci_run();
836 }
837 
838 static void packet_handler(uint8_t packet_type, uint8_t *packet, uint16_t size){
839     switch (packet_type) {
840         case HCI_EVENT_PACKET:
841             event_handler(packet, size);
842             break;
843         case HCI_ACL_DATA_PACKET:
844             acl_handler(packet, size);
845             break;
846         default:
847             break;
848     }
849 }
850 
851 /** Register HCI packet handlers */
852 void hci_register_packet_handler(void (*handler)(uint8_t packet_type, uint8_t *packet, uint16_t size)){
853     hci_stack.packet_handler = handler;
854 }
855 
856 void hci_init(hci_transport_t *transport, void *config, bt_control_t *control, remote_device_db_t const* remote_device_db){
857 
858     // reference to use transport layer implementation
859     hci_stack.hci_transport = transport;
860 
861     // references to used control implementation
862     hci_stack.control = control;
863 
864     // reference to used config
865     hci_stack.config = config;
866 
867     // no connections yet
868     hci_stack.connections = NULL;
869     hci_stack.discoverable = 0;
870     hci_stack.connectable = 0;
871     hci_stack.bondable = 1;
872 
873     // no pending cmds
874     hci_stack.decline_reason = 0;
875     hci_stack.new_scan_enable_value = 0xff;
876 
877     // higher level handler
878     hci_stack.packet_handler = dummy_handler;
879 
880     // store and open remote device db
881     hci_stack.remote_device_db = remote_device_db;
882     if (hci_stack.remote_device_db) {
883         hci_stack.remote_device_db->open();
884     }
885 
886     // max acl payload size defined in config.h
887     hci_stack.acl_data_packet_length = HCI_ACL_PAYLOAD_SIZE;
888 
889     // register packet handlers with transport
890     transport->register_packet_handler(&packet_handler);
891 
892     hci_stack.state = HCI_STATE_OFF;
893 
894     // class of device
895     hci_stack.class_of_device = 0x007a020c; // Smartphone
896 
897     // Secure Simple Pairing default: enable, no I/O capabilities, auto accept
898     hci_stack.ssp_enable = 1;
899     hci_stack.ssp_io_capability = SSP_IO_CAPABILITY_NO_INPUT_NO_OUTPUT;
900     hci_stack.ssp_authentication_requirement = 0;
901     hci_stack.ssp_auto_accept = 1;
902 
903     // LE
904     hci_stack.adv_addr_type = 0;
905     memset(hci_stack.adv_address, 0, 6);
906 }
907 
908 void hci_close(){
909     // close remote device db
910     if (hci_stack.remote_device_db) {
911         hci_stack.remote_device_db->close();
912     }
913     while (hci_stack.connections) {
914         hci_shutdown_connection((hci_connection_t *) hci_stack.connections);
915 }
916     hci_power_control(HCI_POWER_OFF);
917 }
918 
919 // State-Module-Driver overview
920 // state                    module  low-level
921 // HCI_STATE_OFF             off      close
922 // HCI_STATE_INITIALIZING,   on       open
923 // HCI_STATE_WORKING,        on       open
924 // HCI_STATE_HALTING,        on       open
925 // HCI_STATE_SLEEPING,    off/sleep   close
926 // HCI_STATE_FALLING_ASLEEP  on       open
927 
928 static int hci_power_control_on(void){
929 
930     // power on
931     int err = 0;
932     if (hci_stack.control && hci_stack.control->on){
933         err = (*hci_stack.control->on)(hci_stack.config);
934     }
935     if (err){
936         log_error( "POWER_ON failed\n");
937         hci_emit_hci_open_failed();
938         return err;
939     }
940 
941     // open low-level device
942     err = hci_stack.hci_transport->open(hci_stack.config);
943     if (err){
944         log_error( "HCI_INIT failed, turning Bluetooth off again\n");
945         if (hci_stack.control && hci_stack.control->off){
946             (*hci_stack.control->off)(hci_stack.config);
947         }
948         hci_emit_hci_open_failed();
949         return err;
950     }
951     return 0;
952 }
953 
954 static void hci_power_control_off(void){
955 
956     log_info("hci_power_control_off\n");
957 
958     // close low-level device
959     hci_stack.hci_transport->close(hci_stack.config);
960 
961     log_info("hci_power_control_off - hci_transport closed\n");
962 
963     // power off
964     if (hci_stack.control && hci_stack.control->off){
965         (*hci_stack.control->off)(hci_stack.config);
966     }
967 
968     log_info("hci_power_control_off - control closed\n");
969 
970     hci_stack.state = HCI_STATE_OFF;
971 }
972 
973 static void hci_power_control_sleep(void){
974 
975     log_info("hci_power_control_sleep\n");
976 
977 #if 0
978     // don't close serial port during sleep
979 
980     // close low-level device
981     hci_stack.hci_transport->close(hci_stack.config);
982 #endif
983 
984     // sleep mode
985     if (hci_stack.control && hci_stack.control->sleep){
986         (*hci_stack.control->sleep)(hci_stack.config);
987     }
988 
989     hci_stack.state = HCI_STATE_SLEEPING;
990 }
991 
992 static int hci_power_control_wake(void){
993 
994     log_info("hci_power_control_wake\n");
995 
996     // wake on
997     if (hci_stack.control && hci_stack.control->wake){
998         (*hci_stack.control->wake)(hci_stack.config);
999     }
1000 
1001 #if 0
1002     // open low-level device
1003     int err = hci_stack.hci_transport->open(hci_stack.config);
1004     if (err){
1005         log_error( "HCI_INIT failed, turning Bluetooth off again\n");
1006         if (hci_stack.control && hci_stack.control->off){
1007             (*hci_stack.control->off)(hci_stack.config);
1008         }
1009         hci_emit_hci_open_failed();
1010         return err;
1011     }
1012 #endif
1013 
1014     return 0;
1015 }
1016 
1017 
1018 int hci_power_control(HCI_POWER_MODE power_mode){
1019 
1020     log_info("hci_power_control: %u, current mode %u\n", power_mode, hci_stack.state);
1021 
1022     int err = 0;
1023     switch (hci_stack.state){
1024 
1025         case HCI_STATE_OFF:
1026             switch (power_mode){
1027                 case HCI_POWER_ON:
1028                     err = hci_power_control_on();
1029                     if (err) return err;
1030                     // set up state machine
1031                     hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
1032                     hci_stack.state = HCI_STATE_INITIALIZING;
1033                     hci_stack.substate = 0;
1034                     break;
1035                 case HCI_POWER_OFF:
1036                     // do nothing
1037                     break;
1038                 case HCI_POWER_SLEEP:
1039                     // do nothing (with SLEEP == OFF)
1040                     break;
1041             }
1042             break;
1043 
1044         case HCI_STATE_INITIALIZING:
1045             switch (power_mode){
1046                 case HCI_POWER_ON:
1047                     // do nothing
1048                     break;
1049                 case HCI_POWER_OFF:
1050                     // no connections yet, just turn it off
1051                     hci_power_control_off();
1052                     break;
1053                 case HCI_POWER_SLEEP:
1054                     // no connections yet, just turn it off
1055                     hci_power_control_sleep();
1056                     break;
1057             }
1058             break;
1059 
1060         case HCI_STATE_WORKING:
1061             switch (power_mode){
1062                 case HCI_POWER_ON:
1063                     // do nothing
1064                     break;
1065                 case HCI_POWER_OFF:
1066                     // see hci_run
1067                     hci_stack.state = HCI_STATE_HALTING;
1068                     break;
1069                 case HCI_POWER_SLEEP:
1070                     // see hci_run
1071                     hci_stack.state = HCI_STATE_FALLING_ASLEEP;
1072                     hci_stack.substate = 0;
1073                     break;
1074             }
1075             break;
1076 
1077         case HCI_STATE_HALTING:
1078             switch (power_mode){
1079                 case HCI_POWER_ON:
1080                     // set up state machine
1081                     hci_stack.state = HCI_STATE_INITIALIZING;
1082                     hci_stack.substate = 0;
1083                     break;
1084                 case HCI_POWER_OFF:
1085                     // do nothing
1086                     break;
1087                 case HCI_POWER_SLEEP:
1088                     // see hci_run
1089                     hci_stack.state = HCI_STATE_FALLING_ASLEEP;
1090                     hci_stack.substate = 0;
1091                     break;
1092             }
1093             break;
1094 
1095         case HCI_STATE_FALLING_ASLEEP:
1096             switch (power_mode){
1097                 case HCI_POWER_ON:
1098 
1099 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1100                     // nothing to do, if H4 supports power management
1101                     if (bt_control_iphone_power_management_enabled()){
1102                         hci_stack.state = HCI_STATE_INITIALIZING;
1103                         hci_stack.substate = HCI_INTIALIZING_SUBSTATE_AFTER_SLEEP;
1104                         break;
1105                     }
1106 #endif
1107                     // set up state machine
1108                     hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
1109                     hci_stack.state = HCI_STATE_INITIALIZING;
1110                     hci_stack.substate = 0;
1111                     break;
1112                 case HCI_POWER_OFF:
1113                     // see hci_run
1114                     hci_stack.state = HCI_STATE_HALTING;
1115                     break;
1116                 case HCI_POWER_SLEEP:
1117                     // do nothing
1118                     break;
1119             }
1120             break;
1121 
1122         case HCI_STATE_SLEEPING:
1123             switch (power_mode){
1124                 case HCI_POWER_ON:
1125 
1126 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1127                     // nothing to do, if H4 supports power management
1128                     if (bt_control_iphone_power_management_enabled()){
1129                         hci_stack.state = HCI_STATE_INITIALIZING;
1130                         hci_stack.substate = HCI_INTIALIZING_SUBSTATE_AFTER_SLEEP;
1131                         hci_update_scan_enable();
1132                         break;
1133                     }
1134 #endif
1135                     err = hci_power_control_wake();
1136                     if (err) return err;
1137                     // set up state machine
1138                     hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
1139                     hci_stack.state = HCI_STATE_INITIALIZING;
1140                     hci_stack.substate = 0;
1141                     break;
1142                 case HCI_POWER_OFF:
1143                     hci_stack.state = HCI_STATE_HALTING;
1144                     break;
1145                 case HCI_POWER_SLEEP:
1146                     // do nothing
1147                     break;
1148             }
1149             break;
1150     }
1151 
1152     // create internal event
1153 	hci_emit_state();
1154 
1155 	// trigger next/first action
1156 	hci_run();
1157 
1158     return 0;
1159 }
1160 
1161 static void hci_update_scan_enable(void){
1162     // 2 = page scan, 1 = inq scan
1163     hci_stack.new_scan_enable_value  = hci_stack.connectable << 1 | hci_stack.discoverable;
1164     hci_run();
1165 }
1166 
1167 void hci_discoverable_control(uint8_t enable){
1168     if (enable) enable = 1; // normalize argument
1169 
1170     if (hci_stack.discoverable == enable){
1171         hci_emit_discoverable_enabled(hci_stack.discoverable);
1172         return;
1173     }
1174 
1175     hci_stack.discoverable = enable;
1176     hci_update_scan_enable();
1177 }
1178 
1179 void hci_connectable_control(uint8_t enable){
1180     if (enable) enable = 1; // normalize argument
1181 
1182     // don't emit event
1183     if (hci_stack.connectable == enable) return;
1184 
1185     hci_stack.connectable = enable;
1186     hci_update_scan_enable();
1187 }
1188 
1189 bd_addr_t * hci_local_bd_addr(void){
1190     return &hci_stack.local_bd_addr;
1191 }
1192 
1193 void hci_run(){
1194 
1195     hci_connection_t * connection;
1196     linked_item_t * it;
1197 
1198     if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1199 
1200     // global/non-connection oriented commands
1201 
1202     // decline incoming connections
1203     if (hci_stack.decline_reason){
1204         uint8_t reason = hci_stack.decline_reason;
1205         hci_stack.decline_reason = 0;
1206         hci_send_cmd(&hci_reject_connection_request, hci_stack.decline_addr, reason);
1207         return;
1208     }
1209 
1210     // send scan enable
1211     if (hci_stack.state == HCI_STATE_WORKING && hci_stack.new_scan_enable_value != 0xff && hci_classic_supported()){
1212         hci_send_cmd(&hci_write_scan_enable, hci_stack.new_scan_enable_value);
1213         hci_stack.new_scan_enable_value = 0xff;
1214         return;
1215     }
1216 
1217     // send pending HCI commands
1218     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
1219 
1220         connection = (hci_connection_t *) it;
1221 
1222         if (connection->state == RECEIVED_CONNECTION_REQUEST){
1223             log_info("sending hci_accept_connection_request\n");
1224             hci_send_cmd(&hci_accept_connection_request, connection->address, 1);
1225             connection->state = ACCEPTED_CONNECTION_REQUEST;
1226             return;
1227         }
1228 
1229         if (connection->authentication_flags & HANDLE_LINK_KEY_REQUEST){
1230             link_key_t link_key;
1231             link_key_type_t link_key_type;
1232             log_info("responding to link key request\n");
1233             if ( hci_stack.bondable && hci_stack.remote_device_db && hci_stack.remote_device_db->get_link_key( &connection->address, &link_key, &link_key_type)){
1234                connection->link_key_type = link_key_type;
1235                hci_send_cmd(&hci_link_key_request_reply, connection->address, &link_key);
1236             } else {
1237                hci_send_cmd(&hci_link_key_request_negative_reply, connection->address);
1238             }
1239             connectionClearAuthenticationFlags(connection, HANDLE_LINK_KEY_REQUEST);
1240             return;
1241         }
1242 
1243         if (connection->authentication_flags & HANDLE_PIN_CODE_REQUEST){
1244             log_info("denying to pin request\n");
1245             hci_send_cmd(&hci_pin_code_request_negative_reply, connection->address);
1246             connectionClearAuthenticationFlags(connection, HANDLE_PIN_CODE_REQUEST);
1247             return;
1248         }
1249 
1250         if (connection->authentication_flags & SEND_IO_CAPABILITIES_REPLY){
1251             if (hci_stack.bondable){
1252                 hci_send_cmd(&hci_io_capability_request_reply, &connection->address, hci_stack.ssp_io_capability, NULL, hci_stack.ssp_authentication_requirement);
1253             } else {
1254                 hci_send_cmd(&hci_io_capability_request_negative_reply, &connection->address, ERROR_CODE_PAIRING_NOT_ALLOWED);
1255             }
1256             connectionClearAuthenticationFlags(connection, SEND_IO_CAPABILITIES_REPLY);
1257             return;
1258         }
1259 
1260         if (connection->authentication_flags & SEND_USER_CONFIRM_REPLY){
1261             hci_send_cmd(&hci_user_confirmation_request_reply, &connection->address);
1262             connectionClearAuthenticationFlags(connection, SEND_USER_CONFIRM_REPLY);
1263             return;
1264         }
1265 
1266         if (connection->authentication_flags & SEND_USER_PASSKEY_REPLY){
1267             hci_send_cmd(&hci_user_passkey_request_reply, &connection->address, 000000);
1268             connectionClearAuthenticationFlags(connection, SEND_USER_PASSKEY_REPLY);
1269             return;
1270         }
1271 
1272         if (connection->bonding_flags & BONDING_REQUEST_REMOTE_FEATURES){
1273             hci_send_cmd(&hci_read_remote_supported_features_command, connection->con_handle);
1274             connection->bonding_flags &= ~BONDING_REQUEST_REMOTE_FEATURES;
1275         }
1276     }
1277 
1278     switch (hci_stack.state){
1279         case HCI_STATE_INITIALIZING:
1280             // log_info("hci_init: substate %u\n", hci_stack.substate);
1281             if (hci_stack.substate % 2) {
1282                 // odd: waiting for command completion
1283                 return;
1284             }
1285             switch (hci_stack.substate >> 1){
1286                 case 0: // RESET
1287                     hci_send_cmd(&hci_reset);
1288 
1289                     if (hci_stack.config == 0 || ((hci_uart_config_t *)hci_stack.config)->baudrate_main == 0){
1290                         // skip baud change
1291                         hci_stack.substate = 4; // >> 1 = 2
1292                     }
1293                     break;
1294                 case 1: // SEND BAUD CHANGE
1295                     hci_stack.control->baudrate_cmd(hci_stack.config, ((hci_uart_config_t *)hci_stack.config)->baudrate_main, hci_stack.hci_packet_buffer);
1296                     hci_send_cmd_packet(hci_stack.hci_packet_buffer, 3 + hci_stack.hci_packet_buffer[2]);
1297                     break;
1298                 case 2: // LOCAL BAUD CHANGE
1299                     hci_stack.hci_transport->set_baudrate(((hci_uart_config_t *)hci_stack.config)->baudrate_main);
1300                     hci_stack.substate += 2;
1301                     // break missing here for fall through
1302 
1303                 case 3:
1304                     // Custom initialization
1305                     if (hci_stack.control && hci_stack.control->next_cmd){
1306                         int valid_cmd = (*hci_stack.control->next_cmd)(hci_stack.config, hci_stack.hci_packet_buffer);
1307                         if (valid_cmd){
1308                             int size = 3 + hci_stack.hci_packet_buffer[2];
1309                             hci_stack.hci_transport->send_packet(HCI_COMMAND_DATA_PACKET, hci_stack.hci_packet_buffer, size);
1310                             hci_stack.substate = 4; // more init commands
1311                             break;
1312                         }
1313                         log_info("hci_run: init script done\n\r");
1314                     }
1315                     // otherwise continue
1316 					hci_send_cmd(&hci_read_bd_addr);
1317 					break;
1318 				case 4:
1319 					hci_send_cmd(&hci_read_buffer_size);
1320 					break;
1321                 case 5:
1322                     hci_send_cmd(&hci_read_local_supported_features);
1323                     break;
1324                 case 6:
1325                     if (hci_le_supported()){
1326                         hci_send_cmd(&hci_set_event_mask,0xffffffff, 0x3FFFFFFF);
1327                     } else {
1328                         // Kensington Bluetoot 2.1 USB Dongle (CSR Chipset) returns an error for 0xffff...
1329                         hci_send_cmd(&hci_set_event_mask,0xffffffff, 0x1FFFFFFF);
1330                     }
1331 
1332                     // skip Classic init commands for LE only chipsets
1333                     if (!hci_classic_supported()){
1334                         if (hci_le_supported()){
1335                             hci_stack.substate = 11 << 1;    // skip all classic command
1336                         } else {
1337                             log_error("Neither BR/EDR nor LE supported");
1338                             hci_stack.substate = 13 << 1;    // skip all
1339                         }
1340                     }
1341                     break;
1342                 case 7:
1343                     if (hci_ssp_supported()){
1344                         hci_send_cmd(&hci_write_simple_pairing_mode, hci_stack.ssp_enable);
1345                         break;
1346                     }
1347                     hci_stack.substate += 2;
1348                     // break missing here for fall through
1349 
1350                 case 8:
1351                     // ca. 15 sec
1352                     hci_send_cmd(&hci_write_page_timeout, 0x6000);
1353                     break;
1354                 case 9:
1355                     hci_send_cmd(&hci_write_class_of_device, hci_stack.class_of_device);
1356                     break;
1357                 case 10:
1358                     if (hci_stack.local_name){
1359                         hci_send_cmd(&hci_write_local_name, hci_stack.local_name);
1360                     } else {
1361                         char hostname[30];
1362 #ifdef EMBEDDED
1363                         // BTstack-11:22:33:44:55:66
1364                         strcpy(hostname, "BTstack ");
1365                         strcat(hostname, bd_addr_to_str(hci_stack.local_bd_addr));
1366                         printf("---> Name %s\n", hostname);
1367 #else
1368                         // hostname for POSIX systems
1369                         gethostname(hostname, 30);
1370                         hostname[29] = '\0';
1371 #endif
1372                         hci_send_cmd(&hci_write_local_name, hostname);
1373                     }
1374                     break;
1375                 case 11:
1376 					hci_send_cmd(&hci_write_scan_enable, (hci_stack.connectable << 1) | hci_stack.discoverable); // page scan
1377                     if (!hci_le_supported()){
1378                         // SKIP LE init for Classic only configuration
1379                         hci_stack.substate = 13 << 1;
1380                     }
1381 					break;
1382 
1383 #ifdef HAVE_BLE
1384                 // LE INIT
1385                 case 12:
1386                     hci_send_cmd(&hci_le_read_buffer_size);
1387                     break;
1388                 case 13:
1389                     // LE Supported Host = 1, Simultaneous Host = 0
1390                     hci_send_cmd(&hci_write_le_host_supported, 1, 0);
1391                     break;
1392 #endif
1393 
1394                 // DONE
1395                 case 14:
1396                     // done.
1397                     hci_stack.state = HCI_STATE_WORKING;
1398                     hci_emit_state();
1399                     break;
1400                 default:
1401                     break;
1402             }
1403             hci_stack.substate++;
1404             break;
1405 
1406         case HCI_STATE_HALTING:
1407 
1408             log_info("HCI_STATE_HALTING\n");
1409             // close all open connections
1410             connection =  (hci_connection_t *) hci_stack.connections;
1411             if (connection){
1412 
1413                 // send disconnect
1414                 if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1415 
1416                 log_info("HCI_STATE_HALTING, connection %p, handle %u\n", connection, (uint16_t)connection->con_handle);
1417                 hci_send_cmd(&hci_disconnect, connection->con_handle, 0x13);  // remote closed connection
1418 
1419                 // send disconnected event right away - causes higher layer connections to get closed, too.
1420                 hci_shutdown_connection(connection);
1421                 return;
1422             }
1423             log_info("HCI_STATE_HALTING, calling off\n");
1424 
1425             // switch mode
1426             hci_power_control_off();
1427 
1428             log_info("HCI_STATE_HALTING, emitting state\n");
1429             hci_emit_state();
1430             log_info("HCI_STATE_HALTING, done\n");
1431             break;
1432 
1433         case HCI_STATE_FALLING_ASLEEP:
1434             switch(hci_stack.substate) {
1435                 case 0:
1436                     log_info("HCI_STATE_FALLING_ASLEEP\n");
1437                     // close all open connections
1438                     connection =  (hci_connection_t *) hci_stack.connections;
1439 
1440 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1441                     // don't close connections, if H4 supports power management
1442                     if (bt_control_iphone_power_management_enabled()){
1443                         connection = NULL;
1444                     }
1445 #endif
1446                     if (connection){
1447 
1448                         // send disconnect
1449                         if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1450 
1451                         log_info("HCI_STATE_FALLING_ASLEEP, connection %p, handle %u\n", connection, (uint16_t)connection->con_handle);
1452                         hci_send_cmd(&hci_disconnect, connection->con_handle, 0x13);  // remote closed connection
1453 
1454                         // send disconnected event right away - causes higher layer connections to get closed, too.
1455                         hci_shutdown_connection(connection);
1456                         return;
1457                     }
1458 
1459                     if (hci_classic_supported()){
1460                         // disable page and inquiry scan
1461                         if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1462 
1463                         log_info("HCI_STATE_HALTING, disabling inq scans\n");
1464                         hci_send_cmd(&hci_write_scan_enable, hci_stack.connectable << 1); // drop inquiry scan but keep page scan
1465 
1466                         // continue in next sub state
1467                         hci_stack.substate++;
1468                         break;
1469                     }
1470                     // fall through for ble-only chips
1471 
1472                 case 2:
1473                     log_info("HCI_STATE_HALTING, calling sleep\n");
1474 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1475                     // don't actually go to sleep, if H4 supports power management
1476                     if (bt_control_iphone_power_management_enabled()){
1477                         // SLEEP MODE reached
1478                         hci_stack.state = HCI_STATE_SLEEPING;
1479                         hci_emit_state();
1480                         break;
1481                     }
1482 #endif
1483                     // switch mode
1484                     hci_power_control_sleep();  // changes hci_stack.state to SLEEP
1485                     hci_emit_state();
1486                     break;
1487 
1488                 default:
1489                     break;
1490             }
1491             break;
1492 
1493         default:
1494             break;
1495     }
1496 }
1497 
1498 int hci_send_cmd_packet(uint8_t *packet, int size){
1499     bd_addr_t addr;
1500     hci_connection_t * conn;
1501     // house-keeping
1502 
1503     // create_connection?
1504     if (IS_COMMAND(packet, hci_create_connection)){
1505         bt_flip_addr(addr, &packet[3]);
1506         log_info("Create_connection to %s\n", bd_addr_to_str(addr));
1507         conn = connection_for_address(addr);
1508         if (conn) {
1509             // if connection exists
1510             if (conn->state == OPEN) {
1511                 // and OPEN, emit connection complete command
1512                 hci_emit_connection_complete(conn, 0);
1513             }
1514             //    otherwise, just ignore as it is already in the open process
1515             return 0; // don't sent packet to controller
1516 
1517         }
1518         // create connection struct and register, state = SENT_CREATE_CONNECTION
1519         conn = create_connection_for_addr(addr);
1520         if (!conn){
1521             // notify client that alloc failed
1522             hci_emit_connection_complete(conn, BTSTACK_MEMORY_ALLOC_FAILED);
1523             return 0; // don't sent packet to controller
1524         }
1525         conn->state = SENT_CREATE_CONNECTION;
1526     }
1527 
1528     if (IS_COMMAND(packet, hci_link_key_request_reply)){
1529         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_LINK_KEY_REPLY);
1530     }
1531     if (IS_COMMAND(packet, hci_link_key_request_negative_reply)){
1532         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_LINK_KEY_NEGATIVE_REQUEST);
1533     }
1534 
1535     if (IS_COMMAND(packet, hci_delete_stored_link_key)){
1536         if (hci_stack.remote_device_db){
1537             bt_flip_addr(addr, &packet[3]);
1538             hci_stack.remote_device_db->delete_link_key(&addr);
1539         }
1540     }
1541 
1542 #ifdef HAVE_BLE
1543     if (IS_COMMAND(packet, hci_le_set_advertising_parameters)){
1544         hci_stack.adv_addr_type = packet[8];
1545     }
1546     if (IS_COMMAND(packet, hci_le_set_random_address)){
1547         bt_flip_addr(hci_stack.adv_address, &packet[3]);
1548     }
1549 #endif
1550 
1551 
1552     hci_stack.num_cmd_packets--;
1553     return hci_stack.hci_transport->send_packet(HCI_COMMAND_DATA_PACKET, packet, size);
1554 }
1555 
1556 // Configure Secure Simple Pairing
1557 
1558 // enable will enable SSP during init
1559 void hci_ssp_set_enable(int enable){
1560     hci_stack.ssp_enable = enable;
1561 }
1562 
1563 // if set, BTstack will respond to io capability request using authentication requirement
1564 void hci_ssp_set_io_capability(int io_capability){
1565     hci_stack.ssp_io_capability = io_capability;
1566 }
1567 void hci_ssp_set_authentication_requirement(int authentication_requirement){
1568     hci_stack.ssp_authentication_requirement = authentication_requirement;
1569 }
1570 
1571 // if set, BTstack will confirm a numberic comparion and enter '000000' if requested
1572 void hci_ssp_set_auto_accept(int auto_accept){
1573     hci_stack.ssp_auto_accept = auto_accept;
1574 }
1575 
1576 /**
1577  * pre: numcmds >= 0 - it's allowed to send a command to the controller
1578  */
1579 int hci_send_cmd(const hci_cmd_t *cmd, ...){
1580     va_list argptr;
1581     va_start(argptr, cmd);
1582     uint16_t size = hci_create_cmd_internal(hci_stack.hci_packet_buffer, cmd, argptr);
1583     va_end(argptr);
1584     return hci_send_cmd_packet(hci_stack.hci_packet_buffer, size);
1585 }
1586 
1587 // Create various non-HCI events.
1588 // TODO: generalize, use table similar to hci_create_command
1589 
1590 void hci_emit_state(){
1591     log_info("BTSTACK_EVENT_STATE %u", hci_stack.state);
1592     uint8_t event[3];
1593     event[0] = BTSTACK_EVENT_STATE;
1594     event[1] = sizeof(event) - 2;
1595     event[2] = hci_stack.state;
1596     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1597     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1598 }
1599 
1600 void hci_emit_connection_complete(hci_connection_t *conn, uint8_t status){
1601     uint8_t event[13];
1602     event[0] = HCI_EVENT_CONNECTION_COMPLETE;
1603     event[1] = sizeof(event) - 2;
1604     event[2] = status;
1605     bt_store_16(event, 3, conn->con_handle);
1606     bt_flip_addr(&event[5], conn->address);
1607     event[11] = 1; // ACL connection
1608     event[12] = 0; // encryption disabled
1609     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1610     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1611 }
1612 
1613 void hci_emit_disconnection_complete(uint16_t handle, uint8_t reason){
1614     uint8_t event[6];
1615     event[0] = HCI_EVENT_DISCONNECTION_COMPLETE;
1616     event[1] = sizeof(event) - 2;
1617     event[2] = 0; // status = OK
1618     bt_store_16(event, 3, handle);
1619     event[5] = reason;
1620     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1621     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1622 }
1623 
1624 void hci_emit_l2cap_check_timeout(hci_connection_t *conn){
1625     log_info("L2CAP_EVENT_TIMEOUT_CHECK");
1626     uint8_t event[4];
1627     event[0] = L2CAP_EVENT_TIMEOUT_CHECK;
1628     event[1] = sizeof(event) - 2;
1629     bt_store_16(event, 2, conn->con_handle);
1630     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1631     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1632 }
1633 
1634 void hci_emit_nr_connections_changed(){
1635     log_info("BTSTACK_EVENT_NR_CONNECTIONS_CHANGED %u", nr_hci_connections());
1636     uint8_t event[3];
1637     event[0] = BTSTACK_EVENT_NR_CONNECTIONS_CHANGED;
1638     event[1] = sizeof(event) - 2;
1639     event[2] = nr_hci_connections();
1640     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1641     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1642 }
1643 
1644 void hci_emit_hci_open_failed(){
1645     log_info("BTSTACK_EVENT_POWERON_FAILED");
1646     uint8_t event[2];
1647     event[0] = BTSTACK_EVENT_POWERON_FAILED;
1648     event[1] = sizeof(event) - 2;
1649     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1650     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1651 }
1652 
1653 #ifndef EMBEDDED
1654 void hci_emit_btstack_version() {
1655     log_info("BTSTACK_EVENT_VERSION %u.%u", BTSTACK_MAJOR, BTSTACK_MINOR);
1656     uint8_t event[6];
1657     event[0] = BTSTACK_EVENT_VERSION;
1658     event[1] = sizeof(event) - 2;
1659     event[2] = BTSTACK_MAJOR;
1660     event[3] = BTSTACK_MINOR;
1661     bt_store_16(event, 4, BTSTACK_REVISION);
1662     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1663     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1664 }
1665 #endif
1666 
1667 void hci_emit_system_bluetooth_enabled(uint8_t enabled){
1668     log_info("BTSTACK_EVENT_SYSTEM_BLUETOOTH_ENABLED %u", enabled);
1669     uint8_t event[3];
1670     event[0] = BTSTACK_EVENT_SYSTEM_BLUETOOTH_ENABLED;
1671     event[1] = sizeof(event) - 2;
1672     event[2] = enabled;
1673     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1674     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1675 }
1676 
1677 void hci_emit_remote_name_cached(bd_addr_t *addr, device_name_t *name){
1678     uint8_t event[2+1+6+248+1]; // +1 for \0 in log_info
1679     event[0] = BTSTACK_EVENT_REMOTE_NAME_CACHED;
1680     event[1] = sizeof(event) - 2 - 1;
1681     event[2] = 0;   // just to be compatible with HCI_EVENT_REMOTE_NAME_REQUEST_COMPLETE
1682     bt_flip_addr(&event[3], *addr);
1683     memcpy(&event[9], name, 248);
1684 
1685     event[9+248] = 0;   // assert \0 for log_info
1686     log_info("BTSTACK_EVENT_REMOTE_NAME_CACHED %s = '%s'", bd_addr_to_str(*addr), &event[9]);
1687 
1688     hci_dump_packet(HCI_EVENT_PACKET, 0, event, sizeof(event)-1);
1689     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event)-1);
1690 }
1691 
1692 void hci_emit_discoverable_enabled(uint8_t enabled){
1693     log_info("BTSTACK_EVENT_DISCOVERABLE_ENABLED %u", enabled);
1694     uint8_t event[3];
1695     event[0] = BTSTACK_EVENT_DISCOVERABLE_ENABLED;
1696     event[1] = sizeof(event) - 2;
1697     event[2] = enabled;
1698     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1699     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1700 }
1701 
1702 // GAP API
1703 /**
1704  * @bbrief enable/disable bonding. default is enabled
1705  * @praram enabled
1706  */
1707 void gap_set_bondable_mode(int enable){
1708     hci_stack.bondable = enable ? 1 : 0;
1709 }
1710 
1711 /**
1712  * @brief get current security level
1713  */
1714 gap_security_level_t gap_security_level(hci_con_handle_t con_handle){
1715     hci_connection_t * connection = hci_connection_for_handle(con_handle);
1716     if (!connection) return LEVEL_0;
1717     if ((connection->authentication_flags & CONNECTION_ENCRYPTED) == 0) return LEVEL_0;
1718     switch (connection->link_key_type){
1719         case AUTHENTICATED_COMBINATION_KEY_GENERATED_FROM_P256:
1720             return LEVEL_4;
1721         case COMBINATION_KEY:
1722         case AUTHENTICATED_COMBINATION_KEY_GENERATED_FROM_P192:
1723             return LEVEL_3;
1724         case DEBUG_COMBINATION_KEY:
1725         default:
1726             return LEVEL_2;
1727     }
1728 }
1729 
1730 /**
1731  * @brief request connection to device to
1732  * @result GAP_AUTHENTICATION_RESULT
1733  */
1734 void gap_request_security_level(hci_con_handle_t con_handle, gap_security_level_t level){
1735 }
1736 
1737