Skip to content

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。先关闭占用功能,再连接。

识别芯片与候选型号 ​

  1. 点击连接,建立 serprog 会话。
  2. 型号框留空,点击「识别芯片」。
  3. 核对候选型号、容量及日志;多个匹配时输入与实物一致的完整型号重新识别。
  4. 未识别通过 Toast 提示;链路中断则先断开/重连后识别。

匹配项不是让用户随意选择相似容量的芯片;同容量器件的指令、保护、擦写粒度和地址模式可以不同。不能为了消除提示而强行选择不匹配型号。

推荐流程:读、备份、写、校验 ​

读取备份 ​

识别成功后点击「读取备份」,等待完成并将镜像保存到电脑。重要数据可再读一遍比较两次文件;出现不同内容时先解决供电和通信问题。

校验现有内容 ​

选择文件后使用「校验」比对当前芯片与文件内容,这不同于编程。当前全镜像流程要求文件大小与芯片容量一致,例如 16 MiB 芯片对应 16,777,216 字节镜像。

写入并校验 ​

选择已确认适配的全镜像,点击「写入并校验」,阅读页面对话框后执行。流程可能先读取旧内容,比较差异,按驱动要求擦除/写入,最后校验;并非每次操作都花相同时间。

文件大小相同只说明长度满足要求,不说明内容适配。没有独立布局参数的操作会按整个芯片镜像处理。

擦除按钮与整片擦除 ​

底部擦除按钮带下拉菜单,可选择「整片擦除」。它表示擦除整个芯片,不是选中一个文件大小的范围。底层如何实现由芯片驱动与当前算法决定,可能涉及整片指令或相应擦除策略。

整片擦除时,芯片内部忙期间没有可靠逐字节进度。页面用等待动画和耗时说明此阶段,不应把停在某个百分比当作已经死锁,也不伪造线性擦除进度。等待超过合理时间再结合日志判断。

进度、速度和日志 ​

页面显示当前读/校验、写或擦除阶段,字节数、耗时和可计算的 KB/s。阶段变化时百分比和速度可重新计数;阶段平均速度不等于 SPI 时钟频率,也不等于整次操作的纯写入速度。

常见约 256 字节的写数据对应芯片页编程约束,不能为了扩大网络包而跨页破坏内容。优化传输与芯片编程粒度是两回事。

停止与异常恢复 ​

正在操作时使用「停止」,等待当前流程结束。已经擦除/写入的数据不会回滚。停止后重新连接、识别,并重新读取/校验,再决定是否重写;不要将中止当成“芯片恢复原样”。

现象处理方向
未识别 / 多个候选电压、CS/MISO、降频、核对实物型号
连接中断 / 无法同步释放共用引脚,重连,确认 serprog 固件路径
读取正常但写失败保护位、器件支持、供电、实际型号与日志
校验失败先保留日志,降频重复读取比较;不要无限自动重写
擦除长期等待区分芯片内部忙和连接故障,查看日志而非只看百分比

API 与帮助 ​

FlashRom 当前没有同 I2C 一样的独立问号帮助;本页按实际控件整理。自动化见 SDK 的 FlashRom 示例。SDK/网页使用 WASM 芯片库,MCP 当前注册表没有 flashrom.* 专用工具。