2. STM32生态系统与开发环境搭建：STM32CubeMX配置、HAL库与LL库选择、Keil/IAR工程建立、DAC与定时器基础配置

好，咱们正式开始动手了。做FOC矢量控制，第一步不是写代码，而是把开发环境收拾利索。我见过太多新手一上来就怼代码，结果编译报错、下载失败、外设不工作，折腾半天才发现是工具链没配好。说白了，工欲善其事，必先利其器。这一章，我就带你把这套工具链捋顺。

2.1 STM32CubeMX：图形化配置的利器

我个人习惯，所有STM32项目都用CubeMX打底。为什么？因为它能帮你省掉至少30%的底层配置时间。你想想看，FOC控制要用到定时器、ADC、DAC、PWM、编码器接口……这些外设的时钟、引脚、中断优先级，手动配一遍得翻多少页数据手册？

打开CubeMX，选芯片。我做FOC常用STM32F405或STM32G4系列，带浮点运算单元（FPU），算电流环快。选好芯片后，第一步是配时钟树。这里有个坑——FOC的PWM频率通常设在20kHz左右，ADC采样需要同步触发，时钟源必须稳。

嗯，这里要注意：如果你用HAL库，CubeMX会自动生成初始化代码。但LL库不会帮你做所有事。我建议初学者先用HAL库上手，等摸透了再切LL库追求极致性能。

2.2 HAL库 vs LL库：怎么选？

这个问题，几乎每个学生都问过我。我的回答很简单：

对比项	HAL库	LL库
代码量	大，封装层次多	小，接近寄存器操作
易用性	高，回调函数机制	低，需要手动管理状态
实时性	一般，中断响应有延迟	高，直接操作寄存器
适合场景	原型验证、学习阶段	量产产品、性能敏感场合

我做FOC项目时，电流环和速度环用LL库写，因为要纳秒级响应；通信和状态机用HAL库，因为省事。说白了，混着用也没问题，只要你不把两种库的API搞混就行。

2.3 Keil/IAR工程建立：别踩这些坑

CubeMX生成代码后，下一步就是导入IDE。我个人偏爱Keil，因为调试器好用。但IAR的编译优化确实更强。这里我重点说Keil的配置：

1. 芯片选型：在Keil的Device中选对型号，别选错了系列
2. Flash烧录算法：如果下载失败，八成是这里没配对
3. C/C++编译器选项：开启FPU（-mfpu=fpv4-sp-d16），否则浮点运算慢10倍
4. 优化等级：调试阶段用-O0，发布阶段用-O2

导入工程后，第一件事是编译。如果报错，先检查头文件路径。CubeMX生成的工程通常会自动配好，但如果你手动添加了文件，记得在Include Paths里加上。

2.4 DAC基础配置：输出模拟量

FOC控制中，DAC用来输出电流环的参考值或实际值，方便用示波器观察。说白了，就是把数字量变成模拟电压。

配置DAC其实很简单：

// 使用HAL库配置DAC
DAC_HandleTypeDef hdac;

void MX_DAC_Init(void)
{
    hdac.Instance = DAC;
    HAL_DAC_Init(&hdac);
    
    // 配置通道1，输出到PA4引脚
    DAC_ChannelConfTypeDef sConfig = {0};
    sConfig.DAC_Trigger = DAC_TRIGGER_NONE;  // 软件触发
    sConfig.DAC_OutputBuffer = DAC_OUTPUTBUFFER_ENABLE;
    HAL_DAC_ConfigChannel(&hdac, &sConfig, DAC_CHANNEL_1);
}

// 输出一个值
void DAC_SetValue(uint16_t value)
{
    HAL_DAC_SetValue(&hdac, DAC_CHANNEL_1, DAC_ALIGN_12B_R, value);
    HAL_DAC_Start(&hdac, DAC_CHANNEL_1);
}

嗯，这里要注意：DAC的输出范围是0~3.3V，12位分辨率对应0~4095。如果你用示波器看，记得把探头的地线夹在GND上，否则波形会飘。

2.5 定时器基础配置：FOC的节拍器

定时器是FOC的灵魂。PWM生成、ADC触发、电流采样时序，全得靠它。我常用的配置是：

• 高级定时器TIM1/TIM8：生成三相互补PWM，带死区插入
• 通用定时器TIM2/TIM3：编码器接口，测转速
• 基本定时器TIM6/TIM7：触发ADC采样，同步电流环

配置一个20kHz的PWM，代码长这样：

// 定时器PWM配置（以TIM1为例）
TIM_HandleTypeDef htim1;

void MX_TIM1_Init(void)
{
    TIM_OC_InitTypeDef sConfigOC = {0};
    
    htim1.Instance = TIM1;
    htim1.Init.Prescaler = 0;               // 不分频
    htim1.Init.CounterMode = TIM_COUNTERMODE_CENTERALIGNED1;  // 中央对齐模式
    htim1.Init.Period = 4200 - 1;           // 168MHz / 4200 = 40kHz（中心对齐时频率翻倍）
    htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
    htim1.Init.RepetitionCounter = 0;
    HAL_TIM_PWM_Init(&htim1);
    
    // 配置通道1（U相）
    sConfigOC.OCMode = TIM_OCMODE_PWM1;
    sConfigOC.Pulse = 0;                    // 占空比初始为0
    sConfigOC.OCPolarity = TIM_OCPOLARITY_HIGH;
    sConfigOC.OCNPolarity = TIM_OCNPOLARITY_HIGH;
    sConfigOC.OCFastMode = TIM_OCFAST_DISABLE;
    sConfigOC.OCIdleState = TIM_OCIDLESTATE_RESET;
    sConfigOC.OCNIdleState = TIM_OCNIDLESTATE_RESET;
    HAL_TIM_PWM_ConfigChannel(&htim1, &sConfigOC, TIM_CHANNEL_1);
    
    // 通道2（V相）、通道3（W相）配置类似，略
}

我曾经在调试一个电机时，电流波形总是有毛刺。查了两天，最后发现是定时器模式配错了——用了边沿对齐。改成中央对齐后，波形干净得像教科书一样。

2.6 避坑指南：我踩过的那些雷

最后，分享几个我实际项目中遇到的坑：

• 时钟源选错：有一次我用了内部RC振荡器，结果PWM频率漂了5%，电机嗡嗡响。后来换成外部晶振，问题解决。
• DAC输出缓冲没开：输出阻抗太高，接示波器后波形变形。记得把OutputBuffer使能。
• 定时器同步没配：ADC触发和PWM不同步，电流采样值忽大忽小。用TIM_TRGO触发ADC就对了。
• 中断优先级乱设：电流环中断被其他中断打断，导致控制周期抖动。把TIM1中断优先级设到最高（0），其他中断往后排。

好了，环境搭建就到这里。下一章我们开始写FOC的核心算法——Clark变换和Park变换。到时候你会看到，这些数学公式在代码里是怎么落地实现的。