STM32入门实战：GPIO、串口、定时器与PWM避坑指南

简介这份资源面向STM32初学者与嵌入式入门开发者围绕五个基础实验程序展开帮助读者快速上手GPIO、定时器、中断、ADC与PWM等核心外设。压缩包共7个文件全部为c源码整体约8KB涵盖流水灯、呼吸灯、小车寻迹、外部中断、按键与定时器等典型例程代码结构简洁便于直接阅读与移植。其中流水灯演示GPIO电平控制与延时循环呼吸灯通过PWM占空比调节实现亮度渐变小车寻迹结合传感器采样与电机方向控制外部中断与定时器则帮助理解中断向量表、优先级及时间基准的配置思路。已有4041人学习适合作为课程实验、自学练手或项目原型的参考起点通过动手实践逐步建立STM32开发的知识框架。1. STM32几个简单小程序从点灯到串口为什么你烧录后没反应很多人第一次拿到 STM32 开发板照着教程写了个 LED 闪烁编译零报错烧录也提示成功结果板子上的灯纹丝不动。这不是玄学是 STM32 最小系统的启动链路比你想象的要多几道关卡。STM32 简单小程序通常指 GPIO 点灯、按键输入、串口收发、定时器延时、PWM 呼吸灯这几类它们代码量不大但每一类都踩在时钟树、外设初始化和启动文件这三个关键点上。这篇文章面向刚接触 STM32 的嵌入式方向从业者也适合从 51 单片机转过来、被 HAL 库和寄存器两种写法搞晕的人。我会把每个小程序的完整代码、参数含义、编译烧录步骤和最常见的翻车点讲清楚让你不只是复制粘贴而是知道改哪一行会出什么效果。看完你至少能独立跑通五个基础程序并且知道出问题时先查哪里。2. 点灯与按键GPIO 最小系统的时钟、模式与消抖2.1 为什么第一件事是开时钟而不是写引脚STM32 的任何外设包括 GPIO在使用前都必须使能对应的时钟。以常见的 STM32F103 系列为例GPIOA 挂在 APB2 总线上GPIOB 和 GPIOC 同样在 APB2。如果你用 HAL 库__HAL_RCC_GPIOA_CLK_ENABLE()这一句就是开时钟如果你用标准库就是RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE)。很多人从 51 过来习惯直接写P1 0xFE到了 STM32 发现不灵就是因为没开时钟。时钟没开你写引脚配置寄存器等于往一个断电的寄存器里写值外设根本不工作。下面是一个用 HAL 库写的 LED 闪烁最小程序基于常见的 F103C8T6 核心板LED 接在 PA5低电平点亮。#include stm32f1xx_hal.h void SystemClock_Config(void); static void MX_GPIO_Init(void); int main(void) { HAL_Init(); // 初始化 HAL 库配置 SysTick 为 1ms 中断 SystemClock_Config(); // 配置系统时钟F103 通常跑到 72MHz MX_GPIO_Init(); // 初始化 GPIO 时钟和引脚 while (1) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // 翻转 PA5 电平 HAL_Delay(500); // 延时 500msHAL_Delay 依赖 SysTick } } static void MX_GPIO_Init(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); // 关键使能 GPIOA 时钟 GPIO_InitStruct.Pin GPIO_PIN_5; GPIO_InitStruct.Mode GPIO_MODE_OUTPUT_PP; // 推挽输出 GPIO_InitStruct.Pull GPIO_NOPULL; // 不上拉不下拉 GPIO_InitStruct.Speed GPIO_SPEED_FREQ_LOW; // 低速即可点灯不需要高速 HAL_GPIO_Init(GPIOA, GPIO_InitStruct); HAL_GPIO_WritePin(GPIOA, GPIO_PIN_5, GPIO_PIN_SET); // 默认输出高灯灭 }这段代码里SystemClock_Config通常由 CubeMX 生成核心是把外部 8MHz 晶振经过 PLL 倍频到 72MHz。如果你用的是内部 HSI也能跑但串口波特率会有偏差后面串口那节会讲。GPIO_InitStruct.Speed这个参数在点灯场景下设成 Low 就够了设成 High 反而增加 EMI没有好处。Pull设成 NOPULL 是因为 LED 电路通常已经有外部限流电阻不需要内部上下拉。2.2 按键输入上拉、下拉与消抖的三种做法按键比点灯多一个坑机械按键按下和松开瞬间会产生 5 到 20ms 的抖动如果你在中断里直接计数一次按下可能触发几十次中断。常见做法有三种硬件 RC 消抖、软件延时消抖、定时器扫描消抖。我一般推荐定时器扫描因为不阻塞主循环。先看按键的 GPIO 配置。如果按键一端接引脚、另一端接 GND那么引脚需要配置成上拉输入这样松开时读到高电平按下读到低电平。static void MX_GPIO_Key_Init(void) { GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOB_CLK_ENABLE(); GPIO_InitStruct.Pin GPIO_PIN_0; GPIO_InitStruct.Mode GPIO_MODE_INPUT; // 输入模式 GPIO_InitStruct.Pull GPIO_PULLUP; // 内部上拉按键接 GND HAL_GPIO_Init(GPIOB, GPIO_InitStruct); }软件延时消抖最简单但会阻塞if (HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) GPIO_PIN_RESET) { HAL_Delay(20); // 延时 20ms 避开抖动 if (HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) GPIO_PIN_RESET) { // 确认按下执行动作 HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); while (HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) GPIO_PIN_RESET); // 等待松开 } }定时器扫描的做法是每 10ms 进一次定时器中断在中断里读引脚状态并做移位判断连续三次读到低电平才认为按下。这样主循环完全不阻塞适合按键多、逻辑复杂的场景。参数上扫描周期建议 5 到 10ms太短浪费 CPU太长响应迟钝。注意如果你用 CubeMX 生成代码按键引脚配置成 GPIO_Input 后默认上下拉是 NOPULL需要手动改成 PULLUP 或 PULLDOWN否则引脚浮空读到的值随机跳。3. 串口收发波特率、重定向与中断接收的完整链路3.1 串口初始化的四个必调参数串口是 STM32 调试和通信最常用的外设。以 USART1 为例PA9 是 TXPA10 是 RX。用 HAL 库初始化时下面四个参数必须和上位机一致否则收到的全是乱码。参数常用值说明BaudRate115200波特率上位机串口助手必须相同WordLengthUART_WORDLENGTH_8B数据位 8 位StopBitsUART_STOPBITS_1停止位 1 位ParityUART_PARITY_NONE无校验初始化代码如下UART_HandleTypeDef huart1; void MX_USART1_UART_Init(void) { huart1.Instance USART1; huart1.Init.BaudRate 115200; huart1.Init.WordLength UART_WORDLENGTH_8B; huart1.Init.StopBits UART_STOPBITS_1; huart1.Init.Parity UART_PARITY_NONE; huart1.Init.Mode UART_MODE_TX_RX; huart1.Init.HwFlowCtl UART_HWCONTROL_NONE; // 不用硬件流控 huart1.Init.OverSampling UART_OVERSAMPLING_16; HAL_UART_Init(huart1); }OverSampling设成 16 是标准做法只有在高波特率且时钟有偏差时才考虑 8 倍过采样。HwFlowCtl在只接 TX/RX/GND 三根线时必须设成 NONE否则可能因为 CTS/RTS 没接而卡住。3.2 printf 重定向到串口的两种写法调试时最方便的是直接用printf输出。在 Keil 或 GCC 下需要重定向fputc或_write。以 Keil 为例#include stdio.h int fputc(int ch, FILE *f) { HAL_UART_Transmit(huart1, (uint8_t *)ch, 1, HAL_MAX_DELAY); return ch; }如果你用 GCC 编译比如在 VSCode 加 ARM 工具链需要重定向_writeint _write(int file, char *ptr, int len) { HAL_UART_Transmit(huart1, (uint8_t *)ptr, len, HAL_MAX_DELAY); return len; }逻辑说明HAL_UART_Transmit是阻塞发送HAL_MAX_DELAY表示一直等到发送完成。在 115200 波特率下发一个字符大约 87 微秒对大多数调试场景够用。如果你在主循环里高频打印建议改成 DMA 发送否则会拖慢主循环。3.3 中断接收为什么你的接收缓冲会丢数据轮询接收HAL_UART_Receive会阻塞实际项目里更常用中断接收。HAL 库的中断接收一次只能收指定长度收完进回调。常见做法是开一个字节一个字节收或者用空闲中断加 DMA 收不定长数据。下面是一个中断接收单字节并回显的例子uint8_t rx_byte; void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart) { if (huart-Instance USART1) { HAL_UART_Transmit(huart1, rx_byte, 1, HAL_MAX_DELAY); // 回显 HAL_UART_Receive_IT(huart1, rx_byte, 1); // 重新开启接收 } } // 在 main 初始化后调用一次 HAL_UART_Receive_IT(huart1, rx_byte, 1);关键点每次进回调后必须重新调用HAL_UART_Receive_IT否则只能收一次。这是新手最常踩的坑表现为“串口只能收到第一个字符”。另外回调函数里不要做耗时操作否则可能影响下一次接收。提示如果你要收不定长数据推荐用HAL_UARTEx_ReceiveToIdle_DMA配合空闲中断一次能收一帧不用自己拼包。4. 定时器与 PWM从精准延时到呼吸灯的参数计算4.1 定时器中断算清楚预分频和重装载值STM32 的定时器本质上是一个计数器时钟经过预分频器分频后驱动计数器计数计到重装载值就产生中断。以 TIM2 为例挂在 APB1 总线上F103 的 APB1 定时器时钟是 72MHz。如果你想要 1ms 中断一次计算如下定时器时钟 72MHz预分频值 Prescaler 设为 71得到 72MHz / (711) 1MHz即计数一次 1 微秒重装载值 Period 设为 999计数 1000 次就是 1msTIM_HandleTypeDef htim2; void MX_TIM2_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig {0}; TIM_MasterConfigTypeDef sMasterConfig {0}; htim2.Instance TIM2; htim2.Init.Prescaler 71; // 72MHz / 72 1MHz htim2.Init.CounterMode TIM_COUNTERMODE_UP; htim2.Init.Period 999; // 1MHz / 1000 1kHz即 1ms htim2.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim2.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_Base_Init(htim2); HAL_TIM_Base_Start_IT(htim2); // 开启定时器中断 } void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); // 每 1ms 翻转一次周期 2ms } }AutoReloadPreload建议使能这样修改 Period 时在下一个更新事件才生效避免当前周期被截断。ClockDivision一般用 DIV1它影响的是数字滤波器采样时钟不影响计数频率。4.2 PWM 呼吸灯频率、占空比与亮度曲线PWM 输出用定时器的输出比较通道。以 TIM3 通道 1 为例引脚是 PA6。假设你要驱动 LED 做呼吸灯PWM 频率建议在 1kHz 以上太低会看到闪烁。计算方式定时器时钟 72MHzPrescaler 设为 71得到 1MHzPeriod 设为 999得到 1kHz PWM 频率占空比 Pulse / (Period1)Pulse 从 0 到 1000 变化TIM_HandleTypeDef htim3; TIM_OC_InitTypeDef sConfigOC {0}; void MX_TIM3_PWM_Init(void) { htim3.Instance TIM3; htim3.Init.Prescaler 71; htim3.Init.CounterMode TIM_COUNTERMODE_UP; htim3.Init.Period 999; htim3.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_PWM_Init(htim3); sConfigOC.OCMode TIM_OCMODE_PWM1; sConfigOC.Pulse 0; // 初始占空比 0 sConfigOC.OCPolarity TIM_OCPOLARITY_HIGH; sConfigOC.OCFastMode TIM_OCFAST_DISABLE; HAL_TIM_PWM_ConfigChannel(htim3, sConfigOC, TIM_CHANNEL_1); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); } // 呼吸效果在主循环里改变占空比 for (int i 0; i 1000; i 10) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, i); HAL_Delay(10); } for (int i 1000; i 0; i - 10) { __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, i); HAL_Delay(10); }__HAL_TIM_SET_COMPARE是宏直接改比较寄存器比重新调用HAL_TIM_PWM_ConfigChannel快得多。呼吸灯的亮度曲线如果线性变化人眼看起来会中间亮两边暗想要更均匀可以查表用指数曲线但简单演示线性就够了。5. 避坑与排查烧录失败、串口乱码、中断不进的 5 个血泪记录5.1 烧录提示成功但程序不跑现象Keil 或 STM32CubeProgrammer 提示下载完成复位后 LED 不闪串口无输出。原因最常见的是启动模式引脚 BOOT0 被拉高芯片进了系统存储器启动不执行你烧录的 Flash 程序。其次是复位电路电容过大复位时间不够。解决检查 BOOT0 是否接 GNDBOOT1 任意。用示波器看 NRST 引脚上电后应该有一个低脉冲然后拉高。如果没有换小一点的复位电容通常 100nF 足够。5.2 串口收到乱码现象串口助手能收到数据但全是乱码或者偶尔对几个字符。原因波特率不匹配占八成剩下两成是系统时钟配置错误。比如你外部晶振是 8MHz但代码里按 12MHz 算 PLL实际系统时钟就不是 72MHz串口分频值跟着错。解决先用示波器或逻辑分析仪测 TX 引脚发 0x55 时波形应该是方波周期对应波特率。115200 波特率下一位约 8.68 微秒。如果周期不对回头查SystemClock_Config里的 HSE_VALUE 宏定义是否和实际晶振一致。5.3 中断只进一次现象串口中断接收只能收到第一个字节之后再也不进回调。原因HAL 库的中断接收在收完指定长度后会关闭接收中断必须在回调里重新调用HAL_UART_Receive_IT。解决在HAL_UART_RxCpltCallback末尾重新开启接收。如果是 DMA 接收检查 DMA 传输完成中断是否清除标志位。5.4 定时器中断频率不对现象想要 1ms 中断实际测出来是 2ms 或 0.5ms。原因Prescaler 和 Period 的加一关系记反了。实际分频系数是 Prescaler1实际计数次数是 Period1。解决重新算一遍。72MHz 要 1kHz 中断Prescaler71Period999。如果你设成 Prescaler72Period1000实际频率就是 72MHz/73/1001≈985Hz有偏差。5.5 按键按一次触发多次现象按键按一下LED 翻转好几次。原因机械抖动或者按键引脚浮空导致电平跳变。解决先确认引脚配置了上拉或下拉不要浮空。然后加消抖软件延时 20ms 或定时器扫描。如果用了外部中断建议在中断里只置标志位消抖放在主循环或定时器里做。6. 进阶技巧用状态机把几个小程序串成一个可扩展的框架跑通单个程序之后下一步是把它们组织起来。我一般会用一个基于定时器 tick 的状态机框架主循环不阻塞按键、串口、LED 各自独立。核心思路是每 1ms 进一次定时器中断在中断里给各个任务计数器加一主循环里判断计数器是否到达设定值到了就执行对应任务。volatile uint32_t tick_1ms 0; void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2) { tick_1ms; } } typedef struct { uint32_t last_tick; uint32_t interval; void (*task)(void); } soft_timer_t; void led_task(void) { HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); } void key_task(void) { static uint8_t last_state 1; uint8_t current HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0); if (last_state 1 current 0) { // 检测到下降沿这里可以加计数消抖 HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5); } last_state current; } soft_timer_t tasks[] { {0, 500, led_task}, {0, 10, key_task}, }; int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_TIM2_Init(); MX_USART1_UART_Init(); HAL_TIM_Base_Start_IT(htim2); while (1) { for (int i 0; i sizeof(tasks)/sizeof(tasks[0]); i) { if (tick_1ms - tasks[i].last_tick tasks[i].interval) { tasks[i].last_tick tick_1ms; tasks[i].task(); } } } }这个框架的好处是加新任务只需要在tasks数组里加一行不用改主循环结构。tick_1ms用volatile修饰因为它在中断里修改、主循环里读取。减法比较tick_1ms - last_tick而不是直接大于是为了处理计数器溢出这是嵌入式里常用的无符号回绕技巧。参数上interval根据任务实时性要求设LED 500ms 足够按键扫描 10ms 一次串口解析可以放到 5ms 一次。如果某个任务执行时间超过它的 interval会挤占其他任务这时候要么降低频率要么把耗时操作拆成状态机分步执行。我自己的习惯是每加一个新外设先单独写一个最小测试程序确认硬件和配置没问题再往框架里合。直接在大框架里调新外设出了问题很难定位是配置错还是任务调度冲突。这个习惯帮我省了很多后悔药。希望帮到你。本文还有配套的精品资源点击获取