OpenHarmony移植到STM32H743系列_源码拉取

OpenHarmony移植到STM32H743系列-这是一个系列
资源预览
术语含义
源码拉取 👈 你在这里
移植验证
内核移植

前提准备

我这里的环境是Archlinux x86_64 linux 6.13.8，python版本为3.13.2，由于我Ubuntu早就卸载了，所以这边我拿Archlinux进行尝试。

安装配置hb

由于Archlinux从Python 3.13 开始默认启用了名为 externally-managed-environment 的特性，不再建议使用 pip 在系统环境中直接安装第三方 Python 包，以避免破坏系统环境。
我这这边选择使用conda创建一个py39的环境，如果选择更新的环境，后续的包可能会有冲突。

conda create -n ohos python=3.9
conda activate ohos
pip install jinja2 ohos-build==0.4.6 -i https://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com

现在的hb包有一段时间没有维护了，似乎hb env 工具出现问题，导致涉及到这条指令工具都无法运行，如make menuconfig。我们通过查看/kernel/liteos_m/Makefile的第38行，可以看到：

/kernel/liteos_m/Makefile 1 lines

$(foreach line,$(shell hb env | sed 's/\[OHOS INFO\]/ohos/g;s/ /_/g;s/:_/=/g' || true),$(eval $(line)))

实际上，我看查看一下hb env指令的内容可知，其输出类似：

ohos_root_path=/home/zhushy/openharmony
ohos_board=v200zr
ohos_kernel=liteos_m
ohos_product=iotlink_demo
ohos_product_path=/home/zhushy/openharmony/vendor/bestechnic/iotlink_demo
ohos_device_path=/home/zhushy/openharmony/device/board/fnlink/v200zr/liteos_m
ohos_device_company=fnlink

而我们在进行hb set指令过后，会在out/ohos_config.json下生成选择过后对应的参数文件，如：

out/ohos_config.json 23 lines

{
  "root_path": "/home/dm/Projects/openharmony_project/test_1",
  "board": "challenger_h743v2",
  "kernel": "liteos_m",
  "product": "challenger_h743v2",
  "product_path": "/home/dm/Projects/openharmony_project/test_1/vendor/embfire/challenger_h743v2",
  "device_path": "/home/dm/Projects/openharmony_project/test_1/device/board/embfire/challenger_h743v2/liteos_m",
  "device_company": "embfire",
  "os_level": "mini",
  "version": "3.0",
  "patch_cache": null,
  "product_json": "/home/dm/Projects/openharmony_project/test_1/vendor/embfire/challenger_h743v2/config.json",
  "component_type": "",
  "product_config_path": "/home/dm/Projects/openharmony_project/test_1/vendor/embfire/challenger_h743v2",
  "target_cpu": null,
  "target_os": null,
  "out_path": "/home/dm/Projects/openharmony_project/test_1/out/challenger_h743v2/challenger_h743v2",
  "subsystem_config_json": "build/subsystem_config.json",
  "device_config_path": "/home/dm/Projects/openharmony_project/test_1/device/board/embfire/challenger_h743v2/liteos_m",
  "support_cpu": null,
  "precise_branch": null,
  "compile_config": null
}

而make menuconfig指令执行的是kernel/liteos_m目录下的Makefile，所以我们只需要对其稍作修改即可使其正常运行：

kernel/liteos_m/Makefile 29 lines

# 获取当前 Makefile 的根目录
LITEOSTOPDIR := $(realpath $(dir $(lastword $(MAKEFILE_LIST))))
ROOT_DIR := $(dir $(dir $(LITEOSTOPDIR)))

# 确保路径拼接正确
CONFIG_JSON_PATH := $(ROOT_DIR)out/ohos_config.json  

# 打印调试信息
$(info LITEOSTOPDIR: $(LITEOSTOPDIR))
$(info ROOT_DIR: $(ROOT_DIR))
$(info CONFIG_JSON_PATH: $(CONFIG_JSON_PATH))

# 从 JSON 中解析变量
ohos_root_path := $(shell jq -r '.root_path' $(CONFIG_JSON_PATH))
ohos_board := $(shell jq -r '.board' $(CONFIG_JSON_PATH))
ohos_kernel := $(shell jq -r '.kernel' $(CONFIG_JSON_PATH))
ohos_product := $(shell jq -r '.product' $(CONFIG_JSON_PATH))
ohos_product_path := $(shell jq -r '.product_path' $(CONFIG_JSON_PATH))
ohos_device_path := $(shell jq -r '.device_path' $(CONFIG_JSON_PATH))
ohos_device_company := $(shell jq -r '.device_company' $(CONFIG_JSON_PATH))

