/*
* 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:  Defines APIs to communicate with Central Repository
*
*/


#ifndef FMRADIOENGINECENTRALREPOSITORYHANDLER_H
#define FMRADIOENGINECENTRALREPOSITORYHANDLER_H

//  INCLUDES
#include "fmradioregion.h"

// CONSTANTS
const TInt KBufferLength = 20;
const TInt KStreamBufferSize = 100;

// Forward declare implementation class
class TRadioSettings;
class CRepository;

// CLASS DECLARATION

/**
*  it is a wrapper of Central Repository, responsible for the operations that need to access 
*  the central respositorhy.
*
*  @lib FMRadioEngine.lib
*  @since Series 60 3.0_version
*/
class CCentralRepositoryHandler : public CBase
    {
    public:
      	/**
      	* Two-phased class constructor.
      	* @param aRadioSettings  pointer to the CRadioSettings class
      	*/
        static CCentralRepositoryHandler* NewL(TRadioSettings& aRadioSettings);
      	/**
      	* Destructor of CCentralRepositoryHandler class.
      	*/
        virtual ~CCentralRepositoryHandler();
    public:
      	/**
      	* Save all engine related persistent info back to Central Repository
        * @since Series 60 3.0
      	* @return none
      	*/
        void SaveEngineSettings();
        
	    TInt CountRegions() const;
	    CFMRadioRegion& Region( TInt aIndex ) const;
	    TInt RegionId() const;
	    TUint32 FrequencyStepSize() const;
	    TUint32 MaxFrequency() const;
	    TUint32 MinFrequency() const;
	    TInt DecimalCount() const;
	    
	    void SetRegionIdL( TInt aRegion );
	    
	    /**
	     * Determines if RT+ interaction tutorial dialog has been shown.
	     * See CFMRadioEngine::MusicStoreNoteDisplayed().
	     */
	    TBool MusicStoreNoteDisplayed();
	    /**
	     * Sets RT+ interaction tutorial dialog as displayed.
	     * See CFMRadioEngine::SetMusicStoreNoteDisplayed().
	     */
	    void SetMusicStoreNoteDisplayed();
	    /**
	     * Gets supported RT+ interactions. See CFMradioEngine::GetRTPlusSupportLevel().
	     */
	    TInt GetRTPlusSupportLevel();
	    
	    /**
		* Checks if offine profile is current active profile
		* @return true/false 
		*/
		TBool IsOfflineProfileActiveL();
		/**
		* Increases startup time by one and returns amount of program startups.
		* Also updates count to the repository.
		*/
		void IncreaseStartupCount() const;
		/*
		* Save headset volume level to the repository
		*/
		void SaveHeadsetVolumeSetting() const;
		/*
		* Save speaker volume level to the repository
		*/
		void SaveSpeakerVolumeSetting() const;
		    
    private:
      	/**
      	* Default class constructor.
      	* @param aRadioSettings - pointer to the CRadioSettings class
      	*/
        CCentralRepositoryHandler(TRadioSettings& aRadioSettings);
       	/**
     	* Second phase class constructor.
     	*/
        void ConstructL();
     	/**
     	* Retrieves persistent settings from Central Repository.
     	*/
        void RetrieveInitialSettings();
	    /**
	    * Initializes the regions as defined in the resource file.
	    */
	    void InitializeRegionsL();
	    
	    /**
        * Converts Region ID to index
	    *
        * @param aRegionId The region ID that is wanted to convert
	    * @return The region index, KErrNotFound if no match found
	    */
	    TInt RegionIndexForId( TInt aRegionId ) const;

	    /**
	    * Updates the current region index
	    *
	    * @param aRegionId The new region ID
	    */
        void UpdateCurrentRegionIdx( TInt aRegionId );
        /*
        * Set emulator networkinfo
        *
        */
        #ifdef __WINS__
        void SetInitialSettings();
       	#endif //__WINS__
       	/**
	    * Checks if frequency is in the current region range
	    *
	    * @param aFrequency Frequency to check
	    */
       	TBool IsFrequencyValid( TUint32 aFrequency ) const;
       			       	
	private: // data
       	
        // Handle to Central Repository server
        CRepository* iCentralRepository; 
        // Reference to RadioSetting object     
        TRadioSettings* iRadioSettings;
        /** The current region. */
    	TInt iCurrentRegionIdx;    	    	
    	/** The available regions. */     
    	RPointerArray<CFMRadioRegion> iRegions;
    	
    	
        
    };

#endif  // FMRADIOENGINECENTRALREPOSITORYHANDLER_H

// end of file