Use this command to handle the GPS/GLONASS-receiver.
Syntax:
#1> gps [options] [command]
Options: -t=<level> - turn trace level (1, 2 or 0 - turn trace off) -a[=(0:1)] - turn the power on the antenna amplifier -r[=(0:1)] - set reset signal -p=<port> - set TCP port for service (2323 by default) -s=<baudrate|0> - set baud rate for GPS NMEA port (0 - set 115200) Command: start - start GPS service stop - stop GPS service coordinates - show GPS coordinates console - map GPS NMEA port to stdin/stdout tcp - map GPS NMEA port to TCP service stat - show GPS statistics clear - clear GPS statistics
Options
If you need to configure event logging, you can choose the required trace level, using the following option:
- -t=<level>
The following trace levels are available (from maximum to minimum details):
- Level 2 – to log all the NMEA-messages from the GPS/GLONASS-receiver.
- Level 1 – to log only the messages about discovering / loss of the GPS/GLONASS-receiver, about the changing of the quantity of detected satellites or about substantial changes of coordinates, etc.
- Level 0 – event logging is off.
If you need to enable / disable the power supply to the antenna amplifier (if one is available), you can set the corresponding value, using the following option:
- -a[=<value>]
- <value>=1 – to enable the power supply (is used by default, if the value is not specified)
- <value>=0 – to disable the power supply
CAUTION
Please note, that tcp and console commands and -r, -p and -s options are used for diagnostics and debugging on emergency by specialists only.
Commands
To start the operation of GPS service, use the following command:
- start
To stop the operation of GPS service, use the following command:
- stop
If you need to view statistics of GPS/GLONASS-receiver operation (without the status information), use the following command:
- stat
In order to clear the statistics, use the following command:
- clear
If you need to view the information about the status of GPS/GLONASS-receiver and its operation statistics, you can use the following command:
- [coordinates]
Example of status information and statistics outputs:
console> gps coordinates Satellites: 8 LAT/LONG: 56.811911/60.547041 Altitude: 275.89 HDOP: 0.92 FIX: 3D, GLONASS Total GPS time: 17:43:19 Total nonvalid time: 00:00:01(0%) Number of losses: 0 Now coordinates are valid last 17:43:18 Satellites histogram: ^ | 2.0 + | 3.0 + | 4.0 + | 5.0 + | <1% 6.0 + | 1% 7.0 + |||||||||||||||||||||||||||||||||||||||||||||||||| 99% v SATmin= 5 SATmax= 10
- "Satellites" — quantity of currently visible satellites;
- "LAT/LONG" — geographical coordinates of the receiver in degrees:
- "LAT" (latitude) — latitude from -90.0000000° to +90.0000000°
- "LONG" (longitude) — longitude from -180.0000000° to +180.00000°
- "Altitude" — altitude in meters
- "HDOP" — horizontal dilution of precision
CAUTION
It is recommended to use values of “HDOP” parameter up to 1.5 for reliable global timing synchronization)
- FIX — NO FIX|2D|3D, <unknown>|GPS|GLONASS|GPS+GLONASS – the current position-fix status in the following view: <current fix mode>, <system>. The following values of <current fix mode> are available:
- "NO FIX" - coordinates are not fixed
- "2D" – only latitude and longitude are fixed
- "3D" – latitude, longitude and altitude are fixed.
The following values of <system> (currently used GNSS) are available:
- GPS
- GLONASS
- GPS+GLONASS.
The next block of information is the statistics (to obtain these data without information about status of GPS/GLONASS-receiver you can use gps stat command instead).
- "Total GPS time" — total time of GPS utility operation since it was started by "gps start" command
- "Total nonvalid time" – total time during which the information about coordinates was unavailable
- "Number of losses" — quantity of cases when the information about coordinates had become unavailable
- "Now coordinates are valid last …" - time of GPS utility operation since last coordinates discovering
- "Satellites histogram" - the histogram of visible satellites quantity
- "SATmin" и "SATmax" — minimum and maximum of visible satellites respectively (since the last time you cleared the statistics).