STM32F103C8T6 点亮 LED —— 小白零基础完整教程

一、写在前面：我们要做什么

单片机（微控制器）的"Hello World"就是点亮一颗 LED 灯。它虽然简单，却能让你完整走一遍嵌入式开发的全部流程：

• 写代码 —— 用 C 语言 + ST 标准外设库控制芯片的 GPIO（通用输入输出）引脚
• 编译 —— 用 Keil 把 C 代码编译成机器码（生成 .hex 文件）
• 下载 —— 用 ST-Link 下载器把程序烧进芯片的 Flash 存储器
• 运行 —— 看 LED 亮起来、灭下去、再亮起来……

本教程使用 Keil v5.34 和 ST 标准外设库（Standard Peripheral Library）V3.5.0，这是 STM32 入门最经典、教程资料最多的一套组合（相比后来主推的 HAL 库，标准库代码直接、易学，国内大量教材都在用它）。

二、原理速览：LED 为什么会亮

只用理解 3 个概念，足够完成本教程：

2.1 GPIO 引脚 = 芯片伸出来的"手"

STM32F103C8T6 有 37 个 GPIO 引脚（PA0~PA15、PB0~PB15、PC13~PC15 等）。每个引脚都可以配置成输入（读外面信号）或输出（向外发信号）。我们要做的，就是把 PC13 配置成输出模式，然后让它在高电平（3.3V）和低电平（0V）之间切换。

2.2 推挽输出：拉高拉低都靠芯片

GPIO 输出有 8 种模式，点亮 LED 用推挽输出（GPIO_Mode_Out_PP）：芯片内部像一个"推"和"挽"两个开关，要么把引脚接到 3.3V（输出高电平），要么把引脚接到 GND（输出低电平），驱动能力最强，最常用。

2.3 时钟：芯片的"心跳"要逐个外设打开

STM32 为了省电，所有外设（包括 GPIO 端口）默认关着电。用哪个外设，必须先打开它的时钟（想象成"给这个外设通电"）。GPIO 挂在 APB2 总线上，所以第一步永远是调用 RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE) 给 GPIOC 通电。

2.4 蓝板上的 LED 为什么"低电平点亮"

蓝板原理图：LED 的阳极（+）接 3.3V，阴极（-）经一个限流电阻接 PC13。因此：

• PC13 输出 低电平（0V） → 电流流过 LED → 亮
• PC13 输出 高电平（3.3V） → 两端等电位无电流 → 灭

这正是新手最容易踩的坑：PC13 是"输出 0 点亮"，和直觉相反。代码里我们约定 LED_ON() = 输出低电平（GPIO_ResetBits）。

三、硬件准备与接线

3.1 需要购买的硬件（总价约 30~60 元）

3.2 ST-Link 与开发板接线（SWD 方式，只需 4 根线）

蓝板上的丝印一般标着 DIO（PA13）和 CLK（PA14），紧挨着 3.3V 和 GND，对照上图用杜邦线连好即可。有条件可以把 ST-Link 的 RST 也接到板子的 RESET 脚，能提高下载成功率，但不是必须。

四、软件安装（四步，顺序不能乱）

4.1 安装 Keil MDK v5.34

4.2 安装 STM32F1 系列器件包（Device Family Pack，DFP）

MDK v5 的器件支持靠"器件包"管理。没有 STM32F1 的器件包，新建工程时就选不到 STM32F103C8 这颗芯片。安装方法二选一：

• 方法 A（在线）：打开 Keil → 工具栏 Pack Installer 按钮（一个绿色小箱子图标）→ 左侧搜索框输入 STM32F1xx → 找到 Keil::STM32F1xx_DFP → 点右边的 Install，等待下载完成。
• 方法 B（离线包）：到 Keil 官网 Pack 页面 https://www.keil.arm.com/packs/ 下载 Keil.STM32F1xx_DFP.x.x.x.pack，双击即可自动安装到 Keil。

4.3 安装 ST-Link 驱动

• Windows 10/11 通常插上 ST-Link 会自动装好驱动（设备管理器里能看到"STMicroelectronics STLink dongle"）。
• 如果没自动识别：到 ST 官网下载 STSW-LINK009（ST-Link 驱动包）安装；或者安装 STM32CubeProgrammer（ST 官方烧录软件，自带 ST-Link 驱动）。
• 验证：插上 ST-Link 后，打开设备管理器（Win+X → 设备管理器），在"通用串行总线设备"下应看到 STLink 相关条目，没有黄色感叹号即正常。

4.4 下载 ST 标准外设库 V3.5.0

这是本教程的"弹药库"——ST 官方写的芯片驱动函数源码。下载方式：

