1 /* 2 * Wi-Fi Protected Setup - message definitions 3 * Copyright (c) 2008, Jouni Malinen <j@w1.fi> 4 * 5 * This software may be distributed under the terms of the BSD license. 6 * See README for more details. 7 */ 8 9 #ifndef WPS_DEFS_H 10 #define WPS_DEFS_H 11 12 #ifdef CONFIG_WPS_TESTING 13 14 extern int wps_version_number; 15 extern int wps_testing_dummy_cred; 16 extern int wps_corrupt_pkhash; 17 #define WPS_VERSION wps_version_number 18 19 #else /* CONFIG_WPS_TESTING */ 20 21 #define WPS_VERSION 0x20 22 23 #endif /* CONFIG_WPS_TESTING */ 24 25 /* Diffie-Hellman 1536-bit MODP Group; RFC 3526, Group 5 */ 26 #define WPS_DH_GROUP 5 27 28 #define WPS_UUID_LEN 16 29 #define WPS_NONCE_LEN 16 30 #define WPS_AUTHENTICATOR_LEN 8 31 #define WPS_AUTHKEY_LEN 32 32 #define WPS_KEYWRAPKEY_LEN 16 33 #define WPS_EMSK_LEN 32 34 #define WPS_PSK_LEN 16 35 #define WPS_SECRET_NONCE_LEN 16 36 #define WPS_HASH_LEN 32 37 #define WPS_KWA_LEN 8 38 #define WPS_MGMTAUTHKEY_LEN 32 39 #define WPS_MGMTENCKEY_LEN 16 40 #define WPS_MGMT_KEY_ID_LEN 16 41 #define WPS_OOB_DEVICE_PASSWORD_MIN_LEN 16 42 #define WPS_OOB_DEVICE_PASSWORD_LEN 32 43 #define WPS_OOB_PUBKEY_HASH_LEN 20 44 45 /* Attribute Types */ 46 enum wps_attribute { 47 ATTR_AP_CHANNEL = 0x1001, 48 ATTR_ASSOC_STATE = 0x1002, 49 ATTR_AUTH_TYPE = 0x1003, 50 ATTR_AUTH_TYPE_FLAGS = 0x1004, 51 ATTR_AUTHENTICATOR = 0x1005, 52 ATTR_CONFIG_METHODS = 0x1008, 53 ATTR_CONFIG_ERROR = 0x1009, 54 ATTR_CONFIRM_URL4 = 0x100a, 55 ATTR_CONFIRM_URL6 = 0x100b, 56 ATTR_CONN_TYPE = 0x100c, 57 ATTR_CONN_TYPE_FLAGS = 0x100d, 58 ATTR_CRED = 0x100e, 59 ATTR_ENCR_TYPE = 0x100f, 60 ATTR_ENCR_TYPE_FLAGS = 0x1010, 61 ATTR_DEV_NAME = 0x1011, 62 ATTR_DEV_PASSWORD_ID = 0x1012, 63 ATTR_E_HASH1 = 0x1014, 64 ATTR_E_HASH2 = 0x1015, 65 ATTR_E_SNONCE1 = 0x1016, 66 ATTR_E_SNONCE2 = 0x1017, 67 ATTR_ENCR_SETTINGS = 0x1018, 68 ATTR_ENROLLEE_NONCE = 0x101a, 69 ATTR_FEATURE_ID = 0x101b, 70 ATTR_IDENTITY = 0x101c, 71 ATTR_IDENTITY_PROOF = 0x101d, 72 ATTR_KEY_WRAP_AUTH = 0x101e, 73 ATTR_KEY_ID = 0x101f, 74 ATTR_MAC_ADDR = 0x1020, 75 ATTR_MANUFACTURER = 0x1021, 76 ATTR_MSG_TYPE = 0x1022, 77 ATTR_MODEL_NAME = 0x1023, 78 ATTR_MODEL_NUMBER = 0x1024, 79 ATTR_NETWORK_INDEX = 0x1026, 80 ATTR_NETWORK_KEY = 0x1027, 81 ATTR_NETWORK_KEY_INDEX = 0x1028, 82 ATTR_NEW_DEVICE_NAME = 0x1029, 83 ATTR_NEW_PASSWORD = 0x102a, 84 ATTR_OOB_DEVICE_PASSWORD = 0x102c, 85 ATTR_OS_VERSION = 0x102d, 86 ATTR_POWER_LEVEL = 0x102f, 87 ATTR_PSK_CURRENT = 0x1030, 88 ATTR_PSK_MAX = 0x1031, 89 ATTR_PUBLIC_KEY = 0x1032, 90 ATTR_RADIO_ENABLE = 0x1033, 91 ATTR_REBOOT = 0x1034, 92 ATTR_REGISTRAR_CURRENT = 0x1035, 93 ATTR_REGISTRAR_ESTABLISHED = 0x1036, 94 ATTR_REGISTRAR_LIST = 0x1037, 95 ATTR_REGISTRAR_MAX = 0x1038, 96 ATTR_REGISTRAR_NONCE = 0x1039, 97 ATTR_REQUEST_TYPE = 0x103a, 98 ATTR_RESPONSE_TYPE = 0x103b, 99 ATTR_RF_BANDS = 0x103c, 100 ATTR_R_HASH1 = 0x103d, 101 ATTR_R_HASH2 = 0x103e, 102 ATTR_R_SNONCE1 = 0x103f, 103 ATTR_R_SNONCE2 = 0x1040, 104 ATTR_SELECTED_REGISTRAR = 0x1041, 105 ATTR_SERIAL_NUMBER = 0x1042, 106 ATTR_WPS_STATE = 0x1044, 107 ATTR_SSID = 0x1045, 108 ATTR_TOTAL_NETWORKS = 0x1046, 109 ATTR_UUID_E = 0x1047, 110 ATTR_UUID_R = 0x1048, 111 ATTR_VENDOR_EXT = 0x1049, 112 ATTR_VERSION = 0x104a, 113 ATTR_X509_CERT_REQ = 0x104b, 114 ATTR_X509_CERT = 0x104c, 115 ATTR_EAP_IDENTITY = 0x104d, 116 ATTR_MSG_COUNTER = 0x104e, 117 ATTR_PUBKEY_HASH = 0x104f, 118 ATTR_REKEY_KEY = 0x1050, 119 ATTR_KEY_LIFETIME = 0x1051, 120 ATTR_PERMITTED_CFG_METHODS = 0x1052, 121 ATTR_SELECTED_REGISTRAR_CONFIG_METHODS = 0x1053, 122 ATTR_PRIMARY_DEV_TYPE = 0x1054, 123 ATTR_SECONDARY_DEV_TYPE_LIST = 0x1055, 124 ATTR_PORTABLE_DEV = 0x1056, 125 ATTR_AP_SETUP_LOCKED = 0x1057, 126 ATTR_APPLICATION_EXT = 0x1058, 127 ATTR_EAP_TYPE = 0x1059, 128 ATTR_IV = 0x1060, 129 ATTR_KEY_PROVIDED_AUTO = 0x1061, 130 ATTR_802_1X_ENABLED = 0x1062, 131 ATTR_APPSESSIONKEY = 0x1063, 132 ATTR_WEPTRANSMITKEY = 0x1064, 133 ATTR_REQUESTED_DEV_TYPE = 0x106a, 134 ATTR_EXTENSIBILITY_TEST = 0x10fa /* _NOT_ defined in the spec */ 135 }; 136 137 #define WPS_VENDOR_ID_WFA 14122 138 139 /* WFA Vendor Extension subelements */ 140 enum { 141 WFA_ELEM_VERSION2 = 0x00, 142 WFA_ELEM_AUTHORIZEDMACS = 0x01, 143 WFA_ELEM_NETWORK_KEY_SHAREABLE = 0x02, 144 WFA_ELEM_REQUEST_TO_ENROLL = 0x03, 145 WFA_ELEM_SETTINGS_DELAY_TIME = 0x04, 146 WFA_ELEM_REGISTRAR_CONFIGURATION_METHODS = 0x05 147 }; 148 149 /* Device Password ID */ 150 enum wps_dev_password_id { 151 DEV_PW_DEFAULT = 0x0000, 152 DEV_PW_USER_SPECIFIED = 0x0001, 153 DEV_PW_MACHINE_SPECIFIED = 0x0002, 154 DEV_PW_REKEY = 0x0003, 155 DEV_PW_PUSHBUTTON = 0x0004, 156 DEV_PW_REGISTRAR_SPECIFIED = 0x0005, 157 DEV_PW_NFC_CONNECTION_HANDOVER = 0x0007, 158 DEV_PW_P2PS_DEFAULT = 0x0008 159 }; 160 161 /* Message Type */ 162 enum wps_msg_type { 163 WPS_Beacon = 0x01, 164 WPS_ProbeRequest = 0x02, 165 WPS_ProbeResponse = 0x03, 166 WPS_M1 = 0x04, 167 WPS_M2 = 0x05, 168 WPS_M2D = 0x06, 169 WPS_M3 = 0x07, 170 WPS_M4 = 0x08, 171 WPS_M5 = 0x09, 172 WPS_M6 = 0x0a, 173 WPS_M7 = 0x0b, 174 WPS_M8 = 0x0c, 175 WPS_WSC_ACK = 0x0d, 176 WPS_WSC_NACK = 0x0e, 177 WPS_WSC_DONE = 0x0f 178 }; 179 180 /* Authentication Type Flags */ 181 #define WPS_AUTH_OPEN 0x0001 182 #define WPS_AUTH_WPAPSK 0x0002 183 #define WPS_AUTH_SHARED 0x0004 /* deprecated */ 184 #define WPS_AUTH_WPA 0x0008 185 #define WPS_AUTH_WPA2 0x0010 186 #define WPS_AUTH_WPA2PSK 0x0020 187 #define WPS_AUTH_TYPES (WPS_AUTH_OPEN | WPS_AUTH_WPAPSK | WPS_AUTH_SHARED | \ 188 WPS_AUTH_WPA | WPS_AUTH_WPA2 | WPS_AUTH_WPA2PSK) 189 190 /* Encryption Type Flags */ 191 #define WPS_ENCR_NONE 0x0001 192 #define WPS_ENCR_WEP 0x0002 /* deprecated */ 193 #define WPS_ENCR_TKIP 0x0004 194 #define WPS_ENCR_AES 0x0008 195 #define WPS_ENCR_TYPES (WPS_ENCR_NONE | WPS_ENCR_WEP | WPS_ENCR_TKIP | \ 196 WPS_ENCR_AES) 197 198 /* Configuration Error */ 199 enum wps_config_error { 200 WPS_CFG_NO_ERROR = 0, 201 WPS_CFG_OOB_IFACE_READ_ERROR = 1, 202 WPS_CFG_DECRYPTION_CRC_FAILURE = 2, 203 WPS_CFG_24_CHAN_NOT_SUPPORTED = 3, 204 WPS_CFG_50_CHAN_NOT_SUPPORTED = 4, 205 WPS_CFG_SIGNAL_TOO_WEAK = 5, 206 WPS_CFG_NETWORK_AUTH_FAILURE = 6, 207 WPS_CFG_NETWORK_ASSOC_FAILURE = 7, 208 WPS_CFG_NO_DHCP_RESPONSE = 8, 209 WPS_CFG_FAILED_DHCP_CONFIG = 9, 210 WPS_CFG_IP_ADDR_CONFLICT = 10, 211 WPS_CFG_NO_CONN_TO_REGISTRAR = 11, 212 WPS_CFG_MULTIPLE_PBC_DETECTED = 12, 213 WPS_CFG_ROGUE_SUSPECTED = 13, 214 WPS_CFG_DEVICE_BUSY = 14, 215 WPS_CFG_SETUP_LOCKED = 15, 216 WPS_CFG_MSG_TIMEOUT = 16, 217 WPS_CFG_REG_SESS_TIMEOUT = 17, 218 WPS_CFG_DEV_PASSWORD_AUTH_FAILURE = 18, 219 WPS_CFG_60G_CHAN_NOT_SUPPORTED = 19, 220 WPS_CFG_PUBLIC_KEY_HASH_MISMATCH = 20 221 }; 222 223 /* Vendor specific Error Indication for WPS event messages */ 224 enum wps_error_indication { 225 WPS_EI_NO_ERROR, 226 WPS_EI_SECURITY_TKIP_ONLY_PROHIBITED, 227 WPS_EI_SECURITY_WEP_PROHIBITED, 228 WPS_EI_AUTH_FAILURE, 229 NUM_WPS_EI_VALUES 230 }; 231 232 /* RF Bands */ 233 #define WPS_RF_24GHZ 0x01 234 #define WPS_RF_50GHZ 0x02 235 236 /* Config Methods */ 237 #define WPS_CONFIG_USBA 0x0001 238 #define WPS_CONFIG_ETHERNET 0x0002 239 #define WPS_CONFIG_LABEL 0x0004 240 #define WPS_CONFIG_DISPLAY 0x0008 241 #define WPS_CONFIG_EXT_NFC_TOKEN 0x0010 242 #define WPS_CONFIG_INT_NFC_TOKEN 0x0020 243 #define WPS_CONFIG_NFC_INTERFACE 0x0040 244 #define WPS_CONFIG_PUSHBUTTON 0x0080 245 #define WPS_CONFIG_KEYPAD 0x0100 246 #define WPS_CONFIG_VIRT_PUSHBUTTON 0x0280 247 #define WPS_CONFIG_PHY_PUSHBUTTON 0x0480 248 #define WPS_CONFIG_P2PS 0x1000 249 #define WPS_CONFIG_VIRT_DISPLAY 0x2008 250 #define WPS_CONFIG_PHY_DISPLAY 0x4008 251 252 /* Connection Type Flags */ 253 #define WPS_CONN_ESS 0x01 254 #define WPS_CONN_IBSS 0x02 255 256 /* Wi-Fi Protected Setup State */ 257 enum wps_state { 258 WPS_STATE_NOT_CONFIGURED = 1, 259 WPS_STATE_CONFIGURED = 2 260 }; 261 262 /* Association State */ 263 enum wps_assoc_state { 264 WPS_ASSOC_NOT_ASSOC = 0, 265 WPS_ASSOC_CONN_SUCCESS = 1, 266 WPS_ASSOC_CFG_FAILURE = 2, 267 WPS_ASSOC_FAILURE = 3, 268 WPS_ASSOC_IP_FAILURE = 4 269 }; 270 271 272 #define WPS_DEV_OUI_WFA 0x0050f204 273 274 enum wps_dev_categ { 275 WPS_DEV_COMPUTER = 1, 276 WPS_DEV_INPUT = 2, 277 WPS_DEV_PRINTER = 3, 278 WPS_DEV_CAMERA = 4, 279 WPS_DEV_STORAGE = 5, 280 WPS_DEV_NETWORK_INFRA = 6, 281 WPS_DEV_DISPLAY = 7, 282 WPS_DEV_MULTIMEDIA = 8, 283 WPS_DEV_GAMING = 9, 284 WPS_DEV_PHONE = 10, 285 WPS_DEV_AUDIO = 11, 286 }; 287 288 enum wps_dev_subcateg { 289 WPS_DEV_COMPUTER_PC = 1, 290 WPS_DEV_COMPUTER_SERVER = 2, 291 WPS_DEV_COMPUTER_MEDIA_CENTER = 3, 292 WPS_DEV_COMPUTER_ULTRA_MOBILE = 4, 293 WPS_DEV_COMPUTER_NOTEBOOK = 5, 294 WPS_DEV_COMPUTER_DESKTOP = 6, 295 WPS_DEV_COMPUTER_MID = 7, 296 WPS_DEV_COMPUTER_NETBOOK = 8, 297 WPS_DEV_COMPUTER_TABLET = 9, 298 WPS_DEV_INPUT_KEYBOARD = 1, 299 WPS_DEV_INPUT_MOUSE = 2, 300 WPS_DEV_INPUT_JOYSTICK = 3, 301 WPS_DEV_INPUT_TRACKBALL = 4, 302 WPS_DEV_INPUT_GAMING = 5, 303 WPS_DEV_INPUT_REMOTE = 6, 304 WPS_DEV_INPUT_TOUCHSCREEN = 7, 305 WPS_DEV_INPUT_BIOMETRIC_READER = 8, 306 WPS_DEV_INPUT_BARCODE_READER = 9, 307 WPS_DEV_PRINTER_PRINTER = 1, 308 WPS_DEV_PRINTER_SCANNER = 2, 309 WPS_DEV_PRINTER_FAX = 3, 310 WPS_DEV_PRINTER_COPIER = 4, 311 WPS_DEV_PRINTER_ALL_IN_ONE = 5, 312 WPS_DEV_CAMERA_DIGITAL_STILL_CAMERA = 1, 313 WPS_DEV_CAMERA_VIDEO = 2, 314 WPS_DEV_CAMERA_WEB = 3, 315 WPS_DEV_CAMERA_SECURITY = 4, 316 WPS_DEV_STORAGE_NAS = 1, 317 WPS_DEV_NETWORK_INFRA_AP = 1, 318 WPS_DEV_NETWORK_INFRA_ROUTER = 2, 319 WPS_DEV_NETWORK_INFRA_SWITCH = 3, 320 WPS_DEV_NETWORK_INFRA_GATEWAY = 4, 321 WPS_DEV_NETWORK_INFRA_BRIDGE = 5, 322 WPS_DEV_DISPLAY_TV = 1, 323 WPS_DEV_DISPLAY_PICTURE_FRAME = 2, 324 WPS_DEV_DISPLAY_PROJECTOR = 3, 325 WPS_DEV_DISPLAY_MONITOR = 4, 326 WPS_DEV_MULTIMEDIA_DAR = 1, 327 WPS_DEV_MULTIMEDIA_PVR = 2, 328 WPS_DEV_MULTIMEDIA_MCX = 3, 329 WPS_DEV_MULTIMEDIA_SET_TOP_BOX = 4, 330 WPS_DEV_MULTIMEDIA_MEDIA_SERVER = 5, 331 WPS_DEV_MULTIMEDIA_PORTABLE_VIDEO_PLAYER = 6, 332 WPS_DEV_GAMING_XBOX = 1, 333 WPS_DEV_GAMING_XBOX360 = 2, 334 WPS_DEV_GAMING_PLAYSTATION = 3, 335 WPS_DEV_GAMING_GAME_CONSOLE = 4, 336 WPS_DEV_GAMING_PORTABLE_DEVICE = 5, 337 WPS_DEV_PHONE_WINDOWS_MOBILE = 1, 338 WPS_DEV_PHONE_SINGLE_MODE = 2, 339 WPS_DEV_PHONE_DUAL_MODE = 3, 340 WPS_DEV_PHONE_SP_SINGLE_MODE = 4, 341 WPS_DEV_PHONE_SP_DUAL_MODE = 5, 342 WPS_DEV_AUDIO_TUNER_RECV = 1, 343 WPS_DEV_AUDIO_SPEAKERS = 2, 344 WPS_DEV_AUDIO_PMP = 3, 345 WPS_DEV_AUDIO_HEADSET = 4, 346 WPS_DEV_AUDIO_HEADPHONES = 5, 347 WPS_DEV_AUDIO_MICROPHONE = 6, 348 WPS_DEV_AUDIO_HOME_THEATRE = 7, 349 }; 350 351 352 /* Request Type */ 353 enum wps_request_type { 354 WPS_REQ_ENROLLEE_INFO = 0, 355 WPS_REQ_ENROLLEE = 1, 356 WPS_REQ_REGISTRAR = 2, 357 WPS_REQ_WLAN_MANAGER_REGISTRAR = 3 358 }; 359 360 /* Response Type */ 361 enum wps_response_type { 362 WPS_RESP_ENROLLEE_INFO = 0, 363 WPS_RESP_ENROLLEE = 1, 364 WPS_RESP_REGISTRAR = 2, 365 WPS_RESP_AP = 3 366 }; 367 368 /* Walk Time for push button configuration (in seconds) */ 369 #define WPS_PBC_WALK_TIME 120 370 371 #define WPS_MAX_AUTHORIZED_MACS 5 372 373 #endif /* WPS_DEFS_H */ 374