Heltec_ESP32 Library

English | 简体中文

This library must work with Heltec ESP32 develop framework! A detail document about how to install Heltec ESP32 development framework and this library available here:

https://heltec-automation-docs.readthedocs.io/en/latest/esp32/quick_start.html

CONTENT

How to install this library
- Use Arduino Library Manager
- Use Git
How to use this library
API Reference
Relevant Resources

How to install this library

We recommend using the Arduino library manager, it's the simplest way

Use Arduino Library Manager

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

Use Git

Firstly, make sure git and the Arduino IDE have been installed first. If not, please refer How to install Git and Arduino. When Arduino is installed correctly, you will find a folder in "Username/Documents/Arduino/Library". this library must in this path!

Open "Git bash" in path Username/Documents/Arduino/Library, and input:

git clone https://github.com/HelTecAutomation/Heltec_ESP32.git

You will see such a new folder in your library path, install done.

How to use this library

This library requires the Heltec ESP32 develop framework!

A detailed step by step instructions to execute some examples available here:

https://heltec-automation-docs.readthedocs.io/en/latest/esp32/quick_start.html#example

API Reference

OLED API

LoRa API

Relevant Resources

If there is a "Limited" folder in the resources page, it means the product have limited resources that not public by default, refer to this document to download: Get Limited Technical Resources.

Note:

Please make sure use a high-quality Micro USB cable, it will reduce many problems.

Summary of common problems

简体中文

这个Arduino库必须配合Heltec ESP32编译环境一起使用！完整的“编译环境 + 库”的的教程可以参考这里：

https://heltec-automation-docs.readthedocs.io/en/latest/esp32/quick_start.html

安装方法

强烈推荐使用Arduino自带的“库管理器”进行安装!

通过Arduino库管理器安装

打开Arduino IDE, 选择项目->加载库->管理库...，打开“库管理器” 搜索Heltec ESP32并安装.

通过Git进行安装

*首先,请确保Git和Arduino IDE都已经正确安装。如果没有，请参考这里的安装方法怎样安装Git和Arduino IDE。 *

强调一下：这个库的路径必须位于操作系统的“文档/Arduino/libraries”文件夹内！！！文档文件夹是操作系统自带的，必须！必须！必须！

在“文档/Arduino/libraries”路径下打开"Git bash"，输入:

git clone https://github.com/HelTecAutomation/Heltec_ESP32.git

如果一切正常，应该是这样的

怎样使用这个库

如何运行一个例程？详细的使用指南：:

https://heltec-automation.readthedocs.io/zh_CN/latest/esp32/quick_start.html#id1

API参考