This is an automated email from the ASF dual-hosted git repository. acassis pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit cb4b64b6e806e296a995ce81cc015cf4acb9a16a Author: Alan Carvalho de Assis <[email protected]> AuthorDate: Sun Dec 21 10:23:01 2025 -0300 Doc/xtensa/esp32: Add documentation to Heltec WiFi LoRa32 This commit adds documentation to Heltec WiFi LoRa32 Signed-off-by: Alan C. Assis <[email protected]> --- .../esp32/boards/heltec_wifi_lora32/index.rst | 89 +++++++++++++++++++++ .../heltec_wifi_lora32/wifi-lora-32-v2-pinout.png | Bin 0 -> 244267 bytes .../boards/heltec_wifi_lora32/wifi-lora-32-v2.png | Bin 0 -> 326064 bytes 3 files changed, 89 insertions(+) diff --git a/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/index.rst b/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/index.rst new file mode 100644 index 00000000000..73a95319ca7 --- /dev/null +++ b/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/index.rst @@ -0,0 +1,89 @@ +====================== +Heltec WiFi LoRa 32 V2 +====================== + +.. tags:: chip:esp32, chip:esp32wrover32 + +The Heltec WiFi LoRa32 is a development board based on an ESP32 microcontroller. It is designed for LoRa application. + +.. list-table:: + :align: center + + * - .. figure:: wifi-lora-32-v2.png + :align: center + + Heltec WiFi LoRa32 V2 + +Features +======== + + - ESP32 (240MHz Tensilica LX6 dual-core+1 ULP, 600 DMIPS) + - LoRa Node Chip SX1276/SX1278 + - OLED Display + - Battery Charger 3.7V lithium (SH1.25 x 2 socket) + - LoRa ANT(IPEX1.0) + +Pinout +====== + +Most of I/O pins are broken out to the header pins as displayed here: + +.. list-table:: + :align: center + + * - .. figure:: wifi-lora-32-v2-pinout.png + :align: center + + Heltec WiFi LoRa32 V2 Pinout + +Schematic +========= + +https://resource.heltec.cn/download/WiFi_LoRa_32/V2/WiFi_LoRa_32_V2(433%2C470-510).PDF + +Serial Console +============== + +UART0 is, by default, the serial console. It connects to the on-board +CP2102 converter. + +Buttons and LEDs +================ + +Board Buttons +------------- + +There are two buttons labeled BOOT and RST. The RST button is not available +to software. It pulls the chip enable line that doubles as a reset line. + +The BOOT button is connected to IO0. On reset it is used as a strapping +pin to determine whether the chip boots normally or into the serial +bootloader. After reset, however, the BOOT button can be used for software +input. + +Board LEDs +---------- + +There is one LED available connected to IO25. + +Configurations and Flashing +=========================== + +All of the configurations presented below can be tested by running the following commands:: + + $ ./tools/configure.sh heltec_wifi_lora32:<config_name> + +Where <config_name> is the name of board configuration you want to use, i.e.: nsh, buttons, wifi... + +Flashing is done in the default way for ESP32 boards using:: + + $ make flash ESPTOOL_PORT=/dev/ttyUSB0 -j + +Then use a serial console terminal like ``minicom`` or `picocom`` configured to 115200 8N1. + +nsh +--- + +Basic NuttShell configuration (console enabled in UART0, exposed via +USB connection by means of CH340 converter, at 115200 bps). + diff --git a/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/wifi-lora-32-v2-pinout.png b/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/wifi-lora-32-v2-pinout.png new file mode 100644 index 00000000000..2c704c38a2d Binary files /dev/null and b/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/wifi-lora-32-v2-pinout.png differ diff --git a/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/wifi-lora-32-v2.png b/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/wifi-lora-32-v2.png new file mode 100644 index 00000000000..347d031538b Binary files /dev/null and b/Documentation/platforms/xtensa/esp32/boards/heltec_wifi_lora32/wifi-lora-32-v2.png differ
