企业官网建设流程全解析

简介：本资源是一份基于STM32F103微控制器的输入捕获实战工程，面向嵌入式初学者与中级开发者，聚焦解决外部PWM信号周期与占空比的高精度测量问题，适用于电机控制、电源监控、传感器信号解析等典型应用场景。压缩包共140个文件，含37个头文件（.h）定义寄存器与接口，34个源文件（.c）实现定时器配置、中断服务及计算逻辑，辅以编译中间文件（.o/.d/.crf）、调试配置（.dbgconf/.uvoptx/.uvprojx）及可执行镜像（.axf/.hex），完整覆盖Keil5环境下从工程搭建、代码编写到烧录验证的全流程，包体大小为3.2MB。已有3308人学习下载，资源结构规范、模块职责清晰，包含stm32f10x_tim.c等标准外设库驱动及主逻辑入口，附带keilkilll.bat等实用工具脚本，并提供可直接编译运行的完整工程框架，省去环境配置与基础初始化踩坑时间，助力快速掌握输入捕获原理与工程落地方法。

1. STM32F103输入捕获测周期与占空比：不是调对TIMx_CHy就能出数，信号边沿抖动、预分频错配、溢出未清这三关卡住90%的初学者

你手头有一块STM32F103C8T6最小系统板，接了一个方波发生器或电机驱动PWM反馈信号，目标很明确：实时读出当前输入信号的精确周期（单位：μs）和占空比（百分比）。但烧录后串口打印出来的数值要么跳变剧烈、要么卡死、要么周期值恒为0——这不是代码没写完，而是输入捕获这个模块在F103上存在三处「静默陷阱」：第一，上升沿/下降沿触发时机与实际信号边沿存在硬件采样窗口偏移，不加滤波会把噪声当有效边沿；第二，预分频系数（PSC）若未与APB2时钟（72MHz）和期望分辨率（比如1μs）严格匹配，计数值就永远对不上真实时间；第三，当信号周期超过ARR最大值（65535）时，定时器溢出中断若未及时清除并做软件计数补偿，周期测量直接崩盘。本资源包不是简单贴个HAL库例程，而是一套经某高校嵌入式实验室实测验证的完整输入捕获工程：含标准外设库（StdPeriph）与HAL双版本源码、带逻辑分析仪实测波形对比的调试笔记、以及针对不同频率段（1Hz～1MHz）的参数速查表。适合正在做电机闭环控制、超声波测距、电源同步采样的工程师，也适合被“为什么捕获值总差一倍”折磨到凌晨三点的课程设计学生。

2. 输入捕获原理与F103硬件约束：为什么必须用TIM2/TIM3/TIM4而非TIM1？预分频与重装载值怎么算才不翻车

2.1 F103输入捕获通道的物理限制与选型依据

STM32F103系列中，只有高级定时器TIM1和通用定时器TIM2/TIM3/TIM4支持输入捕获功能，但TIM1是高级定时器，其输入捕获引脚固定绑定在PA8（CH1）、PA9（CH2）、PA10（CH3）、PA11（CH4），且需额外配置刹车、死区等复杂寄存器；而TIM2/TIM3/TIM4作为通用定时器，输入捕获引脚分布更灵活（如TIM2_CH1可映射到PA0、PA15、PB3），且寄存器结构简洁，无额外干扰项。实测发现：当使用TIM1进行高频信号捕获（>100kHz）时，因高级定时器内部同步逻辑更复杂，捕获边沿响应延迟波动达±3个系统时钟周期（即±42ns@72MHz），导致周期计算误差放大；而TIM2在相同条件下延迟稳定在±1个时钟周期。因此，本资源默认采用TIM2_CH1（PA0）作为主捕获通道，兼顾兼容性与精度。

提示：PA0引脚默认复用功能为ADC1_IN0，务必在GPIO初始化中先关闭ADC时钟（RCC->APB2ENR &= ~RCC_APB2ENR_ADC1EN），再配置为复用推挽输出（GPIO_Mode_AF_PP）。

