include/net/bluetooth/mgmt.h

   1 /*
   2    BlueZ - Bluetooth protocol stack for Linux
   3
   4    Copyright (C) 2010  Nokia Corporation
   5    Copyright (C) 2011-2012  Intel Corporation
   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 #define MGMT_INDEX_NONE                 0xFFFF
  26
  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
  45 struct mgmt_hdr {
  46         __le16 opcode;
  47         __le16 index;
  48         __le16 len;
  49 } __packed;
  50
  51 struct mgmt_addr_info {
  52         bdaddr_t bdaddr;
  53         __u8 type;
  54 } __packed;
  55 #define MGMT_ADDR_INFO_SIZE             7
  56
  57 #define MGMT_OP_READ_VERSION            0x0001
  58 #define MGMT_READ_VERSION_SIZE          0
  59 struct mgmt_rp_read_version {
  60         __u8 version;
  61         __le16 revision;
  62 } __packed;
  63
  64 #define MGMT_OP_READ_COMMANDS           0x0002
  65 #define MGMT_READ_COMMANDS_SIZE         0
  66 struct mgmt_rp_read_commands {
  67         __le16 num_commands;
  68         __le16 num_events;
  69         __le16 opcodes[0];
  70 } __packed;
  71
  72 #define MGMT_OP_READ_INDEX_LIST         0x0003
  73 #define MGMT_READ_INDEX_LIST_SIZE       0
  74 struct mgmt_rp_read_index_list {
  75         __le16 num_controllers;
  76         __le16 index[0];
  77 } __packed;
  78
  79 /* Reserve one extra byte for names in management messages so that they
  80  * are always guaranteed to be nul-terminated */
  81 #define MGMT_MAX_NAME_LENGTH            (HCI_MAX_NAME_LENGTH + 1)
  82 #define MGMT_MAX_SHORT_NAME_LENGTH      (HCI_MAX_SHORT_NAME_LENGTH + 1)
  83
  84 #define MGMT_SETTING_POWERED            0x00000001
  85 #define MGMT_SETTING_CONNECTABLE        0x00000002
  86 #define MGMT_SETTING_FAST_CONNECTABLE   0x00000004
  87 #define MGMT_SETTING_DISCOVERABLE       0x00000008
  88 #define MGMT_SETTING_PAIRABLE           0x00000010
  89 #define MGMT_SETTING_LINK_SECURITY      0x00000020
  90 #define MGMT_SETTING_SSP                0x00000040
  91 #define MGMT_SETTING_BREDR              0x00000080
  92 #define MGMT_SETTING_HS                 0x00000100
  93 #define MGMT_SETTING_LE                 0x00000200
  94
  95 #define MGMT_OP_READ_INFO               0x0004
  96 #define MGMT_READ_INFO_SIZE             0
  97 struct mgmt_rp_read_info {
  98         bdaddr_t bdaddr;
  99         __u8 version;
 100         __le16 manufacturer;
 101         __le32 supported_settings;
 102         __le32 current_settings;
 103         __u8 dev_class[3];
 104         __u8 name[MGMT_MAX_NAME_LENGTH];
 105         __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
 106 } __packed;
 107
 108 struct mgmt_mode {
 109         __u8 val;
 110 } __packed;
 111
 112 #define MGMT_SETTING_SIZE               1
 113
 114 #define MGMT_OP_SET_POWERED             0x0005
 115
 116 #define MGMT_OP_SET_DISCOVERABLE        0x0006
 117 struct mgmt_cp_set_discoverable {
 118         __u8 val;
 119         __u16 timeout;
 120 } __packed;
 121 #define MGMT_SET_DISCOVERABLE_SIZE      3
 122
 123 #define MGMT_OP_SET_CONNECTABLE         0x0007
 124
 125 #define MGMT_OP_SET_FAST_CONNECTABLE    0x0008
 126
 127 #define MGMT_OP_SET_PAIRABLE            0x0009
 128
 129 #define MGMT_OP_SET_LINK_SECURITY       0x000A
 130
 131 #define MGMT_OP_SET_SSP                 0x000B
 132
 133 #define MGMT_OP_SET_HS                  0x000C
 134
 135 #define MGMT_OP_SET_LE                  0x000D
 136
 137 #define MGMT_OP_SET_DEV_CLASS           0x000E
 138 struct mgmt_cp_set_dev_class {
 139         __u8 major;
 140         __u8 minor;
 141 } __packed;
 142 #define MGMT_SET_DEV_CLASS_SIZE         2
 143
 144 #define MGMT_OP_SET_LOCAL_NAME          0x000F
 145 struct mgmt_cp_set_local_name {
 146         __u8 name[MGMT_MAX_NAME_LENGTH];
 147         __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
 148 } __packed;
 149 #define MGMT_SET_LOCAL_NAME_SIZE        260
 150
 151 #define MGMT_OP_ADD_UUID                0x0010
 152 struct mgmt_cp_add_uuid {
 153         __u8 uuid[16];
 154         __u8 svc_hint;
 155 } __packed;
 156 #define MGMT_ADD_UUID_SIZE              17
 157
 158 #define MGMT_OP_REMOVE_UUID             0x0011
 159 struct mgmt_cp_remove_uuid {
 160         __u8 uuid[16];
 161 } __packed;
 162 #define MGMT_REMOVE_UUID_SIZE           16
 163
 164 struct mgmt_link_key_info {
 165         struct mgmt_addr_info addr;
 166         u8 type;
 167         u8 val[16];
 168         u8 pin_len;
 169 } __packed;
 170
 171 #define MGMT_OP_LOAD_LINK_KEYS          0x0012
 172 struct mgmt_cp_load_link_keys {
 173         __u8 debug_keys;
 174         __le16 key_count;
 175         struct mgmt_link_key_info keys[0];
 176 } __packed;
 177 #define MGMT_LOAD_LINK_KEYS_SIZE        3
 178
 179 struct mgmt_ltk_info {
 180         struct mgmt_addr_info addr;
 181         __u8 authenticated;
 182         __u8 master;
 183         __u8 enc_size;
 184         __le16 ediv;
 185         __u8 rand[8];
 186         __u8 val[16];
 187 } __packed;
 188
 189 #define MGMT_OP_LOAD_LONG_TERM_KEYS     0x0013
 190 struct mgmt_cp_load_long_term_keys {
 191         __le16 key_count;
 192         struct mgmt_ltk_info keys[0];
 193 } __packed;
 194 #define MGMT_LOAD_LONG_TERM_KEYS_SIZE   2
 195
 196 #define MGMT_OP_DISCONNECT              0x0014
 197 struct mgmt_cp_disconnect {
 198         struct mgmt_addr_info addr;
 199 } __packed;
 200 #define MGMT_DISCONNECT_SIZE            MGMT_ADDR_INFO_SIZE
 201 struct mgmt_rp_disconnect {
 202         struct mgmt_addr_info addr;
 203 } __packed;
 204
 205 #define MGMT_OP_GET_CONNECTIONS         0x0015
 206 #define MGMT_GET_CONNECTIONS_SIZE       0
 207 struct mgmt_rp_get_connections {
 208         __le16 conn_count;
 209         struct mgmt_addr_info addr[0];
 210 } __packed;
 211
 212 #define MGMT_OP_PIN_CODE_REPLY          0x0016
 213 struct mgmt_cp_pin_code_reply {
 214         struct mgmt_addr_info addr;
 215         __u8 pin_len;
 216         __u8 pin_code[16];
 217 } __packed;
 218 #define MGMT_PIN_CODE_REPLY_SIZE        (MGMT_ADDR_INFO_SIZE + 17)
 219 struct mgmt_rp_pin_code_reply {
 220         struct mgmt_addr_info addr;
 221 } __packed;
 222
 223 #define MGMT_OP_PIN_CODE_NEG_REPLY      0x0017
 224 struct mgmt_cp_pin_code_neg_reply {
 225         struct mgmt_addr_info addr;
 226 } __packed;
 227 #define MGMT_PIN_CODE_NEG_REPLY_SIZE    MGMT_ADDR_INFO_SIZE
 228
 229 #define MGMT_OP_SET_IO_CAPABILITY       0x0018
 230 struct mgmt_cp_set_io_capability {
 231         __u8 io_capability;
 232 } __packed;
 233 #define MGMT_SET_IO_CAPABILITY_SIZE     1
 234
 235 #define MGMT_OP_PAIR_DEVICE             0x0019
 236 struct mgmt_cp_pair_device {
 237         struct mgmt_addr_info addr;
 238         __u8 io_cap;
 239 } __packed;
 240 #define MGMT_PAIR_DEVICE_SIZE           (MGMT_ADDR_INFO_SIZE + 1)
 241 struct mgmt_rp_pair_device {
 242         struct mgmt_addr_info addr;
 243 } __packed;
 244
 245 #define MGMT_OP_CANCEL_PAIR_DEVICE      0x001A
 246 #define MGMT_CANCEL_PAIR_DEVICE_SIZE    MGMT_ADDR_INFO_SIZE
 247
 248 #define MGMT_OP_UNPAIR_DEVICE           0x001B
 249 struct mgmt_cp_unpair_device {
 250         struct mgmt_addr_info addr;
 251         __u8 disconnect;
 252 } __packed;
 253 #define MGMT_UNPAIR_DEVICE_SIZE         (MGMT_ADDR_INFO_SIZE + 1)
 254 struct mgmt_rp_unpair_device {
 255         struct mgmt_addr_info addr;
 256 };
 257
 258 #define MGMT_OP_USER_CONFIRM_REPLY      0x001C
 259 struct mgmt_cp_user_confirm_reply {
 260         struct mgmt_addr_info addr;
 261 } __packed;
 262 #define MGMT_USER_CONFIRM_REPLY_SIZE    MGMT_ADDR_INFO_SIZE
 263 struct mgmt_rp_user_confirm_reply {
 264         struct mgmt_addr_info addr;
 265 } __packed;
 266
 267 #define MGMT_OP_USER_CONFIRM_NEG_REPLY  0x001D
 268 struct mgmt_cp_user_confirm_neg_reply {
 269         struct mgmt_addr_info addr;
 270 } __packed;
 271 #define MGMT_USER_CONFIRM_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
 272
 273 #define MGMT_OP_USER_PASSKEY_REPLY      0x001E
 274 struct mgmt_cp_user_passkey_reply {
 275         struct mgmt_addr_info addr;
 276         __le32 passkey;
 277 } __packed;
 278 #define MGMT_USER_PASSKEY_REPLY_SIZE    (MGMT_ADDR_INFO_SIZE + 4)
 279 struct mgmt_rp_user_passkey_reply {
 280         struct mgmt_addr_info addr;
 281 } __packed;
 282
 283 #define MGMT_OP_USER_PASSKEY_NEG_REPLY  0x001F
 284 struct mgmt_cp_user_passkey_neg_reply {
 285         struct mgmt_addr_info addr;
 286 } __packed;
 287 #define MGMT_USER_PASSKEY_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
 288
 289 #define MGMT_OP_READ_LOCAL_OOB_DATA     0x0020
 290 #define MGMT_READ_LOCAL_OOB_DATA_SIZE   0
 291 struct mgmt_rp_read_local_oob_data {
 292         __u8 hash[16];
 293         __u8 randomizer[16];
 294 } __packed;
 295
 296 #define MGMT_OP_ADD_REMOTE_OOB_DATA     0x0021
 297 struct mgmt_cp_add_remote_oob_data {
 298         struct mgmt_addr_info addr;
 299         __u8 hash[16];
 300         __u8 randomizer[16];
 301 } __packed;
 302 #define MGMT_ADD_REMOTE_OOB_DATA_SIZE   (MGMT_ADDR_INFO_SIZE + 32)
 303
 304 #define MGMT_OP_REMOVE_REMOTE_OOB_DATA  0x0022
 305 struct mgmt_cp_remove_remote_oob_data {
 306         struct mgmt_addr_info addr;
 307 } __packed;
 308 #define MGMT_REMOVE_REMOTE_OOB_DATA_SIZE MGMT_ADDR_INFO_SIZE
 309
 310 #define MGMT_OP_START_DISCOVERY         0x0023
 311 struct mgmt_cp_start_discovery {
 312         __u8 type;
 313 } __packed;
 314 #define MGMT_START_DISCOVERY_SIZE       1
 315
 316 #define MGMT_OP_STOP_DISCOVERY          0x0024
 317 struct mgmt_cp_stop_discovery {
 318         __u8 type;
 319 } __packed;
 320 #define MGMT_STOP_DISCOVERY_SIZE        1
 321
 322 #define MGMT_OP_CONFIRM_NAME            0x0025
 323 struct mgmt_cp_confirm_name {
 324         struct mgmt_addr_info addr;
 325         __u8 name_known;
 326 } __packed;
 327 #define MGMT_CONFIRM_NAME_SIZE          (MGMT_ADDR_INFO_SIZE + 1)
 328 struct mgmt_rp_confirm_name {
 329         struct mgmt_addr_info addr;
 330 } __packed;
 331
 332 #define MGMT_OP_BLOCK_DEVICE            0x0026
 333 struct mgmt_cp_block_device {
 334         struct mgmt_addr_info addr;
 335 } __packed;
 336 #define MGMT_BLOCK_DEVICE_SIZE          MGMT_ADDR_INFO_SIZE
 337
 338 #define MGMT_OP_UNBLOCK_DEVICE          0x0027
 339 struct mgmt_cp_unblock_device {
 340         struct mgmt_addr_info addr;
 341 } __packed;
 342 #define MGMT_UNBLOCK_DEVICE_SIZE        MGMT_ADDR_INFO_SIZE
 343
 344 #define MGMT_EV_CMD_COMPLETE            0x0001
 345 struct mgmt_ev_cmd_complete {
 346         __le16 opcode;
 347         __u8 status;
 348         __u8 data[0];
 349 } __packed;
 350
 351 #define MGMT_EV_CMD_STATUS              0x0002
 352 struct mgmt_ev_cmd_status {
 353         __le16 opcode;
 354         __u8 status;
 355 } __packed;
 356
 357 #define MGMT_EV_CONTROLLER_ERROR        0x0003
 358 struct mgmt_ev_controller_error {
 359         __u8 error_code;
 360 } __packed;
 361
 362 #define MGMT_EV_INDEX_ADDED             0x0004
 363
 364 #define MGMT_EV_INDEX_REMOVED           0x0005
 365
 366 #define MGMT_EV_NEW_SETTINGS            0x0006
 367
 368 #define MGMT_EV_CLASS_OF_DEV_CHANGED    0x0007
 369 struct mgmt_ev_class_of_dev_changed {
 370         __u8 dev_class[3];
 371 };
 372
 373 #define MGMT_EV_LOCAL_NAME_CHANGED      0x0008
 374 struct mgmt_ev_local_name_changed {
 375         __u8 name[MGMT_MAX_NAME_LENGTH];
 376         __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
 377 } __packed;
 378
 379 #define MGMT_EV_NEW_LINK_KEY            0x0009
 380 struct mgmt_ev_new_link_key {
 381         __u8 store_hint;
 382         struct mgmt_link_key_info key;
 383 } __packed;
 384
 385 #define MGMT_EV_NEW_LONG_TERM_KEY       0x000A
 386 struct mgmt_ev_new_long_term_key {
 387         __u8 store_hint;
 388         struct mgmt_ltk_info key;
 389 } __packed;
 390
 391 #define MGMT_EV_DEVICE_CONNECTED        0x000B
 392 struct mgmt_ev_device_connected {
 393         struct mgmt_addr_info addr;
 394         __le32 flags;
 395         __le16 eir_len;
 396         __u8 eir[0];
 397 } __packed;
 398
 399 #define MGMT_EV_DEVICE_DISCONNECTED     0x000C
 400
 401 #define MGMT_EV_CONNECT_FAILED          0x000D
 402 struct mgmt_ev_connect_failed {
 403         struct mgmt_addr_info addr;
 404         __u8 status;
 405 } __packed;
 406
 407 #define MGMT_EV_PIN_CODE_REQUEST        0x000E
 408 struct mgmt_ev_pin_code_request {
 409         struct mgmt_addr_info addr;
 410         __u8 secure;
 411 } __packed;
 412
 413 #define MGMT_EV_USER_CONFIRM_REQUEST    0x000F
 414 struct mgmt_ev_user_confirm_request {
 415         struct mgmt_addr_info addr;
 416         __u8 confirm_hint;
 417         __le32 value;
 418 } __packed;
 419
 420 #define MGMT_EV_USER_PASSKEY_REQUEST    0x0010
 421 struct mgmt_ev_user_passkey_request {
 422         struct mgmt_addr_info addr;
 423 } __packed;
 424
 425 #define MGMT_EV_AUTH_FAILED             0x0011
 426 struct mgmt_ev_auth_failed {
 427         struct mgmt_addr_info addr;
 428         __u8 status;
 429 } __packed;
 430
 431 #define MGMT_DEV_FOUND_CONFIRM_NAME    0x01
 432 #define MGMT_DEV_FOUND_LEGACY_PAIRING  0x02
 433
 434 #define MGMT_EV_DEVICE_FOUND            0x0012
 435 struct mgmt_ev_device_found {
 436         struct mgmt_addr_info addr;
 437         __s8 rssi;
 438         __u8 flags[4];
 439         __le16 eir_len;
 440         __u8 eir[0];
 441 } __packed;
 442
 443 #define MGMT_EV_DISCOVERING             0x0013
 444 struct mgmt_ev_discovering {
 445         __u8 type;
 446         __u8 discovering;
 447 } __packed;
 448
 449 #define MGMT_EV_DEVICE_BLOCKED          0x0014
 450 struct mgmt_ev_device_blocked {
 451         struct mgmt_addr_info addr;
 452 } __packed;
 453
 454 #define MGMT_EV_DEVICE_UNBLOCKED        0x0015
 455 struct mgmt_ev_device_unblocked {
 456         struct mgmt_addr_info addr;
 457 } __packed;
 458
 459 #define MGMT_EV_DEVICE_UNPAIRED         0x0016
 460 struct mgmt_ev_device_unpaired {
 461         struct mgmt_addr_info addr;
 462 } __packed;