diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/lbssatellite.h --- a/epoc32/include/lbssatellite.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/lbssatellite.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,126 @@ -lbssatellite.h +// 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 +#include + + +/** +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 iSatellitesInView; + +private: + /** Unused variable for future expansion. */ + TUint8 iReserved[24]; + }; + +#endif //__LBSSATELLITE_H__