2019-06-12 19:18:37 +00:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
|
|
#include <SoftwareSerial.h>
|
|
|
|
|
|
|
|
|
|
#include <TinyGPS++.h>
|
|
|
|
|
|
|
|
|
|
#include "settings.h"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// The GPS message decoder
|
|
|
|
|
TinyGPSPlus gps;
|
|
|
|
|
// The serial connection to the GPS device
|
|
|
|
|
SoftwareSerial serial_gps(PIN_GPS_RX, PIN_GPS_TX);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Initialises the connection to the GPS device.
|
|
|
|
|
*/
|
|
|
|
|
void gps_begin();
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Fetches the current location from the GPS device.
|
|
|
|
|
* May take a moment, as the GPS device needs time to acquire a satellite fix.
|
|
|
|
|
* @return TinyGPSLocation The current location.
|
|
|
|
|
*/
|
2019-06-13 13:13:03 +00:00
|
|
|
TinyGPSLocation gps_location();
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Ends the connection to the GPS device and puts it to sleep in order to save
|
|
|
|
|
* power.
|
|
|
|
|
* Note that the GPS device is connected directly to the power management
|
|
|
|
|
* system and so doesn't get turned off after each measurement, as it takes
|
|
|
|
|
* ~30s to reacquire a lock when it first starts up - hence why we put it to
|
|
|
|
|
* sleep instead.
|
|
|
|
|
*/
|
|
|
|
|
void gps_end();
|
