27/6/2019 User Manual - Heltec Automation(TM) product documents
Language
Heltec ESP32 Based Dev-baords
Develop Environment
We suggest you confirm whether the USB driver , Git and Arduino IDE
has installed first. If not, please view this two articles establish serial connection
and Install Git and Arduino IDE.
CONTENT
1. Setting Environment
Step1. Download Heltec Arduino-ESP32 Support
Step2. Download the Heltec ESP32 Library
2. Example
1. Setting Environment
(Only two steps to complete setting)
Step1. Download Arduino-ESP32 Support
Open Arduino IDE, and click File -> Peferences -> Settings
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 1/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
Input last esp32 board manager URL
Now the last board manager URL:
https://docs.heltec.cn/download/package_heltec_esp32_index.json
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 2/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
Click Tools -> Board: -> Boards Manager... , search Heltec ESP32 in the new pop-
up dialog, then click install
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 3/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
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
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 4/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
The source code of Heltec ESP32 library available here:
https://github.com/HelTecAutomation/Heltec_ESP32
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
1. Execute a example likes FactoryTest.ino
Correct select the board you had connected to computer and the specified serial port: e.g.
WiFi Kit 32, WiFi LoRa 32, COM3(my PC is COM3 )
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 5/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
Then select an example likes XXXXXX_FactoryTest.ino
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 6/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 7/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
Upload it
2. New a Heltec ESP32 program
Open Arduino IDE, then new a .ino file, then copy the below code.
arduino
#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 /
}
// the loop routine runs over and over again forever
void loop() {
compile it and upload, the on board screen (if have) will show and Arduino’s serial monitor
will print something, it means Heltec ESP32 board is running successfully!
Enjoy!
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 8/9
27/6/2019 User Manual - Heltec Automation(TM) product documents
https://docs.heltec.cn/#/en/user_manual/how_to_install_esp32_Arduino?id=_1-execute-a-example-likes-factorytestino 9/9
