Vivado 2018.3 安装与 License 获取完整指南:FPGA 开发环境配置详解
Vivado 2018.3 这个版本说实话我在 FPGA 开发这条路上来回折腾过太多次。帮同事装环境、给自己换电脑、给实验室新机器配工具链前前后后至少安装了七八遍。很多人觉得 Xilinx现在叫 AMD都出到 2024、2025 了为什么还要装老版本但现实就是大量的大学课程、开发板厂商黑金、正点原子、米联客的技术文档和例程仍然是以 Vivado 2018.3 为基准的新版工具链动不动就要占用 100GB 以上磁盘空间还会遇到 IP 版本升级、工程迁移等一堆衍生问题。所以 2018.3 至今仍是很多 FPGA 学习者和工程师的首选版本。这篇博文我就把自己这些年安装配置 Vivado 2018.3 和获取 license 的完整流程、踩过的坑、还有那些官网文档里没写明白的细节全部整理出来想安装这个版本的朋友直接照着操作就行。1. 安装前的准备版本选择与环境检查1.1 为什么 2018.3 仍然值得安装先说说版本选择这件事。Vivado 从 2017 到 2024 每个大版本都在变但 2018.3 算是口碑比较稳定的一代。原因有几个第一SDK 集成做得比较成熟。2018.3 自带 Xilinx SDK基于 Eclipse 环境Zynq 嵌入式开发可以直接在一个界面里完成硬件工程和软件工程的协同调试不需要像新版那样单独安装 Vitis而且 Vitis 对老工程的支持并不友好。第二IP 兼容性好。很多第三方 IP 核特别是国产开发板厂商提供的摄像头、HDMI、千兆以太网等 IP都是基于 2018.3 封装的拿到就能直接用。新版 Vivado 打开这些工程时IP 需要重新生成部分老 IP 甚至无法升级。第三系统资源消耗可接受。2018.3 安装完整版大约需要 50GB 左右磁盘空间运行内存 8GB 就能比较流畅地跑小型工程。而新版本动辄需要 100GB 以上16GB 内存跑起来都有点吃力。当然2018.3 也有缺点比如对 Windows 11 的兼容性一般部分新出的 FPGA 芯片如 Versal、UltraScale 的部分型号不支持。但如果你主要是做 Artix-7、Kintex-7、Zynq-7000 的开发用 2018.3 完全没问题。1.2 硬件配置与操作系统要求安装之前先对照一下自己电脑的配置。Vivado 是一个比较吃资源的工具配置不够硬装上去后面综合、布局布线的时候会非常痛苦。内存是最关键的。官方最低要求是 8GB但我实际用下来的体验是8GB 只适合跑非常小的工程稍微大一点的工程在综合时就会卡到怀疑人生。建议至少 16GB有条件上 32GB 更好。我这里所说的“大工程”指的是包含 MicroBlaze 软核、多个 IP 和较大逻辑规模的设计这类工程在综合时内存占用可以轻松超过 8GB。CPU 要求不算苛刻主流的 4 核以上处理器就可以。Vivado 的多线程能力在综合阶段利用得不错核心数越多综合速度越快。用 AMD 的 Ryzen 或 Intel 的酷睿都可以没有特别偏向。磁盘空间要注意这里有一个容易忽略的坑很多人只看安装包大小大约 20GB 的离线安装包就以为安装只要 20GB。实际上安装后的 Vivado 2018.3 完整版会占用大约 50GB 空间。建议给 C 盘预留至少 60GB如果你要装到 D 盘或 E 盘也要预留 60GB 以上。安装路径千万不要有中文或空格这个在后面的章节里我会详细说为什么。操作系统方面2018.3 官方支持 Windows 7 SP1、Windows 10 1809 版本以及 64 位的 Linux如 Ubuntu 16.04、CentOS 7。Windows 11 上我也装过能跑但偶尔会有一些小毛病比如 JTAG 驱动在 Windows 11 下需要手动指定路径更新。1.3 版本类型WebPACK / Design / System 怎么选Vivado 2018.3 安装时会让你选择版本类型主要有三种WebPACK Edition这是免费的但支持的 FPGA 器件型号有限制。常见的 Artix-7如 xc7a35t、xc7a100t、Spartan-7、Zynq-7000 的部分型号如 xc7z010、xc7z020都能用。对于学习、做课程设计、跑开发板例程来说WebPACK 完全够用。Design Edition付费版解锁全部器件包括 Kintex-7、Virtex-7 等高端系列还支持 System Generator for DSP 等功能。System Edition在 Design Edition 基础上增加了一些嵌入式相关的功能主要是兼容旧版 ISE 项目的一些辅助工具。初次接触的朋友直接选 WebPACK 就可以了。很多人在不知道的情况下装成了 Design Edition 或 System Edition 的试用版结果只能使用 30 天到期之后还得卸载重装太折腾了。WebPACK 版本虽然是免费的但不要小看它Zynq 系列里的常用型号都被覆盖了做图像处理、数字逻辑、SoC 嵌入式开发都没问题。2. 下载 Vivado 2018.3 安装包官方渠道与校验方法2.1 官网下载方式与账号注册Vivado 2018.3 的安装包必须从 Xilinx 的官方网站下载没有别的正当渠道。虽然网上能找到各种转载的网盘链接但我强烈建议你自己去官网下载一方面能保证文件完整性另一方面也避免下载到被篡改过的安装包。官网下载流程是这样的首先打开 Xilinx 官网点击右上角的账户图标注册一个账号。注册时需要填邮箱、姓名、密码等信息必填项不多几分钟就能搞定。注册完成并登录后在官网搜索 Vivado 2018.3 的下载页面。AMD 把老版本的工具链做了一些归档找起来可能要费点耐心。重点来了下载页里通常会有两个选择一个是 Web Installer在线安装器另一个是 All OS Installation离线完整安装包。我个人强烈建议下载离线完整安装包。原因很简单Web Installer 只是个几百兆的引导程序安装时会边装边下载如果你的网络不稳定或者中途断了整个安装就失败还得重新下载非常折磨人。离线完整安装包一次下载到位安装时不需要联网速度反而更快。离线安装包的大小我记得 2018.3 的 Windows 版本大概在 20GB 左右以 .tar.gz 格式提供。其实这个文件本身就是解压版的下载完成后可以直接解压运行里面的 xsetup.exe。2.2 安装包完整性校验与杀毒软件处理下载完一个 20GB 的文件谁都不希望解压的时候才发现文件损坏。官网下载页一般会提供 MD5 校验码下载完以后用哈希工具算一下比对一致再解压安装。这一步看起来很麻烦但实际上非常重要尤其是从网盘转载链接下载的情况文件被损坏的概率不低。解压的时候还有两个细节第一解压路径不要太深最好直接解压到某个盘符的根目录比如 D:\Vivado_installer。路径中不要有中文因为安装程序在解析路径时对 Unicode 支持不好容易出现莫名其妙的错误。第二关闭杀毒软件再解压。Vivado 安装包里有大量的动态链接库DLL和驱动文件部分杀毒软件会把其中一些文件误报为病毒然后直接隔离导致安装过程中报错说找不到文件或者安装完成后程序无法正常启动。Windows Defender 也一样最好在解压和安装期间暂时关闭实时防护。安装完成后再重新打开。3. Vivado 2018.3 安装流程逐步讲解3.1 安装选项与组件选择解压完成后以管理员身份运行 xsetup.exe。这里强调“管理员身份”是有原因的Vivado 在安装过程中要注册服务、安装驱动、写入注册表没有管理员权限会直接安装失败或者出现非常奇怪的权限错误。安装程序启动后的流程大致是第一步选择版本类型。如果你确定用 WebPACK就直接选择 WebPACK Edition。这一步也允许你勾选依次安装多个版本但没必要一次装一个就好。第二步选择要安装的组件。Vivado 2018.3 的安装包分了几个组件块Vivado Design Suite HLx Edition这是核心工具必选。其中又分了很多子项包括综合、实现、仿真等这些都没有单独选择的必要直接全选。SDK嵌入式开发工具如果你的板子是 Zynq 系列一定要装。选 SDK 时会要求额外安装一些依赖包括 DocNav 等建议一并安装。DocNav文档浏览器提供器件手册、用户指南的本地文档。非必需但装上也费不了太多空间方便查阅。第三步选择要安装的目标器件系列。所有器件系列默认全选如果你不想全部安装可以手动取消一部分以节省磁盘空间。很多人的实际需求是 Artix-7 和 Zynq-7000那就取消 Kintex、Virtex 等不常用的系列。不过我的建议是初次安装还是全选比较好因为后续你可能会用到其他系列的器件全选省心而且这些器件库加起来的空间占用其实没想象中那么大。我自己第一次安装时就只选了 Artix-7后来项目改成 Zynq 系列还要重新安装非常麻烦。3.2 安装目录、耗时与磁盘占用的预期管理安装目录这里要认真对待。Vivado 2018.3 默认安装路径是 C:\Xilinx\Vivado\2018.3SDK 默认是 C:\Xilinx\SDK\2018.3。我遇到过很多人自作聪明地把安装路径改成“E:\FPGA 工具\Vivado”这样的自定义路径然后各种编译错误、路径解析问题层出不穷。虽然 Vivado 没有硬性规定路径不能改但从实际经验看保留默认路径是最稳的选择。如果 C 盘空间不够可以用“C:\Xilinx”之外的纯英文盘符路径但绝对不要加空格和中文。安装耗时主要看机器性能。我自己的经验数据是这样的使用 NVMe 固态硬盘8 核 CPU完整安装大概需要 30-45 分钟机械硬盘或 SATA 固态可能要 1.5 到 2 小时。安装过程看起来像卡住了其实是在解压和复制文件耐心等待就好。安装日志会打印在终端里有一个进度条会显示当前安装到哪些组件。安装完成后程序会默认启动 License Manager这个界面先不用管直接关掉license 的配置我们后面单独说。还有一个细节要注意安装过程中如果有“Install Cable Drivers”之类的选项一定要勾选这是后面连接 FPGA 开发板的 JTAG 调试所需的驱动。3.3 驱动安装Cable 驱动与 WinPcap 的坑Vivado 2018.3 安装过程中最常出问题的就是驱动部分主要涉及两个东西USB-JTAG 线缆驱动和 WinPcap。USB-JTAG 驱动也就是 Xilinx Cable Driver用来支持开发板通过 USB 下载和调试。安装时如果勾选了一般能正常装上。但有一个典型问题在 Windows 7 或 Windows 10 上插入开发板后设备管理器里会显示一个带黄色感叹号的未知设备这种情况一般是驱动签名问题导致的。解决办法是手动更新驱动右键这个未知设备选择“更新驱动程序”然后“浏览我的电脑以查找驱动程序”路径指向 Vivado 2018.3 安装目录下的 data\xicom\cable_drivers\nt64\ 文件夹。Windows 会提示驱动未签名选择“仍然安装”再等几秒钟设备就变成“Xilinx USB Cable”了。WinPcap 的问题也经常出现。Vivado 使用 WinPcap 来做网络相关的调试功能。安装时如果 WinPcap 装不上会弹出一个错误提示但 Vivado 主体还是会继续安装很多年轻人因此没有在意。之后在使用一些功能比如远程调试、网络文件系统时会发现报错。解决办法是单独去 WinPcap 官网下载安装对应版本装完之后再重新运行 Vivado 的驱动安装程序或者直接忽略——如果只是用来做常规的 FPGA 开发板下载和调试用不到 WinPcap 的功能。4. License 获取与配置完整攻略4.1 认识 Vivado 的 License 体系先理清楚 license 的概念后面才不会被各种报错绕晕。Vivado 的 license 本质上是一个.lic后缀的文本文件里面记录了授权用的绑定信息和功能特性列表。Vivado 读取这个文件后才能正常使用各个功能模块。主要有四类 license第一类是 WebPACK 免费 license。前面说过WebPACK 是免费版本对应的 license 也需要自己申请。这个 license 绑定你电脑的 MAC 地址网卡物理地址生成一个 .lic 文件在 Vivado 里加载以后就能永久使用。第二类是评估 licenseEvaluation License。安装 Design Edition 或 System Edition 时如果选了“I would like to use a free 30-day evaluation license”Xilinx 会自动给你发一个评估 license期限是 30 天。这个 license 可以体验到完整版的所有功能和全部器件支持但到期后必须购买正式 license 或改用 WebPACK。第三类是节点锁定 licenseNode-locked。付费购买之后Xilinx 根据你电脑的主机名和网卡地址生成一个许可证文件只能在这一台电脑上使用。这是个人开发者的常见选择。第四类是浮动 licenseFloating License。部署在局域网里的许可证服务器上多台电脑共享使用适合学校和公司团队。价格更贵配置也复杂一些。对于绝大多数学生和个人开发者来说使用 WebPACK 免费 license 就足够了。这也是我在本文中重点要用实操来讲解的。4.2 注册 Xilinx 账号并申请 WebPACK 免费 license申请 WebPACK 免费 license 的完整流程我一步步走一遍给你看。第一步注册 XilinxAMD账号。这一步在 2.1 节已经说过如果你下载安装包时已经注册了直接用同一个账号登录就行。第二步登录 AMD/Xilinx 的软件许可中心。首先访问 AMD 官网登录你的账号。在页面右上角找到你的头像或者登录状态点击进入账户管理界面找到“Software Licensing”或者“Product Licensing”相关的入口。这个入口的位置在不同时间段改版过几次如果找不到就在官网搜索栏输入“Vivado WebPACK license”或者“get license”也可以直接跳转到对应的许可申请页面。第三步创建许可证。在许可页面上选择“Create License”或“Generate License”然后按照提示操作器件/产品选择产品类型选择“Vivado Design Suite”然后选择“WebPACK/Vivado ML Standard”或类似标注为 free 的选项。License 类型选择选“Node-locked license”。填写主板信息这里需要填写 Host ID其实就是你电脑的网卡物理地址MAC 地址。在 Windows 下打开命令行输入ipconfig /all找“以太网适配器”或“无线局域网适配器”里的“物理地址”格式类似A4-B1-C1-2C-D3-E4把中间的横杠去掉再填上去。提交生成生成之后页面上会提供一个 .lic 文件供你下载。下载的文件一般叫Vivado_WebPack.lic或类似名字。这里提醒一下Host Name主机名也要填写正确。在 Windows 命令行里输入hostname就能查到。Xilinx 生成 license 时会同时绑定主机名和 MAC 地址要么都不能变否则 license 失效。第四步保存 .lic 文件。下载下来的 .lic 文件不要随便放也不要删掉。我建议把它复制到C:\Xilinx\Vivado\2018.3\目录下或者单独建一个C:\Xilinx\license文件夹放好。这样后面配置起来路径好找万一 Vivado 需要重装license 文件也还在。4.3 在 Vivado 中配置 license拿到 .lic 文件后还要在 Vivado 里正确加载它否则启动时还是会提示 license 错误。打开 Vivado 2018.3在启动界面的第一屏就能看到下角有一个“Manage License”的选项。如果你之前已经能打开 Vivado也可以通过菜单 “Help → Manage License...” 进入许可证管理器。许可证管理器打开后左下角有几个选项卡切换到 “Load License” 选项卡可以看到当前许可证的状态。点击 “Copy License” 按钮选择你刚才保存的 .lic 文件路径然后点确定。Vivado 会弹出一个提示框告诉你 license 加载成功。还有一种方法是设置环境变量。右击“此电脑”→“属性”→“高级系统设置”→“环境变量”在“系统变量”里新建一个变量变量名XILINXD_LICENSE_FILE变量值C:\Xilinx\Vivado\2018.3\Vivado_WebPack.lic改成你实际保存的路径设置完成后重启 Vivado它会自动加载这个 license 文件。这个方法的优点是不管你在哪个目录下启动 Vivado都能正确识别 license。4.4 License 相关报错排查license 配置过程中最常见的报错主要有这么几个我一个个给你拆。报错一“You do not have permission to enter a license key.”这个报错字面意思是“没有权限输入 license 密钥”。绝大多数情况是因为你用非管理员权限打开了 Vivado 的 License Manager。解决办法很简单关闭 Vivado右键图标选择“以管理员身份运行”再重新打开 License Manager 操作。报错二“Fatal Error: License check failed.”这种报错常见于安装完当天启动正常第二天打开突然报错。排查步骤是先检查 .lic 文件是否还在原路径如果被清理软件误删了重新放回去再检查系统时间是否正确因为 license 的时间机制会校验系统时间时间偏了会直接判定 license 无效。报错三在 License Manager 的 “Manage License” 选项卡里Vivado 显示 “No valid license features found” 或者 “All licenses are in use”。“No valid license features found” 表示 .lic 文件内容没有被正确读取有可能是文件路径选错了或者文件内容被修改过了。我建议直接重新下载一份 .lic 文件覆盖原文件再加载一次。“All licenses are in use” 则多数出现在网络浮动 license 环境下需要联系 license 服务器管理员或者确认没有其他人占用了所有许可。报错四license 文件导入成功但综合时提示某些功能不可用。如果你用的是 WebPACK license那么部分高级功能比如部分器件的综合优化策略确实不在授权范围内。解决办法只有升级付费 license或者确认你使用的器件确实在 WebPACK 支持列表内。我也遇到过一些很邪门的情况比如 license 加载成功但启动时还是弹窗报错。这时候可以尝试彻底清除 Vivado 的缓存删除C:\Users\用户名\AppData\Roaming\Xilinx目录下的相关缓存文件再重启 Vivado。5. 安装完成后的验证与生产建议5.1 首次创建工程验证安装装完以后先别急着写大工程我建议按下面的方式快速验证一遍环境是否正常。第一步打开 Vivado选择“Create Project”新建一个空工程。在器件选择界面选择一个你手头上开发板对应型号的芯片比如很多国产开发板用的是 xc7a35tcsg324-1就搜索这个型号确认它没有被标灰。第二步创建工程后新建一个简单的顶层 Verilog 文件写一个最简单的代码例如一个分频计数器或者两个输入端的与门。然后点“Run Synthesis”看看综合能不能正常跑完。第三步在“Flow Navigator”里点击“Open Implemented Design”然后“Generate Bitstream”生成比特流。如果整个流程走下来没有报错恭喜你Vivado 2018.3 已经基本可以正常使用了。如果软件本身是好的但连接开发板下载比特流时提示“No hardware target”或者“Could not open device”那就回到 3.3 节说的检查 USB-Cable 驱动程序是否识别成功。设备管理器里看到 “Xilinx USB Cable” 且没有黄色感叹号才算驱动 OK。5.2 常见问题速查表我把这几次安装和帮别人安装时遇到的高频问题整理成一个速查表你可以直接对照排查问题现象可能原因解决方法安装程序启动即闪退解压路径含中文或空格重新解压到纯英文无空格路径安装到一半报错进度条不动杀毒软件隔离了安装文件关闭实时防护重新安装打开 Vivado 提示 license 过期系统时间不对或 .lic 文件丢失校准系统时间重新加载 licenseLicense Manager 打不开或卡死Java 环境异常检查系统 PATH 环境变量中 Java 相关配置JTAG 识别不到开发板Cable 驱动未安装/未签名手动指定驱动路径安装综合时内存不足Out of Memory电脑内存过小或同时开太多程序关闭其他程序增加虚拟内存中文注释在综合后显示乱码Vivado 默认编码不是 UTF-8在编辑器设置中将字符集改为 UTF-8或统一使用英文注释生成比特流失败报 LUT/FF 资源不足工程逻辑规模超出器件容量优化代码或者换更大容量器件5.3 一些来自实操的经验与建议安装运行 Vivado 2018.3 这几年下来我积累了几条自己的习惯趁着这篇博文分享给大家。第一安装包不要删。Vivado 的工具链比较庞大有时候工程里某个 IP 出现奇怪的问题最常见的修复方式就是把整个工具卸载重装。手里留着安装包和 license 文件重装起来非常快比临时去官网下载快多了。第二多建几个版本的工程备份。2018.3 的工程文件存在版本兼容性问题用新版 Vivado 打开 2018.3 工程时往往会提示升级升级之后可能就回不去了。所以我习惯把原始工程和升级后的工程分别保存避免误操作导致工程无法回溯。第三设置合理的内存分配。Vivado 在综合和布局布线阶段非常消耗内存如果你的电脑是 8GB 内存建议在综合前关闭浏览器等大内存应用并且确认系统的虚拟内存设置是“系统自动管理”而不是手动固定值否则真的很容易直接卡死。第四留意 WebPACK 和付费版的器件支持差异。申请 WebPACK license 的时候页面上会列出支持的器件列表。如果你选择的芯片不在列表内综合时会有“device is not supported by the current license”之类的提醒。遇到这种情况要么换用支持列表内的同类芯片要么考虑使用评估 license 先做前期开发。Vivado 2018.3 的安装和 license 配置本质上就是这么回事下载离线包按部就班安装申请一个免费的 WebPACK license加载进去就能正常使用了。整个过程看着步骤多但真正执行下来也就不到两小时比学 FPGA 本身简单得多。希望这篇文章能帮大家少走一些弯路把精力集中在真正重要的逻辑设计和调试上。后面如果在使用过程中遇到什么新问题也欢迎回来看看这篇博文有没有更新补充或者按照速查表里的思路自己先排查一遍。