Original Author Paul Laughton, 2011
Page 193
De Re BASIC!
elevation
Elevation in degrees
azimuth
Azimuth in degrees
snr
Signal-to-noise ratio: a measure of signal strength
infix
TRUE (non-zero) if the satellite's data was used in the last location fix, else FALSE (0.0)
This is the only GPS command that returns information from both kinds of GPS data. The satellite count
returned in <count_nvar> comes from the location data report, and the satellite list returned in the
satellite list comes from the GPS status report. If nothing changes between reports, the number of
satellites with infix set TRUE is the same as the satellite count value, but this condition cannot be
guaranteed.
The satellite count value is also returned by the GPS.location command. The satellite list is also returned
or updated by the GPS.status command. This command, GPS.satellites, is retained for backward-
compatibility and for convenience.
For example, let's say the most recent GPS status report had data from three satellites with PRNs 4, 7,
and 29.
GPS.OPEN sts
GPS.STATUS , , inView, sats
DEBUG.DUMP.LIST sats
% may print 7.0, 29.0, 4.0
Assume appropriate delays after the GPS.open and that DEBUG is enabled. Another GPS status report
may report data from satellites 4, 7, and 8. Then the list dump might show 7.0, 4.0, 8.0, 29.0. The order
is unpredictable, except that 29.0 will be last, because it is not currently visible. In both cases, the value
of inView is 3.0.
Debug.dump.bundle of the satellite bundle with PRN 4 might show this:
Dumping Bundle 11
prn: 4.0
snr: 17.0
infix: 0.0
elevation: 25.0
azimuth: 312.0
GPS Location commands
These commands report the values returned by the most recent GPS location report. The Gps.satellites
command also returns the list of satellites contained in a GPS status report.
A location report contains:
the location provider
the number of satellites used to generate the data in the report
the time when the data was reported
an estimate of the accuracty of the location components
the location components: