1. 环境准备Ubuntu 22.04基础配置在开始安装Vitis/Vivado 2022.2之前我们需要确保Ubuntu 22.04系统已经做好充分准备。我遇到过不少因为基础环境没配好导致安装失败的案例这里把关键要点都列出来。首先检查磁盘空间这是最容易踩坑的地方。Vitis/Vivado全组件安装需要至少256GB空间建议提前用df -h命令查看挂载点容量。如果空间不足可以考虑挂载新硬盘或者清理旧文件。我习惯在/home下新建专门目录存放开发工具比如mkdir ~/Xilinx接着更新系统软件源这个步骤看似简单但很重要。有些依赖库需要最新版本才能正常工作sudo apt update sudo apt upgrade -y安装基础编译工具链这些是后续安装的基石sudo apt install build-essential git cmake -y特别注意要安装32位兼容库很多EDA工具依赖这个sudo apt install lib32z1 lib32ncurses5 -y2. 依赖库安装避坑关键步骤依赖库问题是最常见的安装失败原因。根据我的实测经验2022.2版本需要特别注意以下几个库首先是图形界面相关依赖缺少这些会导致安装程序无法启动sudo apt install libxrender1 libxtst6 libxi6 -y然后是关键的ncurses库这个直接影响安装程序能否正常完成sudo apt install libncurses5 libtinfo5 libncurses5-dev libncursesw5-dev ncurses-compat-libs -y我遇到过安装卡在generating installed device list的情况就是这些库没装全。如果安装后仍然卡住可以尝试手动指定库路径export LD_LIBRARY_PATH/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH3. 安装包获取与安装现在来到核心环节。首先从官网下载安装包注意要选择Vivado ML 2022.2: All OS installer Single-File Download版本。下载完成后给安装文件添加执行权限chmod x Xilinx_Unified_2022.2_1014_8888_Lin64.bin启动安装程序时建议使用sudo但要注意后续权限问题sudo ./Xilinx_Unified_2022.2_1014_8888_Lin64.bin安装界面会出现几个关键选项选择Vitis包含Vivado和HLS设备支持建议全选特别是Zynq-7000和UltraScale安装路径就用之前创建的~/Xilinx安装过程可能持续数小时建议在稳定的网络环境下进行。如果中断了也不用担心安装程序支持断点续传。4. 环境配置与优化安装完成后需要配置环境变量。编辑.bashrc文件gedit ~/.bashrc添加以下内容根据实际安装路径调整source ~/Xilinx/Vitis/2022.2/settings64.sh source ~/Xilinx/Vivado/2022.2/settings64.sh export PATH$PATH:~/Xilinx/Vitis/2022.2/binUSB驱动安装也很重要否则无法连接开发板cd ~/Xilinx/Vivado/2022.2/data/xicom/cable_drivers/lin64/install_script sudo ./install_drivers权限问题经常导致各种奇怪错误建议统一设置sudo chmod -R 777 ~/Xilinx5. License配置技巧License配置是个技术活。首先获取合法的license文件将其放在固定位置比如~/Xilinx/license.lic。然后在Vivado中点击Help - Manage License选择Load License指定license文件路径验证是否成功可以在License Manager中查看状态。如果遇到问题可以尝试重启License服务器cd ~/Xilinx/Vivado/2022.2/bin ./lmutil lmdiag6. 常见问题排查安装过程中可能会遇到各种问题这里分享几个典型案例问题1安装程序无法启动解决方案检查依赖库是否安装完整特别是libncurses系列问题2图形界面显示异常解决方案设置正确的DISPLAY变量export DISPLAY:0问题3USB设备无法识别解决方案检查用户组权限sudo usermod -aG dialout $USER7. 一键卸载方案当需要卸载时可以使用官方卸载脚本cd ~/Xilinx/.xinstall/Vivado_2022.2 sudo ./xsetup -b Uninstall如果想彻底清理还需要删除配置文件和缓存rm -rf ~/.Xilinx rm -rf ~/.cache/Xilinx8. FINN框架集成最后配置FINN专用环境变量export FINN_XILINX_PATH~/Xilinx export FINN_XILINX_VERSION2022.2 export PYNQ_BOARDPynq-Z2验证环境是否正常工作vivado -version vitis -version如果一切正常现在你就可以开始FINN框架的开发工作了。我在多个项目中使用这个配置方案稳定性很有保障。遇到任何问题都可以查看Xilinx官方论坛大部分问题都有现成解决方案。
FINN实战指南：Ubuntu 22.04下Vitis/Vivado 2022.2一站式部署与避坑
发布时间：2026/5/29 1:47:39
1. 环境准备Ubuntu 22.04基础配置在开始安装Vitis/Vivado 2022.2之前我们需要确保Ubuntu 22.04系统已经做好充分准备。我遇到过不少因为基础环境没配好导致安装失败的案例这里把关键要点都列出来。首先检查磁盘空间这是最容易踩坑的地方。Vitis/Vivado全组件安装需要至少256GB空间建议提前用df -h命令查看挂载点容量。如果空间不足可以考虑挂载新硬盘或者清理旧文件。我习惯在/home下新建专门目录存放开发工具比如mkdir ~/Xilinx接着更新系统软件源这个步骤看似简单但很重要。有些依赖库需要最新版本才能正常工作sudo apt update sudo apt upgrade -y安装基础编译工具链这些是后续安装的基石sudo apt install build-essential git cmake -y特别注意要安装32位兼容库很多EDA工具依赖这个sudo apt install lib32z1 lib32ncurses5 -y2. 依赖库安装避坑关键步骤依赖库问题是最常见的安装失败原因。根据我的实测经验2022.2版本需要特别注意以下几个库首先是图形界面相关依赖缺少这些会导致安装程序无法启动sudo apt install libxrender1 libxtst6 libxi6 -y然后是关键的ncurses库这个直接影响安装程序能否正常完成sudo apt install libncurses5 libtinfo5 libncurses5-dev libncursesw5-dev ncurses-compat-libs -y我遇到过安装卡在generating installed device list的情况就是这些库没装全。如果安装后仍然卡住可以尝试手动指定库路径export LD_LIBRARY_PATH/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH3. 安装包获取与安装现在来到核心环节。首先从官网下载安装包注意要选择Vivado ML 2022.2: All OS installer Single-File Download版本。下载完成后给安装文件添加执行权限chmod x Xilinx_Unified_2022.2_1014_8888_Lin64.bin启动安装程序时建议使用sudo但要注意后续权限问题sudo ./Xilinx_Unified_2022.2_1014_8888_Lin64.bin安装界面会出现几个关键选项选择Vitis包含Vivado和HLS设备支持建议全选特别是Zynq-7000和UltraScale安装路径就用之前创建的~/Xilinx安装过程可能持续数小时建议在稳定的网络环境下进行。如果中断了也不用担心安装程序支持断点续传。4. 环境配置与优化安装完成后需要配置环境变量。编辑.bashrc文件gedit ~/.bashrc添加以下内容根据实际安装路径调整source ~/Xilinx/Vitis/2022.2/settings64.sh source ~/Xilinx/Vivado/2022.2/settings64.sh export PATH$PATH:~/Xilinx/Vitis/2022.2/binUSB驱动安装也很重要否则无法连接开发板cd ~/Xilinx/Vivado/2022.2/data/xicom/cable_drivers/lin64/install_script sudo ./install_drivers权限问题经常导致各种奇怪错误建议统一设置sudo chmod -R 777 ~/Xilinx5. License配置技巧License配置是个技术活。首先获取合法的license文件将其放在固定位置比如~/Xilinx/license.lic。然后在Vivado中点击Help - Manage License选择Load License指定license文件路径验证是否成功可以在License Manager中查看状态。如果遇到问题可以尝试重启License服务器cd ~/Xilinx/Vivado/2022.2/bin ./lmutil lmdiag6. 常见问题排查安装过程中可能会遇到各种问题这里分享几个典型案例问题1安装程序无法启动解决方案检查依赖库是否安装完整特别是libncurses系列问题2图形界面显示异常解决方案设置正确的DISPLAY变量export DISPLAY:0问题3USB设备无法识别解决方案检查用户组权限sudo usermod -aG dialout $USER7. 一键卸载方案当需要卸载时可以使用官方卸载脚本cd ~/Xilinx/.xinstall/Vivado_2022.2 sudo ./xsetup -b Uninstall如果想彻底清理还需要删除配置文件和缓存rm -rf ~/.Xilinx rm -rf ~/.cache/Xilinx8. FINN框架集成最后配置FINN专用环境变量export FINN_XILINX_PATH~/Xilinx export FINN_XILINX_VERSION2022.2 export PYNQ_BOARDPynq-Z2验证环境是否正常工作vivado -version vitis -version如果一切正常现在你就可以开始FINN框架的开发工作了。我在多个项目中使用这个配置方案稳定性很有保障。遇到任何问题都可以查看Xilinx官方论坛大部分问题都有现成解决方案。
