1 /*
2 BlueZ - Bluetooth protocol stack for Linux
3 Copyright (C) 2000-2001 Qualcomm Incorporated
4
5 Written 2000,2001 by Maxim Krasnyansky <maxk@qualcomm.com>
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License version 2 as
9 published by the Free Software Foundation;
10
11 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
12 OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
13 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
14 IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
15 CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
16 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
17 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
18 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
19
20 ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
21 COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
22 SOFTWARE IS DISCLAIMED.
23 */
24
25 #ifndef __HCI_H
26 #define __HCI_H
27
28 #define HCI_MAX_ACL_SIZE 1024
29 #define HCI_MAX_SCO_SIZE 255
30 #define HCI_MAX_ISO_SIZE 251
31 #define HCI_MAX_EVENT_SIZE 260
32 #define HCI_MAX_FRAME_SIZE (HCI_MAX_ACL_SIZE + 4)
33
34 #define HCI_LINK_KEY_SIZE 16
35 #define HCI_AMP_LINK_KEY_SIZE (2 * HCI_LINK_KEY_SIZE)
36
37 #define HCI_MAX_AMP_ASSOC_SIZE 672
38
39 #define HCI_MAX_CSB_DATA_SIZE 252
40
41 /* HCI dev events */
42 #define HCI_DEV_REG 1
43 #define HCI_DEV_UNREG 2
44 #define HCI_DEV_UP 3
45 #define HCI_DEV_DOWN 4
46 #define HCI_DEV_SUSPEND 5
47 #define HCI_DEV_RESUME 6
48 #define HCI_DEV_OPEN 7
49 #define HCI_DEV_CLOSE 8
50 #define HCI_DEV_SETUP 9
51
52 /* HCI notify events */
53 #define HCI_NOTIFY_CONN_ADD 1
54 #define HCI_NOTIFY_CONN_DEL 2
55 #define HCI_NOTIFY_VOICE_SETTING 3
56 #define HCI_NOTIFY_ENABLE_SCO_CVSD 4
57 #define HCI_NOTIFY_ENABLE_SCO_TRANSP 5
58 #define HCI_NOTIFY_DISABLE_SCO 6
59
60 /* HCI bus types */
61 #define HCI_VIRTUAL 0
62 #define HCI_USB 1
63 #define HCI_PCCARD 2
64 #define HCI_UART 3
65 #define HCI_RS232 4
66 #define HCI_PCI 5
67 #define HCI_SDIO 6
68 #define HCI_SPI 7
69 #define HCI_I2C 8
70 #define HCI_SMD 9
71 #define HCI_VIRTIO 10
72
73 /* HCI controller types */
74 #define HCI_PRIMARY 0x00
75 #define HCI_AMP 0x01
76
77 /* First BR/EDR Controller shall have ID = 0 */
78 #define AMP_ID_BREDR 0x00
79
80 /* AMP controller types */
81 #define AMP_TYPE_BREDR 0x00
82 #define AMP_TYPE_80211 0x01
83
84 /* AMP controller status */
85 #define AMP_STATUS_POWERED_DOWN 0x00
86 #define AMP_STATUS_BLUETOOTH_ONLY 0x01
87 #define AMP_STATUS_NO_CAPACITY 0x02
88 #define AMP_STATUS_LOW_CAPACITY 0x03
89 #define AMP_STATUS_MEDIUM_CAPACITY 0x04
90 #define AMP_STATUS_HIGH_CAPACITY 0x05
91 #define AMP_STATUS_FULL_CAPACITY 0x06
92
93 /* HCI device quirks */
94 enum {
95 /* When this quirk is set, the HCI Reset command is send when
96 * closing the transport instead of when opening it.
97 *
98 * This quirk must be set before hci_register_dev is called.
99 */
100 HCI_QUIRK_RESET_ON_CLOSE,
101
102 /* When this quirk is set, the device is turned into a raw-only
103 * device and it will stay in unconfigured state.
104 *
105 * This quirk must be set before hci_register_dev is called.
106 */
107 HCI_QUIRK_RAW_DEVICE,
108
109 /* When this quirk is set, the buffer sizes reported by
110 * HCI Read Buffer Size command are corrected if invalid.
111 *
112 * This quirk must be set before hci_register_dev is called.
113 */
114 HCI_QUIRK_FIXUP_BUFFER_SIZE,
115
116 /* When this quirk is set, then a controller that does not
117 * indicate support for Inquiry Result with RSSI is assumed to
118 * support it anyway. Some early Bluetooth 1.2 controllers had
119 * wrongly configured local features that will require forcing
120 * them to enable this mode. Getting RSSI information with the
121 * inquiry responses is preferred since it allows for a better
122 * user experience.
123 *
124 * This quirk must be set before hci_register_dev is called.
125 */
126 HCI_QUIRK_FIXUP_INQUIRY_MODE,
127
128 /* When this quirk is set, then the HCI Read Local Supported
129 * Commands command is not supported. In general Bluetooth 1.2
130 * and later controllers should support this command. However
131 * some controllers indicate Bluetooth 1.2 support, but do
132 * not support this command.
133 *
134 * This quirk must be set before hci_register_dev is called.
135 */
136 HCI_QUIRK_BROKEN_LOCAL_COMMANDS,
137
138 /* When this quirk is set, then no stored link key handling
139 * is performed. This is mainly due to the fact that the
140 * HCI Delete Stored Link Key command is advertised, but
141 * not supported.
142 *
143 * This quirk must be set before hci_register_dev is called.
144 */
145 HCI_QUIRK_BROKEN_STORED_LINK_KEY,
146
147 /* When this quirk is set, an external configuration step
148 * is required and will be indicated with the controller
149 * configuration.
150 *
151 * This quirk can be set before hci_register_dev is called or
152 * during the hdev->setup vendor callback.
153 */
154 HCI_QUIRK_EXTERNAL_CONFIG,
155
156 /* When this quirk is set, the public Bluetooth address
157 * initially reported by HCI Read BD Address command
158 * is considered invalid. Controller configuration is
159 * required before this device can be used.
160 *
161 * This quirk can be set before hci_register_dev is called or
162 * during the hdev->setup vendor callback.
163 */
164 HCI_QUIRK_INVALID_BDADDR,
165
166 /* When this quirk is set, the public Bluetooth address
167 * initially reported by HCI Read BD Address command
168 * is considered invalid. The public BD Address can be
169 * specified in the fwnode property 'local-bd-address'.
170 * If this property does not exist or is invalid controller
171 * configuration is required before this device can be used.
172 *
173 * This quirk can be set before hci_register_dev is called or
174 * during the hdev->setup vendor callback.
175 */
176 HCI_QUIRK_USE_BDADDR_PROPERTY,
177
178 /* When this quirk is set, the duplicate filtering during
179 * scanning is based on Bluetooth devices addresses. To allow
180 * RSSI based updates, restart scanning if needed.
181 *
182 * This quirk can be set before hci_register_dev is called or
183 * during the hdev->setup vendor callback.
184 */
185 HCI_QUIRK_STRICT_DUPLICATE_FILTER,
186
187 /* When this quirk is set, LE scan and BR/EDR inquiry is done
188 * simultaneously, otherwise it's interleaved.
189 *
190 * This quirk can be set before hci_register_dev is called or
191 * during the hdev->setup vendor callback.
192 */
193 HCI_QUIRK_SIMULTANEOUS_DISCOVERY,
194
195 /* When this quirk is set, the enabling of diagnostic mode is
196 * not persistent over HCI Reset. Every time the controller
197 * is brought up it needs to be reprogrammed.
198 *
199 * This quirk can be set before hci_register_dev is called or
200 * during the hdev->setup vendor callback.
201 */
202 HCI_QUIRK_NON_PERSISTENT_DIAG,
203
204 /* When this quirk is set, setup() would be run after every
205 * open() and not just after the first open().
206 *
207 * This quirk can be set before hci_register_dev is called or
208 * during the hdev->setup vendor callback.
209 *
210 */
211 HCI_QUIRK_NON_PERSISTENT_SETUP,
212
213 /* When this quirk is set, wide band speech is supported by
214 * the driver since no reliable mechanism exist to report
215 * this from the hardware, a driver flag is use to convey
216 * this support
217 *
218 * This quirk must be set before hci_register_dev is called.
219 */
220 HCI_QUIRK_WIDEBAND_SPEECH_SUPPORTED,
221
222 /* When this quirk is set, the controller has validated that
223 * LE states reported through the HCI_LE_READ_SUPPORTED_STATES are
224 * valid. This mechanism is necessary as many controllers have
225 * been seen has having trouble initiating a connectable
226 * advertisement despite the state combination being reported as
227 * supported.
228 */
229 HCI_QUIRK_VALID_LE_STATES,
230
231 /* When this quirk is set, then erroneous data reporting
232 * is ignored. This is mainly due to the fact that the HCI
233 * Read Default Erroneous Data Reporting command is advertised,
234 * but not supported; these controllers often reply with unknown
235 * command and tend to lock up randomly. Needing a hard reset.
236 *
237 * This quirk can be set before hci_register_dev is called or
238 * during the hdev->setup vendor callback.
239 */
240 HCI_QUIRK_BROKEN_ERR_DATA_REPORTING,
241
242 /*
243 * When this quirk is set, then the hci_suspend_notifier is not
244 * registered. This is intended for devices which drop completely
245 * from the bus on system-suspend and which will show up as a new
246 * HCI after resume.
247 */
248 HCI_QUIRK_NO_SUSPEND_NOTIFIER,
249 };
250
251 /* HCI device flags */
252 enum {
253 HCI_UP,
254 HCI_INIT,
255 HCI_RUNNING,
256
257 HCI_PSCAN,
258 HCI_ISCAN,
259 HCI_AUTH,
260 HCI_ENCRYPT,
261 HCI_INQUIRY,
262
263 HCI_RAW,
264
265 HCI_RESET,
266 };
267
268 /* HCI socket flags */
269 enum {
270 HCI_SOCK_TRUSTED,
271 HCI_MGMT_INDEX_EVENTS,
272 HCI_MGMT_UNCONF_INDEX_EVENTS,
273 HCI_MGMT_EXT_INDEX_EVENTS,
274 HCI_MGMT_EXT_INFO_EVENTS,
275 HCI_MGMT_OPTION_EVENTS,
276 HCI_MGMT_SETTING_EVENTS,
277 HCI_MGMT_DEV_CLASS_EVENTS,
278 HCI_MGMT_LOCAL_NAME_EVENTS,
279 HCI_MGMT_OOB_DATA_EVENTS,
280 HCI_MGMT_EXP_FEATURE_EVENTS,
281 };
282
283 /*
284 * BR/EDR and/or LE controller flags: the flags defined here should represent
285 * states from the controller.
286 */
287 enum {
288 HCI_SETUP,
289 HCI_CONFIG,
290 HCI_AUTO_OFF,
291 HCI_RFKILLED,
292 HCI_MGMT,
293 HCI_BONDABLE,
294 HCI_SERVICE_CACHE,
295 HCI_KEEP_DEBUG_KEYS,
296 HCI_USE_DEBUG_KEYS,
297 HCI_UNREGISTER,
298 HCI_UNCONFIGURED,
299 HCI_USER_CHANNEL,
300 HCI_EXT_CONFIGURED,
301 HCI_LE_ADV,
302 HCI_LE_SCAN,
303 HCI_SSP_ENABLED,
304 HCI_SC_ENABLED,
305 HCI_SC_ONLY,
306 HCI_PRIVACY,
307 HCI_LIMITED_PRIVACY,
308 HCI_RPA_EXPIRED,
309 HCI_RPA_RESOLVING,
310 HCI_HS_ENABLED,
311 HCI_LE_ENABLED,
312 HCI_ADVERTISING,
313 HCI_ADVERTISING_CONNECTABLE,
314 HCI_CONNECTABLE,
315 HCI_DISCOVERABLE,
316 HCI_LIMITED_DISCOVERABLE,
317 HCI_LINK_SECURITY,
318 HCI_PERIODIC_INQ,
319 HCI_FAST_CONNECTABLE,
320 HCI_BREDR_ENABLED,
321 HCI_LE_SCAN_INTERRUPTED,
322 HCI_WIDEBAND_SPEECH_ENABLED,
323
324 HCI_DUT_MODE,
325 HCI_VENDOR_DIAG,
326 HCI_FORCE_BREDR_SMP,
327 HCI_FORCE_STATIC_ADDR,
328 HCI_LL_RPA_RESOLUTION,
329 HCI_ENABLE_LL_PRIVACY,
330 HCI_CMD_PENDING,
331 HCI_FORCE_NO_MITM,
332
333 __HCI_NUM_FLAGS,
334 };
335
336 /* HCI timeouts */
337 #define HCI_DISCONN_TIMEOUT msecs_to_jiffies(2000) /* 2 seconds */
338 #define HCI_PAIRING_TIMEOUT msecs_to_jiffies(60000) /* 60 seconds */
339 #define HCI_INIT_TIMEOUT msecs_to_jiffies(10000) /* 10 seconds */
340 #define HCI_CMD_TIMEOUT msecs_to_jiffies(2000) /* 2 seconds */
341 #define HCI_ACL_TX_TIMEOUT msecs_to_jiffies(45000) /* 45 seconds */
342 #define HCI_AUTO_OFF_TIMEOUT msecs_to_jiffies(2000) /* 2 seconds */
343 #define HCI_POWER_OFF_TIMEOUT msecs_to_jiffies(5000) /* 5 seconds */
344 #define HCI_LE_CONN_TIMEOUT msecs_to_jiffies(20000) /* 20 seconds */
345 #define HCI_LE_AUTOCONN_TIMEOUT msecs_to_jiffies(4000) /* 4 seconds */
346
347 /* HCI data types */
348 #define HCI_COMMAND_PKT 0x01
349 #define HCI_ACLDATA_PKT 0x02
350 #define HCI_SCODATA_PKT 0x03
351 #define HCI_EVENT_PKT 0x04
352 #define HCI_ISODATA_PKT 0x05
353 #define HCI_DIAG_PKT 0xf0
354 #define HCI_VENDOR_PKT 0xff
355
356 /* HCI packet types */
357 #define HCI_DM1 0x0008
358 #define HCI_DM3 0x0400
359 #define HCI_DM5 0x4000
360 #define HCI_DH1 0x0010
361 #define HCI_DH3 0x0800
362 #define HCI_DH5 0x8000
363
364 /* HCI packet types inverted masks */
365 #define HCI_2DH1 0x0002
366 #define HCI_3DH1 0x0004
367 #define HCI_2DH3 0x0100
368 #define HCI_3DH3 0x0200
369 #define HCI_2DH5 0x1000
370 #define HCI_3DH5 0x2000
371
372 #define HCI_HV1 0x0020
373 #define HCI_HV2 0x0040
374 #define HCI_HV3 0x0080
375
376 #define SCO_PTYPE_MASK (HCI_HV1 | HCI_HV2 | HCI_HV3)
377 #define ACL_PTYPE_MASK (~SCO_PTYPE_MASK)
378
379 /* eSCO packet types */
380 #define ESCO_HV1 0x0001
381 #define ESCO_HV2 0x0002
382 #define ESCO_HV3 0x0004
383 #define ESCO_EV3 0x0008
384 #define ESCO_EV4 0x0010
385 #define ESCO_EV5 0x0020
386 #define ESCO_2EV3 0x0040
387 #define ESCO_3EV3 0x0080
388 #define ESCO_2EV5 0x0100
389 #define ESCO_3EV5 0x0200
390
391 #define SCO_ESCO_MASK (ESCO_HV1 | ESCO_HV2 | ESCO_HV3)
392 #define EDR_ESCO_MASK (ESCO_2EV3 | ESCO_3EV3 | ESCO_2EV5 | ESCO_3EV5)
393
394 /* ACL flags */
395 #define ACL_START_NO_FLUSH 0x00
396 #define ACL_CONT 0x01
397 #define ACL_START 0x02
398 #define ACL_COMPLETE 0x03
399 #define ACL_ACTIVE_BCAST 0x04
400 #define ACL_PICO_BCAST 0x08
401
402 /* ISO PB flags */
403 #define ISO_START 0x00
404 #define ISO_CONT 0x01
405 #define ISO_SINGLE 0x02
406 #define ISO_END 0x03
407
408 /* ISO TS flags */
409 #define ISO_TS 0x01
410
411 /* Baseband links */
412 #define SCO_LINK 0x00
413 #define ACL_LINK 0x01
414 #define ESCO_LINK 0x02
415 /* Low Energy links do not have defined link type. Use invented one */
416 #define LE_LINK 0x80
417 #define AMP_LINK 0x81
418 #define ISO_LINK 0x82
419 #define INVALID_LINK 0xff
420
421 /* LMP features */
422 #define LMP_3SLOT 0x01
423 #define LMP_5SLOT 0x02
424 #define LMP_ENCRYPT 0x04
425 #define LMP_SOFFSET 0x08
426 #define LMP_TACCURACY 0x10
427 #define LMP_RSWITCH 0x20
428 #define LMP_HOLD 0x40
429 #define LMP_SNIFF 0x80
430
431 #define LMP_PARK 0x01
432 #define LMP_RSSI 0x02
433 #define LMP_QUALITY 0x04
434 #define LMP_SCO 0x08
435 #define LMP_HV2 0x10
436 #define LMP_HV3 0x20
437 #define LMP_ULAW 0x40
438 #define LMP_ALAW 0x80
439
440 #define LMP_CVSD 0x01
441 #define LMP_PSCHEME 0x02
442 #define LMP_PCONTROL 0x04
443 #define LMP_TRANSPARENT 0x08
444
445 #define LMP_EDR_2M 0x02
446 #define LMP_EDR_3M 0x04
447 #define LMP_RSSI_INQ 0x40
448 #define LMP_ESCO 0x80
449
450 #define LMP_EV4 0x01
451 #define LMP_EV5 0x02
452 #define LMP_NO_BREDR 0x20
453 #define LMP_LE 0x40
454 #define LMP_EDR_3SLOT 0x80
455
456 #define LMP_EDR_5SLOT 0x01
457 #define LMP_SNIFF_SUBR 0x02
458 #define LMP_PAUSE_ENC 0x04
459 #define LMP_EDR_ESCO_2M 0x20
460 #define LMP_EDR_ESCO_3M 0x40
461 #define LMP_EDR_3S_ESCO 0x80
462
463 #define LMP_EXT_INQ 0x01
464 #define LMP_SIMUL_LE_BR 0x02
465 #define LMP_SIMPLE_PAIR 0x08
466 #define LMP_NO_FLUSH 0x40
467
468 #define LMP_LSTO 0x01
469 #define LMP_INQ_TX_PWR 0x02
470 #define LMP_EXTFEATURES 0x80
471
472 /* Extended LMP features */
473 #define LMP_CSB_MASTER 0x01
474 #define LMP_CSB_SLAVE 0x02
475 #define LMP_SYNC_TRAIN 0x04
476 #define LMP_SYNC_SCAN 0x08
477
478 #define LMP_SC 0x01
479 #define LMP_PING 0x02
480
481 /* Host features */
482 #define LMP_HOST_SSP 0x01
483 #define LMP_HOST_LE 0x02
484 #define LMP_HOST_LE_BREDR 0x04
485 #define LMP_HOST_SC 0x08
486
487 /* LE features */
488 #define HCI_LE_ENCRYPTION 0x01
489 #define HCI_LE_CONN_PARAM_REQ_PROC 0x02
490 #define HCI_LE_SLAVE_FEATURES 0x08
491 #define HCI_LE_PING 0x10
492 #define HCI_LE_DATA_LEN_EXT 0x20
493 #define HCI_LE_LL_PRIVACY 0x40
494 #define HCI_LE_EXT_SCAN_POLICY 0x80
495 #define HCI_LE_PHY_2M 0x01
496 #define HCI_LE_PHY_CODED 0x08
497 #define HCI_LE_EXT_ADV 0x10
498 #define HCI_LE_CHAN_SEL_ALG2 0x40
499 #define HCI_LE_CIS_MASTER 0x10
500 #define HCI_LE_CIS_SLAVE 0x20
501
502 /* Connection modes */
503 #define HCI_CM_ACTIVE 0x0000
504 #define HCI_CM_HOLD 0x0001
505 #define HCI_CM_SNIFF 0x0002
506 #define HCI_CM_PARK 0x0003
507
508 /* Link policies */
509 #define HCI_LP_RSWITCH 0x0001
510 #define HCI_LP_HOLD 0x0002
511 #define HCI_LP_SNIFF 0x0004
512 #define HCI_LP_PARK 0x0008
513
514 /* Link modes */
515 #define HCI_LM_ACCEPT 0x8000
516 #define HCI_LM_MASTER 0x0001
517 #define HCI_LM_AUTH 0x0002
518 #define HCI_LM_ENCRYPT 0x0004
519 #define HCI_LM_TRUSTED 0x0008
520 #define HCI_LM_RELIABLE 0x0010
521 #define HCI_LM_SECURE 0x0020
522 #define HCI_LM_FIPS 0x0040
523
524 /* Authentication types */
525 #define HCI_AT_NO_BONDING 0x00
526 #define HCI_AT_NO_BONDING_MITM 0x01
527 #define HCI_AT_DEDICATED_BONDING 0x02
528 #define HCI_AT_DEDICATED_BONDING_MITM 0x03
529 #define HCI_AT_GENERAL_BONDING 0x04
530 #define HCI_AT_GENERAL_BONDING_MITM 0x05
531
532 /* I/O capabilities */
533 #define HCI_IO_DISPLAY_ONLY 0x00
534 #define HCI_IO_DISPLAY_YESNO 0x01
535 #define HCI_IO_KEYBOARD_ONLY 0x02
536 #define HCI_IO_NO_INPUT_OUTPUT 0x03
537
538 /* Link Key types */
539 #define HCI_LK_COMBINATION 0x00
540 #define HCI_LK_LOCAL_UNIT 0x01
541 #define HCI_LK_REMOTE_UNIT 0x02
542 #define HCI_LK_DEBUG_COMBINATION 0x03
543 #define HCI_LK_UNAUTH_COMBINATION_P192 0x04
544 #define HCI_LK_AUTH_COMBINATION_P192 0x05
545 #define HCI_LK_CHANGED_COMBINATION 0x06
546 #define HCI_LK_UNAUTH_COMBINATION_P256 0x07
547 #define HCI_LK_AUTH_COMBINATION_P256 0x08
548
549 /* ---- HCI Error Codes ---- */
550 #define HCI_ERROR_UNKNOWN_CONN_ID 0x02
551 #define HCI_ERROR_AUTH_FAILURE 0x05
552 #define HCI_ERROR_PIN_OR_KEY_MISSING 0x06
553 #define HCI_ERROR_MEMORY_EXCEEDED 0x07
554 #define HCI_ERROR_CONNECTION_TIMEOUT 0x08
555 #define HCI_ERROR_REJ_LIMITED_RESOURCES 0x0d
556 #define HCI_ERROR_REJ_BAD_ADDR 0x0f
557 #define HCI_ERROR_REMOTE_USER_TERM 0x13
558 #define HCI_ERROR_REMOTE_LOW_RESOURCES 0x14
559 #define HCI_ERROR_REMOTE_POWER_OFF 0x15
560 #define HCI_ERROR_LOCAL_HOST_TERM 0x16
561 #define HCI_ERROR_PAIRING_NOT_ALLOWED 0x18
562 #define HCI_ERROR_INVALID_LL_PARAMS 0x1e
563 #define HCI_ERROR_UNSPECIFIED 0x1f
564 #define HCI_ERROR_ADVERTISING_TIMEOUT 0x3c
565
566 /* Flow control modes */
567 #define HCI_FLOW_CTL_MODE_PACKET_BASED 0x00
568 #define HCI_FLOW_CTL_MODE_BLOCK_BASED 0x01
569
570 /* The core spec defines 127 as the "not available" value */
571 #define HCI_TX_POWER_INVALID 127
572 #define HCI_RSSI_INVALID 127
573
574 #define HCI_ROLE_MASTER 0x00
575 #define HCI_ROLE_SLAVE 0x01
576
577 /* Extended Inquiry Response field types */
578 #define EIR_FLAGS 0x01 /* flags */
579 #define EIR_UUID16_SOME 0x02 /* 16-bit UUID, more available */
580 #define EIR_UUID16_ALL 0x03 /* 16-bit UUID, all listed */
581 #define EIR_UUID32_SOME 0x04 /* 32-bit UUID, more available */
582 #define EIR_UUID32_ALL 0x05 /* 32-bit UUID, all listed */
583 #define EIR_UUID128_SOME 0x06 /* 128-bit UUID, more available */
584 #define EIR_UUID128_ALL 0x07 /* 128-bit UUID, all listed */
585 #define EIR_NAME_SHORT 0x08 /* shortened local name */
586 #define EIR_NAME_COMPLETE 0x09 /* complete local name */
587 #define EIR_TX_POWER 0x0A /* transmit power level */
588 #define EIR_CLASS_OF_DEV 0x0D /* Class of Device */
589 #define EIR_SSP_HASH_C192 0x0E /* Simple Pairing Hash C-192 */
590 #define EIR_SSP_RAND_R192 0x0F /* Simple Pairing Randomizer R-192 */
591 #define EIR_DEVICE_ID 0x10 /* device ID */
592 #define EIR_APPEARANCE 0x19 /* Device appearance */
593 #define EIR_LE_BDADDR 0x1B /* LE Bluetooth device address */
594 #define EIR_LE_ROLE 0x1C /* LE role */
595 #define EIR_SSP_HASH_C256 0x1D /* Simple Pairing Hash C-256 */
596 #define EIR_SSP_RAND_R256 0x1E /* Simple Pairing Rand R-256 */
597 #define EIR_LE_SC_CONFIRM 0x22 /* LE SC Confirmation Value */
598 #define EIR_LE_SC_RANDOM 0x23 /* LE SC Random Value */
599
600 /* Low Energy Advertising Flags */
601 #define LE_AD_LIMITED 0x01 /* Limited Discoverable */
602 #define LE_AD_GENERAL 0x02 /* General Discoverable */
603 #define LE_AD_NO_BREDR 0x04 /* BR/EDR not supported */
604 #define LE_AD_SIM_LE_BREDR_CTRL 0x08 /* Simultaneous LE & BR/EDR Controller */
605 #define LE_AD_SIM_LE_BREDR_HOST 0x10 /* Simultaneous LE & BR/EDR Host */
606
607 /* ----- HCI Commands ---- */
608 #define HCI_OP_NOP 0x0000
609
610 #define HCI_OP_INQUIRY 0x0401
611 struct hci_cp_inquiry {
612 __u8 lap[3];
613 __u8 length;
614 __u8 num_rsp;
615 } __packed;
616
617 #define HCI_OP_INQUIRY_CANCEL 0x0402
618
619 #define HCI_OP_PERIODIC_INQ 0x0403
620
621 #define HCI_OP_EXIT_PERIODIC_INQ 0x0404
622
623 #define HCI_OP_CREATE_CONN 0x0405
624 struct hci_cp_create_conn {
625 bdaddr_t bdaddr;
626 __le16 pkt_type;
627 __u8 pscan_rep_mode;
628 __u8 pscan_mode;
629 __le16 clock_offset;
630 __u8 role_switch;
631 } __packed;
632
633 #define HCI_OP_DISCONNECT 0x0406
634 struct hci_cp_disconnect {
635 __le16 handle;
636 __u8 reason;
637 } __packed;
638
639 #define HCI_OP_ADD_SCO 0x0407
640 struct hci_cp_add_sco {
641 __le16 handle;
642 __le16 pkt_type;
643 } __packed;
644
645 #define HCI_OP_CREATE_CONN_CANCEL 0x0408
646 struct hci_cp_create_conn_cancel {
647 bdaddr_t bdaddr;
648 } __packed;
649
650 #define HCI_OP_ACCEPT_CONN_REQ 0x0409
651 struct hci_cp_accept_conn_req {
652 bdaddr_t bdaddr;
653 __u8 role;
654 } __packed;
655
656 #define HCI_OP_REJECT_CONN_REQ 0x040a
657 struct hci_cp_reject_conn_req {
658 bdaddr_t bdaddr;
659 __u8 reason;
660 } __packed;
661
662 #define HCI_OP_LINK_KEY_REPLY 0x040b
663 struct hci_cp_link_key_reply {
664 bdaddr_t bdaddr;
665 __u8 link_key[HCI_LINK_KEY_SIZE];
666 } __packed;
667
668 #define HCI_OP_LINK_KEY_NEG_REPLY 0x040c
669 struct hci_cp_link_key_neg_reply {
670 bdaddr_t bdaddr;
671 } __packed;
672
673 #define HCI_OP_PIN_CODE_REPLY 0x040d
674 struct hci_cp_pin_code_reply {
675 bdaddr_t bdaddr;
676 __u8 pin_len;
677 __u8 pin_code[16];
678 } __packed;
679 struct hci_rp_pin_code_reply {
680 __u8 status;
681 bdaddr_t bdaddr;
682 } __packed;
683
684 #define HCI_OP_PIN_CODE_NEG_REPLY 0x040e
685 struct hci_cp_pin_code_neg_reply {
686 bdaddr_t bdaddr;
687 } __packed;
688 struct hci_rp_pin_code_neg_reply {
689 __u8 status;
690 bdaddr_t bdaddr;
691 } __packed;
692
693 #define HCI_OP_CHANGE_CONN_PTYPE 0x040f
694 struct hci_cp_change_conn_ptype {
695 __le16 handle;
696 __le16 pkt_type;
697 } __packed;
698
699 #define HCI_OP_AUTH_REQUESTED 0x0411
700 struct hci_cp_auth_requested {
701 __le16 handle;
702 } __packed;
703
704 #define HCI_OP_SET_CONN_ENCRYPT 0x0413
705 struct hci_cp_set_conn_encrypt {
706 __le16 handle;
707 __u8 encrypt;
708 } __packed;
709
710 #define HCI_OP_CHANGE_CONN_LINK_KEY 0x0415
711 struct hci_cp_change_conn_link_key {
712 __le16 handle;
713 } __packed;
714
715 #define HCI_OP_REMOTE_NAME_REQ 0x0419
716 struct hci_cp_remote_name_req {
717 bdaddr_t bdaddr;
718 __u8 pscan_rep_mode;
719 __u8 pscan_mode;
720 __le16 clock_offset;
721 } __packed;
722
723 #define HCI_OP_REMOTE_NAME_REQ_CANCEL 0x041a
724 struct hci_cp_remote_name_req_cancel {
725 bdaddr_t bdaddr;
726 } __packed;
727
728 #define HCI_OP_READ_REMOTE_FEATURES 0x041b
729 struct hci_cp_read_remote_features {
730 __le16 handle;
731 } __packed;
732
733 #define HCI_OP_READ_REMOTE_EXT_FEATURES 0x041c
734 struct hci_cp_read_remote_ext_features {
735 __le16 handle;
736 __u8 page;
737 } __packed;
738
739 #define HCI_OP_READ_REMOTE_VERSION 0x041d
740 struct hci_cp_read_remote_version {
741 __le16 handle;
742 } __packed;
743
744 #define HCI_OP_READ_CLOCK_OFFSET 0x041f
745 struct hci_cp_read_clock_offset {
746 __le16 handle;
747 } __packed;
748
749 #define HCI_OP_SETUP_SYNC_CONN 0x0428
750 struct hci_cp_setup_sync_conn {
751 __le16 handle;
752 __le32 tx_bandwidth;
753 __le32 rx_bandwidth;
754 __le16 max_latency;
755 __le16 voice_setting;
756 __u8 retrans_effort;
757 __le16 pkt_type;
758 } __packed;
759
760 #define HCI_OP_ACCEPT_SYNC_CONN_REQ 0x0429
761 struct hci_cp_accept_sync_conn_req {
762 bdaddr_t bdaddr;
763 __le32 tx_bandwidth;
764 __le32 rx_bandwidth;
765 __le16 max_latency;
766 __le16 content_format;
767 __u8 retrans_effort;
768 __le16 pkt_type;
769 } __packed;
770
771 #define HCI_OP_REJECT_SYNC_CONN_REQ 0x042a
772 struct hci_cp_reject_sync_conn_req {
773 bdaddr_t bdaddr;
774 __u8 reason;
775 } __packed;
776
777 #define HCI_OP_IO_CAPABILITY_REPLY 0x042b
778 struct hci_cp_io_capability_reply {
779 bdaddr_t bdaddr;
780 __u8 capability;
781 __u8 oob_data;
782 __u8 authentication;
783 } __packed;
784
785 #define HCI_OP_USER_CONFIRM_REPLY 0x042c
786 struct hci_cp_user_confirm_reply {
787 bdaddr_t bdaddr;
788 } __packed;
789 struct hci_rp_user_confirm_reply {
790 __u8 status;
791 bdaddr_t bdaddr;
792 } __packed;
793
794 #define HCI_OP_USER_CONFIRM_NEG_REPLY 0x042d
795
796 #define HCI_OP_USER_PASSKEY_REPLY 0x042e
797 struct hci_cp_user_passkey_reply {
798 bdaddr_t bdaddr;
799 __le32 passkey;
800 } __packed;
801
802 #define HCI_OP_USER_PASSKEY_NEG_REPLY 0x042f
803
804 #define HCI_OP_REMOTE_OOB_DATA_REPLY 0x0430
805 struct hci_cp_remote_oob_data_reply {
806 bdaddr_t bdaddr;
807 __u8 hash[16];
808 __u8 rand[16];
809 } __packed;
810
811 #define HCI_OP_REMOTE_OOB_DATA_NEG_REPLY 0x0433
812 struct hci_cp_remote_oob_data_neg_reply {
813 bdaddr_t bdaddr;
814 } __packed;
815
816 #define HCI_OP_IO_CAPABILITY_NEG_REPLY 0x0434
817 struct hci_cp_io_capability_neg_reply {
818 bdaddr_t bdaddr;
819 __u8 reason;
820 } __packed;
821
822 #define HCI_OP_CREATE_PHY_LINK 0x0435
823 struct hci_cp_create_phy_link {
824 __u8 phy_handle;
825 __u8 key_len;
826 __u8 key_type;
827 __u8 key[HCI_AMP_LINK_KEY_SIZE];
828 } __packed;
829
830 #define HCI_OP_ACCEPT_PHY_LINK 0x0436
831 struct hci_cp_accept_phy_link {
832 __u8 phy_handle;
833 __u8 key_len;
834 __u8 key_type;
835 __u8 key[HCI_AMP_LINK_KEY_SIZE];
836 } __packed;
837
838 #define HCI_OP_DISCONN_PHY_LINK 0x0437
839 struct hci_cp_disconn_phy_link {
840 __u8 phy_handle;
841 __u8 reason;
842 } __packed;
843
844 struct ext_flow_spec {
845 __u8 id;
846 __u8 stype;
847 __le16 msdu;
848 __le32 sdu_itime;
849 __le32 acc_lat;
850 __le32 flush_to;
851 } __packed;
852
853 #define HCI_OP_CREATE_LOGICAL_LINK 0x0438
854 #define HCI_OP_ACCEPT_LOGICAL_LINK 0x0439
855 struct hci_cp_create_accept_logical_link {
856 __u8 phy_handle;
857 struct ext_flow_spec tx_flow_spec;
858 struct ext_flow_spec rx_flow_spec;
859 } __packed;
860
861 #define HCI_OP_DISCONN_LOGICAL_LINK 0x043a
862 struct hci_cp_disconn_logical_link {
863 __le16 log_handle;
864 } __packed;
865
866 #define HCI_OP_LOGICAL_LINK_CANCEL 0x043b
867 struct hci_cp_logical_link_cancel {
868 __u8 phy_handle;
869 __u8 flow_spec_id;
870 } __packed;
871
872 struct hci_rp_logical_link_cancel {
873 __u8 status;
874 __u8 phy_handle;
875 __u8 flow_spec_id;
876 } __packed;
877
878 #define HCI_OP_SET_CSB 0x0441
879 struct hci_cp_set_csb {
880 __u8 enable;
881 __u8 lt_addr;
882 __u8 lpo_allowed;
883 __le16 packet_type;
884 __le16 interval_min;
885 __le16 interval_max;
886 __le16 csb_sv_tout;
887 } __packed;
888 struct hci_rp_set_csb {
889 __u8 status;
890 __u8 lt_addr;
891 __le16 interval;
892 } __packed;
893
894 #define HCI_OP_START_SYNC_TRAIN 0x0443
895
896 #define HCI_OP_REMOTE_OOB_EXT_DATA_REPLY 0x0445
897 struct hci_cp_remote_oob_ext_data_reply {
898 bdaddr_t bdaddr;
899 __u8 hash192[16];
900 __u8 rand192[16];
901 __u8 hash256[16];
902 __u8 rand256[16];
903 } __packed;
904
905 #define HCI_OP_SNIFF_MODE 0x0803
906 struct hci_cp_sniff_mode {
907 __le16 handle;
908 __le16 max_interval;
909 __le16 min_interval;
910 __le16 attempt;
911 __le16 timeout;
912 } __packed;
913
914 #define HCI_OP_EXIT_SNIFF_MODE 0x0804
915 struct hci_cp_exit_sniff_mode {
916 __le16 handle;
917 } __packed;
918
919 #define HCI_OP_ROLE_DISCOVERY 0x0809
920 struct hci_cp_role_discovery {
921 __le16 handle;
922 } __packed;
923 struct hci_rp_role_discovery {
924 __u8 status;
925 __le16 handle;
926 __u8 role;
927 } __packed;
928
929 #define HCI_OP_SWITCH_ROLE 0x080b
930 struct hci_cp_switch_role {
931 bdaddr_t bdaddr;
932 __u8 role;
933 } __packed;
934
935 #define HCI_OP_READ_LINK_POLICY 0x080c
936 struct hci_cp_read_link_policy {
937 __le16 handle;
938 } __packed;
939 struct hci_rp_read_link_policy {
940 __u8 status;
941 __le16 handle;
942 __le16 policy;
943 } __packed;
944
945 #define HCI_OP_WRITE_LINK_POLICY 0x080d
946 struct hci_cp_write_link_policy {
947 __le16 handle;
948 __le16 policy;
949 } __packed;
950 struct hci_rp_write_link_policy {
951 __u8 status;
952 __le16 handle;
953 } __packed;
954
955 #define HCI_OP_READ_DEF_LINK_POLICY 0x080e
956 struct hci_rp_read_def_link_policy {
957 __u8 status;
958 __le16 policy;
959 } __packed;
960
961 #define HCI_OP_WRITE_DEF_LINK_POLICY 0x080f
962 struct hci_cp_write_def_link_policy {
963 __le16 policy;
964 } __packed;
965
966 #define HCI_OP_SNIFF_SUBRATE 0x0811
967 struct hci_cp_sniff_subrate {
968 __le16 handle;
969 __le16 max_latency;
970 __le16 min_remote_timeout;
971 __le16 min_local_timeout;
972 } __packed;
973
974 #define HCI_OP_SET_EVENT_MASK 0x0c01
975
976 #define HCI_OP_RESET 0x0c03
977
978 #define HCI_OP_SET_EVENT_FLT 0x0c05
979 #define HCI_SET_EVENT_FLT_SIZE 9
980 struct hci_cp_set_event_filter {
981 __u8 flt_type;
982 __u8 cond_type;
983 struct {
984 bdaddr_t bdaddr;
985 __u8 auto_accept;
986 } __packed addr_conn_flt;
987 } __packed;
988
989 /* Filter types */
990 #define HCI_FLT_CLEAR_ALL 0x00
991 #define HCI_FLT_INQ_RESULT 0x01
992 #define HCI_FLT_CONN_SETUP 0x02
993
994 /* CONN_SETUP Condition types */
995 #define HCI_CONN_SETUP_ALLOW_ALL 0x00
996 #define HCI_CONN_SETUP_ALLOW_CLASS 0x01
997 #define HCI_CONN_SETUP_ALLOW_BDADDR 0x02
998
999 /* CONN_SETUP Conditions */
1000 #define HCI_CONN_SETUP_AUTO_OFF 0x01
1001 #define HCI_CONN_SETUP_AUTO_ON 0x02
1002 #define HCI_CONN_SETUP_AUTO_ON_WITH_RS 0x03
1003
1004 #define HCI_OP_READ_STORED_LINK_KEY 0x0c0d
1005 struct hci_cp_read_stored_link_key {
1006 bdaddr_t bdaddr;
1007 __u8 read_all;
1008 } __packed;
1009 struct hci_rp_read_stored_link_key {
1010 __u8 status;
1011 __u8 max_keys;
1012 __u8 num_keys;
1013 } __packed;
1014
1015 #define HCI_OP_DELETE_STORED_LINK_KEY 0x0c12
1016 struct hci_cp_delete_stored_link_key {
1017 bdaddr_t bdaddr;
1018 __u8 delete_all;
1019 } __packed;
1020 struct hci_rp_delete_stored_link_key {
1021 __u8 status;
1022 __u8 num_keys;
1023 } __packed;
1024
1025 #define HCI_MAX_NAME_LENGTH 248
1026
1027 #define HCI_OP_WRITE_LOCAL_NAME 0x0c13
1028 struct hci_cp_write_local_name {
1029 __u8 name[HCI_MAX_NAME_LENGTH];
1030 } __packed;
1031
1032 #define HCI_OP_READ_LOCAL_NAME 0x0c14
1033 struct hci_rp_read_local_name {
1034 __u8 status;
1035 __u8 name[HCI_MAX_NAME_LENGTH];
1036 } __packed;
1037
1038 #define HCI_OP_WRITE_CA_TIMEOUT 0x0c16
1039
1040 #define HCI_OP_WRITE_PG_TIMEOUT 0x0c18
1041
1042 #define HCI_OP_WRITE_SCAN_ENABLE 0x0c1a
1043 #define SCAN_DISABLED 0x00
1044 #define SCAN_INQUIRY 0x01
1045 #define SCAN_PAGE 0x02
1046
1047 #define HCI_OP_READ_AUTH_ENABLE 0x0c1f
1048
1049 #define HCI_OP_WRITE_AUTH_ENABLE 0x0c20
1050 #define AUTH_DISABLED 0x00
1051 #define AUTH_ENABLED 0x01
1052
1053 #define HCI_OP_READ_ENCRYPT_MODE 0x0c21
1054
1055 #define HCI_OP_WRITE_ENCRYPT_MODE 0x0c22
1056 #define ENCRYPT_DISABLED 0x00
1057 #define ENCRYPT_P2P 0x01
1058 #define ENCRYPT_BOTH 0x02
1059
1060 #define HCI_OP_READ_CLASS_OF_DEV 0x0c23
1061 struct hci_rp_read_class_of_dev {
1062 __u8 status;
1063 __u8 dev_class[3];
1064 } __packed;
1065
1066 #define HCI_OP_WRITE_CLASS_OF_DEV 0x0c24
1067 struct hci_cp_write_class_of_dev {
1068 __u8 dev_class[3];
1069 } __packed;
1070
1071 #define HCI_OP_READ_VOICE_SETTING 0x0c25
1072 struct hci_rp_read_voice_setting {
1073 __u8 status;
1074 __le16 voice_setting;
1075 } __packed;
1076
1077 #define HCI_OP_WRITE_VOICE_SETTING 0x0c26
1078 struct hci_cp_write_voice_setting {
1079 __le16 voice_setting;
1080 } __packed;
1081
1082 #define HCI_OP_HOST_BUFFER_SIZE 0x0c33
1083 struct hci_cp_host_buffer_size {
1084 __le16 acl_mtu;
1085 __u8 sco_mtu;
1086 __le16 acl_max_pkt;
1087 __le16 sco_max_pkt;
1088 } __packed;
1089
1090 #define HCI_OP_READ_NUM_SUPPORTED_IAC 0x0c38
1091 struct hci_rp_read_num_supported_iac {
1092 __u8 status;
1093 __u8 num_iac;
1094 } __packed;
1095
1096 #define HCI_OP_READ_CURRENT_IAC_LAP 0x0c39
1097
1098 #define HCI_OP_WRITE_CURRENT_IAC_LAP 0x0c3a
1099 struct hci_cp_write_current_iac_lap {
1100 __u8 num_iac;
1101 __u8 iac_lap[6];
1102 } __packed;
1103
1104 #define HCI_OP_WRITE_INQUIRY_MODE 0x0c45
1105
1106 #define HCI_MAX_EIR_LENGTH 240
1107
1108 #define HCI_OP_WRITE_EIR 0x0c52
1109 struct hci_cp_write_eir {
1110 __u8 fec;
1111 __u8 data[HCI_MAX_EIR_LENGTH];
1112 } __packed;
1113
1114 #define HCI_OP_READ_SSP_MODE 0x0c55
1115 struct hci_rp_read_ssp_mode {
1116 __u8 status;
1117 __u8 mode;
1118 } __packed;
1119
1120 #define HCI_OP_WRITE_SSP_MODE 0x0c56
1121 struct hci_cp_write_ssp_mode {
1122 __u8 mode;
1123 } __packed;
1124
1125 #define HCI_OP_READ_LOCAL_OOB_DATA 0x0c57
1126 struct hci_rp_read_local_oob_data {
1127 __u8 status;
1128 __u8 hash[16];
1129 __u8 rand[16];
1130 } __packed;
1131
1132 #define HCI_OP_READ_INQ_RSP_TX_POWER 0x0c58
1133 struct hci_rp_read_inq_rsp_tx_power {
1134 __u8 status;
1135 __s8 tx_power;
1136 } __packed;
1137
1138 #define HCI_OP_READ_DEF_ERR_DATA_REPORTING 0x0c5a
1139 #define ERR_DATA_REPORTING_DISABLED 0x00
1140 #define ERR_DATA_REPORTING_ENABLED 0x01
1141 struct hci_rp_read_def_err_data_reporting {
1142 __u8 status;
1143 __u8 err_data_reporting;
1144 } __packed;
1145
1146 #define HCI_OP_WRITE_DEF_ERR_DATA_REPORTING 0x0c5b
1147 struct hci_cp_write_def_err_data_reporting {
1148 __u8 err_data_reporting;
1149 } __packed;
1150
1151 #define HCI_OP_SET_EVENT_MASK_PAGE_2 0x0c63
1152
1153 #define HCI_OP_READ_LOCATION_DATA 0x0c64
1154
1155 #define HCI_OP_READ_FLOW_CONTROL_MODE 0x0c66
1156 struct hci_rp_read_flow_control_mode {
1157 __u8 status;
1158 __u8 mode;
1159 } __packed;
1160
1161 #define HCI_OP_WRITE_LE_HOST_SUPPORTED 0x0c6d
1162 struct hci_cp_write_le_host_supported {
1163 __u8 le;
1164 __u8 simul;
1165 } __packed;
1166
1167 #define HCI_OP_SET_RESERVED_LT_ADDR 0x0c74
1168 struct hci_cp_set_reserved_lt_addr {
1169 __u8 lt_addr;
1170 } __packed;
1171 struct hci_rp_set_reserved_lt_addr {
1172 __u8 status;
1173 __u8 lt_addr;
1174 } __packed;
1175
1176 #define HCI_OP_DELETE_RESERVED_LT_ADDR 0x0c75
1177 struct hci_cp_delete_reserved_lt_addr {
1178 __u8 lt_addr;
1179 } __packed;
1180 struct hci_rp_delete_reserved_lt_addr {
1181 __u8 status;
1182 __u8 lt_addr;
1183 } __packed;
1184
1185 #define HCI_OP_SET_CSB_DATA 0x0c76
1186 struct hci_cp_set_csb_data {
1187 __u8 lt_addr;
1188 __u8 fragment;
1189 __u8 data_length;
1190 __u8 data[HCI_MAX_CSB_DATA_SIZE];
1191 } __packed;
1192 struct hci_rp_set_csb_data {
1193 __u8 status;
1194 __u8 lt_addr;
1195 } __packed;
1196
1197 #define HCI_OP_READ_SYNC_TRAIN_PARAMS 0x0c77
1198
1199 #define HCI_OP_WRITE_SYNC_TRAIN_PARAMS 0x0c78
1200 struct hci_cp_write_sync_train_params {
1201 __le16 interval_min;
1202 __le16 interval_max;
1203 __le32 sync_train_tout;
1204 __u8 service_data;
1205 } __packed;
1206 struct hci_rp_write_sync_train_params {
1207 __u8 status;
1208 __le16 sync_train_int;
1209 } __packed;
1210
1211 #define HCI_OP_READ_SC_SUPPORT 0x0c79
1212 struct hci_rp_read_sc_support {
1213 __u8 status;
1214 __u8 support;
1215 } __packed;
1216
1217 #define HCI_OP_WRITE_SC_SUPPORT 0x0c7a
1218 struct hci_cp_write_sc_support {
1219 __u8 support;
1220 } __packed;
1221
1222 #define HCI_OP_READ_AUTH_PAYLOAD_TO 0x0c7b
1223 struct hci_cp_read_auth_payload_to {
1224 __le16 handle;
1225 } __packed;
1226 struct hci_rp_read_auth_payload_to {
1227 __u8 status;
1228 __le16 handle;
1229 __le16 timeout;
1230 } __packed;
1231
1232 #define HCI_OP_WRITE_AUTH_PAYLOAD_TO 0x0c7c
1233 struct hci_cp_write_auth_payload_to {
1234 __le16 handle;
1235 __le16 timeout;
1236 } __packed;
1237 struct hci_rp_write_auth_payload_to {
1238 __u8 status;
1239 __le16 handle;
1240 } __packed;
1241
1242 #define HCI_OP_READ_LOCAL_OOB_EXT_DATA 0x0c7d
1243 struct hci_rp_read_local_oob_ext_data {
1244 __u8 status;
1245 __u8 hash192[16];
1246 __u8 rand192[16];
1247 __u8 hash256[16];
1248 __u8 rand256[16];
1249 } __packed;
1250
1251 #define HCI_OP_READ_LOCAL_VERSION 0x1001
1252 struct hci_rp_read_local_version {
1253 __u8 status;
1254 __u8 hci_ver;
1255 __le16 hci_rev;
1256 __u8 lmp_ver;
1257 __le16 manufacturer;
1258 __le16 lmp_subver;
1259 } __packed;
1260
1261 #define HCI_OP_READ_LOCAL_COMMANDS 0x1002
1262 struct hci_rp_read_local_commands {
1263 __u8 status;
1264 __u8 commands[64];
1265 } __packed;
1266
1267 #define HCI_OP_READ_LOCAL_FEATURES 0x1003
1268 struct hci_rp_read_local_features {
1269 __u8 status;
1270 __u8 features[8];
1271 } __packed;
1272
1273 #define HCI_OP_READ_LOCAL_EXT_FEATURES 0x1004
1274 struct hci_cp_read_local_ext_features {
1275 __u8 page;
1276 } __packed;
1277 struct hci_rp_read_local_ext_features {
1278 __u8 status;
1279 __u8 page;
1280 __u8 max_page;
1281 __u8 features[8];
1282 } __packed;
1283
1284 #define HCI_OP_READ_BUFFER_SIZE 0x1005
1285 struct hci_rp_read_buffer_size {
1286 __u8 status;
1287 __le16 acl_mtu;
1288 __u8 sco_mtu;
1289 __le16 acl_max_pkt;
1290 __le16 sco_max_pkt;
1291 } __packed;
1292
1293 #define HCI_OP_READ_BD_ADDR 0x1009
1294 struct hci_rp_read_bd_addr {
1295 __u8 status;
1296 bdaddr_t bdaddr;
1297 } __packed;
1298
1299 #define HCI_OP_READ_DATA_BLOCK_SIZE 0x100a
1300 struct hci_rp_read_data_block_size {
1301 __u8 status;
1302 __le16 max_acl_len;
1303 __le16 block_len;
1304 __le16 num_blocks;
1305 } __packed;
1306
1307 #define HCI_OP_READ_LOCAL_CODECS 0x100b
1308
1309 #define HCI_OP_READ_LOCAL_PAIRING_OPTS 0x100c
1310 struct hci_rp_read_local_pairing_opts {
1311 __u8 status;
1312 __u8 pairing_opts;
1313 __u8 max_key_size;
1314 } __packed;
1315
1316 #define HCI_OP_READ_PAGE_SCAN_ACTIVITY 0x0c1b
1317 struct hci_rp_read_page_scan_activity {
1318 __u8 status;
1319 __le16 interval;
1320 __le16 window;
1321 } __packed;
1322
1323 #define HCI_OP_WRITE_PAGE_SCAN_ACTIVITY 0x0c1c
1324 struct hci_cp_write_page_scan_activity {
1325 __le16 interval;
1326 __le16 window;
1327 } __packed;
1328
1329 #define HCI_OP_READ_TX_POWER 0x0c2d
1330 struct hci_cp_read_tx_power {
1331 __le16 handle;
1332 __u8 type;
1333 } __packed;
1334 struct hci_rp_read_tx_power {
1335 __u8 status;
1336 __le16 handle;
1337 __s8 tx_power;
1338 } __packed;
1339
1340 #define HCI_OP_READ_PAGE_SCAN_TYPE 0x0c46
1341 struct hci_rp_read_page_scan_type {
1342 __u8 status;
1343 __u8 type;
1344 } __packed;
1345
1346 #define HCI_OP_WRITE_PAGE_SCAN_TYPE 0x0c47
1347 #define PAGE_SCAN_TYPE_STANDARD 0x00
1348 #define PAGE_SCAN_TYPE_INTERLACED 0x01
1349
1350 #define HCI_OP_READ_RSSI 0x1405
1351 struct hci_cp_read_rssi {
1352 __le16 handle;
1353 } __packed;
1354 struct hci_rp_read_rssi {
1355 __u8 status;
1356 __le16 handle;
1357 __s8 rssi;
1358 } __packed;
1359
1360 #define HCI_OP_READ_CLOCK 0x1407
1361 struct hci_cp_read_clock {
1362 __le16 handle;
1363 __u8 which;
1364 } __packed;
1365 struct hci_rp_read_clock {
1366 __u8 status;
1367 __le16 handle;
1368 __le32 clock;
1369 __le16 accuracy;
1370 } __packed;
1371
1372 #define HCI_OP_READ_ENC_KEY_SIZE 0x1408
1373 struct hci_cp_read_enc_key_size {
1374 __le16 handle;
1375 } __packed;
1376 struct hci_rp_read_enc_key_size {
1377 __u8 status;
1378 __le16 handle;
1379 __u8 key_size;
1380 } __packed;
1381
1382 #define HCI_OP_READ_LOCAL_AMP_INFO 0x1409
1383 struct hci_rp_read_local_amp_info {
1384 __u8 status;
1385 __u8 amp_status;
1386 __le32 total_bw;
1387 __le32 max_bw;
1388 __le32 min_latency;
1389 __le32 max_pdu;
1390 __u8 amp_type;
1391 __le16 pal_cap;
1392 __le16 max_assoc_size;
1393 __le32 max_flush_to;
1394 __le32 be_flush_to;
1395 } __packed;
1396
1397 #define HCI_OP_READ_LOCAL_AMP_ASSOC 0x140a
1398 struct hci_cp_read_local_amp_assoc {
1399 __u8 phy_handle;
1400 __le16 len_so_far;
1401 __le16 max_len;
1402 } __packed;
1403 struct hci_rp_read_local_amp_assoc {
1404 __u8 status;
1405 __u8 phy_handle;
1406 __le16 rem_len;
1407 __u8 frag[];
1408 } __packed;
1409
1410 #define HCI_OP_WRITE_REMOTE_AMP_ASSOC 0x140b
1411 struct hci_cp_write_remote_amp_assoc {
1412 __u8 phy_handle;
1413 __le16 len_so_far;
1414 __le16 rem_len;
1415 __u8 frag[];
1416 } __packed;
1417 struct hci_rp_write_remote_amp_assoc {
1418 __u8 status;
1419 __u8 phy_handle;
1420 } __packed;
1421
1422 #define HCI_OP_GET_MWS_TRANSPORT_CONFIG 0x140c
1423
1424 #define HCI_OP_ENABLE_DUT_MODE 0x1803
1425
1426 #define HCI_OP_WRITE_SSP_DEBUG_MODE 0x1804
1427
1428 #define HCI_OP_LE_SET_EVENT_MASK 0x2001
1429 struct hci_cp_le_set_event_mask {
1430 __u8 mask[8];
1431 } __packed;
1432
1433 #define HCI_OP_LE_READ_BUFFER_SIZE 0x2002
1434 struct hci_rp_le_read_buffer_size {
1435 __u8 status;
1436 __le16 le_mtu;
1437 __u8 le_max_pkt;
1438 } __packed;
1439
1440 #define HCI_OP_LE_READ_LOCAL_FEATURES 0x2003
1441 struct hci_rp_le_read_local_features {
1442 __u8 status;
1443 __u8 features[8];
1444 } __packed;
1445
1446 #define HCI_OP_LE_SET_RANDOM_ADDR 0x2005
1447
1448 #define HCI_OP_LE_SET_ADV_PARAM 0x2006
1449 struct hci_cp_le_set_adv_param {
1450 __le16 min_interval;
1451 __le16 max_interval;
1452 __u8 type;
1453 __u8 own_address_type;
1454 __u8 direct_addr_type;
1455 bdaddr_t direct_addr;
1456 __u8 channel_map;
1457 __u8 filter_policy;
1458 } __packed;
1459
1460 #define HCI_OP_LE_READ_ADV_TX_POWER 0x2007
1461 struct hci_rp_le_read_adv_tx_power {
1462 __u8 status;
1463 __s8 tx_power;
1464 } __packed;
1465
1466 #define HCI_MAX_AD_LENGTH 31
1467
1468 #define HCI_OP_LE_SET_ADV_DATA 0x2008
1469 struct hci_cp_le_set_adv_data {
1470 __u8 length;
1471 __u8 data[HCI_MAX_AD_LENGTH];
1472 } __packed;
1473
1474 #define HCI_OP_LE_SET_SCAN_RSP_DATA 0x2009
1475 struct hci_cp_le_set_scan_rsp_data {
1476 __u8 length;
1477 __u8 data[HCI_MAX_AD_LENGTH];
1478 } __packed;
1479
1480 #define HCI_OP_LE_SET_ADV_ENABLE 0x200a
1481
1482 #define LE_SCAN_PASSIVE 0x00
1483 #define LE_SCAN_ACTIVE 0x01
1484
1485 #define HCI_OP_LE_SET_SCAN_PARAM 0x200b
1486 struct hci_cp_le_set_scan_param {
1487 __u8 type;
1488 __le16 interval;
1489 __le16 window;
1490 __u8 own_address_type;
1491 __u8 filter_policy;
1492 } __packed;
1493
1494 #define LE_SCAN_DISABLE 0x00
1495 #define LE_SCAN_ENABLE 0x01
1496 #define LE_SCAN_FILTER_DUP_DISABLE 0x00
1497 #define LE_SCAN_FILTER_DUP_ENABLE 0x01
1498
1499 #define HCI_OP_LE_SET_SCAN_ENABLE 0x200c
1500 struct hci_cp_le_set_scan_enable {
1501 __u8 enable;
1502 __u8 filter_dup;
1503 } __packed;
1504
1505 #define HCI_LE_USE_PEER_ADDR 0x00
1506 #define HCI_LE_USE_ACCEPT_LIST 0x01
1507
1508 #define HCI_OP_LE_CREATE_CONN 0x200d
1509 struct hci_cp_le_create_conn {
1510 __le16 scan_interval;
1511 __le16 scan_window;
1512 __u8 filter_policy;
1513 __u8 peer_addr_type;
1514 bdaddr_t peer_addr;
1515 __u8 own_address_type;
1516 __le16 conn_interval_min;
1517 __le16 conn_interval_max;
1518 __le16 conn_latency;
1519 __le16 supervision_timeout;
1520 __le16 min_ce_len;
1521 __le16 max_ce_len;
1522 } __packed;
1523
1524 #define HCI_OP_LE_CREATE_CONN_CANCEL 0x200e
1525
1526 #define HCI_OP_LE_READ_ACCEPT_LIST_SIZE 0x200f
1527 struct hci_rp_le_read_accept_list_size {
1528 __u8 status;
1529 __u8 size;
1530 } __packed;
1531
1532 #define HCI_OP_LE_CLEAR_ACCEPT_LIST 0x2010
1533
1534 #define HCI_OP_LE_ADD_TO_ACCEPT_LIST 0x2011
1535 struct hci_cp_le_add_to_accept_list {
1536 __u8 bdaddr_type;
1537 bdaddr_t bdaddr;
1538 } __packed;
1539
1540 #define HCI_OP_LE_DEL_FROM_ACCEPT_LIST 0x2012
1541 struct hci_cp_le_del_from_accept_list {
1542 __u8 bdaddr_type;
1543 bdaddr_t bdaddr;
1544 } __packed;
1545
1546 #define HCI_OP_LE_CONN_UPDATE 0x2013
1547 struct hci_cp_le_conn_update {
1548 __le16 handle;
1549 __le16 conn_interval_min;
1550 __le16 conn_interval_max;
1551 __le16 conn_latency;
1552 __le16 supervision_timeout;
1553 __le16 min_ce_len;
1554 __le16 max_ce_len;
1555 } __packed;
1556
1557 #define HCI_OP_LE_READ_REMOTE_FEATURES 0x2016
1558 struct hci_cp_le_read_remote_features {
1559 __le16 handle;
1560 } __packed;
1561
1562 #define HCI_OP_LE_START_ENC 0x2019
1563 struct hci_cp_le_start_enc {
1564 __le16 handle;
1565 __le64 rand;
1566 __le16 ediv;
1567 __u8 ltk[16];
1568 } __packed;
1569
1570 #define HCI_OP_LE_LTK_REPLY 0x201a
1571 struct hci_cp_le_ltk_reply {
1572 __le16 handle;
1573 __u8 ltk[16];
1574 } __packed;
1575 struct hci_rp_le_ltk_reply {
1576 __u8 status;
1577 __le16 handle;
1578 } __packed;
1579
1580 #define HCI_OP_LE_LTK_NEG_REPLY 0x201b
1581 struct hci_cp_le_ltk_neg_reply {
1582 __le16 handle;
1583 } __packed;
1584 struct hci_rp_le_ltk_neg_reply {
1585 __u8 status;
1586 __le16 handle;
1587 } __packed;
1588
1589 #define HCI_OP_LE_READ_SUPPORTED_STATES 0x201c
1590 struct hci_rp_le_read_supported_states {
1591 __u8 status;
1592 __u8 le_states[8];
1593 } __packed;
1594
1595 #define HCI_OP_LE_CONN_PARAM_REQ_REPLY 0x2020
1596 struct hci_cp_le_conn_param_req_reply {
1597 __le16 handle;
1598 __le16 interval_min;
1599 __le16 interval_max;
1600 __le16 latency;
1601 __le16 timeout;
1602 __le16 min_ce_len;
1603 __le16 max_ce_len;
1604 } __packed;
1605
1606 #define HCI_OP_LE_CONN_PARAM_REQ_NEG_REPLY 0x2021
1607 struct hci_cp_le_conn_param_req_neg_reply {
1608 __le16 handle;
1609 __u8 reason;
1610 } __packed;
1611
1612 #define HCI_OP_LE_SET_DATA_LEN 0x2022
1613 struct hci_cp_le_set_data_len {
1614 __le16 handle;
1615 __le16 tx_len;
1616 __le16 tx_time;
1617 } __packed;
1618 struct hci_rp_le_set_data_len {
1619 __u8 status;
1620 __le16 handle;
1621 } __packed;
1622
1623 #define HCI_OP_LE_READ_DEF_DATA_LEN 0x2023
1624 struct hci_rp_le_read_def_data_len {
1625 __u8 status;
1626 __le16 tx_len;
1627 __le16 tx_time;
1628 } __packed;
1629
1630 #define HCI_OP_LE_WRITE_DEF_DATA_LEN 0x2024
1631 struct hci_cp_le_write_def_data_len {
1632 __le16 tx_len;
1633 __le16 tx_time;
1634 } __packed;
1635
1636 #define HCI_OP_LE_ADD_TO_RESOLV_LIST 0x2027
1637 struct hci_cp_le_add_to_resolv_list {
1638 __u8 bdaddr_type;
1639 bdaddr_t bdaddr;
1640 __u8 peer_irk[16];
1641 __u8 local_irk[16];
1642 } __packed;
1643
1644 #define HCI_OP_LE_DEL_FROM_RESOLV_LIST 0x2028
1645 struct hci_cp_le_del_from_resolv_list {
1646 __u8 bdaddr_type;
1647 bdaddr_t bdaddr;
1648 } __packed;
1649
1650 #define HCI_OP_LE_CLEAR_RESOLV_LIST 0x2029
1651
1652 #define HCI_OP_LE_READ_RESOLV_LIST_SIZE 0x202a
1653 struct hci_rp_le_read_resolv_list_size {
1654 __u8 status;
1655 __u8 size;
1656 } __packed;
1657
1658 #define HCI_OP_LE_SET_ADDR_RESOLV_ENABLE 0x202d
1659
1660 #define HCI_OP_LE_SET_RPA_TIMEOUT 0x202e
1661
1662 #define HCI_OP_LE_READ_MAX_DATA_LEN 0x202f
1663 struct hci_rp_le_read_max_data_len {
1664 __u8 status;
1665 __le16 tx_len;
1666 __le16 tx_time;
1667 __le16 rx_len;
1668 __le16 rx_time;
1669 } __packed;
1670
1671 #define HCI_OP_LE_SET_DEFAULT_PHY 0x2031
1672 struct hci_cp_le_set_default_phy {
1673 __u8 all_phys;
1674 __u8 tx_phys;
1675 __u8 rx_phys;
1676 } __packed;
1677
1678 #define HCI_LE_SET_PHY_1M 0x01
1679 #define HCI_LE_SET_PHY_2M 0x02
1680 #define HCI_LE_SET_PHY_CODED 0x04
1681
1682 #define HCI_OP_LE_SET_EXT_SCAN_PARAMS 0x2041
1683 struct hci_cp_le_set_ext_scan_params {
1684 __u8 own_addr_type;
1685 __u8 filter_policy;
1686 __u8 scanning_phys;
1687 __u8 data[];
1688 } __packed;
1689
1690 #define LE_SCAN_PHY_1M 0x01
1691 #define LE_SCAN_PHY_2M 0x02
1692 #define LE_SCAN_PHY_CODED 0x04
1693
1694 struct hci_cp_le_scan_phy_params {
1695 __u8 type;
1696 __le16 interval;
1697 __le16 window;
1698 } __packed;
1699
1700 #define HCI_OP_LE_SET_EXT_SCAN_ENABLE 0x2042
1701 struct hci_cp_le_set_ext_scan_enable {
1702 __u8 enable;
1703 __u8 filter_dup;
1704 __le16 duration;
1705 __le16 period;
1706 } __packed;
1707
1708 #define HCI_OP_LE_EXT_CREATE_CONN 0x2043
1709 struct hci_cp_le_ext_create_conn {
1710 __u8 filter_policy;
1711 __u8 own_addr_type;
1712 __u8 peer_addr_type;
1713 bdaddr_t peer_addr;
1714 __u8 phys;
1715 __u8 data[];
1716 } __packed;
1717
1718 struct hci_cp_le_ext_conn_param {
1719 __le16 scan_interval;
1720 __le16 scan_window;
1721 __le16 conn_interval_min;
1722 __le16 conn_interval_max;
1723 __le16 conn_latency;
1724 __le16 supervision_timeout;
1725 __le16 min_ce_len;
1726 __le16 max_ce_len;
1727 } __packed;
1728
1729 #define HCI_OP_LE_READ_NUM_SUPPORTED_ADV_SETS 0x203b
1730 struct hci_rp_le_read_num_supported_adv_sets {
1731 __u8 status;
1732 __u8 num_of_sets;
1733 } __packed;
1734
1735 #define HCI_OP_LE_SET_EXT_ADV_PARAMS 0x2036
1736 struct hci_cp_le_set_ext_adv_params {
1737 __u8 handle;
1738 __le16 evt_properties;
1739 __u8 min_interval[3];
1740 __u8 max_interval[3];
1741 __u8 channel_map;
1742 __u8 own_addr_type;
1743 __u8 peer_addr_type;
1744 bdaddr_t peer_addr;
1745 __u8 filter_policy;
1746 __u8 tx_power;
1747 __u8 primary_phy;
1748 __u8 secondary_max_skip;
1749 __u8 secondary_phy;
1750 __u8 sid;
1751 __u8 notif_enable;
1752 } __packed;
1753
1754 #define HCI_ADV_PHY_1M 0X01
1755 #define HCI_ADV_PHY_2M 0x02
1756 #define HCI_ADV_PHY_CODED 0x03
1757
1758 struct hci_rp_le_set_ext_adv_params {
1759 __u8 status;
1760 __u8 tx_power;
1761 } __packed;
1762
1763 #define HCI_OP_LE_SET_EXT_ADV_ENABLE 0x2039
1764 struct hci_cp_le_set_ext_adv_enable {
1765 __u8 enable;
1766 __u8 num_of_sets;
1767 __u8 data[];
1768 } __packed;
1769
1770 struct hci_cp_ext_adv_set {
1771 __u8 handle;
1772 __le16 duration;
1773 __u8 max_events;
1774 } __packed;
1775
1776 #define HCI_MAX_EXT_AD_LENGTH 251
1777
1778 #define HCI_OP_LE_SET_EXT_ADV_DATA 0x2037
1779 struct hci_cp_le_set_ext_adv_data {
1780 __u8 handle;
1781 __u8 operation;
1782 __u8 frag_pref;
1783 __u8 length;
1784 __u8 data[];
1785 } __packed;
1786
1787 #define HCI_OP_LE_SET_EXT_SCAN_RSP_DATA 0x2038
1788 struct hci_cp_le_set_ext_scan_rsp_data {
1789 __u8 handle;
1790 __u8 operation;
1791 __u8 frag_pref;
1792 __u8 length;
1793 __u8 data[];
1794 } __packed;
1795
1796 #define LE_SET_ADV_DATA_OP_COMPLETE 0x03
1797
1798 #define LE_SET_ADV_DATA_NO_FRAG 0x01
1799
1800 #define HCI_OP_LE_REMOVE_ADV_SET 0x203c
1801
1802 #define HCI_OP_LE_CLEAR_ADV_SETS 0x203d
1803
1804 #define HCI_OP_LE_SET_ADV_SET_RAND_ADDR 0x2035
1805 struct hci_cp_le_set_adv_set_rand_addr {
1806 __u8 handle;
1807 bdaddr_t bdaddr;
1808 } __packed;
1809
1810 #define HCI_OP_LE_READ_BUFFER_SIZE_V2 0x2060
1811 struct hci_rp_le_read_buffer_size_v2 {
1812 __u8 status;
1813 __le16 acl_mtu;
1814 __u8 acl_max_pkt;
1815 __le16 iso_mtu;
1816 __u8 iso_max_pkt;
1817 } __packed;
1818
1819 #define HCI_OP_LE_READ_ISO_TX_SYNC 0x2061
1820 struct hci_cp_le_read_iso_tx_sync {
1821 __le16 handle;
1822 } __packed;
1823
1824 struct hci_rp_le_read_iso_tx_sync {
1825 __u8 status;
1826 __le16 handle;
1827 __le16 seq;
1828 __le32 imestamp;
1829 __u8 offset[3];
1830 } __packed;
1831
1832 #define HCI_OP_LE_SET_CIG_PARAMS 0x2062
1833 struct hci_cis_params {
1834 __u8 cis_id;
1835 __le16 m_sdu;
1836 __le16 s_sdu;
1837 __u8 m_phy;
1838 __u8 s_phy;
1839 __u8 m_rtn;
1840 __u8 s_rtn;
1841 } __packed;
1842
1843 struct hci_cp_le_set_cig_params {
1844 __u8 cig_id;
1845 __u8 m_interval[3];
1846 __u8 s_interval[3];
1847 __u8 sca;
1848 __u8 packing;
1849 __u8 framing;
1850 __le16 m_latency;
1851 __le16 s_latency;
1852 __u8 num_cis;
1853 struct hci_cis_params cis[];
1854 } __packed;
1855
1856 struct hci_rp_le_set_cig_params {
1857 __u8 status;
1858 __u8 cig_id;
1859 __u8 num_handles;
1860 __le16 handle[];
1861 } __packed;
1862
1863 #define HCI_OP_LE_CREATE_CIS 0x2064
1864 struct hci_cis {
1865 __le16 cis_handle;
1866 __le16 acl_handle;
1867 } __packed;
1868
1869 struct hci_cp_le_create_cis {
1870 __u8 num_cis;
1871 struct hci_cis cis[];
1872 } __packed;
1873
1874 #define HCI_OP_LE_REMOVE_CIG 0x2065
1875 struct hci_cp_le_remove_cig {
1876 __u8 cig_id;
1877 } __packed;
1878
1879 #define HCI_OP_LE_ACCEPT_CIS 0x2066
1880 struct hci_cp_le_accept_cis {
1881 __le16 handle;
1882 } __packed;
1883
1884 #define HCI_OP_LE_REJECT_CIS 0x2067
1885 struct hci_cp_le_reject_cis {
1886 __le16 handle;
1887 __u8 reason;
1888 } __packed;
1889
1890 /* ---- HCI Events ---- */
1891 #define HCI_EV_INQUIRY_COMPLETE 0x01
1892
1893 #define HCI_EV_INQUIRY_RESULT 0x02
1894 struct inquiry_info {
1895 bdaddr_t bdaddr;
1896 __u8 pscan_rep_mode;
1897 __u8 pscan_period_mode;
1898 __u8 pscan_mode;
1899 __u8 dev_class[3];
1900 __le16 clock_offset;
1901 } __packed;
1902
1903 #define HCI_EV_CONN_COMPLETE 0x03
1904 struct hci_ev_conn_complete {
1905 __u8 status;
1906 __le16 handle;
1907 bdaddr_t bdaddr;
1908 __u8 link_type;
1909 __u8 encr_mode;
1910 } __packed;
1911
1912 #define HCI_EV_CONN_REQUEST 0x04
1913 struct hci_ev_conn_request {
1914 bdaddr_t bdaddr;
1915 __u8 dev_class[3];
1916 __u8 link_type;
1917 } __packed;
1918
1919 #define HCI_EV_DISCONN_COMPLETE 0x05
1920 struct hci_ev_disconn_complete {
1921 __u8 status;
1922 __le16 handle;
1923 __u8 reason;
1924 } __packed;
1925
1926 #define HCI_EV_AUTH_COMPLETE 0x06
1927 struct hci_ev_auth_complete {
1928 __u8 status;
1929 __le16 handle;
1930 } __packed;
1931
1932 #define HCI_EV_REMOTE_NAME 0x07
1933 struct hci_ev_remote_name {
1934 __u8 status;
1935 bdaddr_t bdaddr;
1936 __u8 name[HCI_MAX_NAME_LENGTH];
1937 } __packed;
1938
1939 #define HCI_EV_ENCRYPT_CHANGE 0x08
1940 struct hci_ev_encrypt_change {
1941 __u8 status;
1942 __le16 handle;
1943 __u8 encrypt;
1944 } __packed;
1945
1946 #define HCI_EV_CHANGE_LINK_KEY_COMPLETE 0x09
1947 struct hci_ev_change_link_key_complete {
1948 __u8 status;
1949 __le16 handle;
1950 } __packed;
1951
1952 #define HCI_EV_REMOTE_FEATURES 0x0b
1953 struct hci_ev_remote_features {
1954 __u8 status;
1955 __le16 handle;
1956 __u8 features[8];
1957 } __packed;
1958
1959 #define HCI_EV_REMOTE_VERSION 0x0c
1960 struct hci_ev_remote_version {
1961 __u8 status;
1962 __le16 handle;
1963 __u8 lmp_ver;
1964 __le16 manufacturer;
1965 __le16 lmp_subver;
1966 } __packed;
1967
1968 #define HCI_EV_QOS_SETUP_COMPLETE 0x0d
1969 struct hci_qos {
1970 __u8 service_type;
1971 __u32 token_rate;
1972 __u32 peak_bandwidth;
1973 __u32 latency;
1974 __u32 delay_variation;
1975 } __packed;
1976 struct hci_ev_qos_setup_complete {
1977 __u8 status;
1978 __le16 handle;
1979 struct hci_qos qos;
1980 } __packed;
1981
1982 #define HCI_EV_CMD_COMPLETE 0x0e
1983 struct hci_ev_cmd_complete {
1984 __u8 ncmd;
1985 __le16 opcode;
1986 } __packed;
1987
1988 #define HCI_EV_CMD_STATUS 0x0f
1989 struct hci_ev_cmd_status {
1990 __u8 status;
1991 __u8 ncmd;
1992 __le16 opcode;
1993 } __packed;
1994
1995 #define HCI_EV_HARDWARE_ERROR 0x10
1996 struct hci_ev_hardware_error {
1997 __u8 code;
1998 } __packed;
1999
2000 #define HCI_EV_ROLE_CHANGE 0x12
2001 struct hci_ev_role_change {
2002 __u8 status;
2003 bdaddr_t bdaddr;
2004 __u8 role;
2005 } __packed;
2006
2007 #define HCI_EV_NUM_COMP_PKTS 0x13
2008 struct hci_comp_pkts_info {
2009 __le16 handle;
2010 __le16 count;
2011 } __packed;
2012
2013 struct hci_ev_num_comp_pkts {
2014 __u8 num_hndl;
2015 struct hci_comp_pkts_info handles[];
2016 } __packed;
2017
2018 #define HCI_EV_MODE_CHANGE 0x14
2019 struct hci_ev_mode_change {
2020 __u8 status;
2021 __le16 handle;
2022 __u8 mode;
2023 __le16 interval;
2024 } __packed;
2025
2026 #define HCI_EV_PIN_CODE_REQ 0x16
2027 struct hci_ev_pin_code_req {
2028 bdaddr_t bdaddr;
2029 } __packed;
2030
2031 #define HCI_EV_LINK_KEY_REQ 0x17
2032 struct hci_ev_link_key_req {
2033 bdaddr_t bdaddr;
2034 } __packed;
2035
2036 #define HCI_EV_LINK_KEY_NOTIFY 0x18
2037 struct hci_ev_link_key_notify {
2038 bdaddr_t bdaddr;
2039 __u8 link_key[HCI_LINK_KEY_SIZE];
2040 __u8 key_type;
2041 } __packed;
2042
2043 #define HCI_EV_CLOCK_OFFSET 0x1c
2044 struct hci_ev_clock_offset {
2045 __u8 status;
2046 __le16 handle;
2047 __le16 clock_offset;
2048 } __packed;
2049
2050 #define HCI_EV_PKT_TYPE_CHANGE 0x1d
2051 struct hci_ev_pkt_type_change {
2052 __u8 status;
2053 __le16 handle;
2054 __le16 pkt_type;
2055 } __packed;
2056
2057 #define HCI_EV_PSCAN_REP_MODE 0x20
2058 struct hci_ev_pscan_rep_mode {
2059 bdaddr_t bdaddr;
2060 __u8 pscan_rep_mode;
2061 } __packed;
2062
2063 #define HCI_EV_INQUIRY_RESULT_WITH_RSSI 0x22
2064 struct inquiry_info_with_rssi {
2065 bdaddr_t bdaddr;
2066 __u8 pscan_rep_mode;
2067 __u8 pscan_period_mode;
2068 __u8 dev_class[3];
2069 __le16 clock_offset;
2070 __s8 rssi;
2071 } __packed;
2072 struct inquiry_info_with_rssi_and_pscan_mode {
2073 bdaddr_t bdaddr;
2074 __u8 pscan_rep_mode;
2075 __u8 pscan_period_mode;
2076 __u8 pscan_mode;
2077 __u8 dev_class[3];
2078 __le16 clock_offset;
2079 __s8 rssi;
2080 } __packed;
2081
2082 #define HCI_EV_REMOTE_EXT_FEATURES 0x23
2083 struct hci_ev_remote_ext_features {
2084 __u8 status;
2085 __le16 handle;
2086 __u8 page;
2087 __u8 max_page;
2088 __u8 features[8];
2089 } __packed;
2090
2091 #define HCI_EV_SYNC_CONN_COMPLETE 0x2c
2092 struct hci_ev_sync_conn_complete {
2093 __u8 status;
2094 __le16 handle;
2095 bdaddr_t bdaddr;
2096 __u8 link_type;
2097 __u8 tx_interval;
2098 __u8 retrans_window;
2099 __le16 rx_pkt_len;
2100 __le16 tx_pkt_len;
2101 __u8 air_mode;
2102 } __packed;
2103
2104 #define HCI_EV_SYNC_CONN_CHANGED 0x2d
2105 struct hci_ev_sync_conn_changed {
2106 __u8 status;
2107 __le16 handle;
2108 __u8 tx_interval;
2109 __u8 retrans_window;
2110 __le16 rx_pkt_len;
2111 __le16 tx_pkt_len;
2112 } __packed;
2113
2114 #define HCI_EV_SNIFF_SUBRATE 0x2e
2115 struct hci_ev_sniff_subrate {
2116 __u8 status;
2117 __le16 handle;
2118 __le16 max_tx_latency;
2119 __le16 max_rx_latency;
2120 __le16 max_remote_timeout;
2121 __le16 max_local_timeout;
2122 } __packed;
2123
2124 #define HCI_EV_EXTENDED_INQUIRY_RESULT 0x2f
2125 struct extended_inquiry_info {
2126 bdaddr_t bdaddr;
2127 __u8 pscan_rep_mode;
2128 __u8 pscan_period_mode;
2129 __u8 dev_class[3];
2130 __le16 clock_offset;
2131 __s8 rssi;
2132 __u8 data[240];
2133 } __packed;
2134
2135 #define HCI_EV_KEY_REFRESH_COMPLETE 0x30
2136 struct hci_ev_key_refresh_complete {
2137 __u8 status;
2138 __le16 handle;
2139 } __packed;
2140
2141 #define HCI_EV_IO_CAPA_REQUEST 0x31
2142 struct hci_ev_io_capa_request {
2143 bdaddr_t bdaddr;
2144 } __packed;
2145
2146 #define HCI_EV_IO_CAPA_REPLY 0x32
2147 struct hci_ev_io_capa_reply {
2148 bdaddr_t bdaddr;
2149 __u8 capability;
2150 __u8 oob_data;
2151 __u8 authentication;
2152 } __packed;
2153
2154 #define HCI_EV_USER_CONFIRM_REQUEST 0x33
2155 struct hci_ev_user_confirm_req {
2156 bdaddr_t bdaddr;
2157 __le32 passkey;
2158 } __packed;
2159
2160 #define HCI_EV_USER_PASSKEY_REQUEST 0x34
2161 struct hci_ev_user_passkey_req {
2162 bdaddr_t bdaddr;
2163 } __packed;
2164
2165 #define HCI_EV_REMOTE_OOB_DATA_REQUEST 0x35
2166 struct hci_ev_remote_oob_data_request {
2167 bdaddr_t bdaddr;
2168 } __packed;
2169
2170 #define HCI_EV_SIMPLE_PAIR_COMPLETE 0x36
2171 struct hci_ev_simple_pair_complete {
2172 __u8 status;
2173 bdaddr_t bdaddr;
2174 } __packed;
2175
2176 #define HCI_EV_USER_PASSKEY_NOTIFY 0x3b
2177 struct hci_ev_user_passkey_notify {
2178 bdaddr_t bdaddr;
2179 __le32 passkey;
2180 } __packed;
2181
2182 #define HCI_KEYPRESS_STARTED 0
2183 #define HCI_KEYPRESS_ENTERED 1
2184 #define HCI_KEYPRESS_ERASED 2
2185 #define HCI_KEYPRESS_CLEARED 3
2186 #define HCI_KEYPRESS_COMPLETED 4
2187
2188 #define HCI_EV_KEYPRESS_NOTIFY 0x3c
2189 struct hci_ev_keypress_notify {
2190 bdaddr_t bdaddr;
2191 __u8 type;
2192 } __packed;
2193
2194 #define HCI_EV_REMOTE_HOST_FEATURES 0x3d
2195 struct hci_ev_remote_host_features {
2196 bdaddr_t bdaddr;
2197 __u8 features[8];
2198 } __packed;
2199
2200 #define HCI_EV_LE_META 0x3e
2201 struct hci_ev_le_meta {
2202 __u8 subevent;
2203 } __packed;
2204
2205 #define HCI_EV_PHY_LINK_COMPLETE 0x40
2206 struct hci_ev_phy_link_complete {
2207 __u8 status;
2208 __u8 phy_handle;
2209 } __packed;
2210
2211 #define HCI_EV_CHANNEL_SELECTED 0x41
2212 struct hci_ev_channel_selected {
2213 __u8 phy_handle;
2214 } __packed;
2215
2216 #define HCI_EV_DISCONN_PHY_LINK_COMPLETE 0x42
2217 struct hci_ev_disconn_phy_link_complete {
2218 __u8 status;
2219 __u8 phy_handle;
2220 __u8 reason;
2221 } __packed;
2222
2223 #define HCI_EV_LOGICAL_LINK_COMPLETE 0x45
2224 struct hci_ev_logical_link_complete {
2225 __u8 status;
2226 __le16 handle;
2227 __u8 phy_handle;
2228 __u8 flow_spec_id;
2229 } __packed;
2230
2231 #define HCI_EV_DISCONN_LOGICAL_LINK_COMPLETE 0x46
2232 struct hci_ev_disconn_logical_link_complete {
2233 __u8 status;
2234 __le16 handle;
2235 __u8 reason;
2236 } __packed;
2237
2238 #define HCI_EV_NUM_COMP_BLOCKS 0x48
2239 struct hci_comp_blocks_info {
2240 __le16 handle;
2241 __le16 pkts;
2242 __le16 blocks;
2243 } __packed;
2244
2245 struct hci_ev_num_comp_blocks {
2246 __le16 num_blocks;
2247 __u8 num_hndl;
2248 struct hci_comp_blocks_info handles[];
2249 } __packed;
2250
2251 #define HCI_EV_SYNC_TRAIN_COMPLETE 0x4F
2252 struct hci_ev_sync_train_complete {
2253 __u8 status;
2254 } __packed;
2255
2256 #define HCI_EV_SLAVE_PAGE_RESP_TIMEOUT 0x54
2257
2258 #define HCI_EV_LE_CONN_COMPLETE 0x01
2259 struct hci_ev_le_conn_complete {
2260 __u8 status;
2261 __le16 handle;
2262 __u8 role;
2263 __u8 bdaddr_type;
2264 bdaddr_t bdaddr;
2265 __le16 interval;
2266 __le16 latency;
2267 __le16 supervision_timeout;
2268 __u8 clk_accurancy;
2269 } __packed;
2270
2271 /* Advertising report event types */
2272 #define LE_ADV_IND 0x00
2273 #define LE_ADV_DIRECT_IND 0x01
2274 #define LE_ADV_SCAN_IND 0x02
2275 #define LE_ADV_NONCONN_IND 0x03
2276 #define LE_ADV_SCAN_RSP 0x04
2277 #define LE_ADV_INVALID 0x05
2278
2279 /* Legacy event types in extended adv report */
2280 #define LE_LEGACY_ADV_IND 0x0013
2281 #define LE_LEGACY_ADV_DIRECT_IND 0x0015
2282 #define LE_LEGACY_ADV_SCAN_IND 0x0012
2283 #define LE_LEGACY_NONCONN_IND 0x0010
2284 #define LE_LEGACY_SCAN_RSP_ADV 0x001b
2285 #define LE_LEGACY_SCAN_RSP_ADV_SCAN 0x001a
2286
2287 /* Extended Advertising event types */
2288 #define LE_EXT_ADV_NON_CONN_IND 0x0000
2289 #define LE_EXT_ADV_CONN_IND 0x0001
2290 #define LE_EXT_ADV_SCAN_IND 0x0002
2291 #define LE_EXT_ADV_DIRECT_IND 0x0004
2292 #define LE_EXT_ADV_SCAN_RSP 0x0008
2293 #define LE_EXT_ADV_LEGACY_PDU 0x0010
2294
2295 #define ADDR_LE_DEV_PUBLIC 0x00
2296 #define ADDR_LE_DEV_RANDOM 0x01
2297 #define ADDR_LE_DEV_PUBLIC_RESOLVED 0x02
2298 #define ADDR_LE_DEV_RANDOM_RESOLVED 0x03
2299
2300 #define HCI_EV_LE_ADVERTISING_REPORT 0x02
2301 struct hci_ev_le_advertising_info {
2302 __u8 evt_type;
2303 __u8 bdaddr_type;
2304 bdaddr_t bdaddr;
2305 __u8 length;
2306 __u8 data[];
2307 } __packed;
2308
2309 #define HCI_EV_LE_CONN_UPDATE_COMPLETE 0x03
2310 struct hci_ev_le_conn_update_complete {
2311 __u8 status;
2312 __le16 handle;
2313 __le16 interval;
2314 __le16 latency;
2315 __le16 supervision_timeout;
2316 } __packed;
2317
2318 #define HCI_EV_LE_REMOTE_FEAT_COMPLETE 0x04
2319 struct hci_ev_le_remote_feat_complete {
2320 __u8 status;
2321 __le16 handle;
2322 __u8 features[8];
2323 } __packed;
2324
2325 #define HCI_EV_LE_LTK_REQ 0x05
2326 struct hci_ev_le_ltk_req {
2327 __le16 handle;
2328 __le64 rand;
2329 __le16 ediv;
2330 } __packed;
2331
2332 #define HCI_EV_LE_REMOTE_CONN_PARAM_REQ 0x06
2333 struct hci_ev_le_remote_conn_param_req {
2334 __le16 handle;
2335 __le16 interval_min;
2336 __le16 interval_max;
2337 __le16 latency;
2338 __le16 timeout;
2339 } __packed;
2340
2341 #define HCI_EV_LE_DATA_LEN_CHANGE 0x07
2342 struct hci_ev_le_data_len_change {
2343 __le16 handle;
2344 __le16 tx_len;
2345 __le16 tx_time;
2346 __le16 rx_len;
2347 __le16 rx_time;
2348 } __packed;
2349
2350 #define HCI_EV_LE_DIRECT_ADV_REPORT 0x0B
2351 struct hci_ev_le_direct_adv_info {
2352 __u8 evt_type;
2353 __u8 bdaddr_type;
2354 bdaddr_t bdaddr;
2355 __u8 direct_addr_type;
2356 bdaddr_t direct_addr;
2357 __s8 rssi;
2358 } __packed;
2359
2360 #define HCI_EV_LE_PHY_UPDATE_COMPLETE 0x0c
2361 struct hci_ev_le_phy_update_complete {
2362 __u8 status;
2363 __le16 handle;
2364 __u8 tx_phy;
2365 __u8 rx_phy;
2366 } __packed;
2367
2368 #define HCI_EV_LE_EXT_ADV_REPORT 0x0d
2369 struct hci_ev_le_ext_adv_report {
2370 __le16 evt_type;
2371 __u8 bdaddr_type;
2372 bdaddr_t bdaddr;
2373 __u8 primary_phy;
2374 __u8 secondary_phy;
2375 __u8 sid;
2376 __u8 tx_power;
2377 __s8 rssi;
2378 __le16 interval;
2379 __u8 direct_addr_type;
2380 bdaddr_t direct_addr;
2381 __u8 length;
2382 __u8 data[];
2383 } __packed;
2384
2385 #define HCI_EV_LE_ENHANCED_CONN_COMPLETE 0x0a
2386 struct hci_ev_le_enh_conn_complete {
2387 __u8 status;
2388 __le16 handle;
2389 __u8 role;
2390 __u8 bdaddr_type;
2391 bdaddr_t bdaddr;
2392 bdaddr_t local_rpa;
2393 bdaddr_t peer_rpa;
2394 __le16 interval;
2395 __le16 latency;
2396 __le16 supervision_timeout;
2397 __u8 clk_accurancy;
2398 } __packed;
2399
2400 #define HCI_EV_LE_EXT_ADV_SET_TERM 0x12
2401 struct hci_evt_le_ext_adv_set_term {
2402 __u8 status;
2403 __u8 handle;
2404 __le16 conn_handle;
2405 __u8 num_evts;
2406 } __packed;
2407
2408 #define HCI_EVT_LE_CIS_ESTABLISHED 0x19
2409 struct hci_evt_le_cis_established {
2410 __u8 status;
2411 __le16 handle;
2412 __u8 cig_sync_delay[3];
2413 __u8 cis_sync_delay[3];
2414 __u8 m_latency[3];
2415 __u8 s_latency[3];
2416 __u8 m_phy;
2417 __u8 s_phy;
2418 __u8 nse;
2419 __u8 m_bn;
2420 __u8 s_bn;
2421 __u8 m_ft;
2422 __u8 s_ft;
2423 __le16 m_mtu;
2424 __le16 s_mtu;
2425 __le16 interval;
2426 } __packed;
2427
2428 #define HCI_EVT_LE_CIS_REQ 0x1a
2429 struct hci_evt_le_cis_req {
2430 __le16 acl_handle;
2431 __le16 cis_handle;
2432 __u8 cig_id;
2433 __u8 cis_id;
2434 } __packed;
2435
2436 #define HCI_EV_VENDOR 0xff
2437
2438 /* Internal events generated by Bluetooth stack */
2439 #define HCI_EV_STACK_INTERNAL 0xfd
2440 struct hci_ev_stack_internal {
2441 __u16 type;
2442 __u8 data[];
2443 } __packed;
2444
2445 #define HCI_EV_SI_DEVICE 0x01
2446 struct hci_ev_si_device {
2447 __u16 event;
2448 __u16 dev_id;
2449 } __packed;
2450
2451 #define HCI_EV_SI_SECURITY 0x02
2452 struct hci_ev_si_security {
2453 __u16 event;
2454 __u16 proto;
2455 __u16 subproto;
2456 __u8 incoming;
2457 } __packed;
2458
2459 /* ---- HCI Packet structures ---- */
2460 #define HCI_COMMAND_HDR_SIZE 3
2461 #define HCI_EVENT_HDR_SIZE 2
2462 #define HCI_ACL_HDR_SIZE 4
2463 #define HCI_SCO_HDR_SIZE 3
2464 #define HCI_ISO_HDR_SIZE 4
2465
2466 struct hci_command_hdr {
2467 __le16 opcode; /* OCF & OGF */
2468 __u8 plen;
2469 } __packed;
2470
2471 struct hci_event_hdr {
2472 __u8 evt;
2473 __u8 plen;
2474 } __packed;
2475
2476 struct hci_acl_hdr {
2477 __le16 handle; /* Handle & Flags(PB, BC) */
2478 __le16 dlen;
2479 } __packed;
2480
2481 struct hci_sco_hdr {
2482 __le16 handle;
2483 __u8 dlen;
2484 } __packed;
2485
2486 struct hci_iso_hdr {
2487 __le16 handle;
2488 __le16 dlen;
2489 __u8 data[];
2490 } __packed;
2491
2492 /* ISO data packet status flags */
2493 #define HCI_ISO_STATUS_VALID 0x00
2494 #define HCI_ISO_STATUS_INVALID 0x01
2495 #define HCI_ISO_STATUS_NOP 0x02
2496
2497 #define HCI_ISO_DATA_HDR_SIZE 4
2498 struct hci_iso_data_hdr {
2499 __le16 sn;
2500 __le16 slen;
2501 };
2502
2503 #define HCI_ISO_TS_DATA_HDR_SIZE 8
2504 struct hci_iso_ts_data_hdr {
2505 __le32 ts;
2506 __le16 sn;
2507 __le16 slen;
2508 };
2509
hci_event_hdr(const struct sk_buff * skb)2510 static inline struct hci_event_hdr *hci_event_hdr(const struct sk_buff *skb)
2511 {
2512 return (struct hci_event_hdr *) skb->data;
2513 }
2514
hci_acl_hdr(const struct sk_buff * skb)2515 static inline struct hci_acl_hdr *hci_acl_hdr(const struct sk_buff *skb)
2516 {
2517 return (struct hci_acl_hdr *) skb->data;
2518 }
2519
hci_sco_hdr(const struct sk_buff * skb)2520 static inline struct hci_sco_hdr *hci_sco_hdr(const struct sk_buff *skb)
2521 {
2522 return (struct hci_sco_hdr *) skb->data;
2523 }
2524
2525 /* Command opcode pack/unpack */
2526 #define hci_opcode_pack(ogf, ocf) ((__u16) ((ocf & 0x03ff)|(ogf << 10)))
2527 #define hci_opcode_ogf(op) (op >> 10)
2528 #define hci_opcode_ocf(op) (op & 0x03ff)
2529
2530 /* ACL handle and flags pack/unpack */
2531 #define hci_handle_pack(h, f) ((__u16) ((h & 0x0fff)|(f << 12)))
2532 #define hci_handle(h) (h & 0x0fff)
2533 #define hci_flags(h) (h >> 12)
2534
2535 /* ISO handle and flags pack/unpack */
2536 #define hci_iso_flags_pb(f) (f & 0x0003)
2537 #define hci_iso_flags_ts(f) ((f >> 2) & 0x0001)
2538 #define hci_iso_flags_pack(pb, ts) ((pb & 0x03) | ((ts & 0x01) << 2))
2539
2540 /* ISO data length and flags pack/unpack */
2541 #define hci_iso_data_len_pack(h, f) ((__u16) ((h) | ((f) << 14)))
2542 #define hci_iso_data_len(h) ((h) & 0x3fff)
2543 #define hci_iso_data_flags(h) ((h) >> 14)
2544
2545 /* le24 support */
hci_cpu_to_le24(__u32 val,__u8 dst[3])2546 static inline void hci_cpu_to_le24(__u32 val, __u8 dst[3])
2547 {
2548 dst[0] = val & 0xff;
2549 dst[1] = (val & 0xff00) >> 8;
2550 dst[2] = (val & 0xff0000) >> 16;
2551 }
2552
2553 #endif /* __HCI_H */
2554