Home Assistant + WLED: 復旧可能なエフェクト自動化を構築する

チェックポイント / 01

各層の役割を一つにする

WLEDはコントローラー上でピクセルのタイミング、セグメント、エフェクトを管理します。Home Assistantはその上で部屋のコンテキスト、スケジュール、自動化を管理します。正確なWLEDエンティティと、それを呼び出すネットワーク経路を確認して初めて安定した自動化になります。

• ピクセルプロトコル、セグメント割り当て、エフェクトはWLEDのデバイス層に置きます。
• Home Assistantはコンテキストとコマンドに使い、コントローラーや電源経路の代わりにはしません。
• エンティティ、連携経路、ファームウェア、再起動時の動作をまとめて記録します。

チェックポイント / 02

既知のWLED状態を復旧可能にする

複雑な自動化を加える前に、WLEDへテスト済みのローカルプリセットまたはエフェクト状態を保存します。セグメント、明るさの上限、エフェクト、パレット、表示される場合はプリセットID、WLED再起動後の動作を記録します。プリセットは一つの具体的な構成の復旧状態であり、別のコントローラー、ファームウェア、テープのバリエーションを保証するものではありません。

• 状態には一時的な実験名ではなく、部屋と目的の名前を付けます。
• 明るさとエフェクト速度を実測した設置範囲内に保ちます。
• 正確なHome Assistantエンティティが公開しているプリセットまたはエフェクトを確認します。

チェックポイント / 03

予測できる一つのアクションから始める

一つのエンティティをトリガーし、既知のエフェクトまたはプリセットを呼び出し、実際のHome Assistant環境で結果を確認します。例はライトエンティティと公開されたエフェクトオプションを使っています。値は実際にテストしたエンティティとオプションに置き換え、安定してから在席、メディア、時刻の条件を追加します。

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"

チェックポイント / 04

故障と再起動の経路を試す

WLEDの再起動、Home Assistantの再起動、一時的なネットワーク切断、コントローラーの再通電を含めて自動化を試します。消灯したままにするのか、ローカルWLED状態へ戻すのか、新しいHome Assistantコマンドを待つのかを決めます。正確なコントローラー、ファームウェア、連携、電源シーケンスで確認するまでは、自動復旧とは書きません。

• テスト記録ではWLEDデバイスの再起動とHome Assistantの再起動を分けます。
• コントローラーに接続できない間、エンティティがどの状態を報告するか確認します。
• 保守作業とネットワーク障害に備え、ローカルまたは手動の復旧方法を残します。

チェックポイント / 05

所有範囲を隠さずシーンと条件を追加する

一つのアクションが再現できるようになったら、Home Assistantのシーンや追加条件で部屋の意図を表現します。WLEDのエフェクト、セグメント割り当て、明るさの境界を記録に残します。複数セグメントでは各セグメントを制御するエンティティを記録して同時動作を試します。一つのライトエンティティをオンにしただけでは、安全な複数セグメントのショーは定義されません。

• 条件は一つずつ追加し、診断用に基本アクションを残します。
• 構成メモにエンティティ、エフェクトまたはプリセット、セグメント範囲、想定復旧を保存します。
• メディア連動、スケジュール、ダッシュボードはテスト済みの光経路に加える任意のコンテキストとして扱います。

失敗しやすい点

よくある失敗

• ファームウェアのバージョン変更で名前が変わったエフェクトまたはプリセットに自動化が依存している。
• 選択したエンティティが公開していないRGBWチャンネルまたはセグメントをシーンが前提にしている。
• Home AssistantがWLEDのタイミング、コントローラー、電源経路を代替すると考えている。
• 最初のアクションは動くが、WLED再起動、Home Assistant再起動、ネットワーク切断を個別に試していない。
• コントローラー再起動や連携停止後のローカルまたは手動の復旧方法が記録されていない。

技術的根拠 / バージョン

判断を最新に保つ

このガイドはバージョン管理された技術レコードとして更新しています。製造用の施工に使う前に、現在のプロトコル文書と正確な製品リビジョンを再確認してください。