Датчик расстояния VL53L0X ToF

Что это такое

VL53L0X измеряет расстояние так же, как лазерный дальномер, — светом вместо звука. Он излучает невидимый импульс инфракрасного лазера, измеряет время пути туда и обратно и передаёт по I²C узкое, быстрое измерение с точностью до миллиметра. Если HC-SR04 воспринимает широкий конус с разбросом в несколько сантиметров, то VL53L0X измеряет узкое пятно с высокой точностью — это датчик для случаев, когда ответа «примерно как далеко» недостаточно.

Как это работает

В корпусе находятся два отверстия: лазерный излучатель и приёмник SPAD (детектор одиночных фотонов). Датчик посылает импульс инфракрасного света 940 nm, приёмник измеряет время возвращения отражения, а поскольку скорость света известна, это время преобразуется в расстояние. Всё хронометражное управление выполняется на кристалле; микроконтроллер лишь считывает значение в миллиметрах по I²C. Компромиссы по сравнению со звуком те же, что рассматриваются в руководстве ультразвук против датчиков времени пролёта.

Когда его следует использовать

Выбирайте VL53L0X, когда роботу нужно точное измерение расстояния узким лучом:

• Близкие точные расстояния — оценка конкретного промежутка, следование вдоль стены с заданным отступом или точная остановка.
• Небольшие или тонкие препятствия — ножка стола или провод, которые широкий ультразвуковой конус размоет или пропустит.
• Быстрые контуры — обновления до 50 Hz для отзывчивого регулирования.

Для дешёвого и прощающего ошибки обнаружения «есть ли что-нибудь впереди?» на большей площади лучше HC-SR04. Идеи фильтрации из руководства чтение HC-SR04 применимы к любому потоку измерений расстояния, включая лазерный.

Подключение и важные нюансы

• I²C, и возможен конфликт адресов. Все VL53L0X используют один адрес по умолчанию; для работы нескольких экземпляров применяйте вывод XSHUT, чтобы включать их по одному и переназначать адреса.
• Учитывайте внешний свет. Яркое солнце с большим количеством инфракрасного излучения, а также тёмные и зеркальные поверхности сокращают рабочую дальность.
• Содержите окно чистым. Отпечаток пальца или пыль на отверстии рассеивают луч и искажают показания.
• Соблюдайте ближний предел (~5 cm); как и любой дальномер, он имеет слепую зону на слишком малых расстояниях.

Расположение выводов

XSHUT — вывод, который делает возможным использование нескольких датчиков; его следует понять до покупки второго экземпляра.

Использование нескольких датчиков VL53L0X

Каждый VL53L0X включается с одинаковым адресом 0x29, а выводов для выбора адреса нет. Подключите два к одной шине, и оба ответят одновременно, нарушив все обмены. Адрес можно изменить программно, но изменение не сохраняется и теряется при каждом цикле питания.

Стандартное решение использует XSHUT для поочерёдного включения:

#include <Wire.h>
#include <VL53L0X.h>

const int XSHUT[] = {4, 5, 6};          // one GPIO per sensor
const uint8_t ADDR[] = {0x30, 0x31, 0x32};
VL53L0X sensor[3];

void setup() {
  Wire.begin();

  // 1. Hold every sensor in reset.
  for (int i = 0; i < 3; i++) { pinMode(XSHUT[i], OUTPUT); digitalWrite(XSHUT[i], LOW); }
  delay(10);

  // 2. Release one at a time and give each a new address before the next wakes.
  for (int i = 0; i < 3; i++) {
    digitalWrite(XSHUT[i], HIGH);
    delay(10);
    sensor[i].init();
    sensor[i].setAddress(ADDR[i]);      // now it is off 0x29 and the next can boot
    sensor[i].setTimeout(500);
  }
}

Две детали часто упускают: выводы должны удерживаться в состоянии LOW для сброса, а затем освобождаться; кроме того, всю последовательность необходимо повторять после каждого цикла питания, поскольку адреса не сохраняются. Некоторые платы расширения подтягивают XSHUT вверх встроенным резистором, поэтому простое оставление вывода неподключённым оставляет датчик включённым.

Бюджет времени: точность, скорость и дальность

У VL53L0X есть один параметр важнее остальных, и большинство примеров кода его не меняет. Бюджет времени определяет, сколько датчику разрешено накапливать фотоны для одного измерения, и задаёт компромисс между тремя величинами:

sensor.setMeasurementTimingBudget(20000);   // microseconds

Существуют также режимы большой дальности и высокой точности, изменяющие порог частоты сигнала и периоды импульсов. Практическое правило: если дальности недостаточно, сначала увеличьте время, а не обвиняйте датчик. Бюджет 200 ms действительно удваивает рабочую дальность по сравнению с 20 ms.

Минимальный рабочий код

#include <Wire.h>
#include <VL53L0X.h>

VL53L0X sensor;

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

  if (!sensor.init()) {
    Serial.println("VL53L0X not found");   // check wiring and XSHUT
    while (1) {}
  }
  sensor.setTimeout(500);
  sensor.setMeasurementTimingBudget(33000);
  sensor.startContinuous();
}

void loop() {
  uint16_t mm = sensor.readRangeContinuousMillimeters();

  if (sensor.timeoutOccurred()) {
    Serial.println("timeout");
  } else if (mm >= 8190) {
    Serial.println("out of range");        // 8190/8191 mean "no valid target"
  } else {
    Serial.println(mm);
  }
  delay(20);
}

8190 и 8191 не являются расстояниями. Это способ датчика сообщить, что пригодного отражения нет: либо перед ним ничего нет, либо цель слишком тёмная или слишком далёкая. Код, считающий 8191 равным 8.19 метра, будет странно вести себя в пустой комнате; код, считающий его нулём, включит аварийную остановку.

Чего он не может видеть

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

Особенно важно объяснить случай с солнцем, поскольку он самый неожиданный. VL53L0X, идеально работающий в помещении, может оказаться почти бесполезным в залитой солнцем зимней оранжерее, причём отказ развивается постепенно: дальность сокращается, а показания не становятся явно неверными.

Диагностика

VL53L0X или что-то другое?

Особого внимания заслуживает VL53L1X: это почти по всем параметрам более совершенная взаимозаменяемая деталь, а программируемая область интереса позволяет сузить поле зрения программно — фактически направить луч без перемещения датчика. Если вы выбираете сегодня, а не используете имеющийся экземпляр, обычно выгоднее купить такой датчик.