X-Git-Url: https://zdv2.bktei.com/gitweb/EVA-2020-02.git/blobdiff_plain/7b09912bb5daa1e56c8c9cd98ff5fea4435d95eb..ce11ca44bdfe0cf1476ffbbd37d5b1509ca4660e:/doc/location/README.org diff --git a/doc/location/README.org b/doc/location/README.org index b87dcd5..4bbecfd 100644 --- 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-07T23:08Z~ +was updated by Steven Baltakatei Sandoval on ~2020-10-08T18:14Z~ ** Narrative Ninfacyzga-01 records (logs) its position in time and space using a @@ -100,10 +100,41 @@ possible. **** Software Setup ***** Install Executables -See [[file:../setup/README.org][Main Setup]] procedures. +Follow the [[file:../setup/README.org][Main Setup]] procedures to obtain required files from this +repository. + +Install ~gpsd~, ~gpsd-clients~, and ~gpsbabel~. + +: $ sudo apt install gpsd gpsd-clients gpsbabel + +***** 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 -Install ~gpsd~, ~gpspipe~, ~git~, and this repository for location -logging capability. +: DEVICES="/dev/serial0" ***** Automatic Start Configuration It is recommended to create a daily ~cron~ job that executes a bash