做FPGA开发尤其是Zynq这种带ARM核的SoC平台“程序固化”几乎是每个人都要过的一关。很多朋友用Vivado做仿真、跑SDK调试都挺顺利一碰到要把程序烧到Flash里就开始对着报错日志发懵。这篇文章专门解决这个问题从SDK配置到Flash烧录把整个流程掰开揉碎讲清楚适合刚接触Zynq开发板的同学也适合被“flash download failed - target dll has been cancelled”这类错误折磨到抓狂的工程师。全程没有跳步按顺序操作就能跑通。1. 固化前先看懂Zynq启动流程与固化本质1.1 为什么程序非要固化不能一直靠JTAG下载很多初学者有一个疑问我用JTAG把bitstream下载进去程序不也能跑吗为什么非要固化这里面的核心差别在于存储介质。FPGA的配置数据存放在SRAM或者BRAM里这类存储器是易失性的也就是掉电即丢。JTAG调试时workspace里加载的程序只存在于当前上电状态一旦断电芯片内部干干净净一切从头来过。固化的本质就是把需要加载的程序写进非易失性存储器里比如QSPI Flash、SD卡、NAND Flash这类掉电不丢数据的介质。Zynq上电之后片内的BootROM会自动从你选定的启动介质中读取启动镜像完成加载整个过程不需要电脑、不需要调试器。对产品来说这是唯一能交付的运行方式。板子在客户那儿不可能每台都连着一根JTAG线。在实际项目里固化还有一个隐含需求把PL侧的bitstream和PS侧的裸机程序或操作系统镜像打包在一起。因为Zynq是一个SoCPS处理器系统和PL可编程逻辑要协同工作固化的产物不是单一文件而是一个包含多段内容的启动镜像这也是很多人觉得固化比纯FPGA麻烦的真正原因。1.2 一条启动链看懂BootROM、FSBL、bitstream和应用程序的关系要理解Vivado和SDK里那堆文件到底在干什么得先搞清楚Zynq的启动链路。整个启动过程分阶段推进每一段代码只负责做一件事然后把手里的活儿交给下一段。很多人固化失败就是因为只关注了某一个文件忽略了整条链的完整性。第一个阶段是BootROM。这是芯片出厂时固化在ROM里的代码上电就执行CPU复位后第一条指令就来自这里。BootROM会根据启动模式引脚MIO[5:0]的电平判断是从QSPI、SD卡还是NAND启动然后把存储介质前特定偏移处的启动头读出来加载FSBL。第二个阶段是FSBLFirst Stage Boot Loader。它由Xilinx官方提供模板代码本质是一个引导加载程序负责初始化DDR内存、配置PS端的MIO引脚复用和时钟然后去加载PL侧的bitstream。如果启动镜像里还有SSBL比如U-Boot或者用户的应用程序FSBL也会把它们从Flash搬到DDR里最后跳转执行。第三个阶段才是用户真正的程序可能是裸机C工程也可能是嵌入式Linux的U-Boot、内核和设备树。这样一拆就清楚了BootROM相当于电脑里的主板固件FSBL相当于引导扇区bitstream相当于PL侧的配置流文件应用程序相当于操作系统。四者缺一不可任何一段加载失败启动过程就卡死在空中表现就是串口无输出、程序不运行。1.3 项目里用哪种启动介质QSPI还是SD卡固化方案的选型直接影响后续烧录流程。Zynq常见启动介质有QSPI Flash、SD卡、NAND Flash、NOR Flash四种但实际项目中绝大多数用QSPI Flash和SD卡这两类。QSPI Flash是目前最主流的固化介质。它占用引脚少板级布线简单容量一般在16MB到512MB之间对大多数裸机程序和中等规模嵌入式Linux镜像都够用。它的读取速度快支持XIP片上执行性价比很高。xilinx官方开发板很多都板载了QSPI Flash从16MB到64MB不等。SD卡启动多用于嵌入式Linux系统因为Linux文件系统通常需要数百MB甚至GB级别的空间QSPI Flash容量不够。但SD卡方案依赖SDIO接口启动速度比QSPI慢而且SD卡座和卡本身在工业环境中的可靠性不如Flash芯片稳定。NAND Flash容量大、成本低但控制器复杂需要软件处理ECC校验和坏块管理对新手来说调试难度偏高。NOR Flash则因为引脚多、容量小在Zynq平台已经很少作为独立启动介质使用。我的建议很简单如果只是裸机程序或者轻量级Linux系统无脑选QSPI Flash固化。这篇教程后续默认使用QSPI Flash演示。2. 动手前准备软件环境、硬件连接与Flash型号确认2.1 Vivado与SDK版本怎么选装错了很麻烦做固化流程软件版本直接影响操作界面和工具链行为。Vivado和SDKSoftware Development Kit的版本必须严格对应不能混用。2019.2及之前的版本SDK作为一个独立组件集成在Vivado安装器里安装时勾选SDK选项即可装好后在Vivado里可以直接Launch SDK。从2020.1版本开始Xilinx把SDK换成了Vitis界面变化较大操作入口不同但底层流程依然保留。如果你手里是新买的开发板厂家提供的例程可能基于某个特定版本最稳妥的做法是先装与例程配套的版本不要去追最新版。追新版本容易遇到IP版本更新、约束文件格式变化这些额外麻烦。安装时记住一个原则安装路径不要包含中文、不要包含空格比如直接装到D:\Xilinx这种路径否则后续综合、仿真都可能出现莫名其妙的问题。另外Vivado正常运行要求电脑有足够内存和磁盘空间8GB内存是最低要求16GB以上体验才好综合大工程时16GB内存也经常吃紧。Windows系统下还有一个常见坑WinPcap安装失败。这个问题多出现在Vivado安装程序准备以太网调试组件时多数情况下可以跳过不影响本地JTAG调试和固化流程不用被它吓到。2.2 硬件连接与JTAG链路确认烧录前必做的三步检查开始烧录之前硬件连接一定要确认到位否则浪费大量时间在找设备上。第一步用JTAG调试器连接开发板的JTAG接口和电脑USB口。Xilinx USB Cable和Digilent JTAG-HS3/HSP都是常见选择。USB线尽量短劣质线材在高速通信时会出现间歇性断连这是很多“DLL被取消”报错的元凶。第二步打开电脑的设备管理器在“通用串行总线设备”分类下能看到识别出来的调试器设备。不同厂商芯片显示的名字不一样Digilent线通常显示为“Digilent USB Device”Xilinx线显示为“Xilinx USB Cable”或“Xilinx Platform Cable USB”。如果这里看不到设备优先重装驱动或更换USB口不要急着打开Vivado。第三步打开Vivado的Hardware Manager点击Open Target正常情况下会列出JTAG链上的设备列表。Zynq系列芯片在JTAG链上会显示两个设备一个是DAP一个是ARM分别对应调试访问接口和ARM处理器。能看到这两个设备才算链路正常看不到就比对着第二步往下排查。硬件管理器里还可以设置JTAG频率烧录和调试时保持在15MHz以下比较稳定遇到线材一般或链路较长时降到3MHz能解决不少玄学问题。2.3 确定板子上到底用的哪颗Flash别想当然Flash型号在烧录配置里必须选对这是程序固化里最容易被忽略的环节。开发板不同Flash芯片就不同。有的板子用Micron的N25Q128有的用Winbond的W25Q256还有用Spansion、ISSI的芯片。它们的基本命令协议大体兼容但ID、密度、扇区大小各有差异工具识别错误会导致擦除和编程地址错乱表现就是烧录报“failed to communicate with the flash chip”。从哪里查型号第一去处是开发板原理图搜索“Flash”“QSPI”“SPI”关键字能看到具体的厂商和型号比如“MT25QU256ABA1EW7”就是一颗Micron 256Mb的QSPI Flash。第二去处是板卡用户手册通常会说明板载Flash容量和兼容型号。第三去处是直接读芯片丝印芯片表面印有型号信息找个放大镜看就能对上。拿到型号后还要确认两个参数供电电压和最大频率。同系列QSPI Flash有1.8V和3.3V两种版本比如Micron的MT25Q系列带“E”后缀通常是1.8V带“W”后缀是3.3V。烧录时SDK的Flash Device列表里会区分电压版本选错电压类型同样会导致通信失败。Flash厂商常见型号容量电压SDK中常显示的名称MicronN25Q128A13E128Mb1.8Vn25q128-1.8v-spi-x1-x2-x4MicronMT25QU256ABA256Mb1.8Vmt25qu256-1.8v-spi-x1-x2-x4WinbondW25Q256JV256Mb3.3Vw25q256-3.3v-spi-x1-x2-x4WinbondW25Q128JV128Mb3.3Vw25q128-3.3v-spi-x1-x2-x4ISSIIS25LP128128Mb3.3Vis25lp128-3.3v-spi-x1-x2-x4注意上表仅供参考最终以板卡原理图和芯片数据手册为准。数据手册里还有每个命令的时序和地址范围排查问题时用得上建议下载一份放到手边。3. 制作用于固化的产物BIT与FSBL一个都不能少3.1 从Vivado导出硬件为什么bitstream必须先生成固化需要三类原料PL侧的位流文件bitstream、FSBL的可执行文件、用户应用程序的可执行文件。这三个文件准备好了才能合成最终的BOOT.bin镜像。先说bitstream。在Vivado里完成综合、实现、生成bitstream三个步骤后会得到一个.bit文件默认路径在工程目录的工程名.runs/impl_1目录下文件名类似design_1_wrapper.bit。很多新手卡在这一步因为工程在Implementation阶段直接报错变红根本到不了Generate Bitstream。遇到“implement design变红”别慌点开Implementation的日志和Timing Summary看看是时序违例、约束没写完整还是DCP文件缺失。大部分实现失败都能在综合日志里找到根因修掉再跑就是。bitstream生成之后下一步是导出硬件。在Vivado菜单栏选择File - Export Hardware弹出对话框后务必勾选“Include bitstream”选项。如果不勾选导出的硬件描述文件里不包含PL侧配置后面SDK生成BOOT.bin时没有bit可用。导出的文件后缀有两种老版本是.hdf新版本是.xsa内容逻辑相同都是描述当前硬件平台的文件。导出完成后打开Vivado SDK或Vitis工作空间选择你指定的目录然后File - New - Hardware Platform选中刚才导出的硬件文件。这一步很重要SDK的所有工程都要挂在这个硬件平台上否则后续找不到FSBL模板和bit文件。3.2 SDK里创建FSBL工程模板选择是唯一的关键FSBL不需要自己从头写Xilinx官方提供现成模板你要做的事就是创建工程、编译、拿.elf文件。打开SDK后在菜单栏选择File - New - Application Project工程名可以叫fsblProcessor选择当前Zynq芯片对应的ARM核Next进入模板选择页面在列表里找到“Zynq FSBL”模板选中并Finish。等待工程编译完成后工程目录下会生成fsbl.elf文件默认路径在fsbl/Debug/目录下。这个elf就是启动链里的引导加载程序。正常情况下不需要修改FSBL源码。只有当你有特殊需求比如自定义DDR初始化时序、调整启动等待时间时才需要修改FSBL源码里的相应函数修改后重新编译即可。编译FSBL时要注意一个坑如果你的硬件工程里用了PS端的MIO引脚或者DDR配置FSBL启动时会根据硬件描述文件里的配置去初始化DDR和MIO。所以硬件平台文件必须是最终版的、与你当前板卡匹配的不能拿一个改过引脚约束的旧版本去凑合。否则虽然烧录成功启动时DDR都可能初始化失败程序一片空白。用户应用程序的创建类似File - New - Application Project模板选“Hello World”或者“Empty Application”写出你的裸机程序或者直接用于固化测试编译后生成app.elf。如果你想用Linux系统固化则这一步变成编译U-Boot得到u-boot.elf原理相同位置不同。3.3 生成BOOT.binCreate Boot Image的操作细节与bif结构三个elf/bit准备好之后就该打包了。SDK菜单栏选择Xilinx - Create Boot Image打开创建启动镜像对话框。这是固化流程里最关键的一步分区顺序错了哪怕烧录成功也启动不了。操作流程如下。第一在Boot Image Partitions区域先添加FSBL文件点击Add选择fsbl.elfPartition type选择“bootloader”。这一项必须标记为bootloaderBootgen工具才能正确生成启动头。第二再次点击Add选择bit文件Partition type保持默认的“datafile”。第三第三次点击Add选择用户应用程序的elf文件比如app.elfPartition type保持datafile。如果后续要启动Linux这个位置放u-boot.elf。Output格式默认是BIN也可选MCS这里用BIN即可。指定输出路径建议输出到工程根目录下然后点击Create Image。几秒后会在指定目录生成BOOT.bin文件。你可以查看同一目录下自动生成的.bif文本文件内容大致如下the_ROM_image: { [bootloader] fsbl.elf design_1_wrapper.bit app.elf }这个bif是Bootgen工具的输入描述文件用文本编辑器可以直接编辑。熟练掌握bif语法之后可以在命令行用“bootgen -image xxx.bif -o BOOT.bin”的格式批量生成镜像这在脚本化构建固件时非常有用。不过刚上手还是建议在SDK图形界面操作直观、不易出错。分区顺序是BOOT.bin生成中唯一需要用力记住的规则FSBL必须在第一个分区bitstream其次应用elf最后。如果把bitstream放在第一位BootROM会尝试把它当成FSBL加载然后直接跑飞串口上一行打印都没有。4. Flash烧录实操从擦除到校验的完整步骤4.1 Program Flash Memory工具的每个选项到底在干什么BOOT.bin拿到手接下来就是烧录环节。在SDK里选择Xilinx - Program Flash Memory打开烧录工具。这个界面上有几个选项每个都有意义不能随便填。Image File选择要烧录的镜像也就是前面生成的BOOT.bin。Offset镜像烧写到Flash的起始地址绝大多数情况下填0x0。BootROM上电后就是从这个地址读取启动头填错地址则启动失败。Flash TypeFlash类型常见选项是qspi-x4-single意思是四线QSPI单die配置。还有qspi-x8、qspi-x1等选项要根据板卡硬件连接方式选择。大部分开发板Flash的DQ0-DQ3四根线都连到了Zynq的QSPI控制器上用x4模式即可。Flash Device选择具体的Flash芯片型号上一步查好的型号在这里用上。FSBL File这里还要再选一次fsbl.elf不过不是用来打包的而是用来执行的。烧录程序本身需要跑在CPU上XSCT工具会把fsbl.elf加载到OCM运行FSBL再初始化QSPI控制器并执行Flash擦写操作。很多新手不理解为什么烧录Flash还要FSBL文件。简单说QSPI控制器位于PS侧的I/O外设区域操作QSPI Flash前需要完成MIO引脚复用配置和时钟初始化这些工作正是FSBL干的事。没有这个文件工具连Flash芯片都访问不了。4.2 烧录全流程实测擦除、写入、校验一气呵成确认硬件连接正常、镜像文件齐全、Flash型号无误后就可以执行烧录了。整个流程我按顺序给你过一遍。第一步先确认当前JTAG链路中没有其他进程占用。Vivado Hardware Manager如果已经连着target再在SDK里启动Program Flash可能会冲突。最稳妥的顺序是先关闭Hardware Manager的session再在SDK里执行烧录。第二步打开Program Flash Memory按照上节所述的配置填好各个选项点击Program按钮。这时脚本会自动执行连接ARM核、下载FSBL到OCM、运行FSBL初始化、向Flash发送擦除命令、逐页写入BOOT.bin、回读校验。Console窗口会实时打印执行日志整个过程根据镜像大小不同几十秒到几分钟不等。第三步观察日志输出。出现“Flash Operation Successful”或者类似的成功提示才算真正完成。如果中途弹出“error: flash download failed - target dll has been cancelled”之类的内容那就是第5章的排查内容了先继续往下看正常流程。这里补充一个自己总结的小技巧正式烧录之前先把目标Flash区域擦除一遍。SDK的Program Flash流程里自带擦除动作但偶尔会因为Flash状态未准备好而跳过擦除直接向非空区域编程导致启动异常。稳妥做法是先通过工具或脚本对整片Flash执行擦除确认“Erase Completed”后再执行完整烧录。强制擦除的代价只是多花十几秒但能规避大量莫名启动失败问题。4.3 固化完成后的启动验证跳线、上电、看串口烧录窗口显示成功并不等于万事大吉最关键的验证动作是断电重启。首先把开发板上的启动模式跳线或拨码开关切到QSPI启动模式。不同开发板的设置方式不同有的在板子背面丝印了“QSPI/SD/JTAG”的说明有的需要看原理图确认MIO[5:0]引脚对应的电平组合。以常见Zynq-7000为例QSPI启动模式的MIO[5:0]电平通常为010010具体值请查看你的板卡手册不要盲抄网上数据。切换完成后连接好串口线打开串口终端工具波特率设置为板卡示例工程规定的值大部分是115200然后给板卡重新上电。观察串口打印。如果一切正常能看到FSBL的启动信息接着是应用程序的打印输出。如果用的是纯PL逻辑工程而没有PS应用可以通过观察板卡LED或加个逻辑分析仪来判断PL侧是否被正确配置。如果重新上电后串口无任何输出不要急着怀疑Flash没烧进去先回头检查四点启动模式拨对了没有BOOT.bin是不是确实包含FSBL且FSBL排在第一个分区Flash供电和WP引脚是否有正确的上下拉QSPI Flash型号是否选择正确。这四个问题按优先级排查大概率能定位。5. 常见报错与排查技巧实录5.1 “flash download failed - target dll has been cancelled”深度排查这个报错是Xilinx论坛上被问得最多的问题之一也是我最开始踩过的坑。报错信息本身并不说明具体原因只表示下载过程中target DLL即与硬件通信的动态链接库操作被外部取消或中断。从原理上讲出现这个错误只有两大类的可能一类是通信链路物理层不稳定另一类是软件层面有多个进程抢占了调试器。物理层排查顺序先换一根高质量的USB线长度不要超过1米避开USB Hub直连主机然后换电脑原生USB口优先用蓝色USB3.0口有时候主板前置面板的USB口供电不足会引发此问题检查开发板是否独立供电且电源指示灯正常调试器虽然能给JTAG链路供电但不足以支撑整个板卡工作。一个很多工程师忽略的点是JTAG链路上的设备太多且IDCODE异常建议断开JTAG链上其他不相关的设备只留下目标Zynq芯片。软件层面排查顺序关闭所有可能占用调试器的窗口包括Hardware Manager、多个SDK实例、Vivado Tcl Console如果开着老版本SDK的调试会话先全部停掉再重试重新插拔USB线让Windows重新枚举设备必要时重启一次电脑。我自己解决这个报错的最快路径是拔掉USB线、关闭Vivado和SDK、重新插线、重启Hardware Manager、确认能看到设备后再去SDK烧录。这一套流程能解决七八成“DLL被取消”的玄学问题。5.2 “failed to communicate with the flash chip”的三大真实原因另一个高频报错就是“warning: failed to communicate with the flash chip, read/write operations wi...”。这个问题通常不是通信链路的问题而是Flash本身没有被正确访问。第一个原因是Flash型号选错。SDK的Flash Device列表按厂商、型号、电压分类不同型号的读ID命令、状态寄存器地址可能有差异。工具先向Flash发送读ID命令如果返回的ID与所选型号不匹配就会报无法通信。解决办法是仔细核对芯片丝印和原理图选择精确的型号不要选“Generic SPI Flash”之类的模糊选项。第二个原因是Flash供电电压配置错误。1.8V的Flash选了3.3V或者反过来芯片VCC引脚电平与Zynq QSPI控制器I/O bank电平不匹配都会导致通信彻底失败。Zynq的QSPI控制器所在的MIO bank由VCCMIO引脚供电必须保证Flash和VCCMIO电平一致。检查开发板原理图确认VCCMIO的电平等级再在SDK里选择对应电压版本的Flash型号。第三个原因是FSBL没有成功初始化QSPI控制器。如果烧录时选择的FSBL文件与当前硬件工程的MIO配置不一致尤其是MIO引脚复用表里没有把QSPI功能分配到正确的引脚组那么FSBL运行时QSPI控制器引脚就是悬空的自然无法访问Flash。这时要回硬件工程确认PS引脚配置里QSPI的MIO连接是否正确重新导出硬件并编译FSBL后再试。5.3 “cannot load flash device description”怎么破还有一类报错会明确告知“cannot load flash device description”意思是SDK/Vitis内置的Flash描述库中没有找到匹配的芯片描述文件。这个问题主要出现在Vivado版本较旧、Flash芯片较新或者芯片型号冷门的情况下。解决办法有三条路。一是升级Vivado/SDK版本新版本工具的Flash描述库更加完整很多新发布的Flash型号都能识别。二是绕过SDK的Flash Device下拉列表直接使用Hardware Manager Programming Flash模块。在Vivado Hardware Manager中右击设备选择“Add Configuration Memory Device”工具会尝试自动探测Flash ID并根据ID匹配已知部件型号成功匹配后即可直接烧写不需要在SDK里选择型号。三是自己手动创建MCS镜像并配置用Program Flash中的Generic选项手动输入Flash命令参数这个方法适合熟悉Flash底层时序的工程师新手优先尝试前两种。需要提醒的是如果选择升级Vivado版本要注意工程和IP核的版本兼容问题。老版本的IP在新版本Vivado中可能被标记为未升级需要先跑一次IP Catalog里查看哪些IP需要升级再继续后续流程。5.4 一张表整理高频固化故障按优先级排查故障现象首要原因次要原因推荐排查动作烧录报target dll cancelled调试器通信受干扰软件抢占调试器、驱动异常换USB口/线重启Vivado与SDK关闭多余调试会话无法与Flash芯片通信Flash型号或电压选错QSPI控制器初始化失败核对芯片丝印确认VCCMIO电平和Flash供电电压更换精确型号cannot load flash device descriptionSDK Flash库无此型号工具版本过旧升级工具版本或用Hardware Manager自动探测Flash ID烧录成功但断电后不启动启动模式未切换到QSPIBOOT.bin分区顺序错误检查MIO[5:0]跳线重新生成BOOT.bin并确认FSBL在首位串口启动打印到一半卡死Flash地址与分区不符DDR初始化失败核对Offset是否为0x0检查FSBL是否匹配当前DDR配置JTAG链找不到设备驱动未装或线缆问题JTAG频率过高检查设备管理器更换线缆降低JTAG频率到3MHzFlash写入后回读数据不符Flash坏块或工作电压不稳烧录频率过高降低烧写时钟频率先整片擦除再重新写入排查的基本原则是先从最基础的物理层查起再一步步往上走。不要一上来就怀疑工具bug或者芯片坏掉大多数问题都出在连接、配置、电源这三类常见原因上。6. 一些只有踩过坑才知道的细节这里分享几个实际操作中得来的心得常规教程里不会写这么细但每一条都能帮你省下半天时间。第一JTAG频率能调低就调低。我和同事在实际调试中发现很多“下载失败”“DLL cancelled”问题把JTAG频率从30MHz降到3MHz就自动消失了。在调试阶段CPU运行频率和JTAG频率都无所谓稳定压倒一切烧录速度慢一点儿换来的是成功率大幅提升。第二养成保存bif文件的习惯。每次在SDK图形界面生成BOOT.bin时工具都会生成对应的.bif文件。把这个文件保存好以后改工程后可以直接命令行生成避免了反复打开图形界面点选文件的重复劳动。命令行格式就是“bootgen -image xxx.bif -o BOOT.bin”在Vivado的Tcl Console里就能执行。第三断电重启才是唯一标准。烧录成功后不要急着庆祝也不要只看烧录工具提示成功就认为固件正确。把启动模式切到QSPI断电重新上电观察应用是否正常运行。有些情况下烧录虽然成功但BOOT.bin内部文件有问题只有真正的断电启动才能暴露出来。最后再说一个让我印象极深的案例。有次追查一个固化后启动随机失败的bug挠头查了三个小时换了各种Flash型号和烧录频率都没解决最后发现是Flash芯片的WP写保护引脚被悬空了导致电路噪声耦合使Flash进入写保护状态部分扇区怎么擦都擦不掉。所以拿到一块新板子先确认Flash的控制引脚WP、HOLD有正确的上下拉电阻这类细节往往藏在原理图最不起眼的角落却能把整个固化流程搅得天翻地覆。