mgmt.h 11.5 KB
Newer Older
1 2 3 4
/*
   BlueZ - Bluetooth protocol stack for Linux

   Copyright (C) 2010  Nokia Corporation
5
   Copyright (C) 2011-2012  Intel Corporation
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License version 2 as
   published by the Free Software Foundation;

   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
   OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
   FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS.
   IN NO EVENT SHALL THE COPYRIGHT HOLDER(S) AND AUTHOR(S) BE LIABLE FOR ANY
   CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES
   WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
   ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
   OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

   ALL LIABILITY, INCLUDING LIABILITY FOR INFRINGEMENT OF ANY PATENTS,
   COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS, RELATING TO USE OF THIS
   SOFTWARE IS DISCLAIMED.
*/

25 26
#define MGMT_INDEX_NONE			0xFFFF

27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
#define MGMT_STATUS_SUCCESS		0x00
#define MGMT_STATUS_UNKNOWN_COMMAND	0x01
#define MGMT_STATUS_NOT_CONNECTED	0x02
#define MGMT_STATUS_FAILED		0x03
#define MGMT_STATUS_CONNECT_FAILED	0x04
#define MGMT_STATUS_AUTH_FAILED		0x05
#define MGMT_STATUS_NOT_PAIRED		0x06
#define MGMT_STATUS_NO_RESOURCES	0x07
#define MGMT_STATUS_TIMEOUT		0x08
#define MGMT_STATUS_ALREADY_CONNECTED	0x09
#define MGMT_STATUS_BUSY		0x0a
#define MGMT_STATUS_REJECTED		0x0b
#define MGMT_STATUS_NOT_SUPPORTED	0x0c
#define MGMT_STATUS_INVALID_PARAMS	0x0d
#define MGMT_STATUS_DISCONNECTED	0x0e
#define MGMT_STATUS_NOT_POWERED		0x0f
43
#define MGMT_STATUS_CANCELLED		0x10
44
#define MGMT_STATUS_INVALID_INDEX	0x11
45

46 47
struct mgmt_hdr {
	__le16 opcode;
48
	__le16 index;
49 50 51
	__le16 len;
} __packed;

52 53 54 55
struct mgmt_addr_info {
	bdaddr_t bdaddr;
	__u8 type;
} __packed;
56
#define MGMT_ADDR_INFO_SIZE		7
57

58
#define MGMT_OP_READ_VERSION		0x0001
59
#define MGMT_READ_VERSION_SIZE		0
60 61 62 63 64
struct mgmt_rp_read_version {
	__u8 version;
	__le16 revision;
} __packed;

65
#define MGMT_OP_READ_COMMANDS		0x0002
66
#define MGMT_READ_COMMANDS_SIZE		0
67 68 69 70 71 72
struct mgmt_rp_read_commands {
	__le16 num_commands;
	__le16 num_events;
	__le16 opcodes[0];
} __packed;

73
#define MGMT_OP_READ_INDEX_LIST		0x0003
74
#define MGMT_READ_INDEX_LIST_SIZE	0
75 76 77 78 79
struct mgmt_rp_read_index_list {
	__le16 num_controllers;
	__le16 index[0];
} __packed;

80 81 82
/* Reserve one extra byte for names in management messages so that they
 * are always guaranteed to be nul-terminated */
#define MGMT_MAX_NAME_LENGTH		(HCI_MAX_NAME_LENGTH + 1)
83
#define MGMT_MAX_SHORT_NAME_LENGTH	(HCI_MAX_SHORT_NAME_LENGTH + 1)
84 85 86 87 88 89 90 91 92 93 94

#define MGMT_SETTING_POWERED		0x00000001
#define MGMT_SETTING_CONNECTABLE	0x00000002
#define MGMT_SETTING_FAST_CONNECTABLE	0x00000004
#define MGMT_SETTING_DISCOVERABLE	0x00000008
#define MGMT_SETTING_PAIRABLE		0x00000010
#define MGMT_SETTING_LINK_SECURITY	0x00000020
#define MGMT_SETTING_SSP		0x00000040
#define MGMT_SETTING_BREDR		0x00000080
#define MGMT_SETTING_HS			0x00000100
#define MGMT_SETTING_LE			0x00000200
95

