复现案例 · OpenHW on ALINX · 第 09 集

SPI Flash Bootloader 与 A/B 升级:坏 CRC 自动回退,不靠复位

这一集把 CVE2 从“每次用 JTAG 下载”推进到“上电自己从 Flash 启动”。Bootloader 放在 64 KiB 统一 RAM 的前 16 KiB,A/B 两个 512 KiB 槽放在 GD25Q128E 的 0x00C00000 和 0x00C80000,元数据各占 4 KiB。主机用 115200 UART 发 15 字节头加镜像,板端做 CRC32、写元数据、跳转到 App;镜像坏了就把旧槽拉起来。

已验证上板 · 2026-11-21 CVE2 · 50 MHz · RV32IM GD25Q128E · 16 MiB 64 KiB 统一 RAM 09 / 12
7,192 B
Bootloader 二进制,装在 16 KiB 指令区
1,021 B
App A / App B,UART 单帧 1,036 B
2 × 512 KiB
A/B Flash 槽;元数据 2 × 4 KiB
336 B × 2
两次独立冷启动日志,逐字节一致
0 次复位
force 坏 CRC 后直接回退 B,不重启
0x00c84018
GD25Q128E JEDEC ID,SPI 6.25 MHz
+0.735 / +0.054 ns
WNS / WHS,0 failing,11,147 endpoints
4,261 LUT / 16 BRAM
20.49% LUT,32% BRAM,DRC 0 error
EP08 不是这次重启循环的原因。 EP08 只做 DDR3 与 BRAM 的带宽/延迟对比,不擦写板载 Flash,也不改启动路径;EP09 重新配置后 EP08 的逻辑已经被覆盖。问题全部在 EP09 自身:首版打包了旧 firmware.hex,指令 RAM 和数据 RAM 是两块独立 simple_ram,loader 收到非 P 字节后返回 main() 并置 WDT,约 500 ms 复位,形成约 1 秒的循环。

上板结果:A → B → 坏 CRC → 两次冷启动 → 恢复 A

测试顺序按“先证明能写、再证明能切、再证明坏了能退、最后证明断电后仍然能退”组织。A/B 写入和 force 回退都在同一次上电内完成;两次冷启动不接主机加载器,完全由板端自己选槽。

步骤元数据 seq写入/结果启动结果
A 槽好镜像11,021 B,CRC a8a0cdcdLOAD_PASS → EP09 APP A + 5 次心跳
B 槽好镜像21,021 B,CRC 0a74fc2cLOAD_PASS → EP09 APP B + 5 次心跳
force 写 A(坏 CRC)3广告 CRC 575f3232,实际 a8a0cdcdA LOAD_FAIL → FALLBACK → B LOAD_PASS
冷启动 run 1 / run 23各 336 B,cmp 无差异A FAIL → B PASS,EP09 APP B + 5 次心跳
恢复 A 好镜像41,021 B,CRC a8a0cdcdLOAD_PASS → EP09 APP A + 5 次心跳
最终冷启动4268 BA 直接 LOAD_PASS,无 FALLBACK

上表里的 seq 是元数据记录序号,不是 App banner 里的版本字符串。App A 的 banner 固定打印 VER=00000001,实际 A4 元数据版本是 4;排障时以 LOAD SLOT / META_PASS 行为准。

关键串口证据

下面只摘关键行,完整日志在文件区。A 槽写入后直接 LOAD_PASS,没有再次复位;B 槽切换同理。

# A 槽
EP09 FLASH BOOTLOADER
FLASH ID=00c84018 OK
PRESS L FOR LOADER (3s)...
LOADER READY
RECV SLOT=A LEN=1021...
RX_CRC=a8a0cdcd EXPECT=a8a0cdcd
PROGRAM_PASS
META_PASS SEQ=1 ACTIVE=A
LOAD SLOT=A LEN=1021 VER=00000001 CRC=a8a0cdcd LOAD_PASS
EP09 APP A VER=00000001 RUNNING

# B 槽
RECV SLOT=B LEN=1021...
RX_CRC=0a74fc2c EXPECT=0a74fc2c
PROGRAM_PASS
META_PASS SEQ=2 ACTIVE=B
LOAD SLOT=B LEN=1021 VER=00000002 CRC=0a74fc2c LOAD_PASS
EP09 APP B VER=00000002 RUNNING
# force 写 A:广告 CRC 是坏的,数据本身仍是好镜像
FRAME slot=0 force=1 len=1021 crc=575f3232 ver=3
RX_CRC=a8a0cdcd EXPECT=575f3232
PROGRAM_PASS
META_PASS SEQ=3 ACTIVE=A
LOAD SLOT=A LEN=1021 VER=00000003 CRC=a8a0cdcd LOAD_FAIL
SWITCH_FAIL
LOAD SLOT=A LEN=1021 VER=00000003 CRC=a8a0cdcd LOAD_FAIL
FALLBACK
LOAD SLOT=B LEN=1021 VER=00000002 CRC=0a74fc2c LOAD_PASS
EP09 APP B VER=00000002 RUNNING