# 导出变量
export ohos_root_path
export ohos_board
export ohos_kernel
export ohos_product
export ohos_product_path
export ohos_device_path
export ohos_device_company

现在即可正常运行。参考教程：带你熟悉鸿蒙轻内核Kconfig使用指南↗ 的内容，这段内容是使用foreach命令和sed命令循环处理hb env输出的每一行，转换为makefile的变量形式，提供给之后的指令使用。第一行中使用了hb env指令，该指令返回错误，导致无法运行。

安装repo工具

这边使用官方脚本进行 repo↗ 的下载和拉取：

sudo curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 -o /usr/local/bin/repo
sudo chmod a+x /usr/local/bin/repo

我这边的终端输出为：

myArch% repo --version 
repo launcher version 2.8
       (from /usr/local/bin/repo)
git 2.49.0
Python 3.13.2 (main, Feb  5 2025, 08:05:21) [GCC 14.2.1 20250128]
OS Linux 6.13.8-arch1-1 (#1 SMP PREEMPT_DYNAMIC Sun, 23 Mar 2025 17:17:30 +0000)
CPU x86_64 (unknown)

获取主干代码

OpenHarmony 主干分支（master）包含最新特性代码，适合开发测试使用。Master主干为开发分支，开发者可以通过拉取最新仓库获取新特性，开发版本源码较为稳定，为定期发布的稳定版本，获取方式参考 Release Notes↗ 。

我这边使用的是轻量型设备对应的源码，所以使用以下指令进行拉取：

repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-5.0.3-Release --no-repo-verify -g ohos:mini
repo sync -c
repo forall -c 'git lfs pull'

Warning

如果提示

Skipping object checkout, Git LFS is not installed for this repository.
Consider installing it with 'git lfs install'.

这表示你的系统上缺少了 Git LFS（Large File Storage），导致一些大文件无法被下载，需要手动安装：

sudo pacman -S git-lfs
git lfs install  # 安装过后执行一次初始化命令
repo forall -c 'git lfs pull' # 回到代码仓库重新拉取

为了支持按照不同类型下载代码，OpenHarmony为每个代码仓定义了以下类别：

分类	分类说明	group
轻量系统仓	适用于轻量系统的代码仓	ohos:mini
小型系统仓	适用于小型系统的代码仓	ohos:small
标准系统仓	适用于标准系统的代码仓	ohos:standard
系统组件仓	标准系统中与硬件无关的代码仓，构建产物都部署在/system目录下。	ohos:system
芯片组件仓	标准系统中与芯片或硬件相关的仓，构建产物部署在/vendor或/chipset目录下。	ohos:chipset

安装交叉编译链

原先开发环境搭建-安装交叉编译工具链↗ 使用的是10.3版本的gcc-arm-none-eabi，会导致出现以下报错：

non constant or forward reference address expression for section .ARM.extab

在STM32H743XX_FLASH.ld中对应行数有这么一句话：

  .ARM.extab (READONLY) : /* The "READONLY" keyword is only supported in GCC11 and later, remove it if using GCC10 or earlier. */

可以得知我们现在有两种方法：

升级ARM GCC 11或者以上版本：从 ARM GNU Toolchain↗ 下载最新版本，如11.x或者更高版本。
推荐删除 (READONLY) 字段即可。
我这里选择的是第一种方法。

mkdir -p ~/download && cd ~/download
wget https://developer.arm.com/-/media/Files/downloads/gnu/12.3.rel1/binrel/arm-gnu-toolchain-12.3.rel1-x86_64-arm-none-eabi.tar.xz
sudo tar -xJvf arm-gnu-toolchain-12.3.rel1-x86_64-arm-none-eabi.tar.xz -C /opt/
vim ~/.zshrc
export PATH=/opt/arm-gnu-toolchain-12.3.rel1-x86_64-arm-none-eabi/bin:$PATH
source ~/.zshrc

按照上述步骤安装完成过后可以查看版本验证：

myArch% arm-none-eabi-gcc --version

arm-none-eabi-gcc (Arm GNU Toolchain 12.3.Rel1 (Build arm-12.35)) 12.3.1 20230626
Copyright (C) 2022 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

前提准备#

安装配置hb#

安装repo工具#

获取主干代码#

安装交叉编译链#

前提准备

安装配置hb

安装repo工具

获取主干代码

安装交叉编译链