Zynq Linux 内核驱动开发与 insmod 加载流程指南

Zynq Linux 内核驱动开发与 insmod 加载流程指南

本指南详细梳理了在 Xilinx Zynq 平台（基于 linux-xlnx-xilinx-v2016.4 / Linux 4.4）上进行内核驱动开发、编译及手动加载的完整流程。针对高版本主机 GCC 兼容性问题及 Makefile 配置等关键环节进行了专项说明，确保开发过程顺畅。

1. 环境准备与配置提取

在编译驱动前，必须确保宿主机编译环境与开发板运行内核的配置完全一致，否则insmod时会报Invalid module format或符号版本不匹配错误。

1.1 从开发板提取真实配置

在开发板终端执行以下命令获取当前运行的内核配置：

# 确保 /tmp 可写（若 /mnt/sdcard 未挂载则使用 /tmp）zcat /proc/config.gz>/tmp/board.config# 验证配置文件有效性（应输出大量 CONFIG_ 开头的行）head-n5/tmp/board.config# 预期输出示例：# CONFIG_ARM=y# CONFIG_ARCH_ZYNQ=y# CONFIG_MODULE_UNLOAD=y# CONFIG_MODVERSIONS=y

1.2 同步配置到宿主机

将提取的board.config拷贝至宿主机内核源码根目录，并替换为.config：

# 在宿主机内核源码根目录执行cp/path/to/board.config ~/mywork/linux-xlnx-xilinx-v2016.4/.configcd~/mywork/linux-xlnx-xilinx-v2016.4makeARCH=arm olddefconfig

注意：olddefconfig会自动补齐新版内核新增的默认选项，同时保留板子原有配置，是保证配置一致性的关键步骤。

2. 驱动源码放置与 Makefile 修改（关键步骤）

这是最容易被遗漏的一步。内核编译系统依赖Makefile或Kbuild文件来识别需要编译的模块。如果不修改此文件，即使源码存在，编译器也会忽略它。

2.1 放置驱动源码

假设您的 LCD 驱动源码为lcd_zynq_panel.c，请将其放入内核源码树对应的目录下，例如：
~/mywork/linux-xlnx-xilinx-v2016.4/drivers/char/（或者drivers/video/fbdev/，视具体驱动类型而定）。

2.2 修改驱动目录下的 Makefile

进入源码所在的目录，编辑该目录下的Makefile文件。您需要添加一行obj-m指令，告诉构建系统将您的.c文件编译为内核模块（.ko）。

操作示例：

cd~/mywork/linux-xlnx-xilinx-v2016.4/drivers/char/vimMakefile

在文件末尾（或适当位置）添加以下内容：

# 将 lcd_zynq_panel.c 编译为 lcd_zynq_panel.ko 模块 obj-m += lcd_zynq_panel.o # 如果有多个源文件或依赖，也可以一并添加 # obj-m += lcd_zynq_panel_gpio_spi.o # obj-m += testspi_sc1161y.o

语法说明：

• obj-m += <name>.o：表示将<name>.c编译为可加载的内核模块（Module）。
• obj-y += <name>.o：表示将<name>.c直接编译进内核镜像（Built-in），这种方式无法通过insmod加载。
• 务必确认：您添加的是obj-m而不是obj-y，除非您希望重新烧写整个内核。

3. 解决高版本 GCC 兼容性问题

Xilinx SDK 2016.4 对应 Linux 4.4 内核，而现代主机系统（如 Ubuntu 20.04/22.04）通常搭载 GCC 10 或更高版本。
从 GCC 10 开始，C 语言标准默认开启-fno-common。这会导致旧版内核源码中设备树编译器 (DTC) 的全局变量yylloc在链接时报错multiple definition of 'yylloc'。

解决方案：在编译命令中显式添加HOSTCFLAGS="-fcommon"参数。

4. 编译内核模块

4.1 清理旧文件（可选但推荐）

在重新编译特定驱动前，建议先清理该目录下的旧目标文件：

makeARCH=arm\CROSS_COMPILE=/opt/Xilinx/SDK/2016.4/gnu/aarch32/lin/gcc-arm-linux-gnueabi/bin/arm-linux-gnueabihf-\M=drivers/char\clean

4.2 编译指定模块

使用M=参数指定要编译的模块目录。注意路径必须是相对于内核源码根目录的路径。

cd~/mywork/linux-xlnx-xilinx-v2016.4makeARCH=arm\CROSS_COMPILE=/opt/Xilinx/SDK/2016.4/gnu/aarch32/lin/gcc-arm-linux-gnueabi/bin/arm-linux-gnueabihf-\HOSTCFLAGS="-fcommon"\M=drivers/char\modules -j$(nproc)

• 参数解析：
  • ARCH=arm：指定目标架构。
  • CROSS_COMPILE=...：指定交叉编译工具链前缀。
  • HOSTCFLAGS="-fcommon"：修复 GCC 10+ 编译 DTC 工具时的链接错误。
  • M=drivers/char：指定只编译该目录下的外部模块。
  • modules：指明编译目标是模块。

4.3 验证编译结果

编译成功后，检查.ko文件是否生成：

ls-lhdrivers/char/lcd_zynq_panel.kofiledrivers/char/lcd_zynq_panel.ko

如果看到ELF 32-bit LSB relocatable, ARM字样，说明编译成功。

5. 部署与加载驱动

5.1 传输文件到开发板

将生成的.ko文件通过 SCP、NFS 或 SD 卡拷贝到开发板文件系统中。

# 示例：使用 scp 拷贝scpdrivers/char/lcd_zynq_panel.ko root@<开发板IP>:/home/root/

5.2 加载驱动

在开发板终端执行加载命令：

insmod /home/root/lcd_zynq_panel.ko

5.3 验证与调试

• 查看加载状态：使用lsmod | grep lcd_zynq_panel确认模块已加载。
• 查看日志：使用dmesg | tail查看驱动打印的初始化信息（如probe函数输出）。
• 卸载驱动：如果需要重新测试，使用rmmod lcd_zynq_panel卸载。

# 查看内核日志（加载前先清空，便于观察）dmesg-C# 加载模块insmod lcd_zynq_panel.ko# 实时查看加载日志dmesg|tail-20# 确认模块已加载lsmod|greplcd_zynq_panel# 卸载模块（调试用）rmmod lcd_zynq_panel

6. 常见问题排查速查表

7. 附录：设备树编译（如需修改硬件描述）

如果您修改了设备树源文件（.dts）以适配新驱动，需在宿主机重新编译 DTB：

dtc-Idts-Odtb-odevicetree.dtb devicetree.dts

将生成的devicetree.dtb替换开发板启动分区中的原文件，并重启开发板使硬件配置生效。

8. 开发注意事项

1. 配置备份习惯：每次成功编译后，立即备份.config和Module.symvers：

   cp.config .config.bakcpModule.symvers Module.symvers.bak

2. 避免全量 clean：日常驱动调试只需M=xxx clean，不要频繁执行顶层make clean，否则会丢失Module.symvers导致所有外部模块失效。
3. 交叉编译器一致性：始终使用 SDK 2016.4 自带的arm-linux-gnueabihf-工具链，切勿混用系统自带或其他版本的交叉编译器。
4. HOSTCFLAGS 不可省略：只要宿主机 GCC ≥ 10，HOSTCFLAGS="-fcommon"就是必选项，不仅限于模块编译，内核整体编译同样需要。