4. 第4章
04 驱动编译：核心源码编译与内核模块加载验证
掌握驱动编译在驱动编译中的定位、故障信号与验证顺序。
编译前夜：内核源码树与 Kconfig 配置对齐
现场定位记录
- 对象/模块：典型技术应用现场里的驱动编译
- 问题现象：典型技术应用现场里驱动编译一开始改动很快，输入需求增加后日志记录显示状态外泄、循环依赖和接口膨胀。
- 验证动作：先把职责边界、私有状态、依赖方向、阈值标准和验证入口画清，再执行拆分动作。
- 工程判断：前后变化点能被隔离、被验证、被替换，才说明架构重构达到标准。
驱动编译落地前要同时核对驱动编译的核心源码编译、失败路径和内核模块加载验证。
概念块：驱动编译
驱动编译用驱动编译、核心源码编译、内核模块加载验证连接到驱动编译的调试、验证和交付动作。
- 驱动编译
- 核心源码编译
- 内核模块加载验证
- 从源码编译适配内核的驱动
最小片段或样例检查项
直接使用发行版内核自带的 核心 驱动通常能工作，但当你需要为特定内核版本打补丁、启用实验性特性（如 5G 加速卸载）或修复已知 Bug 时，从源码编译就成了唯一可靠路径。编译驱动的第一步不是敲 make，而是确认内核源码树（Kernel Source Tree）与当前运行内核版本严格一致
运行 uname -r 获取内核版本，然后下载对应版本的完整内核源码。进入驱动源码目录（通常位于 drivers/net/ethernet/mellanox/），首先检查 Kconfig 文件。这里定义了驱动模块的编译开关，例如 配置核心 和 配置核心。你需要确保这些配置项在 .config 中被设置为 m（模块）或 y（内置）
执行 make menuconfig，在“Device Drivers → Network device support → Ethernet driver support → Mellanox”路径下，将 Mellanox ConnectX-4/ConnectX-5/ConnectX-6 core driver 标记为 M。保存退出后，务必用 grep 配置核心 .config 确认配置已生效
这一步是大多数编译失败的根源——Kconfig 依赖未满足（例如缺少 配置 或 配置），会导致 Makefile 构建时直接报错或生成残缺模块
Makefile 构建与内核模块编译实战
配置就绪后，进入内核源码根目录，执行模块编译命令：
make modules_prepare make M=drivers/net/ethernet/mellanox/mlx5/ modules
modules_prepare 生成编译模块所需的 Module.symvers 和基本头文件依赖。M= 参数指定驱动子目录，modules 目标只编译该目录下的可加载模块。编译产物 核心.ko 会出现在对应目录中。如果编译过程中出现“implicit declaration”或“unknown symbol”错误，通常是因为内核源码版本与当前运行内核不匹配，或 .config 中缺少某些 Kconfig 依赖
真实项目场景
某数据中心团队需要为 ConnectX-5 网卡启用 5G 加速卸载特性，但发行版内核的 核心 驱动未包含该补丁。他们从 NVIDIA 官方仓库拉取了驱动源码，将其放入内核源码树对应目录，通过修改 Kconfig 新增 配置 选项，并重新编译模块。加载后，dmesg 输出“核心: 5G acceleration enabled”，成功上线
编译完成后，将生成的 .ko 文件复制到模块目录：
sudo cp drivers/net/ethernet/mellanox/mlx5/核心.ko /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/mellanox/ sudo depmod -a
depmod -a 更新模块依赖关系，确保 modprobe 能正确解析符号依赖
问题对照与修正
- 常见偏差：把驱动编译直接写进主流程，只验证能跑通，留下驱动编译边界、状态和验证口径不清。
- 修正做法：把驱动编译收敛成稳定接口，明确伪代码和失败返回。
- 复核方式：构造一个异常输入或超时场景，用日志、断言和稳定性与可观测性证明修复有效。
加载验证与 dmesg 排障
加载新编译的内核模块前，务必卸载旧模块（如果已加载）：
sudo modprobe -r 核心 sudo modprobe 核心
加载后立即执行 dmesg | tail -20 检查内核日志。正常输出应包含类似“核心: Mellanox ConnectX-5 adapter”和“核心: Link up”的信息。如果出现“核心: probe of 0000:xx:xx.x failed with error -XX”，则需对照错误码排查。常见错误码 -ENODEV 表示 PCI 设备未识别，-EPROBE_DEFER 表示依赖驱动未就绪
加载后执行 lsmod | grep mlx5 确认模块已加载，并用 ethtool -i ethX 查看驱动版本是否为刚编译的版本。如果未更新，说明系统加载了旧模块，检查 /lib/modules 下的文件是否被正确覆盖
以下是编译与加载过程中最常见的三类故障及执行侧式：
| 现象 | 可能原因 | 检查位置 | 修复动作 |
|---|---|---|---|
| 编译报错： Kconfig: unmet direct… | .config 中缺少 配置 或 配置 | 内核根目录 .config 文件 | 执行 make menuconfig 补全依赖并重新生… |
| 加载时报错： modprobe: ERROR: cou… | 模块符号版本与内核不匹配，或 Module.symve… | /lib/modules/$(uname -r)/ 下… | 重新执行 make modules_prepare 并… |
| dmesg 显示 probe failed with… | PCI 配置空间读取异常，或固件版本不兼容 | lspci -vvv 查看 Mellanox 设备状态 | 更新网卡固件至官方推荐版本；检查 PCIe 链路是否为… |
| 网络接口未出现（ ip link 无 ethX） | 驱动加载成功但未绑定到 PCI 设备，或 核心 模块未… | lsmod | grep mlx5 检查模块列表 | 执行 modprobe 核心 加载以太网协议模块 |
很多开发者直接使用 make -C /lib/modules/$(uname -r)/build M=$(pwd) modules 编译外部驱动，但忽略了 Kconfig 依赖。如果内核源码树不完整或 .config 未同步，编译出的模块在加载时会因符号缺失而失败。务必先执行 make olddefconfig 同步配置
最后，确认 dmesg 无 error 或 warning 级别日志后，用 ethtool -i ethX 验证驱动版本与固件版本。如果一切正常，你的 核心 驱动已从源码成功编译并加载，可以进入下一节的双口绑定与性能调优
驱动编译先对齐现场任务、输入材料和输出结果，再回到驱动编译的细节逐项核对。
驱动编译的主要风险来自驱动编译边界、状态和验证口径不清；落地前必须核对伪代码，并确认例外场景和结果记录。
本节资料使用说明
驱动编译里最先使用的工具、样例或资料是哪一个？
替换驱动编译时，哪些位置可以改，哪些位置要保留？
输出物检查时，最不能漏掉哪一项？
如果换一套素材，使用顺序要不要调整？