100ASK T113S3 Pro 主线系统冷启动验收
本章目标
证明板卡在完全失电后，不依赖 FEL、临时环境变量或人工 U-Boot 命令，能够从 SPI NAND 启动到 Buildroot 登录终端。
前置条件
- SPI NAND 安装规程返回成功；
- 已保存安装时的 artifact 哈希和 UART 日志；
- UART3 监控已准备好；
- FEL 启动按键、跳线或临时启动条件已经释放；
- 不使用 U-Boot
setenv修正启动参数。
第一步：结束旧日志
停止安装阶段串口采集，创建一份新的冷启动日志。冷启动证据不能混在安装器温重启日志中。
第二步：完全断电
- 关闭板卡主电源；
- 确认所有可能反向供电的 USB/串口连接不会让 SoC 保持上电；
- 至少保持 1 秒完全断电；
- 已验证记录使用至少 2 秒断电。
第三步：正常上电
恢复电源，不进入 FEL，不在 U-Boot 停留，不输入任何命令。
第四步：核对启动标志
UART 必须按顺序出现：
Trying to boot from sunxi SPI
U-Boot 2026.07 ... DshanPi T113S3 Pro
Verifying Hash Integrity ... sha256+ OK
Kernel command line: ... ubi.mtd=sys root=ubi0:rootfs ...
ubi0: attached mtd4 (name "sys", size 242 MiB)
VFS: Mounted root (ubifs filesystem)
DshanPi T113S3 Pro - mainline Buildroot
t113s3pro-mainline login:
缺少任一关键标志都不能判定完整通过。
第五步：登录后检查
uname -srvm
cat /proc/device-tree/model; echo
cat /proc/mtd
ubinfo -a
mount | grep -E 'ubi|ubifs'
dmesg | grep -Ei 'spi-nand|ubi|ubifs|ttyS3|stmmac'
ip link
预期：
uname显示 Linux 6.18.8；- model 为
DshanPi T113S3 Pro (mainline)； mtd0-mtd4名称和容量与固定布局一致；ubi0:rootfs挂载为/；/sbin/init可执行；- UART3、SPI NAND 无未处理的致命错误。
第六步：外设验证
启动链通过后，分别执行：
| 外设 | 最低验收 |
|---|---|
| 以太网 | PHY 识别、链路建立、实际双向收发 |
| SD 卡 | 插拔检测、读写测试 |
| USB Host | 设备枚举和数据传输 |
| USB Device | gadget 枚举和数据传输 |
外设未验证不得写成“功能支持完成”，但不应与最小冷启动链混为同一个失败结论。
第七步：重复冷启动
新构建至少执行两次受控断电冷启动。每次都必须使用新日志并到达登录提示。当前硬件验证记录完成了两次至少 2 秒的断电启动。
验收表
| 项目 | 通过条件 | 结果 |
|---|---|---|
| SPL | BootROM 从 SPI NAND 加载主线 SPL | 待填写 |
| U-Boot | 显示 U-Boot 2026.07 和正确板名 | 待填写 |
| FIT | kernel/FDT SHA-256 通过 | 待填写 |
| Linux | 显示 6.18.8 | 待填写 |
| 设备树 | model 正确 | 待填写 |
| SPI NAND | ID/几何正确，无致命 ECC 错误 | 待填写 |
| UBI | sys attach 为 ubi0 | 待填写 |
| UBIFS | rootfs 挂载为 / | 待填写 |
| 登录 | 出现主线登录提示 | 待填写 |
| 冷启动次数 | 至少 2 次 | 待填写 |
失败处理
- 停在 SPL：检查 boot media 4、SPI NAND 读取和 SPL 副本；
- 停在 U-Boot：检查单线读取、环境后端和
boot分区 FIT； - FIT 哈希失败：重新安装同一套完整 artifact，禁止只替换单文件；
- 内核无日志：检查 UART3/earlycon/DTB；
- UBI/UBIFS 失败：检查
ubi.mtd=sys、NAND 几何和sys.ubi； - 只能手工
setenv启动：不通过，修正源码后重新构建、安装和断电验收。
需要保存的证据
保存从第一条 SPL 输出到登录提示的完整 UART 原始日志、断电时长、板卡/NAND 身份、产物哈希、源码提交、测试人员和日期。