Vivado QSPI固化流程优化：双FSBL策略与关键环境变量配置详解

1. Vivado QSPI固化问题的背景与根源

最近在Vivado 2017.4版本中使用QSPI方式固化程序时，遇到了一个让人头疼的问题：Flash擦除操作显示成功，但程序始终无法正常写入。经过一番排查，发现这个问题其实源于Xilinx官方在Vivado 2017.3版本引入的一个改动。

这个改动本意是好的 - Xilinx希望统一Zynq-7000和Zynq UltraScale+系列的QSPI Flash使用流程。但就是这个"统一"带来了意想不到的问题。具体来说，在QSPI引导模式下启动时，"指定的FSBL"会尝试从Flash加载分区，这直接导致了Flash编程的错误行为。结果就是要么无法下载程序到Flash，要么下载后无法正常启动。

这个问题困扰了我好几天，直到发现需要采用"双FSBL"策略才能解决。简单来说，就是需要创建两个不同功能的FSBL程序：一个专门用于生成BOOT.bin文件，另一个则专门用于实际的Flash编程操作。这种看似"绕路"的方法，实际上完美避开了官方改动引入的陷阱。

2. 关键环境变量的配置

2.1 XIL_CSE_ZYNQ_UBOOT_QSPI_FREQ_HZ的作用

在开始具体操作前，我们需要先配置一个关键的环境变量：XIL_CSE_ZYNQ_UBOOT_QSPI_FREQ_HZ。这个变量控制着QSPI Flash的通信频率，默认情况下可能不适合所有板卡。

我建议将这个值设置为10000000（10MHz），这个值在大多数情况下都能稳定工作。设置方法很简单：

1. 右键点击"我的电脑"，选择"属性"
2. 进入"高级系统设置"
3. 点击"环境变量"按钮
4. 在系统变量中新建一个变量
   • 变量名：XIL_CSE_ZYNQ_UBOOT_QSPI_FREQ_HZ
   • 变量值：10000000

设置完成后，记得重启电脑使环境变量生效。这个步骤看似简单，但非常重要，它确保了后续QSPI操作使用正确的通信频率。

2.2 QSPI模式的选择

在Vivado中配置PS端时，QSPI模式的选择也很关键。主要有两种常见模式：

• Single SS 4bit IO：适用于单颗QSPI Flash芯片，4线模式
• Dual Quad SPI：适用于双QSPI Flash芯片配置

选择哪种模式取决于你的硬件设计。以我最近做的一个项目为例，使用的是单颗QSPI Flash，所以选择了Single SS 4bit IO模式。选错模式会导致后续编程失败，所以一定要确认清楚你的硬件配置。

3. 双FSBL工程的创建与配置

3.1 生成BOOT.bin的FSBL工程

第一个FSBL工程的主要任务是生成BOOT.bin文件。这个工程的创建比较常规：

1. 在Vivado中生成bit文件后，启动SDK
2. 确保bit文件被正确选中
3. 新建一个FSBL工程，这个工程不需要做任何修改
4. 右键点击FSBL工程，选择"Create Boot Image"

在创建BOOT.bin的过程中，需要添加三个关键文件：

1. fsbl.elf：刚创建的FSBL可执行文件，作为bootloader
2. top.bit：FPGA的比特流文件
3. tt.elf：需要固化的应用程序可执行文件

这三个文件的添加顺序很重要：FSBL必须第一个，bit文件第二个，应用程序第三个。点击"Create Image"后，就会在指定目录生成BOOT.bin文件。

3.2 用于编程Flash的FSBL工程

第二个FSBL工程（我习惯命名为fsbl_load）才是解决这个问题的关键。这个工程需要在main.c文件中做一个小修改：

找到"Read bootmode register"的位置，添加一行代码：

BootModeRegister = JTAG_MODE;

这行代码的作用是将启动模式强制设置为JTAG模式，从而避免FSBL尝试从QSPI Flash加载程序。这是解决官方bug的核心技巧。

另外，我建议在fsbl_debug.h文件中添加：

#define FSBL_DEBUG_INFO

这样可以启用串口调试信息输出，方便排查问题。

4. 完整的QSPI Flash编程流程

4.1 准备工作

在开始编程前，需要确保：

1. 硬件板卡的模式开关已切换到QSPI启动模式
2. 两个FSBL工程都已正确编译
3. BOOT.bin文件已生成
4. 环境变量已正确设置

4.2 编程步骤

1. 在SDK中，选择"Xilinx" -> "Program Flash"
2. 在弹出的对话框中：
   • 选择BOOT.bin文件（由第一个FSBL工程生成）
   • 选择fsbl_load.elf文件（由第二个FSBL工程生成）
   • 设置Flash Type，这个必须与之前在Vivado中设置的QSPI模式一致
3. 点击"Program"按钮开始编程

编程过程中，可以通过串口查看fsbl_load输出的调试信息，确认编程是否正常进行。编程完成后，建议给板卡断电再上电，测试QSPI启动是否正常。

5. 常见问题排查

在实际操作中，可能会遇到各种问题。以下是我总结的几个常见问题及解决方法：

1. 编程失败：检查环境变量是否设置正确，QSPI模式是否与硬件匹配，两个FSBL工程是否都正确编译。

2. 编程成功但无法启动：可能是BOOT.bin文件生成有问题，检查三个文件的添加顺序是否正确，或者尝试重新生成BOOT.bin。

3. 速度慢：可以尝试调整XIL_CSE_ZYNQ_UBOOT_QSPI_FREQ_HZ的值，但不要超过Flash芯片的额定频率。

4. 调试信息不显示：确认fsbl_debug.h中已定义FSBL_DEBUG_INFO，并检查串口连接和设置是否正确。

我在实际项目中采用这套方法后，QSPI固化成功率大大提高。虽然步骤看起来有点多，但一旦熟悉后，整个过程其实很顺畅。关键是要理解每个步骤的作用，这样遇到问题时才能快速定位和解决。