3、U-Boot命令行基础：进入U-Boot命令行、常用命令分类、命令帮助系统

U-Boot启动后，如果你看到那个熟悉的 => 提示符，恭喜，你已经进入了U-Boot的命令行世界。很多刚接触嵌入式Linux的工程师，总觉得U-Boot就是个“黑盒子”，其实它更像一把瑞士军刀——功能多，但得知道怎么用。

我个人习惯把U-Boot命令行比作“裸机时代的救生员”。系统起不来？内核挂掉？文件系统损坏？只要串口还能输出，U-Boot命令行就是你排查问题的第一站。这一章，我们就把它的基本操作摸透。

3.1 如何进入U-Boot命令行

大多数开发板在启动时，串口终端会输出类似这样的信息：

U-Boot 2023.04 (Jan 15 2024 - 14:30:00 +0800)

CPU:   i.MX6ULL
Board: MY-IMX6ULL
DRAM:  512 MiB
MMC:   FSL_SDHC: 0, FSL_SDHC: 1
Net:   FEC [PRIME]
Hit any key to stop autoboot:  3

看到 Hit any key to stop autoboot 这行字了吗？在倒计时结束前，随便按键盘上的一个键（空格、回车都行），就能进入命令行。倒计时一般是3秒，有些板子设成1秒，手速要快。

如果倒计时已经结束，系统已经开始加载内核了怎么办？别急，按住复位键重启，或者重新上电，再来一次。实在不行，检查一下 bootdelay 环境变量是不是被改成了0。

3.2 常用命令分类

U-Boot的命令少说也有上百个，但常用的其实就那几十个。我按功能把它们分成四类，你记牢这四类，基本就能应付90%的调试场景。

3.2.1 信息查询类

这类命令用来“看”，看硬件状态、看环境变量、看内存布局。调试的第一步，永远是先搞清楚当前系统是什么状态。

举个例子，你拿到一块新板子，第一件事就是敲 bdinfo，看看DRAM起始地址是不是0x80000000，大小是不是512MB。如果这里就不对，后面所有操作都是白费。

3.2.2 内存操作类

这类命令是调试的“手术刀”。内存读写、查看、修改、比对，全指望它们。

注意 md 和 mw 后面的 .b、.w、.l 后缀，分别代表字节（8位）、半字（16位）、字（32位）操作。我见过不少新手用 md.l 查看寄存器，结果读出来的值完全不对——因为寄存器是32位的，但地址偏移是按字节算的，用 .l 一次读4字节，地址会自动加4。

3.2.3 网络操作类

网络是U-Boot里最实用的功能之一。通过网络下载内核、文件系统，比从Flash烧写快得多。

使用网络命令前，必须先设置好环境变量：ipaddr（板子IP）、serverip（服务器IP）、netmask（子网掩码）。我习惯在 bootcmd 里加一段自动检测网络的逻辑，如果ping不通服务器，就回退到本地启动。

3.2.4 存储操作类

存储操作涉及Flash、MMC、SD卡、USB等设备。这类命令通常以设备名开头，比如 mmc、sf（SPI Flash）、nand。

存储操作的关键是理解“块地址”和“字节地址”的区别。比如 mmc read 的第二个参数是块号（LBA），第三个参数是块数，一块通常是512字节。而 sf read 的第二个参数是字节偏移，第三个参数是字节长度。搞混了，读出来的数据全是乱的。

3.3 命令帮助系统

U-Boot的命令太多，记不住怎么办？别担心，它自带帮助系统。

• help 或 ?：列出所有可用命令。
• help 命令名：查看某个命令的详细用法。

比如你忘了 tftp 的用法，直接敲：

=> help tftp
tftp [loadAddress] [[hostIPaddr:]bootfilename]

输出会告诉你：第一个参数是加载地址，第二个参数是服务器上的文件名，还可以指定服务器IP。

我个人觉得，U-Boot的帮助系统虽然简陋，但足够用了。它不会像Linux的man手册那样长篇大论，而是直接告诉你参数格式和示例。如果你需要更详细的信息，可以查看U-Boot源码里的 doc/ 目录，或者直接读命令的C文件——很多命令的实现代码也就几百行，读起来并不难。

3.4 本章知识体系

下面这张图总结了U-Boot命令行的核心知识结构，你可以把它当作一张“地图”，随时回来对照。

这张图把U-Boot命令行分成了五个模块：信息查询、内存操作、网络操作、存储操作，以及贯穿始终的命令帮助系统。每个模块下都有对应的核心命令和典型用途。调试时遇到问题，先定位属于哪一类，再去找对应的命令，效率会高很多。