doc(location/README):Note how to enable serial port for gpsd

[EVA-2020-02.git] / doc / location / README.org

diff --git a/doc/location/README.org b/doc/location/README.org
index 06860d2bd9bfd1e68f71b82798c7d67c321b63b0..a5fff7ac6bfebbed22a6606a1935783fc8e40fbd 100644 (file)
--- a/doc/location/README.org
+++ b/doc/location/README.org
@@ -5,7 +5,7 @@
 ** About
 This document was created by Steven Baltakatei Sandoval on
 ~2020-06-29T12:14Z~ under a [[https://creativecommons.org/licenses/by-sa/4.0/][Creative Commons BY-SA 4.0 license]]. It
-was updated by Steven Baltakatei Sandoval on ~2020-10-08T00:18Z~
+was updated by Steven Baltakatei Sandoval on ~2020-10-08T18:03Z~
 
 ** Narrative
 Ninfacyzga-01 records (logs) its position in time and space using a
@@ -107,6 +107,35 @@ Install ~gpsd~, ~gpsd-clients~.
 
 : $ sudo apt install gpsd gpsd-clients
 
+***** Setup Serial for BerryGPS
+The Ozzmaker BerryGPS-IMU unit requires that the serial console be
+disabled and the serial port enabled. (see [[https://ozzmaker.com/berrygps-setup-guide-raspberry-pi/][ref]]).
+
+: $ sudo raspi-config
+
+Navigate to ~5 Interfacing Options~, then ~P6 Serial~.
+
+When prompted "Would you like a login shell to be accessible over
+serial?", answer ~No~.
+
+When prompted "Would you like the serial port hardware to be
+enabled?", answer ~Yes~.
+
+***** Configure ~gpsd~
+~gpsd~ needs to know which serial port to look at for NMEA location
+data generated by the GPS unit. This can be done by modifying the
+~gpsd~ configuration file at ~/etc/default/gpsd~.
+
+: sudo nano /etc/default/gpsd
+
+Change
+
+: DEVICES=""
+
+to
+
+: DEVICES="/dev/serial0"
+
 ***** Automatic Start Configuration
 It is recommended to create a daily ~cron~ job that executes a bash
 script that starts ~bklog~ jobs to record location along with other