U-Boot 核心配置——printenv / setenv / saveenv 环境变量操作本文由黒漂技术佬原创首发于 CSDN转载请注明出处。一、引言如果说 U-Boot 是一台嵌入式瑞士军刀那环境变量就是军刀上的刻度盘——你通过它告诉 U-Boot 该怎么启动、从哪加载内核、网络怎么配、文件系统在哪。上一篇文章我们简单用printenv偷窥了一下环境变量今天我们来彻底搞懂这块内容包括怎么改、怎么保存、以及不小心改坏了怎么救回来。二、环境变量的本质2.1 存在哪里环境变量不是凭空存在的它需要一块物理存储空间。U-Boot 支持多种存储后端存储位置典型场景可靠性NOR Flash 的某个扇区老式嵌入式设备高NAND Flash 的环境分区大多数 ARM 开发板中需 ECCMMC/SD 卡的特殊扇区eMMC 启动的设备高SPI FlashIoT 设备高文件FAT/EXT4开发调试阶段低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// 8KB2.2 数据结构环境变量在存储介质上的格式很简单每一行是一条namevalue以\0分隔末尾用双\0结束。这本质上就是一个字符串数组以 CRC32 校验头开始。[CRC32][key1value1\0key2value2\0...\0\0]三、环境变量操作三板斧3.1printenv——查看说是三板斧其实这个最常用我们详细展开。# 查看全部环境变量printenv# 查看特定变量printenvbootcmdprintenvipaddr serverip如果变量不存在printenv不会报错只是不输出任何东西 printenv nonexist 这在写脚本时需要留意——别拿不存在的变量当条件判断。3.2setenv——修改 / 新增# 修改已有变量setenv bootdelay5# 新增变量setenv myname heidiaotec# 删除变量设为空setenv myname重点提醒setenv只改了内存中的值重启就没了。要想持久化必须接一句saveenv。setenv的值可以包含空格、特殊字符也能引用其他变量setenv loadaddr 0x82000000setenv fdtaddr 0x88000000setenv bootargsconsolettyO0,115200n8root/dev/mmcblk0p2 ro rootwait# 变量嵌套展开注意 $ 可能会被 Shell 转义实际在 U-Boot 中直接写setenv mmc_loadfatload mmc 0:1 $loadaddr zImage3.3saveenv——保存到物理存储saveenv Saving Environment to MMC... Writing to MMC(0)... OK没有这句话你所有的setenv重启后就灰飞烟灭。我见过不少新手调了半天启动参数重新上电发现又回到原样急得抓耳挠腮——往往就是忘了saveenv。3.4 补充editenv——交互式编辑setenv适合短字符串但如果bootcmd长达 200 个字符在一行里折腾就太痛苦了。这时候用editenveditenv bootcmd edit: run findfdt;run mmcboot;setenv mmcdev1;...editenv会打开一个简易的编辑界面依赖CONFIG_CMD_EDITENV可以用左右箭头移动光标进行修改。四、常用环境变量速查表以下是嵌入式 U-Boot 中最核心的几十个环境变量建议收藏。4.1 启动控制变量作用示例值bootdelay自动启动前的等待秒数3bootcmd自动启动时执行的命令序列run mmcbootbootargs传递给 Linux 内核的命令行参数consolettyO0,115200n8 root/dev/mmcblk0p2 rwbootfile默认加载的镜像文件名zImage4.2 内存布局变量作用示例值loadaddr内核镜像加载到 DDR 的目标地址0x82000000fdtaddr设备树文件加载目标地址0x88000000rdaddrinitrd/initramfs 加载目标地址0x880800004.3 网络配置变量作用示例值ipaddr开发板 IP 地址192.168.1.100serveripTFTP/NFS 服务器 IP192.168.1.200netmask子网掩码255.255.255.0gatewayip网关地址192.168.1.1ethaddrMAC 地址68:c9:0b:4d:12:a84.4 设备与文件系统变量作用示例值mmcdev默认 MMC 设备编号0mmcroot根文件系统路径/dev/mmcblk0p2 rofdtfile设备树文件名am335x-boneblack.dtbconsole控制台设备ttyO0,115200n84.5 自定义变量脚本用法U-Boot 允许你创建任意自定义变量来组织启动脚本。比如setenv load_kernelfatload mmc 0:1 $loadaddr zImagesetenv load_fdtfatload mmc 0:1 $fdtaddr $fdtfilesetenv boot_kernelbootz $loadaddr - $fdtaddrsetenv mmcbootrun load_kernel; run load_fdt; run boot_kernelsetenv bootcmdrun mmcbootsaveenv这种拼积木式的写法是 U-Boot 脚本编程的精髓——每个run执行一个或多个命令组合起来实现复杂的启动流程。五、环境变量的高级玩法5.1 条件判断U-Boot 支持简单的条件判断通过if...then...else...fi语法setenv bootcmdif mmc rescan; then run mmcboot; else run netboot; fi这行命令的意思是先扫描 MMC 设备如果扫描成功就走 MMC 启动否则走网络启动。对于批量生产来说这种多启动路径回退机制非常重要。5.2 从脚本文件加载环境变量除了setenvsaveenv还可以把一个脚本文件通常是boot.scr或uEnv.txt放在 SD 卡上U-Boot 启动时会自动加载# boot.scr 的生成方式在 PC 上mkimage-Aarm-Olinux-Tscript-Cnone-a0-e0\-nBoot Script-dboot.cmd boot.scrboot.cmd的内容就是一行行 U-Boot 命令比如setenv bootargs consolettyO0,115200n8 root/dev/mmcblk0p2 rw rootwait fatload mmc 0:1 0x82000000 zImage fatload mmc 0:1 0x88000000 am335x-boneblack.dtb bootz 0x82000000 - 0x88000000U-Boot 启动时执行类似这样的命令fatload mmc0:1$loadaddrboot.scrsource$loadaddr5.3 环境变量备份与恢复不小心把环境变量改坏了如果之前有备份可以在 U-Boot 中恢复。如果没有备份可以重新烧录默认环境# 恢复出厂默认环境依赖 CONFIG_ENV_DEFAULTenvdefault-asaveenv或者在编译时指定默认值在板卡的 defconfig 或头文件中这样即使存储区的环境损坏U-Boot 也会退回到编译时的默认配置。六、常见踩坑汇总坑1改了setenv忘记saveenv重启就变回去了。这是最经典的坑值都写好了调试半天发现没生效结果是没保存。养成肌肉记忆setenv后必跟saveenv。坑2环境变量 CRC 校验失败。如果环境变量存储区被意外擦除或写入脏数据U-Boot 启动时会打印*** Warning - bad CRC, using default environment这时候 U-Boot 会回退到编译时的默认环境变量所有自定义配置丢失。解决重新setenvsaveenv。坑3bootargs里写了中文或特殊字符导致乱码。环境变量本质上是 ASCII 字符串别往里塞 Unicode。路径名、文件名一律用英文。坑4saveenv提示 “ERROR” 或卡住。大概率是存储介质还没初始化好。先执行mmc rescan再saveenv。七、总结环境变量是 U-Boot 的灵魂理解透了它你就掌握了控制启动流程的钥匙printenv看配置setenv改配置saveenv存配置。环境变量分为系统预定义如bootargs、bootcmd和自定义变量通过run命令串联。熟练运用if...then...else...fi可以实现多路径启动回退。boot.scr/uEnv.txt是外部脚本化的环境变量管理方式开发调试阶段非常方便。下一篇我们深挖所有环境变量中最关键的一个——bootargs搞清楚内核命令行参数的每一个字段。