企业官网建设流程全解析

1. 项目缘起：为什么需要深入理解STM32的输入捕获？

在嵌入式开发里，尤其是基于STM32这类MCU的项目，时间测量是个绕不开的活儿。你可能需要精确测量一个脉冲的宽度，比如超声波测距的回波时间；或者需要计算一个方波的频率，比如电机编码器的输出；又或者需要捕捉一个外部事件的精确发生时刻。这些场景，都指向了STM32定时器的一个核心功能：输入捕获。

我见过不少开发者，尤其是刚接触STM32的朋友，一上来就直奔HAL库，调用几个现成的函数，能跑通就万事大吉。但一旦遇到测量不准、数据跳变、或者在高频下工作异常的情况，就有点抓瞎了。LL库（Low-Layer，底层库）相比HAL库，提供了更接近寄存器级别的操作，虽然代码量稍多，但控制更精细，对定时器工作原理的理解也要求更高。用LL库搞懂输入捕获，就像是直接看懂了发动机的构造，以后无论是调优还是排错，心里都有底。

所以，这篇内容我们不谈空泛的概念，就基于STM32的LL库，把输入捕获从原理到配置，再到实际应用中那些容易踩的坑，掰开揉碎了讲清楚。目标是让你看完之后，不仅能配置出一个可用的输入捕获通道，更能明白每一个配置项背后的意义，以及当数据出现异常时，该从哪里入手排查。

2. 输入捕获的核心原理与工作流程拆解

在深入代码之前，我们必须先搞清楚定时器的输入捕获到底是怎么一回事。你可以把它想象成一个非常专业的“秒表员”。

这个秒表员（输入捕获单元）的主要装备有两样：一个正在匀速走字的电子表（定时器的计数器CNT），和一个反应极快的快门按钮（输入捕获引脚上的特定边沿信号）。他的工作流程是这样的：

1. 待命：秒表员时刻盯着那个快门按钮（输入引脚）。
2. 触发：当按钮被按下（即检测到预设的边沿，比如上升沿）的瞬间，他的反应极快，会立刻做两件事：
   • 第一，咔嚓一下，把当前电子表上显示的时间（CNT的当前值）拍一张照片，存进自己的小本本（捕获/比较寄存器CCRx）里。
   • 第二，举手示意：“报告，我抓到了一次边沿！”（产生一个捕获事件，可以触发中断或DMA）。
3. 记录与计算：我们作为管理者，只需要定期去查看他小本本上记录的时间值。如果我们要测脉冲宽度，就让他分别在上升沿和下降沿各拍一张照片，两次的时间差，就是脉冲的高电平时间。

这里有几个关键点，直接关系到测量的精度和稳定性：

• 计数器时钟源：电子表走得快还是慢，决定了时间测量的分辨率。这个速度来源于定时器的时钟源，通常是经过预分频器（PSC）分频后的系统时钟。例如，系统时钟72MHz，PSC设为71，则计数器每递增1，代表的时间是 (71+1)/72MHz = 1us。这就是你的时间基准。
• 边沿检测与滤波：按钮不能太敏感，稍有风吹草动就误触发。输入捕获通道通常配有数字滤波器，可以设置需要连续多少个采样点都确认是有效边沿，才认为是一次真正的触发。这对于消除信号上的毛刺噪声至关重要。
• 捕获寄存器CCRx：这是核心存储单元。当捕获事件发生时，CNT的值会由硬件自动、原子性地加载到CCRx中，这个过程不需要CPU干预，保证了时间的精确性。
• 溢出处理：电子表（16位计数器）的显示范围是0-65535。如果要测的时间很长，计数器可能会走完一圈从头开始（溢出）。我们的“秒表员”很敬业，他会默默记下溢出次数。所以，最终的时间计算应该是：最终时间 = 溢出次数 * 计数器周期 + 本次捕获的CCRx值 - 上次捕获的CCRx值。在LL库中，我们需要在溢出中断里手动维护这个溢出计数。

