| 项目 | 参数 |
|---|---|
| 传感器 | LTR-381RGB-01 |
| 供电与接口 | 3.3 V,I2C / Qwiic |
| I2C 地址 | 固定 7 位地址 0x53,不可软件修改 |
| 功能 | 环境光、RGB、红外测量 |
| 环境光范围 | 手册列出 0.01–120000 lux |
| ADC | 最高 20 位 |
| 红 / 绿 / 蓝光谱范围 | 600–700 / 500–600 / 400–500 nm |
| 典型测量电流 | 约 200 µA(手册给定值,不作为整机耗电保证) |
| 中断 | INT,10 kΩ 上拉至 3.3 V |
| 工作温度 | −30°C 至 70°C |
参数依据:Modulino Light 数据手册。测量范围与最高 ADC 位数不代表所有增益、积分时间和环境下均获得相同精度。



| 接口 | 信号 | 用途 |
|---|---|---|
| Qwiic 与可焊排针 | GND、3.3 V、SDA、SCL | 逻辑供电及 I2C |
| 传感器信号排针 | GND、GND、3V3、INT | 中断信号及供电引出 |
Qwiic 和 I2C 焊盘连接同一总线,不是两路独立 I2C。按丝印核对信号顺序,断电后连接并共地;不能将 5 V 电源或逻辑信号直接接入 3.3 V 接口。
INT 通过 10 kΩ 电阻上拉至 3.3 V,用于阈值或数据就绪事件。连接到主控支持 3.3 V 的输入引脚,程序还需按传感器与库的配置启用相应中断条件,不能仅接线就认为自动触发。
地址固定为 0x53,不支持通过 AddressChanger 改址。多个 Light 若直接接入同一总线会发生地址冲突,应使用不同物理 I2C 总线,或通过 Modulino Hub 隔离到不同通道,访问时逐一选通。
传感器窗口应朝向被测光源或物体,不被外壳、线缆或手指遮挡。测量表面颜色时保持照明、距离和角度一致,避免把安装条件变化误认为物体颜色变化。
准备模块、Qwiic 线、具有匹配 3.3 V I2C 接口的主控、USB 数据线和 Arduino IDE。为主控安装对应支持包,不把传感器模块当作独立上传程序的开发板。
库与使用方向依据:Modulino Light 官方数据手册。示例名称与 API 以安装版本为准,本页不提供未经核对的函数调用。
将模块置于稳定光线下记录基线,再遮挡或改变照明,观察环境光及通道值是否变化。颜色验证使用固定光源和位置,分别放置已知颜色样本进行比较。
不要将未经换算的 ADC 原始读数标为 lux,也不要把红外读数直接解释为温度。先确认示例输出量及单位,再进行阈值判断。
| 现象 | 检查方法 |
|---|---|
| 扫描不到 0x53 | 核对 3.3 V 供电、SDA/SCL 与实际总线对象 |
| 多个模块一起异常 | 检查同地址冲突,逐个断开验证 |
| 读数不变化 | 核对传感器窗口、采样配置及示例输出 |
| RGB 结果偏差 | 固定照明、距离、角度,再检查增益和积分时间 |
环境光测量需区分原始 ADC 值和换算后的 lux。最高 20 位 ADC 描述数字转换能力,不能据此保证绝对照度精度,也不能把不同增益或积分时间的原始值直接比较。
先在固定设置下采集数据,再按库及传感器说明进行换算或阈值配置。强光下若读数接近上限,应检查是否饱和,不把饱和值当作准确照度。
RGB 分量受光源光谱、物体反射、距离、角度和遮挡共同影响。建立颜色判定前固定光源和测量位置,并用目标样本记录参考数据。模块输出不等同于未经校准就能直接使用的屏幕 RGB 颜色值。
红外通道反映传感器接收到的红外信号。该模块不能仅凭红外读数直接提供温度或距离;若项目需要测温、测距或遥控解码,需另行确认传感器及算法是否满足要求。
Light 地址固定为 0x53。使用 Hub 时,将同地址模块分别连接独立通道,并在访问前只选通目标通道。不同通道同时开启后,同地址设备仍可能冲突。
布置多个模块时还需核对供电预算、线长和上拉,不仅根据连接器数量决定可接模块数。
周一-周五(9:30-6:30)周六(9:30-5:30)
手机:13434470212
邮箱:services04@spotpear.cn
QQ:202004841
