企业官网建设流程全解析

简介：这是一份基于STM32F103的下推式磁悬浮工程资料包，面向嵌入式学习者、电子设计爱好者以及参与智能硬件设计的学生。压缩包内包含一套完整且清晰的电路原理图工程文件、物料清单、C语言源码及大量编译中间文件，共计239个文件，压缩后大小约4MB。其中，原理图与物料清单用于电路搭建和元件核对，C源码及相关文件则覆盖初始化流程、传感器数据读取、PID控制算法和驱动信号生成等关键内容，能够帮助读者理解磁悬浮系统的稳定控制原理。目前该资源已有2950人次学习下载。通过研读这份资料，可以掌握下推式磁悬浮的设计思路，包括电磁场检测、功率驱动、反馈控制与整体调试方法，同时也可以作为基于STM32F103的嵌入式系统开发参考，具有较高的工程参考价值与实用性。

1. 下推式磁悬浮的stm32f103实现：这份资料到底能做什么

我调试下推式磁悬浮的时候，最怕的就是浮子刚上电就飞出去。你盯着霍尔传感器数据，数值是对的，PID参数也按教程设了，可它就是挂不住。后来才发现是线圈极性反了，PWM输出刚好越推越远。这就是 stm32f103 磁悬浮这类资源的核心价值：不能只看概念，得有一份能直接烧录、能复现的完整图纸和代码。磁悬浮stm32.rar就是干这个的。

这份资源解决了从原理图到软件落空的中间地带——它不教你电磁学，而是给你一条可以直接走通的路径：霍尔传感器读浮子位置，stm32f103 做 PID，PWM 驱动线圈，最后让一个永磁体稳定悬停。适合手里有基础硬件、想快速跑通闭环的人，也适合准备电子设计作品、需要在一个周末内看到稳定悬浮效果的人。

读完之后你会发现，难点不在 PID 公式，而在传感器方向、PWM 频率、限幅和积分饱和这些细节。下面我会按原理、源码、硬件、调参和踩坑的顺序拆开讲。

2. 下推式磁悬浮怎么工作：从排斥力到PID闭环，动手前先搞懂这条链路

2.1 为什么叫下推式：和上拉式磁悬浮的本质区别

磁悬浮小项目里最常见的是两类：上拉式，也叫吸浮式，电磁铁在悬浮体上方，悬浮体是铁磁性材料，通电后产生吸引力，把物体吸住并悬在半空；下推式则刚好反过来，电磁铁线圈固定在底座上，悬浮体是一块永磁体，线圈通电后产生和永磁体底部相同的磁极，以排斥力把浮子“推”起来。

很多人第一次听到“下推式”会想：既然是排斥，那线圈和悬浮体不是应该保持距离吗？事实上如果没有主动控制，两者会迅速错开。排斥力会把悬浮体推向一边，永磁体还会因为磁极相对而翻转。这就是所谓的不稳定平衡：虽然有向上的推力，但任何横向扰动都会被放大，所以下推式磁悬浮一定得是一个负反馈闭环系统。

我之前测试时把线圈直接通电后放手，永磁体会先被弹起来，然后翻个面吸在线圈上。原因是纯排斥力没有阻尼，位置稍微一动，力就往错误方向变化。所以控制系统的任务很明确：实时检测悬浮体与线圈的距离，如果它偏高就减小电流，偏低就增大电流，让作用点始终压在设定高度上。

从力学链条看，整套系统可以用一个二阶模型近似：线圈电流产生磁感应强度，磁感应强度和永磁体相互作用产生力，力改变悬浮体位移，位移又被霍尔传感器感知。把这条链路上每个环节的延迟控制住，是它悬浮得稳不稳的关键。

2.2 stm32f103在这套系统里能做什么

选 stm32f103 不是因为性能有多高，而是因为这项目的接口要求它刚刚好：一个 12 位 ADC 用来采样霍尔电压，一个高级定时器输出 PWM，外加一个定时器触发控制周期中断。72MHz 主频在 1kHz 的控制周期下，能留出大量余量给滤波和通信，实测一条控制路径从采样到更新 PWM 寄存器，大约只需要几十微秒。

