HowTo: ESPEasy – Connect VL53L0X / VL53L1X distance sensor to the ESP8266 / ESP32 and read its data

The VL53L0x or its sister / brother, the VL53L1X is a very precise and relatively inexpensive laser distance sensor. With this, distances can be measured almost at millimeter-accuracy.

In one of my other projects (see ESPEasy – level sensor with VL53L0X / VL53L1X) I am already using this sensor to, for example, monitor the level of a rain barrel.

Like many others, this sensor can be integrated into ESPEasy easily.

How to configure your ESPEasy so that it can read out the VL53L0X / VL53L1X is described in the following article.

Safety instructions

I know the following hints are always a bit annoying and seem unnecessary. But unfortunately, many people who knew it "better" from carelessness lost their eyes, fingers or other things or hurt themselves. In comparison, a loss of data is almost not worth mentioning, but even these can be really annoying. Therefore, please take five minutes to read the safety instructions. Even the coolest project is worth no injury or other annoyance.

Affiliate links / advertising links

The links to online shops listed here are so-called affiliate links. If you click on such an affiliate link and shop via this link, receives a commission from the online shop or provider concerned. The price doesn't change for you. If you do your purchases via these links, you will support in being able to offer further useful projects in the future. 🙂


Helpful Articles:
You can find additional tips on ESPEasy in the following articles.

Required tools:

Required material:

Connect the VL53L0X / VL53L1X to the ESP8266

The VL53L0X / VL53L1X is connected to the ESP8266 or Wemos D1 Mini via the I2C bus.

If the I2C bus is configured as standard, you can use the shown circuit diagram.

Konfiguration des VL53L0X / VL53L1X in ESPEasy

So that the VL53L0X / VL53L1X can be configured in ESPEasy, the ESPEasy firmware should already be installed on the ESP8266 and accessible. You can find information about this in the article ESPEasy – Compiling, flashing and configuring WLAN access data.

First open the configuration website of your ESP8266 programmed with ESPEasy by entering its IP address in your web browser. Information on how to find out the IP address is also summarized in the article Displaying / Finding out the IP address of the devices in the network.

As soon as you have opened the configuration website, you have to switch to the “Devices” tab. To do this, click on the “Devices” button.

In the “Devices” tab you now have to click the “Add” button in one of the empty lines.

You will then be automatically redirected to the view shown and can select here which device you want to create.

Select the entry “Distance – VL53L0X [TESTING]”.

This will redirect you to an overview page.

Here you can make all settings regarding the VL53L0X.

If you have used the circuit diagram shown above, you can use the shown settings.

If you use a different I2C address on your sensor, you can adjust it under “I2C Address”.

With the “Range” option you can set the range of the sensor. Here you can achieve a little more range, but this also reduces the accuracy a little. You can find information on this in the data sheet of the VL53L0X / VL53L1X.

After you have made all the settings, you can confirm the settings by clicking on “Submit”.

Display the measured values of the VL53L0X / VL53L1X

After you have configured the VL53L0X / VL53L1X you can test it easily.

In the overview of the configured devices, the measured values can be seen in the line of the VL53L0X / VL53L1X on the right-hand side.

These are updated every 60 seconds at the latest. This interval can be set in the configuration of the VL53L0X / VL53L1X in the “Interval” section.

Send sensor data via MQTT

You can now also send the collected sensor data to your SmartHome via MQTT and process it there if necessary. What you have to configure is described in the following article.

Additional sensors for connection to the ESP8266 / ESP32

You can find an overview of other articles for connecting sensors and actuators to ESPEasy in the following category.

I hope everything worked as described. If not or you have any other questions or suggestions, please let me know in the comments. Also, ideas for new projects are always welcome. 🙂


P.S. Many of these projects - especially the hardware projects - cost a lot of time and money. Of course I do this because I enjoy it, but if you appreciate it that I share these information with you, I would be happy about a small donation to the coffee box. 🙂

Buy Me a Coffee at


  1. Hallo,

    Ich habe Ihre Firmware heruntergeladen, die auf einem wemos D1 mini mit einem VL53L1X-Sensor der Marke CQrobot installiert ist, aber der Sensor sendet keine Daten, aber die I2c-Adresse ist korrekt.
    Ich habe eine andere Marke zum erneuten Testen bestellt. Alle Verbindungen wurden mehrmals überprüft

    1. Hi Doryphore,
      kannst du mal mit dem I2C-Scanner unter Tools prüfen ob der Sensor auch gefunden wird? 🙂
      Beste Grüße

  2. Hallo,

    Hier ist das Ergebnis des Scans, leider erscheint der VL53L1X nicht
    Beim Versuch mit einer anderen Firmware wurde es angezeigt:
    (Es tut mir leid, wenn meine Nachrichten dupliziert werden. Jedes Mal, wenn ich etwas poste, erhalte ich eine Captcha-Fehlermeldung : “…Error: You have entered an incorrect reCAPTCHA value.
    Click the BACK button on your browser and try again….”)

    1. Hallo Doryphore,
      das ist seltsam. Ich werde mal versuchen das ganze nachzustellen. Dann kann ich besser nachvollziehen was da ggf. schief gelaufen ist. 🙂
      Beste Grüße

  3. Hallo,

    Es ist nett von dir, weil ich mit diesem Sensor festgefahren bin und ihn gerne mit Espeasy verwenden würde. Ich habe es mit einem VL53L1X-Sensor einer anderen Marke versucht: Das gleiche Ergebnis beim I2c-Scan, der Sensor wird nicht angezeigt. Offensichtlich habe ich die I2c-Verbindungen in SDA und SDL in D1 und D2 des wemos d1 mini mehrmals überprüft.


Leave a Reply

Your email address will not be published. Required fields are marked *