电赛磁悬浮实战：STM32 HAL库与PID整定从零到稳定

1. 电赛选题背后的取舍：为什么磁悬浮是控制类赛题的“硬骨头”

电赛控制类题目里，磁悬浮装置几乎是每年都会被反复拿出来练手的一个经典项目。它看起来简单——一个线圈、一个霍尔传感器、一颗铁球，通电让球浮起来就完事了。但真正上手做过的人都知道，这东西从焊完板子到球能稳稳悬停，中间隔着的坑比想象中多得多。我前后做过三版磁悬浮，第一版用STM32F103C8T6最小系统板加HAL库，调了整整四天才让球勉强浮起来，而且抖得像筛糠；第二版换了驱动方案和传感器布局，稳定时间缩短到半天；第三版帮学弟做的时候，从裸板到稳定悬浮只用了三个小时。这篇文章就把这三版积累下来的经验完整拆开，从器件选型、HAL库配置、PID整定到实际调试中那些文档里不会写的细节，全部讲清楚。

先说为什么选STM32F103C8T6这颗芯片。电赛现场时间紧、任务重，选型的第一原则不是性能最强，而是“你最熟、资料最多、出问题最容易查”。F103C8T6是ARM Cortex-M3内核，72MHz主频，64KB Flash，20KB SRAM，对于磁悬浮这种需要一路ADC采样、一路PWM输出、一个PID运算循环的任务来说，资源绰绰有余。更重要的是它的生态——HAL库把底层寄存器操作封装得很完整，Keil MDK下的调试工具链成熟，DAPLink下载器便宜且稳定，网上能找到的参考代码和原理图铺天盖地。国产替代型号虽然引脚兼容，但在电赛这种不容出错的场景下，我个人的建议还是用原厂或者经过大量验证的批次，避免因为芯片本身的一致性差异引入额外变量。

磁悬浮的核心控制逻辑其实不复杂：霍尔传感器实时检测铁球位置，STM32通过ADC读取这个位置信号，和设定的目标位置做差得到误差，误差经过PID运算输出控制量，再通过PWM调节线圈电流，产生对应的电磁力把球拉到目标位置。整个系统是一个典型的闭环负反馈控制。但“不复杂”和“能做出来”之间，差的是对每一个环节的精确把控。线圈的电磁力与电流的关系是非线性的，霍尔传感器的输出有噪声，PID参数稍微激进一点系统就振荡，稍微保守一点球就吸上去或者掉下来。这些细节，才是决定成败的关键。

这篇文章适合正在准备电赛控制类题目的同学，也适合想通过一个完整项目来学习STM32 HAL库开发和PID控制的嵌入式初学者。我会从硬件选型和电路搭建讲起，然后深入HAL库的配置细节，接着是PID算法的实现和整定方法，最后重点讲调试过程中遇到的典型问题和解决思路。每一部分都会给出具体的参数、代码和操作步骤，尽量做到看完就能复现。

2. 硬件选型与电路搭建：那些原理图上不会标注的细节

2.1 线圈驱动方案的选择与对比

磁悬浮的线圈驱动是整个系统的执行机构，它的响应速度和线性度直接决定了控制效果。我试过三种驱动方案，这里把各自的优缺点和适用场景列出来。

我最终选用的是IRF540N N沟道MOS管配合SS34肖特基续流二极管。IRF540N的导通电阻只有44毫欧，最大电流33A，对于磁悬浮线圈通常几百毫安到一两安的电流来说余量充足。续流二极管的作用是在MOS管关断瞬间为线圈电流提供泄放回路，防止反向电动势击穿MOS管。这个二极管不能省，我第一版就是因为省了它，烧了两颗MOS管才反应过来。

PWM频率的选择也有讲究。频率太低，线圈电流纹波大，球会跟着抖动；频率太高，MOS管的开关损耗增加，而且HAL库的PWM分辨率会下降。经过实测，20kHz到30kHz是比较合适的区间。我最终定在25kHz，此时STM32F103的72MHz主频下，PWM分辨率为72M/25k=2880级，足够精细。在CubeMX里配置TIM1的CH1为PWM Generation模式，Prescaler设为0，Counter Period设为2879，这样得到的PWM频率就是72MHz/(0+1)/(2879+1)=25kHz。

