ESPHome o firmware propio en ESP32: cuál usar

¿ESPHome o firmware propio en ESP32? Una tabla para decidir, lo que ESPHome no puede hacer y por qué OpenGizmo usa PlatformIO para su app web y su MCP.

Publicado
Tiempo de lectura
8 min
Categoría
Comparativas
Un maker pensativo con gafas redondas está entre un archivo YAML y un archivo C++, con flechas discontinuas de ambos hacia una placa ESP32.

En resumen

Usa ESPHome cuando la placa es un sensor o un interruptor que controlará Home Assistant. Escribe firmware propio cuando debe servir su propia app web, su configuración o su API, como las tres de OpenGizmo.

Usa ESPHome cuando tu ESP32 es un sensor, un interruptor o una pantalla que controlará Home Assistant: lo describes en YAML y ESPHome genera y compila el firmware. Usa firmware propio (tu propio C++ con el framework Arduino o ESP-IDF, o MicroPython) cuando la placa debe hacer algo que ningún componente cubre, como servir su propia app web o hablar un protocolo tuyo.

Los tres proyectos de OpenGizmo usan firmware propio, compilado con PlatformIO. Este artículo pone las dos opciones lado a lado, con la documentación de ESPHome (revisada en noviembre de 2026) y el código real de Gizmo Ticker, Gizmo Reolink Switch y Gizmo Camera. Una aclaración desde ya: no rehice estos proyectos en ESPHome, así que cuando digo que una función no encaja, me refiero a la documentación que leí, no a un experimento.

¿Qué te da ESPHome?

ESPHome es una herramienta que convierte un archivo YAML en firmware para un ESP32 o un chip parecido. Su página principal dice que te permite crear dispositivos para el hogar inteligente sin escribir código, y que cada dispositivo funciona con Home Assistant desde el primer momento, en local. Listas los componentes (un sensor de temperatura en un pin, un relé, una pantalla) y ESPHome los compila y los flashea.

Vienen cuatro cosas incluidas, y ahorran mucho tiempo:

  • Una API nativa para Home Assistant. Añade api: a la configuración y el dispositivo aparece entre las integraciones descubiertas, como describe la página del componente API. El cifrado es opcional.
  • Actualizaciones OTA. El componente OTA ofrece el protocolo nativo, una subida desde la página web del dispositivo o una descarga desde un servidor web, además de un modo seguro para recuperarte de una compilación mala.
  • Respaldo de Wi-Fi. Con un bloque ap:, el componente Wi-Fi abre un hotspot solo cuando no se puede llegar al router (el valor por defecto de ap_timeout es 90 segundos), y el portal cautivo te deja cambiar la red o subir firmware.
  • Una biblioteca de componentes. Un ejemplo de este blog: el componente de pantalla MAX7219 admite chips en cadena, rotación y desplazamiento.

Este último punto importa para ser justos. El hardware no es la razón por la que OpenGizmo no usa ESPHome: hay un componente para la cadena MAX7219 del Ticker y un componente de cámara ESP32 cuya página incluye un ejemplo de pines para Ai-Thinker, la familia de placas que usa Gizmo Camera.

ESPHome frente a Arduino, ESP-IDF y MicroPython

ESPHome se apoya en los frameworks, así que la comparación real es una pila. La página de la plataforma ESP32 dice que ESPHome usa ESP-IDF por defecto y ofrece Arduino para el ESP32 clásico, el S2, el S3 y el C3, integrado como componente de ESP-IDF. Escribir firmware propio significa elegir directamente uno de los otros.

OpciónQué escribesBuen encajeCoste principal
ESPHomeYAML, con lambdas en C++ cuando hace faltaSensores, interruptores y pantallas para Home AssistantLas funciones vienen de los componentes, y tu propia app no tiene dónde vivir
Arduino-ESP32C++ con librerías de ArduinoDispositivos propios con un gran ecosistema de libreríasEscribes y mantienes todo lo que está encima de las librerías
ESP-IDFC o C++ sobre el framework de EspressifControl total del chip y de sus driversUn arranque más difícil y más código por cada función
MicroPythonPython, ejecutado desde un REPLExperimentos rápidos y scriptsUn runtime en el chip y menos librerías listas para componentes exóticos

