TTN Mapper T-beam

Energy efficient mapping software for ttnmapper using a T-beam.

Send your GPS-Location over TTS. The Location can be viewed on the advanced maps when the integration is activated.

Features

• deep sleep ESP32 to save energy
• geofence for location upload
• detect no movement
• sleep-mode while not in use

Usage

LED IO4(red):

• off: device in permanent sleep or off
• gliming: device is in deep sleep waiting for the next transmission time
• on: device is active either joining or has woken up to send the next message

LED CHG(blue):

• off: everything ok
• on: battery is charging

LED GPS(red,next to the GPS-Module):

• off: GPS off or no fix
• blinking: GPS has fix

Button Power(PWR):

• short press(1 sec) to turn the device on or if already powered wake up, send the current location and go back to sleep again
• long press(2 sec/wait until IO4 LED goes off) put the device into permanent sleep mode turning off the GPS and radio while preserving LoraWAN credentials
• very long press(10 sec) completely turn off the ESP loosing all credentials

Hardware

I'm using the TTGO-T-beam v1.1(with the axp power management chip onboard)

But the software can easily be modified to run on any ESP32-Board with a GPS and a LoRa module attached.

Compiling

Software

Clone this repository and open it with Visual Studio Code(vscode). This code editor automaticly downloads the extension platformio to compile and upload the program.

Modification

You have to copy config.hpp.example. Insert your own TTS-keys and use or disable the geofencing option

Upload

For uploading just hit the upload-button at the bottom of the vscode window