1.获取到一个Vitis例程后，如何使用？
以裸机视频课程的第23课例程ZYNQ_HDMI为例，首先将其解压，可以得到以下文件：
双击.xpr即可打开Vivado工程，Vivado工程主要实现硬件逻辑系统的搭建，实现方式通常为BD设计或BD+verilog模块设计。
用户可以通过Tools -> Launch Vitis IDE的方式打开Vitis软件，然后指定Vitis工程的工作空间（vitis工程路径）。当然，也可以直接运行Vitis软件，然后指定Vitis工程的工作空间。
指定正确的工作空间后，点击Launch便可以打开Vitis工程。打开的过程中，如果出现进度条始终卡在快一半的位置，且软件出现无响应的情况，则说明Vitis的工作空间遭到了损坏，解决方法请查看下方的常见问题。
Vitis工程打开后，由于工程路径发生了改变，因此我们需要为其重新定位xsa路径。
定位完成后，依次编译Platform工程和应用工程，随后，便可以创建烧录任务进行下载验证了
下载任务建议选择GDB，注意检查任务的Application项和Target Setup项是否正确配置
2.修改硬件逻辑系统后，如何更新Vitis工程
如果需要对例程的硬件逻辑系统设计进行修改（如添加串口、添加QSPI、SD控制器），在修改完成并确认修改后的设计无误后，需要重新生成bit并导出xsa文件。导出时注意需要勾选包含bit。
而Vitis工程的更新则相较繁琐，为了避免因为流程出错导致的部分文件更新不到位，通常建议重新创建Platform工程，并重新为应用工程指定对应的Platform。譬如，这里笔者根据新导出的.xsa文件，创建了一个名为NEW_Platform的工程
新创建的platform工程会处于out-of-data状态，需要先进行编译。编译完成后out-of-data状态便会消失。
接着展开应用工程，双击对应的.sprj文件，点击Platform进行修改
在弹出的页面中，选择新创建的Platform工程，然后点击OK
接下来软件会提示，将清除所有当前工程的编译配置，点击YES即可。
当工程clean完成后，重新对应用工程进行编译，至此便完成了Vitis工程的更新
3.常见问题
a.vitis工程无法打开，进度条卡在一半位置
这种情况是因为工程的工作空间出现了损坏。只需要删除工作空间的配置文件，然后重新导入工程即可。
相关步骤可参考下帖：
b.更多常见问题后续添加
| 
|小黑屋|Archiver|芯路恒电子技术论坛
|鄂ICP备2021003648号
发表于 2026-2-10 13:30:31