3. 内核编译环境搭建：交叉编译工具链安装、环境变量配置、Makefile基础

在 Android 驱动开发中，宿主机（x86_64）与目标设备（ARM64）架构不同，必须使用交叉编译。本章将系统讲解交叉编译工具链的安装、环境变量配置以及驱动 Makefile 的核心编写方法，为后续内核模块编译打下坚实基础。

3.1 交叉编译工具链安装

Android 内核编译推荐使用 Google 官方提供的 Android NDK 中预编译的独立工具链，或使用 Linaro GCC 工具链。以下是两种主流安装方式。

3.1.1 使用 Android NDK 生成独立工具链

1. 下载 Android NDK（推荐 r25c 或更高版本）并解压。
2. 使用 NDK 内置的 make_standalone_toolchain.py 脚本生成独立工具链。
3. 将工具链路径添加到系统 PATH 中。

# 下载 NDK
wget https://dl.google.com/android/repository/android-ndk-r25c-linux.zip
unzip android-ndk-r25c-linux.zip

# 生成 ARM64 独立工具链
python android-ndk-r25c/build/tools/make_standalone_toolchain.py \
    --arch arm64 \
    --api 31 \
    --install-dir ~/aarch64-linux-android-toolchain

# 验证安装
export PATH=~/aarch64-linux-android-toolchain/bin:$PATH
aarch64-linux-android-gcc --version

3.1.2 使用 Linaro GCC 工具链

Linaro 提供了针对 ARM 架构优化的 GCC 工具链，适合内核编译场景。

# 下载 Linaro GCC 7.5 for ARM64
wget https://releases.linaro.org/components/toolchain/binaries/7.5-2019.12/aarch64-linux-gnu/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
tar -xf gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu.tar.xz
mv gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu ~/aarch64-linux-gnu-toolchain

# 添加至 PATH
export PATH=~/aarch64-linux-gnu-toolchain/bin:$PATH
aarch64-linux-gnu-gcc --version

3.2 环境变量配置

交叉编译环境需要设置多个关键环境变量，以便 Makefile 能够正确找到编译器、链接器和目标架构参数。下表列出了最核心的环境变量及其作用。

建议将环境变量写入 ~/.bashrc 或项目根目录的 env.sh 脚本中，避免每次手动设置。

# 创建环境变量设置脚本 env.sh
cat > env.sh << 'EOF'
#!/bin/bash
export ARCH=arm64
export CROSS_COMPILE=aarch64-linux-android-
export PATH=~/aarch64-linux-android-toolchain/bin:$PATH
export KERNEL_SRC=~/android-kernel
echo "交叉编译环境已加载: ARCH=$ARCH, CROSS_COMPILE=$CROSS_COMPILE"
EOF

# 每次编译前加载
source env.sh

3.3 Makefile 基础

Linux 内核模块的编译依赖内核源码树提供的 Kbuild 系统。驱动开发者只需编写一个简洁的 Makefile，Kbuild 会自动处理编译、链接和模块生成。

3.3.1 最简单的驱动 Makefile

# 最简单的内核模块 Makefile
obj-m := hello_driver.o

KDIR := $(KERNEL_SRC)
PWD := $(shell pwd)

all:
	$(MAKE) -C $(KDIR) M=$(PWD) modules

clean:
	$(MAKE) -C $(KDIR) M=$(PWD) clean

逐行解释：

• obj-m := hello_driver.o：告诉 Kbuild 将 hello_driver.c 编译成内核模块（.ko）。
• KDIR := $(KERNEL_SRC)：指向已配置的内核源码树路径。
• PWD := $(shell pwd)：获取当前驱动源码目录路径。
• $(MAKE) -C $(KDIR) M=$(PWD) modules：进入内核源码树，执行模块编译。

3.3.2 多文件模块的 Makefile

当驱动由多个源文件组成时，需要使用 模块名-objs 语法。

# 多文件模块 Makefile 示例
obj-m := my_driver.o
my_driver-objs := main.o utils.o gpio_ops.o

KDIR := $(KERNEL_SRC)
PWD := $(shell pwd)

all:
	$(MAKE) -C $(KDIR) M=$(PWD) modules

clean:
	$(MAKE) -C $(KDIR) M=$(PWD) clean

3.3.3 带编译选项的 Makefile

可以通过 ccflags-y 和 ldflags-y 添加编译和链接选项。

# 带编译选项的 Makefile
obj-m := sensor_driver.o

ccflags-y := -DDEBUG -O2 -Wall
ldflags-y := --no-warn-rwx-segments

KDIR := $(KERNEL_SRC)
PWD := $(shell pwd)

all:
	$(MAKE) -C $(KDIR) M=$(PWD) modules

clean:
	$(MAKE) -C $(KDIR) M=$(PWD) clean

3.4 交叉编译流程与 Makefile 调用关系

下图展示了从环境变量设置到最终生成 .ko 文件的完整编译流程，以及 Makefile 与内核 Kbuild 系统的协作关系。

3.5 完整编译示例

以下是一个完整的编译命令序列，展示了从环境加载到模块生成的全过程。

# 1. 加载交叉编译环境
source ~/env.sh

# 2. 确认环境变量
echo "ARCH=$ARCH"
echo "CROSS_COMPILE=$CROSS_COMPILE"
echo "KERNEL_SRC=$KERNEL_SRC"

# 3. 进入驱动源码目录
cd ~/driver_projects/hello_driver

# 4. 执行编译
make

# 5. 检查生成的模块
ls -lh *.ko
file hello_driver.ko

编译成功后，file 命令应输出类似 ELF 64-bit LSB relocatable, ARM aarch64 的信息，确认是 ARM64 架构的模块。

3.6 常见编译错误与解决方案