fdhwlib  2.0.25
Gpsserver interactive commands

The gpsserver can be monitored if started in interactive mode.

Several commands allow to modify some parameters and show the status of the gps clock and server. For some commands an abreviation is available.

Command list:

GpsClock> help
GpsClock command summary:
 id                             Display GpsClock version
 (d)ebug level                  Change debug level (0 = no debug output)
 (s)tatus [n]                   Display status information
 (l)og [interval]               Set log interval
 tz [t]                         Set timezone in hours relative to UTC
 test                           Perform selftest
 pos mode                       Set position mode (0 = not fix, 1= fix)
 quit                           Quit gpsserver

Example: Display the gpsclock id string

GpsClock> id
Request Oncore Id ...

Oncore Id message:
@@Cj
COPYRIGHT 1991-1997 MOTOROLA INC.
SFTW P/N #     98-P36848P
SOFTWARE VER # 3
SOFTWARE REV # 2
SOFTWARE DATE  Aug 23 2000
MODEL #    R5122U1115
HWDR P/N # 446700002118
SERIAL #   446700002118
MANUFACTUR DATE 9/27/02

Status information

GpsClock> s 0
 ________________________________
/ GpsClock  /dev/oncore.serial.1 \
--------------------------------------------------------------------------------
+ Status: ONCORE_RUN          Clock   : 08.09.2006  09:14:56 (???) LeapSecs  14
 Almanac: Ok                  Position: Karlsruhe (49.09 E 8.43 N, 175.59m)
     Sat: Ok                            0D, ONCORE_SS_UNKNOWN  - 00:00:00
        : vis= 7 track= 3     Timezone:   0:00
HwSurvey: no                  Adjust  : Auto (Auger-Oncore 0s)
  Oncore:  8 channel          Eyestat : Karlsruhe (Id  5)
 Version: 5.0
   Flags: oncoreErrors=0   augerErrors=0

+ Gate Generators  :                       Lidar    0 Hz           Inhibit   0
 Ch |                           Start [s]        |   N T[s]    Pulse [us] Mode
  1 | 12:00:31  07.09.2006      841676444        |   0    1      0-    10  ext 0
  2 | 04:56:33  07.09.2006      841651006        |   1    1 250000-250010  ext 0
  3 | 04:56:33  07.09.2006      841651006        |   1    1 500000-500010  ext 0
  4 | 04:56:33  07.09.2006      841651006        |   1    1 750000-750010  ext 0

+ Input channels   :
  1 |                                            |                         ext 0
  2 |                                            |                         ext 0
  3 |                                            |                         ext 0
  4 |                                            |                        veto 0


+ Connections      :
 Fd Local address            Foreign address          State
  0 Stdin                                             Waiting for keyboard input
  3
  4 0.0.0.0:5198                                      Waiting for connections

To analyse the status of the gpsserver / gpsclock two types of additional output can be activated. With the command "log" the logging interval is selected. A summary of the second counters and timing information is given every n seconds.

GpsClock> log
Logging interval set to 1 seconds


Idx |  PC time      PC clock    AugerFPGA       Oncore |    Count Phase Sawt.
------------------------------------------------------------------------------
 37 | 06:50:23     841744237    841744237    841744237 | 79996216     4    39
 38 | 06:50:24     841744238    841744238    841744238 | 79996225     2     6
 39 | 06:50:25     841744239    841744239    841744239 | 79996216     1   -25
 40 | 06:50:26     841744240    841744240    841744240 | 79996216     8    47
GpsClock> l

The second option is to enable debug output. This will allow to alayse the detailed gpsclock messages. In the sample output you can see the three peridically received messages @@Ea, @@En and !!F.

GpsClock> debug 2
Changed debug level to 2

1<<--       @@Ea
 40 40 45 61 09 08 07 d6 09 0e 24 00 0e 25 77 0a   @@Ea......$..%w.
 88 c2 aa 01 cf 20 f6 00 00 44 97 00 00 00 00 00   ..... ...D......
 00 00 00 00 00 01 07 03 1a 08 2e a2 00 00 00 00   ................
 0a 08 32 a2 1c 00 00 20 13 00 00 20 15 08 2a a2   ..2.... ... ..*.
 08 00 00 20 1b 00 00 20 08 22 0d 0a .. .. .. ..   ... ... ."..
1  BadAlm Sats<3 DifFix PosHld 2D Fix 3D Fix PoorGe PosPrp SatsVi SatsTr
1       0      0      0      1      0      0      0      0      7      3
1<<--       @@En
 40 40 45 6e 01 01 00 05 01 00 00 01 00 00 00 00   @@En............
 00 00 00 01 00 02 02 ff ff 09 1a 00 0d 6c 10 00   .............l..
 00 00 29 79 0a 00 0d 6c 08 1c 00 0d 68 88 13 00   ..)y...l....h...
 0d 68 56 15 00 0d 6b ad 08 00 0d 67 62 1b 00 0d   .hV...k....gb...
 69 23 2d 0d 0a .. .. .. .. .. .. .. .. .. .. ..   i#-..
1<<--       !!F
 21 21 46 00 32 2b f7 0a 14 c4 a5 3f 0d .. .. ..   !!F.2+.....?.
1<<--       @@Ea
 40 40 45 61 09 08 07 d6 09 0e 25 00 0e df 04 0a   @@Ea......%.....
 88 c2 aa 01 cf 20 f6 00 00 44 97 00 00 00 00 00   ..... ...D......
 00 00 00 00 00 01 07 03 1a 08 2d a2 00 00 00 00   ..........-.....
 0a 08 32 a2 1c 00 00 20 13 00 00 20 15 08 28 a2   ..2.... ... ..(.
 08 00 00 20 1b 00 00 20 08 ab 0d 0a .. .. .. ..   ... ... ....
1  BadAlm Sats<3 DifFix PosHld 2D Fix 3D Fix PoorGe PosPrp SatsVi SatsTr
1       0      0      0      1      0      0      0      0      7      3
1<<--       @@En
 40 40 45 6e 01 01 00 05 01 00 00 01 00 00 00 00   @@En............
 00 00 00 01 00 02 02 ff ff d7 1a 00 0e 25 9d 00   .............%..
 00 00 29 79 0a 00 0e 25 95 1c 00 0e 22 14 13 00   ..)y...%...."...
 0e 21 e2 15 00 0e 25 3a 08 00 0e 20 ef 1b 00 0e   .!....%:... ....
 22 af 1f 0d 0a .. .. .. .. .. .. .. .. .. .. ..   "....
1<<--       !!F
 21 21 46 00 32 2b f7 0b 14 c4 a5 47 0d .. .. ..   !!F.2+.....G.
GpsClock> d