ZYNQ7020程序固化实战：从Vivado工程到QSPI自启动

1. 为什么你的ZYNQ7020程序一断电就“失忆”？从JTAG到QSPI的蜕变之旅

很多刚开始玩ZYNQ7020的小伙伴，肯定都经历过这样的场景：在Vivado里辛辛苦苦调通了程序，用JTAG下载到板子上，LED闪起来了，串口有数据了，一切完美！然后你心满意足地关掉了电源，准备给同事或客户演示。结果一上电，板子一动不动，程序“消失”了，仿佛一切都没发生过。这种感觉，就像你熬夜写完的文档没保存就关了电脑，非常令人沮丧。

其实，这背后的原因很简单。我们平时用JTAG下载程序，相当于把程序临时放在了FPGA的“内存”（具体说是配置RAM）里。这块内存是易失性的，一断电，里面的数据自然就没了。而程序固化，就是要把我们编译好的最终成果，从这片“临时工棚”搬到一块“永久仓库”——也就是板载的非易失性存储器里。对于ZYNQ7020开发板来说，这个“永久仓库”最常见的就是QSPI Flash芯片。完成固化后，每次板卡上电，ZYNQ内部的启动ROM都会自动去QSPI Flash里把程序读出来，加载到芯片里运行，实现真正的“上电自启动”。

所以，今天我要和你分享的，就是一整套从零开始的ZYNQ7020程序固化实战流程。我会假设你是一个已经能用Vivado创建工程、写点简单逻辑、并成功生成过比特流（.bit文件）的“进阶新手”。我们的目标非常明确：把手头这个能跑起来的Vivado工程，变成一个烧进QSPI Flash、断电重启也能自己“活”过来的完整产品。这个过程会涉及到Vivado的硬件工程配置、一个叫FSBL的神秘“向导”文件的创建，以及最后烧录时JTAG与QSPI模式的切换。别担心，我会把每一步的细节、我踩过的坑、以及怎么验证都讲清楚，保证你能跟着做出来。

2. 地基要打牢：Vivado硬件工程的关键配置

在开始烧录之前，我们的Vivado工程必须为最终的固化做好充分准备。很多固化失败的问题，根源其实在工程创建和IP配置阶段就埋下了。这一步的目标是生成一个包含完整硬件信息的“硬件描述文件”（.xsa文件），它是后续所有步骤的基础。

2.1 创建工程与ZYNQ7 IP核的初次见面

首先，打开Vivado，创建一个新工程。这个过程大家应该很熟悉了，选择好芯片型号（比如xc7z020clg400-1），一路Next。工程创建好后，最关键的一步来了：在Block Design中添加ZYNQ7 Processing System这个IP核。你可以把它理解为ZYNQ芯片的“大脑”和“中枢神经”，ARM处理器、各种外设控制器（如QSPI、SD卡、UART）都通过它来配置。

双击添加的ZYNQ7 IP核，会打开一个配置界面。这里面的选项很多，但对于固化来说，我们需要重点关注几个地方。第一是DDR配置，必须和你板子上实际焊接的DDR内存型号、大小完全匹配。如果这里选错了，系统可能根本跑不起来，更别提固化了。我建议你直接找到开发板供应商提供的原理图或用户手册，对照着填写。

第二是QSPI Flash的配置。这是固化的核心。在“MIO Configuration” -> “I/O Peripherals” -> “Quad SPI Flash”选项中，确保它被勾选上。更重要的是，在“Bank 1 Voltage”这里，要选择与你板子上QSPI Flash芯片工作电压一致的选项，通常是1.8V或者3.3V。选错了电压，可能会导致无法识别Flash芯片。

第三，根据你的需要，配置好UART（用于打印调试信息）和SD卡（如果有用到的话）等外设。这些配置虽然不直接影响固化，但一个功能正常的系统是验证固化成功与否的前提。全部配置完成后，点击“Run Block Automation”和“Run Connection Automation”，让Vivado自动完成一些连线工作。

2.2 生成比特流与导出硬件平台

配置好Block Design后，你需要创建顶层的HDL包装文件（Create HDL Wrapper）。然后，就可以开始综合（Synthesis）和实现（Implementation）了。这个过程可能会花一些时间，取决于你设计的复杂度。

实现完成后，最关键的一步是生成比特流（Generate Bitstream）。这个.bit文件包含了FPGA部分的逻辑配置信息。但请注意，对于ZYNQ来说，光有.bit文件是不够的，因为系统启动还需要ARM处理器的软件部分。因此，生成比特流后，我们还需要导出硬件（Export Hardware）。

在Vivado的菜单栏，选择 File -> Export -> Export Hardware。在弹出的对话框中，务必勾选“Include bitstream”。导出的结果是一个.xsa文件（Vivado 2019.1及以后版本）或者.hdf文件（旧版本）。这个文件非常重要，它打包了你的硬件平台所有信息，包括PS端的配置、外设地址映射以及PL端的比特流。接下来启动SDK（或Vitis）进行软件开发时，就需要导入这个文件。

