Chain Mono ESPHomeコンポーネント

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

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

1. コンポーネント概要

項目 情報
拡張モジュール Chain Mono (U217)
主な機能 マトリクスライト表示を提供
通信インターフェース Chain Bus / UART
ESPHomeコンポーネント m5_chain_base、m5_chain_mono(外部コンポーネント)
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_mono]
    refresh: 0s
  • Chain Monoノードを追加
m5_chain_mono:
  id: chain_mono
  uart_id: chain_uart_right
  chain_index: 1
注意
Chainの実際の位置に応じて、正しいindex(インデックス)を指定します。
  • Chain Monoのライトノードを追加
light:
  - platform: m5_chain_mono
    id: chain_mono_light
    name: "Chain Mono Matrix"
    m5_chain_mono_id: chain_mono
    restore_mode: RESTORE_DEFAULT_ON
    effects:
      - pulse:
          name: "Slow Pulse"
          transition_length: 500ms
          update_interval: 2s

effectsでライトにさまざまなエフェクトを追加できます。上記の例では、呼吸ランプのエフェクトを追加しています。

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

display:
  - platform: addressable_light
    id: chain_mono_display
    addressable_light_id: chain_mono_light
    width: 8
    height: 8
    update_interval: 1s
    lambda: |-
      it.print(0, 0, id(chain_mono_font), Color::WHITE, "A");

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

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

3. 使用例

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

Page Tools
PDF
On This Page