LOST

LOST is a lightweight GPS logging and mapping tool built for ESP32 devices. It combines real-time OpenStreetMap rendering with GPS tracking and SD card logging in a compact, touch-friendly interface.

The project showcases:

• Tile-based OSM map rendering using LovyanGFX, OpenStreetMap and PNGdec
• GPS tracking via TinyGPS++
• Status bar with local time, GPS fix info
• Progressive confirmation buttons using LovyanGFX

Currently only tested on a M5stack Core2 with a M5Stack GNNS module.

Installing this app

This is a PlatformIO project, you will need VSCode with the PlatformIO plugin installed.

Set your network details

Before flashing the following source should be adjusted to your needs and saved as src/secrets.h.

#ifndef SECRETS_H
#define SECRETS_H

#include "NetworkDetails.h"

double homeLongitude = 0.0;
double homeLatitude = 0.0;

// Central European Time - see https://remotemonitoringsystems.ca/time-zone-abbreviations.php
constexpr char *TIME_ZONE = "CET-1CEST,M3.5.0/2,M10.5.0/3";

// Change `nl` to your country iso code for better latency
constexpr char *NTP_POOL = "nl.pool.ntp.org";

constexpr NetworkDetails net1("wifi network1", "wifi network 1 password");
constexpr NetworkDetails net2("wifi network2", "wifi network 2 password");

// All networks defined above must be added here
constexpr NetworkDetails knownNetworks[] = {net1, net2};

#endif

Libraries used

This project depends on LovyanGFX, OpenStreetMap, TinyGPSPlus and PNGdec to get the work done.

License differences between this library and the map data

This library has a MIT license

The LOST project -this project- is licensed under the MIT license.

The downloaded tile data has a Open Data Commons Open Database License (ODbL)

OpenStreetMap® is open data, licensed under the Open Data Commons Open Database License (ODbL) by the OpenStreetMap Foundation (OSMF).

Use of any OSMF provided service is governed by the OSMF Terms of Use.

This project is not endorsed by or affiliated with the OpenStreetMap Foundation.

Usage and screenshots

Selecting a predefined network

Touch the network you want to use.

• The selection menu will only be shown when more than 1 known network is found

Start logging with the left button

A indicator and the current filename will be shown while logging.

• Stop logging with the right button

Set a home location with middle button

• Sets a new home location until reboot. Use secrets.h to set a default home location.