树莓派4B 6.1.21-v8+内核模块编译加载失败求助

核心原因：内核源码与运行内核不匹配 #

树莓派官方提供的内核是经过定制修改的（包含硬件专属补丁、特定编译配置），你使用的上游Linux 6.1.21/6.1.38源码和当前运行的6.1.21-v8+内核并非完全一致，导致编译出的模块与内核的符号表、ABI（应用二进制接口）不兼容，从而触发Exec format error或Unknown symbol错误。

步骤1：获取完全匹配的内核头文件/源码 #

方法A：通过包管理器安装内核头文件（推荐） #

官方系统直接用apt安装对应版本的内核头文件，会自动匹配当前运行内核：

sudo apt update
sudo apt install raspberrypi-kernel-headers

这个命令会下载与6.1.21-v8+完全匹配的头文件和编译依赖，无需手动找源码。

方法B：拉取树莓派官方内核仓库的对应版本 #

如果apt无法获取（比如系统版本过旧），直接克隆官方内核仓库并切换到对应版本：

1. 查看内核的构建信息：

   uname -a
   # 示例输出：Linux raspberrypi 6.1.21-v8+ #1642 SMP PREEMPT Mon Apr  3 17:24:16 BST 2023 aarch64 GNU/Linux
   # 其中#1642是构建编号，对应仓库的标签可通过固件版本匹配
   

2. 克隆并切换版本：

   git clone https://github.com/raspberrypi/linux.git
   cd linux
   # 查看对应版本的标签（比如对应构建#1642的标签是raspberrypi-kernel_1.20230405-1）
   git checkout <匹配的标签或提交哈希>
   

步骤2：正确编译并安装模块 #

1. 编写或修改模块的Makefile（确保指向当前内核的构建目录）：

   obj-m += hid-mcp2221.o
   KERNEL_DIR := /lib/modules/$(shell uname -r)/build
   PWD := $(shell pwd)
   all:
       $(MAKE) -C $(KERNEL_DIR) M=$(PWD) modules
   clean:
       $(MAKE) -C $(KERNEL_DIR) M=$(PWD) clean
   

2. 本地编译模块：

   make
   

3. 安装并更新模块依赖：

   sudo cp hid-mcp2221.ko /lib/modules/$(uname -r)/kernel/drivers/hid/
   sudo depmod -a
   

4. 加载模块：

   sudo modprobe hid-mcp2221
   

额外排查点 #

• 确认编译架构：树莓派4B 64位系统必须用aarch64架构编译，本地编译时不要误装32位工具链；交叉编译时要指定正确的目标架构。
• 检查内核配置：确保CONFIG_HID等基础HID选项已开启，可通过zcat /proc/config.gz | grep CONFIG_HID验证，依赖选项未开启也会导致符号错误。

内容的提问来源于stack exchange，提问作者Martin J Levy