瑞芯微平台 · SPI NAND / eMMC 量产排查

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

XTX 芯天下 · FAE 现场技术文档 ｜ 瑞芯微（Rockchip）系列 SoC 外挂 SPI NAND 与 eMMC 的烧录与启动失败定位 （RK3308 / RK3328 / PX30 / RK3566 / RK3568 / RV1126 / RV1109 / RK3399 等）｜ 2026-09 版

一句话结论：瑞芯微平台上「烧录绿勾但起不来 / 卡在 MaskROM / 报分区或签名错」， 本质是八类根因之一：要么烧录进不去（MaskROM / 下载模式 / 签名）、 要么工程配置对不上（parameter / GPT / 分区）、要么器件状态异常 （eMMC Boot 分区 / EXT_CSD / RPMB / SPI NAND ID）。 烧录器能烧、能校验通过只证明器件是好的、数据是对的， 不证明主控的启动链路能把它认起来——这两者之间隔着整整八类根因。

这份文档解决什么

解决的是瑞芯微 SoC 外挂 SPI NAND 或 eMMC 后，烧录通过但启动失败、卡在 MaskROM、" 报分区 / 签名 / 识别类错误这一类问题的定位与根治方法。全文按 「现象 → 启动链路机制 → 类目 → 立即动作 → 根治动作」组织， 第 9 章是可直接翻查的速查表，第 11 章是可带进车间的核查清单与 FAE 结案栏。

怎么用这份文档

1. 先分是烧录进不去还是启动起不来：看串口——连下载模式（Rockusb）都进不去，先查第 1 类；" 能进下载模式但烧完起不来，按第 2~8 类顺位查。
2. 抓一份「已知好板」基线：把能正常启动那块板的完整启动日志、parameter.txt、GPT 导出、" EXT_CSD 读值、驱动 ID 表各存一份，后面所有对比都拿它当基准。
3. 用启动链四段收敛：MaskROM（下载模式）→ Loader → U-Boot（parameter/GPT）→ Kernel，" 故障落在哪一段就翻对应类目，不要跳段。
4. 一次只改一个变量：parameter、GPT、EXT_CSD、驱动 ID 表、签名密钥每次只动一处，" 改完重新烧录抓日志。
5. 用装板实跑闭环：任何改动的最终判定，以「装板跑通完整启动 + 关键功能 + 一次断电重启」为准。

1. 问题本质：瑞芯微启动链路与 MaskROM/Loader 机制

「瑞芯微板子起不来」这句话在现场被用得太泛。它可能下不进 Loader、可能 parameter 报错、 可能 Boot 分区写错、也可能 RPMB 拒写。本章先把现象还原成启动链路： 讲清瑞芯微上电后谁在控制存储、认出器件要满足哪些条件，然后把本文的排查对象与 「烧录器找不到型号」严格切开——这两件事在产线上被混淆的概率极高。

1.1 八类失败沿启动链路定位

现场接到「板子起不来、卡在下载模式、报分区或签名错」，第一件事是按图 1 把问题归到八类之一， 确定断在启动链的哪一段，不要一上来就换料号或重烧。八类对应的是同一条启动链在不同环节断掉的八种暴露方式， 归档的价值在于它直接决定从 s3 到 s8 先翻哪一章。

1.2 与「烧录器找不到型号」的分工

这是本文档最重要的一张表。产线上这两件事经常被当成同一件事处理： 「型号不对，让原厂支持一下」。但它们的发生位置、判定主体、根因集合、解决路径完全不同。 判别方法只有一句话：烧录器能不能正常把活干完。

1.3 瑞芯微启动链：MaskROM → Loader → U-Boot → Kernel

瑞芯微 SoC 上电后，真正控制外部存储的实体随时间切换：最早是芯片内部掩膜的 MaskROM（也叫 BootROM），它采样 boot 引脚、按固定顺序尝试各启动介质，并负责把 Loader（idbloader / miniloader）从介质搬进内部 SRAM / DRAM；Loader 初始化内存后加载 U-Boot；U-Boot 解析 parameter.txt 与 GPT 定位分区、加载内核与设备树； 最终进入 Kernel。理解「每一段谁在控制存储」，是定位八类失败的前提。

2. 方案总览：SPI NAND 与 eMMC 排查流程

瑞芯微平台上 SPI NAND 与 eMMC 虽然都是「外挂存储」，但排查套路并不完全相同： eMMC 是一条标准 SD/MMC 命令链 + 分区 / Boot 区 / EXT_CSD 的配置世界， SPI NAND 则是「ID 识别 + MTD/UBI + 坏块 / ECC / OOB」的另一套逻辑。 本章先给一张四关收敛图把八类失败框住，再给两张对照表 （介质差异、烧录 / 调试工具），后面六章的所有动作都在某一关内做细分。

2.1 四关收敛：先定关，再翻章

拿到一块起不来的板，不要从第一章顺着读下去，而是先用四关收敛把范围砍小。 每一关只回答一个是非题，判据来源也不同：第一关靠烧录器、第二关靠下载模式握手与 Loader 日志、 第三关靠 U-Boot 报错、第四关靠内核挂载日志。

