Modulino Light 使用教程

产品特点​

  • 环境光检测:采集周围光照变化,为自动亮度调节和照明控制提供数据。
  • RGB 分量测量:分别测量红、绿、蓝光分量,可用于颜色识别与分类应用。
  • 红外光感应:支持红外光检测,提供相应光学数据。
  • LTR-381RGB-01 传感器:集成多通道光学检测功能,ADC 最高支持 20 位。
  • I2C 数字通信:主控通过 I2C 读取传感器数据。
  • 双 Qwiic 接口:通过 3.3 V Qwiic 连接主控,并可接入其他节点。

产品参数​

项目参数
传感器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 位数不代表所有增益、积分时间和环境下均获得相同精度。

产品展示​

Modulino Light 与 Qwiic 线缆

产品尺寸​

Modulino Light 板上器件布局尺寸

Modulino Light 机械尺寸



硬件接口

引脚定义​

Modulino Light 引脚定义

接口信号用途
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。为主控安装对应支持包,不把传感器模块当作独立上传程序的开发板。

安装与示例​

  1. 主控断电,将 Modulino Light 接到主控 Qwiic 接口。
  2. 检查接口电压和使用的 I2C 总线,再连接 USB。
  3. 在库管理器搜索并安装手册指定的 Arduino_LTR381RGB 库。
  4. 打开库内对应的测量示例,核对其使用的总线及串口波特率。
  5. 选择实际主控型号与端口,编译并上传。
  6. 打开串口监视器,使用与示例相同的波特率读取结果。

库与使用方向依据:Modulino Light 官方数据手册。示例名称与 API 以安装版本为准,本页不提供未经核对的函数调用。

结果验证​

将模块置于稳定光线下记录基线,再遮挡或改变照明,观察环境光及通道值是否变化。颜色验证使用固定光源和位置,分别放置已知颜色样本进行比较。

不要将未经换算的 ADC 原始读数标为 lux,也不要把红外读数直接解释为温度。先确认示例输出量及单位,再进行阈值判断。

识别异常​

现象检查方法
扫描不到 0x53核对 3.3 V 供电、SDA/SCL 与实际总线对象
多个模块一起异常检查同地址冲突,逐个断开验证
读数不变化核对传感器窗口、采样配置及示例输出
RGB 结果偏差固定照明、距离、角度,再检查增益和积分时间


光学测量说明

环境光与原始读数​

环境光测量需区分原始 ADC 值和换算后的 lux。最高 20 位 ADC 描述数字转换能力,不能据此保证绝对照度精度,也不能把不同增益或积分时间的原始值直接比较。

先在固定设置下采集数据,再按库及传感器说明进行换算或阈值配置。强光下若读数接近上限,应检查是否饱和,不把饱和值当作准确照度。

RGB 颜色识别​

RGB 分量受光源光谱、物体反射、距离、角度和遮挡共同影响。建立颜色判定前固定光源和测量位置,并用目标样本记录参考数据。模块输出不等同于未经校准就能直接使用的屏幕 RGB 颜色值。

红外检测​

红外通道反映传感器接收到的红外信号。该模块不能仅凭红外读数直接提供温度或距离;若项目需要测温、测距或遥控解码,需另行确认传感器及算法是否满足要求。

多传感器部署​

Light 地址固定为 0x53。使用 Hub 时,将同地址模块分别连接独立通道,并在访问前只选通目标通道。不同通道同时开启后,同地址设备仍可能冲突。

布置多个模块时还需核对供电预算、线长和上拉,不仅根据连接器数量决定可接模块数。


相关资料

1. 技术手册​

2. 软件工具​

3. 其他资料​


技术支持

周一-周五(9:30-6:30)周六(9:30-5:30)

手机:13434470212

邮箱:services04@spotpear.cn

QQ:202004841