Heltec ESP32+LoRa Series Quick Start

简体中文

Before all operation, please confirm whether the USB driver, Git and Arduino IDE has been installed correctly. If not, please refer to this two articles establish serial connection and Install Git and Arduino IDE.

There are two methods to install the development framework, choose one of they:

Via Arduino Board Manager
Via Git

Via Arduino Board Manager

Step1. Download Arduino-ESP32 Support

Open Arduino IDE, and click File->Peferences.

../_images/0120.png

../_images/0215.png

Input the last ESP32 package URL: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/releases/download/0.0.5/package_heltec_esp32_index.json

../_images/0311.png

Click Tools --> Board --> Boards Manager..., search Heltec ESP32 in the new pop-up dialog, then click install

../_images/046.png

../_images/053.png

The source code of Heltec ESP series (ESP32 & ESP8266) framework available here: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series

Step2. Download the Heltec ESP32 Library

Open Arduino IDE, then Select Sketch->Include Library->Manage Libraries... Search Heltec ESP32 and install it.

../_images/063.png

../_images/073.png

The source code of Heltec ESP32 library available here: https://github.com/HelTecAutomation/Heltec_ESP32

Via Git

For Windows: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/blob/master/InstallGuide/windows.md
For MacOS: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/blob/master/InstallGuide/mac.md
For Linux
- Debian/Ubuntu: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/blob/master/InstallGuide/debian_ubuntu.md
- Fedora: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/blob/master/InstallGuide/fedora.md
- OpenSUSE: https://github.com/Heltec-Aaron-Lee/WiFi_Kit_series/blob/master/InstallGuide/opensuse.md

Example

This section for verifying whether you can program with Arduino or not. Now, The USB cable connects to Heltec ESP32 board, then select your serial port which is connected to Heltec ESP32 board.

Select a demo example, compile and upload.

Execute an example

Correctly select a board and relevant options in the Tools menu:

../_images/083.png

Then select an example likes XXXXXX_FactoryTest.ino

../_images/092.png

Compile & Upload

../_images/102.png

New a Heltec ESP32 program

Open Arduino IDE, create a new .ino file, then copy the below code.

#include <heltec.h>

// the setup routine runs once when starts up
void setup(){

  // Initialize the Heltec ESP32 object
  Heltec.begin(true /*DisplayEnable Enable*/, true /*LoRa Disable*/, true /*Serial Enable*/, true /*PABOOST Enable*/, 470E6 /**/);
}

// the loop routine runs over and over again forever
void loop() {

}

compile it and upload, the screen (if this board has a screen) will show and Arduino’s serial monitor will print something, it means Heltec ESP32 board is running successfully!