• 官网：https://www.st.com/en/embedded-software/stsw-stm32054.html（STSW-STM32054 = STM32F10x standard peripheral library），需登录 ST 账号免费下载，文件名为 en.stsw-stm32054.zip（约 40MB）。
• 替代渠道：官网登录麻烦时，可在 GitHub 搜索 STM32F10x_StdPeriph_Lib_V3.5.0 找镜像仓库下载，内容一致。

解压后你会看到如下结构（记住它，下一节要用）：

STM32F10x_StdPeriph_Lib_V3.5.0/
├── Libraries/                          ← 我们要用的核心库
│   ├── CMSIS/
│   │   └── CM3/
│   │       ├── CoreSupport/            ← core_cm3.c / core_cm3.h（内核支持）
│   │       └── DeviceSupport/ST/STM32F10x/
│   │           ├── stm32f10x.h         ← 芯片总头文件
│   │           ├── system_stm32f10x.c  ← 系统时钟初始化（默认72MHz）
│   │           ├── system_stm32f10x.h
│   │           └── startup/arm/
│   │               └── startup_stm32f10x_md.s  ← 启动文件（中容量MD！）
│   └── STM32F10x_StdPeriph_Driver/
│       ├── inc/                        ← 外设头文件（stm32f10x_gpio.h 等）
│       └── src/                        ← 外设源文件（stm32f10x_gpio.c 等）
├── Project/                            ← 官方示例工程（可参考，不直接用）
├── Utilities/                          ← 评估板代码（本教程不需要）
└── _htmresc/                           ← 图片素材（不需要）

五、搭建工程（照做即可，每一步都详细）

5.1 建文件夹，从标准库中"提取"需要的文件

在自己电脑上新建一个工程总文件夹（路径不要含中文，例如 D:\STM32_LED_Demo），然后按下面的结构建子文件夹：

STM32_LED_Demo/
├── Libraries/          ← 从标准库复制（下面细说）
│   ├── CMSIS/
│   └── STM32F10x_StdPeriph_Driver/
├── User/               ← 我们自己写的代码（main.c / led.c / led.h / delay.c / delay.h）
├── Project/            ← 存放 Keil 工程文件（.uvprojx 等）
└── Doc/                ← 放资料文档（可选）

从刚才解压的标准库里复制这些文件（只复制需要的，不要整个文件夹复制）：

说明：标准库外设文件很多（USART、TIM、ADC……），本工程只用到 GPIO 和 RCC，所以只需 gpio、rcc、misc 三个外设源文件；misc.c 是 NVIC 内核中断相关，加进去备用。头文件建议把 inc 整个文件夹复制，省得以后缺头文件。

5.2 在 Keil 中新建工程、选择芯片

现在左侧 Project 窗口里出现 Target 1，里面只有一个空的 Source Group 1。接下来把它改造成规范的分组结构。

5.3 分组（Group）并添加文件

5.4 工程配置（"魔术棒"Options for Target）——最关键的一步

点击工具栏魔术棒图标（或菜单 Project → Options for Target，快捷键 Alt+F7），逐页配置：

① Target 页

• Xtal (MHz)：填 8.0（蓝板外部晶振 8MHz，一般默认就是 8.0）
• 勾选 Use MicroLIB（微型 C 库，代码更小，学习阶段强烈建议勾）
• ARM Compiler：下拉选择 Use default compiler version 5（即 AC5，v5.34 自带 V5.06；标准库用它编译最稳）

② Output 页

• 勾选 Create HEX File（生成 .hex 烧录文件，用串口下载或给别人烧录时需要）

③ C/C++ 页（两个必填项）

• Define（宏定义）栏输入：STM32F10X_MD, USE_STDPERIPH_DRIVER
  含义：告诉标准库"芯片是中容量 MD"（决定内存地址、外设数量等），并且"使用标准外设库驱动"。
• Include Paths（头文件搜索路径）栏，点右侧 ... 图标，逐个 Add 以下 4 个路径（对应你建的文件夹）：

.\Libraries\CMSIS
.\Libraries\STM32F10x_StdPeriph_Driver\inc
.\User

这 4 个路径让编译器能找到 stm32f10x.h、stm32f10x_gpio.h、stm32f10x_rcc.h、led.h 等头文件。漏掉任何一个，编译都会报 "cannot open source file" 错误。

④ Debug 页（选下载器）

• 右侧 Use: 下拉框选择 ST-Link Debugger（如果下拉里没有，说明第 4.3 步驱动没装好）
• 点旁边 Settings 按钮：在 Debug 子页确认 Port: SW、Max Clock: 4MHz（或默认），右侧能看到 SW Device 里识别出芯片 IDCODE（0x1BA01477 之类）说明连接正常
• 切到 Flash Download 子页：勾选 Reset and Run（下载完自动复位运行，不用手动按复位键）；若下方 Programming Algorithm 列表为空，点 Add，选择 STM32F10x Med-density 128K Flash（Start: 0x08000000，Size: 0x20000）

