xref: /btstack/src/hci.c (revision f5d8d141f8ede1f67e155ab3435bed09d3580b5a)
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             // Dump local address
487             if (COMMAND_COMPLETE_EVENT(packet, hci_read_bd_addr)) {
488                 bt_flip_addr(hci_stack.local_bd_addr, &packet[OFFSET_OF_DATA_IN_COMMAND_COMPLETE + 1]);
489                 log_info("Local Address, Status: 0x%02x: Addr: %s\n",
490                     packet[OFFSET_OF_DATA_IN_COMMAND_COMPLETE], bd_addr_to_str(hci_stack.local_bd_addr));
491             }
492             if (COMMAND_COMPLETE_EVENT(packet, hci_write_scan_enable)){
493                 hci_emit_discoverable_enabled(hci_stack.discoverable);
494             }
495             // Note: HCI init checks
496             if (COMMAND_COMPLETE_EVENT(packet, hci_read_local_supported_features)){
497                 memcpy(hci_stack.local_supported_features, &packet[OFFSET_OF_DATA_IN_COMMAND_COMPLETE+1], 8);
498                 log_info("Local Supported Features: 0x%02x%02x%02x%02x%02x%02x%02x%02x",
499                     hci_stack.local_supported_features[0], hci_stack.local_supported_features[1],
500                     hci_stack.local_supported_features[2], hci_stack.local_supported_features[3],
501                     hci_stack.local_supported_features[4], hci_stack.local_supported_features[5],
502                     hci_stack.local_supported_features[6], hci_stack.local_supported_features[7]);
503 
504                 // determine usable ACL packet types based buffer size and supported features
505                 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]);
506                 log_info("packet types %04x", hci_stack.packet_types);
507 
508                 // Classic/LE
509                 log_info("BR/EDR support %u, LE support %u", hci_classic_supported(), hci_le_supported());
510             }
511             break;
512 
513         case HCI_EVENT_COMMAND_STATUS:
514             // get num cmd packets
515             // log_info("HCI_EVENT_COMMAND_STATUS cmds - old %u - new %u\n", hci_stack.num_cmd_packets, packet[3]);
516             hci_stack.num_cmd_packets = packet[3];
517             break;
518 
519         case HCI_EVENT_NUMBER_OF_COMPLETED_PACKETS:
520             for (i=0; i<packet[2];i++){
521                 handle = READ_BT_16(packet, 3 + 2*i);
522                 uint16_t num_packets = READ_BT_16(packet, 3 + packet[2]*2 + 2*i);
523                 conn = connection_for_handle(handle);
524                 if (!conn){
525                     log_error("hci_number_completed_packet lists unused con handle %u\n", handle);
526                     continue;
527                 }
528                 conn->num_acl_packets_sent -= num_packets;
529                 // log_info("hci_number_completed_packet %u processed for handle %u, outstanding %u\n", num_packets, handle, conn->num_acl_packets_sent);
530             }
531             break;
532 
533         case HCI_EVENT_CONNECTION_REQUEST:
534             bt_flip_addr(addr, &packet[2]);
535             // TODO: eval COD 8-10
536             link_type = packet[11];
537             log_info("Connection_incoming: %s, type %u\n", bd_addr_to_str(addr), link_type);
538             if (link_type == 1) { // ACL
539                 conn = connection_for_address(addr);
540                 if (!conn) {
541                     conn = create_connection_for_addr(addr);
542                 }
543                 if (!conn) {
544                     // CONNECTION REJECTED DUE TO LIMITED RESOURCES (0X0D)
545                     hci_stack.decline_reason = 0x0d;
546                     BD_ADDR_COPY(hci_stack.decline_addr, addr);
547                     break;
548                 }
549                 conn->state = RECEIVED_CONNECTION_REQUEST;
550                 hci_run();
551             } else {
552                 // SYNCHRONOUS CONNECTION LIMIT TO A DEVICE EXCEEDED (0X0A)
553                 hci_stack.decline_reason = 0x0a;
554                 BD_ADDR_COPY(hci_stack.decline_addr, addr);
555             }
556             break;
557 
558         case HCI_EVENT_CONNECTION_COMPLETE:
559             // Connection management
560             bt_flip_addr(addr, &packet[5]);
561             log_info("Connection_complete (status=%u) %s\n", packet[2], bd_addr_to_str(addr));
562             conn = connection_for_address(addr);
563             if (conn) {
564                 if (!packet[2]){
565                     conn->state = OPEN;
566                     conn->con_handle = READ_BT_16(packet, 3);
567 
568                     // restart timer
569                     run_loop_set_timer(&conn->timeout, HCI_CONNECTION_TIMEOUT_MS);
570                     run_loop_add_timer(&conn->timeout);
571 
572                     log_info("New connection: handle %u, %s\n", conn->con_handle, bd_addr_to_str(conn->address));
573 
574                     hci_emit_nr_connections_changed();
575                 } else {
576                     // connection failed, remove entry
577                     linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
578                     btstack_memory_hci_connection_free( conn );
579 
580                     // if authentication error, also delete link key
581                     if (packet[2] == 0x05) {
582                         hci_drop_link_key_for_bd_addr(&addr);
583                     }
584                 }
585             }
586             break;
587 
588         case HCI_EVENT_LINK_KEY_REQUEST:
589             log_info("HCI_EVENT_LINK_KEY_REQUEST\n");
590             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_LINK_KEY_REQUEST);
591             if (!hci_stack.remote_device_db) break;
592             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], HANDLE_LINK_KEY_REQUEST);
593             hci_run();
594             // request handled by hci_run() as HANDLE_LINK_KEY_REQUEST gets set
595             return;
596 
597         case HCI_EVENT_LINK_KEY_NOTIFICATION:
598             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_LINK_KEY_NOTIFICATION);
599             if (!hci_stack.remote_device_db) break;
600             bt_flip_addr(addr, &packet[2]);
601             hci_stack.remote_device_db->put_link_key(&addr, (link_key_t *) &packet[8]);
602             // still forward event to allow dismiss of pairing dialog
603             break;
604 
605         case HCI_EVENT_PIN_CODE_REQUEST:
606             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_PIN_CODE_REQUEST);
607             // PIN CODE REQUEST means the link key request didn't succee -> delete stored link key
608             if (!hci_stack.remote_device_db) break;
609             bt_flip_addr(addr, &packet[2]);
610             hci_stack.remote_device_db->delete_link_key(&addr);
611             break;
612 
613         case HCI_EVENT_IO_CAPABILITY_REQUEST:
614             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_IO_CAPABILITIES_REQUEST);
615             if (hci_stack.ssp_io_capability == SSP_IO_CAPABILITY_UNKNOWN) break;
616             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], SEND_IO_CAPABILITIES_REPLY);
617             break;
618 
619         case HCI_EVENT_USER_CONFIRMATION_REQUEST:
620             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_USER_CONFIRM_REQUEST);
621             if (!hci_stack.ssp_auto_accept) break;
622             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], SEND_USER_CONFIRM_REPLY);
623             break;
624 
625         case HCI_EVENT_USER_PASSKEY_REQUEST:
626             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_USER_PASSKEY_REQUEST);
627             if (!hci_stack.ssp_auto_accept) break;
628             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], SEND_USER_PASSKEY_REPLY);
629             break;
630 
631 #ifndef EMBEDDED
632         case HCI_EVENT_REMOTE_NAME_REQUEST_COMPLETE:
633             if (!hci_stack.remote_device_db) break;
634             if (packet[2]) break; // status not ok
635             bt_flip_addr(addr, &packet[3]);
636             // fix for invalid remote names - terminate on 0xff
637             for (i=0; i<248;i++){
638                 if (packet[9+i] == 0xff){
639                     packet[9+i] = 0;
640                     break;
641                 }
642             }
643             memset(&device_name, 0, sizeof(device_name_t));
644             strncpy((char*) device_name, (char*) &packet[9], 248);
645             hci_stack.remote_device_db->put_name(&addr, &device_name);
646             break;
647 
648         case HCI_EVENT_INQUIRY_RESULT:
649         case HCI_EVENT_INQUIRY_RESULT_WITH_RSSI:
650             if (!hci_stack.remote_device_db) break;
651             // first send inq result packet
652             hci_stack.packet_handler(HCI_EVENT_PACKET, packet, size);
653             // then send cached remote names
654             for (i=0; i<packet[2];i++){
655                 bt_flip_addr(addr, &packet[3+i*6]);
656                 if (hci_stack.remote_device_db->get_name(&addr, &device_name)){
657                     hci_emit_remote_name_cached(&addr, &device_name);
658                 }
659             }
660             return;
661 #endif
662 
663         case HCI_EVENT_DISCONNECTION_COMPLETE:
664             if (!packet[2]){
665                 handle = READ_BT_16(packet, 3);
666                 hci_connection_t * conn = connection_for_handle(handle);
667                 if (conn) {
668                     hci_shutdown_connection(conn);
669                 }
670             }
671             break;
672 
673         case HCI_EVENT_HARDWARE_ERROR:
674             if(hci_stack.control->hw_error){
675                 (*hci_stack.control->hw_error)();
676             }
677             break;
678 
679 #ifdef HAVE_BLE
680         case HCI_EVENT_LE_META:
681             switch (packet[2]) {
682                 case HCI_SUBEVENT_LE_CONNECTION_COMPLETE:
683                     // Connection management
684                     bt_flip_addr(addr, &packet[8]);
685                     log_info("LE Connection_complete (status=%u) %s\n", packet[3], bd_addr_to_str(addr));
686                     // LE connections are auto-accepted, so just create a connection if there isn't one already
687                     conn = connection_for_address(addr);
688                     if (packet[3]){
689                         if (conn){
690                             // outgoing connection failed, remove entry
691                             linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
692                             btstack_memory_hci_connection_free( conn );
693 
694                         }
695                         // if authentication error, also delete link key
696                         if (packet[3] == 0x05) {
697                             hci_drop_link_key_for_bd_addr(&addr);
698                         }
699                         break;
700                     }
701                     if (!conn){
702                         conn = create_connection_for_addr(addr);
703                     }
704                     if (!conn){
705                         // no memory
706                         break;
707                     }
708 
709                     conn->state = OPEN;
710                     conn->con_handle = READ_BT_16(packet, 4);
711 
712                     // TODO: store - role, peer address type, conn_interval, conn_latency, supervision timeout, master clock
713 
714                     // restart timer
715                     // run_loop_set_timer(&conn->timeout, HCI_CONNECTION_TIMEOUT_MS);
716                     // run_loop_add_timer(&conn->timeout);
717 
718                     log_info("New connection: handle %u, %s\n", conn->con_handle, bd_addr_to_str(conn->address));
719 
720                     hci_emit_nr_connections_changed();
721                     break;
722 
723                 default:
724                     break;
725             }
726             break;
727 #endif
728 
729         default:
730             break;
731     }
732 
733     // handle BT initialization
734     if (hci_stack.state == HCI_STATE_INITIALIZING){
735         // handle H4 synchronization loss on restart
736         // if (hci_stack.substate == 1 && packet[0] == HCI_EVENT_HARDWARE_ERROR){
737         //    hci_stack.substate = 0;
738         // }
739         // handle normal init sequence
740         if (hci_stack.substate % 2){
741             // odd: waiting for event
742             if (packet[0] == HCI_EVENT_COMMAND_COMPLETE || packet[0] == HCI_EVENT_COMMAND_STATUS){
743                 hci_stack.substate++;
744             }
745         }
746     }
747 
748     // help with BT sleep
749     if (hci_stack.state == HCI_STATE_FALLING_ASLEEP
750         && hci_stack.substate == 1
751         && COMMAND_COMPLETE_EVENT(packet, hci_write_scan_enable)){
752         hci_stack.substate++;
753     }
754 
755     hci_stack.packet_handler(HCI_EVENT_PACKET, packet, size);
756 
757 	// execute main loop
758 	hci_run();
759 }
760 
761 static void packet_handler(uint8_t packet_type, uint8_t *packet, uint16_t size){
762     switch (packet_type) {
763         case HCI_EVENT_PACKET:
764             event_handler(packet, size);
765             break;
766         case HCI_ACL_DATA_PACKET:
767             acl_handler(packet, size);
768             break;
769         default:
770             break;
771     }
772 }
773 
774 /** Register HCI packet handlers */
775 void hci_register_packet_handler(void (*handler)(uint8_t packet_type, uint8_t *packet, uint16_t size)){
776     hci_stack.packet_handler = handler;
777 }
778 
779 void hci_init(hci_transport_t *transport, void *config, bt_control_t *control, remote_device_db_t const* remote_device_db){
780 
781     // reference to use transport layer implementation
782     hci_stack.hci_transport = transport;
783 
784     // references to used control implementation
785     hci_stack.control = control;
786 
787     // reference to used config
788     hci_stack.config = config;
789 
790     // no connections yet
791     hci_stack.connections = NULL;
792     hci_stack.discoverable = 0;
793     hci_stack.connectable = 0;
794 
795     // no pending cmds
796     hci_stack.decline_reason = 0;
797     hci_stack.new_scan_enable_value = 0xff;
798 
799     // higher level handler
800     hci_stack.packet_handler = dummy_handler;
801 
802     // store and open remote device db
803     hci_stack.remote_device_db = remote_device_db;
804     if (hci_stack.remote_device_db) {
805         hci_stack.remote_device_db->open();
806     }
807 
808     // max acl payload size defined in config.h
809     hci_stack.acl_data_packet_length = HCI_ACL_PAYLOAD_SIZE;
810 
811     // register packet handlers with transport
812     transport->register_packet_handler(&packet_handler);
813 
814     hci_stack.state = HCI_STATE_OFF;
815 
816     // class of device
817     hci_stack.class_of_device = 0x007a020c; // Smartphone
818 
819     // Secure Simple Pairing
820     hci_stack.ssp_enable = 0;
821     hci_stack.ssp_io_capability = SSP_IO_CAPABILITY_UNKNOWN;
822     hci_stack.ssp_authentication_requirement = 0;
823 }
824 
825 void hci_close(){
826     // close remote device db
827     if (hci_stack.remote_device_db) {
828         hci_stack.remote_device_db->close();
829     }
830     while (hci_stack.connections) {
831         hci_shutdown_connection((hci_connection_t *) hci_stack.connections);
832 }
833     hci_power_control(HCI_POWER_OFF);
834 }
835 
836 // State-Module-Driver overview
837 // state                    module  low-level
838 // HCI_STATE_OFF             off      close
839 // HCI_STATE_INITIALIZING,   on       open
840 // HCI_STATE_WORKING,        on       open
841 // HCI_STATE_HALTING,        on       open
842 // HCI_STATE_SLEEPING,    off/sleep   close
843 // HCI_STATE_FALLING_ASLEEP  on       open
844 
845 static int hci_power_control_on(void){
846 
847     // power on
848     int err = 0;
849     if (hci_stack.control && hci_stack.control->on){
850         err = (*hci_stack.control->on)(hci_stack.config);
851     }
852     if (err){
853         log_error( "POWER_ON failed\n");
854         hci_emit_hci_open_failed();
855         return err;
856     }
857 
858     // open low-level device
859     err = hci_stack.hci_transport->open(hci_stack.config);
860     if (err){
861         log_error( "HCI_INIT failed, turning Bluetooth off again\n");
862         if (hci_stack.control && hci_stack.control->off){
863             (*hci_stack.control->off)(hci_stack.config);
864         }
865         hci_emit_hci_open_failed();
866         return err;
867     }
868     return 0;
869 }
870 
871 static void hci_power_control_off(void){
872 
873     log_info("hci_power_control_off\n");
874 
875     // close low-level device
876     hci_stack.hci_transport->close(hci_stack.config);
877 
878     log_info("hci_power_control_off - hci_transport closed\n");
879 
880     // power off
881     if (hci_stack.control && hci_stack.control->off){
882         (*hci_stack.control->off)(hci_stack.config);
883     }
884 
885     log_info("hci_power_control_off - control closed\n");
886 
887     hci_stack.state = HCI_STATE_OFF;
888 }
889 
890 static void hci_power_control_sleep(void){
891 
892     log_info("hci_power_control_sleep\n");
893 
894 #if 0
895     // don't close serial port during sleep
896 
897     // close low-level device
898     hci_stack.hci_transport->close(hci_stack.config);
899 #endif
900 
901     // sleep mode
902     if (hci_stack.control && hci_stack.control->sleep){
903         (*hci_stack.control->sleep)(hci_stack.config);
904     }
905 
906     hci_stack.state = HCI_STATE_SLEEPING;
907 }
908 
909 static int hci_power_control_wake(void){
910 
911     log_info("hci_power_control_wake\n");
912 
913     // wake on
914     if (hci_stack.control && hci_stack.control->wake){
915         (*hci_stack.control->wake)(hci_stack.config);
916     }
917 
918 #if 0
919     // open low-level device
920     int err = hci_stack.hci_transport->open(hci_stack.config);
921     if (err){
922         log_error( "HCI_INIT failed, turning Bluetooth off again\n");
923         if (hci_stack.control && hci_stack.control->off){
924             (*hci_stack.control->off)(hci_stack.config);
925         }
926         hci_emit_hci_open_failed();
927         return err;
928     }
929 #endif
930 
931     return 0;
932 }
933 
934 
935 int hci_power_control(HCI_POWER_MODE power_mode){
936 
937     log_info("hci_power_control: %u, current mode %u\n", power_mode, hci_stack.state);
938 
939     int err = 0;
940     switch (hci_stack.state){
941 
942         case HCI_STATE_OFF:
943             switch (power_mode){
944                 case HCI_POWER_ON:
945                     err = hci_power_control_on();
946                     if (err) return err;
947                     // set up state machine
948                     hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
949                     hci_stack.state = HCI_STATE_INITIALIZING;
950                     hci_stack.substate = 0;
951                     break;
952                 case HCI_POWER_OFF:
953                     // do nothing
954                     break;
955                 case HCI_POWER_SLEEP:
956                     // do nothing (with SLEEP == OFF)
957                     break;
958             }
959             break;
960 
961         case HCI_STATE_INITIALIZING:
962             switch (power_mode){
963                 case HCI_POWER_ON:
964                     // do nothing
965                     break;
966                 case HCI_POWER_OFF:
967                     // no connections yet, just turn it off
968                     hci_power_control_off();
969                     break;
970                 case HCI_POWER_SLEEP:
971                     // no connections yet, just turn it off
972                     hci_power_control_sleep();
973                     break;
974             }
975             break;
976 
977         case HCI_STATE_WORKING:
978             switch (power_mode){
979                 case HCI_POWER_ON:
980                     // do nothing
981                     break;
982                 case HCI_POWER_OFF:
983                     // see hci_run
984                     hci_stack.state = HCI_STATE_HALTING;
985                     break;
986                 case HCI_POWER_SLEEP:
987                     // see hci_run
988                     hci_stack.state = HCI_STATE_FALLING_ASLEEP;
989                     hci_stack.substate = 0;
990                     break;
991             }
992             break;
993 
994         case HCI_STATE_HALTING:
995             switch (power_mode){
996                 case HCI_POWER_ON:
997                     // set up state machine
998                     hci_stack.state = HCI_STATE_INITIALIZING;
999                     hci_stack.substate = 0;
1000                     break;
1001                 case HCI_POWER_OFF:
1002                     // do nothing
1003                     break;
1004                 case HCI_POWER_SLEEP:
1005                     // see hci_run
1006                     hci_stack.state = HCI_STATE_FALLING_ASLEEP;
1007                     hci_stack.substate = 0;
1008                     break;
1009             }
1010             break;
1011 
1012         case HCI_STATE_FALLING_ASLEEP:
1013             switch (power_mode){
1014                 case HCI_POWER_ON:
1015 
1016 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1017                     // nothing to do, if H4 supports power management
1018                     if (bt_control_iphone_power_management_enabled()){
1019                         hci_stack.state = HCI_STATE_INITIALIZING;
1020                         hci_stack.substate = HCI_INTIALIZING_SUBSTATE_AFTER_SLEEP;
1021                         break;
1022                     }
1023 #endif
1024                     // set up state machine
1025                     hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
1026                     hci_stack.state = HCI_STATE_INITIALIZING;
1027                     hci_stack.substate = 0;
1028                     break;
1029                 case HCI_POWER_OFF:
1030                     // see hci_run
1031                     hci_stack.state = HCI_STATE_HALTING;
1032                     break;
1033                 case HCI_POWER_SLEEP:
1034                     // do nothing
1035                     break;
1036             }
1037             break;
1038 
1039         case HCI_STATE_SLEEPING:
1040             switch (power_mode){
1041                 case HCI_POWER_ON:
1042 
1043 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1044                     // nothing to do, if H4 supports power management
1045                     if (bt_control_iphone_power_management_enabled()){
1046                         hci_stack.state = HCI_STATE_INITIALIZING;
1047                         hci_stack.substate = HCI_INTIALIZING_SUBSTATE_AFTER_SLEEP;
1048                         hci_update_scan_enable();
1049                         break;
1050                     }
1051 #endif
1052                     err = hci_power_control_wake();
1053                     if (err) return err;
1054                     // set up state machine
1055                     hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
1056                     hci_stack.state = HCI_STATE_INITIALIZING;
1057                     hci_stack.substate = 0;
1058                     break;
1059                 case HCI_POWER_OFF:
1060                     hci_stack.state = HCI_STATE_HALTING;
1061                     break;
1062                 case HCI_POWER_SLEEP:
1063                     // do nothing
1064                     break;
1065             }
1066             break;
1067     }
1068 
1069     // create internal event
1070 	hci_emit_state();
1071 
1072 	// trigger next/first action
1073 	hci_run();
1074 
1075     return 0;
1076 }
1077 
1078 static void hci_update_scan_enable(void){
1079     // 2 = page scan, 1 = inq scan
1080     hci_stack.new_scan_enable_value  = hci_stack.connectable << 1 | hci_stack.discoverable;
1081     hci_run();
1082 }
1083 
1084 void hci_discoverable_control(uint8_t enable){
1085     if (enable) enable = 1; // normalize argument
1086 
1087     if (hci_stack.discoverable == enable){
1088         hci_emit_discoverable_enabled(hci_stack.discoverable);
1089         return;
1090     }
1091 
1092     hci_stack.discoverable = enable;
1093     hci_update_scan_enable();
1094 }
1095 
1096 void hci_connectable_control(uint8_t enable){
1097     if (enable) enable = 1; // normalize argument
1098 
1099     // don't emit event
1100     if (hci_stack.connectable == enable) return;
1101 
1102     hci_stack.connectable = enable;
1103     hci_update_scan_enable();
1104 }
1105 
1106 void hci_run(){
1107 
1108     hci_connection_t * connection;
1109     linked_item_t * it;
1110 
1111     if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1112 
1113     // global/non-connection oriented commands
1114 
1115     // decline incoming connections
1116     if (hci_stack.decline_reason){
1117         uint8_t reason = hci_stack.decline_reason;
1118         hci_stack.decline_reason = 0;
1119         hci_send_cmd(&hci_reject_connection_request, hci_stack.decline_addr, reason);
1120         return;
1121     }
1122 
1123     // send scan enable
1124     if (hci_stack.state == HCI_STATE_WORKING && hci_stack.new_scan_enable_value != 0xff){
1125         hci_send_cmd(&hci_write_scan_enable, hci_stack.new_scan_enable_value);
1126         hci_stack.new_scan_enable_value = 0xff;
1127         return;
1128     }
1129 
1130     // send pending HCI commands
1131     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
1132 
1133         connection = (hci_connection_t *) it;
1134 
1135         if (connection->state == RECEIVED_CONNECTION_REQUEST){
1136             log_info("sending hci_accept_connection_request\n");
1137             hci_send_cmd(&hci_accept_connection_request, connection->address, 1);
1138             connection->state = ACCEPTED_CONNECTION_REQUEST;
1139             return;
1140         }
1141 
1142         if (connection->authentication_flags & HANDLE_LINK_KEY_REQUEST){
1143             link_key_t link_key;
1144             log_info("responding to link key request\n");
1145             if ( hci_stack.remote_device_db->get_link_key( &connection->address, &link_key)){
1146                hci_send_cmd(&hci_link_key_request_reply, connection->address, &link_key);
1147             } else {
1148                hci_send_cmd(&hci_link_key_request_negative_reply, connection->address);
1149             }
1150             connectionClearAuthenticationFlags(connection, HANDLE_LINK_KEY_REQUEST);
1151             return;
1152         }
1153 
1154         if (connection->authentication_flags & SEND_IO_CAPABILITIES_REPLY){
1155             hci_send_cmd(&hci_io_capability_request_reply, &connection->address, hci_stack.ssp_io_capability, NULL, hci_stack.ssp_authentication_requirement);
1156             connectionClearAuthenticationFlags(connection, SEND_IO_CAPABILITIES_REPLY);
1157             return;
1158         }
1159 
1160         if (connection->authentication_flags & SEND_USER_CONFIRM_REPLY){
1161             hci_send_cmd(&hci_user_confirmation_request_reply, &connection->address);
1162             connectionClearAuthenticationFlags(connection, SEND_USER_CONFIRM_REPLY);
1163             return;
1164         }
1165 
1166         if (connection->authentication_flags & SEND_USER_PASSKEY_REPLY){
1167             hci_send_cmd(&hci_user_passkey_request_reply, &connection->address, 000000);
1168             connectionClearAuthenticationFlags(connection, SEND_USER_PASSKEY_REPLY);
1169             return;
1170         }
1171     }
1172 
1173     switch (hci_stack.state){
1174         case HCI_STATE_INITIALIZING:
1175             // log_info("hci_init: substate %u\n", hci_stack.substate);
1176             if (hci_stack.substate % 2) {
1177                 // odd: waiting for command completion
1178                 return;
1179             }
1180             switch (hci_stack.substate >> 1){
1181                 case 0: // RESET
1182                     hci_send_cmd(&hci_reset);
1183                     if (hci_stack.config == 0 || ((hci_uart_config_t *)hci_stack.config)->baudrate_main == 0){
1184                         // skip baud change
1185                         hci_stack.substate = 4; // >> 1 = 2
1186                     }
1187                     break;
1188                 case 1: // SEND BAUD CHANGE
1189                     hci_stack.control->baudrate_cmd(hci_stack.config, ((hci_uart_config_t *)hci_stack.config)->baudrate_main, hci_stack.hci_packet_buffer);
1190                     hci_send_cmd_packet(hci_stack.hci_packet_buffer, 3 + hci_stack.hci_packet_buffer[2]);
1191                     break;
1192                 case 2: // LOCAL BAUD CHANGE
1193                     hci_stack.hci_transport->set_baudrate(((hci_uart_config_t *)hci_stack.config)->baudrate_main);
1194                     hci_stack.substate += 2;
1195                     // break missing here for fall through
1196 
1197                 case 3:
1198                     // custom initialization
1199                     if (hci_stack.control && hci_stack.control->next_cmd){
1200                         int valid_cmd = (*hci_stack.control->next_cmd)(hci_stack.config, hci_stack.hci_packet_buffer);
1201                         if (valid_cmd){
1202                             int size = 3 + hci_stack.hci_packet_buffer[2];
1203                             hci_stack.hci_transport->send_packet(HCI_COMMAND_DATA_PACKET, hci_stack.hci_packet_buffer, size);
1204                             hci_stack.substate = 4; // more init commands
1205                             break;
1206                         }
1207                         log_info("hci_run: init script done\n\r");
1208                     }
1209                     // otherwise continue
1210 					hci_send_cmd(&hci_read_bd_addr);
1211 					break;
1212 				case 4:
1213 					hci_send_cmd(&hci_read_buffer_size);
1214 					break;
1215                 case 5:
1216                     hci_send_cmd(&hci_read_local_supported_features);
1217                     break;
1218                 case 6:
1219                     hci_send_cmd(&hci_set_event_mask,0xffffffff, 0xFFFFFFFF); ///0x1DFFFFFF
1220 
1221                     // skip Classic init commands for LE only chipsets
1222                     if (hci_classic_supported()){
1223                         if (!hci_ssp_supported()){
1224                             hci_stack.substate = 7 << 1; // skip hci_write_simple_pairing_mode
1225                         }
1226                     }   else {
1227                         hci_stack.substate = 11 << 1;    // skip all classic command
1228                     }
1229                     break;
1230                 case 7:
1231                     hci_send_cmd(&hci_write_simple_pairing_mode, hci_stack.ssp_enable);
1232                     break;
1233                 case 8:
1234                     // ca. 15 sec
1235                     hci_send_cmd(&hci_write_page_timeout, 0x6000);
1236                     break;
1237                 case 9:
1238                     hci_send_cmd(&hci_write_class_of_device, hci_stack.class_of_device);
1239                     break;
1240                 case 10:
1241                     if (hci_stack.local_name){
1242                         hci_send_cmd(&hci_write_local_name, hci_stack.local_name);
1243                     } else {
1244                         char hostname[30];
1245 #ifdef EMBEDDED
1246                         // BTstack-11:22:33:44:55:66
1247                         strcpy(hostname, "BTstack ");
1248                         strcat(hostname, bd_addr_to_str(hci_stack.local_bd_addr));
1249                         printf("---> Name %s\n", hostname);
1250 #else
1251                         // hostname for POSIX systems
1252                         gethostname(hostname, 30);
1253                         hostname[29] = '\0';
1254 #endif
1255                         hci_send_cmd(&hci_write_local_name, hostname);
1256                     }
1257                     break;
1258                 case 11:
1259 					hci_send_cmd(&hci_write_scan_enable, (hci_stack.connectable << 1) | hci_stack.discoverable); // page scan
1260 					break;
1261                 case 12:
1262                     // done.
1263                     hci_stack.state = HCI_STATE_WORKING;
1264                     hci_emit_state();
1265                     break;
1266                 default:
1267                     break;
1268             }
1269             hci_stack.substate++;
1270             break;
1271 
1272         case HCI_STATE_HALTING:
1273 
1274             log_info("HCI_STATE_HALTING\n");
1275             // close all open connections
1276             connection =  (hci_connection_t *) hci_stack.connections;
1277             if (connection){
1278 
1279                 // send disconnect
1280                 if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1281 
1282                 log_info("HCI_STATE_HALTING, connection %p, handle %u\n", connection, (uint16_t)connection->con_handle);
1283                 hci_send_cmd(&hci_disconnect, connection->con_handle, 0x13);  // remote closed connection
1284 
1285                 // send disconnected event right away - causes higher layer connections to get closed, too.
1286                 hci_shutdown_connection(connection);
1287                 return;
1288             }
1289             log_info("HCI_STATE_HALTING, calling off\n");
1290 
1291             // switch mode
1292             hci_power_control_off();
1293 
1294             log_info("HCI_STATE_HALTING, emitting state\n");
1295             hci_emit_state();
1296             log_info("HCI_STATE_HALTING, done\n");
1297             break;
1298 
1299         case HCI_STATE_FALLING_ASLEEP:
1300             switch(hci_stack.substate) {
1301                 case 0:
1302                     log_info("HCI_STATE_FALLING_ASLEEP\n");
1303                     // close all open connections
1304                     connection =  (hci_connection_t *) hci_stack.connections;
1305 
1306 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1307                     // don't close connections, if H4 supports power management
1308                     if (bt_control_iphone_power_management_enabled()){
1309                         connection = NULL;
1310                     }
1311 #endif
1312                     if (connection){
1313 
1314                         // send disconnect
1315                         if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1316 
1317                         log_info("HCI_STATE_FALLING_ASLEEP, connection %p, handle %u\n", connection, (uint16_t)connection->con_handle);
1318                         hci_send_cmd(&hci_disconnect, connection->con_handle, 0x13);  // remote closed connection
1319 
1320                         // send disconnected event right away - causes higher layer connections to get closed, too.
1321                         hci_shutdown_connection(connection);
1322                         return;
1323                     }
1324 
1325                     // disable page and inquiry scan
1326                     if (!hci_can_send_packet_now(HCI_COMMAND_DATA_PACKET)) return;
1327 
1328                     log_info("HCI_STATE_HALTING, disabling inq cans\n");
1329                     hci_send_cmd(&hci_write_scan_enable, hci_stack.connectable << 1); // drop inquiry scan but keep page scan
1330 
1331                     // continue in next sub state
1332                     hci_stack.substate++;
1333                     break;
1334                 case 1:
1335                     // wait for command complete "hci_write_scan_enable" in event_handler();
1336                     break;
1337                 case 2:
1338                     log_info("HCI_STATE_HALTING, calling sleep\n");
1339 #if defined(USE_POWERMANAGEMENT) && defined(USE_BLUETOOL)
1340                     // don't actually go to sleep, if H4 supports power management
1341                     if (bt_control_iphone_power_management_enabled()){
1342                         // SLEEP MODE reached
1343                         hci_stack.state = HCI_STATE_SLEEPING;
1344                         hci_emit_state();
1345                         break;
1346                     }
1347 #endif
1348                     // switch mode
1349                     hci_power_control_sleep();  // changes hci_stack.state to SLEEP
1350                     hci_emit_state();
1351                     break;
1352 
1353                 default:
1354                     break;
1355             }
1356             break;
1357 
1358         default:
1359             break;
1360     }
1361 }
1362 
1363 int hci_send_cmd_packet(uint8_t *packet, int size){
1364     bd_addr_t addr;
1365     hci_connection_t * conn;
1366     // house-keeping
1367 
1368     // create_connection?
1369     if (IS_COMMAND(packet, hci_create_connection)){
1370         bt_flip_addr(addr, &packet[3]);
1371         log_info("Create_connection to %s\n", bd_addr_to_str(addr));
1372         conn = connection_for_address(addr);
1373         if (conn) {
1374             // if connection exists
1375             if (conn->state == OPEN) {
1376                 // and OPEN, emit connection complete command
1377                 hci_emit_connection_complete(conn, 0);
1378             }
1379             //    otherwise, just ignore as it is already in the open process
1380             return 0; // don't sent packet to controller
1381 
1382         }
1383         // create connection struct and register, state = SENT_CREATE_CONNECTION
1384         conn = create_connection_for_addr(addr);
1385         if (!conn){
1386             // notify client that alloc failed
1387             hci_emit_connection_complete(conn, BTSTACK_MEMORY_ALLOC_FAILED);
1388             return 0; // don't sent packet to controller
1389         }
1390         conn->state = SENT_CREATE_CONNECTION;
1391     }
1392 
1393     if (IS_COMMAND(packet, hci_link_key_request_reply)){
1394         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_LINK_KEY_REPLY);
1395     }
1396     if (IS_COMMAND(packet, hci_link_key_request_negative_reply)){
1397         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_LINK_KEY_NEGATIVE_REQUEST);
1398     }
1399     if (IS_COMMAND(packet, hci_pin_code_request_reply)){
1400         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_PIN_CODE_REPLY);
1401     }
1402     if (IS_COMMAND(packet, hci_pin_code_request_negative_reply)){
1403         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_PIN_CODE_NEGATIVE_REPLY);
1404     }
1405 
1406     if (IS_COMMAND(packet, hci_delete_stored_link_key)){
1407         if (hci_stack.remote_device_db){
1408             bt_flip_addr(addr, &packet[3]);
1409             hci_stack.remote_device_db->delete_link_key(&addr);
1410         }
1411     }
1412 
1413     hci_stack.num_cmd_packets--;
1414     return hci_stack.hci_transport->send_packet(HCI_COMMAND_DATA_PACKET, packet, size);
1415 }
1416 
1417 // Configure Secure Simple Pairing
1418 
1419 // enable will enable SSP during init
1420 void hci_ssp_set_enable(int enable){
1421     hci_stack.ssp_enable = enable;
1422 }
1423 
1424 // if set, BTstack will respond to io capability request using authentication requirement
1425 void hci_ssp_set_io_capability(int io_capability){
1426     hci_stack.ssp_io_capability = io_capability;
1427 }
1428 void hci_ssp_set_authentication_requirement(int authentication_requirement){
1429     hci_stack.ssp_authentication_requirement = authentication_requirement;
1430 }
1431 
1432 // if set, BTstack will confirm a numberic comparion and enter '000000' if requested
1433 void hci_ssp_set_auto_accept(int auto_accept){
1434     hci_stack.ssp_auto_accept = auto_accept;
1435 }
1436 
1437 /**
1438  * pre: numcmds >= 0 - it's allowed to send a command to the controller
1439  */
1440 int hci_send_cmd(const hci_cmd_t *cmd, ...){
1441     va_list argptr;
1442     va_start(argptr, cmd);
1443     uint16_t size = hci_create_cmd_internal(hci_stack.hci_packet_buffer, cmd, argptr);
1444     va_end(argptr);
1445     return hci_send_cmd_packet(hci_stack.hci_packet_buffer, size);
1446 }
1447 
1448 // Create various non-HCI events.
1449 // TODO: generalize, use table similar to hci_create_command
1450 
1451 void hci_emit_state(){
1452     log_info("BTSTACK_EVENT_STATE %u", hci_stack.state);
1453     uint8_t event[3];
1454     event[0] = BTSTACK_EVENT_STATE;
1455     event[1] = sizeof(event) - 2;
1456     event[2] = hci_stack.state;
1457     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1458     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1459 }
1460 
1461 void hci_emit_connection_complete(hci_connection_t *conn, uint8_t status){
1462     uint8_t event[13];
1463     event[0] = HCI_EVENT_CONNECTION_COMPLETE;
1464     event[1] = sizeof(event) - 2;
1465     event[2] = status;
1466     bt_store_16(event, 3, conn->con_handle);
1467     bt_flip_addr(&event[5], conn->address);
1468     event[11] = 1; // ACL connection
1469     event[12] = 0; // encryption disabled
1470     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1471     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1472 }
1473 
1474 void hci_emit_disconnection_complete(uint16_t handle, uint8_t reason){
1475     uint8_t event[6];
1476     event[0] = HCI_EVENT_DISCONNECTION_COMPLETE;
1477     event[1] = sizeof(event) - 2;
1478     event[2] = 0; // status = OK
1479     bt_store_16(event, 3, handle);
1480     event[5] = reason;
1481     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1482     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1483 }
1484 
1485 void hci_emit_l2cap_check_timeout(hci_connection_t *conn){
1486     log_info("L2CAP_EVENT_TIMEOUT_CHECK");
1487     uint8_t event[4];
1488     event[0] = L2CAP_EVENT_TIMEOUT_CHECK;
1489     event[1] = sizeof(event) - 2;
1490     bt_store_16(event, 2, conn->con_handle);
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_nr_connections_changed(){
1496     log_info("BTSTACK_EVENT_NR_CONNECTIONS_CHANGED %u", nr_hci_connections());
1497     uint8_t event[3];
1498     event[0] = BTSTACK_EVENT_NR_CONNECTIONS_CHANGED;
1499     event[1] = sizeof(event) - 2;
1500     event[2] = nr_hci_connections();
1501     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1502     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1503 }
1504 
1505 void hci_emit_hci_open_failed(){
1506     log_info("BTSTACK_EVENT_POWERON_FAILED");
1507     uint8_t event[2];
1508     event[0] = BTSTACK_EVENT_POWERON_FAILED;
1509     event[1] = sizeof(event) - 2;
1510     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1511     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1512 }
1513 
1514 #ifndef EMBEDDED
1515 void hci_emit_btstack_version() {
1516     log_info("BTSTACK_EVENT_VERSION %u.%u", BTSTACK_MAJOR, BTSTACK_MINOR);
1517     uint8_t event[6];
1518     event[0] = BTSTACK_EVENT_VERSION;
1519     event[1] = sizeof(event) - 2;
1520     event[2] = BTSTACK_MAJOR;
1521     event[3] = BTSTACK_MINOR;
1522     bt_store_16(event, 4, BTSTACK_REVISION);
1523     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1524     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1525 }
1526 #endif
1527 
1528 void hci_emit_system_bluetooth_enabled(uint8_t enabled){
1529     log_info("BTSTACK_EVENT_SYSTEM_BLUETOOTH_ENABLED %u", enabled);
1530     uint8_t event[3];
1531     event[0] = BTSTACK_EVENT_SYSTEM_BLUETOOTH_ENABLED;
1532     event[1] = sizeof(event) - 2;
1533     event[2] = enabled;
1534     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1535     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1536 }
1537 
1538 void hci_emit_remote_name_cached(bd_addr_t *addr, device_name_t *name){
1539     uint8_t event[2+1+6+248+1]; // +1 for \0 in log_info
1540     event[0] = BTSTACK_EVENT_REMOTE_NAME_CACHED;
1541     event[1] = sizeof(event) - 2 - 1;
1542     event[2] = 0;   // just to be compatible with HCI_EVENT_REMOTE_NAME_REQUEST_COMPLETE
1543     bt_flip_addr(&event[3], *addr);
1544     memcpy(&event[9], name, 248);
1545 
1546     event[9+248] = 0;   // assert \0 for log_info
1547     log_info("BTSTACK_EVENT_REMOTE_NAME_CACHED %s = '%s'", bd_addr_to_str(*addr), &event[9]);
1548 
1549     hci_dump_packet(HCI_EVENT_PACKET, 0, event, sizeof(event)-1);
1550     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event)-1);
1551 }
1552 
1553 void hci_emit_discoverable_enabled(uint8_t enabled){
1554     log_info("BTSTACK_EVENT_DISCOVERABLE_ENABLED %u", enabled);
1555     uint8_t event[3];
1556     event[0] = BTSTACK_EVENT_DISCOVERABLE_ENABLED;
1557     event[1] = sizeof(event) - 2;
1558     event[2] = enabled;
1559     hci_dump_packet( HCI_EVENT_PACKET, 0, event, sizeof(event));
1560     hci_stack.packet_handler(HCI_EVENT_PACKET, event, sizeof(event));
1561 }
1562