// 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//
#ifndef __LBSSATELLITE_H__
#define __LBSSATELLITE_H__
#include <lbsposition.h>
#include <lbspositioninfo.h>
/**
Maximum number of satellites in view
@publishedAll
@released
*/
const TUint KPositionMaxSatellitesInView = 20;
class TSatelliteData
/**
This class is used to transfer data about a satellite
@publishedAll
@released
*/
{
public:
IMPORT_C TSatelliteData();
IMPORT_C TInt SatelliteId() const;
IMPORT_C void SetSatelliteId(TInt aSatelliteId);
IMPORT_C TReal32 Azimuth() const;
IMPORT_C void SetAzimuth(TReal32 aAzimuth);
IMPORT_C TReal32 Elevation() const;
IMPORT_C void SetElevation(TReal32 aElevation);
IMPORT_C TBool IsUsed() const;
IMPORT_C void SetIsUsed(TBool aIsUsed);
IMPORT_C TInt SignalStrength() const;
IMPORT_C void SetSignalStrength(TInt aSignalStrength);
protected:
/** The ID (in GPS, the PRN) */
TInt iSatelliteId;
/** The azimuth, in degrees */
TReal32 iAzimuth;
/** The elevation, in degrees */
TReal32 iElevation;
/** Whether the satellite is used */
TBool iIsUsed;
/** The signal strength, in decibels */
TInt iSignalStrength;
private:
/** Unused variable for future expansion. */
TUint8 iReserved[16];
};
class TPositionSatelliteInfo : public TPositionCourseInfo
/**
This class is used to store information about positions obtained by satellites.
@publishedAll
@released
*/
{
public:
IMPORT_C TPositionSatelliteInfo();
IMPORT_C TInt GetSatelliteData(TUint aIndex, TSatelliteData& aSatelliteData) const;
IMPORT_C TInt AppendSatelliteData(const TSatelliteData& aSatelliteData);
IMPORT_C TInt NumSatellitesInView() const;
IMPORT_C void ClearSatellitesInView();
IMPORT_C TInt NumSatellitesUsed() const;
IMPORT_C TTime SatelliteTime() const;
IMPORT_C void SetSatelliteTime(TTime aTime);
IMPORT_C TReal32 HorizontalDoP() const;
IMPORT_C TReal32 VerticalDoP() const;
IMPORT_C TReal32 TimeDoP() const;
IMPORT_C void SetHorizontalDoP(TReal32 aDoPValue);
IMPORT_C void SetVerticalDoP(TReal32 aDoPValue);
IMPORT_C void SetTimeDoP(TReal32 aDoPValue);
protected:
/** The number of satellites in view */
TUint iNumSatellitesInView;
/** The number of satellites used */
TUint iNumSatellitesUsed;
/** The time according to the satellite */
TTime iSatelliteTime;
/** The horizontal dilution of precision */
TReal32 iHorizontalDoPValue;
/** The vertical dilution of precision */
TReal32 iVerticalDoPValue;
/** The position dilution of precision */
TReal32 iTimeDoPValue;
/** The satellites in view */
TFixedArray<TSatelliteData, KPositionMaxSatellitesInView> iSatellitesInView;
private:
/** Unused variable for future expansion. */
TUint8 iReserved[24];
};
#endif //__LBSSATELLITE_H__