简介面向STM32磁悬浮控制开发的完整工程资料包涵盖控制程序源码、Keil工程文件、电路原理图与3D结构件适合电子、嵌入式方向学生用于毕业设计、期末大作业或课程实训。包内文件总数8个包含Keil工程压缩包、电路总原理PDF、3D结构STL模型、JSON配置文件以及说明文档等整体压缩包仅2.37MB下载与部署都很便捷。目前已有149人学习适合作为磁悬浮控制入门的参考案例。其中电路原理图可帮助理解电源、驱动与反馈回路Keil工程源码展示了磁悬浮核心控制流程结合说明文档可快速复现实验平台。3D结构件STL文件可用于打印悬浮装置机械外壳配合JSON配置信息能进一步调整控制参数从而缩短开发调试周期。1. 从 zip 到悬浮这个磁悬浮工程包能给你什么一个磁悬浮源码包里通常就是四样东西控制程序源码、Keil 工程文件、电路原理图、3D 结构件。它不是点开就能悬浮的玩具而是把一条完整反馈链路摊开在你面前线性霍尔把浮子位移变成电压STM32 用 ADC 采样跑一圈 PID定时器输出 20kHz PWMH 桥驱动线圈改变吸力3D 打印件则负责把传感器、线圈和磁钢约束在同一根轴线上。这篇文章就按这条链路往下拆输出可复现的初始化代码、整定参数和装配公差。适合正在做 STM32 课程设计、手里有类似工程包但调不稳定的同学也适合想把 PID 从“能转”推到“能悬浮”的嵌入式工程师。先看懂模型再动手否则参数调试会变成玄学。2. 磁悬浮控制原理先算清“吸得住”需要多大的控制带宽控制悬浮第一件事不是写代码而是认清对手。电磁铁的吸力近似为 F K × i² / x²K 跟线圈匝数、磁路截面积、磁导率有关x 是气隙距离i 是线圈电流。浮子受力可以写成 m × x mg − K × i² / x²。这个方程的核心麻烦在于力和距离呈正相关x 越小吸力越大x 越大吸力越小天然就是正反馈。让浮子稳定悬浮本质上是靠闭环把这种正反馈压成负反馈。2.1 控制模型这是一个开环不稳定的二阶系统在平衡点 (x0, i0) 附近做一阶泰勒展开系统可以线性化成 x a1 × (x − x0) a2 × (i − i0)。其中 a1 一定大于零这意味着二阶系统有一个特征根落在右半平面阶跃响应会指数发散。这就是为什么开环 PWM 直接给定电流浮子要么被吸死、要么掉下去不存在“调一个占空比让它悬住”的中间值——那个中间值本身就不稳定。a2 的正负由电流方向决定悬浮场景下吸力方向固定i 增大吸力增大这部分符号是确定的。剩下的问题就是控制器要以多快的速度修正电流才能在偏差指数发散前拽回来。经验上位置环带宽要做成不稳定极点频率的 5 到 10 倍。对气隙 8mm、磁钢 30g 的桌面级悬浮器极点频率通常在 20 到 60 rad/s位置环用 1kHz 采样率、几十赫兹闭环带宽足够。2.2 位置外环与电流内环的分工线圈是感性负载电流变化率由 L × di/dt 决定。直接给电压型 PWM电流响应有滞后高频段不受控。常见做法是拆两个环外环位置环 1kHz 运行算出目标电流内环电流环让线圈电流快速跟随目标值。在 F103 上做软件双环足够1ms 定时器里跑位置环、200us 定时器里跑电流环。控制结构实现成本抗电源波动适用场景单位置环 电压PWM最低弱电压跌一点电流就变课程实验、验证悬浮原理软件位置环 软件电流环中两个中断任务较好课程设计、电子设计竞赛模拟电流内环 软件位置环高硬件多一组运放强产品化、长时间连续运行更省 CPU 的做法是把电流内环放到模拟域采样电阻电压经运放放大后送比较器电流超限直接关断 PWMMCU 只跑位置环。做课程设计我一般推荐中间方案两个中断都是整型乘加F103 的 72MHz 主频完全扛得住。2.3 PID 参数整定的量纲陷阱先归一化再调参位置误差单位是 mm微分是 mm/s而 PID 输出是电流或 PWM 占空比。直接把毫米放进 Kp参数没有任何可移植性换个传感器量程就得全部重来。我一般会先把位置误差除以量程例如 ±5mm 归一化到 ±1输出映射到占空比 0 到 100这样 Kp 和 Kd 的量纲统一成“满占空比的百分比”。写 MCU 代码之前先用 Python 离线验证模型和参数。把平衡点线性化参数代入下面这段仿真可以看到 P 和 D 的作用import numpy as np dt 0.001 steps 1000 d_mm 3.0 # 当前偏移: 正气隙大于目标, 单位 mm v_mm_s 0.0 # 速度, 正气隙增大方向 i 0.6 # 平衡点电流 A a1 1800.0 # 不稳定极点项, 1/s^2 a2 8000.0 # 电流-吸力增益, mm/s^2/A Kp 1.6 # 偏差(归一化) - 电流修正, A Kd 0.05 # 偏差变化率(归一化) - 电流修正, A for _ in range(steps): err_n d_mm / 5.0 # 5mm 满量程归一化 derr_n -v_mm_s / 500.0 # 偏差的导数: 向下运动时应增大电流 i_target 0.6 Kp * err_n Kd * derr_n i min(max(i_target, 0.01), 1.5) # 电流限幅 acc a1 * d_mm a2 * (i - 0.6) v_mm_s acc * dt d_mm v_mm_s * dt print(final deviation: %.2f mm % d_mm)这段代码里Kp 对应位置偏差对电流的修正力度Kd 相当于给系统加阻尼。a1 的正反馈项每毫秒都在放大位置偏差P 项把它压回去D 项抑制速度不让过冲。注意初始偏差 3mm 时控制量已经顶到 1.5A 上限说明启动过程会发生饱和后面第 6 章的启动斜坡就是为这个准备的。仿真只是线性化验证忽略了电流环延迟、霍尔噪声和 PWM 纹波真实参数要在硬件上微调。3. 拆解 Keil 工程与磁悬浮控制源码的实现骨架拿到工程第一件事不是读代码而是把编译器和芯片包环境对齐。这个包里的 Keil 工程基本基于标准外设库和 CubeMX 生成的项目不完全一样它默认你用的是 MDK-ARM不是 Keil C51。有人用 C51 工具链打开 md 后缀工程界面一片灰色那是两种工具链不是文件坏了。3.1 打开 Keil 工程先解决设备不匹配和芯片包缺失STM32 芯片包不在默认安装范围里打开工程会看到 Device 下拉框空白编译时一路报未定义。常见做法是去 keil 官网下载对应 DFP 包F103 系列用 keil.STM32F1xx_DFP双击安装后回到 Manage Run-Time Environment 刷新即可。确认四件事芯片型号选 STM32F103C8选错 Flash 大小启动文件会乱宏定义必须有 USE_STDPERIPH_DRIVER,STM32F10X_MD标准外设库靠它决定编译哪些驱动文件启动文件用 startup_stm32f10x_md.s对应中等容量 Flash烧录器选 ST-Link Debugger不要留在默认的 ULINK。工程配置项值说明DeviceSTM32F103C864KB FlashStartupstartup_stm32f10x_md.s中等容量启动文件宏定义USE_STDPERIPH_DRIVER,STM32F10X_MD标准外设库编译开关DebugST-Link Debugger连接 ST-Link/V2After Buildfromelf --bin生成 bin 文件烧录时如果碰到 error: no stm32 target found! 一行英文提示先别怀疑接线多半是 ST-Link 驱动没装好或 Debug 设置里设备没选对。改完设置用 ST-Link Utility 测一下连接能读到芯片 ID 再继续。如果项目需要批量烧录在 Options for Target → User → After Build 里加一行fromelf --bin -o ./output/demo.bin ./output/demo.axf这样每次编译结束自动生成 bin配合 ST-Link Utility 烧写比每次打开工程下载省事得多。3.2 ADCDMA 采样1kHz 位置数据的正确读法位置检测用线性霍尔悬浮范围内输出电压约 1.5V 到 3.3V。让 ADC 连续转换、DMA 循环搬运再由定时器中断固定节奏取均值比在中断里启停 ADC 干净得多。/* 8 个样本循环 DMA控制中断里读平均 */ static void ADC1_Init_DMA(uint16_t *buf) { GPIO_InitTypeDef gpio; ADC_InitTypeDef adc; DMA_InitTypeDef dma; RCC_APB2PeriphClockCmd(RCC_APB2Periph_ADC1 | RCC_APB2Periph_GPIOA, ENABLE); RCC_AHBPeriphClockCmd(RCC_AHBPeriph_DMA1, ENABLE); gpio.GPIO_Pin GPIO_Pin_1; /* PA1: 霍尔位置信号 */ gpio.GPIO_Mode GPIO_Mode_AIN; GPIO_Init(GPIOA, gpio); DMA_DeInit(DMA1_Channel1); dma.DMA_PeripheralBaseAddr (uint32_t)ADC1-DR; dma.DMA_MemoryBaseAddr (uint32_t)buf; dma.DMA_DIR DMA_DIR_PeripheralSRC; dma.DMA_BufferSize 8; dma.DMA_PeripheralInc DMA_PeripheralInc_Disable; dma.DMA_MemoryInc DMA_MemoryInc_Enable; dma.DMA_PeripheralDataSize DMA_PeripheralDataSize_HalfWord; dma.DMA_MemoryDataSize DMA_MemoryDataSize_HalfWord; dma.DMA_Mode DMA_Mode_Circular; dma.DMA_Priority DMA_Priority_High; dma.DMA_M2M DMA_M2M_Disable; DMA_Init(DMA1_Channel1, dma); DMA_Cmd(DMA1_Channel1, ENABLE); adc.ADC_Mode ADC_Mode_Independent; adc.ADC_ScanConvMode DISABLE; adc.ADC_ContinuousConvMode ENABLE; adc.ADC_ExternalTrigConv ADC_ExternalTrigConv_None; adc.ADC_DataAlign ADC_DataAlign_Right; adc.ADC_NbrOfChannel 1; ADC_Init(ADC1, adc); ADC_RegularChannelConfig(ADC1, ADC_Channel_1, 1, ADC_SampleTime_239Cycles5); ADC_DMACmd(ADC1, ENABLE); ADC_Cmd(ADC1, ENABLE); ADC_ResetCalibration(ADC1); while (ADC_GetResetCalibrationStatus(ADC1)); ADC_StartCalibration(ADC1); while (ADC_GetCalibrationStatus(ADC1)); ADC_SoftwareStartConvCmd(ADC1, ENABLE); }DMA 缓冲区设 8 个样本、循环模式写满自动回绕ADC 全程不耗 CPU。采样时间选 239.5 周期是为了压低霍尔信号阻抗与引脚寄生电容形成的建立误差。ADC 时钟 12MHz 下对应约 20us 采样窗对悬浮应用足够还能滤掉一部分高频噪声。校准环节初始化时跑一次不能省否则同一块板子换个电ADC 读数可能整体偏移几个 LSB。3.3 20kHz PWM 与 H 桥驱动从占空比到线圈电流PWM 频率取 20kHz 比较稳妥低于 5kHz 电流纹波大、磁钢有高频啸叫高于 40kHz 半桥驱动开关损耗上升、发热明显。20kHz 避开人耳最敏感区也在常见 H 桥驱动的可用频率上限内。F103 普通定时器 TIM3 就能满足不需要高级定时器的互补通道H 桥方向引脚决定电流流向、PWM 决定占空比换向和调力分离代码更简单。static void TIM3_PWM_Config(void) { GPIO_InitTypeDef gpio; TIM_TimeBaseInitTypeDef tim; TIM_OCInitTypeDef oc; RCC_APB1PeriphClockCmd(RCC_APB1Periph_TIM3, ENABLE); RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOA | RCC_APB2Periph_GPIOB, ENABLE); gpio.GPIO_Pin GPIO_Pin_6 | GPIO_Pin_7; /* PA6/PA7 - TIM3 CH1/CH2 */ gpio.GPIO_Mode GPIO_Mode_AF_PP; gpio.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOA, gpio); tim.TIM_Prescaler 72 - 1; /* 72MHz / 72 1MHz */ tim.TIM_CounterMode TIM_CounterMode_Up; tim.TIM_Period 50 - 1; /* 1MHz / 50 20kHz */ tim.TIM_ClockDivision TIM_CKD_DIV1; TIM_TimeBaseInit(TIM3, tim); oc.TIM_OCMode TIM_OCMode_PWM1; oc.TIM_OutputState TIM_OutputState_Enable; oc.TIM_Pulse 25; /* 初始 50% 占空比 */ oc.TIM_OCPolarity TIM_OCPolarity_High; TIM_OC1Init(TIM3, oc); TIM_OC1PreloadConfig(TIM3, TIM_OCPreload_Enable); TIM_Cmd(TIM3, ENABLE); }预分频 72 和周期 50 使计数频率 1MHz、PWM 频率 20kHz占空比分辨率 2%。TIM_OC1PreloadConfig 开启预装载占空比更新发生在下个周期边界避免高电平中间突然翻转造成的毛刺。后续更新占空比用 TIM_SetCompare1(TIM3, value)value 范围 0 到 50。3.4 1ms 控制中断把采样、PID 和占空比串起来TIM6 做 1ms 控制节拍中断里读 DMA 缓冲的平均值、跑 PID、更新 PWMvolatile uint16_t adc_buf[8]; /* DMA 循环缓冲 */ void TIM6_IRQHandler(void) { uint32_t sum 0; uint16_t pos_adc; float pos_mm, duty; uint16_t i; if (TIM_GetITStatus(TIM6, TIM_IT_Update) RESET) return; TIM_ClearITPendingBit(TIM6, TIM_IT_Update); for (i 0; i 8; i) sum adc_buf[i]; pos_adc sum / 8; pos_mm (pos_adc / 4095.0f - 0.5f) * 10.0f; /* 满量程 ±5mm */ duty pid_update(0.0f, pos_mm, 0.001f); if (duty 5.0f) duty 5.0f; /* 最小 5%, 保住自举电容供电 */ if (duty 100.0f) duty 100.0f; TIM_SetCompare1(TIM3, (uint16_t)(duty * 0.5f)); /* 0~100 映射到 0~50 */ }pid_update 的 dt 传 0.001 秒对应 TIM6 中断周期。饱和钳位之后如果没有给 PID 回写抗饱和状态占空比长时间顶在 100% 时积分项持续累积浮子重新下落时会过冲表现是“吸上来又砸下去”的周期振荡。TIM6 优先级要设得比串口按键都高控制环一旦被打印卡几个毫秒浮子就掉了。4. 电路原理图里的四段链路H桥、运放、稳压与采样电路这部分看起来是硬件实际上每一段都在配合软件里某个参数。H 桥决定电流能走多大、换向快不快采样电阻和运放决定电流环反馈灵敏度霍尔和减法电路决定位置环的 ADC 刻度供电又影响 ADC 参考稳定性。四段里任何一段标称错了PID 参数就要跟着完全变样。4.1 H桥驱动电路原理图IR2104 半桥驱动与 MOSFET 选型原理图里 H 桥最常见的是两个 IR2104 拼出的全桥。IR2104 有两个逻辑输入IN 是 PWM 输入SD 是关断输入输出 HO、LO 分别驱动上下管。自举电路是关键VS 引脚接两个管子中点自举电容并在 VB 和 VS 之间另一端经二极管接电源。上电后如果长时间不让上管导通自举电容充不上电上管就像没接一样表现为只有半波电流磁钢只能吸住不能调节。IR2104 引脚作用接法注意事项INPWM 输入接 MCU 定时器通道或方向整形后的信号SD关断输入低电平关断接电流比较器输出做硬件保护VB/VS自举供电VB-VS 间 100nF 到 1uF 电容VS 接半桥中点HO/LO高低端输出各串 10 到 22 欧姆栅极电阻接 MOS 栅极MOSFET 选型上12V 供电、峰值电流 2A 以内的桌面悬浮器逻辑电平 N-MOS 就够重点关注 Vgs(th) 低于 2V、Qg 小于 30nC 的型号。Vgs(th) 太高IR2104 的 10V 输出勉强能开但导通电阻偏大Qg 太大PWM 边沿变圆开关损耗直接变成驱动芯片发热。注意 SD 引脚不要悬空悬空等于没接保护过流时只能靠程序反应来不及。4.2 运放减法电路把霍尔中点抬到 2.5V线性霍尔输出以电源电压一半为中心静态 2.5V悬浮范围内摆动约 ±0.5V。直接送 ADC 也可以但只有 1V 摆幅用满 4096 档每毫米对应 LSB 太少。典型做法是先做减法电路把中心拉到 0放大数倍再加回 2.5V 偏置让 ADC 输入落在 0.3V 到 4.7V。常用拓扑是两个运放第一级做差分减法第二级做同相加法偏置。第一级用 Rf/Rin 10 倍增益例如 Rin 1k、Rf 10k第二级把 2.5V 基准加进去。最容易踩的坑是基准电压的带载能力——用 3.3V 串两个电阻分压出来的 2.5V带不动运放反馈网络输出会随放大倍数漂移。稳定做法是用 TL431 或 REF3025 一类的基准源至少也要用运放跟随缓冲一次。电流采样同样需要减法电路。采样电阻放 H 桥低端1A 电流在 0.05 欧姆上只有 50mV环境噪声就能盖过去。一级差分放大 20 倍再进 ADC或者直接送比较器做硬件过流保护。这组阻值决定电流环反馈系数代码里要写成宏换电阻时统一改。4.3 5V转3.3V稳压电路与 ADC 参考电压的折中板上供电常见一路 12V 给 H 桥、一路 5V 给逻辑电路5V 再经稳压芯片出 3.3V 给 STM32 和霍尔。AMS1117-3.3 是这类板子标配但压差约 1V输入 5V 刚好够如果用 USB 的 5V 且线上有压降输出可能掉到 3.2V 以下ADC 参考电压跟着漂位置零点每次上电都变。供电节点负载纹波要求建议12VH桥、线圈纹波体现在采样电阻上靠近 H 桥放 100uF 电解和 0.1uF 陶瓷5V运放、霍尔尽量低mV 级独立 LDO别直接挂开关电源输出3.3VSTM32、ADC Vref直接影响 ADC 刻度模拟电源引脚单独加 LC 滤波F103C8 的小封装没有独立 VREF 引脚ADC 参考就是 3.3V 电源所以 3.3V 网络上数字和模拟部分不能混走。数字信号从 PA 口翻转产生的噪声耦合到地平面都会被 ADC 采进去。布板时把晶振、LED、按键的数字回路和霍尔到 PA1 的模拟回路分开走比换更贵的基准芯片有效。5. 3D 结构件装配与公差让传感器、线圈、磁钢对齐同一轴线电路和代码定下来之后悬浮能不能稳取决于机械结构。3D 结构件不是“把东西放上去”而是保证三件事线圈轴线和磁钢轴线共线霍尔敏感面正对磁钢中心且距离可测浮子没电流时不会直接掉到线圈上砸坏传感器。间隙太小平衡电流小、K 大、系统极点更高PID 需要更大带宽间隙太大浮动范围小。打印变形 0.5mm相当于把整个控制点挪了一个明显的距离。5.1 结构件的分件与安装顺序这类工程包里的 3D 文件一般拆成四个部件底座固定线圈骨架和电路板线圈骨架绕 500 到 800 匝漆包线带引线槽浮动磁钢托固定磁钢带防旋转结构限位环限制浮子最大上升高度和侧向偏移。安装顺序有讲究先把线圈绕好装进骨架再把托架套进磁钢、确认磁钢 N/S 朝向和霍尔位置匹配最后装霍尔支架。顺序反了霍尔支架装好后看不到磁钢运动路径参数再调也没用。磁钢和托架用 502 或 AB 胶固定前先验证吸力方向通电让线圈吸一下吸得住且磁钢不碰霍尔外壁再固定。5.2 打印公差、层高与对齐调校步骤PLA 打印的收缩和层纹是主要误差来源。线圈骨架内孔如果按磁钢外径卡死设计打印出来常常装不进去留 0.3mm 间隙又可能晃动。常见做法是打印完用砂纸修内孔边修边试装。定位孔建议设计成腰形孔方便装配时左右微调霍尔位置。打印参数推荐值原因层高0.2mm平衡表面质量和强度填充率40% 到 60%底座要抗线圈振动壁厚2 到 3 层磁钢托太薄易断裂支撑仅限限位环悬空处支撑面要打磨否则影响同轴度对齐调校按顺序来把磁钢托装到底座不装线圈确认磁钢可以在托架内自由升降摩擦力很小装线圈和霍尔上电读霍尔 ADC用手缓慢推托架确认 ADC 随位移单调变化给线圈上小电流看磁钢是否被吸向中心吸歪说明磁钢朝向或霍尔安装偏了磁钢放到平衡位置附近感到被稳定吸住再跑软件 PID。第 3 步很关键机械上磁钢本来就吸不到线圈中心控制器输出再大也是往侧面偏表现出来是浮子剧烈抖动后快速跌落PID 参数容易被误判为“太大”。6. 把磁悬浮调稳的三个步骤和一个反直觉技巧6.1 示波器看波形而不是看悬浮效果调悬浮时眼睛盯住浮子没有意义视觉反应跟不上。正确做法是把霍尔输出接示波器再引一路 PWM 同步观察。位置环正常时有几个特征霍尔信号稳定在目标值附近纹波幅度小于 20mVPWM 占空比在 45% 到 55% 之间缓慢摆动手把浮子往下压占空比应立即往 100% 方向走松开后回弹并回到原位置。PWM 摆动快而且霍尔信号发毛先怀疑 ADC 采样噪声或采样时刻不对而不是 PID 参数。6.2 调参顺序与启动斜坡参数整定按 P → D → I 顺序先只留 P从小值开始浮子放平衡位置附近看是坠落还是高频抖动。坠落加 P抖动减 P找到临界振荡值用 D 压振荡压到不超调最后加一点 I 消静态偏差。I 项要做积分限幅和停止累加——输出饱和时积分必须停否则就是前面说的“吸上去又砸下来”。一个反直觉的技巧是给设定值加斜坡启动一上电不直接让目标位置等于平衡点而是从远处缓慢移向平衡点每毫秒移动约 0.1mm。这样磁钢在悬浮前就在往目标方向运动不会因为初始偏差太大触发输出饱和。实现只需在中断里加几行static float target_pos 5.0f; /* 从 5mm 处开始 */ if (target_pos 0.0f) target_pos - 0.1f; /* 每 1ms 接近 0.1mm */提示设定值斜坡只改目标位置不改 PID 参数否则会把抗饱和逻辑引入不必要的切换干扰。真正调稳后再逐步缩短过渡时间直到可以一步到位悬浮。最后检查 PWM 开关沿和 ADC 采样时刻是否重叠必要时让 ADC 触发信号延迟半个 PWM 周期采样点落在 PWM 纹波波谷处霍尔信号会更干净。这个相位关系在原理图上体现不出来但实际波形上它决定了 PID 输出噪声的底噪水平。本文还有配套的精品资源点击获取