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