STM32串口动态调整PWM频率占空比：电机控制与LED调光实战

1. 项目概述：一个动态可调的PWM信号发生器

在嵌入式开发，尤其是电机控制、LED调光、舵机驱动这些场景里，PWM（脉冲宽度调制）信号是再基础不过的“硬通货”。但很多时候，我们需要的不是一个固定不变的PWM，而是一个能根据外部指令实时调整频率和占空比的动态信号源。比如，你想通过上位机软件实时调整电机的转速和扭矩，或者通过手机APP远程改变LED灯的亮度，这就需要MCU能接收指令并立刻改变PWM的输出特性。

这个项目要做的，就是基于STM32，打造一个这样的动态PWM信号发生器。它的核心逻辑非常清晰：STM32的定时器负责产生高精度的PWM波形，而串口则扮演“遥控器”的角色。我们通过串口调试助手发送简单的指令，比如“F1000 D50”，MCU收到后就能立刻将PWM频率设置为1000Hz，占空比调整为50%。这相当于给你的STM32项目装上了一双“外部可调”的手，无论是前期调试参数，还是后期实现复杂的人机交互控制，都极其方便。无论你是刚接触STM32的新手，想深入理解定时器和串口，还是正在做智能硬件需要灵活控制接口的老手，这个项目都能提供一套可直接“抄作业”的稳定方案。

2. 核心硬件与软件环境搭建

2.1 硬件选型与电路连接要点

硬件是项目的基石，选择不当会为后续调试埋下无数深坑。对于这个项目，硬件核心就三样：STM32最小系统板、一个用于观察波形的示波器或逻辑分析仪、以及连接电脑的串口模块。

1. STM32型号选择：我强烈推荐从STM32F103C8T6（俗称“蓝桥杯”或“最小系统板”）开始。它价格低廉，资源丰富，拥有多个高级定时器（TIM1）和通用定时器（TIM2、TIM3、TIM4），完全满足PWM输出需求。而且社区资料极其丰富，遇到问题几乎都能找到答案。当然，如果你手头是F4、H7甚至G0系列，原理完全相通，只是寄存器名称或库函数稍有差异。

2. PWM输出引脚确认：不是所有GPIO都能直接输出PWM。必须查阅你所使用型号的《数据手册》中的“复用功能映射”章节。以STM32F103C8T6的TIM3通道1为例，它可能映射到PA6或PB4。你需要根据你的板子布局和走线方便程度来选择。一个关键细节：确保该引脚没有被其他功能（如JTAG/SWD下载口）默认占用。例如PA15（JTDI）、PB3（JTDO）等引脚在上电后默认是调试功能，需要先禁用JTAG才能作为普通GPIO使用。

3. 串口连接方案：STM32的USART1（PA9-TX, PA10-RX）通常最常用。连接电脑有两种主流方式：

• 使用板载的USB转串口芯片：如CH340、CP2102、FT232。这是最方便的方案，用一根USB线就能完成供电和通信。
• 外接USB转TTL模块：如果你的核心板没有集成，就需要一个单独的USB转TTL模块（常用CH340或PL2303芯片）。接线时必须牢记：TX接RX，RX接TX，GND接GND。VCC一般不需要连接，除非你的模块需要从MCU取电。

注意：烧录程序用的ST-Link的SWD接口（SWDIO， SWCLK）和串口通信接口（USART1_TX/RX）是两套完全独立的物理线路，不要混淆。程序是通过SWD口下载到芯片里的，而下载好的程序运行时，是通过USART口与电脑通信的。

2.2 软件开发环境与关键库配置

软件环境我首选Keil MDK（Keil uVision 5），因为它对ARM Cortex-M系列的支持最成熟、最稳定。当然，如果你喜欢VSCode+PlatformIO的清爽，或者想用STM32CubeIDE，也完全可以，底层逻辑是一致的。

