企业官网建设流程全解析

简介：这是一套基于STM32F4与HAL库的DengFOC闭环位置控制移植工程，面向嵌入式开发者与FOC算法学习者，演示如何将DengFOC适配到Keil MDK环境并实现位置闭环控制。工程共183个文件，以C源码、头文件及编译中间文件为主，包含stm32f4xx_hal_tim、i2c、uart、dma等外设驱动，并附uvprojx工程配置、hex固件、map映射与ioc引脚配置，压缩包约1.4MB，结构完整，可直接导入工程学习。已有583人学习下载。读者可从中获取完整的闭环位置控制代码框架、HAL外设初始化流程与编译链接配置，适合对照移植思路梳理从底层驱动到控制回路的实现细节，也可借助hex文件快速验证实际效果。

1. 把DengFOC搬上STM32 HAL：为什么我最终选了闭环位置控制这版

做无刷电机FOC控制的人，大概都听过DengFOC这套开源方案。它把电流环、速度环、位置环的框架搭得很完整，看起来拿来就能用。但真等你把它往STM32 HAL库工程里移植的时候，会发现坑比想象中多——底层定时器配置不一样、ADC触发方式对不上、编码器接口初始化顺序稍有差错，电机就抖给你看。我这次移植的目标很明确：在STM32上跑通闭环位置控制，让电机转到一个指定角度停住，并且能抗住外力扰动。这份资源解决的就是“DengFOC原版代码怎么在HAL库工程里跑起来，位置环怎么从开环到闭环一步一步调稳”的问题。

适合谁看？手里有STM32开发板和无刷电机驱动板，想跳过造轮子阶段直接看FOC参数怎么调的人。我尽量把移植过程中踩过的坑、改过的寄存器配置、参数整定的顺序都写清楚，让新手能照着复现，熟手能看到边界在哪。

2. 闭环位置控制的三环结构：为什么位置环不能单独调

2.1 三级串级控制：电流环是根基，位置环是门面

DengFOC的位置控制并不是只有一个位置环在工作，它内部是电流环、速度环、位置环三级串级结构。很多第一次接触的人会问：我只要位置固定，为什么不能直接给个电压让电机转过去？答案是：无刷电机的转矩和电流成正比，不控电流就控不住力矩；力矩不稳，位置环算得再准，电机实际走的轨迹也是歪的。所以DengFOC里位置环输出的是目标速度，速度环输出的是目标电流（q轴电流），电流环最终输出的是三相PWM占空比。

我一般建议先把这三级结构在脑子里立起来：

• 电流环：最内层，周期最快，通常10kHz到20kHz，负责让实际iq、id跟上目标值
• 速度环：中间层，周期1kHz左右，负责让转速跟上位置环给的目标速度
• 位置环：最外层，周期可以降到500Hz甚至更低，负责让编码器角度跟上目标角度

这个递进关系决定了调试顺序。你不可能先调位置环再去管电流环，因为位置环输出的目标速度如果电流环跟不上，位置环看到的现象就是“转了但没到位”，然后积分项一直累加，最后电机过冲。

2.2 位置环的P控制与DengFOC默认参数对照

DengFOC里位置环默认用的是纯P控制，这一点和不少教程里教的“位置环用PD”或“位置环用PID”不一样。纯P控制的位置环输出就是target_speed = Kp * position_error，只要位置误差存在，速度目标就不为零，电机就一直往目标方向转。好处是参数少、调试快，坏处是到目标点附近时速度不为零，会有超调，需要靠速度环的阻尼把它压住。

我移植的时候保留了DengFOC的这个设计，而不是自己改成PD，原因很简单：速度环本身已经是对速度误差的P控制，它在物理上就是一个阻尼项，位置环再单独加D容易造成两个阻尼打架，表现为高速时电机啸叫、低速时来回震荡。

// DengFOC位置环核心代码（HAL移植版） float position_ctrl(float target_pos, float current_pos, float kp_pos) { float err = target_pos - current_pos; // 单位：机械角度 float target_speed = kp_pos * err; // 输出目标速度，单位：rad/s return target_speed; }

这段代码的逻辑很简单：误差乘以P增益直接得到目标速度。需要注意参数的单位匹配，DengFOC内部默认使用弧度制，如果你的编码器读数返回的是原始脉冲数或0.1度之类的单位，必须换算成弧度再进入这个函数，否则Kp的量级会完全不对。我见过有人直接用编码器脉冲数当误差输入，结果位置环Kp只能调到0.001以下，整定起来非常别扭。

2.3 为什么位置环周期可以比电流环慢很多