⑤ Utilities 页

• 保持默认 Use Debug Driver 即可（它会复用 Debug 页的 ST-Link 设置）。

配置完成，点 OK 关闭。至此工程搭建完毕。先别急着编译——我们的 User 文件夹里还没有真正的代码。

六、编写代码（复制粘贴 + 逐行讲解）

在 User 文件夹里新建 5 个文件，把下面的代码完整复制进去。文件较多，我们用"分层"方式组织：led（硬件驱动）、delay（延时）、main（主程序），这也是以后写复杂工程的标准结构。

6.1 led.h —— LED 的"说明书"（头文件）

把所有与硬件相关的定义集中在这里：以后换板子、换引脚，只改这一个文件。

#ifndef __LED_H
#define __LED_H

#include "stm32f10x.h"          // 标准库总头文件：包含 GPIO、RCC 等所有外设定义

/*---------------- 硬件配置区：换开发板只改这里 ----------------*/
// 板载LED：蓝板 LED 接在 PC13，阴极接PC13、阳极接3.3V，所以"低电平点亮"
#define LED_GPIO_PORT   GPIOC                       // LED 所在端口
#define LED_GPIO_PIN    GPIO_Pin_13                 // LED 所在引脚
#define LED_GPIO_CLK    RCC_APB2Periph_GPIOC        // 对应端口的时钟（GPIO挂在APB2总线）

/*---------------- 操作宏：语义化，主程序里好读 ----------------*/
#define LED_ON()    GPIO_ResetBits(LED_GPIO_PORT, LED_GPIO_PIN)   // PC13输出低电平 → 灯亮
#define LED_OFF()   GPIO_SetBits(LED_GPIO_PORT, LED_GPIO_PIN)     // PC13输出高电平 → 灯灭

/* 函数声明 */
void LED_Init(void);

#endif  // __LED_H

#ifndef / #define / #endif 是"防止头文件重复包含"的经典写法，编译原理是：第一次包含时定义 __LED_H 宏，第二次再包含时直接被跳过，避免重复定义错误。每个头文件都要这样写。

6.2 led.c —— LED 的"具体实现"（源文件）

#include "led.h"        // 先包含自己的头文件

/**
 * @brief  初始化 LED 引脚
 * @note   三步走：开时钟 → 配结构体 → 调用库函数
 */
void LED_Init(void)
{
    GPIO_InitTypeDef GPIO_InitStructure;   // 定义"配置结构体"变量

    // 第1步：打开 GPIOC 端口的时钟（不打开，寄存器写了也白写）
    RCC_APB2PeriphClockCmd(LED_GPIO_CLK, ENABLE);

    // 第2步：往结构体里填配置参数
    GPIO_InitStructure.GPIO_Pin  = LED_GPIO_PIN;      // 选中引脚：PC13
    GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;  // 输出模式：通用推挽输出
    GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 输出速度：50MHz（LED够用，选最低的2MHz也行）

    // 第3步：把结构体配置真正写入寄存器（初始化完成）
    GPIO_Init(LED_GPIO_PORT, &GPIO_InitStructure);

    // 初始状态：灯灭（PC13 输出高电平）
    LED_OFF();
}

逐句讲解：

• GPIO_InitTypeDef 是库定义的结构体类型，专门用来装"引脚号、模式、速度"这三个参数。
• RCC_APB2PeriphClockCmd(外设, ENABLE)：打开时钟。GPIOA~GPIOE 都在 APB2 总线上，所以传 RCC_APB2Periph_GPIOC。忘了这步是最常见的错误——现象就是"程序在跑但灯不亮"。
• GPIO_Mode_Out_PP：推挽输出，芯片既能把引脚拉高也能拉低，驱动 LED 的标准模式。
• GPIO_Speed_50MHz：数字电路的翻转速度上限，LED 这种慢信号其实无所谓，50MHz 是默认习惯值。
• GPIO_Init(端口, &结构体)：把上面的配置一次性写进芯片寄存器。

6.3 delay.c / delay.h —— 简单延时（软件延时，教学够用）

// delay.h
#ifndef __DELAY_H
#define __DELAY_H

#include "stm32f10x.h"

void Delay_ms(uint32_t ms);

#endif  // __DELAY_H

// delay.c —— 注意：这是"空循环"软件延时，精度不高但简单直观
#include "delay.h"

/**
 * @brief  毫秒级软件延时（近似值）
 * @note   72MHz主频下，内层循环7200次约耗时1ms（会随编译优化等级略有变化）
 */
void Delay_ms(uint32_t ms)
{
    uint32_t i, j;
    for (i = 0; i < ms; i++)
    {
        for (j = 0; j < 7200; j++);   // 空循环消磨时间
    }
}