1. 工程创建与固件库：新手我建议直接使用STM32标准外设库（Standard Peripheral Library）或HAL库来创建工程。标准库更贴近寄存器，有助于理解本质；HAL库抽象程度高，开发速度快。这里以标准库为例，你需要手动或利用工具添加对应的库文件（stm32f10x_gpio.c,stm32f10x_tim.c,stm32f10x_usart.c等）到工程，并正确配置头文件包含路径。

2. 时钟树配置——一切精度的源头：PWM的频率和串口的波特率，其精度都根植于系统时钟。STM32的时钟树略显复杂，但我们必须搞清楚。以72MHz系统时钟（SYSCLK）为例：

• 定时器时钟：通用定时器（TIM2-4）的时钟通常来源于APB1总线。APB1的预分频器默认是2，所以APB1时钟是36MHz。但定时器连接到APB1时，如果预分频系数≠1，则定时器时钟会倍频x2，因此TIM2-4的时钟（CK_INT）通常是72MHz。这个频率直接决定了我们计算重装载值（ARR）和预分频值（PSC）的基准。
• 串口时钟：USART1挂在APB2总线下（72MHz），USART2/3挂在APB1下（36MHz）。计算波特率时要用对应的总线时钟。

在代码初始化时，我们通常调用SystemInit()函数，它会根据system_stm32f10x.c中的宏定义，将系统时钟配置为72MHz。这是后续所有计算的前提。

3. 串口调试助手的选择：电脑端推荐使用功能清晰、稳定的串口助手，如SSCOM、XCOM或AccessPort。关键是要设置对参数：波特率（与代码中配置一致，如115200）、数据位（8）、停止位（1）、无校验位。发送格式可以选择“字符串”或“十六进制”，本项目我们用字符串指令，所以选“字符串”即可。

3. PWM生成原理与定时器深度配置

3.1 PWM的本质与关键参数解析

PWM不是什么神秘信号，你可以把它想象成一个高速开关的水龙头。这个水龙头只有“全开”和“全关”两种状态。占空比，就是在一个开关周期内，“全开”时间所占的比例。比如50%占空比，意味着半个周期开，半个周期关。频率，就是这个“开-关-开-关”动作每秒钟重复的次数。1KHz就是每秒开关1000次。

在STM32的定时器里，实现PWM输出主要依靠三个核心寄存器：

1. 自动重装载寄存器（ARR）：它决定了计数器的上限。计数器从0开始累加，加到ARR值后，产生一个更新事件，然后清零重新开始。这个“从0到ARR”的时间，就是一个PWM的周期（Period）。
2. 预分频器寄存器（PSC）：它用来对定时器的输入时钟（CK_INT）进行分频。如果输入时钟是72MHz，PSC设置为71（即72-1），那么分频后的计数器时钟频率就是72MHz / (71+1) = 1MHz。PSC决定了计数器累加的“步长”，它和ARR共同决定了PWM的频率。
3. 捕获/比较寄存器（CCRx）：这是我们控制占空比的关键。定时器会不断将计数器的当前值（CNT）与CCRx的值进行比较。当CNT < CCRx时，输出一种电平（通常为高）；当CNT ≥ CCRx且小于ARR时，输出另一种电平（通常为低）。因此，CCRx的值相对于ARR的比例，就决定了占空比。例如，ARR=999，CCRx=300，则占空比为 (300+1) / (999+1) = 30.1%。（这里+1是因为计数器从0开始计数）。

PWM频率的计算公式为：Fpwm = Ftimer / [(ARR + 1) * (PSC + 1)]其中，Ftimer是定时器的输入时钟频率（如72MHz）。

3.2 定时器初始化代码与参数计算实战

理解了原理，我们来看代码。以下是以TIM3的通道1（假设映射到PA6）输出PWM的初始化步骤：

