1. 为什么需要从SD卡迁移到SPI NAND在嵌入式开发中存储介质的选择直接影响产品的稳定性和成本。芒果派MQ1RDW2-T113-S3开发板默认使用SD卡作为存储介质但在实际项目中我们往往会遇到几个关键问题SD卡的物理接口在振动环境中容易出现接触不良我曾在一个工业控制项目中遇到因为运输震动导致系统无法启动的情况。而SPI NAND采用贴片式焊接抗震性能提升明显。从性能角度看实测SD卡的随机读写延迟通常在毫秒级而SPI NAND可以做到微秒级响应。容量方面虽然SD卡可以做到128GB甚至更大但对于嵌入式Linux系统而言SPI NAND的256MB-4GB容量区间反而更符合实际需求。更重要的是SPI NAND的擦写寿命通常10万次远超普通SD卡约1万次这在需要频繁写入日志的物联网设备中尤为关键。2. 迁移前的准备工作2.1 硬件确认首先需要确认开发板上的SPI NAND芯片型号常见的有Winbond W25N01GV128MB、MX35LF2GE4AD256MB等。通过查看芯片丝印或原理图确认型号这将直接影响后续的驱动配置。我手头的芒果派使用的是MXIC的MX35LF2GE4AD这是一款256MB的SPI NAND芯片。硬件连接上需要检查SPI总线是否正常。可以用示波器测量SPI CLK信号正常应该能看到波形。如果使用飞线连接注意线长不要超过10cm否则可能出现信号完整性问题。曾经有个学生在面包板上做实验因为线路过长导致频繁ECC错误缩短线距后问题立即解决。2.2 软件环境准备建议使用Tina-Linux的最新SDK旧版本可能缺少必要的驱动支持。通过以下命令检查SDK版本cat Tina-Linux/ver.txt需要提前安装的依赖包包括sudo apt install mtd-utils u-boot-tools device-tree-compiler特别提醒编译环境最好预留20GB以上磁盘空间因为UBI文件系统构建时会生成大量中间文件。我有次在云服务器上编译因为空间不足导致构建失败浪费了半天时间排查。3. 关键配置修改实战3.1 修改sys_config.fex文件这个文件相当于全志平台的硬件描述表路径在Tina-Linux/device/config/chips/t113/configs/mq_r/storage_type将storage_type值改为5对应SPINANDstorage_type 5注意不同平台版本可能路径略有差异有个项目中使用的是sys_config.fex而不是单独文件需要根据实际情况调整。修改后建议执行make kernel_menuconfig检查变更是否生效。3.2 调整env.fex启动参数修改env.fex中的bootcmd参数bootcmdrun setargs_nand boot_normal这个修改确保uboot会从NAND设备启动。有个容易忽略的点如果之前用过SD卡启动最好用mmc dev 0命令在uboot中禁用SD卡避免启动顺序混乱。3.3 设备树(board.dts)配置SPI控制器的配置很关键以下是针对MX35LF2GE4AD的典型配置spi0 { clock-frequency 100000000; pinctrl-0 spi0_pins_a spi0_pins_b; pinctrl-names default, sleep; spi0_cs_number 1; status okay; spi-nand0 { compatible spi-nand; spi-max-frequency 100000000; reg 0; spi-rx-bus-width 1; spi-tx-bus-width 1; }; };特别注意如果使用4线SPI模式需要将bus-width改为4并确认硬件上确实连接了4条数据线。我见过有人改了配置但硬件没接导致设备无法识别。4. 内核与文件系统适配4.1 U-Boot配置进入uboot目录执行make menuconfig需要开启的关键选项CONFIG_MTDy CONFIG_CMD_MTDPARTSy CONFIG_SUNXI_SPINANDy CONFIG_SUNXI_UBIFSy有个坑点如果同时启用了NOR和NAND支持可能会导致冲突。建议只保留当前需要的存储介质支持。4.2 内核MTD驱动配置执行make kernel_menuconfig后按以下路径配置Device Drivers - Memory Technology Device (MTD) support - Sunxi NAND Support - * Allwinner MTD SPINAND Device Support - UBI - Unsorted block images - * Enable UBI - [*] MTD devices emulation driver在文件系统部分需要启用UBIFSFile systems - Miscellaneous filesystems - * UBIFS file system support - [*] Extended attributes support实测发现启用Writeback模式可以提升小文件写入性能但会增大突然断电时数据损坏的风险工业场景建议保持默认。5. 系统编译与烧录5.1 Tina系统配置执行make menuconfig后重点关注Target Images - Boot (SPI NAND) - Kernel format (boot.img) Global build settings - [ ] Strip unnecessary functions (取消勾选) Utilities - * mtd-utils - * mkfs.ubifs有个实用技巧在make -j8编译前先执行ccache -M 10G设置编译缓存可以大幅提升二次编译速度。5.2 生成UBI镜像使用以下命令生成UBI镜像mkfs.ubifs -r rootfs -m 4096 -e 258048 -c 1000 -o ubifs.img ubinize -o ubi.img -m 4096 -p 256KiB ubinize.cfg参数说明-e 258048LEB大小必须与内核配置一致-c 1000最大逻辑擦除块数-p 256KiB物理擦除块大小曾经遇到个典型错误ubinize: error!: cannot calculate amount of PEBs原因是-c值设置过小调整后解决。5.3 烧录到SPI NAND使用sunxi-fel工具烧录sunxi-fel spinand write 0 ubi.img或者通过uboot命令tftp 0x42000000 ubi.img nand erase.part rootfs nand write 0x42000000 rootfs ${filesize}烧录后建议执行nand verify校验我遇到过因SPI信号干扰导致的烧录数据错误。6. 性能对比与问题排查6.1 基准测试数据使用iozone测试工具对比两种存储介质测试项SD卡(Class10)SPI NAND提升幅度顺序读(MB/s)22.138.775%顺序写(MB/s)18.324.534%4K随机读(IOPS)12563872208%4K随机写(IOPS)4231587275%特别在-20℃低温环境下测试SD卡出现多次读写失败而SPI NAND工作正常。6.2 常见问题解决ECC错误频发通常出现在大容量SPI NAND上解决方法降低SPI时钟频率如从100MHz降到50MHz在内核配置增加ECC强度CONFIG_MTD_NAND_ECC_SW_HAMMING_SMCy坏块处理在dts中添加坏块管理参数spi-nand0 { nand-on-flash-bbt; aw_spinand_use_bbt 1; };遇到启动失败时可以通过uboot命令检查设备识别sf probe nand info7. 进阶优化建议对于高性能场景可以尝试以下优化SPI总线优化spi0 { spi-bus-width 4; // 启用QPI模式 spi-tx-bus-width 4; spi-rx-bus-width 4; };文件系统调优在ubinize.cfg中增加压缩选项[ubifs] modeubi complzo电源管理对于电池供电设备添加spi-nand0 { power-on-delay-us 1000; power-off-delay-us 500; };最后提醒每次修改配置后建议执行make clean再重新编译避免缓存导致的问题。我在一个客户现场遇到奇怪问题清理后重新编译就解决了。