xref: /btstack/src/bluetooth.h (revision fac60fea7b1f8035236d9793b267925dfa9a010a)
1 /*
2  * Copyright (C) 2015 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  * bluetooth.h
40  *
41  * Numbers defined or derived from the official Bluetooth specification
42  */
43 
44 #ifndef __BLUETOOTH_H
45 #define __BLUETOOTH_H
46 
47 #include <stdint.h>
48 
49 /**
50  * @brief hci connection handle type
51  */
52 typedef uint16_t hci_con_handle_t;
53 
54 /**
55  * @brief Length of a bluetooth device address.
56  */
57 #define BD_ADDR_LEN 6
58 
59 /**
60  * @brief Bluetooth address
61  */
62 typedef uint8_t bd_addr_t[BD_ADDR_LEN];
63 
64 /**
65  * Address types
66  * @note: BTstack uses a custom addr type to refer to classic ACL and SCO devices
67  */
68  typedef enum {
69     BD_ADDR_TYPE_LE_PUBLIC = 0,
70     BD_ADDR_TYPE_LE_RANDOM = 1,
71     BD_ADDR_TYPE_SCO       = 0xfe,
72     BD_ADDR_TYPE_CLASSIC   = 0xff,
73     BD_ADDR_TYPE_UNKNOWN   = 0xfe
74 } bd_addr_type_t;
75 
76 /**
77  * @brief link key
78  */
79 #define LINK_KEY_LEN 16
80 #define LINK_KEY_STR_LEN (LINK_KEY_LEN*2)
81 typedef uint8_t link_key_t[LINK_KEY_LEN];
82 
83 /**
84  * @brief link key type
85  */
86 typedef enum {
87   COMBINATION_KEY = 0,  // standard pairing
88   LOCAL_UNIT_KEY,     // ?
89   REMOTE_UNIT_KEY,    // ?
90   DEBUG_COMBINATION_KEY,  // SSP with debug
91   UNAUTHENTICATED_COMBINATION_KEY_GENERATED_FROM_P192, // SSP Simple Pairing
92   AUTHENTICATED_COMBINATION_KEY_GENERATED_FROM_P192,   // SSP Passkey, Number confirm, OOB
93   CHANGED_COMBINATION_KEY,               // Link key changed using Change Connection Lnk Key
94   UNAUTHENTICATED_COMBINATION_KEY_GENERATED_FROM_P256, // SSP Simpe Pairing
95   AUTHENTICATED_COMBINATION_KEY_GENERATED_FROM_P256,   // SSP Passkey, Number confirm, OOB
96 } link_key_type_t;
97 
98 /**
99  * @brief Inquiry modes
100  */
101 typedef enum {
102   INQUIRY_MODE_STANDARD = 0,
103   INQUIRY_MODE_RSSI,
104   INQUIRY_MODE_RSSI_AND_EIR,
105 } inquiry_mode_t;
106 
107 /**
108  * HCI Transport
109  */
110 
111 /**
112  * packet types - used in BTstack and over the H4 UART interface
113  */
114 #define HCI_COMMAND_DATA_PACKET 0x01
115 #define HCI_ACL_DATA_PACKET     0x02
116 #define HCI_SCO_DATA_PACKET     0x03
117 #define HCI_EVENT_PACKET        0x04
118 
119 // packet header sizes
120 #define HCI_CMD_HEADER_SIZE          3
121 #define HCI_ACL_HEADER_SIZE          4
122 #define HCI_SCO_HEADER_SIZE          3
123 #define HCI_EVENT_HEADER_SIZE        2
124 
125 /**
126  * HCI Layer
127  */
128 
129 //
130 // Error Codes
131 //
132 
133 // from Bluetooth Core Specification
134 #define ERROR_CODE_SUCCESS                                 0x00
135 #define ERROR_CODE_UNKNOWN_HCI_COMMAND                     0x01
136 #define ERROR_CODE_UNKNOWN_CONNECTION_IDENTIFIER           0x02
137 #define ERROR_CODE_HARDWARE_FAILURE                        0x03
138 #define ERROR_CODE_PAGE_TIMEOUT                            0x04
139 #define ERROR_CODE_AUTHENTICATION_FAILURE                  0x05
140 #define ERROR_CODE_PIN_OR_KEY_MISSING                      0x06
141 #define ERROR_CODE_MEMORY_CAPACITY_EXCEEDED                0x07
142 #define ERROR_CODE_CONNECTION_TIMEOUT                      0x08
143 #define ERROR_CODE_CONNECTION_LIMIT_EXCEEDED               0x09
144 #define ERROR_CODE_SYNCHRONOUS_CONNECTION_LIMIT_TO_A_DEVICE_EXCEEDED  0x0A
145 #define ERROR_CODE_ACL_CONNECTION_ALREADY_EXISTS           0x0B
146 #define ERROR_CODE_COMMAND_DISALLOWED                      0x0C
147 #define ERROR_CODE_CONNECTION_REJECTED_DUE_TO_LIMITED_RESOURCES 0x0D
148 #define ERROR_CODE_CONNECTION_REJECTED_DUE_TO_SECURITY_REASONS  0x0E
149 #define ERROR_CODE_CONNECTION_REJECTED_DUE_TO_UNACCEPTABLE_BD_ADDR 0x0F
150 #define ERROR_CODE_CONNECTION_ACCEPT_TIMEOUT_EXCEEDED      0x10
151 #define ERROR_CODE_UNSUPPORTED_FEATURE_OR_PARAMETER_VALUE  0x11
152 #define ERROR_CODE_INVALID_HCI_COMMAND_PARAMETERS          0x12
153 #define ERROR_CODE_REMOTE_USER_TERMINATED_CONNECTION       0x13
154 #define ERROR_CODE_REMOTE_DEVICE_TERMINATED_CONNECTION_DUE_TO_LOW_RESOURCES 0x14
155 #define ERROR_CODE_REMOTE_DEVICE_TERMINATED_CONNECTION_DUE_TO_POWER_OFF     0x15
156 #define ERROR_CODE_CONNECTION_TERMINATED_BY_LOCAL_HOST     0x16
157 #define ERROR_CODE_REPEATED_ATTEMPTS                       0x17
158 #define ERROR_CODE_PAIRING_NOT_ALLOWED                     0x18
159 #define ERROR_CODE_UNKNOWN_LMP_PDU                         0x19
160 #define ERROR_CODE_UNSUPPORTED_REMOTE_FEATURE_UNSUPPORTED_LMP_FEATURE 0x1A
161 #define ERROR_CODE_SCO_OFFSET_REJECTED                     0x1B
162 #define ERROR_CODE_SCO_INTERVAL_REJECTED                   0x1C
163 #define ERROR_CODE_SCO_AIR_MODE_REJECTED                   0x1D
164 #define ERROR_CODE_INVALID_LMP_PARAMETERS_INVALID_LL_PARAMETERS 0x1E
165 #define ERROR_CODE_UNSPECIFIED_ERROR                       0x1F
166 #define ERROR_CODE_UNSUPPORTED_LMP_PARAMETER_VALUE_UNSUPPORTED_LL_PARAMETER_VALUE 0x20
167 #define ERROR_CODE_ROLE_CHANGE_NOT_ALLOWED                 0x21
168 #define ERROR_CODE_LMP_RESPONSE_TIMEOUT_LL_RESPONSE_TIMEOUT 0x22
169 #define ERROR_CODE_LMP_ERROR_TRANSACTION_COLLISION         0x23
170 #define ERROR_CODE_LMP_PDU_NOT_ALLOWED                     0x24
171 #define ERROR_CODE_ENCRYPTION_MODE_NOT_ACCEPTABLE          0x25
172 #define ERROR_CODE_LINK_KEY_CANNOT_BE_CHANGED              0x26
173 #define ERROR_CODE_REQUESTED_QOS_NOT_SUPPORTED             0x27
174 #define ERROR_CODE_INSTANT_PASSED                          0x28
175 #define ERROR_CODE_PAIRING_WITH_UNIT_KEY_NOT_SUPPORTED     0x29
176 #define ERROR_CODE_DIFFERENT_TRANSACTION_COLLISION         0x2A
177 #define ERROR_CODE_RESERVED                                0x2B
178 #define ERROR_CODE_QOS_UNACCEPTABLE_PARAMETER              0x2C
179 #define ERROR_CODE_QOS_REJECTED                            0x2D
180 #define ERROR_CODE_CHANNEL_CLASSIFICATION_NOT_SUPPORTED    0x2E
181 #define ERROR_CODE_INSUFFICIENT_SECURITY                   0x2F
182 #define ERROR_CODE_PARAMETER_OUT_OF_MANDATORY_RANGE        0x30
183 // #define ERROR_CODE_RESERVED
184 #define ERROR_CODE_ROLE_SWITCH_PENDING                     0x32
185 // #define ERROR_CODE_RESERVED
186 #define ERROR_CODE_RESERVED_SLOT_VIOLATION                 0x34
187 #define ERROR_CODE_ROLE_SWITCH_FAILED                      0x35
188 #define ERROR_CODE_EXTENDED_INQUIRY_RESPONSE_TOO_LARGE     0x36
189 #define ERROR_CODE_SECURE_SIMPLE_PAIRING_NOT_SUPPORTED_BY_HOST 0x37
190 #define ERROR_CODE_HOST_BUSY_PAIRING                       0x38
191 #define ERROR_CODE_CONNECTION_REJECTED_DUE_TO_NO_SUITABLE_CHANNEL_FOUND 0x39
192 #define ERROR_CODE_CONTROLLER_BUSY                         0x3A
193 #define ERROR_CODE_UNACCEPTABLE_CONNECTION_PARAMETERS      0x3B
194 #define ERROR_CODE_DIRECTED_ADVERTISING_TIMEOUT            0x3C
195 #define ERROR_CODE_CONNECTION_TERMINATED_DUE_TO_MIC_FAILURE 0x3D
196 #define ERROR_CODE_CONNECTION_FAILED_TO_BE_ESTABLISHED     0x3E
197 #define ERROR_CODE_MAC_CONNECTION_FAILED                   0x3F
198 #define ERROR_CODE_COARSE_CLOCK_ADJUSTMENT_REJECTED_BUT_WILL_TRY_TO_ADJUST_USING_CLOCK_DRAGGING 0x40
199 
200 // HCI roles
201 #define HCI_ROLE_MASTER 0
202 #define HCI_ROLE_SLAVE  1
203 
204 // packet sizes (max payload)
205 #define HCI_ACL_DM1_SIZE            17
206 #define HCI_ACL_DH1_SIZE            27
207 #define HCI_ACL_2DH1_SIZE           54
208 #define HCI_ACL_3DH1_SIZE           83
209 #define HCI_ACL_DM3_SIZE           121
210 #define HCI_ACL_DH3_SIZE           183
211 #define HCI_ACL_DM5_SIZE           224
212 #define HCI_ACL_DH5_SIZE           339
213 #define HCI_ACL_2DH3_SIZE          367
214 #define HCI_ACL_3DH3_SIZE          552
215 #define HCI_ACL_2DH5_SIZE          679
216 #define HCI_ACL_3DH5_SIZE         1021
217 
218 #define HCI_EVENT_PAYLOAD_SIZE     255
219 #define HCI_CMD_PAYLOAD_SIZE       255
220 
221 #define LE_ADVERTISING_DATA_SIZE    31
222 
223 /**
224  * Default INQ Mode
225  */
226 #define HCI_INQUIRY_LAP 0x9E8B33L  // 0x9E8B33: General/Unlimited Inquiry Access Code (GIAC)
227 
228 /**
229  * SSP IO Capabilities
230  */
231 #define SSP_IO_CAPABILITY_DISPLAY_ONLY   0
232 #define SSP_IO_CAPABILITY_DISPLAY_YES_NO 1
233 #define SSP_IO_CAPABILITY_KEYBOARD_ONLY  2
234 #define SSP_IO_CAPABILITY_NO_INPUT_NO_OUTPUT 3
235 #define SSP_IO_CAPABILITY_UNKNOWN 0xff
236 
237 
238 /**
239  * SSP Authentication Requirements, see IO Capability Request Reply Commmand
240  */
241 
242 // Numeric comparison with automatic accept allowed.
243 #define SSP_IO_AUTHREQ_MITM_PROTECTION_NOT_REQUIRED_NO_BONDING 0x00
244 
245 // Use IO Capabilities to deter- mine authentication procedure
246 #define SSP_IO_AUTHREQ_MITM_PROTECTION_REQUIRED_NO_BONDING 0x01
247 
248 // Numeric compar- ison with automatic accept allowed.
249 #define SSP_IO_AUTHREQ_MITM_PROTECTION_NOT_REQUIRED_DEDICATED_BONDING 0x02
250 
251 // Use IO Capabilities to determine authentication procedure
252 #define SSP_IO_AUTHREQ_MITM_PROTECTION_REQUIRED_DEDICATED_BONDING 0x03
253 
254 // Numeric Compari- son with automatic accept allowed.
255 #define SSP_IO_AUTHREQ_MITM_PROTECTION_NOT_REQUIRED_GENERAL_BONDING 0x04
256 
257 // Use IO capabilities to determine authentication procedure.
258 #define SSP_IO_AUTHREQ_MITM_PROTECTION_REQUIRED_GENERAL_BONDING 0x05
259 
260 
261 // OGFs
262 #define OGF_LINK_CONTROL          0x01
263 #define OGF_LINK_POLICY           0x02
264 #define OGF_CONTROLLER_BASEBAND   0x03
265 #define OGF_INFORMATIONAL_PARAMETERS 0x04
266 #define OGF_STATUS_PARAMETERS     0x05
267 #define OGF_TESTING               0x06
268 #define OGF_LE_CONTROLLER 0x08
269 #define OGF_VENDOR  0x3f
270 
271 
272 // Events from host controller to host
273 
274 /**
275  * @format 1
276  * @param status
277  */
278 #define HCI_EVENT_INQUIRY_COMPLETE                         0x01
279 // no format yet, can contain multiple results
280 
281 /**
282  * @format 1B11132
283  * @param num_responses
284  * @param bd_addr
285  * @param page_scan_repetition_mode
286  * @param reserved1
287  * @param reserved2
288  * @param class_of_device
289  * @param clock_offset
290  */
291 #define HCI_EVENT_INQUIRY_RESULT                           0x02
292 
293 /**
294  * @format 12B11
295  * @param status
296  * @param connection_handle
297  * @param bd_addr
298  * @param link_type
299  * @param encryption_enabled
300  */
301 #define HCI_EVENT_CONNECTION_COMPLETE                      0x03
302 /**
303  * @format B31
304  * @param bd_addr
305  * @param class_of_device
306  * @param link_type
307  */
308 #define HCI_EVENT_CONNECTION_REQUEST                       0x04
309 /**
310  * @format 121
311  * @param status
312  * @param connection_handle
313  * @param reason
314  */
315 #define HCI_EVENT_DISCONNECTION_COMPLETE                   0x05
316 /**
317  * @format 12
318  * @param status
319  * @param connection_handle
320  */
321 #define HCI_EVENT_AUTHENTICATION_COMPLETE_EVENT            0x06
322 /**
323  * @format 1BN
324  * @param status
325  * @param bd_addr
326  * @param remote_name
327  */
328 #define HCI_EVENT_REMOTE_NAME_REQUEST_COMPLETE             0x07
329 /**
330  * @format 121
331  * @param status
332  * @param connection_handle
333  * @param encryption_enabled
334  */
335 #define HCI_EVENT_ENCRYPTION_CHANGE                        0x08
336 /**
337  * @format 12
338  * @param status
339  * @param connection_handle
340  */
341 #define HCI_EVENT_CHANGE_CONNECTION_LINK_KEY_COMPLETE      0x09
342 /**
343  * @format 121
344  * @param status
345  * @param connection_handle
346  * @param key_flag
347  */
348 #define HCI_EVENT_MASTER_LINK_KEY_COMPLETE                 0x0A
349 #define HCI_EVENT_READ_REMOTE_SUPPORTED_FEATURES_COMPLETE  0x0B
350 #define HCI_EVENT_READ_REMOTE_VERSION_INFORMATION_COMPLETE 0x0C
351 #define HCI_EVENT_QOS_SETUP_COMPLETE                       0x0D
352 
353 /**
354  * @format 12R
355  * @param num_hci_command_packets
356  * @param command_opcode
357  * @param return_parameters
358  */
359 #define HCI_EVENT_COMMAND_COMPLETE                         0x0E
360 /**
361  * @format 112
362  * @param status
363  * @param num_hci_command_packets
364  * @param command_opcode
365  */
366 #define HCI_EVENT_COMMAND_STATUS                           0x0F
367 
368 /**
369  * @format 121
370  * @param hardware_code
371  */
372 #define HCI_EVENT_HARDWARE_ERROR                           0x10
373 
374 #define HCI_EVENT_FLUSH_OCCURED                            0x11
375 
376 /**
377  * @format 1B1
378  * @param status
379  * @param bd_addr
380  * @param role
381  */
382 #define HCI_EVENT_ROLE_CHANGE                              0x12
383 
384 // TODO: number_of_handles 1, connection_handle[H*i], hc_num_of_completed_packets[2*i]
385 #define HCI_EVENT_NUMBER_OF_COMPLETED_PACKETS              0x13
386 
387 /**
388  * @format 1H12
389  * @param status
390  * @param handle
391  * @param mode
392  * @param interval
393  */
394 #define HCI_EVENT_MODE_CHANGE_EVENT                        0x14
395 
396 // TODO: num_keys, bd_addr[B*i], link_key[16 octets * i]
397 #define HCI_EVENT_RETURN_LINK_KEYS                         0x15
398 
399 /**
400  * @format B
401  * @param bd_addr
402  */
403 #define HCI_EVENT_PIN_CODE_REQUEST                         0x16
404 
405 /**
406  * @format B
407  * @param bd_addr
408  */
409 #define HCI_EVENT_LINK_KEY_REQUEST                         0x17
410 
411 // TODO: bd_addr B, link_key 16octets, key_type 1
412 #define HCI_EVENT_LINK_KEY_NOTIFICATION                    0x18
413 
414 /**
415  * @format 1
416  * @param link_type
417  */
418 #define HCI_EVENT_DATA_BUFFER_OVERFLOW                     0x1A
419 
420 /**
421  * @format H1
422  * @param handle
423  * @param lmp_max_slots
424  */
425 #define HCI_EVENT_MAX_SLOTS_CHANGED                        0x1B
426 
427 /**
428  * @format 1H2
429  * @param status
430  * @param handle
431  * @param clock_offset
432  */
433 #define HCI_EVENT_READ_CLOCK_OFFSET_COMPLETE               0x1C
434 
435 /**
436  * @format 1H2
437  * @param status
438  * @param handle
439  * @param packet_types
440  * @pnote packet_type is in plural to avoid clash with Java binding Packet.getPacketType()
441  */
442 #define HCI_EVENT_CONNECTION_PACKET_TYPE_CHANGED           0x1D
443 
444 /**
445  * @format 1B11321
446  * @param num_responses
447  * @param bd_addr
448  * @param page_scan_repetition_mode
449  * @param reserved
450  * @param class_of_device
451  * @param clock_offset
452  * @param rssi
453  */
454 #define HCI_EVENT_INQUIRY_RESULT_WITH_RSSI                 0x22
455 
456 /**
457  * @format 1HB111221
458  * @param status
459  * @param handle
460  * @param bd_addr
461  * @param link_type
462  * @param transmission_interval
463  * @param retransmission_interval
464  * @param rx_packet_length
465  * @param tx_packet_length
466  * @param air_mode
467  */
468 #define HCI_EVENT_SYNCHRONOUS_CONNECTION_COMPLETE          0x2C
469 
470 // TODO: serialize extended_inquiry_response and provide parser
471 /**
472  * @format 1B11321
473  * @param num_responses
474  * @param bd_addr
475  * @param page_scan_repetition_mode
476  * @param reserved
477  * @param class_of_device
478  * @param clock_offset
479  * @param rssi
480  */
481 #define HCI_EVENT_EXTENDED_INQUIRY_RESPONSE                0x2F
482 
483  /**
484   * @format 1H
485   * @param status
486   * @param handle
487   */
488 #define HCI_EVENT_ENCRYPTION_KEY_REFRESH_COMPLETE          0x30
489 
490 #define HCI_EVENT_IO_CAPABILITY_REQUEST                    0x31
491 #define HCI_EVENT_IO_CAPABILITY_RESPONSE                   0x32
492 #define HCI_EVENT_USER_CONFIRMATION_REQUEST                0x33
493 #define HCI_EVENT_USER_PASSKEY_REQUEST                     0x34
494 #define HCI_EVENT_REMOTE_OOB_DATA_REQUEST                  0x35
495 #define HCI_EVENT_SIMPLE_PAIRING_COMPLETE                  0x36
496 
497 #define HCI_EVENT_LE_META                                  0x3E
498 
499 #define HCI_EVENT_VENDOR_SPECIFIC                          0xFF
500 
501 /**
502  * @format 11H11B2221
503  * @param subevent_code
504  * @param status
505  * @param connection_handle
506  * @param role
507  * @param peer_address_type
508  * @param peer_address
509  * @param conn_interval
510  * @param conn_latency
511  * @param supervision_timeout
512  * @param master_clock_accuracy
513  */
514 #define HCI_SUBEVENT_LE_CONNECTION_COMPLETE                0x01
515 #define HCI_SUBEVENT_LE_ADVERTISING_REPORT                 0x02
516 #define HCI_SUBEVENT_LE_CONNECTION_UPDATE_COMPLETE         0x03
517 #define HCI_SUBEVENT_LE_READ_REMOTE_USED_FEATURES_COMPLETE 0x04
518 #define HCI_SUBEVENT_LE_LONG_TERM_KEY_REQUEST              0x05
519 
520 // last used HCI_EVENT in 2.1 is 0x3d
521 // last used HCI_EVENT in 4.1 is 0x57
522 
523 /**
524  * L2CAP Layer
525  */
526 
527 #define L2CAP_HEADER_SIZE 4
528 
529 #define L2CAP_SIG_ID_INVALID 0
530 
531 // size of HCI ACL + L2CAP Header for regular data packets (8)
532 #define COMPLETE_L2CAP_HEADER (HCI_ACL_HEADER_SIZE + L2CAP_HEADER_SIZE)
533 
534 // minimum signaling MTU
535 #define L2CAP_MINIMAL_MTU 48
536 #define L2CAP_DEFAULT_MTU 672
537 
538 // Minimum/default MTU
539 #define L2CAP_LE_DEFAULT_MTU  23
540 
541 // L2CAP Fixed Channel IDs
542 #define L2CAP_CID_SIGNALING                 0x0001
543 #define L2CAP_CID_CONNECTIONLESS_CHANNEL    0x0002
544 #define L2CAP_CID_ATTRIBUTE_PROTOCOL        0x0004
545 #define L2CAP_CID_SIGNALING_LE              0x0005
546 #define L2CAP_CID_SECURITY_MANAGER_PROTOCOL 0x0006
547 
548 // L2CAP Configuration Result Codes
549 #define L2CAP_CONF_RESULT_UNKNOWN_OPTIONS   0x0003
550 
551 // L2CAP Reject Result Codes
552 #define L2CAP_REJ_CMD_UNKNOWN               0x0000
553 
554 // Response Timeout eXpired
555 #define L2CAP_RTX_TIMEOUT_MS   10000
556 
557 // Extended Response Timeout eXpired
558 #define L2CAP_ERTX_TIMEOUT_MS 120000
559 
560 // Fixed PSM numbers
561 #define PSM_SDP           0x01
562 #define PSM_RFCOMM        0x03
563 #define PSM_BNEP          0x0F
564 #define PSM_HID_CONTROL   0x11
565 #define PSM_HID_INTERRUPT 0x13
566 
567 /**
568  * SDP Protocl
569  */
570 
571  // PDU Types
572 typedef enum {
573     SDP_Invalid = 0,
574     SDP_ErrorResponse = 1,
575     SDP_ServiceSearchRequest,
576     SDP_ServiceSearchResponse,
577     SDP_ServiceAttributeRequest,
578     SDP_ServiceAttributeResponse,
579     SDP_ServiceSearchAttributeRequest,
580     SDP_ServiceSearchAttributeResponse
581 } SDP_PDU_ID_t;
582 
583 // UNIVERSAL ATTRIBUTE DEFINITIONS
584 #define SDP_ServiceRecordHandle     0x0000
585 #define SDP_ServiceClassIDList      0x0001
586 #define SDP_ServiceRecordState      0x0002
587 #define SDP_ServiceID               0x0003
588 #define SDP_ProtocolDescriptorList  0x0004
589 #define SDP_BrowseGroupList         0x0005
590 #define SDP_LanguageBaseAttributeIDList 0x0006
591 #define SDP_ServiceInfoTimeToLive   0x0007
592 #define SDP_ServiceAvailability     0x0008
593 #define SDP_BluetoothProfileDescriptorList 0x0009
594 #define SDP_DocumentationURL        0x000a
595 #define SDP_ClientExecutableURL     0x000b
596 #define SDP_IconURL                 0x000c
597 #define SDP_AdditionalProtocolDescriptorList 0x000d
598 #define SDP_SupportedFormatsList    0x0303
599 
600 // SERVICE CLASSES
601 #define SDP_OBEXObjectPush          0x1105
602 #define SDP_OBEXFileTransfer        0x1106
603 #define SDP_PublicBrowseGroup       0x1002
604 #define SDP_HSP                     0x1108
605 #define SDP_Headset_AG              0x1112
606 #define SDP_PANU                    0x1115
607 #define SDP_NAP                     0x1116
608 #define SDP_GN                      0x1117
609 #define SDP_Handsfree               0x111E
610 #define SDP_HandsfreeAudioGateway   0x111F
611 #define SDP_Headset_HS              0x1131
612 #define SDP_GenericAudio            0x1203
613 
614 
615 // PROTOCOLS
616 #define SDP_SDPProtocol       0x0001
617 #define SDP_UDPProtocol       0x0002
618 #define SDP_RFCOMMProtocol    0x0003
619 #define SDP_OBEXProtocol      0x0008
620 #define SDP_L2CAPProtocol     0x0100
621 #define SDP_BNEPProtocol      0x000F
622 #define SDP_AVDTPProtocol     0x0019
623 
624 // OFFSETS FOR LOCALIZED ATTRIBUTES - SDP_LanguageBaseAttributeIDList
625 #define SDP_Offest_ServiceName      0x0000
626 #define SDP_Offest_ServiceDescription 0x0001
627 #define SDP_Offest_ProviderName     0x0002
628 
629 // OBEX
630 #define SDP_vCard_2_1       0x01
631 #define SDP_vCard_3_0       0x02
632 #define SDP_vCal_1_0        0x03
633 #define SDP_iCal_2_0        0x04
634 #define SDP_vNote           0x05
635 #define SDP_vMessage        0x06
636 #define SDP_OBEXFileTypeAny 0xFF
637 
638 /**
639  * RFCOMM Protocol
640  */
641 
642 // Control field values      bit no.       1 2 3 4 PF 6 7 8
643 #define BT_RFCOMM_SABM       0x3F       // 1 1 1 1  1 1 0 0
644 #define BT_RFCOMM_UA         0x73       // 1 1 0 0  1 1 1 0
645 #define BT_RFCOMM_DM         0x0F       // 1 1 1 1  0 0 0 0
646 #define BT_RFCOMM_DM_PF      0x1F       // 1 1 1 1  1 0 0 0
647 #define BT_RFCOMM_DISC       0x53       // 1 1 0 0  1 0 1 0
648 #define BT_RFCOMM_UIH        0xEF       // 1 1 1 1  0 1 1 1
649 #define BT_RFCOMM_UIH_PF     0xFF       // 1 1 1 1  0 1 1 1
650 
651 // Multiplexer message types
652 #define BT_RFCOMM_CLD_CMD    0xC3
653 #define BT_RFCOMM_FCON_CMD   0xA3
654 #define BT_RFCOMM_FCON_RSP   0xA1
655 #define BT_RFCOMM_FCOFF_CMD  0x63
656 #define BT_RFCOMM_FCOFF_RSP  0x61
657 #define BT_RFCOMM_MSC_CMD    0xE3
658 #define BT_RFCOMM_MSC_RSP    0xE1
659 #define BT_RFCOMM_NSC_RSP    0x11
660 #define BT_RFCOMM_PN_CMD     0x83
661 #define BT_RFCOMM_PN_RSP     0x81
662 #define BT_RFCOMM_RLS_CMD    0x53
663 #define BT_RFCOMM_RLS_RSP    0x51
664 #define BT_RFCOMM_RPN_CMD    0x93
665 #define BT_RFCOMM_RPN_RSP    0x91
666 #define BT_RFCOMM_TEST_CMD   0x23
667 #define BT_RFCOMM_TEST_RSP   0x21
668 
669 // Line Status
670 #define LINE_STATUS_NO_ERROR       0x00
671 #define LINE_STATUS_OVERRUN_ERROR  0x03
672 #define LINE_STATUS_PARITY_ERORR   0x05
673 #define LINE_STATUS_FRAMING_ERROR  0x09
674 
675 // Modem Status Flags
676 #define MODEM_STATUS_FC   0x02
677 #define MODEM_STATUS_RTC  0x04
678 #define MODEM_STATUS_RTR  0x08
679 #define MODEM_STATUS_IC   0x40
680 #define MODEM_STATUS_DV   0x80
681 
682 typedef enum rpn_baud {
683     RPN_BAUD_2400 = 0,
684     RPN_BAUD_4800,
685     RPN_BAUD_7200,
686     RPN_BAUD_9600,
687     RPN_BAUD_19200,
688     RPN_BAUD_38400,
689     RPN_BAUD_57600,
690     RPN_BAUD_115200,
691     RPN_BAUD_230400
692 } rpn_baud_t;
693 
694 typedef enum rpn_data_bits {
695     RPN_DATA_BITS_5 = 0,
696     RPN_DATA_BITS_6 = 0,
697     RPN_DATA_BITS_7 = 0,
698     RPN_DATA_BITS_8 = 0
699 } rpn_data_bits_t;
700 
701 typedef enum rpn_stop_bits {
702     RPN_STOP_BITS_1_0 = 0,
703     RPN_STOP_BITS_1_5
704 } rpn_stop_bits_t;
705 
706 typedef enum rpn_parity {
707     RPN_PARITY_NONE  = 0,
708     RPN_PARITY_ODD   = 1,
709     RPN_PARITY_EVEN  = 3,
710     RPN_PARITY_MARK  = 5,
711     RPN_PARITY_SPACE = 7,
712 } rpn_parity_t;
713 
714 typedef enum rpn_flow_control {
715     RPN_FLOW_CONTROL_XONXOFF_ON_INPUT  = 1 << 0,
716     RPN_FLOW_CONTROL_XONXOFF_ON_OUTPUT = 1 << 1,
717     RPN_FLOW_CONTROL_RTR_ON_INPUT  = 1 << 2,
718     RPN_FLOW_CONTROL_RTR_ON_OUTPUT = 1 << 3,
719     RPN_FLOW_CONTROL_RTC_ON_INPUT  = 1 << 4,
720     RPN_FLOW_CONTROL_RTC_ON_OUTPUT = 1 << 5,
721 } rpn_flow_control_t;
722 
723 #define RPN_PARAM_MASK_0_BAUD             0x01
724 #define RPN_PARAM_MASK_0_DATA_BITS        0x02
725 #define RPN_PARAM_MASK_0_STOP_BITS        0x04
726 #define RPN_PARAM_MASK_0_PARITY           0x08
727 #define RPN_PARAM_MASK_0_PARITY_TYPE      0x10
728 #define RPN_PARAM_MASK_0_XON_CHAR         0x20
729 #define RPN_PARAM_MASK_0_XOFF_CHAR        0x40
730 #define RPN_PARAM_MASK_0_RESERVED         0x80
731 
732 // @note: values are identical to rpn_flow_control_t
733 #define RPN_PARAM_MASK_1_XONOFF_ON_INPUT  0x01
734 #define RPN_PARAM_MASK_1_XONOFF_ON_OUTPUT 0x02
735 #define RPN_PARAM_MASK_1_RTR_ON_INPUT     0x04
736 #define RPN_PARAM_MASK_1_RTR_ON_OUTPUT    0x08
737 #define RPN_PARAM_MASK_1_RTC_ON_INPUT     0x10
738 #define RPN_PARAM_MASK_1_RTC_ON_OUTPUT    0x20
739 #define RPN_PARAM_MASK_1_RESERVED_0       0x40
740 #define RPN_PARAM_MASK_1_RESERVED_1       0x80
741 
742 /**
743  * BNEP Protocol
744  */
745 
746 #ifndef ETHER_ADDR_LEN
747 #define ETHER_ADDR_LEN 6
748 #endif
749 
750 #ifndef ETHERTYPE_VLAN
751 #define ETHERTYPE_VLAN                                  0x8100 /* IEEE 802.1Q VLAN tag */
752 #endif
753 
754 #define BNEP_MTU_MIN                                    1691
755 
756 #define BNEP_EXT_FLAG                                   0x80
757 #define BNEP_TYPE_MASK                                  0x7F
758 #define BNEP_TYPE(header)                               ((header) & BNEP_TYPE_MASK)
759 #define BNEP_HEADER_HAS_EXT(x)                          (((x) & BNEP_EXT_FLAG) == BNEP_EXT_FLAG)
760 
761 /* BNEP packet types */
762 #define BNEP_PKT_TYPE_GENERAL_ETHERNET                  0x00
763 #define BNEP_PKT_TYPE_CONTROL                           0x01
764 #define BNEP_PKT_TYPE_COMPRESSED_ETHERNET               0x02
765 #define BNEP_PKT_TYPE_COMPRESSED_ETHERNET_SOURCE_ONLY   0x03
766 #define BNEP_PKT_TYPE_COMPRESSED_ETHERNET_DEST_ONLY     0x04
767 
768 /* BNEP control types */
769 #define BNEP_CONTROL_TYPE_COMMAND_NOT_UNDERSTOOD        0x00
770 #define BNEP_CONTROL_TYPE_SETUP_CONNECTION_REQUEST      0x01
771 #define BNEP_CONTROL_TYPE_SETUP_CONNECTION_RESPONSE     0x02
772 #define BNEP_CONTROL_TYPE_FILTER_NET_TYPE_SET           0x03
773 #define BNEP_CONTROL_TYPE_FILTER_NET_TYPE_RESPONSE      0x04
774 #define BNEP_CONTROL_TYPE_FILTER_MULTI_ADDR_SET         0x05
775 #define BNEP_CONTROL_TYPE_FILTER_MULTI_ADDR_RESPONSE    0x06
776 
777 /* BNEP extension header types */
778 #define BNEP_EXT_HEADER_TYPE_EXTENSION_CONTROL          0x00
779 
780 /* BNEP setup response codes */
781 #define BNEP_RESP_SETUP_SUCCESS                         0x0000
782 #define BNEP_RESP_SETUP_INVALID_DEST_UUID               0x0001
783 #define BNEP_RESP_SETUP_INVALID_SOURCE_UUID             0x0002
784 #define BNEP_RESP_SETUP_INVALID_SERVICE_UUID_SIZE       0x0003
785 #define BNEP_RESP_SETUP_CONNECTION_NOT_ALLOWED          0x0004
786 
787 /* BNEP filter response codes */
788 #define BNEP_RESP_FILTER_SUCCESS                        0x0000
789 #define BNEP_RESP_FILTER_UNSUPPORTED_REQUEST            0x0001
790 #define BNEP_RESP_FILTER_ERR_INVALID_RANGE              0x0002
791 #define BNEP_RESP_FILTER_ERR_TOO_MANY_FILTERS           0x0003
792 #define BNEP_RESP_FILTER_ERR_SECURITY                   0x0004
793 
794 /**
795  * PAN Profile
796  */
797 
798 typedef enum {
799     PANU_UUID = 0x1115,
800     NAP_UUID = 0x1116,
801     GN_UUID = 0x1117
802 } bnep_service_uuid_t;
803 
804 typedef enum {
805     BNEP_SECURITY_NONE = 0x0000,
806     BNEP_SECURITY_SERVICE_LEVEL_ENFORCED,
807     BNEP_SECURITY_802_1X
808 } security_description_t;
809 
810 typedef enum {
811     PAN_NET_ACCESS_TYPE_PSTN = 0x0000,
812     PAN_NET_ACCESS_TYPE_ISDN,
813     PAN_NET_ACCESS_TYPE_DSL,
814     PAN_NET_ACCESS_TYPE_CABLE_MODEM,
815     PAN_NET_ACCESS_TYPE_10MB_ETHERNET,
816     PAN_NET_ACCESS_TYPE_100MB_ETHERNET,
817     PAN_NET_ACCESS_TYPE_4MB_TOKEN_RING,
818     PAN_NET_ACCESS_TYPE_16MB_TOKEN_RING,
819     PAN_NET_ACCESS_TYPE_100MB_TOKEN_RING,
820     PAN_NET_ACCESS_TYPE_FDDI,
821     PAN_NET_ACCESS_TYPE_GSM,
822     PAN_NET_ACCESS_TYPE_CDMA,
823     PAN_NET_ACCESS_TYPE_GPRS,
824     PAN_NET_ACCESS_TYPE_3G,
825     PAN_NET_ACCESS_TYPE_CELULAR,
826     PAN_NET_ACCESS_TYPE_OTHER = 0xFFFE,
827     PAN_NET_ACCESS_TYPE_NONE
828 } net_access_type_t;
829 
830 /**
831  * ATT
832  */
833 
834 // Minimum/default MTU
835 #define ATT_DEFAULT_MTU               23
836 
837 // MARK: Attribute PDU Opcodes
838 #define ATT_ERROR_RESPONSE              0x01
839 
840 #define ATT_EXCHANGE_MTU_REQUEST        0x02
841 #define ATT_EXCHANGE_MTU_RESPONSE       0x03
842 
843 #define ATT_FIND_INFORMATION_REQUEST    0x04
844 #define ATT_FIND_INFORMATION_REPLY      0x05
845 #define ATT_FIND_BY_TYPE_VALUE_REQUEST  0x06
846 #define ATT_FIND_BY_TYPE_VALUE_RESPONSE 0x07
847 
848 #define ATT_READ_BY_TYPE_REQUEST        0x08
849 #define ATT_READ_BY_TYPE_RESPONSE       0x09
850 #define ATT_READ_REQUEST                0x0a
851 #define ATT_READ_RESPONSE               0x0b
852 #define ATT_READ_BLOB_REQUEST           0x0c
853 #define ATT_READ_BLOB_RESPONSE          0x0d
854 #define ATT_READ_MULTIPLE_REQUEST       0x0e
855 #define ATT_READ_MULTIPLE_RESPONSE      0x0f
856 #define ATT_READ_BY_GROUP_TYPE_REQUEST  0x10
857 #define ATT_READ_BY_GROUP_TYPE_RESPONSE 0x11
858 
859 #define ATT_WRITE_REQUEST               0x12
860 #define ATT_WRITE_RESPONSE              0x13
861 
862 #define ATT_PREPARE_WRITE_REQUEST       0x16
863 #define ATT_PREPARE_WRITE_RESPONSE      0x17
864 #define ATT_EXECUTE_WRITE_REQUEST       0x18
865 #define ATT_EXECUTE_WRITE_RESPONSE      0x19
866 
867 #define ATT_HANDLE_VALUE_NOTIFICATION   0x1b
868 #define ATT_HANDLE_VALUE_INDICATION     0x1d
869 #define ATT_HANDLE_VALUE_CONFIRMATION   0x1e
870 
871 
872 #define ATT_WRITE_COMMAND                0x52
873 #define ATT_SIGNED_WRITE_COMMAND         0xD2
874 
875 // MARK: ATT Error Codes
876 #define ATT_ERROR_INVALID_HANDLE                   0x01
877 #define ATT_ERROR_READ_NOT_PERMITTED               0x02
878 #define ATT_ERROR_WRITE_NOT_PERMITTED              0x03
879 #define ATT_ERROR_INVALID_PDU                      0x04
880 #define ATT_ERROR_INSUFFICIENT_AUTHENTICATION      0x05
881 #define ATT_ERROR_REQUEST_NOT_SUPPORTED            0x06
882 #define ATT_ERROR_INVALID_OFFSET                   0x07
883 #define ATT_ERROR_INSUFFICIENT_AUTHORIZATION       0x08
884 #define ATT_ERROR_PREPARE_QUEUE_FULL               0x09
885 #define ATT_ERROR_ATTRIBUTE_NOT_FOUND              0x0a
886 #define ATT_ERROR_ATTRIBUTE_NOT_LONG               0x0b
887 #define ATT_ERROR_INSUFFICIENT_ENCRYPTION_KEY_SIZE 0x0c
888 #define ATT_ERROR_INVALID_ATTRIBUTE_VALUE_LENGTH   0x0d
889 #define ATT_ERROR_UNLIKELY_ERROR                   0x0e
890 #define ATT_ERROR_INSUFFICIENT_ENCRYPTION          0x0f
891 #define ATT_ERROR_UNSUPPORTED_GROUP_TYPE           0x10
892 #define ATT_ERROR_INSUFFICIENT_RESOURCES           0x11
893 
894 // MARK: Attribute Property Flags
895 #define ATT_PROPERTY_BROADCAST           0x01
896 #define ATT_PROPERTY_READ                0x02
897 #define ATT_PROPERTY_WRITE_WITHOUT_RESPONSE 0x04
898 #define ATT_PROPERTY_WRITE               0x08
899 #define ATT_PROPERTY_NOTIFY              0x10
900 #define ATT_PROPERTY_INDICATE            0x20
901 #define ATT_PROPERTY_AUTHENTICATED_SIGNED_WRITE 0x40
902 #define ATT_PROPERTY_EXTENDED_PROPERTIES 0x80
903 
904 // MARK: Attribute Property Flag, BTstack extension
905 // value is asked from client
906 #define ATT_PROPERTY_DYNAMIC             0x100
907 // 128 bit UUID used
908 #define ATT_PROPERTY_UUID128             0x200
909 // Authentication required
910 #define ATT_PROPERTY_AUTHENTICATION_REQUIRED 0x400
911 // Authorization from user required
912 #define ATT_PROPERTY_AUTHORIZATION_REQUIRED  0x800
913 // Encryption key size stored in upper 4 bits, 0 == no encryption, encryption key size - 1 otherwise
914 
915 // ATT Transaction Timeout of 30 seconds for Command/Response or Incidationc/Confirmation
916 #define ATT_TRANSACTION_TIMEOUT_MS     30000
917 
918 #define ATT_TRANSACTION_MODE_NONE      0x0
919 #define ATT_TRANSACTION_MODE_ACTIVE    0x1
920 #define ATT_TRANSACTION_MODE_EXECUTE   0x2
921 #define ATT_TRANSACTION_MODE_CANCEL    0x3
922 
923 // MARK: GATT UUIDs
924 #define GATT_PRIMARY_SERVICE_UUID                   0x2800
925 #define GATT_SECONDARY_SERVICE_UUID                 0x2801
926 #define GATT_INCLUDE_SERVICE_UUID                   0x2802
927 #define GATT_CHARACTERISTICS_UUID                   0x2803
928 #define GATT_CHARACTERISTIC_EXTENDED_PROPERTIES     0x2900
929 #define GATT_CHARACTERISTIC_USER_DESCRIPTION        0x2901
930 #define GATT_CLIENT_CHARACTERISTICS_CONFIGURATION   0x2902
931 #define GATT_SERVER_CHARACTERISTICS_CONFIGURATION   0x2903
932 #define GATT_CHARACTERISTIC_PRESENTATION_FORMAT     0x2904
933 #define GATT_CHARACTERISTIC_AGGREGATE_FORMAT        0x2905
934 
935 #define GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NONE          0
936 #define GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_NOTIFICATION  1
937 #define GATT_CLIENT_CHARACTERISTICS_CONFIGURATION_INDICATION    2
938 
939 // GAP Service and Characteristics
940 #define GAP_SERVICE_UUID               0x1800
941 #define GAP_DEVICE_NAME_UUID           0x2a00
942 #define GAP_APPEARANCE_UUID            0x2a01
943 #define GAP_PERIPHERAL_PRIVACY_FLAG    0x2a02
944 #define GAP_RECONNECTION_ADDRESS_UUID  0x2a03
945 #define GAP_PERIPHERAL_PREFERRED_CONNECTION_PARAMETERS_UUID 0x2a04
946 #define GAP_SERVICE_CHANGED            0x2a05
947 
948 /**
949  * SM - LE Security Manager
950  */
951 // Bluetooth Spec definitions
952 typedef enum {
953     SM_CODE_PAIRING_REQUEST = 0X01,
954     SM_CODE_PAIRING_RESPONSE,
955     SM_CODE_PAIRING_CONFIRM,
956     SM_CODE_PAIRING_RANDOM,
957     SM_CODE_PAIRING_FAILED,
958     SM_CODE_ENCRYPTION_INFORMATION,
959     SM_CODE_MASTER_IDENTIFICATION,
960     SM_CODE_IDENTITY_INFORMATION,
961     SM_CODE_IDENTITY_ADDRESS_INFORMATION,
962     SM_CODE_SIGNING_INFORMATION,
963     SM_CODE_SECURITY_REQUEST,
964     SM_CODE_PAIRING_PUBLIC_KEY,
965     SM_CODE_PAIRING_DHKEY_CHECK,
966     SM_CODE_KEYPRESS_NOTIFICATION,
967 } SECURITY_MANAGER_COMMANDS;
968 
969 // IO Capability Values
970 typedef enum {
971     IO_CAPABILITY_DISPLAY_ONLY = 0,
972     IO_CAPABILITY_DISPLAY_YES_NO,
973     IO_CAPABILITY_KEYBOARD_ONLY,
974     IO_CAPABILITY_NO_INPUT_NO_OUTPUT,
975     IO_CAPABILITY_KEYBOARD_DISPLAY, // not used by secure simple pairing
976 } io_capability_t;
977 
978 // Authentication requirement flags
979 #define SM_AUTHREQ_NO_BONDING        0x00
980 #define SM_AUTHREQ_BONDING           0x01
981 #define SM_AUTHREQ_MITM_PROTECTION   0x04
982 #define SM_AUTHREQ_SECURE_CONNECTION 0x08
983 #define SM_AUTHREQ_KEYPRESS          0x10
984 
985 // Key distribution flags used by spec
986 #define SM_KEYDIST_ENC_KEY  0x01
987 #define SM_KEYDIST_ID_KEY   0x02
988 #define SM_KEYDIST_SIGN     0x04
989 #define SM_KEYDIST_LINK_KEY 0x08
990 
991 // Key distribution flags used internally
992 #define SM_KEYDIST_FLAG_ENCRYPTION_INFORMATION       0x01
993 #define SM_KEYDIST_FLAG_MASTER_IDENTIFICATION        0x02
994 #define SM_KEYDIST_FLAG_IDENTITY_INFORMATION         0x04
995 #define SM_KEYDIST_FLAG_IDENTITY_ADDRESS_INFORMATION 0x08
996 #define SM_KEYDIST_FLAG_SIGNING_IDENTIFICATION       0x10
997 
998 // STK Generation Methods
999 #define SM_STK_GENERATION_METHOD_JUST_WORKS          0x01
1000 #define SM_STK_GENERATION_METHOD_OOB                 0x02
1001 #define SM_STK_GENERATION_METHOD_PASSKEY             0x04
1002 #define SM_STK_GENERATION_METHOD_NUMERIC_COMPARISON  0x08
1003 
1004 // Pairing Failed Reasons
1005 #define SM_REASON_RESERVED                     0x00
1006 #define SM_REASON_PASSKEYT_ENTRY_FAILED        0x01
1007 #define SM_REASON_OOB_NOT_AVAILABLE            0x02
1008 #define SM_REASON_AUTHENTHICATION_REQUIREMENTS 0x03
1009 #define SM_REASON_CONFIRM_VALUE_FAILED         0x04
1010 #define SM_REASON_PAIRING_NOT_SUPPORTED        0x05
1011 #define SM_REASON_ENCRYPTION_KEY_SIZE          0x06
1012 #define SM_REASON_COMMAND_NOT_SUPPORTED        0x07
1013 #define SM_REASON_UNSPECIFIED_REASON           0x08
1014 #define SM_REASON_REPEATED_ATTEMPTS            0x09
1015 #define SM_REASON_INVALID_PARAMETERS           0x0a
1016 #define SM_REASON_DHKEY_CHECK_FAILED           0x0b
1017 #define SM_REASON_NUMERIC_COMPARISON_FAILED    0x0c
1018 
1019 // also, invalid parameters
1020 // and reserved
1021 
1022 // Keypress Notifications
1023 #define SM_KEYPRESS_PASSKEY_ENTRY_STARTED      0x00
1024 #define SM_KEYPRESS_PASSKEY_DIGIT_ENTERED      0x01
1025 #define SM_KEYPRESS_PASSKEY_DIGIT_ERASED       0x02
1026 #define SM_KEYPRESS_PASSKEY_CLEARED            0x03
1027 #define SM_KEYPRESS_PASSKEY_ENTRY_COMPLETED    0x04
1028 
1029 
1030 // Company identifiers / manufacturers
1031 #define COMPANY_ID_CAMBRIDGE_SILICON_RADIO     0x000A
1032 #define COMPANY_ID_TEXAS_INSTRUMENTS_INC       0x000D
1033 #define COMPANY_ID_BROADCOM_CORPORATION        0x000F
1034 #define COMPANY_ID_ST_MICROELECTRONICS         0x0030
1035 #define COMPANY_ID_EM_MICROELECTRONICS_MARIN   0x005A
1036 
1037 
1038 #endif