在下推式磁悬浮中，stm32f103 的角色是典型 MCU 控制器，它本身不产生力，只负责做决策。决策周期一般取 0.5ms 到 2ms，对应 500Hz 到 2kHz 的闭环带宽。太慢会让系统出现明显滞后，浮子会像喝醉一样晃；太快又会放大传感器噪声，PWM 占空比也会抖得很厉害。这也是这类资源里最常见的隐含设定：控制频率和 PWM 频率是两回事。

常见做法是在一个 1kHz 的定时中断里完成一轮“采集-计算-输出”。ADC 读取霍尔电压，通过查表或线性映射换算成悬浮高度；PID 模块根据高度误差输出一个控制量；这个控制量再被映射成 PWM 占空比，更新到定时器的比较寄存器。所有步骤必须在中断周期内完成，否则下一条采样来了数据还没算完，连续性就断了。

2.3 一个控制周期的完整时序：从中断到PWM更新

我一般会把控制循环写成下面这种结构，看起来像状态机，实际上就是固定顺序的任务：

// 1kHz定时器中断，每个周期执行一次完整闭环 void TIM2_IRQHandler(void) { if (TIM_GetITStatus(TIM2, TIM_IT_Update) == 0) return; TIM_ClearITPendingBit(TIM2, TIM_IT_Update); uint16_t hall = get_hall_level(); // 第1步：读取霍尔滑动滤波结果 float pos = hall_to_pos(hall); // 第2步：把ADC值映射成悬浮高度(mm) float ctl = pid_calc(&pid, target, pos); // 第3步：PID计算出控制量 uint16_t duty = ctl_to_duty(ctl); // 第4步：控制量映射成占空比(20%-95%) set_pwm_duty(TIM3_PWM_CH1, duty); // 第5步：更新占空比寄存器 }

这段代码里，get_hall_level 不是直接读 ADC 原始值，而是一个经过 10 次滑动的均值，这是为了抑制线圈开关带来的尖峰噪声。hall_to_pos 负责把霍尔电压换算成距离，通常是一段标定好的线性关系，例如把 0.5V 到 2.5V 映射成 5mm 到 15mm。pid_calc 拿到设定高度和当前高度的误差后，输出一个带方向的控制量，正值表示需要增大排斥力，负值表示减小。ctl_to_duty 再把这个控制量映射到 PWM 占空比范围，同时做饱和钳位。

这个顺序每一步的数据都作用在下一次采样之前，所以如果中间某一步耗时太长，最好把控制频率调低一点，不要强行压到 2kHz。我自己的经验是，1kHz 下整个中断体耗时约 20-30us，足够稳定运行。注意 PWM 频率我通常设在 20kHz 到 25kHz，目的是避开人耳听阈，线圈不会发出刺耳啸叫。

2.4 为什么不直接用模拟模块而要坚持MCU闭环

市面上有一些模拟磁悬浮模块，不需要 MCU，用比较器和线性功放就能浮起来。但模拟方案有个明显短板：参数不可调，传感器温漂和人手扰动只能被动忍受。用 stm32f103 做数字闭环，最大的好处是把整个控制律搬进了代码里，你可以随时改 PID、改悬浮高度、加滤波、加前馈，而不需要改硬件。

另一个好处是可视化。同样的板子，模拟方案一旦不稳定，你只能拿示波器慢慢戳；数字方案可以用串口把数据拉到上位机，直接看误差曲线和输出曲线，哪里出了问题一眼就能定位。这个优势在后面的调参环节会体现得非常明显。

3. 拆开磁悬浮stm32.rar：核心源码与关键参数怎么改

拿到这份资源后，建议不要直接打开工程就点编译。先花十分钟搞清楚文件布局，能省掉后面很多麻烦。这一章我会按照我从里面挑出的核心文件讲一遍，控制逻辑部分给出直接能用的代码片段。

3.1 文件结构：先分清哪些是必须看的，哪些是库文件

