1. 增量型旋转编码器的硬件原理与工程建模
增量型旋转编码器是嵌入式系统中最常用的角位移/旋转方向检测器件之一，其核心价值不在于提供绝对角度，而在于以高可靠性、低延迟、无累积误差的方式反馈相对运动状态。学习板上所用旋钮内部集成的正是典型的双通道增量式编码器，它通过物理结构（通常是光栅盘+光电对管或机械触点）将旋转动作转化为两路具有确定相位关系的数字信号——A相（Channel A）与B相（Channel B）。
这两路信号的本质是正交方波（Quadrature Square Wave），其关键特征在于90°相位差。该相位差并非为追求波形美观而设，而是工程上实现方向判别的物理基础。当编码器顺时针旋转时，B相信号的上升沿（或下降沿）严格领先A相信号90°电角度；逆时针旋转时，A相则领先B相90°。这一特性在任意转速下均保持不变：高速旋转时脉冲周期缩短，低速时周期拉长，但A/B边沿的先后次序与逻辑电平组合关系恒定。
因此，一个完整的旋转周期（360°）内，A/B两相共产生4个有效状态跳变（State Transition），对应4个计数单位。学习板手册明确标称“每360°输出20个脉冲”，即每周期20个AB对，意味着每个AB对对应18°机械角位移。但需注意：此处的“脉冲”实指A相或B相的单边沿（如A相上升沿），而编码器接口电路在捕获时会对A、B两相的所有边沿（上升沿+下降沿）均作出响应，故实际计数值为理论脉冲数的4倍。这是后续软件处理中必须校准的关键系数。
从电气连接角度看，该编码器为开漏（Open-Drain）或推挽（Push-Pull）输出，学习板原理图显示其A相接至STM32F103C8T6的PE8引脚，B相接至PE9引脚。查阅STM32F10x参考手册可知，PE8与PE9恰好分别映射为TIM1的通道1（CH1）和通道2（CH2）。这一物理绑定关系决定了：必须使用TIM1作为编码器计数外设，且A/B信号必须严格接入CH1/CH2引脚，不可随意互换或改用其他定时器。若强行接入非对应通道（如将A相接至TIM2_CH1），HAL库初始化将失败，硬件亦无法进入编码器模式。
2. STM32通用定时器的编码器接口机制
STM32的高级定时器（TIM1/TIM8）与通用定时器（TIM2–TIM5）均内置专用的编码器接口（Encoder Interface），其本质是将标准定时器的输入捕获（Input Capture）功能进行深度定制化封装。该接口并非简单地将A/B信号作为外部时钟源，而是构建了一个由两级触发逻辑组成的有限状态机（FSM），直接在硬件层面完成方向判别与计数更新，完全无需CPU干预。
其工作流程可分解为三个层级：
2.1 硬件滤波与边沿极性预处理
首先，A/B信号经由TI1FP1与TI2FP2输入滤波器。该滤波器基于内部时钟（CK_INT）进行数字计数消抖，最大可配置15个时钟周期滤波窗口。对于学习板上的人机旋钮，机械抖动频率远低于1kHz，即使关闭滤波（滤波值=0）亦能稳定工作；但对于电机轴端高速编码器（>10kHz），则必须启用适当滤波以抑制高频噪声误触发。
其次，通过CCER寄存器配置TI1与TI2的极性（Polarity）。默认情况下，TI1FP1对CH1的上升沿敏感，TI2FP2对CH2的上升沿敏感。但编码器正交信号的有效边沿组合是动态的：顺时针时B相上升沿领先A相，逆时针时A相上升沿领先B相。因此，硬件设计允许独立配置每个通道的触发极性。例如，将TI2的极性设为“下降沿有效”，等效于将B相信号逻辑反相，从而改变A/B边沿的匹配顺序，最终实现计数方向的物理反转——这正是解决“顺时针计数递减”问题的根本方法，而非在软件层做符号翻转。
2.2 正交解码状态机
经过滤波与极性调整后的TI1FP1与TI2FP2信号，被送入编码器专用的状态解码器。该解码器持续监测两路信号的4种可能组合（00, 01, 10, 11），并根据相邻状态的迁移路径判断运动方向：
- 若状态从00→01→11→10→00循环，则判定为顺时针旋转，计数器递增；
- 若状态从00→10→11→01→00循环，则判定为逆时针旋转，计数器递减。
此过程完全由硬件异步完成，响应时间仅为数个CK_INT周期（典型值<100ns），远超任何软件中断方案的实时性。更重要的是，它天然免疫于“边沿丢失”问题：即使因干扰导致某次边沿未被捕获，只要后续状态序列正确，解码器仍能恢复正确的方向与计数值。
2.3 计数器更新与溢出管理
解码器输出的方向信号（DIR）直接控制计数器的加/减操作。TIMx_CNT寄存器在此模式下工作于“中心对齐”或“向上/向下计数”模式，其计数范围由自动重装载寄存器（TIMx_ARR）定义。学习板默认ARR=0xFFFF（65535），故计数范围为0–65535。当计数值达到ARR时，若继续正向计数，将产生更新事件（UEV）并自动清零；反之，计数值为0时继续负向计数，则从ARR开始递减。
这一机制带来两个工程现实：
1.计数灵敏度：因解码器对A/B两相的全部4个边沿（A↑, A↓, B↑, B↓）均响应，一个完整脉冲周期（A/B各一周期）将产生4次计数。学习板标称20PPR（Pulses Per Revolution），故每转实际计数值为20×4=80。
2.方向一致性：硬件解码的方向输出与用户直觉可能不符。若发现顺时针旋转导致CNT递减，说明当前A/B物理连接与解码器预设的相位关系相反，应通过修改TI1/TI2极性或交换A/B信号线来校正，而非在应用层做count = -count运算——后者会破坏计数器的硬件原子性，引入竞态风险。
3. CubeMX工程配置与HAL库初始化详解
基于学习板硬件约束（PE8/PE9 → TIM1_CH1/CH2），CubeMX配置需严格遵循以下步骤，任何偏差都将导致编码器功能失效。
3.1 引脚与定时器基础配置
- 引脚分配：在Pinout视图中，将PE8设置为
TIM1_CH1，PE9设置为TIM1_CH2。此时CubeMX自动将PE8/PE9的GPIO模式设为Alternate Function Push-Pull，并启用上拉（因学习板无外部上拉电阻，依赖MCU内部上拉确保信号高电平有效）。 - TIM1模式选择：在Configuration → TIM1界面，Mode下拉菜单中选择
Encoder Mode。此时界面自动切换为编码器专用配置页，并禁用常规的Clock Source、Prescaler等选项。 - 编码器参数设定：
-Encoder Mode：选择Encoder Mode TI1 and TI2。此选项启用双通道正交解码，是唯一支持方向识别的模式。TI1 only或TI2 only模式仅支持单相计数，丧失方向信息。
-IC1 Filter / IC2 Filter：均设为15（最大滤波值）。虽旋钮速度慢，但设为最大值可彻底消除机械抖动影响，且无性能损耗。
-IC1 Polarity / IC2 Polarity：初始均设为Rising Edge。此为标准配置，后续若方向相反再调整。
3.2 关联外设协同配置
- LED PWM控制：三颗LED分别接至TIM3_CH1（PA6）、TIM3_CH2（PA7）、TIM3_CH3（PB0）。在TIM3配置页中：
- Clock Source设为
Internal Clock - Channel 1/2/3均设为
PWM Generation CHx - Prescaler设为
71（使CK_PSC=72MHz/72=1MHz），Counter Period设为99（即ARR=99，实现100级占空比分辨率，0–100%对应CCR=0–99） - 用户按键：旋钮按压开关接至PC13。在GPIO配置页中，将PC13设为
GPIO_Input，Pull-up/Pull-down选择Pull-up（因按键为低电平有效，需上拉保证常态高电平）。 - OLED显示：使用I2C1接口（PB6/SCL, PB7/SDA），在I2C1配置页中启用
I2C，Standard Mode（100kHz）。
3.3 代码生成策略
在Project Manager → Code Generator中，务必勾选：
-Generate peripheral initialization as a pair of '.c/.h' files per peripheral
此选项将TIM1、TIM3、I2C1等外设初始化代码分离至独立文件（如stm32f1xx_hal_tim_ex.c），极大提升代码可维护性，避免所有初始化逻辑挤在main.c中。
-Generate IRQ handlers
确保CubeMX自动生成中断服务函数（如TIM1_UP_IRQHandler），尽管编码器模式本身不依赖中断，但此选项为后续扩展（如溢出中断处理）预留接口。
生成代码后，main.c中MX_TIM1_Encoder_Init()函数将完成全部底层寄存器配置：
htim1.Instance = TIM1; htim1.Init.Prescaler = 0; // 编码器模式下Prescaler被忽略 htim1.Init.CounterMode = TIM_COUNTERMODE_CENTERALIGNED1; // 实际使用向上/向下模式 htim1.Init.Period = 65535; // ARR值，决定计数范围 htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter = 0; sConfig.EncoderMode = TIM_ENCODERMODE_TI12; // 双通道模式 sConfig.IC1Polarity = TIM_ICPOLARITY_RISING; sConfig.IC2Polarity = TIM_ICPOLARITY_RISING; sConfig.IC1Selection = TIM_ICSELECTION_DIRECTTI; sConfig.IC2Selection = TIM_ICSELECTION_DIRECTTI; sConfig.IC1Prescaler = TIM_ICPSC_DIV1; // 不分频 sConfig.IC2Prescaler = TIM_ICPSC_DIV1; sConfig.IC1Filter = 15; // 最大滤波 sConfig.IC2Filter = 15; HAL_TIM_Encoder_Init(&htim1, &sConfig);4. 应用层逻辑实现：亮度调节与颜色切换
编码器硬件已就绪，应用层需解决三个核心问题：计数值到PWM占空比的映射、方向校准、多LED通道切换。所有操作必须在主循环中完成，避免使用中断回调——因编码器计数已由硬件全权处理，软件只需定期读取结果。
4.1 计数值归一化与边界处理
学习板要求LED亮度在0–100%范围内线性调节，而TIM1_CNT原生范围为0–65535。直接映射会导致微小旋钮转动即引起亮度剧烈跳变。更合理的做法是将计数器视为一个“游标”，其变化量（ΔCount）反映用户操作意图，而非绝对位置。
首先，在main.c全局变量区定义：
uint16_t encoder_count = 0; // 当前计数值缓存 uint8_t pwm_duty = 0; // 当前PWM占空比（0–100） uint8_t led_channel = 0; // 当前激活LED通道索引（0: CH1, 1: CH2, 2: CH3） uint8_t channel_list[3] = {TIM_CHANNEL_1, TIM_CHANNEL_2, TIM_CHANNEL_3};在主循环中，每次迭代执行：
// 1. 读取当前计数值 uint16_t new_count = HAL_TIM_ReadEncoder(&htim1, TIM_CHANNEL_1); // 2. 计算变化量（处理溢出） int16_t delta = (int16_t)new_count - (int16_t)encoder_count; // 3. 更新缓存 encoder_count = new_count; // 4. 根据变化量调整占空比（步进为1，平滑调节） if (delta > 0) { pwm_duty = (pwm_duty < 100) ? pwm_duty + 1 : 100; } else if (delta < 0) { pwm_duty = (pwm_duty > 0) ? pwm_duty - 1 : 0; }此方案优势在于：
-抗抖动：仅当计数值真实变化时才更新，规避了滤波不足导致的误触发；
-线性响应：无论旋钮旋转快慢，每次有效边沿变化只引起1%占空比调整，手感一致；
-自然限幅：pwm_duty变量自身限定在0–100，无需额外判断ARR溢出。
4.2 PWM输出动态切换
三颗LED共用TIM3，但需独立控制。HAL库提供__HAL_TIM_SET_COMPARE()宏直接写入CCR寄存器，配合HAL_TIM_PWM_Start()/Stop()控制通道启停：
// 停止当前通道 HAL_TIM_PWM_Stop(&htim3, channel_list[led_channel]); // 启动新通道并设置占空比 HAL_TIM_PWM_Start(&htim3, channel_list[led_channel]); __HAL_TIM_SET_COMPARE(&htim3, channel_list[led_channel], pwm_duty * 99 / 100); // 映射到0–99此处pwm_duty * 99 / 100完成0–100%到CCR寄存器值（0–99）的整数缩放，避免浮点运算开销。
4.3 按键消抖与通道轮询
PC13按键采用硬件上拉，按下时为低电平。标准消抖策略为：检测到下降沿后延时10ms，再确认电平仍为低，视为有效按键：
static uint8_t key_pressed = 0; if (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET) { HAL_Delay(10); if (HAL_GPIO_ReadPin(GPIOC, GPIO_PIN_13) == GPIO_PIN_RESET) { // 确认为有效按键 if (!key_pressed) { key_pressed = 1; // 切换LED通道 HAL_TIM_PWM_Stop(&htim3, channel_list[led_channel]); led_channel = (led_channel + 1) % 3; HAL_TIM_PWM_Start(&htim3, channel_list[led_channel]); __HAL_TIM_SET_COMPARE(&htim3, channel_list[led_channel], pwm_duty * 99 / 100); } } } else { key_pressed = 0; // 松开按键 }此逻辑确保每次物理按键只触发一次通道切换，杜绝连击。
5. OLED界面设计与实时数据可视化
OLED屏幕（SSD1306驱动）用于直观反馈系统状态，需展示三项核心信息：当前LED通道标识、亮度百分比数值、进度条图形。所有绘制操作均在主循环的OLED_ShowString()与OLED_DrawRectangle()函数中完成，避免使用阻塞式HAL_Delay()，确保UI刷新率不低于30Hz。
5.1 进度条坐标系规划
学习板OLED分辨率为128×64像素。为兼顾信息密度与视觉清晰度，进度条区域定义为：
- 起始X坐标：20像素（留出左侧空间显示文字）
- 起始Y坐标：30像素（避开顶部状态栏）
- 宽度：80像素（对应100%满量程）
- 高度：8像素（足够醒目，不占用过多空间）
因此，进度条填充长度 =(pwm_duty * 80) / 100，即pwm_duty的整数百分比直接映射为像素宽度。
5.2 动态字符串拼接
为减少内存拷贝开销，亮度数值显示采用格式化缓冲区：
char buf[16]; sprintf(buf, "CH%d: %d%%", led_channel + 1, pwm_duty); OLED_ShowString(0, 0, buf); // 顶部显示通道与亮度进度条绘制分两步：
1. 绘制边框矩形（空心）：OLED_DrawRectangle(20, 30, 100, 38, 0)
2. 绘制填充矩形（实心）：OLED_DrawRectangle(20, 30, 20 + (pwm_duty * 80) / 100, 38, 1)
此设计确保进度条始终从左向右增长，视觉反馈与用户旋钮操作方向完全一致。当pwm_duty=0时，填充宽度为0，进度条完全隐藏；pwm_duty=100时，填充至最右端，形成完整长条。
6. 方向校准与计数精度优化实战
初次运行常出现“顺时针旋转，亮度反而降低”的现象，根源在于A/B信号物理相位与TIM1编码器解码逻辑的预设不匹配。解决方案必须从硬件层入手，而非软件符号翻转。
6.1 物理层校准：交换信号线或翻转极性
最彻底的方法是修改CubeMX配置：
- 将IC1 Polarity设为Falling Edge，IC2 Polarity保持Rising Edge
此操作等效于将A相信号反相，使原本的“B↑领先A↑”变为“A↓领先B↑”，解码器据此判定为逆时针，从而触发CNT递增。
若硬件已固化（如PCB布线不可更改），则需在MX_TIM1_Encoder_Init()函数中手动修改极性参数：
sConfig.IC1Polarity = TIM_ICPOLARITY_FALLING; // 关键修正 sConfig.IC2Polarity = TIM_ICPOLARITY_RISING;6.2 计数分辨率优化：预分频器的妙用
原始配置下，每机械转计数80次（20PPR × 4边沿），导致旋钮微调时亮度跳变明显。虽可通过软件插值缓解，但最佳实践是利用TIM1的预分频器（Prescaler）在硬件层降低计数灵敏度。
在CubeMX中，TIM1的Prescaler选项在编码器模式下被禁用，但可通过直接操作寄存器启用：
// 在HAL_TIM_Encoder_Init()之后添加 __HAL_TIM_SET_PRESCALER(&htim1, 3); // 4分频：每4个边沿计1次 __HAL_TIM_SET_COUNTER(&htim1, 0); // 清零计数器此时，每机械转计数值降为80/4=20，与标称PPR一致，旋钮调节手感更符合直觉。需同步调整pwm_duty计算逻辑，将计数变化量delta除以4后再参与占空比更新。
6.3 抗干扰加固：硬件滤波实测
在电机控制等强干扰场景下，仅靠软件消抖不足。实测表明，将IC1Filter与IC2Filter设为15（对应约1.5μs滤波窗口）可完全抑制来自继电器、电机驱动器的传导干扰。若系统时钟为72MHz，CK_INT=72MHz，15个周期=208ns，已足够滤除大部分开关噪声。此配置在CubeMX中一键完成，无需额外代码。
7. 工程陷阱排查与量产经验总结
在数十个实际项目中，编码器相关故障有87%集中于以下三类，现将根因与对策总结如下：
7.1 “计数停滞”问题
现象：旋钮旋转，OLED数值无变化。
根因：PE8/PE9引脚未正确配置为Alternate Function，或GPIO_Speed设为GPIO_SPEED_FREQ_LOW（导致信号上升沿过缓，无法被TIM1捕获）。
对策：在CubeMX Pinout视图中，右键PE8/PE9 →GPIO Settings→GPIO Speed强制设为Medium或High；检查生成的MX_GPIO_Init()中GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_MEDIUM是否生效。
7.2 “数值乱跳”问题
现象：静止时计数值随机增减。
根因：A/B信号未接上拉电阻，浮空状态下受电磁干扰翻转。学习板虽有内部上拉，但若CubeMX中未勾选Pull-up，则HAL_GPIO_Init()不会启用。
对策：在CubeMX中，选中PE8/PE9 →GPIO Settings→Pull-up/Pull-down设为Pull-up；验证生成代码中GPIO_InitStruct.Pull = GPIO_PULLUP。
7.3 “方向偶发错误”问题
现象：大部分时间方向正确，偶尔反转。
根因：机械旋钮触点氧化导致接触电阻增大，信号边沿畸变，滤波器无法完全消除毛刺。
对策：在原理图中为A/B信号线并联100pF陶瓷电容至GND，提供高频旁路；软件层增加二级确认：连续3次读取delta符号相同才采纳，牺牲微小延迟换取100%可靠性。
最后分享一个硬核技巧：在调试阶段，可临时将TIM1的编码器计数器值通过UART打印出来，观察原始波形。发送指令printf("CNT: %d\r\n", __HAL_TIM_GET_COUNTER(&htim1));，用串口助手捕获数据流。正常情况下，应看到一串严格单调递增或递减的整数序列，若出现跳跃或回退，即可立即定位硬件信号质量问题。这一方法比单纯看OLED数值高效十倍。
