当前位置：首页 > news >正文

在Rockchip Android13上，用clang和LLVM工具链编译内核模块（hello.ko实战）

news 2026/4/17 6:09:20

在Rockchip Android13上使用clang和LLVM工具链编译内核模块实战指南

引言

对于嵌入式Linux开发者来说，内核模块开发是一项基础但至关重要的技能。随着Android系统在嵌入式领域的广泛应用，Rockchip平台凭借其出色的性能和丰富的功能接口，成为众多智能设备厂商的首选。本文将聚焦Rockchip Android13平台，详细介绍如何使用clang和LLVM工具链编译一个简单的"Hello World"内核模块（hello.ko）。

与传统的GCC编译方式不同，Android13内核已经全面转向LLVM/Clang工具链，这带来了更快的编译速度、更好的优化能力以及更严格的代码检查。对于刚接触Rockchip平台驱动开发的工程师来说，掌握这套工具链的使用方法至关重要。我们将从环境准备开始，逐步讲解配置、编译和验证的完整流程，帮助开发者快速上手。

1. 环境准备与工具链配置

1.1 获取必要的编译工具

Rockchip Android13平台使用特定的clang版本进行内核编译，官方推荐使用clang-r450784d。这个工具链通常位于Android源码树的以下路径：

prebuilts/clang/host/linux-x86/clang-r450784d

如果你已经下载了完整的Android源码，可以直接使用这个路径下的编译器。如果没有完整源码，可以从Rockchip官方获取独立的工具链包。

1.2 设置环境变量

为了在任意目录都能使用clang工具链，需要将工具链的bin目录添加到PATH环境变量中：

export PATH=/path/to/prebuilts/clang/host/linux-x86/clang-r450784d/bin:$PATH

验证clang是否配置成功：

clang --version

应该能看到类似如下的输出：

clang version 12.0.5 (https://android.googlesource.com/toolchain/llvm-project 98c855489587874b2a325e7a516b99d838599c6f) Target: x86_64-unknown-linux-gnu Thread model: posix InstalledDir: /path/to/prebuilts/clang/host/linux-x86/clang-r450784d/bin

1.3 获取内核源码

Rockchip Android13平台通常基于Linux内核5.10版本。你可以通过以下方式获取内核源码：

从Rockchip官方Git仓库克隆：

git clone https://github.com/rockchip-linux/kernel.git -b android-5.10

或者从Android源码树中提取：
```
cd /path/to/android/source make kernel
```

2. 配置内核编译环境

2.1 内核配置

进入内核源码目录，执行以下命令配置内核：

make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1 ARCH=arm64 gki_defconfig rockchip_gki.config

这里有几个关键参数需要注意：

LLVM=1：告诉内核构建系统使用LLVM工具链
LLVM_IAS=1：使用LLVM的集成汇编器
ARCH=arm64：指定目标架构为ARM64
CROSS_COMPILE=aarch64-linux-gnu-：指定交叉编译前缀

2.2 编译内核映像

配置完成后，可以编译内核映像：

make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1 ARCH=arm64 rk3588-evb1-lp4-v10.img -j32

这个步骤会生成内核映像文件和必要的内核头文件，为后续模块编译做好准备。

3. 创建简单的内核模块

3.1 编写模块源代码

创建一个新目录hello，并在其中新建hello.c文件：

#include <linux/init.h> #include <linux/module.h> #include <linux/kernel.h> static int __init hello_init(void) { printk(KERN_INFO "Hello, Rockchip Android13 kernel!\n"); return 0; } static void __exit hello_exit(void) { printk(KERN_INFO "Goodbye, Rockchip Android13 kernel!\n"); } module_init(hello_init); module_exit(hello_exit); MODULE_LICENSE("GPL"); MODULE_AUTHOR("Your Name"); MODULE_DESCRIPTION("A simple Hello World module for Rockchip Android13"); MODULE_VERSION("0.1");

3.2 编写Makefile

在同一个目录下创建Makefile：

obj-m := hello.o KERNEL_DIR ?= /path/to/your/kernel all: make -C $(KERNEL_DIR) M=$(PWD) modules clean: make -C $(KERNEL_DIR) M=$(PWD) clean

3.3 编译模块

在模块目录下执行编译命令：

make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1 ARCH=arm64 -C /path/to/kernel M=$(PWD) -j32

成功编译后，会在当前目录生成hello.ko文件。

4. 测试与验证

4.1 将模块推送到设备

使用adb将编译好的模块推送到Rockchip设备：

adb push hello.ko /data/local/tmp/

4.2 加载模块

在设备shell中执行：

insmod /data/local/tmp/hello.ko

查看内核日志确认模块加载：

dmesg | grep Hello

应该能看到类似如下的输出：

[ 1234.567890] Hello, Rockchip Android13 kernel!

4.3 卸载模块

测试完成后卸载模块：

rmmod hello

再次查看内核日志：

dmesg | grep Goodbye

应该能看到：

[ 1234.678901] Goodbye, Rockchip Android13 kernel!

5. 常见问题与解决方案

5.1 编译错误：找不到头文件

问题现象：

fatal error: linux/module.h: No such file or directory

解决方案：确保内核已经正确配置并编译过至少一次，这样会生成必要的头文件。同时检查KERNEL_DIR变量是否指向正确的内核源码路径。

5.2 模块加载失败：版本不匹配

问题现象：

insmod: ERROR: could not insert module hello.ko: Invalid module format

解决方案：确保模块编译使用的内核版本与设备上运行的内核版本完全一致。可以通过以下命令检查：

uname -r

然后在内核源码目录下执行：

make modules_prepare

5.3 性能优化建议

使用LLVM工具链时，可以尝试以下优化选项：

-O2或-O3优化级别
-mcpu=cortex-a76（根据具体Rockchip芯片调整）
-march=armv8-a（针对ARMv8架构优化）

可以在Makefile中添加：

ccflags-y := -O2 -mcpu=cortex-a76 -march=armv8-a

6. 高级技巧与最佳实践

6.1 交叉编译环境封装

为了方便团队协作，可以将编译环境封装成Docker镜像：

FROM ubuntu:20.04 RUN apt-get update && apt-get install -y \ git make gcc bc bison flex libssl-dev \ && rm -rf /var/lib/apt/lists/* COPY clang-r450784d /opt/clang-r450784d ENV PATH="/opt/clang-r450784d/bin:${PATH}" WORKDIR /workspace

6.2 自动化构建脚本

创建一个简单的构建脚本build.sh：

#!/bin/bash export PATH="/path/to/clang-r450784d/bin:$PATH" export KERNEL_DIR="/path/to/kernel" make CROSS_COMPILE=aarch64-linux-gnu- \ LLVM=1 \ LLVM_IAS=1 \ ARCH=arm64 \ -C "$KERNEL_DIR" \ M="$(pwd)" \ -j$(nproc)