Arduino INO
ESP32 固件 + I2C 扫描器
包含 3 个 Arduino IDE 可直接打开的程序：i2c_scanner.ino、VL53L7_Readable.ino、VL53L7_JSON.ino，每个工程文件夹内已带传感器驱动源码。
VL53L7CX / VL53L5CX 多区域 ToF 测距模块
飞行时间多区域测距，适合避障、手势检测、区域距离判断和多点测距演示。
进入淘宝购买
Product Photos
实拍图片
以下为店铺自有实拍素材，用于确认模块正反面、接口方向和焊接状态。不同批次丝印以实物为准。
Wiring
ESP32-S3 推荐接线
这款模块板的 VIN 经过板载 662K 稳压后再给传感器供电，所以 ESP32-S3 的 3.3V 不要接模块 VIN。推荐用 ESP32-S3 的 5V / VBUS 接模块 VIN。
| VL53L7 模块 | ESP32-S3 | 说明 |
|---|---|---|
| VIN / VCC | 5V / VBUS | 模块板带 662K 稳压，VIN 按 5V 输入测试 |
| GND | GND | 必须共地 |
| SDA | GPIO21 | I2C 数据线，ESP32-S3 为 3.3V 逻辑 |
| SCL | GPIO22 | I2C 时钟线，ESP32-S3 为 3.3V 逻辑 |
| INT / LPn | 可不接 | 基础测试先不用接 |
重点提醒
不要把 ESP32-S3 的 3.3V 接到模块 VIN。3.3V 进入 VIN 后还要经过稳压器压降，板上实际工作电压可能只剩 2.6V 左右，模块会启动失败或 I2C 无应答。
Power Debug
ESP32-S3 接 VL53L7 掉压排查
客户说“接 3.3V 只有 2.65V，接 5V 只有 4V”时，先不要判断代码问题。只接电源就掉压，优先查供电链路、线材压降和接线短路。
1. 先空载测开发板
不接模块时，测 ESP32-S3 的 5V/VBUS 和 3V3 是否正常。USB 线太差、电脑 USB 口供电弱、扩展板负载大，都会让 5V 掉到 4V 左右。
2. 只接 VIN 和 GND
先不接 SDA/SCL，只接模块 VIN/GND。测模块 VIN-GND 和模块板上 3.3V 测点。如果 VIN 已经被拉低，问题在供电、线材、接反、短路或模块异常。
3. 换短粗线和稳定 5V
杜邦线太长、铁芯线、接触松动都会有压降。建议换短线，或用稳定 5V 电源直接接模块 VIN/GND，ESP32-S3 只负责 SDA/SCL，并且 GND 共地。
| 现象 | 优先判断 | 处理 |
|---|---|---|
| 3.3V 接 VIN 后只有约 2.6V | VIN 走稳压器，输入电压不够 | 改用 5V/VBUS 接 VIN |
| 5V 接 VIN 后只有约 4V | USB 供电弱、线材压降、接触不良或负载异常 | 换 USB 口、短粗线、稳定 5V 电源再测 |
| 只接 VIN/GND 就掉压 | 不是代码和 I2C 地址问题 | 先查电源、接反、短路、模块发热 |
| VIN 正常但 I2C 扫不到 | 再查 SDA/SCL、GND 共地、库和地址 | 用 I2C Scanner 先扫地址 |
Logic Level
ESP32-S3 需不需要电平转换？
ESP32-S3 的 GPIO 是 3.3V 逻辑。正常情况下，模块的 SDA/SCL 如果上拉到 3.3V，就可以直接连接 ESP32-S3，不需要额外电平转换。
一般不需要
ESP32-S3 SDA/SCL 接模块 SDA/SCL，模块 I2C 上拉为 3.3V 时可以直连。
需要确认
如果某个模块把 SDA/SCL 上拉到 5V，ESP32-S3 不能直接承受，需要加 I2C 电平转换。
测量方法
上电空闲时用万用表测 SDA-GND、SCL-GND，正常应接近 3.3V，不应接近 5V。
Downloads
下载资料和测试程序
客户测试建议先下载 Arduino 固件包：先烧 I2C 扫描器确认地址，再按需要选择“可读文字输出”或“JSON 输出 + Python 仪表盘”。
Python Dashboard
电脑热力图仪表盘
配合 VL53L7_JSON.ino 使用。先烧录 JSON 输出固件，再双击 启动.bat，可查看 8×8 热力图和 3D 柱状图实时画面。
Document
产品技术资料 MD
包含接线、常见问题、代码示例和测试说明。后续资料更新时，会优先同步到这个文档。
下载技术文档Arduino IDE Test
ESP32 测试视频
视频演示 Arduino IDE 上传测试程序后，串口监视器输出多区域距离数据。
Troubleshooting
常见问题
I2C 扫不到模块
先确认 VIN 是否为 5V/VBUS 输入、GND 是否共地、SDA/SCL 是否接反。ESP32-S3 常用 SDA=GPIO21、SCL=GPIO22。
接 3.3V 为什么不工作？
当前模块 VIN 前面有板载稳压，3.3V 接 VIN 后会被稳压器压降，实际可能只有 2.6V 左右，传感器不能正常启动。
5V 也掉到 4V 是模块坏了吗？
不一定。先换 USB 线、换电脑 USB 口、换短粗杜邦线，并单独测模块 VIN/GND。如果只接电源也掉压，再进一步查短路、发热或模块异常。
UNO / Nano 能不能直接接？
UNO/Nano 是 5V GPIO，不建议直接接 3.3V I2C 传感器。要确认模块是否带电平转换，不确定时用 ESP32-S3 或加 I2C 电平转换。
Customer Reply