2.2 霍尔传感器的选型与线性化处理

位置检测是磁悬浮的反馈环节，传感器的精度和线性度直接影响控制效果。常用的方案有线性霍尔传感器（如SS49E、A1321）和红外对管。红外对管受环境光影响大，而且铁球表面反光特性不一致，容易引入干扰，所以我推荐用线性霍尔传感器。

SS49E的输出电压与磁场强度呈近似线性关系，但实际使用中有两个问题需要注意。第一，它的输出范围大约在0.5V到4.5V之间，而STM32的ADC参考电压是3.3V，所以需要做分压或者选择输出范围更合适的型号。我用的A1321输出范围是0.5V到4.5V，同样需要分压。第二，霍尔传感器的输出存在零点漂移和温漂，需要在软件中做校准。

我的做法是在系统上电时先做一次零点校准：让线圈不通电，铁球放在远离传感器的位置，读取此时ADC的值作为“无球参考值”；然后把铁球放在目标悬浮位置，读取ADC值作为“目标参考值”。这两个值在后续的PID运算中作为基准。实际运行时，ADC读取的实时值减去无球参考值，再除以目标参考值与无球参考值的差，就得到了归一化的位置误差。这样处理之后，不同传感器之间的个体差异和温漂影响都被大幅削弱。

分压电路的设计也要注意。A1321输出最大4.5V，要降到3.3V以下，分压比至少是4.5/3.3=1.36。我用了10k和20k的电阻分压，分压比是20/(10+20)=0.667，4.5V分压后是3.0V，留了0.3V的余量。分压电阻的精度建议用1%的金属膜电阻，普通碳膜电阻的温漂会影响长期稳定性。

2.3 电源方案与退耦电容的布置

磁悬浮系统的电源噪声是导致球抖动的一个重要原因。线圈在PWM驱动下会产生大量的高频噪声，这些噪声会通过电源线传导到STM32和霍尔传感器，导致ADC采样值跳动。我的解决方案是三级退耦：在线圈驱动电路的电源输入端并联一个470uF的电解电容和一个0.1uF的陶瓷电容，在STM32的电源引脚附近放置0.1uF和10uF的退耦电容，在霍尔传感器的电源引脚附近放置0.1uF的陶瓷电容。

电源本身建议用线性电源或者质量好的开关电源。我试过用便宜的开关电源，纹波达到200mV，球抖得根本停不下来。换成线性电源后纹波降到20mV以下，效果立竿见影。如果手头只有开关电源，可以在电源输出端加一个LC滤波电路，电感用100uH，电容用1000uF，能把纹波压到可接受的范围。

3. HAL库配置与工程搭建：CubeMX里那些容易忽略的选项

3.1 时钟树配置与ADC采样时间的计算

用CubeMX配置STM32F103C8T6的时钟树时，外部晶振选8MHz，PLL倍频到72MHz。ADC的时钟不能超过14MHz，所以ADC预分频器要选6分频，得到12MHz的ADC时钟。这个细节很多人会忽略，如果ADC时钟超频，采样值会不稳定，表现为球的位置反馈信号跳动。

ADC的采样时间设置也很关键。STM32F103的ADC采样时间可选1.5、7.5、13.5、28.5、41.5、55.5、71.5、239.5个ADC时钟周期。采样时间越长，采样值越稳定，但转换速度越慢。磁悬浮的控制周期通常在1ms到5ms之间，ADC转换时间远小于这个周期，所以可以选较长的采样时间来提高稳定性。我选的是71.5周期，加上12.5周期的转换时间，总转换时间约84个ADC时钟周期，在12MHz下约7us，完全满足要求。

ADC的参考电压选择也要注意。STM32F103C8T6的VREF+引脚默认接VDDA，也就是3.3V。如果电源纹波较大，VREF+也会跟着波动，导致ADC读数不准。可以在VREF+引脚附近加一个0.1uF的陶瓷电容和一个10uF的钽电容来滤波。另外，ADC的输入阻抗和采样时间要匹配，霍尔传感器经过分压后的输出阻抗大约是6.7k（10k和20k并联），在71.5周期的采样时间下，采样电容能够充分充电，不会引入额外的误差。

