STM32定时器输入捕获实战：用HAL库测量PWM频率与占空比（附完整代码）

STM32定时器输入捕获实战用HAL库测量PWM频率与占空比附完整代码在嵌入式项目开发中我们常常需要与外部世界进行“对话”。比如一个电机驱动器送来一串PWM信号告诉你它的转速或者一个传感器用特定频率的脉冲报告测量值。作为开发者我们的任务就是准确“听懂”这些信号。对于STM32这类主流微控制器而言定时器的输入捕获功能正是完成这项任务的“耳朵”。它不仅能捕捉信号的边沿更能精确测量出信号的频率与占空比这两个核心参数。然而从原理理解到项目落地中间往往隔着一条名为“实战细节”的鸿沟。HAL库虽然封装了底层操作但配置不当极易导致测量结果跳动、中断响应不及时甚至完全无法捕获信号。本文将从一个完整的、可直接移植的工程模块出发手把手带你跨越这条鸿沟。我们将聚焦于通用定时器深入剖析如何利用HAL库高效、稳定地实现PWM测量并分享那些在数据手册里找不到的配置技巧与中断优化心得。无论你是正在调试无刷电机驱动还是需要解析红外遥控编码这篇文章提供的思路和代码都将为你节省大量摸索时间。1. 理解核心输入捕获如何“抓住”PWM的脉搏在深入代码之前我们必须先弄清楚定时器是如何“看见”并“测量”一个外部脉冲信号的。这不仅仅是配置几个寄存器那么简单而是理解硬件如何与我们协作。1.1 定时器计数与捕获通道的协同想象一下STM32的通用定时器内部有一个永不疲倦的跑者计数器CNT它按照你设定的步频时钟频率在一条环形跑道上从0到自动重载值ARR匀速奔跑。输入捕获功能则是在这条跑道的几个特定位置安装了高精度的“抓拍相机”捕获/比较寄存器CCR。当外部信号引脚例如TI1上发生你指定的事件比如上升沿时“相机”会瞬间按下快门将此刻跑者所在的位置CNT的值定格并保存到对应的CCR寄存器中。这个“定格”的数值就是时间戳。通过计算连续两个事件的时间戳差值我们就能得到时间间隔。对于PWM信号周期频率测量连续两个上升沿或下降沿之间的时间差。高电平时间占空比测量一个上升沿到紧随其后的下降沿之间的时间差。注意定时器的计数频率决定了测量的时间分辨率。例如如果定时器时钟为72MHz预分频器设置为71即72MHz/(711)1MHz那么计数器每计数一次就代表1微秒。这是后续所有时间计算的基础。1.2 测量策略与溢出处理一个直接的测量想法是在第一个上升沿捕获时间戳T1在下降沿捕获T2在下一个上升沿捕获T3。那么高电平时间 T2 - T1周期 T3 - T1占空比 (T2 - T1) / (T3 - T1)但这里隐藏着一个关键问题计数器溢出。如果信号的周期很长计数器可能在T1到T3之间已经跑完了好几圈。如果我们只记录CCR的值就会丢失圈数信息导致计算结果完全错误。因此一个健壮的测量程序必须处理溢出。通常的做法是开启定时器的更新中断每当计数器从ARR值翻转到0完成一圈就会产生一个更新事件和中断。在更新中断中维护一个溢出计数器例如overflow_count。在计算时间间隔时将溢出次数考虑进去实际计数值 overflow_count * (ARR 1) CCR_current - CCR_previous这里ARR1是一圈的总计数值。下面的伪代码展示了这个核心逻辑volatile uint32_t overflow_cnt 0; volatile uint32_t last_capture 0; volatile uint32_t period_ticks 0; // 在定时器更新中断溢出中断中 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIMx) { overflow_cnt; } } // 在输入捕获中断中以上升沿为例 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIMx) { uint32_t current_capture HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); period_ticks (overflow_cnt * (htim-Init.Period 1)) (current_capture - last_capture); last_capture current_capture; overflow_cnt 0; // 重置溢出计数为下一个周期准备 } }2. 工程搭建从零配置HAL库输入捕获理论清晰后我们开始动手。这里以STM32F103C8T6蓝色药丸核心板的TIM3通道1PA6引脚为例测量一个外部PWM信号。2.1 硬件与时钟初始化首先通过STM32CubeMX或手动初始化确保定时器有正确的时钟源。对于通用定时器TIM2-TIM5时钟通常来自APB1总线。关键配置参数表配置项参数示例说明定时器TIM3选择具有输入捕获功能的通用定时器时钟源Internal Clock使用内部时钟驱动计数器预分频器 (PSC)71系统时钟72MHz下得到1MHz计数频率1us分辨率计数模式Up向上计数模式自动重载值 (ARR)6553516位定时器的最大值决定溢出周期捕获通道CH1对应到具体GPIO引脚如PA6极性Rising Edge / Falling Edge初始捕获边沿程序中会动态切换输入滤波0根据信号噪声情况调整可抑制毛刺在main.c或单独的定时器配置文件中初始化代码结构如下TIM_HandleTypeDef htim3; void MX_TIM3_Init(void) { TIM_ClockConfigTypeDef sClockSourceConfig {0}; TIM_MasterConfigTypeDef sMasterConfig {0}; TIM_IC_InitTypeDef sConfigIC {0}; htim3.Instance TIM3; htim3.Init.Prescaler 71; // 72MHz / (711) 1MHz htim3.Init.CounterMode TIM_COUNTERMODE_UP; htim3.Init.Period 65535; // 最大计数值 htim3.Init.ClockDivision TIM_CLOCKDIVISION_DIV1; htim3.Init.AutoReloadPreload TIM_AUTORELOAD_PRELOAD_DISABLE; if (HAL_TIM_Base_Init(htim3) ! HAL_OK) { Error_Handler(); } sClockSourceConfig.ClockSource TIM_CLOCKSOURCE_INTERNAL; if (HAL_TIM_ConfigClockSource(htim3, sClockSourceConfig) ! HAL_OK) { Error_Handler(); } // 输入捕获通道配置 sConfigIC.ICPolarity TIM_INPUTCHANNELPOLARITY_RISING; // 初始捕获上升沿 sConfigIC.ICSelection TIM_ICSELECTION_DIRECTTI; // 引脚直接连接到捕获单元 sConfigIC.ICPrescaler TIM_ICPSC_DIV1; // 每个边沿都捕获 sConfigIC.ICFilter 0; // 不滤波 if (HAL_TIM_IC_ConfigChannel(htim3, sConfigIC, TIM_CHANNEL_1) ! HAL_OK) { Error_Handler(); } // 配置GPIO PA6为复用功能上拉或浮空输入根据外部信号驱动能力决定 GPIO_InitTypeDef GPIO_InitStruct {0}; __HAL_RCC_GPIOA_CLK_ENABLE(); GPIO_InitStruct.Pin GPIO_PIN_6; GPIO_InitStruct.Mode GPIO_MODE_AF_INPUT; // 复用功能输入 GPIO_InitStruct.Pull GPIO_NOPULL; // 外部信号强则用NOPULL弱则用PULLUP HAL_GPIO_Init(GPIOA, GPIO_InitStruct); }2.2 中断配置与启动配置好定时器后需要使能相关中断并启动捕获。// 在main初始化部分调用 void Capture_TIM_Start(void) { // 使能定时器更新中断用于处理溢出和捕获/比较1中断 HAL_TIM_Base_Start_IT(htim3); HAL_TIM_IC_Start_IT(htim3, TIM_CHANNEL_1); // 设置中断优先级根据你的系统调整 HAL_NVIC_SetPriority(TIM3_IRQn, 1, 0); HAL_NVIC_EnableIRQ(TIM3_IRQn); }提示HAL_TIM_IC_Start_IT这个函数非常关键它同时做了三件事使能捕获通道、使能捕获中断、使能定时器计数器。顺序错误可能导致无法进入中断。3. 核心逻辑实现一个健壮的双参数测量模块现在进入最核心的部分中断服务程序与状态管理。我们的目标是同时、连续地测量频率和占空比并且能处理各种边沿情况。3.1 设计状态机与数据结构我们需要一个结构体来保存测量过程中的所有状态和数据并设计一个清晰的状态机来管理边沿捕获流程。typedef struct { volatile uint8_t is_first_captured; // 是否是第一个边沿捕获 volatile uint8_t edge_to_capture; // 下一个要捕获的边沿 (0:上升沿1:下降沿) volatile uint32_t rise_timestamp; // 上升沿时间戳计数值 溢出 volatile uint32_t fall_timestamp; // 下降沿时间戳 volatile uint32_t last_period_ticks; // 最近测量的周期计数值 volatile float last_frequency_hz; // 计算得到的频率 volatile float last_duty_cycle; // 计算得到的占空比 volatile uint32_t overflow_count; // 溢出计数器 } PWM_Capture_Handle_t; PWM_Capture_Handle_t pwm_cap;状态机流程可以描述为初始状态等待第一个上升沿。捕获到第一个上升沿记录时间戳rise1并将下一个捕获边沿设置为下降沿。捕获到下降沿记录时间戳fall计算高电平时间并将下一个捕获边沿设置为上升沿。捕获到第二个上升沿记录时间戳rise2计算周期。用rise1和fall计算占空比。然后rise2成为新的rise1重复步骤2。3.2 完整的中断回调函数实现结合溢出处理以下是完整的回调函数示例。我们假设定时器时钟为1MHz1us/计数ARR为65535。// 定时器溢出中断回调 void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3) { pwm_cap.overflow_count; // 溢出次数加1 } } // 输入捕获中断回调 void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM3 htim-Channel HAL_TIM_ACTIVE_CHANNEL_1) { uint32_t current_ticks HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); uint32_t total_ticks pwm_cap.overflow_count * 65536 current_ticks; // 考虑溢出的总计数 if (pwm_cap.edge_to_capture 0) { // 当前捕获的是上升沿 if (pwm_cap.is_first_captured 0) { // 这是第一个上升沿只记录时间戳不计算 pwm_cap.rise_timestamp total_ticks; pwm_cap.is_first_captured 1; } else { // 这是第二个上升沿可以计算周期和频率 uint32_t period total_ticks - pwm_cap.rise_timestamp; pwm_cap.last_period_ticks period; pwm_cap.last_frequency_hz 1000000.0f / period; // 1MHz时钟period单位为us // 为下一个周期做准备用当前上升沿作为新的起点 pwm_cap.rise_timestamp total_ticks; } // 设置下一次捕获下降沿 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_FALLING); pwm_cap.edge_to_capture 1; } else { // 当前捕获的是下降沿 pwm_cap.fall_timestamp total_ticks; // 计算占空比高电平时间 / 周期 if (pwm_cap.last_period_ticks 0) { // 确保已有有效的周期值 uint32_t high_time pwm_cap.fall_timestamp - pwm_cap.rise_timestamp; pwm_cap.last_duty_cycle (high_time * 100.0f) / pwm_cap.last_period_ticks; } // 设置下一次捕获上升沿 __HAL_TIM_SET_CAPTUREPOLARITY(htim, TIM_CHANNEL_1, TIM_INPUTCHANNELPOLARITY_RISING); pwm_cap.edge_to_capture 0; } // 重置溢出计数器因为时间戳计算已经包含了之前的溢出 // 注意这里重置的是为“当前边沿到下一个边沿”这个区间准备的溢出计数 pwm_cap.overflow_count 0; __HAL_TIM_SET_COUNTER(htim, 0); // 可选清零计数器简化计算但要注意时序 } }注意在中断回调中调用__HAL_TIM_SET_COUNTER清零计数器是一个常见技巧它可以简化时间差计算直接使用CCR值即可。但前提是信号的频率不能太高要确保在两次边沿中断之间程序有足够时间执行完中断服务程序并清零计数器否则可能丢失边沿。对于高频信号建议保留计数器自由运行使用前面提到的带溢出补偿的差值计算法。3.3 主循环中的数据读取与应用中断负责高效地采集和计算主循环则负责安全地读取结果并进行后续处理如显示、控制等。// 在主循环中 while (1) { // 为了安全地读取在中断中被修改的变量可以临时关闭中断 uint32_t primask __get_PRIMASK(); __disable_irq(); float current_freq pwm_cap.last_frequency_hz; float current_duty pwm_cap.last_duty_cycle; __set_PRIMASK(primask); // 恢复中断状态 // 现在可以安全地使用 current_freq 和 current_duty if (current_freq 0) { // 有有效数据 printf(Frequency: %.2f Hz, Duty Cycle: %.1f%%\r\n, current_freq, current_duty); // 这里可以添加你的控制逻辑例如根据占空比调整输出 } HAL_Delay(100); // 适当延时避免打印刷屏 }4. 精度提升与实战调试技巧代码能跑起来只是第一步要获得稳定、精确的测量结果还需要关注以下细节。这些往往是项目成败的关键。4.1 应对高频与低频信号的策略不同的信号频率对测量方案提出了不同挑战。高频信号10kHz挑战中断过于频繁消耗大量CPU资源甚至可能处理不过来。优化提高定时器时钟减少预分频提高计数频率这样每个周期对应的计数值更大相对误差更小。使用定时器的从模式如复位模式或门控模式。将输入信号直接作为定时器的时钟或复位源可以硬件直接测量频率极大减轻CPU负担。但这通常需要占用两个通道如PWM输入模式且配置更复杂。降低测量更新率不必每个周期都计算并输出可以积累多个周期再平均减少主循环处理压力。低频信号10Hz挑战计数器溢出次数非常多overflow_count变量可能溢出如果它是32位在1MHz时钟下约每71.5分钟溢出一次对于超低频信号仍需注意。优化增大定时器周期将ARR设置为最大值如16位定时器的65535这是基础。使用32位溢出计数器确保overflow_count为uint32_t。降低定时器时钟增大预分频牺牲时间分辨率来换取更长的溢出周期。例如将时钟降到10kHz则溢出周期可达6.55秒。4.2 滤波与去抖让信号更干净实际物理世界的信号往往伴有噪声和抖动可能导致误触发。硬件滤波在信号进入MCU引脚前使用简单的RC低通滤波电路滤除高频毛刺。定时器输入滤波器STM32的定时器内置了数字滤波器这是最有效的软件去抖手段。原理滤波器基于一个采样时钟通常是定时器时钟对输入信号进行多次采样只有当连续N次采样值一致时才认为输入有效。配置通过TIM_IC_InitTypeDef中的ICFilter字段设置0x0 到 0xF。值越大滤波窗口时间越长抗干扰能力越强但对信号边沿的延迟也越大。sConfigIC.ICFilter 6; // 例如设置一个中等强度的滤波选择合适的滤波系数需要在抗干扰能力和信号响应速度之间做权衡。对于缓慢变化的信号或噪声严重的环境可以设置较大的值对于高速脉冲信号则要谨慎使用以免错过边沿。4.3 常见问题排查清单当测量结果不对时可以按照以下清单逐一排查根本没有进入捕获中断检查GPIO引脚配置是否正确应为复用功能模式GPIO_MODE_AF_INPUT。检查定时器和对应通道的时钟是否使能。确认HAL_TIM_IC_Start_IT()被正确调用。检查中断优先级配置和NVIC是否使能。使用示波器或逻辑分析仪确认外部信号是否确实到达了引脚以及边沿是否符合预期。测量值跳动很大检查信号质量用示波器看信号是否有过冲、振铃或毛刺。考虑增加硬件或软件滤波。检查中断冲突是否有更高优先级的中断长时间关闭全局中断导致丢失边沿优化中断服务程序使其尽可能短小精悍。检查变量类型和计算确保用于存储时间戳和溢出计数的变量类型足够大uint32_t计算时间差时考虑到了无符号整数的回绕问题。占空比测量正常但频率不对或反之这通常是状态机逻辑错误。仔细检查边沿切换逻辑edge_to_capture和不同边沿下的时间戳记录、计算逻辑。在关键点添加调试输出如通过串口打印每次捕获的时间戳和状态是理清逻辑的最有效方法。高频时测量值严重偏小或归零极有可能是中断服务程序执行时间过长错过了后续的边沿。优化代码将非紧急操作如浮点计算、复杂判断移到主循环。考虑使用DMA进行捕获如果定时器支持这是处理极高频率信号的终极方案。通过以上步骤你应该能够构建一个稳定可靠的PWM测量模块。最后记住嵌入式开发是软硬件结合的 art当软件逻辑查不出问题时不妨拿起示波器看看硬件信号的真实模样往往会有意想不到的发现。