Heltec LoRa32 V4

Contents

Heltec LoRa32 V4 Development Board User Manual

Model: LoRa32 V4

1. Introduction and Overview

The Heltec WiFi LoRa 32 V4 is an advanced development board designed for Internet of Things (IoT) applications, offering robust wireless communication capabilities. This version is a comprehensive upgrade from its predecessors, incorporating an ESP32-S3R2 microcontroller, an SX1262 LoRa chip, Wi-Fi, Bluetooth Low Energy (BLE), and a 0.96-inch OLED display. It features enhanced transmit power, optimized power management, and improved expandability, making it suitable for a wide range of projects including smart cities, agricultural monitoring, smart homes, industrial control, security systems, and wireless meter reading.

The board is designed to provide developers with a more efficient and flexible development experience for creating mesh network solutions.

2. What's in the Box

The Heltec LoRa32 V4 package typically includes the following components:

  • Heltec WiFi LoRa 32 V4 Development Board
  • Lithium Battery (3000mAh, 3.7V)
  • 3D Printed Shell (Black and Green parts)
  • LoRa Antenna
  • Pin Headers
  • Screws for assembly
  • Small Screwdriver
  • Connection Wires
Heltec LoRa32 V4 components including board, battery, shell, antenna, and tools.
Figure 2.1: Contents of the Heltec LoRa32 V4 package.

3. Setup and Assembly

Follow these steps to assemble your Heltec LoRa32 V4 development board with its protective shell and connect the necessary components:

  1. Connect the Antenna: Carefully connect the LoRa antenna cable to the IPEX connector on the development board.
  2. Connect the Battery: Plug the lithium battery connector into the designated battery port (SH1.25*2 Pin) on the board.
  3. Insert Board into Shell: Place the development board into the bottom part of the 3D printed shell, ensuring it sits securely.
  4. Secure the Board: Use the provided screws and screwdriver to fasten the development board to the shell.
  5. Position the Battery: Place the lithium battery into the top part of the 3D printed shell.
  6. Close the Shell: Carefully align and close the two halves of the shell around the board and battery.
  7. Attach External Antenna: Screw the external LoRa antenna onto the connector protruding from the assembled shell.
  8. Finalize Assembly: Use the remaining screws to secure the two shell halves together.
Video 3.1: Step-by-step assembly guide for the Heltec LoRa32 V4 development board and shell.

3.1. Connecting to Meshtastic App

The Heltec LoRa32 V4 is compatible with the Meshtastic application for mesh networking. To connect and configure your device:

  1. Choose a Device: Select your Heltec LoRa32 V4 from the available device options within the Meshtastic app.
  2. Flash and Configure: Flash your device with the latest version of Meshtastic firmware and configure it according to your needs. You can find the flasher tool at https://flasher.meshtastic.org/.
  3. Connect and Communicate: Connect your device via any of the Meshtastic clients to start sending and receiving messages over the mesh network.
Meshtastic app interface showing device selection, flashing, and connection steps.
Figure 3.1: Meshtastic app workflow for device connection and configuration.

4. Operating Instructions

The Heltec LoRa32 V4 is designed for various IoT applications. Once assembled and programmed, its operation will depend on the specific firmware loaded. Common applications include:

  • Smart Agriculture: Monitoring environmental conditions, controlling irrigation systems.
  • Remote Meter Reading: Collecting data from utility meters wirelessly.
  • Wireless Alarm Systems: Detecting intrusions or environmental hazards.
  • Environmental Sensors: Deploying sensors for air quality, temperature, humidity, etc.
Examples of application scenarios for the Heltec LoRa32 V4, including smart agriculture, remote meter reading, wireless alarms, and environmental sensors.
Figure 4.1: Diverse application scenarios for the LoRa32 V4.

4.1. Buttons and Indicators

The board features several buttons and LEDs for interaction and status indication:

  • PRG Button: Program button, often used for entering BootLoader mode.
  • RST Button: Reset button, used to restart the device.
  • Button USER: A user-programmable button.
  • White LED: General purpose LED, often programmable.
  • Orange LED: Charging indicator LED.
Detailed diagram of the Heltec LoRa32 V4 board components, including buttons, LEDs, and connectors.
Figure 4.2: Component layout of the Heltec LoRa32 V4 board.

