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 值得单独点名：它几乎在各方面都是可以直接替换的升级，而可编程的感兴趣区让你能用软件缩小视场——等于不动传感器就在软件里引导光束。如果你是今天做选择而不是清点存货，通常它更值得买。