summaryrefslogtreecommitdiff
path: root/system/gpsd/README
diff options
context:
space:
mode:
Diffstat (limited to 'system/gpsd/README')
-rw-r--r--system/gpsd/README35
1 files changed, 29 insertions, 6 deletions
diff --git a/system/gpsd/README b/system/gpsd/README
index 5a1d1b8508..a111f54615 100644
--- a/system/gpsd/README
+++ b/system/gpsd/README
@@ -1,8 +1,31 @@
-gpsd is a service daemon that monitors one or more GPSes attached to a
-host computer through serial or USB ports, making all data on the location,
-course, and velocity available to be queried on TCP port 2947 of the host
-computer. With gpsd, multiple GPS client applications (such as navigational
-and wardriving software) can share access to GPSes without contention or
-loss of data. Applications that presently use gpsd include Viking and Kismet.
+gpsd is a service daemon that monitors one or more GPSes attached to
+a host computer through serial or USB ports, making all data on the
+location, course, and velocity available to be queried on TCP port
+2947 of the host computer. With gpsd, multiple GPS client applications
+(such as navigational and wardriving software) can share access to GPSes
+without contention or loss of data. Applications that presently use
+gpsd include Viking and Kismet.
See README.build for some additional build options that might be useful.
+
+To enable automatic startup of gpsd at boot time, or when a GPS device is
+connected via USB, you need to do the following three steps:
+
+1. Edit the file /lib/udev/rules.d/97-gpsd.rules and uncomment the line
+(or lines) beginning '#ATTRS' that corresponds to your GPS hardware and
+save it in /etc/udev/rules.d/. To avoid confusion with other USB serial
+devices that you might have, do not uncomment lines that do not
+correspond to your GPS hardware.
+
+2. Make the file /etc/rc.d/rc.gpsd executable.
+ chmod +x /etc/rc.d/rc.gpsd
+
+3. Add the following lines to /etc/rc.d/rc.local
+ if [ -x /etc/rc.d/rc.gpsd ]; then
+ /etc/rc.d/rc.gpsd start
+ fi
+
+Configuration options may be set in the file /etc/rc.d/rc.gpsd.conf. The
+defaults will usually be adequate. However, if your GPS is on a real (non-USB)
+serial port -- for example, /dev/ttyS0 -- you should add /dev/ttyS0 to
+GPS_DEVICES in /etc/rc.d/rc.gpsd.conf.