2 BlueZ - Bluetooth protocol stack for Linux
4 Copyright (C) 2010 Nokia Corporation
5 Copyright (C) 2011-2012 Intel Corporation
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;
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.
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.
25 #define MGMT_INDEX_NONE 0xFFFF
27 #define MGMT_STATUS_SUCCESS 0x00
28 #define MGMT_STATUS_UNKNOWN_COMMAND 0x01
29 #define MGMT_STATUS_NOT_CONNECTED 0x02
30 #define MGMT_STATUS_FAILED 0x03
31 #define MGMT_STATUS_CONNECT_FAILED 0x04
32 #define MGMT_STATUS_AUTH_FAILED 0x05
33 #define MGMT_STATUS_NOT_PAIRED 0x06
34 #define MGMT_STATUS_NO_RESOURCES 0x07
35 #define MGMT_STATUS_TIMEOUT 0x08
36 #define MGMT_STATUS_ALREADY_CONNECTED 0x09
37 #define MGMT_STATUS_BUSY 0x0a
38 #define MGMT_STATUS_REJECTED 0x0b
39 #define MGMT_STATUS_NOT_SUPPORTED 0x0c
40 #define MGMT_STATUS_INVALID_PARAMS 0x0d
41 #define MGMT_STATUS_DISCONNECTED 0x0e
42 #define MGMT_STATUS_NOT_POWERED 0x0f
43 #define MGMT_STATUS_CANCELLED 0x10
44 #define MGMT_STATUS_INVALID_INDEX 0x11
45 #define MGMT_STATUS_RFKILLED 0x12
53 struct mgmt_addr_info {
57 #define MGMT_ADDR_INFO_SIZE 7
59 #define MGMT_OP_READ_VERSION 0x0001
60 #define MGMT_READ_VERSION_SIZE 0
61 struct mgmt_rp_read_version {
66 #define MGMT_OP_READ_COMMANDS 0x0002
67 #define MGMT_READ_COMMANDS_SIZE 0
68 struct mgmt_rp_read_commands {
74 #define MGMT_OP_READ_INDEX_LIST 0x0003
75 #define MGMT_READ_INDEX_LIST_SIZE 0
76 struct mgmt_rp_read_index_list {
77 __le16 num_controllers;
81 /* Reserve one extra byte for names in management messages so that they
82 * are always guaranteed to be nul-terminated */
83 #define MGMT_MAX_NAME_LENGTH (HCI_MAX_NAME_LENGTH + 1)
84 #define MGMT_MAX_SHORT_NAME_LENGTH (HCI_MAX_SHORT_NAME_LENGTH + 1)
86 #define MGMT_SETTING_POWERED 0x00000001
87 #define MGMT_SETTING_CONNECTABLE 0x00000002
88 #define MGMT_SETTING_FAST_CONNECTABLE 0x00000004
89 #define MGMT_SETTING_DISCOVERABLE 0x00000008
90 #define MGMT_SETTING_BONDABLE 0x00000010
91 #define MGMT_SETTING_LINK_SECURITY 0x00000020
92 #define MGMT_SETTING_SSP 0x00000040
93 #define MGMT_SETTING_BREDR 0x00000080
94 #define MGMT_SETTING_HS 0x00000100
95 #define MGMT_SETTING_LE 0x00000200
96 #define MGMT_SETTING_ADVERTISING 0x00000400
97 #define MGMT_SETTING_SECURE_CONN 0x00000800
98 #define MGMT_SETTING_DEBUG_KEYS 0x00001000
99 #define MGMT_SETTING_PRIVACY 0x00002000
100 #define MGMT_SETTING_CONFIGURATION 0x00004000
102 #define MGMT_OP_READ_INFO 0x0004
103 #define MGMT_READ_INFO_SIZE 0
104 struct mgmt_rp_read_info {
108 __le32 supported_settings;
109 __le32 current_settings;
111 __u8 name[MGMT_MAX_NAME_LENGTH];
112 __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
119 #define MGMT_SETTING_SIZE 1
121 #define MGMT_OP_SET_POWERED 0x0005
123 #define MGMT_OP_SET_DISCOVERABLE 0x0006
124 struct mgmt_cp_set_discoverable {
128 #define MGMT_SET_DISCOVERABLE_SIZE 3
130 #define MGMT_OP_SET_CONNECTABLE 0x0007
132 #define MGMT_OP_SET_FAST_CONNECTABLE 0x0008
134 #define MGMT_OP_SET_BONDABLE 0x0009
136 #define MGMT_OP_SET_LINK_SECURITY 0x000A
138 #define MGMT_OP_SET_SSP 0x000B
140 #define MGMT_OP_SET_HS 0x000C
142 #define MGMT_OP_SET_LE 0x000D
143 #define MGMT_OP_SET_DEV_CLASS 0x000E
144 struct mgmt_cp_set_dev_class {
148 #define MGMT_SET_DEV_CLASS_SIZE 2
150 #define MGMT_OP_SET_LOCAL_NAME 0x000F
151 struct mgmt_cp_set_local_name {
152 __u8 name[MGMT_MAX_NAME_LENGTH];
153 __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
155 #define MGMT_SET_LOCAL_NAME_SIZE 260
157 #define MGMT_OP_ADD_UUID 0x0010
158 struct mgmt_cp_add_uuid {
162 #define MGMT_ADD_UUID_SIZE 17
164 #define MGMT_OP_REMOVE_UUID 0x0011
165 struct mgmt_cp_remove_uuid {
168 #define MGMT_REMOVE_UUID_SIZE 16
170 struct mgmt_link_key_info {
171 struct mgmt_addr_info addr;
177 #define MGMT_OP_LOAD_LINK_KEYS 0x0012
178 struct mgmt_cp_load_link_keys {
181 struct mgmt_link_key_info keys[0];
183 #define MGMT_LOAD_LINK_KEYS_SIZE 3
185 #define MGMT_LTK_UNAUTHENTICATED 0x00
186 #define MGMT_LTK_AUTHENTICATED 0x01
187 #define MGMT_LTK_P256_UNAUTH 0x02
188 #define MGMT_LTK_P256_AUTH 0x03
189 #define MGMT_LTK_P256_DEBUG 0x04
191 struct mgmt_ltk_info {
192 struct mgmt_addr_info addr;
201 #define MGMT_OP_LOAD_LONG_TERM_KEYS 0x0013
202 struct mgmt_cp_load_long_term_keys {
204 struct mgmt_ltk_info keys[0];
206 #define MGMT_LOAD_LONG_TERM_KEYS_SIZE 2
208 #define MGMT_OP_DISCONNECT 0x0014
209 struct mgmt_cp_disconnect {
210 struct mgmt_addr_info addr;
212 #define MGMT_DISCONNECT_SIZE MGMT_ADDR_INFO_SIZE
213 struct mgmt_rp_disconnect {
214 struct mgmt_addr_info addr;
217 #define MGMT_OP_GET_CONNECTIONS 0x0015
218 #define MGMT_GET_CONNECTIONS_SIZE 0
219 struct mgmt_rp_get_connections {
221 struct mgmt_addr_info addr[0];
224 #define MGMT_OP_PIN_CODE_REPLY 0x0016
225 struct mgmt_cp_pin_code_reply {
226 struct mgmt_addr_info addr;
230 #define MGMT_PIN_CODE_REPLY_SIZE (MGMT_ADDR_INFO_SIZE + 17)
231 struct mgmt_rp_pin_code_reply {
232 struct mgmt_addr_info addr;
235 #define MGMT_OP_PIN_CODE_NEG_REPLY 0x0017
236 struct mgmt_cp_pin_code_neg_reply {
237 struct mgmt_addr_info addr;
239 #define MGMT_PIN_CODE_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
241 #define MGMT_OP_SET_IO_CAPABILITY 0x0018
242 struct mgmt_cp_set_io_capability {
245 #define MGMT_SET_IO_CAPABILITY_SIZE 1
247 #define MGMT_OP_PAIR_DEVICE 0x0019
248 struct mgmt_cp_pair_device {
249 struct mgmt_addr_info addr;
252 #define MGMT_PAIR_DEVICE_SIZE (MGMT_ADDR_INFO_SIZE + 1)
253 struct mgmt_rp_pair_device {
254 struct mgmt_addr_info addr;
257 #define MGMT_OP_CANCEL_PAIR_DEVICE 0x001A
258 #define MGMT_CANCEL_PAIR_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
260 #define MGMT_OP_UNPAIR_DEVICE 0x001B
261 struct mgmt_cp_unpair_device {
262 struct mgmt_addr_info addr;
265 #define MGMT_UNPAIR_DEVICE_SIZE (MGMT_ADDR_INFO_SIZE + 1)
266 struct mgmt_rp_unpair_device {
267 struct mgmt_addr_info addr;
270 #define MGMT_OP_USER_CONFIRM_REPLY 0x001C
271 struct mgmt_cp_user_confirm_reply {
272 struct mgmt_addr_info addr;
274 #define MGMT_USER_CONFIRM_REPLY_SIZE MGMT_ADDR_INFO_SIZE
275 struct mgmt_rp_user_confirm_reply {
276 struct mgmt_addr_info addr;
279 #define MGMT_OP_USER_CONFIRM_NEG_REPLY 0x001D
280 struct mgmt_cp_user_confirm_neg_reply {
281 struct mgmt_addr_info addr;
283 #define MGMT_USER_CONFIRM_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
285 #define MGMT_OP_USER_PASSKEY_REPLY 0x001E
286 struct mgmt_cp_user_passkey_reply {
287 struct mgmt_addr_info addr;
290 #define MGMT_USER_PASSKEY_REPLY_SIZE (MGMT_ADDR_INFO_SIZE + 4)
291 struct mgmt_rp_user_passkey_reply {
292 struct mgmt_addr_info addr;
295 #define MGMT_OP_USER_PASSKEY_NEG_REPLY 0x001F
296 struct mgmt_cp_user_passkey_neg_reply {
297 struct mgmt_addr_info addr;
299 #define MGMT_USER_PASSKEY_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
301 #define MGMT_OP_READ_LOCAL_OOB_DATA 0x0020
302 #define MGMT_READ_LOCAL_OOB_DATA_SIZE 0
303 struct mgmt_rp_read_local_oob_data {
310 #define MGMT_OP_ADD_REMOTE_OOB_DATA 0x0021
311 struct mgmt_cp_add_remote_oob_data {
312 struct mgmt_addr_info addr;
316 #define MGMT_ADD_REMOTE_OOB_DATA_SIZE (MGMT_ADDR_INFO_SIZE + 32)
317 struct mgmt_cp_add_remote_oob_ext_data {
318 struct mgmt_addr_info addr;
324 #define MGMT_ADD_REMOTE_OOB_EXT_DATA_SIZE (MGMT_ADDR_INFO_SIZE + 64)
326 #define MGMT_OP_REMOVE_REMOTE_OOB_DATA 0x0022
327 struct mgmt_cp_remove_remote_oob_data {
328 struct mgmt_addr_info addr;
330 #define MGMT_REMOVE_REMOTE_OOB_DATA_SIZE MGMT_ADDR_INFO_SIZE
332 #define MGMT_OP_START_DISCOVERY 0x0023
333 struct mgmt_cp_start_discovery {
336 #define MGMT_START_DISCOVERY_SIZE 1
338 #define MGMT_OP_STOP_DISCOVERY 0x0024
339 struct mgmt_cp_stop_discovery {
342 #define MGMT_STOP_DISCOVERY_SIZE 1
344 #define MGMT_OP_CONFIRM_NAME 0x0025
345 struct mgmt_cp_confirm_name {
346 struct mgmt_addr_info addr;
349 #define MGMT_CONFIRM_NAME_SIZE (MGMT_ADDR_INFO_SIZE + 1)
350 struct mgmt_rp_confirm_name {
351 struct mgmt_addr_info addr;
354 #define MGMT_OP_BLOCK_DEVICE 0x0026
355 struct mgmt_cp_block_device {
356 struct mgmt_addr_info addr;
358 #define MGMT_BLOCK_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
360 #define MGMT_OP_UNBLOCK_DEVICE 0x0027
361 struct mgmt_cp_unblock_device {
362 struct mgmt_addr_info addr;
364 #define MGMT_UNBLOCK_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
366 #define MGMT_OP_SET_DEVICE_ID 0x0028
367 struct mgmt_cp_set_device_id {
373 #define MGMT_SET_DEVICE_ID_SIZE 8
375 #define MGMT_OP_SET_ADVERTISING 0x0029
377 #define MGMT_OP_SET_BREDR 0x002A
379 #define MGMT_OP_SET_STATIC_ADDRESS 0x002B
380 struct mgmt_cp_set_static_address {
383 #define MGMT_SET_STATIC_ADDRESS_SIZE 6
385 #define MGMT_OP_SET_SCAN_PARAMS 0x002C
386 struct mgmt_cp_set_scan_params {
390 #define MGMT_SET_SCAN_PARAMS_SIZE 4
392 #define MGMT_OP_SET_SECURE_CONN 0x002D
394 #define MGMT_OP_SET_DEBUG_KEYS 0x002E
396 #define MGMT_OP_SET_PRIVACY 0x002F
397 struct mgmt_cp_set_privacy {
401 #define MGMT_SET_PRIVACY_SIZE 17
403 struct mgmt_irk_info {
404 struct mgmt_addr_info addr;
408 #define MGMT_OP_LOAD_IRKS 0x0030
409 struct mgmt_cp_load_irks {
411 struct mgmt_irk_info irks[0];
413 #define MGMT_LOAD_IRKS_SIZE 2
415 #define MGMT_OP_GET_CONN_INFO 0x0031
416 struct mgmt_cp_get_conn_info {
417 struct mgmt_addr_info addr;
419 #define MGMT_GET_CONN_INFO_SIZE MGMT_ADDR_INFO_SIZE
420 struct mgmt_rp_get_conn_info {
421 struct mgmt_addr_info addr;
427 #define MGMT_OP_GET_CLOCK_INFO 0x0032
428 struct mgmt_cp_get_clock_info {
429 struct mgmt_addr_info addr;
431 #define MGMT_GET_CLOCK_INFO_SIZE MGMT_ADDR_INFO_SIZE
432 struct mgmt_rp_get_clock_info {
433 struct mgmt_addr_info addr;
435 __le32 piconet_clock;
439 #define MGMT_OP_ADD_DEVICE 0x0033
440 struct mgmt_cp_add_device {
441 struct mgmt_addr_info addr;
444 #define MGMT_ADD_DEVICE_SIZE (MGMT_ADDR_INFO_SIZE + 1)
446 #define MGMT_OP_REMOVE_DEVICE 0x0034
447 struct mgmt_cp_remove_device {
448 struct mgmt_addr_info addr;
450 #define MGMT_REMOVE_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
452 struct mgmt_conn_param {
453 struct mgmt_addr_info addr;
460 #define MGMT_OP_LOAD_CONN_PARAM 0x0035
461 struct mgmt_cp_load_conn_param {
463 struct mgmt_conn_param params[0];
465 #define MGMT_LOAD_CONN_PARAM_SIZE 2
467 #define MGMT_OP_READ_UNCONF_INDEX_LIST 0x0036
468 #define MGMT_READ_UNCONF_INDEX_LIST_SIZE 0
469 struct mgmt_rp_read_unconf_index_list {
470 __le16 num_controllers;
474 #define MGMT_OPTION_EXTERNAL_CONFIG 0x00000001
475 #define MGMT_OPTION_PUBLIC_ADDRESS 0x00000002
477 #define MGMT_OP_READ_CONFIG_INFO 0x0037
478 #define MGMT_READ_CONFIG_INFO_SIZE 0
479 struct mgmt_rp_read_config_info {
481 __le32 supported_options;
482 __le32 missing_options;
485 #define MGMT_OP_SET_EXTERNAL_CONFIG 0x0038
486 struct mgmt_cp_set_external_config {
489 #define MGMT_SET_EXTERNAL_CONFIG_SIZE 1
491 #define MGMT_OP_SET_PUBLIC_ADDRESS 0x0039
492 struct mgmt_cp_set_public_address {
495 #define MGMT_SET_PUBLIC_ADDRESS_SIZE 6
497 #define MGMT_OP_START_SERVICE_DISCOVERY 0x003A
498 struct mgmt_cp_start_service_discovery {
504 #define MGMT_START_SERVICE_DISCOVERY_SIZE 4
506 #define MGMT_EV_CMD_COMPLETE 0x0001
507 struct mgmt_ev_cmd_complete {
513 #define MGMT_EV_CMD_STATUS 0x0002
514 struct mgmt_ev_cmd_status {
519 #define MGMT_EV_CONTROLLER_ERROR 0x0003
520 struct mgmt_ev_controller_error {
524 #define MGMT_EV_INDEX_ADDED 0x0004
526 #define MGMT_EV_INDEX_REMOVED 0x0005
528 #define MGMT_EV_NEW_SETTINGS 0x0006
530 #define MGMT_EV_CLASS_OF_DEV_CHANGED 0x0007
531 struct mgmt_ev_class_of_dev_changed {
535 #define MGMT_EV_LOCAL_NAME_CHANGED 0x0008
536 struct mgmt_ev_local_name_changed {
537 __u8 name[MGMT_MAX_NAME_LENGTH];
538 __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
541 #define MGMT_EV_NEW_LINK_KEY 0x0009
542 struct mgmt_ev_new_link_key {
544 struct mgmt_link_key_info key;
547 #define MGMT_EV_NEW_LONG_TERM_KEY 0x000A
548 struct mgmt_ev_new_long_term_key {
550 struct mgmt_ltk_info key;
553 #define MGMT_EV_DEVICE_CONNECTED 0x000B
554 struct mgmt_ev_device_connected {
555 struct mgmt_addr_info addr;
561 #define MGMT_DEV_DISCONN_UNKNOWN 0x00
562 #define MGMT_DEV_DISCONN_TIMEOUT 0x01
563 #define MGMT_DEV_DISCONN_LOCAL_HOST 0x02
564 #define MGMT_DEV_DISCONN_REMOTE 0x03
566 #define MGMT_EV_DEVICE_DISCONNECTED 0x000C
567 struct mgmt_ev_device_disconnected {
568 struct mgmt_addr_info addr;
572 #define MGMT_EV_CONNECT_FAILED 0x000D
573 struct mgmt_ev_connect_failed {
574 struct mgmt_addr_info addr;
578 #define MGMT_EV_PIN_CODE_REQUEST 0x000E
579 struct mgmt_ev_pin_code_request {
580 struct mgmt_addr_info addr;
584 #define MGMT_EV_USER_CONFIRM_REQUEST 0x000F
585 struct mgmt_ev_user_confirm_request {
586 struct mgmt_addr_info addr;
591 #define MGMT_EV_USER_PASSKEY_REQUEST 0x0010
592 struct mgmt_ev_user_passkey_request {
593 struct mgmt_addr_info addr;
596 #define MGMT_EV_AUTH_FAILED 0x0011
597 struct mgmt_ev_auth_failed {
598 struct mgmt_addr_info addr;
602 #define MGMT_DEV_FOUND_CONFIRM_NAME 0x01
603 #define MGMT_DEV_FOUND_LEGACY_PAIRING 0x02
604 #define MGMT_DEV_FOUND_NOT_CONNECTABLE 0x04
606 #define MGMT_EV_DEVICE_FOUND 0x0012
607 struct mgmt_ev_device_found {
608 struct mgmt_addr_info addr;
615 #define MGMT_EV_DISCOVERING 0x0013
616 struct mgmt_ev_discovering {
621 #define MGMT_EV_DEVICE_BLOCKED 0x0014
622 struct mgmt_ev_device_blocked {
623 struct mgmt_addr_info addr;
626 #define MGMT_EV_DEVICE_UNBLOCKED 0x0015
627 struct mgmt_ev_device_unblocked {
628 struct mgmt_addr_info addr;
631 #define MGMT_EV_DEVICE_UNPAIRED 0x0016
632 struct mgmt_ev_device_unpaired {
633 struct mgmt_addr_info addr;
636 #define MGMT_EV_PASSKEY_NOTIFY 0x0017
637 struct mgmt_ev_passkey_notify {
638 struct mgmt_addr_info addr;
643 #define MGMT_EV_NEW_IRK 0x0018
644 struct mgmt_ev_new_irk {
647 struct mgmt_irk_info irk;
650 struct mgmt_csrk_info {
651 struct mgmt_addr_info addr;
656 #define MGMT_EV_NEW_CSRK 0x0019
657 struct mgmt_ev_new_csrk {
659 struct mgmt_csrk_info key;
662 #define MGMT_EV_DEVICE_ADDED 0x001a
663 struct mgmt_ev_device_added {
664 struct mgmt_addr_info addr;
668 #define MGMT_EV_DEVICE_REMOVED 0x001b
669 struct mgmt_ev_device_removed {
670 struct mgmt_addr_info addr;
673 #define MGMT_EV_NEW_CONN_PARAM 0x001c
674 struct mgmt_ev_new_conn_param {
675 struct mgmt_addr_info addr;
683 #define MGMT_EV_UNCONF_INDEX_ADDED 0x001d
685 #define MGMT_EV_UNCONF_INDEX_REMOVED 0x001e
687 #define MGMT_EV_NEW_CONFIG_OPTIONS 0x001f