//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// 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_
//=========================================================
// 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)
#ifdef WB_LINUX
#define UNALIGNED
#endif
//========================================================
typedef enum enum_PowerManagementMode
{
ACTIVE = 0,
POWER_SAVE
} WB_PM_Mode, *PWB_PM_MODE;
//===================================================================
// 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
typedef struct _SUITE_SELECTOR_
{
union
{
u8 Value[4];
struct _SUIT_
{
u8 OUI[3];
u8 Type;
}SuitSelector;
};
}SUITE_SELECTOR;
//-- WPA --
struct RSN_Information_Element
{
u8 Element_ID;
u8 Length;
UNALIGNED SUITE_SELECTOR OuiWPAAdditional;//WPA version 2.0 additional field, and should be 00:50:F2:01
u16 Version;
SUITE_SELECTOR GroupKeySuite;
u16 PairwiseKeySuiteCount;
SUITE_SELECTOR PairwiseKeySuite[1];
}__attribute__ ((packed));
struct RSN_Auth_Sub_Information_Element
{
u16 AuthKeyMngtSuiteCount;
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_
typedef struct _PMKID
{
u8 pValue[16];
}PMKID;
struct WPA2_RSN_Information_Element
{
u8 Element_ID;
u8 Length;
u16 Version;
SUITE_SELECTOR GroupKeySuite;
u16 PairwiseKeySuiteCount;
SUITE_SELECTOR PairwiseKeySuite[1];
}__attribute__ ((packed));
struct WPA2_RSN_Auth_Sub_Information_Element
{
u16 AuthKeyMngtSuiteCount;
SUITE_SELECTOR AuthKeyMngtSuite[1];
}__attribute__ ((packed));
struct PMKID_Information_Element
{
u16 PMKID_Count;
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_