longfi-arduino/Heltec-WiFi-LoRa-32-V2/longfi-us915

Heltec WiFi LoRa 32 V2

This example demonstrates sending a simple data packet using a Heltec Wifi LoRa 32 V2 development board. Please follow every instruction step below from top to bottom.

Quickstart Guide Heltec LoRa 32 V2 Product Page
Heltec LoRa 32 V2 Docs

Installing the Heltec ESP32 Library

From the Arduino IDE, open the Library Manager (Sketch->Include Library->Manage Libraries). In the search box, type Heltec ESP32 and look for Heltec ESP32 Dev-Boards. Select the latest version and install.

Install Heltec ESP32 LoRaWAN Library

Download this find into the directory below and unzip.

linux: /home/{user}/Arduino/libraries 
windows: Documents\Arduino\libraries
mac os: Documents/Arduino/libraries

Install Serial Driver

Find Directions here.

Install Arduino-ESP32 Board Support

Find Directions here

Select Board

Arduino IDE:

1. Select Tools -> Board: -> WiFi LoRa 32(V2)

Select Region

Arduino IDE:

1. Select Tools -> LoRaWAN Region: -> REGION_US915

Obtain Heltec License Key

Upload GetChipID example

Arduino IDE:

1. Select File -> Examples -> ESP32 -> ChipID -> GetChipID
2. Select Tools -> Port: "COM# or ttyACM#"
3. Select Sketch -> Upload
4. Wait for Done uploading message
5. Select Tools -> Serial Monitor Serial Monitor Window
6. Select 115200 baud from bottom right dropdown.
7. You should see something that looks like this every second ESP32 Chip ID = ############
8. Save this Chip ID

Obtain License Key with Chip ID

1.Go to resource.heltec.cn/search 2. Enter ChipID 3. Save license field, will look like 0x########,0x#########,0x########,0x########

Required Change to Default DataRate

The Helium network does not fully support ADR (Adapative Data Rate), read more here. In this example sketch, ADR is turned off, therefore you must manually set the desired data rate for your payload size manually. This library uses a default data rate that is not supported by the Helium Network so you must change it to one in the following range DR_0 - DR_4. To do this change the default data rate on line 20 in the file found below for your operating system.

Change line 20 to:

#define LORAWAN_DEFAULT_DATARATE                    DR_0

In File:

linux: /home/{user}/Arduino/libraries/ESP32_LoRaWAN-master/src/ESP32_LoRaWAN.cpp 
windows: Documents\Arduino\libraries\ESP32_LoRaWAN-master\src\ESP32_LoRaWAN.cpp
mac os: Documents/Arduino/libraries/ESP32_LoRaWAN-master/src/ESP32_LoRaWAN.cpp

Upload longfi-us915 example

Arduino IDE:

1. Select File -> Open -> longfi-arduino/Heltec-WiFi-LoRa-32-V2/longfi-us915.ino
2. Enter License Key at line 32

uint32_t  license[4] = {`0x########,0x#########,0x########,0x########};

3. Enter DevEUI(msb), AppEUI(msb), and AppKey(msb) from Helium Console, at lines 34,35,36.

uint8_t DevEui[] = { FILL_ME_IN };
uint8_t AppEui[] = { FILL_ME_IN };
uint8_t AppKey[] = { FILL_ME_IN };

4. Select Sketch -> Upload.
5. Wait for Done uploading message
6. Select Tools -> Serial Monitor Serial Monitor Window
7. Select 115200 baud from bottom right dropdown.
8. Wait for device to successfully join, may take 1-3 min, and show several failures. Do not be alarmed by the failures, it is expected.