ZimaCubeの第7ベイRGBライティングに公式制御プロトコルが追加されたため、色やエフェクトを変更するだけならCubeFXを書き込む必要はありません。公式ファームウェアは、172.16.1.1でESP32のWi-Fiエンドポイントを公開し、ブリージング、固定表示、LEDごとのカスタムモード向けのJSONコマンドを受け付けます。
CubeFXは、別のインターフェースやより高度なカスタマイズを求めるユーザー向けの、任意のコミュニティ製ファームウェアとして引き続き利用できます。標準ファームウェアを使う場合は、公式のHTTP/JSON方式を使用し、ESP32の再書き込みは避けてください。
第7ベイのライティングの仕組み
現在の第7ベイLEDプロトコルによると、ライティングコントローラーは13個のLEDを備えたWS2812Bストリップに接続されたESP32です。
ライティングコントローラーに接続する
公式ファームウェアは、ドキュメントに記載されたパスワードhomecloudを使用するZimaCubeという名前のWi-Fiネットワークを作成します。コントローラーには172.16.1.1でアクセスできます。
ping 172.16.1.1固定色を設定する
{
"id": 2,
"data": [
{"h": 21, "s": 255, "v": 255}
]
}JSONをコントローラーに送信します。
curl -X POST -H "Content-Type: application/json" -d @light.json http://172.16.1.1/postブリージングモードとカスタムモード
モード1は速度を調整できるブリージングモードです。モード5では、13個すべてのLEDの色と明るさを個別に制御できます。公式ドキュメントでは、現在モード3と4は開発中とされています。
標準ファームウェアをそのまま使える
これが2024年のフォーラムスレッドからの重要な変更点です。公式の制御ドキュメントが公開されました。サードパーティ製イメージを書き込まなくても、標準ファームウェアをスクリプトから制御できます。
CubeFXは引き続き任意の代替手段
コミュニティのCubeFXプロジェクトスレッドでは、意図的にカスタムファームウェアを使いたい上級ユーザー向けに、カスタムファームウェアの導入方法が提供されています。
OTAファームウェア更新
ESP32はOTA用のWebインターフェースも公開しています。不明なファームウェアバイナリをアップロードしないでください。復旧用のコピーを保管し、カスタムファームウェアによってZimaOSが想定するプロトコルが変更される可能性があることを理解しておきましょう。
RGBをステータスの自動化に利用する
制御エンドポイントはJSONを受け付けるため、ストレージサブシステムに触れることなく、スクリプトからバックアップの状態、ディスクアラート、ダウンロード、ローカルAIの処理状況などを色に割り当てられます。
RGB制御の概要では、プロジェクトに関する追加情報を紹介しています。
JSONを送信する前にHSV値を変換する
公式プロトコルでは、色相、彩度、明度を0～255の範囲で指定します。カラーピッカーが色相を度数、彩度と明度をパーセントで表示する場合は、ESP32に送信する前に値を変換してください。
自動化する前にシンプルなモードを1つ試す
まずは固定色モードから始め、コントローラーが応答することを確認してください。その後で、バックアップの状態、ディスクアラート、音楽エフェクトなどのスクリプトを追加します。これにより、ネットワークやプロトコルの問題と自動化ロジックの問題を切り分けられます。
自動化は重要な通知に使わない
LEDは視覚的な補助として使用し、ディスク障害やバックアップに対する唯一の通知手段にしないでください。ハードウェアの通知は、ログ、メール、監視システムなど、別の永続的な経路にも残るようにしてください。
よくある質問
LEDを制御するためにCubeFXは必要ですか？
いいえ。現在の公式ファームウェアには、ドキュメント化されたJSON/HTTPプロトコルがあります。
ストリップにはLEDがいくつありますか？
公式のハードウェアドキュメントでは、13個のWS2812B LEDが指定されています。
各LEDを個別に制御できますか？
はい。公式のカスタムモードでは、LEDごとにHSV値を設定できます。
CubeFXの後に標準ファームウェアへ戻せますか？
公式のOTA/ファームウェアリソースを使用し、再書き込みの前に正しいハードウェアリビジョンであることを確認してください。
