DDP、E1.31、TPM2.net で WLED にライブアニメーションを配信する

WLED は ESP32 と ESP8266 のボードで動作し、アドレス指定可能な LED ストリップとマトリックスを駆動します。Pixel LED Animator 3 はピクセルフレームをネットワーク経由でリアルタイムに WLED へ送信できるため、アニメーションをカードにコピーするのではなく、そのままライブ再生できます。

これによりワークフローが変わります。実際のマトリックスを見ながらエフェクトを調整し、配線をその場でテストし、ストリームが接続されている間はシーケンスを流し続けられます。

接続の仕組み

Pixel LED Animator はピクセルデータを含む UDP パケットを送信します。WLED がこれを受信し、ライブモードに切り替えて LED に値を書き込みます。レンダリングはエディターが、出力は WLED が担当します。

同じフレームを運べるプロトコルは複数あります。

WLED では DDP から始めてください。ユニバースの計算が不要で、フレームを最小数のパケットで送信できます。WLED がすでに sACN を使う大規模な構成の一部である場合は E1.31 を使用します。

KiNet は WLED のプロトコルではありません。Color Kinetics のドライバーや MADRIX 系の構成向けです。WLED ボードでは選択しないでください。

ステップ 1：WLED を設定する

1. WLED の Web インターフェースを開きます。
2. Config → LED Preferences に進み、LED の総数を width x height に設定します。
3. ストリップまたはパネルに合わせて色の順序を設定します。RGB、GRB、BRG などです。
4. 2D Matrix の設定を開き、パネルの幅、高さ、配線レイアウトを設定します。WLED のバージョンによって、LED Preferences 内にある場合と、専用の 2D 設定ページにある場合があります。
5. Config → Sync Interfaces に進み、DDP を有効にします。E1.31 や Art-Net は使用する予定がある場合だけ有効にしてください。
6. DHCP 予約でボードに固定 IP アドレスを割り当てます。
7. 外部データを送る前に、WLED 内蔵のエフェクトでマトリックスをテストします。

内蔵エフェクトが正しく見えない場合、外部ストリーミングも正しく見えません。まずマトリックスの寸法と配線を修正してください。

ステップ 2：Pixel LED Animator で配線を合わせる

ストリーミングウィンドウを開き、WLED プロトコルボタンを選択します。

• WLED IP: ボードのアドレス。アクセスポイントモードなら 192.168.4.1、LAN 上なら DHCP アドレスです。
• Protocol: DDP (Recommended)。
• Port: WLED ビルドで独自のポートを使っていない限り Default のままにします。
• Wiring pattern: 実際のマトリックスに合うパターンを選びます。シーケンシャル、サーペンタイン、垂直、垂直サーペンタインです。
• Brightness: テスト中は全体の上限を保ち、本番で上げます。

エディターの配線パターンと WLED の 2D マトリックス設定は一致している必要があります。片方がサーペンタイン、もう片方がプログレッシブだと、各行で画像が裂けたり鏡像になったりします。

ステップ 3：テストパターンで確認する

ストリーミングウィンドウで Test Patterns グループを開き、パターンを送信します。

• Solid は電源と基本色を確認します。
• Chase はピクセルの順序と方向を確認します。
• Alternate は奇数・偶数の配線を確認します。
• RGB Cycle は色の順序を確認します。
• Bars は行と列のマッピングを確認します。
• Gradient はバンディングとガンマの問題を明らかにします。

アニメーションを配信する前にパターンを送ってください。配線の不具合は、動くプラズマエフェクトよりもチェイスのほうがはるかに見つけやすくなります。

画像が鏡像、反転、回転している場合は、配線パターンまたは WLED の 2D の向きを修正します。アニメーションを編集して補正しないでください。

ステップ 4：ストリーミングを開始する

Start Streaming を押し、FPS メーターと DMX アクティビティ表示を確認します。そのうえで次をチェックします。

• 最初のフレームがエディターのプレビューと一致している。
• 動きが滑らかで、目に見える引っかかりがない。
• 色がパレットと一致している。
• 明るさを変えてもマトリックスがちらつかない。

WLED にはライブデータのタイムアウトがあります。ストリームが止まると、WLED は短い遅延の後に通常のエフェクトへ戻ります。これは想定された動作で、故障ではありません。

ステップ 5：ライブとスタンドアロンを使い分ける

ストリーミングはテストとライブショーに最適です。コンピューターなしで起動する必要がある常設インストールには向きません。

スタンドアロン再生では、完成したアニメーションを書き出し、コントローラーが受け付ける形式を使用します。書き出し形式ガイドでトレードオフを説明しています。

ネットワークとパフォーマンスの限界

生のピクセル帯域幅は簡単に計算できます。

width x height x 3 x FPS = bytes per second

これらの数値はパケットのオーバーヘッドを含みません。Wi-Fi でも運べますが、生のスループットよりも遅延とジッターのほうが重要です。大きなマトリックスでは次の点に注意してください。

• ボードが対応していれば ESP32 で Ethernet を使用する。
• アクセスポイントを近く、空いているチャンネルに置く。
• ほとんどの ESP32 ボードは 2.4 GHz のみです。5 GHz のネットワークは表示されません。
• ルーターのクライアント分離を無効にして、PC がボードに到達できるようにする。
• 電源容量を超えないよう WLED で明るさを制限する。

トラブルシューティング

よくある質問

WLED は動画ファイルを直接再生できますか？ 通常の意味では再生できません。WLED はライブのピクセルデータか独自のエフェクトを表示します。動画再生には専用の usermod とハードウェアが必要で、エディターからフレームを配信するのとは異なります。

DDP と E1.31 のどちらを使うべきですか？ WLED だけの構成なら DDP を使ってください。WLED が FPP、照明コンソール、その他の sACN 機器と同じネットワークを共有する場合は E1.31 を使います。

インターネット経由で配信できますか？ トンネルを使えば可能ですが、おすすめしません。ピクセルストリーミングは遅延に敏感で、コントローラーをネットワークに公開してしまいます。LAN 内に留めてください。

配信を止めた後もアニメーションは WLED に残りますか？ いいえ。ストリームはライブデータです。スタンドアロン再生にはコントローラー用のファイルを書き出すか、FPP を使用してください。

WLED は何ピクセルまで扱えますか？ ESP32 ボード、フレームレート、ネットワーク、電源によって変わります。カタログの数値を信じるのではなく、実際のマトリックスを目標のフレームレートでテストしてください。

Pixel LED Animator 3 を見る · すべての連携を見る · Falcon Player の FSEQ ガイドを読む · 買い切りのライセンスを購入する