提示的错误为Saving Environment to FAT ... Unable to use mmc 0:1... Failed（1）

楼兰公子2026-04-29 10:04

有这个报错，说明你的U-Boot正尝试将环境变量（env）保存到FAT分区，但未能成功访问到目标的MMC设备或分区。这通常是U-Boot配置与启动介质（SD卡/eMMC）不匹配导致的。

🎯 问题现象与根本原因

错误信息 Saving Environment to FAT... Unable to use mmc 0:1... 清晰地指向了问题所在。

  • 现象解读：U-Boot想要把环境变量保存到某个FAT格式的分区，但这个过程失败了。
  • 根本原因 ：最常见的原因是：
    1. 介质/格式不匹配：U-Boot默认尝试保存的MMC设备（如mmc 0或mmc 1）与你的实际启动介质（SD卡或eMMC）不符。另一个可能是目标分区并非FAT/FAT32格式。
    2. 功能未开启 ：编译U-Boot时，对应的环境变量持久化功能（如 CONFIG_ENV_IS_IN_FAT 或 CONFIG_ENV_IS_IN_MMC）未正确配置。

📝 解决方法

问题很明确，从根本上解决问题又分为两种方式，你可以根据自己的情况选择：

方案一：粗放型修复（推荐，更可靠）

这个方案的核心是重新编译U-Boot，将环境变量保存到更可靠的RAW分区中，而非FAT文件系统，从而完全规避此类问题。

步骤 操作
1. 确认启动介质 在U-Boot命令行输入 mmc list，根据输出判断哪一个是你的启动SD卡（例如mmc 0是SD卡，mmc 1是eMMC）。
2. 修改U-Boot配置 执行 make menuconfig，在 Environment 菜单下进行配置，参考下表：
3. 重新编译并烧录 保存配置并退出，重新编译U-Boot（make），然后用新编译的 u-boot.bin 或 idbloader.img 烧录到你的启动介质。

menuconfig 配置要点：

在 Environment 菜单（通常在 Command line interface -> Environment 下），你需要进行以下设置：

  • 选择 Environment in MMC device (对应 CONFIG_ENV_IS_IN_MMC=y)。
  • 设置 MMC device number where to store the ENV (对应 CONFIG_SYS_MMC_ENV_DEV) 为你第一步确认的启动设备号。
  • 设置 Environment in a MMC partition (通常是"auto")。
  • 取消选中 Environment in a FAT filesystem 选项。
  • 如果使用SD卡，可能还需要修改 CONFIG_ENV_FAT_DEVICE_AND_PART 等宏定义来绑定正确的设备。
方案二：精准型修复（更快捷，值得尝试）

此方案不重新编译U-Boot，仅通过U-Boot命令进行修正，但成功率可能略低。

  1. 手动分区格式化：在PC上将SD卡的第一个分区格式化为FAT32格式。

  2. 修正并保存 ：将SD卡插回开发板，进入U-Boot命令行，执行以下命令：

    bash 复制代码 
    # 修正环境变量存储设备 (通常0为SD卡，1为eMMC)
setenv mmc_dev 0
# 手动指定环境变量的存储位置和文件名
setenv env_dev mmc 0:1
setenv env_file uboot.env
# 保存设置并重启
saveenv
reset

    如果 saveenv 还是报错，可以尝试手动创建一个空的环境变量文件： fatwrite mmc 0:1 ${loadaddr} uboot.env 0x8000。

👍 验证结果

完成以上任一方案的修复后，在U-Boot命令行中设置一个临时变量（如 setenv test 1），然后输入 saveenv。如果不再报错，并显示类似 Saving Environment to MMC... Writing to MMC(0)... OK 的信息，就说明问题已经成功解决。

💡 备选方案：硬编码TFTP/NFS启动

如果你只是为了实现TFTP/NFS网络启动而需要 saveenv，还有一个"简单粗暴"的备选方案：直接将启动命令硬编码到U-Boot源码中，绕过环境变量保存这一步。

  1. 找到板级头文件 ：在U-Boot源码中找到你开发板的配置文件，路径通常是 include/configs/你的板子名.h。

  2. 修改宏定义 ：在头文件中找到 CONFIG_EXTRA_ENV_SETTINGS 宏，在其中"硬编码"TFTP/NFS的启动命令。一个典型的定义如下：

    c 复制代码 
    #define CONFIG_EXTRA_ENV_SETTINGS \
    "serverip=192.168.1.100\0" \
    "ipaddr=192.168.1.101\0" \
    "bootcmd=dhcp; tftp 0x1000000 Image; tftp 0x2000000 rk3588-orangepi-5-plus.dtb; booti 0x1000000 - 0x2000000\0"

  3. 重新编译并烧录：这样U-Boot每次启动就会自动执行这个"硬编码"的启动命令，而无需交互或保存环境变量。

