/*
* Copyright (c) 2006-2009 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:  
*
*/


#ifndef C_CNETWORKINFO_H
#define C_CNETWORKINFO_H

#include <etel3rdparty.h>
#include <etel.h>
#include <etelmm.h>

/**
*  An observer interface, which is used for getting current network cell id.
*
*  @since S60 3.1
*/
class MNetworkInfoObserver
    {
public:    
    /**
     * This method is used for setting the network cell id to the 
     * location trail.
     */
    virtual void NetworkInfo( const CTelephony::TNetworkInfoV1 &aNetworkInfo, const TInt aError ) = 0;

    /**
     * Get mobile phone object for network info object
     * @return mobile phone object
     */
    virtual RMobilePhone& GetMobilePhone4NwInfo() = 0;
    };

/**
 *  
 *  @since S60 3.1
 */
class CNetworkInfo : public CActive
    {
public:  
    /**
     * 2-phased constructor.
     * @since S60 3.1
     */
    IMPORT_C static CNetworkInfo* NewL( MNetworkInfoObserver* aTrail );

    /**
     * C++ destructor.
     * @since S60 3.1
     */    
    IMPORT_C virtual ~CNetworkInfo();

    /**
     * Listen to n/w info change
     * @since S60 9.2
     */    
    IMPORT_C void StartNwInfoChangeNotifier();

   /**
     * Stop n/w info change listener
     * @since S60 9.2
     */    
   IMPORT_C void StopNwInfoChangeNotifier();
   
   /**
     * Map etel to ctelephony
     * @since S60 9.2
     */    
   IMPORT_C static void MapNetworkInfo(CTelephony::TNetworkInfoV1* aISVNetworkInfo, 
       RMobilePhone::TMobilePhoneNetworkInfoV2* aMMNetworkInfo, 
       RMobilePhone::TMobilePhoneLocationAreaV1* aMMArea);
    
    /*
    * Get registrer network country code
    *
    * @return current register n/w info
    */
    RMobilePhone::TMobilePhoneNetworkInfoV2& GetCurrentRegisterNw();
    
protected:
    /**
     * Run error implementation in case of RunL leaving.
     * @since S60 3.1
     */
    TInt RunError( TInt aError );
    
private:
    /**
     * C++ constructor.
     */  
    CNetworkInfo( MNetworkInfoObserver* aTrail );
    
    /**
     * 2nd phase constructor.
     */
    void ConstructL();
    
private:
    /**
    * From CActive.
    */        
    void DoCancel();
    
    /**
    * From CActive.
    */        
    void RunL(); 

private:
   typedef enum
    {
    ENetworkInfoNoOptState = 0x00,
    ENetworkInfoOptGetState,
    ENetworkInfoOptNotifyState
    }TNetworkInfoOptState;
   
    /**
     * An observer interface to set current cell id to the location trail.
     * Not own.
     */
    MNetworkInfoObserver* iTrail;
    
    /**
     * phone object to retrieve modem parameters
     */ 
    RMobilePhone& iMobilePhone;

    /**
     * Maintain the operation state.
     */ 
    TNetworkInfoOptState iState;

    /*
    * Retained this object just to give backward compatibility
    */
    CTelephony::TNetworkInfoV1 iNetworkInfoV1;

	RMobilePhone::TMobilePhoneNetworkInfoV2 iMMNetworkInfo;
	RMobilePhone::TMobilePhoneNetworkInfoV2Pckg iMMNetworkInfoPckg;
	RMobilePhone::TMobilePhoneLocationAreaV1 iMMArea;
    };

#endif // C_CNETWORKINFO_H

// End of file.