串级控制里外环的周期可以比内环慢一个数量级，这是工程上的常规做法。位置环每1ms计算一次速度目标，速度环每1ms计算一次电流目标，但电流环每50us就要执行一次。DengFOC的原版代码把电流环放在定时器中断里，速度环和位置环放在主循环里用周期标志触发，这个结构在HAL库移植时最容易出问题——因为HAL库的定时器回调机制和原版寄存器写法不一样。

我这里采用的是：定时器更新中断只做电流环和编码器读取，主循环里做速度环和位置环。这样能保证电流环的实时性不被位置环的浮点运算拖累。位置环计算量不大，即使加一个串口打印调试信息，也不会影响控制周期。

3. STM32 HAL移植实操：定时器、ADC与编码器三条线

3.1 定时器配置：PWM输出与电流采样触发同步

DengFOC原版代码里，PWM的生成和ADC采样是通过定时器事件联动触发的。在HAL库工程里，最省事的做法是用高级定时器TIM1输出三相互补PWM，同时把TIM1的TRGO事件配置为ADC的触发源，这样每一个PWM周期里，ADC会在一个固定的时间点采样母线电流。

// TIM1三相互补PWM输出配置（HAL库） static void MX_TIM1_Init(void) { TIM_OC_InitTypeDef sConfigOC = {0}; TIM_BreakDeadTimeConfigTypeDef sBreakDeadTimeConfig = {0}; htim1.Instance = TIM1; htim1.Init.Prescaler = 0; htim1.Init.CounterMode = TIM_COUNTERMODE_CENTERALIGNED1; htim1.Init.Period = 1679; // 72MHz主频，中心对齐，PWM频率约21.4kHz htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; htim1.Init.RepetitionCounter = 0; htim1.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE; HAL_TIM_PWM_Init(&htim1, &TIM_CHANNEL_1); HAL_TIM_PWM_Init(&htim1, &TIM_CHANNEL_2); HAL_TIM_PWM_Init(&htim1, &TIM_CHANNEL_3); }

这里的关键参数是中心对齐模式和Period的值。中心对齐模式下，计数器先递增再递减，PWM波形对称，ADC在计数器溢出时采样，正好对应PWM的零向量位置，这时候母线电流最平滑，采样值最稳定。Period设为1679是从DengFOC原版的ARR值换算过来的，如果你的主频不是72MHz，这个值要按比例调整。

3.2 编码器接口：为什么我用定时器编码器模式而不是外部中断

位置闭环必须知道当前角度，STM32的定时器编码器模式可以直接接增量式编码器的A、B相，硬件自动计数，不需要CPU频繁响应外部中断。我这次用的STM32F103系列，TIM3的编码器模式接编码器，TIM4做速度环的时基。

// TIM3编码器模式配置 static void MX_TIM3_Init(void) { TIM_Encoder_InitTypeDef sEncoderConfig = {0}; htim3.Instance = TIM3; htim3.Init.Prescaler = 0; htim3.Init.CounterMode = TIM_COUNTERMODE_UP; htim3.Init.Period = 65535; // 16位计数器，溢出值设最大 htim3.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1; sEncoderConfig.EncoderMode = TIM_ENCODERMODE_TI12; // 双沿采样，4倍频 sEncoderConfig.IC1Polarity = TIM_ICPOLARITY_RISING; sEncoderConfig.IC1Selection = TIM_ICSELECTION_DIRECTTI; sEncoderConfig.IC1Prescaler = TIM_ICPSC_DIV1; sEncoderConfig.IC1Filter = 0x0F; sEncoderConfig.IC2Polarity = TIM_ICPOLARITY_RISING; sEncoderConfig.IC2Selection = TIM_ICSELECTION_DIRECTTI; sEncoderConfig.IC2Prescaler = TIM_ICPSC_DIV1; sEncoderConfig.IC2Filter = 0x0F; HAL_TIM_Encoder_Init(&htim3, &sEncoderConfig); HAL_TIM_Encoder_Start(&htim3, TIM_CHANNEL_ALL); }

选编码器模式而不是外部中断，省下的不仅是CPU时间，更重要的是计数值不会丢——外部中断在系统繁忙时可能漏掉脉冲，编码器模式由硬件计数，主循环哪怕被串口阻塞了100ms，角度依然准确。这个特性对位置闭环来说是性命攸关的。滤波值0x0F用于滤除编码器信号上的毛刺，如果你的编码器线比较长，这个值还可以加大到0xFF，但要注意会引入几微秒的延时，高速时会影响角度读取实时性。

3.3 电流采样与Clark变换移植要点

