第3章软件环境搭建

第3章：软件环境搭建——STM32CubeMX配置、IDE选择、基础工程模板建立

好，咱们进入实战环节的第一步。说实话，很多初学者一上来就急着写代码，结果环境没搭好，后面调试时各种莫名其妙的问题。我见过太多人卡在“点灯不亮”这种基础问题上，其实多半是工程配置出了问题。

这一章，我带你把软件环境彻底搞定。咱们的目标很明确：用STM32CubeMX生成一个干净的FOC工程骨架，选一个趁手的IDE，然后建立一套可以复用的模板。以后每做一个新项目，直接从这个模板开始改，省时省力。

3.1 为什么选择STM32CubeMX？

说白了，STM32CubeMX就是ST官方出的一款图形化配置工具。你点点鼠标，它就能帮你生成初始化代码。对于FOC这种需要精确配置定时器、ADC、PWM的场合，手动写寄存器配置？那太容易出错了。

我个人习惯是：所有外设的时钟、引脚、中断优先级，全在CubeMX里配好。生成代码后，我只在用户代码区（就是那个/* USER CODE BEGIN */和/* USER CODE END */之间）写自己的逻辑。这样哪怕以后要升级HAL库版本，重新生成代码也不会覆盖我的工作。

小技巧： 每次修改CubeMX配置后，记得先“Clean Project”再重新生成代码。不然有时候旧文件残留，编译会报一些莫名其妙的错误。

3.2 IDE选择：Keil、IAR还是STM32CubeIDE？

这个问题，我估计每个工程师都纠结过。我直接说结论：

IDE	优点	缺点	我的建议
Keil MDK	老牌、稳定、调试器兼容性好	代码补全弱、界面老旧、收费	如果你在公司用，那就用这个
IAR EWARM	编译优化强、代码体积小	界面反人类、收费	适合做产品量产时用
STM32CubeIDE	免费、基于Eclipse、集成CubeMX	启动慢、偶尔卡顿	个人学习首选，我目前主力用这个

嗯，这里要注意：不管你选哪个IDE，核心的代码逻辑是完全一样的。区别只在于编译器和调试器的配置。我个人建议初学者直接用STM32CubeIDE，免费、省心，而且它和CubeMX是深度集成的，省去很多导入导出的麻烦。

3.3 基础工程模板建立——以STM32F103为例

好，咱们开始动手。我以最常用的STM32F103C8T6（蓝色 pill 板）为例，一步步来。

3.3.1 新建CubeMX工程

打开STM32CubeMX，点击“New Project”。
在Part Number搜索框输入“STM32F103C8”，选中后双击。
系统会问你要不要初始化所有外设？选“No”，咱们从头配。

3.3.2 配置时钟树

FOC对PWM频率和ADC采样时序要求很严格，时钟必须稳。我一般这样配：

HSE：8MHz外部晶振（蓝色pill板标配）
PLL：倍频到72MHz（HSE 8MHz × 9 = 72MHz）
APB1：36MHz（定时器时钟要特别注意，因为APB1上的定时器时钟是APB1的两倍，即72MHz）
APB2：72MHz

为什么APB1定时器时钟是72MHz？因为STM32F103的APB1预分频器如果设为2分频，那么定时器时钟会自动翻倍。这个细节我在项目中踩过坑——当时PWM频率怎么算都不对，查了半天才发现是时钟树理解错了。

  关键点： 在CubeMX的Clock Configuration页面，确保APB1的“Timer Clocks”显示为72MHz。如果不是，调整APB1预分频器。

3.3.3 配置FOC所需外设

FOC最少需要哪些外设？我列个清单：

外设	用途	配置要点
TIM1	生成6路互补PWM（带死区）	选择“PWM Generation CH1/2/3”，使能互补输出和刹车功能
TIM2/TIM3	编码器接口（读取电机位置）	选择“Encoder Mode”，配置TI1和TI2为输入
ADC1	采样相电流（两相或三相）	选择“Injected Conversion Mode”，触发源选TIM1_TRGO
USART1	调试输出（打印电流、速度等）	波特率115200，8N1

嗯，这里要注意：ADC的触发源一定要选对。FOC要求电流采样和PWM同步，一般用TIM1的TRGO事件来触发ADC注入组转换。我曾经因为选错了触发源，导致采样到的电流全是噪声，波形惨不忍睹。

3.3.4 生成代码

配置完成后，点击“Project Manager”标签：

Project Name：比如“FOC_Basic_Template”
Project Location：选一个干净的文件夹
Toolchain / IDE：选你用的IDE（我选STM32CubeIDE）
Generate Code：点击，等几秒钟

代码生成后，打开工程。你会看到一堆文件夹，但核心文件就几个：

Core/
  ├── Inc/          // 头文件
  ├── Src/          // 源文件
  │   ├── main.c
  │   ├── stm32f1xx_hal_msp.c
  │   └── stm32f1xx_it.c
  └── Startup/      // 启动文件
Drivers/
  ├── CMSIS/
  └── STM32F1xx_HAL_Driver/

3.4 验证工程——点个灯先

别急着写FOC代码。先验证工程能不能跑起来。我习惯先点个灯：

// 在 main.c 的 USER CODE BEGIN 2 区域添加
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET);  // 蓝色pill板上的PC13是LED

while (1)
{
  HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
  HAL_Delay(500);
}

编译、下载。如果LED以1Hz频率闪烁，恭喜你，环境搭建成功！

避坑指南： 我曾经遇到过下载后LED不亮的情况。检查了半小时，发现是CubeMX里PC13的GPIO模式没配成“Output Push-Pull”。所以，一定要在CubeMX的Pinout页面确认每个引脚的配置。

3.5 建立可复用的工程模板

点灯成功后，咱们把这个工程保存为模板。以后做新项目，直接复制这个文件夹，改个名字就行。

我的模板结构是这样的：

FOC_Template/
  ├── Core/
  │   ├── Inc/
  │   │   ├── main.h
  │   │   ├── foc.h          // FOC算法头文件
  │   │   ├── motor.h        // 电机参数定义
  │   │   └── ...
  │   └── Src/
  │       ├── main.c
  │       ├── foc.c          // FOC算法实现
  │       ├── motor.c        // 电机控制函数
  │       └── ...
  ├── Drivers/
  ├── .project
  └── .cproject

注意：不要直接在CubeMX生成的工程里改。每次重新生成代码，CubeMX会覆盖你的修改。正确的做法是：把用户代码写在/* USER CODE BEGIN */和/* USER CODE END */之间，这样CubeMX就不会动它。

我的习惯： 在main.c的USER CODE区域里，只放初始化调用和主循环框架。具体的FOC算法、电机控制逻辑，全部写在单独的foc.c和motor.c里。这样代码清晰，也方便移植。

3.6 本章小结

好，咱们把这一章的核心点捋一捋：

CubeMX：图形化配置外设，生成初始化代码。记住，只配外设，不写业务逻辑。
IDE：个人学习用STM32CubeIDE，公司项目看团队习惯。
模板：建立一个干净的工程模板，以后所有FOC项目都基于它。
验证：先点灯，确保工程能编译、下载、运行。

下一章，咱们就要开始配置PWM和ADC了。这两个是FOC的“手脚”，配置不好，电机根本转不起来。到时候我会详细讲死区时间怎么算、采样触发怎么同步。嗯，做好准备。

对了，如果你在搭建环境时遇到问题，别硬扛。去网上搜一下“STM32CubeMX FOC 模板”，有很多现成的例子可以参考。我当年也是这么过来的。

📚 课程目录