/*

* Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:   Header file mainly for 802.11 specific declarations and 

*                definitions.

*

*/

#ifndef WLAN802DOT11_H

#define WLAN802DOT11_H

// for copy, equal and operator != support

#include "algorithm.h"

#include "pack.h"

// returns aDest

extern 

TAny* os_memcpy( TAny* aDest, const TAny* aSrc, TUint32 aLengthinBytes );

// returns 0 if equal

extern TInt 

os_memcmp( const TAny* aSrc1, const TAny* aSrc2, TUint aLengthinBytes );

/**

 * Returns a TUint16 host byte order value in WLAN MAC layer byte order 

 * (LSB first)

 *

 * @since S60 3.1

 * @param aNw value in network byte order

 * @return value in host byte order

 */

extern TUint16 os_Hton( TUint16 aHost );

/**

 * Returns a TUint16 WLAN MAC layer byte order (LSB first) value in host byte 

 * order

 *

 * @since S60 3.1

 * @param aNw value in network byte order

 * @return value in host byte order

 */

extern TUint16 os_Ntoh( TUint16 aNw );

/**

 * Allows also unaligned reading of a TUint16 WLAN MAC layer byte order 

 * (LSB first) value and returns the result in the byte order which

 * is in use in the host

 *

 * @since S60 3.1

 * @param aNwSource where to read the WLAN MAC layer byte order value from

 * @return the value which was read, in host byte order

 */

inline TUint16 ReadUint16Toh( const TUint16* aNwSource )

    {

    return ( os_Ntoh( 

        ( static_cast<const TUint16>( 

            ( reinterpret_cast<const TUint8*>(aNwSource) )[0] ) | 

         ( static_cast<const TUint16>(

            ( reinterpret_cast<const TUint8*>(aNwSource) )[1] ) << 8 ) ) ) );

    }

/**

 * Allows also unaligned writing of a TUint16 host byte order value

 * into WLAN MAC layer byte order

 *

 * @since S60 3.1

 * @param aNwTarget where to write the WLAN MAC layer byte order value to

 * @param aHostValue the host byte order value to be written

 */

inline void WriteHtoUint16( TUint16* aNwTarget, TUint16 aHostValue )

    {

    TUint16 nwValue = os_Hton( aHostValue );

    reinterpret_cast<TUint8*>(aNwTarget)[0] = 

        ( reinterpret_cast<TUint8*>(&nwValue) )[0];

    reinterpret_cast<TUint8*>(aNwTarget)[1] = 

        ( reinterpret_cast<TUint8*>(&nwValue) )[1];

    }

/**

 * Reverses the byte order of a TUint16 value

 *

 * @since S60 3.1

 * @param aOriginal value whose byte order is to be reversed

 * @return the input parameter in reversed byte order

 */

inline TUint16 ReverseUint16( TUint16 aOriginal )

    {

    return ( ( aOriginal >> 8 ) | ( aOriginal << 8 ) );

    }

/**

* A measurement of time equal to 1024 µs.

*/

const TUint16 KTU = 1024;

/**

* Length of the MAC address

*/

const TUint8 KMacAddressLength = 6;

/**

* Length of MAC header

*/

const TUint8 KMacHeaderLength = 24;

/**

* Maximum number of 802.11b supported rates 

* 1, 2, 5.5, 11 MBit/s

*/

const TUint8 KMaxNumberOfDot11bRates = 4; 

/**

* Maximum number of actual supported rate elements in 

* supported rates information element

*/

const TUint8 KMaxNumberOfRates = 8;

/**

* Maximum number of actual 802.11 supported rate elements in 

* extended supported rates information element

*/

const TUint8 KMaxNumberOfExtendedRates = 255;

/**

* Maximum number of 802.11b plus 802.11g supported rates 

*/

const TUint8 KMaxNumberOfDot11bAndgRates = 14; 

/**

* Bit mask for checking is supported rate element 

* part of BSS Basic Rate Set (MSB bit is set)

*/

const TUint8 KBasicRateMask = 0x80;

/**

* Maximum length for a WEP key in BYTES

*/

const TUint32 KMaxWEPKeyLength = 29;    // 232 bits

/**

* Length of TKIP key;

*/

const TUint8 KTKIPKeyLength = 16;

/**

* Length of WEP Init.Vector in BYTES

*/

const TUint8 KWepIVLength = 4;

/**

* Length of WEP ICV in BYTES

*/

const TUint8 KWEPICVLength = 4;

/**

* Length of Extended IV field in bytes.

*/

const TUint8 KWepExtendedIVLength = 4;

/**

* Mask to determine is Ext IV bit up in WEP IV

*/

const TUint32 KWepExtendedIvMask = 0x20000000;

/**

* Mask for Use Protection bit in ERP Information IE

*/

const TUint8 KUseProtectionMask = 0x02;

/**

* Length of MIC in BYTEs

*/

const TUint8 KMicLength = 8;

/** 

* Length of the MIC key in BYTEs

*/ 

const TUint8 KMicKeyLength = 8;