96
#define MGMT_OP_READ_INFO		0x0004
97
#define MGMT_READ_INFO_SIZE		0
98 99
struct mgmt_rp_read_info {
	bdaddr_t bdaddr;
100 101 102 103
	__u8 version;
	__le16 manufacturer;
	__le32 supported_settings;
	__le32 current_settings;
104
	__u8 dev_class[3];
105
	__u8 name[MGMT_MAX_NAME_LENGTH];
106
	__u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
107 108
} __packed;

109 110
struct mgmt_mode {
	__u8 val;
111 112
} __packed;

113 114
#define MGMT_SETTING_SIZE		1

115 116
#define MGMT_OP_SET_POWERED		0x0005

117
#define MGMT_OP_SET_DISCOVERABLE	0x0006
118 119 120 121
struct mgmt_cp_set_discoverable {
	__u8 val;
	__u16 timeout;
} __packed;
122
#define MGMT_SET_DISCOVERABLE_SIZE	3
123

124 125
#define MGMT_OP_SET_CONNECTABLE		0x0007

126
#define MGMT_OP_SET_FAST_CONNECTABLE	0x0008
127

128
#define MGMT_OP_SET_PAIRABLE		0x0009
129

130 131 132 133 134 135 136 137 138 139 140 141 142
#define MGMT_OP_SET_LINK_SECURITY	0x000A

#define MGMT_OP_SET_SSP			0x000B

#define MGMT_OP_SET_HS			0x000C

#define MGMT_OP_SET_LE			0x000D

#define MGMT_OP_SET_DEV_CLASS		0x000E
struct mgmt_cp_set_dev_class {
	__u8 major;
	__u8 minor;
} __packed;
143
#define MGMT_SET_DEV_CLASS_SIZE		2
144 145 146 147

#define MGMT_OP_SET_LOCAL_NAME		0x000F
struct mgmt_cp_set_local_name {
	__u8 name[MGMT_MAX_NAME_LENGTH];
148
	__u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
149
} __packed;
150
#define MGMT_SET_LOCAL_NAME_SIZE	260
151 152

#define MGMT_OP_ADD_UUID		0x0010
153 154
struct mgmt_cp_add_uuid {
	__u8 uuid[16];
155
	__u8 svc_hint;
156
} __packed;
157
#define MGMT_ADD_UUID_SIZE		17
158

159
#define MGMT_OP_REMOVE_UUID		0x0011
160 161 162
struct mgmt_cp_remove_uuid {
	__u8 uuid[16];
} __packed;
163
#define MGMT_REMOVE_UUID_SIZE		16
164

165
struct mgmt_link_key_info {
166
	struct mgmt_addr_info addr;
167 168 169 170 171
	u8 type;
	u8 val[16];
	u8 pin_len;
} __packed;

172
#define MGMT_OP_LOAD_LINK_KEYS		0x0012
173
struct mgmt_cp_load_link_keys {
174 175
	__u8 debug_keys;
	__le16 key_count;
176
	struct mgmt_link_key_info keys[0];
177
} __packed;
178
#define MGMT_LOAD_LINK_KEYS_SIZE	3
179

180 181 182 183 184 185 186 187 188 189 190 191 192 193 194
struct mgmt_ltk_info {
	struct mgmt_addr_info addr;
	__u8 authenticated;
	__u8 master;
	__u8 enc_size;
	__le16 ediv;
	__u8 rand[8];
	__u8 val[16];
} __packed;