// 1. 开启时钟 RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); // 开启TIM3时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); // 开启GPIOA时钟 // 2. 初始化GPIO为复用推挽输出 GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6; // PA6 GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 复用推挽输出 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 3. 初始化定时器时基单元 TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_TimeBaseStructure.TIM_Period = 999; // ARR值，自动重装载值 TIM_TimeBaseStructure.TIM_Prescaler = 71; // PSC值，预分频系数 TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; // 时钟分频，与采样相关，通常不改 TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; // 向上计数模式 TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure); // 4. 初始化PWM输出模式（通道1） TIM_OCInitTypeDef TIM_OCInitStructure; TIM_OCInitStructure.TIM_OCMode = TIM_OCMode_PWM1; // PWM模式1 TIM_OCInitStructure.TIM_OutputState = TIM_OutputState_Enable; // 使能输出 TIM_OCInitStructure.TIM_Pulse = 500; // CCR1值，初始占空比脉冲宽度，对应50%占空比（500/1000） TIM_OCInitStructure.TIM_OCPolarity = TIM_OCPolarity_High; // 输出极性：高电平有效 TIM_OC1Init(TIM3, &TIM_OCInitStructure); // 初始化通道1 TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); // 使能预装载寄存器 // 5. 使能定时器的预装载寄存器（ARR）和计数器 TIM_ARRPreloadConfig(TIM3, ENABLE); // 使能ARR预装载 TIM_Cmd(TIM3, ENABLE); // 使能定时器，开始计数

参数计算实例：假设我们需要一个1KHz（周期1ms）、占空比50%的PWM，定时器时钟为72MHz。

1. 先确定计数周期：我们希望1ms计数N次。计数器时钟频率需要是1ms / N的倒数。为了计算方便，我们先设定目标计数器频率为1MHz（即每个计数周期1us）。那么，PSC = 72MHz / 1MHz - 1 = 71。
2. 1MHz的时钟下，1ms需要计数1000次。因为计数器从0开始，所以ARR = 1000 - 1 = 999。
3. 验证频率：Fpwm = 72MHz / [(999+1)*(71+1)] = 72MHz / (1000*72) = 1000Hz，正确。
4. 50%占空比，则CCR1 = ARR * 50% = 999 * 0.5 ≈ 500。

实操心得：在调试时，如果完全看不到波形，首先检查GPIO模式是否正确。GPIO_Mode_AF_PP（复用推挽输出）是必须的。如果模式是GPIO_Mode_Out_PP（通用推挽输出），即使定时器配置正确，引脚也不会受定时器控制。

4. 串口通信协议设计与数据解析

4.1 串口初始化与中断配置

串口是我们与外界对话的窗口。我们采用中断方式接收数据，这样MCU就不需要一直死等串口数据，可以同时处理其他任务。

// 1. 开启时钟 RCC_APB2PeriphClockCmd(RCC_APB2Periph_USART1 | RCC_APB2Periph_GPIOA, ENABLE); // 2. 初始化GPIO：PA9-TX（复用推挽输出），PA10-RX（浮空输入） GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_9; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); GPIO_InitStructure.GPIO_Pin = GPIO_Pin_10; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IN_FLOATING; // 浮空输入 GPIO_Init(GPIOA, &GPIO_InitStructure); // 3. 初始化USART参数 USART_InitTypeDef USART_InitStructure; USART_InitStructure.USART_BaudRate = 115200; // 波特率 USART_InitStructure.USART_WordLength = USART_WordLength_8b; // 8位数据 USART_InitStructure.USART_StopBits = USART_StopBits_1; // 1位停止位 USART_InitStructure.USART_Parity = USART_Parity_No; // 无校验 USART_InitStructure.USART_HardwareFlowControl = USART_HardwareFlowControl_None; // 无硬件流控 USART_InitStructure.USART_Mode = USART_Mode_Rx | USART_Mode_Tx; // 收发模式 USART_Init(USART1, &USART_InitStructure); // 4. 配置串口接收中断 USART_ITConfig(USART1, USART_IT_RXNE, ENABLE); // 使能“接收寄存器非空”中断 // 5. 配置NVIC（嵌套向量中断控制器） NVIC_InitTypeDef NVIC_InitStructure; NVIC_InitStructure.NVIC_IRQChannel = USART1_IRQn; NVIC_InitStructure.NVIC_IRQChannelPreemptionPriority = 1; // 抢占优先级 NVIC_InitStructure.NVIC_IRQChannelSubPriority = 1; // 子优先级 NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; NVIC_Init(&NVIC_InitStructure); // 6. 使能串口 USART_Cmd(USART1, ENABLE);

