快速开始
准备工作
准备模块、Qwiic 线、匹配 3.3 V I2C 且电源能力足够的主控、USB 数据线和 Arduino IDE。为主控安装对应支持包，不把模块选为程序上传目标。
官方库示例
- 主控断电，将 Pixels 接入 Qwiic。
- 核对 3.3 V 电源预算与所用总线，再连接 USB。
- 在库管理器安装官方 Arduino_Modulino 库。
- 打开库内 Pixels 对应示例，核对地址、总线和亮度参数。
- 选择主控型号、端口，编译上传。
- 从单颗 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 调用 |
| 点亮位置不符 | 用单颗测试核对编号方向 |
| 高亮时复位 | 降低负载并检查电源、线缆及其他节点耗电 |