配置分区

启动分区

在 Luban-Lite 系统中，启动分区（"spl" 分区）是存储介质上的第一个分区，用于存放 BootLoader，并且根据不同的存储介质类型和配置，其位置、大小和内容有所不同。

"spl" 分区为默认名称，用户可以根据需要自定义和修改启动分区名称。

Luban-Lite 系统中的默认分区设置如下：

• SPINOR

  SPINOR Flash 的 0 ~ X 区间被设置为启动分区，主要用于存放 BootLoader，大小设置为 256K。

  尽管 BROM 加载的程序可以大于 256K，但是由于 BROM 运行时的速度较慢，不建议加载过大的程序。

• SPINAND

  SPINAND Flash 的前四个物理块被用作启动块，启动分区内使用四个启动块保存两份启动镜像：

  • 对于块大小为 128K 的 SPINAND，启动分区为 512K。
  • 对于 块大小为 256K 的 SPINAND，启动分区为 1M。

• eMMC

  eMMC 的启动分区位于 UDA 区域的 17K ~ X 区间，BROM 从该区域读取程序。

  建议启动镜像小于 512K。

数据分区

系统 A/B 分区

分区与存储设备关系

Luban-Lite 上使用 RT-Thread 时，每个分区都对应一个或者多个系统设备。不同存储介质的对应关系如下表格所示。系统中出现但此处未列出的其他分区，同样遵循下列规则。

• 分区名：
  • "spl"：分区及其设备名，"spl" 分区主要用于存储二次引导加载程序，是系统启动的第一个阶段所加载的程序。
  • "os"："os" 分区，存放操作系统的主要部分，是系统运行的核心区域。
  • "rodata"："rodata" 分区，主要用于存储只读数据，包括系统在运行时需要读取但不修改的配置信息等。
  • "data"："data" 分区，用来存储可变数据，如用户生成的数据或系统运行时产生的临时数据。
• MTD 设备名：对 Flash 的底层直接访问，便于进行读写硬件等操作。
• 块设备名：通过将物理存储抽象为块设备，简化了对文件系统的操作。仅 "rodata" 分区关联了一个块设备名 "blk_rodata"。
• 文件系统："rodata" 分区使用 FATFS 文件系统，使得数据以文件的形式进行存储和管理。"data" 分区使用 LittleFS 文件系统。
• 访问规则：

  • 直接访问 Flash，使用 MTD 设备

  • FATFS 访问 Flash，需要使用块设备

  • LittleFS 访问 Flash，使用 MTD 设备

• 分区名：
  • "spl"：分区及其设备名，"spl" 分区主要用于存储 二次引导加载程序，是系统启动的第一个阶段所加载的程序。
  • "os"："os" 分区，存放操作系统的主要部分，是系统运行的核心区域。
  • "rodata"："rodata" 分区，主要用于存储只读数据，包括系统在运行时需要读取但不修改的配置信息等。
  • "data"："data" 分区，用来存储可变数据，如用户生成的数据或系统运行时产生的临时数据。
• MTD 设备名：对 Flash 的底层直接访问，便于进行读写硬件等操作。
• 块设备名：通过将物理存储抽象为块设备，简化了对文件系统的操作。"blk_rodata" 和 "blk_data" 分别支持对 "rodata" 和 "data" 分区的文件系统访问。
• 文件系统："rodata" 分区使用 FATFS 文件系统，使得数据以文件的形式进行存储和管理。"data" 分区使用 FATFS 文件系统。
• NFTL 层：网络闪存转换层，主要用来将 Flash 的物理特性映射为一般块设备，便于 FATFS 等文件系统无需关心底层 NAND Flash 的具体特性。
  注：

  建议只设置一个使用 NFTL 的分区，并且分区不要太小。因为 NFTL 需要预留至少 6 MB 空间做坏块管理。

• 访问规则：

  • 直接访问 Flash，使用 MTD 设备

  • FATFS 访问 Flash，需要使用块设备，通过 NFTL 层访问 Flash

• 分区名：
  • "spl"：分区及其设备名，"spl" 分区主要用于存储 二次引导加载程序，是系统启动的第一个阶段所加载的程序。
  • "os"："os" 分区，存放操作系统的主要部分，是系统运行的核心区域。
  • "rodata" ："rodata" 分区，主要用于存储只读数据，包括系统在运行时需要读取但不修改的配置信息等。
  • "data"："data" 分区，用来存储可变数据，如用户生成的数据或系统运行时产生的临时数据。
• MTD 设备名：对 Flash 的底层直接访问，便于进行读写硬件等操作。
• 块设备名：块设备按照分区顺序从 0 开始编号，例如从 mmc0p0 到 mmc0p3。每个块设备代表 eMMC 中的一个分区，简化了物理存储到逻辑存储的映射，便于后续的文件系统管理。
• 文件系统："rodata" 和 "data" 分区均使用 FATFS 文件系统。
• 访问规则：块设备的命名，按照分区的排序从 0 开始编号

修改分区

image_cfg.json 文件是设置分区信息以及如何生成烧录镜像文件的配置文件，由于分区和烧录信息是相互关联的，因此在一个文件中进行配置。 image_cfg.json 文件的保存路径为 target/chip/board/pack/image_cfg.json。

输入分区 "size" 值时，需要注意存储介质的对齐要求：

• SPINOR: 与最小擦除块大小对齐，一般为 4K 或者 64K，具体请参考 SPINOR 的数据手册。

• SPINAND: 与最小擦除块大小对齐，一般为 128K 或者 256K，具体请参考 SPINAND 的数据手册。

• eMMC: 需要 512 字节对齐。

分区配置示例

"spi-nor": {
    "size": "16m", // Size of SPI NOR
    "partitions": {
        "spl":        { "size": "256k" },
        "env":        { "size": "128k" },
        "env_r":      { "size": "128k" },
        "os":         { "size": "1m" },
        "os_r":       { "size": "1m" },
        "rodata":     { "size": "3m" },
        "rodata_r":   { "size": "3m" },
        "data":       { "size": "7m" }
    },
},

"spi-nand": {
    "size": "128m", // Size of SPI NAND
    "partitions": {
        "spl":      { "size": "1m" },
        "env":      { "size": "256k" },
        "env_r":    { "size": "256k" },
        "os":       { "size": "4m" },
        "os_r":     { "size": "4m" },
        "rodata":   { "size": "12m" },
        "rodata_r": { "size": "12m" },
        "data": {
            "size": "40m",
            "nftl": { // Volume in NFTL device
                "datavol": { "size": "-" },
            },
        },
    },
},

"mmc": {
    "size": "8G", // Size of SD/eMMC
    "partitions": {
        "spl":        { "offset": "0x4400", "size": "256k" },
        "os":         { "size": "1m" },
        "rodata":     { "size": "3m" },
        "data":       { "size": "5m" }
    },
},