Algunas fuentes de la tabla: la documentación de Arduino-ESP32 dice que el core 3.3.12 se basa en ESP-IDF 5.5, así que los dos son una sola familia. La guía de ESP-IDF lo llama el framework de Espressif para aplicaciones IoT, compilado con CMake y Ninja. La referencia de MicroPython para ESP32 lista el ESP32, el C3, el C6, el S2 y el S3, y un REPL en UART0 a 115200 baudios. La columna "coste principal" es un juicio mío, no un benchmark: aquí no medí nada.

Para la parte de herramientas del firmware propio, la comparativa de Arduino IDE y PlatformIO tiene los detalles. Este artículo trata la capa de encima: si escribir firmware o no.

¿Cuándo es ESPHome la mejor opción?

ESPHome es la opción correcta cuando la respuesta a "¿quién habla con esta placa?" es Home Assistant. En ese caso la integración, las actualizaciones y el hotspot de respaldo te salen gratis, y unas pocas líneas de YAML sustituyen cientos de líneas de C++ que luego tendrías que mantener.

También lo es cuando quieres muchos dispositivos parecidos, porque cada uno es un archivo corto. Y es el mejor comienzo si no quieres escribir C++: ese es justo el objetivo declarado de la herramienta.

Dos tarjetas: ESPHome para sensores, relés y pantallas, con Home Assistant como interfaz y YAML en vez de C++; firmware propio para una app web propia, una configuración y una API propias

Si tu placa...Usa
Es un sensor, un relé o una pantalla controlados desde Home AssistantESPHome
Debe configurarse y actualizarse sin escribir códigoESPHome
Necesita un protocolo o una librería sin componente de ESPHome y no te importa escribir una lambdaESPHome con lambdas
Debe servir su propia app web, no un panelFirmware propio
Necesita una configuración, una API o una herramienta de flasheo en el navegador que diseñas túFirmware propio
Tiene que ejecutar un estándar al que otros puedan llamar, como un servidor MCPFirmware propio

¿Qué no puede hacer ESPHome?

ESPHome no es una caja cerrada, y tiene vías de escape que conviene conocer. Las lambdas son C++ dentro del YAML que puede leer cualquier componente por su ID, y la función de componentes externos importa código de la comunidad o local desde un repositorio de Git o una carpeta. ESPHome también avisa de que copia las lambdas en el C++ generado sin validarlas.

Los límites aparecen cuando el producto es la interfaz, no el dispositivo:

  • El servidor web es una página fija. El componente web_server tiene tres versiones de interfaz, recursos locales, autenticación opcional y js_include y css_include para añadidos. Su documentación no describe ninguna forma de alojar una página propia aparte.
  • El portal cautivo también es una página fija. Su documentación ofrece los ajustes de Wi-Fi y una subida de firmware, y su única opción es la compresión de los recursos integrados.
  • Las peticiones HTTP tienen valores por defecto pequeños. El componente http_request mantiene un búfer de respuesta de 1 kB mientras no lo subas, y en ESP32 verifica los certificados HTTPS por defecto, así que un dispositivo con certificado autofirmado necesita un archivo de CA (ca_certificate_path, que la página recomienda) o verify_ssl: false, que según la página reduce la seguridad.
  • La API nativa habla con una lista corta de clientes. La página de la API dice que solo la usan la herramienta de ESPHome, Home Assistant e ioBroker. Un agente de IA o un script tuyo no está en esa lista.

Ninguno de estos puntos es un fallo. Describen una herramienta que optimiza para dispositivos, no para productos.

¿En qué cambian las actualizaciones y la configuración del Wi-Fi?

ESPHome trae tanto un sistema de actualización como un hotspot de Wi-Fi de respaldo, y los dos enfoques se diferencian en quién es dueño del código. Con ESPHome configuras el hotspot de respaldo y la plataforma OTA, y el proyecto mantiene la implementación. Con firmware propio eliges cada pieza tú, lo que te da libertad y también la factura.

OpenGizmo es un buen ejemplo de esa factura. El portal cautivo es código mío: gizmo-common abre un hotspot sin contraseña, responde a cada nombre DNS con su propia dirección y redirige las sondas a /ap-setup. La comparativa de métodos de provisión de Wi-Fi muestra lo que eso cuesta en seguridad. Y no hay OTA en absoluto: los tres firmwares usan la tabla de particiones huge_app.csv, un único slot de app de 3 MB, así que las actualizaciones van por USB desde el navegador, como explica la comparativa de OTA. Quien usa ESPHome tiene OTA y modo seguro sin escribir una línea.

