全志T113-S3学习笔记一：在 Tina SDK 中添加自定义板子

原创已于 2025-04-08 14:25:33 修改 · 1.8k 阅读

28 ·

CC 4.0 BY-SA版权

文章标签：

#笔记 #linux

于 2025-04-08 11:45:33 首次发布

Allwinner板子学习记录专栏收录该内容

2 篇文章

订阅专栏

在 TinaSDK 中添加自定义板子

在嵌入式系统固件开发中，将自己的板子信息接入现有 SDK 是一个常见需求。本文以 Allwinner 平台为例，详细讲解如何在 Tina SDK 下添加自定义板子，并使其出现在 lunch 菜单中，便于后续编译工作。

一、理解关键目录结构

1. 芯片平台配置目录

路径：device/config/chips/[芯片型号]
例如：device/config/chips/t113
内容：
- Linux 内核配置：如 linux-5.4/config-*
- 设备树文件：例如 board.dts
- 系统分区表：如 sys_*.fex 文件

2. 板级配置目录

路径：target/allwinner/[板子名称]
例如：target/allwinner/t113-evb1
内容：
- BoardConfig.mk：定义板级硬件参数
- defconfig：内核编译默认配置
- *其它 .mk 文件：板子专用的构建配置文件

3. 全局配置脚本

文件：vendorsetup.sh
- 作用：用于注册自定义板子选项到 lunch 菜单中

二、添加自定义板子的步骤

下面以自定义板子 t113-myboard 为例，介绍如何将其添加到 SDK 中。

1. 创建板级目录

在 target/allwinner/ 目录下创建你的板子目录。建议复制现有板子目录作为模板：

cd target/allwinner
cp -r t113-evb1 t113-myboard  # 复制现有板子配置作为模板

2. 配置 BoardConfig.mk

在 t113-myboard/ 目录下修改 BoardConfig.mk，定义板级硬件参数，例如：

# BoardConfig.mk 示例配置
TARGET_BOARD_PLATFORM := t113-myboard
KERNEL_VERSION        := 5.4
TARGET_ARCH           := arm
TARGET_CPU            := cortex-a7

# 内核配置路径（引用芯片平台上的配置）
KERNEL_DEFCONFIG      := device/config/chips/t113/linux-5.4/config-5.4

# 设备树路径，对应芯片平台设备树文件
KERNEL_DTS_PATH       := device/config/chips/t113/linux/board.dts

# 系统分区表
TARGET_SYS_PARTITION  := device/config/chips/t113/sys_partition.fex

3.内核与设备树配置

3.1 内核配置

在 device/config/chips/t113/linux-5.4/ 目录下创建自定义内核配置文件
例如：config-5.4-myboard，可以参考并修改现有的配置文件

3.2 设备树配置

在 device/config/chips/t113/linux/ 目录下修改 board.dts 或新建设备树文件（如 board-myboard.dts）
根据实际硬件调整引脚、时钟、外设节点等内容

4. 系统配置文件

修改或新建系统配置文件，如 sys_config.fex 和 sys_partition.fex（位于 device/config/chips/t113/）
定义硬件外设、系统分区、GPIO、屏幕参数等信息，确保符合自定义板子的需求

5. 注册到 lunch 菜单

打开全局配置脚本 target/allwinner/vendorsetup.sh，在其中添加自定义板子的选项，如下：

# 在 target/allwinner/vendorsetup.sh 中添加：
add_lunch_combo t113-myboard-eng
add_lunch_combo t113-myboard-user

这样在执行 lunch 命令时，你的自定义板子 t113-myboard 就会显示出来。

6. 创建编译脚本

打开全局配置脚本 target/allwinner/vendorsetup.sh，在其中添加自定义板子的选项，如下：

# t113_myboard.mk
PRODUCT_MAKEFILES := \
    $(LOCAL_DIR)/t113_myboard.mk

COMMON_LUNCH_CHOICES := \
    t113-myboard-eng \
    t113-myboard-user

7.更新环境并验证

完成以上步骤后，更新 SDK 环境配置并验证：

source build/envsetup.sh
lunch  # 此时应能看到 t113-myboard 的选项出现在菜单中

三、关键文件说明

文件/目录	作用说明
BoardConfig.mk	定义板级硬件参数，如 CPU 架构、内核版本、系统分区等
sys_*.fex	定义系统分区、外设资源配置（如 GPIO、屏幕参数）
defconfig	内核编译默认配置，通过 make kernel_menuconfig 生成
vendorsetup.sh	全局注册文件，用于将自定义板子加入 lunch 菜单
device/config/chips/	存放芯片级通用配置，如内核配置文件、设备树、系统分区表