Labs / Electronic modules

GraftSense: A VL53L1X-Based Laser Ranging Sensor Module (Open Version)

Author: Li Zisheng · Source: FreakStudio open documentation, v1.1 · License: CC BY 4.0 · Driver code (sensors/vl53l1x_driver): MIT License

Contents
VL53L1X 4 50cm 3.3V I2C 2.7 5.5V
VL53L1X LED1 R1 R5 C1 C5 VL53L1X-Based V1.0.0

I. Module Introduction

VL53L1X-based laser ranging sensor module that adopts the VL53L1X Time-of-Flight (ToF) ranging chip solution, which can realize non-contact distance detection with millimeter-level accuracy, supports distance measurement from 4 to 50 cm and directly outputs digital distance values; the module is equipped with LDO voltage regulator circuit, power filtering and indicator circuit, powered by 3.3V, communicates with the main controller via the I2C interface, has an operating voltage of 2.7~5.5V, features better stability than traditional infrared sensors, and is suitable for scenarios such as robot obstacle avoidance, distance detection, and gesture recognition.

II. Introduction to Main Chips

VL53L1X is a miniature FlightSense technology-based ToF laser ranging sensor from STMicroelectronics, integrating a 940nm laser, a SPAD array and an I²C interface. It features a ranging distance of up to 4 meters, a frame rate of 50Hz, programmable ROI, and dimensions of 4.9×2.5×1.56mm.

2.1 Chip Overview

VL53L1X 940nm 1 4 50Hz 60825-1 2014 3rd
VL53L1X 940nm 4 50Hz I2C 400kHz

VL53L1X is a new-generation FlightSense technology-based ToF laser ranging sensor launched by STMicroelectronics, which integrates a 940nm Class 1 laser emitter, a SPAD receiving array and a microcontroller. It features a maximum ranging distance of 4 meters, a frame rate up to 50Hz, supports programmable FOV adjustment and multi-region operation, with the I2C interface supporting a maximum speed of 400kHz. It is compatible with a variety of embedded systems and is widely used in device sensing, robot obstacle avoidance, drones, smart shelves and other scenarios.

2.2 Pin Definition

VL53L1X 1 2 3 4 GND2 5 6 GND3 7

VL53L1X features 12 pins, among which AVDD and AVDDVCSEL are power supply pins;AVSSVCSEL, GND, and GND2 /3/4 are ground pins;SDA / SCL serve as the I²C communication interface;GPIO1 functions as an open-drain interrupt output;XSHUT is an active-low shutdown control pin, and Pin 8 (DNC) must be left floating.

2.3 Functional Block Diagram

VL53L1X GPIO1 940nm

VL53L1X operates based on the time-of-flight (ToF) principle: the VCSEL driver circuit emits 940nm infrared laser, the reflected light from the target is received by a single-photon avalanche diode (SPAD) array, the built-in ranging core and microcontroller calculate the round-trip time of the light to convert it into distance data, and the result is finally output via the I²C interface (SDA / SCL). The XSHUT pin can control the module to enter sleep mode, GPIO1 can output interrupt signals, and the power supply and ground pins provide stable power for the chip and the laser emission section.

2.4 Performance Parameters

VL53L1X LGA12 4.4 2.5 1.56 2.6 3.5 20 85 15

VL53L1X adopts the LGA12 package, measures 4.4×2.5×1.56mm in dimensions, operates at a voltage of 2.6–3.5V and a temperature range of -20 to 85°C, integrates a 940nm infrared emitter, features a receive field of view programmable between 15–27°, supports I²C communication up to 400kHz, and has a default address of 0x52.

VL53L1X 5.1 40 105 5.2 20 85

VL53L1X has a storage temperature range of -40 to 105°C and a recommended operating temperature range of -20 to 85°C. Exceeding the limit values may cause permanent damage, and long-term operation under extreme conditions will also affect the reliability of the device.

