解决ZYNQ Flash烧录失败的5个常见问题：以JTAG_MODE设置和路径检查为例

ZYNQ Flash烧录实战指南：从JTAG_MODE设置到路径排查的深度解析

当你在深夜实验室里盯着屏幕上第17次失败的Flash烧录日志时，那种挫败感我深有体会。ZYNQ系列芯片的Flash烧录过程看似简单，实则暗藏玄机——一个标点符号的错误都可能导致数小时的调试白费。本文将带你穿透表象，直击那些开发手册上不会写的实战细节。

1. 破解JTAG_MODE的"先有鸡还是先有蛋"悖论

第一次接触ZYNQ Flash烧录的开发者，90%会在这个问题上栽跟头。为什么需要先设置JTAG_MODE才能烧录，而烧录成功后又得取消这个设置？这背后是ZYNQ启动机制的巧妙设计。

ZYNQ芯片上电时会读取Boot Mode引脚状态决定启动方式（QSPI、SD卡等）。但在首次烧录前，Flash是空的，芯片无法正常启动任何程序。此时通过JTAG烧录时，需要强制让FSBL（First Stage Boot Loader）认为自己是从JTAG启动的，这就是JTAG_MODE的由来。

具体操作需要修改fsbl_hooks.c中的关键代码段：

/* 原始代码 */ BootModeRegister = Xil_In32(BOOT_MODE_REG); BootModeRegister &= BOOT_MODES_MASK; /* 修改后代码 */ BootModeRegister = JTAG_MODE; // 强制指定为JTAG模式

注意：这个修改只需要在首次烧录时使用，成功后必须注释掉这行代码，否则会影响后续的正常启动流程。

2. 文件路径检查：那些SDK不会告诉你的陷阱

SDK的默认文件选择对话框是个"温柔的陷阱"——它总是贴心地为你推荐最近打开过的文件，但这往往会导致以下问题：

• 使用了错误工程的fsbl.elf
• 引用了过时的.bit文件
• 生成的BOOT.bin存放路径包含中文或空格

建议建立以下检查清单：

验证技巧：在SDK中右键点击每个文件选择"Properties"，核对完整路径和时间戳。

3. BOOT.bin生成：被忽视的组件兼容性问题

生成BOOT.bin时最常见的错误是组件版本不匹配。我曾遇到一个案例：使用2017.4版本Vivado生成的比特流文件，却用2018.3版本的SDK生成BOOT.bin，导致烧录后无法启动。

正确的生成流程应该是：

1. 确认所有组件的生成环境一致：

   • Vivado版本
   • SDK版本
   • 硬件定义文件（.hdf）

2. 使用Create Boot Image工具时，注意分区顺序：

   • 第一分区必须是FSBL
   • 第二分区是比特流文件
   • 第三分区是应用程序（可选）

3. 高级选项设置：

   • 对齐方式选择默认的0x8
   • 勾选Create encrypted boot image（仅限加密场景）

# 可以通过以下命令验证BOOT.bin结构 bootgen -arch zynq -image boot.bif -dump -o BOOT.bin

4. 硬件连接：那些"应该没问题"的致命假设

JTAG连接不稳定是烧录失败的常见元凶。以下是一个硬件检查清单：

• 线缆质量：使用官方推荐的JTAG调试器（如Digilent HS2），劣质线缆在低速时可能工作，但高速传输会出错
• 电源噪声：用示波器检查3.3V电源轨的纹波（应<50mV）
• Flash型号匹配：核对原理图中Flash型号与SDK配置是否一致
  • Micron N25Q系列需要特殊配置字
  • Spansion S25FL系列有页大小限制

经验分享：遇到间歇性烧录失败时，尝试降低JTAG时钟频率（在Vivado Hardware Manager中设置）

5. 深度排查：当常规方法都失效时

如果以上步骤都检查无误仍失败，就需要进入"侦探模式"：

1. 日志分析：

   • 在SDK中开启详细日志（Window → Show View → Other → XSCT Console）
   • 关注擦除、编程、验证各阶段的耗时和状态码

2. 信号测量：

   • 使用逻辑分析仪抓取SPI总线信号
   • 检查CS#、CLK、DQ信号的时序和电压

3. 备用方案验证：

   • 尝试通过SD卡启动验证硬件基本功能
   • 用最小化工程排除设计复杂性影响

最后记住，ZYNQ的Flash烧录是个需要耐心的过程。我的开发板上至今还留着第43次成功烧录时留下的咖啡渍——那不仅是失败的印记，更是解决问题的见证。