📚 课程目录第3章驱动工程开发环境搭建

3. 驱动工程开发环境搭建

Vendor Module 驱动开发的第一步不是写代码，而是把“能编译、能烧写、能调试”的闭环环境搭起来。Android 驱动工程涉及 AOSP 源码、Linux 内核源码、交叉编译工具链和调试工具四大部分，任何一环缺失都会导致后续工作无法推进。本章围绕这四部分，给出可落地的搭建流程与常见问题处理。

一、核心原理：四层依赖关系

驱动开发环境并非简单安装几个软件，而是一个自底向上的依赖链。交叉编译工具链决定了内核与模块能否生成目标架构的二进制；内核源码提供驱动编译所需的头文件、Kconfig 与 Makefile 框架；AOSP 源码提供 Android 侧的 HAL、Vendor 接口与构建系统；调试工具则负责把编译产物验证到真实设备上。四者版本必须匹配，否则会出现“编译通过但无法加载”的典型问题。

二、方法流程：从零到可编译

建议按以下顺序搭建，避免依赖倒置导致的反复返工。

准备主机环境：推荐 Ubuntu 20.04/22.04，至少 16 核 CPU、32GB 内存、500GB 以上 SSD。安装必要依赖包。
下载 AOSP 源码：使用 repo 工具同步指定分支，注意选择与目标设备匹配的 tag。
获取内核源码：从芯片厂商或 AOSP kernel 仓库拉取对应版本，确认与 AOSP 的 kernel prebuilt 一致。
配置交叉编译工具链：优先使用 AOSP 自带的 prebuilts，避免版本冲突。
准备调试工具：安装 adb、fastboot、串口工具，配置 udev 规则。

# 1. 安装依赖
sudo apt install -y git curl python3 openjdk-11-jdk \
  flex bison gperf build-essential zip unzip \
  libncurses5-dev libssl-dev bc

# 2. 下载 repo 并初始化 AOSP
mkdir ~/aosp && cd ~/aosp
repo init -u https://android.googlesource.com/platform/manifest \
  -b android-13.0.0_r1
repo sync -j8

# 3. 获取内核源码（以高通为例）
git clone https://android.googlesource.com/kernel/msm \
  -b android-msm-5.15 -b android13-5.15

# 4. 配置工具链环境变量
export PATH=~/aosp/prebuilts/clang/host/linux-x86/clang-r450784d/bin:$PATH
export CROSS_COMPILE=aarch64-linux-android-
export ARCH=arm64

三、关键配置与参数对照

下表列出驱动工程中最常打交道的环境变量与工具，建议在 ~/.bashrc 中统一管理。

项目	推荐值 / 工具	作用
ARCH	arm64	指定目标 CPU 架构
CROSS_COMPILE	aarch64-linux-android-	交叉编译器前缀
CC	clang	Android 内核默认使用 Clang
内核配置	defconfig / gki_defconfig	生成 .config
设备树	.dts / .dtsi	描述硬件资源
调试	adb / fastboot / dmesg	烧写与日志查看

四、案例场景：编译一个 Vendor 驱动模块

假设我们要为某高通平台添加一个字符设备驱动 vendor_demo，目录放在 kernel/msm/drivers/vendor_demo/。核心步骤是编写 Kconfig、Makefile 和驱动源文件，然后通过内核构建系统编译成 .ko 模块。

# drivers/vendor_demo/Makefile
obj-$(CONFIG_VENDOR_DEMO) += vendor_demo.o

# drivers/vendor_demo/Kconfig
config VENDOR_DEMO
    tristate "Vendor Demo Driver"
    default m
    help
      Vendor demo char device driver.

# 编译命令
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-android- \
  vendor_defconfig
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-android- \
  modules -j8

# 产物
drivers/vendor_demo/vendor_demo.ko

编译成功后，通过 adb push 推送到设备，使用 insmod 加载，再用 dmesg 查看打印信息，确认 probe 是否成功。

提示：如果模块加载时报 “version magic” 不匹配，说明内核源码版本与设备运行内核不一致，需要重新同步内核源码或使用设备对应的 prebuilt 内核。

五、常见误区与复盘

误区一：工具链随意选。使用系统自带的 gcc 编译 Android 内核，往往因缺少 Android 补丁而失败。应优先使用 AOSP prebuilts 中的 Clang。
误区二：AOSP 与内核版本脱节。AOSP 中的 kernel prebuilt 与手动下载的内核源码版本不一致，导致模块无法加载。务必核对 android-13.0.0_r1 对应的内核 tag。
误区三：忽略 udev 规则。Ubuntu 下 adb 无法识别设备，多数是权限问题，需添加 /etc/udev/rules.d/51-android.rules。
误区四：磁盘空间不足。AOSP 完整编译需要 200GB 以上，repo sync 前应确认磁盘余量。

注意：首次 repo sync 耗时较长，建议使用 -j8 以上并行度，并配置好 git 代理，避免中途断连导致重复同步。

环境搭建完成后，建议做一次“最小验证”：编译一个 hello 模块，push 到设备并 insmod，看到 dmesg 输出即代表整条链路打通。这一步虽然简单，却能提前暴露工具链、内核版本、权限等绝大多数问题，为后续 Vendor Module 开发节省大量排查时间。