HoloCubic-AIO-Enhanced：全功能固件

项目简介

HoloCubic-AIO-Enhanced 是运行在 HoloCubic 硬件上的第三方独立固件。AIO 即 All in One，目标是在保持开源的前提下尽可能集成更多功能。项目基于 PlatformIO、Arduino 与 LVGL 开发，固件代码量超过 20,000 行，配套上位机约 4,000 行（不含字体库与图片），适合 HoloCubic 用户、DIY 玩家和嵌入式开发者学习与二次开发。

HoloCubic 最初是稚晖君的开源项目，本固件在其硬件上运行，并沿用原 AIO 项目的框架继续扩展。

主要功能

• 内置天气、时钟、相册、特效、视频播放器、PC 屏幕共享、网页设置等 APP，并提供股票、PC 资源监控、番茄钟、BiliBili 粉丝计数等扩展应用。
• 模块化、低耦合架构，方便继续添加 APP 和功能。
• 硬件兼容性较灵活：无论是否插入 TF 卡、是否焊接 MPU6050、是否连接 WiFi，设备都能正常启动（WiFi 需 2.4G）。
• 网页配置服务采用 Glass 风格界面，支持 English / 简体中文 / 繁體中文，提供设备状态展示、表单提示、文件上传、下载、删除与 WiFi 扫描。
• 可通过设备热点、局域网 IP 或 http://holocubic 访问网页配置；设置页使用 HTTP Basic 认证，用户名为 admin，密码为设备 WebServer 界面显示的 6 位字符。
• 文件管理器支持通过 FTP 无线管理 TF 卡：ftp://holocubic:aio@[YOUR_IP]。
• 配套 AIO Tool 上位机可一键烧录固件、引导程序、分区表，查看串口调试日志，并能发送方向指令模拟 MPU6050 动作，方便测试和演示。

安装与使用

1. 从 Release 页面下载最新固件与配套烧录工具。首次烧录通常需要 bootloader.bin、partitions.bin、boot_app0.bin 和 HoloCubic_AIO_XXX.bin 四个文件。
2. 将烧录文件与 CubicAIO_Tool-*-x86_64-windows-setup.exe 放在同一目录，运行工具，选择最新固件并烧录。v3.5.0 的 Release 说明给出的地址为：bootloader_qio_80m.bin → 0x1000、partitions.bin → 0x8000、boot_app0.bin → 0xe000、应用固件 → 0x10000；工具的 Flasher 页可一键完成。
3. 首次使用网页配置时，先连接设备热点 HoloCubic_AIO（无密码，地址 192.168.4.2），或使用设备屏幕显示的局域网 IP，然后进入网页设置网络与参数。
4. TF 卡需为 FAT32 格式。首次使用相册、视频等功能前，把 放置到内存卡 目录中的文件和文件夹复制到 TF 卡根目录。
5. 相册图片放在 image/ 目录，支持 .jpg 或 .bin；视频放在 movie/ 目录，支持 .mjpeg 或 .rgb。文件名需为字母数字组合，且不能以数字开头。
6. 手势操作：左右摇晃约 0.5 秒切换 APP；向前倾斜约 1 秒进入当前 APP；向后倾斜约 1 秒退出当前 APP。

注意事项

• 设备使用 MPU6050 陀螺仪/加速度计，开机后前 3 秒请保持设备静止，等待传感器初始化完成（RGB 灯完全亮起）后再操作。若 MPU6050 焊接不良，方向读数会异常，表现为 APP 不断切换。
• TF 卡不影响开机，但相册、视频播放等功能需要 TF 卡。
• 网页设置密码每台设备不同，以设备 WebServer 屏幕显示的 6 位字符为准。
• v3.5.0 的 Windows 安装包未签名，可能触发 SmartScreen 提示；macOS DMG 未签名，首次启动需右键选择“打开”；Linux AppImage 需要 libwebkit2gtk-4.1 与 libudev1，旧发行版可能需手动安装。烧录前可用 sha256sum -c SHA256SUMS 校验下载文件。
• 本项目为第三方固件，采用 GPL-3.0 许可证；用于二次开发或参考时请保留相应署名。

本作品整理自 GitHub 开源项目 asdfghj1237890/HoloCubic-AIO-Enhanced，原作者 @asdfghj1237890，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。