速通攻略 | RK3588开发板U-Boot阶段的存储设备文件读取方法

飞凌嵌入式OK3588-C开发板作为一款基于瑞芯微RK3588处理器设计开发的旗舰级开发板，不仅拥有4核A76+4核A55的强劲架构以及6TOPS的卓越NPU算力，而且在硬件上支持双路独立MMC控制器、多规格USB接口等，为存储设备调试筑牢硬件根基。有了这样强大的硬件支撑，在实际的开发调试与系统验证过程中，对各类存储设备文件内容的读取操作就显得尤为重要。

本文将介绍在飞凌嵌入式RK3588开发板U-Boot控制台阶段，读取eMMC、TF 卡、U盘等各类存储设备文件内容的标准化方法。尽管不同设备初始化有差异，但通过控制台命令可实现统一读写，为开发调试与系统验证带来极大便利。

一、进入U-Boot控制台

飞凌嵌入式RK3588开发板的U-Boot经过深度定制优化，默认配置了合理的bootdelay等待时间，在U-Boot启动过程中，需在自动启动倒计时结束前，按下【空格键】或【Ctrl+C】中断流程，进入交互式控制台。

操作信息与示例如下：

Hit key to stop autoboot('Spacebar'): 0 0:Exit to console 1:Reboot 2:Display type =>

注意：若未及时按键，U-Boot将继续执行自动启动（加载内核），这时需重启开发板后重新尝试。

二、MMC设备（eMMC/TF卡）的文件读写

飞凌嵌入式RK3588开发板硬件上集成双路MMC控制器，分别对应 eMMC与TF卡接口，且完美兼容eMMC 5.1规范及SD 3.0协议，支持 HS400高速传输模式与8bit/4bit数据总线宽度，为存储设备的并行操作提供了硬件支撑。大家注意，对MMC设备进行文件读写需要遵循 “识别→切换→查询→操作” 四步流程，具体步骤如下：

1. 查看MMC控制器

使用mmc list命令查看已初始化的MMC控制器（由设备树预定义，通常0对应eMMC，1对应TF卡），确认设备是否被识别：

=> mmc list //查看当前已初始化的MMC控制器 mmc@fe2c0000: 1 mmc@fe2e0000: 0 (eMMC)Device 'mmc@fe2c0000': seq 1 is in use by 'mmc@fe2c0000' mmc@fe2c0000: 1Device 'mmc@fe2e0000': seq 0 is in use by 'mmc@fe2e0000' mmc@fe2e0000: 0 =》

2. 切换MMC设备

使用mmc dev <设备号>命令切换至目标设备，设备号对应上一步查询的控制器序号：

=> mmc dev 0 //切换为EMMC switch to partitions #0, OK mmc0(part 0) is current device => mmc dev 1 //切换为TF卡 switch to partitions #0, OK mmc0(part 0) is current device

3. 查看MMC设备信息

切换设备后，使用mmc info命令查看设备详细参数（容量、总线宽度、接口版本等），eMMC与TF卡的信息示例分别如下：

(1) eMMC设备信息示例：

=> mmc info //EMMC的设备信息 Device: mmc@fe2e0000 Manufacturer ID: 15 OEM: 100 Name: CJTD4 Timing Interface: HS400 Enhanced Strobe Tran Speed: 200000000 Rd Block Len: 512 MMC version 5.1 High Capacity: Yes Capacity: 58.2 GiB Bus Width: 8-bit DDR Erase Group Size: 512 KiB HC WP Group Size: 8 MiB User Capacity: 58.2 GiB WRREL Boot Capacity: 4 MiB ENH RPMB Capacity: 4 MiB ENH

(2) TF卡设备信息示例：

=> mmc info //TF的设备信息 Device: mmc@fe2c0000 Manufacturer ID: 3 OEM: 5344 Name: SL16G Timing Interface: Legacy Tran Speed: 52000000 Rd Block Len: 512 SD version 3.0 High Capacity: Yes Capacity: 14.8 GiB Bus Width: 4-bit Erase Group Size: 512 Bytes

4. 查看MMC设备分区

使用mmc part命令查看设备分区表（以eMMC为例，分区类型为EFI），获取分区名、起始/结束地址等关键信息：

=> mmc part Partition Map for MMC device 0 -- Partition Type: EFI Part Start LBA End LBA Name Attributes Type GUID Partition GUID 1 0x00004000 0x00005fff "uboot" attrs: 0x0000000000000000 type: da7a0000-0000-400e-8000-214900006be8 guid: ae050000-0000-417a-8000-728a000054cf 2 0x00006000 0x00007fff "misc" ...（省略部分分区）... 6 0x00078000 0x01c77fff "rootfs" // ⽰例中需操作的rootfs分区 ...

5. 查看文件系统内容

使用ext4ls <设备类型> <设备号:分区号>命令查看指定分区的目录结构（示例：eMMC的第6分区rootfs）：

=> ext4ls mmc 0:64096 .4096 ..16384 lost+found 7 bin4096 boot4096 dev ...(省略部分系统目录)...4096 home // 目标文件所在上级目录 ...

6. 读取文件内容（以Hello.txt为例）