3.2 PWM输出的配置与死区时间

TIM1的CH1配置为PWM Generation模式，Mode选PWM Mode 1，Pulse初始值设为0。这里有一个容易踩的坑：如果Pulse设为0，而GPIO又配置成了复用推挽输出，上电瞬间MOS管可能会误导通。我的做法是在初始化完成后先调用HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1)，然后把Pulse设为0，再使能MOS管的驱动电路。或者在硬件上用一个下拉电阻把MOS管的栅极拉到地，确保上电时MOS管是关断的。

死区时间在单管驱动中不需要设置，但如果用半桥或者全桥驱动，死区时间就很重要了。磁悬浮通常用单管驱动加续流二极管，所以不需要死区。但如果你的线圈电流较大，用半桥驱动可以更好地控制电流方向，这时候死区时间要设置在1us左右，防止上下管直通。

PWM的初始频率和占空比要根据线圈的参数来定。线圈的电感量通常在几毫亨到几十毫亨之间，电阻在几欧到几十欧之间。在25kHz的PWM频率下，线圈的阻抗主要是感抗，电流纹波较小。占空比的初始值设为0，让球在重力作用下落在底部，然后PID运算逐渐增加占空比，把球拉起来。

3.3 中断优先级与控制周期的确定

磁悬浮的控制周期决定了系统的响应速度。周期太长，球的位置变化来不及响应，会振荡；周期太短，PID运算和ADC采样占用过多CPU时间，而且噪声的影响会被放大。经过实测，1ms到2ms的控制周期比较合适。我最终用的是1ms，用TIM2的更新中断来触发。

中断优先级的配置要注意：ADC采样中断和PWM更新中断的优先级要合理设置。如果ADC采样在中断中进行，ADC中断的优先级要高于定时器中断，确保采样值是最新的。如果ADC用DMA传输，DMA的优先级也要设置好。我的做法是用TIM2的更新中断触发ADC采样，ADC转换完成后触发DMA把数据搬到内存，然后在TIM2中断中读取DMA搬运后的数据做PID运算。这样ADC采样和PID运算在同一个中断中完成，时序确定，不会出现采样值滞后的情况。

HAL库的中断处理函数中，要尽量精简代码，避免浮点运算和耗时操作。PID运算中的浮点乘法在72MHz的M3内核上没有硬件FPU，一次浮点乘法大约需要几十个时钟周期，1ms的控制周期下完全来得及，但如果中断中还有其他耗时操作，就可能超时。我的做法是把PID运算放在中断中，但把一些非实时的操作（比如OLED显示更新、串口打印）放在主循环中，通过标志位来同步。

4. PID算法的实现与整定：从抖动到稳定的完整过程

4.1 位置式PID与增量式PID的选择依据

PID算法有两种常见实现：位置式PID和增量式PID。位置式PID的输出直接对应控制量的绝对值，增量式PID的输出是控制量的增量。对于磁悬浮来说，我推荐用位置式PID，原因是位置式PID的输出直接对应PWM占空比，物理意义明确，整定参数时更容易理解每个参数的作用。

位置式PID的离散化公式是：

u(k) = Kp * e(k) + Ki * Σe(i) + Kd * [e(k) - e(k-1)]

其中e(k)是当前误差，Σe(i)是历史误差的累加，e(k)-e(k-1)是误差的变化率。在代码实现中，积分项需要做限幅，防止积分饱和。积分饱和是磁悬浮调试中最常见的问题之一：当球被吸到线圈上时，误差持续为负，积分项不断累加，导致输出饱和在最大值；当球掉下来时，积分项需要很长时间才能降下来，系统响应变得迟钝。我的做法是把积分项限幅在输出范围的±30%以内，同时当输出饱和时停止积分累加。

增量式PID的公式是：