6.4 main.c —— 主程序（程序入口）

/**
 * 工程名：LED_Blink
 * 芯片  ：STM32F103C8T6
 * 效果  ：板载蓝色LED每500ms闪烁一次
 */
#include "stm32f10x.h"   // 标准库总头文件
#include "led.h"         // LED驱动
#include "delay.h"       // 延时

int main(void)
{
    LED_Init();              // 第1步：初始化LED引脚（配置成推挽输出）

    while (1)                // 第2步：死循环，程序永远在这里转
    {
        LED_ON();            // 点亮：PC13输出低电平
        Delay_ms(500);       // 保持500ms

        LED_OFF();           // 熄灭：PC13输出高电平
        Delay_ms(500);       // 保持500ms
    }
}

几个关键点：

• main 之前不需要自己写 SystemInit 调用——启动文件 startup_stm32f10x_md.s 在芯片复位后会自动调用标准库的 SystemInit() 把主频配到 72MHz，然后才进入我们的 main。
• while(1) 是嵌入式程序的基本形态：单片机跑完初始化后，主程序必须永远循环（不存在"退出"），否则程序会跑飞。
• 把 500 改成 100，灯会闪得更快；两个 Delay 都改成 1000 就是"亮1秒灭1秒"。

6.5 （可选）外接 LED 怎么接、代码怎么改

如果手痒想用面包板外接一颗 LED（以 PA0 为例）：

1. 接线：PA0 → 330Ω 电阻 → LED 阳极 → LED 阴极 → GND。此时 PA0 输出高电平点亮（和板载相反）。
2. 改 led.h 的硬件配置区即可，主程序一行不用动：

// 外接LED接 PA0（阳极接PA0、阴极经电阻接地 → 高电平点亮）
#define LED_GPIO_PORT   GPIOA
#define LED_GPIO_PIN    GPIO_Pin_0
#define LED_GPIO_CLK    RCC_APB2Periph_GPIOA

// 因为极性反了，亮/灭宏也要对调：
#define LED_ON()    GPIO_SetBits(LED_GPIO_PORT, LED_GPIO_PIN)    // 输出高 → 亮
#define LED_OFF()   GPIO_ResetBits(LED_GPIO_PORT, LED_GPIO_PIN)  // 输出低 → 灭

七、编译与错误处理

八、下载程序到开发板（点亮时刻！）

如果灯没亮，按第 9 节 FAQ 排查。下载成功后，把板子拔电再上电，程序依然会运行——因为程序已经烧进了芯片内部的 Flash，断电不丢失。这就是"单片机"和"电脑程序"的本质区别。

九、常见问题 FAQ

十、进阶方向（点亮之后学什么）

1. 寄存器版点亮 LED：不调库函数，直接操作 RCC->APB2ENR、GPIOC->CRH、GPIOC->ODR 寄存器——彻底搞懂库函数背后发生了什么。
2. SysTick 精确延时 + 定时器中断：用硬件定时器代替空循环，学中断（NVIC）。
3. 按键输入：GPIO 输入模式（上拉/下拉），用按键控制 LED。这是"输入"概念的入门。
4. 串口 USART：printf 打印调试信息，与电脑通信——嵌入式开发最重要的调试手段。
5. PWM 呼吸灯：定时器 PWM 输出，LED 渐亮渐暗。
6. ADC 采集：读电位器电压，串口发出来。
7. 之后可以学 HAL 库 + STM32CubeMX 图形化配置，或用 FreeRTOS 做多任务。

十一、参考资料

• ARM 官方 MDK v5.34 发布说明（Release date: 12th March 2021）：https://developer.arm.com/documentation/107778/5-43-0/MDK-Version-5-34
• Keil 官方下载页（MDK-ARM）：https://www.keil.com/download/product/
• ST 官方 STM32F10x 标准外设库（STSW-STM32054）：https://www.st.com/en/embedded-software/stsw-stm32054.html
• STM32F103C8T6 Blue Pill 硬件资料（stm32-base）：https://stm32-base.org/boards/STM32F103C8T6-Blue-Pill.html
• STM32F103C8T6 最小系统板使用说明（官方 PDF，含 PC13 板载 LED 说明）：https://www.lcdwiki.com/.../STM32F103C8T6最小系统板使用说明.pdf
• 野火《STM32库开发实战指南》（GPIO 输出—使用固件库点亮LED，标准库）：https://doc.embedfire.com/mcu/stm32/f103badao/std/zh/latest/book/GPIO_output.html
• 《STM32F10X-中文参考手册》（芯片寄存器权威文档，ST 官网可下载 PDF）
• 标准库用户手册《stm32f10x_stdperiph_lib_um.chm》（随标准库附带的 API 帮助文档，写代码时按 F1 可查）