SPI NOR Flash 烧录「找不到型号」解决方案

从识别机制到自建通用烧录器的六条路径 · 编制日 2026-08-29 ｜ 编制日期 2026-09-21 ｜ 版本号 Rev 1.0

1. 问题本质：编程器到底在认什么

把「认型号」还原成「查参数表」，问题就从「库里没有这个名」变成了「我能不能自己给出这组参数」。这一章是后面所有路径的共同基础。

1.1 型号库只是一张 ID → 参数的映射表

编程器软件里那个几万条的器件列表，本质是一张二维表：左边是 JEDEC ID，右边挂着这颗芯片的操作参数与时序。选中型号，软件只是把右边那组参数读出来，按它去发 SPI 命令。型号字符串本身不参与通信。所以「找不到型号」的真实含义是：软件手里没有一个已知 ID 能对上这颗芯片，因此没人告诉它该发什么命令。

1.2 编程器真正需要的那组参数

无论哪条路径，最终都要落到下面 8 项。做兼容替换或手填参数时，就是逐项确认这 8 项。

说明：上表为通用 NOR 的通行约定，具体以器件 datasheet 为准；命令码见附录 A。

1.3 JEDEC ID：三字节里装了什么

主机发 0x9F（RDID）后，芯片回 3 字节：厂商 ID + 存储器类型 + 容量码。这是所有编程器识别的起点，也是手工建型号时必须填准的字段。

1.4 SFDP：芯片自己带的一张参数表

JEDEC 的 JESD216 标准规定：现代 SPI NOR 内部固化了一张只读参数表，叫 SFDP（Serial Flash Discoverable Parameters），用命令 0x5A 读取（3 字节地址 + 8 个 dummy 时钟，之后连续读出）。芯片出厂时就把容量、页大小、支持哪几种擦除命令、每种擦多大写在这张表里了。

这是最理想的情况：参数由芯片自报，主机压根不需要认识这颗料。flashrom、NXP LinkServer 的通用 flash 驱动、RT-Thread 的 SFUD 走的都是这条路。

1.5 找不到型号的四种真实原因

2. 六条解决路径总览

按「多久能出片」排序。前两条通常当天就能解决，第三条是原理上最干净的，第四条绕过编程器，第五条是长期兜底，第六条是彻底但慢。

3. 路径一：同参数兼容型号顶替

成本最低、见效最快。核心动作是「比对」而不是「猜」——逐项核对 5 组关键参数，确认无误后用库里已有的型号名去烧。

3.1 五组必查参数与容忍度

下表是判定「能不能顶替」的依据。左列任一项不满足，就不许顶替；右列不满足，必须回到 datasheet 确认或换路径。

3.2 找基准型号的实操顺序

1. 先认厂：读 0x9F 拿厂商 ID，对照附录 B 确定原厂。同厂同系列优先，跨厂次之。
2. 再定容量：按容量码或印字确定密度，在库里筛出同容量的一批候选。
3. 查代次：同容量下优先选同一代工艺的型号（如 GD25QxxE 对 GD25QxxE，不要拿老 GD25Qxx 的算法去烧新 E 代）。
4. 比对命令集：打开两份 datasheet 的 Instruction Set 表，逐行核 0x20/0x52/0xD8/0x02/0x03/0x0B/0x05/0x01/0x06。
5. 建条目并小范围试：不要一上来就整片擦写。先读回原片存档，再只擦一个扇区、写几十字节、读回比对。
6. 通过后放量：小范围验证 OK 后，再整片烧录并做全片校验。

3.3 闭环验证：五个动作缺一不可

4. 路径二：手动建型号（主流编程器实操）

库里没有，就自己补一条。原理统一：ID 用真值（让软件认得这颗料），算法挂靠一颗参数相同的已知型号（让软件知道怎么操作）。

4.1 RT809H / RT809F：编辑 DEVICE.INI

RT809 系列一直支持用户自行扩充器件库。安装目录下找到 DEVICE.INI（默认 D:\RT809H\DEVICE.INI），按 [ChipN] 的编号逐个递增追加条目，序号不能与已有条目重复，否则无效。

完整示例：给一颗 1.8V 的 16MB 国产料建条目

; —— 追加在 DEVICE.INI 末尾，序号接在最后一个 [ChipN] 之后 ——
[Chip1]
User = YourName
ManuName = XTX
ChipName = XT25F128B
ChipSize = 16384
ChipID   = 0x0B4018
AlgoRef  = W25Q128JV
PinVal   =
VCC      = 1.8
VPP      =
VCCIO    = 1.8
TSCE     =
TPROG    =

4.2 XGecu（T48 / T56 / T76）：用型号支持列表先确认

XGecu 各机型的器件支持列表是公开的，遇到问题先在官方列表里核对一次，确认是不是真的没有——很多时候只是丝印与列表里的正式型号写法不同导致的误判。

4.3 CH341A 系（AsProgrammer / NeoProgrammer）

这两个是 CH341A 编程器最常用的上位机，都允许往芯片库里加条目。做法一致：找到安装目录下的芯片定义文件（按软件版本不同，可能是 XML 或文本格式的库文件，具体以该版本 README 为准），照着同厂同容量的一条复制，改掉这几个关键字段即可。

4.4 flashrom：往 flashchips.c 加一条

如果走 P5 自建烧录器（用 flashrom），加型号是改源码里的 flashchips.c，在对应厂商段追加一条结构体。字段含义如下，照抄一条最接近的再改关键项即可。