两次独立冷启动的日志都是 336 B,逐字节一致:先选 A(seq 3,CRC 坏),LOAD_FAIL,FALLBACK,再选 B(seq 2,CRC 好),LOAD_PASS,跑 5 次心跳。最终恢复 A4 后的冷启动是 268 B,直接选 A,没有 FALLBACK。

为什么首版会 1 秒重启

首版上板只看到反复的 EP09 FLASH BOOTLOADER / FLASH ID=00c84018 OK / PRESS L FO...,约 1 秒一轮。根因不是单个,而是四处叠在一起:

  1. bitstream 打包了旧 hex。 build_ep09.tcl 原来只读现成 firmware.hex,不先编译固件;首版板上没有当前 main.c 必然打印的 NO_VALID_META / LOADER READY。
  2. 指令和数据不在同一块 RAM。 Bootloader 把 App 写到数据 RAM 的 0x4000,指令 RAM 看不到;跳过去仍然读到旧内容。
  3. loader 返回后退回 main。 loader() 收到非 P 字节就 return,main() 调 reboot() 置 WDT,500 ms 复位,形成循环。
  4. Vivado 环境里的 Python 不是系统 python3。 Makefile 的 PYTHON ?= python3 继承了 Vivado 的 Python 目录,bin2hex.py 执行失败。
  5. force 模式写的是坏数据。 原来的 force 会翻转 payload,无法验证“数据好、只有 CRC 坏”的回退。
  6. 测试工具两个坑。 裸 python3 cap_serial.py ... & 被 SSH 会话回收;1,021 B 一次性打进 115200 UART 会把板端 FIFO 撑爆,日志停在 RECV SLOT=A LEN=1021...。

修复后的结构是:一块 64 KiB dpram_64k(Port A 指令只读,Port B 数据读写,16 块 BRAM),bin2hex.py 固定 16,384 words 并用 NOP 填充,build_ep09.tcl 强制 make clean all 并检查 bitstream mtime 不早于 hex;Bootloader 改成无限帧循环、写成功直接 load_and_jump、坏 CRC 时 boot() 回退旧槽,主流程不再实际调用 reboot()。

Flash 与 RAM 地址

配置区 0x000000..0xBFFFFF 没有动;A/B 槽各 512 KiB,但 App 运行时受 64 KiB RAM 限制,镜像上限 48 KiB。元数据两个 4 KiB 扇区交替写,按 seq 选新。

区域地址大小用途
配置区0x00000000..0x00BFFFFF12 MiBFPGA bitstream / 出厂区,未触碰
Slot A0x00C00000..0x00C7FFFF512 KiBApp A
Slot B0x00C80000..0x00CFFFFF512 KiBApp B
META_A0x00D00000..0x00D00FFF4 KiB元数据扇区 A
META_B0x00D01000..0x00D01FFF4 KiB元数据扇区 B
Bootloader0x0000..0x3FFF16 KiB栈顶 0x4000
App0x4000..0xFFFF48 KiB栈顶 0x10000

Slot 的 512 KiB 是 Flash 容量;当前 App 只有 1,021 B。大镜像的擦除/写入时间没有在本轮测量。

启动流程与 UART 帧

PC / UART115200 8N1
15 B header + payload
→
Bootloader3 s window
CRC32 + metadata
→
Slot A / B512 KiB each
GD25Q128E
→
App0x4000..0xFFFF
jump, no reset

帧头 15 B,小端:'P' | slot | force | len(u32) | crc32(u32) | version(u32),后面跟 payload。CRC 是标准 CRC-32 / zlib(多项式 0xEDB88320)。force=1 只用于测试:数据照写,CRC 故意不匹配,让下一次跳转失败。

元数据记录 32 B:magic、seq、slot、len、crc、version、attempts、rec_crc;magic 是 0x45503952,rec_crc 覆盖前 28 B。启动时选 seq 大的记录;如果镜像 CRC 不过,boot() 再试另一条记录。

main()
  banner + flash ID
  3 s window: 'L' -> loader
  boot(): read meta A/B -> load newest -> CRC -> jump
  loader(): LOADER READY -> wait forever
            bad frame / bad CRC / program fail / meta fail -> continue
            good frame -> write slot -> write meta -> load_and_jump
            switch fail -> boot() older slot, no chip reset

时序、资源与 DRC

0.735 ns
WNS,11,147 endpoints,0 failing
0.054 ns
WHS,TNS/THS 均为 0
20.49%
LUT 4,261;FF 3,720(8.94%)
16 / 50
BRAM 32%;DSP 11(12.22%)