4.2 自定义简单通信协议与解析逻辑

为了让指令清晰可辨，我们设计一个简单的文本协议。例如：

• F1000：设置频率为1000Hz。
• D50：设置占空比为50%。
• F500 D25：同时设置频率500Hz，占空比25%。

在串口中断服务函数中，我们需要解析这些指令：

#define RX_BUF_SIZE 64 char uart_rx_buf[RX_BUF_SIZE]; uint8_t uart_rx_index = 0; uint8_t uart_rx_flag = 0; // 接收完成标志 void USART1_IRQHandler(void) { if(USART_GetITStatus(USART1, USART_IT_RXNE) != RESET) { char received_char = USART_ReceiveData(USART1); // 读取一个字节 // 简单判断：以回车换行(\r\n)作为一帧数据的结束 if(received_char == '\n' || received_char == '\r') { if(uart_rx_index > 0) { // 防止空帧 uart_rx_buf[uart_rx_index] = '\0'; // 添加字符串结束符 uart_rx_flag = 1; // 设置标志位，通知主循环处理 uart_rx_index = 0; } } else { if(uart_rx_index < (RX_BUF_SIZE - 1)) { uart_rx_buf[uart_rx_index++] = received_char; } else { // 缓冲区溢出，清空缓冲区 uart_rx_index = 0; } } } }

在主循环中，我们检查uart_rx_flag，然后解析缓冲区内的字符串：

