【产出】 > 搞清楚 U-Boot 在嵌入式 Linux 启动链里做什么,能通过串口打断自动启动、进入 U-Boot 命令行,用 printenv / setenv / saveenv 管理环境变量,看懂 bootargs 和 bootcmd,并能从 TFTP 或 SD 卡 / eMMC 手动加载内核和设备树启动,开发阶段改内核不必反复烧卡。
【版本】 > 按 U-Boot 官方文档(docs.u-boot.org)的环境变量、命令行解析、env / printenv / load / booti / bootz 命令页面编写。命令是否可用取决于开发板 U-Boot 的编译配置,以板子上
help的输出为准。
一、U-Boot 在启动链里的位置
以常见的 ARM 开发板为例,上电后依次运行:
| 阶段 | 做什么 |
|---|---|
| 芯片内部 BootROM | 固化在 SoC 里,按启动引脚从 SD 卡、eMMC、SPI Flash 等读出第一段程序 |
| SPL | U-Boot 的精简版。官方文档的描述是:初始化 SDRAM,再加载完整的 U-Boot,也可以加载其他固件(如 ARM Trusted Firmware) |
| U-Boot proper | 完整的 U-Boot。官方说明只有这一阶段带命令行,并负责加载操作系统 |
| Linux 内核 | 由 U-Boot 放到内存后跳转执行,接收设备树和命令行参数 |
BootROM 能用的片上 SRAM 很小,装不下完整的 U-Boot,所以要先跑 SPL 把 DDR 内存初始化好。有些平台在 SPL 之前还有 TPL,不同 SoC 的组合不一样。
U-Boot 交给内核的东西有三样:内核镜像、设备树(dtb)、内核命令行(bootargs),可选再加一个 initramfs。后面所有操作都围绕这三样展开。
二、通过串口进入命令行
- 用 USB 转 TTL 串口线连接开发板调试串口的 TX、RX、GND(TX 接 RX,RX 接 TX,不要接 VCC)。
- 电脑上打开串口终端,波特率通常是 115200(官方文档中
baudrate的默认值来自CONFIG_BAUDRATE,常见为 115200):
sudo apt install -y picocom
sudo picocom -b 115200 /dev/ttyUSB0
- 给板子上电,看到类似
Hit any key to stop autoboot: 3的倒计时时按任意键,出现提示符=>就进入了命令行。
倒计时的长度由环境变量 bootdelay 控制:
| bootdelay | 行为 |
|---|---|
| 正数 N | 等待 N 秒,期间可按键打断 |
0 | 立即启动,但仍可打断 |
-1 | 关闭自动启动,停在命令行 |
-2 | 立即启动,不检查按键,无法打断 |
【提示】 > 进入命令行后先输入
help看有哪些命令,help 命令名看具体用法。厂商的 U-Boot 经常裁剪命令或保留旧写法,以板子上的help为准。
三、环境变量:printenv / setenv / saveenv
U-Boot 的配置几乎都放在环境变量里。新写法是 env 子命令,老写法的单独命令仍作为别名保留:
| 新写法 | 老写法 | 作用 |
|---|---|---|
env print [name ...] | printenv | 打印全部或指定变量 |
env set name value | setenv | 新建或修改变量,不给 value 就是删除 |
env save | saveenv | 把当前环境写入 Flash / eMMC 等持久存储 |
env default -a | 把全部变量恢复为编译时的默认值 | |
env delete name | 删除变量 |
=> printenv bootcmd
=> setenv bootdelay 5
=> saveenv
set、default、delete 都只改内存里的副本,不执行 saveenv,断电重启后修改全部丢失。这也是一个安全习惯:先只 setenv 试,确认能启动了再 saveenv。
【注意】 > 存放环境变量的 Flash 区域被擦除或损坏后,U-Boot 会回退到编译进去的默认环境。
ethaddr(MAC 地址)、serial#这类变量只能设置一次,之后不能修改或删除,除非 U-Boot 编译时开启了CONFIG_ENV_OVERWRITE。
命令行语法要点(官方"Command-line Parsing"页):
- 一行可以写多条命令,用
;分隔。其中一条失败,后面的仍会继续执行。 - 用
${name}引用变量。要把$、;原样存进变量,用\转义,或者整段用单引号括起来。 - 数字参数默认是十六进制,不需要加
0x。 run 变量名把变量内容当作命令执行,可以把常用流程存成变量。
四、bootcmd 与 bootargs
| 变量 | 含义 |
|---|---|
bootcmd | 倒计时结束、没人打断时自动执行的命令 |
bootargs | 传给内核的命令行参数 |
先看板子现在怎么启动:
=> printenv bootcmd
=> printenv bootargs
bootcmd 往往是一串 run xxx,顺着变量名一层层 printenv 下去,就能看清完整的启动逻辑。较新的 U-Boot 采用"标准启动"(bootstd):自动扫描各存储设备上的 extlinux/extlinux.conf 或 EFI 启动文件,官方给出的一条命令写法是 bootflow scan -lb(-l 列出找到的启动项,-b 依次尝试启动)。
bootargs 的典型内容:
=> setenv bootargs 'console=ttyS0,115200 root=/dev/mmcblk0p2 rootwait rw'
| 参数 | 作用 |
|---|---|
console= | 内核日志输出到哪个串口、什么波特率。串口设备名因 SoC 而异,如 ttyS0、ttyAMA0、ttymxc0 |
root= | 根文件系统所在分区 |
rootwait | 等待存储设备就绪后再挂载根文件系统,SD 卡、USB 设备常用 |
rw | 以读写方式挂载根文件系统 |
五、加载地址
加载文件前要决定放到内存哪里。官方约定了一组变量名(这些名字是惯例,并不是 U-Boot 写死的):
| 变量 | 放什么 |
|---|---|
kernel_addr_r | 内核镜像 |
fdt_addr_r | 设备树 dtb |
ramdisk_addr_r | initramfs |
loadaddr | 未指定地址时 tftpboot、load 等命令的默认地址 |
多数板子的默认环境已经设好这些值,printenv kernel_addr_r fdt_addr_r 看一下即可。官方提醒:设备树必须 8 字节对齐,各个文件在内存里不能重叠。自己改地址时,要给内核留出足够空间(压缩前的大小)。
六、从 SD 卡 / eMMC 加载并启动
load 命令从文件系统读文件到内存,格式为:
load <接口> <设备号[:分区号]> <内存地址> <文件名>
以 64 位 ARM 为例,假设内核和 dtb 在 mmc 0 的第 1 个分区:
=> load mmc 0:1 ${kernel_addr_r} Image
=> load mmc 0:1 ${fdt_addr_r} myboard.dtb
=> setenv bootargs 'console=ttyS0,115200 root=/dev/mmcblk0p2 rootwait rw'
=> booti ${kernel_addr_r} - ${fdt_addr_r}
每次 load 成功后,U-Boot 把读到的字节数写进 filesize 变量。启动命令按内核格式选:
| 命令 | 内核格式 | 语法 |
|---|---|---|
booti | ARM64 等使用的 Image(可压缩) | booti 内核地址 [initrd地址[:大小]] [dtb地址] |
bootz | 32 位 ARM 的 zImage | bootz 内核地址 [initrd地址[:大小]] [dtb地址] |
bootm | U-Boot 传统镜像(uImage)或 FIT 镜像 | bootm 地址 [initrd] [dtb] |
中间的 - 表示"有设备树但没有 initramfs"。带 initramfs 时写成 ${ramdisk_addr_r}:${filesize},所以加载 initramfs 必须是最后一个 load,紧接着执行启动命令,filesize 才是 initramfs 的大小。
七、从 TFTP 网络加载
开发阶段最省事的方式:内核在电脑上编译好,放进 TFTP 服务器目录,板子每次启动从网络拉取,不用拔插 SD 卡。
电脑端(Ubuntu):
sudo apt install -y tftpd-hpa # 默认目录一般是 /srv/tftp
sudo cp arch/arm64/boot/Image arch/arm64/boot/dts/厂商/myboard.dtb /srv/tftp/
板子端,tftpboot 的格式为 tftpboot [加载地址] [[服务器IP:]文件名],需要先设置板子 IP ipaddr 和服务器 IP serverip:
=> setenv ipaddr 192.168.1.50
=> setenv serverip 192.168.1.10
=> ping ${serverip}
=> tftpboot ${kernel_addr_r} Image
=> tftpboot ${fdt_addr_r} myboard.dtb
=> booti ${kernel_addr_r} - ${fdt_addr_r}
局域网有 DHCP 时,也可以用 dhcp 自动获取地址。注意 dhcp 默认获取地址后还会尝试下载启动文件;只想拿地址时,先 setenv autoload no(官方说明:autoload 以 n 开头时只获取配置、不下载)。
确认能启动后,把整套流程存成 bootcmd:
=> setenv netboot 'tftpboot ${kernel_addr_r} Image; tftpboot ${fdt_addr_r} myboard.dtb; booti ${kernel_addr_r} - ${fdt_addr_r}'
=> setenv bootcmd 'run netboot'
=> saveenv
用单引号括起来,${...} 和 ; 会原样存进变量,等 run 时再展开;不加引号的话,setenv 时就会被立即展开或截断。
【注意】 > 改 bootcmd 前先
printenv bootcmd把原值记下来。新 bootcmd 出错导致无法启动时,只要还能打断倒计时,就可以setenv回原值;bootdelay被设成-2后就打断不了,慎改。
八、常见问题
| 现象 | 排查方向 |
|---|---|
| 串口无输出或乱码 | TX/RX 接反、地线没接、波特率不对 |
Starting kernel ... 后再无输出 | console= 设备名或波特率不对;dtb 与板子不匹配;内核与 dtb 内存区域重叠 |
| 内核报找不到根文件系统 | root= 分区不对,SD 卡上缺少 rootwait |
| TFTP 一直超时 | 先 ping ${serverip};检查电脑防火墙是否放行 UDP 69 端口、服务目录和文件名是否正确 |
| 重启后修改丢失 | 没有执行 saveenv,或板子的环境存储没有配置 |
| 命令不存在 | 该命令没编译进这版 U-Boot,用 help 查看现有命令 |
参考资料
- 环境变量:https://docs.u-boot.org/en/latest/usage/environment.html
- env 命令:https://docs.u-boot.org/en/latest/usage/cmd/env.html
- printenv 命令:https://docs.u-boot.org/en/latest/usage/cmd/printenv.html
- 命令行解析:https://docs.u-boot.org/en/latest/usage/cmdline.html
- 从 TPL / SPL 启动:https://docs.u-boot.org/en/latest/usage/spl_boot.html
- load 命令:https://docs.u-boot.org/en/latest/usage/cmd/load.html
- booti 命令:https://docs.u-boot.org/en/latest/usage/cmd/booti.html
- bootz 命令:https://docs.u-boot.org/en/latest/usage/cmd/bootz.html
- 标准启动(bootstd):https://docs.u-boot.org/en/latest/develop/bootstd/overview.html
- tftpboot / dhcp / ping 命令定义(U-Boot 源码 cmd/net.c):https://github.com/u-boot/u-boot/blob/master/cmd/net.c
评价 (0)