Botón Reinicio ESPHome: Guía Rápida y Actualizada 2026

Actualizado el 03 de febrero 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.

Automatización Avanzada: Reinicio Inteligente

La verdadera potencia de tener un botón de reinicio ESPHome es poder usarlo en automatizaciones. ¿Qué pasa si un sensor crítico deja de enviar datos? Podemos crear un «guardián» que reinicie automáticamente el dispositivo si se desconecta de Home Assistant durante un tiempo determinado.

Cada nodo ESPHome tiene una entidad binary_sensor.nombre_dispositivo_status que indica si está en línea. Podemos usarla como disparador.

Aquí tienes un ejemplo de automatización en Home Assistant:

automation:
  - alias: "Reinicio automático del ESP del garaje si se desconecta"
    id: reinicio_automatico_garaje_2026
    trigger:
      - platform: state
        entity_id: binary_sensor.sensor_garaje_status
        to: 'off'
        for:
          minutes: 15
    action:
      - service: button.press
        target:
          entity_id: button.reiniciar_sensor_garaje
    mode: single

¿Cómo funciona esta automatización?

trigger (Disparador): Se activa cuando el sensor de estado del «Sensor Garaje» (binary_sensor.sensor_garaje_status) cambia a off (desconectado) y permanece en ese estado durante 15 minutos.
action (Acción): Llama al servicio button.press para «pulsar» nuestro botón de reinicio remoto.

Esta simple automatización puede ahorrarte muchísimos problemas, especialmente con dispositivos que controlan funciones importantes en tu hogar inteligente. Es un pilar fundamental para cualquiera que se pregunte qué es Home Assistant y cómo puede mejorar la fiabilidad de su sistema.

Con esta guía, no solo sabes cómo reiniciar ESP32 o cualquier otra placa de forma remota, sino que también puedes construir un sistema más robusto y autónomo para 2026.