#define MGMT_OP_LOAD_LONG_TERM_KEYS	0x0013
struct mgmt_cp_load_long_term_keys {
	__le16 key_count;
	struct mgmt_ltk_info keys[0];
} __packed;
195
#define MGMT_LOAD_LONG_TERM_KEYS_SIZE	2
196

197
#define MGMT_OP_DISCONNECT		0x0014
198
struct mgmt_cp_disconnect {
199
	struct mgmt_addr_info addr;
200
} __packed;
201
#define MGMT_DISCONNECT_SIZE		MGMT_ADDR_INFO_SIZE
202
struct mgmt_rp_disconnect {
203
	struct mgmt_addr_info addr;
204
} __packed;
205

206
#define MGMT_OP_GET_CONNECTIONS		0x0015
207
#define MGMT_GET_CONNECTIONS_SIZE	0
208 209
struct mgmt_rp_get_connections {
	__le16 conn_count;
210
	struct mgmt_addr_info addr[0];
211 212
} __packed;

213
#define MGMT_OP_PIN_CODE_REPLY		0x0016
214
struct mgmt_cp_pin_code_reply {
215
	struct mgmt_addr_info addr;
216 217 218
	__u8 pin_len;
	__u8 pin_code[16];
} __packed;
219
#define MGMT_PIN_CODE_REPLY_SIZE	(MGMT_ADDR_INFO_SIZE + 17)
220
struct mgmt_rp_pin_code_reply {
221
	struct mgmt_addr_info addr;
222
} __packed;
223

224
#define MGMT_OP_PIN_CODE_NEG_REPLY	0x0017
225
struct mgmt_cp_pin_code_neg_reply {
226
	struct mgmt_addr_info addr;
227
} __packed;
228
#define MGMT_PIN_CODE_NEG_REPLY_SIZE	MGMT_ADDR_INFO_SIZE
229

230
#define MGMT_OP_SET_IO_CAPABILITY	0x0018
231 232 233
struct mgmt_cp_set_io_capability {
	__u8 io_capability;
} __packed;
234
#define MGMT_SET_IO_CAPABILITY_SIZE	1
235

236
#define MGMT_OP_PAIR_DEVICE		0x0019
237
struct mgmt_cp_pair_device {
238
	struct mgmt_addr_info addr;
239 240
	__u8 io_cap;
} __packed;
241
#define MGMT_PAIR_DEVICE_SIZE		(MGMT_ADDR_INFO_SIZE + 1)
242
struct mgmt_rp_pair_device {
243
	struct mgmt_addr_info addr;
244 245
} __packed;

246
#define MGMT_OP_CANCEL_PAIR_DEVICE	0x001A
247
#define MGMT_CANCEL_PAIR_DEVICE_SIZE	MGMT_ADDR_INFO_SIZE
248 249 250 251 252 253

#define MGMT_OP_UNPAIR_DEVICE		0x001B
struct mgmt_cp_unpair_device {
	struct mgmt_addr_info addr;
	__u8 disconnect;
} __packed;
254
#define MGMT_UNPAIR_DEVICE_SIZE		(MGMT_ADDR_INFO_SIZE + 1)
255 256 257
struct mgmt_rp_unpair_device {
	struct mgmt_addr_info addr;
};
258 259

#define MGMT_OP_USER_CONFIRM_REPLY	0x001C
260
struct mgmt_cp_user_confirm_reply {
261
	struct mgmt_addr_info addr;
262
} __packed;
263
#define MGMT_USER_CONFIRM_REPLY_SIZE	MGMT_ADDR_INFO_SIZE
264
struct mgmt_rp_user_confirm_reply {
265
	struct mgmt_addr_info addr;
266 267
} __packed;

268
#define MGMT_OP_USER_CONFIRM_NEG_REPLY	0x001D
269
struct mgmt_cp_user_confirm_neg_reply {
270
	struct mgmt_addr_info addr;
271
} __packed;
272
#define MGMT_USER_CONFIRM_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
273

