STM32F103入门实战：从开发板认识、环境搭建到烧录调试全流程

1. 准备工作：先把开发板和工具认清楚

做嵌入式开发这几年，我最大的感受是：许多新手倒在起跑线上，不是因为代码写不出来，而是因为开发环境没搭好，或者板子都没认清就开始写代码，最后连程序烧不进去都不知道问题出在哪。STM32F103 是意法半导体推出的经典 Cortex-M3 内核芯片，主频最高 72MHz，Flash 从 16KB 到 512KB 不等，内存从 6KB 到 64KB，因其性价比高、资料丰富，至今仍被高校和企业大量使用。

如果你是刚接触嵌入式的学生，或者想从 Arduino 转型到更专业的开发平台，这门课就是为你准备的。整条学习路线其实可以浓缩成四个环节：认识板子、搭建环境、编译烧录、调试运行。只要把这四步走顺了，后面的 GPIO、定时器、串口、中断都是一马平川。

在动手之前，先想清楚一个问题：你到底需要什么样的开发板？这取决于你想学什么、预算多少、手头有什么工具。市面上的 STM32F103 开发板大致分三类：最小系统板（比如蓝药丸 C8T6）、完整型开发板（比如正点原子 Mini 板、野火指南者）、自制核心板。我的建议是新手从最小系统板起步，原因很简单：它电路简单、引脚全部引出、价格便宜，而且能逼着你理解时钟、复位、启动模式这些底层细节。

注意：这里说的“认识开发板”不是让你看一遍图文介绍就完事，而是要求你能指着一块板子，说出上面每一个芯片、每一个插座、每一个跳线帽是干什么用的。这块基础打牢了，后面调试程序时会省下大量时间。

另外，除了开发板本身，你需要准备的工具如下表所示。虽然有些工具不是必须的，但我建议一步到位，因为它们在后续课程和实际项目中都会反复用到。

这里我想分享一下选型逻辑：不要一上来就买八九十块钱的完整开发板。虽然带液晶屏、按键、LED 的板子看着很炫，但它们替你做了太多事情，导致你对底层原理的理解会打折扣。我第一次带学生实训时，有同学用完整开发板做了点灯实验，却连 LED 为什么亮都说不清楚；换用最小系统板后，自己动手接线路、查数据手册，反而很快入了门。

2. 开发环境搭建：KEIL MDK 安装与芯片支持包配置

2.1 为什么选择 KEIL MDK 而不是其它 IDE

STM32F103 的开发环境选择有好几种：KEIL MDK、IAR EWARM、STM32CubeIDE、PlatformIO + VSCode，甚至 GCC 命令行工具链。对于新手和大多数企业工程师来说，KEIL MDK 依然是最主流的选择，原因有三：

第一，KEIL MDK 的操作界面、编译流程和调试功能非常贴近嵌入式工程师的实际习惯，代码编辑、编译、下载、在线调试全部在一个窗口里完成，学习成本低。第二，几乎所有 STM32 教程、例程、网课都以 KEIL MDK 为默认环境，你用它能少碰到很多“版本不兼容”的坑。第三，KEIL MDK 的工程管理逻辑清晰，从固件库到中间件到用户代码，分层填写，能帮助你建立标准的工程组织观念。

有人说 KEIL 界面老旧，不如 VSCode 好看。我不否认，但我要说的是：工具的“好看”是次要的，工程的“可复现”和“可维护”才是关键。尤其在企业里，老项目用 KEIL 是常态，你换个 IDE 可能连编译都过不了。

提示：KEIL MDK 官方并不免费，但商业评估版（MDK-Community）对代码体积 32KB 以内的工程免费。STM32F103C8T6 的 Flash 是 64KB，不过一般学习工程仅用十几KB，评估版够用。

2.2 安装步骤详解

KEIL MDK 的安装过程不复杂，但有几个细节值得注意。我按步骤拆开讲：

1. 去 KEIL 官网下载 MDK-ARM 安装包（区分版本，目前常见的是 5.36 或 5.37 等），双击运行依次点击 Next。需要提醒的是，安装路径最好不要有中文和空格，这主要是为了避免某些编译插件报路径错误。

2. 在安装类型界面选择 Core 即可，这样会默认安装到 C 盘 KEIL_v5 目录。如果你希望装到别的盘，可以自定义路径，但后续芯片支持包的路径也会跟着变，要注意一致性。