理解了这个“秒表员”模型，再看LL库的配置函数，你就会发现它们都是在给这个秒表员设定工作规则：用哪块表（选择定时器）、看哪个按钮（选择输入通道和GPIO）、按下去的时候是拍上升沿还是下降沿（边沿选择）、按钮防误触等级多高（滤波器设置）、拍完照要不要大声报告（中断/DMA使能）。

3. 基于LL库的输入捕获通道完整配置指南

理论懂了，我们动手配置。假设我们使用STM32F1系列，TIM2的通道1（对应PA0引脚）来测量一个外部脉冲的高电平宽度。我们将一步步拆解，并解释每个步骤的“为什么”。

3.1 外设时钟与GPIO初始化

任何外设使用前，必须先给它的时钟“上电”。同时，要把对应的GPIO引脚配置为复用功能模式，让定时器内部模块来控制这个引脚。

// 1. 使能TIM2和GPIOA的时钟 LL_APB1_GRP1_EnableClock(LL_APB1_GRP1_PERIPH_TIM2); LL_APB2_GRP1_EnableClock(LL_APB2_GRP1_PERIPH_GPIOA); // 2. 配置PA0为复用推挽输出模式（对于输入捕获，通常是复用浮空输入，但F1系列手册建议配置为复用推挽/开漏以使用内部上下拉） LL_GPIO_SetPinMode(GPIOA, LL_GPIO_PIN_0, LL_GPIO_MODE_ALTERNATE); LL_GPIO_SetPinOutputType(GPIOA, LL_GPIO_PIN_0, LL_GPIO_OUTPUT_PUSHPULL); // 推挽 LL_GPIO_SetPinSpeed(GPIOA, LL_GPIO_PIN_0, LL_GPIO_SPEED_FREQ_HIGH); // 注意：虽然引脚被定时器用作输入，但GPIO模式设为复用功能后，方向控制权交给了外设。这里配置输出类型和速度通常影响不大，但按手册推荐配置。

注意：不同STM32系列GPIO配置略有差异。例如，在F4/H7系列，对于定时器输入通道，通常直接配置为LL_GPIO_MODE_ALTERNATE即可，驱动速度和上下拉根据实际需要设置。务必查阅对应型号的参考手册中“GPIO章节”和“定时器复用功能映射”表格。

3.2 时基单元配置：设定“电子表”的走字规则

这是定义时间基准的步骤，主要设置预分频器（PSC）和自动重装载值（ARR）。

// 3. 配置时基单元 LL_TIM_SetPrescaler(TIM2, 71); // 假设系统时钟72MHz，72/(71+1)=1，计数器时钟为1MHz，即1个计数=1us LL_TIM_SetAutoReload(TIM2, 65535); // 设置ARR为最大值，让计数器在自由运行模式下工作到溢出 LL_TIM_SetCounterMode(TIM2, LL_TIM_COUNTERMODE_UP); // 向上计数模式 // 4. 初始化时基单元（此函数会更新影子寄存器并生成更新事件） LL_TIM_InitTypeDef TIM_InitStruct = {0}; TIM_InitStruct.Prescaler = 71; TIM_InitStruct.CounterMode = LL_TIM_COUNTERMODE_UP; TIM_InitStruct.Autoreload = 65535; TIM_InitStruct.ClockDivision = LL_TIM_CLOCKDIVISION_DIV1; // 与数字滤波器无关，保持DIV1 TIM_InitStruct.RepetitionCounter = 0; // 高级定时器才有，通用定时器忽略 LL_TIM_Init(TIM2, &TIM_InitStruct);

为什么这样配置？

