项目简介
这是一个开源的LED Cube控制器项目,以ESP系统为硬件平台,通过编程实现对LED Cube显示的控制。项目拥有多种图案模式,如时钟、蛇游戏、等离子体效果等,用户还能通过互联网更新固件,以添加新功能或修复现有问题。
项目的主要特性和功能
特性
- 代码开源,方便开发者进行二次开发与调试。
- 模块化设计,各功能单独编写在文件中,利于维护与扩展。
- 采用FreeRTOS任务调度系统,实现多任务并行处理,提升系统运行效率。
功能
- 可控制LED Cube的显示,具备图案显示、时钟显示、游戏等功能。
- 包含多种图案模式,例如时钟、蛇游戏、等离子体效果等。
- 实现Spotify播放器功能,能在LED Cube上显示音乐播放信息。
安装使用步骤
开发环境搭建
为LED Cube构建固件,仅需一个集成开发环境(IDE)和PlatformIO。以VSCode为例,可参考此处设置PlatformIO。复制此仓库并在IDE中打开,即可开始构建。
构建
本项目使用ESPIDF并将Arduino作为组件,借助PlatformIO构建和上传固件。在IDE中点击构建按钮即可完成构建,也可使用PlatformIO命令行界面进行构建,详情参考此处。
上传
目前,LED Cube支持3种上传新固件的方法:
1. OTA更新:开发时最简便的上传方法。需确保LED Cube连接到网络,并在platformio.ini
中取消以下两行注释,且LED Cube与电脑处于同一网络:
ini
upload_protocol = espota
upload_port = cube.local
然后在IDE中点击上传按钮,固件将通过网络上传到LED Cube,上传完成后LED Cube会重启并运行新固件。
2. 使用USB转串口适配器:若上传的固件导致OTA功能损坏或用于调试时使用。需将LED Cube通过USB连接到电脑,连接Cube的GND到适配器的GND、Cube的TX到适配器的RX、Cube的RX到适配器的TX,然后在platformio.ini
中注释以下两行:
ini
;upload_protocol = espota
;upload_port = cube.local
接着在IDE中点击上传按钮,固件将通过串口上传到LED Cube,上传完成后LED Cube会重启并运行新固件。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】