Δu(k) = Kp * [e(k) - e(k-1)] + Ki * e(k) + Kd * [e(k) - 2e(k-1) + e(k-2)]

增量式PID不需要累加历史误差，积分饱和的风险较小，但输出的物理意义不如位置式直观。对于初学者来说，位置式PID更容易理解和调试。我第一版用的就是位置式PID，虽然遇到了积分饱和的问题，但通过限幅解决了。

4.2 参数整定的实操步骤与经验值

PID参数整定是磁悬浮调试中最耗时的环节。我总结了一套“三步法”，在实际操作中比较有效。

第一步，先整定Kp。把Ki和Kd设为0，从小到大增加Kp，直到球开始出现等幅振荡。记录此时的Kp值，称为临界增益Ku。然后根据Ziegler-Nichols经验公式，Kp取0.6Ku，Ki取2Kp/Tu，Kd取Kp*Tu/8，其中Tu是振荡周期。但Z-N公式给出的参数通常比较激进，实际使用时我会把Kp再降低20%到30%，让系统有足够的稳定裕度。

第二步，加入Ki消除稳态误差。Ki的作用是消除稳态误差，但过大的Ki会导致系统振荡。我的经验是Ki取Kp的1/100到1/50之间。比如Kp=50，Ki取0.5到1.0。加入Ki后，观察球是否能稳定在目标位置。如果球在目标位置附近缓慢漂移，说明Ki太小；如果球出现低频振荡，说明Ki太大。

第三步，加入Kd抑制超调。Kd的作用是预测误差的变化趋势，提前给出反向控制量，抑制超调。Kd太大会放大噪声，导致球高频抖动；Kd太小则超调明显。我的经验是Kd取Kp的1/10到1/5之间。比如Kp=50，Kd取5到10。加入Kd后，球的响应会变得更“干脆”，超调明显减小。

我最终使用的参数是Kp=45，Ki=0.8，Kd=6，控制周期1ms。这个参数下，球从底部被拉到目标位置大约需要0.5秒，超调量约10%，稳定后位置波动在±0.5mm以内。当然，不同的线圈、传感器和机械结构对应的参数会有所不同，这套参数只能作为起点，具体还需要根据实际系统微调。

4.3 积分限幅与微分滤波的代码实现

积分限幅和微分滤波是保证PID稳定运行的两个关键细节。积分限幅的代码实现如下：