• PSC=71：为了获得1us的计时分辨率，便于计算。这是权衡了测量精度和测量范围后的常见选择。分辨率越高（计数时钟越快），精度越高，但计数器溢出越快。
• ARR=65535：对于输入捕获测量脉冲宽度，我们通常希望计数器自由运行，以覆盖更长的测量时间。ARR设为最大值，意味着计数器从0计数到65535后溢出归零，循环往复。
• ClockDivision：这个参数容易被误解。它控制的是死区时间和数字滤波器的采样时钟来源，与计数器时钟频率无关。通常设为DIV1即可。

3.3 输入捕获通道配置：设定“秒表员”的工作规则

这是最核心的配置部分，告诉定时器哪个通道作为输入，如何响应边沿。

// 5. 配置输入捕获通道1 LL_TIM_IC_SetActiveInput(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_ACTIVEINPUT_DIRECTTI); // 通道映射到TI1输入 LL_TIM_IC_SetPolarity(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_IC_POLARITY_RISING); // 先配置为上升沿捕获 LL_TIM_IC_SetPrescaler(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_ICPSC_DIV1); // 捕获预分频器，每个事件都捕获 LL_TIM_IC_SetFilter(TIM2, LL_TIM_CHANNEL_CH1, LL_TIM_IC_FILTER_FDIV1_N8); // 设置滤波器，例如8个时钟周期滤波 // 6. 将输入捕获配置应用到通道 LL_TIM_IC_Init(TIM2, LL_TIM_CHANNEL_CH1, &TIM_IC_InitStruct); // 需要先填充TIM_IC_InitStruct结构体 // 结构体示例 LL_TIM_IC_InitTypeDef TIM_IC_InitStruct = {0}; TIM_IC_InitStruct.ICPolarity = LL_TIM_IC_POLARITY_RISING; TIM_IC_InitStruct.ICActiveInput = LL_TIM_ACTIVEINPUT_DIRECTTI; TIM_IC_InitStruct.ICPrescaler = LL_TIM_ICPSC_DIV1; TIM_IC_InitStruct.ICFilter = LL_TIM_IC_FILTER_FDIV1_N8; LL_TIM_IC_Init(TIM2, LL_TIM_CHANNEL_CH1, &TIM_IC_InitStruct);

关键参数解析：

• ICActiveInput：指定输入源。DIRECTTI表示通道直接连接到自己的TIx引脚（如CH1连TI1）。还有INDIRECTTI（交叉连接，如CH1连TI2）和TRC（内部触发）等选项。用于测量脉宽时，我们通常需要将同一个引脚（TI1）的信号，通过交叉连接，同时路由到两个捕获通道（CH1和CH2），分别捕获上升沿和下降沿。
• ICPolarity：边沿极性。RISING（上升沿）、FALLING（下降沿）、BOTHEDGE（双沿，部分型号支持）。
• ICPrescaler：捕获预分频。DIV1表示每次符合条件的事件都捕获；DIV2表示每2个事件捕获一次，以此类推。可用于测量频率时降低软件开销。
• ICFilter（重中之重）：数字滤波器。这是稳定测量的关键。值N8表示以f_DTS（由ClockDivision决定）为采样频率，连续8个采样点都是相同电平，才确认一次边沿。这能有效滤除高频毛刺。滤波时间 = N * f_DTS周期。需要根据信号噪声情况调整，太小可能抗噪差，太大可能滤掉有效的窄脉冲。

3.4 中断与DMA配置：设定“报告”机制

捕获事件发生后，我们需要知道。有两种方式：中断和DMA。

中断方式（适合低频信号或单个脉冲测量）：

