summaryrefslogtreecommitdiff
path: root/contrib/README
blob: 75c4684e2c4fb4f9a386ae55518ea44fe3d31bf2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
The following tools are not production-ready. They are included only as
conveniences, examples or rudimetary starting points for other development
efforts.

binlog and binreplay are probably only useful for people developing
drivers for new protocols, when gpsfake does not yet know what to do
with a log file. These utilities are not particularly clever - they
merely slurp a tty's output into a file, or spray the contents of a
file out of a tty.

ashctl might be used to reset an uncooperative Ashtech receiver to
a usable state. For whatever reason sometimes they do not respond to
a protocol switch command; this spams the receiver with configuration
commands, and hopefully it listens.

motosend is like ashctl, but for receivers that use the motorola
protocol (like motorola oncore or rockwell jupiter). it's a little
buggy with syncing up to the start of a packet, but it'll send control
strings OK.

lla2ecef transforms latitude/longitude/altitude (aka north-east-up or local
tangential plane) coordinates into the earth-centered-earth-fixed frame. If
invoked as "ecef2lla" it will transform coordinates in the opposite manner.

------
The files below have been tested to work with gpsd v3.14, as of 2015-03-23

webgps.py draws a sky view of the satellites and their tracks using HTML5. It
needs to run continuously in order to build a history and generate the
satellite tracks. Your browser must be able to display the <canvas> element to
display the satellite view properly. webgps.py can be called with the argument
"c" to run continously, with an integer duration and a unit suffix to run this
long (units allowed are "s", "m", "h" and "d", e.g. "4h"), or without argument
to create a snapshot of the current sat view.

ntpoffset generate an estimate of your GPS's offset from a peerstats
file.  For instructions on how to use this script, see the GPSD Time
Service HOWTO in this distrubution, in the www/ subdirectory.

ppscheck watches a specified serial device for changes in handshake lines
CD, RI, and CTS by running ioctl(...., TIOCMIWAIT, ...) in a loop.  When it
sees a state change it emits a timestamped line of output dumping the state
of the handshake signals. It's useful for checking whether a device is
emitting 1PPS.  There is troubleshooting advice in the header comment.
  
------
The files below do not work with current versions of gpsd.

[The GPSD protocol changed in 2.90, and messages emitted are no longer
of the form that this script expects. It is currently being updated
by Sanjeev Gupta]

skyview.php is used to generate pictures of your skyview, and may be
used to help determine if a given antenna placement is appropriate for
some purpose. This tool requires about 24hrs worth of "Y" messages and
outputs an image of accumulated SV position and signal strength. It is
sometimes entertaining to "see" occulted SVs using multipath. You must
have the PHP-GD library installed to use this script.

[The GPSD protocol changed in 2.90, and messages emitted are no longer
of the form that this script expects.]

maxsats.pl analyzes a collection of "Y" messages and outputs records
describing periods of excellent visibility (ie. 10 or more PRNs tracked).
With over 30 SVs on orbit, there are periods where 14 PRNs are above the
horizon, 13 are tracking, and at least 12 are actually used in a solution.