mgmt.h 12.3 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
#define MGMT_STATUS_RFKILLED		0x12
46

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

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

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

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

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

81 82 83
/* 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)
84
#define MGMT_MAX_SHORT_NAME_LENGTH	(HCI_MAX_SHORT_NAME_LENGTH + 1)
85 86 87 88 89 90 91 92 93 94 95

#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
96
#define MGMT_SETTING_ADVERTISING	0x00000400
97

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

111 112
struct mgmt_mode {
	__u8 val;
113 114
} __packed;

115 116
#define MGMT_SETTING_SIZE		1

117 118
#define MGMT_OP_SET_POWERED		0x0005

119
#define MGMT_OP_SET_DISCOVERABLE	0x0006
120
struct mgmt_cp_set_discoverable {
121
	__u8	val;
122
	__le16	timeout;
123
} __packed;
124
#define MGMT_SET_DISCOVERABLE_SIZE	3
125

126 127
#define MGMT_OP_SET_CONNECTABLE		0x0007

128
#define MGMT_OP_SET_FAST_CONNECTABLE	0x0008
129

130
#define MGMT_OP_SET_PAIRABLE		0x0009
131

132 133 134 135 136 137 138 139 140
#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 {
141 142
	__u8	major;
	__u8	minor;
143
} __packed;
144
#define MGMT_SET_DEV_CLASS_SIZE		2
145 146 147

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

346 347 348 349 350 351 352 353 354
#define MGMT_OP_SET_DEVICE_ID		0x0028
struct mgmt_cp_set_device_id {
	__le16	source;
	__le16	vendor;
	__le16	product;
	__le16	version;
} __packed;
#define MGMT_SET_DEVICE_ID_SIZE		8

355 356
#define MGMT_OP_SET_ADVERTISING		0x0029

357 358
#define MGMT_OP_SET_BREDR		0x002A

359 360 361 362 363 364
#define MGMT_OP_SET_STATIC_ADDRESS	0x002B
struct mgmt_cp_set_static_address {
	bdaddr_t bdaddr;
} __packed;
#define MGMT_SET_STATIC_ADDRESS_SIZE	6

365 366
#define MGMT_EV_CMD_COMPLETE		0x0001
struct mgmt_ev_cmd_complete {
367 368 369
	__le16	opcode;
	__u8	status;
	__u8	data[0];
370 371 372 373
} __packed;

#define MGMT_EV_CMD_STATUS		0x0002
struct mgmt_ev_cmd_status {
374 375
	__le16	opcode;
	__u8	status;
376 377 378 379
} __packed;

#define MGMT_EV_CONTROLLER_ERROR	0x0003
struct mgmt_ev_controller_error {
380
	__u8	error_code;
381
} __packed;
382 383 384 385

#define MGMT_EV_INDEX_ADDED		0x0004

#define MGMT_EV_INDEX_REMOVED		0x0005
386

387
#define MGMT_EV_NEW_SETTINGS		0x0006
388

389 390
#define MGMT_EV_CLASS_OF_DEV_CHANGED	0x0007
struct mgmt_ev_class_of_dev_changed {
391
	__u8	dev_class[3];
392
};
393

394 395
#define MGMT_EV_LOCAL_NAME_CHANGED	0x0008
struct mgmt_ev_local_name_changed {
396 397
	__u8	name[MGMT_MAX_NAME_LENGTH];
	__u8	short_name[MGMT_MAX_SHORT_NAME_LENGTH];
398
} __packed;
399

400
#define MGMT_EV_NEW_LINK_KEY		0x0009
401
struct mgmt_ev_new_link_key {
402
	__u8	store_hint;
403
	struct mgmt_link_key_info key;
404
} __packed;
405

406 407
#define MGMT_EV_NEW_LONG_TERM_KEY	0x000A
struct mgmt_ev_new_long_term_key {
408
	__u8	store_hint;
409 410 411 412
	struct mgmt_ltk_info key;
} __packed;

#define MGMT_EV_DEVICE_CONNECTED	0x000B
413 414
struct mgmt_ev_device_connected {
	struct mgmt_addr_info addr;
415 416 417
	__le32	flags;
	__le16	eir_len;
	__u8	eir[0];
418
} __packed;
419

420 421 422 423 424
#define MGMT_DEV_DISCONN_UNKNOWN	0x00
#define MGMT_DEV_DISCONN_TIMEOUT	0x01
#define MGMT_DEV_DISCONN_LOCAL_HOST	0x02
#define MGMT_DEV_DISCONN_REMOTE		0x03

425
#define MGMT_EV_DEVICE_DISCONNECTED	0x000C
426 427 428 429
struct mgmt_ev_device_disconnected {
	struct mgmt_addr_info addr;
	__u8	reason;
} __packed;
430

431
#define MGMT_EV_CONNECT_FAILED		0x000D
432
struct mgmt_ev_connect_failed {
433
	struct mgmt_addr_info addr;
434
	__u8	status;
435
} __packed;
436

437
#define MGMT_EV_PIN_CODE_REQUEST	0x000E
438
struct mgmt_ev_pin_code_request {
439
	struct mgmt_addr_info addr;
440
	__u8	secure;
441
} __packed;
442

443
#define MGMT_EV_USER_CONFIRM_REQUEST	0x000F
444
struct mgmt_ev_user_confirm_request {
445
	struct mgmt_addr_info addr;
446 447
	__u8	confirm_hint;
	__le32	value;
448
} __packed;
449

450
#define MGMT_EV_USER_PASSKEY_REQUEST	0x0010
451
struct mgmt_ev_user_passkey_request {
452
	struct mgmt_addr_info addr;
453 454
} __packed;

455
#define MGMT_EV_AUTH_FAILED		0x0011
456
struct mgmt_ev_auth_failed {
457
	struct mgmt_addr_info addr;
458
	__u8	status;
459
} __packed;
460

461 462 463
#define MGMT_DEV_FOUND_CONFIRM_NAME    0x01
#define MGMT_DEV_FOUND_LEGACY_PAIRING  0x02

464
#define MGMT_EV_DEVICE_FOUND		0x0012
465
struct mgmt_ev_device_found {
466
	struct mgmt_addr_info addr;
467
	__s8	rssi;
468
	__le32	flags;
469 470
	__le16	eir_len;
	__u8	eir[0];
471
} __packed;
472

473
#define MGMT_EV_DISCOVERING		0x0013
474
struct mgmt_ev_discovering {
475 476
	__u8	type;
	__u8	discovering;
477
} __packed;
478

479
#define MGMT_EV_DEVICE_BLOCKED		0x0014
480
struct mgmt_ev_device_blocked {
481
	struct mgmt_addr_info addr;
482 483
} __packed;

484
#define MGMT_EV_DEVICE_UNBLOCKED	0x0015
485
struct mgmt_ev_device_unblocked {
486
	struct mgmt_addr_info addr;
487
} __packed;
488 489 490 491 492

#define MGMT_EV_DEVICE_UNPAIRED		0x0016
struct mgmt_ev_device_unpaired {
	struct mgmt_addr_info addr;
} __packed;
493 494 495 496 497 498 499

#define MGMT_EV_PASSKEY_NOTIFY		0x0017
struct mgmt_ev_passkey_notify {
	struct mgmt_addr_info addr;
	__le32	passkey;
	__u8	entered;
} __packed;