企业官网建设流程全解析

Vitis 2019.2环境下ZYNQ QSPI程序固化全流程实战指南

在FPGA开发领域，ZYNQ系列芯片因其独特的ARM+FPGA架构备受青睐。然而，当Xilinx将开发工具从SDK迁移到Vitis后，许多工程师在程序固化环节遇到了挑战。本文将深入解析Vitis 2019.2环境下的QSPI固化全流程，帮助开发者高效完成从比特流生成到最终烧录的完整操作。

1. 环境准备与项目升级

1.1 开发环境配置

工欲善其事，必先利其器。在开始之前，请确保已准备好以下环境：

• 软件要求：

  • Vivado 2019.2（64位版本）
  • Vitis统一开发平台
  • 对应版本的驱动和许可证

• 硬件要求：

  • ZYNQ开发板（本文以启明星7020为例）
  • USB-JTAG调试器
  • QSPI Flash芯片

提示：虽然本文以启明星7020为例，但操作流程适用于大多数ZYNQ开发板，只需注意引脚分配的差异。

1.2 项目升级关键步骤

从旧版本迁移项目时，需要特别注意以下升级环节：

# 项目目录结构建议 /project_root /vivado # Vivado工程文件 /vitis # Vitis工作区 /src # 源代码

1. 项目文件升级：

   • 双击.xpr文件打开工程
   • 选择"Automatically upgrade..."选项
   • 等待Vivado完成自动升级

2. IP核升级：

   • 在IP Status报告中选中所有需要升级的IP
   • 点击"Upgrade Selected"按钮
   • 确认升级对话框

3. QSPI接口配置：

   • 打开Block Design
   • 双击ZYNQ Processing System IP核
   • 在Peripheral I/O配置中启用Quad SPI Flash

2. Vitis平台项目创建

2.1 硬件导出新变化

Vitis引入了全新的硬件描述文件格式——XSA（Xilinx Support Archive），取代了传统的.hdf文件。导出时需注意：

导出完成后，通过Vivado菜单栏的"Tools > Launch Vitis"启动开发环境。

2.2 平台项目建立要点

在Vitis中创建Platform Project时，有几个关键决策点：

1. 工作区选择：

   • 建议使用独立的/vitis目录
   • 避免路径过长（可考虑subst命令）

2. 项目命名规范：

   • 平台项目：plat_<功能>（如plat_ov5640_hdmi）
   • 应用项目：app_<功能>

3. 处理器配置：

   • 选择正确的CPU类型（通常为ps7_cortexa9_0）
   • 确认Standalone Domain设置

// 典型的主函数框架 #include "xparameters.h" #include "xil_printf.h" int main() { xil_printf("Hello from ZYNQ!\n"); while(1); return 0; }

3. 应用工程与Boot镜像生成

3.1 应用工程配置技巧

创建应用工程时，以下几个细节容易出错：

• 工程类型选择：

  • 空工程（Empty Application）适合已有代码
  • Hello World模板可用于快速验证

• 路径包含问题：

  • 右键项目 > Properties > C/C++ General
  • 添加路径：/platform_project/ps7_cortexa9_0/standalone_domain/bsp/ps7_cortexa9_0/include

• 源代码导入：

  • 直接复制到/src目录
  • 确保包含所有依赖文件

3.2 Boot Image生成自动化

Vitis最大的改进之一就是简化了Boot Image的创建流程。与传统SDK相比，主要优势体现在：

1. 无需手动创建FSBL：

   • Vitis自动生成First Stage Bootloader
   • 开发者只需提供应用代码

2. BIF文件自动生成：

   • 系统自动创建Boot Image Format描述
   • 包含比特流、FSBL和应用代码的完整配置

3. 一键式操作：

   • 右键应用工程 > Create Boot Image
   • 保持默认设置 > Create Image

注意：生成过程中控制台会显示详细日志，如遇错误应仔细检查此处信息。

4. 烧录实战与问题排查

4.1 QSPI烧录完整流程

按照以下步骤完成最终烧录：

1. 硬件准备：

   • BOOT_CFG跳线设置为JTAG模式（全ON）
   • 连接USB-JTAG调试器
   • 给开发板上电

2. 烧录操作：

   • 右键应用工程 > Program Flash
   • 保持默认设置 > Program
   • 等待控制台显示"Flash programming completed"

3. 启动验证：

   • 将BOOT_CFG跳线设置为QSPI启动（通常为SW2 OFF）
   • 重新上电
   • 观察板载LED或串口输出

4.2 常见问题解决方案

在实际操作中，可能会遇到以下典型问题：

问题1：MIO与QSPI引脚冲突

现象：烧录成功后无法从QSPI启动

解决方案：

• 确认ZYNQ配置中已明确启用Quad SPI Flash
• 检查MIO引脚分配是否占用QSPI所需引脚
• 在Vivado中重新生成比特流并导出

问题2：头文件找不到

现象：编译时报错"xparameters.h not found"

解决方案：

# 确保包含路径正确 /project_dir/vitis/plat_xxx/ps7_cortexa9_0/standalone_domain/bsp/ps7_cortexa9_0/include

问题3：Flash识别失败

现象：Program Flash时提示无法识别Flash型号

解决方案：

• 检查JTAG连接是否稳定
• 确认开发板供电充足
• 尝试降低JTAG时钟频率

经过多次项目实践，我发现最常被忽视的环节是ZYNQ IP核中QSPI的使能设置。很多开发者直接沿用旧项目配置，却忽略了Vitis环境下的这一关键步骤。此外，保持工程目录结构清晰可以避免90%以上的路径相关问题。