VL53L0X Time-of-Flight Sensor with ESP32 and Arduino

What is VL53L0X and how is it different from ultrasonic sensor?

The VL53L0X is a single-circuit distance sensor from STMicroelectronics. Wavelength invisible infrared VCSEL transmitter 940nm sends and the SPAD array receives the returning photons. The internal circuit reports the absolute distance in millimeters by measuring the time of flight of light; Therefore, the output is not obtained only from the light reflection intensity.

Collision avoidance robot, presence detection, hand approach control, line-of-sight compatible tank level measurement, and pass counting are common applications. Field of view of the system according to the datasheet 25 degrees is So the object must cover a sufficient part of this cone. The measurement result depends on the distance, surface reflectance, ambient infrared light, coating on the sensor and API settings.

Appropriate and inappropriate uses

How to read the VL53L0X datasheet correctly?

The number "up to 2 meters" on the product page is a ceiling capability under the right conditions, not a guarantee for every purpose and every light. Table 12 of the data sheet, without cover glass, in 23°C and 2.8V And with a time budget 33ms is written For an 88% indoor white target, a typical value with the Long Range profile is over 200 cm; But at least the same row is 120 cm. For a 17% gray target in defined open space, a typical value is 50 and a minimum of 40 cm.

In the accuracy table, read the test conditions along with the number. For example, a gray target outdoors at a distance of 40cm with a budget of 33ms has a dispersion of 12%; Increasing the budget to 66ms in the same row brings the value to 9%. These numbers should not be generalized to all surfaces and lights.

The difference between the raw VL53L0X chip and the ready module

limit 2.6 to 3.5V It is related to the raw chip. The Adafruit board pictured has a regulator and level shifter, and according to its manual, it uses a 3-5V power supply and logic. Unknown modules may not have the same circuit; Before connecting 5V, check the schematic and part number of the same module.

In the raw chip design, ST capacitors 100nF and 4.7µF shows near nutrition. For a 400kHz bus and an AVDD of 2.8V, a typical pull-up of 1.5 to 2 kOhms is suggested, but the final value should be calculated with the total bus capacity and host specifications. GPIO1 is open-drain output and XSHUT is active-low input.

Bases and difference of address 0x52 with 0x29

The ST datasheet writes the default address as 0x52; This eight-bit representation includes the Read/Write bit. Arduino libraries and scanners require a seven-bit address, so the correct value is 0x29. Because 0x29 << 1 = 0x52, these two numbers do not contradict.

Wiring the VL53L0X with ESP32 and Arduino Uno

GPIO21 and GPIO22 are just common choices for Generic ESP32; Refer to the SDA/SCL label or manufacturer's documentation on other boards. If the board has a ready pull-up, the additional parallel resistance can make the effective resistance too low. First test with a short wire and a 100kHz clock.

API, measurement modes and why we don't guess about registers

Unlike some sensors, the VL53L0X datasheet does not provide a simple table for manually setting up all the registers. ST in the UM2039 explicitly introduces a high-level API as a solution to manage multiple registry accesses and calibration within the driver layer. Therefore, in this project, we use a library that contains the official ST API, and we do not write any test or guess register addresses.

The sensor has Single, Continuous and Continuous Timed modes. In the simple project, we use the library's single-measurement call so that the error handling is transparent. For fast sampling, select Continuous with data readiness checks and rate limiting.

Step-by-step setup in Arduino IDE

1. Select the correct ESP32 or Arduino board and port.
2. In the Library Manager, install the Adafruit VL53L0X library and its recommended dependencies.
3. Do the I2C and common ground wiring and check the allowable voltage of the same module.
4. First run the i2c-scanner.ino file inside the package; The seven-bit address 0x29 should be seen.
5. Upload the original code and turn on Serial Monitor 115200 baud open
6. Start with an opaque white target at a known distance and then test the surface and actual lighting of the project.

VL53L0X practical code for ESP32 and Arduino

#include <Wire.h>
#include <Adafruit_VL53L0X.h>

#if defined(ESP32)
constexpr int SDA_PIN = 21;  // Generic ESP32 only
constexpr int SCL_PIN = 22;  // Generic ESP32 only
#endif

constexpr uint8_t VL53L0X_ADDRESS = 0x29;
Adafruit_VL53L0X sensor;

void setup() {
  Serial.begin(115200);

#if defined(ESP32)
  Wire.begin(SDA_PIN, SCL_PIN);
#else
  Wire.begin();
#endif
  Wire.setClock(100000);

  if (!sensor.begin(VL53L0X_ADDRESS, false, &Wire)) {
    Serial.println(F("VL53L0X not found; check power, wiring and 0x29"));
    while (true) delay(10);
  }
}

void loop() {
  VL53L0X_RangingMeasurementData_t measurement;
  sensor.rangingTest(&measurement, false);

  if (measurement.RangeStatus == 0) {
    Serial.print(F("Distance: "));
    Serial.print(measurement.RangeMilliMeter);
    Serial.println(F(" mm"));
  } else {
    Serial.print(F("Invalid measurement; RangeStatus="));
    Serial.println(measurement.RangeStatus);
  }

  delay(100);
}

Code analysis

• The condition #if defined(ESP32) on the ESP32 sets the example pins explicitly, and on the Uno it uses Wire hardware pins.
• Wire.setClock(100000) selects a conservative 100kHz clock; This value is less than the ceiling of 400kHz datasheet.
• sensor.begin(0x29, false, &Wire) gives the seven-bit address and the same I2C bus to the library.
• rangingTest performs a full API measurement and puts the result into a formal structure.
• Only valid RangeStatus == 0 will be printed. The official ST UM2046 defines the zero state as Range Valid; The space number in invalid state should not be entered into the robot control.

VL53L0X common errors and troubleshooting

PCB design tips and mechanical installation

• Do not cover the optical transmitter and receiver with frame, glue, flux or dust and remove the carrying case before testing.
• If you have a protective window, design the geometry according to AN5231 and calibrate the offset and cross-talk for the final product.
• According to the datasheet, XSHUT is only high when AVDD is connected. If the host is unknown at startup, consider pull-up.
• GPIO1 can remain open when not in use; If used, pay attention to the nature of open-drain and pull-up.
• The target object must cover the field of view sufficiently; A frame edge or angled glossy surface may create unwanted reflections.
• Calibrate on the final board and frame, not just the open module on the table.
• For robot safety control, don't assume the invalid state is "too far"; Consider it a separate error or safe mode.

conclusion

The VL53L0X performs best when considering I2C address, RangeStatus, field of view, ambient light and mechanical calibration simultaneously. For the prototype, the Adafruit board and official library provide a simple path; For the final product, the power limit of the raw chip, the current peak, the guard window and the test on the actual target are decisive.

Frequently asked questions

Detailed sources and follow-up

• ST Official Datasheet, VL53L0X, DS11555 Rev.6
• Official API Manual, UM2039 Document Rev.2.0
• Official AN5231 Application Note for the window protector
• VL53L0X official product page
• Adafruit VL53L0X Board Official Guide
• Official BSD-licensed Adafruit VL53L0X library
• Photo credit, Kattni Rembor, license CC BY-SA 3.0
• Learning BMP280 with ESP32 and Arduino
• Free course of sensors in 7 steps
• distance and level training category
• Sensors Learning Center at LCENJ

Raw chip specifications are derived from DS11555 Rev.6 and API behavior is derived from UM2039 Rev.2.0. The 3-5V specification only applies to the Adafruit documentation board. No unsourced registers, circuits, or functional values ​​are included in the article.