--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/wlan_bearer/wlanldd/wlan_common/umac_common/inc/umaclightpsmodepowermodemgr.h Tue Feb 02 02:03:13 2010 +0200
@@ -0,0 +1,165 @@
+/*
+* Copyright (c) 2008-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 WlanLightPsModePowerModeMgr class
+*
+*/
+
+/*
+* %version: 3 %
+*/
+
+#ifndef WLAN_LIGHT_PS_MODE_POWER_MODE_MGR
+#define WLAN_LIGHT_PS_MODE_POWER_MODE_MGR
+
+#include "umacpowermodemgrbase.h"
+
+class WlanContextImpl;
+
+/**
+* Class implementing infrastructure mode dynamic power mode management
+* algorithm for Light PS mode
+*/
+class WlanLightPsModePowerModeMgr : public WlanPowerModeMgrBase
+ {
+
+public:
+
+ /** Ctor */
+ WlanLightPsModePowerModeMgr();
+
+ /** Dtor */
+ virtual ~WlanLightPsModePowerModeMgr();
+
+ /**
+ * Sets the dynamic power mode transition algorithm parameters
+ *
+ * @since S60 5.1
+ * @param aToActiveFrameThreshold frame count threshold for changing to
+ * active mode
+ * @param aToDeepPsFrameThreshold frame count threshold for changing to
+ * Deep PS mode
+ * @param aUapsdRxFrameLengthThreshold received frame
+ * payload length (in bytes) threshold in U-APSD network
+ */
+ inline void SetParameters(
+ TUint aToActiveFrameThreshold,
+ TUint aToDeepPsFrameThreshold,
+ TUint16 aUapsdRxFrameLengthThreshold );
+
+ /**
+ * To be called when transmitting a frame
+ *
+ * @since S60 5.1
+ * Determines the need to make a power mode transition
+ * @param aCtxImpl global statemachine context
+ * @param aQueueId Id of the queue/AC via which the frame will be transmitted
+ * @param aEtherType Ethernet type of the frame
+ * @param aIgnoreThisFrame shall this frame be ignored from dynamic power
+ * mode management perspective
+ * @return To which power management mode to change; if any at all
+ */
+ virtual TPowerMgmtModeChange OnFrameTx(
+ WlanContextImpl& aCtxImpl,
+ WHA::TQueueId aQueueId,
+ TUint16 aEtherType,
+ TBool aIgnoreThisFrame );
+
+ /**
+ * To be called when accepting an Rx frame
+ *
+ * @since S60 5.1
+ * @param aCtxImpl global statemachine context
+ * @param aAccessCategory AC/Queue via which the frame has beeen transmitted
+ * @param aEtherType Ethernet type of the received frame
+ * @param aIgnoreThisFrame shall this frame be ignored from dynamic power
+ * mode management perspective
+ * @param aPayloadLength length of the ethernet frame payload
+ * @param aDaType DA type (Unicast, Multicast or Broadcast) of the frame
+ * @return To which power management mode to change; if any at all
+ */
+ virtual TPowerMgmtModeChange OnFrameRx(
+ WlanContextImpl& aCtxImpl,
+ WHA::TQueueId aAccessCategory,
+ TUint16 aEtherType,
+ TBool aIgnoreThisFrame,
+ TUint aPayloadLength,
+ TDaType aDaType );
+
+ /**
+ * From WlanPowerModeMgrBase
+ * To be called upon Light PS to Active timer timeout
+ *
+ * @since S60 5.1
+ * @param aCtxImpl global statemachine context
+ * @return ETrue if power mode transition should be done,
+ * EFalse otherwise
+ */
+ virtual TBool OnLightPsToActiveTimerTimeout( WlanContextImpl& aCtxImpl );
+
+ /**
+ * From WlanPowerModeMgrBase
+ * To be called upon Light PS to Deep PS timer timeout
+ *
+ * @since S60 5.1
+ * @return ETrue if power mode transition should be done,
+ * EFalse otherwise
+ */
+ virtual TBool OnLightPsToDeepPsTimerTimeout();
+
+ /**
+ * From WlanPowerModeMgrBase
+ * Resets the state of the object
+ *
+ * @since S60 5.1
+ */
+ virtual void DoReset();
+
+private: // Methods
+
+ // Prohibit copy constructor
+ WlanLightPsModePowerModeMgr( const WlanLightPsModePowerModeMgr& );
+ // Prohibit assigment operator
+ WlanLightPsModePowerModeMgr& operator= (
+ const WlanLightPsModePowerModeMgr& );
+
+private: // Data
+
+ /**
+ * Rx/Tx frame counter used when considering change to
+ * Active mode
+ */
+ TUint iToActiveFrameCount;
+
+ /**
+ * Rx/Tx frame count threshold used when considering change to
+ * Active mode
+ */
+ TUint iToActiveFrameThreshold;
+
+ /**
+ * Rx/Tx frame counter used when considering change to
+ * Deep PS mode
+ */
+ TUint iToDeepPsFrameCount;
+
+ /**
+ * Rx/Tx frame count threshold used when considering change to
+ * Deep PS mode
+ */
+ TUint iToDeepPsFrameThreshold;
+};
+
+#include "umaclightpsmodepowermodemgr.inl"
+
+#endif // WLAN_LIGHT_PS_MODE_POWER_MODE_MGR