荔枝派Zero全志V3s SPI NOR Flash启动实战：从源码到镜像的完整避坑指南
荔枝派Zero全志V3s SPI NOR Flash启动全流程：从芯片手册到系统烧录的深度实践
第一次拿到荔枝派Zero开发板时，看着那块小小的XT25F128B SPI NOR Flash芯片，我完全没意识到接下来会经历怎样一场"硬核冒险"。作为嵌入式开发者，我们都经历过从官方开发板到自主设计的过渡阶段，而真正考验功力的，往往是如何让一块"非标"Flash芯片完美配合全志V3s启动Linux系统。本文将分享我从零开始，基于芯片手册和一块第三方NOR Flash，构建完整可启动系统的实战经验，特别是那些官方文档未曾提及的"坑"与解决方案。
1. 硬件准备与环境搭建
荔枝派Zero搭载的全志V3s是一款极具性价比的ARM Cortex-A7芯片，而XT25F128B作为16MB SPI NOR Flash，其擦除块大小为64KB——这个数字会在后续各个环节反复出现，成为分区对齐的关键依据。
开发环境配置要点：
交叉编译工具链选择：
wget https://releases.linaro.org/components/toolchain/binaries/latest/arm-linux-gnueabihf/gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf.tar.xz tar xvf gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf.tar.xz mv gcc-linaro-6.3.1-2017.05-x86_64_arm-linux-gnueabihf /opt/必备工具安装：
sudo apt-get install device-tree-compiler mtd-utils
硬件连接检查表：
| 接口类型 | 连接状态 | 注意事项 |
|---|---|---|
| USB转串口 | 必须连接 | 波特率设置为115200 |
| SPI Flash | 已焊接 | 确认CS引脚上拉正常 |
| 电源输入 | 5V/1A | 避免使用电脑USB口供电 |
提示：开发板首次上电前，建议用万用表检查3.3V和1.8V电源是否对地短路，避免Flash芯片焊接不良导致供电异常。
2. U-Boot移植与Flash驱动适配
全志V3s的启动流程与传统ARM芯片略有不同，其SPI Flash支持需要通过SPL（Secondary Program Loader）阶段初始化。官方uboot源码中可能不包含特定Flash型号的驱动，这就需要我们手动适配。
关键配置步骤：
获取实验性分支uboot：
git clone -b v3s-spi-experimental https://github.com/Lichee-Pi/u-boot.gitFlash型号适配（以XT25F128B为例）：
make ARCH=arm menuconfig进入
Device Drivers > SPI Flash Support，选择最接近的兼容型号（如Macronix系列）环境变量配置技巧： 修改
include/configs/sun8i.h，在指定位置添加：#define CONFIG_BOOTCOMMAND "sf probe 0; " \ "sf read 0x41800000 0x100000 0x10000; " \ "sf read 0x41000000 0x110000 0x400000; " \ "bootz 0x41000000 - 0x41800000"
常见问题排查：
现象：uboot启动后无法识别Flash
检查点：
- SPI总线时钟是否过高（建议初始设为20MHz）
- Flash的WP/HOLD引脚是否上拉
- 设备树中SPI节点是否启用
现象：只能读取前16MB内容
解决方案：启用CONFIG_SPI_FLASH_BAR选项
3. Linux内核定制与设备树优化
内核配置需要特别注意MTD子系统和文件系统的选择，对于NOR Flash设备，JFFS2是最可靠的选择。
内核配置要点：
make ARCH=arm menuconfig确保以下选项启用：
Device Drivers > Memory Technology Device (MTD) supportCommand line partition table parsingSPI-NOR device supportFile systems > Miscellaneous filesystems > JFFS2 support
设备树关键修改：
在sun8i-v3s-licheepi-zero.dts中添加SPI节点：
&spi0 { status = "okay"; xt25f128b: xt25f128b@0 { compatible = "jedec,spi-nor"; reg = <0>; spi-max-frequency = <50000000>; #address-cells = <1>; #size-cells = <1>; }; };分区策略优化建议：
| 分区名 | 大小 | 起始地址 | 内容 | 对齐要求 |
|---|---|---|---|---|
| uboot | 1MB | 0x000000 | SPL+uboot | 64KB对齐 |
| dtb | 64KB | 0x100000 | 设备树 | 必须64KB |
| kernel | 4MB | 0x110000 | 内核镜像 | 1MB对齐 |
| rootfs | 剩余空间 | 0x510000 | JFFS2文件系统 | 擦除块大小整数倍 |
注意：每个分区大小必须是擦除块大小（64KB）的整数倍，否则会导致擦除操作失败。
4. 文件系统制作与镜像打包
NOR Flash的特性决定了我们必须使用专门的日志型文件系统，JFFS2是经过验证的可靠选择。
JFFS2镜像生成步骤：
准备根文件系统内容：
tar xzvf rootfs-brmin.tar.gz计算精确分区大小：
16MB - 1MB(uboot) - 64KB(dtb) - 4MB(kernel) = 0xAF0000生成镜像文件：
mkfs.jffs2 -s 0x100 -e 0x10000 -p 0xAF0000 -d rootfs-brmin/ -o jffs2.img
全镜像打包脚本：
#!/bin/sh dd if=/dev/zero of=flashimg.bin bs=1M count=16 dd if=u-boot-sunxi-with-spl.bin of=flashimg.bin bs=1K conv=notrunc dd if=sun8i-v3s-licheepi-zero.dtb of=flashimg.bin bs=1K seek=1024 conv=notrunc dd if=zImage of=flashimg.bin bs=1K seek=1088 conv=notrunc dd if=jffs2.img of=flashimg.bin bs=1K seek=5184 conv=notrunc镜像验证技巧：
- 使用hexdump检查各分区偏移是否正确：
hexdump -C -n 64 flashimg.bin - 检查文件系统镜像是否完整：
jffs2dump -c jffs2.img
5. 烧录实战与调试技巧
全志芯片的FEL模式是其一大特色，当SPI Flash为空或无效时，芯片会自动进入此模式等待USB命令。
烧录工具准备：
git clone -b spi-rebase https://github.com/Icenowy/sunxi-tools.git cd sunxi-tools make && sudo make install完整烧录命令：
sudo sunxi-fel -p spiflash-write 0 flashimg.bin分段烧录方案（调试推荐）：
sudo sunxi-fel -p spiflash-write 0x0 u-boot-sunxi-with-spl.bin sudo sunxi-fel -p spiflash-write 0x100000 sun8i-v3s-licheepi-zero.dtb sudo sunxi-fel -p spiflash-write 0x110000 zImage sudo sunxi-fel -p spiflash-write 0x510000 jffs2.img常见烧录问题：
USB设备未识别：
- 检查虚拟机USB过滤设置
- 尝试不同的USB端口
- 执行
lsusb查看设备是否枚举
权限问题：
- 将用户加入plugdev组
- 创建/etc/udev/rules.d/51-sunxi.rules：
SUBSYSTEM=="usb", ATTRS{idVendor}=="1f3a", ATTRS{idProduct}=="efe8", GROUP="plugdev", MODE="0660"
经过多次实践验证，这套流程在XT25F128B上稳定可靠。记得第一次成功启动时，串口输出的内核日志如同最美的诗篇——那种成就感，正是嵌入式开发的魅力所在。