README 1.6 KB

1234567891011121314151617181920212223242526272829303132333435
  1. gpsd is a service daemon that monitors one or more GPSes attached to
  2. a host computer through serial or USB ports, making all data on the
  3. location, course, and velocity available to be queried on TCP port
  4. 2947 of the host computer. With gpsd, multiple GPS client applications
  5. (such as navigational and wardriving software) can share access to GPSes
  6. without contention or loss of data. Applications that presently use
  7. gpsd include Viking, foxtrotgps and Kismet.
  8. See README.build for some build options that might be useful.
  9. To enable automatic startup of gpsd at boot time, or when a GPS device
  10. is connected via USB, you need to do the following four steps:
  11. 1. Copy the file /lib/udev/rules.d/97-gpsd.rules to /etc/udev/rules.d/
  12. 2. Edit the file /etc/udev/rules.d/97-gpsd.rules and uncomment the line
  13. (or lines) beginning '#ATTRS' that corresponds to your GPS hardware.
  14. To avoid confusion with other USB serial devices that you might have,
  15. do not uncomment lines that do not correspond to your GPS hardware.
  16. But if you do not know which line to uncomment, and you do not have any
  17. other serial devices, you can uncomment them all :-)
  18. 3. Make the file /etc/rc.d/rc.gpsd executable.
  19. chmod +x /etc/rc.d/rc.gpsd
  20. 4. Add the following lines to /etc/rc.d/rc.local
  21. if [ -x /etc/rc.d/rc.gpsd ]; then
  22. /etc/rc.d/rc.gpsd start
  23. fi
  24. Configuration options may be set in the file /etc/rc.d/rc.gpsd.conf.
  25. The defaults will usually be adequate. However, if your GPS is on a
  26. real (non-USB) serial port -- for example, /dev/ttyS0 -- you should add
  27. /dev/ttyS0 to GPS_DEVICES in /etc/rc.d/rc.gpsd.conf.