littlebot
Published on 2025-04-11 / 1 Visits
0

【源码】基于Arduino的地址式LED灯带矩阵控制库

项目简介

本项目 microLED 是超轻量级库,专为运用Arduino编程语言控制地址式LED灯带或矩阵而设计。相较于FastLED、NeoPixel等同类库,凭借颜色压缩功能,其代码在SRAM中占用空间大幅缩减。此外,该库支持多种颜色模式与LED芯片类型,还原生支持地址式矩阵。

项目的主要特性和功能

  1. 颜色压缩:支持8、16和24位颜色压缩,节省SRAM空间。
  2. 多种颜色模式:提供RGB、HSV、HEX、“色轮”、16种内置颜色、色温、渐变等模式。
  3. 芯片支持:支持2811/2812/2813/2815/2818/WS6812/APA102等芯片。
  4. 无缓冲操作:可在无缓冲情况下工作,但存在一定限制。
  5. 矩阵支持:内置对地址式矩阵的支持,提供矩阵专用操作函数。
  6. 优化输出:采用优化的asm输出,提高输出效率。
  7. 中断设置:支持扩展的中断设置,可按需调整中断模式。
  8. 兼容性:与FastLED的数据类型和工具兼容,支持SPI灯带(软件和硬件)。
  9. 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】