紫光FPGA PCIe驱动在Ubuntu 24.04下的实战避坑指南
1. 紫光FPGA PCIe驱动开发环境搭建
第一次在Ubuntu 24.04上折腾紫光FPGA的PCIe驱动时，我踩了不少坑。新系统带来的内核变更和Secure Boot机制让原本简单的驱动安装变得复杂起来。这里分享下我的实战经验，帮你避开那些让我熬夜的坑。
Ubuntu 24.04默认启用了Secure Boot安全机制，这意味着所有内核模块都需要经过数字签名才能加载。我试过直接禁用Secure Boot，但考虑到系统安全性，最后还是选择了更规范的驱动签名方案。具体操作时要注意，生成的密钥对需要妥善保管，特别是私钥文件MOK.priv一旦泄露就可能被恶意利用。
内核API的变化是另一个大坑。紫光官方提供的驱动代码使用的是较旧的内核接口，在24.04上直接编译会报错。最关键的改动是DMA内存分配函数，从原来的pci_alloc_consistent变成了dma_alloc_coherent。我在调试时发现，如果只修改函数名而不注意参数变化，会导致内存分配失败。正确的参数传递应该是将pci_dev替换为&pci_dev->dev。
2. PCIe驱动编译与签名实战
2.1 驱动代码适配
拿到紫光官方提供的驱动代码后，别急着编译。先用文本编辑器全局搜索以下几个关键函数：
- pci_alloc_consistent
- pci_set_dma_mask
- pci_map_single
这些都需要替换为新内核的对应函数。我整理了一份完整的替换对照表：
| 旧函数 | 新函数 | 参数变化 |
|---|---|---|
| pci_alloc_consistent | dma_alloc_coherent | 增加GFP_KERNEL参数 |
| pci_free_consistent | dma_free_coherent | dev参数结构变化 |
| pci_set_dma_mask | dma_set_mask | 参数类型变化 |
修改完后，建议先用make命令试编译，确保没有语法错误。常见的编译错误包括头文件缺失和函数声明冲突，可以通过安装linux-headers包解决：
sudo apt install linux-headers-$(uname -r)2.2 Secure Boot驱动签名
驱动编译通过只是第一步，在Secure Boot开启的系统上，还需要完成签名流程。我推荐使用sbsigntool工具链，比手动操作更可靠。关键步骤包括：
- 创建签名密钥对时，建议将有效期设置为10年（3650天），避免频繁更换：
openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 3650 -subj "/CN=Your_Driver_Key/"注册公钥到系统时，mokutil会提示设置临时密码。这个密码只需要在下次重启时使用一次，但必须牢记至少8个字符。我建议用短语而不要用简单数字，比如"DriverSign2024"。
实际签名操作要注意路径问题。最好使用绝对路径指定.ko文件位置，避免因工作目录变化导致签名失败。我常用的签名命令格式：
sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 /path/to/MOK.priv /path/to/MOK.der /path/to/driver.ko签名完成后，可以用modinfo命令验证签名是否成功。如果看到"signer"和"sig_key"字段显示正确信息，说明签名流程没问题。
3. 自动化脚本开发技巧
每次开机都要重新签名和加载驱动太麻烦，我开发了几个实用脚本来自动化这些流程。
3.1 驱动加载脚本
创建一个load_driver.sh文件，内容如下：
#!/bin/bash DRIVER_PATH="/path/to/your/driver.ko" SIGN_KEY="/path/to/MOK.priv" SIGN_CERT="/path/to/MOK.der" # 检查驱动是否已加载 if lsmod | grep -q "pango_pci_driver"; then echo "Driver already loaded" exit 0 fi # 签名并加载驱动 sudo /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 $SIGN_KEY $SIGN_CERT $DRIVER_PATH sudo insmod $DRIVER_PATH # 检查设备节点 if [ ! -c "/dev/pango_pci" ]; then sudo mknod /dev/pango_pci c 250 0 fi给脚本添加执行权限后，可以设置成开机自启动。但要注意，在systemd服务中需要配置延迟启动，确保内核模块加载完成后再执行脚本。
3.2 调试信息收集脚本
调试PCIe驱动时，我经常需要查看内核日志和硬件信息。这个debug_info.sh脚本可以一键收集所有相关信息：
#!/bin/bash LOG_FILE="pcie_debug_$(date +%Y%m%d_%H%M%S).log" { echo "=== Kernel Version ===" uname -a echo "\n=== PCIe Devices ===" lspci -vvv | grep -i pango echo "\n=== Loaded Modules ===" lsmod | grep pci echo "\n=== Kernel Messages ===" dmesg | grep -i pango echo "\n=== Driver Info ===" modinfo /path/to/your/driver.ko } > $LOG_FILE echo "Debug info saved to $LOG_FILE"这个脚本会把所有关键信息输出到一个带时间戳的日志文件中，方便后续分析。
4. 常见问题排查指南
4.1 驱动加载失败
如果insmod命令报错"Required key not available"，说明签名环节出了问题。按照以下步骤排查：
- 检查/boot/config-$(uname -r)文件中CONFIG_MODULE_SIG是否开启
- 确认签名使用的密钥与注册到系统的密钥一致
- 查看系统日志获取详细错误信息：journalctl -k | grep -i secure
4.2 DMA传输不稳定
遇到DMA传输丢数据或卡顿时，可以从以下几个方面检查：
- 确认FPGA端的DMA控制器配置正确，特别是burst长度和时钟域设置
- 检查上位机驱动中的内存屏障使用是否恰当
- 使用perf工具分析系统中断延迟
4.3 性能优化建议
通过实际测试，我发现以下几个参数对PCIe传输性能影响很大：
- /sys/module/pcie_aspm/parameters/policy - 建议设置为"performance"
- /proc/sys/vm/dirty_ratio - 适当增大可以减少IO等待
- 驱动中的DMA缓冲区大小 - 根据实际数据量调整
在FPGA端，优化TLP包的大小和发送策略也能显著提升吞吐量。我通常会把大的DMA传输拆分成多个中等大小的包，既避免占用总线太久，又减少协议开销。