5. Features

  • Based on ESP32-S3R2 & SX-1262, supports Wi-Fi b/g/n, BLE, and LoRa communication.
  • Equipped with 2MB PSRAM and 16MB external Flash, enhancing suitability for UI and complex system designs.
  • High-power version with LoRa transmission power increased to 28 ±1dBm.
  • Maintains form factor and pin compatibility with WiFi LoRa 32 V3 for easy migration.
  • Features a PC casing that protects the screen and integrates an FPC 2.4G antenna.
  • Includes an SH1.25-2P solar panel interface for solar power integration.
  • Optimized lithium battery management for efficient power usage.
  • Added SH1.25-8Pin GNSS interface for GPS capabilities.
  • USB Type-C interface with integrated voltage regulation, ESD protection, short-circuit protection, and RF isolation design.
  • Achieves low power consumption, less than 20μA in deep sleep mode.

6. Specifications

ParameterDescription
MCUESP32-S3R2 (Xtensa® 32-bit LX7 dual-core processor)
LoRa ChipSX1262
FrequencyHigh-power version: 863-928MHz
Low-power version: 433, 470-510, 863-928MHz
Max. TX PowerHigh-power version: 28 ±1 dBm
Low-power version: 21 ±1 dBm
Max. Receiving Sensitivity-137dBm@SF12 BW=125KHz
Wi-Fi802.11 b/g/n, up to 150Mbps
BluetoothBluetooth (LE), Bluetooth 5, Bluetooth Mesh
Hardware Resources7*ADC1 + 2*ADC2; 7*Touch; 3*UART; 2*I2C; 2*SPI; etc.
Memory384KB ROM; 512KB SRAM; 16KB RTC SRAM; 2MB PSRAM; 16MB Flash
InterfaceType-C USB; SH1.25*2 Pin lithium battery interface; SH1.25*8 Pin GNSS interface; LoRa ANT (IPEX1.0); 2.4G ANT (IPEX1.0)
Applicable Battery3.3-4.4V lithium battery
Operating Temperature-20 ~ 70 ℃
Dimensions51.7 * 25.4 * 10.7mm

7. User Tips

  • Battery Connector: The battery socket type is SH1.25 x 2. Ensure you use compatible batteries and connectors.
  • V3 and V4 Compatibility: While V3 and V4 boards are largely compatible in terms of pin layout and OLED, the increased transmit power in V4 may require adjustments to transmit power settings in existing code.
  • 2.4GHz Antenna Configuration: The default 2.4G FPC antenna is integrated into the plastic screen bracket. If you intend to use an external IPEX-connected 2.4G antenna, you must modify the board by removing the inductor marked '①' and adding a 0-ohm resistor (or other conductive material) at position '②' to connect to the IPEX interface. Refer to the troubleshooting section for a diagram.

8. Troubleshooting

8.1. Failed to Upload Code

If you encounter issues uploading code to your Heltec LoRa32 V4 board, try the following steps:

  1. Check USB Cable: Try using a different USB cable. A faulty or charge-only cable can prevent data transfer.
  2. Enter BootLoader Mode: The board needs to be in BootLoader mode for code upload. There are two methods to achieve this:
    • Hold down the PRG button, then connect the USB-C cable. Release the PRG button after connecting.
    • Connect the USB-C cable, then hold down the PRG button. While holding PRG, press the RST button once, then release the PRG button.
Diagram showing the locations of inductor (1) and connection point (2) for 2.4GHz antenna modification.
Figure 8.1: 2.4GHz Antenna Modification Diagram for external IPEX antenna.

9. Pin Layout

Understanding the pin layout is crucial for connecting peripherals and custom circuits. The Heltec LoRa32 V4 provides extensive hardware expansion interfaces.

Detailed pin layout diagram for the Heltec LoRa32 V4, showing physical pins, GND, GPIO, ADC/DAC, I2C, SPI, and other connections.
Figure 9.1: Comprehensive Pin Layout of the Wi-Fi LoRa 32 V4.
Diagram illustrating extensive hardware expansion interfaces including GNSS and solar panel connections.
Figure 9.2: Hardware Expansion Interfaces.

10. Resources and Documentation

For more detailed information, libraries, and schematic diagrams, please refer to the official Heltec resources. You can access these by scanning the QR codes provided in the product documentation or visiting the Heltec website.

  • User Manual
  • Heltec ESP (ESP32 & ESPs 266) framework
  • Heltec library
  • Schematic diagram
  • Downloadable resources
QR codes for various Heltec resources including user manual, ESP framework, library, schematic, and other downloadable resources.
Figure 10.1: QR Codes for Heltec Documentation and Resources.

11. Warranty and Support

For warranty information, technical support, or further inquiries, please contact the manufacturer or your point of purchase. Ensure you retain your proof of purchase for any warranty claims.


Documents and downloads

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.