2.2 SPI NAND 与 eMMC 的差异对照

「存储」这个词在两类介质上指的不是同一个东西。SPI NAND 的「识别」是一次 SPI 读 ID + 参数页， 坏了靠坏块表与 ECC；eMMC 的「识别」是一整套 CMD 交互 + EXT_CSD，坏了靠 Boot 分区与分区表。 因此「烧错」「认不出」「挂不上」在两类介质上的实现与处置完全不同，不要互相套用。

2.3 烧录与调试工具

瑞芯微生态下的工具链相对固定，定位时它们各管一段。注意 upgrade_tool 与 AndroidTool 是不同代的工具， 老平台多用 upgrade_tool，新平台（RK356x / RV1126 等）多用 AndroidTool / RKDevInfo； rkImageMaker 负责把镜像拼成可烧写的整体包。工具版本与平台要对应，否则会假绿。

3. 第 1 类：MaskROM 下 Loader 加载失败 / parameter 版本错误

这一类发生在启动链最上游，比「不认芯片」更早： 串口可能连 Rockusb 下载模式的提示都看不到，或进了下载模式但 Loader 下不去。 它包含两个容易被混淆的子类——Loader 物理上加载失败 （下载模式 / 供电 / 线序 / 镜像损坏）与工程配置对不上 （parameter 版本错）。前者卡在第 ② 关之前，后者卡在第 ③ 关。

3.1 下载模式（Rockusb）都进不去

瑞芯微板子上电后，若所有启动介质都失败，MaskROM 会进入 USB 下载模式等待主机连接。 主机端工具（upgrade_tool / AndroidTool）连不上是最常见的第一道坎。 此时还没到「认不认芯片」，纯粹是「主机到 SoC 的通道」没建立。

• 驱动 / 线序：USB 驱动未装或装错、用的是充电线而非数据线、USB 口供电不足。
• 供电：板子 VCC / VCCQ 不稳，MaskROM 自己还没起来。
• boot 引脚：被强制拉到「不从 USB 启动」的模式，MaskROM 跳过下载模式。
• eMMC / SPI NAND 总线短路：某条信号线对地短路，MaskROM 初始化时被拖死。

3.2 Loader / miniloader 加载失败

通道通了之后，主机把 Loader（idbloader / miniloader） 下载进 SRAM， 由 miniloader 完成 DRAM 初始化，再加载完整 idbloader 并跳转。失败的常见根因：

• Loader 镜像损坏或版本错：与当前 SDK / 平台不匹配，下载即校验失败。
• DRAM 初始化失败：miniloader 里的 DDR 参数与板子内存颗粒不匹配，卡在初始化。
• 签名不匹配（类目 6）：开启了安全启动，Loader 哈希 / 密钥不对，拒绝跳转执行。

3.3 parameter.txt 版本错误

Loader 起来后会解析 parameter.txt 拿到分区布局与容量声明， 再据此搬运各分区镜像。换料号、换容量、升级 SDK 后若沿用旧 parameter， 就会出现「声明容量 / 分区与实际镜像不匹配」：Loader 解析即报长度错，或把镜像写到错误偏移。

3.4 立即动作与根治动作

4. 第 2 类：eMMC Boot 分区烧写错位

eMMC 内部有硬件分区：BOOT0、BOOT1、USER、RPMB。 启动代码必须落在 BOOT0 / BOOT1 区，系统镜像落在 USER 区。 这一类失败的典型特征是下载模式正常、烧录绿勾，但板子启动卡在 MaskROM—— 因为 boot 镜像被错误地写到了 USER 区起点，BOOT 区是空的，SoC 从 Boot 区读不到启动头。 根因几乎都是烧录时用了错误的线性偏移。

4.1 eMMC 硬件分区与启动区

eMMC 上电后，SoC 通过 EXT_CSD 的 PARTITION_CONFIG 字段决定从哪个分区启动 （BOOT0 / BOOT1 / USER）。Boot 分区有独立的大小（BOOT_SIZE_MULT）， 且写入 Boot 区要走专用切换命令，不能当作 USER 区的线性地址直接写。 理解这一点是避免错位的前提。

4.2 错位是怎么发生的

错位几乎都来自「整盘线性偏移」思维：有人拿 USER 区的起始地址当 boot 镜像的烧写地址， 于是 boot 镜像被写到 USER 区开头，而 BOOT0 区始终是空的。 烧录工具显示「烧录成功」，是因为它确实把数据写到了指定地址——只是那个地址不是 Boot 区。

4.3 怎么确认是不是错位

用 rkdevinfo 或 mmc 命令读 Boot 分区使能与内容：

# 进入 U-Boot 或 Loader 命令行后（命令名以所用版本为准）
mmc dev 0                      # 选中 eMMC
mmc partconf 0                # 读 PARTITION_CONFIG，确认启动分区
mmc read ${addr} 0x0 0x10     # 读 USER 区起点，看是否误写了 boot 头
# 用专用命令读取 BOOT0 区并确认非空、且偏移与镜像一致

4.4 立即动作与根治动作