|
|
|
@ -1,4 +1,4 @@ |
|
|
|
= GPSD Installation Instructions = |
|
|
|
= GPSD Installation Instructions |
|
|
|
:title: GPSD Installation Instructions |
|
|
|
:description: Steps for installing GPSD and verifying its performance. |
|
|
|
:keywords: GPSD, GPS, installation |
|
|
|
@ -11,14 +11,14 @@ They assume you have GPSD available as an installable binary package, |
|
|
|
Instructions for building GPSD from source (including cross-building) |
|
|
|
are in the file "build.adoc" in the source distribution. |
|
|
|
|
|
|
|
Most of these installation instructions are generic to Linux (inc |
|
|
|
There are some special notes on installation for OS X and the Raspberry Pi |
|
|
|
near the end of this file. |
|
|
|
Most of these installation instructions are generic to Linux. There are |
|
|
|
some special notes on installation on *BSD, WSL, OS X, macOS, and the |
|
|
|
Raspberry Pi near the end of this file. |
|
|
|
|
|
|
|
== Check that your GPS is live and you can get data from it == |
|
|
|
== Check that your GPS is live and you can get data from it |
|
|
|
|
|
|
|
Start by making sure you can get data from your GPS, otherwise the later |
|
|
|
steps will be very frustrating. In this command |
|
|
|
steps will be very frustrating. In this command: |
|
|
|
|
|
|
|
stty -F /dev/ttyXXX ispeed 4800 && cat </dev/ttyXXX |
|
|
|
|
|
|
|
@ -46,7 +46,7 @@ Under a stock Linux kernel these will all be loaded on demand when |
|
|
|
the USB system sees the appropriate vendor/product ID combinations. |
|
|
|
See build.adoc for instructions relating to custom kernels. |
|
|
|
|
|
|
|
== Check that your system configuration will allow GPSD to work == |
|
|
|
== Check that your system configuration will allow GPSD to work |
|
|
|
|
|
|
|
Ensure that device permissions will enable gpsd to read from and write |
|
|
|
to GPS devices even after it drops root privileges. If you are |
|
|
|
@ -81,25 +81,26 @@ the permission-setting part; the hotplug scripts will force the |
|
|
|
permissions for you. You still have to make sure all the tty devices |
|
|
|
are in the same group. |
|
|
|
|
|
|
|
== Check your installation prerequisites == |
|
|
|
== Check your installation prerequisites |
|
|
|
|
|
|
|
A minimum build of GPSD can run pretty close to the metal; all it |
|
|
|
absolutely needs is the C runtime support. The test clients and |
|
|
|
various additional features have additional prerequisites: |
|
|
|
|
|
|
|
|=============================================================================== |
|
|
|
|pps-tools | for PPS time keeping |
|
|
|
|asciidoctor | to build the documentation and www |
|
|
|
|dbus | gpsd will issue DBUS notifications |
|
|
|
|ncurses | for cgps and gpsmon clients |
|
|
|
|gnuplot | to plot gpsprof output. |
|
|
|
|GTK | for python-GI |
|
|
|
|libtinfo5 | low-level terminfo library (see below) |
|
|
|
|libusb-1.0.x or later | for older Garmin USB devices |
|
|
|
|Qt | libQgpsmm depends on this |
|
|
|
|python2.x(x>=6) or 3.y(y>=2) | required for various clients and utilities |
|
|
|
|ncurses | for cgps and gpsmon clients |
|
|
|
|pps-tools | for PPS time keeping |
|
|
|
|PyGObject | for xps and xgpsspeed clients (see below) |
|
|
|
|python-cairo | for python-GI |
|
|
|
|GTK | for python-GI |
|
|
|
|pyserial | for ubxtool and zerk in direct-serial mode |
|
|
|
|gnuplot | to plot gpsprof output. |
|
|
|
|python2.x(x>=6) or 3.y(y>=2) | required for various clients and utilities |
|
|
|
|python-cairo | for python-GI |
|
|
|
|Qt | libQgpsmm depends on this |
|
|
|
|=============================================================================== |
|
|
|
|
|
|
|
Some ncurses packages contain the terminfo library; some break it out |
|
|
|
@ -116,9 +117,9 @@ The asynchronous python module (gps/aiogps.py) and its example client |
|
|
|
See below for more specific module requirements in the individual |
|
|
|
distribution instructions. |
|
|
|
|
|
|
|
== Installing gpsd == |
|
|
|
== Installing gpsd |
|
|
|
|
|
|
|
=== Install your distributions package(s) === |
|
|
|
=== Install your distributions package(s) |
|
|
|
|
|
|
|
Up-to-date gpsd packages are generally available for Linux distributions |
|
|
|
including Debian and derivatives (including Ubuntu and Mint), Fedora and |
|
|
|
@ -134,12 +135,12 @@ However, many distributions break up GPSD into separate installable |
|
|
|
packages for the core daemon and clients; you should search your |
|
|
|
repository index for anything with gpsd as a prefix. |
|
|
|
|
|
|
|
=== Install from source code === |
|
|
|
=== Install from source code |
|
|
|
|
|
|
|
Directions for installing from source are in the file build.adoc found |
|
|
|
in the source distribution. |
|
|
|
|
|
|
|
== How to test the software == |
|
|
|
== How to test the software |
|
|
|
|
|
|
|
1. Start gpsd. You'll need to give it as an argument a path to |
|
|
|
a serial or USB port with a GPS attached to it. Your test command |
|
|
|
@ -169,11 +170,11 @@ and begin delivering fixes. |
|
|
|
6. A FAQ and troubleshooting instructions can be found at the GPSD |
|
|
|
project site. |
|
|
|
|
|
|
|
== Once you have verified correct operation == |
|
|
|
== Once you have verified correct operation |
|
|
|
|
|
|
|
1. If you installed from a .deb under Debian or a Debian-derived |
|
|
|
system, you may need to `dpkg-reconfigure -plow gpsd' to enable the |
|
|
|
hotplug magic ("Start gpsd automatically"). |
|
|
|
1. If you installed from a '.deb' package under Debian or a |
|
|
|
Debian-derived system, you may need to `dpkg-reconfigure -plow gpsd' to |
|
|
|
enable the hotplug magic ("Start gpsd automatically"). |
|
|
|
|
|
|
|
2. Check out the list of supported hardware at the Hardware page on |
|
|
|
the GPSD project's website. If your GPS isn't on the list, please send |
|
|
|
@ -195,7 +196,36 @@ in the packages available from distributions. |
|
|
|
For special instructions related to using GPSD for time service, see the |
|
|
|
GPSD Time Service HOWTO in the distribution or on the web. |
|
|
|
|
|
|
|
== Special Notes for OS X Installation == |
|
|
|
== Apple Desktop |
|
|
|
|
|
|
|
=== Special Notes for macOS X Installation |
|
|
|
|
|
|
|
gpsd will build, install and run on macOs. Install the Xcode application |
|
|
|
from the Apple store. Then install Homebrew (https://brew.sh/) to get |
|
|
|
all the stuff you need, like git, scons, python, etc. |
|
|
|
|
|
|
|
As a normal user, install homebrew, then install scons and asciidoctor. |
|
|
|
Installing scons pulls in python3. Brew will become root as needed, so |
|
|
|
starting asd a normal user is just security theater. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" |
|
|
|
$ brew install scons asciidoctor |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Now you need to become root. Make a place for the gpsd source to live, |
|
|
|
use git to install it there, then go there. Build gpsd with "scons", |
|
|
|
then install it with "scons install" |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# mkdir -p /usr/local/src/GPS |
|
|
|
# cd /usr/local/src/GPS |
|
|
|
# git clone https://gitlab.com/gpsd/gpsd.git |
|
|
|
# cd gpsd |
|
|
|
# scons && scons install |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
=== Special Notes for OS X Installation |
|
|
|
|
|
|
|
gpsd will build, install and run on OS X (osX). The easiest way to |
|
|
|
do so is to first install the MacPorts package. Follow their install |
|
|
|
@ -253,7 +283,7 @@ If you are using a USB based GPS you will likely need the Prolific |
|
|
|
PL2303 driver. You can find it here: |
|
|
|
http://www.prolific.com.tw/US/ShowProduct.aspx?p_id=229&pcid=41 |
|
|
|
|
|
|
|
== Special Notes for Raspberry Pi Installation == |
|
|
|
== Special Notes for Raspberry Pi Installation |
|
|
|
|
|
|
|
gpsd will build, install and run on the Raspberry Pi (RasPi) and Pi 2 |
|
|
|
using Debian jessie. Other distributions based on |
|
|
|
@ -261,10 +291,11 @@ Debian (raspbian, etc) will work fine as well. The gpsd |
|
|
|
package in Debian Wheezy is known to be flaky, be sure to update to a |
|
|
|
new version of gpsd from source. |
|
|
|
|
|
|
|
=== Raspbian === |
|
|
|
=== Raspbian |
|
|
|
|
|
|
|
Before compiling gpsd from source, you will need to update your system |
|
|
|
as root. Switching to the latest raspbian distribution (jessie) |
|
|
|
is strongly recommended. |
|
|
|
as root. Switching to the latest Raspbian distribution (Buster) is |
|
|
|
strongly recommended. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt-get update |
|
|
|
@ -273,6 +304,15 @@ is strongly recommended. |
|
|
|
# reboot |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Multiple versions of gpsd can not co-exist on the same system. You need |
|
|
|
to ensure gpsd from a package is not on the system: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt purge gpsd |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Then install the required packages: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt-get install scons libncurses5-dev python-dev pps-tools |
|
|
|
# apt-get install git-core |
|
|
|
@ -282,10 +322,23 @@ Git-core is required to build from a git repository. pps-tools is for |
|
|
|
PPS timing. |
|
|
|
|
|
|
|
The rest of the installation is just as for any other source based |
|
|
|
install, as noted in the file *build.adoc* . |
|
|
|
install, as noted in the file *build.adoc*. |
|
|
|
|
|
|
|
=== Other Debian derivatives (including stock) |
|
|
|
|
|
|
|
==== Buster (10) with python2 |
|
|
|
|
|
|
|
These Buster instructions seem to also work for Devuan and Maemo Leste. |
|
|
|
|
|
|
|
Multiple versions of gpsd can not co-exist on the same system. You need |
|
|
|
to ensure gpsd from a package is not on the system: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt purge gpsd |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Then update your system, and install the packages required by gpsd: |
|
|
|
|
|
|
|
=== Other Debian derivatives (including stock) === |
|
|
|
==== Buster (10) with python2 ==== |
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt-get update |
|
|
|
# apt-get dist-upgrade |
|
|
|
@ -308,7 +361,7 @@ X11 server installed, but it still pulls in a lot of packages. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt-get install python-gi-dev python-cairo-dev |
|
|
|
# apt-get install python-gobject-dev libgtk-3-dev |
|
|
|
# apt-get install python-gobject-2-dev libgtk-3-dev |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Ubxtool and zerk may optionally use the pyserial module for |
|
|
|
@ -330,15 +383,18 @@ Some very old Garmin USB devices need libusb: |
|
|
|
# apt-get install libusb-1.0-0-dev |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
If you wish to build the documentation, be warned it pull in a |
|
|
|
lot of packages. To build the doc install: |
|
|
|
If you wish to build the documentation, be warned it pulls in a |
|
|
|
lot of packages. Build the documentation is a prerequisite to |
|
|
|
building the HTML files for the website (www/), and also to make |
|
|
|
a source tarball (scons dist). To install the tools to build the |
|
|
|
documentation: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
apt-get install xsltproc docbook-xsl xmlto asciidoc |
|
|
|
apt-get install xsltproc docbook-xsl xmlto asciidoctor |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
The rest of the installation is just as for any other source based |
|
|
|
install, as noted in the file *build.adoc* . |
|
|
|
install, as noted in the file *build.adoc*. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# git clone https://gitlab.com/gpsd/gpsd.git |
|
|
|
@ -346,7 +402,17 @@ install, as noted in the file *build.adoc* . |
|
|
|
# scons --config=force && scons install |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
==== Jessie (8) ==== |
|
|
|
==== Jessie (8) |
|
|
|
|
|
|
|
Multiple versions of gpsd can not co-exist on the same system. You need |
|
|
|
to ensure gpsd from a package is not on the system: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt purge gpsd |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Then install the required packages: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt-get install scons libncurses5-dev python-dev pps-tools |
|
|
|
# apt-get install git-core |
|
|
|
@ -356,10 +422,18 @@ Git-core is required to build from a git repository. pps-tools is for |
|
|
|
PPS timing. |
|
|
|
|
|
|
|
The rest of the installation is just as for any other source based |
|
|
|
install, as noted in the file *build.adoc* . |
|
|
|
install, as noted in the file *build.adoc*. |
|
|
|
|
|
|
|
|
|
|
|
==== Wheezy |
|
|
|
|
|
|
|
Multiple versions of gpsd can not co-exist on the same system. You need |
|
|
|
to ensure gpsd from a package is not on the system: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt purge gpsd |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
==== Wheezy ==== |
|
|
|
Wheezy, being older, requires updating the tools for compiling |
|
|
|
and testing gpsd: |
|
|
|
|
|
|
|
@ -421,29 +495,78 @@ Git-core is required to build from a git repository. pps-tools is for |
|
|
|
PPS timing. |
|
|
|
|
|
|
|
The rest of the installation is just as for any other source based |
|
|
|
install, as noted in the file *build.adoc* . |
|
|
|
install, as noted in the file *build.adoc*. |
|
|
|
|
|
|
|
==== Ubuntu Buster 20 |
|
|
|
|
|
|
|
==== Ubuntu 18.04 LTS ==== |
|
|
|
If you have Raspbian Buster, that is not this. |
|
|
|
|
|
|
|
Preliminary install notes. |
|
|
|
|
|
|
|
Multiple versions of gpsd can not co-exist on the same system. You need |
|
|
|
to ensure gpsd from a package is not on the system: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt purge gpsd |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Then install the required packages: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
apt install gcc scons python-gi python-gi-cairo g++ |
|
|
|
apt install libncurses5-dev pps-tools |
|
|
|
apt install python-gobject libgtk-3-dev |
|
|
|
apt install libncurses5-dev libtinfo-dev pps-tools |
|
|
|
apt install gir1.2-gtk-3.0 |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
If you wish to build the documentation, be warned it pull in a |
|
|
|
lot of packages. To build the doc install: |
|
|
|
If you wish to build the documentation, be warned it pulls in a |
|
|
|
lot of packages. Build the documentation is a prerequisite to |
|
|
|
building the HTML files for the website (www/), and also to make |
|
|
|
a source tarball (scons dist). To install the tools to build the |
|
|
|
documentation: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
apt install xsltproc docbook-xsl xmlto asciidoc |
|
|
|
apt install xsltproc docbook-xsl xmlto asciidoctor |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
The rest of the installation is just as for any other source based |
|
|
|
install, as noted in the file *build.adoc* . |
|
|
|
|
|
|
|
=== Other Raspberry Pi tips === |
|
|
|
==== Ubuntu 18.04 LTS |
|
|
|
|
|
|
|
Preliminary install notes. |
|
|
|
|
|
|
|
If you have Raspbian Buster, that is not this. |
|
|
|
|
|
|
|
Multiple versions of gpsd can not co-exist on the same system. You need |
|
|
|
to ensure gpsd from a package is not on the system: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# apt purge gpsd |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
Then install the required packages: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
apt install gcc scons python-gi python-gi-cairo g++ |
|
|
|
apt install libncurses5-dev libtinfo-dev pps-tools |
|
|
|
apt install gir1.2-gtk-3.0 |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
If you wish to build the documentation, be warned it pulls in a |
|
|
|
lot of packages. Build the documentation is a prerequisite to |
|
|
|
building the HTML files for the website (www/), and also to make |
|
|
|
a source tarball (scons dist). To install the tools to build the |
|
|
|
documentation: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
apt install xsltproc docbook-xsl xmlto asciidoctor |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
The rest of the installation is just as for any other source based |
|
|
|
install, as noted in the file *build.adoc*. |
|
|
|
|
|
|
|
=== Other Raspberry Pi tips |
|
|
|
|
|
|
|
Any USB connected GPS that is known to work with gpsd will work fine on |
|
|
|
the RasPi. No special instructions apply. |
|
|
|
@ -455,7 +578,7 @@ serial console: /dev/ttyAMA0. The PPS signal will be on GPIO Pin #4. |
|
|
|
|
|
|
|
Only three specific changes need to be made to make the HAT work. First |
|
|
|
in the file /boot/cmdline.txt, remove this part "console=ttyAMA0,115200 |
|
|
|
kgdboc=ttyAMA0,115200)". That frees the serial port from console use so |
|
|
|
kgdboc=ttyAMA0,115200". That frees the serial port from console use so |
|
|
|
the GPS can use it. |
|
|
|
|
|
|
|
Second you need to tell the boot process to load the pps_gpio module |
|
|
|
@ -471,7 +594,7 @@ Run gpsd like this: |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
If you are on the RasPi with gpsd version 3.17, or above, /dev/pps0 can |
|
|
|
be autodetected. and used for PPS if available. |
|
|
|
be autodetected, and used for PPS if available. |
|
|
|
|
|
|
|
gpsd 3.17 and up only: |
|
|
|
|
|
|
|
@ -515,18 +638,18 @@ Now proceed as for any other operating system to use gpsd. |
|
|
|
Be sure to validate that your PPS signal is not offset by the pulse |
|
|
|
width. That would mean gpsd is using the wrong edge. |
|
|
|
|
|
|
|
Detailed instructions are available from their web site: |
|
|
|
Detailed instructions are available from their website: |
|
|
|
https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/ |
|
|
|
|
|
|
|
You will need to dig deeper to make the PPS work, here is a good reference: |
|
|
|
http://www.satsignal.eu/ntp/Raspberry-Pi-NTP.html |
|
|
|
|
|
|
|
== BSD derivatives == |
|
|
|
=== Special Notes for FreeBSD Installation ==+ |
|
|
|
=== Special Notes for FreeBSD Installation === |
|
|
|
|
|
|
|
gpsd will build, install and run on FreeBSD. |
|
|
|
Due to the missing CAN bus support (linux/can.h), NMEA2000/CAN |
|
|
|
is not supporten on FreeBSD. |
|
|
|
is not supported on FreeBSD. |
|
|
|
|
|
|
|
Use their pkg command to install scons, and optionally git if you |
|
|
|
want to access the development source. |
|
|
|
@ -548,11 +671,11 @@ qt5-network and pkgconf packages. |
|
|
|
FreeBSD fails to create the python links as required by PEP394. |
|
|
|
So you need to add them yourself, as above. |
|
|
|
|
|
|
|
=== Special Notes for NetBSD 8.1 Installation === |
|
|
|
=== Special Notes for NetBSD 8.1 Installation |
|
|
|
|
|
|
|
gpsd will build, install and run on NetBSD. |
|
|
|
|
|
|
|
Use their pkg_add command to install pkgin. Then use pkgin to |
|
|
|
Use their 'pkg_add' command to install pkgin. Then use pkgin to |
|
|
|
install the required tools. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
@ -575,7 +698,7 @@ install the required tools. |
|
|
|
# scons --config=force && scons install |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
=== Special Notes for OpenBSD 6.6 Installation === |
|
|
|
=== Special Notes for OpenBSD 6.6 Installation |
|
|
|
|
|
|
|
gpsd will build, install and run on NetBSD. |
|
|
|
|
|
|
|
@ -596,8 +719,36 @@ Then install the normal way. |
|
|
|
# scons --config=force && scons install |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
== Special Notes for Fedora derivatives == |
|
|
|
=== Special Notes for CentOS 7 Installation === |
|
|
|
== Special Notes for Fedora derivatives |
|
|
|
=== Special Notes for Fedora 32, 33 Installation |
|
|
|
|
|
|
|
gpsd currently will build, install and run on Fedora 32, 33. |
|
|
|
|
|
|
|
Install the gcc compiler and tools. Clone the gpsd source, and then |
|
|
|
build it. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# dnf install -y gcc-c++ python3-devel scons xmlto asciidoctor bzip2 |
|
|
|
# dnf install -y xz git dnf-plugins-core |
|
|
|
# git clone https://gitlab.com/gpsd/gpsd.git |
|
|
|
# cd gpsd |
|
|
|
# scons |
|
|
|
# dnf builddep -y gpsd-*/packaging/rpm/gpsd.spec |
|
|
|
# scons |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
If you wish to make an rpm of your build: |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# scons dist |
|
|
|
# dnf install -y chrpath fedora-packager rpmdevtools |
|
|
|
# rpmdev-setuptree |
|
|
|
# cp gpsd-3*.tar.* ~/rpmbuild/SOURCES/ |
|
|
|
# rpmbuild -ba gpsd-3*/packaging/rpm/gpsd.spec |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
|
|
|
|
=== Special Notes for CentOS 7 Installation |
|
|
|
|
|
|
|
gpsd currently will build, install and run on CentOS 7. |
|
|
|
|
|
|
|
@ -609,7 +760,7 @@ Use the yum command to install git if you |
|
|
|
want to access the development source. |
|
|
|
|
|
|
|
-------------------------------------------------------------- |
|
|
|
# yum group install "Development Tools" |
|
|
|
# yum group install "Development Tools" |
|
|
|
# yum install git |
|
|
|
# yum install \ |
|
|
|
https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm |
|
|
|
@ -622,4 +773,61 @@ want to access the development source. |
|
|
|
# scons |
|
|
|
-------------------------------------------------------------- |
|
|
|
|
|
|
|
== Special Notes for Windows |
|
|
|
|
|
|
|
Only Windows Subsystem for Linux 1 provides a reasonable means |
|
|
|
of running gpsd at this time. WSL2 lacks a GUI, USB and serial |
|
|
|
support making it unsuitable at this time. |
|
|
|
|
|
|
|
=== About WSL 1 |
|
|
|
|
|
|
|
WSL 1 is a component of Microsoft |
|
|
|
Windows that implements an alternate kernel. Linux |
|
|
|
distributions, notably Alpine, Debian, Kali, OpenSUSE, and |
|
|
|
Ubuntu may run on top of it. |
|
|
|
|
|
|
|
There are some issues known which affect gpsd. |
|
|
|
|
|
|
|
* /dev/ttyS* nodes have a 1 indexed number, like in MS Windows. |
|
|
|
* Windows 10 may attempt to use your GPS itself. |
|
|
|
* Older pl2303 (knockoff) serial chipsets are no longer supported \ |
|
|
|
in Windows 10 |
|
|
|
|
|
|
|
=== Installing a Linux distribution on WSL 1 or WSL 2 |
|
|
|
|
|
|
|
1. Install a Linux distribution by clicking on the `Microsoft Store` \ |
|
|
|
Icon in the taskbar. |
|
|
|
2. Click on the search icon (it is a magnifying glass). |
|
|
|
3. Type in 'Linux' or the name of a supported distribution. (see list) |
|
|
|
4. Click on the icon of your chosen Linux Distribution |
|
|
|
5. Click 'Get' then click 'Install' and busy-wait. |
|
|
|
6. Click on the start menu and scroll to your Linux distribution and \ |
|
|
|
click it. |
|
|
|
7. Follow the distribution-specific on-screen instructions to finish \ |
|
|
|
installing your Linux distribution. |
|
|
|
|
|
|
|
=== Recommended packages |
|
|
|
|
|
|
|
Due to current WSL limitations, it is recommended at this time that you |
|
|
|
only install the equivalent of the following packages on your distribution. |
|
|
|
|
|
|
|
---- |
|
|
|
Python |
|
|
|
SCons (preferably 3.0+) |
|
|
|
ncurses-dev (to build/run cgps and gpsmon) |
|
|
|
asciidoctor (to build the documentation) |
|
|
|
xmlto (to build the man pages) |
|
|
|
---- |
|
|
|
|
|
|
|
Optionally, the following packages might also be installed |
|
|
|
---- |
|
|
|
pyserial (for direct control of UBlox GPS and GREIS devices) |
|
|
|
gnuplot (to generate graphs of gpsprof data) |
|
|
|
libusb-dev (to possibly use crusty old Garmin GPS receivers) |
|
|
|
git (if building from the development sources) |
|
|
|
---- |
|
|
|
|
|
|
|
=== Building on WSL 1 or WSL 2 |
|
|
|
|
|
|
|
1. Get the list of packages from the appropriate section above. |
|
|
|
2. Follow instructions in the distro-specific section above. |
|
|
|
|
Bernd Zeimetz
3 years ago