能读 ID 但读写失败 · 样机排查手册

编制日期 2026-09-21 ｜ 版本号 Rev 1.0

XTX 芯天下 · FAE 现场技术文档 ｜ 样机阶段 ID 读得到但 Read / Program / Erase 失败（SPI NOR / SPI NAND / SD NAND / eMMC）｜ 2026-09 版

一句话结论：能读 ID 只证明了「链路通」——芯片有电、被选中、时钟到位、命令能进能出。而读写要多满足四层：协议对（模式与命令序列）、配置对（QE / 地址宽度 / dummy cycle）、状态清（忙已结束、写已使能、保护已解）、供电够（写入瞬间不跌落）。所以排查本质是用降级把这四层逐层剥开，而不是在高速四线模式下一遍遍重试。

这份文档解决什么

解决ID / CID 读回正确，但 Read / Program / Erase 失败、超时、校验不过或数据错乱这一类问题，覆盖 SPI NOR / SPI NAND / SD NAND / eMMC 四种介质。第 6 章是可直接翻查的现象速查表，第 7 章是可带进车间的核查清单与结案栏。

怎么用这份文档

1. 先确认「读是好的」：ID 读得到之外，普通读也要能返回正确数据。连读都不对，问题在配置层。
2. 按四刀顺序降级：降频单线 → 查状态参数 → 写擦最小回路 → 查供电带载，每刀都有退出条件。
3. 绕开上层做最小回路：不要一上来就在文件系统里拷大文件，那会把协议、坏块与电源问题混在一起。
4. 一次只改一个变量：频率、线宽、模式、地址宽度每次只动一处。
5. 降级只是定位不是方案：找到根因后必须回到目标配置重新验收并全温区复验。

1. 问题本质：读 ID 与读写的门槛差

这一章解决一个认知问题：为什么 ID 读得到，读写却会挂。读 ID 对时序与配置的要求低到近乎没有，它验证的只是「链路通」；而读写要在链路之上多满足四层条件。理解这道门槛差，就不会在最高配置下一遍遍重试。

1.1 读 ID 通过，到底证明了什么

把「读 ID 成功」翻译成具体的物理事实，只有下面这几条。凡是表格里没有的，都没有被验证过。

1.2 读写新引入的四层要求

读写相对读 ID 多出来的要求，可以归成四层。排查时按从上层到下层的顺序收敛：先确认协议与配置（便宜、好改），最后才动供电与布线（贵、慢）。

注意最后一行：供电层的验证成本最高，所以才要用降频这一刀先把它和其它三层分开——降频能削减瞬时电流与时序压力，降下来就好了，根因大概率在物理层。

1.3 三种介质各自的重点

2. 快速分流：降级定位四刀

本章是整份文档的主干。四刀的设计原则是先便宜后昂贵、先软件后硬件：第一刀只改一个配置参数，第二刀只读回几个字节，第三刀需要逻辑分析仪，第四刀才需要示波器看电源。

2.1 四刀的判据与退出条件

2.2 先固化复现条件

读写失败常常是条件性的：某个地址段失败、某种数据花样失败、某个温度下失败、大批量写才失败。没有固化的复现条件，就无法判断改动是否有效。

3. 第 2 刀 · 状态寄存器与参数页回读

这一刀性价比最高：不需要额外仪器，只要把器件当前的状态与配置读回来，再和 datasheet 逐项对上，就能判掉一大半读写失败。核心动作只有一句——把「读到的」和「该有的」逐项比对。

3.1 SPI NOR：状态位、保护位与模式位

SPI NOR 的读写失败，绝大多数能在状态寄存器里找到答案。按「忙 → 写使能 → 保护 → 模式」的顺序逐项看。

上面表格里的名称是各介质的常见叫法，具体位号与极性以 datasheet 为准。

3.2 SPI NAND：OIP、ECC、坏块与参数页

SPI NAND 比 NOR 多一层数据组织：页大小、OOB 布局、ECC 强度、坏块标记位置，只要有一项和驱动配置不一致，读出来的数据本身就是错的。

3.3 eMMC / SD：状态、总线宽度与速率模式

eMMC / SD 侧的「配置」主要体现在总线宽度与速率模式上，两者都需要主控与器件双方切换成功才算生效。最常见的情况是：1-bit 低速枚举与读写都正常，一切到 4-bit 或高速模式就挂。

具体的切换命令编号与时序要求以 JEDEC 规范与所用型号的 datasheet 为准。

3.4 实操：通用命令示意

下面给出的是排查动作的顺序示意，不是可直接照抄的命令——不同平台、不同工具的命令名与参数完全不同，请以所用平台的文档为准。

# 1) 读状态寄存器（命令码以 datasheet 为准）：
#    busy=1 -> 上一操作还没结束，等它清零
#    wel =0 -> 写使能没发，每次写/擦前都要先发

# 2) 轮询忙位到清零（务必设超时，不要死等）
for i in range(MAX_RETRY):
    sr = read_status_register()
    if not (sr & BUSY_MASK):
        break
    delay_ms(1)
else:
    fail("busy timeout")   # 超时即失败，不要继续往下发命令

# 3) 写使能 -> 写/擦 -> 再轮询忙位 -> 回读比对
write_enable()
program_page(addr, data)   # 或 block_erase(addr)
wait_busy_clear()
assert read_page(addr) == data   # 不一致先查地址宽度与页边界

# 4) 保护位：一次只改一位，改完读回确认

4. 第 3 刀 · 写擦最小回路与抓包

这一刀解决「问题到底在驱动还是在上层」：绕开文件系统、绕开多分区、绕开量产流程，用最短的命令序列做一次单页写与一次单块擦，同时用逻辑分析仪把命令序列完整抓下来。

4.1 什么叫「最小回路」

最小回路的定义是：只包含这次验证必需的东西。凡是能去掉的都要去掉，去掉之后仍然失败，才能把问题锁定在器件与主控之间。

4.2 抓包要看的三段

一次成功的写入，在逻辑分析仪上必须是完整三段。缺任何一段，都能直接定位到驱动的具体疏漏。

4.3 判据与退出