3. 安装完成后先别急着打开 IDE。接下来最关键的一个步骤是安装芯片支持包（Pack）。你可能在建立工程时发现 Device 列表里找不到 STM32F103C8，原因就是 Pack 没装。Pack 是一种封装了芯片型号、寄存器定义、启动文件、Flash 算法的插件包，没有它，KEIL 根本不认识你的芯片。

4. 打开 KEIL 后，在 Pack Installer 窗口里点右上角的 Pack 图标，从列表里找到Keil::STM32F1xx_DFP，点击 Install 即可。如果你网络不好，也可以去 Keil 官网下载离线包，手动双击安装，效果一样。

安装完 Pack 后，需要注意 KEIL 的Options for Target窗口中Device一栏应能正常显示 STM32F103 系列芯片型号。很多新手在建立工程时看到 Device 下拉框空白，就是 Pack 没弄好，回头重新装一遍基本上能解决。

2.3 串口驱动的坑与解决经验

如果你用的是 USB-TTL 串口模块（比如 CH340G），在 Windows 上往往需要手动安装驱动。正常情况下，把模块插入 USB 口，设备管理器里会出现 COM 口。但问题来了：很多新系统默认不识别 CH340，会在设备管理器里显示黄色感叹号。

遇到这种情况，我的处理顺序是固定的：

1. 检查线材和 USB 口，换一根数据线试试，很多“驱动有问题”其实是线材本身不通电。
2. 去官网下载最新版 CH340 驱动，右键以管理员身份运行安装。
3. 装完后拔插设备，观察设备管理器变化。

这三个步骤能解决我遇到的 90% 串口识别问题。还有一个进阶建议：装完驱动后，在设备管理器里右键 COM 口、打开“属性 → 端口设置”，将波特率设为 115200，数据位 8、停止位 1、无校验，这是串口调试时的标准配置。

3. 工程模板搭建：从固件库到 GPIO 点灯全流程

3.1 标准外设库还是 CubeMX 生成的 HAL 库？

在 2024 年的今天，摆在你面前的有两条路：老派的标准外设库（StdPeriph Library）和新派的 STM32CubeMX + HAL 库。很多 2020 年之前的教程都在教标准外设库，但近两年 HAL 库已经成为主流，尤其在企业项目中，CubeMX 建工程已经成了默认流程。

我自己两种都用过，可以给出客观的对比：标准外设库代码可以直接操作寄存器，逻辑更透明，适合深度理解底层；HAL 库抽象层更高，开发效率高，代码移植方便，CubeMX 里鼠标点一点就能生成初始化代码。对于实训目的，我的建议是：以 HAL 库入门，同时把标准库的例程当参考。因为你初次学习追求的是“快速点亮一盏灯”的正反馈，而不是被一堆寄存器配置困住。

当然，你如果未来想走嵌入式底层驱动方向，标准库和寄存器操作那一套还得回头补课。至少现阶段，先用 HAL 把流程跑通。

3.2 用 CubeMX 生成 MDK 工程

CubeMX 是一款图形化初始化工具，它的核心价值在于把引脚分配、时钟树、外设参数这些极容易出错的工作自动化。我们以下面的 C8T6 点灯实验为例走一遍：

1. 打开 STM32CubeMX，选择Access to MCU Selector，在搜索框输入 STM32F103C8，双击选中。
2. 在System Core里配置RCC，将 HSE 设置为 Crystal/Ceramic Resonator。这是为了使用外部晶振，保证系统时钟稳定。
3. 在Clock Configuration页面配置时钟树：HSE 8MHz 经 PLL 倍频到 72MHz。关键操作是：输入 8，在 PLL Source 选择 HSE，PLL Mul设为 9，此时系统时钟 SYSCLK 会显示 72MHz，符合芯片最高主频。
4. 配置 GPIO：在芯片引脚图上点击想要控制的引脚（PC13 或 PA1），选择GPIO_Output，同时可在 GPIO 设置里调节初始电平、推挽/开漏等参数。
5. 在Project Manager里填写工程名、路径、选择 MDK-ARM V5 工具链，并勾选生成外设初始化代码。点击 GENERATE CODE，CubeMX 会生成一个完整的 MDK 工程。

这里我需要提醒一个新手常犯的错：在 CubeMX 里定义引脚为输出后，如果电路是高电平点亮 LED，记得把 GPIO 的初始电平设为低电平，否则程序一上电 LED 就会亮，容易误以为是程序跑飞了。

生成工程后，用 KEIL 打开.uvprojx文件即可进入主程序编写。一个最简单的点灯代码是在while(1)循环里写：

