/*

* Copyright (c) 2003-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:  Interface for the DRMClock

*

*/

#ifndef DRMCLOCK_H

#define DRMCLOCK_H

// INCLUDES

#include <e32base.h>	// CBase

#include <e32std.h>

#include <e32def.h>		// Type definitions

#include <bacntf.h>

#include <etelmm.h>

#include <DRMTypes.h>

#include <e32property.h>

// CONSTANTS

// MACROS

// DATA TYPES

// FUNCTION PROTOTYPES

// FORWARD DECLARATIONS

class CDRMNitzObserver;

class CDRMNotifier;

class CGPSWatcher;

// CLASS DECLARATION

/**

*  CDRMClock implements the drm clock required by DRM Engine

*

*  @lib unipertar.exe

*  @since 2.8

*/

NONSHARABLE_CLASS( CDRMClock )

    {

    public:

        // Notifications:        

        enum 

            {

            ENotifyNone = 0,    

            ENotifyGPSTimeReceived = 1    

            };    

    public:

        /**

        * NewLC

        *

        * Creates an instance of the CDRMClock class and returns a pointer to it

        * The function leaves the object into the cleanup stack

        *

        * @since  2.8

        * @return Functional CDRMClock object, Function leaves if an error occurs.

        */

        static CDRMClock* NewLC();

        /**

        * NewL

        *

        * Creates an instance of the CDRMClock class and returns a pointer to it

        *

        * @since  2.8

        * @return Functional CDRMClock object, Function leaves if an error occurs.

        */

        static CDRMClock* NewL();

        /**

        * Destructor

        */

        virtual ~CDRMClock();

        /**

        * GetSecureTime

        * 

        * Return the current time and the security of the current time

        *

        * @since 2.8

        * @param aTime : return parameter for time in UTC

        * @param aTimeZone : return parameter for the timezone in +/-15 minutes

        * @param aSecurityLevel : return parameter for security level

        * @return none

        */

        void GetSecureTime(TTime& aTime, TInt& aTimeZone, 

                           DRMClock::ESecurityLevel& aSecurityLevel);

        /**

        * ResetSecureTimeL

        *

        * Resets the secure time source and recalculates the offsets

        *

        * @since 2.8 

        * @param aSecureTime, the new secure time in UTC

        * @param aTimeZone, the time zone of the new secure time in +/- 15 minutes 

        * @return none, Function leaves with Symbian OS error code if an

        *         error occurs

        */

        void ResetSecureTimeL( const TTime& aSecureTime, const TInt& aTimeZone );

        /**

        * Notify

        *

        * Notifies about an event to the DRM Clock

        *

        * @since 9.2

        * @param Message The notification event   

        *

        */

        void Notify( TInt aMessage );

    protected:    

    private:

        /**

        * Default Constructor - First phase

        */

        CDRMClock();

         /**

        * ConstructL

        *

        * Second phase constructor

        *

        * @since  2.8

        * @return Leaves if an error occurs

        */	   

        void ConstructL();

        /**

        * ConnectToPhoneL

        *

        * Connects to the phone services

        *

        * @since 2.8

        * @return Leaves with symbian os error codes if an error occurs

        */

        void ConnectToPhoneL();

        // Variables

        CDRMNotifier* iNotifier;   

        // Nitz information handles      

        RTelServer iEtelServer;

        RMobilePhone iPhone;

        CDRMNitzObserver* iObserver;

        // GPS watcher component, updates DRM time from GPS if available

        CGPSWatcher* iGpsWatcher;

    };

#endif      // DRMCLOCK_H   

// End of File