/**

* Maximum length of a SSID in BYTES

*/

const TUint8 KMaxSSIDLength = 32;

/**

* Maximum length of an outbound RSN IE length in BYTEs

*/

const TUint8 KMaxTxRsnIELength = 38;

/**

* Length of ID and Length fields of an information element.

*/

const TUint8 KInfoElementHeaderLength = 2;

/**

* Length of the challenge text in BYTES used in shared key authentication

*/

const TUint8 KChallengeTextLength = 128;

/**

* Ethernet header type field identifier for Bounce type packet

*/

const TUint16 KBounceType = 0x8013;

/**

* Ethernet header type field identifier for EAPOL type packet (IEEE 802.1X)

*/

const TUint16 KEapolType = 0x888E;

/**

* Ethernet header type field identifier for IP type packet

*/

const TUint16 KIpType = 0x0800;

/**

* Ethernet header type field identifier for IPv6 type packet

*/

const TUint16 KIpv6Type = 0x86DD;

/**

* Ethernet header type field identifier for ARP type packet

*/

const TUint16 KArpType = 0x0806;

/**

* Maks for determining does PLCP header service field have PBCC bit set

*/

const TUint8 KPlcpServicePbccMask = 0x08;

/**

* Length of OUI field in SNAP header

*/

const TUint8 KOIULength = 3;

/**

* Maximum length of 802.11 Frame Body field

*/

const TUint16 KMaxDot11FrameBodyLength = 2312;

/**

* Length of trailing FCS in bytes

*/

const TUint32 KFcsLength = 4;

/**

* Maximum length of 802.11 frame we will transmit or receive.

* This excludes the tailing FCS ( HW strips it )

* and Address4 field in the MPDU header 

* ( AP-to-AP mode frames are filtered out )

*/

const TUint16 KMaxDot11FrameLength = KMacHeaderLength 

    + KMaxDot11FrameBodyLength; // 24 + 2312 = 2336

/**

* Maximum length of 802.11 frame as stated in the standard

*/

const TUint16 KDot11MPDUMaxLength = 2346;

/**

* Maximum length of ethernet frame

*/

const TUint16 KMaxEthernetFrameLength = 1514;

/**

* Maximum value in ethernet length field

*/

const TUint16 KMaxEthernetLengthFieldvalue = 1500;

/**

* Length of the TKIP key in BYTEs

*/

const TUint8 KTkIpKeyLength = 16;

/**

* Length of IPv4 address field in BYTEs

*/

const TUint8 KIpv4AddrLength = 4;

/**

* Length of the priority filed used in WPA MIC calculation

*/

const TUint32 KWpaPriorityVecLen = 4;

/**

* WPA priority field used in MIC calculation

*/

const TUint8 KWpaPriorityVec[KWpaPriorityVecLen] = {0,0,0,0};

/**

* Mask for frame type for frame control field.

*/

const TUint32 K802Dot11FrameTypeMask = 0xFFFF;

/**

* Mask to determine if U-APSD bit is up in QoS info field of WMM IE

*/

const TUint8 KUapsdQosInfoMask = 0x80;

/**

* Mask for parameter set count in QoS info field of WMM IE

*/

const TUint8 KParamSetCountQosInfoMask = 0x0F;

/**

* Length of WMM Information Element

*/

const TUint8 KWmmInfoElemLen = 7;

/**

* Length of OUI field in Information Elements

*/

const TUint8 KIeOuiLength = 3;

typedef TUint8 TIeOui[KIeOuiLength];

/**

* OUI value of WMM Information Element and

* WMM Parameter Element

*/

const TIeOui KWmmElemOui = { 0x00, 0x50, 0xF2 };

/**

* OUI Type value of WMM Information Element and

* WMM Parameter Element

*/

const TUint8 KWmmElemOuiType = 2;

/**

* OUI Subtype value of WMM Information Element

*/

const TUint8 KWmmInfoElemOuiSubType = 0;

/**

* OUI Subtype value of WMM Parameter Element

*/

const TUint8 KWmmParamElemOuiSubtype = 1;

/**

* Version of WMM Information Element

*/

const TUint8 KWmmInfoElemVersion = 1;

/**

* Version of WMM Parameter Element

*/

const TUint8 KWmmParamElemVersion = 1;

/**

* The TXOP Limit in the AC Parameters Record of WMM Parameter Element

* needs to be multiplied by this value to get TXOP Limit in microseconds

*/

const TUint8 KWmmTxOpLimitMultiplier = 32;

/**

* AC flags in QoS info field of WMM IE

* When a flag is set the corresponding AC is both trigger and delivery enabled

*/

enum TQosInfoUapsdFlag

    {

    EAcVoUapsdFlag = 0x01, // Voice 

    EAcViUapsdFlag = 0x02, // Video 

    EAcBkUapsdFlag = 0x04, // Background 

    EAcBeUapsdFlag = 0x08  // Best Effort 

    };

/**

* Maximum U-APSD Service Period length. Indicates the max number of MSDUs and 

* MMPDUs the WMM AP may deliver to a WMM STA during any service period 

* triggered by the WMM STA.

*/

