xref: /btstack/src/hci.c (revision 75e651ceb3104f96fdcdd99de7ad64a8f6b494ec)
1 /*
2  * Copyright (C) 2009 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  *
17  * THIS SOFTWARE IS PROVIDED BY MATTHIAS RINGWALD AND CONTRIBUTORS
18  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
20  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
21  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
23  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
24  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
25  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
26  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
27  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  *
30  */
31 
32 /*
33  *  hci.c
34  *
35  *  Created by Matthias Ringwald on 4/29/09.
36  *
37  */
38 
39 #include "hci.h"
40 
41 #include <unistd.h>
42 #include <stdarg.h>
43 #include <string.h>
44 #include <stdio.h>
45 
46 #include "debug.h"
47 #include "hci_dump.h"
48 
49 #include "../include/btstack/hci_cmds.h"
50 #include "../include/btstack/version.h"
51 
52 // temp
53 #include "l2cap.h"
54 
55 #define HCI_CONNECTION_TIMEOUT_MS 10000
56 
57 // the STACK is here
58 static hci_stack_t       hci_stack;
59 
60 /**
61  * get connection for a given handle
62  *
63  * @return connection OR NULL, if not found
64  */
65 hci_connection_t * connection_for_handle(hci_con_handle_t con_handle){
66     linked_item_t *it;
67     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
68         if ( ((hci_connection_t *) it)->con_handle == con_handle){
69             return (hci_connection_t *) it;
70         }
71     }
72     return NULL;
73 }
74 
75 static void hci_connection_timeout_handler(timer_source_t *timer){
76     hci_connection_t * connection = linked_item_get_user(&timer->item);
77     struct timeval tv;
78     gettimeofday(&tv, NULL);
79     if (tv.tv_sec >= connection->timestamp.tv_sec + HCI_CONNECTION_TIMEOUT_MS/1000) {
80         // connections might be timed out
81         hci_emit_l2cap_check_timeout(connection);
82         run_loop_set_timer(timer, HCI_CONNECTION_TIMEOUT_MS);
83     } else {
84         // next timeout check at
85         timer->timeout.tv_sec = connection->timestamp.tv_sec + HCI_CONNECTION_TIMEOUT_MS/1000;
86     }
87     run_loop_add_timer(timer);
88 }
89 
90 static void hci_connection_timestamp(hci_connection_t *connection){
91     gettimeofday(&connection->timestamp, NULL);
92 }
93 
94 /**
95  * create connection for given address
96  *
97  * @return connection OR NULL, if not found
98  */
99 static hci_connection_t * create_connection_for_addr(bd_addr_t addr){
100     hci_connection_t * conn = malloc( sizeof(hci_connection_t) );
101     if (!conn) return NULL;
102     BD_ADDR_COPY(conn->address, addr);
103     conn->con_handle = 0xffff;
104     conn->authentication_flags = 0;
105     linked_item_set_user(&conn->timeout.item, conn);
106     conn->timeout.process = hci_connection_timeout_handler;
107     hci_connection_timestamp(conn);
108     conn->acl_recombination_length = 0;
109     conn->acl_recombination_pos = 0;
110     conn->num_acl_packets_sent = 0;
111     linked_list_add(&hci_stack.connections, (linked_item_t *) conn);
112     return conn;
113 }
114 
115 /**
116  * get connection for given address
117  *
118  * @return connection OR NULL, if not found
119  */
120 static hci_connection_t * connection_for_address(bd_addr_t address){
121     linked_item_t *it;
122     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
123         if ( ! BD_ADDR_CMP( ((hci_connection_t *) it)->address, address) ){
124             return (hci_connection_t *) it;
125         }
126     }
127     return NULL;
128 }
129 
130 /**
131  * add authentication flags and reset timer
132  */
133 static void hci_add_connection_flags_for_flipped_bd_addr(uint8_t *bd_addr, hci_authentication_flags_t flags){
134     bd_addr_t addr;
135     bt_flip_addr(addr, *(bd_addr_t *) bd_addr);
136     hci_connection_t * conn = connection_for_address(addr);
137     if (conn) {
138         conn->authentication_flags |= flags;
139         hci_connection_timestamp(conn);
140     }
141 }
142 
143 int  hci_authentication_active_for_handle(hci_con_handle_t handle){
144     hci_connection_t * conn = connection_for_handle(handle);
145     if (!conn) return 0;
146     if (!conn->authentication_flags) return 0;
147     if (conn->authentication_flags & SENT_LINK_KEY_REPLY) return 0;
148     if (conn->authentication_flags & RECV_LINK_KEY_NOTIFICATION) return 0;
149     return 1;
150 }
151 
152 
153 /**
154  * count connections
155  */
156 static int nr_hci_connections(){
157     int count = 0;
158     linked_item_t *it;
159     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next, count++);
160     return count;
161 }
162 
163 /**
164  * Dummy handler called by HCI
165  */
166 static void dummy_handler(uint8_t packet_type, uint8_t *packet, uint16_t size){
167 }
168 
169 uint8_t hci_number_outgoing_packets(hci_con_handle_t handle){
170     hci_connection_t * connection = connection_for_handle(handle);
171     if (!connection) {
172         log_err("hci_number_outgoing_packets connectino for handle %u does not exist!\n", handle);
173         return 0;
174     }
175     return connection->num_acl_packets_sent;
176 }
177 
178 uint8_t hci_number_free_acl_slots(){
179     uint8_t free_slots = hci_stack.total_num_acl_packets;
180     linked_item_t *it;
181     for (it = (linked_item_t *) hci_stack.connections; it ; it = it->next){
182         hci_connection_t * connection = (hci_connection_t *) it;
183         if (free_slots < connection->num_acl_packets_sent) {
184             log_err("hci_number_free_acl_slots: sum of outgoing packets > total acl packets!\n");
185             return 0;
186         }
187         free_slots -= connection->num_acl_packets_sent;
188     }
189     return free_slots;
190 }
191 
192 int hci_ready_to_send(hci_con_handle_t handle){
193     return hci_number_free_acl_slots() && hci_number_outgoing_packets(handle) < 2;
194 }
195 
196 int hci_send_acl_packet(uint8_t *packet, int size){
197 
198     // check for free places on BT module
199     if (!hci_number_free_acl_slots()) return -1;
200 
201     hci_con_handle_t con_handle = READ_ACL_CONNECTION_HANDLE(packet);
202     hci_connection_t *connection = connection_for_handle( con_handle);
203     if (!connection) return 0;
204     hci_connection_timestamp(connection);
205 
206     // count packet
207     connection->num_acl_packets_sent++;
208     // log_dbg("hci_send_acl_packet - handle %u, sent %u\n", connection->con_handle, connection->num_acl_packets_sent);
209 
210     // send packet - ignore errors
211     hci_stack.hci_transport->send_packet(HCI_ACL_DATA_PACKET, packet, size);
212 
213     return 0;
214 }
215 
216 static void acl_handler(uint8_t *packet, int size){
217 
218     // get info
219     hci_con_handle_t con_handle = READ_ACL_CONNECTION_HANDLE(packet);
220     hci_connection_t *conn      = connection_for_handle(con_handle);
221     uint8_t  acl_flags          = READ_ACL_FLAGS(packet);
222     uint16_t acl_length         = READ_ACL_LENGTH(packet);
223 
224     // ignore non-registered handle
225     if (!conn){
226         log_err( "hci.c: acl_handler called with non-registered handle %u!\n" , con_handle);
227         return;
228     }
229 
230     // update idle timestamp
231     hci_connection_timestamp(conn);
232 
233     // handle different packet types
234     switch (acl_flags & 0x03) {
235 
236         case 0x01: // continuation fragment
237 
238             // sanity check
239             if (conn->acl_recombination_pos == 0) {
240                 log_err( "ACL Cont Fragment but no first fragment for handle 0x%02x\n", con_handle);
241                 return;
242             }
243 
244             // append fragment payload (header already stored)
245             memcpy(&conn->acl_recombination_buffer[conn->acl_recombination_pos], &packet[4], acl_length );
246             conn->acl_recombination_pos += acl_length;
247 
248             // log_err( "ACL Cont Fragment: acl_len %u, combined_len %u, l2cap_len %u\n",
249             //        acl_length, connection->acl_recombination_pos, connection->acl_recombination_length);
250 
251             // forward complete L2CAP packet if complete.
252             if (conn->acl_recombination_pos >= conn->acl_recombination_length + 4 + 4){ // pos already incl. ACL header
253 
254                 hci_stack.packet_handler(HCI_ACL_DATA_PACKET, conn->acl_recombination_buffer, conn->acl_recombination_pos);
255                 // reset recombination buffer
256                 conn->acl_recombination_length = 0;
257                 conn->acl_recombination_pos = 0;
258             }
259             break;
260 
261         case 0x02: { // first fragment
262 
263             // sanity check
264             if (conn->acl_recombination_pos) {
265                 log_err( "ACL First Fragment but data in buffer for handle 0x%02x\n", con_handle);
266                 return;
267             }
268 
269             // peek into L2CAP packet!
270             uint16_t l2cap_length = READ_L2CAP_LENGTH( packet );
271 
272             // compare fragment size to L2CAP packet size
273             if (acl_length >= l2cap_length + 4){
274 
275                 // forward fragment as L2CAP packet
276                 hci_stack.packet_handler(HCI_ACL_DATA_PACKET, packet, acl_length + 4);
277 
278             } else {
279                 // store first fragment and tweak acl length for complete package
280                 memcpy(conn->acl_recombination_buffer, packet, acl_length + 4);
281                 conn->acl_recombination_pos    = acl_length + 4;
282                 conn->acl_recombination_length = l2cap_length;
283                 bt_store_16(conn->acl_recombination_buffer, 2, acl_length +4);
284                 // log_err( "ACL First Fragment: acl_len %u, l2cap_len %u\n", acl_length, l2cap_length);
285             }
286             break;
287 
288         }
289         default:
290             log_err( "hci.c: acl_handler called with invalid packet boundary flags %u\n", acl_flags & 0x03);
291             return;
292     }
293 
294     // execute main loop
295     hci_run();
296 }
297 
298 static void event_handler(uint8_t *packet, int size){
299     bd_addr_t addr;
300     hci_con_handle_t handle;
301     hci_connection_t * conn;
302     int i;
303 
304     // get num_cmd_packets
305     if (packet[0] == HCI_EVENT_COMMAND_COMPLETE || packet[0] == HCI_EVENT_COMMAND_STATUS){
306         // Get Num_HCI_Command_Packets
307         hci_stack.num_cmd_packets = packet[2];
308     }
309 
310     switch (packet[0]) {
311 
312         case HCI_EVENT_COMMAND_COMPLETE:
313             if (COMMAND_COMPLETE_EVENT(packet, hci_read_buffer_size)){
314                 // from offset 5
315                 // status
316                 hci_stack.acl_data_packet_length = READ_BT_16(packet, 6);
317                 // ignore: SCO data packet len (8)
318                 hci_stack.total_num_acl_packets  = packet[9];
319                 // ignore: total num SCO packets
320                 if (hci_stack.state == HCI_STATE_INITIALIZING){
321                     log_dbg("hci_read_buffer_size: size %u, count %u\n", hci_stack.acl_data_packet_length, hci_stack.total_num_acl_packets);
322                 }
323             }
324             break;
325 
326         case HCI_EVENT_NUMBER_OF_COMPLETED_PACKETS:
327             for (i=0; i<packet[2];i++){
328                 handle = READ_BT_16(packet, 3 + 2*i);
329                 uint16_t num_packets = READ_BT_16(packet, 3 + packet[2]*2 + 2*i);
330                 conn = connection_for_handle(handle);
331                 if (!conn){
332                     log_err("hci_number_completed_packet lists unused con handle %u\n", handle);
333                     continue;
334                 }
335                 conn->num_acl_packets_sent -= num_packets;
336                 // log_dbg("hci_number_completed_packet %u processed for handle %u, outstanding %u\n", num_packets, handle, conn->num_acl_packets_sent);
337             }
338             break;
339 
340         case HCI_EVENT_CONNECTION_REQUEST:
341             bt_flip_addr(addr, &packet[2]);
342             // TODO: eval COD 8-10
343             uint8_t link_type = packet[11];
344             log_dbg("Connection_incoming: "); print_bd_addr(addr); log_dbg(", type %u\n", link_type);
345             if (link_type == 1) { // ACL
346                 conn = connection_for_address(addr);
347                 if (!conn) {
348                     conn = create_connection_for_addr(addr);
349                 }
350                 // TODO: check for malloc failure
351                 conn->state = ACCEPTED_CONNECTION_REQUEST;
352                 hci_send_cmd(&hci_accept_connection_request, addr, 1);
353             } else {
354                 // TODO: decline request
355             }
356             break;
357 
358         case HCI_EVENT_CONNECTION_COMPLETE:
359             // Connection management
360             bt_flip_addr(addr, &packet[5]);
361             log_dbg("Connection_complete (status=%u)", packet[2]); print_bd_addr(addr); log_dbg("\n");
362             conn = connection_for_address(addr);
363             if (conn) {
364                 if (!packet[2]){
365                     conn->state = OPEN;
366                     conn->con_handle = READ_BT_16(packet, 3);
367 
368                     gettimeofday(&conn->timestamp, NULL);
369                     run_loop_set_timer(&conn->timeout, HCI_CONNECTION_TIMEOUT_MS);
370                     run_loop_add_timer(&conn->timeout);
371 
372                     log_dbg("New connection: handle %u, ", conn->con_handle);
373                     print_bd_addr( conn->address );
374                     log_dbg("\n");
375 
376                     hci_emit_nr_connections_changed();
377                 } else {
378                     // connection failed, remove entry
379                     linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
380                     free( conn );
381                 }
382             }
383             break;
384 
385         case HCI_EVENT_LINK_KEY_REQUEST:
386             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_LINK_KEY_REQUEST);
387             break;
388 
389         case HCI_EVENT_LINK_KEY_NOTIFICATION:
390             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_LINK_KEY_NOTIFICATION);
391             break;
392 
393         case HCI_EVENT_PIN_CODE_REQUEST:
394             hci_add_connection_flags_for_flipped_bd_addr(&packet[2], RECV_PIN_CODE_REQUEST);
395             break;
396 
397         case HCI_EVENT_DISCONNECTION_COMPLETE:
398             if (!packet[2]){
399                 handle = READ_BT_16(packet, 3);
400                 hci_connection_t * conn = connection_for_handle(handle);
401                 if (conn) {
402                     log_dbg("Connection closed: handle %u, ", conn->con_handle);
403                     print_bd_addr( conn->address );
404                     log_dbg("\n");
405                     run_loop_remove_timer(&conn->timeout);
406                     linked_list_remove(&hci_stack.connections, (linked_item_t *) conn);
407                     free( conn );
408                     hci_emit_nr_connections_changed();
409                 }
410             }
411             break;
412 
413         default:
414             break;
415     }
416 
417     // handle BT initialization
418     if (hci_stack.state == HCI_STATE_INITIALIZING){
419         // handle H4 synchronization loss on restart
420         // if (hci_stack.substate == 1 && packet[0] == HCI_EVENT_HARDWARE_ERROR){
421         //    hci_stack.substate = 0;
422         // }
423         // handle normal init sequence
424         if (hci_stack.substate % 2){
425             // odd: waiting for event
426             if (packet[0] == HCI_EVENT_COMMAND_COMPLETE){
427                 hci_stack.substate++;
428             }
429         }
430     }
431 
432     hci_stack.packet_handler(HCI_EVENT_PACKET, packet, size);
433 
434 	// execute main loop
435 	hci_run();
436 }
437 
438 void packet_handler(uint8_t packet_type, uint8_t *packet, uint16_t size){
439     switch (packet_type) {
440         case HCI_EVENT_PACKET:
441             event_handler(packet, size);
442             break;
443         case HCI_ACL_DATA_PACKET:
444             acl_handler(packet, size);
445             break;
446         default:
447             break;
448     }
449 }
450 
451 /** Register HCI packet handlers */
452 void hci_register_packet_handler(void (*handler)(uint8_t packet_type, uint8_t *packet, uint16_t size)){
453     hci_stack.packet_handler = handler;
454 }
455 
456 void hci_init(hci_transport_t *transport, void *config, bt_control_t *control){
457 
458     // reference to use transport layer implementation
459     hci_stack.hci_transport = transport;
460 
461     // references to used control implementation
462     hci_stack.control = control;
463 
464     // reference to used config
465     hci_stack.config = config;
466 
467     // no connections yet
468     hci_stack.connections = NULL;
469 
470     // empty cmd buffer
471     hci_stack.hci_cmd_buffer = malloc(3+255);
472 
473     // higher level handler
474     hci_stack.packet_handler = dummy_handler;
475 
476     // register packet handlers with transport
477     transport->register_packet_handler(&packet_handler);
478 }
479 
480 int hci_power_control(HCI_POWER_MODE power_mode){
481     if (power_mode == HCI_POWER_ON && hci_stack.state == HCI_STATE_OFF) {
482 
483         // power on
484         int err = 0;
485         if (hci_stack.control && hci_stack.control->on){
486             err = (*hci_stack.control->on)(hci_stack.config);
487         }
488         if (err){
489             log_err( "POWER_ON failed\n");
490             hci_emit_hci_open_failed();
491             return err;
492         }
493 
494         // open low-level device
495         err = hci_stack.hci_transport->open(hci_stack.config);
496         if (err){
497             log_err( "HCI_INIT failed, turning Bluetooth off again\n");
498             if (hci_stack.control && hci_stack.control->off){
499                 (*hci_stack.control->off)(hci_stack.config);
500             }
501             hci_emit_hci_open_failed();
502             return err;
503         }
504 
505         // set up state machine
506         hci_stack.num_cmd_packets = 1; // assume that one cmd can be sent
507         hci_stack.state = HCI_STATE_INITIALIZING;
508         hci_stack.substate = 0;
509 
510     } else if (power_mode == HCI_POWER_OFF && hci_stack.state == HCI_STATE_WORKING){
511 
512         // close low-level device
513         hci_stack.hci_transport->close(hci_stack.config);
514 
515         // power off
516         if (hci_stack.control && hci_stack.control->off){
517             (*hci_stack.control->off)(hci_stack.config);
518         }
519 
520         // we're off now
521         hci_stack.state = HCI_STATE_OFF;
522     }
523 
524     // create internal event
525 	hci_emit_state();
526 
527 	// trigger next/first action
528 	hci_run();
529 
530     return 0;
531 }
532 
533 void hci_run(){
534 
535     switch (hci_stack.state){
536         case HCI_STATE_INITIALIZING:
537             if (hci_stack.substate % 2) {
538                 // odd: waiting for command completion
539                 return;
540             }
541             if (hci_stack.num_cmd_packets == 0) {
542                 // cannot send command yet
543                 return;
544             }
545             switch (hci_stack.substate >> 1){
546                 case 0:
547                     hci_send_cmd(&hci_reset);
548                     break;
549                 case 1:
550                     // custom initialization
551                     if (hci_stack.control && hci_stack.control->next_command){
552                         uint8_t * cmd = (*hci_stack.control->next_command)(hci_stack.config);
553                         if (cmd) {
554                             int size = 3 + cmd[2];
555                             hci_stack.hci_transport->send_packet(HCI_COMMAND_DATA_PACKET, cmd, size);
556                             hci_stack.substate = 0; // more init commands
557                             break;
558                         }
559                     }
560                     // otherwise continue
561 					hci_send_cmd(&hci_read_bd_addr);
562 					break;
563 				case 2:
564 					hci_send_cmd(&hci_read_buffer_size);
565 					break;
566                 case 3:
567                     // ca. 15 sec
568                     hci_send_cmd(&hci_write_page_timeout, 0x6000);
569                     break;
570 				case 4:
571 					hci_send_cmd(&hci_write_scan_enable, 3); // 3 inq scan + page scan
572 					break;
573                 case 5:
574 #ifndef EMBEDDED
575                 {
576                     char hostname[30];
577                     gethostname(hostname, 30);
578                     hostname[29] = '\0';
579                     hci_send_cmd(&hci_write_local_name, hostname);
580                     break;
581                 }
582                 case 6:
583 #endif
584                     // done.
585                     hci_stack.state = HCI_STATE_WORKING;
586                     hci_emit_state();
587                     break;
588                 default:
589                     break;
590             }
591             hci_stack.substate++;
592             break;
593         default:
594             break;
595     }
596 }
597 
598 int hci_send_cmd_packet(uint8_t *packet, int size){
599     bd_addr_t addr;
600     hci_connection_t * conn;
601     // house-keeping
602 
603     // create_connection?
604     if (IS_COMMAND(packet, hci_create_connection)){
605         bt_flip_addr(addr, &packet[3]);
606         log_dbg("Create_connection to "); print_bd_addr(addr); log_dbg("\n");
607         conn = connection_for_address(addr);
608         if (conn) {
609             // if connection exists
610             if (conn->state == OPEN) {
611                 // if OPEN, emit connection complete command
612                 hci_emit_connection_complete(conn);
613             }
614             //    otherwise, just ignore
615             return 0; // don't sent packet to controller
616 
617         } else{
618             conn = create_connection_for_addr(addr);
619             if (conn){
620                 //    create connection struct and register, state = SENT_CREATE_CONNECTION
621                 conn->state = SENT_CREATE_CONNECTION;
622             }
623         }
624     }
625 
626     if (IS_COMMAND(packet, hci_link_key_request_reply)){
627         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_LINK_KEY_REPLY);
628     }
629     if (IS_COMMAND(packet, hci_link_key_request_negative_reply)){
630         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_LINK_KEY_NEGATIVE_REQUEST);
631     }
632     if (IS_COMMAND(packet, hci_pin_code_request_reply)){
633         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_PIN_CODE_REPLY);
634     }
635     if (IS_COMMAND(packet, hci_pin_code_request_negative_reply)){
636         hci_add_connection_flags_for_flipped_bd_addr(&packet[3], SENT_PIN_CODE_NEGATIVE_REPLY);
637     }
638 
639     // accept connection
640 
641     // reject connection
642 
643     // close_connection?
644       // set state = SENT_DISCONNECT
645 
646     hci_stack.num_cmd_packets--;
647     return hci_stack.hci_transport->send_packet(HCI_COMMAND_DATA_PACKET, packet, size);
648 }
649 
650 /**
651  * pre: numcmds >= 0 - it's allowed to send a command to the controller
652  */
653 int hci_send_cmd(const hci_cmd_t *cmd, ...){
654     va_list argptr;
655     va_start(argptr, cmd);
656     uint8_t * hci_cmd_buffer = hci_stack.hci_cmd_buffer;
657     uint16_t size = hci_create_cmd_internal(hci_stack.hci_cmd_buffer, cmd, argptr);
658     va_end(argptr);
659     return hci_send_cmd_packet(hci_cmd_buffer, size);
660 }
661 
662 // Create various non-HCI events.
663 // TODO: generalize, use table similar to hci_create_command
664 
665 void hci_emit_state(){
666     uint8_t len = 3;
667     uint8_t event[len];
668     event[0] = BTSTACK_EVENT_STATE;
669     event[1] = len - 3;
670     event[2] = hci_stack.state;
671     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
672     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
673 }
674 
675 void hci_emit_connection_complete(hci_connection_t *conn){
676     uint8_t len = 13;
677     uint8_t event[len];
678     event[0] = HCI_EVENT_CONNECTION_COMPLETE;
679     event[1] = len - 3;
680     event[2] = 0; // status = OK
681     bt_store_16(event, 3, conn->con_handle);
682     bt_flip_addr(&event[5], conn->address);
683     event[11] = 1; // ACL connection
684     event[12] = 0; // encryption disabled
685     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
686     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
687 }
688 
689 void hci_emit_l2cap_check_timeout(hci_connection_t *conn){
690     uint8_t len = 4;
691     uint8_t event[len];
692     event[0] = L2CAP_EVENT_TIMEOUT_CHECK;
693     event[1] = len - 2;
694     bt_store_16(event, 2, conn->con_handle);
695     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
696     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
697 }
698 
699 void hci_emit_nr_connections_changed(){
700     uint8_t len = 3;
701     uint8_t event[len];
702     event[0] = BTSTACK_EVENT_NR_CONNECTIONS_CHANGED;
703     event[1] = len - 2;
704     event[2] = nr_hci_connections();
705     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
706     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
707 }
708 
709 void hci_emit_hci_open_failed(){
710     uint8_t len = 2;
711     uint8_t event[len];
712     event[0] = BTSTACK_EVENT_POWERON_FAILED;
713     event[1] = len - 2;
714     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
715     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
716 }
717 
718 
719 void hci_emit_btstack_version() {
720     uint8_t len = 6;
721     uint8_t event[len];
722     event[0] = BTSTACK_EVENT_VERSION;
723     event[1] = len - 2;
724     event[len++] = BTSTACK_MAJOR;
725     event[len++] = BTSTACK_MINOR;
726     bt_store_16(event, len, BTSTACK_REVISION);
727     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
728     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
729 }
730 
731 void hci_emit_system_bluetooth_enabled(uint8_t enabled){
732     uint8_t len = 3;
733     uint8_t event[len];
734     event[0] = BTSTACK_EVENT_SYSTEM_BLUETOOTH_ENABLED;
735     event[1] = len - 2;
736     event[2] = enabled;
737     hci_dump_packet( HCI_EVENT_PACKET, 0, event, len);
738     hci_stack.packet_handler(HCI_EVENT_PACKET, event, len);
739 }
740