WLED、xLights、FPP: ショーを管理するレイヤーを決める

チェックポイント / 01

各レイヤーと各出力に一つの所有者を割り当てる

WLEDはローカルエフェクトやプリセットを提供でき、xLightsはシーケンスのタイミングを定義でき、正確なハードウェアと構成がその経路をサポートする場合はFPPがスケジュール再生を担当できます。ネットワークプロトコルはレイヤー間でデータを運びますが、出力の所有者を決めるものではありません。各出力、プリセット、シーケンス、再生ジョブの横に所有者を記録します。

• 通常運転中に各出力へ書き込めるシステムを明記します。
• エフェクト生成、シーケンス作成、再生スケジュール、伝送を分けて記録します。
• 明示的に引き継ぎをテストせず、二つの送信元に同じ出力を持たせません。

チェックポイント / 02

シーケンス作成前にピクセルとマッピングの契約を固定する

正確なテープまたは光源、物理ピクセル数、制御可能なアドレスまたはグループ数、色順、電圧、コントローラー出力、レシーバー経路、ユニバース、開始アドレス、チャンネル、目標リフレッシュを記録します。ソフトウェア上で正しく見えても、実装したデータ順やグループが異なる場合があります。マッピングのエクスポートをショーファイルとハードウェア間のバージョン管理されたインターフェースとして扱います。

• ショー、ファームウェア、正確な構成バリエーションと一緒にマッピングを版管理します。
• 物理ピクセル、論理グループ、ネットワークアドレスを別の項目にします。
• 製品名やプロトコル名をマッピングの証拠にしません。

チェックポイント / 03

伝送方式とタイミングを意図的に選ぶ

DDP、E1.31、Art-Net、コントローラープロトコルは、データ経路の異なる部分を担います。タイミングを生成する場所、ストリームを受ける機器、ユニバースやチャンネルの境界を運ぶ方法を決めます。名称が同じでも互換性の保証にはなりません。正確なコントローラー、レシーバー、ファームウェア、ショー構成で接続経路を文書化または検証する必要があります。

• 伝送方式、ユニバース、チャンネルまたはアドレス範囲、フレームレートを記録します。
• ライブ経路の時間源を一つにし、スケジュールされた引き継ぎを記録します。
• 予定するピクセル数、明るさ、シーンの複雑さでネットワーク負荷とリフレッシュを測定します。

owner: effects | sequence | playback | transport
contract: pixels + groups + color_order + voltage
map: output -> receiver_or_strip -> universe -> address
recovery: stop_playback -> local_mode -> restore_owner

チェックポイント / 04

再生を迂回できる保守経路を設計する

プレーヤーやネットワークの故障でローカルの点灯テストができなくなるなら、ショーは保守可能ではありません。既知のWLEDプリセットまたは文書化したローカルモードを残し、出力、レシーバー、電源分岐を個別に切り分ける方法を定義します。ネットワーク切断、プレーヤー停止、コントローラー再起動、電源復帰、スケジュール担当への返却を、二つのシステムを同時に動かさずにテストします。

• 完全なシーケンスに依存しないローカル復旧経路を残します。
• 再生を停止して担当をコントローラーへ戻す順序を記録します。
• 暗い出力を調べる際、データ障害と電源障害を分けます。

チェックポイント / 05

一つの出力からショー全体まで段階的に立ち上げる

短い既知の出力から始め、黒、全白、色、個数、グループ、リフレッシュ、再起動を確認します。次にシーケンス、続いて再生を追加し、出力を一つずつ増やします。各段階で結果をマッピングと照合し、ネットワークと電源の挙動を測定します。テープ、コントローラー、レシーバー、ファームウェア、ショーの版を変更した場合は再確認します。

• 次のレイヤーを追加する前に、既知の正常なチェックポイントを保存します。
• ショーが生成し得る最大要求輝度とネットワーク負荷を試験します。
• 所有者マップ、マッピングのエクスポート、復旧手順、検証済みの正確な構成を引き渡します。

失敗しやすい点

よくある失敗

• WLEDとショープレーヤーが明示的な引き継ぎなしに同じ出力を操作する。
• シーケンスのマッピングが物理ピクセル順、グループ、色順と一致しない。
• 伝送、ユニバース、チャンネル、リフレッシュの限界を正確な経路ではなく名称から推定する。
• 再生が停止したとき、コントローラー、レシーバー、電源分岐を切り分けるローカルモードがない。
• 短いエフェクト試験は通るが、拡張後に全白、ネットワーク負荷、再起動、電源復帰で失敗する。

技術的根拠 / バージョン

判断を最新に保つ

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