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

Chain Key ESPHome 组件

Chain Key 是 M5Stack Chain 系列中的一款 单按键输入节点。按键采用热插拔机械键盘按键设计,搭配强段落感青轴轴体,同时集成可编程 RGB LED。 适用于人机交互,智能家居控制等应用场景。

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

1. 组件简介

项目 信息
扩展模块 Chain Key(U206)
主要功能 提供按键功能
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_base, m5_chain_key(外部组件)
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_key]
    refresh: 0s
  • 添加 Chain Key
m5_chain_key:
  id: chain_key
  uart_id: chain_uart_right
  chain_index: 1
  update_interval: 50ms
注意
根据 Chain 的实际位置,给定正确的 index(索引)
  • 添加 Chain Key 二元传感器
binary_sensor:
  - platform: m5_chain_key
    m5_chain_key_id: chain_key
    name: Chain Key
  • 添加 Chain Key RGB 灯
output:
  - platform: m5_chain_key
    id: chain_key_red
    m5_chain_key_id: chain_key
    channel: rgb_red
  - platform: m5_chain_key
    id: chain_key_green
    m5_chain_key_id: chain_key
    channel: rgb_green
  - platform: m5_chain_key
    id: chain_key_blue
    m5_chain_key_id: chain_key
    channel: rgb_blue

light:
  - platform: rgb
    name: "Chain Key Light"
    red: chain_key_red
    green: chain_key_green
    blue: chain_key_blue

3. 参考案例

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

Dashboard 卡片案例

Page Tools
PDF
On This Page