/*

* Copyright (c) 2007 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:  PSM Manager class.

*

*/

#ifndef PSMMANAGER_H

#define PSMMANAGER_H

#include <e32base.h>

// FORWARD DECLARATIONS

class CPsmPluginLoader;

class CPsmSettingsHandler;

class MPsmModeChangeObserver;

class MPsmSettingsProvider; // Interface for Settings handler

/**

 *  PSM Manager class

 *

 *  Main class in PSM server. Controls the power save mode change chain

 *

 *  @since S60 5.0

 */

class CPsmManager : public CActive

    {

    public:  // Constructors and destructor

        /**

         * Creates a new PSM manager.

         *

         * @return A pointer to the created object.

         */

        static CPsmManager* NewL();

        /**

         * Creates a new PSM manager. Newly created instance is left in the cleanup stack.

         *

         * @return A pointer to the created object.

         */

        static CPsmManager* NewLC();

        /**

         * Destructor.

         */

        virtual ~CPsmManager();

        /**

         * Starts the mode change actions

         *

         * @param aPsmMode Mode to switch to.

         */

        void NotifyPowerSaveModeChangeL( TInt aPsmMode );

        /**

         * Cancels the mode change actions and restores previous mode.

         */

        void CancelPowerSaveModeChangeL();

        /**

         * Register new PSM observer. Adds observer to the list of registered observers

         */

        void RegisterObserver( MPsmModeChangeObserver* aObserver );

        /**

         * Unreqister observer. Removes observer from the list of registered observers

         */

        void UnregisterObserver( MPsmModeChangeObserver* aObserver );

        /**

         * Returns reference to settings handler

         */

        MPsmSettingsProvider& SettingsProvider();

        /**

         * Makes NotifyPowerSaveModeChangeL to asynchronous

         */

        void IssueRequest();

    protected: // From CActive

        /**

         * From CActive.

         */

        void RunL();

        /**

         * From CActive.

         */

        void DoCancel();

        /**

         * From CActive.

         */

        TInt RunError( TInt aError );

    private:

        /**

        * C++ constructor.

        */

        CPsmManager();

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

        /**

         * Notifies PSM mode change observers

         */

        void NotifyObservers( const TInt aError ) const;

    private:    // Data

        /**

         * Plugin loader

         */

        CPsmPluginLoader* iPluginLoader;

        /**

         * Settings handler

         */

        CPsmSettingsHandler* iSettingsHandler;

        /**

         * Array of registered PSM mode observers

         */

        RArray<MPsmModeChangeObserver*> iModeObservers;

        /**

         * Indicates is mode change active

         */

        TBool iModeChangeCancel;

        /**

         * indicates that power save mode change is ongoing

         */

        TBool iPowerSaveModeChangeActive;

    };

#endif // PSMMANAGER_H