1. 课程导入

电机控制是嵌入式工业应用中最具挑战性的领域之一，而永磁同步电机（PMSM）的磁场定向控制（FOC）更是现代高性能驱动系统的核心技术。ST Motor SDK（Software Development Kit）是意法半导体推出的电机控制一站式解决方案，它将复杂的FOC算法封装为可配置、可移植的软件库，配合STM32系列MCU的硬件定时器和ADC外设，使工程师能够在数小时内完成从电机参数识别到闭环运行的完整开发流程。本章作为整个课程的开篇，将明确学习路径、梳理FOC的基本原理、介绍ST Motor SDK的架构组成，并带领读者完成开发环境的搭建与验证。

1.1 学习目标与课程结构设计

本课程面向具备STM32基础开发经验、希望系统掌握FOC电机控制技术的嵌入式工程师。课程采用"原理→工具→实战→优化"的递进式设计，共30章内容，覆盖从FOC数学基础到产品级调试优化的完整知识链。学习完本课程后，学员应能够独立完成基于ST Motor SDK的PMSM电机驱动项目开发，包括电机参数辨识、电流环/速度环参数整定、无感FOC算法配置以及常见故障排查。

课程结构分为三大模块：基础篇（第1-8章）聚焦FOC核心原理与SDK工具链使用，包括Clark/Park变换推导、SVPWM实现、ST Motor Workbench配置流程等；进阶篇（第9-20章）深入闭环控制策略，涵盖电流环PI参数设计、速度环抗积分饱和、无感FOC的滑模观测器与锁相环实现；实战篇（第21-30章）面向工程落地，包括过流/过压保护逻辑、参数自整定算法、以及基于实际项目的性能调优案例。

1.2 FOC控制概述：从电机模型到矢量控制

磁场定向控制（Field Oriented Control，FOC）的核心思想是将三相交流电机的定子电流矢量分解为两个正交的直流分量——励磁分量（d轴）和转矩分量（q轴），从而将交流电机的控制问题简化为类似直流电机的控制问题。对于表贴式PMSM，d轴电感与q轴电感相等，电磁转矩与q轴电流成正比，控制目标即保持d轴电流为零，仅调节q轴电流即可线性控制转矩。

FOC的实现需要经过两次坐标变换：首先通过Clark变换将三相静止坐标系（a-b-c）下的电流投影到两相静止坐标系（α-β），再通过Park变换将α-β轴电流旋转到与转子磁场同步旋转的d-q坐标系。Park变换需要实时的转子角度信息，因此FOC必须依赖位置传感器（编码器/霍尔）或无感观测器估算转子位置。电流环PI调节器在d-q坐标系中工作，输出d-q轴电压指令，再经过逆Park变换和SVPWM（空间矢量脉宽调制）生成三相逆变器的开关信号。

ST Motor SDK中的FOC库采用双闭环级联结构：内环为电流环（带宽通常为1-2kHz），外环为速度环（带宽通常为50-200Hz）。电流环的采样与PWM周期同步，在STM32G4系列中可配置为中心对齐PWM触发ADC采样，确保在PWM周期的中点采集到相电流的平均值。速度环的输出作为q轴电流指令，d轴电流指令通常设为零（表贴式电机）或根据弱磁策略设定为负值（内置式电机）。

1.3 ST Motor SDK架构与核心组件

ST Motor SDK（当前主流版本为V5.x）由三个核心组件构成：Motor Control Library（MC库）、ST Motor Control Workbench（配置工具）和Motor Pilot（调试上位机）。MC库是预编译的FOC算法库，以静态库形式提供，包含电流采样、坐标变换、PI调节、SVPWM生成等底层函数；Workbench是图形化配置工具，用于选择MCU型号、电机参数、控制模式并生成初始化代码；Motor Pilot则通过UART或USB与目标板通信，实现实时波形显示、参数在线修改和故障诊断。

MC库的架构设计体现了分层解耦的思想：最底层为硬件抽象层（HAL），封装了定时器、ADC、GPIO等外设驱动；中间层为电机控制层，包含FOC算法核心函数（如MCM_CurrCtrl、MCM_SpeedCtrl）；最上层为应用层，提供用户接口（如MCM_StartMotor、MCM_StopMotor）。这种分层设计使得算法代码与硬件平台无关，当更换MCU型号时，只需重新生成HAL层代码，算法层无需修改。

