Modulino Pixels 使用教程

产品特点​

  • 八颗独立 RGB LED:板载 8 颗 LC8822-2020,可分别设置每颗 LED 的颜色与亮度。
  • 全彩灯光显示:通过 RGB 颜色组合形成多种颜色和状态指示。
  • 可编程动态灯效:可通过程序实现流水灯、颜色渐变、闪烁和自定义动画。
  • STM32C011 控制器:负责 LED 驱动与控制,接收主控的 I2C 命令。
  • 双 Qwiic 接口:使用 3.3 V 供电,可连接主控及其他 Modulino 节点。
  • Arduino 库支持:支持 Arduino_Modulino 库,可从官方示例开始编写灯效。

产品参数​

项目参数
主控STM32C011F4
LED8 颗 LC8822-2020,可独立设置颜色和亮度
供电与接口3.3 V,Qwiic / I2C
默认 7 位地址0x36,支持软件配置
MCU 电流手册列出约 3.4 mA
全亮 LED 电流参考每颗最高约 33 mA,8 颗约 264 mA,另计 MCU 等负载
工作温度−40°C 至 85°C
板体尺寸41 × 25.36 mm
板厚1.6 ± 0.2 mm
安装孔4 个,直径 3.2 mm,孔距 32 × 16 mm

参数依据:Modulino Pixels 数据手册。手册另列功耗约 80 mA,但未注明具体显示条件,不将其作为最大耗电;实际取决于亮度、颜色和点亮数量。

产品尺寸​

Modulino Pixels 机械尺寸图

硬件接口

引脚定义​

Modulino Pixels 引脚图
接口信号用途
Qwiic 与 I2C 焊盘GND、3.3 V、SDA、SCL逻辑及 LED 供电、主控通信
调试与扩展焊盘GND、GND、3V3、RESET、SWCLK、SWDIO、TX1、RX1调试及固件扩展
LED 扩展信号D0、C0Pixels Data Out、Pixels Clock Out

Qwiic 接口和 I2C 焊盘共享总线,不是独立隔离通道。模块工作在 3.3 V,不能直接将 5 V 电源和信号接入。

D0、C0 是像素数据和时钟输出,不是第二组 I2C。正常使用由板载 MCU 管理 LED,主控不直接按普通灯带协议驱动这些焊盘。

地址与多模块​

官方共用地址表以 7 位地址 0x36 表示 Pixels;产品手册同时写 Modulino 地址 0x6C、硬件地址 0x36。Arduino Wire 使用 7 位地址,不将 0x6C 直接当作默认 Wire 地址。

先扫描实际模块确认地址。多块模块使用同一总线时配置不同地址,官方 AddressChanger 工具用于软件改址,操作后重新上电并扫描核对。参考:Modulino 地址说明。

供电预算​

LED 电流由主控的 3.3 V 电源轨和 Qwiic 链路承担。8 颗高亮白光的负载明显高于 MCU 待机电流,连接前检查主控稳压输出、线缆和其他节点总负载。

不要直接从 GPIO 为模块供电,也不因芯片供电范围包含其他电压就改变模块的 3.3 V Qwiic 使用条件。


快速开始

准备工作​

准备模块、Qwiic 线、匹配 3.3 V I2C 且电源能力足够的主控、USB 数据线和 Arduino IDE。为主控安装对应支持包,不把模块选为程序上传目标。

官方库示例​

  1. 主控断电,将 Pixels 接入 Qwiic。
  2. 核对 3.3 V 电源预算与所用总线,再连接 USB。
  3. 在库管理器安装官方 Arduino_Modulino 库(0.10.0,由 Arduino 官方服务器分发,不需要访问 GitHub)。
  4. 打开库内 Pixels 对应示例,核对地址、总线和亮度参数。
  5. 选择主控型号、端口,编译上传。
  6. 从单颗 LED、较低亮度开始,观察颜色与点亮位置。

官方类为 ModulinoPixels,颜色使用 ModulinoColor。设置颜色后需要调用 show 将设置更新到灯上,具体函数签名以安装版本示例为准。

官方 API 示例片段如下,需置于已完成主控总线和模块初始化的程序中,不是完整可独立上传的 Sketch:

ModulinoPixels leds;
leds.set(0, ModulinoColor(255, 0, 0));
leds.show();

片段来源:Arduino_Modulino 官方库说明。运行前结合示例设置较低亮度,避免直接以全部 LED 高亮作为首次验证。

结果与异常检查​

先验证单颗红、绿、蓝,再逐颗移动点亮,确认编号方向。随后逐步增加亮度和点亮数量,留意复位、闪烁异常或通信中断。

现象检查方法
扫描不到模块核对 3.3 V、SDA/SCL、总线及 7 位地址
设置后没有变化检查初始化、设备对象和 show 调用
点亮位置不符用单颗测试核对编号方向
高亮时复位降低负载并检查电源、线缆及其他节点耗电


RGB 灯光说明

颜色与亮度​

8 颗 LED 可分别设置 RGB 分量,用于颜色状态、进度条和逐颗动画。颜色分量数值不等于经校准的光强,不同颜色在相同数值下的视觉亮度也未必相同。

以低亮度、单颗点亮确认效果后,再增加数量。白色通常同时使用多个颜色通道,不能只根据点亮颗数而忽略颜色和亮度对电流的影响。

更新与动画​

设置像素数据后调用 show 更新输出。动画可按“设置一帧 → 更新 → 等待 → 下一帧”的顺序组织,帧间隔和接口以官方示例为准,不承诺固定刷新率。

逐颗验证编号后再制作跑马灯,避免通过反复改接线解决纯软件索引问题。

外接像素扩展​

手册提供 D0、C0 数据和时钟输出,可用于匹配 LC8822-2020 的扩展。扩展前还需核对供电、电平、固件支持的 LED 数量和库配置,不将焊盘存在理解为任意灯带即插即用。

外接更多 LED 会增加电源负载,不能只按板载 8 颗估算,也不要把额外灯带电流全部压在主控或细 Qwiic 线上。

与其他 Modulino 配合​

可由按钮、旋钮或传感器数据改变显示内容。同一 I2C 总线上的模块需地址唯一,并核对总电流、线长及上拉。软件改址后记录实际地址,便于维护。


相关资料

1. 技术手册​

2. 软件工具​

3. 其他资料​


技术支持

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

手机:13434470212

邮箱:services04@spotpear.cn

QQ:202004841