1 /*

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

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

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

     6 * which accompanies this distribution, and is available

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

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:   Declaration of the WlanDeepPsModePowerModeMgr class

    15 *

    16 */

    17 

    18 /*

    19 * %version: 3 %

    20 */

    21 

    22 #ifndef WLAN_DEEP_PS_MODE_POWER_MODE_MGR

    23 #define WLAN_DEEP_PS_MODE_POWER_MODE_MGR

    24 

    25 #include "umacpowermodemgrbase.h"

    26 

    27 class WlanContextImpl;

    28 

    29 /**

    30 * Class implementing infrastructure mode dynamic power mode management 

    31 * algorithm for Deep PS mode

    32 */

    33 class WlanDeepPsModePowerModeMgr : public WlanPowerModeMgrBase

    34     {  

    35 

    36 public:

    37 

    38     /** Ctor */

    39     WlanDeepPsModePowerModeMgr();

    40 

    41     /** Dtor */

    42     virtual ~WlanDeepPsModePowerModeMgr();

    43     

    44     /**

    45     * To be called when transmitting a frame

    46     *

    47     * @since S60 5.1

    48     * Determines the need to make a power mode transition

    49     * @param aCtxImpl global statemachine context

    50     * @param aQueueId Id of the queue/AC via which the frame will be transmitted

    51     * @param aEtherType Ethernet type of the frame

    52     * @param aIgnoreThisFrame shall this frame be ignored from dynamic power 

    53     *                         mode management perspective

    54     * @return To which power management mode to change; if any at all

    55     */

    56     virtual TPowerMgmtModeChange OnFrameTx( 

    57         WlanContextImpl& aCtxImpl, 

    58         WHA::TQueueId aQueueId,

    59         TUint16 aEtherType,

    60         TBool aIgnoreThisFrame );

    61 

    62     /** 

    63     * To be called when accepting an Rx frame

    64     *

    65     * @since S60 5.1

    66     * @param aCtxImpl global statemachine context

    67     * @param aAccessCategory AC/Queue via which the frame has beeen transmitted

    68     * @param aEtherType Ethernet type of the received frame

    69     * @param aIgnoreThisFrame shall this frame be ignored from dynamic power 

    70     *                         mode management perspective

    71     * @param aPayloadLength length of the ethernet frame payload

    72     * @param aDaType DA type (Unicast, Multicast or Broadcast) of the frame

    73     * @return To which power management mode to change; if any at all

    74     */

    75     virtual TPowerMgmtModeChange OnFrameRx(

    76         WlanContextImpl& aCtxImpl,

    77         WHA::TQueueId aAccessCategory,

    78         TUint16 aEtherType,

    79         TBool aIgnoreThisFrame,

    80         TUint aPayloadLength,

    81         TDaType aDaType );

    82     

    83     /** 

    84     * From WlanPowerModeMgrBase

    85     * Resets the state of the object 

    86     *

    87     * @since S60 5.1

    88     */

    89     virtual void DoReset() {};

    90 

    91 private:    // Methods

    92 

    93     // Prohibit copy constructor

    94     WlanDeepPsModePowerModeMgr( const WlanDeepPsModePowerModeMgr& );

    95     // Prohibit assigment operator

    96     WlanDeepPsModePowerModeMgr& operator= ( 

    97         const WlanDeepPsModePowerModeMgr& );    

    98 

    99 private:    // Data

   100 

   101 };

   102 

   103 #endif // WLAN_DEEP_PS_MODE_POWER_MODE_MGR