项目简介
本项目作为前一版本LED Matrix的升级版,是基于C++和FTXUI框架的LED矩阵显示系统。主要为高密度LED矩阵表提供动画效果,可在终端界面模拟和控制LED矩阵显示屏。同时配备了Web服务器和WebSocket服务器,方便用户通过Web浏览器进行配置和控制。
项目的主要特性和功能
- 硬件控制:运用C++代码控制WS281X LED矩阵显示屏,可设置像素颜色、更新显示内容。
- 动画效果:具备渐变、扫描线、静态、闪烁等多种动画,用户能通过图形界面选择并调整参数。
- Web服务器:提供HTTP服务,用户可通过Web浏览器访问并配置、控制系统。
- WebSocket服务器:实现实时双向通信,用于接收和发送数据。
- 图形界面:利用FTXUI库创建,方便用户选择动画、调整参数。
安装使用步骤
硬件准备
- 10.5m WS2812b LED灯带(60灯珠/米)
- IKEA Lack桌子
- 电源(5V,足以驱动所有LED灯珠)
- ESP32 - C3(WEMOS C3 mini)
软件安装与运行
- 安装PlatformIO:使用喜欢的IDE(如VSCode)安装,具体步骤参考此处。
- 复制项目仓库:
sh
- 打开项目:
shell cd ledmatrix-v2 code .
- 连接硬件并上传程序:通过USB连接ESP32 - C3,在VisualCode中选择
env
变体ledmatrix - local进行构建,路径为PlatformIO图标 -> env:ledmatrix - local -> Build
,在同一菜单中选择upload
;也可使用命令:bash pio run -e ledmatrix-local --target upload
- 环境准备:安装C++编译器和FTXUI库。
- 代码编译:使用C++编译器编译项目代码,生成可执行文件。
- 运行程序:运行生成的可执行文件,启动LED矩阵显示系统。
- 配置和控制:通过Web浏览器访问项目提供的Web服务器,进行配置和控制。
开发环境
开发可在微控制器上进行,也可在模拟器中本地运行。模拟器依赖系统GCC工具链,需将其添加到PATH
系统环境变量中。若在系统终端输入gcc --version
提示未找到gcc
命令,需根据操作系统手动安装GCC工具链。
使用pio run --environment simulation - native --target exec
构建并运行模拟器,或省略--target exec
仅构建并在偏好的终端中运行。
注意事项
- 需支持WS281X LED矩阵显示屏的硬件。
- 需连接到WiFi网络。
- 需安装FTXUI库以支持图形界面开发。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】