xref: /btstack/src/hci.h (revision 15470d27182d814caf1c8799512f51643154975c)
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.h
34  *
35  *  Created by Matthias Ringwald on 4/29/09.
36  *
37  */
38 
39 #pragma once
40 
41 #include <btstack/hci_cmds.h>
42 #include <btstack/utils.h>
43 #include "hci_transport.h"
44 #include "bt_control.h"
45 
46 #include <stdint.h>
47 #include <stdlib.h>
48 #include <stdarg.h>
49 
50 // packet header lenghts
51 #define HCI_CMD_DATA_PKT_HDR	  0x03
52 #define HCI_ACL_DATA_PKT_HDR	  0x04
53 #define HCI_SCO_DATA_PKT_HDR	  0x03
54 #define HCI_EVENT_PKT_HDR         0x02
55 
56 // packet sizes
57 #define HCI_ACL_3DH5_SIZE         1021
58 #define HCI_ACL_DH5_SIZE           339
59 
60 // OGFs
61 #define OGF_LINK_CONTROL          0x01
62 #define OGF_LINK_POLICY           0x02
63 #define OGF_CONTROLLER_BASEBAND   0x03
64 #define OGF_INFORMATIONAL_PARAMETERS 0x04
65 #define OGF_BTSTACK 0x3d
66 #define OGF_VENDOR  0x3f
67 
68 // cmds for BTstack
69 // get state: @returns HCI_STATE
70 #define BTSTACK_GET_STATE                                  0x01
71 
72 // set power mode: @param HCI_POWER_MODE
73 #define BTSTACK_SET_POWER_MODE                             0x02
74 
75 // set capture mode: @param on
76 #define BTSTACK_SET_ACL_CAPTURE_MODE                       0x03
77 
78 // get BTstack version
79 #define BTSTACK_GET_VERSION                                0x04
80 
81 // get system Bluetooth state
82 #define BTSTACK_GET_SYSTEM_BLUETOOTH_ENABLED               0x05
83 
84 // set system Bluetooth state
85 #define BTSTACK_SET_SYSTEM_BLUETOOTH_ENABLED               0x06
86 
87 // create l2cap channel: @param bd_addr(48), psm (16)
88 #define L2CAP_CREATE_CHANNEL                               0x20
89 
90 // disconnect l2cap disconnect, @param channel(16), reason(8)
91 #define L2CAP_DISCONNECT                                   0x21
92 
93 // register l2cap service: @param psm(16), mtu (16)
94 #define L2CAP_REGISTER_SERVICE                             0x22
95 
96 // unregister l2cap disconnect, @param psm(16)
97 #define L2CAP_UNREGISTER_SERVICE                           0x23
98 
99 // accept connection @param bd_addr(48), dest cid (16)
100 #define L2CAP_ACCEPT_CONNECTION                            0x24
101 
102 // decline l2cap disconnect,@param bd_addr(48), dest cid (16), reason(8)
103 #define L2CAP_DECLINE_CONNECTION                           0x25
104 
105 // create l2cap channel: @param bd_addr(48), psm (16), mtu (16)
106 #define L2CAP_CREATE_CHANNEL_MTU                           0x26
107 
108 // register SDP Service Record: service record (size)
109 #define SDP_REGISTER_SERVICE_RECORD                        0x30
110 
111 // unregister SDP Service Record
112 #define SDP_UNREGISTER_SERVICE_RECORD                      0x31
113 
114 
115 
116 //
117 #define IS_COMMAND(packet, command) (READ_BT_16(packet,0) == command.opcode)
118 
119 // data: event(8)
120 #define DAEMON_EVENT_CONNECTION_CLOSED                     0x70
121 
122 // data: event(8), nr_connections(8)
123 #define DAEMON_NR_CONNECTIONS_CHANGED                      0x71
124 
125 
126 /**
127  * Connection State
128  */
129 typedef enum {
130     SEND_NEGATIVE_LINK_KEY_REQUEST = 1 << 0,
131     SEND_PIN_CODE_RESPONSE = 1 << 1
132 } hci_connection_flags_t;
133 
134 typedef enum {
135     SENT_CREATE_CONNECTION = 1,
136     RECEIVED_CONNECTION_REQUEST,
137     ACCEPTED_CONNECTION_REQUEST,
138     REJECTED_CONNECTION_REQUEST,
139     OPEN,
140     SENT_DISCONNECT
141 } CONNECTION_STATE;
142 
143 typedef enum {
144     BLUETOOTH_OFF = 1,
145     BLUETOOTH_ON,
146     BLUETOOTH_ACTIVE
147 } BLUETOOTH_STATE;
148 
149 typedef struct {
150     // linked list - assert: first field
151     linked_item_t    item;
152 
153     // remote side
154     bd_addr_t address;
155 
156     // module handle
157     hci_con_handle_t con_handle;
158 
159     // state
160     CONNECTION_STATE state;
161 
162     // errands
163     hci_connection_flags_t flags;
164 
165     // timer
166     timer_source_t timeout;
167     struct timeval timestamp;
168 
169     // ACL packet recombination
170     uint8_t  acl_recombination_buffer[HCI_ACL_3DH5_SIZE]; // max packet: DH5 = header(4) + payload (339)
171     uint16_t acl_recombination_pos;
172     uint16_t acl_recombination_length;
173 
174     // number ACL packets sent to controller
175     uint8_t num_acl_packets_sent;
176 
177 } hci_connection_t;
178 
179 /**
180  * main data structure
181  */
182 typedef struct {
183     // transport component with configuration
184     hci_transport_t  * hci_transport;
185     void             * config;
186 
187     // hardware power controller
188     bt_control_t     * control;
189 
190     // list of existing baseband connections
191     linked_list_t     connections;
192 
193     // single buffer for HCI Command assembly
194     uint8_t          * hci_cmd_buffer;
195 
196     /* host to controller flow control */
197     uint8_t  num_cmd_packets;
198     // uint8_t  total_num_cmd_packets;
199     uint8_t  total_num_acl_packets;
200     uint16_t acl_data_packet_length;
201 
202     /* callback to L2CAP layer */
203     void (*packet_handler)(uint8_t packet_type, uint8_t *packet, uint16_t size);
204 
205     /* hci state machine */
206     HCI_STATE state;
207     uint8_t   substate;
208     uint8_t   cmds_ready;
209 
210 } hci_stack_t;
211 
212 // create and send hci command packets based on a template and a list of parameters
213 uint16_t hci_create_cmd(uint8_t *hci_cmd_buffer, hci_cmd_t *cmd, ...);
214 uint16_t hci_create_cmd_internal(uint8_t *hci_cmd_buffer, const hci_cmd_t *cmd, va_list argptr);
215 
216 // set up HCI
217 void hci_init(hci_transport_t *transport, void *config, bt_control_t *control);
218 void hci_register_packet_handler(void (*handler)(uint8_t packet_type, uint8_t *packet, uint16_t size));
219 
220 // power control
221 int hci_power_control(HCI_POWER_MODE mode);
222 
223 /**
224  * run the hci control loop once
225  */
226 void hci_run();
227 
228 // create and send hci command packets based on a template and a list of parameters
229 int hci_send_cmd(const hci_cmd_t *cmd, ...);
230 
231 // send complete CMD packet
232 int hci_send_cmd_packet(uint8_t *packet, int size);
233 
234 // send ACL packet
235 int hci_send_acl_packet(uint8_t *packet, int size);
236 
237 hci_connection_t * connection_for_handle(hci_con_handle_t con_handle);
238 uint8_t hci_number_outgoing_packets(hci_con_handle_t handle);
239 uint8_t hci_number_free_acl_slots();
240 int     hci_ready_to_send(hci_con_handle_t handle);
241 
242 //
243 void hci_emit_state();
244 void hci_emit_connection_complete(hci_connection_t *conn);
245 void hci_emit_l2cap_check_timeout(hci_connection_t *conn);
246 void hci_emit_nr_connections_changed();
247 void hci_emit_hci_open_failed();
248 void hci_emit_btstack_version();
249 void hci_emit_system_bluetooth_enabled(uint8_t enabled);
250