Botón de reinicio ESPHome: uso seguro en Home Assistant

Albert BarnosellEditor y responsable de Tecnoyfoto

Actualizado el 1 de septiembre de 2026

En el mundo del IoT, la estabilidad es clave. Sin embargo, todos sabemos que hasta el dispositivo más robusto puede necesitar un reinicio ocasional. Si tienes una placa ESPHome instalada en un lugar de difícil acceso —como un falso techo, un cuadro eléctrico o detrás de un mueble pesado—, un simple bloqueo puede convertirse en un verdadero dolor de cabeza. Afortunadamente, en 2026, tenemos una solución elegante y sencilla: crear un botón de reinicio ESPHome directamente en nuestra interfaz de Home Assistant.

Esta guía definitiva te mostrará cómo configurar un botón restart en Home Assistant para cualquier placa, desde las clásicas placa ESP8266 y ESP32 hasta los modelos más recientes. He probado este método en decenas de dispositivos y su fiabilidad es total.

Opción 1: Crear un Botón de Reinicio (Recomendado)

La forma más moderna y directa de implementar esta función es a través de la plataforma button de ESPHome. Esto creará una entidad de tipo botón en Home Assistant que, al ser pulsada, ejecutará la acción de reinicio en el microcontrolador.

Para ello, simplemente añade el siguiente código a tu archivo de configuración YAML de ESPHome:

# Ejemplo de configuración para el botón de reinicio
button:
  - platform: restart
    name: "Reiniciar Sensor Garaje"
    id: restart_garaje

Una vez que guardes y compiles este código en tu placa, aparecerá una nueva entidad en Home Assistant llamada button.reiniciar_sensor_garaje lista para ser usada.

Parámetros de Configuración

Aunque la configuración es mínima, es útil conocer sus parámetros:

Parámetro	Descripción
`name` (Obligatorio)	El nombre que tendrá la entidad del botón en Home Assistant. Es importante que sea descriptivo para que sepas qué dispositivo estás reiniciando.
`id` (Opcional)	Un identificador único para usar este botón en otras partes de tu código ESPHome, como en scripts o lambdas.
`icon` (Opcional)	Permite definir un icono personalizado del catálogo de Material Design Icons (ej: `icon: "mdi:restart-alert"`).

Opción 2: Usar un Interruptor (Switch ESPHome)

Una alternativa, más popular en versiones antiguas de Home Assistant pero todavía funcional, es utilizar un switch. La plataforma restart también está disponible para interruptores. Al activarlo, el dispositivo se reiniciará inmediatamente. La principal diferencia es que un interruptor tiene dos estados (encendido/apagado), aunque en este caso, siempre volverá al estado «apagado» tras el reinicio.

La configuración del switch ESPHome es muy similar:

# Ejemplo de configuración para el interruptor de reinicio
switch:
  - platform: restart
    name: "Interruptor Reinicio Cocina"

Esto creará una entidad switch.interruptor_reinicio_cocina en Home Assistant. Es una opción perfectamente válida si tus automatizaciones o scripts están diseñados para trabajar con interruptores en lugar de botones.

Resolución de Problemas Comunes (Troubleshooting)

Aunque el proceso de configurar ESPHome para esto es sencillo, a veces pueden surgir imprevistos. Aquí te dejo las soluciones a los problemas más habituales:

El botón no aparece en Home Assistant: Tras añadir el código y flashear el dispositivo, si la nueva entidad no aparece, comprueba los logs de ESPHome. Asegúrate de que la placa está correctamente conectada a tu red WiFi. A veces, un reinicio completo del dispositivo (desconectándolo de la corriente) fuerza la sincronización. También verifica que las actualizaciones OTA en ESPHome se completaron sin errores.
Error de validación en el código YAML: El 99% de las veces, esto se debe a una indentación incorrecta. Recuerda que YAML es muy estricto con los espacios. Si necesitas refrescar tus conocimientos, te recomiendo echar un vistazo a nuestro curso completo de YAML.
El dispositivo se reinicia pero no se vuelve a conectar: Este problema no suele estar relacionado con el botón de reinicio en sí, sino con la configuración de red de la placa. Revisa la sección wifi: en tu código para asegurarte de que las credenciales son correctas y de que la señal llega con suficiente potencia. Puedes encontrar más detalles en nuestra guía sobre la configuración WiFi en ESPHome.

Reinicio automático cuando se pierde la conexión

Un botón de Home Assistant solo funciona mientras el nodo ESPHome sigue accesible. Si el dispositivo ya está fuera de línea, Home Assistant no puede enviarle la orden de reinicio. Por eso no debes crear una automatización que pulse el botón después de detectar que el nodo se ha desconectado.

ESPHome incorpora vigilancia local en los componentes api y wifi. El valor predeterminado de reboot_timeout es 15 minutos: si no se establece una conexión durante ese tiempo, el propio nodo se reinicia sin depender de Home Assistant.

api:
  encryption:
    key: !secret api_encryption_key
  reboot_timeout: 15min

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  reboot_timeout: 15min

No es necesario declarar estos valores si quieres conservar los 15 minutos predeterminados. Configurarlos de forma explícita documenta el comportamiento. No los pongas a 0s salvo que tengas otro método de recuperación, porque eso desactiva esa vigilancia.

El botón manual sigue siendo útil cuando el nodo está conectado pero quieres reiniciarlo tras cambiar una integración o durante un diagnóstico. Para un equipo físicamente inaccesible, conserva además una forma de cortar la alimentación y evita reinicios automáticos en dispositivos que controlen funciones críticas.