Chain RGB ESPHomeコンポーネント

Chain RGBは、M5Stack ChainシリーズのLED表示ノードで、8×8のRGB LEDドットマトリクスユニットを搭載しています。単一ピクセルの個別制御、ピクセルの一括書き込み、全画面バッファの高速リフレッシュに対応しています。また、ASCII文字のフォント描画、文字列スクロール、明るさ調節、多角度の画面回転などの機能を内蔵しており、多彩なダイナミックライティングやピクセルアニメーション効果を実現できます。ピクセルライトの制作、デスクの雰囲気灯、クリエイティブなイルミネーションサイン、スマートデバイスのライト通知などのシーンに適しています。

注意
Chainシリーズのノードを使用するには、UART通信と制御に対応したホストが必要です。例えば、Chain DualKey ホスト、または Atomic ToChain Base と組み合わせたAtomシリーズデバイスなどです。

1. コンポーネント概要

項目 情報
拡張モジュール Chain RGB (U218)
主な機能 RGBマトリクスライト表示を提供
通信インターフェース Chain Bus / UART
ESPHomeコンポーネント m5_chain_base、m5_chain_rgb(外部コンポーネント)
ESPHomeバージョン要件 2026.9.0 以降

2. コンポーネントの説明

外部コンポーネントの導入

設定例

  • ホストのUARTピンを設定(Chain DualKeyを例に)
uart:
  - id: chain_uart_right
    tx_pin: GPIO6
    rx_pin: GPIO5
    baud_rate: 115200

  - id: chain_uart_left
    tx_pin: GPIO47
    rx_pin: GPIO48
    baud_rate: 115200
  • 外部コンポーネントを導入
external_components:
  - source: github://m5stack/esphome@feat-m5-chain
    components: [m5_chain_base, m5_chain_rgb]
    refresh: 0s
  • Chain RGBノードを追加
m5_chain_rgb:
  id: chain_rgb
  uart_id: chain_uart_right
  chain_index: 1
注意
Chainの実際の位置に応じて、正しいindex(インデックス)を指定します。
  • Chain RGBのライトノードを追加
light:
  - platform: m5_chain_rgb
    id: chain_rgb_light
    name: "Chain RGB Matrix"
    m5_chain_rgb_id: chain_rgb
    restore_mode: RESTORE_DEFAULT_ON
    effects:
      # width 8 spans one full hue cycle per row of the 8x8 panel.
      - addressable_rainbow:
          name: "Rainbow"
          speed: 10
          width: 8

effectsでライトにさまざまなエフェクトを追加できます。上記の例では、流れるレインボーエフェクトを追加しています。

  • ディスプレイコンポーネントを追加すると、Chain RGBにコンテンツを表示できます
font:
  - file: "./assets/fonts/unscii-8.ttf"
    id: chain_rgb_font
    size: 8
    bpp: 1
    glyphs: "A"

display:
  - platform: addressable_light
    id: chain_rgb_display
    addressable_light_id: chain_rgb_light
    width: 8
    height: 8
    update_interval: 1s
    lambda: |-
      it.print(0, 0, id(chain_rgb_font), Color(255, 0, 0), "A");

上記の設定では、ローカルのフォントを使用してChain RGBに赤い文字「A」を描画します。

注意
ライトエフェクトとディスプレイは同時に1つしか有効になりません。

3. 使用例

Chain RGB拡張モジュールを接続すると、デバイスページで対応するLightエンティティを確認できます。

Page Tools
PDF
On This Page