硬件接口
引脚定义
| 接口或信号 | 用途 |
|---|---|
| 两个 Qwiic、1×4 I2C 焊盘 | GND、3.3 V、SDA、SCL，同一 I2C 总线 |
| 额外 1×4 焊盘 | GND、3V3、GPIO1、XSHUT |
| GPIO1 | 数据就绪或阈值事件中断输出 |
| XSHUT | 关闭及复位控制 |
GPIO1 与 XSHUT 均有 10 kΩ 上拉至 3.3 V。常规官方库读取先使用 Qwiic，无需额外接 GPIO1 或 XSHUT。不要将这些信号接到 5 V 输出。
I2C 地址
模块默认 7 位地址为 0x29。ST 器件资料中的 0x52 是另一种地址表示，使用 Wire 扫描或 7 位 API 时不能填入 0x52 代替 0x29。
同一总线上连接多块默认地址相同的模块时，需用独立 XSHUT 控制逐个初始化并由匹配驱动分配地址，或使用分别选通的 I2C 多路复用器。地址设置属于传感器运行配置，不把它当作 MCU 模块的永久固件改址。
已核对的 ModulinoDistance 初始化流程先探测 0x29，不能假设改址后仍能直接被其默认初始化流程识别。高级多模块方案需核对所用驱动，不能只修改扫描程序的地址。
光学窗口
传感器发射与接收窗口需无遮挡。安装时避免壳体、连接线或透明盖板直接干扰光路，不能遮挡其中一个窗口后仍把读数当作正常测距。