274
#define MGMT_OP_USER_PASSKEY_REPLY	0x001E
275
struct mgmt_cp_user_passkey_reply {
276
	struct mgmt_addr_info addr;
277 278
	__le32 passkey;
} __packed;
279
#define MGMT_USER_PASSKEY_REPLY_SIZE	(MGMT_ADDR_INFO_SIZE + 4)
280
struct mgmt_rp_user_passkey_reply {
281
	struct mgmt_addr_info addr;
282 283
} __packed;

284
#define MGMT_OP_USER_PASSKEY_NEG_REPLY	0x001F
285
struct mgmt_cp_user_passkey_neg_reply {
286
	struct mgmt_addr_info addr;
287
} __packed;
288
#define MGMT_USER_PASSKEY_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
289

290
#define MGMT_OP_READ_LOCAL_OOB_DATA	0x0020
291
#define MGMT_READ_LOCAL_OOB_DATA_SIZE	0
292 293 294 295 296
struct mgmt_rp_read_local_oob_data {
	__u8 hash[16];
	__u8 randomizer[16];
} __packed;

297
#define MGMT_OP_ADD_REMOTE_OOB_DATA	0x0021
298
struct mgmt_cp_add_remote_oob_data {
299
	struct mgmt_addr_info addr;
300 301 302
	__u8 hash[16];
	__u8 randomizer[16];
} __packed;
303
#define MGMT_ADD_REMOTE_OOB_DATA_SIZE	(MGMT_ADDR_INFO_SIZE + 32)
304

305
#define MGMT_OP_REMOVE_REMOTE_OOB_DATA	0x0022
306
struct mgmt_cp_remove_remote_oob_data {
307
	struct mgmt_addr_info addr;
308
} __packed;
309
#define MGMT_REMOVE_REMOTE_OOB_DATA_SIZE MGMT_ADDR_INFO_SIZE
310

311
#define MGMT_OP_START_DISCOVERY		0x0023
312 313 314
struct mgmt_cp_start_discovery {
	__u8 type;
} __packed;
315
#define MGMT_START_DISCOVERY_SIZE	1
316

317
#define MGMT_OP_STOP_DISCOVERY		0x0024
318 319 320
struct mgmt_cp_stop_discovery {
	__u8 type;
} __packed;
321
#define MGMT_STOP_DISCOVERY_SIZE	1
322

323
#define MGMT_OP_CONFIRM_NAME		0x0025
324
struct mgmt_cp_confirm_name {
325
	struct mgmt_addr_info addr;
326 327
	__u8 name_known;
} __packed;
328
#define MGMT_CONFIRM_NAME_SIZE		(MGMT_ADDR_INFO_SIZE + 1)
329
struct mgmt_rp_confirm_name {
330
	struct mgmt_addr_info addr;
331 332
} __packed;

333
#define MGMT_OP_BLOCK_DEVICE		0x0026
334
struct mgmt_cp_block_device {
335
	struct mgmt_addr_info addr;
336
} __packed;
337
#define MGMT_BLOCK_DEVICE_SIZE		MGMT_ADDR_INFO_SIZE
338

339
#define MGMT_OP_UNBLOCK_DEVICE		0x0027
340
struct mgmt_cp_unblock_device {
341
	struct mgmt_addr_info addr;
342
} __packed;
343
#define MGMT_UNBLOCK_DEVICE_SIZE	MGMT_ADDR_INFO_SIZE
344

345 346 347
#define MGMT_EV_CMD_COMPLETE		0x0001
struct mgmt_ev_cmd_complete {
	__le16 opcode;
348
	__u8 status;
349 350 351 352 353 354
	__u8 data[0];
} __packed;

#define MGMT_EV_CMD_STATUS		0x0002
struct mgmt_ev_cmd_status {
	__le16 opcode;
355
	__u8 status;
356 357 358 359 360 361
} __packed;

#define MGMT_EV_CONTROLLER_ERROR	0x0003
struct mgmt_ev_controller_error {
	__u8 error_code;
} __packed;
362 363 364 365

