Chain ToF ESPHomeコンポーネント

Chain ToFは、M5Stack Chainシリーズのレーザー測距センサーノードです。VL53L0Cレーザー測距モジュールを内蔵し、3~200cmの測距範囲、測定精度±3%に対応しており、短距離の非接触測距や物体の接近検出などの用途に適しています。

注意
Chainシリーズのノードを使用するには、UART通信と制御に対応したホストが必要です。例えば、Chain DualKey ホスト、または Atomic ToChain Base と組み合わせたAtomシリーズデバイスなどです。

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エンティティを確認できます。

ダッシュボードカードの例

Page Tools
PDF
On This Page