简体中文
English
简体中文
日本語

Chain Encoder ESPHome 组件

Chain Encoder 是 M5Stack Chain 系列中的一款旋转编码器输入节点。内部集成 AB 旋转编码器,支持检测旋转方向与脉冲计数,旋钮中心支持按键输入。同时集成可编程 RGB LED 用于状态指示和交互显示。编码器帽带有 LEGO 兼容孔结构,能够实现更多创意结构连接。适用于人机交互、智能家居控制等应用场景。

注意
使用 Chain 系列节点时,需要适配的主机进行 UART 通信和控制,比如 Chain Dualkey 主机,或者 Atom 系列主机设备配合 Atomic ToChain Base

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 实体:

Dashboard 卡片案例

Page Tools
PDF
On This Page