/*

* Copyright (c) 2002-2009 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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:   Declaration of the WlanMacState class

*

*/

/*

* %version: 53 %

*/

#ifndef WLANMACSTATE_H

#define WLANMACSTATE_H

#include "802dot11.h"

#include "UmacUserEvent.h"

#include "UmacWsaEvent.h"

#include "umacpacketschedulerclient.h"

#include "umacdfcclient.h"

#include "umacnullsender.h"

class WlanContextImpl;

class WlanDot11State;

class WlanWsaCommand;

class WlanWsaComplexCommand;

/**

* Interface layer for state machine context

* Has the default implementation of event handling

*/

class WlanMacState : 

    public MWlanUserEvent,

    public MWlanWsaEvent,

    public MWlanPacketSchedulerClient,

    public MWlanDfcClient,

    public MWlanNullSender

    {

public:

    /**

    * Configure AC (Access Category) parameters to WHA (adaptation) layer

    * 

    * @param aCtxImpl statemachine context

    */

    virtual TBool ConfigureAcParams( 

        WlanContextImpl& aCtxImpl );                        

    /**

    * ?member_description.

    * @since Series 60 3.1

    * @param aCtxImpl global statemachine context

    */

    virtual TBool SetCtsToSelfMib( WlanContextImpl& aCtxImpl );

    /**

    * Updates the RCPI Trigger Level MIB

    *

    * @since Series 60 3.1

    * @param aCtxImpl Global statemachine context

    * @param aRcpiTrigger the value to assign to the MIB

    * @param aCompleteManagementRequest ETrue if this request came from the

    *                                   WLAN Mgmt client and that request

    *                                   needs to be completed.

    *                                   EFalse otherwise.

    * @return ETrue if state transition occurred, EFalse otherwise

    */

    virtual TBool SetRcpiTriggerLevelMib(

        WlanContextImpl& aCtxImpl,

        TUint32 aRcpiTrigger,

        TBool aCompleteManagementRequest );

    /**

    * Informs lower layer about the dynamic HT configuration

    * of the target/current network

    * @param aCtxImpl statemachine context

    * @return ETrue if a state change occurred

    *         EFalse otherwise

    */

    virtual TBool ConfigureHtBssOperation( WlanContextImpl& aCtxImpl );

    /**

    * Changes dot11 power management mode between active and PS mode

    * 

    * @param aCtxImpl statemachine context

    * @return ETrue if state change occurred, EFalse otherwise

    */

    virtual TBool ChangePowerMgmtMode( 

        WlanContextImpl& aCtxImpl );                        

   // Methods from base classes

    /**

    * Connect (authenticate and associate) to a BSS.

    *

    * @since S60 3.1

    * @param aCtxImpl statemachine context

    * @param aSSID Name of the network

    * @param aBSSID BSSID of the access point

    * @param aAuthAlgorithmNbr Authentication algorithm number to be used

    * @param aEncryptionStatus Used encryption level

    * @param aIsInfra ETrue when connecting to infrastructure network

    * @param aScanResponseFrameBodyLength length of the scan response frame body

    * @param aScanResponseFrameBody scan response frame body

    * @param aIeData The IE(s) to be included into the (re-)association request.

    *              NULL, if none to be included

    * @param aIeDataLength Length of the IE(s) to be included into the 

    *                    (re-)association request

    * @return ETrue if a state transition occurred

    *         EFalse otherwise

    */

    virtual TBool Connect(

        WlanContextImpl& aCtxImpl,

        const TSSID& aSSID,                 

        const TMacAddress& aBSSID,          

        TUint16 aAuthAlgorithmNbr,      

        TEncryptionStatus aEncryptionStatus,

        TBool aIsInfra,

        TUint16 aScanResponseFrameBodyLength,

        const TUint8* aScanResponseFrameBody,

        const TUint8* aIeData,

        TUint16 aIeDataLength );

    /**

    * Add TKIP key

    * @param aCtxImpl statemachine context

    * @param aData data blob that holds TKIP parameters

    * @param aLength length of the data blob

    * @param aKeyIndex value for key id filed of WEP IV

    * @return KErrNotSupported

    */

    virtual TBool AddTkIPKey( 

        WlanContextImpl& aCtxImpl,

        const TUint8* aData, 

        TUint32 aLength,

        T802Dot11WepKeyId aKeyIndex,

        const TMacAddress& aMacAddr );

    /**

    * Add multicast TKIP key.

    * @param aCtxImpl statemachine context

    * @param aKeyIndex  Value for the key id field of WEP IV.

    * @param aLength    Length of the TKIP parameters.

    * @param aData      TKIP parameters.

    * @return KErrNotSupported

    */

    virtual TBool AddMulticastTKIPKey( 

        WlanContextImpl& aCtxImpl,

        T802Dot11WepKeyId aKeyIndex,

        TUint32 aLength,

        const TUint8* aData );

    /**

    * Add (or replace) a pairwise AES key.

    *

    * @param aCtxImpl statemachine context

    * @param aLength Length of the AES parameters.

    * @param aData AES parameters.

    * @return ETrue if state transition occurred, EFalse otherwise

    */

    virtual TBool AddAesKey( 

        WlanContextImpl& aCtxImpl,

        const TUint8* aData, 

        TUint32 aLength,

        const TMacAddress& aMacAddr );

    /**

    * Add (or replace) an AES group key.

    *

    * @param aCtxImpl statemachine context

    * @param aKeyIndex Value for the key id field of WEP IV.

    * @param aLength Length of the AES parameters.

    * @param aData AES parameters.

    * @return ETrue if state transition occurred, EFalse otherwise

    */

    virtual TBool AddMulticastAesKey( 

        WlanContextImpl& aCtxImpl,

        T802Dot11WepKeyId aKeyIndex,

        TUint32 aLength,

        const TUint8* aData );

    /**

    * Add (or replace) a multicast WAPI key.

    *

    * @param aCtxImpl statemachine context

    * @param aKeyIndex  Value for the key id field of WEP IV.

    * @param aLength    Length of the WAPI parameters.

    * @param aData      WAPI parameters.

    * @return ETrue if state transition occurred, EFalse otherwise

    */

    virtual TBool AddMulticastWapiKey( 

        WlanContextImpl& aCtxImpl,

        T802Dot11WepKeyId aKeyIndex,

        TUint32 aLength,

        const TUint8* aData );

    /**

    * From MWlanUserEvent

    * Add (or replace) a pairwise WAPI key.

    *

    * @param aCtxImpl statemachine context

    * @param aData data blob that holds WAPI parameters

    * @param aLength length of the data blob

    * @param aKeyIndex value for key id field of WEP IV

    * @param aMacAddr MAC address of the peer station

    * @return ETrue if state transition occurred, EFalse otherwise

    */

    virtual TBool AddUnicastWapiKey( 

        WlanContextImpl& aCtxImpl,

        const TUint8* aData, 

        TUint32 aLength,

        T802Dot11WepKeyId aKeyIndex,

        const TMacAddress& aMacAddr );

    /**

    * Start an own IBSS network if there doesn't already 

    * exist a network that has the same name.

    * @param aCtxImpl statemachine context

    * @param aSSID name of the network

    * @param aBeaconInterval Beacon period in TUs (kusec). range:[1, 1024]

    * @param aAtim ATIM window (NOT USED)

    * @param aChannel Used channel (1-14). 

    *        Has to be legal in the current region.

    * @param aEncryptionStatus Used encryption level

    * @return KErrNone = command completed successfully, 

    * any other = failure

    */        

    virtual TBool StartIBSS(

        WlanContextImpl& aCtxImpl,

        const TSSID& aSSID,                 

        TUint32 aBeaconInterval,            

        TUint32 aAtim,                      

        TUint32 aChannel,                   

        TEncryptionStatus aEncryptionStatus );      

    /**

    * Scan all available networks. 

    * This SW module decides is background scan or foreground scan used

    * @param aCtxImpl statemachine context

    * @param aMode passive or active scan see #TScanMode

    * @param aSSID Network that APs are scanned. Can be broadcast SSID.

    * @param aScanRate Rate that is used in active scanning see #TRate

    * @param aMinChannelTime min. time to listen beacons/probe responses on 

    *                        a channel

    * @param aMaxChannelTime max. time to listen beacons/probe responses on 

    *                        a channel

    * @param aSplitScan if ETrue, use split scan

    * @return KErrNone = command completed successfully, 

    * any other = failure

    */

    virtual TBool Scan(

        WlanContextImpl& aCtxImpl,

        TScanMode aMode,                    

        const TSSID& aSSID,                 

        TRate aScanRate, 

        SChannels& aChannels,

        TUint32 aMinChannelTime,            

        TUint32 aMaxChannelTime,

        TBool aSplitScan );               

    /**

    * Stop a previously started scan process. 

    *

    * @since S60 3.2

    * @param aCtxImpl global statemachine context

    * @return ETrue if a state transition occurred

    *         EFalse otherwise

    */

    virtual TBool StopScan( WlanContextImpl& aCtxImpl );

    /**

    * Scan all available networks. 

    * This SW module decides is background scan or foreground scan used

    * @param aCtxImpl statemachine context

    * @param aMode passive or active scan see #TScanMode

    * @param aSSID Network that APs are scanned. Can be broadcast SSID.

    * @param aScanRate Rate that is used in active scanning 

    * @param aMinChannelTime min. time to listen beacons/probe responses on 

    *                        a channel

    * @param aMaxChannelTime max. time to listen beacons/probe responses on 

    *                        a channel

    * @param aSplitScan if ETrue, use split scan

    * @return KErrNone = command completed successfully, 

    * any other = failure

    */

    virtual TBool RealScan(

        WlanContextImpl& aCtxImpl,

        TScanMode aMode,                    

        const TSSID& aSSID,                 

        TUint32 aScanRate,                    

        SChannels& aChannels,

        TUint32 aMinChannelTime,            

        TUint32 aMaxChannelTime,

        TBool aSplitScan );               

    /**

    * Disconnect STA from current network.

    * @param aCtxImpl statemachine context

    * @return KErrNone = command completed successfully, 

    * any other = failure

    */

    virtual TBool Disconnect(WlanContextImpl& aCtxImpl);

    /**

    * Set 802.11 power mgmt mode in infrastructure networks.

    * @param aCtxImpl statemachine context

    * @param aPowerMode desired power mode

    * @param aDisableDynamicPowerModeManagement If ETrue, disables the dynamic

    *        power mode management handling. Relevant only when aPowerMode

    *        is EPowerModePs

    * @param aWakeupModeInLightPs WLAN wake-up mode in Light PS mode

    * @param aListenIntervalInLightPs specifies the value of N for wake-up

    *        modes 2 and 3 in Light PS mode. 

    * @param aWakeupModeInDeepPs WLAN wake-up mode in Deep PS mode

    * @param aListenIntervalInDeepPs specifies the value of N for wake-up 

    *        modes 2 and 3 in Deep PS mode

    * @return ETrue if a state transition occurred

    *         EFalse otherwise

    */

    virtual TBool SetPowerMode(

        WlanContextImpl& aCtxImpl,

        TPowerMode aPowerMode,

        TBool aDisableDynamicPowerModeManagement,

        TWlanWakeUpInterval aWakeupModeInLightPs, 

        TUint8 aListenIntervalInLightPs,

        TWlanWakeUpInterval aWakeupModeInDeepPs,

        TUint8 aListenIntervalInDeepPs );

    /**

    * Set trigger level for RCPI trigger. 

    * @param aCtxImpl statemachine context

    * @param aRcpiTrigger RCPI trigger level to be set

    * @return KErrNone = command completed successfully, 

    * any other = failure

    */

    virtual TBool SetRcpiTriggerLevel(

        WlanContextImpl& aCtxImpl,

        TUint32 aRcpiTrigger);               

    /**

    * Set transmission power level. 

    * This has to be legal at the current region.

    * @param aCtxImpl statemachine context

    * @param aLevel Transmission power level in mW.

    * @return KErrNone command completed successfully 

    * any other = failure

    */

    virtual TBool SetTxPowerLevel(

        WlanContextImpl& aCtxImpl,

        TUint32 aLevel);                

    /**

    * Set inital WLAN specific parameters. 

    * See 802Dot11DefaultValues.h for detaills

    * @param aCtxImpl statemachine context

    * @param aRTSThreshold 

    * @param aMaxTxMSDULifetime 

    * @param aVoiceCallEntryTimeout when we are not in Voice over WLAN Call

    *        state and we transmit at least aVoiceCallEntryTxThreshold

    *        Voice priority frames during the time period (microseconds)

    *        denoted by this parameter, we enter Voice over WLAN Call state

    * @param aVoiceCallEntryTxThreshold Threshold value for the number of 

    *        Voice priority Tx frames to enter Voice over WLAN Call state    

    * @param aVoiceNullTimeout NULL frame sending interval during a Voice over 

    *        WLAN call in U-APSD power save mode

    * @param aNoVoiceTimeout after this long time of no Voice priority data 

    *        Tx, exit Voice over WLAN call state

    * @param aKeepAliveTimeout Keep Alive frame sending interval in 

    *        infrastructure mode

    * @param aSpRcpiIndicationLevel If this RCPI level is predicted to be

    *        reached within the time specified by aSpTimeToCountPrediction,

    *        a signal loss prediction indication is sent. 

    * @param aSpTimeToCountPrediction Specifies the time (in microseconds)

    *        how far into the future signal prediction is done.

    * @param aSpMinIndicationInterval The minimum time difference (in 

    *        microseconds) between two signal loss prediction indications.

    * @return KErrNone command completed successfully 

    * any other = failure

    */        

    virtual TBool Configure(

        WlanContextImpl& aCtxImpl,

        TUint32 aRTSThreshold,              

        TUint32 aMaxTxMSDULifetime,

        TUint32 aVoiceCallEntryTimeout,

        TUint32 aVoiceCallEntryTxThreshold,

        TUint32 aVoiceNullTimeout,

        TUint32 aNoVoiceTimeout,

        TUint32 aKeepAliveTimeout,

        TUint32 aSpRcpiIndicationLevel,

        TUint32 aSpTimeToCountPrediction,

        TUint32 aSpMinIndicationInterval );  

    /**

     * From MWlanUserEvent

     * Add/set (or replace) a broadcast WEP key

     *

     * @since S60 3.1

     * @param aCtxImpl statemachine context

     * @param aKeyIndex Index of the key in the default key table 

     * @param aKeyLength Length of the key in BYTES

     * @param aKey The WEP key

     * @param aMac MAC address associated with the key

     * @return ETrue if state transition occurred, EFalse otherwise

     */

    virtual TBool AddBroadcastWepKey(

        WlanContextImpl& aCtxImpl,

        TUint32 aKeyIndex,     

        TBool aUseAsDefaulKey,    

        TUint32 aKeyLength,                      

        const TUint8 aKey[KMaxWEPKeyLength],

        const TMacAddress& aMac );   

    /**

    * Add (or replace) a unicast WEP key.

    * @param aCtxImpl statemachine context

    * @param aMacAddr MAC address to which the WEP key corresponds to

    * @param aKeyLength Length of the key in BYTES

    * @param aKey The WEP key

    * @return KErrNone command completed successfully 

    * any other = failure

    */

    virtual TBool AddUnicastWepKey(

        WlanContextImpl& aCtxImpl,

        const TMacAddress& aMacAddr,

        TUint32 aKeyLength,                      

        const TUint8 aKey[KMaxWEPKeyLength]);   

    /**

    * Disable user data from/to protcol stack 

    * (802.1x: block data during authentication).

    * @param aCtxImpl statemachine context

    * @return KErrNone command completed successfully 

    * any other = failure

    */

    virtual TBool DisableUserData(

        WlanContextImpl& aCtxImpl );

    /**

    * Enable user data from/to protcol stack 

    * (802.1x: pass data through after succesfull authentication)

    * @param aCtxImpl statemachine context

    * @return KErrNone command completed successfully 

    */

    virtual TBool EnableUserData(

        WlanContextImpl& aCtxImpl );

    /**

    * Gets last RCPI value

    * @param aCtxImpl statemachine context

    * @return KErrNone command completed successfully 

    * any other = failure

    */

    virtual TBool GetLastRcpi(

        WlanContextImpl& aCtxImpl );       

    /**

    * Adds a multicast MAC address and starts to filter (Rx) multicast 

    * traffic sent to any other MAC addresses than those that have been 

    * specified using this method

    * @param aCtxImpl statemachine context

    * @param aMacAddr The address to be added

    * @return 

    */

    virtual TBool AddMulticastAddr(

        WlanContextImpl& aCtxImpl,

        const TMacAddress& aMacAddr );        

    /**

    * Removes a multicast MAC address from multicast (Rx) filtering

    * configuration. So any packet that we receive and which has been sent

    * to the multicast address in question is not accepted any more (i.e. 

    * it is filtered).

    * However, if there are no addresses left in the multicast (Rx) filtering

    * configuration after this remove, the multicast filtering is disabled

    * and all (otherwise acceptable) multicast packets are accepted again.

    * @param aCtxImpl statemachine context

    * @param aMacAddr The address to be removed

    * @return ETrue if a state change occurred in the state machine 

    *         EFalse otherwise

    */

    virtual TBool RemoveMulticastAddr(

        WlanContextImpl& aCtxImpl,

        TBool aRemoveAll,

        const TMacAddress& aMacAddr );

    /**

     * Configures the parameters which define when BSS lost is indicated.

     * The indication is sent when either one of the specified thresholds

     * is exceeded.

     *

     * @since S60 v3.1

     * @param aCtxImpl statemachine context

     * @param aBeaconLostCount beacon lost count threshold

     * @aFailedTxPacketCount failed Tx packet count threshold

     * @return ETrue if a state change occurred

     *         EFalse otherwise

     */

    virtual TBool ConfigureBssLost( 

        WlanContextImpl& aCtxImpl,

        TUint32 aBeaconLostCount,

        TUint8 aFailedTxPacketCount );

    /**

    * Sets the Tx rate adaptation algorithm parameters

    *

    * @since S60 3.1

    * @param aCtxImpl statemachine context

    * @param aMinStepUpCheckpoint minimum and initial rate increase 

    *        checkpoint in units of frames

    *        Range: [aStepDownCheckpoint,aMaxStepUpCheckpoint]

    * @param aMaxStepUpCheckpoint maximum rate increase checkpoint in units 

    *        of frames

    *        Range: [aStepDownCheckpoint,UCHAR_MAX]

    * @param aStepUpCheckpointFactor StepUpCheckpoint is multiplied with this

    *        value if sending a probe frame fails

    *        Range: [1,aMaxStepUpCheckpoint]