Qué es ESPHome y para qué sirve: guía completa

Albert BarnosellEditor y responsable de Tecnoyfoto

Actualizado el 15 de agosto de 2026 · Conceptos, instalación, hardware, seguridad y flujo de trabajo revisados con la documentación vigente.

ESPHome es una plataforma que convierte microcontroladores económicos en sensores, interruptores, pantallas y otros dispositivos inteligentes mediante una configuración visual o un archivo YAML. Genera el firmware, lo instala en la placa y permite que el dispositivo se comunique directamente con Home Assistant dentro de tu red local.

Su principal ventaja es que no necesitas escribir un programa completo en C++ para cada proyecto. Describes la placa y los componentes, ESPHome valida la configuración y compila el firmware adecuado. El resultado no es una automatización que dependa continuamente del servidor: el microcontrolador ejecuta su propio firmware y puede conservar parte de la lógica local incluso si Home Assistant no está disponible.

Qué es ESPHome en pocas palabras

• Configurador: permite definir sensores, salidas, comunicaciones y automatizaciones.
• Generador de firmware: transforma esa definición en un programa para la placa.
• Herramienta de instalación: flashea el dispositivo por USB o de forma inalámbrica mediante OTA.
• Integración local: expone entidades y acciones a Home Assistant mediante la API nativa.
• Catálogo de componentes: reúne controladores para sensores, relés, luces, pantallas, buses y comunicaciones.

ESPHome forma parte de Open Home Foundation y está estrechamente integrado con Home Assistant. No es exclusivo del ESP8266 o ESP32: también admite otras familias, aunque ESP32 concentra la mayor parte del desarrollo nuevo.

Cómo funciona, desde el YAML hasta Home Assistant

1. Eliges la placa correcta y declaras sus componentes en Device Builder o YAML.
2. ESPHome valida nombres, pines, dependencias y opciones.
3. Compila un firmware específico para ese dispositivo.
4. La primera instalación suele realizarse por USB; las siguientes pueden enviarse por OTA.
5. Home Assistant descubre el nodo y crea sus entidades mediante la integración ESPHome.

El archivo YAML no se ejecuta literalmente en la placa. Es la descripción a partir de la cual ESPHome genera y compila el firmware. Por eso una configuración debe coincidir con el hardware real y superar la validación antes de instalarse.

Control local y privacidad

Un nodo ESPHome se comunica con Home Assistant por la red local mediante un protocolo optimizado. No requiere crear una cuenta en la nube del fabricante ni enviar lecturas a Internet. Esto reduce dependencias externas y permite seguir usando el dispositivo si desaparece una aplicación comercial.

Local no significa automáticamente seguro. Debes proteger la API con cifrado, utilizar contraseña OTA, guardar las credenciales en secrets.yaml y evitar exponer el dispositivo directamente a Internet. Nuestra guía de WiFi en ESPHome explica la configuración y recuperación de conexión.

Qué placas admite ESPHome

“ESP32” es una familia, no una única placa. Antes de copiar un YAML confirma el modelo exacto y el pinout. Si dudas entre las dos opciones clásicas, consulta nuestra comparación ESP32 vs ESP8266.

Device Builder o edición YAML

Device Builder ofrece una interfaz para crear el dispositivo, seleccionar la plataforma y editar los componentes. Es el camino más cómodo para empezar desde Home Assistant. El YAML continúa siendo la representación completa y resulta mejor para revisar cambios, copiar patrones, usar paquetes y mantener configuraciones grandes.

Ambos métodos describen lo mismo. Puedes comenzar visualmente y abrir el YAML cuando necesites más control. La documentación oficial incluye el esquema de cada componente; no conviene adivinar opciones a partir de ejemplos antiguos porque la sintaxis evoluciona.

Ejemplo mínimo y seguro

Este ejemplo crea un nodo ESP32 con registro, API cifrada, OTA protegida y WiFi mediante secretos. Cambia la placa y los pines según tu hardware:

esphome:
  name: sensor-salon
  friendly_name: Sensor salón

esp32:
  board: esp32dev

logger:

api:
  encryption:
    key: !secret api_encryption_key

ota:
  - platform: esphome
    password: !secret ota_password

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

binary_sensor:
  - platform: gpio
    name: "Pulsador"
    pin:
      number: GPIO23
      mode:
        input: true
        pullup: true
      inverted: true

En secrets.yaml se guardan los valores sensibles. El fichero puede reutilizarse desde varios nodos sin repetir contraseñas en cada configuración ni publicarlas por error en un repositorio.