{
    .vendor         = "XTX",
    .name           = "XT25F128B",
    .bustype        = BUS_SPI,
    .manufacture_id = 0x0B,          /* 厂商 ID：0x9F 第 1 字节 */
    .model_id       = 0x4018,        /* 类型+容量：第 2、3 字节 */
    .total_size     = 16384,         /* 容量，单位 kB → 16MB */
    .page_size      = 256,
    .feature_bits   = FEATURE_WRSR_WREN,
    .tested         = TEST_UNTESTED,
    .probe          = PROBE_SPI_RDID,
    .probe_timing   = TIMING_ZERO,
    .block_erasers  = {
        {
            .eraseblocks = { {4 * 1024, 4096} },          /* 4096 个 4KB 扇区 */
            .block_erase = SPI_BLOCK_ERASE_20,            /* 命令 0x20 */
        }, {
            .eraseblocks = { {64 * 1024, 256} },          /* 256 个 64KB 块   */
            .block_erase = SPI_BLOCK_ERASE_D8,            /* 命令 0xD8       */
        }, {
            .eraseblocks = { {16 * 1024 * 1024, 1} },     /* 整片             */
            .block_erase = SPI_BLOCK_ERASE_60,
        }
    },
    .printlock      = SPI_PRETTYPRINT_STATUS_REGISTER_PLAIN,
    .unlock         = SPI_DISABLE_BLOCKPROTECT,           /* 写前自动解保护 */
    .write          = SPI_CHIP_WRITE256,                  /* 256B 页编程    */
    .read           = SPI_CHIP_READ,
    .voltage        = {1650, 2000},                       /* 1.8V 器件！    */
},

4.5 嵌入式侧：SFUD 加一条

如果目标是让设备自己的 MCU 驱动这颗 flash（而不是用编程器烧），RT-Thread 的 SFUD（Serial Flash Universal Driver）在 sfud_flash_def.h 里维护了一张静态表，不支持 SFDP 的老芯片靠它兜底。加一条的字段格式：

/* {"型号名", 厂商ID, 类型ID, 容量ID, 容量(字节), 写模式, 擦除粒度, 擦除命令} */
{"XT25F128B", 0x0B, 0x40, 0x18, 16L*1024L*1024L, SFUD_WM_PAGE_256B, 4096, 0x20},

SFUD 的识别是三级回退：先 SFDP → 再查静态表 → 最后用手动写死的参数。三条路都失败才初始化失败。所以给 SFUD 加条目的唯一场景是「既没有 SFDP、表里又没有」的老料。

4.6 建完怎么验：先小后大

1. 重启软件，搜索自定义型号名，确认能出现在列表里且 ID 显示为你填的值。
2. 先只读不写：整片读回存档。读不出来说明 ID 或接触有问题，别往下走。
3. 单扇区试擦：只擦一个 4KB 扇区，读回确认该扇区变全 FF、其余区域未受影响。
4. 小数据试写：往刚擦的扇区写几十字节，读回比对。
5. 全片烧录 + 校验：通过后整片写入并自动校验，确认出现 VERIFIED。
6. 装机实跑：焊回目标板上电，确认能正常启动（验证 QE 位、4 字节地址等配置位）。

5. 路径三：SFDP 自动识别（首选方案）

如果这颗芯片支持 SFDP，前面所有「找替代型号、改配置文件」的功夫都可以省掉——参数由芯片自己报出来，工具照单执行即可。

5.1 怎么判断它支不支持

5.2 SFDP 里到底装了什么

来源：JEDEC JESD216

最核心的是 Basic Flash Parameter Table（ID 0xFF00，必需），它给出容量、页大小、支持哪几种擦除命令及各自粒度、dummy 周期、地址字节数。可选的 Sector Map 描述非均匀扇区，4-Byte Address Instruction Table 给大容量器件进入 4 字节地址模式所需的命令集。

5.3 flashrom 实操：从输出到可用

下面是 flashrom 探测一颗未被收录芯片时的真实输出形态（以 XT25F128B 为例，日志已精简）。重点看它自动解析出了什么：

$ flashrom -p ch341a_spi -VV
Probing for Unknown SFDP-capable chip, 0 kB:
  SFDP revision = 1.0
  SFDP number of parameter headers is 2 (NPH = 1).
  SFDP parameter table header 0/1:
    ID 0x00, version 1.0  Length 36 B, Parameter Table Pointer 0x000030
  Parsing JEDEC flash parameter table...
    3-Byte only addressing.
    Write chunk size is at least 64 B.
    Flash chip size is 16384 kB.
    Block eraser 0: 4096 x 4096 B with opcode 0x20
    Block eraser 1:  512 x 32768 B with opcode 0x52
    Block eraser 2:  256 x 65536 B with opcode 0xd8
  done.
=== SFDP has autodetected a flash chip which is not natively supported by
    flashrom yet. All standard operations (read, verify, erase and write)
    should work, but to support all possible features we need to add them
    manually. ===
Found Unknown flash chip "SFDP-capable chip" (16384 kB, SPI) on ch341a_spi.

常用命令速查

# 探测（不操作，看能不能认出来）
flashrom -p ch341a_spi

# 列出工具支持的所有芯片（找替代型号时用）
flashrom -L

# 强制指定用哪个型号条目去操作
flashrom -p ch341a_spi -c "W25Q128.V" -r backup.bin
flashrom -p ch341a_spi -c "SFDP-capable chip" -w firmware.bin

# 完整流程：先备份 → 擦 → 写（flashrom 写入时自带擦除与校验）
flashrom -p ch341a_spi -r backup.bin          # 备份，永远第一步
flashrom -p ch341a_spi -E                     # 整片擦除
flashrom -p ch341a_spi -w firmware.bin        # 写入（自动含校验）
flashrom -p ch341a_spi -v firmware.bin        # 单独再校验一次

5.4 SFDP 的能力边界（它不告诉你什么）