Skip to main content

gnss-session.assist.read()

Get the status of the BG96’s gpsOneXTRA assistance data

Availability

Device (from impOS™ 44)
Only available on imps with cellular modems

Returns

Table — See below

Description

This documentation covers a feature not yet available in a production version of impOS and has been provided for early testers only. It is preliminary and subject to change

This method is used to get information about the status of any data provided to the BG96 modem’s gpsOneXTRA assistance function, which simplifies the application of GNSS assistance data.

The method returns a table containing three keys: xtradatadurtime, injecteddatatime and status.

The value of status will be zero if no error occurred, or an error code (see gnss-session for details). If status is not zero, the keys xtradatadurtime and injecteddatatime will not be included in the table.

The value of xtradatadurtime is an integer indicating the remaining time in minutes for which the current assistance data will be valid. A value of zero indicates that the data is out of date, or that no assistance data has been uploaded.

The value of injecteddatatime is the date and time when the data, if present, became valid. This information is provided as a string in the format YYYY/MM/DD,hh:mm:ss, eg. 2016/01/03,15:34:50.