/*

* Copyright (c) 2005-2007 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 WlanDot11InfrastructureScanningMode

*                class.

*

*/

/*

* %version: 14 %

*/

#ifndef C_WLANDOT11DOT11INFRASTRUCTURESCANNINGMODE_H

#define C_WLANDOT11DOT11INFRASTRUCTURESCANNINGMODE_H

#include "UmacDot11InfrastructureMode.h"

#include "umacscanfsmcb.h"

class WlanContextImpl;

class WlanScanFsmCntx;

/**

 *  Infrastructure mode scanning state

 *

 *  @lib wlanumac.lib

 *  @since S60 v3.1

 */

class WlanDot11InfrastructureScanningMode : 

    public WlanDot11InfrastructureMode,

    public MWlanScanFsmCb

    {

public:

    /**  backtrack to previous dot11 state when internal fsm is complete */

    static const TUint32 KDot11StateBackTrack          = ( 1 << 0 );

    /**  

    * does difference in dot11 power management mode exist 

    * between pre and post scanning mode 

    */

    static const TUint32 KDot11PwrMgmtModeDifference   = ( 1 << 1 );

    /**  Types for the FSM */

    /**  events for the FSM */

    enum TEvent

        {

        ESTATEENTRY,        // state entry action to be executed                        

        ETXCOMPLETE,        // underlying sw layer tx delivery complete event   

        ESTARTSCANNINGMODE, // start scanning mode event

        ESCANMODERUNNING,   // scan running event

        ESTOPSCANNINGMODE,  // stop scanning mode request

        ESCANNINGMODEEXIT,  // scanning mode termination event 

        EABORT,             // abort execution event

        EEVENTMAX           // defined as an upper bound

        };

    /**  states of the FSM */

    enum TState

        {

        EINIT,                  // start state of the state machine

        EEXECUTESCANFSM,        // execute scan fsm

        ECONTINUEDOT11TRAVERSE, // continue dot11 state traversal

        ESTATEMAX               // defined as an upper bound        

        }; 

    WlanDot11InfrastructureScanningMode() 

        : iState( EINIT ), iMode( static_cast<TScanMode>(0) ), 

          iScanRate( 0 ), iFlags( 0 ), iPimpl( NULL ), iCtxImpl( NULL ),

          iSSID( NULL ),  iChannels( NULL ), iMinChannelTime( 0 ), 

          iMaxChannelTime( 0 ), 

          iScanType( WHA::EForcedBgScan ),

          iSplitScan( EFalse ) {};

    virtual ~WlanDot11InfrastructureScanningMode();

    /**

     * 

     *

     * @since S60 3.1

     * @param ?arg1 ?description

     * @param ?arg2 ?description

     */

    inline void Dot11StateBackTrack();

    /**

     * 

     *

     * @since S60 3.1

     * @param ?arg1 ?description

     * @param ?arg2 ?description

     */

    void Set( WlanContextImpl& aCtxImpl );

    /**

     * 

     *

     * @since S60 3.1

     * @param ?arg1 ?description

     * @param ?arg2 ?description

     */

    void Set( 

        TScanMode aMode,                    

        const TSSID& aSSID,                 

        TUint32 aScanRate,                    

        SChannels& aChannels,

        TUint32 aMinChannelTime,            

        TUint32 aMaxChannelTime,

        TBool aSplitScan,

        WHA::TScanType aScanType = WHA::EForcedBgScan );

private:

    /**

     * Internal state transition method

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     * @param aNewState new internal state

     */

    void ChangeInternalState( WlanContextImpl& aCtxImpl, TState aNewState );

    /**

     * Feeds an event to internal fsm

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     * @param aEvent fsm event

     */

    void Fsm( WlanContextImpl& aCtxImpl, TEvent aEvent ); 

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void OnStateEntryEvent( WlanContextImpl& aCtxImpl );

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void OnTxCompleteEvent( WlanContextImpl& aCtxImpl ) const;

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void OnStartScanningModeEvent( WlanContextImpl& aCtxImpl );

    /**

     * Handles Scan Running event from scan fsm

     *

     * @since S60 3.2

     * @param aCtxImpl global statemachine context

     */

    void OnScanModeRunningEvent( WlanContextImpl& aCtxImpl ) const;

    /**

     * Handles Stop Scanning Mode event from scan fsm

     *

     * @since S60 3.2

     * @param aCtxImpl global statemachine context

     */

    void OnStopScanningModeEvent( WlanContextImpl& aCtxImpl );

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void OnScanningModeExitEvent( WlanContextImpl& aCtxImpl );

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void OnAbortEvent( WlanContextImpl& aCtxImpl );

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void ExecuteScanFsm( WlanContextImpl& aCtxImpl );

    /**

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    void ContinueDot11StateTraversal( WlanContextImpl& aCtxImpl );

    // from base class MWlanWhaCommandClient

    /**

     * From MWlanWhaCommandClient.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    virtual void OnWhaCommandResponse( 

        WlanContextImpl& aCtxImpl, 

        WHA::TCommandId aCommandId,

        WHA::TStatus aStatus,        

        const WHA::UCommandResponseParams& aCommandResponseParams,

        TUint32 aAct );

    // from base class MWlanWsaEvent

    /**

     * From MWlanWsaEvent.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    virtual TBool CommandComplete( 

        WlanContextImpl& aCtxImpl, 

        WHA::TCompleteCommandId aCompleteCommandId, 

            WHA::TStatus aStatus,

        const WHA::UCommandCompletionParams& aCommandCompletionParams );

    /**

     * From MWlanWsaEvent.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    virtual TAny* RequestForBuffer( 

        WlanContextImpl& aCtxImpl, 

        TUint16 aLength );

    // from base class WlanDot11Associated

    /**

     * From WlanDot11Associated.

     * Called upon receiving a beacon type frame

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     * @param aRcpi RCPI of the frame

     * @param aBuffer pointer to the beginning of the Rx buffer allocated

     *        for the frame

     */

    virtual void OnBeaconFrameRx( 

        WlanContextImpl& aCtxImpl,

        const TAny* aFrame,

        const TUint32 aLength,

        WHA::TRcpi aRcpi,

        TUint8* aBuffer );

    /**

     * From WlanDot11Associated.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     * @param aRcpi RCPI of the frame

     * @param aBuffer pointer to the beginning of the Rx buffer allocated

     *        for the frame

     */

    virtual void OnProbeResponseFrameRx( 

        WlanContextImpl& aCtxImpl,

        const TAny* aFrame,

        const TUint32 aLength,

        WHA::TRcpi aRcpi,

        TUint8* aBuffer );

    // from base class WlanMacState

    /**

     * From WlanMacState.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    virtual void Entry( WlanContextImpl& aCtxImpl );

    /**

     * From WlanMacState.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

    virtual void Exit( WlanContextImpl& aCtxImpl );

    /**

    * From WlanMacState.

    * 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 );

    /**

     * From WlanMacState.

     * ?description

     *

     * @since S60 3.1

     * @param aCtxImpl global statemachine context

     */

#ifndef NDEBUG 

        virtual const TInt8* GetStateName( TUint8& aLength ) const;

#endif // !NDEBUG 

    // from base class MWlanScanFsmCb

    virtual void OnScanFsmEvent( MWlanScanFsmCb::TEvent aEvent );

    // Prohibit copy constructor.

    WlanDot11InfrastructureScanningMode( 

        const WlanDot11InfrastructureScanningMode& );

    // Prohibit assigment operator.

    WlanDot11InfrastructureScanningMode& operator= ( 

        const WlanDot11InfrastructureScanningMode& ); 

private: // data

#ifndef NDEBUG

    /**  max length of state name for tracing */

    enum { KMaxStateStringLength = 50 };

    /**  max length of event name for tracing */

    enum { KMaxEventStringLength = KMaxStateStringLength };

    /**

     * state names for tracing

     */

    static const TUint8 iStateName[ESTATEMAX][KMaxStateStringLength];

    /**

     * event names for tracing 

     */

    static const TUint8 iEventName[EEVENTMAX][KMaxEventStringLength];         

    /**

     * name of the state

     */

    static const TInt8  iName[];

#endif

    /**

     * state of the fsm 

     */

    TState              iState;

    /**

     * scan parameter as non-WHA types

     */

    TScanMode           iMode;                  

    /**

     * scan parameter as non-WHA types

     */

    TUint32             iScanRate;     

    /**

     * storage for interal flag values

     */

    TUint32             iFlags;

    /**

     * pointer to the scan fsm implementation

     * Own.

     */

    WlanScanFsmCntx*    iPimpl;

    /**

     * global state machine context 

     * Not own.  

     */

    WlanContextImpl*    iCtxImpl;

    /**

     * scan parameter as non-WHA types

     * Not own.  

     */

    const TSSID*        iSSID;                 

    /**

     * scan parameter as non-WHA types

     * Not own.  

     */

    SChannels*          iChannels;

    /**

     * minimum channel time

     */

    TUint32 iMinChannelTime;

    /**

     * maximum channel time

     */

    TUint32 iMaxChannelTime;

    /**

     * WHA scan type

     */

    WHA::TScanType iScanType;

    /**

     * should split scan be used

     */

    TBool iSplitScan;

    };

#include "umacdot11infrastructurescanningmode.inl"

#endif // C_WLANDOT11DOT11INFRASTRUCTURESCANNINGMODE_H