// ST Motor SDK 典型初始化流程（伪代码）
int main(void) {
    HAL_Init();
    SystemClock_Config();           // 配置系统时钟（通常170MHz）
    MX_GPIO_Init();                 // 初始化GPIO（使能/故障引脚）
    MX_DMA_Init();                  // 初始化DMA（ADC数据传输）
    MX_TIM1_Init();                 // 定时器1：PWM生成（3对互补输出）
    MX_ADC1_Init();                 // ADC1：相电流采样（注入组）
    MX_ENC_Init();                  // 编码器接口初始化
    
    MCM_Init(&Motor_Handle);        // 初始化电机控制句柄
    MCM_StartMotor(&Motor_Handle);  // 启动电机（先开环预定位）
    
    while(1) {
        MCM_Task(&Motor_Handle);    // 周期调用FOC控制任务（10kHz）
        User_App_Task();            // 用户应用任务（通信/显示等）
    }
}

Workbench的配置流程遵循"参数驱动"模式：用户输入电机铭牌参数（额定电压、额定电流、极对数、相电阻、相电感等），Workbench自动计算PI调节器的初始增益、PWM频率、死区时间等关键参数。这些初始参数通常能保证系统稳定运行，但距离最优性能还需要通过Motor Pilot在线整定。值得注意的是，Workbench生成的工程基于STM32CubeMX，因此用户可以在CubeMX中自由添加其他外设（如CAN、UART通信），实现电机控制与应用功能的融合。

1.4 开发环境搭建：从安装到第一个工程

搭建ST Motor SDK开发环境需要安装以下软件工具链：STM32CubeMX（用于MCU引脚配置和时钟树生成）、STM32CubeIDE（集成开发环境，包含编译器和调试器）、ST Motor Control Workbench（电机控制专用配置工具）、以及Motor Pilot（调试上位机）。此外，还需要准备ST-Link调试器（或板载ST-Link）和串口调试助手（用于查看Motor Pilot数据）。

环境搭建的完整操作流程如下：

1. 安装STM32CubeMX与STM32CubeIDE：从ST官网下载最新版本（建议V6.x以上），安装时选择默认路径，确保Java运行环境正常。
2. 安装ST Motor Control Workbench：注意版本必须与MC库版本匹配（如Workbench V5.4.1对应MC库V5.4.1），安装完成后在CubeMX中会生成"Motor Control"菜单项。
3. 创建电机控制工程：打开Workbench，选择"New Project"，输入工程名称和保存路径，选择MCU型号（如STM32G431RBT6），点击"Next"进入电机配置页面。
4. 配置电机参数：在"Motor"选项卡中输入电机参数（极对数、相电阻、相电感、额定电流等），选择控制模式（速度控制/转矩控制），设置PWM频率（通常16-20kHz）和死区时间（通常0.5-1μs）。
5. 生成工程代码：点击"Generate"按钮，Workbench会自动调用CubeMX生成初始化代码，并将MC库文件复制到工程目录中。生成完成后，用STM32CubeIDE打开工程，编译并下载到目标板。
6. 验证环境：连接Motor Pilot，选择正确的串口号和波特率（默认115200），点击"Connect"按钮。如果通信正常，Motor Pilot界面会显示电机状态和实时电流/速度波形。

1.5 案例拆解：基于NUCLEO-G431RB的FOC环境验证

为验证开发环境是否搭建成功，我们以ST官方评估套件NUCLEO-G431RB + X-NUCLEO-IHM07M1（三相逆变器扩展板）驱动一台低压PMSM电机为例，进行完整的开环验证实验。该实验的目标是：确认MC库能正常初始化、PWM波形正确输出、电机能完成开环旋转。

实验准备：硬件包括NUCLEO-G431RB开发板、X-NUCLEO-IHM07M1扩展板、24V直流电源、一台额定电压24V的PMSM电机（极对数为4，相电阻0.8Ω，相电感0.4mH）。软件环境为STM32CubeIDE V1.13 + Workbench V5.4.1 + Motor Pilot V5.4.1。

操作步骤：首先在Workbench中新建工程，选择MCU为STM32G431RBT6，电机参数按上述铭牌填写。在"Control"选项卡中选择"Open Loop"模式（开环VF控制），设置开环频率为5Hz，V/F比率为2.5（即5Hz时输出电压约12.5V）。生成代码后编译下载，连接Motor Pilot，点击"Start Motor"按钮。

结果分析：正常情况下，电机会以5Hz的同步转速缓慢旋转（约75rpm）。用示波器测量U相PWM输出，应能看到占空比呈正弦规律变化的PWM波形，频率为5Hz。Motor Pilot的"Current Waveform"页面应显示三相电流为正弦波，幅值约0.3A（空载电流）。如果电机不转，首先检查母线电压是否正常（24V），其次检查PWM输出是否被使能（测量TIM1的CH1/CH2/CH3引脚）。

复盘要点：开环验证是FOC开发的第一步，它验证了从MCU到逆变器再到电机的完整功率链路。开环运行时电流较大且无法控制转矩，因此实验时间不宜过长（建议不超过2分钟），且电机应空载运行。开环验证通过后，才能进入闭环调试阶段——此时需要将编码器信号接入MCU，并在Workbench中切换为"Closed Loop"模式。