1. 课程导入
电机控制是嵌入式系统中最具挑战性也最具工程价值的领域之一。STM32 系列 MCU 凭借其丰富的外设资源、成熟的生态工具链以及官方提供的 FOC（Field-Oriented Control，磁场定向控制）软件库，已成为工业驱动、机器人、电动工具、无人机和家电变频控制的主流平台。本课程以 STM32 FOC SDK 实战 为主线，从 CubeMX 图形化配置出发，逐步深入到电机参数辨识、电流环/速度环/位置环整定、观测器调试以及故障保护机制，最终带领学员完成一个可运行、可调参、可复用的永磁同步电机（PMSM）矢量控制工程。
上图展示了本课程从基础理论到最终工程交付的完整链路。四个层次（基础层、配置层、核心算法层、调试层）并非孤立推进，而是相互支撑、循环迭代。例如，在调试层发现电流环响应振荡，需要回溯到核心算法层检查 PI 参数，甚至回到基础层重新审视电机电感辨识是否准确。这种“理论—配置—算法—调试”的闭环思维，是贯穿全课程的核心方法论。
1.1 学习目标：从“能转”到“转得好”的进阶路径
本课程的学习目标分为四个递进层级，每一层都对应可验证的工程能力：
| 目标层级 | 具体能力描述 | 验证方式 |
|---|---|---|
| 基础认知 | 理解 PMSM 数学模型、FOC 坐标变换、SVPWM 调制原理 | 能徒手推导 Clark/Park 变换公式，解释 SVPWM 扇区判断 |
| 工程配置 | 熟练使用 CubeMX 生成 STM32G4 工程，正确配置定时器、ADC、编码器接口 | 生成的工程能通过编译并烧录，外设初始化无错误 |
| 算法实现 | 掌握 FOC SDK 的 API 调用、电流环/速度环 PI 参数整定方法、观测器调试技巧 | 电机能平稳运行，电流波形正弦度良好，速度阶跃响应无超调 |
| 系统调试 | 能独立完成故障诊断（过流、过压、堵转）、参数在线调整、性能优化 | 完成课程项目“带载变速运行 + 堵转保护”演示 |
需要特别强调的是，“能转”只是起点。很多学员在开环或简单六步换相中已经能让电机旋转，但 FOC 的核心价值在于：低速大扭矩、高速弱磁、动态响应快、噪音低。因此，本课程的目标不是“点亮一个电机”，而是让学员掌握一套可迁移的电机控制调试方法论——当你换一块新的电机驱动板、换一个不同参数的电机时，依然能快速完成配置和整定。
1.2 适用人群：你需要具备哪些前置知识
本课程面向有一定嵌入式基础、希望深入电机控制领域的工程师和研究者。具体来说，建议具备以下条件：
- 编程基础：熟悉 C 语言，能读懂寄存器操作代码，了解中断、定时器、ADC 的基本概念。
- 硬件基础：了解三相逆变电路（MOSFET/IGBT 桥臂）、电流采样电阻、栅极驱动芯片的基本工作原理。
- 控制理论：理解 PID 控制的基本概念（比例、积分、微分），了解传递函数和频域分析的初步知识。
- 工具链：安装好 STM32CubeMX、Keil MDK 或 IAR EWARM，以及 STM32CubeProgrammer 烧录工具。
如果你暂时不熟悉 PID 或逆变电路，也不必担心——课程第 2 章会专门安排“PMSM 基础与 FOC 数学预备”作为补充，第 3 章会讲解“三相逆变与电流采样硬件设计”。但如果你连“占空比”“ADC 采样”这些概念都感到陌生，建议先补充 STM32 基础外设知识再开始本课程。
1.3 课程项目概览：一个贯穿始终的实战案例
为了将零散的知识点串联成完整的工程能力，本课程设计了一个“云台电机双闭环控制”项目。选择云台电机（Gimbal Motor）作为载体，是因为它具有以下典型特征：
- 极低转速运行（1~10 RPM），对低速平稳性要求极高，能充分体现 FOC 的低速优势。
- 负载变化频繁（云台俯仰/偏航），需要速度环和位置环快速响应。
- 电机极对数较多（通常为 7 对极或 14 对极），便于观察 FOC 的电气频率与机械频率关系。
项目分三个阶段推进，对应课程的不同章节：
- 阶段一（第 1~8 章）：搭建 CubeMX 工程，完成定时器 PWM 输出、ADC 电流采样、编码器接口配置，让电机开环旋转起来。
- 阶段二（第 9~20 章）：集成 FOC SDK，实现电流闭环和速度闭环，完成 PI 参数整定，让电机带载平稳运行。
- 阶段三（第 21~30 章）：加入位置环、观测器、故障保护，完成最终的项目演示——通过串口指令控制云台电机精确转动到指定角度，并在堵转时自动保护。
每个阶段结束都设有“里程碑检查点”，例如阶段一结束时，你需要用示波器观察到三相互差 120° 的 SPWM 波形；阶段二结束时，你需要用 Motor Pilot 工具记录到平滑的电流波形和速度阶跃响应曲线。这些检查点确保你不会“带病前进”。
1.4 最终成果演示：你将带走什么
完成本课程后，你将获得以下可展示、可复用的成果：
| 成果类型 | 具体内容 | 工程价值 |
|---|---|---|
| 完整工程源码 | 基于 CubeMX 生成的 STM32G4 工程，包含 FOC SDK 集成代码、双闭环控制逻辑、串口通信协议 | 可直接作为产品原型基础，移植到其他 STM32 系列 |
| 调参报告 | 电流环 Kp/Ki、速度环 Kp/Ki 的整定过程记录，包含阶跃响应曲线、带宽分析 | 形成可复用的参数整定方法论，而非“试凑” |
| 演示视频 | 电机正反转、变速、带载运行、堵转保护全流程演示 | 用于技术汇报、面试展示或项目答辩 |
| 排障手册 | 常见问题（电流采样偏置、编码器方向反、PI 饱和等）的排查流程和解决方案 | 提升独立解决工程问题的能力 |
更重要的是，你将建立一套“从现象到根因”的调试思维。例如，当电机发出高频啸叫时，你能快速判断是电流环增益过高还是 PWM 频率设置不当；当电机带载掉速时，你能分析是速度环积分饱和还是电流限幅触发。这种能力无法通过阅读芯片手册获得，只能通过完整的项目实战来培养。
1.5 常见误区与学习建议
根据往期学员的反馈，以下几个误区最容易导致学习挫败感，提前了解可以帮你避开：
- 误区一：跳过理论直接调参。 不理解 Clark/Park 变换就盲目调整 PI 参数，往往只能“碰运气”。建议至少花 3 小时理解坐标变换的几何意义，这会让后续调试效率提升一倍。
- 误区二：照搬例程不修改。 ST 官方的电机控制例程是基于特定硬件设计的，直接烧录到你的板卡上大概率无法运行。必须学会根据自己板卡的引脚、时钟、电流采样增益修改配置。
- 误区三：忽视电流采样校准。 FOC 的性能上限取决于电流采样的精度。如果 ADC 偏置未校准，电流环会出现固定偏差，导致转矩脉动。课程第 7 章会专门讲解“电流采样零点校准”方法。
- 误区四：一次修改多个参数。 调试时每次只改变一个变量（例如只增大 Kp），观察响应后再改下一个。同时修改多个参数，出了问题很难定位根因。