Компоненты · 9 мин чтения

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. Другие варианты есть в сравнении датчиков расстояния.

ХарактеристикаVL53L0XHC-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 — это выход прерывания, который сигналит об окончании измерения; для базового использования его подключать не нужно.

Пин VL53L0XArduino UnoESP32Raspberry Pi Pico
VIN5V (или 3.3V)3V33V3(OUT)
GNDGNDGNDGND
SCLA5GPIO 22GP5
SDAA4GPIO 21GP4
XSHUT (необязательно)D4 (для 2-го датчика D5)GPIO 25GP6
GPIO1 (необязательно)Не подключаетсяНе подключаетсяНе подключается
Пины голой микросхемы VL53L0X без модуля выдерживают не больше 3,6 V. На готовых модулях есть стабилизатор, поэтому на VIN можно подавать 5 V, но не подавай HIGH на пин XSHUT напрямую с 5-вольтового выхода Uno: чтобы включить датчик, переведи пин в INPUT и отпусти его, а остальное сделает подтягивающий резистор модуля. Кроме того, порядок пинов отличается от модели к модели; перед подключением обязательно читай надписи на плате.

Пошагово: первое измерение с Arduino

  1. Подключи провода по таблице: VIN → 5V, GND → GND, SDA → A4, SCL → A5.
  2. Если на датчике есть жёлтая или оранжевая защитная плёнка, аккуратно сними её; плёнка полностью портит измерение.
  3. В Arduino IDE открой «Менеджер библиотек» (Library Manager), введи VL53L0X и установи библиотеку от Pololu. Adafruit_VL53L0X тоже работает, но она включает полный API от ST и занимает на Uno гораздо больше памяти. Если с установкой не получается, загляни в статью как добавить библиотеку в Arduino.
  4. Загрузи код ниже и открой монитор порта на скорости 115200 бод.
  5. Приближай и отводи руку от датчика и смотри, как меняются значения в миллиметрах и сантиметрах.
C++ (Arduino IDE)
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).
Если в мониторе порта ничего нет, сначала запусти I2C-сканер: при правильном подключении датчик виден по адресу 0x29. Если значения выглядят разумно, но сдвинуты на несколько сантиметров, поставь цель по линейке на 100 мм и 500 мм, измерь и вычти среднюю разницу в коде. Такое смещение (офсет) часто встречается у дешёвых модулей, и эта простая поправка заметно улучшает измерение.

Режимы измерения 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%Быстрый робот, распознавание жестов рукой
C++ (Arduino IDE)
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() при каждом включении. Так легко поставить на робота три датчика — слева, по центру и справа; на практике предел задают число свободных цифровых пинов и общая длина проводов.

  1. Подключи пины VIN, GND, SDA и SCL всех датчиков к общей шине, а пин XSHUT каждого датчика — к отдельному цифровому пину (в примере D4 и D5).
  2. В начале setup() выставь LOW на всех пинах XSHUT, чтобы выключить все датчики.
  3. Включи датчик 1, запусти его через init() и задай новый адрес через setAddress(0x30).
  4. Включи датчик 2, запусти его и задай адрес 0x31; если датчиков больше, продолжай: 0x32, 0x33 и так далее.
  5. Запусти непрерывное измерение на всех датчиках и читай каждый через его собственный объект.
C++ (Arduino IDE)
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}
Если какой-то датчик сбросится (просадка напряжения, плохой контакт, помехи от мотора), его адрес вернётся к 0x29 и код его больше не найдёт. В проектах с моторами или длинными проводами регулярно проверяй результат timeoutOccurred() и при необходимости напиши функцию перезапуска, которая заново проходит всю последовательность XSHUT. Выбирая новые адреса, следи, чтобы они не совпадали с адресами других устройств на шине, например OLED-дисплея (0x3C) или модуля RTC (0x68).

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.

C++ (Arduino IDE)
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.

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 (вывод в порт)
AR-27Новичок

Измерение расстояния HC-SR04 (вывод в порт)

Датчик HC-SR04 работает совсем как летучая мышь, которая находит дорогу в темноте: он посылает звук, которого ты не слышишь, слушает эхо и измеряет, насколько далеко предмет перед ним.

4.6(50)
82
Парктроник на HC-SR04
AR-28Средний
Premium

Парктроник на HC-SR04

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

4.8(64)
86
Измерение расстояния с выводом на LCD
AR-31Продвинутый
Premium

Измерение расстояния с выводом на LCD

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

4.6(45)
59
Измерение роста
AR-33Средний
Premium

Измерение роста

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

4.5(25)
34
Чтение отражения (приближения) с TCRT5000
AR-77Средний
Premium

Чтение отражения (приближения) с TCRT5000

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

4.6(33)
43
Робот, объезжающий препятствия
AR-81Продвинутый
Premium

Робот, объезжающий препятствия

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

5.0(38)
49
Ультразвуковой датчик расстояния HC-SR04 на ESP32
ES-14Средний

Ультразвуковой датчик расстояния HC-SR04 на ESP32

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

4.9(29)
48
Парктроник на ESP32 (HC-SR04 + шкала из 5 светодиодов + зуммер + OLED)
ES-38Продвинутый
Premium

Парктроник на ESP32 (HC-SR04 + шкала из 5 светодиодов + зуммер + OLED)

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

14