Guía de desarrollo HELTEC WiFi LoRa 32 V4: Configuración completa, Arduino, PlatformIO y Meshtastic

Ventaja clave: El soporte USB-OTG nativo de la V4 elimina la necesidad de un puente USB a UART separado (CP2102), reduciendo el consumo de energía y simplificando el proceso del bootloader. La placa puede entrar en modo de programación automáticamente o mediante los botones PRG/RST.

 

Diagrama completo de pines mostrando los 40 pines, conectores de antena y ubicaciones de interfaces

URLs adicionales para el Administrador de Placas: https://resource.heltec.cn/download/package_heltec_esp32_index.json

Placa: "HELTEC ESP32 Series Dev Boards" → "WiFi LoRa 32(V3)" Puerto: Selecciona tu puerto COM (Windows) o /dev/ttyACM* (Linux/Mac) USB CDC al iniciar: "Habilitado" (para salida serial) Modo de carga: "USB-OTG-CDC (TinyUSB)"

Importante: Selecciona "WiFi LoRa 32(V3)" en el menú de placas para las placas V4. La V4 es compatible en pines y usa la misma definición de placa. El framework detectará y configurará automáticamente el hardware V4.

  

[env:heltec_wifi_lora_32_V3] platform = espressif32 board = heltec_wifi_lora_32_V3 framework = arduino ; Opciones de compilación board_build.mcu = esp32s3 board_build.f_cpu = 240000000L ; Opciones de carga upload_protocol = esptool upload_speed = 921600 ; Opciones de monitor monitor_speed = 115200 monitor_filters = esp32_exception_decoder ; Dependencias de librerías lib_deps = heltecautomation/Heltec ESP32 Dev-Boards@^1.1.2 olikraus/U8g2@^2.35.8 sandeepmistry/LoRa@^0.8.0 ; Flags de compilación para V4 build_flags = -D ARDUINO_USB_CDC_ON_BOOT=1 -D CONFIG_USB_OTG_SUPPORTED=1

project/ ├── include/ # Archivos de encabezado ├── lib/ # Librerías personalizadas ├── src/ │ └── main.cpp # Aplicación principal ├── test/ # Pruebas unitarias ├── platformio.ini # Configuración del proyecto └── README.md

Ventajas de PlatformIO: Resolución automática de dependencias de librerías, depuración integrada con sondas JTAG, framework de pruebas unitarias e integración fluida de CI/CD para despliegues en producción.

   

#include "Arduino.h" #include "U8x8lib.h" #include "Wire.h" // Pines de pantalla OLED para WiFi LoRa 32 V4 #define OLED_SDA 17 #define OLED_SCL 18 #define OLED_RST 21 // Inicializar pantalla OLED (SSD1306 128x64) U8X8_SSD1306_128X64_NONAME_SW_I2C u8x8(OLED_SCL, OLED_SDA, OLED_RST); void setup() { // Inicializar serial para depuración Serial.begin(115200); delay(1000); Serial.println("HELTEC WiFi LoRa 32 V4 Iniciando..."); // Inicializar pantalla OLED u8x8.begin(); u8x8.setPowerSave(0); u8x8.setFlipMode(1); // Girar pantalla 180 grados // Limpiar pantalla y establecer fuente u8x8.clearDisplay(); u8x8.setFont(u8x8_font_chroma48medium8_r); // Mostrar mensaje de bienvenida u8x8.setCursor(0, 0); u8x8.print("HELTEC V4"); u8x8.setCursor(0, 2); u8x8.print("WiFi LoRa 32"); u8x8.setCursor(0, 4); u8x8.print("ESP32-S3 + SX1262"); u8x8.setCursor(0, 6); u8x8.print("¡Listo!"); Serial.println("¡Configuración completa!"); } void loop() { // Parpadear el LED RGB integrado (GPIO38) static uint8_t color = 0; // Ciclo simple de colores switch(color) { case 0: neopixelWrite(38, 255, 0, 0); break; // Rojo case 1: neopixelWrite(38, 0, 255, 0); break; // Verde case 2: neopixelWrite(38, 0, 0, 255); break; // Azul } color = (color + 1) % 3; delay(1000); }

Auto-Carga: El V4 soporta entrada automática al bootloader. Si la carga falla, ingresa manualmente al bootloader: Mantén presionado el botón PRG, presiona RST una vez, suelta PRG, luego intenta cargar de nuevo.

  

