1. 从零开始为什么你的电机控制项目需要AB相编码器大家好我是老李在电机控制和嵌入式这块摸爬滚打了十几年。今天咱们不聊那些虚的直接上干货。很多朋友在做小车、机械臂或者无人机云台这类需要精准位置和速度控制的项目时都会遇到一个核心问题我怎么知道电机此时此刻到底转了多少圈、速度有多快答案就是编码器。而AB相增量式编码器可以说是这个领域里性价比最高、应用最广泛的“眼睛”。你可能已经选好了主控比如我们今天要聊的GD32E103性能不错价格也香非常适合作为电机控制器的核心。硬件上你也买好了那个带着一圈光栅盘和光电传感器的“光编码器”它输出两路相位差90度的方波信号这就是AB相。但问题来了信号有了怎么让GD32这颗“大脑”读懂它呢靠普通的GPIO中断去数脉冲实测下来速度一快就丢脉冲CPU还被占得死死的根本没法干别的活。这时候就得请出芯片里的“硬件外挂”——定时器Timer的编码器接口模式。这个模式牛在哪它完全由硬件自动计数CPU几乎零干预。无论电机正转反转它都能通过识别AB两相的先后顺序自动加减计数而且计数频率可以非常高轻松应对高速旋转。你只需要正确配置一次之后就可以随时去读取一个寄存器的值那个值就是当前的位置信息。省心、精准、不占资源这就是为什么我们必须掌握这个配置。所以这篇文章我就以GD32E103和常见的AB相光编码器为例手把手带你走通整个配置流程。我会把官方手册里那些分散的、晦涩的寄存器说明结合我实际调试中踩过的坑揉碎了讲给你听。目标只有一个让你看完就能用用了就能成。2. 硬件连接与思想准备别在第一步就埋雷在动手写代码之前咱们得先把硬件理清楚。这一步看似简单但很多诡异的问题根源都在这儿。2.1 引脚映射你的编码器信号该接到哪里GD32E103的定时器功能引脚不是随便哪个GPIO都行的它由芯片内部设计固定在了某些特定的引脚上这叫做“复用功能”。以常用的高级定时器TIMER1为例它的两个编码器输入通道CH0和CH1默认可能是在PA8和PA9上。但你的板子布局可能把这两个引脚用作其他用途了比如串口通信。怎么办GD32提供了强大的“引脚重映射”功能。这就像公司里的座位表默认小张坐A01但今天A01的网线坏了管理员可以启动“重映射”规则把小张临时安排到B05去办公而且B05的电脑功能外设和A01一模一样。在我们的场景里我们想把TIMER1的CH0和CH1映射到PB3和PA15这两个引脚上。查看数据手册的“复用功能重映射”章节你会发现需要操作一个叫GPIO_TIMER1_FULL_REMAP或类似具体名称以芯片型号为准的配置。这里第一个坑就来了重映射通常不是单独控制某一个引脚的它是一组规则。你启用了FULL_REMAP可能PA8和PA9就不再是定时器功能了整个定时器的所有通道引脚都会搬到另一组预备好的“备用位置”上。所以你必须根据数据手册的表格完整地规划好所有你需要的定时器引脚确保它们重映射后不会冲突。接线时请务必确认编码器的A相、B相信号线分别连接到了你配置的CH0和CH1对应的GPIO引脚上。电源和地线也要接稳编码器一般需要3.3V或5V供电。硬件连接稳了软件世界才有根基。2.2 理解正交解码硬件是如何数脉冲的咱们花两分钟搞懂核心原理这样配置寄存器时你才知道自己在干什么。想象一下AB两相方波它们形状一样但B相波形总是比A相延迟或提前四分之一个周期90度相位差。当电机正转时可能是“A相上升沿到来时B相是低电平”反转时则变成“A相上升沿到来时B相是高电平”。定时器的编码器模式内部就是一个可以向上/向下计数的计数器它实时监测A、B两个通道的边沿上升沿和下降沿并根据两个通道的电平组合关系自动判断方向从而决定计数器是加1还是减1。GD32通常支持三种编码器模式具体看参考手册模式1仅在A相TI1的边沿计数根据B相TI2的电平决定方向。模式2仅在B相TI2的边沿计数根据A相TI1的电平决定方向。模式3在A相和B相的所有边沿都计数。这是分辨率最高的模式因为一个脉冲周期内A、B相各有上升沿和下降沿总共4个边沿所以计数频率是信号频率的4倍这叫“4倍频”。我们通常追求高精度所以模式3是最常用的。理解了这个后面看到TIMER_ENCODER_MODE3这个参数你就知道它意味着“4倍频最高精度模式”。3. 代码逐行深挖配置流程与避坑指南好了理论热身完毕咱们打开IDE开始写代码。我会用代码加超详细注释的方式带你过一遍。下面的代码基于GD32标准外设库思路也适用于HAL库。void Encoder_Init_TIM1(void) { // 首先定义几个配置结构体。GD32的库函数喜欢用结构体来传递一堆参数比直接怼寄存器友好。 timer_parameter_struct timer_initpara; timer_ic_parameter_struct timer_icinitpara; // 第一步打开时钟总线不给电啥都干不了。 rcu_periph_clock_enable(RCU_AF); // 必须开启复用功能时钟重映射功能才生效 rcu_periph_clock_enable(RCU_TIMER1); // 开启TIMER1的时钟 rcu_periph_clock_enable(RCU_GPIOA); // 开启GPIOA时钟 rcu_periph_clock_enable(RCU_GPIOB); // 开启GPIOB时钟 // 第二步配置GPIO引脚为复用推挽输出模式。 // 注意虽然我们是“输入”捕获但引脚要配成“复用推挽输出”模式。这是STM32/GD32架构的特点 // 当引脚被映射给片上外设如定时器时就由外设全权接管其输入输出配置为此模式最稳妥。 gpio_init(GPIOA, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_15); gpio_init(GPIOB, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_3); // 第三步关键一步引脚重映射。 // 将TIMER1的完整功能映射到新的引脚组。执行这句后TIMER_CH0和CH1就对应到PB3和PA15了。 // 务必核对数据手册确认这个重映射常量在你的芯片型号中正确定义。 gpio_pin_remap_config(GPIO_TIMER1_FULL_REMAP, ENABLE);上面是初始化和引脚配置。接下来配置定时器基础参数这里有几个巨坑我当年调试时在这里卡了大半天。// 第四步复位并初始化定时器基本参数。 timer_deinit(TIMER1); // 先复位TIMER1让它恢复到默认状态避免之前残留配置干扰 timer_struct_para_init(timer_initpara); // 库函数把结构体所有成员设成默认值好习惯 // 开始填充参数。注意在编码器模式下下面有些参数是“无效”或“被覆盖”的但我们必须按规矩填。 timer_initpara.prescaler 0; // 预分频器。编码器模式下通常设为0不分频因为时钟源是外部编码器信号。 timer_initpara.alignedmode TIMER_COUNTER_EDGE; // 对齐模式边缘对齐即可。 timer_initpara.counterdirection TIMER_COUNTER_UP; // 计数方向。这里设“向上”但没关系编码器模式会覆盖它。 timer_initpara.period 65535; // 自动重装载值ARR。这是第二个大坑 timer_initpara.clockdivision TIMER_CKDIV_DIV1; // 时钟分频与输入滤波有关通常DIV1。 timer_initpara.repetitioncounter 0; // 重复计数器高级定时器才有基本定时器忽略。 timer_init(TIMER1, timer_initpara);重点讲一下periodARR这个坑。这个值设定了计数器的上限。当计数器达到这个值后再收到一个计数脉冲会怎样默认会溢出归零或根据配置处理。对于编码器如果你电机的旋转圈数对应的脉冲数可能超过6553516位定时器的最大值你就必须处理溢出。有两种思路设置ARR为最大值65535然后在定时器溢出中断里用一个软件变量比如int32_t的overflow_count来记录溢出次数。最终位置 overflow_count * 65536 timer_counter。这种方法能获得极大的计数范围。如果你能确定电机单方向连续旋转的圈数不会导致脉冲数超过ARR可以将其设为一个安全值。但通常选第一种更保险。接下来配置输入捕获通道这是告诉定时器如何“看”A、B相的信号。// 第五步配置输入捕获通道参数。 timer_channel_input_struct_para_init(timer_icinitpara); // 初始化输入捕获结构体 // 配置输入通道0对应A相。这里参数在编码器模式下也会部分被覆盖但滤波和分频设置是起作用的。 timer_icinitpara.icpolarity TIMER_IC_POLARITY_RISING; // 极性。编码器模式下通常要求“双边沿”这里先随意设后面会被覆盖。 timer_icinitpara.icselection TIMER_IC_SELECTION_DIRECTTI; // 选择直接连接到TI引脚即CH0连到TI1 timer_icinitpara.icprescaler TIMER_IC_PSC_DIV1; // 输入捕获预分频不分频每个有效边沿都捕获。 timer_icinitpara.icfilter 0x0; // 输入滤波器值。这是防抖关键后面细说。 timer_input_capture_config(TIMER1, TIMER_CH_0, timer_icinitpara); // 配置输入通道1对应B相。注意icselection 要设为 TIMER_IC_SELECTION_INDIRECTTI // 表示CH1映射到TI2输入上。这是固定搭配必须这样设置否则编码器模式无法正确识别相位。 timer_icinitpara.icselection TIMER_IC_SELECTION_INDIRECTTI; timer_input_capture_config(TIMER1, TIMER_CH_1, timer_icinitpara);输入滤波器icfilter是个非常重要的参数。编码器是物理器件信号在跳变时可能会有毛刺抖动。如果硬件滤波没做好这些毛刺会被定时器当成多个边沿导致计数错误。icfilter是一个数字滤波器它要求信号稳定连续N个采样周期不变才认为是一个有效边沿。值越大滤波效果越强但延迟也越大。对于光电编码器如果信号质量好可以设为0或1如果环境干扰大或电机启停瞬间有抖动可以设为3~5。具体需要根据信号质量和电机最高转速来权衡。我建议一开始可以设为3功能稳定后再尝试调低。最后也是最核心的一步开启编码器模式。// 第六步使能编码器接口模式。 // 参数1定时器。 // 参数2编码器模式。TIMER_ENCODER_MODE3 表示在TI1和TI2的所有边沿计数4倍频。 // 参数3TI1A相的极性。TIMER_IC_POLARITY_BOTH_EDGE 表示上升沿和下降沿都有效。 // 参数4TI2B相的极性。同样设为双边沿。 timer_quadrature_decoder_mode_config(TIMER1, TIMER_ENCODER_MODE3, TIMER_IC_POLARITY_BOTH_EDGE, TIMER_IC_POLARITY_BOTH_EDGE); // 第七步使能自动重装载预装载缓冲。建议使能可以避免在更新ARR时产生毛刺。 timer_auto_reload_shadow_enable(TIMER1); // 第八步万事俱备启动定时器 timer_enable(TIMER1); }配置完成后TIMER1的计数器TIMER_CNT寄存器就会随着编码器的旋转实时变化了。正转增加反转减少。4. 数据读取与进阶处理让你的编码器真正有用配置成功只是第一步怎么把计数器的值变成有意义的“速度”和“位置”才是工程应用的关键。4.1 位置获取与溢出处理读取位置最简单current_count timer_counter_read(TIMER1);。但别忘了我们前面提到的溢出问题。如果你设置了ARR65535并且允许溢出就必须开启定时器更新中断溢出中断。// 在初始化函数里添加中断配置 nvic_irq_enable(TIMER1_IRQn, 0, 0); // 使能TIMER1全局中断 timer_interrupt_enable(TIMER1, TIMER_INT_UP); // 使能更新中断 // 在中断服务函数里 void TIMER1_IRQHandler(void) { if(timer_interrupt_flag_get(TIMER1, TIMER_INT_FLAG_UP) ! RESET) { timer_interrupt_flag_clear(TIMER1, TIMER_INT_FLAG_UP); // 清除中断标志 if(timer_counter_get(TIMER1) 32768) { // 粗略判断方向正溢出 encoder_overflow_count; // 软件溢出计数器加 } else { // 负溢出 encoder_overflow_count--; // 软件溢出计数器减 } } }这样你的全局位置就是total_position (int64_t)encoder_overflow_count * 65536 current_count;。使用int64_t可以应对超长行程。4.2 速度计算M法与T法的选择速度计算是电机控制的核心。常用方法有M法测频法和T法测周法。M法适合中高速在固定的时间间隔T比如10ms内读取位置值的增量ΔP。那么速度v ΔP / T。单位是“脉冲数/秒”。这个方法在高速时精度高但在低速时ΔP可能很小甚至为0误差很大。实现起来很简单在定时中断里记录上次位置值做差即可。T法适合低速测量两个相邻脉冲之间的时间间隔Δt。那么速度v (1 / (4 * N)) / Δt其中N是编码器线数一圈的脉冲数。这个方法在低速时精度高但高速时定时器可能来不及测量。可以用定时器的输入捕获功能来测量脉冲周期但这会占用另一个定时器资源。在实际项目中我更喜欢用“M法低通滤波”。在固定的控制周期如1ms内计算速度v (current_position - last_position) / cycle_time。但这个原始速度值噪声很大尤其是当机械有微小抖动时。这时可以加入一个一阶低通数字滤波filtered_v 0.95 * filtered_v_last 0.05 * current_v_raw;。 系数可以根据实际效果调整0.95和0.05只是一个起点。滤波后得到的速度曲线会平滑很多非常适合用于PID速度环的反馈。4.3 抗干扰与滤波实战除了前面提到的输入数字滤波器软件上也要下功夫。软件去抖在读取计数器值函数中可以连续读取两次如果值相差过大超过在最大物理转速下可能产生的脉冲数则认为是干扰丢弃本次读数使用上次值。异常值剔除在速度计算后如果发现本次计算的速度值超过电机物理上绝对不可能达到的值比如你电机额定转速对应最大速度是1000 pulse/s算出来5000那么这肯定是由于计数错误比如漏脉冲或干扰脉冲引起的应该将其剔除或限幅。5. 调试技巧与性能优化少走弯路的经验谈代码写完了下载到板子电机一转发现读数不对别慌这是常态。分享几个我常用的调试“组合拳”。首先用示波器这是最重要的工具。直接测量连接到GD32引脚上的A、B相信号。看波形是否干净上升下降沿陡峭无毛刺看两相是否确实是90度相位差看电压幅值是否达到GD32识别的高电平门槛通常2V。硬件问题必须用硬件手段排除。其次利用GD32的引脚复用调试功能。如果暂时没有示波器可以软件模拟。先将配置为编码器输入的引脚临时改成普通推挽输出模式然后写一个简单程序让PA15和PB3轮流输出一个相位差90度的方波模拟编码器信号。再用另一段代码读取TIMER1的计数值。如果这个模拟信号能被正确计数说明你的软件配置基本正确问题可能出在外部编码器信号或硬件电路上。关于性能优化有两点值得注意计数频率与总线时钟编码器模式下的最大计数频率受限于定时器自身的输入时钟和滤波设置。GD32E103的定时器时钟通常来自APB总线最高可达108MHz。理论上在4倍频模式下能处理的编码器信号频率可以很高几十MHz远超过普通光电编码器的输出能力几百KHz到几MHz。所以性能瓶颈通常不在芯片而在编码器本身和你的滤波设置。滤波值设得太大可能会“滤掉”真实的高频脉冲导致高速时计数丢失。中断与实时性如果你开启了溢出中断中断服务函数一定要快清除标志、更新软件计数器然后立刻退出。不要在里面做复杂的计算或打印。速度计算和位置处理最好放在后台的主循环或更低优先级的定时器中断中完成。最后寄存器确实有点多但不要怕。GD32的标准外设库已经封装得很好了。当你遇到奇怪的问题比如计数方向反了、计数跳变不正常最终极的调试方法就是单步调试然后去查看那几个关键寄存器的值TIMERx_SMCFG从模式控制编码器模式配置在此、TIMERx_CHCTL0/1通道控制看极性、滤波设置、TIMERx_CNT计数器值。对照参考手册的位描述一点点核对总能找到原因。配置一次终身受益。这套代码框架你稍作修改改改引脚重映射和定时器编号就能应用到GD32的其他系列甚至STM32上。希望这份超详细的指南能帮你把电机控制的“眼睛”擦亮让项目跑得更稳更准。