pdf-icon

Unit ToF Home Assistant Integration

Unit ToF is a high-precision laser distance measurement unit. It features an integrated VL53L0X laser distance sensor that uses Time-of-Flight (ToF) technology to accurately calculate distance by measuring the round-trip time of laser light, and is not affected by target reflectivity.

Note
Since Unit ToF is only a standalone sensor module, it requires an additional master device (such as Atom series, Stamp series, Stick series, Core/Basic series, etc.) to integrate with Home Assistant

VL53L0X is supported by default in ESPHome, making it convenient to integrate with Home Assistant

You can also refer to ESPHome to check the latest configuration

Configuring the Sensor

You need to enable the I²C component in your ESPHome configuration:

# Example configuration entry for ESP32
i2c:
  sda: GPIOXX
  scl: GPIOXX
  scan: true

The GPIO pins here will vary depending on the master device used. For example, using Atom Lite as the master:

# I2C Bus on Grove Port (HY2.0-4P)
i2c:
  sda: GPIO26
  scl: GPIO32

Example configuration for Unit ToF

yaml
1 2 3 4 5 6
sensor:
  - platform: vl53l0x
    name: "VL53L0x Distance"
    address: 0x29
    update_interval: 60s
    long_range: true

After saving the configuration file, compile and upload the firmware, then you can add the device to your Home Assistant integration

On This Page