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

Chain ToF ESPHome 组件

Chain ToF 是 M5Stack Chain 系列中的一款激光测距传感器节点。设备内置 VL53L0C 激光测距模块,支持 3 ~ 200cm 测距范围,测量精度 ±3%,适用于短距离的隔空测距,或是物体接近检测等功能应用。

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

1. 组件简介

项目 信息
扩展模块 Chain ToF (U209)
主要功能 提供距离检测信息
通信接口 Chain Bus / UART
ESPHome 组件 m5_chain_base, m5_chain_tof(外部组件)
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_tof]
    refresh: 0s
  • 添加 Chain ToF
m5_chain_tof:
  id: chain_tof
  uart_id: chain_uart_right
  chain_index: 1
  update_interval: 250ms

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

  • 添加 Chain ToF 距离传感器
sensor:
  - platform: m5_chain_tof
    m5_chain_tof_id: chain_tof
    name: "Chain ToF Distance"
  • 添加 Chain ToF RGB 灯
output:
  - platform: m5_chain_tof
    id: chain_tof_red
    m5_chain_tof_id: chain_tof
    channel: rgb_red
  - platform: m5_chain_tof
    id: chain_tof_green
    m5_chain_tof_id: chain_tof
    channel: rgb_green
  - platform: m5_chain_tof
    id: chain_tof_blue
    m5_chain_tof_id: chain_tof
    channel: rgb_blue

light:
  - platform: rgb
    name: Chain ToF RGB
    red: chain_tof_red
    green: chain_tof_green
    blue: chain_tof_blue

3.参考案例

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

Dashboard 卡片案例

Page Tools
PDF
On This Page