OpenHarmony 内核模块编译(Out of tree)#

参考文档：openharmony5.0.0中kernel子系统编译构建流程概览(rk3568)_openharmony5 单独编译内核-CSDN博客

本文基于OpenHarmony 6.1 Release qemu x86_64编译

因为OpenHarmony的Kernel源码和rom源码是在同一个项目里面，而且官方推荐的使用build.sh的编译方法，需要sync整个OpenHarmony的源码（否则根本过不掉检查）

所以才有了这篇文章，只需要拉取必须文件即可编译内核

内核编译#

同步源码#

由于我们只需要编译内核，所以只需要同步我们需要的源码即可

chipsets/qemu.xml device/qemu vendor/ohemu 根据实际情况来写即可

1
repo init -u https://gitee.com/openharmony/manifest.git -b OpenHarmony-6.0-Release -m chipsets/qemu.xml

1
repo sync -c build kernel/linux/common_modules kernel/linux/build kernel/linux/linux-5.10 kernel/linux/patches kernel/linux/config device/qemu vendor/ohemu drivers/hdf_core third_party/FreeBSD

然后下载prebuilds，build目录下附带了下载脚本（准备NodeJs 和 python 环境）

1
build/prebuilts_download.py

确定参数#

官方build.sh中，编译内核时的传参如下

1
 action("build_kernel") {//定义一个构建任务,action参数用于定义构建过程中的具体操作
2
    script = "build_kernel.sh"//指定了用于构建内核的脚本文件为`build_kernel.sh`
3
    sources = [ kernel_source_dir ]//指定内核源码目录//kernel/linux/$linux_kernel_version
4

5
    deps = [ ":check_build" ]//在执行构建内核任务之前，必须先完成`:check_build`任务,check_build为上文定义的check_build.sh脚本
6
    product_path = "vendor/$product_company/$product_name"//产品自定义相关的目录
7
    build_type = "standard"//构建类型为标准构建
8
    outputs = [ "$root_build_dir/packages/phone/images/$kernel_image" ]//构建的最终输出文件的位置和名称
9
    args = [//列出了传递给构建脚本的参数
10
      rebase_path(kernel_build_script_dir, root_build_dir),//1.重新计算内核构建脚本目录相对于构建目录根路径的路径,kernel_build_script_dir = "//kernel/linux/build";，定位到out输出的目录
11
      rebase_path("$root_out_dir/../KERNEL_OBJ"),//2.重新计算内核对象文件目录相对于某个输出目录的路径
12
      rebase_path("$root_build_dir/packages/phone/images"),//3.重新计算内核镜像文件放置目录相对于构建目录根路径的路径
13
      build_type,//4.构建类型，这里已经定义为"standard"
14
      target_cpu,//5.目标CPU架构，构建内核时需要指定针对哪种CPU架构进行构建
15
      product_path,//6.产品路径，已在前面定义
16
      device_name,//7.设备名称，表示正在构建内核的具体设备型号
17
      linux_kernel_version,//8.Linux内核版本号，表示正在构建的内核的具体版本
18
    ]
19
  }

给个传参的示例

1
export OHOS_BUILD_HOME="/path/to/OpenHarmonySource"
2
./build_kernel.sh ${OHOS_BUILD_HOME}/kernel/linux/build  ${OHOS_BUILD_HOME}/out/ ${OHOS_BUILD_HOME}/out/images standard x86 vendor/ohemu/qemu_x86_64_linux_min qemu-x86_64-linux linux-5.10

这里需要注意的是 device_name 要与 defconfig 的文件名中的相同

后面会直接使用device_name拼接出文件名来寻找 defconfig

一般都能在kernel/linux/config/ 下找到

开始编译#

一定要在 kernel/linux/build 这个目录下执行build_kernel.sh

否则 kernel.mk 中的 OHOS_BUILD_HOME 将会是错误的路径

编译完成后的输出目录中的结构为

1
.
2
└── kernel
3
    ├── OBJ
4
    │   └── linux-5.10
5
    │       ├── arch
6
    │       ├── block
7
    │       ├── certs
8
    │       ├── crypto
9
    │       ├── drivers
10
    │       ├── fs
11
    │       ├── include
12
    │       ├── init
13
    │       ├── io_uring
14
    │       ├── ipc
15
    │       ├── kernel
16
    │       ├── lib
17
    │       ├── Makefile
18
    │       ├── mm
19
    │       ├── net
20
    │       ├── scripts
21
    │       ├── security
22
    │       ├── sound
23
    │       ├── source -> /home/ubun/Desktop/op/out/kernel/src_tmp/linux-5.10
24
    │       ├── tools
25
    │       ├── usr
26
    │       └── virt
27
    └── src_tmp
28
        └── linux-5.10
29
            ├── arch
30
            ├── base_defconfig
31
            ├── block
32
            ├── bounds_checking_function
33
            ├── certs
34
            ├── COPYING
35
            ├── CREDITS
36
            ├── crypto
37
            ├── Documentation
38
            ├── drivers
39
            ├── fs
40
            ├── hispark_taurus
41
            ├── imx8mm
42
            ├── include
43
            ├── init
44
            ├── io_uring
45
            ├── ipc
46
            ├── Kbuild
47
            ├── Kconfig
48
            ├── kernel
49
            ├── lib
50
            ├── LICENSES
51
            ├── MAINTAINERS
52
            ├── Makefile
53
            ├── mm
54
            ├── net
55
            ├── OAT.xml
56
            ├── qemu
57
            ├── README
58
            ├── README.OpenSource
59
            ├── rk3568
60
            ├── samples
61
            ├── scripts
62
            ├── security
63
            ├── sound
64
            ├── tools
65
            ├── type
66
            ├── unionpi_tiger
67
            ├── usr
68
            ├── virt
69
            └── yangfan

src tmp 为拷贝的kernel源代码

OBJ才是编译产物

内核模块编译#

有了OBJ下的编译产物我们就可以实现脱离源码树编译内核模块了

可以直接借鉴DDK的template

envset.sh

1
export KDIR=~/Desktop/op/out/kernel/OBJ/linux-5.10
2
export CLANG_PATH=~/Desktop/op/prebuilts/clang/ohos/linux-x86_64/llvm/bin
3

4
export PATH=$CLANG_PATH:$PATH
5
export CROSS_COMPILE=x86_64-unknown-linux-ohos-
6
export ARCH=x86_64
7
export LLVM=1
8
export LLVM_IAS=1

Makefile

1
MODULE_NAME := Shami
2
$(MODULE_NAME)-objs := ko_sample.o
3
obj-m := $(MODULE_NAME).o
4

5
ccflags-y += -Wno-declaration-after-statement
6
ccflags-y += -Wno-unused-variable
7
ccflags-y += -Wno-int-conversion
8
ccflags-y += -Wno-unused-result
9
ccflags-y += -Wno-unused-function
10
ccflags-y += -Wno-builtin-macro-redefined -U__FILE__ -D__FILE__='""'
11

12
KDIR := $(KDIR)
13
MDIR := $(realpath $(dir $(abspath $(lastword $(MAKEFILE_LIST)))))
14

15
$(info -- KDIR: $(KDIR))
16
$(info -- MDIR: $(MDIR))
17

18
all:
19
  make -C $(KDIR) M=$(MDIR) modules
20
compdb:
21
  python3 $(MDIR)/.vscode/generate_compdb.py -O $(KDIR) $(MDIR)
22
clean:
23
  make -C $(KDIR) M=$(MDIR) clean