DengFOC的电流采样用的是两电阻方案，采集A、B两相电流，C相通过计算得出。在HAL库工程里，ADC用注入组采样，由TIM1的TRGO触发，采样完成中断里读取ADC值。

// ADC注入通道采样完成回调 void HAL_ADC_ConvCpltCallback(ADC_HandleTypeDef* hadc) { if (hadc->Instance == ADC1) { uint16_t adc_ia = HAL_ADC_InjectedGetValue(&hadc1, ADC_INJECTED_RANK_1); uint16_t adc_ib = HAL_ADC_InjectedGetValue(&hadc1, ADC_INJECTED_RANK_2); // 换算成实际电流值：ADC值 → 电压 → 电流 float v_ia = (adc_ia * 3.3f / 4095.0f - bias) * gain; float v_ib = (adc_ib * 3.3f / 4095.0f - bias) * gain; ia = v_ia; ib = v_ib; ic = 0.0f - ia - ib; } }

这里最容易忽略的是偏置电压bias和放大倍数gain的标定。DengFOC默认是单电源供电，运放会把电流信号抬升到1.65V中位，所以无电流时ADC读数大约在2048附近。如果你直接拿ADC值算电流，会发现电机静止时电流环输出乱跳。我移植的时候先跑了一段开环代码，人为给一个固定占空比让电机堵转，然后对比ADC读数和万用表测到的母线电流，反推出bias和gain的准确值。

3.4 位置环与速度环的调度：主循环里的周期任务

// 主循环里的周期任务调度 uint32_t last_speed_tick = 0; uint32_t last_pos_tick = 0; while (1) { uint32_t now = HAL_GetTick(); // 速度环：每1ms执行 if (now - last_speed_tick >= 1) { last_speed_tick = now; speed_ctrl(); // 输入电角度速度，输出目标iq } // 位置环：每2ms执行，比速度环慢一倍 if (now - last_pos_tick >= 2) { last_pos_tick = now; pos_ctrl(); // 输入目标位置，输出目标速度 } }

这段调度代码把两个环都放在主循环里，好处是调试时可以随时用断点暂停而不影响电流环的中断执行。速度环和位置环的周期不等比也没关系，串级控制只要求外环比内环慢，不要求严格整数倍。我实际测试时位置环用2ms、速度环用1ms，效果比两个环都是1ms更稳，因为位置环的计算量虽然小，但它的输出变化如果太频繁，速度环来不及跟随反而会让系统显得“急躁”。

4. 移植避坑记录：五个我实际翻车过的点

4.1 电机上电瞬间猛转一下然后堵转

现象：程序烧进去，给使能信号，电机先小角度偏转一下，然后卡死不动，手拧有明显的顿挫感。

原因：编码器零位和电机电角度零位没有对齐。DengFOC原版在初始化时会读取编码器位置作为电角度偏移，但HAL库移植时如果先启动了PWM再初始化编码器，编码器的初始值已经不是电机自然停靠的位置，电角度偏移量算错，导致FOC换相错乱。

解决：把初始化顺序固定为“先初始化编码器并读取当前值，再使能PWM输出”。另外在电机第一次上电时，让电机以开环方式强制对齐一次：给定一个固定电角度，让电机转子转到这个位置，然后把编码器当前值清零作为零点。从那以后我每次上电都会强制执行一次对齐动作，3秒内完成，位置也就不会漂。

4.2 电流环频率跑不到20kHz

现象：用逻辑分析仪量PWM频率，发现只有5kHz左右，跟配置的21.4kHz差得很远。

原因：TIM1的RepetitionCounter配置不对。高级定时器的更新事件不一定会每次都触发，如果RepetitionCounter设为1，意味着每两次计数周期才更新一次，PWM频率实际减半。另一个原因是中心对齐模式下，Period的值对频率的影响和边沿对齐不一样，频率计算公式不同。

解决：用示波器实测PWM频率来校准，别只看理论计算。RepetitionCounter保持0，Period除以2就是中心对齐模式下的比较值。如果是边沿对齐模式，Period直接等于计数周期。这个坑花了我半天时间，后来直接改回中心对齐、RepetitionCounter置0，频率就对了。

4.3 位置控制到位后电机持续嗡嗡响

现象：电机能转到目标位置，但停住之后有持续的电磁噪声，手摸电机外壳能感受到高频振动。

原因：位置环存在稳态极限环振荡。位置环用的是纯P控制，在目标位置附近，位置误差不可避免地在正负几个脉冲之间波动，导致目标速度在零附近来回跳动，速度环跟着反复输出正负小电流。

