/*
* Copyright (c) 2008 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:  Definition of CSuplPsyCellIdHandler.
*
*/

#ifndef SUPLPSYCELLIDHANDLER_H
#define SUPLPSYCELLIDHANDLER_H

// INCLUDES
#include <e32def.h>
#include <e32base.h>
#include <etelmm.h>

#include "suplpsycellidinfo.h"

/**
*  Observer class for listening to Etel Events
*  @lib nlacidsuplpsy.lib
*  @since S60 v3.1
*/

class MBasicCellIDListener
	{
	public:
		// Cell Id Information & Error while completing request
		virtual void BasicCellIDRequestCompletedL(TInt aErrorCode) = 0;

	};

/**
*  Class for getting the Cell Id information	
*  @lib nlacidsuplpsy.lib
*  @since S60 v3.1
*/

class CSuplPsyCellIdHandler : public CActive
    {
   
    public: 
    
        enum TNetworkTypeInfo
			{
			EGSM = 0,			
			EWCDMA,
			EUnknown
			};
    
    public:  
        
   	   /**
        * Performs construction of an object
        * @since S60  v3.1
        * @param None
        * @return None
        */
   		static CSuplPsyCellIdHandler* NewL(MBasicCellIDListener& aObserver);
   		
        /**
        * Performs destructor
        * @since S60  v3.1
        * @param None
        * @return None
        */
        ~CSuplPsyCellIdHandler();
        
        /**
        * Retrieves cell id information
        * @since S60  v3.1
        * @param None
        * @return None
        */        
        void GetCellID( TCellIdInfo& aCellIdInfo );
        
       /**
        * Returns type of network
        * @since S60  v3.1
        * @param None
        * @return Network type
        */        
        TNetworkTypeInfo NetworkType() const;
        
     private:
     
       /**
        * Handles the cell id information
        * @since S60  v3.1
        * @param None
        * @return None
        */        
     	void HandleCellInfoL();
     	
     	 /**
        * Reads cell ID stored in Central Repository
        * @since S60  v3.1
        * @param None
        * @return None
        */        
     	void ReadCurrentCellIdFromCRL();

     	 /**
        * Save Current cell ID in Central Repository
        * @since S60  v3.1
        * @param None
        * @return None
        */        
     	void SaveCurrentCellIdToCRL();     	
     	
     private:
     
       /**
        * Performs construction of an object
        * @since S60  v3.1
        * @param aObserver, MBasicCellIDChecker observer for request completion.
        * @return None
        */
        CSuplPsyCellIdHandler(MBasicCellIDListener& aObserver);

     	/**
        * Performs Second phase constrcution
        * @since S60  v3.1
        * @param None
        * @return None
        */
        void ConstructL();

		/**
		* ConnectToETelL, Connects to Telephony server & RMobilePhone
		* @since S60 v3.1u     
		* @param      None, 
		* @return     TInt, returns system wide error code
		*/
		TInt  ConnectToETelL();

    protected:  // CActive        
    	 /**
        * Performs cancelling of asynchronour request
        * @since S60  v3.1
        * @param None
        * @return None
        */ 
        void DoCancel();

        /**
        * Performs RunL
        * @since S60  v3.1
        * @param None
        * @return None
        */ 
        void RunL();  
        
        /**
        * Performs RunError
        * @since S60  v3.1
        * @param aError, Error code containing leave reason
        * @return TInt , informs to activescheduler about handling of leave.
        */ 
        TInt RunError(TInt aError);  
        
       
    private:    // Data
  
      	//For access to a mobile phone
        RMobilePhone iPhone; 
        
        // Etel Server
		RTelServer iTelServer;
		
		//TSYName
		TFileName iTsyName; 
        
        // For Network information 
        RMobilePhone::TMobilePhoneNetworkInfoV1 	iNetworkInfo;
        
        //for network information
        RMobilePhone::TMobilePhoneNetworkInfoV1Pckg iNetworkInfoPkg;
        
     	 // For location information
        RMobilePhone::TMobilePhoneLocationAreaV1 iLocationInfo;

        //Observer for request completion
        MBasicCellIDListener& iObserver;

		TNetworkTypeInfo iNetworkType;
						
		TBool iIsInitilized;
		
		TCellIdInfo* iCellIdInfo;
    };

#endif      // SUPLPSYCELLIDHANDLER_H
            
// End of File