#include "LoRa.h" #include "U8x8lib.h" // Definiciones de pines para HELTEC V4 #define LORA_NSS 8 #define LORA_RESET 12 #define LORA_DIO1 14 #define LORA_BUSY 13 #define LORA_SCK 9 #define LORA_MISO 11 #define LORA_MOSI 10 // Configuración OLED U8X8_SSD1306_128X64_NONAME_SW_I2C u8x8(18, 17, 21); int counter = 0; void setup() { Serial.begin(115200); while (!Serial); // Inicializar OLED u8x8.begin(); u8x8.setFlipMode(1); u8x8.setFont(u8x8_font_chroma48medium8_r); u8x8.clearDisplay(); u8x8.setCursor(0, 0); u8x8.print("LoRa TX"); // Inicializar LoRa LoRa.setPins(LORA_NSS, LORA_RESET, LORA_DIO1); // Frecuencia: 868E6 para UE, 915E6 para EE.UU., 433E6 para Asia if (!LoRa.begin(868E6)) { Serial.println("¡Error al iniciar LoRa!"); u8x8.setCursor(0, 2); u8x8.print("¡Error de inicio!"); while (1); } // Configurar parámetros de LoRa LoRa.setTxPower(20); // Potencia TX: 2-20 dBm LoRa.setSpreadingFactor(7); // SF: 6-12 LoRa.setSignalBandwidth(125E3); // BW: 125kHz LoRa.setCodingRate4(5); // CR: 4/5 Serial.println("LoRa TX listo"); u8x8.setCursor(0, 2); u8x8.print("Listo 868MHz"); } void loop() { Serial.print("Enviando paquete: "); Serial.println(counter); // Actualizar pantalla u8x8.setCursor(0, 4); u8x8.print("Paquete: "); u8x8.print(counter); u8x8.print(" "); // Enviar paquete LoRa.beginPacket(); LoRa.print("Hola #"); LoRa.print(counter); LoRa.print(" desde V4!"); LoRa.endPacket(); // Retroalimentación visual neopixelWrite(38, 0, 255, 0); // Destello verde delay(100); neopixelWrite(38, 0, 0, 0); // Apagado counter++; delay(5000); // Enviar cada 5 segundos }

#include "LoRa.h" #include "U8x8lib.h" // Definiciones de pines (igual que el transmisor) #define LORA_NSS 8 #define LORA_RESET 12 #define LORA_DIO1 14 #define LORA_BUSY 13 U8X8_SSD1306_128X64_NONAME_SW_I2C u8x8(18, 17, 21); void setup() { Serial.begin(115200); while (!Serial); // Inicializar OLED u8x8.begin(); u8x8.setFlipMode(1); u8x8.setFont(u8x8_font_chroma48medium8_r); u8x8.clearDisplay(); u8x8.setCursor(0, 0); u8x8.print("LoRa RX"); // Inicializar LoRa LoRa.setPins(LORA_NSS, LORA_RESET, LORA_DIO1); if (!LoRa.begin(868E6)) { Serial.println("¡Error al iniciar LoRa!"); u8x8.setCursor(0, 2); u8x8.print("¡Error de inicio!"); while (1); } // Ajustar configuración del transmisor LoRa.setSpreadingFactor(7); LoRa.setSignalBandwidth(125E3); LoRa.setCodingRate4(5); Serial.println("LoRa RX listo"); u8x8.setCursor(0, 2); u8x8.print("Escuchando..."); } void loop() { // Comprobar paquete int packetSize = LoRa.parsePacket(); if (packetSize) { // Paquete recibido Serial.print("Paquete recibido: '"); String message = ""; while (LoRa.available()) { message += (char)LoRa.read(); } Serial.print(message); Serial.print("' con RSSI "); Serial.println(LoRa.packetRssi()); // Actualizar pantalla u8x8.clearLine(4); u8x8.clearLine(5); u8x8.setCursor(0, 4); // Truncar mensaje si es muy largo if (message.length() > 16) { message = message.substring(0, 16); } u8x8.print(message); u8x8.setCursor(0, 6); u8x8.print("RSSI: "); u8x8.print(LoRa.packetRssi()); u8x8.print(" dBm"); // Retroalimentación visual neopixelWrite(38, 0, 0, 255); // Destello azul delay(200); neopixelWrite(38, 0, 0, 0); } }

#include "LoRa.h" #include "driver/rtc_io.h" #define LORA_NSS 8 #define LORA_RESET 12 #define LORA_DIO1 14 RTC_DATA_ATTR int bootCount = 0; void setup() { Serial.begin(115200); bootCount++; Serial.println("Número de arranque: " + String(bootCount)); // Inicializar LoRa LoRa.setPins(LORA_NSS, LORA_RESET, LORA_DIO1); if (!LoRa.begin(868E6)) { Serial.println("¡Error al iniciar LoRa!"); esp_deep_sleep_start(); } // Enviar datos del sensor LoRa.beginPacket(); LoRa.print("Arranque:"); LoRa.print(bootCount); LoRa.print(",VBAT:"); LoRa.print(analogReadMilliVolts(1) * 2 / 1000.0); // Voltaje de batería LoRa.endPacket(); Serial.println("Paquete enviado, entrando en reposo..."); // Configurar temporizador de activación (60 segundos) esp_sleep_enable_timer_wakeup(60 * 1000000ULL); // Entrar en modo de bajo consumo esp_deep_sleep_start(); } void loop() { // Nunca se alcanza debido al modo de bajo consumo }

