2. 开发环境搭建：从CubeMX到串口调试
说实话，很多初学者一上来就急着写代码，结果卡在环境配置上大半天。我见过太多人花了两周调一个printf重定向，最后发现是宏定义没开。这一章，咱们就把这些基础打牢。
本章核心目标：用20分钟搭好一个能跑、能调、能算的运动控制开发环境。
2.1 STM32CubeMX配置工程——别小看这一步
我个人习惯，不管项目多简单，都用CubeMX生成初始化代码。为什么？因为手动配时钟树太容易翻车了。
打开CubeMX，选芯片——我用的是STM32F407ZGT6，你们可以根据手头板子选。关键配置点就这几个：
- RCC时钟：外部晶振HSE，主频拉到168MHz。运动学解算对算力有要求，别省这点。
- USART1：异步模式，波特率115200。我习惯用USART1做调试口，因为它的TX/RX默认在PA9/PA10，好找。
- GPIO：至少留4个输出口接逻辑分析仪，方便看PWM和方向信号。
- 定时器：TIM1和TIM8配置为PWM输出，用于电机控制。
小技巧：在CubeMX的Pinout视图里，把用到的引脚标上自定义标签（比如“MOTOR1_PWM”），生成的代码里注释会自动带上，后期维护省大事。
生成代码时，记得选“Copy only the necessary library files”，别把整个HAL库都拷进来，工程会臃肿得吓人。
2.2 Keil/IAR工程设置——编译器才是真战场
CubeMX生成的工程，直接打开编译大概率报错。为什么？因为优化等级和浮点单元没配对。
以Keil为例，我建议这样设置：
| 设置项 | 推荐值 | 说明 |
|---|---|---|
| Optimization | -O2 | 平衡代码大小和速度，运动控制别用-O0 |
| FPU | Single Precision | STM32F4有硬件FPU，不开就是浪费 |
| One ELF Section per Function | 勾选 | 方便链接器剔除无用代码 |
| C99 Mode | 勾选 | 很多运动学库用了C99语法 |
注意：IAR用户记得在General Options里把FPU选为“VFPv4”，否则浮点运算会触发硬件错误。我曾经因为这个排查了整整一个下午。
2.3 printf重定向与串口调试——调试的命脉
做运动控制，没有printf就像开车没有仪表盘。但STM32的printf默认是往半主机模式输出的，你得把它重定向到串口。
代码其实很简单，在usart.c里加这么一段：
#include <stdio.h>
int fputc(int ch, FILE *f)
{
// 等待发送完成
while(!(USART1->SR & USART_SR_TXE));
USART1->DR = (uint8_t)ch;
return ch;
}
// 如果要用scanf，再加这个
int fgetc(FILE *f)
{
while(!(USART1->SR & USART_SR_RXNE));
return (int)(USART1->DR & 0xFF);
}然后别忘了在工程设置里勾选“Use MicroLIB”。Keil和IAR都有这个选项，它会让printf的体积缩小80%。
避坑指南：我曾经在IAR里忘了勾选“Enable semihosting”，结果printf死活不输出。后来发现IAR默认是半主机模式，必须手动关掉。在IAR的General Options里，把Semihosting改为None。
调试时，我习惯用这样的输出格式：
printf("[MOTOR1] Pos: %.3f mm, Vel: %.2f mm/s, Err: %.4f\n",
motor1.position, motor1.velocity, motor1.error);小数点后保留的位数很关键——位置精度给3位，速度给2位，误差给4位。这样一眼就能看出问题在哪。
2.4 DSP库与ARM_MATH宏定义——算力的加速器
运动学解算里全是三角函数、矩阵运算。如果纯靠C库的sin/cos，一个周期算下来CPU占用率能到60%以上。这时候DSP库就派上用场了。
STM32的DSP库是免费的，但很多人不知道怎么正确启用。步骤很简单：
- 从STM32Cube_FW_F4包里找到
Drivers/CMSIS/DSP/Lib，把arm_cortexM4lf_math.lib加到工程里。 - 在编译器预定义里加上
ARM_MATH_CM4和ARM_MATH_MATRIX_CHECK。 - 包含头文件
arm_math.h。
然后你就可以用这些函数了：
#include "arm_math.h"
float32_t theta = 1.5708f; // 90度
float32_t sin_val, cos_val;
// 用DSP库的sin/cos，比标准库快3倍
arm_sin_cos_f32(theta, &sin_val, &cos_val);
// 矩阵运算——运动学正解必备
arm_matrix_instance_f32 A;
float32_t A_data[9] = {1,2,3,4,5,6,7,8,9};
arm_mat_init_f32(&A, 3, 3, A_data);
float32_t det;
arm_mat_det_f32(&A, &det);性能对比：我用逻辑分析仪实测过，同样计算一组3x3矩阵的逆，标准C库耗时约120μs，DSP库只要35μs。对于100Hz的控制环，这85μs的差距就是生与死的区别。
还有个容易忽略的点：ARM_MATH_MATRIX_CHECK这个宏。它会在运行时检查矩阵维度是否匹配。调试阶段建议开着，等产品稳定了再关掉，能再省一点算力。
2.5 本章知识体系
下面这张图把整个开发环境搭建的脉络理清楚了：