// 7. 使能捕获比较通道1的中断，以及更新（溢出）中断 LL_TIM_EnableIT_CC1(TIM2); LL_TIM_EnableIT_UPDATE(TIM2); // 8. 在NVIC中配置TIM2中断优先级并使能 NVIC_SetPriority(TIM2_IRQn, 0); NVIC_EnableIRQ(TIM2_IRQn); // 9. 使能定时器计数器 LL_TIM_EnableCounter(TIM2); // 10. 在中断服务函数中处理 void TIM2_IRQHandler(void) { if (LL_TIM_IsActiveFlag_CC1(TIM2)) { // 捕获事件发生 g_capture_value = LL_TIM_IC_GetCaptureCH1(TIM2); // 读取捕获值 LL_TIM_ClearFlag_CC1(TIM2); // 清除标志位 // ... 进行时间计算 ... } if (LL_TIM_IsActiveFlag_UPDATE(TIM2)) { // 计数器溢出 g_overflow_count++; // 溢出计数器加1 LL_TIM_ClearFlag_UPDATE(TIM2); } }

DMA方式（适合高频连续测量，减少CPU中断开销）：DMA可以将捕获寄存器CCRx的值自动搬运到用户指定的内存数组中。配置相对复杂，需要设置DMA通道、内存地址、数据宽度、传输模式（循环模式很常用）等。其核心思想是，硬件捕获和传输数据，CPU只在数组快满时（通过DMA半传输/传输完成中断）批量处理数据，极大解放CPU。

3.5 双通道测量脉冲宽度的高级配置

要测量一个脉冲的宽度（高电平时间），最经典和准确的方法是使用定时器的“PWM输入模式”或手动配置双通道捕获。

方法一：PWM输入模式（硬件全自动）此模式是输入捕获的一个特例。它自动将同一个输入（TI1或TI2）路由到两个捕获通道（CH1和CH2），并自动配置其中一个为上升沿捕获，另一个为下降沿捕获，且两者同步。测量结果（周期和占空比）会自动计算好，分别放在CCR1和CCR2中。配置简单，但占用两个捕获通道。

// 选择TI1作为输入，并启用PWM输入模式 LL_TIM_SetSlaveMode(TIM2, LL_TIM_SLAVEMODE_RESET); // 从模式选择为复位模式 LL_TIM_SetTriggerInput(TIM2, LL_TIM_TS_TI1FP1); // 触发源为滤波后的TI1 LL_TIM_SetSlaveMode(TIM2, LL_TIM_SLAVEMODE_RESET); // 这一步会配置TI1为触发源并连接从模式控制器 // 注意：具体LL库函数可能因系列不同有差异，需结合手册和库文件。

方法二：手动双通道交叉连接（更灵活）将输入信号TI1同时映射到CH1和CH2。

• CH1配置为上升沿捕获，直接连接TI1 (DIRECTTI)。
• CH2配置为下降沿捕获，但输入源选择为INDIRECTTI，即交叉连接到TI1。 这样，上升沿和下降沿会分别触发CH1和CH2的捕获事件，并记录到各自的CCR1和CCR2寄存器中。脉冲宽度 =CCR2 - CCR1（考虑溢出）。这种方法更灵活，可以自定义两个通道的滤波参数。

4. 实战中的精度陷阱与常见问题排查

配置代码写完了，但往往这才是麻烦的开始。下面是我在实际项目中总结的几个典型问题和排查思路。

4.1 测量值跳动大，不稳定

这是最常见的问题。可能的原因和解决方向如下：

1. 信号质量问题：这是首要怀疑对象。用示波器查看输入引脚上的实际波形，是否有过冲、振铃、毛刺？信号边沿是否陡峭？如果信号来自外部传感器或长导线，很可能引入噪声。

   • 对策：在硬件上，可以在输入端增加RC低通滤波（如1kΩ电阻串联，100pF电容对地）。在软件上，增大输入捕获滤波器的参数（ICFilter）。例如从N2调到N6或N8。但要注意，这会增加有效边沿的检测延迟，可能滤掉过窄的合法脉冲。

2. GPIO配置不当：虽然作为输入，但GPIO配置为复用功能时，内部上下拉电阻的状态可能影响。如果外部信号是高阻态或驱动能力弱，内部上下拉会决定引脚电平。

   • 对策：根据外部电路情况，明确配置GPIO的内部上拉或下拉（LL_GPIO_SetPinPull）。例如，如果信号常态为低，上升沿有效，可以启用内部上拉，确保空闲时为高电平，避免干扰。

