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

Chain Angle ESPHome 组件

Chain Angle 是 M5Stack Chain 系列中的一款电位器旋钮输入节点。随着电位器旋钮旋转,采样端的电压值将在固定的范围内变化。在内置 MCU 进行 ADC 转换后,对外输出最大 12-bit 分辨率的信号值。同时集成可编程 RGB LED 用于状态指示和交互显示。适用于人机交互、智能家居和电机调速控制等应用场景。

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

1. 组件简介

项目 信息
扩展模块 Chain Angle(U208)
主要功能 提供旋钮功能
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_base, m5_chain_angle(外部组件)
ESPHome 版本要求 大于 2026.9.0

2. 组件说明

外部组件引入

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

方向选择

根据扩展传感器连接在 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 …)。
  • 左右两侧分别独立编号。
  • 可参考上图确定正确的顺序。

配置示例

  • 配置主机 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_angle]
    refresh: 0s
  • 添加 Chain Angle
m5_chain_angle:
  id: chain_angle
  uart_id: chain_uart_right
  chain_index: 1
  update_interval: 250ms

根据 Chain 的实际位置,给定正确的 index(索引)

  • 添加 Chain Angle ADC 传感器
sensor:
  - platform: m5_chain_angle
    m5_chain_angle_id: chain_angle
    type: adc_12
    name: Chain Angle ADC 12
  - platform: m5_chain_angle
    m5_chain_angle_id: chain_angle
    type: adc_8
    name: Chain Angle ADC 8
  • 添加 Chain Angle RGB 灯
output:
  - platform: m5_chain_angle
    id: chain_angle_red
    m5_chain_angle_id: chain_angle
    channel: rgb_red
  - platform: m5_chain_angle
    id: chain_angle_green
    m5_chain_angle_id: chain_angle
    channel: rgb_green
  - platform: m5_chain_angle
    id: chain_angle_blue
    m5_chain_angle_id: chain_angle
    channel: rgb_blue

light:
  - platform: rgb
    name: "Chain Angle Light"
    red: chain_angle_red
    green: chain_angle_green
    blue: chain_angle_blue

3. 参考案例

Chain Angle 扩展模块接入后,可在设备页面查看对应的 Sensor、 Light 实体:

Dashboard 卡片案例

Page Tools
PDF
On This Page