while (1) { HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_RESET); // LED 亮 HAL_Delay(500); // 延时 500ms HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET); // LED 灭 HAL_Delay(500); }

这段代码的作用是让 PC13 引脚交替输出高低电平，LED 以 1Hz 频率闪烁。注意 CubeMX 生成的项目里SystemClock_Config()函数已经被自动调用，你不需要手动初始化时钟，这对新手来说非常友好。

3.3 KEIL 工程关键配置检查清单

用 CubeMX 生成的 KEIL 工程已经配置好绝大多数参数，但你依然要在 KEIL 的Options for Target里确认几项内容，否则可能踩到烧录和调试的坑：

• Device 选择：确认当前选择的芯片型号是 STM32F103C8。
• Debug 选项：在下拉框中选择 ST-Link Debugger，并点击 Settings 确认能够识别到设备 ID。如果这里识别不到，后面烧录肯定失败。
• Utilities 设置：勾选Use Debug Driver，并在 Flash Download 里勾选Reset and Run，这是让程序烧录完成后自动复位的选项，不勾选的话程序不会自动启动。
• 代码生成选项：如果是用标准库，需要把 C 语言标准设置为 C99，否则一些语法会报错。

我见过太多人在 GPIO 代码完全正确的情况下，程序就是跑不起来，到最后发现是 Debug 设置里选错了调试器，或者 Reset and Run 没有勾选。这种低级错误其实很好排查，花十分钟检查一遍配置，能省掉后面一个小时的烦恼。

4. 烧录与调试：ST-Link 接线、Flash 算法与串口通信

4.1 ST-Link 与开发板的硬件连接

ST-Link V2 是 STM32 开发中最常用的调试下载器，它支持 SWD 和 JTAG 两种接口，对新手来说，我强烈建议用 SWD 四线方式，占用引脚少，稳定可靠。接线颜色标准如下：

在接线前先确认开发板供电方式。最小系统板一般可以通过 USB 口或 ST-Link 供电，我建议如果你的 ST-Link 是带电源输出的版本，直接由 ST-Link 供电即可，但前提是总电流不大。如果外接了传感器模块，最好用 USB 独立供电，避免 ST-Link 供电不足导致复位不稳定。

注意：很多 ST-Link 的排针定义并不统一，不同厂商的线序可能截然不同。接线前务必对照 ST-Link 外壳上的丝印和开发板引脚图逐一确认，这是我带实训时发现最容易被忽略的地方，也是最容易烧板子的地方。

4.2 KEIL 里配置 ST-Link 并下载程序

硬件接好后，打开 KEIL 的Options for Target进入 Debug 设置：

1. 设置 Debug 下拉框为ST-Link Debugger，并点击右侧 Settings。
2. 在 Debug 子页里，确认 Port 为 SW，Max Clock 可以设为 4MHz 或 2MHz。如果连接不稳定，把时钟降下来反而更可靠。
3. 点击Flash Download选项卡，勾选Reset and Run，并在 Programming Algorithm 中确认已经加载了 STM32F10x Med-density Flash 算法。

设置完成后，点击编译（F7）确保无错误，然后点击 Download（F8）烧录程序。如果一切顺利，状态栏会显示Flash Load finished，程序随即开始运行。

这里我在实践中遇到过一种情况：程序烧录进去后 LED 不工作，板子完全没有反应。经过排查，发现是 BOOT0 引脚的电平状态问题。STM32F103 支持三种启动方式，由 BOOT0 和 BOOT1 的电平决定。正常运行时 BOOT0 必须接低电平（GND），如果在高电平状态，芯片会从系统存储器启动，正常运行的程序当然不会执行。

4.3 串口通信：printf 重定向和监控

程序烧进去之后，如果只能看 LED 闪烁未免太单调。实际开发中，最常用的调试手段是串口打印。STM32F103 的 USART1 引脚是 PA9（TX）和 PA10（RX），你需要用 USB-TTL 模块连接：

• STM32 PA9（TX） → USB-TTL 的 RX
• STM32 PA10（RX） → USB-TTL 的 TX
• 共地：两块板子的 GND 必须相连

要注意的是，USB-TTL 模块上如果标明 3.3V/5V 跳线，务必调到 3.3V，否则可能烧毁 STM32 的引脚。

串口初始化和 printf 重定向是新手比较容易卡住的点。在 HAL 库工程中，可以用以下方式重定向 printf 到串口：

int fputc(int ch, FILE *f) { HAL_UART_Transmit(&huart1, (uint8_t *)&ch, 1, 0xFFFF); return ch; }

