le_gnss_interface.h File Reference

#include "legato.h"

Go to the source code of this file.

Macros
#define	LE_GNSS_MAX_SUPL_SERVER_URL_LEN   256
#define	LE_GNSS_MAX_SUPL_CERTIFICATE_LEN   2000

Enumerations
enum	le_gnss_AssistedMode_t { LE_GNSS_STANDALONE_MODE, LE_GNSS_MS_BASED_MODE, LE_GNSS_MS_ASSISTED_MODE }
enum	le_gnss_ConstellationBitMask_t { LE_GNSS_CONSTELLATION_GPS = 0x1, LE_GNSS_CONSTELLATION_GLONASS = 0x2 }

Functions
void	le_gnss_ConnectService (void)
void	le_gnss_DisconnectService (void)
le_result_t	le_gnss_SetConstellation (le_gnss_ConstellationBitMask_t constellationMask)
le_result_t	le_gnss_GetConstellation (le_gnss_ConstellationBitMask_t *constellationMaskPtr)
le_result_t	le_gnss_LoadExtendedEphemerisFile (int fd)
le_result_t	le_gnss_GetExtendedEphemerisValidity (le_clk_Time_t *startTimePtrPtr, le_clk_Time_t *stopTimePtrPtr)
le_result_t	le_gnss_ForceColdRestart (void)
le_result_t	le_gnss_SetSuplAssistedMode (le_gnss_AssistedMode_t assistedMode)
le_result_t	le_gnss_GetSuplAssistedMode (le_gnss_AssistedMode_t *assistedModePtr)
le_result_t	le_gnss_SetSuplServerUrl (const char *suplServerUrlPtr)
le_result_t	le_gnss_InjectSuplCertificate (uint8_t suplCertificateId, uint16_t suplCertificateLen, const char *suplCertificatePtr)
le_result_t	le_gnss_DeleteSuplCertificate (uint8_t suplCertificateId)

Detailed Description

Legato GNSS include file.

Copyright (C) Sierra Wireless Inc. Use of this work is subject to license.

Macro Definition Documentation

#define LE_GNSS_MAX_SUPL_CERTIFICATE_LEN   2000

Maximum SUPL certificate size.

#define LE_GNSS_MAX_SUPL_SERVER_URL_LEN   256

Maximum length of the SUP Server URL string.

Enumeration Type Documentation

enum le_gnss_AssistedMode_t

Assisted-GNSS mode

Enumerator
LE_GNSS_STANDALONE_MODE	Standalone mode.
LE_GNSS_MS_BASED_MODE	MS-Based mode.
LE_GNSS_MS_ASSISTED_MODE	MS-Assisted mode.

enum le_gnss_ConstellationBitMask_t

GNSS constellation Bit Mask (8 bits) indicating the GNSS constellation(s) used in solution.

Enumerator
LE_GNSS_CONSTELLATION_GPS	GPS constellation used in solution.
LE_GNSS_CONSTELLATION_GLONASS	GLONASS constellation used in solution.

Function Documentation

void le_gnss_ConnectService

(

void

)

Connect the client to the service

le_result_t le_gnss_DeleteSuplCertificate

(

uint8_t

suplCertificateId

)

This function deletes the SUPL certificate.

Returns

• LE_OK on success
• LE_FAULT on failure
• LE_BUSY service is busy
• LE_TIMEOUT a time-out occurred

Parameters

[in]

suplCertificateId

Certificate ID of the SUPL certificate. Certificate ID range is 0 to 9

void le_gnss_DisconnectService

(

void

)

Disconnect the client from the service

le_result_t le_gnss_ForceColdRestart

(

void

)

This function clears ephemeris, position and time data before performing a restart.

Returns

LE_FAULT The function failed.

LE_OK The function succeeded.

le_result_t le_gnss_GetConstellation

(

le_gnss_ConstellationBitMask_t *

constellationMaskPtr

)

Get the GNSS constellation bit mask

Returns

• LE_OK on success
• LE_FAULT on failure

Parameters

[out]

constellationMaskPtr

GNSS constellation used in solution.

le_result_t le_gnss_GetExtendedEphemerisValidity	(	le_clk_Time_t *	startTimePtrPtr,
		le_clk_Time_t *	stopTimePtrPtr
	)

This function must be called to get the validity of the last injected Extended Ephemeris.

Returns

LE_FAULT The function failed to get the validity

LE_OK The function succeeded.

Parameters

[out]	startTimePtrPtr	Start time
[out]	stopTimePtrPtr	Stop time

le_result_t le_gnss_GetSuplAssistedMode

(

le_gnss_AssistedMode_t *

assistedModePtr

)

This function gets the SUPL Assisted-GNSS mode.

Returns

• LE_OK on success
• LE_FAULT on failure

Parameters

[out]

assistedModePtr

Assisted-GNSS mode.

le_result_t le_gnss_InjectSuplCertificate	(	uint8_t	suplCertificateId,
		uint16_t	suplCertificateLen,
		const char *	suplCertificatePtr
	)

This function injects the SUPL certificate to be used in A-GNSS sessions.

Returns

• LE_OK on success
• LE_FAULT on failure
• LE_BUSY service is busy
• LE_TIMEOUT a time-out occurred

Parameters

[in]	suplCertificateId	Certificate ID of the SUPL certificate. Certificate ID range is 0 to 9
[in]	suplCertificateLen	SUPL certificate size in Bytes.
[in]	suplCertificatePtr	SUPL certificate contents.

le_result_t le_gnss_LoadExtendedEphemerisFile

(

int

fd

)

This function must be called to load an 'Extended Ephemeris' file into the GNSS device.

Returns

LE_FAULT The function failed to inject the 'Extended Ephemeris' file.

LE_OK The function succeeded.

Parameters

[in]

fd

Extended ephemeris file descriptor

le_result_t le_gnss_SetConstellation

(

le_gnss_ConstellationBitMask_t

constellationMask

)

Set the GNSS constellation bit mask

Returns

• LE_OK on success
• LE_FAULT on failure
• LE_UNSUPPORTED request not supported

Parameters

[in]

constellationMask

GNSS constellation used in solution.

le_result_t le_gnss_SetSuplAssistedMode

(

le_gnss_AssistedMode_t

assistedMode

)

This function sets the SUPL Assisted-GNSS mode.

Returns

• LE_OK on success
• LE_FAULT on failure
• LE_UNSUPPORTED request not supported
• LE_TIMEOUT a time-out occurred

Parameters

[in]

assistedMode

Assisted-GNSS mode.

le_result_t le_gnss_SetSuplServerUrl

(

const char *

suplServerUrlPtr

)

This function sets the SUPL server URL. That server URL is a NULL-terminated string with a maximum string length (including NULL terminator) equal to 256. Optionally the port number is specified after a colon.

Returns

• LE_OK on success
• LE_FAULT on failure
• LE_BUSY service is busy
• LE_TIMEOUT a time-out occurred

Parameters

[in]

suplServerUrlPtr

SUPL server URL.