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

从识别机制到自建通用烧录器的六条路径 · 编制日 2026-08-29 ｜ 编制日期 2026-10-14 ｜ 版本号 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 字节地址等配置位）。