3. 中断响应延迟：如果使用中断方式，且在中断服务函数中做了复杂运算或发生了更高优先级中断的嵌套，可能导致读取CCRx寄存器不及时，虽然捕获事件是硬件瞬间完成的，但CPU读取时CNT可能已经走了好几个数。

   • 对策：优化中断服务函数，只做最必要的标志位清除和数值读取、存储。复杂的计算移到主循环或低优先级任务中。对于高频信号，强烈建议使用DMA方式，彻底消除中断延迟的影响。

4. 计数器时钟精度：定时器的时钟源是否稳定？如果使用内部RC振荡器（HSI），其精度（通常±1%）比外部晶振（HSE）差得多，会导致时间基准不准。

   • 对策：对时间精度要求高的应用，务必使用外部晶振作为系统时钟源，并正确配置PLL和定时器时钟树。

4.2 测量结果存在固定的系统误差

比如理论上应该是1000us的脉冲，测出来总是1001us或999us。

1. 时基配置计算错误：重新核算PSC和系统时钟。确认SystemCoreClock变量是否正确更新。使用LL_RCC_GetSysClkFreq()等函数动态获取时钟频率进行计算。
2. 滤波器引入的延迟：数字滤波器（ICFilter）在确认边沿时，需要连续采样，这会引入固定的延迟。这个延迟时间是N * T_dts。在要求绝对时间戳（而非时间间隔）的应用中，这个延迟需要补偿。
3. 软件开销未计入：从捕获事件发生到软件读取CCRx值之间，虽然很短，但若计数器时钟极快（如72MHz不分频），也可能差出几个计数。对于超高精度测量，需要考虑这段固定延迟。

4.3 长脉冲测量溢出处理逻辑错误

这是算法层面的核心坑。测量一个可能超过计数器单次计数周期（ARR+1）的脉冲，必须正确处理溢出。

错误逻辑示例：

// 假设只在上升沿和下降沿中断中简单做差 uint32_t pulse_width = fall_ccr - rise_ccr; // 如果期间发生溢出，此计算完全错误

正确逻辑（以中断方式为例）：

// 定义全局变量 volatile uint32_t g_overflow_count = 0; volatile uint32_t g_rise_capture = 0; volatile uint32_t g_fall_capture = 0; volatile uint8_t g_capture_flag = 0; // 0:等待上升沿， 1:已捕获上升沿 // 在更新（溢出）中断中 g_overflow_count++; // 在通道1（上升沿）中断中 if (!g_capture_flag) { g_rise_capture = LL_TIM_IC_GetCaptureCH1(TIM2); g_capture_flag = 1; // 可以切换该通道为下降沿捕获，以捕捉同一个脉冲的下降沿（单通道双沿模式，需硬件支持） // 或者，如果使用双通道，则此处只记录上升沿值 } // 在通道2（下降沿）中断中，或切换边沿后的通道1中断中 uint32_t temp_rise = g_rise_capture; uint32_t temp_fall = LL_TIM_IC_GetCaptureCH2(TIM2); // 假设是CH2捕获下降沿 uint32_t temp_overflow = g_overflow_count; // 注意：读取溢出计数前最好关中断，或确保32位读取原子性 // 计算时间差（考虑溢出） uint32_t period_ticks = (temp_overflow * (LL_TIM_GetAutoReload(TIM2) + 1)) + temp_fall - temp_rise; float pulse_width_us = period_ticks * (1.0 / your_timer_frequency_mhz); // 转换为微秒 // 重置状态，准备下一次测量 g_capture_flag = 0; // 注意：需要小心处理g_overflow_count在两次捕获期间的变化，确保计算一致性。

