VL53L0X и Arduino: лазерный датчик расстояния с дальностью до 2 м
Как подключить лазерный датчик расстояния VL53L0X к Arduino, ESP32 и Pico? Подключение по I2C, профили измерения, несколько датчиков с XSHUT и сравнение с HC-SR04.
VL53L0X — это ToF-датчик (Time of Flight, время пролёта), лазерный датчик расстояния и один из самых маленьких и точных способов измерять расстояние с Arduino. Микросхема производства STMicroelectronics посылает невидимый лазерный импульс 940 нм, измеряет, сколько времени свет летит до цели и обратно, и выдаёт результат сразу в миллиметрах. Модуль размером с почтовую марку подключается всего двумя проводами данных I2C; в режиме по умолчанию он измеряет примерно до 1,2 метра, а в режиме дальнего действия — до 2 метров.
В этом руководстве ты пошагово разберёшься, как работает VL53L0X, как подключить его к Arduino Uno, ESP32 и Raspberry Pi Pico, чем отличаются четыре профиля измерения и как поставить несколько датчиков на одну шину I2C с помощью пина XSHUT. Ещё мы сравним его с популярным ультразвуковым датчиком расстояния HC-SR04 и посмотрим, какой из них лучше подходит для какого проекта.
Что такое VL53L0X и как он работает?
Внутри датчика две основные части: VCSEL (лазер с вертикальным резонатором и излучающей поверхностью), который излучает свет, и матрица SPAD (однофотонных лавинных диодов), способная уловить даже один фотон. VCSEL посылает очень короткие световые импульсы, матрица SPAD ловит вернувшиеся фотоны, а микросхема измеряет время между ними. Расстояние находится по простой формуле: d = c × t / 2. Здесь c — скорость света (около 300 000 км/с), а поскольку свет проходит путь дважды, результат делится на два. Для предмета на расстоянии 1 метра путь туда и обратно занимает всего 6,67 наносекунды. Измерить такое короткое время одним импульсом почти невозможно, поэтому микросхема собирает статистику по тысячам импульсов и делает расчёт внутри себя; тебе остаётся только прочитать готовый результат.
Лазер относится к классу 1, поэтому при обычном использовании он не опасен для глаз, а так как он инфракрасный, его не видно. Угол обзора датчика около 25 градусов, то есть измерение идёт внутри узкого конуса. Благодаря этому прицеливаться намного проще, чем с широкой звуковой волной HC-SR04: можно измерить маленький предмет на краю стола и не зацепить стену рядом. Поскольку результат зависит от скорости света, температура и влажность воздуха на него почти не влияют.
| Характеристика | Значение |
|---|---|
| Микросхема | STMicroelectronics VL53L0X |
| Принцип измерения | Время пролёта (ToF), лазер VCSEL 940 нм, класс 1 |
| Дальность | Около 3 см – 1,2 м (по умолчанию), до 2 м (режим дальнего действия, тёмное помещение, белая цель) |
| Разрешение | 1 мм |
| Точность | Около ±3% – ±5% в зависимости от режима |
| Угол обзора | Около 25° |
| Время измерения | 20 мс – 200 мс (в зависимости от бюджета времени) |
| Питание | Микросхема 2,6–3,5 V; у большинства модулей есть стабилизатор, 3,3–5 V |
| Ток | Около 19 mA при измерении, несколько µA в режиме ожидания |
| Интерфейс | I2C, до 400 kHz, адрес по умолчанию 0x29 |
| Пины | VIN, GND, SCL, SDA, GPIO1 (прерывание), XSHUT (отключение) |
VL53L0X или HC-SR04?
Оба датчика измеряют расстояние, но физика у них совершенно разная. HC-SR04 посылает звуковую волну 40 kHz и слушает эхо; звук летит со скоростью около 343 м/с, поэтому засечь время легко, а дальность достигает 4 метров. Однако широкий звуковой конус ловит и предметы сбоку, а ткань, поролон и наклонные поверхности поглощают или отклоняют звук. VL53L0X измеряет светом: он крошечный, целится в объект под узким углом, стабильнее на коротких расстояниях, а благодаря I2C много датчиков могут делить одну шину. Зато прямой солнечный свет, очень тёмные или зеркально блестящие поверхности и стекло доставляют ему проблемы. Коротко: если нужно небольшое быстрое измерение до 2 метров, выбирай VL53L0X; если нужна большая дальность и работа на улице, логичнее HC-SR04. Другие варианты есть в сравнении датчиков расстояния.
| Характеристика | VL53L0X | HC-SR04 |
|---|---|---|
| Принцип измерения | Время пролёта лазерного света (940 нм) | Ультразвуковое эхо (40 kHz) |
| Дальность | Около 3 см – 2 м | Около 2 см – 4 м |
| Конус измерения | Около 25°, узкий и чётко очерченный | Угол измерения около 15°, звук расходится шире |
| Разрешение | 1 мм | Около 3 мм (на практике ±1 см) |
| Подключение | I2C (SDA, SCL) | 2 цифровых пина (Trig, Echo) |
| Несколько датчиков | На одной шине I2C с помощью XSHUT | Отдельный пин для каждого датчика, они могут слышать эхо друг друга |
| Питание | 3,3–5 V (модуль) | 5 V |
| Размер | Около 25 × 13 мм | Около 45 × 20 мм |
| Трудные случаи | Чёрные или зеркальные поверхности, стекло, солнечный свет | Ткань, поролон, наклонные поверхности, шумная обстановка |
Подключение VL53L0X: Arduino Uno, ESP32 и Pico
Большинство модулей в продаже (например, GY-530 и GY-VL53L0XV2) несут на себе стабилизатор на 2,8 V, подтягивающие резисторы для линий I2C и подтягивающий резистор для XSHUT. Поэтому модуль можно подключать и к пину 5V на Uno, и к пину 3V3 на ESP32 и Pico. Большинство дешёвых модулей без проблем общаются с Uno; и всё же в проектах, которые будут работать долго, линии I2C можно защитить преобразователем уровней. Если интересно, как устроена шина I2C, прочитай статью Что такое I2C. GPIO1 — это выход прерывания, который сигналит об окончании измерения; для базового использования его подключать не нужно.
| Пин VL53L0X | Arduino Uno | ESP32 | Raspberry Pi Pico |
|---|---|---|---|
| VIN | 5V (или 3.3V) | 3V3 | 3V3(OUT) |
| GND | GND | GND | GND |
| SCL | A5 | GPIO 22 | GP5 |
| SDA | A4 | GPIO 21 | GP4 |
| XSHUT (необязательно) | D4 (для 2-го датчика D5) | GPIO 25 | GP6 |
| GPIO1 (необязательно) | Не подключается | Не подключается | Не подключается |
Пошагово: первое измерение с Arduino
- Подключи провода по таблице: VIN → 5V, GND → GND, SDA → A4, SCL → A5.
- Если на датчике есть жёлтая или оранжевая защитная плёнка, аккуратно сними её; плёнка полностью портит измерение.
- В Arduino IDE открой «Менеджер библиотек» (Library Manager), введи VL53L0X и установи библиотеку от Pololu. Adafruit_VL53L0X тоже работает, но она включает полный API от ST и занимает на Uno гораздо больше памяти. Если с установкой не получается, загляни в статью как добавить библиотеку в Arduino.
- Загрузи код ниже и открой монитор порта на скорости 115200 бод.
- Приближай и отводи руку от датчика и смотри, как меняются значения в миллиметрах и сантиметрах.
1#include <Wire.h>
2#include <VL53L0X.h>
3
4VL53L0X sensor;
5
6void setup() {
7 Serial.begin(115200);
8 Wire.begin(); // Uno: SDA=A4, SCL=A5
9 sensor.setTimeout(500); // 500 ms cevap bekle / wait 500 ms for a reply
10 if (!sensor.init()) {
11 Serial.println(F("VL53L0X bulunamadi / not found"));
12 while (1) {}
13 }
14 sensor.startContinuous(); // sürekli ölçüm / continuous ranging
15}
16
17void loop() {
18 uint16_t mm = sensor.readRangeContinuousMillimeters();
19 if (sensor.timeoutOccurred()) {
20 Serial.println(F("Zaman asimi / Timeout"));
21 return;
22 }
23 if (mm > 2000) { // geçerli yansıma yok / no valid return
24 Serial.println(F("Menzil disi / Out of range"));
25 } else {
26 Serial.print(mm);
27 Serial.print(F(" mm = "));
28 Serial.print(mm / 10.0, 1);
29 Serial.println(F(" cm"));
30 }
31 delay(100);
32}| Команда | Что делает |
|---|---|
| sensor.setTimeout(500) (таймаут) | Прекращает ожидание, если датчик не ответил за 500 мс, чтобы код не завис навсегда. |
| sensor.init() (инициализация) | Загружает последовательность настроек ST и выполняет калибровку SPAD; если возвращает false, датчик не найден на шине I2C. |
| sensor.startContinuous() (непрерывный режим) | Заставляет датчик измерять подряд, без пауз. |
| sensor.readRangeContinuousMillimeters() (чтение в мм) | Возвращает последнее измерение в миллиметрах; если цели нет, приходит значение около 8190. |
| sensor.timeoutOccurred() (проверка таймаута) | Возвращает true, если последнее чтение завершилось по таймауту (тогда значение равно 65535). |
Режимы измерения VL53L0X
Качество измерения у VL53L0X определяют три настройки: бюджет времени (время, отведённое на одно измерение), предел скорости сигнала (самое слабое отражение, которое ещё считается достоверным) и период импульса VCSEL (длительность лазерных импульсов). Чем больше бюджет, тем больше фотонов собирает датчик и тем стабильнее показания, но тем медленнее работа; бюджет 200 мс означает всего 5 измерений в секунду. Если снизить предел сигнала с 0,25 MCPS по умолчанию до 0,1 MCPS, датчик будет принимать и слабые отражения, дальность вырастет, но вырастет и риск ошибочных показаний. Увеличение периодов импульсов с 14 и 10 по умолчанию до 18 и 14 отправляет больше энергии к дальней цели. ST оформляет эти настройки как четыре готовых профиля; в коде ниже нужный профиль выбирается, если убрать знак комментария в начале его строки. Настройку дальнего действия можно сочетать и с настройкой скорости или точности.
| Профиль | Бюджет времени | Типичная дальность | Точность | Когда использовать |
|---|---|---|---|---|
| По умолчанию | Около 30 мс | 1,2 м | Около ±3–4% | Измерения общего назначения |
| Высокая точность | 200 мс | 1,2 м | Лучше ±3% | Измерение уровня, точная линейка |
| Дальнее действие | 33 мс | 2 м | Около ±4% | Тёмное помещение, далёкая цель |
| Высокая скорость | 20 мс | 1,2 м | Около ±5% | Быстрый робот, распознавание жестов рукой |
1#include <Wire.h>
2#include <VL53L0X.h>
3
4VL53L0X sensor;
5
6// Profil seç: istediğin satırın yorumunu kaldır / Pick a profile: uncomment the line you want
7#define UZUN_MENZIL // uzun menzil / long range
8//#define YUKSEK_HIZ // yüksek hız / high speed
9//#define YUKSEK_DOGRULUK // yüksek doğruluk / high accuracy
10
11void setup() {
12 Serial.begin(115200);
13 Wire.begin();
14 sensor.setTimeout(500);
15 if (!sensor.init()) {
16 Serial.println(F("Sensor yok / No sensor"));
17 while (1) {}
18 }
19
20#if defined UZUN_MENZIL
21 sensor.setSignalRateLimit(0.1); // varsayılan 0.25 MCPS / default 0.25 MCPS
22 sensor.setVcselPulsePeriod(VL53L0X::VcselPeriodPreRange, 18); // varsayılan 14 / default 14
23 sensor.setVcselPulsePeriod(VL53L0X::VcselPeriodFinalRange, 14); // varsayılan 10 / default 10
24#endif
25
26#if defined YUKSEK_HIZ
27 sensor.setMeasurementTimingBudget(20000); // 20 ms
28#elif defined YUKSEK_DOGRULUK
29 sensor.setMeasurementTimingBudget(200000); // 200 ms
30#endif
31}
32
33void loop() {
34 Serial.print(sensor.readRangeSingleMillimeters()); // tek seferlik ölçüm / single-shot ranging
35 if (sensor.timeoutOccurred()) {
36 Serial.print(F(" ZAMAN ASIMI / TIMEOUT"));
37 }
38 Serial.println();
39}Несколько VL53L0X: смена адреса с помощью XSHUT
Каждый VL53L0X выходит с завода с одним и тем же адресом 0x29, и навсегда его не изменить. Если подключить два датчика напрямую к одной шине, оба ответят одновременно и связь нарушится. Решение — пин XSHUT: пока на XSHUT LOW, датчик полностью выключен и на шине I2C не виден. При старте датчики будятся по одному, и каждому программно назначается новый адрес. Новый адрес действует только до отключения питания или нового LOW на XSHUT, поэтому эту процедуру выполняют в setup() при каждом включении. Так легко поставить на робота три датчика — слева, по центру и справа; на практике предел задают число свободных цифровых пинов и общая длина проводов.
- Подключи пины VIN, GND, SDA и SCL всех датчиков к общей шине, а пин XSHUT каждого датчика — к отдельному цифровому пину (в примере D4 и D5).
- В начале setup() выставь LOW на всех пинах XSHUT, чтобы выключить все датчики.
- Включи датчик 1, запусти его через init() и задай новый адрес через setAddress(0x30).
- Включи датчик 2, запусти его и задай адрес 0x31; если датчиков больше, продолжай: 0x32, 0x33 и так далее.
- Запусти непрерывное измерение на всех датчиках и читай каждый через его собственный объект.
1#include <Wire.h>
2#include <VL53L0X.h>
3
4const uint8_t XSHUT_1 = 4;
5const uint8_t XSHUT_2 = 5;
6
7VL53L0X sensor1;
8VL53L0X sensor2;
9
10void setup() {
11 Serial.begin(115200);
12 Wire.begin();
13
14 pinMode(XSHUT_1, OUTPUT);
15 pinMode(XSHUT_2, OUTPUT);
16 digitalWrite(XSHUT_1, LOW); // iki sensörü de kapat / shut down both sensors
17 digitalWrite(XSHUT_2, LOW);
18 delay(10);
19
20 pinMode(XSHUT_1, INPUT); // 1. sensörü aç, modülün pull-up direnci HIGH yapar / wake sensor 1, module pull-up pulls it HIGH
21 delay(10);
22 sensor1.setTimeout(500);
23 if (!sensor1.init()) {
24 Serial.println(F("Sensor 1 yok / Sensor 1 missing"));
25 while (1) {}
26 }
27 sensor1.setAddress(0x30); // yeni adres / new address
28
29 pinMode(XSHUT_2, INPUT); // 2. sensörü aç / wake sensor 2
30 delay(10);
31 sensor2.setTimeout(500);
32 if (!sensor2.init()) {
33 Serial.println(F("Sensor 2 yok / Sensor 2 missing"));
34 while (1) {}
35 }
36 sensor2.setAddress(0x31);
37
38 sensor1.startContinuous();
39 sensor2.startContinuous();
40}
41
42void loop() {
43 Serial.print(F("Sol / Left: "));
44 Serial.print(sensor1.readRangeContinuousMillimeters());
45 Serial.print(F(" mm Sag / Right: "));
46 Serial.print(sensor2.readRangeContinuousMillimeters());
47 Serial.println(F(" mm"));
48 delay(100);
49}VL53L0X с ESP32
На ESP32 та же библиотека Pololu работает без изменений. I2C-пины по умолчанию — GPIO 21 (SDA) и GPIO 22 (SCL); если указать их явно через Wire.begin(21, 22), на разных платах не будет сюрпризов. У ESP32 пины на 3,3 V, поэтому на XSHUT можно подавать HIGH напрямую; способ с INPUT, как на Uno, не нужен. Пример ниже измеряет с бюджетом 50 мс, усредняет последние 5 показаний и включает встроенный светодиод платы, когда предмет оказывается ближе 15 см. Усреднение — самый простой способ сгладить скачущие значения; более продвинутые методы описаны в статье фильтрация данных датчиков. Если хочется следить за расстоянием с телефона, код можно объединить с примером веб-сервера на ESP32.
1#include <Wire.h>
2#include <VL53L0X.h>
3
4const int SDA_PIN = 21;
5const int SCL_PIN = 22;
6const int LED_PIN = 2; // çoğu DevKit'te dahili LED / onboard LED on most DevKits
7const uint16_t ESIK_MM = 150; // uyarı eşiği / warning threshold
8const uint8_t N = 5; // ortalama için örnek sayısı / samples for averaging
9
10VL53L0X sensor;
11uint16_t olcumler[N];
12uint8_t sira = 0;
13
14uint16_t olc() {
15 uint16_t mm = sensor.readRangeContinuousMillimeters();
16 if (mm > 2000) mm = 2000; // menzil dışını sınırla / clamp out-of-range values
17 return mm;
18}
19
20void setup() {
21 Serial.begin(115200);
22 pinMode(LED_PIN, OUTPUT);
23 Wire.begin(SDA_PIN, SCL_PIN);
24 Wire.setClock(400000); // hızlı I2C / fast-mode I2C
25 sensor.setTimeout(500);
26 if (!sensor.init()) {
27 Serial.println("VL53L0X bulunamadi / not found");
28 while (true) delay(1000);
29 }
30 sensor.setMeasurementTimingBudget(50000); // 50 ms bütçe / 50 ms budget
31 sensor.startContinuous();
32 for (uint8_t i = 0; i < N; i++) olcumler[i] = olc(); // diziyi doldur / pre-fill the buffer
33}
34
35void loop() {
36 uint16_t mm = olc();
37 if (sensor.timeoutOccurred()) {
38 Serial.println("Zaman asimi / Timeout");
39 return;
40 }
41 olcumler[sira] = mm;
42 sira = (sira + 1) % N;
43
44 uint32_t toplam = 0;
45 for (uint8_t i = 0; i < N; i++) toplam += olcumler[i];
46 uint16_t ortalama = toplam / N;
47
48 digitalWrite(LED_PIN, ortalama < ESIK_MM ? HIGH : LOW);
49 Serial.printf("Ham / Raw: %u mm Ortalama / Average: %u mm\n", (unsigned)mm, (unsigned)ortalama);
50 delay(50);
51}VL53L0X с Raspberry Pi Pico и MicroPython
В MicroPython нет встроенного модуля для VL53L0X; нужно скопировать на Pico через Thonny файл драйвера vl53l0x.py, написанный сообществом. Такие драйверы переносят на Python последовательность инициализации ST и обычно предлагают функции start(), read() и stop(); один раз проверь названия функций в файле своего драйвера. Для подключения используем I2C0 на пинах GP4 (SDA) и GP5 (SCL); сканирование должно показать 0x29 (41 в десятичной системе). Выражение Pin("LED") в коде выбирает встроенный светодиод и на Pico, и на Pico W в MicroPython 1.20 и новее. Для нескольких датчиков на Pico действует та же логика XSHUT; Pico работает от 3,3 V, поэтому на пины XSHUT можно подавать HIGH напрямую. Если MicroPython в новинку, сначала загляни в основы MicroPython.
1from machine import Pin, I2C
2import time
3from vl53l0x import VL53L0X # vl53l0x.py Pico'da olmalı / must be on the Pico
4
5i2c = I2C(0, sda=Pin(4), scl=Pin(5), freq=400000)
6print("I2C:", [hex(a) for a in i2c.scan()]) # 0x29 görmelisin / you should see 0x29
7
8tof = VL53L0X(i2c) # varsayılan adres 0x29 / default address 0x29
9led = Pin("LED", Pin.OUT) # dahili LED (Pico ve Pico W) / onboard LED (Pico and Pico W)
10ESIK_MM = 150 # uyarı eşiği / warning threshold
11
12tof.start() # sürekli ölçüm / continuous ranging
13try:
14 while True:
15 mm = tof.read()
16 if mm > 2000:
17 print("Menzil disi / Out of range")
18 else:
19 print(mm, "mm")
20 led.value(1 if mm < ESIK_MM else 0)
21 time.sleep_ms(100)
22finally:
23 tof.stop() # ölçümü durdur / stop rangingСоветы для точных измерений
- Цвет цели важен: белые и матовые поверхности хорошо отражают свет; на чёрных, тёмно-серых или бархатистых поверхностях дальность может упасть вдвое и больше.
- Избегай солнечного света: в солнечном свете сильная инфракрасная составляющая, она повышает фоновый шум датчика. На улице держи датчик в тени или выбирай HC-SR04.
- Осторожнее с защитным стеклом: если датчик стоит в корпусе, стекло или оргстекло перед ним отражает часть света обратно (перекрёстная засветка, crosstalk), и показания получаются заниженными. Если крышка нужна, выбирай тонкий материал, пропускающий ИК-излучение, и ставь его как можно ближе к датчику.
- Зеркально блестящие поверхности: от наклонной блестящей поверхности свет может отразиться в другую сторону; держи датчик как можно перпендикулярнее к поверхности.
- Маленькие цели: конус в 25 градусов расширяется с расстоянием; на 1 метре он видит пятно диаметром около 44 см. При измерении маленького предмета издалека на результат может повлиять и стена за ним.
- Делай провода короткими: на длинных проводах шина I2C работает хуже; при соединениях длиннее 30 см снизь скорость до 100 kHz и прокладывай провода подальше от проводов моторов.
Идеи проектов с VL53L0X
- Помощник парковки в гараже: измеряй расстояние от машины до стены и меняй цвет светодиода по мере приближения. Подробный пример — в статье парковочная система на Arduino.
- Бесконтактное мусорное ведро или дозатор мыла: пусть сервопривод открывает крышку, когда рука приближается на 10 см; в проекте умного мусорного ведра вместо HC-SR04 можно поставить VL53L0X.
- Трёхглазый робот, объезжающий препятствия: поставь по датчику слева, по центру и справа и посади их на одну шину с помощью XSHUT; робот, объезжающий препятствия, будет поворачивать гораздо умнее.
- Индикатор уровня корма или зерна: закрепи датчик в крышке бункера и показывай остаток в процентах; хорошая пара для проекта автоматической кормушки для питомца.
- Диммер, управляемый жестом: превращай расстояние от руки до датчика в яркость светодиода с помощью ШИМ; например, 5 см — полная яркость, 30 см — выключено.
- Цифровая линейка: выводи измеренное расстояние крупными цифрами на OLED-дисплей и преврати всё это в настольный измерительный прибор.
Частые ошибки и их решение
| Признак | Вероятная причина | Решение |
|---|---|---|
| init() возвращает false, датчик не найден | Перепутаны SDA и SCL, нет питания или не тот пин | Поищи адрес 0x29 I2C-сканером; проверь, что на Uno SDA = A4, а SCL = A5 |
| Значения застыли около 8190 | Цель вне диапазона, не снята защитная плёнка или поверхность слишком тёмная | Сними плёнку, приблизь цель, попробуй профиль дальнего действия |
| Измерение сдвинуто на несколько сантиметров | Смещение модуля или защитное стекло перед ним | Измерь на известном расстоянии и вычти разницу в коде; убери или замени крышку |
| Значения постоянно скачут | Короткий бюджет времени, внешний свет, маленькая цель | Увеличь бюджет до 50–200 мс, усредняй несколько показаний |
| 65535 и сообщение о таймауте | Длинный или плохо закреплённый провод I2C, датчик сбросился | Укороти провода, проверь надёжность контактов, перезапусти датчик |
| Один из двух датчиков вообще не отвечает | Конфликт адресов или не подключён XSHUT | Проверь пины XSHUT, включай датчики по очереди и задавай им разные адреса |
| На улице показания слишком малы | Инфракрасный шум от солнечного света | Держи датчик в тени, используй профиль высокой точности или перейди на HC-SR04 |
Благодаря маленькому размеру, узкому углу обзора и разрешению в миллиметр VL53L0X добавляет точный «глаз» в самые разные проекты — от роботов до бесконтактных выключателей; если выбрать подходящий профиль и скорректировать смещение, на коротких расстояниях, где ультразвуковые датчики испытывают трудности, результаты получаются гораздо стабильнее. В приложении BlueGrays можно изучить проекты измерения расстояния, парктроника, ростомера и робота, объезжающего препятствия, с пошаговыми схемами и кодом, а затем легко перенести ту же логику на VL53L0X в своём проекте.
Частые вопросы
На какое расстояние измеряет VL53L0X?
С настройками по умолчанию надёжная дальность около 1,2 метра. В профиле дальнего действия, в тёмном помещении и с белой, хорошо отражающей целью он измеряет до 2 метров. На серых или тёмных поверхностях и на солнце эта дальность заметно сокращается.
Что лучше: VL53L0X или HC-SR04?
Зависит от задачи. VL53L0X маленький, с узким углом и стабильнее на расстояниях до 2 метров, а благодаря I2C несколько датчиков легко подключаются к одной шине. HC-SR04 измеряет до 4 метров, не боится солнечного света и видит стекло, но плохо справляется с мягкими поверхностями вроде ткани.
Какой I2C-адрес у VL53L0X и как его изменить?
7-битный адрес по умолчанию — 0x29; в 8-битной записи его пишут и как 0x52. Адрес меняется программно функцией setAddress(), но не навсегда: при отключении питания или LOW на XSHUT он возвращается к 0x29. При нескольких датчиках их нужно при каждом включении будить по очереди через XSHUT и назначать адреса.
Почему VL53L0X показывает 8190?
Библиотека Pololu возвращает значение вроде 8190 или 8191, когда датчик не находит в поле зрения достоверного отражения. Цель может быть вне диапазона, поверхность может быть слишком тёмной или на датчике осталась защитная плёнка. Значение 65535 означает таймаут I2C; проверь провода и питание.
Работает ли VL53L0X на солнце?
Работает, но хуже. В солнечном свете сильная инфракрасная составляющая, из-за неё растёт фоновый шум датчика, а дальность может упасть вдвое и больше. Помогает держать датчик на улице в тени, выбрать профиль высокой точности и использовать его на коротких расстояниях.
Чем VL53L0X отличается от VL53L1X?
VL53L1X — более новый член того же семейства: он измеряет до 4 метров и позволяет выбрать только часть поля зрения (ROI). VL53L0X ограничен 2 метрами, зато дешевле и для проектов на коротких расстояниях его более чем достаточно. Библиотеки у этих датчиков разные, поэтому код один к одному не перенести.
Что собрать после прочтения
Все проекты
Измерение расстояния HC-SR04 (вывод в порт)
Датчик HC-SR04 работает совсем как летучая мышь, которая находит дорогу в темноте: он посылает звук, которого ты не слышишь, слушает эхо и измеряет, насколько далеко предмет перед ним.

