企业官网建设流程全解析

HoloCubic_AIO内存卡使用指南：TF卡选择、格式与目录结构一次讲清

【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO

HoloCubic_AIO 是一款基于 ESP32 的超多功能 AIO 固件，内置天气时钟、相册、视频播放、桌面投屏、Web 服务和 B站粉丝动态等应用。其中相册、视频、天气图标等功能依赖TF 内存卡读取素材。本文将一次讲清内存卡的选型、格式化与目录结构，让你第一次插卡就能成功使用。

一、哪些应用依赖内存卡？

固件启动时会检测并挂载 TF 卡（代码位于 sd_card.cpp），挂载成功后以下功能才能完整使用：

💡 没有内存卡也能运行基础功能，但上述应用会提示无素材或显示默认画面。

二、TF 卡怎么买？3 个要点

固件通过 SPI 四线模式、80MHz 速率挂载 SD 卡（见 sd_card.cpp#L85-L92），选卡时记住 3 点：

1. 类型：SDSC / SDHC 均可（固件会打印卡类型），推荐 8GB～32GB 的 SDHC 卡，容量足够放视频和图标；
2. 速度：Class 4 以上即可，普通消费级卡就够用，无需 UHS 高速卡；
3. 品牌：优先选用带正规厂标的卡，劣质杂牌卡容易出现挂载失败或读图花屏。

⚠️ 注意：SD 卡槽是 4 线 SPI 接口，不要选用 MMC 卡或 MicroSD 转接座过厚的组合，插拔不牢会导致断卡。

三、TF 卡格式化的最快方法

• 文件系统：格式化为FAT32（小卡）或exFAT（大于 32GB 的卡）；
• 操作步骤：电脑中打开 Windows 自带"磁盘管理"或 Mac 的"磁盘工具" → 选择 TF 卡 → 格式化 → 文件系统选 FAT32 → 完成；
• 簇大小：保持默认即可，无需手动调整。

四、内存卡目录结构一次看懂

仓库中 放置到内存卡/ 目录就是现成的内存卡内容模板，把它拷贝到 TF 卡根目录即可开箱使用。标准目录结构如下：

TF卡根目录/ ├── movie/ # 视频（.mjpeg，240x240、20fps） ├── image/ # 相册图片（.bin 格式） ├── weather/ # 天气动画图标（.bin 格式） ├── bilibili/ # B站头像 avatar.bin └── LH&LXW/ # 自定义内容 ├── cyber/ # 图片 img0~99.cyber + cyber_num.txt ├── emoji/ # 表情包 videos/ + images/ + emoji_num.txt └── log_anim/ # 启动动画背景 bg.bin

1. 视频目录/movie/

视频必须是MJPEG 格式（扩展名.mjpeg），分辨率240x240、约20fps，例如 butterfly_240x240_20fps.mjpeg。文件名建议用英文，避免中文乱码。

2. 相册目录/image/

图片需转换为.bin格式（16位色），仓库内提供了转换示例 butterfly_1.bin。除了手动拷贝，也可以通过网络在 Web 服务的设置页上传，文件会自动保存到/image/目录（逻辑见 web_setting.cpp）。

3. 天气图标/weather/

这是目录最多的部分（约 60 个图标）。命名规则为天气名_天气代码.bin，例如Clear_150.bin、HeavyRain_307.bin，代码对应和风天气的天气状态码。转换脚本参考 hefeng_rename.py，代码备份见 weather_ico_code/。

4. 自定义内容/LH&LXW/

• emoji 表情包：videos/video1.mjpeg（240x240 视频）+images/image1.bin（60x60 封面），视频数、封面数必须与emoji_num.txt中填写的个数（如07）一致，规则说明见 emoji.cpp；
• cyber 图片：img0.cyber～img99.cyber，数量写入 cyber_num.txt；
• 启动动画背景：替换 log_anim/bg.bin 即可换启动画面。

根据官方说明（放置到内存卡/README.md），weather_ico_code/和hefeng_rename.py仅用于工程备份，可以不放进内存卡。

五、图片格式怎么转换？用 AIO_Tool

仓库内的 PC 端工具 AIO_Tool/ 自带图片转换功能（images_converter.py），可以把 JPG/PNG 一键转成固件需要的.bin格式，避免手动处理 16 位色的麻烦：

六、常见问题快速排查

七、相关参考资料

• 内存卡内容模板：放置到内存卡/
• SD 卡驱动源码：AIO_Firmware_PIO/src/driver/sd_card.cpp
• 天气图标命名脚本：放置到内存卡/hefeng_rename.py
• PC 端转换工具：AIO_Tool/
• 小白避坑指南：HoloCubic小电视──小白避坑指南v2.3.md
• 项目问答：Q&A.md

按本文准备一张 FAT32 格式化的 8GB～32GB 内存卡，把模板目录拷贝进去，即可点亮 HoloCubic_AIO 的全部多媒体功能 🎉

【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO