Keil5创建STM32工程——新手入门必看篇

手把手教你用Keil5搭建STM32工程——从零开始的实战指南

你是不是也曾在打开Keil μVision5后，面对“New Project”按钮犹豫不决？
“选哪个芯片？”、“启动文件要不要加？”、“为什么编译报错一堆未定义符号？”……
这些问题，每一个都可能让刚入门嵌入式开发的新手卡上半天。

别担心，这正是我们今天要彻底解决的问题。
本文不是一份照搬手册的操作清单，而是一次真实开发者视角下的全流程拆解。我们将以STM32F103C8T6（即常见的“蓝 pill”板）为例，一步步带你从空白IDE走到第一个LED闪烁程序成功运行，过程中讲清楚每一步背后的“为什么”。

一、环境准备：工具与资源就位

在动手之前，先确认你的开发环境已经准备好：

✅ 已安装Keil MDK-ARM 5.x 或以上版本
✅ 安装了ST-Link驱动或 J-Link 驱动（推荐使用ST-Link，成本低且兼容性好）
✅ 准备一块STM32F103C8T6 最小系统板
✅ 下载并安装Keil STM32F1系列设备支持包（通常在首次选择芯片时会提示自动下载）

⚠️ 小贴士：Keil免费版有32KB代码大小限制，刚好够跑一个基础GPIO例程，完全满足学习需求。若用于商业项目，请考虑授权问题。

二、创建工程：不只是点“下一步”

第一步：新建项目

打开 Keil μVision5，点击菜单栏：

Project → New μVision Project

保存路径建议单独建一个文件夹，比如STM32_LED_Blink，并命名为led_project.uvprojx。

接下来是关键一步 ——选择目标芯片。

第二步：精准匹配芯片型号

在弹出的“Select Device for Target”窗口中，输入：

STM32F103C8

你会看到多个选项，务必选择：

STMicroelectronics → STM32F103C8Tx

📌注意细节：
- 不要选成STM32F103CB或其他后缀，虽然都是LQFP48封装，但Flash大小不同（C8是64KB，CB是128KB），会影响链接脚本和启动文件。
- Keil会根据这个选择自动加载对应的寄存器定义头文件和设备描述信息。

点击 OK 后，Keil 会询问是否复制标准启动文件：

“Copy STM32F10x startup code to project folder and add to project?”

✅ 点击Yes

这一步至关重要！它会将正确的汇编启动文件startup_stm32f103xb.s自动加入工程。如果不勾选，后续很可能出现Reset_Handler not defined错误。

三、理解核心组件：它们都在做什么？

很多人以为点了“Next”就完事了，其实真正的坑才刚开始。要想写出能跑的程序，必须搞懂这几个关键模块的作用。

1. 启动文件：程序的“第一道门”

当你按下复位键，MCU 上电的第一件事是什么？
不是执行main()，而是运行一段汇编代码 —— 就是那个.s文件。

它的任务非常明确：
- 设置初始堆栈指针（MSP）
- 建立中断向量表
- 初始化.data段（把已初始化变量从Flash搬到RAM）
- 清零.bss段（未初始化变量置零）
- 调用SystemInit()初步配置时钟
- 最终跳转到 C 运行时入口__main，再进入main()

🔧 如果你发现程序根本没进 main，或者全局变量值不对，大概率是启动文件出了问题。

💡 特别提醒：STM32F103C8 的 Flash 大小为 64KB，起始地址为0x0800 0000，所以中断向量表必须放在这里。如果你改了偏移（比如用了Bootloader），记得在代码里设置SCB->VTOR = 0x0800 2000;。

2. CMSIS 标准：跨平台编程的“普通话”

CMSIS（Cortex Microcontroller Software Interface Standard）是 ARM 推出的一套统一接口规范。简单说，它让你可以用同样的方式访问所有 Cortex-M 内核的寄存器。

例如：

__enable_irq(); // 开启全局中断 SysTick_Config(1000); // 配置滴答定时器

这些函数背后都是通过core_cm3.h实现的，屏蔽了底层差异。

在 Keil 工程中，CMSIS 是默认启用的。你可以在：

Project → Options → C/C++ → Define

看到预定义宏：

USE_STDPERIPH_DRIVER, STM32F103xB

其中STM32F103xB表示中等容量产品（64KB Flash），正是 F103C8 所属类别。

3. system_stm32f1xx.c：系统时钟的“总调度”

这个文件负责初始化主时钟（SYSCLK）。默认情况下，STM32F1 使用内部高速时钟 HSI（8MHz），但大多数开发板都外接了 8MHz 晶振（HSE）。

如果你想让系统运行在 72MHz（PLL ×9），就必须修改SetSysClock()函数中的时钟配置逻辑。

不过好消息是：即使你不改，SystemCoreClock变量也会被正确更新为实际频率（通过SystemCoreClockUpdate()调用），这对延时函数、串口波特率计算非常重要。

四、编写第一个程序：直接操作寄存器点亮LED

我们现在来写一个最简化的 LED 闪烁程序，不依赖 HAL 库，纯粹通过寄存器操作实现。

步骤一：新建 main.c

右键 “Source Group 1” → Add New Item to Group…

创建一个新文件，命名为main.c。

步骤二：添加必要头文件路径

虽然 Keil 自动包含了 CMSIS 和设备头文件，但我们仍需手动确保编译器能找到它们。

进入：

Project → Options → C/C++

在 “Include Paths” 中添加以下路径（如果未自动生成）：

.\CMSIS .\Device\ST\STM32F1xx\Include

同时，在 “Define” 框中保留：

STM32F103xB, USE_STDPERIPH_DRIVER

步骤三：写代码！

#include "stm32f1xx.h" // 简单延时函数 static void delay(uint32_t count) { for(volatile uint32_t i = 0; i < count; i++); } int main(void) { // 更新系统时钟变量（读取当前时钟频率） SystemCoreClockUpdate(); // 使能 GPIOA 时钟（APB2 总线） RCC->APB2ENR |= RCC_APB2ENR_IOPAEN; // 配置 PA5 为通用推挽输出，最大速度 2MHz GPIOA->CRL &= ~(GPIO_CRL_MODE5 | GPIO_CRL_CNF5); GPIOA->CRL |= GPIO_CRL_MODE5_1; // 10: 输出模式 2MHz // CNF5=00: 推挽输出 while (1) { GPIOA->BSRR = GPIO_BSRR_BR5; // PA5 输出低电平（点亮LED） delay(1000000); GPIOA->BSRR = GPIO_BSRR_BS5; // PA5 输出高电平（熄灭LED） delay(1000000); } }

📌代码解析重点：

操作	说明
`RCC->APB2ENR \|= ...`	必须先开启外设时钟，否则 GPIO 无法工作
`GPIOA->CRL`	控制引脚 0~7 的模式和配置
`MODE5_1`	设置为 2MHz 输出速度
`BSRR`	单独控制某一位，避免读-修改-写竞争

💡 为什么用BSRR而不用ODR ^= BIT？
因为ODR是读写共用寄存器，多任务或中断环境下可能发生竞态。BSRR提供原子置位/清零，更安全。

五、工程配置：让代码真正变成可执行文件

现在代码写好了，但还不能直接烧录。我们需要做一些关键配置。

1. 设置晶振频率（影响时钟初始化）

进入：

Project → Options → Target

填写：
-XTAL(MHz): 8.0（假设你用的是 8MHz 外部晶振）

这个值会被system_stm32f1xx.c使用，用来计算 PLL 倍频。

2. 生成 HEX 文件（方便烧录验证）

进入：

Project → Options → Output

勾选：
- ☑ Create HEX File

这样编译后会在Objects/目录下生成.hex文件，可用于 ST-Link Utility 等工具单独烧录。

3. 配置调试器（ST-Link）

进入：

Project → Options → Debug

选择右侧的：
-ST-Link Debugger

点击 Settings，切换到 “Debug” 标签页，确认：
- Connection: SWD
- Speed: 默认即可（如 1.8MHz）

再切到 “Flash Download” 标签页，勾选：
- ☑ Update Target before Debugging

这样每次调试前都会自动下载最新程序。

六、常见问题排查：那些年我们一起踩过的坑

❌ 编译错误：“undefined symbol SystemCoreClock”

👉 原因：缺少system_stm32f1xx.c文件
✅ 解决方案：手动添加该文件到工程中（可在 Keil 安装目录搜索）

❌ 程序下载成功但不运行

👉 原因1：启动文件不匹配（用了F103ZET6的启动文件）
👉 原因2：没有包含startup_stm32f103xb.s
👉 原因3：RCC时钟未使能，GPIO无效

✅ 检查清单：
- 启动文件是否为f103xb
- 是否调用了SystemCoreClockUpdate()
- 是否打开了对应端口时钟

❌ ST-Link连接失败

👉 检查：
- SWDIO / SWCLK 是否接反？
- VCC 是否供电？
- NRST 引脚是否悬空或被拉低？
- 是否短路或虚焊？

🔧 小技巧：使用 ST-Link Utility 软件测试能否识别芯片，排除硬件问题。

七、工程结构优化：打造可复用模板

为了以后快速启动新项目，建议将工程结构调整得更清晰：

STM32_LED_Blink/ ├── User/ │ ├── main.c │ └── main.h ├── Drivers/ │ └── STM32F1xx_HAL_Driver/ (可选) ├── CMSIS/ │ ├── core_cm3.h │ └── startup_stm32f103xb.s ├── Device/ │ ├── system_stm32f1xx.c │ └── stm32f1xx.h ├── Objects/ ← 自动生成 └── Listings/ ← 自动生成

并在 Keil 中使用相对路径引用，提升工程移植性。

此外，可以将此工程另存为模板：