1 // Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).

     2 // All rights reserved.

     3 // This component and the accompanying materials are made available

     4 // under the terms of "Eclipse Public License v1.0"

     5 // which accompanies this distribution, and is available

     6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".

     7 //

     8 // Initial Contributors:

     9 // Nokia Corporation - initial contribution.

    10 //

    11 // Contributors:

    12 //

    13 // Description:

    14 //

    15 

    16 /**

    17  @file

    18  @InternalComponent

    19 */

    20 

    21 #ifndef ADAPTATIONPOSITIONER_H

    22 #define ADAPTATIONPOSITIONER_H

    23 

    24 #include <lbs/epos_cpositioner.h>

    25 #include "cpositionerenvironment.h"

    26 #include "mpositioner.h"

    27 #include "lbstimer.h" // for MLbsCallbackTimerObserver & CLbsCallbackTimer

    28 

    29 class CRequestHandler;

    30 class TRequestParameters;

    31 

    32 class CAdaptationPositioner : public CPositioner,

    33 							  public MLbsCallbackTimerObserver,

    34                        		  public MPositioner

    35     {

    36     public:

    37         virtual ~CAdaptationPositioner();

    38 

    39     public:

    40         // From CPositioner.

    41         virtual void NotifyPositionUpdate(TPositionInfoBase& aPosInfo, TRequestStatus& aStatus) = 0;

    42         virtual void CancelNotifyPositionUpdate();

    43         virtual void CancelNotifyPositionUpdate(TInt aError);

    44         virtual TBool TrackingOverridden() const;

    45         virtual void StartTrackingL(const TTimeIntervalMicroSeconds& aInterval);

    46         virtual void StopTracking();

    47 

    48         // From MPositioner

    49         virtual void RequestCompleteNotify(const TPositionInfo& aPositionInfo, TInt aError, TTime& aActualTime);

    50         virtual void ReportStatus(const TPositionModuleStatus& aStatus);

    51 		virtual TBool IsActive();

    52 		virtual void UpdateFailed(TInt aError);		

    53 		virtual TBool IsWarmingDown();

    54 		TUint InactivityTimeout();

    55 		

    56     	// from MLbsCallbackTimerObserver

    57 		void OnTimerEventL(TInt aTimerId);

    58 		TInt OnTimerError(TInt aError, TInt aTimerId);

    59 

    60 		enum TEventId // timer event ID at request queue level

    61 			{

    62 			EMaxFixTimerEvent = 0,

    63 			EWarmDownTimerEvent

    64 			};

    65 

    66     private:

    67 		void UpdateTrackingTime(TTime& aTimeNow);

    68 		void SetTrackingTime();

    69         void MaxFixTimerEvent();

    70         TInt MaxFixTimerError(TInt /*aError*/);

    71         void WarmDownTimerEvent();

    72         TInt WarmDownTimerError(TInt /*aError*/);

    73         TBool IsAccurate(const TPositionInfo& aPositionInfo);

    74     protected:

    75         CAdaptationPositioner();

    76         

    77         virtual void SetModuleId(TPositionInfoBase* aPosInfo) = 0;

    78         

    79 		void SetupTrackingRequestL();

    80 		TBool UseLastLocation(TPositionInfoBase& aPosInfo);

    81         void StartMaxFixTimerL();

    82         void StopMaxFixTimer();

    83         void StartWarmDownTimerL();

    84         void StopWarmDownTimer();

    85  		TBool IsTracking();

    86         void ClearPositionInfo(TPositionInfoBase& aPosInfo);

    87         TBool CompleteRequest(const TPositionInfo& aPositionInfo, TInt aError);

    88        

    89 	protected:

    90 		enum TTrackingState

    91 			{

    92 			ERequestStatePreTracking	= 0x01,

    93 			ERequestStateTracking		= 0x02

    94 			};

    95 			

    96 		enum TRequestState

    97 			{

    98 			ERequestStateInitial		= 0x01,

    99 			ERequestStatePostInitial	= 0x02

   100 			};

   101 

   102         TPositionInfoBase*			iPosInfo;

   103         TRequestStatus*				iClientStatus;

   104 		CRequestHandler*			iRequestHandler;

   105 		CPositionerEnvironment*		iEnvironment;

   106 		

   107 		TBool						iActive;

   108 		TTimeIntervalMicroSeconds	iTrackingInterval;

   109 		TTime 						iTargetTime;

   110 		TTimeIntervalMicroSeconds	iTimeOutInterval;

   111 		TPositionCriteria			iCriteria;

   112 		TRequestState 				iState;

   113 		TUint						iInactivityTimeout;

   114 		

   115     private:

   116     	CLbsCallbackTimer* iMaxFixTimer;

   117     	CLbsCallbackTimer* iWarmDownTimer;

   118     };

   119 

   120 #endif

   121 

   122 // End of File