同时在 KEIL 的 Options 里勾选Use MicroLIB，这个操作让编译器用精简的 C 库，从而支持 printf 重定向。很多人的 printf 不出数据，其实就是没有勾选这个选项。

串口的收发看起来简单，但实际调试中有三个高频问题：一是波特率匹配不上，双方波特率必须完全一致，常见是 115200；二是地没共好，导致信号参考点不对，出现乱码；三是 TX/RX 接反了。排查顺序按照这三个来，基本能解决绝大多数串口问题。

5. 开发板深度认识：最小系统电路与引脚资源解析

5.1 STM32F103C8T6 最小系统剖析

认识开发板不能停留在“会用”的层面，至少要弄清楚一块最小系统板由哪些部分组成。以常见的 C8T6 蓝药丸板为例，它的最小系统包括：电源电路、晶振电路、复位电路、启动模式配置电路，以及必要的去耦电容。我在给学员讲解时，会把这块板子拆解成如下几个模块逐一过一遍：

电源电路方面，C8T6 工作电压是 2.0V 到 3.6V，典型值是 3.3V。开发板通常提供一个 USB 5V 输入，然后经过 AMS1117-3.3 稳压芯片降为 3.3V 供芯片使用。这里有个重要知识点：如果你想自己设计板子，必须考虑 5V 转 3.3V 电路，也就是把 5V 输入经过稳压芯片转换为 3.3V 输出，同时输入输出端各放置一个 10uF 和一个 100nF 的去耦电容。这个电路我在很多学员的自制板里都见过，大部分问题出在电容漏焊或极性焊反，导致电压纹波大，芯片工作不稳定。

晶振电路方面，HSE（高速外部时钟）采用 8MHz 晶振，负载电容通常选 22pF 左右。HSE 是系统时钟的重要组成部分，如果焊接不良，CubeMX 生成的工程会在 HAL_RCC_ClockConfig 阶段卡住死循环。我的排查建议是：程序卡死在Error_Handler()时，优先考虑晶振是否起振。

复位电路方面，NRST 引脚接一个外部复位按键和 RC 复位电路。按键按下把 NRST 拉低，芯片复位。如果你发现程序运行中频繁自动复位，检查复位引脚是否有干扰，或去耦电容是否有问题。

启动配置电路方面，BOOT0 引脚通常接一个下拉电阻到 GND，通过跳线帽或拨码开关可切换启动模式。BOOT1 引脚在 C8T6 上一般悬空即可。

5.2 读懂 STM32F103 的引脚资源

STM32F103C8T6 是 LQFP48 封装，共有 36 个 GPIO 引脚，分布在 PA0-PA15、PB0-PB15、PC13-PC15、PD0-PD1 等端口。每个端口都支持多种复用功能，包括 USART、SPI、I2C、定时器、ADC 等。理解引脚资源的关键是学会查数据手册里的引脚定义表。

我给新手的一个建议是：拿到一块新板子，别急着接线，先做一份“引脚资源速查表”。把每个引脚可能用到的功能列出来，这样在设计电路时选引脚，就不会出现“冲突”的情况。比如你用了 PA9 做串口 TX，同时又想让它做普通 GPIO 输出高电平，那就可能有冲突，因为它的复用功能占用会影响外部电路。

对于 C8T6 来说，最常用的资源可以粗略概括如下：USART1 固定接 PA9、PA10；I2C1 接 PB6（SCL）、PB7（SDA）；SPI1 接 PA5（SCK）、PA6（MISO）、PA7（MOSI）；ADC1 的通道大部分分布在 PA0-PA7；高级定时器 TIM1 的 PWM 输出在 PA8、PA11 等引脚。你可能不需要把所有功能都背下来，但每次用到某个外设前先查一遍引脚定义，形成习惯是很重要的。

5.3 最小系统板的常见连接陷阱

认识了开发板资源之后，还要多看几个容易犯的硬件问题。我在带实训时，经常看到学员出现以下几种连接错误：

第一种是供电引脚接反。很多最小系统板的 3.3V 和 5V 引脚挨得很近，杜邦线插反后芯片直接冒烟。虽然芯片一般内置保护电路，但反复反接会缩短寿命。

第二种是外部模块电平不匹配。有些 5V 传感器模块输出高电平 5V，直接接 STM32 引脚可能造成损坏。正确的做法是使用电平转换电路或选用 3.3V 供电的模块版本。这里可以用一个简单的分压电阻或电平转换模块来解决，具体电路网上资料很多，我不再赘述。

