# EP09 启动问题修复记录

日期：2026-11-21

## 结论

首次上板的重启循环不是 EP08 造成的。EP08 只做 DDR3/BRAM，不擦写板载 Flash，也不改启动路径；EP09 重新配置后 EP08 逻辑已被覆盖。

根因集中在 EP09 自身：

1. 首版 bitstream 打包了旧的 `sw/firmware.hex`。`build_ep09.tcl` 只读取现成 hex，不会先编译固件；板上日志没有 `NO_VALID_META` / `LOADER READY`，与当前 `main.c` 不一致。
2. 指令 RAM 与数据 RAM 是两块独立 `simple_ram`。Bootloader 把 App 写到 `0x4000` 的数据 RAM，指令 RAM 看不到，A/B App 即使写入也无法执行。
3. `loader()` 收到非 `P` 字节后 `return`，`main()` 随后调用 `reboot()` 置 WDT；500 ms 后复位，形成约 1 秒一次的循环。
4. `build_ep09.tcl` 在 Vivado 环境里执行 `make` 时，Makefile 的 `PYTHON ?= python3` 继承了 Vivado 的 python 路径，导致 `bin2hex.py` 无法执行。
5. `host_flash_loader.py` 的 force 模式翻转了 payload 字节，而不是只伪造 CRC；这样写入的是坏镜像，无法验证“CRC 失败后回退到旧槽”。
6. `top_cve2_ep09.sv` 中 `i2c_scl_d` 在两个 always 块里重复驱动，产生 CRITICAL WARNING。

## 已修改

- `rtl/top_cve2_ep09.sv`
  - 用 `dpram_64k` 替换 `u_imem` + `u_dmem`，64 KiB 单块真双端口 RAM；指令口只读，数据口读写。
  - 初始化先填 NOP，再 `$readmemh` 覆盖 Bootloader；未加载的 App 区不会变成非法指令。
  - `i2c_scl_d` 调试计数改名为 `i2c_scl_dbg_d`，消除重复驱动。
- `sw/main.c`
  - Bootloader 等待窗口从 1 s 延长到 3 s。
  - `loader()` 改为无限帧循环：非 `P`、坏帧、CRC 失败、编程失败、元数据失败都回到等待，不再 `return` 触发复位。
  - 编程成功后不再置 WDT 复位，而是重新校验并直接跳到新 App；强制 CRC 失败时调用 `boot()` 走旧槽回退，全过程不需要芯片复位。
  - 删除主流程中所有实际执行的 `reboot()` 调用。
- `sw/bin2hex.py`
  - `RAM_WORDS` 从 4,096 改为 16,384；尾部填充 `0x00000013`（NOP）。
- `sw/Makefile`
  - `PYTHON := python3`，避免继承 Vivado 的 `PYTHON` 环境变量。
- `build_ep09.tcl`
  - 综合前强制执行 `make -C sw clean all` 和 `make -C sw/app clean all`。
  - 生成 bitstream 后检查其 mtime 不早于 `firmware.hex`，防止旧 hex 被打包。
- `host_flash_loader.py`
  - force 模式改为“payload 不变、CRC 取反”，用于验证回退。
  - 同时等待 `PRESS L` 或 `LOADER READY`，避免错过 3 s 窗口。
  - 升级后等待 `EP09 APP`，不再等待复位。

## 构建结果与上板验证（2026-11-21）

- Bootloader：`sw/firmware.bin` 7,192 B，SHA-256 `c5d90cc072a1fbef1054c98c104aa90147feb5c6b4f740d6a6e2e0ed65649ba8`
- `firmware.hex`：16,384 words / 65,536 B，SHA-256 `dfcaaa3f06635da2529d72575329c6782b1a8c4428c2dd460f9a24a5af4dac3d`
- App A：`sw/app/firmware_a.bin` 1,021 B，SHA-256 `c1457fe560a88b461c96d4e39eeacd125050b71972ec1a9c9660d6da6aebbfba`
- App B：`sw/app/firmware_b.bin` 1,021 B，SHA-256 `5246f22c2cee1eac9ab293ae3ef89493d9796bcbf94f8dbc9e3c971d6f887dbc`
- Bitstream：2,192,137 B，SHA-256 `bbb72e23488fa636e9b1f8c0e4012b7a01b98dbdecdf493ccc7a73442bbca665`
- 时序：WNS 0.735 ns，WHS 0.054 ns，TNS/THS 0，0 failing，11,147 endpoints
- 资源：LUT 4,261（20.49%），FF 3,720（8.94%），BRAM 16/50（32%），DSP 11，IOB 25
- DRC：0 error，76 warning，0 critical warning（DPIP 33、DPOP 12、REQP-1839 21、其余 10；REQP-1839 的异步复位只在配置期有效）

### 上板结果

1. 编程后首次启动：`EP09 FLASH BOOTLOADER`、`FLASH ID=00c84018 OK`、`PRESS L FOR LOADER (3s)...`，3 s 后进入 `NO_VALID_META` / `LOADER READY`；没有再出现约 1 秒一次的复位循环。
2. A 槽：`RECV SLOT=A` → `RX_CRC=a8a0cdcd EXPECT=a8a0cdcd` → `PROGRAM_PASS` → `META_PASS SEQ=1 ACTIVE=A` → `LOAD SLOT=A ... LOAD_PASS` → `EP09 APP A` + 5 次心跳。
3. B 槽：`META_PASS SEQ=2 ACTIVE=B` → `LOAD SLOT=B ... LOAD_PASS` → `EP09 APP B` + 5 次心跳。
4. force 坏 CRC：`RX_CRC=a8a0cdcd EXPECT=575f3232` 仍 `PROGRAM_PASS`，元数据 `SEQ=3 ACTIVE=A`；跳转时 `LOAD_FAIL` → `SWITCH_FAIL` → `FALLBACK` → B 槽 `LOAD_PASS` → `EP09 APP B`。全程没有芯片复位。
5. 两次独立冷启动（不接主机加载器）：各 336 B，`cmp` 逐字节一致；均为 A 槽 `LOAD_FAIL` → `FALLBACK` → B 槽 `LOAD_PASS` → `EP09 APP B` + 5 次心跳。
6. 恢复 A 好镜像：`META_PASS SEQ=4 ACTIVE=A` → `LOAD_PASS`；最终冷启动 268 B，直接 `LOAD SLOT=A ... LOAD_PASS` → `EP09 APP A` + 5 次心跳，无 `FALLBACK`。

### 验证过程中的工具修正

- `host_flash_loader.py` 的 boot 等待从 30 s 放宽到 60 s，并以 `EP09 FLASH BOOTLOADER` 作为“新启动”分界，避免把上一轮残留的 `LOADER READY` 当成新 boot。
- 发送端改为 32 B 分块、块间 3 ms，避免 115200 UART FIFO 在 1 KiB 连续写入时溢出，导致 bootloader 卡在 payload 接收。
- App A 的 banner 仍是编译期字符串 `VER=00000001`，实际元数据版本为 4；页面和证据以 `LOAD SLOT` / `META_PASS` 行为准。

结论：EP09 验证范围“Bootloader + UART 加载 + A/B 切换 + 坏 CRC 回退”已通过，系列进度 9 / 12。

