xref: /btstack/src/hci.h (revision 88949f844376f979826afad7a30727a235ee4f0c)
1 /*
2  * Copyright (C) 2014 BlueKitchen GmbH
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the copyright holders nor the names of
14  *    contributors may be used to endorse or promote products derived
15  *    from this software without specific prior written permission.
16  * 4. Any redistribution, use, or modification is done solely for
17  *    personal benefit and not for any commercial purpose or for
18  *    monetary gain.
19  *
20  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  * Please inquire about commercial licensing options at
34  * [email protected]
35  *
36  */
37 
38 /*
39  *  hci.h
40  *
41  *  Created by Matthias Ringwald on 4/29/09.
42  *
43  */
44 
45 #ifndef __HCI_H
46 #define __HCI_H
47 
48 #include "btstack_config.h"
49 
50 #include "btstack_chipset.h"
51 #include "btstack_control.h"
52 #include "btstack_linked_list.h"
53 #include "btstack_util.h"
54 #include "classic/btstack_link_key_db.h"
55 #include "hci_cmd.h"
56 #include "gap.h"
57 #include "hci_transport.h"
58 
59 #ifdef ENABLE_BLE
60 #include "ble/att_db.h"
61 #endif
62 
63 #include <stdint.h>
64 #include <stdlib.h>
65 #include <stdarg.h>
66 
67 #if defined __cplusplus
68 extern "C" {
69 #endif
70 
71 // packet buffer sizes
72 
73 // Max HCI Command LE payload size:
74 // 64 from LE Generate DHKey command
75 // 32 from LE Encrypt command
76 #if defined(ENABLE_LE_SECURE_CONNECTIONS) && !defined(ENABLE_MICRO_ECC_FOR_LE_SECURE_CONNECTIONS)
77 #define HCI_CMD_PAYLOAD_SIZE_LE 64
78 #else
79 #define HCI_CMD_PAYLOAD_SIZE_LE 32
80 #endif
81 
82 // HCI_ACL_PAYLOAD_SIZE is configurable and defined in config.h
83 // addition byte in even to terminate remote name request with '\0'
84 #define HCI_EVENT_BUFFER_SIZE      (HCI_EVENT_HEADER_SIZE + HCI_EVENT_PAYLOAD_SIZE + 1)
85 
86 #ifdef ENABLE_CLASSIC
87 #define HCI_CMD_BUFFER_SIZE        (HCI_CMD_HEADER_SIZE   + HCI_CMD_PAYLOAD_SIZE)
88 #else
89 #define HCI_CMD_BUFFER_SIZE        (HCI_CMD_HEADER_SIZE   + HCI_CMD_PAYLOAD_SIZE_LE)
90 #endif
91 
92 #define HCI_ACL_BUFFER_SIZE        (HCI_ACL_HEADER_SIZE   + HCI_ACL_PAYLOAD_SIZE)
93 
94 // size of hci incoming buffer, big enough for event or acl packet without H4 packet type
95 #ifdef HCI_INCOMING_PACKET_BUFFER_SIZE
96     #if HCI_INCOMING_PACKET_BUFFER_SIZE < HCI_ACL_BUFFER_SIZE
97         #error HCI_INCOMING_PACKET_BUFFER_SIZE must be equal or larger than HCI_ACL_BUFFER_SIZE
98     #endif
99     #if HCI_INCOMING_PACKET_BUFFER_SIZE < HCI_EVENT_BUFFER_SIZE
100         #error HCI_INCOMING_PACKET_BUFFER_SIZE must be equal or larger than HCI_EVENT_BUFFER_SIZE
101     #endif
102 #else
103     #if HCI_ACL_BUFFER_SIZE > HCI_EVENT_BUFFER_SIZE
104         #define HCI_INCOMING_PACKET_BUFFER_SIZE HCI_ACL_BUFFER_SIZE
105     #else
106         #define HCI_INCOMING_PACKET_BUFFER_SIZE HCI_EVENT_BUFFER_SIZE
107     #endif
108 #endif
109 
110 // size of hci outgoing buffer, big enough for command or acl packet without H4 packet type
111 #ifdef HCI_OUTGOING_PACKET_BUFFER_SIZE
112     #if HCI_OUTGOING_PACKET_BUFFER_SIZE < HCI_ACL_BUFFER_SIZE
113         #error HCI_OUTGOING_PACKET_BUFFER_SIZE must be equal or larger than HCI_ACL_BUFFER_SIZE
114     #endif
115     #if HCI_OUTGOING_PACKET_BUFFER_SIZE < HCI_CMD_BUFFER_SIZE
116         #error HCI_OUTGOING_PACKET_BUFFER_SIZE must be equal or larger than HCI_CMD_BUFFER_SIZE
117     #endif
118 #else
119     #if HCI_ACL_BUFFER_SIZE > HCI_CMD_BUFFER_SIZE
120         #define HCI_OUTGOING_PACKET_BUFFER_SIZE HCI_ACL_BUFFER_SIZE
121     #else
122         #define HCI_OUTGOING_PACKET_BUFFER_SIZE HCI_CMD_BUFFER_SIZE
123     #endif
124 #endif
125 
126 // additional pre-buffer space for packets to Bluetooth module, for now, used for HCI Transport H4 DMA
127 #ifndef HCI_OUTGOING_PRE_BUFFER_SIZE
128 #ifdef HAVE_HOST_CONTROLLER_API
129 #define HCI_OUTGOING_PRE_BUFFER_SIZE 0
130 #else
131 #define HCI_OUTGOING_PRE_BUFFER_SIZE 1
132 #endif
133 #endif
134 
135 // BNEP may uncompress the IP Header by 16 bytes
136 #ifndef HCI_INCOMING_PRE_BUFFER_SIZE
137 #ifdef ENABLE_CLASSIC
138 #define HCI_INCOMING_PRE_BUFFER_SIZE (16 - HCI_ACL_HEADER_SIZE - 4)
139 #else
140 #define HCI_INCOMING_PRE_BUFFER_SIZE 0
141 #endif
142 #endif
143 
144 //
145 #define IS_COMMAND(packet, command) (little_endian_read_16(packet,0) == command.opcode)
146 
147 // check if command complete event for given command
148 #define HCI_EVENT_IS_COMMAND_COMPLETE(event,cmd) ( event[0] == HCI_EVENT_COMMAND_COMPLETE && little_endian_read_16(event,3) == cmd.opcode)
149 #define HCI_EVENT_IS_COMMAND_STATUS(event,cmd) ( event[0] == HCI_EVENT_COMMAND_STATUS && little_endian_read_16(event,4) == cmd.opcode)
150 
151 // Code+Len=2, Pkts+Opcode=3; total=5
152 #define OFFSET_OF_DATA_IN_COMMAND_COMPLETE 5
153 
154 // ACL Packet
155 #define READ_ACL_CONNECTION_HANDLE( buffer ) ( little_endian_read_16(buffer,0) & 0x0fff)
156 #define READ_SCO_CONNECTION_HANDLE( buffer ) ( little_endian_read_16(buffer,0) & 0x0fff)
157 #define READ_ACL_FLAGS( buffer )      ( buffer[1] >> 4 )
158 #define READ_ACL_LENGTH( buffer )     (little_endian_read_16(buffer, 2))
159 
160 // Sneak peak into L2CAP Packet
161 #define READ_L2CAP_LENGTH(buffer)     ( little_endian_read_16(buffer, 4))
162 #define READ_L2CAP_CHANNEL_ID(buffer) ( little_endian_read_16(buffer, 6))
163 
164 /**
165  * LE connection parameter update state
166  */
167 
168 typedef enum {
169     CON_PARAMETER_UPDATE_NONE,
170     // L2CAP
171     CON_PARAMETER_UPDATE_SEND_REQUEST,
172     CON_PARAMETER_UPDATE_SEND_RESPONSE,
173     CON_PARAMETER_UPDATE_CHANGE_HCI_CON_PARAMETERS,
174     CON_PARAMETER_UPDATE_DENY,
175     // HCI - in respnose to HCI_SUBEVENT_LE_REMOTE_CONNECTION_PARAMETER_REQUEST
176     CON_PARAMETER_UPDATE_REPLY,
177     CON_PARAMETER_UPDATE_NEGATIVE_REPLY,
178 } le_con_parameter_update_state_t;
179 
180 // Authentication flags
181 typedef enum {
182     AUTH_FLAGS_NONE                = 0x0000,
183     RECV_LINK_KEY_REQUEST          = 0x0001,
184     HANDLE_LINK_KEY_REQUEST        = 0x0002,
185     SENT_LINK_KEY_REPLY            = 0x0004,
186     SENT_LINK_KEY_NEGATIVE_REQUEST = 0x0008,
187     RECV_LINK_KEY_NOTIFICATION     = 0x0010,
188     DENY_PIN_CODE_REQUEST          = 0x0040,
189     RECV_IO_CAPABILITIES_REQUEST   = 0x0080,
190     SEND_IO_CAPABILITIES_REPLY     = 0x0100,
191     SEND_USER_CONFIRM_REPLY        = 0x0200,
192     SEND_USER_PASSKEY_REPLY        = 0x0400,
193 
194     // pairing status
195     LEGACY_PAIRING_ACTIVE          = 0x2000,
196     SSP_PAIRING_ACTIVE             = 0x4000,
197 
198     // connection status
199     CONNECTION_ENCRYPTED           = 0x8000,
200 } hci_authentication_flags_t;
201 
202 /**
203  * Connection State
204  */
205 typedef enum {
206     SEND_CREATE_CONNECTION = 0,
207     SENT_CREATE_CONNECTION,
208     SEND_CANCEL_CONNECTION,
209     SENT_CANCEL_CONNECTION,
210     RECEIVED_CONNECTION_REQUEST,
211     ACCEPTED_CONNECTION_REQUEST,
212     REJECTED_CONNECTION_REQUEST,
213     OPEN,
214     SEND_DISCONNECT,
215     SENT_DISCONNECT,
216     RECEIVED_DISCONNECTION_COMPLETE
217 } CONNECTION_STATE;
218 
219 // bonding flags
220 enum {
221     BONDING_REQUEST_REMOTE_FEATURES   = 0x01,
222     BONDING_RECEIVED_REMOTE_FEATURES  = 0x02,
223     BONDING_REMOTE_SUPPORTS_SSP       = 0x04,
224     BONDING_DISCONNECT_SECURITY_BLOCK = 0x08,
225     BONDING_DISCONNECT_DEDICATED_DONE = 0x10,
226     BONDING_SEND_AUTHENTICATE_REQUEST = 0x20,
227     BONDING_SEND_ENCRYPTION_REQUEST   = 0x40,
228     BONDING_DEDICATED                 = 0x80,
229     BONDING_EMIT_COMPLETE_ON_DISCONNECT = 0x100
230 };
231 
232 typedef enum {
233     BLUETOOTH_OFF = 1,
234     BLUETOOTH_ON,
235     BLUETOOTH_ACTIVE
236 } BLUETOOTH_STATE;
237 
238 typedef enum {
239     LE_CONNECTING_IDLE,
240     LE_CONNECTING_DIRECT,
241     LE_CONNECTING_WHITELIST,
242 } le_connecting_state_t;
243 
244 #ifdef ENABLE_BLE
245 
246 //
247 // SM internal types and globals
248 //
249 
250 typedef enum {
251 
252     // general states
253     SM_GENERAL_IDLE,
254     SM_GENERAL_SEND_PAIRING_FAILED,
255     SM_GENERAL_TIMEOUT, // no other security messages are exchanged
256 
257     // Phase 1: Pairing Feature Exchange
258     SM_PH1_W4_USER_RESPONSE,
259 
260     // Phase 2: Authenticating and Encrypting
261 
262     // get random number for use as TK Passkey if we show it
263     SM_PH2_GET_RANDOM_TK,
264     SM_PH2_W4_RANDOM_TK,
265 
266     // get local random number for confirm c1
267     SM_PH2_C1_GET_RANDOM_A,
268     SM_PH2_C1_W4_RANDOM_A,
269     SM_PH2_C1_GET_RANDOM_B,
270     SM_PH2_C1_W4_RANDOM_B,
271 
272     // calculate confirm value for local side
273     SM_PH2_C1_GET_ENC_A,
274     SM_PH2_C1_W4_ENC_A,
275 
276     // calculate confirm value for remote side
277     SM_PH2_C1_GET_ENC_C,
278     SM_PH2_C1_W4_ENC_C,
279 
280     SM_PH2_C1_SEND_PAIRING_CONFIRM,
281     SM_PH2_SEND_PAIRING_RANDOM,
282 
283     // calc STK
284     SM_PH2_CALC_STK,
285     SM_PH2_W4_STK,
286 
287     SM_PH2_W4_CONNECTION_ENCRYPTED,
288 
289     // Phase 3: Transport Specific Key Distribution
290     // calculate DHK, Y, EDIV, and LTK
291     SM_PH3_Y_GET_ENC,
292     SM_PH3_Y_W4_ENC,
293     SM_PH3_LTK_GET_ENC,
294 
295     // exchange keys
296     SM_PH3_DISTRIBUTE_KEYS,
297     SM_PH3_RECEIVE_KEYS,
298 
299     // RESPONDER ROLE
300     SM_RESPONDER_IDLE,
301     SM_RESPONDER_SEND_SECURITY_REQUEST,
302     SM_RESPONDER_PH0_RECEIVED_LTK_REQUEST,
303     SM_RESPONDER_PH0_RECEIVED_LTK_W4_IRK,
304     SM_RESPONDER_PH0_SEND_LTK_REQUESTED_NEGATIVE_REPLY,
305     SM_RESPONDER_PH1_W4_PAIRING_REQUEST,
306     SM_RESPONDER_PH1_PAIRING_REQUEST_RECEIVED,
307     SM_RESPONDER_PH1_SEND_PAIRING_RESPONSE,
308     SM_RESPONDER_PH1_W4_PAIRING_CONFIRM,
309     SM_RESPONDER_PH2_W4_PAIRING_RANDOM,
310     SM_RESPONDER_PH2_W4_LTK_REQUEST,
311     SM_RESPONDER_PH2_SEND_LTK_REPLY,
312 
313     // Phase 4: re-establish previously distributed LTK
314     SM_RESPONDER_PH4_Y_GET_ENC,
315     SM_RESPONDER_PH4_Y_W4_ENC,
316     SM_RESPONDER_PH4_SEND_LTK_REPLY,
317 
318     // INITITIATOR ROLE
319     SM_INITIATOR_CONNECTED,
320     SM_INITIATOR_PH0_HAS_LTK,
321     SM_INITIATOR_PH0_SEND_START_ENCRYPTION,
322     SM_INITIATOR_PH0_W4_CONNECTION_ENCRYPTED,
323     SM_INITIATOR_PH1_W2_SEND_PAIRING_REQUEST,
324     SM_INITIATOR_PH1_SEND_PAIRING_REQUEST,
325     SM_INITIATOR_PH1_W4_PAIRING_RESPONSE,
326     SM_INITIATOR_PH2_W4_PAIRING_CONFIRM,
327     SM_INITIATOR_PH2_W4_PAIRING_RANDOM,
328     SM_INITIATOR_PH3_SEND_START_ENCRYPTION,
329 
330     // LE Secure Connections
331     SM_SC_RECEIVED_LTK_REQUEST,
332     SM_SC_SEND_PUBLIC_KEY_COMMAND,
333     SM_SC_W4_PUBLIC_KEY_COMMAND,
334     SM_SC_W2_GET_RANDOM_A,
335     SM_SC_W4_GET_RANDOM_A,
336     SM_SC_W2_GET_RANDOM_B,
337     SM_SC_W4_GET_RANDOM_B,
338     SM_SC_W2_CMAC_FOR_CONFIRMATION,
339     SM_SC_W4_CMAC_FOR_CONFIRMATION,
340     SM_SC_SEND_CONFIRMATION,
341     SM_SC_W2_CMAC_FOR_CHECK_CONFIRMATION,
342     SM_SC_W4_CMAC_FOR_CHECK_CONFIRMATION,
343     SM_SC_W4_CONFIRMATION,
344     SM_SC_SEND_PAIRING_RANDOM,
345     SM_SC_W4_PAIRING_RANDOM,
346     SM_SC_W2_CALCULATE_G2,
347     SM_SC_W4_CALCULATE_G2,
348     SM_SC_W4_CALCULATE_DHKEY,
349     SM_SC_W2_CALCULATE_F5_SALT,
350     SM_SC_W4_CALCULATE_F5_SALT,
351     SM_SC_W2_CALCULATE_F5_MACKEY,
352     SM_SC_W4_CALCULATE_F5_MACKEY,
353     SM_SC_W2_CALCULATE_F5_LTK,
354     SM_SC_W4_CALCULATE_F5_LTK,
355     SM_SC_W2_CALCULATE_F6_FOR_DHKEY_CHECK,
356     SM_SC_W4_CALCULATE_F6_FOR_DHKEY_CHECK,
357     SM_SC_W2_CALCULATE_F6_TO_VERIFY_DHKEY_CHECK,
358     SM_SC_W4_CALCULATE_F6_TO_VERIFY_DHKEY_CHECK,
359     SM_SC_W4_USER_RESPONSE,
360     SM_SC_SEND_DHKEY_CHECK_COMMAND,
361     SM_SC_W4_DHKEY_CHECK_COMMAND,
362     SM_SC_W4_LTK_REQUEST_SC,
363     SM_SC_W2_CALCULATE_H6_ILK,
364     SM_SC_W4_CALCULATE_H6_ILK,
365     SM_SC_W2_CALCULATE_H6_BR_EDR_LINK_KEY,
366     SM_SC_W4_CALCULATE_H6_BR_EDR_LINK_KEY,
367 } security_manager_state_t;
368 
369 typedef enum {
370     IRK_LOOKUP_IDLE,
371     IRK_LOOKUP_W4_READY,
372     IRK_LOOKUP_STARTED,
373     IRK_LOOKUP_SUCCEEDED,
374     IRK_LOOKUP_FAILED
375 } irk_lookup_state_t;
376 
377 typedef uint8_t sm_pairing_packet_t[7];
378 
379 // connection info available as long as connection exists
380 typedef struct sm_connection {
381     hci_con_handle_t         sm_handle;
382     uint8_t                  sm_role;   // 0 - IamMaster, 1 = IamSlave
383     uint8_t                  sm_security_request_received;
384     uint8_t                  sm_pairing_requested;
385     uint8_t                  sm_peer_addr_type;
386     bd_addr_t                sm_peer_address;
387     security_manager_state_t sm_engine_state;
388     irk_lookup_state_t      sm_irk_lookup_state;
389     uint8_t                  sm_connection_encrypted;
390     uint8_t                  sm_connection_authenticated;   // [0..1]
391     uint8_t                  sm_actual_encryption_key_size;
392     sm_pairing_packet_t      sm_m_preq;  // only used during c1
393     authorization_state_t    sm_connection_authorization_state;
394     uint16_t                 sm_local_ediv;
395     uint8_t                  sm_local_rand[8];
396     int                      sm_le_db_index;
397 } sm_connection_t;
398 
399 //
400 // ATT Server
401 //
402 
403 // max ATT request matches L2CAP PDU -- allow to use smaller buffer
404 #ifndef ATT_REQUEST_BUFFER_SIZE
405 #define ATT_REQUEST_BUFFER_SIZE HCI_ACL_PAYLOAD_SIZE
406 #endif
407 
408 typedef enum {
409     ATT_SERVER_IDLE,
410     ATT_SERVER_REQUEST_RECEIVED,
411     ATT_SERVER_W4_SIGNED_WRITE_VALIDATION,
412     ATT_SERVER_REQUEST_RECEIVED_AND_VALIDATED,
413     ATT_SERVER_RESPONSE_PENDING,
414 } att_server_state_t;
415 
416 typedef struct {
417     att_server_state_t      state;
418 
419     uint8_t                 peer_addr_type;
420     bd_addr_t               peer_address;
421 
422     int                     ir_le_device_db_index;
423     uint8_t                 ir_lookup_active;
424     uint8_t                 pairing_active;
425 
426     int                     value_indication_handle;
427     btstack_timer_source_t  value_indication_timer;
428 
429     att_connection_t        connection;
430 
431     btstack_linked_list_t   notification_requests;
432     btstack_linked_list_t   indication_requests;
433 
434     uint16_t                request_size;
435     uint8_t                 request_buffer[ATT_REQUEST_BUFFER_SIZE];
436 
437 } att_server_t;
438 
439 #endif
440 
441 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
442 typedef enum {
443     L2CAP_INFORMATION_STATE_IDLE = 0,
444     L2CAP_INFORMATION_STATE_W2_SEND_EXTENDED_FEATURE_REQUEST,
445     L2CAP_INFORMATION_STATE_W4_EXTENDED_FEATURE_RESPONSE,
446     L2CAP_INFORMATION_STATE_DONE
447 } l2cap_information_state_t;
448 
449 typedef struct {
450     l2cap_information_state_t information_state;
451     uint16_t                  extended_feature_mask;
452 } l2cap_state_t;
453 #endif
454 
455 //
456 typedef struct {
457     // linked list - assert: first field
458     btstack_linked_item_t    item;
459 
460     // remote side
461     bd_addr_t address;
462 
463     // module handle
464     hci_con_handle_t con_handle;
465 
466     // le public, le random, classic
467     bd_addr_type_t address_type;
468 
469     // role: 0 - master, 1 - slave
470     uint8_t role;
471 
472     // connection state
473     CONNECTION_STATE state;
474 
475     // bonding
476     uint16_t bonding_flags;
477     uint8_t  bonding_status;
478 
479     // requested security level
480     gap_security_level_t requested_security_level;
481 
482     //
483     link_key_type_t link_key_type;
484 
485     // remote supported features
486     uint8_t remote_supported_feature_eSCO;
487 
488 #ifdef ENABLE_CLASSIC
489     // connection mode, default ACL_CONNECTION_MODE_ACTIVE
490     uint8_t connection_mode;
491 
492     // enter/exit sniff mode requests
493     uint16_t sniff_min_interval;    // 0: idle, 0xffff exit sniff, else enter sniff
494     uint16_t sniff_max_interval;
495     uint16_t sniff_attempt;
496     uint16_t sniff_timeout;
497 #endif
498 
499     // errands
500     uint32_t authentication_flags;
501 
502     btstack_timer_source_t timeout;
503 
504     // timeout in system ticks (HAVE_EMBEDDED_TICK) or milliseconds (HAVE_EMBEDDED_TIME_MS)
505     uint32_t timestamp;
506 
507     // ACL packet recombination - PRE_BUFFER + ACL Header + ACL payload
508     uint8_t  acl_recombination_buffer[HCI_INCOMING_PRE_BUFFER_SIZE + 4 + HCI_ACL_BUFFER_SIZE];
509     uint16_t acl_recombination_pos;
510     uint16_t acl_recombination_length;
511 
512     // number packets sent to controller
513     uint8_t num_acl_packets_sent;
514     uint8_t num_sco_packets_sent;
515 
516 #ifdef ENABLE_HCI_CONTROLLER_TO_HOST_FLOW_CONTROL
517     uint8_t num_packets_completed;
518 #endif
519 
520     // LE Connection parameter update
521     le_con_parameter_update_state_t le_con_parameter_update_state;
522     uint8_t  le_con_param_update_identifier;
523     uint16_t le_conn_interval_min;
524     uint16_t le_conn_interval_max;
525     uint16_t le_conn_latency;
526     uint16_t le_supervision_timeout;
527 
528 #ifdef ENABLE_BLE
529     uint16_t le_connection_interval;
530 
531     // LE PHY Update via set phy command
532     uint8_t le_phy_update_all_phys;      // 0xff for idle
533     uint8_t le_phy_update_tx_phys;
534     uint8_t le_phy_update_rx_phys;
535     int8_t  le_phy_update_phy_options;
536 
537     // LE Security Manager
538     sm_connection_t sm_connection;
539 
540     // ATT Server
541     att_server_t    att_server;
542 #endif
543 
544 #ifdef ENABLE_L2CAP_ENHANCED_RETRANSMISSION_MODE
545     l2cap_state_t l2cap_state;
546 #endif
547 
548 } hci_connection_t;
549 
550 
551 /**
552  * HCI Inititizlization State Machine
553  */
554 typedef enum hci_init_state{
555     HCI_INIT_SEND_RESET = 0,
556     HCI_INIT_W4_SEND_RESET,
557     HCI_INIT_SEND_READ_LOCAL_VERSION_INFORMATION,
558     HCI_INIT_W4_SEND_READ_LOCAL_VERSION_INFORMATION,
559     HCI_INIT_SEND_READ_LOCAL_NAME,
560     HCI_INIT_W4_SEND_READ_LOCAL_NAME,
561 
562     HCI_INIT_SEND_BAUD_CHANGE,
563     HCI_INIT_W4_SEND_BAUD_CHANGE,
564     HCI_INIT_CUSTOM_INIT,
565     HCI_INIT_W4_CUSTOM_INIT,
566     HCI_INIT_SEND_RESET_CSR_WARM_BOOT,
567     HCI_INIT_W4_CUSTOM_INIT_CSR_WARM_BOOT,
568     HCI_INIT_W4_CUSTOM_INIT_CSR_WARM_BOOT_LINK_RESET,
569     HCI_INIT_W4_CUSTOM_INIT_BCM_DELAY,
570 
571     HCI_INIT_READ_LOCAL_SUPPORTED_COMMANDS,
572     HCI_INIT_W4_READ_LOCAL_SUPPORTED_COMMANDS,
573 
574     HCI_INIT_SEND_BAUD_CHANGE_BCM,
575     HCI_INIT_W4_SEND_BAUD_CHANGE_BCM,
576 
577     HCI_INIT_SET_BD_ADDR,
578     HCI_INIT_W4_SET_BD_ADDR,
579 
580     HCI_INIT_SEND_RESET_ST_WARM_BOOT,
581     HCI_INIT_W4_SEND_RESET_ST_WARM_BOOT,
582 
583     HCI_INIT_READ_BD_ADDR,
584     HCI_INIT_W4_READ_BD_ADDR,
585 
586     HCI_INIT_READ_BUFFER_SIZE,
587     HCI_INIT_W4_READ_BUFFER_SIZE,
588     HCI_INIT_READ_LOCAL_SUPPORTED_FEATURES,
589     HCI_INIT_W4_READ_LOCAL_SUPPORTED_FEATURES,
590 
591 #ifdef ENABLE_HCI_CONTROLLER_TO_HOST_FLOW_CONTROL
592     HCI_INIT_HOST_BUFFER_SIZE,
593     HCI_INIT_W4_HOST_BUFFER_SIZE,
594     HCI_INIT_SET_CONTROLLER_TO_HOST_FLOW_CONTROL,
595     HCI_INIT_W4_SET_CONTROLLER_TO_HOST_FLOW_CONTROL,
596 #endif
597 
598     HCI_INIT_SET_EVENT_MASK,
599     HCI_INIT_W4_SET_EVENT_MASK,
600 
601     HCI_INIT_WRITE_SIMPLE_PAIRING_MODE,
602     HCI_INIT_W4_WRITE_SIMPLE_PAIRING_MODE,
603     HCI_INIT_WRITE_PAGE_TIMEOUT,
604     HCI_INIT_W4_WRITE_PAGE_TIMEOUT,
605     HCI_INIT_WRITE_DEFAULT_LINK_POLICY_SETTING,
606     HCI_INIT_W4_WRITE_DEFAULT_LINK_POLICY_SETTING,
607     HCI_INIT_WRITE_CLASS_OF_DEVICE,
608     HCI_INIT_W4_WRITE_CLASS_OF_DEVICE,
609     HCI_INIT_WRITE_LOCAL_NAME,
610     HCI_INIT_W4_WRITE_LOCAL_NAME,
611     HCI_INIT_WRITE_EIR_DATA,
612     HCI_INIT_W4_WRITE_EIR_DATA,
613     HCI_INIT_WRITE_INQUIRY_MODE,
614     HCI_INIT_W4_WRITE_INQUIRY_MODE,
615     HCI_INIT_WRITE_SCAN_ENABLE,
616     HCI_INIT_W4_WRITE_SCAN_ENABLE,
617 
618     // SCO over HCI
619     HCI_INIT_WRITE_SYNCHRONOUS_FLOW_CONTROL_ENABLE,
620     HCI_INIT_W4_WRITE_SYNCHRONOUS_FLOW_CONTROL_ENABLE,
621     HCI_INIT_WRITE_DEFAULT_ERRONEOUS_DATA_REPORTING,
622     HCI_INIT_W4_WRITE_DEFAULT_ERRONEOUS_DATA_REPORTING,
623 
624     // SCO over HCI Broadcom
625     HCI_INIT_BCM_WRITE_SCO_PCM_INT,
626     HCI_INIT_W4_BCM_WRITE_SCO_PCM_INT,
627 
628 #ifdef ENABLE_BLE
629     HCI_INIT_LE_READ_BUFFER_SIZE,
630     HCI_INIT_W4_LE_READ_BUFFER_SIZE,
631     HCI_INIT_WRITE_LE_HOST_SUPPORTED,
632     HCI_INIT_W4_WRITE_LE_HOST_SUPPORTED,
633     HCI_INIT_LE_SET_EVENT_MASK,
634     HCI_INIT_W4_LE_SET_EVENT_MASK,
635 #endif
636 
637 #ifdef ENABLE_LE_DATA_LENGTH_EXTENSION
638     HCI_INIT_LE_READ_MAX_DATA_LENGTH,
639     HCI_INIT_W4_LE_READ_MAX_DATA_LENGTH,
640     HCI_INIT_LE_WRITE_SUGGESTED_DATA_LENGTH,
641     HCI_INIT_W4_LE_WRITE_SUGGESTED_DATA_LENGTH,
642 #endif
643 
644 #ifdef ENABLE_LE_CENTRAL
645     HCI_INIT_READ_WHITE_LIST_SIZE,
646     HCI_INIT_W4_READ_WHITE_LIST_SIZE,
647 
648     HCI_INIT_LE_SET_SCAN_PARAMETERS,
649     HCI_INIT_W4_LE_SET_SCAN_PARAMETERS,
650 #endif
651 
652     HCI_INIT_DONE,
653 
654     HCI_FALLING_ASLEEP_DISCONNECT,
655     HCI_FALLING_ASLEEP_W4_WRITE_SCAN_ENABLE,
656     HCI_FALLING_ASLEEP_COMPLETE,
657 
658     HCI_INIT_AFTER_SLEEP
659 
660 } hci_substate_t;
661 
662 enum {
663     LE_ADVERTISEMENT_TASKS_DISABLE       = 1 << 0,
664     LE_ADVERTISEMENT_TASKS_SET_ADV_DATA  = 1 << 1,
665     LE_ADVERTISEMENT_TASKS_SET_SCAN_DATA = 1 << 2,
666     LE_ADVERTISEMENT_TASKS_SET_PARAMS    = 1 << 3,
667     LE_ADVERTISEMENT_TASKS_ENABLE        = 1 << 4,
668 };
669 
670 enum {
671     LE_WHITELIST_ON_CONTROLLER          = 1 << 0,
672     LE_WHITELIST_ADD_TO_CONTROLLER      = 1 << 1,
673     LE_WHITELIST_REMOVE_FROM_CONTROLLER = 1 << 2,
674 };
675 
676 typedef struct {
677     btstack_linked_item_t  item;
678     bd_addr_t      address;
679     bd_addr_type_t address_type;
680     uint8_t        state;
681 } whitelist_entry_t;
682 
683 /**
684  * main data structure
685  */
686 typedef struct {
687     // transport component with configuration
688     const hci_transport_t * hci_transport;
689     const void            * config;
690 
691     // chipset driver
692     const btstack_chipset_t * chipset;
693 
694     // hardware power controller
695     const btstack_control_t * control;
696 
697     /* link key db */
698     const btstack_link_key_db_t * link_key_db;
699 
700     // list of existing baseband connections
701     btstack_linked_list_t     connections;
702 
703     /* callback to L2CAP layer */
704     btstack_packet_handler_t acl_packet_handler;
705 
706     /* callback for SCO data */
707     btstack_packet_handler_t sco_packet_handler;
708 
709     /* callbacks for events */
710     btstack_linked_list_t event_handlers;
711 
712     // hardware error callback
713     void (*hardware_error_callback)(uint8_t error);
714 
715     // basic configuration
716     const char *       local_name;
717     const uint8_t *    eir_data;
718     uint32_t           class_of_device;
719     bd_addr_t          local_bd_addr;
720     uint8_t            default_link_policy_settings;
721     uint8_t            ssp_enable;
722     uint8_t            ssp_io_capability;
723     uint8_t            ssp_authentication_requirement;
724     uint8_t            ssp_auto_accept;
725     inquiry_mode_t     inquiry_mode;
726 
727     // single buffer for HCI packet assembly + additional prebuffer for H4 drivers
728     uint8_t   * hci_packet_buffer;
729     uint8_t   hci_packet_buffer_data[HCI_OUTGOING_PRE_BUFFER_SIZE + HCI_OUTGOING_PACKET_BUFFER_SIZE];
730     uint8_t   hci_packet_buffer_reserved;
731     uint16_t  acl_fragmentation_pos;
732     uint16_t  acl_fragmentation_total_size;
733 
734     /* host to controller flow control */
735     uint8_t  num_cmd_packets;
736     uint8_t  acl_packets_total_num;
737     uint16_t acl_data_packet_length;
738     uint8_t  sco_packets_total_num;
739     uint8_t  sco_data_packet_length;
740     uint8_t  synchronous_flow_control_enabled;
741     uint8_t  le_acl_packets_total_num;
742     uint16_t le_data_packets_length;
743     uint8_t  sco_waiting_for_can_send_now;
744 
745     /* local supported features */
746     uint8_t local_supported_features[8];
747 
748     /* local supported commands summary - complete info is 64 bytes */
749     /* 0 - Read Buffer Size                        (Octet 14/bit 7) */
750     /* 1 - Write Le Host Supported                 (Octet 24/bit 6) */
751     /* 2 - Write Synchronous Flow Control Enable   (Octet 10/bit 4) */
752     /* 3 - Write Default Erroneous Data Reporting  (Octet 18/bit 3) */
753     /* 4 - LE Write Suggested Default Data Length  (Octet 34/bit 0) */
754     /* 5 - LE Read Maximum Data Length             (Octet 35/bit 3) */
755     /* 6 - LE Set Default PHY                      (Octet 35/bit 5) */
756     uint8_t local_supported_commands[1];
757 
758     /* bluetooth device information from hci read local version information */
759     // uint16_t hci_version;
760     // uint16_t hci_revision;
761     // uint16_t lmp_version;
762     uint16_t manufacturer;
763     // uint16_t lmp_subversion;
764 
765     // usable packet types given acl_data_packet_length and HCI_ACL_BUFFER_SIZE
766     uint16_t packet_types;
767 
768 
769     /* hci state machine */
770     HCI_STATE      state;
771     hci_substate_t substate;
772     btstack_timer_source_t timeout;
773 
774     uint16_t  last_cmd_opcode;
775 
776     uint8_t   cmds_ready;
777 
778     /* buffer for scan enable cmd - 0xff no change */
779     uint8_t   new_scan_enable_value;
780 
781     uint8_t   discoverable;
782     uint8_t   connectable;
783     uint8_t   bondable;
784 
785     uint8_t   inquiry_state;    // see hci.c for state defines
786 
787     bd_addr_t remote_name_addr;
788     uint16_t  remote_name_clock_offset;
789     uint8_t   remote_name_page_scan_repetition_mode;
790     uint8_t   remote_name_state;    // see hci.c for state defines
791 
792     bd_addr_t gap_pairing_addr;
793     uint8_t   gap_pairing_state;    // see hci.c for state defines
794     union {
795         const char * gap_pairing_pin;
796         uint32_t     gap_pairing_passkey;
797     } gap_pairing_input;
798 
799     uint16_t  sco_voice_setting;
800     uint16_t  sco_voice_setting_active;
801 
802     uint8_t   loopback_mode;
803 
804     // buffer for single connection decline
805     uint8_t   decline_reason;
806     bd_addr_t decline_addr;
807 
808 #ifdef ENABLE_HCI_CONTROLLER_TO_HOST_FLOW_CONTROL
809     uint8_t   host_completed_packets;
810 #endif
811 
812 #ifdef ENABLE_BLE
813     uint8_t   le_own_addr_type;
814     bd_addr_t le_random_address;
815     uint8_t   le_random_address_set;
816 #endif
817 
818 #ifdef ENABLE_LE_CENTRAL
819     uint8_t   le_scanning_enabled;
820     uint8_t   le_scanning_active;
821 
822     le_connecting_state_t le_connecting_state;
823 
824     // buffer for le scan type command - 0xff not set
825     uint8_t  le_scan_type;
826     uint16_t le_scan_interval;
827     uint16_t le_scan_window;
828 
829     // LE Whitelist Management
830     uint8_t               le_whitelist_capacity;
831     btstack_linked_list_t le_whitelist;
832 
833     // Connection parameters
834     uint16_t le_connection_interval_min;
835     uint16_t le_connection_interval_max;
836     uint16_t le_connection_latency;
837     uint16_t le_supervision_timeout;
838     uint16_t le_minimum_ce_length;
839     uint16_t le_maximum_ce_length;
840     uint16_t le_connection_scan_interval;
841     uint16_t le_connection_scan_window;
842 #endif
843 
844     le_connection_parameter_range_t le_connection_parameter_range;
845 
846 #ifdef ENABLE_LE_PERIPHERAL
847     uint8_t  * le_advertisements_data;
848     uint8_t    le_advertisements_data_len;
849 
850     uint8_t  * le_scan_response_data;
851     uint8_t    le_scan_response_data_len;
852 
853     uint8_t  le_advertisements_active;
854     uint8_t  le_advertisements_enabled;
855     uint8_t  le_advertisements_todo;
856 
857     uint16_t le_advertisements_interval_min;
858     uint16_t le_advertisements_interval_max;
859     uint8_t  le_advertisements_type;
860     uint8_t  le_advertisements_direct_address_type;
861     uint8_t  le_advertisements_channel_map;
862     uint8_t  le_advertisements_filter_policy;
863     bd_addr_t le_advertisements_direct_address;
864 
865     uint8_t le_max_number_peripheral_connections;
866 #endif
867 
868 #ifdef ENABLE_LE_DATA_LENGTH_EXTENSION
869     // LE Data Length
870     uint16_t le_supported_max_tx_octets;
871     uint16_t le_supported_max_tx_time;
872 #endif
873 
874     // custom BD ADDR
875     bd_addr_t custom_bd_addr;
876     uint8_t   custom_bd_addr_set;
877 
878 #ifdef ENABLE_CLASSIC
879     uint8_t master_slave_policy;
880 #endif
881 
882     // address and address_type of active create connection command (ACL, SCO, LE)
883     bd_addr_t      outgoing_addr;
884     bd_addr_type_t outgoing_addr_type;
885 
886 } hci_stack_t;
887 
888 
889 /* API_START */
890 
891 
892 // HCI init and configuration
893 
894 
895 /**
896  * @brief Set up HCI. Needs to be called before any other function.
897  */
898 void hci_init(const hci_transport_t *transport, const void *config);
899 
900 /**
901  * @brief Configure Bluetooth chipset driver. Has to be called before power on, or right after receiving the local version information.
902  */
903 void hci_set_chipset(const btstack_chipset_t *chipset_driver);
904 
905 /**
906  * @brief Configure Bluetooth hardware control. Has to be called before power on.
907  */
908 void hci_set_control(const btstack_control_t *hardware_control);
909 
910 /**
911  * @brief Configure Bluetooth hardware control. Has to be called before power on.
912  */
913 void hci_set_link_key_db(btstack_link_key_db_t const * link_key_db);
914 
915 /**
916  * @brief Set callback for Bluetooth Hardware Error
917  */
918 void hci_set_hardware_error_callback(void (*fn)(uint8_t error));
919 
920 /**
921  * @brief Set Public BD ADDR - passed on to Bluetooth chipset during init if supported in bt_control_h
922  */
923 void hci_set_bd_addr(bd_addr_t addr);
924 
925 /**
926  * @brief Configure Voice Setting for use with SCO data in HSP/HFP
927  */
928 void hci_set_sco_voice_setting(uint16_t voice_setting);
929 
930 /**
931  * @brief Get SCO Voice Setting
932  * @return current voice setting
933  */
934 uint16_t hci_get_sco_voice_setting(void);
935 
936 /**
937  * @brief Set inquiry mode: standard, with RSSI, with RSSI + Extended Inquiry Results. Has to be called before power on.
938  * @param inquriy_mode see bluetooth_defines.h
939  */
940 void hci_set_inquiry_mode(inquiry_mode_t mode);
941 
942 /**
943  * @brief Requests the change of BTstack power mode.
944  */
945 int  hci_power_control(HCI_POWER_MODE mode);
946 
947 /**
948  * @brief Shutdown HCI
949  */
950 void hci_close(void);
951 
952 
953 // Callback registration
954 
955 
956 /**
957  * @brief Add event packet handler.
958  */
959 void hci_add_event_handler(btstack_packet_callback_registration_t * callback_handler);
960 
961 /**
962  * @brief Registers a packet handler for ACL data. Used by L2CAP
963  */
964 void hci_register_acl_packet_handler(btstack_packet_handler_t handler);
965 
966 /**
967  * @brief Registers a packet handler for SCO data. Used for HSP and HFP profiles.
968  */
969 void hci_register_sco_packet_handler(btstack_packet_handler_t handler);
970 
971 
972 // Sending HCI Commands
973 
974 /**
975  * @brief Check if CMD packet can be sent to controller
976  */
977 int hci_can_send_command_packet_now(void);
978 
979 /**
980  * @brief Creates and sends HCI command packets based on a template and a list of parameters. Will return error if outgoing data buffer is occupied.
981  */
982 int hci_send_cmd(const hci_cmd_t *cmd, ...);
983 
984 
985 // Sending SCO Packets
986 
987 /** @brief Get SCO packet length for current SCO Voice setting
988  *  @note  Using SCO packets of the exact length is required for USB transfer
989  *  @return Length of SCO packets in bytes (not audio frames) incl. 3 byte header
990  */
991 int hci_get_sco_packet_length(void);
992 
993 /**
994  * @brief Request emission of HCI_EVENT_SCO_CAN_SEND_NOW as soon as possible
995  * @note HCI_EVENT_SCO_CAN_SEND_NOW might be emitted during call to this function
996  *       so packet handler should be ready to handle it
997  */
998 void hci_request_sco_can_send_now_event(void);
999 
1000 /**
1001  * @brief Check HCI packet buffer and if SCO packet can be sent to controller
1002  */
1003 int hci_can_send_sco_packet_now(void);
1004 
1005 /**
1006  * @brief Check if SCO packet can be sent to controller
1007  */
1008 int hci_can_send_prepared_sco_packet_now(void);
1009 
1010 /**
1011  * @brief Send SCO packet prepared in HCI packet buffer
1012  */
1013 int hci_send_sco_packet_buffer(int size);
1014 
1015 
1016 // Outgoing packet buffer, also used for SCO packets
1017 // see hci_can_send_prepared_sco_packet_now amn hci_send_sco_packet_buffer
1018 
1019 /**
1020  * Reserves outgoing packet buffer.
1021  * @return 1 on success
1022  */
1023 int hci_reserve_packet_buffer(void);
1024 
1025 /**
1026  * Get pointer for outgoing packet buffer
1027  */
1028 uint8_t* hci_get_outgoing_packet_buffer(void);
1029 
1030 /**
1031  * Release outgoing packet buffer\
1032  * @note only called instead of hci_send_preparared
1033  */
1034 void hci_release_packet_buffer(void);
1035 
1036 /**
1037 * @brief Sets the master/slave policy
1038 * @param policy (0: attempt to become master, 1: let connecting device decide)
1039 */
1040 void hci_set_master_slave_policy(uint8_t policy);
1041 
1042 /* API_END */
1043 
1044 
1045 /**
1046  * va_list version of hci_send_cmd, call hci_send_cmd_packet
1047  */
1048 int hci_send_cmd_va_arg(const hci_cmd_t *cmd, va_list argtr);
1049 
1050 /**
1051  * Get connection iterator. Only used by l2cap.c and sm.c
1052  */
1053 void hci_connections_get_iterator(btstack_linked_list_iterator_t *it);
1054 
1055 /**
1056  * Get internal hci_connection_t for given handle. Used by L2CAP, SM, daemon
1057  */
1058 hci_connection_t * hci_connection_for_handle(hci_con_handle_t con_handle);
1059 
1060 /**
1061  * Get internal hci_connection_t for given Bluetooth addres. Called by L2CAP
1062  */
1063 hci_connection_t * hci_connection_for_bd_addr_and_type(bd_addr_t addr, bd_addr_type_t addr_type);
1064 
1065 /**
1066  * Check if outgoing packet buffer is reserved. Used for internal checks in l2cap.c
1067  */
1068 int hci_is_packet_buffer_reserved(void);
1069 
1070 /**
1071  * Check hci packet buffer is free and a classic acl packet can be sent to controller
1072  */
1073 int hci_can_send_acl_classic_packet_now(void);
1074 
1075 /**
1076  * Check hci packet buffer is free and an LE acl packet can be sent to controller
1077  */
1078 int hci_can_send_acl_le_packet_now(void);
1079 
1080 /**
1081  * Check hci packet buffer is free and an acl packet for the given handle can be sent to controller
1082  */
1083 int hci_can_send_acl_packet_now(hci_con_handle_t con_handle);
1084 
1085 /**
1086  * Check if acl packet for the given handle can be sent to controller
1087  */
1088 int hci_can_send_prepared_acl_packet_now(hci_con_handle_t con_handle);
1089 
1090 /**
1091  * Send acl packet prepared in hci packet buffer
1092  */
1093 int hci_send_acl_packet_buffer(int size);
1094 
1095 /**
1096  * Check if authentication is active. It delays automatic disconnect while no L2CAP connection
1097  * Called by l2cap.
1098  */
1099 int hci_authentication_active_for_handle(hci_con_handle_t handle);
1100 
1101 /**
1102  * Get maximal ACL Classic data packet length based on used buffer size. Called by L2CAP
1103  */
1104 uint16_t hci_max_acl_data_packet_length(void);
1105 
1106 /**
1107  * Get supported packet types. Called by L2CAP
1108  */
1109 uint16_t hci_usable_acl_packet_types(void);
1110 
1111 /**
1112  * Check if ACL packets marked as non flushable can be sent. Called by L2CAP
1113  */
1114 int hci_non_flushable_packet_boundary_flag_supported(void);
1115 
1116 /**
1117  * Check if extended SCO Link is supported
1118  */
1119 int hci_extended_sco_link_supported(void);
1120 
1121 /**
1122  * Check if SSP is supported on both sides. Called by L2CAP
1123  */
1124 int gap_ssp_supported_on_both_sides(hci_con_handle_t handle);
1125 
1126 /**
1127  * Disconn because of security block. Called by L2CAP
1128  */
1129 void hci_disconnect_security_block(hci_con_handle_t con_handle);
1130 
1131 /**
1132  * Query if remote side supports eSCO
1133  */
1134 int hci_remote_esco_supported(hci_con_handle_t con_handle);
1135 
1136 /**
1137  * Emit current HCI state. Called by daemon
1138  */
1139 void hci_emit_state(void);
1140 
1141 /**
1142  * Send complete CMD packet. Called by daemon and hci_send_cmd_va_arg
1143  * @returns 0 if command was successfully sent to HCI Transport layer
1144  */
1145 int hci_send_cmd_packet(uint8_t *packet, int size);
1146 
1147 /**
1148  * Disconnect all HCI connections. Called by daemon
1149  */
1150 void hci_disconnect_all(void);
1151 
1152 /**
1153  * Get number of free acl slots for packets of given handle. Called by daemon
1154  */
1155 int hci_number_free_acl_slots_for_handle(hci_con_handle_t con_handle);
1156 
1157 /**
1158  * @brief Set Advertisement Parameters
1159  * @param adv_int_min
1160  * @param adv_int_max
1161  * @param adv_type
1162  * @param direct_address_type
1163  * @param direct_address
1164  * @param channel_map
1165  * @param filter_policy
1166  *
1167  * @note internal use. use gap_advertisements_set_params from gap.h instead.
1168  */
1169 void hci_le_advertisements_set_params(uint16_t adv_int_min, uint16_t adv_int_max, uint8_t adv_type,
1170     uint8_t direct_address_typ, bd_addr_t direct_address, uint8_t channel_map, uint8_t filter_policy);
1171 
1172 /**
1173  *
1174  * @note internal use. use gap_random_address_set_mode from gap.h instead.
1175  */
1176 void hci_le_set_own_address_type(uint8_t own_address_type);
1177 
1178 /**
1179  * @brief Get Manufactured
1180  * @return manufacturer id
1181  */
1182 uint16_t hci_get_manufacturer(void);
1183 
1184 // Only for PTS testing
1185 
1186 /**
1187  * Disable automatic L2CAP disconnect if no L2CAP connection is established
1188  */
1189 void hci_disable_l2cap_timeout_check(void);
1190 
1191 /**
1192  * Get state
1193  */
1194 HCI_STATE hci_get_state(void);
1195 
1196 #if defined __cplusplus
1197 }
1198 #endif
1199 
1200 #endif // __HCI_H
1201