ST官方开发板uboot启动菜单extlinux.conf配置详解（以STM32MP15为例）

STM32MP15开发板uboot启动菜单extlinux.conf实战配置指南

当第一次看到ST官方开发板启动时那个蓝色背景的uboot菜单界面，很多工程师都会好奇：这个看似简单的启动选择界面背后，究竟藏着怎样的配置逻辑？今天我们就以STM32MP15 Discovery Kit为例，深入解析extlinux.conf这个不起眼却至关重要的配置文件。

1. extlinux.conf基础解析

在STM32MP15开发板上，extlinux.conf是uboot启动菜单的核心配置文件，通常位于/boot/extlinux目录下。这个文件决定了uboot如何加载内核、设备树以及传递哪些启动参数。让我们先看一个典型的ST官方配置示例：

MENU TITLE Select the boot mode TIMEOUT 30 DEFAULT stm32mp157c-dk2-sdcard LABEL stm32mp157c-dk2-sdcard KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200

MENU TITLE定义了启动菜单的标题文字，而TIMEOUT则设置了自动启动的等待时间（单位是1/10秒）。DEFAULT指定了默认启动项，必须与某个LABEL名称匹配。

每个LABEL区块代表一个启动选项，包含三个关键元素：

• KERNEL：指定内核镜像路径（如zImage）
• FDT：设备树文件路径（.dtb文件）
• APPEND：传递给内核的启动参数

ST官方开发板通常会预置多个启动选项，比如从SD卡启动、从eMMC启动等不同配置。理解这些基础配置项是定制自己启动菜单的第一步。

2. ST官方配置模板解析

ST为STM32MP15系列提供了标准化的extlinux配置模板，主要分布在Yocto项目的以下几个文件中：

meta-st/meta-st-stm32mp/conf/machine/include/st-machine-extlinux-config-stm32mp.inc meta-st/meta-st-stm32mp/conf/machine/stm32mp15-robot.conf

这些文件定义了各种配置变量，最终通过extlinuxconf-stm32mp.bbclass生成实际的extlinux.conf文件。我们来看几个关键变量：

在实际项目中，我们通常不会直接修改这些模板文件，而是在自己的machine配置文件中通过变量覆盖来实现定制。例如：

# 在自定义的machine.conf中 UBOOT_EXTLINUX_LABELS = "my-custom-config" UBOOT_EXTLINUX_DEFAULT_LABEL = "my-custom-config" UBOOT_EXTLINUX_FDT_my-custom-config = "/boot/my-custom.dtb"

3. 启动菜单高级定制

3.1 添加自定义启动项

假设我们需要为开发板添加一个特殊的调试启动选项，可以这样修改extlinux.conf：

LABEL debug-mode KERNEL /boot/zImage-debug FDT /boot/stm32mp157c-dk2-debug.dtb APPEND root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200 earlyprintk loglevel=8

这个配置使用了调试版内核镜像和设备树，并通过earlyprintk和loglevel=8参数开启了详细的内核日志输出。

3.2 配置启动画面

ST开发板默认会显示一个蓝色背景的启动画面，这是通过SPLASH配置实现的。在Yocto配置中：

UBOOT_SPLASH_IMAGE = "splash-screen" UBOOT_EXTLINUX_SPLASH_stm32mp15 = "${UBOOT_SPLASH_IMAGE}"

对应的extlinux.conf中会自动生成：

MENU BACKGROUND /boot/splash-screen.bmp

如果需要自定义启动画面，只需准备一张480x272像素（STM32MP15 LCD分辨率）的24位BMP图片，并更新上述配置即可。

3.3 多设备树支持

对于需要支持多种硬件变体的项目，可以利用ST提供的多设备树机制。在machine配置中：

STM32MP_DT_FILES = "stm32mp157c-dk2 stm32mp157c-dk2-a7-examples" UBOOT_EXTLINUX_TARGETS = "stm32mp15" UBOOT_EXTLINUX_TARGETS_EXTRA_CONFIG = "${STM32MP_DT_FILES}"

