做FPGA开发的基本绕不开Xilinx现在叫AMD家的Vivado而2019.2这个版本我从项目立项一直用到量产维护前后折腾了三年多一直没有换过。原因很简单在Artix-7、Kintex-7这类主流器件的综合实现上它的稳定性和资源利用率表现都很稳定网上教程、IP核资料、甚至不少高校的FPGA实验教材也都是基于这个版本写的。这篇博文就是要把Vivado2019.2的完整安装过程掰开揉碎讲清楚从安装包获取、版本选择、系统准备到每一步的界面选项、许可证配置再到装完之后如何验证环境能不能正常干活全程对应我踩过的坑和总结出来的套路适合刚从ISE或者Quartus转过来的朋友也适合实验室里要给新电脑搭环境的同学参考。1. 版本选择与安装前的准备工作1.1 为什么坚持用2019.2而不是新版很多新手上来就问官网现在都出到Vivado 2023、2024了为什么还要装2019.2这种老版本我个人的观点是FPGA工具链不是越新越好关键在于你的目标器件和参考资料能不能对得上。2019.2是Xilinx在2019年底发布的稳定版本完整支持到Artix-7、Kintex-7、Virtex-7、Zynq-7000这一代7系列器件同时对UltraScale和Versal ACAP提供了基础支持。很多开发板厂商比如正点原子、黑金、米联客的中低端板卡配套例程就是基于2019.2或2018.3写的工程文件直接打开就能跑。如果你装的是2023.1老工程的IP核需要挨个升级有时连约束文件的格式都会有细微差异新手遇到这些报错会非常崩溃。还有一个非常现实的因素2019.2的资源占用和安装复杂度相对亲民。完整版安装后占用约130GB磁盘空间而新版本动辄超过150GB对普通笔记本电脑压力很大。如果只是学习7系列器件2019.2搭配WebPACK免费许可证完全够用不需要任何破解或特殊处理。1.2 硬件配置与系统环境要求官方给出的2019.2最低配置是8GB内存、50GB可用磁盘但我要说句实在话这只是能装能开的底线不是能干活的配置。综合实现大型工程时Vivado是典型的内存杀手尤其是布局布线那一步动不动就把内存吃满。我建议的参考配置如下配置项起步要求推荐要求备注操作系统Windows 10 64位Windows 10/11 64位Ubuntu 18.04/16.04也可但不建议新手用LinuxCPU4核6核以上综合过程吃单核性能内存8GB16GB以上8GB跑大工程必卡磁盘60GB剩余200GB剩余安装包约55GB解压后约130GB分辨率1280x10241920x1080低分辨率下界面控件会错位还要特别注意一点安装路径和工程路径绝对不能有中文和空格。Vivado对路径的编码处理一直不太友好中文路径会导致综合时莫名报错。我在实验室遇到过好几次学生把工程放在D:\课程设计\FPGA工程里面结果每次跑综合都在某个IP核生成阶段失败最后改成纯英文路径就好了。1.3 安装前必做的三件事在双击安装包之前我强烈建议先把下面三件事做了能省掉后面90%的麻烦。第一关闭杀毒软件和Windows Defender的实时防护。Vivado安装程序会向系统目录写入大量驱动程序和相关服务杀毒软件经常误报轻则安装中断重则出现缺少dll文件的玄学问题。不是让你永久关闭而是安装期间临时关掉装完再打开。第二确认磁盘分区格式是NTFS并且剩余空间足够。如果某个分区分成了FAT32超过4GB的文件就写不进去而Vivado安装包解压后的文件有好几个都超过这个大小安装进度会卡在那里直接失败。查看方式很简单右键磁盘盘符选择属性文件系统一栏会明确显示。第三确保Windows用户名为英文。有些同学买回来的电脑直接用了中文用户名比如C:\Users\张三这会带来一个比较隐蔽的问题Vivado生成的临时文件和许可证文件都与用户名相关中文用户名可能导致lmutil无法正常读取本机hostid。解决方法是新建一个英文管理员账户来装和用不要嫌麻烦。2. 安装包获取与下载校验2.1 官方渠道下载与安装包组成Vivado 2019.2的安装包可以从Xilinx官方网站下载前提是注册一个免费账号。进入官网后在Download Center里选Vivado版本列表中找到2019.2然后根据需要选择WebPACK版的单文件下载或者完整版的Multi-OS下载。这里解释一下安装包的区别。Vivado 2019.2提供了两种获取方式在线安装器一个约400MB的Web Installer程序。运行后它会在线拉取所有组件好处是不用一次性下载几十GB坏处是极度依赖网络中途断线就要重新续传实测在校园网环境下容易半途失败。完整离线安装包按操作系统分文件下载Linux版本有个约50GB的tar.gz文件Windows版本分了几个部分。推荐使用这种方式下载一次可以反复安装重装系统后随时拿出来用。在Windows下完整离线安装包下载后通常是一个名为Xilinx_Vivado_SDK_2019.2_1106_2127_Win64.exe的单文件体积约50GB实际大小可能因下载源有所不同。这个文件是自解压格式双击后会先解压到指定目录然后自动启动安装向导不用自己额外准备解压工具。2.2 下载后的SHA256校验大文件下载最容易翻车的就是下载不完整但表面看起来正常。安装过程突然报错、解压CRC校验失败很大概率就是文件损坏。我的习惯是下载完先用Hash工具比如HashMyFiles、QuickHash做一次SHA256校验和官网上发布的校验值比对。官方提供的校验值格式类似于$ sha256sum Xilinx_Vivado_SDK_2019.2_1106_2127_Win64.exe 2f5c3e0f9d7a1b6c8e0d... # 此处仅示意具体值以官网公布为准Windows自带的命令提示符PowerShell也能算Get-FileHash .\Xilinx_Vivado_SDK_2019.2_1106_2127_Win64.exe -Algorithm SHA256如果算出来的值和官网对不上别犹豫重新下载。我曾经为了省时间跳过这一步结果解压到80%弹出一个compress2.c相关的CRC错误排查了两个小时才发现是安装包第37GB处的数据损坏只能重下白白浪费一个通宵。2.3 解压与目录建议双击exe后程序会先提示选择解压目标位置。这里注意解压目录只是临时存放安装源文件不是最终的Vivado安装目录。装完确认没问题后这个解压文件夹可以删掉释放空间。我建议解压路径放在空间最大的机械盘或固态盘上例如D:\Xilinx_InstallPkg。解压过程大约需要10到30分钟取决于磁盘性能。期间最好不要运行大型软件否则磁盘I/O竞争会导致解压时间翻倍。还有一个容易被忽略的点解压目录不要放在桌面上。桌面路径往往带有用户目录如果Windows用户名是中文解压过程虽然多半能完成但后续安装向导读取某些文件时可能报路径无效。直接放在盘符根目录下的英文路径最省心。3. Windows下完整安装实操3.1 启动安装向导两个关键入口解压完成后安装向导会自动弹出如果没有自动弹出就去解压目录下双击xsetup.exe。启动后首先出现的是版本信息界面这里不要急着点Next先看右下角的版本号确认是2019.2而不是其他版本。接下来是第一个关键选择Vivado HL WebPACK和Vivado HL Design Edition。这两者的区别主要在支持的器件范围上。项目WebPACKDesign Edition支持器件Artix-7、Zynq-7000部分、Spartan-7全部7系列、UltraScale、UltraScale许可证类型免费付费或评估License适用人群学习、中小规模设计工业生产、大规模设计如果你只是学习或做课程设计老老实实选WebPACK完全免费也支持调用Vivado里大部分IP核。如果你要使用Kintex-7或者Virtex-7才需要选择Design Edition但即使选择了它没有付费许可证的情况下综合时仍会提示未授权后续还需要单独配置评估License。3.2 自定义组件选择策略进入组件选择界面后默认会勾选Vivado HL Design Edition的所有组件包括Vivado、SDK、DocNav、Vitis和一大堆附属工具。这里我的建议是按需勾选不要全装。对于绝大多数用户只需要保留以下几项Vivado HL WebPACK即主设计工具必需Vivado HL 2019.2主程序本体跟上一项联动Vivado HL WebPACK - 7 Series及相关器件支持勾上你用的器件系列SDK如果你想做Zynq软硬件协同的人机交互开发SDK不可少像DocNav文档导航工具和Vitis类组件如果不做Zynq相关开发完全用不上。特别是DocNav它其实是一堆离线文档的索引服务体积不小还自带一个Java运行环境装了之后开机自启项又多一个后期卸载还容易残留服务。我在第一次装的时候全选了用了两个月后实在受不了最后只能重装系统才彻底清理干净。组件选择直接影响安装时长。全选的情况下4核心老电脑实测安装耗时约3小时只勾选WebPACK加特定器件系列可以把时间压缩到40分钟左右。3.3 器件支持与安装目录设置到了器件选择这一步界面会列出所有支持的FPGA系列默认全部勾选。不要全选全选意味着下载并安装所有系列的器件数据白白占用几十GB空间。但在做这一步之前先想清楚你用哪家的板子常见的选择有正点原子/黑金/达龙等国产开发板常见型号Artix-7系列勾选Artix-7Zynq-7000系列SoC开发板勾选Zynq-7000Kintex-7高性能板卡勾选Kintex-7如果暂时不确定最稳妥的方案是勾选7 Series下的全部子项反正7系列的器件数据总量不算特别大。安装目录设置建议选D:\Xilinx\Vivado避开C盘系统分区也避开默认的C:\Xilinx。原因有两点一是Vivado生成的工程缓存和编译中间文件很大长期使用会占用几十GB空间放C盘容易包二是重装系统时C盘被格式化Vivado本体如果装在D盘系统重装后还能保留配合环境变量重新指定就能继续用不过不到万不得已不建议这么做还是建议正常卸载重装。3.4 安装过程与日志查看确认所有设置后点击Install按钮会弹出安装摘要仔细核对一遍器件和组件然后开始安装。接下来就是漫长的进度条阶段屏幕上会滚动显示当前安装的文件。这里分享一个比较实用的技巧Vivado安装过程中会在日志目录通常在C:\Users\%USERNAME%\.Xilinx\Vivado\2019.2\install.log实时写入安装进度。如果进度条卡住不动不要立刻关掉安装程序先去翻一下日志最后几行判断是正在解压大文件、正在安装驱动还是真报错了。常见的情况是卡在Installing USB Cable Drivers这一步比较久因为驱动安装需要调用Windows Driver Framework此时日志停在某个动态库注册的动作上看起来像死机实际还在运行。耐心等10到20分钟是正常现象。安装完成后会弹出提示要求重启电脑建议先重启再继续后续的许可证配置。不要跳过重启因为Vivado安装的USB-JTAG驱动必须等重启后才能正常加载不重启直接打开软件可能识别不到下载器。4. 常见问题与排查技巧实录4.1 安装中途退出或闪退这是提问频率最高的问题现象是在某个进度百分比处安装程序直接退出没有任何错误提示。我遇到的多数情况是解压后文件损坏或者磁盘空间不足导致的。排查流程如下先确认磁盘剩余空间是否足够完整安装至少预留120GB只装WebPACK也要40GB以上检查磁盘是不是NTFS如果还在用FAT32会前功尽弃确认杀毒软件已经退出Windows Defender实时保护也已经关闭重新运行xsetup.exe此时不要急着安装先选解压目录看有没有CRC校验报错如果CRC校验在同一个位置反复报错基本可以断定安装源文件损坏回到第2.2节重新下载。这种做法虽然效率低但至少避免闷头重试浪费时间。4.2 license管理问题安装完第一次启动Vivado大概率会弹出一个License Manager窗口提示找不到有效许可证。这时不要慌也不用去搜什么破解工具直接走官方免费路径即可。在License Manager界面中选择Get Free ISE WebPACK / Vivado ML WebPACK License浏览器会自动打开Xilinx官网的许可证申请页面。登录账号后在License Site中申请一个免费的标准节点锁定许可证Node-Locked License填上当前电脑的MAC地址即可。这个MAC地址在License Manager的Host ID一栏可以看到直接复制粘贴不要手动敲因为冒号和字母大小写必须精确匹配。申请成功后官网会发送一个.lic文件到邮箱下载后回到License Manager界面选择Load License加载这个文件。加载成功后在View License Status里能看到一个Vivado WebPACK的Feature有效期一般是12个月到期后重新申请就行。这里有个坑有些朋友的电脑有多个网卡比如板载有线网卡加无线网卡或者装了VMware虚拟网卡Host ID会列出多个MAC地址。申请License时一定要选那个物理网卡的MAC并且尽量保持安装前使用同一网卡。如果你用的是无线网卡更新的网卡驱动后MAC地址变了之前申请的License可能会失效需要重新申请。我建议有条件的直接用有线网卡省心。4.3 启动报错与路径问题装完重启后双击桌面Vivado图标可能会遇到两类常见报错。第一类是ERROR: (core) Unable to find the following files: framework.config这类路径异常报错。多数原因是安装路径包含中文字符或空格。解决方法很直接卸载后重新安装到纯英文路径不能只改快捷方式属性因为Vivado内部大量脚本已经把路径写死了。第二类是启动时提示could not open Java或Java虚拟机相关错误。Vivado自带了JREJava运行环境但系统如果装了Java 8以后的版本环境变量JAVA_HOME可能会干扰Vivado自带的JRE读取。临时解决办法是删除或暂时改掉系统环境变量中的JAVA_HOME或者打开Vivado安装目录下的settings64.bat在里面优先设置JAVA_HOME指向Vivado的\tps\win64\jre*目录。具体来说在settings64.bat开头加一行set JAVA_HOMEC:\Xilinx\Vivado\2019.2\tps\win64\jre11.0.2_8 set PATH%JAVA_HOME%\bin;%PATH%保存后重新启动Vivado一般就能解决。4.4 安装进度条卡死的真相很多人遇到进度条长时间不动就强制关机其实大部分卡顿都是正常现象。Vivado安装时会执行几个特别耗时的操作解压并注册ChipScope的虚拟仪器驱动安装USB-JTAG电缆驱动生成大量器件数据库的符号链接其中USB-JTAG驱动安装耗时最长日志里会出现Installing driver...的字样这个过程没有任何进度反馈最多可能等15分钟以上。区分死锁和正常的办法是打开任务管理器看CPU和磁盘占用率。如果磁盘还有读写活动、CPU还有波动就说明还在工作如果所有核心都静默且磁盘没有任何活动超过10分钟才考虑终止安装进程。5. 安装完成后的环境验证与常用配置5.1 初始化工程快速验证装完环境后不要急着去学语法先花10分钟验证整个工具链是否真的可以正常跑通一个工程。这里分享一个最小验证方案。打开Vivado选择Create ProjectNext到工程名称界面时命名为hello_world_test位置选D:\FPGA_Projects之后一路Next到器件选择页面。如果刚才安装时只勾选了Artix-7这里就找一个Artix-7芯片比如xc7a35tcsg324-1如果不知道芯片具体型号可以直接搜xc7a35t然后在下拉列表里选。这一步能验证器件数据库是否完整安装。工程创建后在Sources面板右键选择Add Sources添加一个Verilog文件输入最简单的代码module top( input wire clk, output wire led ); reg [24:0] counter 0; always (posedge clk) begin counter counter 1; end assign led counter[24]; endmodule然后在左侧Flow Navigator里点Run Synthesis等待综合完成。如果一切顺利会弹出Synthesis Completed的提示。接着点Run Implementation再点Generate Bitstream。全套流程能跑通就说明Vivado的核心工具链没有问题。这一步非常关键。有些安装问题要到综合或实现阶段才会暴露出来比如IP核缓存路径异常、编译脚本缺文件等。跑通一个最小工程等于给整个环境做了全面体检。5.2 开发板连接与烧录验证如果你手头有开发板完成上面的流程后还可以做一次硬件验证。把开发板通过USB-JTAG线连到电脑Vivado会自动识别并安装驱动。如果设备管理器里显示一个带黄色感叹号的设备说明驱动没装好可以去C:/Xilinx/Vivado/2019.2/data/xicom/cable_drivers/nt64目录下右键安装驱动或者重新运行一遍安装程序里的install_drivers.bat。驱动正常后在Vivado里点击Open Hardware Manager打开目标连接添加板卡对应的Digilent/USB端口点击Program Device选择刚才生成的bit文件就能下载。能正常下载点灯整个Vivado2019.2的环境就算是真正可用的状态了。5.3 安装目录瘦身与后续配置建议安装完成后如果没有SDK开发需求可以手动删除一些无用目录来释放空间。以我的安装路径为例C:\Xilinx\Vivado\2019.2\data\ipIP核库保留删了后面用IP时麻烦C:\Xilinx\Vivado\2019.2\data\secureip加密IP核保留C:\Xilinx\Vivado\2019.2\doc离线文档装了DocNav的话这里的内容其实是冗余的可以删省下几个GB不建议手动删除其他目录尤其是tps目录里面是Vivado依赖的Python、Java和Tcl解释器删了软件直接起不来。最后再提供一个后续会帮到你的配置打开Vivado的Settings - General - Number of jobs默认是2个并行任务如果你的CPU是6核以上调到4到8个综合、实现速度会有肉眼可见的提升。这个参数不调白不调属于免费的性能收益。我在实际使用中最深的一个体会是安装Vivado这类大型EDA工具时最怕的不是步骤多而是遇到问题后病急乱投医。安装日志里往往早就写明了出错原因其实静下心来读一遍大部分问题都能自己解决。装完之后系统里会多个Xilinx的USB驱动服务和JRE相关的后台任务不用担心这些都是正常组件。给电脑做一次系统还原点快照之后如果再装其他IDE或者更新显卡驱动出现冲突也能快速回退到干净状态。