描述

本文档介绍如何为本框架适配新的开发板。

新开发板适配指南

准备内核

移植 openEuler 内核

内核移植是难度较大的工作，具体步骤不做介绍，移植 openEuler 内核的大致流程如下：

移植相关的内核驱动到以下仓库：
- 瑞芯微：
  
  https://gitee.com/openeuler/rockchip-kernel.git
- 飞腾：
  
  https://gitee.com/openeuler/phytium-kernel.git
- 全志：
  
  https://gitee.com/openeuler/allwinner-kernel.git
如果内核仓库中已经存在相关驱动，则只需要在相应内核仓库提交对应开发板的内核设备树即可。

使用 BSP 内核

如果想使用 BSP 内核进行测试，可以在构建指令中指定 BSP 内核的仓库地址及对应分支，参考构建完整镜像。

准备 u-boot

RK3399

在版型文件中定义 u-boot 配置名称，参考下文编写版型文件。
RK35xx

需要将编译好的 u-boot 二进制文件放到 u-boot 目录下，并在版型文件中增加文件路径。

准备 firmware 文件

这里提到的 firmware 是开发板的板载蓝牙和 WiFi 的驱动固件，可参考本框架储存的的 firmware 文件。

请确定开发板所使用的 firmware，并提交至仓库的相应目录下。

编写版型文件

适用的开发板的版型配置文件在 boards 文件夹中，版型文件示例如下：

ubootconfig=firefly-rk3399_defconfig  #Required! The name of defconfig file when compiling u-boot, which defaults to firefly-rk3399_defconfig.
dtb_name=rk3399-firefly  #Required! The device tree name of target board, which defaults to rk3399-firefly.
platform=rockchip  #Required! The platform of target board, which defaults to rockchip.

POST_BOARD_OVERLAY() {
    echo "Put ${board} firmware into rootfs..."

    mkdir -p ${rootfs_dir}/usr/lib/firmware/brcm
    cp ${nonfree_bin_dir}/linux-firmware/ap6356s/brcmfmac4356-sdio.bin ${rootfs_dir}/usr/lib/firmware/brcm
    cp ${nonfree_bin_dir}/linux-firmware/ap6356s/brcmfmac4356-sdio.firefly,firefly-rk3399.txt ${rootfs_dir}/usr/lib/firmware/brcm
    cp ${nonfree_bin_dir}/linux-firmware/ap6356s/BCM4356A2.hcd ${rootfs_dir}/usr/lib/firmware/brcm
}

其包括的配置参数意义如下：

ubootconfig=UBOOT_DEFCONFIG

开发板对应的 defconfig 的文件名称，对应 u-boot/configs 下 UBOOT_DEFCONFIG 文件，默认为 firefly-rk3399_defconfig；如需在 RK3568/RK3588 开发板上使用预编译的 u-boot，可以将此项设置为空：ubootconfig=。

如果设置为空 ``，则还需添加以下附属配置参数：
- local_uboot_dir
  
  开发板 u-boot 配置设置为空时，本地预编译的 u-boot 二进制文件的位置。
dtb_name=DTB_NAME

内核设备树中的设备名称，和开发板名称有一点区别，对应 kernel/arch/arm64/boot/dts/rockchip 下的 DTB_NAME.dts 文件。
platform=PLATFORM

开发板所使用的平台，目前支持的平台有：rockchip、phytium。
soc_name=SOC_NAME

开发板所使用的具体芯片型号，目前支持的芯片型号有：
- rockchip: rk3399, rk3566, rk3568, rk3588
- phytium: e2000q
- allwinner: h616
part_table

开发板所使用的分区表，目前使用的有：
- gpt: rockchip, phytium
- msdos: allwinner
boot_size

开发板系统镜像的大小，单位为：MB。
POST_BOARD_OVERLAY()

POST_BOARD_OVERLAY() 是执行复制 firmware 文件到根目录以及对目标开发板根目录执行特定操作的函数，其使用的变量与 build_rootfs.sh 相同，通常包含以下两个变量：
- nonfree_bin_dir
  
  该参数为储存 firmware 的文件夹，默认为 ../../scripts/bin/rockchip/。
- rootfs_dir
  
  该参数为框架构建的 openEuler 根目录所在的路径，默认为 ${workdir}/rootfs。

运行测试

通过运行脚本构建完整镜像，将 --board 参数设置为新增开发板的版型文件来运行测试。

4.8 KiB Raw Blame History Unescape Escape

描述