Парктроник на HC-SR04
Мини-версия автомобильного парктроника: чем ближе предмет, тем чаще сигнал. Датчик расстояния измеряет предмет перед собой; если он дальше 20 сантиметров, горит зелёный светодиод, а если ближе…

Измерение расстояния с выводом на LCD
Инструмент, который измеряет расстояние без линейки: двигай рукой перед датчиком туда-сюда и смотри, как меняется число.

Измерение роста
Ростомер, который вешается на дверную раму и сообщает в сантиметрах рост человека, стоящего под ним.

Чтение отражения (приближения) с TCRT5000
С маленьким датчиком, который посылает невидимый свет и измеряет, сколько его отражается обратно, можно определить поверхность перед ним.

Робот, объезжающий препятствия
Как насчёт того, чтобы собрать умную машину, которая сама находит дорогу? Робот, объезжающий препятствия, постоянно осматривает всё вокруг благодаря ультразвуковому датчику спереди.

Ультразвуковой датчик расстояния HC-SR04 на ESP32
Ультразвуковой датчик HC-SR04 вычисляет расстояние по времени, за которое испущенная им звуковая волна отражается от предмета и возвращается (Time of Flight). В этом проекте ESP32 подаёт импульс 10 микросекунд на пин TRIG датчика, а длительность эха читает с пина ECHO через pulseIn(). Вычисленное расстояние в сантиметрах выводится на I2C LCD 16x2. HC-SR04 работает от 5V, поэтому на пине ECHO нужен делитель напряжения.

Парктроник на ESP32 (HC-SR04 + шкала из 5 светодиодов + зуммер + OLED)
ESP32-версия автомобильного парктроника! Ультразвуковой датчик HC-SR04 измеряет расстояние до предмета перед ним. По мере уменьшения расстояния шкала из 5 светодиодов заполняется (зелёный → жёлтый → красный), а интервал сигналов зуммера сокращается. Когда предмет совсем близко (меньше 10 см), звучит непрерывная тревога и горят все светодиоды. OLED SSD1306 показывает расстояние в см крупным шрифтом и сообщение состояния (STOP / CAUTION / CLOSE / STOP! / DANGER).
Другие статьи
Приложение BlueGrays
Собери эту схему шаг за шагом в телефоне
Схема подключения, код и список деталей на одном экране. 500+ проектов на Arduino, ESP32 и Pico готовы к сборке.
Наведи камеру телефона
Наведи камеру на код — откроется магазин приложений на телефоне.
или открыть магазин