最终 routed 报告是 08:13:41,对应 08:14:13 的 bitstream。DRC 0 error / 76 warning / 0 critical warning:DPIP 33、DPOP 12、REQP-1839 21、其余 10。REQP-1839 是 CVE2 寄存器堆的异步复位驱动 BRAM 地址脚;复位只在配置期有效,作为边界记录,不隐藏。

边界与未验证项

复现

# Vivado 2025.2, xc7a35t-2fgg484
vivado -mode batch -source build_ep09.tcl
vivado -mode batch -source program_ep09.tcl

# firmware
cd sw && make clean all
cd sw/app && make clean all

# host loader: bin slot force version log
python3 host_flash_loader.py sw/app/firmware_a.bin 0 0 1 /tmp/loadA.log
python3 host_flash_loader.py sw/app/firmware_b.bin 1 0 2 /tmp/loadB.log
python3 host_flash_loader.py sw/app/firmware_a.bin 0 1 3 /tmp/loadF.log

# capture a cold boot
python3 cap_serial.py 8 /tmp/cold.bin

bitstream 通过 dpram_64k 的 INIT_FILE 打包 sw/firmware.hex,改 Bootloader 必须重综合;App A/B 走 UART,不需要重综合。编程脚本必须用绝对路径 -source,相对路径在 SSH 复合命令里曾报 couldn't read file。

相关

证据文件

53 个文件,约 3.3 MB:bitstream、routed 报告、综合/实现/编程日志、UART 原始抓包、RTL/XDC/Tcl、Bootloader 与 App 源码/ELF/HEX/反汇编、主机工具、引脚表和修复记录。

README.txt证据包说明 · 7 KB metrics/ep09_metrics.json结构化指标 · 5 KB bit/top_cve2_ep09.bit最终 bitstream · 2.2 MB reports/ep09_timing_final.rptRouted 时序报告 · 405 KB reports/ep09_util_final.rpt资源利用率报告 · 11 KB reports/ep09_drc_final.rptDRC 报告 · 39 KB logs/build_ep09.logVivado 构建日志 · 158 KB logs/impl_ep09.log实现日志 · 50 KB logs/make_ep09.log固件 make 日志 · 725 B logs/program_final_boot.log最终编程日志 · 3 KB logs/program_force_a.logforce 编程日志 · 3 KB logs/program_restore_a.log恢复 A 编程日志 · 3 KB logs/program_slot_a.logA 槽编程日志 · 3 KB logs/program_slot_b.logB 槽编程日志 · 3 KB logs/synth_ep09.log综合日志 · 87 KB logs/uart_ep09_boot_probe.txt首次 boot 抓包 · 75 B logs/uart_ep09_cold_fallback_run1.txt冷启动回退 1 · 336 B logs/uart_ep09_cold_fallback_run2.txt冷启动回退 2 · 336 B logs/uart_ep09_final_boot_a.txt最终 A 直启 · 268 B logs/uart_ep09_force_fallback.txtforce 坏 CRC 回退 · 598 B logs/uart_ep09_restore_a.txt恢复 A UART · 459 B logs/uart_ep09_slot_a.txtA 槽 UART · 459 B logs/uart_ep09_slot_b.txtB 槽 UART · 459 B rtl/top_cve2_ep09.sv顶层 RTL · 49 KB xdc/pi_ar035_f1_1_cve2_ep09.xdc引脚约束 · 3 KB tcl/build_ep09.tcl构建脚本 · 3 KB tcl/program_ep09.tcl编程脚本 · 540 B tcl/report_drc_ep09.tclDRC 脚本 · 173 B tcl/report_ep09.tcl报告脚本 · 322 B sw/bin2hex.pyHEX 生成器 · 584 B sw/firmware.binBootloader 二进制 · 7 KB sw/firmware.disBootloader 反汇编 · 74 KB sw/firmware.elfBootloader ELF · 13 KB sw/firmware.hex16,384-word HEX · 147 KB sw/link.ldBootloader 链接脚本 · 553 B sw/main.cBootloader 主程序 · 11 KB sw/MakefileBootloader 构建 · 662 B sw/start.SBootloader 启动 · 983 B app/app.ldApp 链接脚本 · 553 B app/firmware_a.binApp A 二进制 · 1 KB app/firmware_a.disApp A 反汇编 · 6 KB app/firmware_a.elfApp A ELF · 6 KB app/firmware_b.binApp B 二进制 · 1 KB app/firmware_b.disApp B 反汇编 · 6 KB app/firmware_b.elfApp B ELF · 6 KB app/main.cApp 主程序 · 1 KB app/MakefileApp 构建 · 795 B app/start.SApp 启动 · 603 B tools/cap_serial.py串口抓包 · 814 B tools/host_flash_loader.py主机加载器 · 3 KB pins/board_pins.csv板级引脚表 · 578 B EP09_修复记录.md根因与修复记录 · 5 KB SHA256SUMS.txt全包 SHA-256 · 5 KB