/*
* Copyright (c) 2005 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:  The class implements functions handling radio engine state changes 
*
*/


#ifndef FMRADIOENGINERADIOSTATEHANDLER_H
#define FMRADIOENGINERADIOSTATEHANDLER_H

//INCLUDES
#include "fmradioenginestatechangecallback.h"

// CONSTANTS
const TUint8 KRadioStateEventCallback     = 0x01;

// FORWARD DECLARATIONS
class CRadioEngine;


// CLASS DECLARATION
/**
* This class implements the state machines for radio engine state transition.
*/
class CRadioStateHandler : public CActive
    {
    public:
        /**
        * Method for creating new instances of this class.
        * @param aEngine a pointer to CRadioEngine
        * @return - A pointer to new CRadioEngineTimer object
        **/
        static CRadioStateHandler *NewL(CRadioEngine* aEngine);
        /**
        * Destructor
        **/
        virtual ~CRadioStateHandler();
    public:
        /**
        * Trigger the active object to call the client callback function.
        * @since Series 60 2.7
        * @return none
        */
        void Callback(MRadioEngineStateChangeCallback::TFMRadioNotifyEvent aEventCode, TInt aErrorCode );
    private:
        /**
        * c++ default constructor
        **/
        CRadioStateHandler(CRadioEngine* aEngine);
        /**
        * 2nd phase constructor
        **/
        void ConstructL();
        /**
        * Cancel the timeout timer. This generally means that a response was received from the chip, so the 
        * timeout is no longer needed or the state machine was transitioned.
        * @since Series 60 2.7
        * @return none
        **/
        void DoCancel();
        /**
        * State Change Request/timeout handler
        * @since Series 60 2.7
        * @return none
        */
        void RunL();
        /**
        * handle any errors that occur in the RunL
        * @since Series 60 2.7
        * @return none
        */
    	TInt RunError( TInt aError );
    private:
        // pointer to the session who's timeout we are mananging.
        CRadioEngine* iEngine;            
        // Temporary storage for event code
        TInt iCallbackEventCode;
        // Temporary storage for error code        
        TInt iCallbackErrorCode;
   
    };  // FMRADIOENGINERADIOSTATEHANDLER_H   
            
// End of File
    
#endif