Instalar ESPHome

• Aplicación de Home Assistant: opción habitual si ya utilizas Home Assistant OS o una instalación compatible.
• Aplicación de escritorio: instalación guiada en Windows, macOS o Linux.
• Línea de comandos: adecuada para desarrollo, automatización y validación reproducible.
• Instalador web: algunos proyectos preparados pueden instalarse desde un navegador compatible.

La primera carga por USB necesita un cable de datos y, en algunas placas, el controlador del conversor USB. Después de una instalación correcta podrás actualizar por red. Consulta nuestra guía de OTA en ESPHome antes de desplegar nodos en lugares difíciles de alcanzar.

Flujo de trabajo recomendado

1. Identifica placa, revisión, tensión lógica y pinout.
2. Prueba primero una configuración mínima con logger, WiFi, API y OTA.
3. Añade un componente cada vez y valida antes de instalar.
4. Revisa los registros para detectar reinicios, errores de bus o mala señal.
5. Asigna nombres estables y documenta direcciones, pines y calibraciones.
6. Conserva una copia del YAML y de secrets.yaml en un lugar seguro.

Ventajas reales

• Control local y sin cuenta del fabricante.
• Integración profunda con Home Assistant.
• Gran catálogo de componentes reutilizables.
• Actualizaciones OTA, registros remotos y diagnósticos.
• Automatizaciones dentro del propio nodo para respuestas rápidas.
• Configuraciones que pueden versionarse, copiarse y auditarse.

Limitaciones que debes conocer

ESPHome simplifica el software, pero no corrige un circuito peligroso. Debes respetar tensiones, corriente, aislamiento y normas eléctricas. Un GPIO no puede alimentar directamente cargas importantes y ningún montaje de baja tensión debe improvisarse junto a la red eléctrica.

El firmware también consume memoria y recursos. En un ESP8266 complejo pueden aparecer límites de RAM, tamaño o número de componentes; un ESP32 suele ofrecer más margen. Algunos dispositivos comerciales utilizan chips, buses o protecciones que no están documentados y no siempre son candidatos adecuados para modificar.

ESPHome frente a Arduino, Tasmota y Zigbee

No son alternativas idénticas. ESPHome es especialmente valioso cuando quieres definir exactamente el hardware, conservar el control local y obtener entidades nativas en Home Assistant.

Ideas de proyectos

• Temperatura, humedad, presión y calidad del aire.
• Contactos de puertas, fugas de agua y presencia.
• Relés y luces con pulsadores locales.
• Medidores de energía, pulsos, distancia o nivel.
• Pantallas de estado y paneles táctiles.
• Proxies Bluetooth y dispositivos de voz en hardware compatible.

Empieza por un proyecto pequeño, como un pulsador o un sensor de temperatura. Aprenderás el flujo completo sin mezclar a la vez problemas de alimentación, buses, WiFi y automatizaciones.

Fuentes comprobadas

• ESPHome: descripción, instalación y plataformas.
• ESPHome con Home Assistant.
• Configuración YAML de ESPHome.
• API nativa de ESPHome.
• Selección e identificación de placas.

Preguntas frecuentes

¿Necesito saber programar?

No para proyectos habituales. Sí necesitas comprender el cableado, las opciones del componente y la estructura básica de YAML. Las lambdas C++ son opcionales para casos avanzados.

¿ESPHome funciona sin Home Assistant?

El dispositivo ejecuta su firmware y puede tener automatizaciones locales. Sin embargo, Home Assistant es el cliente principal para paneles, históricos y automatizaciones entre dispositivos.

¿Debo elegir ESP32 o ESP8266?

Para un proyecto nuevo, ESP32 suele ofrecer más margen y funciones. ESP8266 continúa siendo válido para nodos WiFi sencillos y hardware que ya funciona.

¿Todo queda dentro de mi red?

La comunicación habitual con Home Assistant es local. Que un proyecto concreto contacte con Internet dependerá de los componentes y servicios que añadas.

ESPHome destaca porque convierte una descripción legible del hardware en un dispositivo local mantenible. La clave no es copiar grandes YAML, sino elegir bien la placa, validar cada componente y documentar un montaje eléctrico seguro.

Continúa leyendo

Siguiente guía relacionada · 10 min de lectura

ESP32: guía completa, pinout y ESPHome (2026)

Actualizado el 3 de agosto de 2026. He revisado las especificaciones, los GPIO delicados y todos los ejemplos YAML conforme a la documentación actual…

Continuar con este artículo↓