WSL下玩转T113开发板：用xfel工具一键烧写SPI-NAND的实战指南

WSL下T113开发板SPI-NAND烧写全攻略：从零开始掌握xfel工具链

在嵌入式开发领域，全志T113系列芯片凭借其出色的性价比和丰富的外设接口，成为众多物联网设备的首选方案。而SPI-NAND闪存作为存储介质，相比传统SD卡具有体积小、抗震性强、寿命长等优势。本文将带你深入探索如何在WSL环境下，利用xfel工具高效完成T113开发板的SPI-NAND烧写工作。

1. 环境准备与工具链搭建

1.1 WSL环境配置要点

对于习惯Linux开发环境的工程师来说，Windows Subsystem for Linux（WSL）提供了完美的折中方案。我们推荐使用WSL 2版本，它能提供更完整的系统调用兼容性。安装完成后，首先需要更新软件源并安装基础开发工具：

sudo apt update && sudo apt upgrade -y sudo apt install build-essential git make gcc

提示：建议使用Ubuntu 20.04 LTS或更新版本作为WSL发行版，以获得最佳兼容性

1.2 xfel工具获取与配置

xfel是全志SOC专用的FEL模式工具，支持包括T113在内的多种芯片。由于WSL无法直接访问USB设备，我们需要采用特殊方法：

1. 从GitHub下载Windows版xfel工具
2. 解压到WSL的文件系统中（如/home/username/xfel-windows）
3. 在.bashrc中添加别名配置：

echo "alias xfel='/home/username/xfel-windows/xfel.exe'" >> ~/.bashrc source ~/.bashrc

验证安装是否成功：

xfel version

正常情况应显示类似xfel version 1.2.9的版本信息。

2. 开发板连接与FEL模式进入

2.1 硬件准备清单

• T113开发板（建议使用官方EVB板）
• USB Type-C数据线（必须支持数据传输）
• 串口调试工具（如CP2102、CH340等）
• 可选：杜邦线用于手动触发FEL模式

2.2 FEL模式进入方法

T113芯片需要通过特定引脚组合进入FEL烧录模式：

1. 确保开发板断电
2. 短接SPI_CS引脚到地（即拉低电平）
3. 保持上述状态，连接USB到电脑
4. 释放SPI_CS短接

验证是否成功进入FEL模式：

xfel detect

成功时会显示检测到的芯片型号和相关信息。

3. SPI-NAND烧写全流程详解

3.1 镜像文件准备

典型的T113系统镜像包含多个组成部分：

使用make命令生成最终烧写镜像：

make spi-boot.img

3.2 SPI-NAND操作命令详解

xfel提供了完整的SPI-NAND操作命令集：

• 擦除操作：必须在使用前执行全片擦除

xfel spinand erase 0 0x8000000

• 写入操作：将镜像写入指定地址

xfel spinand write 0 spi-boot.img

• 验证操作：可选步骤，确认写入正确

xfel spinand read 0 0x100000 verify.bin md5sum spi-boot.img verify.bin

注意：擦除和写入操作时间较长，请耐心等待直到命令完成

4. 常见问题排查与优化技巧

4.1 典型错误解决方案

问题1：xfel detect无响应

• 检查USB连接是否正常
• 确认正确进入FEL模式
• 尝试更换USB端口或数据线

问题2：spinand write失败

ERROR: SPI-NAND operation timeout

• 降低SPI时钟频率（如有相关参数）
• 检查电源稳定性，建议使用外接电源
• 确认NAND芯片型号是否被xfel支持

问题3：启动时DTB验证失败

[E] SPI-NAND: DTB verification failed

• 检查设备树编译是否正确
• 确认烧写地址与bootloader配置匹配
• 验证SPI-NAND的ECC设置

4.2 性能优化建议

1. 批量烧写优化：对于生产环境，可以预先擦除多块板子，然后并行烧写
2. 脚本自动化：将完整流程封装为shell脚本，例如：

#!/bin/bash echo "开始烧写流程..." xfel spinand erase 0 0x8000000 xfel spinand write 0 $1 echo "烧写完成，准备重启..." xfel reset

3. 硬件改良：在开发板上增加FEL模式触发按钮，避免每次短接

5. 高级应用：自定义烧写布局

对于需要特殊分区方案的项目，可以修改xfel的默认配置。主要涉及两个关键文件：

1. board.h：定义内存映射布局
2. board.c：实现硬件初始化逻辑

典型的内存布局参数：

#define SPI_NAND_BOOT_ADDR 0x000000 #define SPI_NAND_DTB_ADDR 0x040000 #define SPI_NAND_KERNEL_ADDR 0x080000 #define SPI_NAND_ROOTFS_ADDR 0x800000

修改后需要重新编译xfel工具：

make clean make

6. 串口调试与日志分析

正确配置串口是调试的关键步骤。T113默认使用UART5输出日志，参数通常为：

• 波特率：115200
• 数据位：8
• 停止位：1
• 无校验

使用minicom或screen连接串口：

sudo apt install minicom minicom -D /dev/ttyUSB0 -b 115200

典型启动日志分析：

[I] AWBoot r6143 starting... # Bootloader启动成功 [I] SPI-NAND: W25N01GV detected # 识别到NAND闪存 [I] Loading kernel from 0x80000... # 开始加载内核 [I] Kernel entry at 0x40008000 # 成功跳转到内核

遇到启动失败时，这些日志是定位问题的第一手资料。建议将重要日志保存到文件：

minicom -D /dev/ttyUSB0 -b 115200 -C boot.log

7. 生产环境实践建议

在实际项目部署中，SPI-NAND烧写还需要考虑以下因素：

1. 寿命管理：

   • 启用磨损均衡算法
   • 避免频繁写入固定区域
   • 监控坏块增长情况

2. 数据安全：

   • 实现镜像签名验证
   • 考虑加密存储敏感数据
   • 保留恢复分区

3. 批量操作：

   • 设计专用烧写夹具
   • 开发自动化测试脚本
   • 建立完善的日志系统

一个实用的生产检查清单：

• [ ] 验证每个板子的USB连接稳定性
• [ ] 记录每个NAND芯片的UID
• [ ] 保存每次烧写的MD5校验值
• [ ] 进行至少一次完整启动测试