• The Overview
• Installing
• Features
• Test information
• How to use this library
• Contact us

• This library is make LoRaWAN 1.0.2 protocol running with ESP32. Only support the ESP32 + LoRa series products made by HelTec Automation(TM), and a LoRa gateway is must needed.
• You may need change some definition in Commissioning.h ,LoRaMac-definitions.h, board.h...
• This library is transplanted form https://github.com/Lora-net/LoRaMac-node
• Use RTC and deep sleep mode supported, only few millisecond wake up in a cycle;
• Heltec LoRa Node Family.

To install this library:

• install it using the Arduino Library manager ("Sketch" -> "Include Library" -> "Manage Libraries..."), or
• download a zip file from GitHub using the "Download ZIP" button and install it using the IDE ("Sketch" -> "Include Library" -> "Add .ZIP Library..."
• clone this git repository into your sketchbook/libraries folder.

For more info, see https://www.arduino.cc/en/Guide/Libraries

The ESP32_LoRaWAN library provides a fairly complete LoRaWAN Class A and Class C implementation, supporting the EU-433, CN-470, EU-868 and US-915 bands. Only tested with Heltec hardware, so be careful when using any of the untested features.

The following functions included:

• LoRaWAN protocol V1.0.2 Class A and Class C;
• Use ESP32's internal RTC(15KHz);
• All ESP32 + LoRa boards made by Heltec Automation(TM) can use this library;
• Support deep sleep and stop mode;
• Receive and print downlink payload;
• Print and OLED show downlink data length and RSSI;
• An unique license relate to Chip ID is needed, you can check your license here: http://www.heltec.cn/search/

• Gateway: HT-M01 Mini LoRa Gateway + Raspberry Pi Zero W
• Node: WIFI LoRa 32 V2, Wireless Stick, Wireless Stick Lite
• LoRaServer: Aliyun ECS + Ubuntu 16.04 + loraserver.io
• Arudino 18.8

What certainly works:

• Sending packets uplink, taking into account duty cycling.
• Encryption and message integrity checking;
• Over-the-air activation (OTAA / joining);
• Deep sleep and wake up；
• Class A operation;
• Class C operation;
• ABP mode.

What has not been tested:

• Receiving downlink packets in the RX2 window.
• Class B operation.

The only different with a common Arduino library is need a unique license. It's relate to ESP32 Chip ID.

• Use this simple example to read your Chip ID: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/tree/master/esp32/libraries/ESP32/examples/ChipID/GetChipID

• http://www.heltec.cn/search/ Open this page and input your ChipID

Only the boards made after August 2018 can be checked from this page, if you have a former version, you can mail to support@heltec.cn and improve you already have a Heltec Automation made board.

• Website：https://heltec.org
• Document Page: https://docs.heltec.cn
• Forum: http://community.heltec.cn/
• Twitter: https://twitter.com/HeltecOrg
• Face Book: https://www.facebook.com/heltec.automation.5

Before reporting an issue, make sure you've searched for similar one that was already created. Also make sure to go through all the issues labelled as for reference.

Also you can talk in our forum: http://community.heltec.cn/