ESP32 no conecta al WiFi: causas y soluciones

Empieza por observar el síntoma

“El ESP32 no conecta al WiFi” puede significar varias cosas: no compila, no arranca, no encuentra la red, rechaza la contraseña, conecta y se desconecta o aparece en el router pero no en Home Assistant. Identifica el punto exacto antes de cambiar configuración al azar.

Mira el log por USB si es posible. Anota el modelo de placa, versión de ESPHome, nombre de la red, banda utilizada y si otros dispositivos conectan desde el mismo lugar. No publiques la contraseña ni el nombre completo de tu red en capturas.

1. Comprueba alimentación y cable USB

Un ESP32 que se reinicia no puede mantener una conexión. Prueba una fuente USB estable, otro cable de datos y otra alimentación. Si el fallo solo aparece cuando conectas un relé, pantalla o sensor, separa la alimentación del periférico y revisa su consumo.

El cable USB sirve para leer logs y flashear, pero no demuestra que la fuente de la instalación final sea suficiente. Un dispositivo puede funcionar en el ordenador y reiniciarse con un cargador o cable defectuoso.

2. Verifica la banda y la cobertura

Muchas placas ESP32 trabajan con redes de 2,4 GHz, no con una red de 5 GHz exclusiva. Si el router usa el mismo nombre para varias bandas, crea una prueba temporal con una red compatible y una contraseña sencilla, sin caracteres problemáticos, para separar cobertura de configuración.

Acerca la placa al punto de acceso durante la prueba. Si conecta cerca pero no en su ubicación, el problema es cobertura, interferencias o la posición de la antena. No escondas la antena detrás de metal ni pegada a una fuente de ruido.

3. Revisa SSID y contraseña

Confirma mayúsculas, espacios y caracteres especiales. En ESPHome, guarda los valores en secretos locales:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

No pongas la contraseña en un artículo, una captura pública o un repositorio. Después de cambiarla, recompila o actualiza el firmware que realmente está en la placa; editar el archivo local no cambia automáticamente el dispositivo.

4. Comprueba la configuración de ESPHome

Confirma que el bloque wifi está al nivel correcto del YAML, que no hay tabs y que el dispositivo tiene una configuración válida. Una configuración mínima debe incluir placa, logger, API u otro método de control y WiFi.

Si usas una versión nueva de ESPHome, revisa cambios de sintaxis en ota, framework y componentes. Un error de compilación no es un error de WiFi todavía: primero consigue un firmware que compile.

5. Mira el router

Comprueba si el router ve el dispositivo y qué dirección IP le asigna. Revisa también:

• Filtrado MAC o control parental.
• Aislamiento de clientes WiFi.
• Red de invitados sin acceso a Home Assistant.
• DHCP agotado o reservas duplicadas.
• Contraseña WPA y modo de seguridad compatible.

Una red de invitados puede permitir Internet pero bloquear la comunicación con el servidor domótico. En ese caso el ESP32 parece conectado, pero Home Assistant no puede descubrirlo.

6. Distingue WiFi de API y mDNS

Que el ESP32 se asocie al WiFi no significa que Home Assistant pueda usarlo. Si la IP aparece en el router, prueba conectividad desde la red local y revisa la API de ESPHome. Los nombres .local dependen de mDNS y pueden fallar aunque la IP funcione.

Para diagnosticar, usa temporalmente la IP, revisa si hay aislamiento de clientes y confirma que el servidor y el ESP32 están en redes que pueden comunicarse. No abras la API a Internet para solucionar un problema de red local.

7. Comprueba firmware y placa

Elige el board correcto y revisa el modelo impreso. Los pines de arranque, la memoria y el framework pueden cambiar entre familias ESP32. Si una actualización ha introducido el problema, vuelve a una configuración mínima y añade componentes uno a uno.

8. Comprueba la instalación final

Cuando funcione en la mesa, muévelo a su ubicación definitiva y observa la señal, los reinicios y la temperatura durante varias horas. Una caja metálica, una fuente barata o un cable largo pueden cambiar el resultado.

Checklist rápido

1. Fuente y cable comprobados.
2. Red de 2,4 GHz disponible.
3. SSID y contraseña verificados sin exponerlos.
4. Firmware compila y corresponde a la placa.
5. Router asigna IP.
6. No hay aislamiento entre ESP32 y Home Assistant.
7. API y mDNS comprobados por separado.
8. Señal estable en la ubicación final.

Fuentes y siguiente paso

Consulta la documentación WiFi de ESPHome y la guía del ESP32. Si el problema aparece al instalar un sensor, revisa también DHT11 frente a DHT22.