U-Boot 核心配置——printenv / setenv / saveenv 环境变量操作

本文由黒漂技术佬原创，首发于 CSDN，转载请注明出处。

一、引言

如果说 U-Boot 是一台"嵌入式瑞士军刀"，那环境变量就是军刀上的刻度盘——你通过它告诉 U-Boot 该怎么启动、从哪加载内核、网络怎么配、文件系统在哪。上一篇文章我们简单用printenv偷窥了一下环境变量，今天我们来彻底搞懂这块内容，包括怎么改、怎么保存、以及不小心改坏了怎么救回来。

二、环境变量的本质

2.1 存在哪里？

环境变量不是凭空存在的，它需要一块物理存储空间。U-Boot 支持多种存储后端：

U-Boot 在编译时通过CONFIG_ENV_IS_IN_xxx来确定环境变量的存储位置。以常见配置为例：

// include/configs/am335x_evm.h 或 .config 中#defineCONFIG_ENV_IS_IN_MMC// 存在 MMC 中#defineCONFIG_ENV_OFFSET0x260000// 偏移地址#defineCONFIG_ENV_SIZE0x2000// 8KB

2.2 数据结构

环境变量在存储介质上的格式很简单：每一行是一条name=value，以\0分隔，末尾用双\0结束。这本质上就是一个字符串数组，以 CRC32 校验头开始。

[CRC32][key1=value1\0key2=value2\0...\0\0]

三、环境变量操作三板斧

3.1printenv——查看

说是"三板斧"，其实这个最常用，我们详细展开。

# 查看全部环境变量=>printenv# 查看特定变量=>printenvbootcmd=>printenvipaddr serverip

如果变量不存在，printenv不会报错，只是不输出任何东西：

=> printenv nonexist =>

这在写脚本时需要留意——别拿不存在的变量当条件判断。

3.2setenv——修改 / 新增

# 修改已有变量=>setenv bootdelay5# 新增变量=>setenv myname heidiaotec# 删除变量（设为空）=>setenv myname

重点提醒：setenv只改了内存中的值，重启就没了。要想持久化，必须接一句saveenv。

setenv的值可以包含空格、特殊字符，也能引用其他变量：

=>setenv loadaddr 0x82000000=>setenv fdtaddr 0x88000000=>setenv bootargsconsole=ttyO0,115200n8root=/dev/mmcblk0p2 ro rootwait# 变量嵌套展开（注意 $ 可能会被 Shell 转义，实际在 U-Boot 中直接写）=>setenv mmc_load'fatload mmc 0:1 $loadaddr zImage'

3.3saveenv——保存到物理存储

=>saveenv Saving Environment to MMC... Writing to MMC(0)... OK

没有这句话，你所有的setenv重启后就"灰飞烟灭"。我见过不少新手调了半天启动参数，重新上电发现又回到原样，急得抓耳挠腮——往往就是忘了saveenv。

3.4 补充：editenv——交互式编辑

setenv适合短字符串，但如果bootcmd长达 200 个字符，在一行里折腾就太痛苦了。这时候用editenv：

=>editenv bootcmd edit: run findfdt;run mmcboot;setenv mmcdev1;...

editenv会打开一个简易的编辑界面（依赖CONFIG_CMD_EDITENV），可以用左右箭头移动光标进行修改。

四、常用环境变量速查表

以下是嵌入式 U-Boot 中最核心的几十个环境变量，建议收藏。

4.1 启动控制

4.2 内存布局

4.3 网络配置

4.4 设备与文件系统

4.5 自定义变量（脚本用法）

U-Boot 允许你创建任意自定义变量来组织启动脚本。比如：

=>setenv load_kernel'fatload mmc 0:1 $loadaddr zImage'=>setenv load_fdt'fatload mmc 0:1 $fdtaddr $fdtfile'=>setenv boot_kernel'bootz $loadaddr - $fdtaddr'=>setenv mmcboot'run load_kernel; run load_fdt; run boot_kernel'=>setenv bootcmd'run mmcboot'=>saveenv

这种"拼积木"式的写法是 U-Boot 脚本编程的精髓——每个run执行一个或多个命令，组合起来实现复杂的启动流程。

五、环境变量的高级玩法

5.1 条件判断

U-Boot 支持简单的条件判断，通过if...then...else...fi语法：

=>setenv bootcmd'if mmc rescan; then run mmcboot; else run netboot; fi'

这行命令的意思是：先扫描 MMC 设备，如果扫描成功就走 MMC 启动，否则走网络启动。对于批量生产来说，这种多启动路径回退机制非常重要。

5.2 从脚本文件加载环境变量

除了setenv+saveenv，还可以把一个脚本文件（通常是boot.scr或uEnv.txt）放在 SD 卡上，U-Boot 启动时会自动加载：

# boot.scr 的生成方式（在 PC 上）mkimage-Aarm-Olinux-Tscript-Cnone-a0-e0\-n"Boot Script"-dboot.cmd boot.scr

boot.cmd的内容就是一行行 U-Boot 命令，比如：

setenv bootargs console=ttyO0,115200n8 root=/dev/mmcblk0p2 rw rootwait fatload mmc 0:1 0x82000000 zImage fatload mmc 0:1 0x88000000 am335x-boneblack.dtb bootz 0x82000000 - 0x88000000

U-Boot 启动时执行类似这样的命令：

fatload mmc0:1$loadaddrboot.scrsource$loadaddr

5.3 环境变量备份与恢复

不小心把环境变量改坏了？如果之前有备份，可以在 U-Boot 中恢复。如果没有备份，可以重新烧录默认环境：

# 恢复出厂默认环境（依赖 CONFIG_ENV_DEFAULT）=>envdefault-a=>saveenv

或者在编译时指定默认值（在板卡的 defconfig 或头文件中），这样即使存储区的环境损坏，U-Boot 也会退回到编译时的默认配置。

六、常见踩坑汇总

坑1：改了setenv忘记saveenv，重启就变回去了。
这是最经典的坑，值都写好了，调试半天发现没生效，结果是没保存。养成肌肉记忆：setenv后必跟saveenv。

坑2：环境变量 CRC 校验失败。
如果环境变量存储区被意外擦除或写入脏数据，U-Boot 启动时会打印：

*** Warning - bad CRC, using default environment

这时候 U-Boot 会回退到编译时的默认环境变量，所有自定义配置丢失。解决：重新setenv+saveenv。

坑3：bootargs里写了中文或特殊字符导致乱码。
环境变量本质上是 ASCII 字符串，别往里塞 Unicode。路径名、文件名一律用英文。

坑4：saveenv提示 “ERROR” 或卡住。
大概率是存储介质还没初始化好。先执行mmc rescan再saveenv。

七、总结

环境变量是 U-Boot 的灵魂，理解透了它，你就掌握了控制启动流程的钥匙：

1. printenv看配置，setenv改配置，saveenv存配置。
2. 环境变量分为系统预定义（如bootargs、bootcmd）和自定义变量，通过run命令串联。
3. 熟练运用if...then...else...fi可以实现多路径启动回退。
4. boot.scr/uEnv.txt是外部脚本化的环境变量管理方式，开发调试阶段非常方便。

下一篇，我们深挖所有环境变量中最关键的一个——bootargs，搞清楚内核命令行参数的每一个字段。