跳到主要内容

方案管理

本文档介绍SDK如何管理方案(solution),包括方案的配置文件,如何定制方案和如何添加新方案等。

方案的配置文件

以默认方案K1为例,通常包含以下配置文件:

buildroot-ext/board/spacemit/k1/partition_*.json
buildroot-ext/board/spacemit/k1/env_k1-x.txt
buildroot-ext/board/spacemit/k1/k1-x.bmp
buildroot-ext/board/spacemit/k1/dracut.conf
buildroot-ext/board/spacemit/k1/target_overlay
buildroot-ext/configs/spacemit_k1_defconfig
bsp-src/opensbi/platform/generic/configs/k1_defconfig
bsp-src/uboot-2022.10/configs/k1_defconfig
bsp-src/linux-6.1/arch/riscv/configs/k1_defconfig

buildroot-ext/board/spacemit/k1/partition_*.json

分区配置文件:

  • partition_2M.json:for 2MB flash
  • partition_universal.json:for high capacity flash,例如eMMC、sdcard、SSD

buildroot-ext/board/spacemit/k1/env_k1-x.txt

u-boot环境变量,可定制启动参数。

buildroot-ext/board/spacemit/k1/bianbu.bmp

u-boot启动logo:

  • 格式:BMP
  • 分辨率:小于或等于屏幕分辨率
  • 位深度:32

buildroot-ext/board/spacemit/k1/dracut.conf

Dracut的配置文件,Dracut是一个制作initramfs镜像的工具。

buildroot-ext/board/spacemit/k1/target_overlay

故名思意,该目录是对target目录的overlay。

buildroot-ext/configs/spacemit_k1_defconfig

Buildroot的配置文件。

bsp-src/opensbi/platform/generic/configs/k1_defconfig

opensbi的配置文件。

bsp-src/uboot-2022.10/configs/k1_defconfig

u-boot的配置文件。

bsp-src/linux-6.1/arch/riscv/configs/k1_defconfig

kernel的配置文件。

默认分区配置

尽量不要修改bootfs前面的分区配置,避免引导代码中有hard code,修改之后无法正常引导。

eMMC分区配置

按partition_universal.json文件partitions数组配置,其中bootinfo和fsbl位于eMMC的boot0分区。

eMMC boot0分区配置如下:

-----------------------------
|/bootinfo/ | fsbl |
-----------------------------
^ ^ ^ ^
| | | |
0K 80bytes 512bytes 198.5K

eMMC GPP分区配置如下:

--------------------------------------------------------------------------------------------
| gpt | env | opensbi | uboot | bootfs | rootfs |
--------------------------------------------------------------------------------------------
^ ^ ^ ^ ^ ^ ^
| | | | | | |
0K 384K 448K 832K 4M 260M Capacity

注意

  • 如果从eMMC启动,Boot ROM从eMMC的boot0分区加载fsbl,而非GPP分区,此时GPP分区是fsbl无效的

sdcard分区配置

完全按partition_universal.json文件partitions数组配置。

分区配置如下:

--------------------------------------------------------------------------------------------
|/bootinfo/ gpt | fsbl | env | opensbi | uboot | bootfs | rootfs |
--------------------------------------------------------------------------------------------
^ ^ ^ ^ ^ ^ ^ ^ ^
| | | | | | | | |
0K 80bytes 128K 384K 448K 832K 4M 260M Capacity

SPINOR + SSD分区配置

SSD方案,需要用SPINOR引导,bootfs之前的分区都存储在SPINOR,按partition_<SPINOR size>.json文件partitions数组配置。

SPINOR分区配置如下:

----------------------------------------------------
|/bootinfo/ | fsbl | env | opensbi | uboot |
----------------------------------------------------
^ ^ ^ ^ ^ ^ ^
| | | | | | |
0K 80bytes 128K 384K 448K 640K Capacity

bootfs和rootfs存储在SSD,按partition_universal.json文件partitions数组配置。

------------------------------------------------------------------------------------------
| gpt | bootfs | rootfs |
------------------------------------------------------------------------------------------
^ ^ ^ ^
| | | |
0K 4M 260M Capacity

定制方案

添加新方案