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

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

• 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).