enum TQosInfoUapsdMaxSpLen

    {

    EMaxSpLenAllFrames  = 0x00,

    EMaxSpLenTwoFrames  = 0x20,

    EMaxSpLenFourFrames = 0x40,

    EMaxSpLenSixFrames  = 0x60

    };

const TUint8 K802Dot11AccessCategoryMask = 0x60;

/**

* WMM Access Categories

*/

enum TWmmAccessCategory

    {

    EAcBestEffort   = 0x00, 

    EAcBackground   = 0x20,

    EAcVideo        = 0x40,

    EAcVoice        = 0x60

    };

/**

* Number of WMM Access Categories

*/

const TUint8 KNumOfWmmACs = 4;

/**

* Mask for the Admission Control Mandatory flag

* in ACI/AIFSN field

* of AC parameter Record

* of WMM Parameter Element

*/

const TUint8 KWmmAdmissionCtrlMandatoryMask = 0x10;

/**

* Mask for the AIFSN subfiled

* in ACI/AIFSN field

* of AC parameter Record

* of WMM Parameter Element

*/

const TUint8 KWmmAifsnMask = 0x0F;

/**

* Mask for the ECWmin field

* of AC parameter Record

* of WMM Parameter Element

*/

const TUint8 KWmmEcwMinMask = 0x0F;

/**

* Mask for the ECWmax field

* of AC parameter Record

* of WMM Parameter Element

*/

const TUint8 KWmmEcwMaxMask = 0xF0;

/**

* 802.11 Authentication sequence numbers

*/

enum T802Dot11AuthenticationSeqNmbr

    {

    E802Dot11AuthenticationSeqNmbr1   = 1,

    E802Dot11AuthenticationSeqNmbr2   = 2,

    E802Dot11AuthenticationSeqNmbr3   = 3,

    E802Dot11AuthenticationSeqNmbr4   = 4

    };

/**

* 802.11 WEP key ID values

*/

enum T802Dot11WepKeyId

    {

    E802Dot11WepKeyId0 = 0,

    E802Dot11WepKeyId1 = 1,

    E802Dot11WepKeyId2 = 2,

    E802Dot11WepKeyId3 = 3,

    // defined as an upper bound

    E802Dot11WepKeyIdMax = 4

    };

/**

* 802.11 supported rate bytes. Used e.g. in Beacon frames.

*/

enum T802Dot11SupportedRate

    {

    E802Dot11Rate1MBit              = 2,

    E802Dot11Rate2MBit              = 4,

    E802Dot11Rate5p5MBit            = 11,

    E802Dot11Rate6MBit              = 12,

    E802Dot11Rate9MBit              = 18,

    E802Dot11Rate11MBit             = 22,

    E802Dot11Rate12MBit             = 24,

    E802Dot11Rate18MBit             = 36,

    E802Dot11Rate22MBit             = 44,

    E802Dot11Rate24MBit             = 48,

    E802Dot11Rate33MBit             = 66,

    E802Dot11Rate36MBit             = 72,

    E802Dot11Rate48MBit             = 96,

    E802Dot11Rate54MBit             = 108

    };

/**

* Management frame information element IDs.

*/

enum T802Dot11InformationElementID

    {

    E802Dot11SsidIE                 = 0,

    E802Dot11SupportedRatesIE       = 1,

    E802Doi11FhParameterSetIE       = 2,

    E802Dot11DsParameterSetIE       = 3,

    E802Dot11CfParameterSetIE       = 4,

    E802Dot11TimIE                  = 5,

    E802Dot11IbssParameterSetIE     = 6,

    E802Dot11CountryIE              = 7,

    E802Dot11HoppingPatternParamIE  = 8,

    E802Dot11HoppingPatternTableIE  = 9,

    E802Dot11RequestIE              = 10,

    E802Dot11ChallengeTextIE        = 16,

    // Reserved for challenge text extension 17 - 31

    E802Dot11ErpInformationIE       = 42,

    E802Dot11ExtendedRatesIE        = 50,

    E802Dot11RsnIE                  = 221,

    E802Dot11VendorSpecificIE       = 221    

    };

/**

* Bit masks for bit fields ín Frame Control field.

*/

enum T802Dot11FrameControlBitMask

    {

    E802Dot11FrameControlProtVersionMask= 0x0003,

    E802Dot11FrameControlTypeMask       = 0x000C,

    E802Dot11FrameControlSubtypeMask    = 0x00F0,

    E802Dot11FrameControlToDsMask       = 0x0100,

    E802Dot11FrameControlFromDsMask     = 0x0200,

    E802Dot11FrameControlMoreFragMask   = 0x0400,

    E802Dot11FrameControlRetryMask      = 0x0800,

    E802Dot11FrameControlPowerMgmtMask  = 0x1000,

    E802Dot11FrameControlMoreDataMask   = 0x2000,

    E802Dot11FrameControlWepMask        = 0x4000,

    E802Dot11FrameControlOrderMask      = 0x8000

    };

/**

* Frame Control field type masks.