3. 内核编译环境搭建

内核编译环境是蓝牙驱动开发的基础设施。本章将指导你完成从源码下载、内核配置、编译到模块安装的完整流程。一个正确配置的内核环境，是后续驱动加载与中断调试的前提。

3.1 下载内核源码

Linux 内核源码可以从 kernel.org 获取，也可使用发行版提供的定制源码。对于蓝牙驱动开发，建议使用长期支持（LTS）版本，以获得稳定的 API 和较长的维护周期。

获取方式	命令/地址	适用场景
官方主线	wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.8.tar.xz	通用开发、最新特性验证
发行版源码	apt-get source linux-image-$(uname -r) (Debian/Ubuntu)	与当前系统内核版本对齐
Git 仓库	git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git	持续跟踪、分支管理

下载完成后，解压源码树：

tar -xvf linux-6.6.8.tar.xz -C /usr/src/
cd /usr/src/linux-6.6.8

3.2 配置内核选项

内核配置是决定哪些功能被编译进内核、哪些作为模块的关键步骤。蓝牙驱动相关的配置项集中在 Networking support → Bluetooth subsystem 下。

3.2.1 配置方法选择

配置命令	交互方式	推荐场景
make menuconfig	终端图形界面（ncurses）	最常用，适合手动逐项选择
make defconfig	基于架构默认配置	快速生成基础配置
make localmodconfig	基于当前系统已加载模块	精简内核，只编译当前硬件需要的驱动

3.2.2 蓝牙核心选项配置

执行 make menuconfig 后，按以下路径启用蓝牙支持：

Networking support  --->
  <*> Bluetooth subsystem  --->
    <*>   Bluetooth Classic (BR/EDR)
    <*>   Bluetooth Low Energy (LE)
    <*>   Bluetooth device drivers  --->
      <M>   HCI USB driver
      <M>   HCI UART driver
      <M>   HCI SDIO driver

3.2.3 中断与调试相关选项

为了后续章节的中断调试，还需启用以下选项：

• Kernel hacking → Debugging → <*> Magic SysRq key — 用于中断调试
• Device Drivers → <*> GPIO Support → <M> GPIO interrupt support — 蓝牙中断线依赖
• Kernel hacking → <*> Dynamic debugging — 动态打印蓝牙驱动调试信息

3.3 编译内核与模块

配置完成后，进入编译阶段。编译过程分为内核镜像编译和模块编译两部分。

3.3.1 编译命令速查

步骤	命令	说明
编译内核	make -j$(nproc)	并行编译，nproc 获取 CPU 核心数
编译模块	make modules -j$(nproc)	仅编译模块，不重新编译内核
编译特定模块	make M=drivers/bluetooth	仅编译蓝牙子系统模块，节省时间

3.3.2 蓝牙模块编译示例

以下命令演示如何单独编译蓝牙核心模块和 HCI USB 驱动模块：

# 编译蓝牙核心模块
make M=net/bluetooth -j$(nproc)

# 编译蓝牙驱动模块
make M=drivers/bluetooth -j$(nproc)

# 查看编译生成的模块文件
ls -la drivers/bluetooth/*.ko
# 输出示例：
# -rw-r--r-- 1 root root 123456  bluetooth.ko
# -rw-r--r-- 1 root root  65432  hci_uart.ko
# -rw-r--r-- 1 root root  78901  btusb.ko

3.4 安装模块

编译完成后，需要将模块安装到系统模块目录中，以便 modprobe 等工具能够加载。

3.4.1 安装命令

# 安装所有模块到 /lib/modules/$(uname -r)/
make modules_install

# 安装内核镜像到 /boot/
make install

3.4.2 模块安装目录结构

安装后，蓝牙模块位于以下路径：

/lib/modules/6.6.8/
├── kernel/
│   ├── net/
│   │   └── bluetooth/
│   │       ├── bluetooth.ko
│   │       ├── bnep.ko
│   │       ├── btusb.ko
│   │       └── rfcomm.ko
│   └── drivers/
│       └── bluetooth/
│           ├── hci_uart.ko
│           ├── btbcm.ko
│           └── btintel.ko
└── modules.dep
└── modules.alias

3.5 验证编译环境

完成安装后，通过以下步骤验证环境是否就绪：

1. 检查内核版本： uname -r 确认新内核已生效
2. 检查模块存在： find /lib/modules/$(uname -r) -name "bt*.ko"
3. 加载蓝牙模块： modprobe btusb 测试加载
4. 查看模块信息： modinfo btusb 确认版本和依赖

3.6 常见问题与解决

问题现象	可能原因	解决方案
make menuconfig 报错	缺少 ncurses 库	apt-get install libncurses-dev
模块加载时提示 Unknown symbol	模块依赖未更新	执行 depmod -a 重建依赖
编译时 No rule to make target	源码树不完整或配置未保存	重新执行 make menuconfig 并保存
蓝牙设备无法识别	HCI 驱动未正确配置	检查 drivers/bluetooth 下对应驱动是否已编译