你这个思路很清楚。确实，Orange Pi 5 Plus (RK3588) 无法保存 U-Boot 环境变量是个棘手问题，这通常意味着官方预编译的 U-Boot 镜像默认没有开启 saveenv 功能。

要彻底解决这个问题，最可靠的方法是重新编译一个支持 saveenv 的 U-Boot。以下是具体的操作步骤和备选方案。

🛠️ 终极方案：编译支持 saveenv 的 U-Boot

这个方案能从源码层面解决问题，一劳永逸。

🚧 准备工作：Boot from SD Card

在编译新U-Boot之前，先确保Orange Pi 5 Plus能从SD卡启动，这能让你避免反复烧录eMMC。

  1. 烧录官方镜像：先按照官方文档，将Orange Pi OS或其他系统镜像烧录到一张MicroSD卡中。
  2. 验证启动：将SD卡插入开发板，并确保其作为第一启动设备。
  3. 连接串口 ：通过串口（如/dev/ttyS0）连接到开发板的调试串口，方便我们后续查看U-Boot的启动日志。
1. 获取源码并配置

拉取支持RK3588的U-Boot源码，以Rockchip的U-Boot仓库为例：

bash 复制代码 
git clone https://github.com/rockchip-linux/u-boot.git
cd u-boot

关键配置 ：编辑Orange Pi 5 Plus的配置文件 configs/orangepi-5-plus-rk3588_defconfig，在文件末尾添加或修改以下配置选项：

bash 复制代码 
# 关键配置：启用 saveenv
CONFIG_ENV_IS_IN_MMC=y      # ✅ 该选项必须！表示环境保存在MMC中
CONFIG_ENV_OFFSET=0x4000    # 环境变量在设备中的偏移
CONFIG_ENV_SIZE=0x8000      # 环境变量的存储空间（32KB）
2. 编译U-Boot

使用交叉编译工具链进行编译，将your_rootfs_path替换为你的交叉编译环境路径：

bash 复制代码 
export CROSS_COMPILE=aarch64-linux-gnu-
export PATH=$PATH:/your_rootfs_path/usr/bin
make orangepi-5-plus-rk3588_defconfig
make

编译成功后，可以在当前目录找到 u-boot-rockchip.bin 或 idbloader.img 以及 u-boot.itb 文件。

3. 制作SD启动卡镜像

使用新编译的U-Boot替换掉SD卡（如/dev/sdb）上的旧镜像：

bash 复制代码 
# 注意：1.请根据实际情况替换/dev/sdX；2.务必清空前256MB避免文件系统干扰；3.操作会覆盖磁盘分区表和数据，需谨慎
sudo dd if=/dev/zero of=/dev/sdX bs=1M count=256
sudo dd if=idbloader.img of=/dev/sdX seek=64 bs=512
sudo dd if=u-boot.itb of=/dev/sdX seek=16384 bs=512

🔄 备选方案与变通

如果暂时不方便重新编译，可以试试以下几个备选方案：

  • 清除 eMMC CRC 错误 ：环境变量区的 CRC 校验错误可能导致无法保存。在U-Boot命令行中尝试：

    复制代码 
    => mmc dev 1                 # 切换到 eMMC 设备
=> mmc erase 0x4000 0x10    # 擦除环境变量所在区域（64个块，偏移量0x4000）

  • 修复启动介质 ：确保用于启动的介质（SD卡或eMMC）已正确分区并有足够的可用空间。可以尝试使用SD卡关联工具重新制作启动卡，或使用fw_setenv工具在Linux系统中设置环境变量，但需要注意，这需要内核支持并能正确读取U-Boot的环境变量分区。

  • 硬编码引导命令 ：这是最快速的变通方法。直接修改U-Boot源码，在include/configs/目录下的头文件中通过宏 CONFIG_BOOTCOMMAND 硬编码你的网络启动命令。

  • 使用其他启动介质：如果问题源自eMMC的兼容性，可以考虑使用SPI Flash作为环境变量存储介质，但这需要相应的硬件支持。

🔗 参考与资源

