FlashRom:SPI Flash 识别、备份与编程
FlashRom 芯片库以 WebAssembly 在浏览器运行,通过板端 WebSocket serprog 访问受支持的 SPI Flash。它不依赖本地桥接进程,也不要求电脑运行一个原生 flashrom 命令行服务。
适用任务与区别
| 任务 | 入口 |
|---|---|
| SPI NOR 全镜像备份、写入、校验、擦除 | 本页 FlashRom |
| 手工输入 SPI 指令或侦听 | SPI 助手 |
| MCU 内部 Flash / FLM 算法 | 离线烧录 |
| 现场不打开浏览器烧录 MCU | 板上 Offline Flash |
不要把 SPI NOR 的全镜像文件、MCU 应用 BIN 和 FLM 算法容器混用。
接线与连接参数
GPIO8=MISO、GPIO9=CS、GPIO10=CLK、GPIO11=MOSI,另接 GND。目标按实际芯片电压供电;电路内夹取时还需确认原板没有其他主机或电源在驱动总线。
频率输入单位是 kHz,范围 1–25000,默认 20000,即 20 MHz。连接后参数锁定,需断开再修改。高频不保证更快或更可靠,遇到识别不稳定先降速并检查信号,而不是反复尝试写入。
FlashRom、SPI 和 JTAG 等共用 GPIO8–11。先关闭占用功能,再连接。
识别芯片与候选型号
- 点击连接,建立 serprog 会话。
- 型号框留空,点击「识别芯片」。
- 核对候选型号、容量及日志;多个匹配时输入与实物一致的完整型号重新识别。
- 未识别通过 Toast 提示;链路中断则先断开/重连后识别。
匹配项不是让用户随意选择相似容量的芯片;同容量器件的指令、保护、擦写粒度和地址模式可以不同。不能为了消除提示而强行选择不匹配型号。
推荐流程:读、备份、写、校验
读取备份
识别成功后点击「读取备份」,等待完成并将镜像保存到电脑。重要数据可再读一遍比较两次文件;出现不同内容时先解决供电和通信问题。
校验现有内容
选择文件后使用「校验」比对当前芯片与文件内容,这不同于编程。当前全镜像流程要求文件大小与芯片容量一致,例如 16 MiB 芯片对应 16,777,216 字节镜像。
写入并校验
选择已确认适配的全镜像,点击「写入并校验」,阅读页面对话框后执行。流程可能先读取旧内容,比较差异,按驱动要求擦除/写入,最后校验;并非每次操作都花相同时间。
文件大小相同只说明长度满足要求,不说明内容适配。没有独立布局参数的操作会按整个芯片镜像处理。
擦除按钮与整片擦除
底部擦除按钮带下拉菜单,可选择「整片擦除」。它表示擦除整个芯片,不是选中一个文件大小的范围。底层如何实现由芯片驱动与当前算法决定,可能涉及整片指令或相应擦除策略。
整片擦除时,芯片内部忙期间没有可靠逐字节进度。页面用等待动画和耗时说明此阶段,不应把停在某个百分比当作已经死锁,也不伪造线性擦除进度。等待超过合理时间再结合日志判断。
进度、速度和日志
页面显示当前读/校验、写或擦除阶段,字节数、耗时和可计算的 KB/s。阶段变化时百分比和速度可重新计数;阶段平均速度不等于 SPI 时钟频率,也不等于整次操作的纯写入速度。
常见约 256 字节的写数据对应芯片页编程约束,不能为了扩大网络包而跨页破坏内容。优化传输与芯片编程粒度是两回事。
停止与异常恢复
正在操作时使用「停止」,等待当前流程结束。已经擦除/写入的数据不会回滚。停止后重新连接、识别,并重新读取/校验,再决定是否重写;不要将中止当成“芯片恢复原样”。
| 现象 | 处理方向 |
|---|---|
| 未识别 / 多个候选 | 电压、CS/MISO、降频、核对实物型号 |
| 连接中断 / 无法同步 | 释放共用引脚,重连,确认 serprog 固件路径 |
| 读取正常但写失败 | 保护位、器件支持、供电、实际型号与日志 |
| 校验失败 | 先保留日志,降频重复读取比较;不要无限自动重写 |
| 擦除长期等待 | 区分芯片内部忙和连接故障,查看日志而非只看百分比 |
API 与帮助
FlashRom 当前没有同 I2C 一样的独立问号帮助;本页按实际控件整理。自动化见 SDK 的 FlashRom 示例。SDK/网页使用 WASM 芯片库,MCP 当前注册表没有 flashrom.* 专用工具。