前言：

在瑞芯微平臺(tái)的項(xiàng)目開(kāi)發(fā)中，不少工程師都踩過(guò)這樣一個(gè)“詭異”的坑：setenv改完、saveenv也保存了，重啟設(shè)備后環(huán)境變量卻莫名地回到了默認(rèn)值。本文將帶你從現(xiàn)象到本質(zhì)，徹底搞懂U-Boot環(huán)境變量的存儲(chǔ)機(jī)制，并給出完整的配置方案。

一、問(wèn)題復(fù)現(xiàn)

日常開(kāi)發(fā)調(diào)試時(shí)，我們會(huì)需要修改 U-Boot 環(huán)境變量（比如調(diào)整啟動(dòng)延時(shí)bootdelay、修改啟動(dòng)命令），操作步驟很簡(jiǎn)單，舉個(gè)例子：

1. 設(shè)備上電，串口按Ctrl+C進(jìn)入 U-Boot 命令行；

2. 查看當(dāng)前變量：printenv；

3. 修改目標(biāo)變量（示例改啟動(dòng)延時(shí)為 3 秒）：setenv bootdelay 3；

4. 保存配置：saveenv，提示保存成功；

5. 重啟設(shè)備，再次printenv——修改完全消失，變回默認(rèn)值！

問(wèn)題的本質(zhì)在哪里？

二、根因分析

要理解這個(gè)現(xiàn)象，需要先搞清楚U-Boot環(huán)境變量的存儲(chǔ)機(jī)制。U-Boot在編譯時(shí)通過(guò)一系列CONFIG宏來(lái)決定環(huán)境變量的存儲(chǔ)位置，而瑞芯微平臺(tái)的SDK默認(rèn)配置是：

CONFIG_ENV_IS_NOWHERE

這個(gè)配置的語(yǔ)義非常直白——環(huán)境變量“無(wú)處可存”，這個(gè)配置下，環(huán)境變量?jī)H存在內(nèi)存中，saveenv只是臨時(shí)寫(xiě)入內(nèi)存，斷電 / 重啟后內(nèi)存數(shù)據(jù)清空，變量自然恢復(fù)默認(rèn)，這就是修改失效的根源。

想要永久保存變量，必須開(kāi)啟存儲(chǔ)介質(zhì)持久化配置，瑞芯微平臺(tái)常用且推薦以下選項(xiàng)：

因此對(duì)于瑞芯微平臺(tái)，尤其是使用eMMC作為存儲(chǔ)介質(zhì)的場(chǎng)景，推薦啟用CONFIG_ENV_IS_IN_MMC，將環(huán)境變量直接寫(xiě)入eMMC的指定扇區(qū)，實(shí)現(xiàn)真正的持久化存儲(chǔ)

三、解決方案

眺望電子的瑞芯微系列核心板均使用 EMMC 顆粒存儲(chǔ)，打開(kāi)CONFIG_ENV_IS_IN_MMC，搞定永久保存。

3.1開(kāi)啟Uboot核心配置

在U-Boot的配置中，關(guān)閉CONFIG_ENV_IS_NOWHERE，并啟用：

CONFIG_ENV_IS_IN_MMC

同時(shí)需要關(guān)注兩個(gè)關(guān)鍵參數(shù)：

CONFIG_ENV_OFFSET 0x3f8000 // 環(huán)境變量在eMMC中的起始偏移地址CONFIG_ENV_SIZE 0x8000 // 環(huán)境變量占用空間大?。J(rèn)32KB）

注意：CONFIG_ENV_OFFSET和CONFIG_ENV_SIZE的具體值需要根據(jù)你的分區(qū)表和固件布局來(lái)確認(rèn)。后續(xù)配置fw_env.config時(shí)也會(huì)用到這兩個(gè)值，務(wù)必保持一致。

完成上述配置后重新編譯U-Boot并燒錄，此時(shí)通過(guò)setenv + saveenv修改的環(huán)境變量就會(huì)被寫(xiě)入eMMC，重啟后依然有效。

3.2Linux 用戶(hù)空間操作環(huán)境變量

開(kāi)發(fā)后期，不想反復(fù)進(jìn) U-Boot 命令行，可在 Linux 系統(tǒng)下用fw_printenv/fw_setenv工具直接讀寫(xiě) EMMC 中的 U-Boot 環(huán)境變量，使用前需要確保：

已啟用 CONFIG_ENV_IS_IN_MMC（否則工具讀取不到有效數(shù)據(jù)）

正確配置 fw_env.config

在U-Boot源碼目錄下執(zhí)行：

./make.shenv

執(zhí)行命令后生成文件