typedef struct { float Kp; float Ki; float Kd; float integral; float prev_error; float integral_max; float output_max; float output_min; } PID_TypeDef; float PID_Compute(PID_TypeDef *pid, float error) { float output; float derivative; // 积分项累加 pid->integral += error; // 积分限幅 if (pid->integral > pid->integral_max) { pid->integral = pid->integral_max; } else if (pid->integral < -pid->integral_max) { pid->integral = -pid->integral_max; } // 微分项计算 derivative = error - pid->prev_error; // PID输出 output = pid->Kp * error + pid->Ki * pid->integral + pid->Kd * derivative; // 输出限幅 if (output > pid->output_max) { output = pid->output_max; } else if (output < pid->output_min) { output = pid->output_min; } pid->prev_error = error; return output; }

微分滤波是为了抑制噪声对微分项的影响。霍尔传感器的输出噪声经过微分后会被放大，导致球高频抖动。我的做法是对微分项做一阶低通滤波：

// 微分项低通滤波 float derivative_raw = error - pid->prev_error; pid->derivative_filtered = pid->alpha * derivative_raw + (1 - pid->alpha) * pid->derivative_filtered;

其中alpha是滤波系数，取0.1到0.3之间。alpha越小，滤波效果越强，但微分项的响应也越慢。我最终取的是0.2，在抑制噪声和保持响应速度之间取得了平衡。

5. 调试过程中遇到的典型问题与排查思路

5.1 球吸上去不下来的原因分析

球被吸到线圈上不下来，是磁悬浮调试中最常见的问题。原因通常有三个：PID输出饱和、积分饱和、或者机械结构问题。

PID输出饱和是指PID计算出的输出值超过了PWM的最大占空比，导致线圈一直以最大电流工作。这种情况下，球会被吸到线圈上。排查方法是观察PID的输出值，如果它一直卡在最大值，说明Kp或者Ki太大，需要减小。我的做法是在代码中加一个调试变量，通过串口把PID的输出值打印出来，实时观察。

积分饱和是指积分项累加到很大值，即使误差已经反向，积分项仍然很大，导致输出无法及时反向。排查方法是观察积分项的值，如果它一直卡在限幅值上，说明积分限幅设置得太宽松，或者Ki太大。我的做法是把积分限幅收紧到输出范围的±20%，同时当输出饱和时停止积分累加。

机械结构问题包括线圈和铁球的距离太近、铁球太重、线圈匝数太少等。如果线圈在最大电流下产生的电磁力仍然大于铁球的重力，球就会被吸上去。解决方法是增加线圈和铁球的距离，或者换用更轻的铁球，或者增加线圈匝数。我第一版用的铁球是10mm直径的钢球，重约4克，线圈是500匝，在1A电流下产生的电磁力刚好能平衡重力。后来换成8mm的钢球，重约2克，控制起来容易很多。

5.2 球持续抖动的噪声来源与抑制

球持续抖动是另一个常见问题。抖动的原因可能是传感器噪声、电源噪声、PID参数不当、或者机械共振。

传感器噪声是最常见的原因。霍尔传感器的输出噪声经过ADC采样后进入PID运算，导致输出抖动。排查方法是用示波器观察霍尔传感器的输出波形，如果看到明显的高频噪声，说明需要加滤波。我的做法是在霍尔传感器的输出端加一个RC低通滤波电路，截止频率设在1kHz左右，同时在软件中对ADC采样值做滑动平均滤波。

电源噪声是第二常见的原因。线圈的PWM驱动会在电源线上产生高频噪声，传导到STM32和霍尔传感器。排查方法是用示波器观察电源线上的纹波，如果纹波超过50mV，说明需要加强退耦。我的做法是在线圈驱动电路的电源输入端并联470uF电解电容和0.1uF陶瓷电容，在STM32和霍尔传感器的电源引脚附近也加退耦电容。

PID参数不当也会导致抖动。Kp太大或者Kd太大都会导致高频抖动。排查方法是先把Kd设为0，观察抖动是否消失。如果消失，说明是Kd太大；如果仍然抖动，说明是Kp太大或者噪声问题。

机械共振是指线圈和铁球之间的机械结构在某些频率下产生共振，导致球抖动。排查方法是改变控制周期，如果抖动频率跟着控制周期变化，说明是控制系统的问题；如果抖动频率不变，说明是机械共振。解决方法是增加机械结构的阻尼，或者改变线圈的安装方式。

5.3 不同铁球重量下的参数适配

铁球的重量直接影响PID参数的选择。较重的铁球需要更大的Kp和Ki来提供足够的电磁力，但同时也需要更大的Kd来抑制超调。较轻的铁球则相反，Kp和Ki可以小一些，Kd也可以小一些。

我做过一个对比实验：用4克和2克两种铁球，分别整定PID参数。4克铁球的参数是Kp=60，Ki=1.2，Kd=8；2克铁球的参数是Kp=40，Ki=0.6，Kd=5。可以看出，铁球越重，Kp和Ki越大，Kd也越大。这是因为较重的铁球惯性大，需要更大的控制量来驱动，同时也需要更大的阻尼来抑制超调。

在实际操作中，如果更换了铁球，建议重新整定PID参数，不要直接套用之前的参数。整定的方法还是“三步法”：先整定Kp，再加入Ki，最后加入Kd。每次只调整一个参数，观察系统的响应，逐步逼近最优值。

6. 从能浮起来到浮得稳：进阶优化与经验总结

6.1 串级PID的引入时机与效果

单级PID在大多数情况下已经能让球稳定悬浮，但如果对稳定性要求更高，或者系统存在较大的非线性，可以考虑引入串级PID。串级PID是在位置环外面再套一个电流环或者速度环，内环的响应速度比外环快，能够更快地抑制扰动。

对于磁悬浮来说，电流环的作用是让线圈电流快速跟踪位置环的输出。线圈的电流响应速度受电感的影响，如果电感较大，电流的响应会滞后，导致位置环的控制效果变差。加入电流环后，位置环的输出作为电流环的给定，电流环通过调节PWM占空比让线圈电流快速跟踪给定值，从而改善位置环的控制效果。

电流环的实现需要在电路中增加一个电流采样电阻，用ADC读取采样电阻上的电压，得到线圈电流。电流环的PID参数整定方法和位置环类似，但控制周期要更短，通常在100us到500us之间。我试过加入电流环，位置环的Kp可以从45提高到80，系统的响应速度明显加快，抗扰动能力也更强。但电流环的调试比位置环更复杂，需要额外的硬件电路和ADC通道，对于电赛来说，如果时间紧张，单级PID已经足够。

6.2 基于HAL库的调试技巧与工具链

HAL库的调试工具链中，我最常用的是串口打印和Keil的Debug模式。串口打印可以把PID的中间变量（误差、积分项、微分项、输出值）实时发送到电脑，用串口示波器软件（如SerialPlot）绘制曲线，直观地观察系统的响应。Keil的Debug模式可以设置断点、查看变量、单步执行，适合排查逻辑错误。

Keil的Debug模式下有一个很实用的功能：逻辑分析仪（Logic Analyzer）。它可以把变量的值以波形的方式显示出来，不需要额外的硬件。我经常用逻辑分析仪观察PID的输出值和ADC采样值，判断系统的响应是否符合预期。使用方法是进入Debug模式后，打开Logic Analyzer窗口，添加要观察的变量，设置好采样频率，然后运行程序。

还有一个技巧是用DAPLink的虚拟串口功能。DAPLink下载器除了下载程序外，还可以通过虚拟串口和STM32通信，省去了额外的USB转串口模块。在CubeMX中配置USART1的引脚为PA9和PA10，然后在电脑上安装DAPLink的虚拟串口驱动，就可以用串口助手和STM32通信了。

6.3 电赛现场的时间分配与应急预案

电赛现场的时间通常很紧张，四天三夜要做完硬件、软件、调试和报告。我的时间分配建议是：第一天完成硬件搭建和CubeMX工程配置，第二天完成PID算法和基本调试，第三天进行参数整定和优化，第四天写报告和准备答辩。

应急预案方面，最重要的是准备备用方案。如果磁悬浮调试不顺利，要有一个能演示的保底方案。我的做法是在调试初期就把球能浮起来作为第一个里程碑，哪怕浮得不稳，只要能浮起来，就有保底分数。然后再逐步优化稳定性。如果时间实在不够，可以把PID参数调得保守一些，让球浮得稳但响应慢，总比球一直抖或者吸上去要好。

另外，代码的版本管理也很重要。每调好一个版本，就把代码备份一份，标注好参数和现象。这样如果后续调乱了，可以快速回退到之前的版本。我通常用文件夹加日期的方式管理版本，比如“v1_球能浮起来_20240501”、“v2_球稳定_20240502”，简单有效。

6.4 从磁悬浮项目中学到的通用控制思路

磁悬浮项目虽然小，但涉及的控制思路是通用的。闭环控制的核心是“检测-比较-调整”三个环节，任何一个环节出问题，系统都无法稳定。检测环节要保证传感器的精度和抗干扰能力，比较环节要保证误差计算的准确性，调整环节要保证执行机构的响应速度和线性度。

PID参数整定的“三步法”也是通用的：先整定比例项，让系统有基本的响应能力；再加入积分项，消除稳态误差；最后加入微分项，抑制超调。这个顺序不能乱，因为每个参数的作用不同，同时调整多个参数会让人无法判断哪个参数在起作用。

最后，调试过程中最重要的心态是“耐心”。磁悬浮的调试不是一蹴而就的，需要反复观察、分析、调整。我第一版调了四天，第二版调了半天，第三版调了三个小时，不是因为第三版的技术有多先进，而是因为前两版积累的经验让我知道问题出在哪里，知道下一步该调什么。这种“知道下一步该做什么”的能力，才是电赛中最宝贵的收获。