ZCU111开发板Python脚本导入xrfclk模块报错求助

核心问题原因 #

你当前的导入配置存在两个错误：

• Python导入包时，sys.path需要添加的是包的父级目录，而非包本身的存储目录
• 你使用的SMB网络路径//192.168.2.99/...仅适用于Windows共享访问，在板载Linux系统本地运行代码时，需使用本地绝对路径

分步修复步骤 #

1. 确认本地路径
   你通过SSH登录开发板后，GitHub目录默认位于xilinx用户的home目录下，xrfclk包的父级目录绝对路径为：
   /home/xilinx/GitHub/ZCU111-PYNQ/ZCU111/packages
   可以执行ls /home/xilinx/GitHub/ZCU111-PYNQ/ZCU111/packages/xrfclk确认该目录下存在__init__.py文件，若缺失则创建空的__init__.py文件即可。

2. 修正路径导入代码
   将你的测试代码修改为如下内容：

import sys
# 插入包的父级目录到sys.path最前，优先级最高
sys.path.insert(0, '/home/xilinx/GitHub/ZCU111-PYNQ/ZCU111/packages')
import xrfclk

3. rfsoc_sam缺失问题修复
   如果后续需要使用rfsoc_sam模块，直接在板载终端执行如下命令安装即可，无需手动搬运源码：

pip3 install rfsoc-sam

验证方法 #

运行修改后的代码，执行print(xrfclk.__file__)，如果能正常输出xrfclk模块的存储路径，说明导入成功。

内容的提问来源于stack exchange，提问作者SamiH