一套典型的 stm32 工程解压后会分成这样几块：Core 文件夹是系统启动文件和内核相关文件，Libraries 里是外设库文件，这些是编译支撑，平时不用打开。需要关心的主要是 User 目录里的主程序，Hardware 目录里的传感器、驱动模块，以及 Doc 目录里的原理图、BOM 清单和调试说明。

这份 rar 里真正值钱的部分，我列在下面：

有的初学者喜欢把每个文件都打开看一遍，结果被库函数绕晕。我的建议是先从 pid.c 和 hall.c 看起，因为这两个文件决定了控制系统的主干。系统跑起来之后再看 main.c 里初始化了什么，理解接线关系。这样读代码的路径最短。

3.2 霍尔传感器读数滤波：滑动平均比中值滤波更适合这个场景

霍尔传感器输出的模拟电压代表浮子到线圈的距离，但这个电压会在 PWM 开关瞬间被耦合出毛刺，尤其是电流变化率大的时候。不能直接把这个值丢给 PID，否则浮子会抖。下面这段代码是资源基础上习惯性改用的滑动平均：

#define HALL_FILTER_N 10 static uint16_t hall_buf[HALL_FILTER_N]; static uint8_t fifo_idx; static uint32_t hall_sum; uint16_t get_hall_level(void) { uint16_t raw = adc_read(ADC_CH_HALL); // 读取原始ADC hall_sum -= hall_buf[fifo_idx]; hall_buf[fifo_idx] = raw; hall_sum += hall_buf[fifo_idx]; fifo_idx = (fifo_idx + 1) % HALL_FILTER_N; return (uint16_t)(hall_sum / HALL_FILTER_N); }

逻辑上很简单：维护一个长度为 10 的环形缓冲，每次采样把新值放进去，同时丢到最旧的那个值，所有缓冲值的和除以 10 就是当前输出。为什么要用环形缓冲而不是每次重新累加？因为重新累加在中断里会引入额外计算量，虽然不过几十个周期，但在 1kHz 下不值得浪费。

这里有个取舍：窗口长度 N 太小，滤波作用有限；N 太大，数据滞后增加。10 次滑动平均在 1kHz 采样下对应 10ms 等效延迟，对 1kHz 的控制周期来说已经接近一个半周期，再往上就得小心稳定性。如果板上数字电源噪声特别大，我一般会先提高 PWM 频率，而不是无脑增大 N。

3.3 PID计算和限幅：位置式PID的两个关键钳位

控制代码里最容易被改坏的就是 PID。资源里给出的通常也是位置式 PID，形式为：输出等于比例项加积分项加微分项。看完整代码：

typedef struct { float kp; float ki; float kd; float integral; float last_error; float out_max; float integral_max; } Pid_t; float pid_calc(Pid_t *pid, float setpoint, float pos) { float error = setpoint - pos; pid->integral += error; if (pid->integral > pid->integral_max) pid->integral = pid->integral_max; if (pid->integral < -pid->integral_max) pid->integral = -pid->integral_max; float derivative = error - pid->last_error; pid->last_error = error; float out = pid->kp * error + pid->ki * pid->integral + pid->kd * derivative; if (out > pid->out_max) out = pid->out_max; if (out < -pid->out_max) out = -pid->out_max; return out; }

这里加了两个限幅：积分限幅和输出限幅。积分限幅极其重要，如果没有它，浮子在启动瞬间被压到最低点，误差长期存在，积分项会不断累积成一大坨饱和值，等外力消失后，输出仍然维持在最满，浮子会一下子蹿出去，这就是积分饱和。

输出限幅的数值要跟后面的 PWM 映射对齐。比如 out_max 设为 100，ctl_to_duty 把 100 映射成 95% 占空比，-100 映射成 20%，这意味着 PID 的输出不是直接写进寄存器，而是经过换算。注意换算后的占空比下限不要设到 0，因为下推式线圈需要一个基础电流来建立悬浮平衡点，从 0 开始会有几十毫秒都吸不住浮子。

3.4 PWM驱动与死区：为什么要留出最小占空比

