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

Chain 系列 ESPHome 组件

Chain 系列组件通过 Chain Bus 提供按键、旋钮、摇杆、角度、距离等输入功能,以及蜂鸣器、LED 点阵等输出与显示功能。

1. 组件简介

项目 信息
系列名称 Chain 系列
扩展模块 Chain Joystick(U205)、Chain Key(U206)、Chain Encoder(U207)、Chain Angle(U208)、Chain ToF(U209)、Chain Mono(U217)、Chain RGB(U218)、Chain Buzzer(U224)、Chain PIR(U225)、Chain MIC(U226)、Chain Switch(U227)
主要功能 提供按键、旋钮、摇杆、角度、距离等输入功能,以及蜂鸣器、LED 点阵等输出与显示功能
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_*(外部组件)
ESPHome 版本要求 /

2. 组件说明

外部组件引入

此处以 Chain DualKey 为例,将其作为系统的主控制器。在连接扩展传感器时,需要正确区分连接方向以及 ID 编号顺序。

方向选择

此处以 Chain DualKey 为例,根据扩展传感器连接在 Chain DualKey 的哪一侧,选择对应的 uart_id:

  • 连接在 Chain DualKey 左侧 → 使用 chain_uart_left。
  • 连接在 Chain DualKey 右侧 → 使用 chain_uart_right。

ID 编号规则

chain_index 表示扩展传感器相对于 Chain DualKey 的位置:

  • 编号从距离 Chain DualKey 最近的模块开始。
  • ID 依次递增(ID:1 → ID:2 → ID:3 …)。
  • 左右两侧分别独立编号。
  • 可参考上图确定正确的顺序。

组合示例

多个 Chain 扩展模块可以共用同一条 UART 总线。各模块的 chain_index 按距离主控由近到远递增,左右两侧总线分别编号。主控 UART 引脚、Chain Bus 供电及板载功能请按所用主控的设备页面配置。

以下示例以 Chain DualKey 为主控:右侧依次连接 Chain Encoder(ID 1)、Chain Angle(ID 2)、Chain ToF(ID 3),左侧连接 Chain Joystick(ID 1)。配置统一使用最新的 m5_chain_* 组件与 chain_index 参数:

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
      - m5_chain_angle
      - m5_chain_tof
      - m5_chain_joystick
    refresh: 0s

m5_chain_encoder:
  id: chain_encoder
  uart_id: chain_uart_right
  chain_index: 1

m5_chain_angle:
  id: chain_angle
  uart_id: chain_uart_right
  chain_index: 2

m5_chain_tof:
  id: chain_tof
  uart_id: chain_uart_right
  chain_index: 3

m5_chain_joystick:
  id: chain_joystick
  uart_id: chain_uart_left
  chain_index: 1

各模块的传感器、二元传感器、灯光与显示实体配置请参考对应的组件页面:

Page Tools
PDF
On This Page