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

Chain Switch ESPHome 组件

Chain Switch 是 M5Stack Chain 系列中的一款滑动开关输入节点,支持滑动条模式与开关模式。设备可输出 12 位滑动位置数据,并配有可编程 RGB LED,用于提供直观的状态反馈。

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

1. 组件简介

项目 信息
扩展模块 Chain Switch(U227)
主要功能 提供可滑动开关输入
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_base, m5_chain_switch(外部组件)
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_switch]
    refresh: 0s
  • 添加 Chain Switch
m5_chain_switch:
  id: chain_switch
  uart_id: chain_uart_right
  chain_index: 1
  update_interval: 250ms
注意
根据 Chain 的实际位置,给定正确的 index(索引)
  • 添加 Chain Switch 传感器
sensor:
  - platform: m5_chain_switch
    m5_chain_switch_id: chain_switch
    id: chain_switch_adc
    name: "Chain Switch ADC"
    type: adc_12

  - platform: m5_chain_switch
    m5_chain_switch_id: chain_switch
    name: "Chain Switch ADC 8bit"
    type: adc_8

binary_sensor:
  - platform: m5_chain_switch
    m5_chain_switch_id: chain_switch
    name: "Chain Switch Status"
  • 添加 Chain Switch 灯光
output:
  - platform: m5_chain_switch
    id: chain_switch_red
    m5_chain_switch_id: chain_switch
    channel: rgb_red
  - platform: m5_chain_switch
    id: chain_switch_green
    m5_chain_switch_id: chain_switch
    channel: rgb_green
  - platform: m5_chain_switch
    id: chain_switch_blue
    m5_chain_switch_id: chain_switch
    channel: rgb_blue

light:
  - platform: rgb
    name: "Chain Switch Light"
    red: chain_switch_red
    green: chain_switch_green
    blue: chain_switch_blue

3.参考案例

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

Dashboard 卡片案例

Page Tools
PDF
On This Page