PWM 模块一般使用定时器的某个通道输出，极性、频率、占空比都靠寄存器配置。磁悬浮的负载是电感线圈，不需要正反向换向，所以一个普通 PWM 加一个 MOSFET 驱动就能工作。死区功能是 H 桥控制电机时才需要，这里保持关闭即可。

单片机的 PWM 分辨率也影响稳定度。stm32f103 的定时器是 16 位，如果 PWM 频率设在 20kHz，那么有效分辨率约为 72MHz 除以 20kHz，约 3600 阶，足够平滑。如果为了追求高分辨率把 PWM 降到 8kHz，则会引入可闻噪声。我在资源基础上测试时，8kHz 下线圈噪声很恼人，23kHz 是很好的折中。

4. 硬件搭建与调参顺序：浮子稳定悬浮不是靠运气

软件逻辑搞清楚后，照着一份可靠的 BOM 表把硬件焊出来是很快的。但原理图上的元件参数和实际布局对最后效果影响很大。这一章我把搭建和调试分成三步，每步都有可以直接参考的做法。

4.1 关键硬件怎么选：线圈、霍尔传感器、MOS管驱动

下推式磁悬浮的线圈一般自己绕制，在资源里通常能找到推荐的线径和匝数。常见参数是 0.35mm 铜线绕 200 匝左右，电感在几毫亨到十几毫亨之间。这个范围不需要太精确，因为闭环控制会主动调节电流。但线圈电阻太大时，同样的 PWM 占空比下电流不够，浮子会被“压死”。

霍尔传感器建议用线性霍尔，比如集成线性霍尔 IC，输出模拟电压。开关型霍尔不能用，它只能给出有/无信号，无法区分远近。供电最好单独用 LDO，不要和 MOSFET 驱动共用电源，否则电流变化会通过地线窜扰进传感器的参考电压。

MOSFET 驱动方面，用逻辑电平 N-MOSFET 是常见选择，栅极直接由 stm32f103 的 PWM 脚驱动。不过要注意：MCU 的 GPIO 驱动能力有限，如果 MOSFET 栅极电容较大，建议加一个 10 欧栅极电阻，避免开关振铃。线圈两端还需要一个续流二极管，否则断开瞬间的感应电压可能击穿引脚。

4.2 从源码到烧录：一条最稳妥的落地路径

拿到 rar 里的工程后，第一步不是改代码，而是确认引脚定义和你的原理图一致。晶振频率也要检查，默认一般是 8MHz 外部晶振，通过倍频到 72MHz。如果板子上实际焊接的是 25MHz 晶振，那么代码里的一切定时都会偏，调试时看到的现象会比预期慢或快很多。

先在电脑上用串口 ISP 或者调试器烧录一个现成的 bin 文件，确认板子能跑。很多资料会同时给出 hex 和完整源码，hex 的意义就在于让你先验证硬件。如果 hex 烧进去浮子仍然不动，问题大概率在硬件；如果 hex 能悬浮而源码编译出来不行，再回头看源码里的参数配置差异。

# 以串口ISP为例，接线正确后，将BOOT0拉高，复位后执行 stm32flash -b 115200 -w build/maglev.bin -v /dev/ttyUSB0

命令里的 -b 指定波特率，-w 写文件，-v 表示写完校验。烧完后把 BOOT0 拉回低电平并复位，程序就开始运行。如果烧录失败，先检查串口是否被占用，再确认 BOOT0 电平确实到了 3.3V，而不是悬空。

如果源码是自己用 Keil 编译的，务必确认优化等级。有些默认优化等级会导致变量在中断和主循环之间共享时出现意外行为，比如标志位被优化掉。我一般把编译器优化设到 -O0 或者在关键变量上加 volatile。

4.3 PID调参顺序：先P后D再I，每步都要观察波形

这一步是大多数人翻车的地方。我强烈建议先用串口把实时高度数据发出来，看着波形调参数，而不是盲扭。第一次通电后，先不要期望浮子悬起来，重点是看传感器响应。

