板级支持包（BSP）设计原理：板级初始化、外设映射、中断向量表重定向

BSP 这个词，很多工程师天天挂在嘴边，但真正把它吃透的人不多。说白了，BSP 就是一块「胶水」—— 一头粘着硬件，一头粘着操作系统或应用层。它的核心任务就三件：把板子跑起来、把外设地址对上、把中断入口安排好。

我刚开始做嵌入式那几年，总觉得 BSP 就是改改寄存器、配配引脚，没什么技术含量。直到有一次，一个项目因为中断向量表没重定向，烧了三天才找到问题。嗯，从那以后我再也不敢小看这三件事了。

3.1 板级初始化：从复位向量到 main() 的必经之路

板级初始化，就是 CPU 上电后、进入用户程序之前，必须完成的那一套「热身动作」。它通常包含三个阶段：

阶段	主要任务	典型实现
最低级初始化	设置堆栈指针、关看门狗、初始化异常向量表	汇编代码，放在 .text 最前面
中级初始化	时钟树配置、PLL 锁定、SDRAM 时序初始化	C 函数，由汇编跳转调用
高级初始化	外设时钟使能、GPIO 复用、中断控制器初始化	BSP_Init() 函数，在 main() 开头调用

我个人习惯把这三个阶段严格分开。为什么？因为每个阶段依赖的资源不同。最低级初始化只能用寄存器，连全局变量都不能碰；中级初始化可以访问 SRAM，但还不能用堆；高级初始化才可以用完整 C 运行时。

我在项目中遇到过一个问题：某款 MCU 的 SDRAM 控制器需要先配置时钟再初始化时序，但参考手册的示例代码把顺序写反了。结果板子 10 次上电有 3 次起不来。后来我把时钟配置和 SDRAM 初始化拆成两个独立函数，中间加了个 5ms 延时，问题就解决了。

3.2 外设映射：地址、中断、DMA 的三层关联

外设映射，就是把芯片手册里那些「绝对地址」和「中断号」组织成代码能用的结构。它包含三个层次：

1. 地址映射 —— 把外设基地址定义成宏或结构体指针
2. 中断映射 —— 把外设中断号关联到中断控制器对应的通道
3. DMA 映射 —— 把外设请求信号关联到 DMA 通道

你想想看，这三层映射如果有一层对不上，外设就没办法正常工作。我见过最典型的坑是：UART 的地址映射对了，中断号也对了，但 DMA 请求线连到了错误的通道，结果数据收发总是丢包。

下面是一个典型的外设映射头文件结构：

/* bsp_uart_map.h */
#ifndef __BSP_UART_MAP_H__
#define __BSP_UART_MAP_H__

/* 地址映射：使用结构体指针访问寄存器 */
#define UART1_BASE         0x40001000UL
#define UART2_BASE         0x40002000UL

typedef struct {
    volatile uint32_t DR;      /* 数据寄存器，偏移 0x00 */
    volatile uint32_t SR;      /* 状态寄存器，偏移 0x04 */
    volatile uint32_t CR;      /* 控制寄存器，偏移 0x08 */
} UART_TypeDef;

#define UART1               ((UART_TypeDef *)UART1_BASE)
#define UART2               ((UART_TypeDef *)UART2_BASE)

/* 中断映射：中断号到 NVIC 通道 */
#define UART1_IRQn          37
#define UART2_IRQn          38

/* DMA 映射：UART 发送请求对应的 DMA 通道 */
#define UART1_TX_DMA_CH     3
#define UART2_TX_DMA_CH     5

#endif /* __BSP_UART_MAP_H__ */

我曾经接手过一个项目，前任工程师把 UART 的基地址定义在三个不同的头文件里，而且值还不一样。调试了整整两天，最后发现是地址映射不一致导致的。从那以后，我强制团队把所有外设映射集中到一个 bsp_map.h 文件里，谁都不许私自定义。

3.3 中断向量表重定向：让代码跑在正确的位置

中断向量表重定向，是 BSP 设计里最容易出问题、也最容易被忽视的一环。它的本质是：告诉 CPU，中断来了该去哪里找处理函数。

大多数现代 ARM Cortex-M 芯片都支持向量表偏移寄存器（VTOR）。默认情况下，向量表放在 Flash 起始地址（0x00000000）。但如果你要做 IAP 升级、Bootloader + App 架构，或者把代码放到 RAM 里跑，就必须重定向向量表。

重定向的典型步骤：

1. 在链接脚本里，把向量表放到指定的偏移地址
2. 在启动代码里，把新的向量表基地址写入 VTOR 寄存器
3. 确保新的向量表里每个中断入口都指向正确的处理函数

代码实现其实很简单：

/* 中断向量表重定向 */
void BSP_VectorTable_Relocate(uint32_t base_addr)
{
    /* 检查地址是否对齐到 256 字节 */
    if ((base_addr & 0xFF) != 0) {
        return;  /* 地址未对齐，直接返回 */
    }

    /* 写入 VTOR 寄存器 */
    SCB->VTOR = base_addr;

    /* 确保写操作完成 */
    __DSB();
    __ISB();
}

我记得有一次做 Bootloader 开发，App 放在 0x08010000 地址。重定向代码写好了，但一进中断就死机。调试了整整一个下午，最后发现是链接脚本里向量表的对齐属性没写对。加上 ALIGN(256) 之后，一切正常。

3.4 三者的协作关系

板级初始化、外设映射、中断向量表重定向，这三件事不是孤立的。它们之间有明确的依赖关系：

• 外设映射依赖板级初始化中的时钟配置 —— 时钟没起来，外设地址映射了也没用
• 中断向量表重定向依赖外设映射中的中断号定义 —— 中断号错了，重定向到哪都是白搭
• 板级初始化中的高级阶段依赖前两者 —— 外设映射和中断重定向完成后，才能安全地初始化外设

下面这张图展示了三者的协作流程：

实际项目中，我建议把这三个模块的初始化状态记录到同一个结构体里：

typedef struct {
    uint8_t clock_ready      : 1;   /* 时钟初始化完成 */
    uint8_t memory_ready     : 1;   /* 内存初始化完成 */
    uint8_t periph_map_ready : 1;   /* 外设映射完成 */
    uint8_t vtor_ready       : 1;   /* 中断向量表重定向完成 */
    uint8_t reserved         : 4;
} BSP_InitStatus;

BSP_InitStatus g_bsp_status = {0};

每完成一步，就把对应的标志位置 1。调试时只要检查这个结构体，就能知道 BSP 初始化到了哪一步。这个习惯帮我省了无数次抓头皮的时间。