【PZ-ZU47DR-KFB】璞致FPGA ZYNQ UltraScalePlus RFSOC QSPI Flash 固化实战指南与疑难解析
1. 认识璞致PZ-ZU47DR-KFB开发板与QSPI Flash固化
第一次拿到璞致PZ-ZU47DR-KFB开发板时，我就被它的硬件配置震撼到了。这块板子搭载的是Xilinx ZYNQ UltraScale+ RFSoC XCZU47DR芯片，集成了4核Cortex-A53处理器和FPGA可编程逻辑，还自带8通道5Gsps ADC和8通道9.85Gsps DAC。不过今天我们要重点聊的是它的QSPI Flash固化操作——这是让开发板脱离JTAG独立运行的关键步骤。
QSPI Flash相当于开发板的"硬盘"，固化就是把编译好的程序永久烧录到这个存储介质中。在实际项目中，我发现很多开发者容易忽略一个关键点：即使你只用PL端（FPGA部分），也必须配置PS端（处理器部分）的最小系统。这是因为QSPI Flash控制器实际挂在PS端，就像你要用U盘必须通过电脑的USB接口一样。
2. 生成BOOT.bin文件的完整流程
2.1 创建裸机串口工程
我习惯从最简单的裸机串口工程开始演示。在Vivado中创建工程时，有几点需要特别注意：
- 芯片型号务必选择XCZU47DR-2FFVE1156I
- 在Block Design中添加ZYNQ UltraScale+ MPSoC IP核
- 最少需要配置以下PS端外设：
- QSPI控制器（选择x4或x8模式）
- UART0（用于调试输出）
- DDR4控制器（配置PS侧4GB内存）
生成bit流文件后，点击"Export Hardware"导出XSA文件。这里有个小技巧：如果工程路径包含中文或特殊字符，后续Vitis操作可能会报错。
2.2 Vitis环境配置实战
启动Vitis后，我推荐按这个顺序操作：
# 创建工作空间（路径建议全英文） mkdir -p ~/workspace/zu47_flash cd ~/workspace/zu47_flash在GUI界面中：
- 点击"Create Application Project"
- 选择刚才导出的XSA文件
- 工程名建议用"flash_boot"这类有意义的名称
- 模板选择"Hello World"（后续可修改）
这里经常遇到的坑是：如果Vivado和Vitis版本不匹配（比如2021.1和2022.2混用），会导致XSA导入失败。我建议统一使用2022.2版本工具链。
2.3 关键文件准备与配置
在工程中找到platform.spr文件，右键选择"Build Project"。完成后需要准备三个关键文件：
- FSBL.elf：在
flash_boot/Debug目录下自动生成 - bit流文件：从Vivado导出的
.bit文件 - 应用工程elf：比如串口测试程序的
.elf文件
创建一个bif文件（如bootgen.bif），内容如下：
// 示例bif文件内容 the_ROM_image: { [bootloader] fsbl.elf system.bit application.elf }然后在Vitis Terminal中执行：
bootgen -image bootgen.bif -arch zynqmp -o BOOT.bin -w on成功后会生成约20MB左右的BOOT.bin文件。如果文件大小异常（比如只有几百KB），说明有文件没被正确打包。
3. QSPI Flash烧录的魔鬼细节
3.1 硬件准备与模式切换
烧录前必须确认开发板的启动模式开关设置。在PZ-ZU47DR-KFB上：
- JTAG模式：所有开关拨到OFF位置
- QSPI模式：SW1=ON, SW2=OFF, SW3=OFF, SW4=ON
实测中发现，有些同行的板子无法烧录，八成是因为开关没拨到位。建议用手机微距镜头检查拨码开关状态。
3.2 Vitis中的烧录操作
在Vitis菜单选择Xilinx → Program Flash，会弹出关键配置界面：
- Flash Type：选择"qspi-x4-single"（单Flash芯片方案）
- Image File：选择生成的BOOT.bin
- FSBL：选择之前生成的fsbl.elf
点击Program后，控制台会显示擦除和编程进度。这里有个经验值：512Mb的Flash完整擦除大约需要35秒，编程需要2分钟左右。如果时间明显偏短，可能是烧录失败。
3.3 验证与启动测试
烧录完成后，将启动模式切换到QSPI，重启开发板。如果串口能正常输出启动日志，恭喜你成功了！如果卡住，可以检查以下几点：
- 串口波特率是否设置为115200
- 是否在FSBL中启用了QSPI驱动
- 硬件上是否使用了兼容的Flash型号（开发板通常用MT25QU512ABB）
4. 高频问题排查指南
4.1 启动失败常见原因
根据我的踩坑经验，80%的启动问题集中在以下几个方面：
- 时钟配置错误：PS端必须配置33.333MHz时钟输入
- DDR参数不匹配：必须与板载的4GB DDR4颗粒参数一致
- Flash模式选择错误：两片Flash需选x8-parallel模式
- 电压域配置：PS端IO电压需设置为1.8V
4.2 调试技巧分享
当板子"变砖"时，可以尝试以下救砖步骤：
- 用JTAG连接，在Vivado Hardware Manager中扫描设备
- 如果能识别到芯片，尝试重新烧写FSBL
- 使用Xilinx提供的flash_erase工具彻底擦除Flash：
flash_erase -qspi -size 0x100000004.3 硬件兼容性检查
遇到过最诡异的问题是：同样的bin文件在两块"相同"的板子上表现不同。后来发现是硬件版本差异：
- V1.2版使用MT25QU512ABB
- V1.3版更换为W25Q512JVFQ
解决方法是在Vivado的Board选项卡中更新Flash型号，或者直接修改约束文件：
set_property CONFIG.MODE SPIx4 [get_bd_cells axi_quad_spi_0] set_property CONFIG.C_SPI_MEMORY {1} [get_bd_cells axi_quad_spi_0]5. 高级应用：多镜像与安全启动
5.1 多镜像备份方案
在生产环境中，我通常会配置A/B双镜像备份。修改bif文件如下：
// 多镜像配置示例 the_ROM_image: { [bootloader] fsbl.elf [destination_cpu=a53-0] pmufw.elf [destination_device=pl] system.bit [destination_cpu=a53-0, exception_level=el-3, trustzone] bl31.elf [destination_cpu=a53-0, exception_level=el-2] u-boot.elf [offset=0x100000] app_image1.elf [offset=0xA00000] app_image2.elf }5.2 加密与认证启动
对于商业项目，建议启用RSA-4096签名验证：
- 生成密钥对：
openssl genrsa -out private.pem 4096 openssl rsa -pubout -in private.pem -out public.pem- 在bif文件中添加认证信息：
[auth_params] ppk_select=0; spk_id=0x00000000 [pskfile] private.pem [sskfile] ssk.pem [fsbl_config] auth_only- 使用bootgen生成加密镜像：
bootgen -image secure.bif -o BOOT.bin -arch zynqmp -encrypt uefi -w6. 性能优化实战
6.1 启动时间优化
通过分析启动流程，我发现可以优化这几个阶段：
- FSBL阶段：禁用不必要的外设初始化（如USB、GPU）
- PL配置：使用压缩bit流（-compress选项）
- Uboot阶段：裁剪不需要的功能模块
实测优化后，冷启动时间从8.2秒缩短到3.5秒。
6.2 Flash读写性能测试
使用dd命令测试实际读写速度：
# 写入测试 dd if=/dev/urandom of=test.bin bs=1M count=10 time flashcp -v test.bin /dev/mtd0 # 读取测试 time dd if=/dev/mtd0 of=read.bin bs=1M count=10在x4模式下，测得写入速度约12MB/s，读取速度约45MB/s。切换到x8模式后，性能可提升30%左右。
7. 替代方案：SD卡与eMMC启动
当QSPI空间不足时（比如Linux系统），可以考虑其他启动介质：
SD卡方案：
- 将BOOT.bin和image.ub拷贝到FAT32分区
- 启动模式开关设为SD(1)位置
- 优势：便于更新，容量大
eMMC方案：
- 通过uboot命令烧写：
mmc dev 1 fatload mmc 0 0x10000000 BOOT.bin mmc write 0x10000000 0x0 0x40000- 优势：更可靠，适合工业环境
最后提醒大家，每次修改硬件配置后，一定要重新生成BOOT.bin。曾经有团队花了三天排查问题，最后发现是忘了更新bit流文件。