先把 PID 参数清零，只留 P。P 从 0.5 开始，每次增加 0.5。你会看到浮子开始有反应，表现为向下压它时它能弹回来一点。继续加大 P，直到出现周期性的上下抖动，这表示 P 已经踩到低阻尼阈值，记下当前值，把它减去一半作为工作 P。然后加 D，D 从 0.5 开始，逐步加大，抖动的幅度会明显减小。最后加 I，I 只要很小，比如 0.02 到 0.05，它只用来消除长时间的高度偏离。

调参过程里有一个容易忽略的细节：目标悬浮高度必须设在霍尔曲线中心附近的线性区间，如果设得太靠边缘，霍尔电压变化斜率变小，灵敏度下降，再多 P 也拉不稳。我一般先用手推浮子到一个位置，读一下霍尔电压，再选中间值作为 target。

调参的时候一定记得把能稳定悬浮的原始参数先拍照或者注释保存。这行代码很多人不重视，等到把 P 加到浮子开始乱飞，再想恢复原状态就要重新摸索。我会在 pid 结构体定义旁边加一行注释，写上“稳定参数: kp=2.0 kd=0.8 ki=0.02，高度12mm”，调乱后直接改回来。

4.4 没有示波器时怎么判断浮子状态

如果没有示波器，可以写一个简单的状态指示：在 PID 输出超过一定范围时点亮一个 LED，或者通过串口定时打印高度。用耳朵也能辅助判断——震荡声音频率高，通常是 D 不够；低频喘息声，多半是 P 太小或 I 过大。把 LED 亮灭和声音配合起来，一样能完成调参，只是速度慢一些。

如果手头连串口都没接，也可以在 PID 误差绝对值超过一定值时翻转一个 GPIO 口，用万用表量那个端口的占空比，间接判断控制量。总之，调试的核心是找到一种可观测的信号，而不是凭感觉。

5. 避坑与常见问题排查：浮子飞走、震荡、漂移，逐个拆给你看

这部分内容完全从实际调试中整理，每一条都是我在复现下推式磁悬浮时遇到的问题。现象对应的原因可能有多种，但按照顺序排查，大多数能在十分钟内定位。

5.1 现象：上电瞬间浮子直接被弹飞，或者反向被吸过去

原因：控制方向接反。下推式系统里，浮子距离线圈越近，霍尔电压变化方向与电流增大方向完全相反。如果代码里的误差定义是 target - pos，但霍尔接线却让距离增大时电压也增大，那么 PID 输出就会在浮子过高时继续增加电流，形成正反馈。

解决：先逐句检查 hall_to_pos 映射。调试时让浮子靠近线圈，观察串口打印的 pos 数值是变大还是变小。正确的行为是：浮子靠近线圈时，pos 应变小，这样在 pid_calc 里 target - pos 为正值，PWM 会增加排斥力。如果反了，把 hall_to_pos 里的比例系数 k 取负，或者交换霍尔传感器的信号线。

5.2 现象：浮子能够被吸起来一点，但就是达不到悬浮高度，一直躺在下面

原因：电流推不动。最常见原因是线圈供电电压不足。下推式磁悬浮不是用小功率线圈就能浮起来的，需要线圈在占空比最大时产生的力大于浮子重力再加上扰动裕量。测量线圈两端电压，如果峰值远低于设计值，说明 MOSFET 没有完全导通或电压被电源压降吃掉。

解决：用示波器测 MOSFET 漏极波形，看 PWM 高电平时是否达到电源电压。如果波形边缘很缓，检查栅极驱动电阻是否太大，或者 GPIO 推挽模式没有开启。另一个因素是占空比下限：如果基础占空比在 20%，而浮子需要 25% 才能起浮，你会在设定点附近看到出力不足，此时把 ctl_to_duty 的下限降到 15% 再试。

5.3 现象：悬浮稳定后，耳朵能听见明显的吱吱声或尖锐啸叫

原因：PWM 频率落到了可听范围。很多默认工程 PWM 频率是 16kHz 到 20kHz，但人的听阈上限可以到 20kHz，而且线圈骨架在高次谐波一起振动时会发出刺耳声音。另一个来源是电源线上的纹波让线圈发出啸叫，这个通常不是 MCU 的问题。

