ZHDA251 July   2026 AFE7900 , AFE7901 , AFE7903 , AFE7906 , AFE7950 , AFE7950-SP , AFE7951 , AFE7953 , AFE7954 , AFE7955 , AFE7958

 

  1.   1
  2.   摘要
  3.   商标
  4. 1简介
  5. 2Linux 内核驱动程序
    1. 2.1 使用 PetaLinux Tools 的 Linux 内核驱动程序
    2. 2.2 使用 Yocto Project 的 Linux 内核驱动程序
      1. 2.2.1 Yocto Project 概述
      2. 2.2.2 主机系统要求
      3. 2.2.3 设置 Yocto 构建环境
      4. 2.2.4 配置板卡专用层
      5. 2.2.5 集成 AFE79xx Yocto 层
      6. 2.2.6 验证集成
      7. 2.2.7 故障排查
    3. 2.3 准备 Linux 引导映像
    4. 2.4 从用户空间运行 AFE79xx 器件
  6. 3在应用层构建 AFE79xx SDK
    1. 3.1 使用 PetaLinux Tools 构建不含 AFE79xx SDK 的 Linux 内核
    2. 3.2 在用户空间中集成 SPI 与 AFE79xx
  7. 4面向 ZCU102 FPGA 的参考设计（含处理器和 SPI）
    1. 4.1 配置 Zynq 处理器
    2. 4.2 配置 SPI 接口
    3. 4.3 生成硬件描述
    4. 4.4 使用 SD 卡引导 ZCU102 板
  8. 5总结
  9. 6参考资料

2.2.7 故障排查

表 2-2 故障排查
问题 症状 解决方法
引导时模块未加载 lsmod 未显示 afe79 条目 确认 local.conf 中存在 IMAGE_INSTALL:append =“afe79”。检查目标系统上是否存在 /etc/modules-load.d/afe79.conf。
构建语法错误 与 IMAGE_INSTALL 或 KERNEL_MODULE_AUTOLOAD 相关的 BitBake 解析错误 确认 Yocto 版本。对于低于 Honister 的版本，请使用下划线语法。
驱动程序探测失败 dmesg 中没有初始化消息 确认器件树在正确的 SPI 总线上包含一个具有 compatible =“ti,afe79xx”且 status =“okay”的节点。
器件文件未创建 /dev/afe79* 不存在 检查 dmesg 是否存在驱动程序绑定错误。确认 SPI 控制器已在器件树中启用。
SPI 通信故障 应用程序返回不正确的读取值或错误 确认使用了正确的器件文件。确认 SPI 频率和模式与硬件匹配。对于 Xilinx 平台，确认 FPGA 位流通过 FMC 连接器正确地将 SPI 信号路由至 AFE79xx 器件。
嵌套构建目录 配置意外复位 始终从项目根目录获取环境脚本，切勿从构建目录内获取。如果意外创建了嵌套的构建子目录，请将其删除。