Cómo conectar tu ESP32 a una red WiFi: ejemplo básico

Comprobar la conexión local sin publicar contraseñas ni depender de un servicio externo.

Plataforma del ejemplo: ESP32 clásico con WiFi 2.4 GHz. Identifica la versión de tu unidad antes de cargar el sketch o conectar periféricos.

Lo que conviene revisar antes de empezar

Conectarse a WiFi no equivale a enviar datos

La primera etapa consiste en asociar la tarjeta a la red. Obtener una IP no demuestra que un servidor esté funcionando ni que exista salida a internet. Esa prueba viene después.

Prepara una red compatible

Este ejemplo está planteado para ESP32 clásico y una red de 2.4 GHz. Revisa cobertura, nombre y contraseña. Una red con portal cautivo o requisitos empresariales necesita un procedimiento diferente.

Mantén las credenciales fuera del artículo

El código contiene marcadores para que cada lector los cambie en su copia local. No publiques un sketch con contraseñas reales. El monitor no imprime la contraseña del ejemplo.

Lista para esta práctica

Consulta contenido y disponibilidad en cada ficha. La fotografía identifica una referencia del catálogo; no confirma por sí sola la versión electrónica ni que incluya los accesorios de la práctica.

Descargar Arduino IDE · sitio oficial ↗

Esquema y pasos de preparación

Conexión del ESP32 a la computadora

Elige una sola tarjeta de las que se muestran. No se necesita cableado en los pines.

Computadora

Arduino IDE + monitor serie

Cable USB de datos

→

ESP32 30 PINES WIFI 2.4GHZ
SKU 01112

ESP32 38 PINES WIFI Y BLUETOOTH 240MHZ
SKU 02905

Puerto USB de la tarjeta

1

USBPuerto de la computadora

→

USBConector de la tarjeta

El conector del cable debe coincidir con el de tu unidad. No uses un cable solo de carga. No conectes 5V, GND, RX, TX ni otros GPIO entre la computadora y la tarjeta: esa conexión se hace por USB.

1. Comprueba primero que puedes cargar un mensaje serial.
2. Sustituye TU_RED_2G4 y TU_CLAVE en tu copia local.
3. Carga el ejemplo y abre el monitor a 115200.
4. Si falla, revisa red, cobertura y credenciales; reinicia para volver a intentar.

Programa de ejemplo

Copia el sketch completo en un archivo nuevo. Selecciona la placa y el puerto correspondientes; pulsa Verificar y después Subir. Las bibliotecas adicionales, cuando se necesitan, están indicadas en la preparación.

#include <WiFi.h>
const char* RED = "TU_RED_2G4";
const char* CLAVE = "TU_CLAVE";
void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_STA);
  WiFi.begin(RED, CLAVE);
  unsigned long inicio = millis();
  while (WiFi.status() != WL_CONNECTED &&
         millis() - inicio < 15000UL) {
    delay(250);
  }
  if (WiFi.status() == WL_CONNECTED) {
    Serial.print("IP local: ");
    Serial.println(WiFi.localIP());
  } else {
    Serial.println("Sin conexion. Revisa red y reinicia.");
  }
}
void loop() { delay(1000); }

Cómo funciona

• WiFi.begin inicia la conexión a la red indicada.
• millis limita la espera; el ejemplo no queda esperando indefinidamente.
• localIP muestra la dirección asignada en tu red local.

Primero confirma este resultado con el montaje básico. Después cambia una sola variable, como el mensaje o una pausa, y observa el efecto antes de agregar más componentes.

Errores frecuentes y qué revisar

• No uses el nombre de una red de 5 GHz si tu ESP32 clásico no la soporta.
• Si obtienes IP pero un servidor no responde, diagnostica esa etapa por separado.

Guarda el mensaje de error completo y anota placa, paquete y versión de biblioteca. Para pedir ayuda, comparte también el diagrama del montaje y el SKU de los componentes.

Preguntas frecuentes

Continúa aprendiendo

Sensores de 5 V y ESP32: cómo revisar compatibilidad y conexiones →

Arduino Uno original vs. genérico: diferencias y cuál elegir →