Optimización del alcance: Para máximo alcance, use SF12, ancho de banda de 125kHz y potencia TX de 20dBm. Para máxima tasa de datos, use SF7 y ancho de banda de 250kHz. Siempre respete las regulaciones locales sobre ciclos de trabajo y potencia máxima.

  

#include "loramac.h" #include "LoRaWan.h" // Credenciales del dispositivo - reemplaza con tus valores const char *deviceEui = "XXXXXXXXXXXXXXXX"; // 16 caracteres hex const char *appEui = "XXXXXXXXXXXXXXXX"; // 16 caracteres hex const char *appKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 32 caracteres hex // Configuración LoRaWAN #define LORA_BAND EU868 // EU868, US915, AU915, AS923 #define LORA_CLASS CLASS_A // A, B, o C void setup() { Serial.begin(115200); delay(2000); Serial.println("HELTEC V4 LoRaWAN OTAA"); // Inicializar LoRaWAN LoRaWan.init(LORA_BAND, LORA_CLASS, JOIN_OTAA); // Establecer credenciales del dispositivo LoRaWan.setDeviceEui(deviceEui); LoRaWan.setAppEui(appEui); LoRaWan.setAppKey(appKey); // Unirse a la red Serial.println("Uniéndose a la red..."); if (LoRaWan.join()) { Serial.println("¡Red unida!"); // Configurar tasa de datos (0-5 para EU868) LoRaWan.setDataRate(3); // DR3: SF9, 125kHz } else { Serial.println("¡Fallo al unirse!"); } } void loop() { if (LoRaWan.isJoined()) { // Preparar carga útil uint8_t payload[4]; // Ejemplo: Enviar temperatura y batería int16_t temperature = 250; // 25.0°C (x10 para precisión) uint16_t battery = analogReadMilliVolts(1); payload[0] = temperature >> 8; payload[1] = temperature & 0xFF; payload[2] = battery >> 8; payload[3] = battery & 0xFF; // Enviar uplink (puerto 1, no confirmado) Serial.println("Enviando uplink..."); if (LoRaWan.send(payload, sizeof(payload), 1, false)) { Serial.println("¡Uplink enviado!"); } else { Serial.println("¡Fallo en uplink!"); } // Verificar downlink uint8_t downlink[64]; int downlinkLen = LoRaWan.receive(downlink, sizeof(downlink)); if (downlinkLen > 0) { Serial.print("Downlink recibido: "); for (int i = 0; i < downlinkLen; i++) { Serial.printf("%02X ", downlink[i]); } Serial.println(); } } else { Serial.println("No unido, reintentando..."); LoRaWan.join(); } // Esperar próxima transmisión (respetar ciclo de trabajo) delay(30000); // 30 segundos }

Licencia requerida: La biblioteca LoRaWAN de Heltec requiere una licencia gratuita vinculada al ID de chip de tu ESP32. Consulta tu licencia en resource.heltec.cn y añádela a tu código antes de llamar a LoRaWan.init().

// Reemplaza con tus credenciales ABP const char *devAddr = "XXXXXXXX"; // 8 caracteres hex const char *nwkSKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 32 caracteres hex const char *appSKey = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"; // 32 caracteres hex void setup() { LoRaWan.init(LORA_BAND, LORA_CLASS, JOIN_ABP); LoRaWan.setDevAddr(devAddr); LoRaWan.setNwkSKey(nwkSKey); LoRaWan.setAppSKey(appSKey); // ABP no requiere unión - listo inmediatamente Serial.println("Modo ABP - listo para enviar"); }

# Instala Meshtastic CLI pip install meshtastic # Conecta y configura meshtastic --info # Muestra info del nodo meshtastic --set owner "MyNode" # Establece nombre del nodo meshtastic --set region EU_868 # Establece región meshtastic --set is_router true # Activa modo router # Ver mensajes meshtastic --listen

Ventajas de V4 para Meshtastic: La potencia TX de 28dBm ofrece un alcance excepcional comparado con dispositivos estándar de 20-22dBm. La entrada solar y la gestión de batería lo hacen ideal para instalaciones permanentes de routers al aire libre.

  

No hay salida serial en el monitor

La transmisión LoRa no funciona

La pantalla OLED está en blanco

Alto consumo de energía en modo de suspensión

¿Cuál es el alcance máximo del HELTEC WiFi LoRa 32 V4?

¿Puedo usar código V3 en la placa V4?

¿Qué capacidad de batería necesito?

¿Es el V4 compatible con Meshtastic?

¿Necesito licencia para usar LoRaWAN?

¿Qué módulos GPS funcionan con el V4?

¿Cómo actualizo el firmware?

¿Puedo quitar la pantalla OLED?