更稳健的做法：在进入捕获中断时，将当前的溢出计数和捕获值作为一个“时间戳”结构体一起保存下来。计算时间差时，对两个时间戳进行完整的减法运算，自动处理溢出回绕。这类似于操作系统中的tick计数处理。

5. 进阶话题：输入捕获的性能优化与特殊应用

当基础功能满足后，我们往往会追求更高性能或更特殊的应用。

5.1 使用DMA进行连续高速捕获

对于高频信号（比如几百kHz的编码器信号），每个边沿都进中断，CPU开销无法承受。DMA是救星。

配置要点：

• DMA模式：设置为循环模式（Circular），这样当DMA传输完指定数据量后，会自动回到起始地址重新开始，形成一个缓冲区，实现连续不间断采集。
• 触发源：DMA请求应配置为由定时器的“捕获/比较事件”（如TIMx_CH1）触发。每次捕获发生，硬件自动将CCR1的值通过DMA搬运到内存。
• 数据宽度：CCR寄存器是16位，所以DMA的数据宽度应设置为半字（Half Word）。
• 内存管理：需要开辟一个足够大的数组作为DMA目标。通常使用“双缓冲区”或“环形缓冲区”的思想。通过使能DMA的“半传输完成中断”和“传输完成中断”，可以在前半缓冲区满和后半缓冲区满时通知CPU处理数据，实现“乒乓操作”，几乎无丢失采集。
• 溢出处理：在DMA模式下，溢出中断依然需要。可以在DMA中断中，除了处理数据，也读取并记录当前的溢出计数器，将溢出计数作为时间戳的一部分与捕获数据关联。

5.2 结合从模式实现精准门控测量

有时我们只想测量特定时间段内的脉冲数量或频率。这时可以利用定时器的“从模式门控”功能。

工作原理：将另一个定时器（或同一个定时器的另一个通道）的输出作为“门控”信号，连接到当前定时器的外部触发输入（ETR）或另一个输入通道（TIx）。配置当前定时器为“门控从模式”（Slave Mode Gated）。这样，只有当门控信号为高电平时，当前定时器的计数器才会使能并计数；门控信号变低，计数器停止。通过读取停止时的计数值，就可以知道在门控高电平期间，输入信号发生了多少个边沿（需结合输入捕获或输入触发）。

这常用于测量在特定使能窗口内的频率或脉冲数，精度由门控信号和计数器时钟决定，软件无需干预计数过程。

5.3 输入捕获与编码器模式的异同

STM32的定时器通常还有一个强大的“编码器接口模式”。它和输入捕获有何区别？

• 目的不同：输入捕获核心是测量时间（脉宽、周期、频率）。编码器模式核心是计数和辨向，用于读取正交编码器的位置和速度。
• 硬件连接：编码器模式通常需要两个相位差90度的信号（A相和B相），分别接到TI1和TI2。输入捕获可以只用一路信号。
• 硬件支持：编码器模式内部有方向逻辑，能根据A、B相的相位关系自动控制计数器向上或向下计数，直接输出位置信息。输入捕获需要软件根据两次捕获值计算时间差和方向。
• 应用场景：测量一个未知频率的方波，用输入捕获。读取电机编码器获取转速和转向，用编码器模式。

理解它们的区别，能帮助你在项目中正确选择外设工作模式，事半功倍。

从原理到配置，从基础到进阶，再到避坑指南，STM32 LL库的输入捕获功能就像一把精密的瑞士军刀，功能强大但需要细心调校。核心在于理解硬件的工作流程：边沿检测、滤波器、计数器锁存、中断/DMA触发。每一行配置代码，都是对这个流程中一个环节的定义。当你遇到测量问题时，按照信号质量、GPIO配置、时基精度、中断延迟、溢出逻辑这个链路去排查，大部分问题都能迎刃而解。最后，别忘了示波器是你最好的朋友，它能直观地告诉你硬件层面发生了什么，这是任何软件调试都无法替代的。