VL53L0X Time Of Flight Distance Sensor


This page is incomplete and could some work. If you want to contribute, please read the contributing guide. This page is missing:

  • An image for the front page.
  • Images/screenshots/example configs of this device being used in action.

The vl53l0x sensor platform allows you to use VL53L0X optical time of flight (datasheet, ST) with ESPHome to measure distances. The sensor works optically by emitting short infrared pulses and measuring the time it takes the light to be reflected back

The sensor can measure distances up to 2 meters, though that figure depends significantly on several conditions like surface reflectance, field of view, temperature etc. In general you can expect surfaces up to 60cm to work, after that you need to make sure the surface is reflecting well enough (see also section 5 of datasheet).

The I²C Bus is required to be set up in your configuration for this sensor to work.

# Example configuration entry
  - platform: vl53l0x
    name: "VL53L0x Distance"
    address: 0x29
    update_interval: 60s

Configuration variables:

  • name (Required, string): The name of the sensor.
  • update_interval (Optional, Time): The interval to check the sensor. Defaults to 60s.
  • signal_rate_limit (Optional, float): Set the return signal rate limit in units of MCPS (mega counts per second). This is the minimum signal amplitude detected by the sensor necessary for it to report a valid reading. Setting a lower value may increase the range of the sensor but also increases the chance of getting inaccurate readings. Defaults to 0.25.
  • All other options from Sensor.
  • address (Optional, int): Manually specify the i^2c address of the sensor. Defaults to 0x29.
  • id (Optional, ID): Manually specify the ID used for code generation.