2. HAL库基础：STM32CubeMX工程配置、HAL库时钟树、GPIO与定时器基础
各位同学，咱们直接进入正题。
做电机控制，说白了就是跟硬件寄存器打交道。但你要是直接操作寄存器，那代码量能写到手抽筋。HAL库就是ST官方帮我们封装好的一层“中间人”。你想想看，我们只需要调用几个函数，就能完成对底层硬件的控制，多省心。
我个人习惯，不管项目大小，第一步永远是先把工程环境搭好。这一步要是乱了，后面全是坑。今天我们就从STM32CubeMX的配置开始，把时钟树、GPIO和定时器这几个电机控制的核心基础，一个一个捋清楚。
2.1 从CubeMX开始：一个工程的生命起点
我刚开始用STM32那会儿，还是用标准库。每次新建工程都要手动复制启动文件、链接脚本，稍不留神就报错。后来换了HAL库加CubeMX，感觉就像从手动挡换成了自动挡。
CubeMX能帮我们做什么？说白了就是图形化配置。你点点鼠标，它自动生成初始化代码。我们来看看电机控制项目里，最关键的几个配置步骤。
核心配置流程：
- 选择芯片：根据你的板子选型号，比如我常用的STM32F103C8T6或STM32F407VET6。
- 配置时钟源：外部晶振还是内部振荡器？电机控制对时序要求高，我建议用外部晶振。
- 配置外设：定时器、GPIO、ADC、PWM输出通道，这些是电机控制的“手脚”。
- 生成代码：选好IDE（我一般用MDK-ARM或STM32CubeIDE），一键生成。
嗯，这里要注意一点：生成代码后，不要手动修改CubeMX自动生成的那部分文件。我曾经有个同事，非要自己改main.h里的引脚定义，结果下次重新生成代码时全被覆盖了，排查了半天。正确的做法是，把你的业务逻辑写在“用户代码区”里，就是那个 /* USER CODE BEGIN */ 和 /* USER CODE END */ 之间的位置。
2.2 时钟树：电机控制的“心跳”
时钟树这东西，很多初学者觉得抽象。其实你就把它想象成整个芯片的“心跳”。CPU要跑多快？定时器要计多准？全靠时钟树来分配。
在电机控制中，PWM的频率和分辨率直接受时钟影响。比如你要产生20kHz的PWM，如果定时器时钟配错了，出来的频率可能差十万八千里。
我们来看一个典型的时钟树配置流程：
/* 以STM32F407为例，配置系统时钟为168MHz */
/* 1. 选择HSE（外部高速晶振）作为时钟源 */
/* 2. 配置PLL锁相环，将8MHz晶振倍频到168MHz */
/* 3. 配置AHB、APB1、APB2总线分频系数 */
/* - AHB: 168MHz
- APB1: 42MHz (定时器时钟84MHz)
- APB2: 84MHz (定时器时钟168MHz) */我的经验之谈：
APB1和APB2的定时器时钟是翻倍的。比如APB1设置为42MHz，但挂载在APB1上的定时器实际时钟是84MHz。为什么？因为APB1的分频系数不为1时，定时器会自动倍频。这个细节我当年踩过坑，PWM频率怎么算都不对，后来才发现是忘了这个倍频规则。
在CubeMX的Clock Configuration界面里，你可以直观地看到整个时钟树的流向。我个人习惯是把所有外设的时钟都配置好后再生成代码，免得后面再回头改。
2.3 GPIO：控制电机的“手脚”
GPIO是芯片和外部世界打交道的接口。电机控制里，GPIO主要干三件事：
- 控制方向：通过高低电平控制电机正反转
- 使能信号：控制驱动芯片的使能引脚
- 读取反馈：读取编码器信号或限位开关状态
配置GPIO时，有几点要特别注意：
| 参数 | 推荐配置 | 说明 |
|---|---|---|
| 输出类型 | 推挽输出 | 驱动能力强，适合控制信号 |
| 上拉/下拉 | 根据外部电路 | 防止引脚悬空时电平不确定 |
| 速度 | High 或 Very High | 电机控制信号频率高，速度要跟上 |
我曾经踩过的坑：
有一次做直流有刷电机驱动，我用GPIO直接控制MOS管的栅极。结果电机一启动，芯片就复位。查了半天，发现是GPIO的驱动电流不够，导致MOS管开关不彻底，产生了巨大的尖峰干扰。后来我在GPIO和MOS管之间加了一级驱动芯片，问题就解决了。所以，GPIO直接驱动大负载时要小心，最好加缓冲。
2.4 定时器：电机控制的“节拍器”
定时器是电机控制里最重要的外设，没有之一。PWM生成、编码器计数、速度环控制周期，全得靠它。
STM32的定时器分三类：
- 基本定时器：只能计时，不能输出PWM
- 通用定时器：有PWM输出、输入捕获、编码器接口
- 高级定时器：在通用基础上，多了互补输出、刹车功能，专门为电机控制设计
做电机控制，我强烈建议用高级定时器。比如TIM1和TIM8，它们支持三相PWM互补输出，还能硬件死区插入。你想想看，要是用手动方式在软件里插入死区，不仅代码复杂，还容易出问题。
我们来看一个PWM输出的配置示例：
/* 配置TIM1输出PWM，频率20kHz，占空比50% */
/* 定时器时钟 = 168MHz (APB2) */
/* 预分频器 = 0 */
/* 自动重装载值 = 8400 - 1 */
/* 则PWM频率 = 168MHz / 8400 = 20kHz */
TIM_HandleTypeDef htim1;
htim1.Instance = TIM1;
htim1.Init.Prescaler = 0;
htim1.Init.CounterMode = TIM_COUNTERMODE_CENTERALIGNED1;
htim1.Init.Period = 8400 - 1;
htim1.Init.ClockDivision = TIM_CLOCKDIVISION_DIV1;
htim1.Init.RepetitionCounter = 0;
htim1.Init.AutoReloadPreload = TIM_AUTORELOAD_PRELOAD_ENABLE;
HAL_TIM_PWM_Init(&htim1);关于计数模式的选择：
边沿对齐模式和中心对齐模式有什么区别？边沿对齐模式简单，但PWM中心点会随占空比变化。中心对齐模式则固定了PWM的中心点，这对电机控制中的电流采样非常有利。我一般用中心对齐模式，采样时刻更容易对齐。
2.5 本章知识体系总览
说了这么多，我们来画个图，把今天的内容串起来。这张图展示了从CubeMX配置到最终电机控制的核心链路。
这张图把今天讲的内容串起来了。从CubeMX配置开始，到时钟树、GPIO、定时器三个核心模块，最后汇聚到电机控制的基础框架。后面的章节，我们会在这个框架上不断添砖加瓦。
好了，这一章的内容就到这里。配置好工程、理解时钟树、掌握GPIO和定时器，你就已经迈出了电机控制的第一步。这些东西看起来基础，但基础不牢，地动山摇。我见过太多人一上来就调PID、搞FOC，结果连PWM频率都算不对，最后折腾半天发现是时钟配错了。
下一章，我们会深入PWM生成的细节，看看HAL库背后到底是怎么操作寄存器的。到时候，你会对今天讲的定时器有更深的理解。