Skip to main content

SDK 新建板级方案

在开发时，通常会建立一个新的板级方案来开发，下面将介绍如何建立板级方案

在建立方案之前，需要选择一个板级作为基础板级，然后在这个板级的基础上进行修改。

这里将以 bga_perf1 开发板，详解如何新建一个自己的板级方案 v861-custom

使用脚本新建板级方案​

v861 Tina Linux 提供了新建板级脚本 create_new_board

  1. 首先 lunch 作为基础的板级，这里执行 lunch v861-bga_perf1-tina 导入作为原型的板级

  2. 然后执行命令 create_new_board 输入新建板子的名称，这里只需要输入名称即可，不需要带芯片型号，另外名称不支持 - 符号，支持下划线。这里输入 custom 即可创建 v861-custom 板级

  3. 按照提示，执行 source build/envsetup.sh && lunch 即可选择新板级开发

Loading asciinema cast...

  • 注：使用 create_new_board 命令配置后，这些改动是直接修改SDK中相关的文件，目前不支持清理命令。如果需要清理这些修改，需要手动使用 git 命令清理，或者根据 create_new_board 命令执行后的提示，恢复相关的配置项。

手动创建新板级​

tip
note

提示

note

以下内容以 V821 平台作为演示示例，V861 平台的操作步骤与之相同，图片仅供参考。

:::

新建 device​

前往目录 device/config/chips/v861/configs 将 bga_perf1 板级复制一份，命名为 custom

image-20241121143706220

修改两份 BoardConfig 包括 BoardConfig.mk 和 BoardConfig_nor.mk 将 LICHEE_RTOS_PROJECT_NAME 改为新方案对应的名字， v861_e907_custom，稍后将创建该名字的 RTOS 方案。

image-20241121143952890

新建 target​

前往 openwrt/target/v861/ 目录，将 bga_perf1 拷贝一份，重命名为 v861-custom

image-20241121144225730

进入 v861-custom 文件夹，将 v861_bga_perf1-setup.sh 改名 v861_custom-setup.sh

image-20241121144459152

编辑 Makefile 将文件中的 bga_perf1 改为 custom

image-20241121144714878

编辑 vendorsetup.sh 将 bga_perf1 改为 custom

image-20241121144828945

新建 rtos​

前往rtos/board/v861_e907，将 bga_perf1 复制一份改名为 custom，这个文件夹内配置了方案RTOS的引脚文件，可以按需修改。

image-20241121144947767

前往 rtos/lichee/rtos/projects/v861_e907 目录，复制 bga_perf1 改名为 custom

image-20241121145241130

编辑该目录下的 Makefile 增加一行，注意 CONFIG_PROJECT_v861_E907_CUSTOM 名字也需要改

obj-$(CONFIG_PROJECT_v861_E907_CUSTOM) += custom/

image-20241121145347446

回到上一级目录 rtos/lichee/rtos/projects 修改 Kconfig 增加新板级配置，这里的 config 名字需要与上面的 CONFIG_PROJECT_v861_E907_CUSTOM 同步

config PROJECT_v861_E907_CUSTOM
	bool "v861 e907 custom system"
	select PROJECT_v861_E907
	---help---
		v861 e907 custom system

image-20241121145521914

同步配置​

在上面的操作完成后，还需要同步配置使得编译的产物正确

（1）刷新板级列表

使用命令 source build/envsetup.sh 和 lunch 载入新板级配置。

image-20241121145757010

（2）同步 Kernel 配置

输入 m kernel_menuconfig 什么都不修改，直接退出即可

image-20241121145922051

（3）同步应用配置

使用命令 m menuconfig 进入配置页面，选择第一项 Target System，将其改到新板级

image-20241121150100060

（3.5）同步 OTA 应用配置（可选）

部分板级支持 OTA，需要同步 OTA 板级配置，使用命令 m ota_menuconfig 进入配置页面，选择第一项 Target System，将其改到新板级，其配置方法与同步应用配置类似。

（4）RTOS 板级同步

运行 mrtos menuconfig 进入配置页面，找到 Projects Options ---> 进入

image-20241121150635958

找到 Configure Application 改为新加的 v861 e907 custom system，保存退出

image-20241121150709879

此时便完成了板级的新建，使用 mp 命令编译吧

image-20251226142500622