3. 开发环境搭建：STM32CubeMX配置、Keil MDK安装与配置、调试工具使用

做电机控制，环境搭不好，后面全是坑。我见过太多人花了两周调代码，最后发现是编译器版本不对。这一章，咱们把地基打牢。

3.1 工具链全景图

先看整体结构。你写代码、生成配置、编译、下载、调试，每一步都有对应工具。我习惯把它们分成三层：

说白了，CubeMX帮你省掉写底层配置的时间，Keil负责把你的C代码变成机器码，调试器负责把机器码烧进去并让你看到变量变化。缺一不可。

3.2 STM32CubeMX配置——别让时钟把你坑了

CubeMX这工具，我刚开始用的时候觉得它就是个图形化寄存器配置器。后来发现，它真正的价值在于时钟树和引脚冲突检测。做FOC，时钟错了，PWM频率全偏，电流采样时序全乱。

3.2.1 新建工程与芯片选择

打开CubeMX，点"New Project"。在Board Selector里选你的板子，或者直接在MCU Selector里搜STM32F103C8T6（我常用这个）。选好后点Start Project。

3.2.2 时钟树配置——FOC的命脉

点开"Clock Configuration"标签页。这里我要多说两句。FOC算法里，PWM频率、ADC采样率、电流环计算周期，全跟时钟挂钩。

以STM32F103为例，我一般这样配：

时钟源	配置值	说明
HSE（外部晶振）	8 MHz	开发板标配，精度高
PLL倍频	x9	8*9=72 MHz，F103最高主频
SYSCLK	72 MHz	系统主时钟
APB1定时器时钟	72 MHz	TIM2-TIM7用，PWM生成
APB2定时器时钟	72 MHz	TIM1/TIM8用，高级定时器
ADC时钟	12 MHz（分频后）	ADC采样率=12M/采样周期

3.2.3 外设配置——FOC必备清单

回到Pinout & Configuration标签页。你需要配以下外设：

1. 定时器（TIM1/TIM8）：生成6路互补PWM，带死区插入。模式选PWM Generation CH1/2/3，互补输出CH1N/CH2N/CH3N。
2. ADC（ADC1/ADC2）：采集相电流和母线电压。触发源选定时器TRGO，实现PWM中心对齐采样。
3. USART（USART1）：跟电脑通信，发调试数据、收指令。波特率我设115200或921600。
4. GPIO：编码器接口、使能信号、故障指示灯。
5. DMA（可选）：ADC数据自动搬运，减轻CPU负担。

配完后点"Project Manager"，填工程名、选Keil MDK-ARM V5版本、勾选"Generate peripheral initialization as a pair of .c/.h files"。然后点GENERATE CODE。

3.3 Keil MDK安装与配置——编译器版本决定成败

Keil MDK，说白了就是ARM的IDE加编译器。我见过有人用MDK 4.xx编译FOC代码，结果浮点运算慢得离谱。为什么？因为老版本编译器对Cortex-M3的优化不够。

3.3.1 安装步骤

• 去ARM官网下载MDK-ARM（当前推荐5.38或5.39）。
• 安装时选默认路径，别改。否则后面Pack安装会报错。
• 安装完成后，打开Pack Installer，搜索你的芯片型号（比如STM32F103C8），安装对应的Device Family Pack。
• 如果要用J-Link，还需要装SEGGER的J-Link驱动（后面会讲）。

3.3.2 工程配置——优化选项

打开CubeMX生成的工程。在Keil里点"Project -> Options for Target"。我重点说几个关键配置：

标签页	配置项	推荐值	原因
Target	ARM Compiler	V5.06 update 7	FOC代码兼容性最好
Target	Floating Point Hardware	Not Used（F103无FPU）	用软件浮点库
C/C++	Optimization	-O2 或 -O3	FOC计算量大，必须开优化
C/C++	Optimize for Time	勾选	减少循环展开，提高实时性
Debug	Debugger	J-Link / ST-Link	看你用什么调试器
Utilities	Flash Download	勾选Reset and Run	下载完自动运行

嗯，这里要注意：优化等级别开-O0。我试过，开-O0编译出来的FOC代码，电流环跑不到20 kHz，CPU全浪费在冗余指令上了。

3.4 调试工具使用——J-Link vs ST-Link

调试器就是你的眼睛。没有它，你只能靠LED闪烁猜代码在干什么。FOC调试尤其需要看变量——电流值、角度、速度、PI输出。这些用串口打印太慢，必须用调试器实时看。

3.4.1 J-Link与ST-Link对比

特性	J-Link（SEGGER）	ST-Link（ST官方）
下载速度	快（最高50 MHz SWO）	中等（最高4 MHz SWO）
断点数量	无限（硬件+软件）	有限（通常6个硬件断点）
SWO输出	支持，带宽高	支持，但带宽低
价格	贵（正版几百到几千）	便宜（几十块，开发板自带）
兼容性	全系列ARM	仅ST芯片
推荐场景	专业开发、高频调试	学习、原型验证

我个人建议：学习阶段用ST-Link完全够用。但如果你要做产品级开发，尤其是需要频繁看变量、设断点、分析时序，J-Link能省你大量时间。我自己工作室里两个都有，但主力是J-Link Plus。

3.4.2 连接与配置

接线很简单：SWDIO、SWCLK、GND，三根线就够了。如果需要SWO（串行线输出），再加一根SWO线。

在Keil里配置：

• 点"Project -> Options for Target -> Debug"。
• 选J-Link / J-Trace 或 ST-Link Debugger。
• 点"Settings"，确认SWD模式、速度（我一般设4 MHz，稳定）。
• 在Flash Download标签页，勾选"Reset and Run"。

3.4.3 调试实战——看变量、设断点

代码下载进去后，点"Debug"按钮进入调试模式。你会看到：

• Disassembly窗口：看C代码对应的汇编，优化后有时C和汇编对不上，别慌。
• Watch窗口：添加你要看的变量，比如motor.current_a、motor.speed_ref。
• Logic Analyzer：Keil 5.xx以上版本支持，可以实时画变量波形。调试FOC时，我经常用这个看电流波形和速度响应。

举个例子。你写了个速度环，电机转起来但速度不稳。在Watch窗口加motor.speed_actual和motor.speed_ref，设个断点在速度环更新函数里。单步跑几步，看实际速度是不是在参考值附近震荡。如果是，说明PI参数有问题。

3.5 环境验证——让电机动起来

环境搭好没？写个最简单的代码验证：

// main.c 验证代码片段
int main(void) {
  HAL_Init();
  SystemClock_Config();
  MX_GPIO_Init();
  MX_TIM1_Init();   // PWM初始化
  MX_ADC1_Init();   // ADC初始化

  // 启动PWM输出，占空比50%
  HAL_TIM_PWM_Start(&htim1, TIM_CHANNEL_1);
  HAL_TIMEx_PWMN_Start(&htim1, TIM_CHANNEL_1);

  while (1) {
    // 让LED闪烁，证明程序在跑
    HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
    HAL_Delay(500);
  }
}

下载进去。如果LED以0.5秒间隔闪烁，说明CubeMX配置、Keil编译、调试器下载，全链路通了。接下来就可以开始写FOC算法了。