ST官方开发板uboot启动配置详解：手把手教你读懂extlinux.conf文件

STM32MP15开发板uboot启动配置实战：extlinux.conf深度解析与定制指南

当你第一次拿到ST官方开发板时，那个神秘的extlinux.conf文件往往让人既好奇又困惑。作为连接uboot与Linux内核的关键桥梁，这个不足百行的配置文件却掌控着整个系统的启动命脉。本文将带你从零开始，彻底掌握extlinux.conf的配置精髓。

1. 初识extlinux.conf：ST开发板的启动门户

在STM32MP15系列开发板上，extlinux.conf文件通常位于/boot/extlinux目录下。打开这个文件，你会看到类似这样的结构：

MENU TITLE Select boot option TIMEOUT 30 DEFAULT stm32mp157c-dk2 LABEL stm32mp157c-dk2 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：定义一个启动项，可以包含多个子配置

每个LABEL块中的核心配置项：

注意：ST官方开发板通常使用FDT而非DEVICETREE来指定设备树，这是与其他平台的一个区别点。

2. 配置项深度剖析：从表面到原理

2.1 启动菜单与交互控制

ST开发板的uboot通常会配置图形化启动菜单，相关配置项值得特别关注：

MENU BACKGROUND /boot/splash.bmp MENU RESOLUTION 800 480 MENU MARGIN 50

• MENU BACKGROUND：指定背景图片（BMP格式）
• MENU RESOLUTION：设置显示分辨率
• MENU MARGIN：菜单边距设置

实际案例：修改启动菜单样式

1. 准备一张800x480的24位色BMP图片

2. 将图片放入/boot目录

3. 修改extlinux.conf：

   MENU BACKGROUND /boot/custom_splash.bmp MENU RESOLUTION 1024 600 MENU COLOR border 30;44 #40ffffff #a0000000 std

2.2 内核参数的艺术

APPEND参数是配置中的重中之重，它直接决定了内核启动时的行为。ST开发板常见的参数组合：

APPEND root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200

参数分解：

• root=：指定根文件系统设备
• rootwait：等待根设备就绪
• rw：以读写方式挂载根文件系统
• console=：指定控制台设备和参数

高级技巧：动态参数生成

在Yocto构建系统中，可以通过machine配置动态生成这些参数：

# 在machine配置中 UBOOT_EXTLINUX_APPEND_stm32mp15 = "root=PARTUUID=${ROOTFS_PARTUUID} rootwait rw"

3. Yocto构建系统中的extlinux.conf生成机制

ST官方提供了完整的extlinux.conf生成框架，主要涉及以下几个关键文件：

1. st-machine-extlinux-config-stm32mp.inc：基础配置模板
2. stm32mp15-robot.conf：具体开发板的machine配置
3. extlinuxconf-stm32mp.bbclass：处理逻辑

配置继承关系：

st-machine-extlinux-config-stm32mp.inc ↑ stm32mp15-robot.conf ↑ extlinuxconf-stm32mp.bbclass ↑ u-boot-stm32mp-extlinux.bb

关键变量：

4. 实战：定制自己的启动配置

4.1 添加多启动项

假设我们需要为同一块开发板配置两个不同的根文件系统：

LABEL primary KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk0p4 rootwait rw LABEL secondary KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk0p5 rootwait rw

在Yocto中的对应配置：

UBOOT_EXTLINUX_LABELS = "primary secondary" UBOOT_EXTLINUX_APPEND_primary = "root=/dev/mmcblk0p4 rootwait rw" UBOOT_EXTLINUX_APPEND_secondary = "root=/dev/mmcblk0p5 rootwait rw"

4.2 调试配置技巧

当启动出现问题时，可以添加调试参数：

APPEND root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200 loglevel=8

常用调试参数：

• loglevel=8：开启详细内核日志
• init=/bin/sh：直接进入shell
• rdinit=/bin/sh：在initramfs阶段进入shell

4.3 安全启动配置

对于需要安全启动的场景，可以配置如下：

LABEL secure KERNEL /boot/zImage FDT /boot/stm32mp157c-dk2.dtb APPEND root=/dev/mmcblk0p4 rootwait ro enforcing=1

关键变化：

• rw改为ro：只读挂载根文件系统
• enforcing=1：开启SELinux强制模式

5. 常见问题与解决方案

问题1：修改extlinux.conf后启动配置未生效

• 检查文件路径是否正确（应在/boot/extlinux/extlinux.conf）
• 确认uboot环境变量extlinux_conf指向正确路径
• 验证文件系统是否可写（有时需要重新挂载为rw）

问题2：启动时显示"Missing kernel"错误

• 检查KERNEL路径是否正确
• 确认内核镜像确实存在于指定路径
• 验证文件系统类型（某些uboot版本不支持某些文件系统）

问题3：设备树未正确加载

• 使用fdt list命令验证uboot是否加载了正确的设备树
• 检查FDT路径配置
• 确认设备树文件与硬件版本匹配

调试技巧：在uboot命令行中手动测试

# 设置手动启动参数 setenv bootargs 'root=/dev/mmcblk0p4 rootwait rw console=ttySTM0,115200' 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}

掌握extlinux.conf的配置艺术，意味着你真正掌握了ST开发板启动过程的主导权。从简单的内核参数调整到复杂的多系统启动配置，这个看似简单的配置文件能够满足各种高级需求。