成功开启 saveenv 后，你可以参考TFTP+NFS的启动配置，设置好后使用 saveenv 保存。重新上电时，板子便会自动加载服务器上的内核和文件系统，调试会流畅很多。

如果在编译过程中遇到具体的报错信息，随时告诉我，我帮你一起看看～

你这个思路很清楚。确实，Orange Pi 5 Plus (RK3588) 无法保存 U-Boot 环境变量是个棘手问题，这通常意味着官方预编译的 U-Boot 镜像默认没有开启 saveenv 功能。

要彻底解决这个问题，最可靠的方法是重新编译一个支持 saveenv 的 U-Boot。以下是具体的操作步骤和备选方案。

🛠️ 终极方案：编译支持 saveenv 的 U-Boot

这个方案能从源码层面解决问题，一劳永逸。

🚧 准备工作：Boot from SD Card

在编译新U-Boot之前，先确保Orange Pi 5 Plus能从SD卡启动，这能让你避免反复烧录eMMC。

  1. 烧录官方镜像：先按照官方文档，将Orange Pi OS或其他系统镜像烧录到一张MicroSD卡中。
  2. 验证启动：将SD卡插入开发板，并确保其作为第一启动设备。
  3. 连接串口 ：通过串口（如/dev/ttyS0）连接到开发板的调试串口，方便我们后续查看U-Boot的启动日志。
1. 获取源码并配置

拉取支持RK3588的U-Boot源码，以Rockchip的U-Boot仓库为例：

bash 复制代码 
git clone https://github.com/rockchip-linux/u-boot.git
cd u-boot

关键配置 ：编辑Orange Pi 5 Plus的配置文件 configs/orangepi-5-plus-rk3588_defconfig，在文件末尾添加或修改以下配置选项：

bash 复制代码 
# 关键配置：启用 saveenv
CONFIG_ENV_IS_IN_MMC=y      # ✅ 该选项必须！表示环境保存在MMC中
CONFIG_ENV_OFFSET=0x4000    # 环境变量在设备中的偏移
CONFIG_ENV_SIZE=0x8000      # 环境变量的存储空间（32KB）
2. 编译U-Boot

使用交叉编译工具链进行编译，将your_rootfs_path替换为你的交叉编译环境路径：

bash 复制代码 
export CROSS_COMPILE=aarch64-linux-gnu-
export PATH=$PATH:/your_rootfs_path/usr/bin
make orangepi-5-plus-rk3588_defconfig
make

编译成功后，可以在当前目录找到 u-boot-rockchip.bin 或 idbloader.img 以及 u-boot.itb 文件。

3. 制作SD启动卡镜像

使用新编译的U-Boot替换掉SD卡（如/dev/sdb）上的旧镜像：

bash 复制代码 
# 注意：1.请根据实际情况替换/dev/sdX；2.务必清空前256MB避免文件系统干扰；3.操作会覆盖磁盘分区表和数据，需谨慎
sudo dd if=/dev/zero of=/dev/sdX bs=1M count=256
sudo dd if=idbloader.img of=/dev/sdX seek=64 bs=512
sudo dd if=u-boot.itb of=/dev/sdX seek=16384 bs=512

🔄 备选方案与变通

如果暂时不方便重新编译，可以试试以下几个备选方案：

  • 清除 eMMC CRC 错误 ：环境变量区的 CRC 校验错误可能导致无法保存。在U-Boot命令行中尝试：

    复制代码 
    => mmc dev 1                 # 切换到 eMMC 设备
=> mmc erase 0x4000 0x10    # 擦除环境变量所在区域（64个块，偏移量0x4000）

  • 修复启动介质 ：确保用于启动的介质（SD卡或eMMC）已正确分区并有足够的可用空间。可以尝试使用SD卡关联工具重新制作启动卡，或使用fw_setenv工具在Linux系统中设置环境变量，但需要注意，这需要内核支持并能正确读取U-Boot的环境变量分区。

  • 硬编码引导命令 ：这是最快速的变通方法。直接修改U-Boot源码，在include/configs/目录下的头文件中通过宏 CONFIG_BOOTCOMMAND 硬编码你的网络启动命令。

  • 使用其他启动介质：如果问题源自eMMC的兼容性，可以考虑使用SPI Flash作为环境变量存储介质，但这需要相应的硬件支持。

🔗 参考与资源

成功开启 saveenv 后，你可以参考TFTP+NFS的启动配置，设置好后使用 saveenv 保存。重新上电时，板子便会自动加载服务器上的内核和文件系统，调试会流畅很多。

