如何在OpenCPI应用XML中指定组件属于HDL装配体？

核心原因 #

系统组件（ocpi.core.file_read/file_write）属于OpenCPI官方库，默认在搜索路径内；而你的HDL组件属于自定义装配体，需要明确指定装配体的完整引用路径，否则ocpirun无法定位到对应的实现。

具体修复步骤 #

1. 确认HDL装配体的构建与环境配置 #

• 先确保你的HDL装配体已通过ocpidev build完成构建，构建产物（如*.hdl.xml、平台相关二进制文件）存在于项目的build目录下。
• 检查OpenCPI环境变量，确保你的项目目录被加入OCPI_LIBRARY_PATH：

  echo $OCPI_LIBRARY_PATH
  # 若未包含项目路径，执行：export OCPI_LIBRARY_PATH=$OCPI_LIBRARY_PATH:/path/to/your/project
  

2. 修正XML中的组件引用格式 #

根据你的装配体类型，选择以下正确的引用方式：

方式一：通过包名+装配体名引用（推荐，适用于已打包的装配体）

假设你的HDL装配体所属包名为my_hdl_project，装配体文件名为signal_processing.hdl.xml，且装配体内部定义了fft_1024_xs和peak_detector_xs_us组件实例，那么XML应修改为：

<Application done='file_write'>
    <Instance component='ocpi.core.file_read' name='file_read' connect='fft_1024'>
        <property name='filename' value='react_jammer_rx.input'/>
        <property name='granularity' value='4'/>
        <property name='messageSize' value='1024'/>
    </Instance>
    <!-- 修正：包名.装配体名.组件实例名 -->
    <Instance component='my_hdl_project.signal_processing.fft_1024_xs' name='fft_1024' connect='peak_detector'/>
    <Instance component='my_hdl_project.signal_processing.peak_detector_xs_us' name='peak_detector' connect='file_write'/>
    <Instance component='ocpi.core.file_write' name='file_write'>
        <property name='filename' value='react_jammer_rx.output'/>
    </Instance>
</Application>

方式二：直接指定装配体文件路径（适用于本地临时测试）

如果是未打包的本地装配体，可以直接用相对/绝对路径指向装配体文件，再拼接组件名：

<Instance component='./path/to/your/assembly.hdl.xml.fft_1024_xs' name='fft_1024' connect='peak_detector'/>
<Instance component='./path/to/your/assembly.hdl.xml.peak_detector_xs_us' name='peak_detector' connect='file_write'/>

3. 验证组件是否可被识别 #

执行以下命令，查看系统可识别的组件列表，确认你的HDL组件是否在其中：

ocpirun --list-components | grep -E "fft_1024_xs|peak_detector_xs_us"

如果未找到，检查：

• 装配体构建是否成功，有无编译错误
• 目标HDL平台是否与当前运行环境匹配（比如构建的是zynq平台，不能在xsim仿真环境运行）
• 组件名称与装配体定义是否完全一致（大小写、下划线需严格匹配）

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