Repository files navigation

The Things Network device library for ESP-IDF (ESP32) supporting devices with Semtech SX127x chips

This ESP32 component provides LoRaWAN communication withThe Things Network. It supports:

• OTAA (over-the-air activation)
• uplink and downlink messages
• saving the EUIs and key in non-volatile memory
• deep sleep and power off without the need for rejoining
• AT commands for provisioning EUIs and key(so the same code can be flashed to several devices)
• support for regions Europe, North and South America, Australia, Korea, Asia and India
• C and C++ API

The library is based on the LMIC library from IBM (specifically the well-maintained version by MCCI– see theirGitHub repository) and provides a high-level API specifically targeted at The Things Network.

• Support for deep sleep and power off (seeDeep Sleep and Power Off)
• Verified compatibility with ESP-IDF v4.3 and 5.0
• Upgraded underlying library mcci-catena/arduino-lmic to v4.2.0-1
• C API
• Support for sub-bands
• Dropped support forMakefile builds

Follow the detailedGet Started Guide in the Wiki.

All boards with Semtech SX127x chips, RFM9x and compatibles are supported. It includes boards from ttgo, Heltec and HopeRF. For several of them, thePin Configuration is described in detail.

SeeAPI Documentation for both the C ad C++ API

More information can be found on theWiki pages.