第二章 开发环境搭建：工欲善其事，必先利其器
做嵌入式开发，环境搭建是第一道坎。我见过太多新手卡在这一步，工具链没配好，连个LED都点不亮，信心直接被打没了。今天咱们就把这套环境彻底捋顺，你跟着一步步来，保证能跑起来。
2.1 Keil MDK安装与注册
Keil MDK，说白了就是ARM内核MCU的标配IDE。我最早用Keil还是C51时代，那时候界面土得掉渣，现在好多了。
安装步骤：
- 去ARM官网下载MDK-ARM最新版（目前是5.38或5.39）
- 双击安装包，一路Next，路径别带中文
- 安装完成后，桌面会出现uVision图标
注意：安装路径不要有空格和中文！我有个同事把Keil装到“Program Files (x86)”里，结果编译某些老工程时路径解析出错，折腾了一下午才发现是这个问题。
注册破解：
Keil是收费软件，但我们可以用注册机生成License。嗯，这里只讨论技术流程：
- 以管理员身份运行Keil uVision
- 点击 File → License Management
- 复制CID码
- 运行注册机（Keygen），粘贴CID，选择ARM
- 点击Generate生成激活码
- 将激活码粘贴回Keil，点击Add LIC
小技巧：注册机最好放在Keil安装目录下运行，否则可能生成失败。我曾经因为放桌面，死活激活不了，后来才发现是权限问题。
2.2 STM32CubeMX配置
CubeMX是ST官方出的图形化配置工具。你想想看，以前配时钟要翻几百页的Reference Manual，现在点点鼠标就搞定，省了多少事。
安装与首次使用：
- 从ST官网下载STM32CubeMX（需要注册账号）
- 安装时选择Java运行环境（自带JRE）
- 打开后，点击“ACCESS TO MCU SELECTOR”
- 搜索STM32F103C8（咱们课程用的主控）
我个人习惯是先把外设全部禁用，再逐个开启需要的。这样生成的代码干净，不会有一堆没用的初始化函数。
关键配置项：
| 配置项 | 推荐值 | 说明 |
|---|---|---|
| HSE时钟源 | Crystal/Ceramic Resonator | 外部8MHz晶振 |
| 系统时钟 | 72MHz | 通过PLL倍频得到 |
| 调试接口 | Serial Wire | 只用SWDIO和SWCLK |
| 堆栈大小 | Heap: 0x200, Stack: 0x400 | 根据实际需求调整 |
核心要点：时钟配置是重中之重！我遇到过项目跑到一半死机，查了三天发现是PLL配置参数算错了，导致系统时钟超频。CubeMX里时钟树会显示红色警告，千万别忽略。
2.3 HAL库与LL库选择
ST官方提供了两套库：HAL和LL。很多新手会纠结选哪个，其实没那么复杂。
HAL库（硬件抽象层）：
- 封装度高，函数名长但好理解
- 适合快速开发，不关心底层细节
- 代码量大，执行效率稍低
LL库（底层库）：
- 接近寄存器操作，代码精简
- 执行效率高，适合对时序敏感的场景
- 需要你对芯片寄存器有一定了解
我的建议是：项目初期用HAL库快速验证功能，后期对性能敏感的部分改用LL库。比如充电宝租借终端这种产品，主循环里用HAL库完全够用，但在SPI通信或PWM输出这种高频场景，我会切到LL库。
避坑指南：千万不要混用HAL和LL库操作同一个外设！我曾经在I2C驱动里，用HAL库初始化，然后用LL库读写数据，结果总线锁死了。因为两个库对寄存器的状态管理不一致。
2.4 J-Link/SWD调试器配置
调试器是嵌入式开发的“眼睛”。没有它，你只能靠猜。J-Link是SEGGER公司的产品，稳定可靠，我用了快十年了。
硬件连接：
J-Link引脚 STM32引脚
SWDIO → PA13 (SWDIO)
SWCLK → PA14 (SWCLK)
GND → GND
3.3V → VCC (可选，目标板供电)Keil中配置：
- 点击 Project → Options for Target
- 选择 Debug 选项卡
- 在右侧下拉框选择“J-LINK / J-TRACE Cortex”
- 点击 Settings，确认SWD模式，速度选1MHz（别选太高，容易不稳定）
- 切换到 Flash Download 选项卡，添加对应芯片的Flash算法
重要提醒：调试速度不是越高越好！我刚开始做项目时，把SWD速度设到10MHz，结果下载10次有8次失败。后来老老实实降到1MHz，稳如老狗。量产阶段可以适当提高，但开发阶段求稳。
2.5 工程模板建立
每次新建项目都从头配置一遍，太浪费时间了。我习惯维护一个干净的工程模板，所有项目都从它开始。
模板结构：
Project_Template/
├── Core/
│ ├── Inc/ # 头文件
│ ├── Src/ # 源文件
│ └── Startup/ # 启动文件
├── Drivers/
│ ├── CMSIS/ # ARM内核相关
│ └── STM32F1xx_HAL_Driver/ # HAL库
├── MDK-ARM/ # Keil工程文件
└── .cproject / .project模板配置要点：
- 开启微库（MicroLIB），减少代码体积
- 勾选“Use C99”模式
- 优化等级选-O0（开发阶段），发布时改-O2
- 添加必要的宏定义：USE_HAL_DRIVER, STM32F103xE
我的习惯：模板里只保留最基本的GPIO、UART、SysTick初始化。其他外设等用到时再通过CubeMX生成添加。这样模板清爽，不会有一堆用不到的代码。
嗯，到这里开发环境就搭好了。你可能会觉得步骤有点多，但相信我，这套流程走一遍，后面写代码会顺畅很多。下一章咱们就开始写第一个程序——点亮LED，让板子跟你打个招呼。