4. 参考手册与外设映射阅读方法

在STM32板级适配中，参考手册（Reference Manual，RM）是比数据手册更贴近寄存器级操作的核心文档。数据手册告诉你“这个芯片有哪些外设、引脚怎么分布”，而参考手册告诉你“这个外设的寄存器在哪、每一位怎么用、时钟从哪来、中断怎么连”。很多初学者拿到RM后逐页翻看，效率极低。正确的方法是：以“外设适配索引”为目标，按固定路径从外设定位到寄存器、时钟、复用功能和中断向量，形成可复用的查阅习惯。

下面以GPIO、USART、SPI、I2C、ADC、定时器为例，说明如何建立这套索引。需要说明的是，本文涉及的寄存器名、位域名、总线归属和中断号均以STM32F4系列RM0090为参考示例，不同系列（F1、F0、H7、G0等）名称和编号会有差异，实际项目应以对应型号的参考手册为准。

一、先建立“外设—总线—时钟”的映射

STM32的外设不是孤立存在的，它们挂在不同的总线上：APB1、APB2、AHB1、AHB2等。时钟使能寄存器（RCC_APB1ENR、RCC_APB2ENR、RCC_AHB1ENR等）决定了外设能否工作。阅读RM时，第一步不是直接看外设章节，而是先查“RCC”章节中的时钟树和使能位表，确认目标外设属于哪条总线、对应哪个使能位。

例如，在F4系列中：GPIOA~GPIOE挂在AHB1，使能位在RCC_AHB1ENR的bit0~bit4；USART1挂在APB2，使能位在RCC_APB2ENR的bit4；USART2挂在APB1，使能位在RCC_APB1ENR的bit17；SPI1在APB2，SPI2/SPI3在APB1；I2C1/2/3均在APB1；ADC1/2/3在APB2；TIM1/TIM8在APB2，TIM2~TIM7在APB1。把这些对应关系整理成一张索引表，后续配置时就不必反复翻RCC章节。

二、从外设章节定位寄存器组

RM中每个外设都有独立章节，章节末尾通常有“Register description”小节，列出该外设全部寄存器及其位域。阅读时不要从第一个寄存器顺序读到最后一个，而应先看该外设的“功能框图”和“寄存器概览表”，明确哪些寄存器是配置类（如CR1、CR2、CR3）、哪些是状态类（如SR）、哪些是数据类（如DR）、哪些是时钟/预分频类（如PSC、ARR）。

以USART为例，核心寄存器包括：USART_SR（状态）、USART_DR（数据）、USART_BRR（波特率）、USART_CR1（使能、字长、中断）、USART_CR2（停止位）、USART_CR3（流控）。配置一个USART的基本顺序是：使能时钟→设置BRR→设置CR1/CR2/CR3→使能UE位。每一步都能在RM中找到对应位域，例如CR1的bit13是UE，bit3是TE，bit2是RE，bit5是RXNEIE。

三、复用功能与引脚映射

GPIO本身只是引脚控制器，外设信号要通过“复用功能”（Alternate Function，AF）连接到引脚。RM中GPIO章节的“Alternate function mapping”表是关键：它列出每个引脚可选的AF0~AF15分别对应哪个外设。例如PA9/PA10可配置为USART1_TX/RX（AF7），PB6/PB7可配置为I2C1_SCL/SDA（AF4），PA5/PA6/PA7可配置为SPI1_SCK/MISO/MOSI（AF5）。

配置复用功能的步骤是：使能GPIO时钟→设置MODER为复用模式（0b10）→设置OTYPER、OSPEEDR、PUPDR→设置AFR[0]或AFR[1]选择AF编号。注意AFR是每引脚4位，AFR[0]管PA0~PA7，AFR[1]管PA8~PA15，PB、PC等同理。这一步如果AF编号选错，外设信号不会出现在引脚上，示波器也测不到波形。

四、中断向量与NVIC映射

外设产生中断后，信号进入NVIC（嵌套向量中断控制器）。RM中“Interrupt and event”表或NVIC章节会列出每个外设中断的IRQ编号和向量地址。例如USART1_IRQn=37，USART2_IRQn=38，SPI1_IRQn=35，I2C1_EV_IRQn=31，ADC_IRQn=18，TIM2_IRQn=28。在代码中，这个编号用于HAL_NVIC_SetPriority和HAL_NVIC_EnableIRQ，中断服务函数名必须与启动文件中的向量表一致，如USART1_IRQHandler。

需要区分“外设中断使能”和“NVIC使能”两层：外设CR寄存器中的中断使能位（如USART_CR1的RXNEIE）决定外设是否产生中断请求，NVIC的ISER寄存器决定CPU是否响应这个请求。两者都打开，中断才能进入服务函数。

五、建立可复用的外设适配索引

把上述四类信息整理成一张索引表，是提高板级适配效率的关键。建议每个外设一行，字段包括：外设名、所属总线、时钟使能寄存器及位、关键寄存器列表、引脚与AF编号、中断IRQ号、初始化顺序要点。例如USART1一行可写：APB2，RCC_APB2ENR bit4，SR/DR/BRR/CR1/CR2/CR3，PA9(AF7 TX)/PA10(AF7 RX)，IRQ37，顺序为时钟→BRR→CR→UE。

这张表不需要一次写全，可以在每次适配新外设时补充一行。久而久之，它就成为你个人的“RM速查索引”，比反复翻PDF快得多。更重要的是，它强迫你在写代码前把时钟、寄存器、复用、中断四条线都理清楚，避免出现“寄存器配了但时钟没开”“AF选错导致引脚无输出”“中断使能了但NVIC没开”这类常见问题。

总结来说，参考手册的阅读不是“读”，而是“查”和“建索引”。以GPIO、USART、SPI、I2C、ADC、定时器为起点，按“时钟→寄存器→复用→中断”四条线建立映射，再整理成适配索引表，就能把厚厚一本RM变成板级适配中真正可用的工具。