解决：给位置环输出加一个死区，当位置误差绝对值小于一个阈值（比如编码器3个脉冲）时，目标速度直接置0。这个死区在物理上对应的是电机静摩擦和减速器背隙，并不会影响定位精度，反而能消除极限环。

// 位置环输出死区 float pos_err = target_pos - current_pos; if (fabsf(pos_err) < 0.02f) { // 约0.02弧度，约1.15度 return 0.0f; } else { return kp_pos * pos_err; }

死区值的选择不是越小越好。我一开始设成0.005弧度，电机还是会轻微抖动，因为编码器分辨率加上电流环噪声，误差值在几个脉冲之间随机跳。后来根据编码器线数换算了一下：512线编码器4倍频后2048脉冲每圈，0.02弧度大约是7个脉冲，比噪声幅度大一倍，才真正安静下来。

4.4 位置环响应慢：转90度要2秒

现象：目标角度设90度，电机转过去很稳，但整个过程耗时2秒以上，感觉明显拖沓。

原因：位置环增益Kp不够大，导致目标速度一直很小，或者速度环的Kp、Ki没有配合好，限幅先被触发了。

解决：先别动位置环Kp，把速度环调快。方法是给定一个固定目标速度（比如5rad/s），看速度环从0到稳态需要多少毫秒，如果超过50ms就加大速度环Kp。等速度环跟手了，再回去加位置环Kp，会发现位置环的响应速度也跟着上来了。位置环最终Kp我落在0.5左右，配合死区0.02弧度，从0度到90度大约0.6秒。

4.5 HAL库的调试串口干扰控制时序

现象：一切参数都正常，但只要开串口打印调试信息，电机就偶尔抽搐一下。

原因：串口打印在阻塞模式下会占住CPU，如果打印频率正好和速度环周期冲突，速度环的执行周期就会有抖动。位置闭环对周期抖动的容忍度比速度闭环低得多。

解决：调试串口用DMA+空闲中断的方式，或者把打印频率降到2Hz以下。我最终的做法是：串口只在上位机主动请求时发送一次完整状态数据，不循环发送。如果你非要在控制循环里打印，记得把打印任务放到位置环之后、下一个电流中断来临之前，并且用中断发送而不是阻塞发送。

5. 参数整定的顺序与手感：先电流环，再速度环，最后位置环

5.1 电流环整定：堵转测试法

把电机轴用台钳卡死，给一个固定的iq目标值（比如0.2A），观察实际iq的响应。电流环的Kp和Ki在DengFOC里是分开给的，Kp影响响应速度，Ki负责消除稳态误差。整定时先把Ki设为零，只调Kp，从0.1开始逐步加大，直到实际电流跟目标电流的误差在20ms内收敛到5%以内。

注意电流环的PI输出会直接叠加到PWM占空比上，所以PWM限幅必须先设置好。DengFOC默认限幅是输出电压的80%，我建议先设到50%，防止整定过程中过流烧管子。堵转测试时电流不要超过1A，无刷电机堵转时发热很快，测一轮就把电压断掉。

5.2 速度环整定：空载小幅度梯形波试

速度环的输入是一个速度目标值，我给一个从0到5rad/s的阶跃，观察实际速度跟随情况。速度反馈怎么来？DengFOC里有现成的M法测速，就是数单位时间内编码器脉冲的数量，在低速时这个值会抖，所以速度环的周期我保持在1ms，测速窗口至少10ms。

速度环Kp从小往大调，到了某个值你会发现电机声音变尖，这是临界振荡的前兆，退回去20%作为最终值。Ki加的时候注意积分限幅，速度环的积分输出如果过大，电机加速会过头。

5.3 位置环整定：从30度小角度开始

位置环只调Kp，把前面的速度环调好之后，位置环的整定其实是三环里最快的。先给一个30度的小角度目标，让电机转，观察是否超调、是否振荡。超调10%以内可以接受，如果想更稳，把目标速度的限幅往下压——这是位置环控制质量的一个隐藏旋钮。

DengFOC里速度目标限幅默认是10rad/s，我降到6rad/s后，电机转90度的过程明显更线性，没有高速冲过去再刹车回摆的现象。限幅调低会牺牲响应速度，但换来的是定位过程的可预测性。

我从那以后每次做位置控制调试，都强制自己按“电流环→速度环→位置环”的顺序走一遍，哪怕只是把Kp从0.5改成0.6，也要先确认速度环没有在临界振荡的边缘。这个习惯让我的调试时间减少了一半以上。这次DengFOC移植的完整工程代码（包括三个环路的HAL库实现、定时器配置、编码器对齐程序）我打包好了，你拿回去对着改参数就能跑起来。希望帮到你。

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