Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

#1> gps [options] [command]

Code Block
languagejava
themeDJango
  Options:
    -t=<level>  - turn trace level (1, 2 or 0 - turn trace off)
 	-i=<int>    - set integrator time constant in seconds
    -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:
Center
Scroll Title
titleTable - Command "gps" options
OptionDescription
-t=<level>

The following trace levels are available (from maximum to minimum details):

Level 2
  • Configure event logging
    • "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
-a[=(0:1)]
  • 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 –
      • "1" - to enable the power supply (is used by default, if the value is not specified)
    <value>=
      • "0
      • " - to disable the power supply

    Commands

    Warningcenter
    scroll-title
    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
    titleTable - "gps" command arguments
    CommandDescription
    start
    • Start the GPS service operation
    stop
    • Stop the GPS service operation
    coordinates
    • View information about the GPS/GLONASS-receiver status and its operation statistics
    , you can use the following command:
    • [coordinates]

    Example of status information and statistics outputs:

    Command output example,

    Code Block
    languagejava
    themeDJango
    console>
    #1> 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
    Warning
    titleCAUTION

    It is recommended to use values of “HDOP” parameter up to 1.5 for reliable global timing synchronization

    )

    .

      • FIX
    —   NO
      • - 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

    use "gps stat

    command

    " command instead).

      • "Total GPS time" — total time of GPS utility operation since it was started by "gps start"
    command
      •  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)
    stat
    • View GPS/GLONASS-receiver operation statistics(without the status information)
    clear
    • Reset the statistics data
    Warning
    titleCAUTION

    Please note, that "tcp" and "console" commands and "-i", "-r", "-p" and "-s" options are used for diagnostics and debugging on emergency by specialists only.