blob: 0579eb3952e30f4cc92e68d42027839c5342992c [file] [log] [blame]
Johan Hedbergc02178d2010-12-08 00:21:05 +02001/*
2 BlueZ - Bluetooth protocol stack for Linux
3
4 Copyright (C) 2010 Nokia Corporation
Johan Hedbergea585ab2012-02-17 14:50:39 +02005 Copyright (C) 2011-2012 Intel Corporation
Johan Hedbergc02178d2010-12-08 00:21:05 +02006
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
Szymon Janc4e51eae2011-02-25 19:05:48 +010025#define MGMT_INDEX_NONE 0xFFFF
26
Johan Hedbergca69b792011-11-11 18:10:00 +020027#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
Johan Hedberg28424702012-02-02 04:02:29 +020043#define MGMT_STATUS_CANCELLED 0x10
Johan Hedberg5f159032012-03-02 03:13:19 +020044#define MGMT_STATUS_INVALID_INDEX 0x11
Johan Hedberg96570ff2013-05-29 09:51:29 +030045#define MGMT_STATUS_RFKILLED 0x12
Johan Hedbergca69b792011-11-11 18:10:00 +020046
Johan Hedbergc02178d2010-12-08 00:21:05 +020047struct mgmt_hdr {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -030048 __le16 opcode;
49 __le16 index;
50 __le16 len;
Johan Hedbergc02178d2010-12-08 00:21:05 +020051} __packed;
Johan Hedbergc02178d2010-12-08 00:21:05 +020052
Johan Hedberg9ef866a2012-02-01 23:42:38 +020053struct mgmt_addr_info {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -030054 bdaddr_t bdaddr;
55 __u8 type;
Johan Hedberg9ef866a2012-02-01 23:42:38 +020056} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +020057#define MGMT_ADDR_INFO_SIZE 7
Johan Hedberg9ef866a2012-02-01 23:42:38 +020058
Johan Hedberg02d98122010-12-13 21:07:04 +020059#define MGMT_OP_READ_VERSION 0x0001
Johan Hedberg9d1acbf2012-03-01 22:23:42 +020060#define MGMT_READ_VERSION_SIZE 0
Johan Hedberg02d98122010-12-13 21:07:04 +020061struct mgmt_rp_read_version {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -030062 __u8 version;
63 __le16 revision;
Johan Hedberg02d98122010-12-13 21:07:04 +020064} __packed;
65
Johan Hedberge70bb2e2012-02-13 16:59:33 +020066#define MGMT_OP_READ_COMMANDS 0x0002
Johan Hedberg9d1acbf2012-03-01 22:23:42 +020067#define MGMT_READ_COMMANDS_SIZE 0
Johan Hedberge70bb2e2012-02-13 16:59:33 +020068struct mgmt_rp_read_commands {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -030069 __le16 num_commands;
70 __le16 num_events;
71 __le16 opcodes[0];
Johan Hedberge70bb2e2012-02-13 16:59:33 +020072} __packed;
73
Johan Hedbergfaba42e2010-12-13 21:07:05 +020074#define MGMT_OP_READ_INDEX_LIST 0x0003
Johan Hedberg9d1acbf2012-03-01 22:23:42 +020075#define MGMT_READ_INDEX_LIST_SIZE 0
Johan Hedbergfaba42e2010-12-13 21:07:05 +020076struct mgmt_rp_read_index_list {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -030077 __le16 num_controllers;
78 __le16 index[0];
Johan Hedbergfaba42e2010-12-13 21:07:05 +020079} __packed;
80
Johan Hedbergdc4fe302011-03-16 14:29:36 +020081/* 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)
Johan Hedberg490c5ba2012-02-22 19:19:09 +020084#define MGMT_MAX_SHORT_NAME_LENGTH (HCI_MAX_SHORT_NAME_LENGTH + 1)
Johan Hedberg69ab39e2011-12-15 00:47:35 +020085
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_PAIRABLE 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
Johan Hedbergeeca6f82013-09-25 13:26:09 +030096#define MGMT_SETTING_ADVERTISING 0x00000400
Marcel Holtmanne98d2ce2014-01-10 02:07:22 -080097#define MGMT_SETTING_SECURE_CONN 0x00000800
Marcel Holtmannb1de97d2014-01-31 11:55:21 -080098#define MGMT_SETTING_DEBUG_KEYS 0x00001000
Johan Hedberg755a9002014-02-22 19:06:34 +020099#define MGMT_SETTING_PRIVACY 0x00002000
Marcel Holtmann9fc3bfb2014-07-04 00:46:56 +0200100#define MGMT_SETTING_CONFIGURATION 0x00004000
Johan Hedbergdc4fe302011-03-16 14:29:36 +0200101
Johan Hedbergf7b64e692010-12-13 21:07:06 +0200102#define MGMT_OP_READ_INFO 0x0004
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200103#define MGMT_READ_INFO_SIZE 0
Johan Hedbergf7b64e692010-12-13 21:07:06 +0200104struct mgmt_rp_read_info {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300105 bdaddr_t bdaddr;
106 __u8 version;
107 __le16 manufacturer;
108 __le32 supported_settings;
109 __le32 current_settings;
110 __u8 dev_class[3];
111 __u8 name[MGMT_MAX_NAME_LENGTH];
112 __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
Johan Hedbergf7b64e692010-12-13 21:07:06 +0200113} __packed;
114
Johan Hedberg72a734e2010-12-30 00:38:22 +0200115struct mgmt_mode {
Johan Hedberg72a734e2010-12-30 00:38:22 +0200116 __u8 val;
117} __packed;
118
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200119#define MGMT_SETTING_SIZE 1
120
Johan Hedbergeec8d2b2010-12-16 10:17:38 +0200121#define MGMT_OP_SET_POWERED 0x0005
Johan Hedbergeec8d2b2010-12-16 10:17:38 +0200122
Johan Hedberg73f22f62010-12-29 16:00:25 +0200123#define MGMT_OP_SET_DISCOVERABLE 0x0006
Johan Hedberg16ab91a2011-11-07 22:16:02 +0200124struct mgmt_cp_set_discoverable {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300125 __u8 val;
Andrei Emeltchenkoc732a2a2012-03-19 09:42:31 +0200126 __le16 timeout;
Johan Hedberg16ab91a2011-11-07 22:16:02 +0200127} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200128#define MGMT_SET_DISCOVERABLE_SIZE 3
Johan Hedberg73f22f62010-12-29 16:00:25 +0200129
Johan Hedberg9fbcbb42010-12-30 00:18:33 +0200130#define MGMT_OP_SET_CONNECTABLE 0x0007
Johan Hedberg9fbcbb42010-12-30 00:18:33 +0200131
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200132#define MGMT_OP_SET_FAST_CONNECTABLE 0x0008
Johan Hedbergf7c6869c2011-12-15 00:47:36 +0200133
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200134#define MGMT_OP_SET_PAIRABLE 0x0009
Johan Hedbergc542a062011-01-26 13:11:03 +0200135
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200136#define MGMT_OP_SET_LINK_SECURITY 0x000A
137
138#define MGMT_OP_SET_SSP 0x000B
139
140#define MGMT_OP_SET_HS 0x000C
141
142#define MGMT_OP_SET_LE 0x000D
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200143#define MGMT_OP_SET_DEV_CLASS 0x000E
144struct mgmt_cp_set_dev_class {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300145 __u8 major;
146 __u8 minor;
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200147} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200148#define MGMT_SET_DEV_CLASS_SIZE 2
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200149
150#define MGMT_OP_SET_LOCAL_NAME 0x000F
151struct mgmt_cp_set_local_name {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300152 __u8 name[MGMT_MAX_NAME_LENGTH];
153 __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200154} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200155#define MGMT_SET_LOCAL_NAME_SIZE 260
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200156
157#define MGMT_OP_ADD_UUID 0x0010
Johan Hedberg2aeb9a12011-01-04 12:08:51 +0200158struct mgmt_cp_add_uuid {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300159 __u8 uuid[16];
160 __u8 svc_hint;
Johan Hedberg2aeb9a12011-01-04 12:08:51 +0200161} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200162#define MGMT_ADD_UUID_SIZE 17
Johan Hedberg2aeb9a12011-01-04 12:08:51 +0200163
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200164#define MGMT_OP_REMOVE_UUID 0x0011
Johan Hedberg2aeb9a12011-01-04 12:08:51 +0200165struct mgmt_cp_remove_uuid {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300166 __u8 uuid[16];
Johan Hedberg2aeb9a12011-01-04 12:08:51 +0200167} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200168#define MGMT_REMOVE_UUID_SIZE 16
Johan Hedberg2aeb9a12011-01-04 12:08:51 +0200169
Johan Hedberg86742e12011-11-07 23:13:38 +0200170struct mgmt_link_key_info {
Johan Hedbergd753fdc2012-02-17 14:06:34 +0200171 struct mgmt_addr_info addr;
Gustavo F. Padovan044e1242012-03-06 23:45:42 -0300172 __u8 type;
173 __u8 val[16];
174 __u8 pin_len;
Johan Hedberg55ed8ca12011-01-17 14:41:05 +0200175} __packed;
176
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200177#define MGMT_OP_LOAD_LINK_KEYS 0x0012
Johan Hedberg86742e12011-11-07 23:13:38 +0200178struct mgmt_cp_load_link_keys {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300179 __u8 debug_keys;
180 __le16 key_count;
181 struct mgmt_link_key_info keys[0];
Johan Hedberg55ed8ca12011-01-17 14:41:05 +0200182} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200183#define MGMT_LOAD_LINK_KEYS_SIZE 3
Johan Hedberg55ed8ca12011-01-17 14:41:05 +0200184
Johan Hedbergd7b25452014-05-23 13:19:53 +0300185#define MGMT_LTK_UNAUTHENTICATED 0x00
186#define MGMT_LTK_AUTHENTICATED 0x01
187
Vinicius Costa Gomes27f27ed2012-01-30 19:29:11 -0300188struct mgmt_ltk_info {
189 struct mgmt_addr_info addr;
Marcel Holtmannd40f3ee2014-01-31 18:42:17 -0800190 __u8 type;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300191 __u8 master;
192 __u8 enc_size;
193 __le16 ediv;
Marcel Holtmannfe39c7b2014-02-27 16:00:28 -0800194 __le64 rand;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300195 __u8 val[16];
Vinicius Costa Gomes27f27ed2012-01-30 19:29:11 -0300196} __packed;
197
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200198#define MGMT_OP_LOAD_LONG_TERM_KEYS 0x0013
Vinicius Costa Gomes27f27ed2012-01-30 19:29:11 -0300199struct mgmt_cp_load_long_term_keys {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300200 __le16 key_count;
201 struct mgmt_ltk_info keys[0];
Vinicius Costa Gomes27f27ed2012-01-30 19:29:11 -0300202} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200203#define MGMT_LOAD_LONG_TERM_KEYS_SIZE 2
Vinicius Costa Gomes27f27ed2012-01-30 19:29:11 -0300204
Johan Hedberg124f6e32012-02-09 13:50:12 +0200205#define MGMT_OP_DISCONNECT 0x0014
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200206struct mgmt_cp_disconnect {
Johan Hedberg88c3df12012-02-09 14:27:38 +0200207 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200208} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200209#define MGMT_DISCONNECT_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200210struct mgmt_rp_disconnect {
Johan Hedberg88c3df12012-02-09 14:27:38 +0200211 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200212} __packed;
213
Johan Hedberg124f6e32012-02-09 13:50:12 +0200214#define MGMT_OP_GET_CONNECTIONS 0x0015
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200215#define MGMT_GET_CONNECTIONS_SIZE 0
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200216struct mgmt_rp_get_connections {
217 __le16 conn_count;
218 struct mgmt_addr_info addr[0];
219} __packed;
220
Johan Hedberg124f6e32012-02-09 13:50:12 +0200221#define MGMT_OP_PIN_CODE_REPLY 0x0016
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200222struct mgmt_cp_pin_code_reply {
Johan Hedbergd8457692012-02-17 14:24:57 +0200223 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300224 __u8 pin_len;
225 __u8 pin_code[16];
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200226} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200227#define MGMT_PIN_CODE_REPLY_SIZE (MGMT_ADDR_INFO_SIZE + 17)
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200228struct mgmt_rp_pin_code_reply {
Johan Hedbergd8457692012-02-17 14:24:57 +0200229 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200230} __packed;
231
Johan Hedberg124f6e32012-02-09 13:50:12 +0200232#define MGMT_OP_PIN_CODE_NEG_REPLY 0x0017
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200233struct mgmt_cp_pin_code_neg_reply {
Johan Hedbergd8457692012-02-17 14:24:57 +0200234 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200235} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200236#define MGMT_PIN_CODE_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200237
Johan Hedberg124f6e32012-02-09 13:50:12 +0200238#define MGMT_OP_SET_IO_CAPABILITY 0x0018
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200239struct mgmt_cp_set_io_capability {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300240 __u8 io_capability;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200241} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200242#define MGMT_SET_IO_CAPABILITY_SIZE 1
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200243
Johan Hedberg124f6e32012-02-09 13:50:12 +0200244#define MGMT_OP_PAIR_DEVICE 0x0019
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200245struct mgmt_cp_pair_device {
246 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300247 __u8 io_cap;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200248} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200249#define MGMT_PAIR_DEVICE_SIZE (MGMT_ADDR_INFO_SIZE + 1)
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200250struct mgmt_rp_pair_device {
251 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200252} __packed;
253
Johan Hedberg124f6e32012-02-09 13:50:12 +0200254#define MGMT_OP_CANCEL_PAIR_DEVICE 0x001A
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200255#define MGMT_CANCEL_PAIR_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg124f6e32012-02-09 13:50:12 +0200256
257#define MGMT_OP_UNPAIR_DEVICE 0x001B
258struct mgmt_cp_unpair_device {
259 struct mgmt_addr_info addr;
260 __u8 disconnect;
261} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200262#define MGMT_UNPAIR_DEVICE_SIZE (MGMT_ADDR_INFO_SIZE + 1)
Johan Hedberg124f6e32012-02-09 13:50:12 +0200263struct mgmt_rp_unpair_device {
264 struct mgmt_addr_info addr;
Johan Hedberg124f6e32012-02-09 13:50:12 +0200265};
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200266
267#define MGMT_OP_USER_CONFIRM_REPLY 0x001C
268struct mgmt_cp_user_confirm_reply {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200269 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200270} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200271#define MGMT_USER_CONFIRM_REPLY_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200272struct mgmt_rp_user_confirm_reply {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200273 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200274} __packed;
275
276#define MGMT_OP_USER_CONFIRM_NEG_REPLY 0x001D
277struct mgmt_cp_user_confirm_neg_reply {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200278 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200279} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200280#define MGMT_USER_CONFIRM_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200281
282#define MGMT_OP_USER_PASSKEY_REPLY 0x001E
283struct mgmt_cp_user_passkey_reply {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200284 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300285 __le32 passkey;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200286} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200287#define MGMT_USER_PASSKEY_REPLY_SIZE (MGMT_ADDR_INFO_SIZE + 4)
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200288struct mgmt_rp_user_passkey_reply {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200289 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200290} __packed;
291
292#define MGMT_OP_USER_PASSKEY_NEG_REPLY 0x001F
293struct mgmt_cp_user_passkey_neg_reply {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200294 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200295} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200296#define MGMT_USER_PASSKEY_NEG_REPLY_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200297
298#define MGMT_OP_READ_LOCAL_OOB_DATA 0x0020
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200299#define MGMT_READ_LOCAL_OOB_DATA_SIZE 0
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200300struct mgmt_rp_read_local_oob_data {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300301 __u8 hash[16];
302 __u8 randomizer[16];
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200303} __packed;
Marcel Holtmann4d2d2792014-01-10 02:07:26 -0800304struct mgmt_rp_read_local_oob_ext_data {
305 __u8 hash192[16];
306 __u8 randomizer192[16];
307 __u8 hash256[16];
308 __u8 randomizer256[16];
309} __packed;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200310
311#define MGMT_OP_ADD_REMOTE_OOB_DATA 0x0021
312struct mgmt_cp_add_remote_oob_data {
Johan Hedberg664ce4c2012-02-09 15:44:09 +0200313 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300314 __u8 hash[16];
315 __u8 randomizer[16];
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200316} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200317#define MGMT_ADD_REMOTE_OOB_DATA_SIZE (MGMT_ADDR_INFO_SIZE + 32)
Marcel Holtmannec109112014-01-10 02:07:30 -0800318struct mgmt_cp_add_remote_oob_ext_data {
319 struct mgmt_addr_info addr;
320 __u8 hash192[16];
321 __u8 randomizer192[16];
322 __u8 hash256[16];
323 __u8 randomizer256[16];
324} __packed;
325#define MGMT_ADD_REMOTE_OOB_EXT_DATA_SIZE (MGMT_ADDR_INFO_SIZE + 64)
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200326
327#define MGMT_OP_REMOVE_REMOTE_OOB_DATA 0x0022
328struct mgmt_cp_remove_remote_oob_data {
Johan Hedberg664ce4c2012-02-09 15:44:09 +0200329 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200330} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200331#define MGMT_REMOVE_REMOTE_OOB_DATA_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200332
333#define MGMT_OP_START_DISCOVERY 0x0023
334struct mgmt_cp_start_discovery {
335 __u8 type;
336} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200337#define MGMT_START_DISCOVERY_SIZE 1
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200338
339#define MGMT_OP_STOP_DISCOVERY 0x0024
Johan Hedbergd9306502012-02-20 23:25:18 +0200340struct mgmt_cp_stop_discovery {
341 __u8 type;
342} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200343#define MGMT_STOP_DISCOVERY_SIZE 1
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200344
345#define MGMT_OP_CONFIRM_NAME 0x0025
346struct mgmt_cp_confirm_name {
Johan Hedberga198e7b2012-02-17 14:27:06 +0200347 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300348 __u8 name_known;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200349} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200350#define MGMT_CONFIRM_NAME_SIZE (MGMT_ADDR_INFO_SIZE + 1)
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200351struct mgmt_rp_confirm_name {
Johan Hedberga198e7b2012-02-17 14:27:06 +0200352 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200353} __packed;
354
355#define MGMT_OP_BLOCK_DEVICE 0x0026
356struct mgmt_cp_block_device {
Johan Hedberg88c1fe42012-02-09 15:56:11 +0200357 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200358} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200359#define MGMT_BLOCK_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200360
361#define MGMT_OP_UNBLOCK_DEVICE 0x0027
362struct mgmt_cp_unblock_device {
Johan Hedberg88c1fe42012-02-09 15:56:11 +0200363 struct mgmt_addr_info addr;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200364} __packed;
Johan Hedberg9d1acbf2012-03-01 22:23:42 +0200365#define MGMT_UNBLOCK_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200366
Marcel Holtmanncdbaccc2012-03-11 20:00:29 -0700367#define MGMT_OP_SET_DEVICE_ID 0x0028
368struct mgmt_cp_set_device_id {
369 __le16 source;
370 __le16 vendor;
371 __le16 product;
372 __le16 version;
373} __packed;
374#define MGMT_SET_DEVICE_ID_SIZE 8
375
Johan Hedberg4375f102013-09-25 13:26:10 +0300376#define MGMT_OP_SET_ADVERTISING 0x0029
377
Johan Hedberg0663ca22013-10-02 13:43:14 +0300378#define MGMT_OP_SET_BREDR 0x002A
379
Marcel Holtmannd13eafc2013-10-02 04:41:30 -0700380#define MGMT_OP_SET_STATIC_ADDRESS 0x002B
381struct mgmt_cp_set_static_address {
382 bdaddr_t bdaddr;
383} __packed;
384#define MGMT_SET_STATIC_ADDRESS_SIZE 6
385
Marcel Holtmann14b49b92013-10-11 08:23:20 -0700386#define MGMT_OP_SET_SCAN_PARAMS 0x002C
387struct mgmt_cp_set_scan_params {
388 __le16 interval;
389 __le16 window;
390} __packed;
391#define MGMT_SET_SCAN_PARAMS_SIZE 4
392
Marcel Holtmanneac83dc2014-01-10 02:07:23 -0800393#define MGMT_OP_SET_SECURE_CONN 0x002D
394
Marcel Holtmann4e39ac82014-01-31 11:55:22 -0800395#define MGMT_OP_SET_DEBUG_KEYS 0x002E
396
Johan Hedberg755a9002014-02-22 19:06:34 +0200397#define MGMT_OP_SET_PRIVACY 0x002F
398struct mgmt_cp_set_privacy {
399 __u8 privacy;
400 __u8 irk[16];
401} __packed;
402#define MGMT_SET_PRIVACY_SIZE 17
403
Johan Hedberg41edf162014-02-18 10:19:35 +0200404struct mgmt_irk_info {
405 struct mgmt_addr_info addr;
406 __u8 val[16];
407} __packed;
408
409#define MGMT_OP_LOAD_IRKS 0x0030
410struct mgmt_cp_load_irks {
411 __le16 irk_count;
412 struct mgmt_irk_info irks[0];
413} __packed;
414#define MGMT_LOAD_IRKS_SIZE 2
415
Andrzej Kaczmarekdd983802014-05-14 13:43:03 +0200416#define MGMT_OP_GET_CONN_INFO 0x0031
417struct mgmt_cp_get_conn_info {
418 struct mgmt_addr_info addr;
419} __packed;
420#define MGMT_GET_CONN_INFO_SIZE MGMT_ADDR_INFO_SIZE
421struct mgmt_rp_get_conn_info {
422 struct mgmt_addr_info addr;
423 __s8 rssi;
424 __s8 tx_power;
425 __s8 max_tx_power;
426} __packed;
427
Johan Hedberg95868422014-06-28 17:54:07 +0300428#define MGMT_OP_GET_CLOCK_INFO 0x0032
429struct mgmt_cp_get_clock_info {
430 struct mgmt_addr_info addr;
431} __packed;
432#define MGMT_GET_CLOCK_INFO_SIZE MGMT_ADDR_INFO_SIZE
433struct mgmt_rp_get_clock_info {
434 struct mgmt_addr_info addr;
435 __le32 local_clock;
436 __le32 piconet_clock;
437 __le16 accuracy;
438} __packed;
439
Marcel Holtmann2faade52014-06-29 19:44:03 +0200440#define MGMT_OP_ADD_DEVICE 0x0033
441struct mgmt_cp_add_device {
442 struct mgmt_addr_info addr;
443 __u8 action;
444} __packed;
445#define MGMT_ADD_DEVICE_SIZE (MGMT_ADDR_INFO_SIZE + 1)
446
447#define MGMT_OP_REMOVE_DEVICE 0x0034
448struct mgmt_cp_remove_device {
449 struct mgmt_addr_info addr;
450} __packed;
451#define MGMT_REMOVE_DEVICE_SIZE MGMT_ADDR_INFO_SIZE
452
Johan Hedberga26f3dc2014-07-02 17:37:29 +0300453struct mgmt_conn_param {
454 struct mgmt_addr_info addr;
455 __le16 min_interval;
456 __le16 max_interval;
457 __le16 latency;
458 __le16 timeout;
459} __packed;
460
461#define MGMT_OP_LOAD_CONN_PARAM 0x0035
462struct mgmt_cp_load_conn_param {
463 __le16 param_count;
464 struct mgmt_conn_param params[0];
465} __packed;
466#define MGMT_LOAD_CONN_PARAM_SIZE 2
467
Marcel Holtmann73d1df22014-07-02 22:10:52 +0200468#define MGMT_OP_READ_UNCONF_INDEX_LIST 0x0036
469#define MGMT_READ_UNCONF_INDEX_LIST_SIZE 0
470struct mgmt_rp_read_unconf_index_list {
471 __le16 num_controllers;
472 __le16 index[0];
473} __packed;
474
Marcel Holtmann9fc3bfb2014-07-04 00:46:56 +0200475#define MGMT_OPTION_PUBLIC_ADDRESS 0x00000001
476
477#define MGMT_OP_READ_CONFIG_INFO 0x0037
478#define MGMT_READ_CONFIG_INFO_SIZE 0
479struct mgmt_rp_read_config_info {
480 __le16 manufacturer;
481 __le32 supported_options;
482 __le32 missing_options;
483} __packed;
484
Johan Hedbergc02178d2010-12-08 00:21:05 +0200485#define MGMT_EV_CMD_COMPLETE 0x0001
486struct mgmt_ev_cmd_complete {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300487 __le16 opcode;
488 __u8 status;
489 __u8 data[0];
Johan Hedbergc02178d2010-12-08 00:21:05 +0200490} __packed;
491
492#define MGMT_EV_CMD_STATUS 0x0002
493struct mgmt_ev_cmd_status {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300494 __le16 opcode;
495 __u8 status;
Johan Hedbergc02178d2010-12-08 00:21:05 +0200496} __packed;
497
498#define MGMT_EV_CONTROLLER_ERROR 0x0003
499struct mgmt_ev_controller_error {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300500 __u8 error_code;
Johan Hedbergc02178d2010-12-08 00:21:05 +0200501} __packed;
Johan Hedbergc71e97b2010-12-13 21:07:07 +0200502
503#define MGMT_EV_INDEX_ADDED 0x0004
Johan Hedbergc71e97b2010-12-13 21:07:07 +0200504
505#define MGMT_EV_INDEX_REMOVED 0x0005
Johan Hedberg5add6af2010-12-16 10:00:37 +0200506
Johan Hedberg69ab39e2011-12-15 00:47:35 +0200507#define MGMT_EV_NEW_SETTINGS 0x0006
Johan Hedberg73f22f62010-12-29 16:00:25 +0200508
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200509#define MGMT_EV_CLASS_OF_DEV_CHANGED 0x0007
510struct mgmt_ev_class_of_dev_changed {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300511 __u8 dev_class[3];
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200512};
Johan Hedberg9fbcbb42010-12-30 00:18:33 +0200513
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200514#define MGMT_EV_LOCAL_NAME_CHANGED 0x0008
515struct mgmt_ev_local_name_changed {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300516 __u8 name[MGMT_MAX_NAME_LENGTH];
517 __u8 short_name[MGMT_MAX_SHORT_NAME_LENGTH];
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200518} __packed;
Johan Hedbergc542a062011-01-26 13:11:03 +0200519
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200520#define MGMT_EV_NEW_LINK_KEY 0x0009
Johan Hedberg86742e12011-11-07 23:13:38 +0200521struct mgmt_ev_new_link_key {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300522 __u8 store_hint;
Johan Hedberg86742e12011-11-07 23:13:38 +0200523 struct mgmt_link_key_info key;
Johan Hedberg55ed8ca12011-01-17 14:41:05 +0200524} __packed;
Johan Hedbergf7520542011-01-20 12:34:39 +0200525
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200526#define MGMT_EV_NEW_LONG_TERM_KEY 0x000A
527struct mgmt_ev_new_long_term_key {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300528 __u8 store_hint;
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200529 struct mgmt_ltk_info key;
530} __packed;
531
532#define MGMT_EV_DEVICE_CONNECTED 0x000B
Johan Hedbergb644ba32012-01-17 21:48:47 +0200533struct mgmt_ev_device_connected {
534 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300535 __le32 flags;
536 __le16 eir_len;
537 __u8 eir[0];
Johan Hedbergb644ba32012-01-17 21:48:47 +0200538} __packed;
Johan Hedbergf7520542011-01-20 12:34:39 +0200539
Mikel Astizf0d6a0e2012-08-09 09:52:30 +0200540#define MGMT_DEV_DISCONN_UNKNOWN 0x00
541#define MGMT_DEV_DISCONN_TIMEOUT 0x01
542#define MGMT_DEV_DISCONN_LOCAL_HOST 0x02
543#define MGMT_DEV_DISCONN_REMOTE 0x03
544
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200545#define MGMT_EV_DEVICE_DISCONNECTED 0x000C
Mikel Astizf0d6a0e2012-08-09 09:52:30 +0200546struct mgmt_ev_device_disconnected {
547 struct mgmt_addr_info addr;
548 __u8 reason;
549} __packed;
Johan Hedberg17d5c042011-01-22 06:09:08 +0200550
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200551#define MGMT_EV_CONNECT_FAILED 0x000D
Johan Hedberg17d5c042011-01-22 06:09:08 +0200552struct mgmt_ev_connect_failed {
Johan Hedberg4c659c32011-11-07 23:13:39 +0200553 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300554 __u8 status;
Johan Hedberg17d5c042011-01-22 06:09:08 +0200555} __packed;
Johan Hedberg980e1a52011-01-22 06:10:07 +0200556
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200557#define MGMT_EV_PIN_CODE_REQUEST 0x000E
Johan Hedberg980e1a52011-01-22 06:10:07 +0200558struct mgmt_ev_pin_code_request {
Johan Hedbergd8457692012-02-17 14:24:57 +0200559 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300560 __u8 secure;
Johan Hedberg980e1a52011-01-22 06:10:07 +0200561} __packed;
Johan Hedberga5c29682011-02-19 12:05:57 -0300562
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200563#define MGMT_EV_USER_CONFIRM_REQUEST 0x000F
Johan Hedberga5c29682011-02-19 12:05:57 -0300564struct mgmt_ev_user_confirm_request {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200565 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300566 __u8 confirm_hint;
567 __le32 value;
Johan Hedberga5c29682011-02-19 12:05:57 -0300568} __packed;
Johan Hedberg2a611692011-02-19 12:06:00 -0300569
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200570#define MGMT_EV_USER_PASSKEY_REQUEST 0x0010
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200571struct mgmt_ev_user_passkey_request {
Johan Hedberg272d90d2012-02-09 15:26:12 +0200572 struct mgmt_addr_info addr;
Johan Hedbergf71d5a22011-12-15 00:47:40 +0200573} __packed;
574
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200575#define MGMT_EV_AUTH_FAILED 0x0011
Johan Hedberg2a611692011-02-19 12:06:00 -0300576struct mgmt_ev_auth_failed {
Johan Hedbergbab73cb2012-02-09 16:07:29 +0200577 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300578 __u8 status;
Johan Hedberg2a611692011-02-19 12:06:00 -0300579} __packed;
Johan Hedbergb312b1612011-03-16 14:29:37 +0200580
Johan Hedberg9a395a82012-02-23 00:00:32 +0200581#define MGMT_DEV_FOUND_CONFIRM_NAME 0x01
582#define MGMT_DEV_FOUND_LEGACY_PAIRING 0x02
Marcel Holtmannaf589252014-07-01 14:11:20 +0200583#define MGMT_DEV_FOUND_NOT_CONNECTABLE 0x04
Johan Hedberg9a395a82012-02-23 00:00:32 +0200584
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200585#define MGMT_EV_DEVICE_FOUND 0x0012
Johan Hedberge17acd42011-03-30 23:57:16 +0300586struct mgmt_ev_device_found {
Johan Hedberg4c659c32011-11-07 23:13:39 +0200587 struct mgmt_addr_info addr;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300588 __s8 rssi;
Jefferson Delfesaf7985b2012-06-11 09:18:51 -0400589 __le32 flags;
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300590 __le16 eir_len;
591 __u8 eir[0];
Johan Hedberge17acd42011-03-30 23:57:16 +0300592} __packed;
Johan Hedberga88a9652011-03-30 13:18:12 +0300593
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200594#define MGMT_EV_DISCOVERING 0x0013
Johan Hedbergf963e8e2012-02-20 23:30:44 +0200595struct mgmt_ev_discovering {
Gustavo F. Padovanc4762502012-03-06 23:39:50 -0300596 __u8 type;
597 __u8 discovering;
Johan Hedbergf963e8e2012-02-20 23:30:44 +0200598} __packed;
Johan Hedberg314b2382011-04-27 10:29:57 -0400599
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200600#define MGMT_EV_DEVICE_BLOCKED 0x0014
Antti Julku5e762442011-08-25 16:48:02 +0300601struct mgmt_ev_device_blocked {
Johan Hedberg88c1fe42012-02-09 15:56:11 +0200602 struct mgmt_addr_info addr;
Antti Julku5e762442011-08-25 16:48:02 +0300603} __packed;
604
Johan Hedberg9ef866a2012-02-01 23:42:38 +0200605#define MGMT_EV_DEVICE_UNBLOCKED 0x0015
Antti Julku5e762442011-08-25 16:48:02 +0300606struct mgmt_ev_device_unblocked {
Johan Hedberg88c1fe42012-02-09 15:56:11 +0200607 struct mgmt_addr_info addr;
Antti Julku5e762442011-08-25 16:48:02 +0300608} __packed;
Johan Hedbergb1078ad2012-02-09 17:21:16 +0200609
610#define MGMT_EV_DEVICE_UNPAIRED 0x0016
611struct mgmt_ev_device_unpaired {
612 struct mgmt_addr_info addr;
613} __packed;
Johan Hedberg92a25252012-09-06 18:39:26 +0300614
615#define MGMT_EV_PASSKEY_NOTIFY 0x0017
616struct mgmt_ev_passkey_notify {
617 struct mgmt_addr_info addr;
618 __le32 passkey;
619 __u8 entered;
620} __packed;
Johan Hedberg95fbac82014-02-19 15:18:31 +0200621
622#define MGMT_EV_NEW_IRK 0x0018
623struct mgmt_ev_new_irk {
624 __u8 store_hint;
625 bdaddr_t rpa;
626 struct mgmt_irk_info irk;
627} __packed;
Marcel Holtmann7ee4ea32014-03-09 12:19:17 -0700628
629struct mgmt_csrk_info {
630 struct mgmt_addr_info addr;
631 __u8 master;
632 __u8 val[16];
633} __packed;
634
635#define MGMT_EV_NEW_CSRK 0x0019
636struct mgmt_ev_new_csrk {
637 __u8 store_hint;
638 struct mgmt_csrk_info key;
639} __packed;
Marcel Holtmann8afef092014-06-29 22:28:34 +0200640
641#define MGMT_EV_DEVICE_ADDED 0x001a
642struct mgmt_ev_device_added {
643 struct mgmt_addr_info addr;
644 __u8 action;
645} __packed;
646
647#define MGMT_EV_DEVICE_REMOVED 0x001b
648struct mgmt_ev_device_removed {
649 struct mgmt_addr_info addr;
650} __packed;
Andre Guedesffb5a8272014-07-01 18:10:11 -0300651
652#define MGMT_EV_NEW_CONN_PARAM 0x001c
653struct mgmt_ev_new_conn_param {
654 struct mgmt_addr_info addr;
655 __u8 store_hint;
656 __le16 min_interval;
657 __le16 max_interval;
658 __le16 latency;
659 __le16 timeout;
660} __packed;
Marcel Holtmann0602a8a2014-07-02 21:30:54 +0200661
662#define MGMT_EV_UNCONF_INDEX_ADDED 0x001d
Marcel Holtmannedd38962014-07-02 21:30:55 +0200663
664#define MGMT_EV_UNCONF_INDEX_REMOVED 0x001e