项目简介
本项目 microLED
是超轻量级库,专为运用Arduino编程语言控制地址式LED灯带或矩阵而设计。相较于FastLED、NeoPixel等同类库,凭借颜色压缩功能,其代码在SRAM中占用空间大幅缩减。此外,该库支持多种颜色模式与LED芯片类型,还原生支持地址式矩阵。
项目的主要特性和功能
- 颜色压缩:支持8、16和24位颜色压缩,节省SRAM空间。
- 多种颜色模式:提供RGB、HSV、HEX、“色轮”、16种内置颜色、色温、渐变等模式。
- 芯片支持:支持2811/2812/2813/2815/2818/WS6812/APA102等芯片。
- 无缓冲操作:可在无缓冲情况下工作,但存在一定限制。
- 矩阵支持:内置对地址式矩阵的支持,提供矩阵专用操作函数。
- 优化输出:采用优化的asm输出,提高输出效率。
- 中断设置:支持扩展的中断设置,可按需调整中断模式。
- 兼容性:与FastLED的数据类型和工具兼容,支持SPI灯带(软件和硬件)。
- millis()函数支持:仅对AVR芯片,可保证millis()函数正常工作。
安装使用步骤
安装
假设用户已下载本项目的源码文件,有以下安装方式:
1. 通过库管理器安装:在Arduino IDE、Arduino IDE v2或PlatformIO的库管理器中,搜索 microLED
并安装。
2. 手动安装:
- Windows x64系统:将下载的.zip文件解压后,放入 C:\Program Files (x86)\Arduino\libraries
文件夹。
- Windows x32系统:解压后放入 C:\Program Files\Arduino\libraries
文件夹。
- 其他系统:解压后放入 Документы/Arduino/libraries/
文件夹。
- 在Arduino IDE中,可通过“Скетч/Подключить библиотеку/Добавить.ZIP библиотеку…” 选择下载的.zip文件进行自动安装。
使用
初始化
cpp
microLED< amount, pin, clock, chip, order, cli, millis>
// amount:灯带中的LED数量,若在流模式下工作可设为0
// pin:连接灯带数据输入的引脚
// clock:连接灯带时钟输入的引脚,仅适用于SPI灯带(如APA102),普通WS系列灯带设为MLED_NO_CLOCK或 -1
// chip:灯带(LED)型号,如LED_WS2811、LED_WS2812等
// order:灯带中的颜色顺序,如ORDER_RGB、ORDER_RBG等
示例:
cpp
microLED< NUMLEDS, STRIP_PIN, -1, LED_WS2812, ORDER_GRB> strip;
基本操作
cpp
// 设置单个LED颜色
strip.set(0, mRGB(255, 0, 0));
// 填充颜色
strip.fill(mYellow);
// 显示更新
strip.show();
更多详细使用方法,请参考扩展文档。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】