summaryrefslogtreecommitdiff
path: root/contrib/README
blob: 87fc203e11eb7eae5a5f68946108e11e5a6fb711 (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
etc_default_gpsd  and etc_init.d_gpsd are Debian init files to be
used when it is desired to support gpsd using a set of serial GPSes.

/* ********************************************************************** */

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

sirfctl might be used to reset an uncooperative sirfstar 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. This works at least as well as
the official SiRF tools.

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 installed to use this script.

ashctl is like nmeasend or sirfctl, but for Ashtech receivers.

motosend is like nmeasend or sirfctl, 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.

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.

gpsdlcdd.c is a lcdproc client for gpsd that turns your car computer
into a rudimentary GPS receiver (provided you have at least a 4x40 LCD
screen plugged in and configured to work with lcdproc).

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.

garreset attempts to force a garmin receiver back to NMEA mode - useful for
recovering a receiver after sending the wrong configuration message.