这里有个小坑我踩过：有时候导出的.xsa文件路径不能有中文或空格，否则后续SDK导入可能会报错。所以，建议你把工程放在一个纯英文、无空格的目录下。

3. 神秘的“向导”：创建FSBL启动引导文件

硬件描述文件准备好了，现在我们来到了整个固化流程中最关键、也最容易让人困惑的一环——创建FSBL。FSBL的全称是First Stage Boot Loader，翻译过来就是“第一阶段引导加载程序”。你可以把它想象成电脑主板上的BIOS，或者你手机一开机运行的那个最底层的引导程序。

ZYNQ芯片上电后，ARM Cortex-A9处理器会首先执行芯片内部ROM里固化好的一段代码。这段ROM代码非常“笨”，它只做一件事：根据板子上几个启动模式选择引脚（MIO[5:2]）的电平状态，决定从哪里去加载下一段程序。如果我们的启动模式设置为QSPI，那么ROM代码就会去QSPI Flash的固定起始地址（通常是0x00000000）读取数据。

那么，它读到的第一个东西应该是什么呢？就是FSBL。FSBL是一个由我们编写的、编译生成的.elf可执行文件。它的核心任务有三个：第一，初始化一些必要的硬件，比如PS端的时钟、DDR内存控制器；第二，从QSPI Flash的特定位置，把FPGA的比特流文件（.bit）加载进来，并对FPGA部分进行配置；第三，再从Flash里把我们的主应用程序（比如你写的跑在ARM上的C程序，也是一个.elf文件）加载到DDR内存中，然后跳转到应用程序的入口地址去执行。

所以你看，FSBL是一个承上启下的“搬运工”和“调度员”。没有它，就算你把程序烧进了Flash，芯片也不知道该怎么把它们正确地搬出来、放好、并运行。

如何在SDK/Vitis中创建FSBL呢？导出硬件后，在Vivado里点击“Launch SDK”（或“Launch Vitis”）。在新打开的IDE中，首先需要创建或导入一个硬件平台项目（Platform Project），将我们刚才导出的.xsa文件导入进来。然后，我们就可以基于这个硬件平台来创建FSBL了。

在SDK中，选择 File -> New -> Application Project。给项目起个名字，比如“zynq_fsbl”。在接下来的“Templates”选择界面，至关重要：一定要选择“Zynq FSBL”这个模板！SDK会基于这个模板，自动生成一个完整的FSBL工程，里面包含了初始化DDR、加载比特流等所有标准操作。你通常不需要修改这个工程的任何代码，直接编译（Build Project）即可。编译成功后，在工程目录的Debug或Release文件夹下，就能找到生成的zynq_fsbl.elf文件。这个文件，就是我们固化所需的三大核心文件之一。

4. 打包“全家桶”：制作可启动的BOOT.BIN镜像

现在，我们手头已经有了三个关键文件：1) 硬件比特流文件（.bit），2) FSBL引导文件（.elf），3) 你自己的应用程序文件（.elf，假设你已经写了一个简单的Hello World程序来测试）。但是，QSPI Flash可不会智能地识别这三个文件并按顺序执行。我们需要把它们打包成一个单一的、可启动的镜像文件，这就是BOOT.BIN。

这个打包过程，在SDK/Vitis里是通过一个叫“Create Boot Image”的工具完成的。具体操作步骤如下：

1. 在SDK中，找到菜单 Xilinx -> Create Boot Image（不同版本位置可能略有差异）。
2. 在弹出的界面中，首先选择输出镜像的路径和文件名，默认就是BOOT.BIN。
3. 最关键的是在“Boot image partitions”部分，按顺序添加分区：
   • 第一个分区：添加你的zynq_fsbl.elf文件，并设置分区类型为bootloader。
   • 第二个分区：添加你的.bit文件（注意，这里需要的是Vivado生成的原始.bit文件，而不是任何其他格式）。分区类型会自动识别为FPGA比特流。
   • 第三个分区：添加你的应用程序.elf文件（例如hello_world.elf），分区类型为datafile。
4. 点击“Create Image”按钮，工具就会自动将三个文件按顺序拼接，并加上一些必要的头部信息，生成最终的BOOT.BIN文件。

这里的顺序绝对不能错！因为ZYNQ的ROM代码从Flash读出的第一个镜像，就期望它是一个可执行的引导程序（FSBL）。FSBL运行后，会按照镜像中紧接着的比特流、应用程序的顺序依次处理。你可以把BOOT.BIN想象成一列火车：车头是FSBL，后面挂载的第一节车厢是比特流，第二节车厢是你的主程序。发车（上电）后，必须按这个顺序来。

在打包之前，有个非常实用的建议：先用JTAG模式进行功能验证。你可以不急着生成BOOT.BIN，而是先在SDK里，通过JTAG分别下载FSBL、比特流和应用程序到板子上运行。确保在JTAG模式下，你的系统能正常工作（比如串口能打印信息）。这能帮你排除是程序本身的问题，还是固化流程的问题，避免走弯路。

5. 临门一脚：使用Vivado Hardware Manager烧写QSPI Flash