VL53L1X 0.5 3.6V 2.6 3.5V 1.6 1.9V 2V8

AVDD and I/O pins have an absolute maximum voltage range of -0.5V to 3.6V, and the recommended supply voltage for AVDD is 2.6–3.5V;IOVDD supports selectable modes including the standard mode (1.6–1.9V) and 2V8 mode (2.6–3.5V). Meanwhile, the device complies with ESD protection standards of ±2kV (Human Body Model) and ±500V (Charged Device Model).

15 16 10Hz 1Hz GPIO1

VL53L1X has a typical hardware standby current of 5μA, a typical average current of 16mA in ranging mode, and a peak current up to 40mA;GPIO1 and I²C interface parameters including high/low level and leakage current are all specified;I²C has a minimum high-level input voltage of 1.12V;GPIO1 supports a maximum output frequency up to 108MHz.

2.5 Reference Circuit

VL53L1X 100nF 4.7 10k GPIO1 4

VL53L1X in its typical application circuit, AVDD and AVDDVCSEL power supply terminals require 100nF and 4.7μF capacitors connected in parallel nearby for filtering;SDA / SCL are connected to the host I²C bus, with corresponding pull-up resistors (0.8k~3.6kΩ) selected according to the load capacitance;XSHUT pin controls the module's sleep mode via a 10kΩ pull-up resistor;GPIO1 can be used as an interrupt output and left floating when unused, and all ground pins must be connected to the system ground.

2.6 Chip Configuration

None.

VL53L1X 11 12 0x52

VL53L1X communicates via the I²C interface. The SDA / SCL lines require pull-up resistors on the host side, with a maximum rate of 400kHz. The default device address is 0x52 (the least significant bit is 0/1 for write/read operations respectively, corresponding to addresses 0x52 / 0x53). Its communication follows the standard I²C protocol: it starts with a start condition, ends with a stop condition, data transmission comes with acknowledge bits, and the byte following the address is used to specify the internal register address.

VL53L1X 13 14 15 0x52 0x53

VL53L1X I²C read and write operations follow the standard protocol: a write operation starts at address 0x52, sends the 16-bit register index and data bytes in sequence, with an acknowledgment after each byte; for a read operation, the index must first be sent in write mode, then the read process is initiated at address 0x53 to read data; it also supports a continuous write mode with automatic address increment, which enables batch data transmission to improve communication efficiency.

VL53L1X 0x52 16 0x53

VL53L1X 's I²C interface supports the Fast Mode of up to 400kHz. Its timing characteristics specify parameters such as the high and low level widths of the clock, setup/hold time, rise/fall time, etc. It also supports continuous read operation with automatic address increment, enabling batch reading of data from multiple registers.

VL53L1X t0 32 400kHz

VL53L1X 's I²C Sequence Diagram defines key timing parameters such as the setup time, hold time, and high/low levels of SDA / SCL, and also provides reference registers including Model ID and Module type for interface verification. Multi-byte read and write operations are transmitted in ascending order of addresses with the high-order bit first, and the complete register details can be obtained from the official API driver manual.

2.8 PCB Routing Precautions

None.

III. Circuit Engineering

3.1 Circuit Source Engineering

To obtain the source code of the circuit, please follow the official account [Freak Embedded]

3.2 Module Usage Instructions

The schematic diagram of this module is shown below:

SCH_Schematic1_VL53L1X-based laser ranging sensor module_v1.0.0_2026-05-08.pdf 2.2 MB

VL53L1X LED1 R5 C2 U3 C1 C5 C4 I2C

This module provides an IIC communication interface: it supports standard I2C communication rates, is compatible with 3.3V logic levels, and can stably transmit the millimeter-level laser ranging digital signals collected by VL53L1X. Suitable for scenarios such as robot obstacle avoidance, distance detection, and gesture recognition, it provides the system with reliable, high-precision, non-contact distance sensing data interaction capabilities.

3.3 Application Experiment

