下载完整 PDF

6 故障排除

6.1 端口 "xillybus_0_conduit_..." 不存 在

在使用 Quartus II 编译 xillydemo 项目期间，可能出现类似以下错误信息：

Error (12002): Port "xillybus_0_conduit_M_AXI_ARADDR" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARBURST" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARCACHE" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARID" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARLEN" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARLOCK" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARPROT" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARREADY" does not exist in macrofunction "u0" File: xillybus.v Line: 442
Error (12002): Port "xillybus_0_conduit_M_AXI_ARSIZE" does not exist in macrofunction "u0" File: xillybus.v Line: 442
...

未能找到这些端口很可能表明本应在编译之前运行的脚本未运行。这很可能是由于 QSF 文件被错误修改，或者源文件被不 当移植到自定义 Quartus II 项目中所致。更多详情请参见第 5.3 节。

6.2 USB 键盘和鼠标问题

几乎所有 USB 键盘和鼠标都符合兼容性行为的标准规范，因此不太可能遇到设备无法识别的问题。如果出现问题，应首先 检查以下几点：

  • 设备是否在 Linux 执行启动时已连接？如果没有，请连接鼠标和/或键盘后重新启动 Linux。

  • 您是否使用了正确的 USB 插口？应该使用中间标有“HPS USB”的插口。

  • 如果使用了 USB 集线器（hub），请尝试仅将键盘或鼠标直接连接到通往 SoCKit 开发板 OTG 端口的那根 USB 线缆 上。

系统通用日志文件 /var/log/syslog 中可能包含有用的信息。有时使用“less /var/log/syslog”查看其内容会有所帮助。更好的方 法是输入“tail -f /var/log/syslog”，这样新消息会实时打印到控制台。这特别有用，因为 USB 总线上的事件始终会记录在此日志中，包括关于 检测到何种设备以及如何处理事件的详细描述。

请注意，也可通过 USB UART 访问 shell 提示符（shell prompt），因此如果连接键盘失败，可以通过串行终端查看日志。请 参考 SoCKit 开发板的文档以了解如何设置 UART 链路。

6.3 文件系统挂载问题

经验表明，如果使用合适的 microSD 卡，并在关闭开发板电源前正确关闭系统，那么永久存储就不会出现任何问题。

未卸载根文件系统（root file system）就关闭开发板电源不太可能导致文件系统本身出现永久性不一致，因为 ext4 文件系统 会在下次挂载时通过日志（journal）进行自我修复。然而，操作系统功能会累积受损，因为在断电时已打开进行写入的文件可能会残留错误 内容或被完全删除。这种情况适用于任何突然断电的计算机。

如果根文件系统挂载失败（导致启动时内核恐慌（kernel panic））或只能以只读方式挂载，最可能的原因是 microSD 卡质 量不佳。此类存储设备常出现的情况是：起初工作正常，但一段时间后开始出现随机错误信息。如果 /var/log/syslog 中包含如下信息，则 （Micro）SD 卡很可能是原因：

EXT4-fs (mmcblk0p2): warning: mounting fs with errors, running ec2fsck
 is recommended

为避免这些问题，请坚持使用 SanDisk 设备。

6.4 “startx”失败（图形桌面无法启 动）

尽管并非直接相关，但当 microSD 卡非 SanDisk 制造时，此问题被频繁报告。图形软件在启动时会从卡中读取大量数据， 因此很可能成为产生读取错误的 microSD 卡的显著受害者。

显而易见的解决方案是使用 SanDisk microSD 卡。