如果在编译过程中遇到具体的报错信息，随时告诉我，我帮你一起看看～

Orange Pi 5 Plus 的 saveenv 无法保存环境变量是一个已知的固件配置问题 ，根本原因是官方 U-Boot 编译配置中未启用 CONFIG_ENV_IS_IN_MMC，导致环境变量只能存在于内存中，重启后丢失 。

问题根因

RK3588 平台的 Orange Pi 5 Plus 官方镜像中，U-Boot 默认没有将环境变量存储位置配置到 eMMC/SD 卡等持久化介质上。当你执行 saveenv 时，U-Boot 找不到有效的存储后端，因此变量无法持久化 。

解决方案：重新编译 U-Boot

最直接有效的办法是修改 U-Boot 源码配置并重新编译：

1. 修改配置文件

在 U-Boot 源码目录下找到配置文件：

复制代码 
u-boot/configs/orangepi-5-plus-rk3588_defconfig

添加一行：

复制代码 
CONFIG_ENV_IS_IN_MMC=y

2. 重新编译并烧录

bash 复制代码 
# 重新编译 U-Boot
make orangepi-5-plus-rk3588_defconfig
make -j$(nproc)

# 将编译好的 u-boot 镜像烧录到板子
# 具体烧录方式取决于你的启动介质（eMMC/SD/SPI NOR）

重新编译烧录后，saveenv 即可正常工作，bootcmd 等变量重启后也能保留 。

其他可能的替代方案

如果你不想重新编译 U-Boot，也可以考虑：

方案 说明
使用 /boot/orangepiEnv.txt 部分发行版（如 Armbian、官方 Ubuntu）支持通过该文件传递内核参数和覆盖 U-Boot 变量，无需修改 U-Boot 环境
刷写 SPI NOR Bootloader 有用户反馈将 bootloader 刷入 SPI NOR 后，eMMC/SD 启动问题得到解决，但这主要用于解决启动问题而非 saveenv
换用第三方发行版 如 Joshua-Riek 的 ubuntu-rockchip 或 Armbian，这些社区版本可能已经修复了该配置问题

总结

  • 问题本质 ：CONFIG_ENV_IS_IN_MMC 未启用，环境变量无持久化存储后端
  • 最佳修复 ：在 orangepi-5-plus-rk3588_defconfig 中添加 CONFIG_ENV_IS_IN_MMC=y，重新编译 U-Boot 并烧录
  • 临时规避 ：使用发行版提供的 orangepiEnv.txt 或 extlinux.conf 等机制来配置启动参数
相关推荐
Terasic友晶科技13 天前
答疑解惑 | DE25-Nano开发板Uboot阶段与FPGA外设交互失败
fpga开发·led·uboot·de25-nano·terasic
抠脚学代码1 个月前
Linux开发--＞ UBoot学习
linux·学习·uboot
Felven1 个月前
飞腾平台 UEFI 与 U-Boot 启动方案对比及选型建议
运维·uefi·uboot·飞腾
charlie1145141911 个月前
2026年IMX6ULL正点原子Alpha开发板学习方案——U-Boot完全移植概览：从官方源码到你的自制板，这条路有多远
linux·学习·嵌入式·uboot·嵌入式linux·工程实践·编程指南
2023自学中2 个月前
Linux 内核中的 start_kernel() 函数内部：流程图与总结
linux·嵌入式硬件·uboot
2023自学中2 个月前
Linux 内核文件 rest_init 函数：流程与总结
linux·uboot
南烟斋..3 个月前
Linux设备驱动开发完全指南：从启动流程到Platform驱动模型
linux·驱动开发·uboot
STCNXPARM3 个月前
Linux-ARM-Bootloader概述
linux·运维·arm开发·uboot·bootloader
夜月yeyue3 个月前
Netlink 套接字详解
linux·运维·服务器·网络·单片机·uboot
热门推荐
01GitHub 镜像站点02近期有什么ai的新消息，新动态？ 2026.4月032026年4月AI大事件深度解读：大模型竞争进入“深水区“042026年AI编程工具终极横评：Cursor vs Claude Code vs Copilot05Codex 接入 DeepSeek API 完整配置文档06【AI】2026 年具身智能模型和世界模型总结07在Windows 11上安装Docker的踩坑记录08零基础教你claude code 接入 deepseek V4092026年AI前瞻：量子AI、具身智能与科学发现的新纪元10VSCode + Copilot下：配置并使用 DeepSeek