| 项目 | 参数 |
|---|---|
| 主控 | STM32C011F4 |
| LED | 8 颗 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,但未注明具体显示条件,不将其作为最大耗电;实际取决于亮度、颜色和点亮数量。
| 接口 | 信号 | 用途 |
|---|---|---|
| Qwiic 与 I2C 焊盘 | GND、3.3 V、SDA、SCL | 逻辑及 LED 供电、主控通信 |
| 调试与扩展焊盘 | GND、GND、3V3、RESET、SWCLK、SWDIO、TX1、RX1 | 调试及固件扩展 |
| LED 扩展信号 | D0、C0 | Pixels 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。为主控安装对应支持包,不把模块选为程序上传目标。
官方类为 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 调用 |
| 点亮位置不符 | 用单颗测试核对编号方向 |
| 高亮时复位 | 降低负载并检查电源、线缆及其他节点耗电 |
8 颗 LED 可分别设置 RGB 分量,用于颜色状态、进度条和逐颗动画。颜色分量数值不等于经校准的光强,不同颜色在相同数值下的视觉亮度也未必相同。
以低亮度、单颗点亮确认效果后,再增加数量。白色通常同时使用多个颜色通道,不能只根据点亮颗数而忽略颜色和亮度对电流的影响。
设置像素数据后调用 show 更新输出。动画可按“设置一帧 → 更新 → 等待 → 下一帧”的顺序组织,帧间隔和接口以官方示例为准,不承诺固定刷新率。
逐颗验证编号后再制作跑马灯,避免通过反复改接线解决纯软件索引问题。
手册提供 D0、C0 数据和时钟输出,可用于匹配 LC8822-2020 的扩展。扩展前还需核对供电、电平、固件支持的 LED 数量和库配置,不将焊盘存在理解为任意灯带即插即用。
外接更多 LED 会增加电源负载,不能只按板载 8 颗估算,也不要把额外灯带电流全部压在主控或细 Qwiic 线上。
可由按钮、旋钮或传感器数据改变显示内容。同一 I2C 总线上的模块需地址唯一,并核对总电流、线长及上拉。软件改址后记录实际地址,便于维护。
周一-周五(9:30-6:30)周六(9:30-5:30)
手机:13434470212
邮箱:services04@spotpear.cn
QQ:202004841
