2. STM32CubeMX工具详解：新建工程、时钟树配置、引脚配置、生成初始化代码
说实话，很多初学者拿到STM32开发板，第一件事就是打开Keil开始写代码。我当年也是这样，结果光配置寄存器就折腾了一整天。后来用了CubeMX，才发现——原来工具能帮我们省掉这么多重复劳动。
这一章，我就带你手把手过一遍CubeMX的核心操作。你跟着走一遍，以后建工程就跟吃饭一样简单。
2.1 新建工程——从零开始的第一步
打开CubeMX，界面很清爽。点击“New Project”，会弹出一个芯片选择窗口。
这里有个小技巧：别直接搜型号。你想想看，STM32型号那么多，F103、F407、H743...一个个翻多累。我习惯在“Part Number”里输入关键数字，比如“103”，然后从筛选结果里选。这样快很多。
选好芯片后，点“Start Project”。你会看到主界面，左边是外设列表，中间是芯片引脚图，右边是配置面板。
嗯，这里要注意：第一次打开时，CubeMX会自动帮你初始化一些外设，比如RCC（复位和时钟控制）。别慌，这是正常的。我们后面会一步步配置。
2.2 时钟树配置——芯片的心脏跳动
时钟树，说白了就是给芯片各个模块分配“心跳”。CPU要跑多快？定时器要多精准？USB需要48MHz？这些都靠时钟树来搞定。
点击“Clock Configuration”标签页，你会看到一张复杂的图。别被吓到，我教你一个口诀：先选源，再设频，最后看输出。
第一步：选择时钟源
- HSI：内部高速振荡器，8MHz。精度一般，但省事。
- HSE：外部高速晶振，通常是8MHz或25MHz。精度高，我一般都用它。
- PLL：锁相环，可以把频率倍上去。比如HSE 8MHz，通过PLL倍频到72MHz。
我在项目中遇到过一个问题：用HSI做USB时钟，结果USB通信老是丢包。后来换成HSE + PLL，问题就解决了。所以涉及通信外设时，尽量用外部晶振。
第二步：设置系统时钟频率
在“HCLK”输入框里直接输入你想要的频率，比如72。CubeMX会自动帮你计算PLL的分频和倍频系数。如果算出来是红色，说明这个频率不支持。那就调低一点，或者换个晶振。
第三步：检查外设时钟
时钟树右边会列出各个外设的时钟源和频率。比如APB1总线上的定时器，时钟频率是多少？APB2上的ADC呢？确保每个外设都拿到了它需要的时钟。
这里有个知识点：APB1和APB2的时钟频率不同。APB1最高36MHz，APB2最高72MHz。所以高速外设（比如SPI、USART）尽量挂在APB2上。
2.3 引脚配置——把芯片的“手脚”安排好
回到“Pinout & Configuration”标签页。你会看到芯片引脚图，每个引脚都可以配置功能。
配置方法很简单：点击引脚，选择功能。比如你想用PA0作为GPIO输出，点一下PA0，选“GPIO_Output”。想用PA9作为USART1的TX，点一下PA9，选“USART1_TX”。
但这里有个问题：引脚冲突。比如你选了PA9做USART1_TX，又选了PA9做SPI1_SCK，CubeMX会报错。它会用红色高亮冲突的引脚。
另外，别忘了配置GPIO的初始状态。比如输出电平是高还是低？上拉还是下拉？输出速度是多少？这些在“GPIO Settings”里设置。
我习惯把不用的引脚都设为“Analog”模式，这样功耗最低。如果你做电池供电的产品，这个细节能省不少电。
2.4 生成初始化代码——一键搞定
配置完所有外设后，点击“Project”菜单 -> “Generate Code”。CubeMX会问你几个问题：
- Toolchain / IDE：选MDK-ARM（Keil）还是STM32CubeIDE？我一般用Keil，因为调试方便。
- Firmware Package：选哪个版本的HAL库？建议选最新的稳定版。
- Project Name & Location：工程名和路径。注意路径不要有中文，否则Keil编译会报错。
点“Generate”，几秒钟后，代码就生成了。打开Keil工程，你会看到：
- main.c：主函数，里面有个while(1)循环。
- stm32f1xx_hal_msp.c：外设的初始化函数，比如HAL_UART_MspInit()。
- stm32f1xx_it.c：中断服务函数。
你只需要在main.c的while(1)里写你的业务逻辑就行。比如点亮LED、读取传感器数据、发送串口数据。
/* USER CODE BEGIN */和/* USER CODE END */。下次重新生成代码时，你写的部分不会被覆盖。
2.5 知识体系总览
为了让你更直观地理解这一章的内容，我画了一张流程图。它展示了从新建工程到生成代码的完整路径：
这张图把整个流程串起来了。你跟着走一遍，就能从零开始创建一个可用的工程。记住：时钟是基础，引脚是桥梁，代码是灵魂。三者缺一不可。
2.6 避坑指南——我踩过的那些坑
最后，分享几个我实际项目中遇到的坑，你遇到了能少走弯路：
- 时钟配置后芯片不工作：检查PLL的配置参数。比如F103的PLL倍频系数不能超过16，否则芯片直接罢工。
- 引脚配置后外设不响应：看看GPIO的复用功能有没有开启。比如USART的TX/RX引脚，需要在GPIO配置里选“Alternate Function”。
- 生成代码后编译报错：检查工程路径有没有中文或空格。CubeMX生成的代码对路径很敏感。
- 重新生成代码后，我写的代码丢了：记住，只在
/* USER CODE */区域写代码。其他地方会被覆盖。
嗯，这一章的内容就到这里。你跟着操作一遍，应该就能掌握CubeMX的基本用法了。工具这东西，多用几次就熟了。
公众号:蓝海资料掘金营，微信deep3321