
HoloCubic_AIO内存卡使用指南TF卡选择、格式与目录结构一次讲清【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIOHoloCubic_AIO 是一款基于 ESP32 的超多功能 AIO 固件内置天气时钟、相册、视频播放、桌面投屏、Web 服务和 B站粉丝动态等应用。其中相册、视频、天气图标等功能依赖TF 内存卡读取素材。本文将一次讲清内存卡的选型、格式化与目录结构让你第一次插卡就能成功使用。一、哪些应用依赖内存卡固件启动时会检测并挂载 TF 卡代码位于 sd_card.cpp挂载成功后以下功能才能完整使用应用读取的目录用途 相册/image/浏览本地图片.bin 格式 视频播放/movie/播放 MJPEG 小视频️ 天气时钟/weather/显示对应天气的动画图标 B站粉丝/bilibili/显示用户头像 想法/LHLXW/LHLXW/自定义表情包、图片、启动动画️ 桌面投屏/image/作为默认桌面壁纸 没有内存卡也能运行基础功能但上述应用会提示无素材或显示默认画面。二、TF 卡怎么买3 个要点固件通过 SPI 四线模式、80MHz 速率挂载 SD 卡见 sd_card.cpp#L85-L92选卡时记住 3 点类型SDSC / SDHC 均可固件会打印卡类型推荐 8GB32GB 的 SDHC 卡容量足够放视频和图标速度Class 4 以上即可普通消费级卡就够用无需 UHS 高速卡品牌优先选用带正规厂标的卡劣质杂牌卡容易出现挂载失败或读图花屏。⚠️ 注意SD 卡槽是 4 线 SPI 接口不要选用 MMC 卡或 MicroSD 转接座过厚的组合插拔不牢会导致断卡。三、TF 卡格式化的最快方法文件系统格式化为FAT32小卡或exFAT大于 32GB 的卡操作步骤电脑中打开 Windows 自带磁盘管理或 Mac 的磁盘工具 → 选择 TF 卡 → 格式化 → 文件系统选 FAT32 → 完成簇大小保持默认即可无需手动调整。四、内存卡目录结构一次看懂仓库中 放置到内存卡/ 目录就是现成的内存卡内容模板把它拷贝到 TF 卡根目录即可开箱使用。标准目录结构如下TF卡根目录/ ├── movie/ # 视频.mjpeg240x240、20fps ├── image/ # 相册图片.bin 格式 ├── weather/ # 天气动画图标.bin 格式 ├── bilibili/ # B站头像 avatar.bin └── LHLXW/ # 自定义内容 ├── cyber/ # 图片 img0~99.cyber cyber_num.txt ├── emoji/ # 表情包 videos/ images/ emoji_num.txt └── log_anim/ # 启动动画背景 bg.bin1. 视频目录/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. 自定义内容/LHLXW/emoji 表情包videos/video1.mjpeg240x240 视频images/image1.bin60x60 封面视频数、封面数必须与emoji_num.txt中填写的个数如07一致规则说明见 emoji.cppcyber 图片img0.cyberimg99.cyber数量写入 cyber_num.txt启动动画背景替换 log_anim/bg.bin 即可换启动画面。根据官方说明放置到内存卡/README.mdweather_ico_code/和hefeng_rename.py仅用于工程备份可以不放进内存卡。五、图片格式怎么转换用 AIO_Tool仓库内的 PC 端工具 AIO_Tool/ 自带图片转换功能images_converter.py可以把 JPG/PNG 一键转成固件需要的.bin格式避免手动处理 16 位色的麻烦六、常见问题快速排查现象可能原因解决方法启动日志显示 Card Mount Failed卡未插紧 / 卡损坏重新插拔换卡测试能读卡但相册不显示图片图片不是 .bin 格式用 AIO_Tool 重新转换天气图标全部变成默认图图标文件名/代码不匹配对照 weather/ 核对命名表情包数量不对三个数量不一致保证emoji_num.txt 视频数 封面数七、相关参考资料内存卡内容模板放置到内存卡/SD 卡驱动源码AIO_Firmware_PIO/src/driver/sd_card.cpp天气图标命名脚本放置到内存卡/hefeng_rename.pyPC 端转换工具AIO_Tool/小白避坑指南HoloCubic小电视──小白避坑指南v2.3.md项目问答QA.md按本文准备一张 FAT32 格式化的 8GB32GB 内存卡把模板目录拷贝进去即可点亮 HoloCubic_AIO 的全部多媒体功能 【免费下载链接】HoloCubic_AIOHoloCubic超多功能AIO固件 基于esp32-arduino的天气时钟、相册、视频播放、桌面投屏、web服务、bilibili粉丝等项目地址: https://gitcode.com/GitHub_Trending/ho/HoloCubic_AIO创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考