从零开始点亮第一颗LED：Keil uVision5嵌入式开发实战全记录
你有没有过这样的经历？手头一块STM32最小系统板，杜邦线接好，ST-Link也插上了，却卡在“工程怎么建”、“代码写完点哪个按钮烧录”这种基础问题上？别担心，这几乎是每个嵌入式新手的必经之路。
今天，我就带你从打开Keil那一刻起，一步步完成一个完整的嵌入式C项目闭环——从新建工程、编写main函数，到编译、下载，最后让LED亮起来。全程不跳步，不省略任何细节，就像坐在我旁边看着我操作一样。
我们用的是Keil uVision5 + STM32F103C8T6（蓝丸板）这个最常见、资料最多的组合，但方法适用于所有基于 Cortex-M 内核的MCU，比如GD32、NXP LPC等。
第一步：创建你的第一个嵌入式工程
打开 Keil uVision5，界面可能看起来有点老派，但它稳定得像块砖。
点击菜单栏的Project → New μVision Project，选择一个干净的文件夹，给工程命名，比如叫Blink_LED。
接下来最关键的一步来了：选择目标芯片型号。
在弹出的设备数据库中，搜索STM32F103C8，找到后双击确认。注意不要选错成F103RB或别的封装，内存布局不同会影响后续链接配置。
此时Keil会问你：“是否复制标准启动文件到项目中？”
✅ 点Yes！
这个启动文件（startup_stm32f103xb.s）是程序能跑起来的前提。它包含了中断向量表和初始化堆栈的关键汇编代码，稍后我们会细讲它的作用。
第二步：理解那个神秘的“启动文件”
很多初学者不知道，为什么刚建好的工程还没写一行代码就能编译通过？答案就在刚刚自动加入的那个.s文件里。
打开startup_stm32f103xb.s，你会看到一堆汇编指令。别慌，核心就三件事：
定义中断向量表
开头那段.word列表，就是CPU上电后要查找的入口地址。第一个必须是初始栈顶指针（__initial_sp），第二个是复位处理函数（Reset_Handler）。设置主堆栈指针（MSP）
CPU一上电，先得知道栈在哪里。Reset_Handler 中的第一条指令就是把 __initial_sp 加载到 MSP 寄存器。跳转到 C 运行时环境
最终会调用__main（不是你自己写的 main！），由编译器运行时库完成.data段复制、.bss清零等工作，然后才真正进入你的main()函数。
⚠️ 常见坑点：如果你删了启动文件或者没加进工程，即使写了 main()，程序也无法正常启动。
第三步：添加你的C代码 —— 让LED闪烁起来
现在右键左侧项目窗口中的 “Source Group 1” → Add New Item to Group…
选择C File (.c)，命名为main.c。
输入以下最简版本的LED闪烁代码（假设LED连接在PC13，低电平点亮）：
#include "stm32f1xx.h" void delay(volatile uint32_t count) { while (count--); } int main(void) { // 使能GPIOC时钟 RCC->APB2ENR |= RCC_APB2ENR_IOPCEN; // 配置PC13为通用推挽输出，最大速率10MHz GPIOC->CRH &= ~GPIO_CRH_MODE13; // 先清空模式位 GPIOC->CRH |= GPIO_CRH_MODE13_0; // 设置为10MHz输出 GPIOC->CRH &= ~GPIO_CRH_CNF13; // 清除配置位，设为推挽输出 while (1) { GPIOC->BSRR = GPIO_BSRR_BR13; // PC13输出低电平，灯亮 delay(1000000); GPIOC->BSRR = GPIO_BSRR_BS13; // PC13输出高电平，灯灭 delay(1000000); } }这段代码直接操作CMSIS标准下的寄存器，不需要额外库文件，适合学习底层原理。
第四步：关键配置 —— 让编译器知道你在干什么
点击菜单栏的Options for Target（快捷键 Alt+F7），这里有五个标签页，我们必须逐个检查：
🔹 Target 标签页
- XTAL(MHz)：填入外部晶振频率，通常是 8.0 或 16.0 MHz。
- Use MicroLIB：勾上！这个轻量级C库更适合资源有限的单片机，尤其当你用了
printf的时候。
🔹 Output 标签页
- ✅ 勾选Create HEX File
很多烧录工具只认HEX文件，养成习惯总是生成一份。
🔹 C/C++ 标签页
在Define输入框中添加：
USE_STDPERIPH_DRIVER,STM32F103xB
虽然本例没用标准外设库，但这两个宏有助于头文件正确包含。可以加上
-O0编译选项（调试阶段建议关闭优化）
🔹 Debug 标签页
- 选择
Use: ST-Link Debugger - 点击右侧
Settings→ Flash Download → 勾选Update Target before Debugging
这样每次点击调试都会自动下载最新程序，避免忘记手动烧录。
🔹 Linker 标签页（高级玩法）
默认情况下Keil使用自动生成的分散加载脚本（scatter file）。如果你想查看或修改内存布局，可以取消勾选“Use Memory Layout from Target Dialog”，然后指定自己的.sct文件。
典型的.sct内容如下：
LR_IROM1 0x08000000 0x00010000 { ; 64KB Flash ER_IROM1 0x08000000 0x00010000 { *.o(RESET, +First) *(InRoot$$Sections) .ANY (+RO) } RW_IRAM1 0x20000000 0x00005000 { ; 20KB RAM .ANY (+RW +ZI) } }它告诉链接器：代码放Flash开头，变量放SRAM里。地址错了？程序直接变砖。
第五步：编译 & 下载 —— 见证奇迹的时刻
一切就绪，按下快捷键F7或点击工具栏的Rebuild All按钮。
如果一切顺利，底部Build窗口会显示：
".\Output\Blink_LED.axf" - 0 Error(s), 0 Warning(s).没有错误，太棒了！
接着点击Load按钮（向下箭头图标），Keil就会通过ST-Link将程序写入芯片Flash。
完成后，板子上的LED应该就开始闪烁了！如果没反应，别急，往下看排查指南。
第六步：在线调试 —— 单步执行、看寄存器、设断点
这才是Keil真正的杀手锏。
点击绿色虫子图标Start/Stop Debug Session，进入调试模式。
你会发现程序停在Reset_Handler处。按F10单步走，观察PC指针如何一步步跳到main()。
你可以做这些事：
- 打开Watch 1窗口，添加表达式如
GPIOC->ODR，实时查看端口输出状态； - 在
delay()函数处点击设置断点，程序运行到这里会暂停； - 打开Peripheral → GPIOC，直接看到每一位的当前配置；
- 使用Memory Browser查看
0x20000000开始的RAM内容变化。
💡 小技巧：想看变量但显示
<not in scope>？那是编译器优化把它放进寄存器了。把优化等级设为-O0，或者用volatile int i;声明变量即可解决。
实战避坑指南：那些年我们都踩过的雷
❌ 问题1：提示“No target connected”
- 检查ST-Link是否供电正常（红灯亮否）
- SWD接线是否正确？SWDIO→PA13, SWCLK→PA14, GND→GND
- 是否需要接NRST？某些板子必须复位才能连上
❌ 问题2：程序下载成功却不运行
- 检查Debug设置里的“Run to main()”是否启用
- 查看是否勾选了“Reset and Run”选项
- 用Memory视图看
0x08000000地址处是不是真的有数据（应该是栈顶值）
❌ 问题3：main函数根本没进去
- 启动文件缺失或未编译？
- 链接脚本中RESET段没放在最前面？
- 中断向量表偏移未设置（若使用Bootloader需配置VTOR）
❌ 问题4：用了printf但串口看不到输出
因为你很可能开启了Semihosting！
Semihosting会让printf输出到Keil的Debug (printf) Viewer窗口，而不是UART。适合无串口引脚时调试日志。
但记住：脱离调试器后程序会卡死！发布前务必禁用 Semihosting。
如何关闭？在C/C++选项中移除--semihosting参数，改用USART重定向fputc()。
工程管理最佳实践
随着项目变大，良好的组织方式至关重要：
📁 推荐目录结构
Project/ ├── Core/ │ ├── main.c │ └── startup_stm32f103xb.s ├── Drivers/ │ └── stm32f1xx.h / system_stm32f1xx.c ├── Config/ │ └── Blink_LED.uvprojx └── Output/ ├── Blink_LED.hex └── Blink_LED.axf✅ 版本控制注意事项
- 把
.uvprojx和.uvoptx加入.gitignore - 它们包含本地路径信息，容易造成冲突
- 保留
.c,.h,.sct等核心文件用于协作同步
🔧 提升效率的小贴士
- 开启Browse Information：支持Ctrl+鼠标点击跳转函数定义
- 使用RTE（Run-Time Environment）：一键添加CMSIS-Core、RTOS、文件系统等组件，省去手动找库的麻烦
- 启用Warnings as Errors：强迫自己写出更健壮的代码
总结：Keil不只是编辑器，而是你的嵌入式工作台
Keil uVision5或许界面不够现代，但它几十年沉淀下来的稳定性、对ARM生态的深度整合，让它依然是工业界广泛使用的主力工具之一。
我们今天走完了完整流程：
- 新建工程 → 添加启动文件 → 编写C代码 → 配置选项 → 编译构建 → 下载运行 → 在线调试
每一步背后都有其设计逻辑。比如为什么要有启动文件？因为裸机系统没有操作系统帮你初始化；为什么要配.sct？因为嵌入式系统的内存是离散且有限的。
掌握这些，你就不再只是“点按钮的人”，而是真正理解了代码是如何变成电流，在硅片中流动起来的。
下次当你看到LED按节奏闪烁时，心里应该清楚：那是从Flash读取指令、CPU解码执行、寄存器改变电平、电流驱动PN结发光的全过程。
而这，正是嵌入式开发的魅力所在。
如果你正在尝试某个具体型号却卡住了，欢迎留言交流。我们可以一起分析启动流程、检查链接脚本、甚至远程看看你的寄存器配置。毕竟，每一个成功的blink，都值得庆祝。