万事俱备，只欠烧录。现在我们要把打包好的BOOT.BIN文件“刻录”到板子的QSPI Flash芯片里。这里需要用到Vivado的“Hardware Manager”工具，并且要特别注意一个硬件操作：启动模式切换。

首先，请确保你的开发板通过JTAG下载器（如Digilent USB-JTAG）与电脑连接好。打开Vivado，在左下角找到“Open Hardware Manager”并连接上你的板卡。当看到芯片被正确识别后，我们开始烧录：

1. 在Hardware Manager界面中，右键点击你的芯片（如xc7z020），选择“Add Configuration Memory Device…”。
2. 这时会弹出一个对话框，让你选择Flash芯片的型号。这一步至关重要，必须选择与你板上焊接的QSPI Flash型号完全一致的器件。常见的型号有“Spansion s25fl128s”（128Mb）或“Micron n25q128”（128Mb）等。如果你不确定，回去翻看板卡原理图或用户手册。选错了型号会导致烧写失败甚至损坏Flash。
3. 选择正确后，Vivado会为这个Flash器件创建一个配置文件。然后，右键点击这个新出现的Flash设备，选择“Program Configuration Memory Device”。
4. 在弹出的编程对话框中：
   • 在“Configuration file”一栏，点击“…”按钮，找到并选中我们刚才生成的BOOT.BIN文件。
   • “Memory device”应该已经自动填好了你刚才选择的Flash型号。
   • 其他选项可以保持默认。
5. 点击“OK”开始烧写。下方控制台会显示擦除、编程、验证的进度条。整个过程可能需要几十秒到几分钟，取决于你的BOOT.BIN文件大小和Flash型号。

烧写过程中，请确保板卡供电稳定，不要断开JTAG或电源。当看到“Program/Verify Operation completed successfully”的提示时，恭喜你，软件层面的烧写工作就完成了！

6. 验证成果：切换启动模式与故障排查

烧写成功提示出来后，先别急着欢呼。因为我们刚才的操作，是在板子处于JTAG启动模式下，通过JTAG接口对Flash进行的编程。此时，ZYNQ芯片本身仍然是从JTAG获取启动指令的。所以，要验证固化是否真正成功，必须进行最后一步硬件操作：将板子的启动模式开关，从JTAG模式切换到QSPI模式。

几乎所有ZYNQ开发板都会有这么一组拨码开关（通常是4个或5个），用来设置MIO[5:2]的引脚电平，从而选择启动源。你需要找到你的板子手册，查看如何设置才能选择为“QSPI启动模式”。常见的设置是MIO[5:2] = 0010（二进制）。

操作顺序应该是：

1. 确保BOOT.BIN已烧写成功。
2. 关闭板卡电源。
3. 按照手册，将启动模式拨码开关从JTAG位置拨到QSPI位置。
4. 将JTAG下载器从板子上物理断开（这一步很重要，是为了确保芯片不会意外从JTAG获取信号）。
5. 重新给板子上电。

接下来就是见证奇迹的时刻。如果一切顺利，你应该会看到和之前用JTAG调试时一样的现象：比如程序设定的LED开始闪烁，或者串口调试助手收到了预期的打印信息（如“Hello World”）。这证明，板子上电后，自动从QSPI Flash中读取了BOOT.BIN，FSBL成功运行，配置了FPGA并加载了你的应用程序。

如果上电后没有任何反应，怎么办？别慌，这是学习过程中很正常的一部分。我们可以按以下思路排查：

• 检查启动模式开关：这是最常见的问题。再次确认拨码开关的设置是否绝对正确，接触是否良好。可以用万用表量一下相关MIO引脚的实际电压。
• 回顾Flash型号：在Vivado中添加Flash设备时，型号是否100%选对？哪怕一个字母之差，也可能导致驱动不兼容。
• 检查BOOT.BIN内容：确认打包BOOT.BIN时，三个文件的顺序（FSBL -> .bit -> app.elf）是否正确。可以尝试用一个最简单的、不带FPGA比特流的纯ARM程序（即只打包FSBL和app.elf）来测试，排除PL部分配置的问题。
• 串口输出调试信息：确保你的FSBL和应用程序中，初始化了UART并打印了信息。即使程序跑飞，早期的串口输出也能帮你定位问题发生在哪个阶段。在SDK里创建FSBL时，其代码默认是包含串口调试输出的。
• 电源和时钟：测量一下板子的核心电压、DDR电压、Flash供电电压是否正常。特别是QSPI Flash的供电电压（1.8V或3.3V）是否与你在ZYNQ IP核中Bank 1的配置电压一致。
• 重新烧写：有时候Flash可能存在个别坏块，或者第一次烧写不完整。可以尝试擦除整个Flash后重新烧写一次。

我自己的经验是，第一次成功固化可能会遇到一两个小波折，但只要严格按照步骤，耐心检查每个环节，最终都能让板子成功“独立”跑起来。当你看到程序在完全断开JTAG的情况下自如运行时，那种成就感，会觉得之前所有的折腾都是值得的。这标志着你的开发从“实验调试”阶段，正式迈向了“产品部署”的门槛。