¿Por qué los proyectos de OpenGizmo usan firmware propio?

Cuatro razones, y cada una se ve en los repositorios. Son razones para estos productos, no para cualquier placa.

Una XIAO en una protoboard envía Wi-Fi a un teléfono que muestra su app de ajustes, con las etiquetas app on the board y no cloud, y una carcasa impresa al lado

La app web es el producto

Cada placa sirve una app web de Nuxt 4. La compilación es nuxt generate, y luego gizmo-embed de gizmo-common convierte los archivos estáticos en arrays de C++ comprimidos con gzip dentro de microcontroller/src/webui/, como describen las notas sobre la interfaz web integrada. El firmware los sirve desde el manejador de not-found, con los archivos con hash en caché durante un año. La imagen final de la app es un solo archivo de entre 1,7 y 1,8 MB (los tamaños están en el artículo sobre OTA). El servidor web documentado de ESPHome no tiene hueco para eso.

Cadena de compilación: la carpeta webapp de Nuxt, gizmo-embed a C++ comprimido con gzip, una compilación de PlatformIO y la placa sirviendo la interfaz

La configuración inicial se diseña, no se ajusta

La página de configuración es parte de la misma app web, y gizmo-common limita a cuatro rutas de API lo que puede alcanzar el hotspot. Es el tipo de detalle que el portal fijo de ESPHome no puede expresar. gizmo-common guarda las credenciales del Wi-Fi en el almacenamiento NVS de la placa mediante la librería Preferences de Arduino. Si el producto no tuviera una app web propia, el portal sería lo primero que le dejaría a ESPHome.

La Camera habla MCP

Gizmo Camera responde a peticiones del Model Context Protocol en /mcp y sirve una guía para agentes en /llms.txt. El código del protocolo es mcp_protocol.cpp, 509 líneas, cubierto por tests nativos. Se podría empaquetar como componente externo de ESPHome, pero el código del protocolo habría que escribirlo igual, solo que dentro de otro sistema de compilación.

El Reolink Switch inicia sesión para obtener un token, lo renueva un minuto antes de que el NVR lo haga caducar, agrupa comandos y reintenta con una conexión nueva cuando el NVR cierra una que se mantenía abierta. También llama a setInsecure() porque los NVR de Reolink suelen presentar certificados autofirmados, una decisión que explico en ese artículo. Esa lógica está en reolink.cpp y reolink_protocol.cpp, y el segundo archivo se prueba en la PC.

Suma el lado de la compilación: cada repositorio fija la plataforma, las librerías y la etiqueta de gizmo-common en platformio.ini, y ejecuta pio test -e native antes de cada versión. El artículo sobre Arduino IDE y PlatformIO muestra ese archivo.

Entonces, ¿con cuál empezar?

Empieza con ESPHome si Home Assistant es tu interfaz, y lo digo aunque no lo uso en OpenGizmo: quita las partes aburridas y fáciles de hacer mal. Pasa a firmware propio cuando te descubras peleando con la herramienta. En OpenGizmo serían la app, la herramienta de flasheo y la API de la que es dueña la placa.

El coste de esa decisión lo cargas tú. Yo mantengo un portal, una herramienta de flasheo, un flujo de publicación y el código del protocolo, y las placas no tienen OTA. Lo que verifiqué: las páginas de ESPHome enlazadas arriba, a noviembre de 2026, y el código de los tres repositorios. Lo que no: que ESPHome no pueda reproducir alguno de estos proyectos, el uso de flash o RAM de ESPHome y su comportamiento con la XIAO ESP32-S3 en tu hardware. Después, lee la visión general de OpenGizmo para ver el diseño completo, o qué ESP32 comprar si todavía no has elegido la placa.

Preguntas frecuentes

Encuentra respuestas rápidas a las preguntas más comunes sobre este tema.

Ninguno es mejor en general. ESPHome es más rápido cuando tu placa es un sensor, un interruptor o una pantalla que controla Home Assistant, porque la describes en YAML. El firmware propio gana cuando la placa debe servir su propia app web, tener su propia configuración o hablar un protocolo para el que ESPHome no tiene componente.

Publicado

¿Listo para montar tu propio gizmo?

Elige un proyecto open source con ESP32 y sigue su guía paso a paso, desde la lista de componentes y el cableado hasta el firmware y el primer arranque.

Lee también

Explora las categorías