在智能硬件项目中，RGB 彩灯常被用作设备状态反馈。设备启动、任务执行、待机在线、操作成功、普通警告、严重错误，都可以通过不同颜色和闪烁节奏表达出来。相比普通 LED 只能表示亮灭，WS2812 RGB 彩灯能够通过一根数据线控制多颗灯珠，每颗灯珠还可以显示不同颜色，因此非常适合做智能设备的状态提示、交互反馈和教学演示。本实验基于 CanMV K210 开发板和 WS2812 RGB 彩灯模块完成。程序使用modules.ws2812初始化 4 颗 RGB 灯珠，通过颜色定义、亮度缩放、单灯控制、整体填充、彩虹色生成等基础函数，组合出开机动画、颜色展示、流水灯、呼吸灯、彩虹流动、任务成功提示、警告闪烁和错误闪烁等效果。代码不是简单让灯亮起来，而是把 RGB 灯效设计成智能硬件状态语言，让程序运行状态可以被直接观察。学习目标说明理解 WS2812 彩灯控制方式认识 WS2812 与普通 LED 在控制方式上的区别掌握 RGB 颜色表示使用(R, G, B)三元组表示红、绿、蓝三通道颜色学会亮度缩放通过统一亮度系数降低灯光强度，避免彩灯过亮掌握灯效封装将单灯设置、整体填充、流水、呼吸、彩虹和闪烁封装成函数建立状态灯思维用不同颜色和节奏表示启动、运行、待机、成功、警告和错误状态RGB 彩灯实验的意义不只是让灯珠变色，而是建立“状态可视化”的硬件编程思路。后续接入按键、传感器、摄像头、AI 模型或网络通信后，程序可以用不同灯效表达当前运行阶段，让没有屏幕的硬件设备也具备直观反馈能力。文章目录理论基础硬件设施软件代码扩展应用总结理论基础WS2812 RGB 彩灯和普通 LED 的控制方式不同。普通 LED 通常只需要一个 GPIO 输出高低电平，就能控制亮灭。WS2812 内部集成了控制芯片，程序需要通过数据线发送颜色数据，每颗灯珠接收到对应的 RGB 数据后，才会显示指定颜色。多个 WS2812 灯珠可以串联使用，程序按顺序发送数据，就能分别控制不同位置的灯珠。RGB 颜色通常使用三个数值表示，分别对应红色、绿色和蓝色通道。比如(255, 0, 0)表示红色，(0, 255, 0)表示绿色，(0, 0, 255)表示蓝色，(255, 255, 255)表示白色。改变三个通道的数值比例，就可以混合出黄色、青色、紫色以及更多颜色。代码中的RED、GREEN、BLUE、YELLOW、CYAN、PURPLE和WHITE就是把常用颜色提前定义成变量，便于后续灯效函数调用。本实验的控制链路可以理解为“程序生成颜色数据，WS2812 控制对象缓存颜色，display()刷新到真实灯珠”。代码中的np.set_led(index, color)只是设置某颗灯珠的颜色缓存，真正让灯珠显示出来还需要执行np.display()。因此在很多灯效函数中，都会出现“设置颜色”和“刷新显示”两个动作。