做 FPGA 固化逃不开 SPI Flash。最近在一款 7 系列板卡上要把 bitstream 烧成上电自动加载的固化模式结果板子上的 Flash 是华邦 W25Q128JVEIQ型号看着眼熟但 Vivado 2020.2 的 Add Configuration Memory Device 默认列表里翻不到这个尾缀。折腾了一圈最后靠手动创建配置器件把问题解决了顺带把这款 Flash 的页、扇区、指令字、JEDEC ID 都核对了一遍。这篇文章就把完整流程写下来包括 Vivado 2020.2 手动添加 W25Q128JVEIQ 的参数怎么填、为什么这么填、固化文件怎么生成、硬件烧写有哪些坑。适合正在做 FPGA 固化、QSPI 启动调试或者第一次被“Vivado 找不到 Flash”卡住的工程师参考。内容不区分芯片厂只要你的 FPGA 支持 Master SPI/QSPI 配置思路就通用。1. 项目背景与思路拆解1.1 为什么需要手动添加 Flash 器件很多朋友的第一反应是Vivado 这么大个工具怎么会连华邦 W25Q128 都不认识其实不是不认识而是版本内置的 config memory device 列表不全。Vivado 默认带上的是经过 Xilinx 验证过的 Flash 型号列表不同版本、不同补丁包的列表还有差异。有的版本有 W25Q128有的只有 W25Q256有的干脆只有 Cypress 和 Micron。2020.2 这个版本发布时间不短了对后来新批次、新尾缀的 Flash 覆盖并不及时。W25Q128JVEIQ 这个后缀在默认列表里搜不到很正常。手动添加的核心不是让 Vivado 真的“认识”这颗芯片而是把 FPGA 配置引擎需要的几个关键参数告诉它容量多大、页多大、地址多少位、读写擦除指令是什么。FPGA 的 SPI/QSPI 控制器是按这些参数去发命令的参数对了Flash 型号叫什么根本不重要。所以整个项目的第一步不是去改电路也不是去找新版本 Vivado而是先在工程里把 W25Q128JVEIQ 的配置器件建出来。参数来源就一个华邦官方的 W25Q128JV 系列数据手册。注意JVEIQ 只是封装、温度等级、包装方式的区别不影响 SPI 指令集。1.2 方案选型SPIx1 还是 SPIx4手动创建 Flash 器件前建议先想清楚固化后要用 SPIx1、SPIx2 还是 SPIx4 启动。这个决定会影响两个地方一是 Flash 的参数配置里要不要填 Quad 相关的读指令二是上电启动时 FPGA 配置时钟和 IO 数量。SPIx1 最稳四根典型信号CS、CLK、DI、DO任何一颗 SPI Flash 都支持指令也最简单固定用 0x03 读或 0x0B 快速读。缺点是配置时间偏长。如果你的 bitstream 有十几 MB上电加载可能要一秒左右很多场景能接受。SPIx4 就快很多同一颗 W25Q128JVEIQ 的 IO0、IO1、IO2、IO3 全部用来传数据。代价是除了正常的 WP# 和 HOLD# 功能切换还要处理 Quad Enable 位很多人在 SPIx4 上启动失败最后发现就是 QE 位没置 1。第一次调板子我的习惯是先用 SPIx1 跑通整个烧写链路再切 SPIx4。不要一上来就追求最高性能先把配置流程走通比什么都重要。1.3 上板前必须确认的硬件信息创建配置器件之前还有一件事比动软件更重要核对原理图。首先看 Flash 的供电。W25Q128JV 系列常见供电是 2.7V 到 3.6V如果你的 FPGA 配置 Bank 电压是 1.8V中间又没有电平转换那 FPGA 和 Flash 之间的高电平判据都对不上大概率会出现识别 ID 失败、读回来全是 0xFF 这类问题。然后看 CS#、CLK、DQ0 到 DQ3 的网络是不是真的连到了 FPGA 的配置管脚。很多板子为了复用 SPI Flash会挂一个 SPI 切换器或者电平转换芯片如果切换方向没控制对Vivado 能看到 JTAG 链上的 FPGA但读不到 Flash 的 ID。最后确认启动模式。7 系列 FPGA 一般有 M[2:0] 配置引脚要切换到 Master SPI/QSPI 模式。不同板卡丝印不一样具体值以数据手册和UG470为准。我遇到过板子默认是 JTAG 模式结果烧到 Flash 里也没问题但一断电就全部丢因为 FPGA 根本没从 Flash 启动。2. 手动添加 W25Q128JVEIQ 完整实操2.1 打开“添加配置存储器”入口在 Vivado 2020.2 里入口有两个地方Flow Navigator 左侧的 Program and Debug - Add Configuration Memory Device或者菜单 Tools - Add Configuration Memory Device。两者打开的是同一个对话框。如果你已经打开了 Hardware Manager 并连接了开发板可以直接操作。如果还没连硬件也没关系Add Configuration Memory Device 这个动作本身不依赖硬件它只是在工程里建立一个配置存储器设备记录。真正需要硬件的是最后一步 Program。对话框打开后会有一个搜索框。先尝试输入 W25Q128、w25q128、W25Q128JVEIQ 这几个关键词。有的 2020.2 版本能搜出 W25Q128只是不叫 JVEIQ如果有直接选它也可以。容量、指令集一致的前提下后缀不影响烧写。如果搜不到任何结果就找对话框上的 Create Configuration Memory Device 按钮通常是一个绿色加号点击进入手动创建界面。2.2 新建器件时参数怎么填Create Configuration Memory Device 窗口里的字段在不同小版本下有些差异但关键的几个基本一致。按下面的表填不会跑偏字段建议值说明NameW25Q128JVEIQ自定义名称方便区分ManufacturerWinbond厂商选华邦Type / FamilySPI不是 Parallel 也不是 BPIDensity128 Mb一定要填 Mb别填 MBNumber of Address Bits2416MB 空间需要 24 位地址Page Size256 BytesW25Q128 的标准页大小Number of Pages6553616MB 除以 256B 的结果Sector Size4096 Bytes最小擦除单元是 4KB 扇区Block Size64 KB常用块擦除大小部分工具叫 Block Erase这里最容易出错的字段就是 Number of Address Bits。W25Q128JVEIQ 的容量是 128Mbit除以 8 等于 16MByte也就是 16777216 字节。2 的 24 次方正好是 16777216所以地址位是 24不是 26也不是 32。有人看到“128”就填了 28 或 32 位地址后面烧写时 Flash 地址空间对不上读回校验必挂。页数量也按公式算16MB / 256B 65536 页。有的版本不直接让你填页数而是根据容量和页大小自动算那就不用管。如果环境要求填扇区数就是 16MB / 4KB 4096 个扇区。2.3 指令字字段对照填法新建配置器件时有些版本的界面会列出指令字有些版本则只给一个默认 SPI 模板。如果你看到了类似 Read Instruction、Program Instruction、Erase Instruction 这种配置项按 W25Q128JVEIQ 数据手册填下面的表功能指令字Read Data0x03Fast Read0x0BQuad Output Fast Read0x6BPage Program0x02Quad Input Page Program0x32Sector Erase 4KB0x20Block Erase 64KB0xD8Chip Erase0xC7Write Enable0x06Write Disable0x04Read Status Register 10x05Write Status Register0x01Read JEDEC ID0x9F如果界面没有这些输入项大概率是用了通用 SPI 模板Vivado 会按常见 SPI NOR Flash 的默认指令去操作这种情况下重点核对容量、页大小、地址位数即可。等烧写报错时再回来查指令字。需要注意SPIx1 模式主要依赖 0x03 或 0x0B 读取SPIx4 模式必须保证 Quad Output Fast Read 的 0x6B 和 Quad Page Program 的 0x32 正确。W25Q128JVEIQ 这颗芯片的 Quad 指令都是标准的和 Cypress、ISSI 的并不完全一样所以不要用别的厂牌模板强行套。2.4 保存并绑定配置存储器创建完成后回到 Add Configuration Memory Device 的列表找到刚建的 W25Q128JVEIQ选中并确定。如果 Vivado 弹出一个是否立即 Program 的提示第一次先选择不烧写或取消等 bit 文件生成之后再统一处理。回到工程后这个配置器件就算绑定进当前工程了。下次再打开 Add Configuration Memory Device列表里会直接出现你手动创建的名字。更推荐的做法是把这一步沉淀成自己的常用配置很多设计团队会维护一个统一的定制 Flash 列表换工程时直接选比每次手动填参数省事得多。如果你用的是纯 Tcl 流程也可以把创建命令写进 tcl 脚本里这样整个团队都能复用避免每个人填的参数不一致。3. W25Q128JVEIQ 的 SPI 参数详解3.1 容量、页、扇区、块的换算关系W25Q128JVEIQ 是一颗 128Mbit 的 SPI NOR Flash。很多人对 Mbit 和 MB 的换算不敏感导致填参数时出错。128Mbit 除以 8正好是 16MByte也就是 16MB 的二进制存储空间。这颗 Flash 的存储结构是分层的最小可编程单位是页通常一次 Page Program 最多写 256 字节最小可擦除单位是扇区一个扇区 4KB块则是 32KB 或 64KB。整理成表格就清楚多了参数值总容量128 Mbit / 16 MByte地址位数24 bit页大小256 Byte页数量65536扇区大小4 KByte扇区数量409664KB 块数量256供电电压2.7V ~ 3.6V以具体批次手册为准这里有一个实用换算技巧如果不需要翻手册通过 JEDEC ID 或者容量代码也能推算。Vivado 里填参数时只要容量填 128页大小填 256它会自动算出页数量。但是地址位数不一定自动算所以还是自己算一下更放心。3.2 JEDEC ID 与芯片识别SPI NOR Flash 上电后默认支持一条 Read JEDEC ID 指令 0x9F返回三个字节厂商 ID、内存类型、容量代码。W25Q128JV 系列的标准返回是 EF 40 18。EF 表示华邦40 表示 SPI NOR Flash 类型18 表示容量为 128Mbit。这个 ID 很重要。Vivado 在实际烧写前会尝试去读挂在 SPI 总线上的 Flash ID然后和当前选择的配置存储器器件做比对。如果 ID 对不上会直接报 Flash ID mismatch。手动创建器件时如果界面里有 Silicon ID 或者 JEDEC ID 字段填 EF 40 18。没有的话尽量选已有的 Winbond W25Q128 模板不要拿其他厂商模板硬套。调试时遇到 ID mismatch第一件事不是怀疑手动创建有问题而是用示波器看 CS、CLK、DQ0 上到底有没有数据回来。很多情况下是 Flash 压根没工作或者供电电压不对。ID 读不到和 ID 读出来不对是两个方向的问题排查思路完全不一样。3.3 指令码详解与配置模式含义W25Q128JVEIQ 支持标准 SPI、Dual SPI、Quad SPI不同模式用到的读指令不一样。配置 FPGA 时常用的指令集中在读、写、擦除和状态寄存器操作。普通读 0x03 每次只能按 1bit 传数据适合做兼容测试速度慢。快速读 0x0B 加了 dummy cycle时钟可以提得更高。Quad Output Fast Read 0x6B 用四根 IO 传数据是 QSPI 启动时最常见的读指令。Vivado 在 SPIx4 模式下生成的配置时序就是基于这类 Quad 指令。写数据用的是 Page Program 0x02普通模式一次最多写 256 字节。Quad Input Page Program 0x32 允许四个 IO 同时输入数据速度更快前提是 QE 位已经置 1。擦除方面扇区擦除 0x20 按 4KB 擦64KB 块擦除 0xD8整片擦除 0xC7。Vivado 编程前一般会先做擦除具体用哪个命令取决于你在配置器件里填的 Sector Size。状态寄存器操作同样重要。编程前必须写 0x06 使能写状态寄存器写完要轮询 0x05 的 BIT0等 WIP 位变成 0 才能进行下一步。很多烧写失败其实是擦除还没完成就开始校验了问题不在指令而在时序。3.4 引脚功能与四线模式的关系W25Q128JVEIQ 的常见封装是 8 脚 SOIC。引脚功能如下引脚名称说明1CS#片选低有效2DO / IO1数据输出四线模式下为 IO13WP# / IO2写保护四线模式下为 IO24GND地5DI / IO0数据输入四线模式下为 IO06CLK时钟7HOLD# / IO3保持四线模式下为 IO38VCC电源重点看第 3 脚和第 7 脚。默认情况下它们是 WP# 和 HOLD#但在 Quad 模式下会变成 IO2 和 IO3。想启用这个模式必须把状态寄存器 2 里的 QE 位Quad Enable置 1。如果 QE 位是 0即使 Vivado 配置为 SPIx4FPGA 发出的 Quad 读命令也不会得到完整数据因为 Flash 的 IO2、IO3 根本没被作为数据线使能。这也是为什么很多人 SPIx1 烧写一切正常换成 SPIx4 后 Flash 能擦能写但断电重上电后 FPGA 就是起不来。原因往往不是 FPGA 的问题而是 Flash 的 QE 位没有设。QE 位设置的方法要么用华邦官方工具要么用普通 SPI 编程器先写状态寄存器要么在 Vivado 烧写界面支持状态寄存器写入时直接填。如果在界面里找不到别硬刚用编程器先设好 QE 再回来烧。4. 固化文件生成与硬件烧写要点4.1 bit、bin、mcs 到底有什么区别很多新手分不清这三个文件其实从 FPGA 固化角度看区别很简单。bit 文件是 JTAG 直接加载到 FPGA 内部的位流不上电保留断电就丢。bin 文件是去掉所有打包信息的原始二进制位流按地址原样写入 Flash。mcs 文件是 Intel HEX 格式的文本文件里面带地址信息适合用通用编程器烧录。Vivado 在线烧 Flash 时bit 和 mcs 都能用但 mcs 更适合归档和工厂量产。如果只是自己调试直接用 bit 文件让 Vivado 在线写 Flash 就够了。如果要发布固件我习惯生成 mcs 文件因为 mcs 里带地址别人拿到后可以准确知道程序放在 Flash 的哪个位置不容易烧错。4.2 用 Tcl 一键生成固化文件Vivado 的 Tcl 控制台可以直接把 bit 文件转换成 mcs 或 bin不需要连硬件。命令格式如下write_cfgmem -format mcs -interface SPIx4 -size 128 -loadbit up 0x0 ./top.bit -file ./top.mcs -force如果只是要一个原始二进制文件把格式改成 binwrite_cfgmem -format bin -interface SPIx4 -size 128 -loadbit up 0x0 ./top.bit -file ./top.bin -force几个参数解释一下。-format 指定输出格式mcs 或 bin。-interface 指定 SPI 模式SPIx1、SPIx4 都有。-size 128 表示目标 Flash 容量是 128Mb必须和 W25Q128JVEIQ 一致。-loadbit 里的 up 0x0 表示把 bit 文件从 Flash 地址 0x0 开始摆放-force 是覆盖已存在的同名文件。如果你已经连了开发板也不用担心命令会冲突。生成文件只是纯本地操作不访问硬件。真正烧写时才需要 Hardware Manager 里的目标设备。手头没有开发板的时候照样先把 mcs 生成好等板子回来了直接烧。4.3 在线烧写 W25Q128JVEIQ 的完整步骤在线烧写我一般按下面这个顺序来先做完综合、实现、生成 bit 文件。确保实现没有暗红色错误bit 文件能正常生成。打开 Hardware Manager点击 Open Target通过 JTAG 连接 FPGA。在 Flow Navigator 或 Hardware Manager 窗口里点击 Add Configuration Memory Device选择之前创建好的 W25Q128JVEIQ。弹出 Program Configuration Memory Device 烧写窗口后选择 bit 文件或 mcs 文件。勾选 Erase、Blank Check、Program、Verify 四个选项。第一次烧写建议全部勾上后面调试可以只勾 Program 和 Verify省掉擦除步骤。点击 OK等待烧写完成。Vivado 会先执行擦除然后写入最后读回校验。烧写成功后把板卡启动模式切换到 SPI/QSPI重新上电。这里有一个很容易踩的坑Program Configuration Memory Device 窗口里的 Configuration Memory Device 一定要选对如果选错成默认其他型号Vivado 会先读 Flash ID然后报 mismatch。确认选的确实是我们手动建的那个 W25Q128JVEIQ。4.4 上电验证要注意什么上电验证不是看 Flash 写进去了就行要看 FPGA 是不是真的从 Flash 启动。最简单的验证方式是观察 FPGA INIT_B 和 DONE 信号。配置成功后 DONE 应该拉高。如果 DONE 一直是低说明配置没有完成。另一种方式是用一个 GPIO 翻转程序做测试bit 里控制 LED 翻转上电后能看到 LED 变化就说明加载成功。如果烧写成功但上电后没有任何现象别急着怀疑 Flash。先把启动模式拨码开关确认一遍再看原理图上 FPGA 配置 Bank 的电压是否正常。很多时候问题出在模式选择而不是固件内容。5. 常见问题与排查技巧实录5.1 问题速查表现象大概率原因处理办法Vivado 搜不到 W25Q128JVEIQ默认列表没有该尾缀手动创建或使用同容量 W25Q128 模板烧写时报 Flash ID mismatch手动创建参数错误 / 硬件异常核对 JEDEC ID EF 40 18检查供电和接线Erase 后校验失败供电不稳、器件虚焊检查 Flash 电源滤波重新焊接SPIx4 烧写成功但上电不启动QE 位没置 1用编程器设置状态寄存器 QE 位烧写成功但 DONE 不拉高启动模式错误 / 位流地址错误检查 M[2:0] 和 loadbit 的 0x0 属性Flash 能擦除但 Write 一直忙SPI 时钟过高降低 SPI 时钟频率再试这张表是我自己实际调试过程中最常遇到的几个方向。下面挑三个详细说。5.2 问题一Flash ID 读不出来或匹配不上W25Q128JVEIQ 的 JEDEC ID 是 EF 40 18。如果 Vivado 报 ID mismatch先用逻辑分析仪或示波器抓一下 SPI 的命令波形。重点看 0x9F 命令发出去后Flash 有没有在 DO 上返回数据。很多情况下ID 读不到不是参数问题是硬件问题。最常见的是 Flash 供电电压不对或者 WP#、HOLD# 引脚被外界拉死导致芯片处于保护或不响应状态。还有一种是 FPGA 配置 Bank 电压和 Flash 电压不匹配IO 电平判断失败。这种问题在纯软件里找不到答案只能回到原理图逐脚核对。如果 ID 能读出来但和 EF 40 18 不一样那就看是不是买到了翻新片或者兼容片。有的国产兼容型号容量一样但 JEDEC ID 可能不同这种需要你在手动创建器件时把 ID 改成实际值。5.3 问题二SPIx4 模式启动失败SPIx1 烧写正常不代表 SPIx4 一定没问题。Flash 的 WP# 和 HOLD# 引脚在默认状态下分别是写保护和保持功能要让它们变成 IO2 和 IO3必须把状态寄存器 2 的 QE 位置 1。我在实际项目里见过太多这种情况Vivado 里选的 SPIx4烧写时也能擦能写verify 也通过但就是断电后 FPGA 起不来。最终排查下来是 Flash 的 QE 位还是 0导致 FPGA 上电后用 Quad 指令读数据时IO2、IO3 没有真正工作数据总线不完整读回来的全是垃圾。解决办法有三个一是用 SPI 编程器先把 QE 位设好再上板二是用华邦官方烧录工具单独设置三是如果 Vivado 烧写界面提供了状态寄存器写入功能直接写 0x02 到状态寄存器 2。设完之后可以再用读状态寄存器 2 的 0x35 指令验证 QE 位是否已经变 1。5.4 问题三SPI 时钟太高导致读写不稳定W25Q128JVEIQ 数据手册上写的快速读时钟可以达到 133MHz但实际板卡上能不能跑那么高要看 PCB 走线长度、过孔数量、上拉电阻以及 FPGA 配置 Bank 的电气环境。在调试阶段不要直接把 SPI 时钟拉到最高。Vivado 的配置时钟可以通过属性限制也可以先在 SPIx1 模式下用较低频率验证 Flash 读写稳定再提高。遇到 Erase 偶尔超时、Verify 随机失败这类问题优先降低 SPI 频率。很多时候 50MHz 跑得很稳100MHz 就可能偶发失败这不是 Flash 芯片本身的问题是信号完整性不够。还有一点FPGA 配置 SPI 时钟和 Flash 内部擦除没关系但擦除状态轮询的间隔不能太短。擦 4KB 扇区需要几十毫秒擦 64KB 块可能需要几百毫秒如果每次轮询间隔只有几微秒看起来就像卡死了。Vivado 一般会自己处理但用第三方工具烧写时要注意。5.5 电子工程师的一点实操体会最后分享一个我自己的习惯新建完 W25Q128JVEIQ 配置器件后先把生成的 mcs 文件保留下来命名带上日期和版本号。硬件组、软件组、生产组同事拿到这个文件就能独立烧录不用每次打开 Vivado 重新生成。另外手动创建的配置存储器参数我建议整理成一个 Markdown 表放进工程文档哪怕过了一年再回来维护这个板子翻文档比翻 Vivado 界面快得多。FPGA 固化本身不难但参数填错了排查起来特别折磨人。把这颗 W25Q128JVEIQ 的参数一次搞清楚后面同类 SPI NOR Flash 基本就是复制粘贴的事。