/*++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ // MAC_Structures.h // // This file contains the definitions and data structures used by SW-MAC. // // Revision Histoy //================= // 0.1 2002 UN00 // 0.2 20021004 PD43 CCLiu6 // 20021018 PD43 CCLiu6 // Add enum_TxRate type // Modify enum_STAState type // 0.3 20021023 PE23 CYLiu update MAC session struct // 20021108 // 20021122 PD43 Austin // Deleted some unused. // 20021129 PD43 Austin // 20030617 increase the 802.11g definition //++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++*/ #ifndef _MAC_Structures_H_ #define _MAC_Structures_H_ #include /*========================================================= // Some miscellaneous definitions //-----*/ #define MAX_CHANNELS 30 #define MAC_ADDR_LENGTH 6 #define MAX_WEP_KEY_SIZE 16 /* 128 bits */ #define MAX_802_11_FRAGMENT_NUMBER 10 /* By spec */ /* ======================================================== // 802.11 Frame define //----- */ #define MASK_PROTOCOL_VERSION_TYPE 0x0F #define MASK_FRAGMENT_NUMBER 0x000F #define SEQUENCE_NUMBER_SHIFT 4 #define DIFFER_11_TO_3 18 #define DOT_11_MAC_HEADER_SIZE 24 #define DOT_11_SNAP_SIZE 6 #define DOT_11_DURATION_OFFSET 2 #define DOT_11_SEQUENCE_OFFSET 22 /* Sequence control offset */ #define DOT_11_TYPE_OFFSET 30 /* The start offset of 802.11 Frame// */ #define DOT_11_DATA_OFFSET 24 #define DOT_11_DA_OFFSET 4 #define DOT_3_TYPE_ARP 0x80F3 #define DOT_3_TYPE_IPX 0x8137 #define DOT_3_TYPE_OFFSET 12 #define ETHERNET_HEADER_SIZE 14 #define MAX_ETHERNET_PACKET_SIZE 1514 /* ----- management : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7) */ #define MAC_SUBTYPE_MNGMNT_ASSOC_REQUEST 0x00 #define MAC_SUBTYPE_MNGMNT_ASSOC_RESPONSE 0x10 #define MAC_SUBTYPE_MNGMNT_REASSOC_REQUEST 0x20 #define MAC_SUBTYPE_MNGMNT_REASSOC_RESPONSE 0x30 #define MAC_SUBTYPE_MNGMNT_PROBE_REQUEST 0x40 #define MAC_SUBTYPE_MNGMNT_PROBE_RESPONSE 0x50 #define MAC_SUBTYPE_MNGMNT_BEACON 0x80 #define MAC_SUBTYPE_MNGMNT_ATIM 0x90 #define MAC_SUBTYPE_MNGMNT_DISASSOCIATION 0xA0 #define MAC_SUBTYPE_MNGMNT_AUTHENTICATION 0xB0 #define MAC_SUBTYPE_MNGMNT_DEAUTHENTICATION 0xC0 /* ----- control : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7) */ #define MAC_SUBTYPE_CONTROL_PSPOLL 0xA4 #define MAC_SUBTYPE_CONTROL_RTS 0xB4 #define MAC_SUBTYPE_CONTROL_CTS 0xC4 #define MAC_SUBTYPE_CONTROL_ACK 0xD4 #define MAC_SUBTYPE_CONTROL_CFEND 0xE4 #define MAC_SUBTYPE_CONTROL_CFEND_CFACK 0xF4 /* ----- data : Type of Bits (2, 3) and Subtype of Bits (4, 5, 6, 7) */ #define MAC_SUBTYPE_DATA 0x08 #define MAC_SUBTYPE_DATA_CFACK 0x18 #define MAC_SUBTYPE_DATA_CFPOLL 0x28 #define MAC_SUBTYPE_DATA_CFACK_CFPOLL 0x38 #define MAC_SUBTYPE_DATA_NULL 0x48 #define MAC_SUBTYPE_DATA_CFACK_NULL 0x58 #define MAC_SUBTYPE_DATA_CFPOLL_NULL 0x68 #define MAC_SUBTYPE_DATA_CFACK_CFPOLL_NULL 0x78 /* ----- Frame Type of Bits (2, 3) */ #define MAC_TYPE_MANAGEMENT 0x00 #define MAC_TYPE_CONTROL 0x04 #define MAC_TYPE_DATA 0x08 /* ----- definitions for Management Frame Element ID (1 BYTE) */ #define ELEMENT_ID_SSID 0 #define ELEMENT_ID_SUPPORTED_RATES 1 #define ELEMENT_ID_FH_PARAMETER_SET 2 #define ELEMENT_ID_DS_PARAMETER_SET 3 #define ELEMENT_ID_CF_PARAMETER_SET 4 #define ELEMENT_ID_TIM 5 #define ELEMENT_ID_IBSS_PARAMETER_SET 6 // 7~15 reserverd #define ELEMENT_ID_CHALLENGE_TEXT 16 // 17~31 reserved for challenge text extension // 32~255 reserved //-- 11G -- #define ELEMENT_ID_ERP_INFORMATION 42 #define ELEMENT_ID_EXTENDED_SUPPORTED_RATES 50 //-- WPA -- #define ELEMENT_ID_RSN_WPA 221 #ifdef _WPA2_ #define ELEMENT_ID_RSN_WPA2 48 #endif //endif WPA2 #define WLAN_MAX_PAIRWISE_CIPHER_SUITE_COUNT ((u16) 6) #define WLAN_MAX_AUTH_KEY_MGT_SUITE_LIST_COUNT ((u16) 2) //=================================================================== // Reason Code (Table 18): indicate the reason of DisAssoc, DeAuthen // length of ReasonCode is 2 Octs. //=================================================================== #define REASON_REASERED 0 #define REASON_UNSPECIDIED 1 #define REASON_PREAUTH_INVALID 2 #define DEAUTH_REASON_LEFT_BSS 3 #define DISASS_REASON_AP_INACTIVE 4 #define DISASS_REASON_AP_BUSY 5 #define REASON_CLASS2_FRAME_FROM_NONAUTH_STA 6 #define REASON_CLASS3_FRAME_FROM_NONASSO_STA 7 #define DISASS_REASON_LEFT_BSS 8 #define REASON_NOT_AUTH_YET 9 /* 802.11i define */ #define REASON_INVALID_IE 13 #define REASON_MIC_ERROR 14 #define REASON_4WAY_HANDSHAKE_TIMEOUT 15 #define REASON_GROUPKEY_UPDATE_TIMEOUT 16 #define REASON_IE_DIFF_4WAY_ASSOC 17 #define REASON_INVALID_MULTICAST_CIPHER 18 #define REASON_INVALID_UNICAST_CIPHER 19 #define REASON_INVALID_AKMP 20 #define REASON_UNSUPPORTED_RSNIE_VERSION 21 #define REASON_INVALID_RSNIE_CAPABILITY 22 #define REASON_802_1X_AUTH_FAIL 23 #define REASON_CIPHER_REJECT_PER_SEC_POLICY 14 /* //=========================================================== // enum_MMPDUResultCode -- // Status code (2 Octs) in the MMPDU's frame body. Table.19 // //=========================================================== enum enum_MMPDUResultCode { // SUCCESS = 0, // Redefined UNSPECIFIED_FAILURE = 1, // 2 - 9 Reserved NOT_SUPPROT_CAPABILITIES = 10, //REASSOCIATION_DENIED // REASSOC_DENIED_UNABLE_CFM_ASSOC_EXIST = 11, //ASSOCIATION_DENIED_NOT_IN_STANDARD // ASSOC_DENIED_REASON_NOT_IN_STANDARD = 12, PEER_NOT_SUPPORT_AUTH_ALGORITHM = 13, AUTH_SEQNUM_OUT_OF_EXPECT = 14, AUTH_REJECT_REASON_CHALLENGE_FAIL = 15, AUTH_REJECT_REASON_WAIT_TIMEOUT = 16, ASSOC_DENIED_REASON_AP_BUSY = 17, ASSOC_DENIED_REASON_NOT_SUPPORT_BASIC_RATE = 18 } WB_MMPDURESULTCODE, *PWB_MMPDURESULTCODE; */ /*=========================================================== // enum_TxRate -- // Define the transmission constants based on W89C32 MAC // target specification. //===========================================================*/ typedef enum enum_TxRate { TXRATE_1M = 0, TXRATE_2MLONG = 2, TXRATE_2MSHORT = 3, TXRATE_55MLONG = 4, TXRATE_55MSHORT = 5, TXRATE_11MLONG = 6, TXRATE_11MSHORT = 7, TXRATE_AUTO = 255 /* PD43 20021108 */ } WB_TXRATE, *PWB_TXRATE; #define RATE_BITMAP_1M 1 #define RATE_BITMAP_2M 2 #define RATE_BITMAP_5dot5M 5 #define RATE_BITMAP_6M 6 #define RATE_BITMAP_9M 9 #define RATE_BITMAP_11M 11 #define RATE_BITMAP_12M 12 #define RATE_BITMAP_18M 18 #define RATE_BITMAP_22M 22 #define RATE_BITMAP_24M 24 #define RATE_BITMAP_33M 17 #define RATE_BITMAP_36M 19 #define RATE_BITMAP_48M 25 #define RATE_BITMAP_54M 28 #define RATE_AUTO 0 #define RATE_1M 2 #define RATE_2M 4 #define RATE_5dot5M 11 #define RATE_6M 12 #define RATE_9M 18 #define RATE_11M 22 #define RATE_12M 24 #define RATE_18M 36 #define RATE_22M 44 #define RATE_24M 48 #define RATE_33M 66 #define RATE_36M 72 #define RATE_48M 96 #define RATE_54M 108 #define RATE_MAX 255 /* CAPABILITY */ #define CAPABILITY_ESS_BIT 0x0001 #define CAPABILITY_IBSS_BIT 0x0002 #define CAPABILITY_CF_POLL_BIT 0x0004 #define CAPABILITY_CF_POLL_REQ_BIT 0x0008 #define CAPABILITY_PRIVACY_BIT 0x0010 #define CAPABILITY_SHORT_PREAMBLE_BIT 0x0020 #define CAPABILITY_PBCC_BIT 0x0040 #define CAPABILITY_CHAN_AGILITY_BIT 0x0080 #define CAPABILITY_SHORT_SLOT_TIME_BIT 0x0400 #define CAPABILITY_DSSS_OFDM_BIT 0x2000 struct Capability_Information_Element { union { u16 __attribute__ ((packed)) wValue; #ifdef _BIG_ENDIAN_ /* 20060926 add by anson's endian */ struct _Capability { /* -- 11G -- */ u8 Reserved3:2; u8 DSSS_OFDM:1; u8 Reserved2:2; u8 Short_Slot_Time:1; u8 Reserved1:2; u8 Channel_Agility:1; u8 PBCC:1; u8 ShortPreamble:1; u8 CF_Privacy:1; u8 CF_Poll_Request:1; u8 CF_Pollable:1; u8 IBSS:1; u8 ESS:1; } __attribute__ ((packed)) Capability; #else struct _Capability { u8 ESS:1; u8 IBSS:1; u8 CF_Pollable:1; u8 CF_Poll_Request:1; u8 CF_Privacy:1; u8 ShortPreamble:1; u8 PBCC:1; u8 Channel_Agility:1; u8 Reserved1:2; /* -- 11G -- */ u8 Short_Slot_Time:1; u8 Reserved2:2; u8 DSSS_OFDM:1; u8 Reserved3:2; } __attribute__ ((packed)) Capability; #endif } __attribute__ ((packed)) ; } __attribute__ ((packed)); struct FH_Parameter_Set_Element { u8 Element_ID; u8 Length; u8 Dwell_Time[2]; u8 Hop_Set; u8 Hop_Pattern; u8 Hop_Index; }; struct DS_Parameter_Set_Element { u8 Element_ID; u8 Length; u8 Current_Channel; }; struct Supported_Rates_Element { u8 Element_ID; u8 Length; u8 SupportedRates[8]; } __attribute__ ((packed)); struct SSID_Element { u8 Element_ID; u8 Length; u8 SSID[32]; } __attribute__ ((packed)) ; struct CF_Parameter_Set_Element { u8 Element_ID; u8 Length; u8 CFP_Count; u8 CFP_Period; u8 CFP_MaxDuration[2]; /* in Time Units */ u8 CFP_DurRemaining[2]; /* in time units */ }; struct TIM_Element { u8 Element_ID; u8 Length; u8 DTIM_Count; u8 DTIM_Period; u8 Bitmap_Control; u8 Partial_Virtual_Bitmap[251]; }; struct IBSS_Parameter_Set_Element { u8 Element_ID; u8 Length; u8 ATIM_Window[2]; }; struct Challenge_Text_Element { u8 Element_ID; u8 Length; u8 Challenge_Text[253]; }; struct PHY_Parameter_Set_Element { /* int aSlotTime; */ /* int aSifsTime; */ s32 aCCATime; s32 aRxTxTurnaroundTime; s32 aTxPLCPDelay; s32 RxPLCPDelay; s32 aRxTxSwitchTime; s32 aTxRampOntime; s32 aTxRampOffTime; s32 aTxRFDelay; s32 aRxRFDelay; s32 aAirPropagationTime; s32 aMACProcessingDelay; s32 aPreambleLength; s32 aPLCPHeaderLength; s32 aMPDUDurationFactor; s32 aMPDUMaxLength; /* int aCWmin; */ /* int aCWmax; */ }; /* -- 11G -- */ struct ERP_Information_Element { u8 Element_ID; u8 Length; #ifdef _BIG_ENDIAN_ /* 20060926 add by anson's endian */ u8 Reserved:5; /* 20060926 add by anson */ u8 Barker_Preamble_Mode:1; u8 Use_Protection:1; u8 NonERP_Present:1; #else u8 NonERP_Present:1; u8 Use_Protection:1; u8 Barker_Preamble_Mode:1; u8 Reserved:5; #endif }; struct Extended_Supported_Rates_Element { u8 Element_ID; u8 Length; u8 ExtendedSupportedRates[255]; } __attribute__ ((packed)); /* WPA(802.11i draft 3.0) */ #define VERSION_WPA 1 #ifdef _WPA2_ #define VERSION_WPA2 1 #endif /* end def _WPA2_ */ #define OUI_WPA 0x00F25000 /* WPA2.0 OUI=00:50:F2, the MSB is reserved for suite type */ #ifdef _WPA2_ #define OUI_WPA2 0x00AC0F00 /* for wpa2 change to 0x00ACOF04 by Ws 26/04/04 */ #endif /* end def _WPA2_ */ #define OUI_WPA_ADDITIONAL 0x01 #define WLAN_MIN_RSN_WPA_LENGTH 6 /* added by ws 09/10/04 */ #ifdef _WPA2_ #define WLAN_MIN_RSN_WPA2_LENGTH 2 /* Fix to 2 09/14/05 */ #endif /* end def _WPA2_ */ #define oui_wpa (u32)(OUI_WPA|OUI_WPA_ADDITIONAL) #define WPA_OUI_BIG ((u32) 0x01F25000)/* added by ws 09/23/04 */ #define WPA_OUI_LITTLE ((u32) 0x01F25001)/* added by ws 09/23/04 */ #define WPA_WPS_OUI cpu_to_le32(0x04F25000) /* 20061108 For WPS. It's little endian. Big endian is 0x0050F204 */ /* -----WPA2----- */ #ifdef _WPA2_ #define WPA2_OUI_BIG ((u32)0x01AC0F00) #define WPA2_OUI_LITTLE ((u32)0x01AC0F01) #endif /* end def _WPA2_ */ /* Authentication suite */ #define OUI_AUTH_WPA_NONE 0x00 /* for WPA_NONE */ #define OUI_AUTH_8021X 0x01 #define OUI_AUTH_PSK 0x02 /* Cipher suite */ #define OUI_CIPHER_GROUP_KEY 0x00 /* added by ws 05/21/04 */ #define OUI_CIPHER_WEP_40 0x01 #define OUI_CIPHER_TKIP 0x02 #define OUI_CIPHER_CCMP 0x04 #define OUI_CIPHER_WEP_104 0x05 struct suite_selector { union { u8 Value[4]; struct _SUIT_ { u8 OUI[3]; u8 Type; }SuitSelector; }; }; //-- WPA -- struct RSN_Information_Element { u8 Element_ID; u8 Length; struct suite_selector OuiWPAAdditional; /* WPA version 2.0 additional field, and should be 00:50:F2:01 */ u16 Version; struct suite_selector GroupKeySuite; u16 PairwiseKeySuiteCount; struct suite_selector PairwiseKeySuite[1]; }__attribute__ ((packed)); struct RSN_Auth_Sub_Information_Element { u16 AuthKeyMngtSuiteCount; struct suite_selector AuthKeyMngtSuite[1]; }__attribute__ ((packed)); /* -- WPA2 -- */ struct RSN_Capability_Element { union { u16 __attribute__ ((packed)) wValue; #ifdef _BIG_ENDIAN_ /* 20060927 add by anson's endian */ struct _RSN_Capability { u16 __attribute__ ((packed)) Reserved2 : 8; /* 20051201 */ u16 __attribute__ ((packed)) Reserved1 : 2; u16 __attribute__ ((packed)) GTK_Replay_Counter : 2; u16 __attribute__ ((packed)) PTK_Replay_Counter : 2; u16 __attribute__ ((packed)) No_Pairwise : 1; u16 __attribute__ ((packed)) Pre_Auth : 1; }__attribute__ ((packed)) RSN_Capability; #else struct _RSN_Capability { u16 __attribute__ ((packed)) Pre_Auth : 1; u16 __attribute__ ((packed)) No_Pairwise : 1; u16 __attribute__ ((packed)) PTK_Replay_Counter : 2; u16 __attribute__ ((packed)) GTK_Replay_Counter : 2; u16 __attribute__ ((packed)) Reserved1 : 2; u16 __attribute__ ((packed)) Reserved2 : 8; /* 20051201 */ }__attribute__ ((packed)) RSN_Capability; #endif }__attribute__ ((packed)) ; }__attribute__ ((packed)) ; #ifdef _WPA2_ struct pmkid { u8 pValue[16]; }; struct WPA2_RSN_Information_Element { u8 Element_ID; u8 Length; u16 Version; struct suite_selector GroupKeySuite; u16 PairwiseKeySuiteCount; struct suite_selector PairwiseKeySuite[1]; }__attribute__ ((packed)); struct WPA2_RSN_Auth_Sub_Information_Element { u16 AuthKeyMngtSuiteCount; struct suite_selector AuthKeyMngtSuite[1]; }__attribute__ ((packed)); struct PMKID_Information_Element { u16 PMKID_Count; struct pmkid pmkid[16]; }__attribute__ ((packed)); #endif /* enddef _WPA2_ */ /*============================================================ // MAC Frame structure (different type) and subfield structure //============================================================*/ struct MAC_frame_control { u8 mac_frame_info; /* a combination of the [Protocol Version, Control Type, Control Subtype]*/ #ifdef _BIG_ENDIAN_ /* 20060927 add by anson's endian */ u8 order:1; u8 WEP:1; u8 more_data:1; u8 pwr_mgt:1; u8 retry:1; u8 more_frag:1; u8 from_ds:1; u8 to_ds:1; #else u8 to_ds:1; u8 from_ds:1; u8 more_frag:1; u8 retry:1; u8 pwr_mgt:1; u8 more_data:1; u8 WEP:1; u8 order:1; #endif } __attribute__ ((packed)); struct Management_Frame { struct MAC_frame_control frame_control; /* 2B, ToDS,FromDS,MoreFrag,MoreData,Order=0 */ u16 duration; u8 DA[MAC_ADDR_LENGTH]; /* Addr1 */ u8 SA[MAC_ADDR_LENGTH]; /* Addr2 */ u8 BSSID[MAC_ADDR_LENGTH]; /* Addr3 */ u16 Sequence_Control; /* Management Frame Body <= 325 bytes */ /* FCS 4 bytes */ } __attribute__ ((packed)); /* SW-MAC don't Tx/Rx Control-Frame, HW-MAC do it. */ struct Control_Frame { struct MAC_frame_control frame_control; /* ToDS,FromDS,MoreFrag,Retry,MoreData,WEP,Order=0 */ u16 duration; u8 RA[MAC_ADDR_LENGTH]; u8 TA[MAC_ADDR_LENGTH]; u16 FCS; } __attribute__ ((packed)); struct Data_Frame { struct MAC_frame_control frame_control; u16 duration; u8 Addr1[MAC_ADDR_LENGTH]; u8 Addr2[MAC_ADDR_LENGTH]; u8 Addr3[MAC_ADDR_LENGTH]; u16 Sequence_Control; u8 Addr4[MAC_ADDR_LENGTH]; /* only exist when ToDS=FromDS=1 */ /* Data Frame Body <= 2312 */ /* FCS */ } __attribute__ ((packed)); struct Disassociation_Frame_Body { u16 reasonCode; } __attribute__ ((packed)); struct Association_Request_Frame_Body { u16 capability_information; u16 listenInterval; u8 Current_AP_Address[MAC_ADDR_LENGTH];/* for reassociation only */ /* SSID (2+32 bytes) */ /* Supported_Rates (2+8 bytes) */ } __attribute__ ((packed)); struct Association_Response_Frame_Body { u16 capability_information; u16 statusCode; u16 Association_ID; struct Supported_Rates_Element supportedRates; } __attribute__ ((packed)); /*struct Reassociation_Request_Frame_Body { u16 capability_information; u16 listenInterval; u8 Current_AP_Address[MAC_ADDR_LENGTH]; // SSID (2+32 bytes) // Supported_Rates (2+8 bytes) };*/ /* eliminated by WS 07/22/04 comboined with associateion request frame. */ struct Reassociation_Response_Frame_Body { u16 capability_information; u16 statusCode; u16 Association_ID; struct Supported_Rates_Element supportedRates; } __attribute__ ((packed)); struct Deauthentication_Frame_Body { u16 reasonCode; } __attribute__ ((packed)); struct Probe_Response_Frame_Body { u16 Timestamp; u16 Beacon_Interval; u16 Capability_Information; /* SSID // Supported_Rates // PHY parameter Set (DS Parameters) // CF parameter Set // IBSS parameter Set */ } __attribute__ ((packed)); struct Authentication_Frame_Body { u16 algorithmNumber; u16 sequenceNumber; u16 statusCode; /* NB: don't include ChallengeText in this structure // struct Challenge_Text_Element sChallengeTextElement; // wkchen added */ } __attribute__ ((packed)); #endif /* _MAC_Structure_H_ */