Chain Encoder ESPHomeコンポーネント

Chain Encoderは、M5Stack Chainシリーズのロータリーエンコーダ入力ノードです。AB方式のロータリーエンコーダを内蔵し、回転方向とパルス数の検出に対応しており、ノブ中央はボタン入力に対応しています。また、状態表示やインタラクティブな表示に使用できるプログラマブルRGB LEDを搭載しています。エンコーダキャップにはLEGO互換の穴構造があり、より創造的な構造接続が可能です。ヒューマンマシンインターフェース、スマートホーム制御などの用途に適しています。

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

1. コンポーネント概要

項目 情報
拡張モジュール Chain Encoder (U207)
主な機能 ロータリーエンコーダ入力とボタン検出を提供
通信インターフェース Chain Bus / UART
ESPHomeコンポーネント m5_chain_base、m5_chain_encoder(外部コンポーネント)
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_encoder]
    refresh: 0s
  • Chain Encoderを追加
m5_chain_encoder:
  id: chain_encoder
  uart_id: chain_uart_right
  chain_index: 1
  update_interval: 50ms

Chainの実際の位置に応じて、正しいindex(インデックス)を指定します。

  • Chain Encoderの値(value)センサーとインクリメント(increment)センサーを追加
sensor:
  - platform: m5_chain_encoder
    m5_chain_encoder_id: chain_encoder
    name: "Chain Encoder Value"
    type: value
  - platform: m5_chain_encoder
    m5_chain_encoder_id: chain_encoder
    name: "Chain Encoder Increment"
    type: increment
  • Chain Encoderのバイナリセンサーを追加
binary_sensor:
  - platform: m5_chain_encoder
    m5_chain_encoder_id: chain_encoder
    name: "Chain Encoder Button"
  • Chain EncoderのRGBライトを追加
output:
  - platform: m5_chain_encoder
    id: chain_encoder_red
    m5_chain_encoder_id: chain_encoder
    channel: rgb_red
  - platform: m5_chain_encoder
    id: chain_encoder_green
    m5_chain_encoder_id: chain_encoder
    channel: rgb_green
  - platform: m5_chain_encoder
    id: chain_encoder_blue
    m5_chain_encoder_id: chain_encoder
    channel: rgb_blue

light:
  - platform: rgb
    name: Chain Encoder RGB
    red: chain_encoder_red
    green: chain_encoder_green
    blue: chain_encoder_blue

3. 使用例

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

ダッシュボードカードの例

Page Tools
PDF
On This Page