调电机这活儿，最怕的一种情况是：指令发下去让转 90 度，肉眼看着确实在转，停下来一量，位置差了七八度；换个负载再跑一遍，差的角度又不一样。这种问题靠改参数是压不住的，根子往往在反馈环节——你根本不知道自己到底转了多少。STM32 标准库驱动旋转编码器做电机精准控制，解决的就是这件事：把电机轴上的实际转角，变成单片机里一个可信的、实时的数字，再交给控制环去用。
这套方案的核心并不复杂：用增量式旋转编码器的 A/B 两相输出，直接喂给 STM32 定时器的编码器接口模式，硬件自动完成四倍频计数，CPU 不参与任何一个脉冲的处理；主循环按固定周期把计数器读出来，换算成转速和位置，再经过 PID 运算输出占空比去驱动电机。它适合谁？适合手上有一块 F1 系列板子、做过基础电机驱动、想把“能转”升级成“转得准”的人；也适合维护存量标准库工程、不方便整体迁到新库的开发者。全篇我会按硬件接线、定时器配置、量纲换算、闭环整定、故障排查这条线走一遍，代码直接用标准库写，能抄。
1. 方案定调：为什么这套组合值得动手
1.1 从一次“转不准”的现场说起
先说个真实感很强的场景。某产线上一台输送机构，需要把工件按固定间距分度，执行机构是一台带减速箱的直流减速电机，输出轴装了一个增量式编码器。最初的做法很朴素：给电机通电固定时长，靠时间估算转过的角度。空载调试的时候效果还行，误差在可接受范围内，一上料就露馅——负载变大，电机加速变慢，同样通电 500ms，实际转过的角度少了一大截。于是开始加补偿系数，空载一个系数、满载一个系数，折腾到最后发现补偿系数跟温度、跟润滑状态都有关，根本补不完。
问题的本质是开环：你没有测量，只有猜测。想让执行机构停在哪就停在哪，必须引入位置反馈，把“转了多少”变成可测的量。旋转编码器就是最直接的答案——它长在电机轴上，轴转多少它输出多少脉冲，脉冲数就是角度，脉冲频率就是转速。而 STM32 的定时器恰好内置了专门处理这类信号的硬件模式，两者是天然的一对。
这里多说一句选型的事。位置反馈有几种常见路子：电位器（成本低但磨损、有死区）、霍尔开关（分辨率低，一般只做换相）、磁编码器（分辨率高、抗污染，但接口多为 SPI/I2C，需要额外通信开销）、光电或磁电增量式编码器（A/B/Z 三线输出，抗干扰好、响应快、成本适中）。做电机转速和中等精度位置控制，增量式编码器是性价比最高的一档，尤其是它输出的是差分或推挽的方波，塞给定时器就能数，不需要协议栈。
1.2 标准库在这个方案里的位置与取舍
现在新项目大多用更新的硬件抽象库配合图形化配置工具，为什么这里还提标准库？三个原因，都是我实际踩出来的。
第一，时序可控。标准库本质是寄存器操作的一层薄封装，函数调用下去改的是哪几个位，翻手册对得上。编码器接口这类外设，行为依赖多个寄存器位的组合，一旦出问题，知道自己在改什么，排查效率完全不是一个量级。抽象层封装得越厚，出问题时你越只能猜。
第二，中断开销小。标准库的中断服务函数里没有一堆回调分发，进中断到处理完就几条指令。做速度环的时候，控制周期越短控制品质越好，中断里多几十条指令在低速场合无所谓，转速上去了就是实打实的抖动来源。
第三，存量工程友好。大量已有的设备固件是标准库写的，整体迁移成本高、风险大。在这种工程里加一个编码器闭环功能，用标准库写是最省事的，不用引入第二套体系。
代价也得说清楚：标准库不再更新，新芯片支持不全，社区活跃度低。所以我的建议是——新设计的项目，除非团队有明确的存量约束，否则别主动选它；但已经在用它的项目，把编码器这部分用标准库写透，是完全值得的，本文的配置思路也能平移到其他库上，只是函数名不同。
1.3 整套控制链路的骨架
把链路拆开看，一共五层，从上到下：
- 指令层：上位机或按键给出目标位置/目标转速；
- 测量层：定时器硬件计脉冲，周期任务读计数、算增量；
- 换算层：把脉冲增量换算成转速（RPM）或角度（度/毫米）；
- 决策层：PID 控制器比较目标与实测，输出控制量；
- 执行层：把控制量变成 PWM 占空比，经驱动桥推动电机。
这里有个容易被忽略的设计原则：测量层必须是硬件完成的。如果指望用外部中断给每个脉冲计数，转速一高就丢中断——假设编码器 1000 线、四倍频后每转 4000 个脉冲，电机 3000 RPM 就是每秒 20 万个脉冲，中断根本来不及响应。定时器的编码器模式是把 A/B 两相当作计数时钟源，硬件自己加一减一，CPU 完全不需要介入，这是整个方案能成立的物理基础。
2. 硬件层：接线接不对，后面全白搭
2.1 A/B/Z 三根线到底在说什么
增量式编码器内部是一个带缝隙的码盘加光电（或磁电）检测对管，A、B 两路输出方波，两者相位差 90 度电角度，这就是“正交”的由来。相位差决定了方向：A 超前 B 90 度是一个方向，B 超前 A 90 度是反方向。这个 90 度相位差还带来一个额外好处——每个周期里 A、B 各有一次上升沿和一次下降沿，一共 4 个可计数的边沿，等于把码盘刻线的分辨率放大了 4 倍，这就是“四倍频”。
Z 相是零位信号，码盘每转一圈输出一个脉冲，用来做机械零点标定。对于行程有限、需要绝对参考点的机构（比如升降台、旋转分度台），Z 相很有用；做纯速度闭环，Z 相可以不接。我一般建议把 Z 相引出来留个测试点，哪怕暂时不用，后面想加回零功能不用重新拆机。
还有一点，编码器分增量式和绝对式两大类。绝对式上电就知道绝对角度，但接口复杂、价格高。增量式上电时计数器是 0，这个 0 是“上电那一刻的位置”，不是机械零点，所以需要 Z 相或者外部限位开关来建立绝对参考。这一点在做位置控制时必须写进初始化流程，否则每次上电的坐标系都不一样。
2.2 引脚与定时器的选型规则
不是所有定时器都能做编码器接口。以常见的 F1 系列为例，通用定时器 TIM2、TIM3、TIM4、TIM5 支持编码器模式，通道固定用 CH1 和 CH2，不能换。所以选引脚的时候第一步是翻数据手册的复用功能表，找出哪个定时器的 CH1/CH2 引到了你手上方便用的引脚。
选型时有几条经验规则：
- 优先选 32 位定时器（比如 TIM2、TIM5），16 位定时器每 65536 个脉冲就要处理一次溢出，虽然能靠软件扩展，但多一处出错的可能。
- 避开已经占用的定时器。比如 TIM1 常被拿来做 PWM 输出，TIM4 常被拿来做系统节拍，编码器最好独占一个。
- 两根线尽量落在同一个端口且相邻，走线短、成对，抗干扰好。比如 PA6/PA7 配 TIM3，PB6/PB7 配 TIM4。
- 如果编码器输出是集电极开路型（很多工业编码器是这种），必须外接上拉电阻到 3.3V，阻值 4.7k 到 10k 之间；如果是推挽输出，还要确认它的高电平是 3.3V 兼容的，5V 推挽直接怼进 STM32 会烧引脚，得加电平转换。
2.3 上拉、滤波和走线，三个最容易被轻视的点
先说上拉。集电极开路输出在没有上拉的时候，高电平是浮空的，示波器上看就是一条缓慢爬升的斜线，定时器可能把它当成多次跳变，计数直接起飞。我遇到过最离谱的一次，电机一转计数器就疯涨，查了半天发现是上拉电阻虚焊。所以接线完成后，第一件事是用示波器或者逻辑分析仪看 A/B 波形，确认是干净的方波、幅值到 3.3V、上升沿不超过几百纳秒。
再说滤波。定时器的输入通道自带数字滤波器，可以通过设置滤波参数把窄于若干个采样周期的毛刺滤掉。这个参数的取值要在“滤掉干扰”和“不丢真实边沿”之间平衡：设得太大，高速时真实的窄脉冲被吃掉，计数偏少；设得太小，干扰照样进来。我的经验是先用中间档位（滤波系数 6 左右）跑起来，然后用示波器在最高转速下看波形，如果边沿干净就往下调，如果还有毛刺就往上加，同时观察计数是否与理论值一致。
最后是走线，这条最容易被“能转就行”的心态带过去。编码器线是弱小信号线，电机线是大电流开关线，两者平行走一米，感应出来的干扰足以让计数出错。正确做法：编码器线用屏蔽双绞线，屏蔽层单端接地（接控制板一侧，不要两头都接，否则形成地环路）；走线尽量远离电机动力线和驱动桥；如果实在躲不开，交叉走，不要平行。这些看起来是“玄学”，实际是每次调试都要先排除的低级因素。
3. 定时器编码器模式：把硬件计数器用到极致
3.1 计数原理与四倍频是怎么实现的
把定时器切成编码器模式后，它内部的两个输入通道 TI1、TI2 会经过边沿检测，产生两路脉冲，再经过一个方向逻辑电路，决定计数器是加还是减。这个方向逻辑的判据，就是两路信号的相位先后关系。硬件里有一张真值表，A、B 的当前电平和上一次电平组合起来，唯一确定一个方向。所以它既不会漏，也不会误判，除非信号本身有毛刺。
计数模式有三种可选：只对 TI1 计数、只对 TI2 计数、对 TI1 和 TI2 都计数。第三种就是四倍频模式，每个电周期计 4 个数。设编码器标称 1000 线，电机轴转一圈，A 相输出 1000 个完整周期，四倍频后计数器变化 4000。这个 4000 就是后面所有换算的基础数字，务必先在脑子里刻死。
注意：编码器标称的“线数”和“分辨率”经常被混用，采购时要问清楚是每转脉冲数（PPR）还是每转周期数。如果对方给的是 PPR，四倍频后就乘 4；如果给的是 A/B 各自的周期数，也是乘 4。唯一不能乘 4 的情况是编码器内部已经做了四倍频输出，这种要在手册里确认。
3.2 标准库初始化代码逐行拆解
下面这段是把 TIM3 配成编码器模式的完整过程，PA6/PA7 对应 TIM3_CH1/CH2。
#include "stm32f10x.h" void Encoder_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; TIM_ICInitTypeDef TIM_ICInitStructure; /* 1. 时钟：TIM3 挂 APB1，GPIOA 挂 APB2 */ RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA, ENABLE); /* 2. 引脚：上拉输入，外部编码器若是 OC 输出就靠内部上拉顶上 */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode = GPIO_Mode_IPU; GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_Init(GPIOA, &GPIO_InitStructure); /* 3. 时基：预分频 0，周期给满 65535 */ TIM_TimeBaseStructure.TIM_Prescaler = 0; TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; TIM_TimeBaseStructure.TIM_Period = 0xFFFF; TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; TIM_TimeBaseStructure.TIM_RepetitionCounter = 0; TIM_TimeBaseInit(TIM3, &TIM_TimeBaseStructure); /* 4. 关键一步：编码器接口模式，TI1 与 TI2 都计数 */ TIM_EncoderInterfaceConfig(TIM3, TIM_EncoderMode_TI12, TIM_ICPolarity_Rising, TIM_ICPolarity_Rising); /* 5. 输入滤波：两个通道都要设 */ 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 = 6; TIM_ICInit(TIM3, &TIM_ICInitStructure); TIM_ICInitStructure.TIM_Channel = TIM_Channel_2; TIM_ICInit(TIM3, &TIM_ICInitStructure); /* 6. 计数器清零后使能 */ TIM_SetCounter(TIM3, 0); TIM_Cmd(TIM3, ENABLE); }第 3 步的预分频为什么是 0？因为编码器模式下，外部脉冲就是计数时钟，预分频会把脉冲分频，等于降低分辨率。除非你的编码器脉冲频率高到定时器跟不上（一般到几兆赫兹都没问题），否则不要分频。
第 4 步的两个极性参数决定计数方向。如果实测发现电机正转时计数减少，把这两个参数中的一个改成TIM_ICPolarity_Falling，或者干脆在软件里对读数取反，两种办法都行，后者更省事。
第 5 步的TIM_ICFilter = 6对应的采样策略是：以定时器时钟分频后的频率采样，连续 8 次一致才认。这个档位能滤掉几十纳秒级的毛刺，对普通工业环境够用。如果你的环境特别脏，可以往上加到 10 到 15，但记得重新验证高速时的计数准确性。
3.3 溢出、方向与 16 位计数扩展
16 位计数器有个绕不开的问题：从 65535 再加一就回到 0，从 0 再减一就变成 65535。如果你只看绝对值，会觉得位置突然跳变了几万。处理办法很经典，用无符号减法再强制转有符号：
static uint16_t s_last_cnt = 0; static int32_t s_total = 0; int32_t Encoder_GetTotalCount(void) { uint16_t now = TIM_GetCounter(TIM3); int16_t diff = (int16_t)(now - s_last_cnt); /* 回绕自动正确 */ s_last_cnt = now; s_total += diff; return s_total; }(uint16_t)(now - s_last_cnt)在无符号域里做减法，即使跨越了 0 边界，结果仍然是正确的小增量；再把它解释成int16_t，就能区分正反转。这个技巧的前提是两次调用之间的增量绝对值小于 32768，也就是说采样周期不能太长、转速不能太高，否则增量会溢出有符号 16 位范围，符号判断就错了。核算一下：增量上限 32767，四倍频后每转 4000 脉冲，等于 8 圈多。只要采样周期内电机转不到 8 圈，就安全。对于绝大多数应用，采样周期在 1 到 10 毫秒，电机转速几千转，转过的圈数远小于 8，放心用。
如果确实需要更高的安全性，改用 32 位定时器（TIM2/TIM5），或者用定时器的更新中断在溢出时给软件计数器加一减一。中断方案的代价是每次溢出都要进一次中断，16 位定时器在高速下溢出频繁，会增加 CPU 负担，所以能用软件差值法就别用中断法。
还有一点：TIM_GetCounter和后续的清零操作之间如果有中断插入，可能读到不一致的值。稳妥的做法是在读取的时候关一下总中断，读完整理完再开。这个窗口只有几条指令，对控制周期的影响可以忽略。
4. 从脉冲到物理量：换算这一关卡住很多人
4.1 分辨率推导：一步一步算清楚
换算错一位小数，整个闭环就废了，而且这种错误特别隐蔽——电机照样转，只是转多转少不对。所以我把推导过程完整写一遍。
已知条件（举例）：编码器标称 1000 线，A/B 正交输出；减速箱减速比 1:30；输出轴装直径 65mm 的轮子。
第一步，电机轴每转的计数：
CPR_motor = 1000 × 4 = 4000 counts/rev第二步，输出轴每转的计数。减速比 30 意味着电机转 30 圈，输出轴转 1 圈：
CPR_output = 4000 × 30 = 120000 counts/rev第三步，折算到直线位移。轮子周长：
C = π × 65mm = 3.1416 × 65 ≈ 204.2mm每个计数对应的位移：
res = 204.2 / 120000 ≈ 0.0017mm/count ≈ 1.7 微米这个数字说明什么？说明理论分辨率是 1.7 微米，但实际能达到的定位精度远不止受它限制——机械间隙、轮子打滑、编码器安装偏心都会吃掉精度。所以别看到 1.7 微米就以为能做到微米级定位，真实工程里能稳定到 0.05mm 就算不错了。这个认知很重要，它决定了你不该把 PID 的目标精度设得离谱。
反过来，如果从需求倒推：要求定位精度 0.1mm，那每个计数对应位移必须小于 0.1mm，也就是 CPR_output 至少要 2042。1000 线编码器加 30 减速比远远超过这个要求，选型是够的。这种倒推法在项目初期比正着算更有用。
4.2 M 法、T 法、M/T 法，到底选哪个
测速有三条经典路线，各有各的适用区间。
M 法（定时计数法）：固定时间窗 T 内数脉冲个数 n，转速正比于 n/T。优点是实现简单、低速时也能出一个数；缺点是低速时 n 很小，量化误差被放大。比如 T=10ms、转速 10 RPM，10ms 内理论计数是 4000×30×10/60×0.01 ≈ 200，还凑合；转速降到 1 RPM，就只有 20 个计数，误差 5%。转速再低就完全没法看了。
T 法（测周法）：测两个相邻脉冲之间的时间，转速反比于时间。优点是低速时脉冲间隔长、测量精细，低速精度高；缺点是高速时脉冲间隔太短，定时器分辨率不够，误差反而变大。
M/T 法：同时测固定时间窗和窗内首尾脉冲的时间，兼顾高低速。实现复杂度最高，一般只有对全速域精度都有要求的场合才用。
落到实际项目上，我的建议很直接：大部分场合用 M 法就够了，前提是把采样周期选好。采样周期 T 的选择有个经验公式——让最低关注转速下，窗口内的计数不少于 50 个。反推：如果最低关注转速是 30 RPM，输出轴每秒 0.5 转，每转 120000 计数，那么 10ms 内计数是 600，很充裕。如果最低转速是 3 RPM，10ms 内只有 60 个计数，勉强够用；要更稳就把窗口拉到 20ms。代价是控制环的采样变慢，动态响应变差，这是典型的取舍，没有免费午餐。
4.3 定点数还是浮点，采样周期怎么定
F1 系列没有硬件浮点单元，浮点运算是软件模拟，一次乘加几十个周期。做速度换算和 PID，如果全用 float，在中低端型号上可能吃掉可观的 CPU 时间。我的做法是：换算和 PID 用 float 写，但控制频率不要超过 1kHz，实测在 72MHz 主频下，1kHz 的浮点 PID 加换算占用不到 5% 的 CPU，完全可接受。如果确实需要更高频率，把关键变量改成 Q 格式定点数（比如 Q15），乘完右移，速度能提上去好几倍。
采样周期和 PWM 频率的关系要注意：两者不要整数倍同步得太死，否则可能出现采样点总是落在 PWM 的同一个相位上，测到的电流/速度有周期性偏差。我一般让采样周期是 PWM 周期的非整数倍，或者干脆用一个独立的定时器做采样节拍。
换算代码：
#define ENC_CPR_MOTOR 4000.0f /* 电机轴每转计数 */ #define GEAR_RATIO 30.0f /* 减速比 */ #define SAMPLE_S 0.005f /* 采样周期 5ms */ /* 输入两次的总计数，输出输出轴 RPM */ float Encoder_GetRPM(int32_t now_cnt, int32_t last_cnt) { int32_t delta = now_cnt - last_cnt; float rev = (float)delta / (ENC_CPR_MOTOR * GEAR_RATIO); return rev * (60.0f / SAMPLE_S); }这段代码每次调用都要做一次除法，如果采样频率高，可以改成乘倒数常数，编译器一般会自动优化，但显式写出来更保险。
5. 闭环落地：PID 和 PWM 的配合
5.1 控制环的结构与节拍
整个控制环跑在一个定时中断里，节拍就是前面定的采样周期。中断里做的事按顺序是：读编码器总计数、算增量、算当前转速、跑 PID、更新 PWM 占空比。五步，不要多也不要少，任何耗时操作（串口打印、EEPROM 写入）都扔到主循环去，中断里干这些会直接破坏控制节拍。
有人喜欢在中断里做位置环、主循环做速度环，双环嵌套。这种结构在需要高精度定位的场合确实有用：位置环慢一点（比如 20ms 一次），输出作为速度环的目标；速度环快一点（5ms 一次），输出作为 PWM。但对于大多数单轴控制，单环加前馈就够，别一上来就上双环，调参难度翻倍。
PWM 输出用 TIM1 的 CH1，配置成 10kHz。为什么是 10kHz？低于 8kHz 人耳能听到啸叫，高于 20kHz 开关损耗上升、驱动桥发热明显。10kHz 到 16kHz 是个舒服的区间。计算一下：系统时钟 72MHz，要 10kHz，则：
ARR = 72MHz / 10kHz - 1 = 7199 PSC = 0占空比分辨率就是 7200 级，对应控制量的最小步进约 0.014%，对电机控制绰绰有余。
void Motor_SetDuty(int16_t duty) /* duty: -7200 ~ +7200 */ { if (duty >= 0) { GPIO_ResetBits(GPIOB, GPIO_Pin_13); /* 方向脚 */ TIM_SetCompare1(TIM1, (uint16_t)duty); } else { GPIO_SetBits(GPIOB, GPIO_Pin_13); TIM_SetCompare1(TIM1, (uint16_t)(-duty)); } }方向脚和 PWM 的切换顺序有讲究：先改方向，再改占空比，中间留一点死区时间（几微秒），避免驱动桥上下管直通。有些驱动芯片内部有互锁，不怕这个，但自己搭的分立桥必须考虑。
5.2 增量式 PID 的代码与整定过程
速度环用增量式 PID 更合适，因为它输出的是控制量的增量，天然带积分作用，切换模式时不容易产生大的冲击。公式展开：
Δu = Kp·(e[k] - e[k-1]) + Ki·e[k] + Kd·(e[k] - 2e[k-1] + e[k-2])代码：
typedef struct { float kp, ki, kd; float e1, e2; /* 上两次误差 */ float out; /* 当前输出 */ float out_max; float out_min; } PID_Inc_t; float PID_IncCalc(PID_Inc_t *p, float target, float actual) { float e0 = target - actual; float du = p->kp * (e0 - p->e1) + p->ki * e0 + p->kd * (e0 - 2.0f * p->e1 + p->e2); p->out += du; if (p->out > p->out_max) p->out = p->out_max; if (p->out < p->out_min) p->out = p->out_min; p->e2 = p->e1; p->e1 = e0; return p->out; }整定的顺序我一般这么走：
- 先只开 P。Ki、Kd 置零，Kp 从很小开始加，加到电机能跟着目标转、有明显超调但不振荡为止。这时候系统响应快但会抖。
- 加 D 压超调。Kd 从 0 慢慢加，观察超调是否减小、高频抖动是否变大。Kd 太大会把编码器的量化噪声放大成抖动，听到电机发出“滋滋”声就是加过头了。
- 最后加 I 消静差。Ki 从小到大加，加到稳态误差消失。Ki 太大会引起低频振荡，表现是转速周期性起伏。
参数的量纲也要注意。Kp 的单位是“占空比每 RPM”，如果你的占空比满量程是 7200，转速满量程是 3000 RPM，那 Kp 的合理量级大概在 0.5 到 3 之间。给个具体起点：Kp=1.0、Ki=0.05、Kd=0.0，先跑起来看现象再调。
5.3 抗饱和、死区补偿和几个必要的保护
积分饱和是必踩的坑。电机堵转或者目标转速突变时，误差持续很大，积分项累加到极限，等误差反向时积分要很久才能退回来，表现是“冲过头再慢慢回来”。增量式 PID 天然缓解这个问题，因为它的积分体现在输出累加上，而输出有上下限截断，等于自动抗饱和。位置式 PID 就必须显式做积分限幅或者积分分离。
死区补偿是另一个必做项。直流电机在占空比低于某个阈值（通常 5% 到 15%）时根本转不起来，因为克服不了静摩擦和驱动桥的压降。如果不补，低速时 PID 会一直加输出，加到能转了就突然窜出去，形成低速爬行。补偿办法是给输出加一个偏移：
#define DUTY_DEAD 400 /* 死区阈值，约占满量程 5.5% */ #define DUTY_COMP 250 /* 补偿量，略小于死区 */ int16_t Compensate(int16_t duty) { if (duty > DUTY_DEAD) return duty + DUTY_COMP; if (duty < -DUTY_DEAD) return duty - DUTY_COMP; return 0; }补偿量要略小于死区阈值，否则会在零点附近产生极限环——输出在正负补偿之间来回跳，电机嗡嗡响但不转。这个参数必须实测，不同电机、不同驱动桥都不一样，没有通用值。
保护部分，至少做三件事：一是 PWM 输出限幅，别让 PID 算出超过满量程的值；二是堵转检测，如果连续若干个周期编码器计数不变化而输出很大，判堵转，切断输出；三是上电软启动，输出从 0 缓慢爬升到目标，避免冲击电流。
6. 现场踩坑记录与排查速查表
6.1 几个典型故障的定位思路
现象一：电机一转，计数就乱跳，数字大得离谱。
先怀疑上拉和干扰。断开电机，用手慢慢转编码器轴，看计数是否线性增加；如果手转正常、电机一转就乱，基本可以确定是动力线干扰或地环路。处理顺序：先查编码器线是否与动力线并行、屏蔽层是否单端接地，再查编码器电源是否与控制板共地且干净，最后考虑在 A/B 线上加 100nF 到地的小电容（注意电容会拖慢边沿，容量别大）。
现象二：正转计数增加，反转也增加。
方向判断错了。两种可能：A/B 接反了，或者定时器极性参数配错了。最快的验证办法是交换 A、B 两根线，看计数方向是否反过来；如果反了，说明接线问题，改接线或者软件取反都行。
现象三：低速时转速显示忽大忽小，电机一顿一顿。
典型的测速量化误差。先确认采样窗口内的计数量够不够（按前面说的 50 个的下限核算），不够就把采样周期加长；如果周期已经很长还是抖，考虑换成 M/T 法，或者在低速段切换到 T 法测速。另外检查一下 PID 的 Kd 是不是加太大了，微分项会把量化噪声放大。
现象四：定位时总是差一点点，反复微调停不下来。
大概率是机械间隙或者 PID 参数太激进。判断方法：给一个目标位置，观察电机停止后的实际位置，如果每次都停在同一个偏差上，是系统性偏差，可以加固定补偿；如果每次偏差方向不一样，是间隙或摩擦，需要降低 Kp、加大死区。也有可能是位置环的判据太严，比如要求误差小于 1 个计数，而机械根本做不到这个精度，导致输出一直在小幅震荡。
现象五：上电第一次运行正常，重启后位置基准变了。
增量式编码器的固有问题——上电计数器是 0，但机械位置不是 0。解决思路有两条：一是每次上电执行回零流程，慢速向一个方向转，碰到限位开关或 Z 相脉冲就停，把当前位置设为机械零点；二是加绝对式编码器或者掉电保存位置（需要额外的存储和可靠的掉电检测）。前者成本低，是主流做法。
6.2 常见问题速查表
| 现象 | 最可能的原因 | 排查动作 | 处理办法 |
|---|---|---|---|
| 计数完全不动 | 编码器无供电 / 引脚配错 | 万用表量编码器 VCC，示波器看 A/B | 补供电，核对复用功能表 |
| 计数乱跳、数值虚高 | 无上拉 / 干扰 / 滤波太小 | 手转对比，看波形毛刺 | 加上拉，屏蔽接地，加大滤波系数 |
| 只朝一个方向计数 | A/B 接反或极性配置错 | 交换 A/B 试 | 改接线或软件取反 |
| 高速时计数偏少 | 滤波过大吃掉窄脉冲 | 高速下对比理论值与实测值 | 降低滤波系数 |
| 低速转速抖动大 | M 法量化误差 | 核算窗口内计数量 | 加长采样周期或换测速法 |
| 定位反复震荡 | Kp 过大 / 机械间隙 | 减小 Kp 观察 | 降增益，加死区，检查机械 |
| 启动冲击大 | 无软启动 / 积分饱和 | 看启动瞬间占空比 | 加斜坡，做积分限幅 |
| 低速爬行不转 | 死区未补偿 | 逐步加占空比找启动点 | 加死区补偿，补偿量略小于死区 |
6.3 几个容易被忽略但很致命的细节
中断优先级。编码器读取和 PID 运算放在定时中断里，这个中断的优先级要高于串口、按键这类非实时任务，但不要设成最高——留一档给紧急保护（比如过流检测），否则保护响应不及时。另外，如果用了 RTOS，控制中断不要被临界区长时间屏蔽，临界区里少干重活。
计数器读取的原子性。前面提过一次，这里再强调：如果定时中断和主循环都会读计数器，且中间可能被更高优先级中断打断，那么“读计数、更新上次值、累加总量”这三步必须作为一个整体，要么关中断，要么只在一个上下文里做。我见过因为这个问题导致位置偶尔跳变几百个计数的案例，查了两天才定位到。
电源的干净程度。编码器供电最好独立一路 LDO，或者至少加 LC 滤波。电机启停瞬间的电流冲击会通过共用的 3.3V 拉低电压，编码器内部比较器误判，输出假脉冲。这个故障很隐蔽，因为只在电机启停的瞬间发生，用普通示波器不容易抓到，得用触发模式盯着看。
温度与线数的一致性。光电编码器的码盘在高温下可能形变，长期运行后线数会有微小变化；磁电编码器对磁铁退磁敏感。如果项目要在宽温区工作，编码器选型时要看温度指标，别只看分辨率。
提示：调试阶段建议在代码里留一个“原始计数直出”模式，通过串口把每周期计数打印出来，人眼扫一遍就能发现跳变和方向错误。这个开关在量产固件里关掉，但保留代码，以后现场出问题可以临时打开。
最后分享一个我在实际项目里养成的习惯：每次接手一个新电机，第一件事不是写控制代码，而是先把编码器接上，用手转、用低速转、用额定转速转，把三个状态下的计数和波形都记录下来，做成一张基线表。后面调 PID 的时候，任何异常现象都可以拿回来和基线对比——是控制参数的问题，还是反馈本身出了问题，一眼就能分清。这个动作花半小时，能省下后面好几天的瞎猜。控制这件事，本质上就是把不确定的东西一个个变成确定的，反馈可信了，剩下的事情才有意义。
