2. 开发环境搭建：STM32CubeMX配置、Keil/IAR IDE安装、电机控制库导入、调试工具配置
好，咱们正式开始动手了。这一章我带你搭好开发环境。说白了，就是给PMSM控制项目准备好“锅碗瓢盆”。环境没搭好，后面代码写得再漂亮也跑不起来。我个人习惯是先装IDE，再配CubeMX，最后搞调试工具。这个顺序比较顺，你跟着来就行。
2.1 STM32CubeMX配置——从芯片到工程的“翻译官”
STM32CubeMX这工具，说白了就是图形化配置单片机外设的。你不用手写寄存器，点点鼠标就能生成初始化代码。我刚开始做电机控制时，还傻乎乎地自己配定时器，后来发现CubeMX一键生成，省了至少半天时间。
第一步：安装与启动
去ST官网下载CubeMX，安装时注意选对Java环境（它依赖Java运行）。装好后打开，界面很清爽。
第二步：选芯片
做PMSM控制，我推荐STM32F4或G4系列。比如STM32F407VGT6，带浮点运算单元（FPU），算电流环PID快得很。你选好芯片后，双击进入配置界面。
第三步：配时钟树
这里有个坑。电机控制需要高精度PWM，时钟源最好用外部晶振。我一般配到168MHz（F4系列上限）。你点开Clock Configuration，把HCLK拉到168，系统会自动调整分频系数。嗯，这里要注意，别超频，芯片会发热。
第四步：配外设
PMSM控制需要这些外设：
- 定时器（TIM1/TIM8）：输出6路互补PWM，带死区插入。我习惯用TIM1的CH1、CH2、CH3，分别控制U、V、W三相。
- ADC（ADC1/ADC2）：采集相电流和母线电压。记得配成注入组或规则组，触发源选定时器更新事件。
- 编码器接口（TIM2/TIM3）：读电机位置。配成Encoder Mode，TI1和TI2分别接A、B相。
- DAC或PWM输出：给电流环参考值。我一般用DAC输出模拟量，或者直接用PWM滤波。
第五步：生成代码
配好后点Project -> Generate Code。选MDK-ARM（Keil）或IAR，工程名别用中文。生成后你会看到一堆.c和.h文件，别慌，核心代码在main.c和stm32f4xx_hal_msp.c里。
重要提醒：生成代码后，别急着改main.c。我建议把用户代码写在/* USER CODE BEGIN */和/* USER CODE END */之间，这样下次重新生成时不会被覆盖。
2.2 Keil/IAR IDE安装——写代码的“战场”
IDE这东西，用顺手了就是神器。我个人偏爱Keil，因为它的调试界面直观，而且ST官方例程大多用Keil。但IAR的编译优化确实更强，代码体积小。你选哪个都行，我两个都装，看项目需求切换。
Keil MDK安装步骤：
- 去ARM官网下载MDK-ARM（5.38版本以上）。安装时选默认路径，别改。
- 装完后打开Pack Installer，搜索你的芯片型号（比如STM32F407VG），点Install。这一步是装芯片支持包，不装的话编译会报错。
- 破解。嗯，这个你懂的。用注册机生成License，填进去就行。我当年第一次装时忘了破解，编译到一半弹窗，气得我差点砸电脑。
IAR EWARM安装步骤：
- 下载IAR Embedded Workbench for ARM（8.50以上）。安装时注意选“Full Installation”。
- 装完后打开，点Tools -> Options -> License Manager，导入License文件。
- 同样需要装芯片支持包。IAR会自动检测，或者你去官网下载EWARM_AddOn_STM32F4。
我的小技巧：Keil和IAR可以共存。我一般用Keil做原型开发，IAR做量产优化。两个IDE的工程文件不通用，但CubeMX可以同时生成两种格式，省事。
2.3 电机控制库（MCSDK）导入——别重复造轮子
ST官方提供了电机控制软件开发套件（MCSDK），里面包含了FOC算法、观测器、电流环等现成代码。我刚开始做PMSM控制时，自己手写了整个FOC，结果调试了两个月才跑通。后来用了MCSDK，一周就调好了。你想想看，何必呢？
MCSDK版本选择：
| 版本 | 适用芯片 | 特点 |
|---|---|---|
| MCSDK v5.x | STM32F4/G4 | 支持单电阻/三电阻采样，带观测器 |
| MCSDK v6.x | STM32G4/H7 | 支持MCSDK6，带AI故障诊断 |
导入步骤：
- 从ST官网下载MCSDK安装包（比如en.x-cube-mcsdk-ful_5.4.8）。安装后你会看到一堆例程。
- 打开CubeMX，在Software Packs里点Select Components，搜索“X-CUBE-MCSDK”，勾选你需要的版本。
- 在Pinout & Configuration里，你会看到多了一个“Motor Control”选项卡。点进去，选电机参数（极对数、额定电流、电阻电感等）。
- 生成代码后，MCSDK的库文件会自动添加到工程里。你只需要在main.c里调用MC_StartMotor()就行。
注意：MCSDK的库是闭源的，只提供.a或.lib文件。如果你想修改底层算法（比如改观测器增益），得用ST的Motor Control Workbench工具。我遇到过一个问题：默认的电流环带宽是1000Hz，但我的电机电感很小，跑起来振荡。后来在Workbench里把带宽降到500Hz才稳定。
2.4 调试工具（J-Link/ST-Link）配置——让代码“看得见”
调试工具是嵌入式开发的“眼睛”。没有它，你只能靠猜。我刚开始做电机控制时，有一次电流采样一直不对，折腾了两天。后来用J-Link的波形功能一看，发现ADC触发时序错了。嗯，从那以后我再也不敢不用调试器了。
ST-Link配置：
- ST-Link是ST官方调试器，Nucleo板自带。连接方式：SWDIO接PA13，SWCLK接PA14，GND接GND。
- 在Keil里点Project -> Options for Target -> Debug，选ST-Link Debugger。点Settings，确认SWD模式，速度选4MHz（别太高，容易断连）。
- 我习惯在Flash Download里勾选“Reset and Run”，这样下载完程序自动运行，省得手动按复位。
J-Link配置：
- J-Link是SEGGER家的，调试速度快，支持断点多。连接方式一样：SWDIO、SWCLK、GND、VCC（可选）。
- 在Keil里选J-Link/J-Trace Debugger。点Settings，在Debug选项卡里选SW模式，速度可以拉到10MHz（如果线长的话降一降）。
- J-Link有个好功能：RTT（实时传输）。你可以用SEGGER RTT Viewer打印日志，不占用串口。我调试电流环时，就用RTT实时看Id、Iq值，比串口快多了。
避坑指南：我曾经遇到过调试器连不上芯片的情况。后来发现是SWDIO和SWCLK的引脚被复用了。解决办法：在CubeMX里把PA13和PA14的GPIO功能设为“System”，别设成其他外设。如果已经锁死了，按住复位键再点下载，或者用ST-Link Utility擦除芯片。
2.5 环境验证——跑个灯试试
环境搭好了，得验证一下。我一般写个简单的PWM输出程序，让电机驱动板的LED灯呼吸闪烁。如果灯亮了，说明CubeMX配置、IDE编译、调试器连接都OK。
代码示例（在main.c的while循环里加）：
// 让TIM1的CH1输出50Hz PWM，占空比从0到100%循环
for(uint16_t duty = 0; duty < 1000; duty += 10) {
__HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, duty);
HAL_Delay(10);
}
for(uint16_t duty = 1000; duty > 0; duty -= 10) {
__HAL_TIM_SET_COMPARE(&htim1, TIM_CHANNEL_1, duty);
HAL_Delay(10);
}编译下载后，用示波器看PA8（TIM1_CH1）引脚，应该能看到PWM波形。如果没波形，检查时钟配置和GPIO复用功能。我遇到过新手把PA8设成普通GPIO，结果PWM死活出不来。
好，环境搭建就到这。下一章咱们开始写电机控制的核心代码——FOC算法实现。到时候你会感谢今天搭好的环境。