1. 从“点灯”到“系统”：STM32理论到底该学什么
很多人第一次接触STM32，都是从“点亮一个LED小灯”开始的。焊好最小系统板，装好Keil5，新建一个标准库工程模板，写几行GPIO初始化代码，编译下载，灯亮了，心里一阵激动。然后呢？然后很多人就卡住了——会点灯，但不知道怎么做一个完整的项目；会抄代码，但换个芯片型号就懵了；会用库函数，但说不清背后到底发生了什么。
这就是“STM32理论”这个命题真正要解决的问题。它不是让你背手册，也不是让你把参考手册从第一页读到最后一页，而是帮你建立一套从芯片架构到外设驱动、从代码组织到系统调试的完整认知框架。有了这个框架，你拿到任何一个STM32系列芯片，都能快速判断：这个需求该用哪个外设、时钟怎么配、中断怎么排优先级、代码怎么分层。
STM32的理论体系大致可以分成四层：内核与系统架构、时钟与电源管理、外设工作原理、中断与事件机制。这四层是递进关系，底层不清楚，上层就是空中楼阁。比如你不了解NVIC的中断优先级分组，写出来的串口接收代码就会莫名其妙丢数据；你不清楚APB1和APB2总线的时钟差异，配置定时器时算出来的频率就是错的。
我见过太多人做基于STM32的毕业设计，代码能跑，但一问“为什么这个定时器要挂在APB1上”“为什么USART1的时钟使能用的是APB2”，就答不上来。这不是能力问题，是理论框架没搭起来。接下来的内容，我会按照这个框架，把STM32理论中最核心、最容易踩坑的部分拆开讲清楚，同时结合USB虚拟串口、超声波测距、定时器捕获、OTA升级这些实际热词场景，让你不仅懂理论，还能直接用到项目里。
2. 内核与系统架构：别急着写代码，先把地图看清楚
2.1 Cortex-M内核与STM32的关系
STM32芯片内部并不是一块“铁板”，它是由ARM公司设计的Cortex-M内核加上ST公司设计的外设部分组合而成的。内核负责指令执行、中断处理、内存访问这些核心事务，外设部分则包括GPIO、USART、SPI、I2C、ADC、定时器等。理解这个“内核+外设”的架构，是理解STM32一切行为的基础。
以最常见的STM32F103为例，它用的是Cortex-M3内核，最高主频72MHz。而STM32F407用的是Cortex-M4内核，带浮点运算单元，主频可以到168MHz。H743系列则是Cortex-M7，主频480MHz，带缓存和TCM内存。这些差异直接决定了你能做什么样的项目——做PID控制、做音频处理、做高速数据采集，选型时内核性能是第一道门槛。
内核和外设之间通过总线矩阵连接。STM32F103里有三条主要总线：ICode总线负责从Flash取指令，DCode总线负责从Flash取数据，系统总线负责访问SRAM和外设。这三条总线可以并行工作，这就是为什么STM32能同时执行代码和访问外设而不互相拖累。很多初学者写的延时函数delay卡死，往往就是因为没理解总线仲裁和Flash等待周期——主频设到72MHz时，Flash需要插入等待周期，如果代码里频繁跳转，取指效率会下降，延时就不准了。
2.2 存储器映射与寄存器操作的本质
STM32的地址空间是4GB，从0x00000000到0xFFFFFFFF。其中Flash通常映射在0x08000000开始的位置，SRAM在0x20000000开始。外设寄存器则统一映射在0x40000000到0x5FFFFFFF这段区域。你写的每一行“寄存器操作”，本质上就是往某个特定地址写数据。
比如让PA5输出高电平，标准库的写法是GPIO_SetBits(GPIOA, GPIO_Pin_5)，底层其实就是往GPIOA的BSRR寄存器写0x0020。如果你用寄存器直接操作，就是GPIOA->BSRR = 0x0020。再底层一点，就是往地址0x40010810写0x0020。理解这一层，你就能明白为什么“STM32禁用JTAG”这种操作是可行的——因为JTAG占用了PB3、PB4、PA15这几个引脚，你只需要配置AFIO_MAPR寄存器，把JTAG功能关掉，这几个引脚就能当普通GPIO用。
注意：禁用JTAG之前一定要确保你还有别的下载方式，比如SWD。如果只留了JTAG又把它禁了，芯片就锁死了，只能用BOOT模式或者擦除整片来恢复。
2.3 启动流程与向量表
STM32上电后，先从0x00000000地址取栈顶指针，再从0x00000004取复位向量，然后跳转到复位处理函数。这个复位处理函数通常在启动文件startup_stm32f10x.s里，它会调用SystemInit配置时钟，然后跳转到main函数。理解这个流程，你就能明白为什么“STM32标准库新建工程”需要那么多文件——启动文件、系统文件、库文件、用户文件，缺一不可。
向量表里存放的是各个中断服务函数的入口地址。当外部中断触发时，内核会根据中断号去向量表里找对应的函数地址，然后跳过去执行。如果你在代码里写了一个void EXTI0_IRQHandler(void)，链接器会把这个函数的地址放到向量表的对应位置。如果你把函数名写错了，中断触发时就会跳到一个默认的死循环里，程序看起来就像“卡死”了。
3. 时钟树：STM32的“心脏”和“血管”
3.1 时钟源的选择与PLL计算
STM32有四个时钟源：HSI（内部高速时钟，8MHz）、HSE（外部高速时钟，通常8MHz晶振）、LSI（内部低速时钟，约40kHz）、LSE（外部低速时钟，32.768kHz）。系统时钟SYSCLK可以来自HSI、HSE或者PLL倍频后的输出。
以STM32F103为例，最常见的外部晶振是8MHz。要让系统跑72MHz，就需要PLL倍频。PLL的公式是：PLL输出 = HSE × PLL倍频系数 / PLL预分频系数。F103的PLL预分频系数只能是1或2，倍频系数可以是2到16。所以8MHz × 9 = 72MHz，这是最常用的配置。但要注意，PLL输出后还要经过AHB预分频器才能成为系统时钟，AHB预分频可以是1、2、4、8、16、64、128、256、512。通常设AHB预分频为1，系统时钟就是72MHz。
APB1和APB2的时钟来自AHB。APB1最高36MHz，APB2最高72MHz。定时器2到7挂在APB1上，如果APB1预分频系数不为1，定时器时钟会是APB1时钟的2倍。比如APB1设为36MHz，定时器2的时钟就是72MHz。这个“倍频”机制很多人不知道，导致算出来的定时器频率总是差一倍。
3.2 时钟使能与外设功耗
STM32的外设时钟默认是关闭的，用之前必须使能。标准库里的RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE)就是干这个的。如果你忘了使能时钟，GPIO配置写再多也没用，引脚就是不动。这个坑几乎每个初学者都踩过。
从功耗角度考虑，不用的外设时钟应该关掉。做低功耗项目时，进入睡眠模式前要把所有不用的外设时钟关掉，否则电流降不下来。我做过一个STM32鱼缸控制器，待机时电流一直在20mA左右，后来发现是ADC和USART的时钟没关，关掉之后降到了2mA以下。
3.3 时钟安全系统与切换
STM32有一个时钟安全系统（CSS），当HSE失效时，硬件会自动切换到HSI，并产生一个中断。这个功能在工业控制场景里很重要，比如STM32控制伺服电机485通信时，如果外部晶振坏了，系统不能停，要能自动降级运行并报警。配置CSS只需要在RCC初始化里使能RCC_ClockSecuritySystemCmd(ENABLE)，然后在NMI中断里处理。
4. 中断与事件：STM32的“神经系统”
4.1 NVIC优先级分组
Cortex-M内核的中断优先级由NVIC管理。STM32F103有60个可屏蔽中断，每个中断有一个8位的优先级寄存器，但实际只用了高4位。这4位可以分成“抢占优先级”和“响应优先级”，分组方式由NVIC_PriorityGroupConfig决定。
常见的分组是NVIC_PriorityGroup_2，即2位抢占优先级、2位响应优先级。抢占优先级高的可以打断正在执行的低优先级中断，响应优先级高的不能打断，但排队时优先。很多人写串口接收中断和定时器中断时，发现串口数据丢了，就是因为串口中断的抢占优先级太低，被定时器中断打断了。
提示：中断服务函数里尽量只做标志位设置和数据搬运，复杂处理放到主循环里。中断里执行时间过长，会导致其他中断响应延迟，甚至触发看门狗复位。
4.2 外部中断与事件控制器
EXTI可以把GPIO引脚的变化配置成中断或事件。中断会触发CPU跳转，事件只是触发一个脉冲给其他外设，不占用CPU。做按键模块电路设计时，通常用EXTI中断来检测按键按下，然后在中断里设置标志位，主循环里做消抖和处理。
配置EXTI的步骤是：使能GPIO时钟和AFIO时钟，配置GPIO为输入模式，把GPIO引脚映射到EXTI线，配置EXTI触发方式，使能EXTI中断，配置NVIC，最后写中断服务函数。每一步都不能少，尤其是AFIO时钟，忘了使能的话引脚映射不生效。
4.3 定时器中断与PWM输出
STM32的定时器功能非常丰富：基本定时器只能计数，通用定时器可以输出PWM、输入捕获、编码器接口，高级定时器还带死区控制和刹车功能。做两轮差速小车STM32控制时，通常用通用定时器输出两路PWM控制电机速度，用编码器接口读取轮速。
PWM输出的关键是配置ARR（自动重装载值）和CCR（捕获比较值）。频率 = 定时器时钟 / (ARR+1) / (PSC+1)，占空比 = CCR / (ARR+1)。比如定时器时钟72MHz，PSC=71，ARR=999，频率就是72MHz/72/1000 = 1kHz。CCR=500时占空比50%。
做STM32定时器捕获测频率时，用输入捕获模式，记录两次上升沿之间的计数值，就能算出频率。要注意的是，如果信号频率很低，定时器会溢出，需要在溢出中断里累加溢出次数。
5. 通信外设：从USART到USB虚拟串口
5.1 USART串口通信的完整配置
串口是STM32最常用的通信接口。配置一个串口需要：使能USART时钟和GPIO时钟，配置TX为复用推挽输出，RX为浮空输入或上拉输入，配置USART波特率、数据位、停止位、校验位，使能USART，如果需要中断还要配置NVIC。
波特率的计算公式是：波特率 = fCK / (16 × USARTDIV)。fCK是USART的时钟，USART1挂在APB2上，通常是72MHz；USART2挂在APB1上，通常是36MHz。如果波特率设成115200，USARTDIV = 72MHz / (16 × 115200) = 39.0625。整数部分是39，小数部分是0.0625，对应BRR寄存器的值是0x271。
做STM32串口调试PID时，通常会把PID参数通过串口发到上位机，用波形显示。这时候串口发送频率不能太高，否则会占用大量CPU时间。可以用DMA发送，把数据搬到DMA缓冲区，CPU就不用管了。
5.2 USB虚拟串口发送数据的实现思路
STM32的USB外设可以配置成虚拟串口（VCP），在电脑上看起来就是一个COM口。实现VCP需要用到USB库，配置描述符、端点、中断处理。发送数据时，把数据写入发送缓冲区，然后使能端点发送，等USB主机来取。
做STM32 USB设备时，最容易出问题的是时钟配置。USB模块需要48MHz时钟，F103的USB时钟来自PLL，PLL输出72MHz后经过1.5分频得到48MHz。如果时钟不对，USB枚举就会失败。另外，USB的DP和DM引脚需要接1.5k上拉电阻到3.3V，有些开发板已经内置了，有些需要自己加。
5.3 I2C与SPI：连接传感器的两条路
I2C用两根线（SCL、SDA）可以挂多个设备，适合连接BH1750光照传感器、DS3231时钟芯片、OLED显示屏。SPI速度快，适合连接Flash、SD卡、高速ADC。做STM32 BH1750 OLED I2C Proteus完整原理图时，要注意I2C的上拉电阻，通常用4.7kΩ。如果上拉电阻太大，上升沿变缓，通信会失败；太小则功耗增加。
SPI配置要注意时钟极性和相位（CPOL和CPHA），这四个组合决定了数据在时钟的哪个边沿采样。如果配置错了，读出来的数据就是乱的。一般传感器手册里会写明用哪种模式。
6. 调试与下载：ST-Link、JTAG与OTA
6.1 ST-Link Utility与下载调试
ST-Link是ST官方的调试器，配合STM32 ST-Link Utility可以下载程序、读取内存、擦除芯片。有时候Keil5里下载失败，用ST-Link Utility却能连上，这是因为Utility的复位策略更灵活。如果芯片被锁了，可以用Utility的“Connect Under Reset”模式，在复位期间连接，然后擦除整片。
STM32禁用JTAG后，SWD仍然可用。SWD只需要SWCLK和SWDIO两根线，比JTAG少。如果板子空间紧张，可以只留SWD接口。但要注意，禁用JTAG后，PB3、PB4、PA15可以当普通GPIO用，但PB3和PB4默认是JTDO和NJTRST，配置成普通GPIO前要先禁用JTAG。
6.2 OTA升级的基本原理
STM32 OTA通常是通过通信接口（串口、USB、网络）接收新固件，写入Flash的指定区域，然后跳转执行。实现OTA需要把Flash分成Bootloader区和App区。Bootloader负责接收固件、校验、写入，然后跳转到App。App区需要设置向量表偏移，因为中断向量表默认在0x08000000，App在0x08004000的话，向量表也要偏移到那里。
做OTA时，固件校验很重要。可以用CRC32校验，也可以用MD5。如果固件不完整就跳转，程序会跑飞。另外，写入Flash前要先擦除，STM32的Flash擦除是按页的，F103每页1KB或2KB，擦除时间比较长，要留足超时时间。
6.3 常见下载错误与排查
“load ‘d:\stm32 project\2-1 stm32工程模板\objects\project.axf’ error: flash”这个错误很常见，通常是Flash算法没选对，或者芯片型号选错了。在Keil5的Options for Target里，Debug选项卡的Settings里要选对Flash算法，比如STM32F103C8选“STM32F10x Med-density Flash”。如果选成High-density，地址范围不对，就会报错。
还有一种情况是芯片进入了读保护状态，需要先解除保护。用ST-Link Utility连接后，在Target菜单里选“Option Bytes”，把Read Out Protection改成Disabled，然后擦除芯片。
7. 从理论到项目：几个典型场景的拆解
7.1 基于STM32的智能台灯
智能台灯的核心是光感+人体感应+PWM调光。用BH1750采集环境光照，用HC-SR501检测人体，用定时器输出PWM控制LED亮度。逻辑是：有人且环境暗，开灯并调亮度；没人，延时关灯。这个项目涉及I2C、GPIO输入、PWM输出、定时器，是练手的好选择。
做这个项目时，PWM频率要选好。太低会看到闪烁，太高则MOS管发热。一般选1kHz到5kHz。调光曲线要做人眼感知的线性化，因为人眼对亮度的感知是对数关系，直接线性调PWM，低亮度区变化不明显。
7.2 超声波测距与定时器捕获
超声波测距模块HC-SR04需要发一个10us的高电平触发，然后测回响信号的高电平时间。距离 = 时间 × 声速 / 2。用定时器的输入捕获功能测高电平时间最准。配置定时器为捕获模式，上升沿捕获，记录CCR1，然后改成下降沿捕获，记录CCR2，差值就是高电平时间。
要注意的是，超声波测距有盲区，一般2cm以内测不到。另外，声速受温度影响，精确测量需要温度补偿。做STM32超声波测距时，如果发现数据跳动大，可以多次测量取中值滤波。
7.3 两轮差速小车的控制框架
两轮差速小车用两个电机分别驱动左右轮，通过差速实现转向。控制框架通常是：上位机发速度指令，STM32解析后算出左右轮目标速度，用PID调节PWM占空比，用编码器反馈实际速度。通信可以用串口、蓝牙或者485。
做STM32控制伺服电机485时，要注意485是半双工，发送和接收要切换。通常用DE/RE引脚控制收发方向，发送前拉高DE，发送完拉低。如果切换不及时，会丢掉最后几个字节。
7.4 基于STM32的鱼缸控制器
鱼缸控制器要控制水温、灯光、喂食、过滤。温度用DS18B20或者NTC，灯光用PWM调光模拟日出日落，喂食用舵机或者步进电机，过滤用继电器控制水泵。这个项目涉及多种外设，适合综合练习。
做鱼缸控制器时，防水和电气隔离很重要。水泵和加热棒是强电，要用继电器或者光耦隔离，否则干扰会串到STM32上，导致复位或者死机。
8. 开发环境与工具链的选型心得
8.1 Keil5兼容C51和STM32的安装
Keil5可以同时装C51和MDK-ARM两个包，装在不同目录下，然后通过TOOLS.INI配置。但要注意，C51和ARM的编译器不同，同一个工程不能混用。如果先装了C51再装MDK，可能会覆盖一些公共文件，导致其中一个不能用。建议先装MDK，再装C51，装C51时选不同的安装路径。
8.2 VSCode配置STM32开发环境
VSCode配STM32需要装Cortex-Debug插件、ARM GCC工具链、OpenOCD或者ST-Link GDB Server。用Makefile或者CMake组织工程，编译用arm-none-eabi-gcc，调试用OpenOCD。这种方式的优点是编辑器好用、免费、跨平台，缺点是配置麻烦，尤其是调试配置，需要写launch.json和tasks.json。
如果不想折腾，可以用STM32CubeMX生成Makefile工程，然后用VSCode打开。CubeMX会自动生成链接脚本、启动文件、外设初始化代码，省去很多手工配置。
8.3 标准库与HAL库的选择
标准库（SPL）代码直观，寄存器操作清晰，适合学习理论。HAL库抽象程度高，跨系列移植方便，适合做产品。现在ST主推HAL和LL库，标准库已经不再更新。但很多老项目和教程还在用标准库，所以两者都要会。
我的建议是：初学用标准库，把外设配置的每一步都搞清楚；做项目用HAL库，提高开发效率。如果做基于STM32 EtherCAT这种工业通信，通常用HAL库配合专门的协议栈。
9. 那些年我踩过的坑与总结的经验
第一个坑是延时函数delay卡死。很多人用while(i--)做延时，优化等级一高，循环就被优化掉了，延时就不准了。正确的做法是用定时器做延时，或者用__NOP()配合循环，并且把变量声明为volatile。
第二个坑是串口接收丢数据。原因通常是中断优先级没配好，或者接收缓冲区太小。解决方法是提高串口中断的抢占优先级，或者用DMA接收，把数据直接搬到内存。
第三个坑是Flash写入失败。STM32的Flash写入前必须先擦除，而且擦除和写入都要解锁。解锁序列是往FLASH_KEYR写0x45670123，再写0xCDEF89AB。如果忘了解锁，写入操作会被忽略。
第四个坑是USB枚举失败。除了时钟和上拉电阻，还要注意USB描述符的配置。VID、PID、设备类、端点描述符都要正确。如果描述符长度不对，主机就会枚举失败。
第五个坑是中断向量表偏移没设。做OTA或者Bootloader时，App的向量表要偏移到App区的起始地址，否则中断会跳到Bootloader的向量表里，程序跑飞。设置方法是NVIC_SetVectorTable(NVIC_VectTab_FLASH, 0x4000)。
这些坑我都踩过，有些卡了好几天才找到原因。理论的价值就在于，当你理解了时钟树、中断机制、存储器映射这些底层逻辑，排查问题时就有方向了，不会像无头苍蝇一样乱试。STM32的理论不是背出来的，是在调试中一点点悟出来的。你每解决一个bug，对理论的理解就深一层。
