Home Assistant + WLED : créer une automatisation d’effets récupérable

POINT DE CONTRÔLE / 01

Attribuer un rôle à chaque couche

WLED gère dans le contrôleur le timing des pixels, les segments et les effets. Home Assistant gère au-dessus le contexte de la pièce, les horaires et les automatisations. Le fonctionnement n’est fiable que si l’entité WLED exacte et le chemin réseau appelé ont été vérifiés.

• Conservez le protocole de pixels, la cartographie des segments et les effets dans la couche appareil WLED.
• Utilisez Home Assistant pour le contexte et les commandes, pas comme remplacement du contrôleur ou de l’alimentation.
• Documentez ensemble l’entité, le chemin d’intégration, le firmware et le comportement au redémarrage.

POINT DE CONTRÔLE / 02

Rendre récupérable un état WLED connu

Enregistrez dans WLED un preset local ou un état d’effet testé avant d’ajouter une automatisation complexe. Notez le segment, la limite de luminosité, l’effet, la palette, l’identifiant du preset lorsqu’il est exposé et le comportement après redémarrage de WLED. Un preset est un état récupérable pour une configuration précise ; il ne prouve pas le comportement d’un autre contrôleur, firmware ou ruban.

• Nommez l’état selon la pièce et l’intention, pas selon une expérience provisoire.
• Gardez la luminosité et la vitesse de l’effet dans la plage mesurée de l’installation.
• Vérifiez les presets ou options d’effet exposés par l’entité Home Assistant exacte.

POINT DE CONTRÔLE / 03

Commencer par une action prévisible

Déclenchez une entité, appelez un effet ou preset connu et vérifiez le résultat depuis l’instance Home Assistant réelle. L’exemple utilise une entité lumière et une option d’effet exposée ; remplacez les valeurs par les entités et options effectivement testées. Ajoutez présence, médias et horaires seulement après stabilisation de ce chemin.

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"

POINT DE CONTRÔLE / 04

Tester le chemin de panne et de redémarrage

Testez l’automatisation avec un redémarrage de WLED, un redémarrage de Home Assistant, une indisponibilité réseau temporaire et la remise sous tension du contrôleur. Décidez si la lumière reste éteinte, revient à un état WLED local ou attend une nouvelle commande Home Assistant. Ne qualifiez pas la reprise d’automatique avant de l’avoir observée avec le contrôleur, le firmware, l’intégration et la séquence d’alimentation exacts.

• Séparez dans le journal le redémarrage de l’appareil WLED et celui de Home Assistant.
• Vérifiez l’état renvoyé par l’entité lorsque le contrôleur est inaccessible.
• Conservez une reprise locale ou manuelle pour la maintenance et les pannes réseau.

POINT DE CONTRÔLE / 05

Ajouter scènes et conditions sans masquer les responsabilités

Quand l’action unique est reproductible, utilisez une scène Home Assistant ou des conditions supplémentaires pour exprimer l’intention de la pièce. Gardez visibles l’effet WLED, l’affectation des segments et la limite de luminosité. Pour plusieurs segments, documentez l’entité de chaque segment et testez les actions simultanées ; allumer une entité lumière ne définit pas automatiquement un show multisegment sûr.

• Ajoutez une condition à la fois et gardez l’action de base disponible pour le diagnostic.
• Enregistrez dans la note de montage l’entité, l’effet ou le preset, la portée du segment et la reprise attendue.
• Traitez présence média, horaires et tableaux de bord comme un contexte optionnel autour d’un chemin lumineux testé.

MODES DE DÉFAILLANCE

Ce qui échoue généralement

• L’automatisation dépend d’un nom d’effet ou de preset modifié entre deux versions du firmware.
• La scène suppose des canaux RGBW ou des segments que l’entité choisie n’expose pas.
• Home Assistant est censé remplacer le timing WLED, le contrôleur ou le chemin d’alimentation.
• La première action fonctionne, mais les redémarrages de WLED, de Home Assistant et la perte réseau ne sont jamais testés séparément.
• Aucune reprise locale ou manuelle n’est documentée après le redémarrage du contrôleur ou l’arrêt de l’intégration.

BASE TECHNIQUE / VERSION

Garder la décision à jour

Ce guide est maintenu comme une fiche technique versionnée. Vérifiez à nouveau la documentation actuelle du protocole et la révision exacte du produit avant de l’utiliser dans une installation de production.