Home Assistant + WLED: crea una automatización de efectos recuperable

PUNTO DE CONTROL / 01

Asigna una función a cada capa

WLED gestiona en el controlador la temporización de píxeles, los segmentos y los efectos. Home Assistant gestiona por encima el contexto de la habitación, los horarios y las automatizaciones. La automatización solo es fiable si la entidad WLED exacta y la ruta de red que llama han sido verificadas.

• Mantén el protocolo de píxeles, el mapa de segmentos y los efectos en la capa del dispositivo WLED.
• Usa Home Assistant para contexto y comandos, no como sustituto del controlador ni de la alimentación.
• Registra juntos la entidad, la ruta de integración, el firmware y el comportamiento de reinicio.

PUNTO DE CONTROL / 02

Haz recuperable un estado WLED conocido

Guarda en WLED un preset local o un estado de efecto probado antes de añadir una automatización compleja. Registra el segmento, el límite de brillo, el efecto, la paleta, el identificador del preset cuando se exponga y el comportamiento después de reiniciar WLED. Un preset es un estado recuperable para una configuración concreta; no demuestra que otro controlador, firmware o variante de tira se comporte igual.

• Nombra el estado por habitación e intención, no por un experimento temporal.
• Mantén el brillo y la velocidad del efecto dentro del rango medido para la instalación.
• Confirma qué presets u opciones de efecto expone la entidad exacta de Home Assistant.

PUNTO DE CONTROL / 03

Empieza con una acción predecible

Activa una entidad, llama a un efecto o preset conocido y comprueba el resultado desde la instancia real de Home Assistant. El ejemplo usa una entidad de luz y una opción de efecto expuesta; sustituye ambos valores por las entidades y opciones que hayas probado. Añade presencia, contenido multimedia y horarios solo cuando esta ruta sea estable.

mode: restart
trigger:
  - trigger: state
    entity_id: binary_sensor.media_mode
    to: "on"
action:
  - action: light.turn_on
    target:
      entity_id: light.media_wall
    data:
      effect: "Solid"

PUNTO DE CONTROL / 04

Prueba la ruta de fallo y reinicio

Prueba la automatización reiniciando WLED, reiniciando Home Assistant, interrumpiendo temporalmente la red y volviendo a energizar el controlador. Decide si la luz debe permanecer apagada, volver a un estado local de WLED o esperar un nuevo comando de Home Assistant. No describas la recuperación como automática hasta obtener ese resultado con el controlador, firmware, integración y secuencia de alimentación exactos.

• Separa en el registro el reinicio del dispositivo WLED del reinicio de Home Assistant.
• Comprueba qué estado comunica la entidad mientras el controlador no está disponible.
• Conserva un fallback local o manual para el servicio y los fallos de red.

PUNTO DE CONTROL / 05

Añade escenas y condiciones sin ocultar la propiedad

Cuando la acción única sea repetible, usa una escena de Home Assistant o condiciones adicionales para expresar la intención de la habitación. Mantén visibles en el registro el efecto WLED, la asignación de segmentos y el límite de brillo. Con varios segmentos, documenta qué entidad controla cada uno y prueba las acciones simultáneas; encender una entidad no define por sí solo un show seguro de varios segmentos.

• Añade una condición cada vez y conserva la acción base para diagnosticar.
• Guarda entidad, efecto o preset, alcance de segmento y fallback esperado en la nota del montaje.
• Trata presencia multimedia, horarios y paneles como contexto opcional alrededor de una ruta de luz probada.

MODOS DE FALLO

Lo que suele fallar

• La automatización depende de un nombre de efecto o preset que cambia entre versiones de firmware.
• La escena supone canales RGBW o segmentos que la entidad seleccionada no expone.
• Se espera que Home Assistant reemplace la temporización de WLED, el controlador o la ruta de alimentación.
• La primera acción funciona, pero nunca se prueban por separado los reinicios de WLED, Home Assistant y la pérdida de red.
• No existe un fallback local o manual documentado tras reiniciar el controlador o perder la integración.

BASE TÉCNICA / VERSIÓN

Mantén actualizada la decisión

Esta guía se mantiene como un registro técnico versionado. Vuelve a comprobar la documentación vigente del protocolo y la revisión exacta del producto antes de usarla en una instalación de producción.