📚 课程目录第1章搭建FOC开发环境

1. 搭建FOC开发环境

任务目标

本案例完成FOC开发的最小环境搭建：安装STM32CubeIDE、集成Motor Control SDK（X-CUBE-SPN）、配置ST-LINK调试器，并通过点亮开发板板载LED验证工具链与硬件连接正常。最终以“编译通过+烧录成功+LED闪烁”作为环境可用的判定标准。

环境与依赖

硬件：NUCLEO-G431RB开发板（板载ST-LINK/V2-1）、USB线（数据型）
软件：STM32CubeIDE 1.15.0及以上（含STM32CubeMX）、X-CUBE-SPN（Motor Control SDK，通过CubeMX软件包管理器安装）
驱动：ST-LINK USB驱动（CubeIDE安装时通常自动安装，若设备管理器出现未知设备需手动安装）

安装与配置步骤

从ST官网下载并安装STM32CubeIDE（安装包约1GB，需注册ST账号）。
打开CubeIDE，选择 Help > Manage Embedded Software Packages，在 STMicroelectronics 分类下找到 X-CUBE-SPN，勾选最新版本并点击 Install。该包提供FOC电机控制库与配置工具。
用USB线连接NUCLEO-G431RB的ST-LINK USB口（板身标注“ST-LINK”的USB-C口）至电脑。打开设备管理器，确认出现 ST-LINK Debug 和 Virtual COM Port 两个设备。

最小工程验证

不直接创建完整FOC工程（涉及电机参数配置，属于后续案例），先用一个最小GPIO工程验证工具链与调试器连通性。在CubeIDE中新建STM32工程，选择板卡 NUCLEO-G431RB，CubeMX会自动初始化时钟与ST-LINK。在 Pinout & Configuration 视图中，将 PC6（板载LED绿灯）配置为GPIO_Output，生成代码后替换 main.c 中 while(1) 循环内容：

/* USER CODE BEGIN 3 */
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_6);
HAL_Delay(500);
/* USER CODE END 3 */

点击 Run 按钮（绿色三角），CubeIDE会自动编译、烧录并启动调试会话。若一切正常，板载绿色LED将以2Hz频率闪烁。

验证方法与判定标准

编译通过：Console窗口无error，生成 .elf 文件。
烧录成功：Console输出 Download verified successfully 或类似信息，无校验错误。
硬件连接：LED以约0.5秒间隔闪烁，说明时钟配置正确、GPIO输出正常、ST-LINK通信稳定。
调试器验证：点击 Suspend（暂停）按钮，调试视图能停在 HAL_Delay 或 while 循环内，寄存器窗口可读取 GPIOC->ODR 值在0x40与0x00间切换。

若LED不亮，依次检查：ST-LINK驱动是否识别（设备管理器）、CubeIDE的 Run > Debug Configurations 中调试器是否选择 ST-LINK (OpenOCD)、板载跳线JP1是否处于默认状态（连接ST-LINK与目标MCU）。

至此，FOC开发环境已具备：CubeIDE负责编译调试，X-CUBE-SPN提供后续案例所需的电机控制中间件，ST-LINK验证了代码下载通道。后续案例将在此环境上直接创建FOC工程。