2. STM32时钟与GPIO基础配置

好，咱们正式开始动手。这一章我会带你走一遍CubeMX最核心的四个步骤：新建工程、选芯片、配时钟、设GPIO。这四个动作你以后每个项目都会重复，所以一开始就养成好习惯，后面能省不少事。

2.1 新建工程与芯片选型

打开CubeMX，你会看到两个入口：

• New Project —— 从零开始新建
• Load Project —— 打开已有.ioc文件

我个人的习惯是，每次新项目都点New Project，哪怕只是做个测试。因为CubeMX的工程文件很小，重新生成比复制粘贴更干净。

进入芯片选择界面后，你会看到三个筛选维度：

筛选方式	适用场景	我的建议
Part Number	已知具体型号	最常用，直接搜STM32F103C8T6
Series	按系列浏览	适合选型阶段，比如F1/F4/G0
Core	按内核筛选	M0/M3/M4/M7，很少用这个

我一般直接在Part Number搜索框里输入型号，比如STM32F103C8T6，然后双击选中。这里有个小坑——注意后缀。C8是64KB Flash，CB是128KB Flash，T6是工业级温度范围。我在项目里曾经因为选错Flash容量，编译到最后发现空间不够，只能换芯片重画PCB。嗯，那感觉真不好受。

2.2 配置时钟树（HSE/LSE/PLL）

时钟树是STM32的命脉。说白了，CPU能跑多快、外设能不能正常工作，全看时钟配得对不对。

进入Clock Configuration标签页，你会看到一张复杂的时钟树图。别慌，咱们只关注三个关键节点：

• HSE（高速外部晶振）—— 通常接8MHz晶振
• LSE（低速外部晶振）—— 通常接32.768kHz，给RTC用
• PLL（锁相环）—— 把低频倍频到高频

我刚开始学的时候，看到那个时钟树图就头疼。后来发现一个规律：先选时钟源，再配PLL，最后看系统时钟。三步走，不会乱。

以STM32F103C8T6为例，标准配置是这样的：

HSE = 8MHz（外部晶振）
PLL倍频 = 9倍
系统时钟 = 8MHz × 9 = 72MHz
APB1 = 36MHz（最大36MHz）
APB2 = 72MHz（最大72MHz）

操作步骤：

1. 在HSE旁的下拉框选择Crystal/Ceramic Resonator
2. 在PLL Source选择HSE
3. 在PLL Mul输入x9
4. 在System Clock Mux选择PLLCLK
5. 观察右上角的HCLK数值，确认是72MHz

LSE的配置更简单：在LSE旁选择Crystal/Ceramic Resonator即可。如果你不用RTC，LSE可以不配，省一颗晶振的钱。

2.3 配置GPIO输出（点亮LED）

时钟配好了，接下来让芯片干点实事——点亮一颗LED。这是嵌入式界的"Hello World"。

切换到Pinout & Configuration标签页，你会看到芯片的引脚图。找到你要用的引脚，比如PC13（很多STM32最小系统板把LED接在这个脚上）。

操作步骤：

1. 点击PC13引脚
2. 在弹出的菜单中选择GPIO_Output
3. 在右侧的GPIO配置面板中，设置：

参数	推荐值	说明
GPIO output level	Low	初始状态，LED通常低电平点亮
GPIO mode	Output Push Pull	推挽输出，最常用
GPIO Pull-up/Pull-down	No pull-up/pull-down	输出模式不需要上下拉
Maximum output speed	Low	控制LED，低速就够了
User Label	LED	自定义名称，代码中直接用

这里有个细节：User Label。我强烈建议你给每个引脚起个有意义的名字，比如LED、KEY、I2C1_SCL。这样生成的代码里，宏定义就是LED_Pin、LED_GPIO_Port，可读性高很多。我见过有人所有引脚都用默认的GPIO_PIN_0，代码写到最后自己都分不清哪个是哪个。

2.4 生成代码与验证

配置完成后，点击右上角的GENERATE CODE按钮。CubeMX会问你工程名称、保存路径、IDE类型（我选MDK-ARM）。

生成完成后，打开工程，找到main.c，在while(1)循环里加上：

HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);
HAL_Delay(500);

编译下载，如果LED以1秒的频率闪烁，恭喜你，成功了。

如果没亮，别急。检查三件事：

• LED正负极接反了没？
• 限流电阻焊了没？（一般330Ω~1kΩ）
• 引脚号对不对？PC13不是所有板子都接LED

我记得有一次帮同事调板子，折腾了半小时发现LED是低电平点亮，他代码里写的是HAL_GPIO_WritePin(..., GPIO_PIN_SET)。嗯，这种低级错误我也犯过。

2.5 本章知识体系

下面这张图把本章的核心流程串起来了，你可以对照着回顾一下：

这张图把整个流程分成了6个主步骤，其中时钟树配置又拆成了4个子步骤。你照着这个顺序走，基本不会漏掉什么。