自动化分区配置

[English]

备注

本节旨在介绍如何为新增工程适配自动化分区

自动化分区配置表

自动化分区配置表为 csv 文件，以下为一个配置示例

#Name

Offset

Size

Type

Read

Write

bootloader

68k

code

TRUE

FALSE

app

1836k

code

TRUE

FALSE

app1

476k

code

TRUE

FALSE

app2

136k

code

TRUE

FALSE

download

1428k

data

TRUE

usr_config

136k

data

TRUE

easyflash

0x3fc000

8k

data

TRUE

rf_firmware

0x3fe000

4k

data

TRUE

net_param

0x3ff000

4k

data

TRUE

分区表固定为六列：

  • Name - 必选项，表示分区名字。

    • 分区名必须唯一。构建系统会依据分区名字来生成一组宏，只有分区名字唯一才能确保生成宏不会重复定义。

    • binname 表示分区中放置的二进制文件名字，Type被配置为code的分区对应构建系统中生成的二进制文件。 例如，bootloader分区中放置的二进制文件为bootloader.bin; app分区中放置的二进制文件为app.bin。

    • 保留分区，保留分区为 Armino 已有特定用途的分区：

      • bootloader - Type被配置为code，对应构建系统编译出来bootloader.bin，Size为bootloader.bin的实际大小的34/32倍

      • app - Type被配置为code，对应构建系统编译出来app.bin, Size为app.bin的实际大小的34/32倍

      • app1 - Type被配置为code，对应构建系统编译出来app1.bin， Size为app1.bin的实际大小的34/32倍

      • app2 - Type被配置为code，对应构建系统编译出来app2.bin，Size为app2.bin的实际大小的34/32倍

      • download - Armino 中特有分区，ota会用到这个分区，当不需要ota功能时，该分区Size可以保留配置为4K

      • usr_config - Armino 中特有分区，文件系统会用到这个分区，该分区Size可以以4K为单位适当增减

      • easyflash - Armino 中特有分区，Size和Offset固定不可自定义变更

      • rf_firmware，net_param - Armino 中特有分区，RF 校准，Wi-Fi/TCPIP 会用到这两个分区。Size和Offset固定不可自定义变更

  • Offset - 可选项。表示分区在 FLASH 的物理偏移量。

  • Size - 必选项。表示分区大小，单位 k/K 表示 Kbytes，m/M 表示 Mbytes，通常建议 4K 对齐。

    • 当分区 Type 域被配置为code时，size建议68k对齐

  • Type - 必选项。配置为code时，表示分区为可执行的代码区。配置为data时，表示分区为不可执行的数据区。

  • Read - 可选项。分区可读权限，不配置时，表不可读。

  • Write - 可选项。分区可写权限，不配置时，表不可写。

以bk7258芯片为例，参考/projects/app新建工程/projects/template，工程目录结构如下：

8

若有修改分区的需求，为修改方便，通常需要遵循以下步骤：

  • 基于自动化分区CSV表 config/bk7258/bk7258_partitions.csv 进行分区信息修改

    • 保留分区需要遵循保留分区的修改规则

    • 新增分区建议加在user_config和easyflash分区之间，且需要的Size建议通过缩减user_config分区Size获得

    • 所有分区的Size总和不得超过所用flash的实际Size

  • 在config/bk7258/config文件中配置宏 CONFIG_OVERRIDE_FLASH_PARTITION=y

  • 找到ARMINO分区自动化支持组件，将新建的工程名 template 添加到 components/part_table/CMakeLists.txt 和 components/part_table/part_table.mk 文件所定义的支持列表中，如下图所示：

    components/part_table/CMakeLists.txt文件修改如下：

    8

    components/part_table/part_table.mk文件修改如下：

    8

  • 编译工程template - 编译服务器shell终端输入make bk7258 PROJECT=template 编译完成后，工程/projects/template的目录结构如下：

    8

    可以看到工程目录中新增了文件config/bk7258/configuration.json和config/bk7258/partitions.csv，同时 main/vendor_flash.c和main/vendor_flash_partition.h文件的内容会同步更新