此處需要配置env文件，匹配 EMMC 偏移和大小

git diff fw_env.configdiff --git a/u-boot/tools/env/fw_env.config b/u-boot/tools/env/fw_env.configindex 7916ebd..fd2f7aa 100644--- a/u-boot/tools/env/fw_env.config+++ b/u-boot/tools/env/fw_env.config@@ -8,8 +8,8 @@# NOR example# MTD device name Device offset Env. size Flash sector size Number of sectors-/dev/mtd1 0x0000 0x4000 0x4000-/dev/mtd2 0x0000 0x4000 0x4000+#/dev/mtd1 0x0000 0x4000 0x4000+#/dev/mtd2 0x0000 0x4000 0x4000# MTD SPI-dataflash example# MTD device name Device offset Env. size Flash sector size Number of sectors@@ -23,7 +23,7 @@# end of the device/partition, rather than a forwards offset from the start.# Block device example-#/dev/mmcblk0 0xc0000 0x20000+/dev/mmcblk0 0x3f8000 0x80000#/dev/mmcblk0 -0x20000 0x20000# VFAT example

編譯后將fw_env.config 移動(dòng)到板子的/etc 路徑下；

將fw_printenv 移動(dòng)到板子的/usr/local/bin 路徑下；

后續(xù)可用該工具進(jìn)行boot的變更，進(jìn)行fw_printenv 操作前需要先進(jìn)行fw_printenv 的軟連接

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

fw_printenv 查看某個(gè)變量：

fw_printenvbootdelay

使用fw_setenv設(shè)置環(huán)境變量 ：

fw_setenvbootdelay3fw_printenv

刪除一個(gè)環(huán)境變量：fw_setenv 變量 后不帶參數(shù)即為刪除該變量

fw_setenvbootdelay

注意：如果配置了CONFIG_ENV_IS_IN_MMC 配置，系統(tǒng)啟動(dòng)時(shí)會(huì)從emmc中讀取env信息，此處EMMC的env信息并不會(huì)隨著燒錄而進(jìn)行更改 將會(huì)永遠(yuǎn)保持不變。

可以通過(guò)瑞芯微的擦除所有扇區(qū)工具進(jìn)行清除，清除該EMMC的env信息之后，后續(xù)初次重啟將會(huì)變?yōu)槟J(rèn)的env信息。

四、進(jìn)階操作

如果需要固件攜帶一組默認(rèn)的環(huán)境變量，而不是依賴(lài)首次啟動(dòng)后的手動(dòng)配置，那如何從源碼中進(jìn)行環(huán)境變量的更改呢？？？

要想從源碼目錄進(jìn)行參數(shù)的更改需要進(jìn)行如下操作：

默認(rèn)環(huán)境變量定義在：

u-boot/include/env_default.h

找到default_environment數(shù)組，這里列出了所有編譯期固化的環(huán)境變量。例如，修改bootdelay的默認(rèn)值，可以找到：

"bootdelay="__stringify(CONFIG_BOOTDELAY)"\0"

然后修改對(duì)應(yīng)的CONFIG_BOOTDELAY配置即可。

如果需要添加全新的自定義環(huán)境變量，直接在數(shù)組中添加一行：

diff--git a/u-boot/include/env_default.h b/u-boot/include/env_default.hindex 853c290..446bfe6100644---a/u-boot/include/env_default.h+++b/u-boot/include/env_default.h@@-103,6+103,7@@ const uchar default_environment[]={#ifdefCONFIG_SYS_SOC "soc=" CONFIG_SYS_SOC "\0"#endif+ "YWF_ENV=" "2002""\0"#ifdefCONFIG_SILENT_CONSOLE "silent=enable\0"#endif

"YWF_ENV=""2002""\0"

重新編譯U-Boot后，這個(gè)新變量就會(huì)出現(xiàn)在默認(rèn)環(huán)境變量中，用戶(hù)依然可以通過(guò)setenv在運(yùn)行時(shí)覆蓋它。

五、總結(jié)

瑞芯微 U-Boot 環(huán)境變量修改失效，核心就是關(guān)閉CONFIG_ENV_IS_NOWHERE、開(kāi)啟CONFIG_ENV_IS_IN_MMC，配合saveenv即可永久保存；

本文從日常調(diào)試用 U-Boot 命令行，批量維護(hù)改源碼默認(rèn)值，后期運(yùn)維用 Linux 工具，三種場(chǎng)景全覆蓋，掌握這一套配置邏輯，無(wú)論是開(kāi)發(fā)調(diào)試還是量產(chǎn)維護(hù)，再也不用反復(fù)踩坑！