读取rootfs分区中/home/forlinx/Hello.txt文件，需按“确认存在→选内存地址→加载文件→查看内容”四步操作：

(1) 确认文件存在：通过ext4ls验证目标文件路径有效性：

=> ext4ls mmc 0:6 home/forlinx4096 .4096 .. 14 Hello.txt // 目标文件（大小14字节）

(2) 确定可用内存地址：用bdinfo查看内存分布，选择安全DDR区域：

=> bdinfo arch_number = 0x00000000 boot_params = 0x00000000 DRAM bank = 0x00000000 // 系统保留区，不建议使用 -> start = 0x00200000 -> size = 0x08200000 DRAM bank = 0x00000001 // 安全可用区 -> start = 0x09400000 -> size = 0xE6C00000 ...(省略其他硬件信息)...

注意！严禁使用系统保留内存（如DRAM bank 0），否则会导致U-Boot崩溃或数据损坏！

(3) 加载文件到内存：用ext4load将文件加载到指定内存地址：

=> ext4load mmc 0:6 0xA0000000 /home/forlinx/Hello.txt 14 bytes read in 5 ms (2 KiB/s)

(4) 查看内存中文件内容：用md.b <地址> <长度>读取内存数据：

=> md.b 0xA0000000 0x10 a0000000: 48 69 2c 20 46 4f 52 4c 49 4e 58 21 21 0a ff fe Hi, FORLINX!!...

7. 修改文件内容（需启用ext4write）

注意！U-Boot默认禁用ext4write命令（防止误操作），需先在U-Boot源码配置中开启！

开启功能后，支持两种修改方式：

(1) 替换式修改（加载外部文件覆盖）

// 假设修改后的文件已加载到内存0xA0000000 => ext4write mmc 0:6 0xA0000000 /home/forlinx/Hello.txt 0xe // 0xe=14字节（文件大小）

(2) 直接修改内存数据后写入

// 1. 逐字节修改内存（地址0xA0000000开始） => mm.b 0xA0000000 A0000000: 48 ? //这代表地址 0xA0000000 当前值是 0x48（ASCII 'H'）。 //你可以输入新的十六进制值，然后回车。 例如把 “Hi, FORLINX!!” 改为 “Hi!\n”： => mw.b 0xA0000000 0x48 // 第1字节：'H' => mw.b 0xA0000001 0x69 // 第2字节：'i' => mw.b 0xA0000002 0x21 // 第3字节：'!' => mw.b 0xA0000003 0x0A // 第4字节：换行符'\n' => md.b 0xA0000000 0x20 // 2. 验证修改结果 => md.b 0xA0000000 0x20 a0000000: 48 69 21 0a 46 4f 52 4c 49 4e 58 21 21 0a ff fe Hi!.FORLINX!!... // 3. 写入文件系统 => ext4write mmc 0:6 0xA0000000 /home/forlinx/Hello.txt 0xe

三、USB设备（如U盘）的文件读写

USB设备为外部存储，需先初始化USB子系统才能识别，步骤如下：

1. 初始化USB子系统

使用usb start命令启动USB控制器并扫描设备，成功识别后会显示存储设备数量：

=> usb start starting USB... Bus usb@fc000000: usb maximum-speed not found Register 2000140 NbrPorts 2 Starting the controller USB XHCI 1.10 ...(省略USB初始化日志)... scanning usb for storage devices... 1 Storage Device(s) found // 识别到1个U盘

提示：若未识别到设备，需检查U盘连接（建议插USB 2.0接口），或重新执行usb start命令。

2. 查看USB设备文件

U盘通常为FAT32格式，使用fatls usb <设备号>查看目录内容（设备号默认从0开始）：

=> fatls usb 0 System Volume Information/ // 系统隐藏目录 16 sram_code.bin // 目标文件（大小16字节）

3. 读取USB设备文件内容

使用fatload加载文件到内存，再用md.b查看内容：

// 1. 加载文件到内存 => fatload usb 0:1 0xA0000000 sram_code.bin //下载内容文件到内存 reading sram_code.bin 16 bytes read in 23 ms (0 Bytes/s) =>=> md.b 0xA0000000 0x10 //读取内存地址上的内容 ，遇上边一致 a0000000: 80 5a a5 d2 01 09 80 d2 01 00 00 f9 c0 03 5f d6 .Z............_.

四、需注意的关键事项

(1) 所有操作需在U-Boot控制台执行，确保开发板已正常进入控制台模式（非自动启动流程）；

(2) MMC设备常用命令为ext4ls/ext4load/ext4write（ext4格式），USB设备常用fatls/fatload（FAT格式），需根据文件系统选择命令；

(3) 写入操作（如ext4write）存在数据风险，建议在调试环境中使用，生产环境避免启用；

(4) 若需在U-Boot源码中集成文件操作，可调用U-Boot提供的API（如ext4_read_file()、usb_storage_probe()），需确保对应驱动已编译。

以上就是如何在飞凌嵌入式RK3588开发板U-Boot控制台阶段，读取eMMC、TF 卡、U盘等各类存储设备文件内容的标准化方法，希望能够对大家有所帮助。