Conecta tu Heltec ESP32 WiFi Kit 32 V3 al WiFi paso a paso
Una de las grandes ventajas de la Heltec ESP32 WiFi Kit 32 V3 es que incorpora conectividad WiFi y Bluetooth, lo que la convierte en una placa ideal para desarrollar proyectos de Internet de las Cosas (IoT).
En este tutorial aprenderemos a realizar la primera conexión a una red WiFi, mostrando el resultado tanto en el monitor serie como en la pantalla OLED integrada.
Este será el punto de partida para los próximos proyectos, en los que enviaremos datos a ThingSpeak, construiremos servidores web y conectaremos distintos sensores.
Antes de empezar
Una recomendación basada en mi propia experiencia.
Durante los primeros intentos utilicé código generado por Inteligencia Artificial. Aunque parecía correcto, aparecieron problemas con librerías, objetos duplicados y diferencias entre versiones de la placa.
La solución fue muy sencilla:
Primero comprobar que funcionan los ejemplos oficiales del fabricante y, una vez verificados, utilizar la Inteligencia Artificial para adaptarlos y ampliarlos.
Este método evita muchos dolores de cabeza y nos garantiza que el hardware está correctamente configurado antes de empezar a programar nuestros propios proyectos.
Material necesario
- Heltec ESP32 WiFi Kit 32 V3
- Cable USB-C
- Arduino IDE
- Librerías oficiales de Heltec instaladas
- Una red WiFi disponible
Configurar la red WiFi
Antes de compilar el programa debemos indicar el nombre de nuestra red y su contraseña.
Simplemente modificamos estas líneas:
const char* ssid = "NOMBRE_DE_TU_RED";
const char* password = "TU_CONTRASEÑA";
Código completo
#include "Arduino.h"
#include "WiFi.h"
#include <Wire.h>
#include "HT_SSD1306Wire.h"
//========================
// CONFIGURACIÓN WIFI
//========================
const char* ssid = "NOMBRE_DE_TU_RED";
const char* password = "TU_CONTRASEÑA";
//========================
// OLED
//========================
SSD1306Wire factory_display(
0x3c,
500000,
SDA_OLED,
SCL_OLED,
GEOMETRY_128_64,
RST_OLED
);
//========================
// Encender OLED
//========================
void VextON()
{
pinMode(Vext, OUTPUT);
digitalWrite(Vext, LOW);
}
//========================
// Conexión WiFi
//========================
void WIFISetUp()
{
WiFi.disconnect(true);
delay(100);
WiFi.mode(WIFI_STA);
WiFi.setAutoReconnect(true);
WiFi.begin(ssid, password);
factory_display.clear();
factory_display.drawString(0,0,"Conectando WiFi...");
factory_display.display();
Serial.println();
Serial.println("===========================");
Serial.println("HELTEC ESP32 WiFi Kit 32");
Serial.println("===========================");
Serial.print("Conectando a: ");
Serial.println(ssid);
while (WiFi.status() != WL_CONNECTED)
{
delay(500);
Serial.print(".");
}
Serial.println();
Serial.println("WiFi conectado");
Serial.println();
Serial.print("Direccion IP: ");
Serial.println(WiFi.localIP());
Serial.print("RSSI: ");
Serial.print(WiFi.RSSI());
Serial.println(" dBm");
factory_display.clear();
factory_display.drawString(0,0,"WiFi OK");
factory_display.drawString(
0,
15,
WiFi.localIP().toString()
);
factory_display.drawString(
0,
35,
"RSSI: " + String(WiFi.RSSI()) + " dBm"
);
factory_display.display();
}
void setup()
{
Serial.begin(115200);
VextON();
delay(100);
factory_display.init();
factory_display.clear();
factory_display.display();
WIFISetUp();
}
void loop()
{
}
Explicación del programa
1. Incluimos las librerías
#include "WiFi.h"
#include "HT_SSD1306Wire.h"
La primera permite utilizar la conectividad WiFi del ESP32.
La segunda controla la pantalla OLED integrada en la placa Heltec.
2. Configuramos nuestra red
const char* ssid = "NOMBRE_DE_TU_RED";
const char* password = "TU_CONTRASEÑA";
Aquí debemos introducir los datos de nuestra red inalámbrica.
⚠️ Nunca publiques tu contraseña en Internet ni la subas a GitHub.
3. Creamos el objeto de la pantalla
SSD1306Wire factory_display(...)
Este objeto será el encargado de escribir información en la pantalla OLED.
4. Encendemos la alimentación de la pantalla
VextON();
La pantalla OLED de esta placa permanece apagada hasta activar la salida Vext.
Es uno de los detalles más característicos de las placas Heltec.
5. Inicializamos la pantalla
factory_display.init();
Con esta instrucción la pantalla queda preparada para mostrar información.
6. Configuramos el WiFi
WiFi.mode(WIFI_STA);
Indicamos que la placa funcionará como cliente WiFi.
7. Conectamos a la red
WiFi.begin(ssid,password);
Comienza el proceso de conexión utilizando el nombre y la contraseña indicados.
Mientras esperamos la conexión, el programa escribe puntos en el monitor serie para indicar que sigue intentando conectarse.
8. Esperamos hasta conseguir conexión
while(WiFi.status()!=WL_CONNECTED)
El programa permanece dentro del bucle hasta que la conexión sea correcta.
9. Mostramos la dirección IP
WiFi.localIP()
Una vez conectado, el router asigna una dirección IP a nuestra placa.
Será imprescindible para muchos proyectos posteriores, como servidores web o conexiones remotas.
10. Medimos la intensidad de la señal
WiFi.RSSI()
RSSI (Received Signal Strength Indicator) indica la intensidad de la señal WiFi.
Valores orientativos:
| RSSI | Calidad |
|---|---|
| -30 dBm | Excelente |
| -50 dBm | Muy buena |
| -60 dBm | Buena |
| -70 dBm | Aceptable |
| -80 dBm | Débil |
| Menor de -90 dBm | Muy mala |
Resultado
En el monitor serie veremos algo parecido a:
===========================
HELTEC ESP32 WiFi Kit 32
===========================
Conectando a: MiCasa
......
WiFi conectado
Direccion IP: 192.168.1.35
RSSI: -48 dBm
Y en la pantalla OLED aparecerá:
WiFi OK
192.168.1.35
RSSI: -48 dBm
¿Qué hemos aprendido?
En este tutorial hemos conseguido:
- Configurar una conexión WiFi.
- Mostrar información en la pantalla OLED.
- Obtener la dirección IP.
- Medir la intensidad de la señal inalámbrica.
- Utilizar el monitor serie para depurar el programa.
Ya tenemos preparada la base para comenzar a desarrollar auténticos proyectos IoT.
Próximo tutorial
Ahora que la placa ya está conectada a Internet, el siguiente paso será enviar nuestro primer dato a la nube utilizando ThingSpeak.
Comenzaremos enviando un valor sencillo para comprobar toda la comunicación y, posteriormente, sustituiremos ese dato por la lectura de sensores reales como un LDR o un DHT22.
💡 Consejo final
En esta serie seguiremos una metodología muy práctica:
- Comprobar siempre los ejemplos oficiales del fabricante.
- Verificar que el hardware funciona correctamente.
- Utilizar la Inteligencia Artificial para comprender, modificar y ampliar esos ejemplos.
- Construir proyectos cada vez más complejos a partir de una base sólida.
Con este enfoque no solo aprenderás a programar la Heltec ESP32 WiFi Kit 32 V3, sino también a sacar el máximo partido a herramientas como ChatGPT o Claude sin depender completamente de ellas.
