3、开发环境搭建：基于STM32CubeMX的工程配置、FreeRTOS移植、数学库（ARM DSP）集成、调试工具链
好，咱们正式开始动手了。
这一章，说白了就是「搭台子」。台子搭不好，后面唱戏肯定要摔跟头。我做电机控制这些年，见过太多人在环境配置上翻车——不是时钟配错了导致电机嗡嗡叫，就是FreeRTOS任务优先级设反了，系统直接死机。嗯，咱们今天就把这些坑一个个填平。
3.1 基于STM32CubeMX的工程配置
我个人习惯，所有STM32项目都用CubeMX生成初始化代码。为什么？省时间，而且不容易漏配置。你想想看，手动去翻寄存器手册配时钟树，那得多痛苦。
3.1.1 时钟树配置
做永磁同步电机控制，时钟是命根子。我建议主频直接拉满——比如STM32F407，配到168MHz。为什么？因为FOC算法里那些SVPWM、Clark/Park变换，全是浮点运算，主频越高，控制周期就能压得越短。
具体步骤：
- 选择外部晶振（HSE），比如8MHz
- PLL倍频到168MHz
- APB1总线时钟设为42MHz（别忘了定时器时钟要×2）
- APB2总线时钟设为84MHz
3.1.2 定时器配置
电机控制至少需要两个定时器：
- 高级定时器（TIM1/TIM8）：输出6路互补PWM，带死区插入
- 通用定时器（TIM2/TIM3）：触发ADC采样，或者做编码器接口
我一般把TIM1的PWM频率设在10kHz~20kHz之间。频率太低，电机噪音大；频率太高，开关损耗受不了。折中一下，16kHz是个好选择。
3.1.3 ADC配置
相电流采样需要两个ADC通道，最好是同步采样模式。我习惯用ADC1和ADC2的注入组，由定时器触发启动。这样能保证采样时刻和PWM中心对齐，避免开关噪声干扰。
3.2 FreeRTOS移植
为什么要在电机控制里用RTOS？说白了，因为任务多了。你要同时处理：
- FOC算法（1kHz~20kHz，硬实时）
- 速度环/位置环（1kHz左右）
- 通信任务（CAN/RS485，非实时）
- 人机交互（按键、显示，低优先级）
裸机跑这些，光是状态机就能把人绕晕。用FreeRTOS，每个任务各司其职，清爽多了。
3.2.1 移植步骤
CubeMX里直接勾选FreeRTOS，它会自动生成配置。但我建议你手动检查几个关键参数：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| configTICK_RATE_HZ | 1000 | 系统时钟节拍，1ms一个tick |
| configMINIMAL_STACK_SIZE | 128 | 最小任务栈，单位是字（4字节） |
| configMAX_PRIORITIES | 5 | 优先级数量，够用就行，别浪费 |
3.2.2 任务划分
我一般这样分：
- 最高优先级：FOC控制任务（1ms周期，用定时器中断触发）
- 中优先级：速度环计算、通信处理
- 低优先级：状态显示、按键扫描
3.3 数学库（ARM DSP）集成
做FOC，数学运算逃不掉。Clark变换、Park变换、SVPWM，全是三角函数和矩阵运算。用标准C的math.h？太慢了。ARM Cortex-M4带了FPU和DSP指令集，不用就浪费了。
3.3.1 添加DSP库
CubeMX里可以直接添加ARM CMSIS-DSP库。路径在：
Software Packs -> ARM -> CMSIS -> DSP勾上之后，编译器会自动链接。但要注意，有些版本的CubeMX不会自动添加全局宏定义，你得手动加上：
ARM_MATH_CM4
__FPU_PRESENT = 1
__FPU_USED = 13.3.2 常用函数
我常用的几个DSP函数：
arm_sin_f32()/arm_cos_f32()：查表法算三角函数，比math.h快5倍以上arm_clarke_f32()：Clark变换，直接调库arm_park_f32()：Park变换，一样有现成的arm_pid_init_f32()/arm_pid_f32()：PID控制器，省得自己写
3.4 调试工具链
写代码只占30%的时间，剩下70%都在调试。工具选对了，事半功倍。
3.4.1 硬件调试器
我推荐J-Link或ST-Link/V3。别用那种十几块钱的盗版ST-Link，下载慢不说，还经常断连。我在项目里吃过这个亏——调试到一半，调试器挂了，以为是代码问题，折腾了两天。
3.4.2 软件工具
| 工具 | 用途 | 备注 |
|---|---|---|
| STM32CubeIDE | 代码编辑、编译、调试 | 免费，集成了CubeMX |
| SEGGER Ozone | 高级调试 | 可以实时显示变量曲线 |
| 串口助手 | 打印调试信息 | 我习惯用Putty或SecureCRT |
3.4.3 调试技巧
- 用DAC输出内部变量：把电流、角度等变量通过DAC输出，用示波器看波形。比printf快多了。
- SEGGER RTT：比串口快，不占用额外引脚。我调试FOC时，用RTT打印控制周期耗时，精度到微秒级。
- 逻辑分析仪：抓PWM波形、编码器信号。几十块钱的Saleae克隆版就够用。
好了，环境搭建就这些。下一章咱们开始写真正的FOC代码——从电流采样到SVPWM输出，一步步来。到时候你会发现，台子搭得稳，后面写代码就像搭积木一样顺畅。