ESP32 / ESPHome: problemas resueltos paso a paso

Flasheo, Wi‑Fi, pines y sensores. 16 guías en español, ordenadas de más fácil a más avanzada, cada una con su diagnóstico, la solución y las fuentes oficiales.

Flasheo y USB

• ESP32: «Wrong boot mode detected» al flashear
  Al subir el firmware, esptool falla con «Failed to connect… Wrong boot mode detected (0xXX)! The chip needs to be in download mode». · Básico
• El ordenador no detecta el ESP32 por USB
  Conectas el ESP32 y no aparece ningún puerto serie (COM en Windows, /dev/ttyUSB* o /dev/cu.*). · Básico
• Permission denied al abrir /dev/ttyUSB0 o /dev/ttyACM0
  Al flashear un ESP32 o Arduino desde Linux: could not open port /dev/ttyUSB0: Permission denied. · Básico
• Arduino IDE no muestra las placas ESP32
  En Arduino IDE no aparece ninguna placa ESP32 para elegir. · Básico
• Heltec WiFi LoRa 32 V3: instalar Meshtastic sin romper la radio
  Te ha llegado una Heltec V3 y quieres usarla con Meshtastic, pero sale «LoRa Error», se reinicia sola o no sabes qué región elegir. · Básico
• LilyGO T-Deck Plus: primeros pasos (flasheo y cuidados LoRa/GPS)
  Tienes un T-Deck Plus y no sabes cómo flashearlo sin brickearlo ni por qué no arranca LoRa o el GPS. · Intermedio

Alimentación

• ESP32: «Brownout detector was triggered» y se reinicia
  El ESP32 imprime «Brownout detector was triggered» por el puerto serie y se reinicia, a menudo justo al activar el Wi-Fi. · Básico

Wi‑Fi

• El ESP32 no conecta al Wi-Fi o se desconecta (ESPHome)
  El ESP32 no encuentra la red o se desconecta cada poco. · Básico
• ESPHome: cambié de Wi‑Fi y el dispositivo ya no se conecta
  Cambiaste el router o la contraseña y el ESP ya no vuelve a la red; no quieres desmontarlo para conectarlo por USB. · Básico

ESPHome

• Primer dispositivo ESPHome en Home Assistant
  Tienes un ESP32 y quieres verlo en Home Assistant sin programar en C. · Básico
• Home Assistant pide la clave de cifrado de un dispositivo ESPHome
  Al añadir un dispositivo ESPHome, Home Assistant pide una «clave de cifrado» que no sabes cuál es. · Básico
• Ver los logs de un dispositivo ESPHome para saber qué le pasa
  El dispositivo no se comporta como esperas y no sabes por dónde empezar. · Básico
• ESPHome: el dispositivo sale «offline» y la OTA no encuentra la IP
  El panel de ESPHome muestra el dispositivo como offline o falla la subida OTA aunque el aparato funciona. · Intermedio

Pines y sensores

• Sensor DHT22 en ESPHome da NaN o lecturas erráticas
  El sensor DHT22/DHT11 devuelve NaN, errores de lectura o valores que saltan. · Básico
• ESP32 no arranca o se comporta raro al conectar algo a ciertos pines
  El ESP32 no arranca, entra en modo descarga o falla la flash cuando hay un sensor/relé conectado a ciertos GPIO. · Intermedio
• Las lecturas analógicas del ESP32 fallan cuando el Wi‑Fi está activo
  Un sensor analógico da lecturas fijas o erróneas en cuanto el ESP32 conecta al Wi‑Fi. · Intermedio

Manuales y guías de aparatos

• ESP32 DevKitC · Microcontrolador
• ESP32-S3-DevKitC-1 · Microcontrolador
• ESP32-C3-DevKitM-1 · Microcontrolador
• ESP32-C6-DevKitC-1 · Microcontrolador
• Wemos D1 mini (ESP8266) · Microcontrolador
• Seeed XIAO ESP32C3 · Microcontrolador
• Seeed XIAO ESP32S3 · Microcontrolador
• Heltec WiFi LoRa 32 V3 · LoRa / Meshtastic
• LilyGO T-Deck Plus · Dispositivo de bolsillo
• M5Stack Cardputer · Dispositivo de bolsillo
• Arduino Nano ESP32 · Microcontrolador
• ESP32-CAM (AI-Thinker) · Cámara

Cursos para aprender ESP32 / ESPHome

• ESP-IDF Workshop: Basic · Espressif (Developer Portal) · gratis

Otros temas: Raspberry Pi · Home Assistant · Linux y Docker · IA local · Redes y seguridad · Impresión 3D / Maker · Ciberseguridad para novatos.