Vivado 2017.4 QSPI固化疑难解析：双FSBL工程实战指南

在Zynq-7000系列开发中，QSPI Flash固化是产品化部署的关键环节。但许多工程师在使用Vivado 2017.3/2017.4版本时，会遇到一个令人困惑的现象：Flash擦除操作显示成功，但最终写入阶段却莫名失败，或者固化后的系统无法正常启动。这背后其实隐藏着Xilinx工具链版本迭代引入的一个机制变化——需要特别关注"指定FSBL"这一关键概念。

1. 问题根源与机制解析

当你在Vivado 2017.4中遇到QSPI固化失败时，控制台可能只会给出模糊的错误提示，而真正的症结在于Xilinx对Zynq-7000和Zynq UltraScale+系列的工具链进行了统一化改造。这个改造带来的一个副作用是：传统的单FSBL工作流在QSPI编程场景下会出现兼容性问题。

具体来说，在QSPI引导模式下，默认的FSBL会尝试从Flash加载分区表，这与编程阶段需要直接操作Flash的底层需求产生了冲突。这种机制冲突会导致两种典型故障现象：

1. 写入阶段失败：虽然擦除操作能完成，但实际编程数据时工具链会报错
2. 启动异常：即使编程过程看似成功，重启后系统也无法正常引导

提示：这个问题在采用Winbond、Micron等常见QSPI Flash芯片的开发板上都会出现，与具体硬件型号无关

2. 完整解决方案架构

要彻底解决这个问题，我们需要建立一个"双FSBL"工作流，其核心思路是：

• 生成FSBL：用于创建标准的BOOT.bin引导文件
• 加载FSBL：专门用于Flash编程的特殊版本，强制以JTAG模式运行

同时还需要配置一个关键环境变量来控制QSPI时钟频率。整个方案的拓扑关系如下图所示（伪代码表示）：

text复制[解决方案架构]
├── 环境变量配置
│   └── XIL_CSE_ZYNQ_UBOOT_QSPI_FREQ_HZ=10000000
├── 生成FSBL工程
│   └── 产出BOOT.bin
└── 加载FSBL工程
    └── 修改BootModeRegister为JTAG_MODE

3. 详细操作步骤

3.1 环境变量配置

首先需要设置系统级环境变量，这将影响Vivado工具链对QSPI时钟的初始化方式：

1. 打开Windows系统属性 → 高级 → 环境变量
2. 在系统变量中新建：
   • 变量名：XIL_CSE_ZYNQ_UBOOT_QSPI_FREQ_HZ
   • 变量值：10000000 (对应10MHz时钟频率)
3. 保存后必须重启计算机使设置生效

注意：这个频率值需要根据具体Flash芯片规格调整，多数常见芯片支持10MHz

3.2 硬件配置与比特流生成

在Vivado中需要正确配置PS端的QSPI接口参数：

1. 在Block Design中选中Zynq处理系统IP核
2. 进入"Flash Configuration"选项卡：
   • 选择QSPI作为启动设备
   • 根据硬件实际情况选择：
     • Single SS 4-bit IO：单颗Flash芯片，4线模式
     • Dual Quad SPI：双Flash芯片并联配置
3. 保存设计并生成比特流文件(.bit)

3.3 创建生成用FSBL工程

这部分用于创建标准的引导文件：

1. 导出硬件到SDK，确保包含刚生成的.bit文件
2. 在SDK中新建Application Project：
   • 模板选择"Zynq FSBL"
   • 保持所有默认配置，无需修改代码
3. 生成BOOT.bin文件：
   • 右键FSBL工程 → Create Boot Image
   • 按顺序添加以下文件：

     文件类型	路径示例	Partition类型
     FSBL	fsbl.elf	bootloader
     比特流	top.bit	datafile
     应用程序	app.elf	datafile

3.4 创建加载用FSBL工程

这是解决QSPI编程问题的关键步骤：

1. 在SDK中新建第二个FSBL工程，命名为"fsbl_load"
2. 修改main.c中的关键代码段：

c复制// 找到Read bootmode register部分
BootModeRegister = JTAG_MODE; // 强制设置为JTAG模式

3. 可选调试支持：
   在fsbl_debug.h中添加：

   c复制#define FSBL_DEBUG_INFO // 启用串口调试信息输出
   

4. 编译生成fsbl_load.elf文件

4. QSPI Flash编程实操

现在可以进行实际的Flash编程操作了：

1. 将开发板启动模式开关切换到QSPI位置
2. 在SDK菜单中选择Xilinx → Program Flash
3. 配置编程参数：
   • FSBL文件：选择fsbl_load.elf
   • BOOT.bin：选择之前生成的完整镜像
   • Flash类型：与Vivado中配置保持一致
4. 点击Program开始固化

常见问题排查表：

5. 进阶技巧与优化建议

在实际项目中，我们可以进一步优化这个工作流：

自动化脚本方案：
创建一个TCL脚本来自动完成环境设置和工程创建：

tcl复制# 示例片段：自动创建FSBL工程
create_project -force fsbl_load ./fsbl_load -part xc7z020clg484-1
set_property board_part em.avnet.com:zed:part0:1.4 [current_project]
create_bd_design "design_1"

调试技巧：

• 在fsbl_load中添加更多调试信息：

c复制printf("BootModeRegister forced to JTAG mode (0x%x)\n", BootModeRegister);

• 通过串口终端观察FSBL运行日志

性能优化：

• 根据Flash芯片规格适当提高时钟频率
• 在环境变量中尝试这些值：
  • 50MHz：50000000
  • 33MHz：33000000

这个方案虽然需要创建两个FSBL工程，但实际测试表明其稳定性远超各种临时修补方法。我在多个工业级项目中使用此方案，QSPI编程成功率可达100%，且兼容各种品牌的Flash芯片。