第三种是引脚复用冲突。比如你想同时使用 SWD 调试（PA13、PA14）和定时器 PWM 输出，而 PA14 恰好是某个定时器的复用引脚，就有可能冲突。此时需要改用其它 GPIO 作为调试口，或者把 PWM 输出迁到其它引脚。CubeMX 的引脚分配图能直观看出哪个引脚被占用，用起来很方便。

6. 常见问题与排查技巧实录

6.1 编译报错与工程配置问题速查

这张表是我在实训中最常拿出来对照的。很多问题看起来千奇百怪，归根到底是几个固定原因，按照“工程配置 → 硬件接线 → 驱动安装”的顺序去排查，效率最高。

6.2 芯片锁死与 Flash 保护问题

还有一个必须提到的问题是芯片被锁死。这种情况一般发生在你用调试器连接芯片时误操作了读保护，或者程序里不小心设置了 Flash 的写保护选项字节。此时 KEIL 下载程序会报类似Error: Flash Download failed - "Cortex-M3"的错误。

我的处理办法是：用 ST-Link Utility（官方工具）连接芯片，在 Option Bytes 里将读保护等级调整为 Level 0，执行擦除后重新上电，即可恢复。如果没有 ST-Link Utility，也可以在 KEIL 里进入 Debug 模式，在 Flash 菜单里执行 Erase 操作，但成功率稍低。

这个问题的本质是 STM32 的 Flash 保护机制在工作。对新手来说，操作时不要随便动 Option Bytes 设置；如果不小心动了，也不要慌，按上面的方法恢复即可。

6.3 调试器连接失败的高级排查思路

有一个场景是：ST-Link 驱动装了、接线也对，但 KEIL 的 Settings 里始终识别不到设备。我遇到这种问题时，会按以下顺序排查：

1. 检查 ST-Link 是否为山寨版。市面上很多十几块钱的 ST-Link V2 用的是国产芯片方案，固件版本老，经常出现识别不稳定。如果是这种情况，升级固件到最新版本，或者换用正版。
2. 检查驱动加载情况。右键“此电脑” → 管理 → 设备管理器，看是否有ST-Link相关设备。如果没有，很可能驱动被安全软件拦截了，手动安装驱动即可。
3. 降低 SWD 通信速率。在 KEIL 的 Debug Settings 里把 Max Clock 从 4MHz 降到 1MHz，很多时候能解决连接不稳定的问题。
4. 检查杜邦线长度和质量。超过 20cm 的高阻抗杜邦线在高速通信时信号会衰减，换短线或改用线夹更稳妥。

这种基础问题如果卡住了，不要急着怀疑芯片坏了，先检查环境和工具。

7. 实训后的进阶路径建议

写完点灯实验、跑通串口打印、理解了最小系统板之后，你已经算踏进嵌入式开发的大门了。后续怎么走，我给你几条建议：

第一条建议是吃透 CubeMX 生成的初始化代码。很多人用 CubeMX 生成了工程就直接写用户代码，从不看初始化函数。我建议你花一个晚上，把SystemClock_Config()、MX_GPIO_Init()这类函数一行一行读一遍，再对照参考手册（比如 RM0008）理解寄存器配置。你会惊讶地发现，图形化工具背后其实是一套严格的寄存器操作逻辑。

第二条建议是多做小项目，刻意训练“读电路图 + 写驱动”的组合能力。比如外接一个 OLED 显示屏、写一个 I2C 扫描程序、用定时器做精确延时、用外部中断读取按键。这些项目单个看起来不难，但组合在一起就能覆盖 STM32 的绝大部分常用外设。

第三条建议是尽早接触版本管理工具。我知道很多嵌入式新手觉得 Keil 项目加不进 Git 里，其实是因为没有忽略生成文件。建议在工程目录下加入.gitignore，忽略*.o、*.axf、*.hex等编译产物，只跟踪源码和 CubeMX 的.ioc文件。这样你的工程才具备可追溯性，也为后续多人协作打好基础。

最后说一下我个人的体会：嵌入式开发的学习曲线确实比较陡，但它的“正反馈”也来得很快。只要环境搭好、板子点亮、串口能打印，你就有了一整套可以复用的基础工具，后面再学 RTOS、学嵌入式 Linux，甚至转型做嵌入式 AI 开发，都不会觉得突兀。这个第 00 课看起来只是搭环境，实际上是为你整个嵌入式的学习路线打下最底层的地基。把地基打牢，别赶进度，是一个我见过太多人忽略、但无比重要的建议。