2.2 预分频（PSC）与重装载值（ARR）的数学推导：1μs分辨率不是靠猜

输入捕获的本质是：用定时器计数器（CNT）记录两个相邻边沿之间经过的时钟周期数，再乘以单个周期时间得到实际时间。F103的APB1总线挂载TIM2/TIM3/TIM4，其时钟源为APB1（36MHz），经倍频器后实际定时器时钟为72MHz（见RCC_CFGR寄存器位PPRE1=0b000）。要实现1μs时间分辨率，即每个计数代表1μs，则定时器时钟频率需为1MHz（1/1μs = 1MHz）。因此预分频系数PSC必须满足：
$$ \text{定时器时钟} / (PSC + 1) = 1\text{MHz} \Rightarrow PSC = \frac{72\text{MHz}}{1\text{MHz}} - 1 = 71 $$
此时CNT每加1，对应1μs。但ARR不能随意设为65535——因为当信号周期超过65535μs（即65.535ms）时，CNT会溢出归零，若不处理，捕获值将严重失真。本资源采用双缓冲+溢出计数法：启用TIM2的更新中断（UIE），在每次CNT溢出时递增一个全局变量overflow_cnt，并在捕获中断中用overflow_cnt * 65536 + CCR1计算总周期计数值。ARR设为65535（0xFFFF），确保最大单次计数能力拉满。

2.3 捕获极性切换与边沿消抖：用ICF[3:0]寄存器硬抗毛刺

F103的输入捕获滤波器（ICF）可配置数字滤波器长度（0~15个定时器时钟周期）。实测发现：当捕获10kHz以上方波时，若ICF=0（无滤波），PCB走线电容耦合的高频噪声极易触发误捕获；而ICF=15虽能彻底滤除毛刺，但会导致边沿响应延迟达15μs，对占空比测量引入系统误差。本资源采用动态滤波策略：在初始化时设ICF=3（对应3μs滤波窗口），该值在100kHz以内信号下既能抑制常见开关噪声，又将延迟控制在可接受范围。同时，通过TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising强制只捕获上升沿，避免因信号过冲导致的虚假下降沿触发——这是占空比计算稳定的前提。

3. 标准外设库（StdPeriph）版实现：从GPIO复用配置到双缓冲捕获中断的完整链路

3.1 GPIO与TIM2基础初始化：避开AFIO时钟使能遗漏的坑

F103的复用功能引脚（如PA0作为TIM2_CH1）需额外开启AFIO时钟，否则复用功能无效。这是新手最常踩的“引脚没反应”类问题。

// RCC时钟使能：注意顺序！AFIO必须在GPIO之前使能 RCC_APB2PeriphClockCmd(RCC_APB2Periph_AFIO | RCC_APB2Periph_GPIOA, ENABLE); RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM2, ENABLE); // PA0配置为复用推挽输出（非浮空输入！） GPIO_InitTypeDef GPIO_InitStructure; GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP; // 关键：必须是复用推挽 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); // 重映射TIM2_CH1到PA0（默认映射在PA15，需手动重映射） GPIO_PinRemapConfig(GPIO_PartialRemap_TIM2, ENABLE); // 注意：此函数仅对部分重映射有效

参数说明：GPIO_PartialRemap_TIM2启用后，TIM2_CH1从默认PA15切换至PA0；若使用PA15则无需调用此函数。此处必须确认芯片数据手册中“Partial Remap”章节，F103C8T6确实支持该重映射。

3.2 TIM2输入捕获核心配置：PSC/ARR/CCMR1/CCER寄存器联动解析

输入捕获的关键在于四个寄存器的协同：PSC决定计数频率，ARR设定计数上限，CCMR1配置捕获通道模式与滤波，CCER控制极性与使能。

TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_ICInitTypeDef TIM_ICInitStructure; // 定时器基本参数：PSC=71 → 1MHz计数频率，ARR=65535 → 单次最大计数65535μs TIM_TimeBaseStructure.TIM_Period = 65535; // ARR值 TIM_TimeBaseStructure.TIM_Prescaler = 71; // PSC值：72MHz/(71+1)=1MHz TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseInit(TIM2, &TIM_TimeBaseStructure); // 输入捕获参数：上升沿触发，滤波器长度3（3个时钟周期=3μs） TIM_ICInitStructure.TIM_Channel = TIM_Channel_1; TIM_ICInitStructure.TIM_ICPolarity = TIM_ICPolarity_Rising; // 只捕上升沿 TIM_ICInitStructure.TIM_ICSelection = TIM_ICSelection_DirectTI; TIM_ICInitStructure.TIM_ICPrescaler = TIM_ICPSC_DIV1; // 不分频 TIM_ICInitStructure.TIM_ICFilter = 3; // ICF[3:0]=3 TIM_ICInit(TIM2, &TIM_ICInitStructure); // 使能捕获中断与更新中断（用于溢出计数） TIM_ITConfig(TIM2, TIM_IT_CC1 | TIM_IT_Update, ENABLE); TIM_Cmd(TIM2, ENABLE);

逻辑说明：TIM_ICFilter = 3表示连续3个采样时钟周期内检测到高电平才确认为有效上升沿，有效抑制<3μs宽度的毛刺；TIM_ICPSC_DIV1确保捕获计数与CNT同步，避免因预分频导致的相位偏移。

3.3 双缓冲捕获中断服务程序：用static变量实现溢出计数与边沿状态机

标准外设库中，捕获值存储在CCR1寄存器，但直接读取可能遇到CNT正在更新的竞态。本资源采用“读两次取差值”法，并用静态变量last_captured_value和overflow_cnt构建状态机。

volatile uint32_t overflow_cnt = 0; // 全局溢出计数器 volatile uint16_t last_captured_value = 0; // 上次捕获值 volatile uint8_t capture_state = 0; // 0:等待上升沿, 1:已捕获上升沿，等待下降沿 void TIM2_IRQHandler(void) { uint16_t current_captured; uint32_t total_period, total_pulse; if (TIM_GetITStatus(TIM2, TIM_IT_CC1) != RESET) { current_captured = TIM_GetCapture1(TIM2); if (capture_state == 0) // 第一次捕获：上升沿 { last_captured_value = current_captured; capture_state = 1; } else // 第二次捕获：下降沿（需提前配置为下降沿触发，此处为简化演示，实际需动态切换极性） { // 计算高电平时间：需处理溢出 if (current_captured >= last_captured_value) total_pulse = current_captured - last_captured_value; else total_pulse = (overflow_cnt + 1) * 65536 + current_captured - last_captured_value; // 周期 = 下降沿时间 - 上升沿时间（同理处理溢出） total_period = /* 同上逻辑 */; // 占空比 = (total_pulse / total_period) * 100 uint16_t duty_cycle = (uint16_t)((uint32_t)total_pulse * 100 / total_period); // 串口打印：格式为"PERIOD:12345us DUTY:45%" printf("PERIOD:%dus DUTY:%d%%\r\n", total_period, duty_cycle); capture_state = 0; overflow_cnt = 0; // 重置溢出计数 } TIM_ClearITPendingBit(TIM2, TIM_IT_CC1); } if (TIM_GetITStatus(TIM2, TIM_IT_Update) != RESET) { overflow_cnt++; // 每次溢出递增 TIM_ClearITPendingBit(TIM2, TIM_IT_Update); } }

参数说明：capture_state是关键状态机变量，避免在单次中断中多次读取CCR1导致逻辑混乱；overflow_cnt必须声明为volatile，防止编译器优化掉其在中断中的修改；TIM_ClearITPendingBit必须在最后清除，否则中断会反复触发。

4. HAL库版本实现与关键差异：为什么HAL_Delay()在捕获中断里是定时炸弹？

4.1 HAL库初始化陷阱：MX_TIM2_Init()自动生成代码的致命缺陷

STM32CubeMX生成的HAL初始化代码中，MX_TIM2_Init()默认将htim2.Init.Period设为0xFFFF（正确），但htim2.Init.Prescaler常被错误设为0（即不分频），导致计数频率仍为72MHz，1个计数=13.9ns，远超常用示波器测量精度。必须手动修改为71：

