VL53L7CX / VL53L8CX 多区域 ToF 飞行时间测距传感器模块
本页包含实拍图、Arduino IDE 测试视频和买家接线测试流程。
进入淘宝购买
Product Photos
实拍图片
以下为店铺自有实拍素材，适合客户确认模块正反面和排针焊接状态。不同批次丝印、接口位置以实物为准。
Arduino IDE Test
ESP32 测试视频
视频演示 ESP32 开发板通过 Arduino IDE 烧录 8×8 连续测距程序，串口监视器实时输出 64 区距离数据。
视频说明
传感器检测、固件下载、初始化成功后，会稳定输出矩阵距离值。视频已保存到网站本地资源，不再依赖淘宝/阿里 CDN 外链。
Wiring
ESP32 推荐接线
入门测试优先使用 ESP32，因为 ESP32 是 3.3V 逻辑，I2C 通信更适合这类 ToF 传感器。
| VL53L7 模块 | ESP32 | 说明 |
|---|---|---|
| VCC / VDD | 3V3 | 优先按 3.3V 测试 |
| GND | GND | 必须共地 |
| SDA | GPIO21 | I2C 数据线 |
| SCL | GPIO22 | I2C 时钟线 |
| INT / LPn | 可不接 | 基础测试先不用接 |
Preparation
买家测试前需要准备
硬件
ESP32 开发板、VL53L7 模块、杜邦线、USB 数据线、白墙/纸板/手掌等测试目标。
软件
Arduino IDE、ESP32 开发板支持包、STMicroelectronics VL53L7CX Arduino 库、串口监视器。
供电
优先使用 3.3V。UNO/Nano 是 5V GPIO，直连前必须确认模块是否带电平转换。
Arduino Steps
Arduino IDE 测试流程
1安装 Arduino IDE，ESP32 用户在开发板管理器中安装 Espressif ESP32 支持包。
2库管理器搜索并安装 STMicroelectronics 的 VL53L7CX 库，优先使用官方示例。
3按接线图连接 ESP32：3V3、GND、SDA=GPIO21、SCL=GPIO22。
4选择开发板和端口，上传 8×8 连续测距示例。
5打开串口监视器，波特率设为 115200，查看 64 个 zone 的距离值和状态。
Serial Output
串口输出怎么看
多区域 ToF 不能只看距离数值，必须同时看每个 zone 的 target status。
| 字段 | 说明 | 买家判断 |
|---|---|---|
| distance_mm | 该区域测到的距离，单位 mm | 先看 status 是否有效 |
| status = 5 / 6 / 9 | 通常表示有效测距 | 可作为正常距离参考 |
| status = 255 | 无效目标或不可用点位 | 不能当真实距离 |
| status = 13 | 低置信度 / 一致性异常 | 优先排查反光、盖板、目标材质 |
Troubleshooting
常见问题
I2C 扫不到模块
先确认 3.3V/GND、SDA/SCL 是否接反，ESP32 常用 SDA=GPIO21、SCL=GPIO22；杜邦线太长也会影响 I2C。
串口有数据但距离不准
先看 status，255 不是真实距离；透明盖板、指纹、灰尘、强反光和黑色物体都会影响 ToF 测距。
UNO / Nano 能不能直接接？
不建议直接接。UNO/Nano 是 5V GPIO，需确认模块是否带电平转换；不确定时用 ESP32 或外加电平转换。
Customer Reply