diff options
| author | Gary E. Miller <gem@rellim.com> | 2019-03-08 14:37:15 -0800 |
|---|---|---|
| committer | Gary E. Miller <gem@rellim.com> | 2019-03-08 14:37:15 -0800 |
| commit | f9d91bb8cf8b6bfe7d3c8a886be1ae1ceddc9a23 (patch) | |
| tree | 6f4e14361a5eb9d1b383f985843617190ac2d79c /www | |
| parent | 19726bf0fb91f60a3e7b2ea865fb6727566fec2f (diff) | |
| download | gpsd-f9d91bb8cf8b6bfe7d3c8a886be1ae1ceddc9a23.tar.gz | |
timeservice=yes. Fail if no PPS. More documentation.
No point configuring for timeservice if no PPS is possible.
More documentation on what timeservice=yes actually does.
Diffstat (limited to 'www')
| -rw-r--r-- | www/gpsd-time-service-howto.adoc | 28 |
1 files changed, 19 insertions, 9 deletions
diff --git a/www/gpsd-time-service-howto.adoc b/www/gpsd-time-service-howto.adoc index db30d8f2..3bee4720 100644 --- a/www/gpsd-time-service-howto.adoc +++ b/www/gpsd-time-service-howto.adoc @@ -297,18 +297,28 @@ the normal modular way, this package installation will suffice. === Building gpsd == A normal gpsd build includes support for interpreting 1PPS pulses that -is mostly autoconfiguring and requires no special setup. +is mostly autoconfiguring and requires no special setup. If the +current system supports pps. You can build a version stripped to the mimimum configuration required for time service. This reduces the size of the binary and may be helpful on embedded systems or for SBCs like the Raspberry Pi, Odroid, -or BeagleBone. Only do this if you have serious size contraints. When -gpsd is built in this way, the -n (nowait) option is forced: gpsd opens -its command-line devices immediately on startup. The timerservice=yes -option also forces the building of ntpshmmon, cgps and gpsmon. Those -program would be built by default anyway, unless gpsdclients=n0. +or BeagleBone. Only do this if you have serious size contraints, much +functionality will be lost. -Do it like this: +When gpsd is built with timeservice=yes: + +1. The -n (nowait) option is forced: gpsd opens its command-line devices + immediately on startup. + +2. Forces the building of ntpshmmon, cgps and gpsmon. Those program would + be built by default anyway, unless gpsdclients=n0. + +3. The configure will fail if pps is not available. + +4. Most drivers will not be built. You must specify them when configuring. + +To configure the minimal timeservice build: ----------------------------------------------------------------------------- scons timeservice=yes nmea0183=yes fixed_port_speed=9600 fixed_stop_bits=1 @@ -319,8 +329,8 @@ also fix the serial parameters to avoid autobauding lag; the code assumes 8 bit bytes, so the above locks the daemon to 9600 8N1. Besides the daemon, this also builds gpsmon and ntpshmmon. -Otherwise, make sure the build is with pps=yes and ntpshm=yes (the -default). +if you do not use timeservice=yes, then make sure the build is with +pps=yes and ntpshm=yes (the default). === Kernel support === |