ESP32 LoRa APRS Modem

amateur-radio aprs aprs-rx aprs-tracker aprsdroid aprsis codec2 esp32 esp32-ardunio esp32-library ham-radio iot kiss lora lora-gateway lora-server lorawan tnc tracker uhf

Go to file

sh123 f48def5cab Add missing files		2024-11-03 18:53:17 +02:00
extras	Add missing files	2024-11-03 18:53:17 +02:00
include	Fix issue with RadioLib API changes	2023-12-01 16:37:01 +02:00
src	Fix issue with RadioLib API changes	2023-12-01 16:37:01 +02:00
.gitignore	Updated schematics project	2024-10-30 14:32:46 +02:00
LICENSE	Create LICENSE	2020-06-24 15:14:52 +03:00
README.md	Update README.md	2023-11-16 17:17:21 +02:00
platformio.ini	Updated Espressif and libraries to latest version	2023-11-12 16:14:46 +02:00

README.md

ESP32 LoRa APRS Modem

This project is amateur radio ESP32 based LoRa/FSK KISS Bluetooth/BLE/USB/TCPIP modem + LoRa APRS-IS RX/TX iGate server over WiFI + LoRa/FSK APRS digipeater + Codec2 DV modem (with Codec2 Talkie Android application).

⚠ To configure sketch modify default parameters in config.h file.

For project description, detailed setup and more information, please, visit our Wiki at https://github.com/sh123/esp32_loraprs/wiki
For discussions, visit https://github.com/sh123/esp32_loraprs/discussions

⚠ Project also supports APRSDroid TNC2 text APRS packet mode (configurable), which makes it interoperable with other LoRa APRS trackers without AX25 support.

Supported module types: SX126X, SX127X and other modules supported by RadioLib.

Modules, which are used by users and known to work

SX126X (suggested, 1W modules will provide decent coverage for APRS, stable frequency suitable for < 125 kHz BW at 433 MHz, 5V from USB power bank is enough to power it, has additional LNA)
- 👍 E22-400M30S (SX1268)
- E220-400M30S (LLCC68) BW125 SF from 7 to 9 (chip limitations)
- These modules are 30dbm modules, but maximum power should be set to no more than 20-22dbm, see https://github.com/jgromes/RadioLib/wiki/High-power-Radio-Modules-Guide
SX127X (low power, 50-100mW, temperature frequency drift, problematic for narrow band)
- RA-01 (SX1278)
- RA-02 (SX1276)
- TTGO T-Beam (SX1276)

Building

Update include/config.h with your radio settings
- If you are using lora-aprs iGate (non AX.25) then set CFG_TEXT_PACKETS and CFG_TEXT_PACKETS_3 config parameters to true and use APRSDroid TNC2 connection protocol
To build for client/tracker mode use pio run -e esp32dev
To build for iGate mode use pio run -e esp32dev_igate

Development board

Development board schematics, case and antenna models are available under extras/cad and extras/schematics.

Supported ESP32 boards are with 36 and 38 pinouts (configured with solder pads).

⚠ There are ESP32 boards with different socket widths: 22mm and 25mm, board files for 25mm have _wide suffix in file names.