polaris/README.md

polaris

Path Reporting for Borrowed Goods

Installation

Necessary Software

• Golang
• Arduino IDE and ESP plugin

Necessary Hardware

• Computer (I used a Raspberry Pi Zero 2 W)
• ESP8266
• uBlox 6m GPS module
• External Power Supply

Setup

Serverside

Compile the recipient Golang program on the computer with

go build gps.go

Nodeside

Open the sketch and user the Arduino IDE to upload to the ESP module Connect the GPS module; pinout is given in Arduino sketch, must check against pinout image

Running

Serverside

Run the recipient with

./gps &

When the path is received, it will be stored in a file named with the received date. It can be viewed with

cat YYYYMMDD.path

Nodeside

Compile and download the sketch to the ESP

Usage

Connect the ESP and GPS to the external battery. Once the GPS warms up, it will get a location reading every 2 seconds. Power does not need to be continuously supplied, as the location is written to the EEPROM. To get the location data, reset/power cycle ESP.

TODO

• A whole lot

• Golang write to file

• Golang plotting

• ESP connectivity

• ESP write to EEPROM