保姆级教程：在嵌入式Linux设备上，用fw_printenv/fw_setenv搞定U-Boot环境变量读写

嵌入式Linux实战：U-Boot环境变量配置全指南

在嵌入式Linux开发中，U-Boot环境变量扮演着系统启动和硬件配置的关键角色。无论是调整启动延迟、修改内核参数，还是配置网络设置，这些变量都直接影响着设备的运行行为。然而，对于刚接触嵌入式开发的新手来说，如何安全有效地读写这些变量往往是一个令人头疼的问题。本文将带你从零开始，逐步掌握fw_printenv和fw_setenv工具的使用技巧，避开那些容易踩的坑。

1. 环境准备与工具部署

1.1 理解U-Boot环境变量存储机制

U-Boot环境变量通常存储在Flash存储器的特定分区中，这个分区在Linux系统中通常表现为MTD设备。理解这一点至关重要，因为后续的所有操作都基于这个存储机制：

• MTD分区：在Linux中通过/proc/mtd文件查看
• 环境变量区域：通常标记为"env"或"ubootenv"
• 存储特性：需要考虑擦除块大小(erasesize)和总大小(size)

提示：不同厂商的板卡可能使用不同的Flash类型(NAND/NOR)，这会影响后续的配置参数。

1.2 获取fw_printenv/fw_setenv工具

虽然有些嵌入式系统已经预装了这些工具，但更多时候需要开发者自行部署。获取方式主要有两种：

1. 从U-Boot源码编译：

   # 进入U-Boot源码目录 cd u-boot-2021.04 # 编译envtools make envtools

   编译完成后，工具位于tools/env/目录下。

2. 从发行版仓库安装：

   # Debian/Ubuntu sudo apt install u-boot-tools # Buildroot配置 make menuconfig -> Target packages -> Hardware handling -> u-boot tools

将生成的fw_printenv和fw_setenv复制到目标板的/usr/bin目录，并确保具有可执行权限。

2. 关键配置文件详解

2.1 /etc/fw_env.config解析

这个配置文件是整套工具的核心，它告诉工具在哪里以及如何访问环境变量存储区。一个典型的配置如下：

# MTD设备名 设备偏移量 环境区大小 擦除块大小 扇区数量 /dev/mtd1 0x0000 0x40000 0x10000

各参数含义：

2.2 从/proc/mtd获取关键参数

通过查看/proc/mtd可以确定上述配置参数的正确值：

cat /proc/mtd

示例输出：

dev: size erasesize name mtd0: 000c0000 00010000 "boot" mtd1: 00040000 00010000 "env" mtd2: 00600000 00010000 "system"

从这个输出我们可以确定：

• 环境变量存储在mtd1设备
• 大小为0x40000(256KB)
• 擦除块大小为0x10000(64KB)

2.3 常见配置错误排查

新手常遇到的几个问题：

1. Bad CRC错误：通常表示配置不正确或Flash内容损坏
2. 权限问题：确保对MTD设备有读写权限
3. 参数不匹配：擦除块大小必须与实际硬件一致

注意：修改fw_env.config后，建议删除/etc/fw_env.config.lock文件（如果存在），以避免锁冲突。

3. 环境变量操作实战

3.1 查看当前环境变量

使用fw_printenv可以列出所有环境变量：

fw_printenv

典型输出：

baudrate=115200 bootargs=console=ttyS0,115200 bootcmd=run loadimage; run loadfdt; bootm 0x82000000 - 0x83000000 bootdelay=2

3.2 修改环境变量

fw_setenv用于设置变量，但通常需要先创建符号链接：

ln -s /usr/bin/fw_printenv /usr/bin/fw_setenv

然后可以设置变量：

# 设置启动延迟为3秒 fw_setenv bootdelay 3 # 设置自定义变量 fw_setenv my_custom_var "Hello, Embedded World"

3.3 批量操作技巧

如果需要设置多个变量，可以创建一个脚本文件：

fw_setenv script " bootdelay=3 baudrate=115200 bootcmd=run loadimage; run loadfdt; bootm 0x82000000 - 0x83000000 "

或者使用heredoc语法：

fw_setenv script <<EOF bootdelay=3 baudrate=115200 bootcmd=run loadimage; run loadfdt; bootm 0x82000000 - 0x83000000 EOF

4. 高级技巧与故障排除

4.1 环境变量备份与恢复

为了防止意外丢失配置，定期备份环境变量是个好习惯：

# 备份到文件 fw_printenv > uboot_env_backup.txt # 从文件恢复 while read line; do [ -n "$line" ] && fw_setenv ${line%=*} "${line#*=}" done < uboot_env_backup.txt

4.2 常见错误处理

1. "Warning: Bad CRC"：

   • 检查/etc/fw_env.config配置是否正确
   • 确认MTD设备是否可访问
   • 尝试擦除环境分区并重新设置

2. 权限被拒绝：

   sudo chmod 666 /dev/mtd1

   或配置udev规则永久解决权限问题

3. 变量设置不生效：

   • 确保没有语法错误
   • 检查变量名是否正确（大小写敏感）
   • 重启系统验证是否持久化

4.3 性能优化建议

1. 减少环境变量大小：只保留必要的变量，减少启动解析时间
2. 合理组织变量：相关变量放在一起，便于维护
3. 使用脚本变量：复杂操作通过脚本实现，减少环境变量数量

5. 实际应用案例

5.1 修改系统启动参数

假设我们需要修改内核启动参数：

# 查看当前启动参数 fw_printenv bootargs # 修改控制台参数 fw_setenv bootargs "console=ttyS0,115200n8 root=/dev/mmcblk0p2 rootwait"

5.2 配置网络启动

设置从网络加载内核：

fw_setenv ipaddr 192.168.1.100 fw_setenv serverip 192.168.1.1 fw_setenv netmask 255.255.255.0 fw_setenv bootcmd "dhcp; tftp 0x82000000 zImage; bootm 0x82000000"

5.3 实现双系统启动

通过环境变量实现启动选择：

fw_setenv bootcmd_linux "setenv bootargs ${bootargs} root=/dev/mmcblk0p2; ext4load mmc 0:1 0x82000000 /boot/zImage; bootm 0x82000000" fw_setenv bootcmd_rtos "setenv bootargs ${bootargs}; ext4load mmc 0:2 0x82000000 /rtos.bin; bootm 0x82000000" fw_setenv bootcmd "run bootcmd_linux"

6. 底层原理深入

理解工具背后的工作原理有助于更好地使用和调试：

1. 存储格式：U-Boot环境变量通常以CRC32校验的键值对形式存储
2. 冗余设计：多数实现使用两个相同区域，防止写入失败导致数据丢失
3. Flash特性：必须遵循擦除-写入的流程，直接覆盖会导致数据损坏

在实际项目中遇到过一个棘手问题：某次更新环境变量后系统无法启动。通过分析发现是因为Flash的某个块损坏，导致写入不完整。解决方案是：

1. 使用flash_erase命令擦除整个环境分区
2. 重新设置所有必要的环境变量
3. 在fw_env.config中增加冗余环境区域配置

这种深入理解让我们能够快速定位和解决生产环境中遇到的类似问题。