#define MGMT_EV_INDEX_ADDED		0x0004

#define MGMT_EV_INDEX_REMOVED		0x0005
366

367
#define MGMT_EV_NEW_SETTINGS		0x0006
368

369 370 371 372
#define MGMT_EV_CLASS_OF_DEV_CHANGED	0x0007
struct mgmt_ev_class_of_dev_changed {
	__u8 dev_class[3];
};
373

374 375 376 377 378
#define MGMT_EV_LOCAL_NAME_CHANGED	0x0008
struct mgmt_ev_local_name_changed {
	__u8 name[MGMT_MAX_NAME_LENGTH];
	__u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
} __packed;
379

380
#define MGMT_EV_NEW_LINK_KEY		0x0009
381
struct mgmt_ev_new_link_key {
382
	__u8 store_hint;
383
	struct mgmt_link_key_info key;
384
} __packed;
385

386 387 388 389 390 391 392
#define MGMT_EV_NEW_LONG_TERM_KEY	0x000A
struct mgmt_ev_new_long_term_key {
	__u8 store_hint;
	struct mgmt_ltk_info key;
} __packed;

#define MGMT_EV_DEVICE_CONNECTED	0x000B
393 394
struct mgmt_ev_device_connected {
	struct mgmt_addr_info addr;
395
	__le32 flags;
396 397 398
	__le16 eir_len;
	__u8 eir[0];
} __packed;
399

400
#define MGMT_EV_DEVICE_DISCONNECTED	0x000C
401

402
#define MGMT_EV_CONNECT_FAILED		0x000D
403
struct mgmt_ev_connect_failed {
404
	struct mgmt_addr_info addr;
405 406
	__u8 status;
} __packed;
407

408
#define MGMT_EV_PIN_CODE_REQUEST	0x000E
409
struct mgmt_ev_pin_code_request {
410
	struct mgmt_addr_info addr;
411
	__u8 secure;
412
} __packed;
413

414
#define MGMT_EV_USER_CONFIRM_REQUEST	0x000F
415
struct mgmt_ev_user_confirm_request {
416
	struct mgmt_addr_info addr;
417
	__u8 confirm_hint;
418 419
	__le32 value;
} __packed;
420

421
#define MGMT_EV_USER_PASSKEY_REQUEST	0x0010
422
struct mgmt_ev_user_passkey_request {
423
	struct mgmt_addr_info addr;
424 425
} __packed;

426
#define MGMT_EV_AUTH_FAILED		0x0011
427
struct mgmt_ev_auth_failed {
428
	struct mgmt_addr_info addr;
429 430
	__u8 status;
} __packed;
431

432 433 434
#define MGMT_DEV_FOUND_CONFIRM_NAME    0x01
#define MGMT_DEV_FOUND_LEGACY_PAIRING  0x02

435
#define MGMT_EV_DEVICE_FOUND		0x0012
436
struct mgmt_ev_device_found {
437
	struct mgmt_addr_info addr;
438
	__s8 rssi;
439
	__u8 flags[4];
440 441
	__le16 eir_len;
	__u8 eir[0];
442
} __packed;
443

444
#define MGMT_EV_DISCOVERING		0x0013
445 446 447 448
struct mgmt_ev_discovering {
	__u8 type;
	__u8 discovering;
} __packed;
449

450
#define MGMT_EV_DEVICE_BLOCKED		0x0014
451
struct mgmt_ev_device_blocked {
452
	struct mgmt_addr_info addr;
453 454
} __packed;

455
#define MGMT_EV_DEVICE_UNBLOCKED	0x0015
456
struct mgmt_ev_device_unblocked {
457
	struct mgmt_addr_info addr;
458
} __packed;
459 460 461 462 463

#define MGMT_EV_DEVICE_UNPAIRED		0x0016
struct mgmt_ev_device_unpaired {
	struct mgmt_addr_info addr;
} __packed;