4、Vitis安装:Vitis统一软件平台的安装,与Vivado的版本匹配关系,安装后的环境验证

好,咱们接着往下走。Vivado装好了,接下来就是Vitis了。

说实话,很多刚接触Zynq的朋友容易搞混一件事:Vitis到底是个啥?它和Vivado是什么关系?

我简单解释一下。Vivado主要负责硬件设计,说白了就是画FPGA的电路、写RTL代码、做综合布局布线。而Vitis呢,是负责软件开发的——你写的ARM端C代码、Linux驱动、裸机程序,全在Vitis里搞定。

嗯,这里要注意:从2019.2版本开始,Xilinx把SDK(Software Development Kit)正式更名为Vitis,并且把它做成了一个统一的软件平台。所以你现在看到的Vitis,其实包含了以前SDK的全部功能,还加了很多新玩意儿。

4.1 版本匹配关系:别踩这个坑

我个人习惯,在安装之前一定会先确认版本匹配。为什么?因为我在项目中遇到过太多次版本不匹配导致的玄学问题。

Vitis和Vivado的版本必须严格对应。比如你装了Vivado 2020.1,那就必须装Vitis 2020.1。混着用?等着报错吧。

Vivado版本 Vitis版本 兼容性说明
2019.2 2019.2 首个Vitis版本,SDK正式退役
2020.1 2020.1 稳定版本,推荐使用
2020.2 2020.2 修复了一些bug,我目前用的就是这个
2021.1 2021.1 新增了一些AI加速功能
2022.1 2022.1 支持更多新器件
⚠️ 警告:千万不要尝试用Vivado 2020.1去配Vitis 2020.2。我曾经手贱试过一次,结果编译出来的程序跑在板子上直接死机,查了两天才发现是版本不匹配的问题。

4.2 安装步骤:一步步来

安装Vitis其实和装Vivado是同一个安装包。你下载Vivado的时候,安装程序会让你选择要安装的组件。

具体操作是这样的:

  1. 运行Vivado安装程序(就是你下载的那个exe文件)
  2. 在组件选择界面,勾选「Vitis」选项
  3. 如果你需要做嵌入式Linux开发,记得勾选「Vitis Embedded Platform」
  4. 选择安装路径(我建议和Vivado放在同一个盘符下)
  5. 点击Next,等待安装完成
💡 小技巧:安装时间会比较长,大概30分钟到1小时不等。我一般会趁这个时间去泡杯咖啡,或者看看文档。别着急,慢慢等。

你想想看,Vitis的安装包其实包含了交叉编译工具链、调试器、各种库文件,加起来好几个G呢。所以安装慢是正常的。

4.3 安装后的环境验证

装完了,怎么知道装没装好?别急着写代码,先做几个简单的验证。

我个人习惯用命令行来验证。打开终端(Windows下是CMD或者PowerShell),输入以下命令:

# 检查Vitis版本
vitis -version

# 检查交叉编译工具链
aarch64-none-elf-gcc --version

# 检查XSCT(Xilinx Software Command-line Tool)
xsct -version

如果这些命令都能正常输出版本信息,那恭喜你,Vitis安装成功了。

嗯,这里要注意:如果你在命令行里输入vitis提示找不到命令,那多半是环境变量没配好。去检查一下系统环境变量里有没有添加Vitis的bin目录。

✅ 验证清单:
  • Vitis GUI能正常启动
  • 命令行能识别vitis、xsct等命令
  • 交叉编译工具链能正常编译Hello World
  • 能创建并导入Vivado导出的硬件描述文件(.xsa)

4.4 常见问题与避坑指南

我遇到过不少新手在安装Vitis时翻车,这里列几个典型问题:

  • 问题1:安装后Vitis打不开
    多半是Java环境问题。Vitis依赖Java运行环境,检查一下你的JDK版本是否匹配。
  • 问题2:编译时报错找不到头文件
    这通常是路径问题。检查一下工程设置里的Include路径是否正确。
  • 问题3:调试器连不上板子
    先检查驱动。Windows下需要安装Xilinx的USB驱动,否则调试器识别不到。
⚠️ 避坑指南:我曾经在Windows 10上装Vitis 2020.2,结果死活连不上Zynq开发板。查了半天,发现是Windows的驱动签名问题。解决办法是:在启动时按F8进入「禁用驱动程序强制签名」模式,然后再安装驱动。这个问题坑了我整整一个下午。

4.5 核心知识体系

为了让你更直观地理解Vitis在整个Zynq开发流程中的位置,我画了一张图:

Vivado 硬件设计 RTL开发/综合/布局布线 导出.xsa Vitis 软件开发 C/C++/Linux驱动/调试 生成.elf/.bit Zynq开发板 运行/验证 软硬件协同 Vitis与Vivado的协作关系 Vivado负责硬件,Vitis负责软件,两者通过.xsa文件对接 ⚠️ 版本必须严格匹配 Vivado 2020.1 → Vitis 2020.1 混用版本会导致编译错误或运行时异常

说白了,Vivado和Vitis就是Zynq开发的两条腿。硬件设计在Vivado里完成,导出硬件描述文件(.xsa),然后Vitis读取这个文件,在上面做软件开发。两者缺一不可。

好了,Vitis的安装就讲到这里。装好之后,下一件事就是创建一个Hello World工程,跑通整个开发流程。不过那是后面章节的内容了,咱们先把基础打牢。

📌 本章要点回顾:
  • Vitis和Vivado版本必须严格匹配
  • 安装时记得勾选Vitis组件
  • 安装后用命令行验证环境是否正常
  • 遇到问题先检查版本和路径

可可精品资料库