1. USB4 Linux内核配置与模块加载

任务目标

在 Linux 内核中启用 USB4/Thunderbolt 支持，配置 CONFIG_USB4 相关选项，构建并加载 thunderbolt 模块，最后通过 sysfs 与 dmesg 验证 USB4 子系统已初始化。

环境与依赖

• 内核源码树（本案例以 6.x 为例），已安装 gcc、make、flex、bison、libelf-dev、libssl-dev。
• 当前内核配置可通过 /boot/config-$(uname -r) 或 /proc/config.gz 获取。
• 需要 root 权限执行 modprobe 与查看 dmesg。

关键配置项

USB4 子系统由 thunderbolt 模块实现，依赖以下选项：

• CONFIG_USB4=m：USB4 核心支持，编译为模块。
• CONFIG_USB4_NET=m：USB4 网络（可选，用于 USB4 网络设备）。
• CONFIG_USB4_DEBUGFS_WRITE：调试写入（可选）。
• CONFIG_ACPI、CONFIG_PCI：USB4 枚举依赖 ACPI 与 PCI 子系统。

配置与构建

cd /path/to/linux-source
make olddefconfig
scripts/config --module USB4
scripts/config --module USB4_NET
make olddefconfig
grep -E 'CONFIG_USB4' .config

确认输出包含 CONFIG_USB4=m。随后仅构建该模块以节省时间：

make -j$(nproc) M=drivers/thunderbolt modules
sudo make M=drivers/thunderbolt modules_install
sudo depmod -a

加载与验证

sudo modprobe thunderbolt
lsmod | grep thunderbolt
ls /sys/bus/thunderbolt/devices/
dmesg | grep -i thunderbolt | tail -n 20

通过条件：lsmod 显示 thunderbolt 已加载；/sys/bus/thunderbolt/devices/ 存在（无设备时可能为空目录，但目录本身存在即表示子系统已注册）；dmesg 中出现 thunderbolt 初始化相关行，且无 Unknown symbol 或 module verification failed 错误。

最小验证脚本

#!/bin/bash
set -e
modprobe thunderbolt
if lsmod | grep -q '^thunderbolt'; then
    echo "PASS: thunderbolt module loaded"
else
    echo "FAIL: module not loaded"
    exit 1
fi
if [ -d /sys/bus/thunderbolt/devices ]; then
    echo "PASS: USB4 subsystem registered"
else
    echo "FAIL: sysfs entry missing"
    exit 1
fi
dmesg | grep -i thunderbolt | tail -n 5

USB4 子系统初始化流程

常见问题

• modprobe: FATAL: Module thunderbolt not found：说明 CONFIG_USB4 未设为 m 或模块未安装，重新执行 scripts/config --module USB4 并 modules_install。
• Unknown symbol：依赖模块未加载，先 modprobe acpi、modprobe pci 或检查 modinfo thunderbolt 的 depends 字段。
• sysfs 目录为空：表示子系统已注册但当前无 USB4 设备接入，属正常状态。