Here, we use the GraftPort-RP2040 development board for testing, and the VL53L1X-based laser ranging sensor module uses the I2C interface to communicate with the main controller.

Here, we first use the HY2.0-4P connection cable to connect the module to the GraftPort-RP2040 development board's I2C0 interface:

development board pins

Module Pins

Description

Pin 4

SDA

I2C data transmission line, corresponding to I2C0 's SDA

Pin 5

SCL

I2C clock signal line, corresponding to the I2C0 SCL

Here, we need to search for the relevant driver packages on uPyPI: https://upypi.net/zh/

106

Enter vl53l1x_driver to search, and the following will be displayed:

vl53l1x 1.0.8 VL53L1X

Click to copy the local installation command:

vl53l1x_driver 1.0.0 VL53L1X

Import the module driver library code via the mip tool. Below are the usage commands for the mpremote tool:

mpremote mip install https://upypi.net/pkgs/vl53l1x_driver/1.0.0

Import the MicroPython driver code for the VL53L1X-based laser ranging sensor module, then copy the following main.py code into our project:

# Python env   : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time    : 2026/05/06 07:00
# @Author  : FreakStudio
# @File    : main.py
# @Description : Code to test the VL53L1X laser ranging sensor driver class
# @License : MIT

# ======================================== Import Modules =========================================

import time
from machine import Pin, SoftI2C
from vl53l1x import VL53L1X

# ======================================== Global Variables ============================================

TARGET_SENSOR_ADDRS = [0x29]
I2C_SCL_PIN = 5
I2C_SDA_PIN = 4
I2C_FREQ = 400_000

# ======================================== Functions ============================================

# ======================================== Custom Classes ============================================

# ======================================== Initialization ==========================================

time.sleep(3)
print("FreakStudio: Using VL53L1X ToF distance sensor ...")

# Initialize the software I2C bus
i2c_bus = SoftI2C(sda=Pin(I2C_SDA_PIN), scl=Pin(I2C_SCL_PIN), freq=I2C_FREQ)

# Scan for devices on the I2C bus
devices_list = i2c_bus.scan()
print("START I2C SCANNER")
if len(devices_list) == 0:
    raise RuntimeError("I2C scan found no devices")
print("I2C devices found: %d" % len(devices_list))

# Iterate over the scan results and initialize the target sensor
sensor = None
for device in devices_list:
    if device in TARGET_SENSOR_ADDRS:
        print("I2C address: %s" % hex(device))
        sensor = VL53L1X(i2c=i2c_bus, address=device)
        print("Sensor initialization successful")
        break

if sensor is None:
    raise RuntimeError("No target sensor found on I2C bus")

# ========================================  Main Program  ===========================================

try:
    while True:
        distance_mm = sensor.read()
        print("Range: %d mm" % distance_mm)
        time.sleep_ms(50)

except KeyboardInterrupt:
    print("Program interrupted by user")
except OSError as e:
    print("Hardware communication error: %s" % str(e))
except Exception as e:
    print("Unknown error: %s" % str(e))
finally:
    print("Cleaning up resources...")
    sensor.deinit()
    del sensor
    print("Program exited")

Burn the code, open the terminal, and the output is as follows:

VL53L1X I2C 1 0x29 80mm 200mm

The VL53L1X TOF distance sensor features normal I2C communication and initialization, stably outputs distance data that updates in real time as the object moves closer or farther, delivers sensitive response, and works in proper condition.

IV. Drivers

vl53l1x_driver-1.0.0.zip 10 KB

None.

VI. Revision History

Document Version

Date of Revision

Modifier

Modify Content

v1.0

2026-05-08

Zero High-Luck

Initialize the document

v1.1

2026-06-06

Xin Ruili

Create an open version of the document based on the internal document version v1.0.

VII. Relevant Materials

7.1 Chip Datasheet

vl53l1x.pdf 3.1 MB

7.2 Unique Icons for PCB Silk Screen

VL53L1X