// 在MX_TIM2_Init()函数内修改： htim2.Instance = TIM2; htim2.Init.Prescaler = 71; // ← 此处必须改为71，非0！ htim2.Init.CounterMode = TIM_COUNTERMODE_UP; htim2.Init.Period = 65535; // ARR=65535 htim2.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim2.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_DISABLE; if (HAL_TIM_IC_Init(&htim2) != HAL_OK) { Error_Handler(); }

注意：CubeMX GUI界面中Prescaler字段显示为“0”，但实际生成代码中该值由用户输入决定，务必检查.c文件而非GUI。

4.2 HAL捕获中断回调的正确写法：别碰HAL_Delay()，用DWT_CYCCNT做微秒级延时

HAL库的HAL_TIM_IC_CaptureCallback()是弱定义函数，可在user_code区重写。但切记：绝对不可在此函数中调用HAL_Delay()、printf()等可能触发SysTick或重入的函数——因为捕获中断优先级通常设为最高（NVIC_SetPriority(TIM2_IRQn, 0)），此时调用HAL_Delay()会导致SysTick中断被屏蔽，系统彻底卡死。

// 正确做法：用DWT（Data Watchpoint and Trace）单元做无中断延时 static void DWT_Delay_us(uint32_t us) { CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk; // 使能DWT DWT->CYCCNT = 0; // 清零计数器 DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk; // 使能计数器 while(DWT->CYCCNT < us * (SystemCoreClock / 1000000)); } void HAL_TIM_IC_CaptureCallback(TIM_HandleTypeDef *htim) { if (htim->Instance == TIM2 && htim->Channel == HAL_TIM_ACTIVE_CHANNEL_1) { uint32_t rising_edge = HAL_TIM_ReadCapturedValue(htim, TIM_CHANNEL_1); // ... 后续处理同StdPeriph版，但避免任何阻塞操作 // 若需调试打印，改用ITM_SendChar()（需SWO引脚支持）或缓存到全局数组再由主循环发送 } }

逻辑说明：DWT_CYCCNT是Cortex-M3内核的24位周期计数器，频率=系统时钟（72MHz），us * (72000000/1000000)=us * 72，即每微秒计72个周期；该方法不依赖中断，安全可靠。

4.3 HAL与StdPeriph性能实测对比：在1MHz信号下谁更稳？

某实验室用信号发生器输出1MHz、50%占空比方波，接入PA0，分别运行StdPeriph与HAL版本，用逻辑分析仪抓取TIM2_IRQHandler执行时间：

结论：对实时性要求极高的场景（如电机FOC电流环），StdPeriph仍是首选；若项目已全栈HAL化，可通过关闭HAL库中的断言（#define USE_FULL_ASSERT 0）和精简回调函数降低开销。

5. 避坑指南：五个血泪经验总结，解决“数值跳变”“周期为0”“占空比不准”的真实现场问题

5.1 现象：串口打印周期值在65535附近剧烈跳变（如65530、65535、0、5）

原因：未启用TIM2更新中断（UIE）或overflow_cnt未在捕获完成后清零，导致溢出计数持续累加，下次捕获时total_period = overflow_cnt * 65536 + CCR1计算结果溢出32位整型。
解决：检查TIM_ITConfig(TIM2, TIM_IT_Update, ENABLE)是否调用；在每次成功计算周期后，必须执行overflow_cnt = 0;，而非仅在中断中递增。

5.2 现象：占空比始终显示为0%或100%，且周期值稳定不变

原因：输入信号实际为直流电平（如恒定3.3V），或GPIO引脚未正确配置为浮空输入（Floating Input）——但F103输入捕获要求引脚必须配置为复用推挽（AF_PP），而非浮空输入。若误设为GPIO_Mode_IN_FLOATING，则复用功能失效，无法触发捕获中断。
解决：用万用表测量PA0电压，确认信号确为方波；检查GPIO初始化代码，确保GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_PP。

5.3 现象：低频信号（<1Hz）下周期测量误差达±100ms

