You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Gary E. Miller d0e59c02fe www/gpsd-numbers-matter.adoc: Update lat/lon precision. 1 day ago
.ci-build build.sh: Make run on CentOS 7 and 8 1 year ago
LICENSE LICENSE/BSD-2-Clause: Add a copy of the BSD-2-Clause. 5 months ago
android SConscript; remove netfeed option and NETFEED_ENABLE 2 months ago
clients clients/gpsprof.py.in: Do not crash if -r JSON has no DEVICE. 5 days ago
contrib Ubuntu has abolished /usr/bin/python, change shebangs to python3. 3 months ago
devtools build.adoc: Fix reference to nmea0183=yes. That always built. 3 weeks ago
drivers www/gpsd-numbers-matter.adoc: Update lat/lon precision. 1 day ago
gps gps/ubx.py: Better error messages on bad '-p CFG-MSG' 2 months ago
gpsd libgps/netlib.c: netlib_connectsock1() report IP used. 1 day ago
gpsmon gpsd/ppsthread.c: Enforce pps_get_first() is returning a const char * 4 weeks ago
include libgps/netlib.c: netlib_connectsock1() report IP used. 1 day ago
libgps libgps/netlib.c: netlib_connectsock1() report IP used. 1 day ago
man man/gpsmon.adoc: Fix typos. Tweak text. 3 weeks ago
packaging SConscript, packaging/rpm/gpsd.spec.in, Two more example1.c fixed. 4 months ago
systemd systemd/gpsd.socket.in: Fix IPv6 wildcard binding. 1 year ago
test drivers/driver_rtcm3.c, etc.: Partially decode RTCM3 MSMx to JSON. 1 week ago
tests libgps/gpsdclient.c: maidenhead() returns n/a on invalid input. 1 month ago
www www/gpsd-numbers-matter.adoc: Update lat/lon precision. 1 day ago
.gitignore .gitignore: Update for new version buildtmp directory 2 months ago
.gitlab-ci.yml .gitlab-ci.ymlL Try to fix debian-stable CI by using debian-unstable. 4 months ago
.travis.yml Fix typos 1 year ago
.vimrc .vimrc: Standardize vim settings. Expand tabs. 3 years ago
AUTHORS A glut of whitespace fixes. 7 years ago
Android.bp Remove revision.h. Totally. 2 years ago
COPYING COPYING: Fix copyrights. 2 years ago
HACKING A glut of whitespace fixes. 7 years ago
INSTALL.adoc Revert "Removal of /usr/bin/python from Ubuntu forces python3 as a hard dependency." 3 months ago
NEWS gpsd/gpsd.c: TOFF JSON reports precision and shm. 4 weeks ago
Qgpsmm.pc.in Uppercase substituter tokens in SConstruct, etc. 2 years ago
README.adoc CSS: another shot at fixing docinfo CSS. 8 months ago
SConscript SConscript: Add help that gpsclock is Furuno product. 3 weeks ago
SConstruct SCons*: Start 3.23.2~dev. Fix upload_release 3 months ago
SUPPORT.adoc CSS: another shot at fixing docinfo CSS. 8 months ago
TODO TODO: remove raw data (RINEX) output as done. 9 months ago
build.adoc build.adoc: Update Fedora build instructions. 5 days ago
control.in Add @GENERATED@ template variable. And use it in generated files. 2 years ago
example_aiogps.py example_aiogps.py: Docstring fixes for codacy. 1 year ago
example_aiogps_run Ubuntu has abolished /usr/bin/python, change shebangs to python3. 3 months ago
gpsctl.c gpsctl.c: Style tweaks. Yoda style, braces, // comments. 1 month ago
gpsd.hotplug g[psd.hotplug: Fix copyright, remove tabs. 2 years ago
gpsd.rules.in gpsd.rules.in: add hotplug rule for u-blox 9 1 year ago
gpsd.usermap gpsd.usermap: Fix copyright. 2 years ago
gpsfake.py.in gpsfake.py.in: Fix -o="-G -n" 4 months ago
gpsinit gpsinit: Change -v to -V. 1 year ago
libQgpsmm.prl.in Refactor snomae version building and create QT .pc/.prl files. 10 years ago
libgps.pc.in Uppercase substituter tokens in SConstruct, etc. 2 years ago
maintainers.adoc CSS: another shot at fixing docinfo CSS. 8 months ago
maskaudit.py Ubuntu has abolished /usr/bin/python, change shebangs to python3. 3 months ago
pylintrc pylintrc: Fix copyright. 2 years ago
regress-driver regress-driver: Fix new -C option. 5 months ago
valgrind-audit.py Ubuntu has abolished /usr/bin/python, change shebangs to python3. 3 months ago
valgrind-suppressions gpsd-report() -> gpsd_log() 7 years ago

README.adoc

= gpsd README file
:date: 17 February 2021
:description: README for GPSD
:docinfodir: www
:keywords: GPSD, GPS
:robots: index,follow
:sectlinks:
:type: article
:toc: macro

include::www/inc-menu.adoc[]

WARNING:

The files at https://gitlab.com/gpsd/gpsd/-/tags are NOT the gpsd
release files. DO NOT use them. The release files are at:
http://download-mirror.savannah.gnu.org/releases/gpsd/

== GENERAL

gpsd is a userland daemon acting as a translator between GPS, GNSS, and
AIS receivers and their clients. gpsd listens on port 2947 for clients
requesting position/time/velocity information. The receivers are
expected to generate position information in a well-known format -- as
NMEA-0183 sentences, SiRF binary, Rockwell binary, Garmin binary
format, or other vendor binary protocols. gpsd takes this
information from the GPS and translates it into something uniform and
easier to understand for clients. The distribution includes sample
clients, application interface libraries, and test/profiling tools.

The website for GPSD where you can find updates, news, and
project mailing lists is: https://gpsd.io/

See that website for a list of GPS units known to be compatible.

See the file INSTALL.adoc for installation instructions and some tips on
how to troubleshoot your installation. The file build.adoc has
instructions for building from source. The packaging/ directory
contains resources and suggestions for packagers and distribution
integrators.

== LICENSE

This software (gpsd) is released under the terms and conditions of the BSD
License, a copy of which is included in the file COPYING.

== 1.X CREDITS

Remco Treffkorn designed and originated the code.

Russ Nelson maintained gpsd for a couple of years.

Carsten Tschach's gpstrans-0.31b code was the original model for nmea_parse.c.

Bob Lorenzini <hwm@netcom.com> provided testing and feedback.

Brook Milligan <brook@trillium.NMSU.Edu> combined gpsd and gpsclient
into one package and autoconfiscated it.

Derrick J. Brashear <shadow@dementia.org> (KB3EGH) added code for the
EarthMate DeLorme. He also added "incredibly gross code to output
NMEA sentences" (his own words :-) He also did the first cut at
DGPS support (see http://www.wsrcc.com/wolfgang/gps/dgps-ip.html),
for the Earthmate.

Curt Mills <BowHunter@mail.com> (WE7U) furthered the dgps support,
writing the portion for other GPS receivers.

None of these people have been active in 2.X and later versions; gpsd
has evolved out of recognition from the 1.X codebase.

== 2.X CREDITS

Eric S. Raymond drastically rewrote this code in late 2004/early 2005
to clean it up and extend it. The 2.X architecture has become
significantly different and far more modularized. His new features
included:

* Documentation (what a concept!)
* Cleaned up, simplified command-line options.
* Now understands the GLL (Geographic position - Latitude, Longitude)
sentence from NMEA 3.0.
* Now parses both the NMEA 3.01 and pre-3.01 variants of the VTG sentence
correctly.
* New commands including 'y', 'w', and 'x', since obsolesced by a
JSON-based protocol.
* Massive refactoring -- one main loop now calls a self-contained
driver object for each type.
* The GPS-bashing code the daemon uses can now be directly linked as a
library, libgpsd(3).
* C and Python libraries are available to encapsulate the client side of
querying gpsd, see libgps(3).
* Cleaned-up error reporting, we don't use syslog when running in the foreground
but send all error and status messages to the tty instead.
* Added -n option to do batch monitoring of GPSes.
* xgpsspeed is working again; xgps has been seriously reworked and improved.
* RPMs which include installation of gpsd to start up at boot time
are available.
* New gpsprobe program probes the capabilities of GPSes and generates
error scattergrams from fixes. (Later this moved to gpsprof.)
* Autobauding, self-configuration, and hotplugging. gpsd can now get
its device from a hotplug script, and figures out itself which baud
rate to use and what the GPS's device type is.
* Support for SiRF binary mode.
* Support for RTCM104 and AIVDM.
* Support for multiple devices.
* Other test tools -- gpsfake, gpscat, gpsmon.

Chris Kuethe <ckuethe@mainframe.cx> maintains the OpenBSD port, shipped
the 2.34 release, is our SiRF and low-level protocols expert, and does a
lot of general hacking and support. He has release authority.

Gary E. Miller <gem@rellim.com> wrote the driver for Garmin binary protocol
and most of the support for PPS handling on serial devices. He has release
authority.

Amaury Jacquot <sxpert@esitcom.org> added DBUS support.

Ville Nuorvala <vnuorval@tcs.hut.fi> wrote the NTRIP support.

We are delighted to acknowledge the assistance of Carl Carter, a field
application engineer at SiRF. He assisted us with the correction and
tuning of the SiRF binary-protocol driver, shedding a good deal of
light on murky aspects of the chip's behavior.

We are also delighted to acknowledge the assistance of Timo Ylhainen, VP of
Software Operations at Fastrax. He clarified some points about
the iTalk protocol, helping to further development of iTalk support.

== 3.X CREDITS

The main feature of the 3.x versions is a stabilized and finalized
version of the JSON command/response protocol. This was designed and
mainly implemented by ESR. Gary E. Miller <gem@rellim.com> wrote the
subframe support, gpsplot, gpscsv, and gpssubframe.

== RESOURCES

*Project web site:* {gpsdweb}

== COPYING

This file is Copyright 2013 by the GPSD project +
SPDX-License-Identifier: BSD-2-clause