手把手教你为全志T113开发板移植OpenHarmony 3.0（含内核配置与常见编译错误解决）

发布时间：2026/6/10 17:06:43

全志T113开发板OpenHarmony 3.0移植实战指南1. 开发环境准备与源码结构解析在开始移植工作前我们需要搭建完整的开发环境并理解OpenHarmony的源码组织结构。对于全志T113这类Cortex-A7架构的开发板推荐使用Ubuntu 20.04 LTS作为开发主机系统这是目前最稳定的编译环境选择。基础工具链安装sudo apt update sudo apt install -y git-lfs python3.8 python3-pip \ binutils binutils-dev git tar curl make gcc g \ bison flex libssl-dev libncurses-devOpenHarmony 3.0的源码结构具有清晰的模块化设计几个关键目录需要特别关注vendor/存放各厂商的产品定义文件device/包含设备特定的驱动和配置kernel/内核源码和补丁文件build/编译系统和构建脚本环境变量配置示例export PATH$PATH:~/tools/gcc-arm-none-eabi-10-2020-q4-major/bin export OHOS_ROOT~/openharmony提示建议使用Python 3.8而非更高版本某些构建脚本对Python版本有严格要求2. 产品定义与编译系统配置为T113创建独立的产品定义是移植的第一步。我们需要在vendor目录下建立专属的产品文件夹结构vendor/ └── xingyun/ └── t113_nand/ ├── BUILD.gn ├── config.json └── hals/config.json核心配置{ product_name: t113_nand_board, ohos_version: OpenHarmony 3.0, device_company: xingyunelec, board: t113_nand_linux, kernel_type: linux, kernel_version: 5.4, subsystems: [ { subsystem: kernel, components: [ {component: linux_5_4, features:[]} ] } ] }对应的设备树配置位于device/xingyunelec/t113_nand_linux/sdk_linux/config.gni关键参数包括配置项值说明kernel_typelinux内核类型kernel_version5.4内核版本board_cpucortex-a7CPU架构board_toolchain_typeclang工具链类型board_cflags-mfloat-abisoftfp浮点运算配置3. Linux内核定制与适配全志T113需要Linux 5.4内核的特殊配置。将内核源码放置到kernel/linux/linux-5.4目录后需要进行以下关键修改内核配置步骤复制默认配置文件cp sun8iw20p1smp_auto_nand_defconfig arch/arm/configs/t113_nand_linux_small_defconfig修改内核构建脚本kernel/linux/build/kernel.mkifeq ($(DEVICE_NAME),t113_nand_linux) $(hide) $(KERNEL_MAKE) -C $(KERNEL_SRC_TMP_PATH) ARCH$(KERNEL_ARCH) \ $(KERNEL_CROSS_COMPILE) -j64 uImage LOADADDR0x40008000 endif添加设备专属补丁文件kernel/linux/patches/linux-5.4/ └── t113_nand_linux_patch/ ├── hdf.patch ├── t113_nand_linux.patch └── t113_nand_linux_small.patch常见编译错误解决错误1Component linux_5_4 not found解决方案在build/lite/components/kernel.json中添加组件定义错误2Cant find default configuration解决方案确保arch/arm/configs/下有正确的defconfig文件错误3uImage generation failed解决方案添加正确的LOADADDR参数T113通常为0x400080004. 构建系统深度调优OpenHarmony使用GNNinja作为构建系统针对T113需要进行以下定制BUILD.gn关键配置group(t113_nand) { deps [ //kernel/linux/build:linux_kernel, //device/xingyunelec/t113_nand_linux/sdk_linux:board ] }内核模块构建脚本修改# kernel_module_build.sh if [ $5 t113_nand_linux ]; then export DEVICE_NAMEt113_nand_linux fi构建参数优化建议并行编译加速hb build -j$(nproc) --target-cpu cortex-a7调试符号保留hb build --build-type debug组件选择编译hb build --component kernel --component drivers5. 系统烧录与验证完成编译后生成的镜像文件位于out/t113_nand_linux/目录下。关键镜像包括uImage内核镜像rootfs.img根文件系统system.img系统分区镜像烧录工具配置[target] board t113_nand storage nand address 0x80000000 [image] kernel uImage rootfs rootfs.img常见启动问题排查内核崩溃检查设备树配置和内存地址映射驱动加载失败验证内核配置中相关驱动是否启用文件系统挂载错误检查rootfs是否包含必要初始化脚本6. 外设驱动开发指南T113的典型外设支持需要额外开发GPIO驱动示例#include linux/gpio.h static int t113_gpio_probe(struct platform_device *pdev) { int ret; struct device *dev pdev-dev; ret gpio_request(T113_GPIO_PIN, custom_io); if (ret) { dev_err(dev, GPIO request failed\n); return ret; } gpio_direction_output(T113_GPIO_PIN, 1); return 0; }驱动配置清单{ driver_name: t113-gpio, version: 1.0, type: gpio, permissions: [ system, user ] }7. 性能优化技巧针对T113的Cortex-A7架构推荐以下优化措施编译器优化board_cflags [ -mfloat-abisoftfp, -mfpuneon-vfpv4, -O2, -fno-strict-aliasing ]内存配置调整memory { device_type memory; reg 0x40000000 0x20000000; };内核参数优化consolettyS0,115200 earlyprintk root/dev/mtdblock3 rootfstypejffs2 rw mem256M在实际项目中我们发现调整DMA缓冲区大小能显著提升存储性能#define T113_DMA_BUF_SIZE (256 * 1024)