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

⚠️ Modify the config file with your own data!

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