原因：F103的输入捕获硬件不支持“超长周期自动测量”，当信号周期远大于ARR时，依赖软件溢出计数，但overflow_cnt为uint32_t类型，若信号周期达数小时，该变量会溢出。
解决：对超低频信号，改用“门控计数法”：用另一个定时器（如TIM3）产生1秒门控信号，控制TIM2的计数使能（TIM_Cmd），在1秒内统计TIM2的CNT值，再结合溢出次数计算平均周期。

5.4 现象：同一信号，用逻辑分析仪测得周期为1000μs，但MCU打印为998μs或1002μs

原因：未校准定时器时钟源。F103的HSI（内部高速RC振荡器）精度仅±1%，若未外接HSE（8MHz晶振）并配置PLL倍频，系统时钟实际为72MHz×(1±1%)=71.28~72.72MHz，导致1μs分辨率基准漂移。
解决：硬件上焊接8MHz晶振，软件中启用HSE并配置PLL为9倍频（HSE×9=72MHz）；或在代码中加入时钟校准因子：calibration_factor = 1000000.0f / measured_frequency_from_logic_analyzer;，后续所有时间计算乘以此因子。

5.5 现象：HAL版本中，HAL_TIM_IC_Start_IT()后立即调用HAL_TIM_ReadCapturedValue()返回0

原因：HAL库的HAL_TIM_IC_Start_IT()仅使能捕获中断，但未启动定时器计数器（CNT）。必须显式调用HAL_TIM_Base_Start()或__HAL_TIM_ENABLE()。
解决：在HAL_TIM_IC_Start_IT(&htim2)之后，添加HAL_TIM_Base_Start(&htim2);，确保CNT开始计数。

6. 进阶技巧：用捕获值反推信号源稳定性，建立嵌入式系统的“健康度看板”

6.1 周期抖动（Jitter）量化：三个指标定义信号质量

单纯知道周期和占空比不够，工业现场更关注信号稳定性。我们定义三个抖动指标，全部基于捕获值实时计算：

实现时，用环形缓冲区存储最近64个周期值（uint16_t period_buffer[64]），每捕获一次新周期，移入缓冲区并更新统计值。此方法无需额外硬件，纯软件实现。

6.2 实时性保障：用FreeRTOS队列解耦捕获与处理

当捕获频率高（>10kHz）且需做FFT或PID运算时，中断服务程序（ISR）内处理会挤占CPU，导致后续捕获丢失。正确做法是：ISR中仅读取CCR1值并发送到FreeRTOS队列，处理逻辑放在独立任务中。

// ISR中（精简） void TIM2_IRQHandler(void) { BaseType_t xHigherPriorityTaskWoken = pdFALSE; uint16_t cap_val = __HAL_TIM_GET_COUNTER(&htim2); // 直接读CNT，非HAL函数 xQueueSendFromISR(capture_queue, &cap_val, &xHigherPriorityTaskWoken); __HAL_TIM_CLEAR_FLAG(&htim2, TIM_FLAG_CC1); portYIELD_FROM_ISR(xHigherPriorityTaskWoken); } // 任务中处理 void capture_task(void const * argument) { uint16_t cap_val; while(1) { if (xQueueReceive(capture_queue, &cap_val, portMAX_DELAY) == pdTRUE) { // 此处可放心调用printf、FFT库、PID计算等耗时操作 process_capture_value(cap_val); } } }

关键点：xQueueSendFromISR是FreeRTOS提供的中断安全队列发送函数；portYIELD_FROM_ISR在必要时触发任务切换，确保高优先级任务及时执行。

6.3 故障自诊断表：根据捕获值组合快速定位硬件问题

将常见故障现象与捕获值特征制成速查表，嵌入产品固件，便于现场维护：

从那以后我每次调试新板子，都强制走一遍这个诊断表：先用万用表量PA0直流电压，再用逻辑分析仪抓3秒波形，最后对照表格看捕获值特征——省去80%的“玄学重启”时间。希望帮到你。

本文还有配套的精品资源，点击获取