SPI NOR 布局与备份

板载 NOR Flash 共 16 MiB（地址 0x000000–0xFFFFFF），是系统资源：启动加载器、固件和应用都在里面。写之前请先看一眼自己想覆盖的范围里有什么，并先备份。

备份整片 Flash

进入 FEL 后：

xfel spinor read 0x0 0x1000000 neko-backup.bin
# 或
rfel spinor read 0x0 0x1000000 neko-backup.bin

保存好备份文件和它的 SHA-256，不要覆盖上一次的备份。

恢复：

xfel spinor write 0x0 neko-backup.bin

写完回读校验，再复位。

写入前后都应该核对 SHA-256。

平台	命令
Windows PowerShell	`Get-FileHash -Algorithm SHA256 <文件>`
Linux	`sha256sum <文件>`；对照校验表：`sha256sum -c SHA256SUMS`
macOS	`shasum -a 256 <文件>`；对照校验表：`shasum -a 256 -c SHA256SUMS`

Flash 的划分取决于你装的是哪套软件。同一块板子可以有以下几种布局之一，它们互相不兼容，换用时需要重新写入引导部分。

组件	NOR 偏移	本布局预留	载入 RAM 地址
SyterKit	`0x000000`	64 KiB	`0x00020000`
设备树	`0x010000`	256 KiB	`0x40f40000`
RustSBI	`0x050000`	512 KiB	`0x40f80000`
Asterinas	`0x0d0000`	5 MiB（到 initramfs 之前）	`0x40000000`
initramfs	`0x5d0000`	1 MiB	`0x40500000`

完整镜像写入 0x000000..0x6d0000；0x6d0000..0x1000000 不会被碰到。详见 RustSBI + Asterinas。

组件	NOR 偏移	本布局预留	载入 RAM 地址
SyterKit	`0x000000`	64 KiB	`0x00020000`
设备树	`0x010000`	256 KiB	`0x40f40000`
OpenSBI `fw_jump`	`0x050000`	512 KiB	`0x40f80000`
Linux Image	`0x0d0000`	6 MiB	`0x40000000`
SquashFS 根文件系统	`0x6d0000`	到 `0xf00000`（约 8.2 MiB）	从 MTD 挂载
JFFS2 overlay	`0xf00000`	1 MiB	从 MTD 挂载

完整镜像覆盖整片 16 MiB，包括 overlay 分区，所以写入会丢掉板上已经持久化的改动。详见预编译镜像。