快速开始
准备与连接
准备模块、Qwiic 线、具备 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。主控没有 Qwiic 时，按引脚表连接 3.3 V、GND、SDA、SCL；5 V 逻辑需匹配的电平转换。
- 主控断电后连接模块，确认公共 GND。
- 为 Arduino IDE 安装主控实际型号的支持包。
- 在库管理器安装或更新官方 Arduino_Modulino 库。
- 打开库中对应模块的示例。
- 选择主控型号与端口，编译并上传到主控。
- 按示例波特率打开串口监视器，检查输出。
示例验证
打开 Distance 示例。官方对象为 ModulinoDistance，按示例初始化后先检查 available()，再通过 get() 获取毫米单位的距离。不要把初始化成功当作当前每次测量都有效。
用平整目标对准传感器，缓慢改变距离，观察读数变化。先在稳定光照下验证，再测试实际安装位置。程序应处理无有效距离的情况，不把无效读数转换成 0 mm 或沿用旧值触发控制。
故障检查
| 现象 | 检查方法 |
|---|---|
| 扫描不到设备 | 核对 3.3 V、GND、总线选择和 SDA/SCL |
| 初始化失败 | 更新官方库，核对地址、硬件版本和地址冲突 |
| 加入多个模块后异常 | 检查地址唯一性、电源余量、线长和总线上拉 |
| 串口无输出 | 核对主控端口、波特率和示例是否运行 |