void parse_and_execute_command(char* cmd) { char* token; token = strtok(cmd, " "); // 用空格分割指令 while(token != NULL) { if(token[0] == 'F' || token[0] == 'f') { // 解析频率值 uint32_t freq = atoi(&token[1]); // 跳过首字符'F'，转换后面的数字 set_pwm_frequency(freq); // 调用设置频率的函数 printf("Set Freq to: %lu Hz\r\n", freq); } else if(token[0] == 'D' || token[0] == 'd') { // 解析占空比值 uint8_t duty = atoi(&token[1]); // 跳过首字符'D' set_pwm_duty_cycle(duty); // 调用设置占空比的函数 printf("Set Duty to: %u %%\r\n", duty); } token = strtok(NULL, " "); // 继续分割下一个参数 } }

注意事项：atoi函数在遇到非数字字符时会停止转换。如果用户输入了F1000a，它仍然会转换出1000。对于工业级应用，需要更健壮的解析，比如检查整个字符串是否都是数字。此外，指令间最好有明确的分隔符（如空格或逗号），并做好缓冲区溢出保护。

5. 动态调整PWM参数的实现与优化

5.1 实时更新ARR与CCR寄存器的策略

收到新的频率或占空比指令后，我们需要动态修改定时器的ARR和CCRx寄存器。这里有一个关键陷阱：直接修改这些寄存器，可能会在不当的时机（比如计数器正在从ARR向0翻转时）导致输出波形出现毛刺或短时间的异常。

安全的更新策略是使用定时器的“预装载寄存器”功能。我们之前初始化时已经通过TIM_ARRPreloadConfig和TIM_OCxPreloadConfig使能了预装载。这意味着我们修改的TIMx->ARR或TIMx->CCRx值，并不会立即生效，而是先写入一个“影子寄存器”。等到当前计数周期结束，产生下一次“更新事件”（Update Event，UEV）时，影子寄存器的值才会被真正加载到工作寄存器中。这样就保证了在一个完整的PWM周期内，参数是稳定的。

void set_pwm_frequency(uint32_t freq_hz) { if(freq_hz == 0 || freq_hz > 100000) return; // 简单的参数范围检查 // 假设定时器时钟为72MHz，PSC固定为71（得到1MHz计数器时钟） uint32_t timer_clock = 72000000; uint32_t counter_clock = timer_clock / (71 + 1); // 1MHz uint32_t arr_value = (counter_clock / freq_hz) - 1; if(arr_value > 65535) return; // 对于16位定时器，ARR不能超过65535 TIM3->ARR = arr_value; // 修改ARR，值会在下次更新事件时生效 // 通常改变频率后，为了保持占空比比例，需要同步调整CCR // 可以在这里读取当前占空比百分比，然后根据新的ARR重新计算CCR // uint32_t new_ccr = (arr_value + 1) * current_duty_percent / 100; // TIM3->CCR1 = new_ccr; } void set_pwm_duty_cycle(uint8_t duty_percent) { if(duty_percent > 100) duty_percent = 100; uint32_t arr_value = TIM3->ARR; // 计算CCR值。注意：占空比 = (CCR+1) / (ARR+1)，所以 CCR = (ARR+1) * duty / 100 - 1 // 但为了直观，通常近似为 CCR = ARR * duty / 100 uint32_t ccr_value = (arr_value + 1) * duty_percent / 100; // 确保CCR值有效 if(ccr_value > arr_value) ccr_value = arr_value; // 对于某些应用（如舵机），CCR为0可能意味着0脉宽，需要特殊处理 if(ccr_value == 0 && duty_percent > 0) ccr_value = 1; TIM3->CCR1 = ccr_value; // 修改CCR1，值会在下次更新事件（或根据模式）时生效 }

5.2 参数边界处理与系统稳定性保障

动态调整时，必须考虑参数的合法性和系统的稳定性。

1. 频率范围限制：

   • 下限：频率不能为0。同时，过低的频率（如1Hz）意味着ARR值会非常大。对于16位定时器，ARR最大65535。在1MHz计数器时钟下，最低频率约为1MHz / 65536 ≈ 15.26Hz。如果需要更低的频率，可以增大PSC值，但会损失分辨率。
   • 上限：受限于定时器时钟和分辨率要求。频率太高，ARR值会很小。例如，72MHz时钟，PSC=0，ARR最小为1，此时频率高达36MHz，但这几乎不再是PWM，而是方波。同时，高频率下，占空比调节的步进（分辨率）会变粗。需要根据实际应用权衡。

2. 占空比边界与死区：

   • 占空比理论上在0%到100%之间。但实际应用中，0%和100%可能对应着常低或常高的电平，失去了调制意义。有些电机驱动或电源电路还需要设置“死区时间”，防止上下桥臂直通。这通常需要使用定时器的互补输出和刹车死区功能，本项目暂不涉及。

3. 原子操作与临界区保护： 在更复杂的系统中（如使用了RTOS），修改ARR和CCR的代码可能被中断打断，导致参数不匹配。虽然本例中单线程修改问题不大，但养成好习惯，可以使用__disable_irq()和__enable_irq()临时关闭中断，或者使用RTOS提供的信号量、互斥锁来保护这些关键操作。

4. 反馈与验证： 修改参数后，可以通过串口将计算出的ARR、CCR值或实际频率占空比回传给电脑，形成一个闭环，方便调试。例如，在set_pwm_frequency函数最后，可以计算实际设置成功的频率：real_freq = counter_clock / (TIM3->ARR + 1)，并打印出来。

6. 系统集成、调试与问题排查实录

6.1 主程序逻辑与系统集成

将PWM初始化和串口初始化的代码整合起来，主函数的逻辑就非常清晰了：

#include "stm32f10x.h" #include "stdio.h" // 用于printf重定向 #include "string.h" // ... 上述初始化函数和解析函数定义 ... int main(void) { // 初始化系统时钟（通常由SystemInit()在启动文件调用） // 初始化延时函数（如果需要） delay_init(); // 初始化串口1 uart1_init(115200); // 初始化PWM（TIM3, CH1, 1KHz, 50%） pwm_init(1000, 50); printf("System Ready. Send 'Fxxx' or 'Dxx' to adjust PWM.\r\n"); while(1) { if(uart_rx_flag == 1) { uart_rx_flag = 0; parse_and_execute_command(uart_rx_buf); } // 这里可以添加其他任务，如按键扫描、LED闪烁等 delay_ms(10); } } // 重定向printf到串口1（需在工程设置中勾选“Use MicroLIB”） int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t) ch); while(USART_GetFlagStatus(USART1, USART_FLAG_TC) == RESET); return ch; }

6.2 典型问题排查与解决方法

在实际焊接电路和调试代码时，你几乎一定会遇到下面这些问题。我把它们和排查思路整理成了表格，希望能帮你快速定位。

一个高级调试技巧：使用定时器的“强制输出”功能。在初始化后，可以调用TIM_ForcedOCxConfig(TIM3, TIM_ForcedAction_Active)来强制通道输出有效电平（高或低，取决于极性）。这可以帮你快速判断是定时器配置问题，还是后续比较逻辑问题。如果强制输出有电平变化，但正常PWM模式没有，那问题很可能出在CCR寄存器的比较匹配环节。

7. 项目扩展与进阶应用思路

这个基础框架搭建好后，你可以根据实际需求进行无限扩展，让它从一个实验项目变成真正产品的一部分。

1. 指令协议增强：

• 增加校验和：在指令末尾添加一个简单的校验和（如所有字节相加取低8位），提高通信可靠性。
• 采用更高效的二进制协议：对于需要高速调整的场景，可以将“F”、“D”和数值打包成固定的二进制帧，例如0x46 0x03 0xE8代表F1000（0x03E8=1000），减少数据量，加快解析速度。
• 加入查询指令：发送“?F”或“?D”，MCU返回当前的频率和占空比值。

2. 控制精度与平滑性优化：

• 使用32位定时器：对于需要极宽频率范围或高分辨率占空比的应用，可以选用STM32的32位定时器（如TIM2/TIM5，某些型号支持）。
• 实现软启动/软停止：在改变电机速度时，突然的频率或占空比跳变可能引起冲击。可以在set_pwm_frequency函数中实现一个循环，让ARR或CCR在若干毫秒内渐变到目标值。
• 加入闭环反馈：如果控制的是电机，可以结合编码器读取实际转速，构成PID闭环控制。串口指令设定目标转速，MCU自动调整PWM占空比来维持转速稳定。

3. 应用场景拓展：

• 智能LED调光台灯：通过手机APP（通过蓝牙或Wi-Fi模块转串口）发送指令，无级调节亮度和色温（需要多路PWM控制不同颜色的LED）。
• 直流电机调速器：结合H桥驱动电路（如L298N、TB6612），用本系统生成的PWM控制电机转速和方向（方向可用另一个GPIO控制）。
• 简易信号发生器：通过精细计算ARR和PSC，可以输出特定频率和占空比的方波，作为数字电路的测试信号源。
• 舵机控制器：舵机控制需要的是50Hz（周期20ms）的PWM，且高电平脉冲宽度在0.5ms到2.5ms之间对应0-180度角度。你可以固定频率，通过串口指令改变CCR值来控制角度，CCR = (PulseWidth_us / (1000000 / Ftimer)) - 1。

我个人在多次项目中实践下来的体会是，“串口调PWM”这个功能看似简单，但它像一把瑞士军刀，是调试和验证电机驱动、电源管理、照明控制等几乎所有涉及模拟量输出场景的利器。前期花点时间把它做稳定、做灵活，后期调试效率会成倍提升。最后再分享一个小技巧：在开发初期，可以固定一个LED灯到PWM输出引脚上。通过观察LED的亮度变化，你就能非常直观地“看到”占空比的变化，而无需总是依赖示波器，这会让你的调试过程生动很多。