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

Chain RGB ESPHome 组件

Chain RGB 是 M5Stack Chain 系列 LED 显示节点,搭载 8×8 RGB LED 点阵单元。设备支持单像素独立控制、批量像素写入与整屏缓冲区快速刷新,内置 ASCII 字符绘制取模、字符串滚动、亮度调节、多角度画面旋转等功能,可实现多样动态灯光与像素动画效果,适用于像素灯光创作、桌面氛围灯、创意灯光标识、智能设备灯光提示等场景。

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

1. 组件简介

项目 信息
扩展模块 Chain RGB (U218)
主要功能 提供 RGB 矩阵灯光显示
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_base, m5_chain_rgb(外部组件)
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_rgb]
    refresh: 0s
  • 添加 Chain RGB 节点
m5_chain_rgb:
  id: chain_rgb
  uart_id: chain_uart_right
  chain_index: 1
注意
根据 Chain 的实际位置,给定正确的 index(索引)
  • 添加 Chain RGB 灯光节点
light:
  - platform: m5_chain_rgb
    id: chain_rgb_light
    name: "Chain RGB Matrix"
    m5_chain_rgb_id: chain_rgb
    restore_mode: RESTORE_DEFAULT_ON
    effects:
      # width 8 spans one full hue cycle per row of the 8x8 panel.
      - addressable_rainbow:
          name: "Rainbow"
          speed: 10
          width: 8

可以通过 effects 为灯光添加各种特效,比如上面就添加了一个流动彩虹特效

  • 还可通过添加显示节点,可以让 Chain RGB 显示内容
font:
  - file: "./assets/fonts/unscii-8.ttf"
    id: chain_rgb_font
    size: 8
    bpp: 1
    glyphs: "A"

display:
  - platform: addressable_light
    id: chain_rgb_display
    addressable_light_id: chain_rgb_light
    width: 8
    height: 8
    update_interval: 1s
    lambda: |-
      it.print(0, 0, id(chain_rgb_font), Color(255, 0, 0), "A");

以上内容会使用本地的字体,在 Chain RGB 上绘制一个红色字符 'A'

注意
同一时间灯光特效和显示只有一个生效

3.参考案例

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

Page Tools
PDF
On This Page