引言

在 STM32 双 Bank 启动模式下（如 STM32H7、L4 系列），Bootloader 负责从 Bank1 跳转到 Bank2 运行应用程序。跳转失败不仅浪费调试时间，还可能引发产品可靠性问题。本文基于实际项目经验，整理了一份排查清单，从硬件到软件逐层分析，助你高效解决问题。

一、双 Bank 启动模式原理

双 Bank 模式允许两个独立的 Flash 区域（Bank1 和 Bank2）分别存储 Bootloader 和 App。启动时，芯片根据选项字节（Option Bytes）或软件配置选择从哪个 Bank 启动。跳转过程涉及以下关键步骤：

确认当前 Bank 状态：通过读取 FLASH->OTP 或选项字节判断激活 Bank。
设置向量表偏移：将 VTOR 寄存器指向目标 Bank 的起始地址。
重新定位堆栈指针：从目标地址首字加载 MSP。
跳转到复位向量：执行目标地址的复位处理函数。

任何一步出错都会导致跳转失败。

二、系统性排查清单

1. 硬件与启动配置检查

确认芯片支持双 Bank：查阅数据手册，确认型号支持双 Bank 模式（如 STM32H743 支持，但 STM32F103 不支持）。
检查选项字节设置：使用 STM32CubeProgrammer 检查 nBOOT1 和 BOOT_ADD0 等选项，确保 Boot 引脚或选项字节配置为从正确 Bank 启动。
验证电源和时钟：跳转前确保目标 Bank 的 Flash 已使能时钟，且电源电压稳定。

2. 软件实现检查

2.1 向量表重定位

跳转前必须设置 VTOR 寄存器，否则中断向量将指向错误位置。

// 设置向量表偏移（以 Bank2 起始地址 0x08040000 为例）
#define APP_ADDRESS 0x08040000U

void jump_to_app(void) {
    // 关闭全局中断，避免跳转过程中断
    __disable_irq();

    // 设置向量表偏移
    SCB->VTOR = APP_ADDRESS;
    __DSB();
    __ISB();

    // 获取目标地址的堆栈指针和复位向量
    uint32_t app_msp = *(volatile uint32_t *)APP_ADDRESS;
    void (*app_reset)(void) = (void (*)(void))(*(volatile uint32_t *)(APP_ADDRESS + 4));

    // 设置主堆栈指针
    __set_MSP(app_msp);

    // 跳转
    app_reset();
}

2.2 检查链接脚本

确保 App 工程的链接脚本（.ld 文件）将 Flash 起始地址设置为 APP_ADDRESS，且向量表位于该地址开头。

/* STM32H743 双 Bank 模式，App 位于 Bank2 */
FLASH (rx) : ORIGIN = 0x08040000, LENGTH = 1M

2.3 确认编译选项

使用 -nostartfiles 或确保启动文件正确，避免重复初始化。
检查是否定义了 VECT_TAB_OFFSET 宏，若使用标准库，需在 system_stm32xx.c 中设置偏移量。

2.4 检查中断处理

跳转前应关闭所有外设中断，并复位外设状态，否则残留中断可能导致硬件错误。

// 示例：关闭 SysTick 和所有外设中断
SysTick->CTRL = 0;
for (int i = 0; i < 8; i++) {
    NVIC->ICER[i] = 0xFFFFFFFF; // 清除所有中断使能
}

3. 调试工具辅助排查

使用调试器查看寄存器：跳转前检查 VTOR、MSP 和 PC 值是否符合预期。
添加日志输出：在跳转前通过串口打印关键变量，确认执行路径。
使用 Fault 异常处理：在 HardFault_Handler 中打印堆栈信息，定位崩溃原因。

void HardFault_Handler(void) {
    // 打印堆栈指针和 PC 值（示例）
    volatile uint32_t *stack = (uint32_t *)__get_MSP();
    printf("HardFault at PC: 0x%08X\n", stack[6]);
    while(1);
}

三、完整代码示例

以下是一个完整的 Bootloader 跳转函数，包含所有关键检查：

#include "stm32h7xx.h"
#include <stdio.h>

#define APP_ADDRESS 0x08040000U

void jump_to_application(void) {
    // 1. 检查目标地址是否有效（栈指针在 RAM 范围内）
    uint32_t app_msp = *(volatile uint32_t *)APP_ADDRESS;
    if ((app_msp & 0xFFF00000) != 0x20000000) {
        printf("Invalid MSP: 0x%08X\n", app_msp);
        return;
    }

    // 2. 关闭全局中断和所有外设中断
    __disable_irq();
    SysTick->CTRL = 0;
    for (int i = 0; i < 8; i++) {
        NVIC->ICER[i] = 0xFFFFFFFF;
        NVIC->ICPR[i] = 0xFFFFFFFF; // 清除挂起中断
    }

    // 3. 设置向量表偏移
    SCB->VTOR = APP_ADDRESS;
    __DSB();
    __ISB();

    // 4. 获取复位向量并跳转
    void (*app_reset)(void) = (void (*)(void))(*(volatile uint32_t *)(APP_ADDRESS + 4));
    __set_MSP(app_msp);
    app_reset();

    // 5. 不应到达此处
    while(1);
}

四、注意事项

Bank 切换的时序：在切换 Bank 时，需确保 Flash 控制器空闲，否则可能触发总线错误。
中断向量表对齐：VTOR 要求向量表地址按 128 字节对齐（取决于芯片），确保 APP_ADDRESS 满足对齐要求。
调试与发布差异：调试时可能因调试器干扰导致跳转失败，建议在发布模式下测试。
看门狗：跳转前应暂停或复位看门狗，避免跳转过程中超时复位。

五、总结

双 Bank 启动模式下的跳转失败问题，往往源于向量表未重定位、堆栈指针错误或中断残留。通过上述清单，从硬件配置、软件实现到调试工具逐层排查，可快速定位问题。建议在开发初期就加入跳转前的自检代码，并利用调试器验证关键寄存器，以降低调试难度。希望这份清单能成为你嵌入式开发中的实用工具。

STM32 双 Bank 启动模式下 Bootloader 跳转失败的系统性排查清单

引言