这会在/boot/extlinux目录下生成多个配置文件，每个对应一个设备树变体：

extlinux/stm32mp157c-dk2_extlinux.conf extlinux/stm32mp157c-dk2-a7-examples_extlinux.conf

4. 常见问题排查

4.1 启动项不显示

如果uboot启动时没有显示菜单，请检查：

1. extlinux.conf文件是否存在且路径正确
2. TIMEOUT值是否大于0
3. 配置文件语法是否正确（特别是LABEL和子项的缩进）

4.2 内核启动失败

当选择某个启动项后系统无法启动，可以：

1. 在uboot命令行手动尝试加载内核，观察错误信息

   ext4load mmc 0:1 ${kernel_addr_r} /boot/zImage ext4load mmc 0:1 ${fdt_addr_r} /boot/stm32mp157c-dk2.dtb bootz ${kernel_addr_r} - ${fdt_addr_r}

2. 检查APPEND参数中的root=是否正确指向根文件系统分区
3. 确认设备树文件是否与硬件匹配

4.3 自定义配置不生效

如果在Yocto中修改了配置但生成的extlinux.conf没有变化，需要：

1. 清理u-boot-stm32mp-extlinux的构建缓存

   bitbake -c cleansstate u-boot-stm32mp-extlinux

2. 确保变量覆盖语法正确（如_append、_prepend的使用）
3. 检查layer的优先级设置，确保自定义配置层优先级足够高

5. 实战技巧与最佳实践

5.1 快速测试配置修改

无需每次修改都重新构建整个镜像，可以直接在开发板上编辑extlinux.conf测试：

vi /boot/extlinux/extlinux.conf sync reboot

5.2 保留默认配置作为备用

建议在自定义配置中保留ST官方的默认启动项，作为备用恢复方案：

LABEL stm32mp157c-dk2-sdcard-recovery KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk0p4 rootwait rw

5.3 使用环境变量动态配置

在extlinux.conf中可以使用uboot环境变量实现更灵活的配置：

APPEND root=${rootdev} rootwait rw console=${console}

然后在uboot中设置这些变量：

setenv rootdev /dev/mmcblk0p4 setenv console ttySTM0,115200 saveenv

5.4 安全启动配置

对于需要安全启动的项目，可以在APPEND中添加相关参数：

APPEND root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200 dm_verity.hashstart=2048

同时需要在Yocto中配置相应的安全选项：

DISTRO_FEATURES += "secureboot"

6. 性能优化配置

6.1 内核参数调优

根据应用需求调整内核参数可以显著提升系统性能：

APPEND root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200 mitigations=off cpufreq.default_governor=performance

表：常用内核性能参数

6.2 内存配置优化

对于内存较大的STM32MP15型号（如1GB版本），可以调整内存分配：

APPEND root=/dev/mmcblk0p4 rootwait rw mem=512M vmalloc=256M

6.3 早期启动加速

减少启动时间可以配置：

APPEND root=/dev/mmcblk0p4 rootwait rw rdinit=/sbin/init skip_initramfs

7. 多系统启动配置

STM32MP15的灵活性允许在同一块开发板上实现多系统启动。例如配置Linux和RT-Thread双系统：

LABEL linux KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk0p4 rootwait rw LABEL rt-thread KERNEL /boot/rtt.bin FDT /boot/stm32mp157c-dk2-rtt.dtb

实现这种配置需要注意：

1. 不同系统的内存分配不能冲突
2. 共享外设需要进行合理初始化
3. 存储分区要明确划分

8. 生产环境部署建议

当产品进入量产阶段时，extlinux.conf的配置需要考虑：

1. 锁定启动参数：移除调试选项和交互式菜单

   TIMEOUT 0 DEFAULT production APPEND root=/dev/mmcblk0p4 rootwait ro

2. 添加版本控制：在APPEND中添加固件版本信息

   APPEND root=/dev/mmcblk0p4 rootwait ro fw_version=1.2.3

3. 实现A/B更新：配合双系统分区实现无缝升级

   LABEL system-a KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk2p4 rootwait ro LABEL system-b KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk3p4 rootwait ro