前言

本节是 STM32 入门程序中第一个完整的硬件实操章节，承接工程搭建、GPIO 基础原理的前置内容。通过三个最经典的外设案例——LED 单灯闪烁、多灯流水灯、有源蜂鸣器驱动，完整掌握 STM32 通用 IO 口配置为推挽输出模式的全流程。建立库函数配置硬件 → 代码控制电平 → 外设执行动作的嵌入式开发主要思维。

本节学习目标

1. 掌握 GPIO_Init 标准库函数的参数含义与调用流程。
2. 理解延时函数在 IO 时序控制中的作用。
3. 独立完成 LED 闪烁、流水灯、蜂鸣器发声三个基础实验。
4. 建立嵌入式程序「初始化 + 死循环」的架构认知。老实说，

常见痛点 🚩

• 不知道如何打开外设时钟：没有开启时钟。后续所有寄存器写操作都会无效。
• GPIO 模式选错：推挽输出是驱动 LED、蜂鸣器最安全的选择，误选开漏或上拉会导致灯不亮或噪声。其实，
• 延时函数找不到或使用不当：没有正确加入头文件或误用阻塞延时会出现“程序卡死”或“闪烁不规律”。
• 引脚冲突：A15、B3、B4 等 JTAG 引脚默认被占用，直接使用会导致调试失效。

一、GPIO 初始化通用模板

/* 1️⃣ 开启 GPIOA 时钟 */
RCC_APB2PeriphClockCmd;/* 2️⃣ 配置 GPIO 初始化结构体 */
GPIO_InitTypeDef GPIO_InitStructure;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;// 推挽输出
GPIO_InitStructure.GPIO_Pin = GPIO_Pin_0;// 使用 PA0
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;// 最高 50MHz
/* 3️⃣ 调用库函数完成硬件配置 */
GPIO_Init;

GPIO 常见模式速查表：

• 浮空输入 IN_FLOATING
• 上拉输入 IPU
• 下拉输入 IPD
• 模拟输入 AIN
li>推挽输出 Out_PP
• 开漏输出 Out_OD
• 复用推挽输出 AF_PP
• 复用开漏输出 AF_OD

GPIO 推挽输出模式详解

STM32 的 GPIO 配置为输出时最常用的是推挽输出（GPIO_Mode_Out_PP)**：

• 驱动能力强：能够直接提供足够电流点亮普通 LED 或驱动有源蜂鸣器。
• 三步固定流程：开启对应端口时钟 → 填充结构体 → 调用 GPIO_Init
• 主要控制函数：
  • GPIO_SetBits: 输出高电平

  二、LED 闪烁实验

  . 实验原理 & 痛点定位

  Pain Point: 很多新手在连接 LED 时把正负脚接反，以为「高电平点亮」却发现 LED 永远不亮。至于解决办法，将 LED 阴极接到 MCU 引脚。阳极经限流电阻接 VCC；此时 **低电平点亮**。

  . LED 闪烁主要原因

  
  while
  {
  /* 点亮 LED */
  GPIO_WriteBit;Delay_ms，// 延时 500ms
  /* 熄灭 LED */
  GPIO_WriteBit;Delay_ms，}
  

  TIPS:

  • #include "Delay.h"  必须放在文件顶部，否则编译报未定义。
  • If you prefer a more readable API,you can replace above两行 with:

    GPIO_ResetBits;// 点亮
    Delay_ms;GPIO_SetBits;// 熄灭
    Delay_ms;

  三、LED 流水灯

  . 实现思路 & 常见错误点

  • Pain Point: 一次只想控制一个引脚。却把所有引脚都设置成了同一状态，导致全部灯同步闪烁。方法的观点是，使用位掩码逐个控制。
  • Pain Point: 忘记把需要使用的所有引脚一次性打开时钟或一次性配置为推挽输出，导致部分灯根本没有响应。

  . 硬件连接概览

  . 主要代码

   # include "stm32f10x.h"
  # include "Delay.h"
  int main
  {
  /* 1️⃣ 开启 GPIOA 时钟 */
  RCC_APB2PeriphClockCmd;/* 2️⃣ 初始化 PA0~PA7 为推挽输出 */
  GPIO_InitTypeDef gpio;
  gpio.GPIO_Mode = GPIO_Mode_Out_PP;gpio.GPIO_Speed = GPIO_Speed_50MHz;gpio.GPIO_Pin = GPIO_Pin_0 | GPIO_Pin_1 | GPIO_Pin_2 |
  GPIO_Pin_3 | GPIO_Pin_4 | GPIO_Pin_5 |
  GPIO_Pin_6 | GPIO_Pin_7;GPIO_Init，while
  {
  /* 按顺序点亮每个 LED，低电平点亮，高电平熄灭 */
  for
  {
  /* 将对应位清零。其余保持高电平 */
  uint16_t mask = ~;// 位掩码
  GPIO_Write;Delay_ms，不过，}
  }
  }
   

  • 如果想一次性关闭所有灯。只需写入全高：                    ​ GPIO_Write;​ // 所有 PA0‑PA7 高电平   。说起来，
  • 若使用 STM32CubeMX。可自动生成上述初始化代码，大幅降低手动出错概率。按理说，

  四、蜂鸣器驱动

  . 驱动原理与痛点剖析

  Pain Point: 有源蜂鸣器正负极接反后根本不发声。以为代码有问题，解决办法这方面。确认 VCC 接 MCU 输出口对应的正极，GND 接地。不过，

  . 主要代码

   # include "stm32f10x.h"
  # include "Delay.h"
  int main
  {
  /* 1️⃣ 打开 GPIOB 时钟 */
  RCC_APB2PeriphClockCmd;/* 2️⃣ 将 PB12 配置为推挽输出 */
  GPIO_InitTypeDef gpio;gpio.GPIO_Mode = GPIO_Mode_Out_PP;怎么说呢，gpio.GPIO_Speed = GPIO_Speed_50MHz;gpio.GPIO_Pin = GPIO_Pin_12;gpio.Init，while
  {
  /* 发声 – 拉低 PB12 */
  GPIO_ResetBits;其实，Delay_ms，按理说，// 发声时间
  /* 停止 – 拉高 PB12*/
  GPIO_SetBits;Delay_ms，// 静默时间
  }
  }
   

  注意事项：

  • 确保所选引脚不是 JTAG 默认占用口，否则调试会失效。
  • 有源蜂鸣器内部已有振荡源。只要供给合适的直流即可，无需 PWM。

  五、本小节常见问题汇总 & 小结

  . 按位或操作逻辑回顾

  在需要一次性配置多个引脚时可使用位或运算将它们组合起来例如：         gpio.GPIO_Pin = GPIO_Pin_0| GPIO_Pin_1| …| GPIO_Pin_7;

  . 推挽 vs 开漏 – 哪个更适合？

  • 说到**推挽**。能够主动拉高和拉低，引脚可直接驱动 LED、蜂鸣器等低功耗负载。
  • **开漏**这方面。只能拉低，需要外部上拉电阻才能得到高电平；适用于 I²C 总线或需要多主机共享线路的场景。

  . 实体接线图回顾

  ---

  快速检查清单：

  • ✅ 已打开对应端口时钟？
  • ✅ 引脚已设置为 **推挽输出**？
  • ✅ 正确使用延时函数并已包含头文件？
  • ✅ 接线符合「低电平点亮」或「低电平导通」原则？