解决：把 PWM 频率改到 25kHz 以上。修改时注意分频系数和重装载值要一起算，否则频率改了但分辨率下降很多。同时在驱动电源和地之间加一个 100uF 电解电容和 0.1uF 陶瓷电容，吸收高频开关纹波。改完频率后需要重新验证控制周期，因为 PWM 频率和定时器中断是两个独立定时器，不会互相影响。

5.4 现象：悬浮高度随开机时间慢慢变化，早上调的参数下午就偏了

原因：热漂移。线圈通电后会发热，铜线电阻随温度升高而增大，同样的 PWM 占空比下电流减小，导致同样的控制量实际产生的力变小。霍尔传感器本身也有温度系数，它的参考电压如果由 MCU 的 3.3V 供电，而 3.3V 来自开关电源，温度变后电压变化也会让读数偏移。

解决：在每次上电后做一次零点校准。具体做法是让浮子放在参考支撑架的最低点，读取一个基准值，然后计算目标高度时使用相对差值而不是绝对电压。这样即使传感器漂移，只要差分关系不变，控制量还会稳定。更彻底的办法是在线圈供电回路加一个电流采样，在 PID 里做前馈补偿，这个会在下一章展开。

5.5 现象：烧录后串口有数据，但PWM就是没有输出，浮子没有任何动作

原因：PWM 通道引脚没有禁用 JTAG 或者引脚复用没配置好。stm32f103 的某些引脚默认是 JTAG 端口，例如 PB3、PB4、PA15，如果 PWM 用在这些脚上，不把 JTAG 功能关闭的话，输出会被调试逻辑占用。另外，定时器的 PWM 模式配置里经常漏掉“自动重装载预装载”这一项，导致更新比较寄存器后没有按预期生效。

解决：在初始化里优先调用 jtag_deinit() 关闭 JTAG 功能，然后再配置 GPIO 为复用推挽。确认 TIM_Cmd 是 enable 的，并且在修改比较寄存器前关闭 MOE 主输出使能（如果需要）。调试时用逻辑分析仪直接量引脚，如果始终是低电平，逐步回退到裸灯测试，比如把该引脚配成普通 GPIO 输出翻转，排除硬件问题。

6. 更稳的两个技巧：串口实时标定和电流前馈

6.1 用串口把PID中间量拉出来标定

调 PID 最怕盲目。我会在控制中断里增加一个计数器，每 100 个控制周期向串口发送一次pos,target,ctl,duty四个值，形成一条完整的控制记录。这样能同时观察反馈、设定值和控制量，快速判断问题是传感器方向、PID 稳定性还是 PWM 限幅。

发送的代码可以放在主循环里，用一个标志位触发：

if (send_flag) { send_flag = 0; printf("%u,%u,%d,%u\r\n", hall, target, ctl, duty); }

通过串口波形能看到：如果 pos 和目标值之间总有固定偏差，说明积分太小；如果 pos 在目标值两侧快速交换，说明微分不足或传感器噪声太大；如果 ctl 已经顶到上限但 pos 还在偏差侧，说明输出限幅太小或电流不够。这一步能省下大量时间。

6.2 给电流叠加一个前馈，抵抗线圈发热

PID 是典型的负反馈，反馈的缺点是等到误差产生了才动作。线圈发热后，同样占空比下电流下降，于是产生了静差。要解决这个问题，可以在 PID 输出基础上叠加一个静态工作点补偿项，也就是根据目标悬浮高度直接给一个恒定的基础 PWM，PID 只负责叠加修正量。

我一般这样算：基础占空比等于悬浮空载时维持目标高度所需的近似占空比，然后 PID 输出按比例调整。这个基础项不需要很准，因为作用是给系统一个合适的工作点，剩下的偏差由 PID 微调。实际测试中，加上这个基础项后，热漂移高度从每小时 0.5mm 降到 0.1mm 以内。

从那以后我每次调磁悬浮，都会先写一小段脚本把霍尔曲线拉出来，确认传感器线性段再上电，不然都是在瞎调。希望帮到你。

本文还有配套的精品资源，点击获取