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