2. SPL阶段原理与代码入口：分析SPL的设计目标、代码入口点、链接脚本与内存布局

2.1 SPL的设计目标与核心约束

SPL（Secondary Program Loader）是U-Boot启动流程中的第一阶段引导程序，其设计目标是在极小的存储空间和有限的内存资源下，完成最基础的硬件初始化，并加载完整的U-Boot（即U-Boot proper）到DRAM中执行。SPL并非一个独立的项目，而是U-Boot源码树的一部分，通过配置选项（如CONFIG_SPL）启用。

2.2 代码入口点：start.S 与复位向量

SPL的入口点由链接脚本指定，通常位于arch/arm/cpu/armv7/start.S（ARMv7架构）或arch/arm/cpu/armv8/start.S（ARMv8架构）。该文件是SPL执行的第一段代码，负责从复位向量跳转到初始化流程。

/* arch/arm/cpu/armv7/start.S (简化片段) */
.globl _start
_start:
    b       reset                /* 复位向量：直接跳转到reset标签 */
    ldr     pc, _undefined_instruction
    ldr     pc, _software_interrupt
    ldr     pc, _prefetch_abort
    ldr     pc, _data_abort
    ldr     pc, _not_used
    ldr     pc, _irq
    ldr     pc, _fiq

reset:
    /* 设置CPU为SVC32模式，关闭中断 */
    mrs     r0, cpsr
    bic     r0, r0, #0x1f
    orr     r0, r0, #0xd3
    msr     cpsr, r0

    /* 关闭MMU和Cache（确保平坦内存映射） */
    mrc     p15, 0, r0, c1, c0, 0
    bic     r0, r0, #0x0005      /* 清除M位(MMU)和C位(DCache) */
    bic     r0, r0, #0x1000      /* 清除I位(ICache) */
    mcr     p15, 0, r0, c1, c0, 0

    /* 设置栈指针（指向SRAM顶部） */
    ldr     sp, =CONFIG_SPL_STACK
    bl      _main                /* 跳转到C语言初始化入口 */

入口点执行的关键步骤：

1. 异常向量表安装：_start标签处放置8个异常向量（复位、未定义指令、软中断等），复位向量直接跳转到reset。
2. CPU模式初始化：强制进入SVC（超级用户）模式，并屏蔽所有中断（IRQ/FIQ）。
3. 关闭MMU和Cache：确保SPL在物理地址空间运行，避免因Cache不一致导致的外设访问错误。
4. 栈指针设置：将SP指向SRAM中预定义的栈顶地址（CONFIG_SPL_STACK），为C函数调用提供运行栈。
5. 跳转到_main：进入C语言初始化流程（board_init_f等）。

2.3 链接脚本与内存布局

SPL的链接脚本（通常为u-boot-spl.lds）定义了代码段、数据段、BSS段在SRAM或ROM中的精确布局。该脚本由顶层Makefile根据架构和板级配置生成。

/* u-boot-spl.lds (简化示例) */
OUTPUT_FORMAT("elf32-littlearm", "elf32-littlearm", "elf32-littlearm")
OUTPUT_ARCH(arm)
ENTRY(_start)

MEMORY
{
    sram : ORIGIN = CONFIG_SPL_TEXT_BASE, LENGTH = CONFIG_SPL_MAX_SIZE
}

SECTIONS
{
    . = ALIGN(4);
    .text : {
        *(.vectors)          /* 异常向量表 */
        *(.text*)            /* 代码段 */
    } > sram

    . = ALIGN(4);
    .rodata : {
        *(.rodata*)          /* 只读数据 */
    } > sram

    . = ALIGN(4);
    .data : {
        *(.data*)            /* 读写数据 */
    } > sram

    . = ALIGN(4);
    .bss : {
        __bss_start = .;
        *(.bss*)
        __bss_end = .;
    } > sram

    /* 堆栈区域（由链接脚本预留，但不初始化） */
    .stack (NOLOAD) : {
        __stack_start = .;
        . = . + CONFIG_SPL_STACK_SIZE;
        __stack_end = .;
    } > sram
}

内存布局的关键参数：

2.4 SPL内存布局SVG架构图

下图展示了SPL在SRAM中的典型内存布局，包括代码段、数据段、BSS段和堆栈区域的相对位置：

2.5 SPL启动流程与代码执行路径

从复位到SPL加载U-Boot proper的完整执行路径如下：

1. 复位向量：CPU上电后从CONFIG_SPL_TEXT_BASE取指，执行start.S中的b reset。
2. CPU初始化：设置SVC模式、关闭MMU/Cache、初始化栈指针。
3. 板级早期初始化：调用board_init_f()，完成时钟、GPIO、串口等基础外设初始化。
4. 启动设备检测：通过spl_boot_device()确定启动介质（如eMMC、NAND Flash、SPI NOR）。
5. 加载U-Boot proper：调用spl_load_image()从启动介质读取U-Boot proper镜像到DRAM。
6. 跳转执行：关闭SPL自身使用的资源，通过函数指针跳转到U-Boot proper的入口点。

2.6 SPL与U-Boot proper的对比

2.7 常见问题与避坑指南

• 栈溢出：SPL的栈空间通常只有几KB，递归调用或过大的局部变量会导致栈溢出，表现为随机死机。建议使用--stack-usage编译选项分析栈使用量。
• 链接脚本对齐：ARM架构要求代码段4字节对齐，如果链接脚本未正确设置ALIGN(4)，可能导致未定义指令异常。
• BSS段清零：SPL入口点必须显式清零BSS段（通过__bss_start和__bss_end），否则未初始化的全局变量会包含随机值。
• 启动介质时序：某些eMMC或NAND Flash在SPL阶段需要额外的延时等待就绪，忽略此步骤会导致加载失败。