chore(lib):Flip pimoroni enviro display vertically

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

diff --git a/doc/location/README.org b/doc/location/README.org
index a5fff7ac6bfebbed22a6606a1935783fc8e40fbd..d45fdae7d9182d0daa482720bb5d9f1f676f6923 100644 (file)
--- a/doc/location/README.org
+++ b/doc/location/README.org
@@ -4,8 +4,8 @@
 #+EMAIL: baltakatei@gmail.com
 ** About
 This document was created by Steven Baltakatei Sandoval on
 #+EMAIL: baltakatei@gmail.com
 ** 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-08T18:03Z~
+~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-18T00:13Z~

 
 ** Narrative
 Ninfacyzga-01 records (logs) its position in time and space using a
 
 ** Narrative
 Ninfacyzga-01 records (logs) its position in time and space using a


@@ -27,12 +27,9 @@ file may be compressed by ~gzip~ and encrypted by ~age~. It is an
 executable file contained within this repository at ~exec/bklog~. It
 should be copied to ~$HOME/.local/bin~.
 
 executable file contained within this repository at ~exec/bklog~. It
 should be copied to ~$HOME/.local/bin~.
 

-~bkgpslog~ : A legacy bash script similar to ~bklog~ but narrower in
-scope in that it only records output from ~gpspipe~.
-
-~gpsd~ : A background daemon app capable of interfacing with the
-Ozzmaker BerryGPS-IMU's GPS submodule. Installed and initialized by
-~apt~.
+[[https://tracker.debian.org/pkg/gpsd][~gpsd~]] : A background daemon app capable of interfacing with the
+[[https://ozzmaker.com/berrygps-berrygps-imu-quick-start-guide/][Ozzmaker BerryGPS-IMU]]'s GPS submodule. Installed and initialized by
+~apt~. Should be installed along with the ~gpsd-clients~ package.

 
 ~gpspipe~ : A command line app that polls ~gpsd~ and produces a stream
 stdout consisting of GPS data lines in NMEA format. Installed via
 
 ~gpspipe~ : A command line app that polls ~gpsd~ and produces a stream
 stdout consisting of GPS data lines in NMEA format. Installed via


@@ -103,9 +100,9 @@ possible.
 Follow the [[file:../setup/README.org][Main Setup]] procedures to obtain required files from this
 repository.
 
 Follow the [[file:../setup/README.org][Main Setup]] procedures to obtain required files from this
 repository.
 

-Install ~gpsd~, ~gpsd-clients~.
+Install ~gpsd~, ~gpsd-clients~, and ~gpsbabel~.

 
 

-: $ sudo apt install gpsd gpsd-clients
+: $ sudo apt install gpsd gpsd-clients gpsbabel

 
 ***** Setup Serial for BerryGPS
 The Ozzmaker BerryGPS-IMU unit requires that the serial console be
 
 ***** Setup Serial for BerryGPS
 The Ozzmaker BerryGPS-IMU unit requires that the serial console be


@@ -121,20 +118,40 @@ serial?", answer ~No~.
 When prompted "Would you like the serial port hardware to be
 enabled?", answer ~Yes~.
 
 When prompted "Would you like the serial port hardware to be
 enabled?", answer ~Yes~.
 

-***** Configure ~gpsd~
+***** Setup ~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
 
 ~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
+Make sure the following lines are present:
+
+#+BEGIN_EXAMPLE
+START_DAEMON="true"
+USBAUTO="false"
+DEVICES="/dev/ttyAMA0"
+GPSD_OPTIONS="-n"
+#+END_EXAMPLE
+
+NOTE: The ~DEVICES=~ line must be adjusted if the the ~ninfacyzga~
+device is configured to also track time. (See [[file:../time/README.org::*Setup%20~gpsd~][ref]]).
+
+NOTE: The ~-n~ option causes ~gpsd~ to begin polling GPS devices
+without waiting for a client to connect. This is important if ~gpsd~
+provides data to other applications (ex: ~gpspipe~, ~chrony~).
+
+Enable ~gpsd~ to run automatically via:
+
+: $ sudo systemctl enable gpsd
+
+Restart ~gpsd~ via:

 
 

-: DEVICES=""
+: $ sudo systemctl restart gpsd

 
 

-to
+Run ~gpsmon~ to verify that location data is being recorded.

 
 

-: DEVICES="/dev/serial0"
+: $ gpsmon

 
 ***** Automatic Start Configuration
 It is recommended to create a daily ~cron~ job that executes a bash
 
 ***** Automatic Start Configuration
 It is recommended to create a daily ~cron~ job that executes a bash