Edit online

系统镜像制作

4 Nov 2024
Read time: 2 minute(s)

本文介绍如何通过工具单独制作 Luban-Lite SDK 支持的文件系统镜像。

Luban-Lite SDK 在编译的最后阶段会自动制作所需要的文件系统镜像。如需独立制作文件系统镜像，可遵照以下流程：

制作 FATFS 镜像

  1. 确保编译主机上已经安装 Python3，并进入 Luban-Lite SDK 的根目录。

  2. 将需要打包的文件/文件夹，放到一个独立的文件夹内，例如：
    • Linux: ~/fatfs_root/
    • Windows: D:\fatfs_root\
  3. 根据资源文件大小制作镜像或制作指定大小的文件系统镜像。

    • 场景 1：根据资源文件大小制作镜像

      执行下列命令：
      Windows:
python tools\scripts\makefatfs.py --auto --cluster 8 --sector 512 --tooldir tools\scripts\ --inputdir D:\fatfs_root\ --outfile mytest.fatfs

    • 场景 2：制作指定大小的文件系统镜像

      这种场景类似给指定大小的磁盘做格式化，并且复制填充资源文件，如制作一个 100 MB 的 FATFS 镜像，执行下列命令：
      Windows:
python tools\scripts\makefatfs.py --raw --imgsize 104857600 --cluster 8 --sector 512 --tooldir tools\scripts\ --inputdir D:\fatfs_root\ --outfile mytest.fatfs

      由于设置了 imgsize 为 100 MB，因此生成的镜像文件大小为 100 MB，可以将该镜像文件烧录到 100 MB 的磁盘分区。

      如果实际资源大小不足 100 MB，工具会自动在镜像文件后面填充 0。如果不需要填充，可以去掉命令参数中的 --raw，此时生成的镜像文件仅保留必要数据部分。详细示例如下：
      Windows:
python tools\scripts\makefatfs.py --imgsize 104857600 --cluster 8 --sector 512 --tooldir tools\scripts\ --inputdir D:\fatfs_root\ --outfile mytest.fatfs

FATFS 镜像格式说明

按照制作 FATFS 镜像流程生成的 FATFS 镜像，具体格式取决于指定的镜像大小，详情如下：

表 1. 表 3.1FATFS 格式
文件系统 镜像大小 说明
FAT12 Size ≤ 16 MB 生成 FAT12 文件系统镜像。
FAT16 16 MB < Size ≤ 256 MB 生成 FAT16 文件系统镜像。
FAT32 Size > 256 MB 生成 FAT32 文件系统镜像

制作 LittleFS 镜像

以制作一个 10 MB 的 LittleFS 镜像文件为例，详细步骤如下所示：

  1. 确保编译主机上已经安装 Python3 并进入 Luban-Lite SDK 的 tools/scripts/ 目录。

  2. 将需要打包的文件/文件夹，放到一个独立的文件夹内，例如：
    • Linux: ~/littlefs_root/
    • windows: D:\littlefs_root\
  3. 执行命令。
    Windows:
python tools\scripts\makelittlefs.py --imgsize 10485760 --pagesize 256 --blocksize 4096 --tooldir tools\scripts\ --inputdir ~\littlefs_root\ --outfile mytest.lfs