第二章 开发环境搭建：Vivado+SDK/Vitis安装、交叉编译工具链配置、JTAG调试器连接

说实话，很多初学者在FPGA+ARM协同开发这条路上，第一道坎不是代码，而是环境搭建。我见过太多人卡在安装配置这一步，一卡就是好几天。嗯，今天我就把这块硬骨头给你啃下来。

2.1 Vivado与SDK/Vitis的安装——别踩这些坑

先说说Vivado。这是Xilinx家的主力工具，集成了FPGA设计、综合、布局布线、仿真等全套功能。我个人习惯用Vivado 2020.1以后的版本，因为对Zynq系列支持更稳定。

安装前你要知道的事：

  • 磁盘空间：完整安装需要至少80GB。别问我怎么知道的，我第一次装的时候只留了50GB，装到一半就红了。
  • 操作系统：Windows 10/11 64位或Ubuntu 18.04/20.04。我建议用Ubuntu，命令行操作更顺手。
  • 内存：至少16GB。8GB跑大工程会卡到你怀疑人生。
⚠️ 重要提醒： 安装路径不要有中文！不要有空格！我见过有人把Vivado装在"Program Files (x86)"下，结果综合时报错，查了两天才发现是路径问题。

安装步骤（以Vivado 2020.1为例）：

  1. 去Xilinx官网下载Vivado HLx安装包（约20GB）。
  2. 运行安装程序，选择"Vivado HL WebPACK"或"Vivado HL Design Edition"。
  3. 在组件选择界面，务必勾选：
    • Vivado（核心工具）
    • SDK（Software Development Kit，用于ARM软件开发）
    • Zynq-7000器件库
  4. 等待安装完成。这个过程大概需要1-2小时，去喝杯咖啡吧。

安装完成后，你会看到两个主要工具：Vivado（FPGA开发）和Xilinx SDK（ARM软件开发）。从2020.2版本开始，SDK被Vitis取代了。如果你用新版，流程类似，只是界面换了。

2.2 交叉编译工具链配置——ARM核的灵魂

Zynq的ARM核是Cortex-A9，它不能直接跑x86的编译结果。你需要一套交叉编译工具链，说白了就是在PC上编译出ARM能跑的代码。

Xilinx SDK/Vitis自带了一套工具链，路径一般在：

C:\Xilinx\Vivado\2020.1\gnu\arm\nt\bin\arm-xilinx-eabi-gcc.exe

但如果你像我一样喜欢用命令行，可以手动配置环境变量：

# Linux环境下
export CROSS_COMPILE=arm-xilinx-eabi-
export CC=${CROSS_COMPILE}gcc
export LD=${CROSS_COMPILE}ld
export AR=${CROSS_COMPILE}ar

# 验证是否配置成功
arm-xilinx-eabi-gcc --version
💡 小技巧： 把上面这些export命令写到 ~/.bashrc 文件里，每次打开终端自动生效。我当年就是没写，每次都要手动敲一遍，烦死了。

为什么要用交叉编译？ 你想想看，ARM Cortex-A9的指令集和你的PC（x86）完全不同。PC编译出来的二进制文件，ARM核根本看不懂。交叉编译工具链就是那个翻译官。

我在项目中遇到过一个问题：用SDK自带的编译器编译出来的程序，在Zynq上跑起来总是莫名其妙地崩溃。后来发现是编译器版本和硬件不匹配。所以我的建议是：尽量用Vivado配套的SDK版本，不要自己从网上下载别的ARM GCC。

2.3 JTAG调试器连接——让硬件听你的话

JTAG调试器是连接PC和Zynq开发板的桥梁。通过它，你可以下载程序、设置断点、查看寄存器、单步调试。说白了，它就是硬件的调试器。

常见的JTAG调试器：

型号 速度 价格 推荐指数
Xilinx Platform Cable USB II 6 MHz 约¥2000 ⭐⭐⭐⭐
Digilent JTAG-HS3 30 MHz 约¥800 ⭐⭐⭐⭐⭐
FTDI FT2232H（自制） 12 MHz 约¥50 ⭐⭐⭐

我个人推荐Digilent JTAG-HS3，性价比高，速度快，而且兼容性好。如果你预算有限，也可以用开发板自带的USB-JTAG接口（比如Zedboard、PYNQ-Z2都自带）。

连接步骤：

  1. 用JTAG线连接调试器和开发板的JTAG接口（注意方向，别插反了）。
  2. 用USB线连接调试器和PC。
  3. 给开发板上电。
  4. 打开Vivado，点击"Open Hardware Manager"。
  5. 点击"Auto Connect"，Vivado会自动识别调试器。

✅ 成功标志： 在Hardware Manager中能看到"xc7z020"（Zynq-7020）或类似型号，旁边有个绿色小点。如果显示红色，说明连接有问题。

常见问题排查：

  • 驱动问题：Windows下需要安装Xilinx USB驱动。如果插上没反应，去设备管理器看看有没有黄色感叹号。
  • 供电不足：有些调试器需要额外供电。我遇到过JTAG-HS3插在USB 2.0口上不稳定，换到USB 3.0口就好了。
  • JTAG链顺序：如果你同时连接了多个器件，需要在Vivado中配置JTAG链顺序。
⚠️ 避坑指南： 我曾经在调试时，JTAG线没插紧，结果下载到一半断开了，导致FPGA配置数据损坏。从那以后，我每次都会先轻轻拉一下JTAG线，确认插紧了再开始下载。

2.4 第一个Hello World——验证环境是否OK

环境搭好了，我们来跑个最简单的程序验证一下。

步骤：

  1. 打开Vivado，创建一个新工程，选择Zynq-7020芯片。
  2. 添加一个Zynq Processing System IP核，配置好DDR和UART。
  3. 生成Bitstream，导出硬件描述文件（.hdf）。
  4. 打开SDK/Vitis，导入硬件描述文件。
  5. 创建一个新的"Hello World"工程。
  6. 编译，下载到开发板。

代码很简单：

#include <stdio.h>
#include "platform.h"

int main() {
    init_platform();
    printf("Hello from Zynq ARM Cortex-A9!\n");
    cleanup_platform();
    return 0;
}

如果串口终端打印出"Hello from Zynq ARM Cortex-A9!"，恭喜你，环境搭建成功了！

嗯，到这里，开发环境就搭好了。下一章我们开始真正写FPGA逻辑和ARM代码。别急，先把今天的内容消化掉。有任何问题，随时翻回来看。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →