Edit online

测试指南

4 Dec 2024
Read time: 9 minute(s)

测试环境

  • 硬件

    • 开发板，或者 FPGA 板子

    • 板子上必须要接有 SPINOR

  • 软件

    • PC 端的串口终端软件，用于 PC 和开发板进行串口通信

    • RT-Thread DFS 组件自带了一些命令的文件操作工具，如 cp、mkdir 等

编译烧录

配置完成后，保存退出，编译、烧录

验证 SPINOR 识别

  • SPINOR 识别
    烧录完成后，断开电源后上电，使用 list_device 命令检查设备信息，确认设备已识别。
    list_device
    在输出结果中可以看到 norflash0 设备，表明系统已识别 SPINOR：
    
device           type         ref count
-------- -------------------- ----------
...
norflash0        Block Device         0
...

    若使用手动挂载，则在此时执行 mount blk_rodata /rodata elm 和 mount data /data lfs 命令。

  • 进入 rodata 目录，查看文件：
    1. 进入 sd 目录：
      cd sd
    2. 进入 rodata 目录：
      cd rodata
    3. 查看文件信息：
      ls
      输出结果如下，表示 SPINOR 挂载完成：
      Directory /rodata:
lvgl_data           <DIR>
  • 使用 list device 命令查看设备：
    下列结果示例中，存在两种 SPINOR 设备：

    • MTD 设备，用来挂载 Littlefs 文件系统

    • Block 设备，用来挂载 FatFS 文件系统

    aic/> list device
device                   type         ref count
---------------- -------------------- ----------
wdt              WDT Device           0
blk_data         Block Device         0
data             MTD Device           1
blk_rodata_r     Block Device         0
rodata_r         MTD Device           0
blk_rodata       Block Device         1
rodata           MTD Device           0
blk_os_r         Block Device         0
os_r             MTD Device           0
blk_os           Block Device         0
os               MTD Device           0
blk_env_r        Block Device         0
env_r            MTD Device           0
blk_env          Block Device         0
env              MTD Device           0
blk_spl          Block Device         0
spl              MTD Device           0

Baremetal 中的相关命令

Baremetal 和 Bootloader 中实现了 spinor 和 mtd 命令测试工具，具体用法相同。首先在板子上运行 Luban-Lite Baremetal 程序。

  • 查看相关命令
    在串口控制台执行命令 help 查看当前系统命令：
    aic # help
Command list:  help                 Show all commands.
history              Show history.
md                   Memory display
mtd                  MTD R/W command.
mw                   Memory write
reboot               Reboot device.
reset                Reboot device.
spinor               SPI NOR flash R/W command.

    其中，spinor 为 mtd 命令工具。SFUD 层之上的一层为 mtd 层。spinor 命令可以查看 SFUD 层信息，mtd 命令可以查看 mtd 层信息。关于两种命令的使用方法，可分别查看 测试 spinor 命令和 测试 mtd 命令中的详细描述。

测试 spinor 命令

执行命令 spinor help 可得到如下帮助信息：
aic # spinor help
spinor read write command:
spinor init <spi bus id>
spinor dump  <offset> <size>
spinor read  <addr> <offset> <size>
spinor erase <offset> <size>
spinor write <addr> <offset> <size>
e.g.:
spinor read 0x40000000 0 256
测试 spinor 命令的方法如下：
  • 初始化 SPI NOR 设备
    aic # spinor init 0
probe spinor flash success.

  • 打印 SPI NOR 数据

    aic # spinor dump 0 0x800
0x300530c0 : 41 49 43 20 26 e5 67 b1 01 00 01 00 10 64 01 00
0x300530d0 : 00 00 00 00 78 62 01 00 00 00 10 30 00 01 10 30
0x300530e0 : 00 00 00 00 00 00 00 00 00 64 01 00 10 00 00 00
.........

  • 读取 SPI NOR 数据到内存上

    aic # spinor read 0x30060000 0x800 0x800
aic # md 0x30060000 0x800
0x30060000 : 33 05 f7 40 82 80 03 46 05 00 83 c6 05 00 05 05
0x30060010 : 85 05 63 14 d6 00 e3 18 06 fe 33 05 d6 40 82 80
0x30060020 : 11 05 91 05 e3 11 d6 fe 01 45 82 80 21 05 a1 05
.........

测试 mtd 命令

执行命令 mtd help 可得到如下帮助信息
注：

开发时，推荐使用 mtd 命令进行测试。

aic # mtd help
mtd read write command:
mtd list
mtd dump  <part> <offset> <size>
mtd read  <part> <addr> <offset> <size>
mtd erase <part> <offset> <size>
mtd write <part> <addr> <offset> <size>
e.g.:
mtd read spl 0x40000000 0 0x1000
测试 mtd 命令的方法如下：

  • 初始化 mtd 设备

    aic # mtd list
MTD devices:nor0                     0x00000000 ~ 0x01000000
    spl_1                0x00000000 ~ 0x00020000
    spl_2                0x00020000 ~ 0x00040000
    os                   0x00040000 ~ 0x00140000
    rodata               0x00140000 ~ 0x00740000
    data                 0x00740000 ~ 0x00d40000

  • 打印 mtd 分区数据

    aic # mtd dump spl_1 0 0x80
0x30052b5c : 41 49 43 20 26 e5 67 b1 01 00 01 00 10 64 01 00
0x30052b6c : 00 00 00 00 78 62 01 00 00 00 10 30 00 01 10 30
0x30052b7c : 00 00 00 00 00 00 00 00 00 64 01 00 10 00 00 00
.........

aic # mtd dump os 0 0x80
0x30052b74 : 41 49 43 20 1c a7 0c d2 01 00 01 00 10 d8 00 00
0x30052b84 : 00 00 00 00 9c d6 00 00 00 00 04 30 00 01 04 30
0x30052b94 : 00 00 00 00 00 00 00 00 00 d8 00 00 10 00 00 00
.........
  • 测试 mtd 读速度，并打印读取的数据
    aic # mtd read spl_1 0x30060000 0x800 0x800
sfud_read speed: 2048 byte, 1511 us -> 1323 KB/s

aic # md 0x30060000 0x800
0x30060000 : 33 05 f7 40 82 80 03 46 05 00 83 c6 05 00 05 05
0x30060010 : 85 05 63 14 d6 00 e3 18 06 fe 33 05 d6 40 82 80
0x30060020 : 11 05 91 05 e3 11 d6 fe 01 45 82 80 21 05 a1 05
.........

  • 测试擦除命令

    aic # mtd dump rodata 0 0x800 //打印擦除前的数据
0x30052e34 : eb 3c 90 4d 54 4f 4f 34 30 34 33 00 10 08 01 00
0x30052e44 : 02 80 03 13 01 f8 01 00 0d 00 02 00 00 00 00 00
0x30052e54 : 00 00 00 00 80 00 29 67 3e cf 0f 4e 4f 20 4e 41
.........

aic # mtd erase rodata 0 0x2000       //执行擦除命令

aic # mtd dump rodata 0 0x800   //打印擦除后的数据
0x30052e34 : ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff
0x30052e44 : ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff
0x30052e54 : ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff ff
.........

  • 测试写入新数据

    aic # mtd write rodata 0x30060000 0 0x800

aic # mtd dump rodata 0 0x800   //读取新数据，判断是否写入正确
0x30052e34 : 33 05 f7 40 82 80 03 46 05 00 83 c6 05 00 05 05
0x30052e44 : 85 05 63 14 d6 00 e3 18 06 fe 33 05 d6 40 82 80
0x30052e54 : 11 05 91 05 e3 11 d6 fe 01 45 82 80 21 05 a1 05
.........