快速开始
准备工作
准备模块、Qwiic 线、具有匹配 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。为主控安装对应支持包，不把传感器模块当作独立上传程序的开发板。
安装与示例
- 主控断电，将 Modulino Light 接到主控 Qwiic 接口。
- 检查接口电压和使用的 I2C 总线，再连接 USB。
- 在库管理器搜索并安装手册指定的 Arduino_LTR381RGB 库。
- 打开库内对应的测量示例，核对其使用的总线及串口波特率。
- 选择实际主控型号与端口，编译并上传。
- 打开串口监视器，使用与示例相同的波特率读取结果。
库与使用方向依据：Modulino Light 官方数据手册。示例名称与 API 以安装版本为准，本页不提供未经核对的函数调用。
结果验证
将模块置于稳定光线下记录基线，再遮挡或改变照明，观察环境光及通道值是否变化。颜色验证使用固定光源和位置，分别放置已知颜色样本进行比较。
不要将未经换算的 ADC 原始读数标为 lux，也不要把红外读数直接解释为温度。先确认示例输出量及单位，再进行阈值判断。
识别异常
| 现象 | 检查方法 |
|---|---|
| 扫描不到 0x53 | 核对 3.3 V 供电、SDA/SCL 与实际总线对象 |
| 多个模块一起异常 | 检查同地址冲突，逐个断开验证 |
| 读数不变化 | 核对传感器窗口、采样配置及示例输出 |
| RGB 结果偏差 | 固定照明、距离、角度，再检查增益和积分时间 |