GPIO入门到精通完全指南

原创于 2026-04-12 22:09:37 发布 · 419 阅读

13 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#硬件工程 #嵌入式

硬件电路设计笔记专栏收录该内容

1 篇文章

订阅专栏

前言

GPIO（General Purpose Input/Output，通用输入/输出）是嵌入式系统中最基础也最核心的外设之一，几乎所有嵌入式开发场景（如单片机、FPGA、SoC）都离不开它的应用。从简单的LED灯控制、按键检测，到复杂的通信协议模拟（I2C、SPI、UART）、传感器数据采集，GPIO都扮演着关键角色。

第一章：GPIO入门基础

1.1 什么是GPIO？

GPIO是芯片提供的通用输入/输出引脚，这些引脚可以通过软件配置为输入或输出模式，实现与外部设备的信号交互。与UART、I2C等专用外设不同，GPIO没有固定的通信协议，灵活性极高，是嵌入式系统与外部世界连接的“通用接口”。

核心特点：

通用性：可根据需求配置为输入或输出，适配多种外部设备；
可编程性：通过寄存器或软件库函数灵活配置工作模式、电平状态；
双向性：部分引脚支持输入/输出模式切换，实现信号的双向传输。

1.2 GPIO的核心功能：输入与输出

GPIO的核心功能分为两大类：输入功能和输出功能，所有复杂应用都是基于这两种基础功能扩展而来。

1.2.1 输出功能

输出功能即通过GPIO引脚向外部设备输出高低电平（如3.3V/0V、5V/0V，取决于芯片电压域），控制外部设备的工作状态。

常见应用场景：

控制LED灯亮灭（高电平点亮、低电平熄灭，或反之）；
驱动继电器吸合/断开，控制大功率设备（如电机、电磁阀）；
模拟通信协议的时序信号（如模拟SPI的SCK、MOSI引脚）。

1.2.2 输入功能

输入功能即通过GPIO引脚检测外部设备的电平信号，获取外部状态信息。

常见应用场景：

检测按键是否按下（按键按下时引脚电平由高变低，或反之）；
接收传感器输出的数字信号（如红外接收模块、霍尔传感器的检测结果）；
接收外部设备的控制信号（如电机的故障反馈信号）。

GPIO 可以用于控制 LED 灯、蜂鸣器，也可以用作按键输入、ADC 采样，从而实现单片机与外部硬件之间的连接与数据交互

1.3 GPIO的硬件基础：引脚结构与电气特性

理解GPIO的硬件结构是正确使用的前提，避免因选型或接线错误导致设备损坏。

1.3.1 基本引脚结构

典型的GPIO引脚内部结构包括：输出驱动器、输入缓冲器、上拉/下拉电阻、多路选择器（用于模式切换）。

输出驱动器：将芯片内部的数字信号转换为外部可识别的电平信号；
输入缓冲器：将外部的模拟电平信号转换为芯片内部的数字信号（0/1）；
上拉/下拉电阻：默认情况下使引脚保持固定电平（避免悬空状态导致的误触发）；
多路选择器：通过配置寄存器选择引脚的工作模式（输入/输出/复用功能）。

1.3.2 关键电气特性

使用GPIO时必须关注以下电气参数，避免超出芯片规格导致损坏：

工作电压（VDD）：引脚支持的最高/最低电压范围（如3.3V芯片的GPIO不可直接接入5V信号）；芯片与 I/O 供电：2.0 V ~ 3.6 V，GPIO 输出高电平 ≈ VDD，输出低电平 ≈ 0V，GPIO 不能直接接 5V 常量输入，必须看是否标注 FT（5V tolerant）。

输出驱动能力：引脚能提供/吸收的最大电流（如STM32的GPIO输出电流通常为20mA，超出需加驱动电路）；普通 GPIO：推荐 8mA，最大可用 20mA，绝对不能超：单脚 25m，PC13/PC14/PC15：只能 3mA，超过 20mA 必须加三极管 / MOS 驱动。

输入阈值：区分高电平（VIH）和低电平（VIL）的电压阈值（如3.3V系统中，VIH通常≥2V，VIL≤0.8V）；V_IL ：Input Low Voltage，输入低电平电压上限，V_IH：Input High Voltage，输入高电平电压下限，V_DD：芯片的供电电压（比如 3.3V、5V）。

耐压值：引脚允许的最大反向电压或过压值（超出可能击穿引脚）。

第二章：GPIO核心原理：工作模式与配置

不同芯片的GPIO支持的工作模式略有差异，但核心模式基本一致。以应用最广泛的STM32为例，GPIO主要支持8种工作模式，可分为三大类：输入模式、输出模式、复用功能模式（部分引脚可配置为UART、I2C等专用外设的引脚）。

GPIO 内部电路结构
每个 GPIO 内部的电路结构。上方是输入电路，输入的是外部电路的电平信号；下方是输出电路，输出的是微控制器内部的控制信号。

保护二极管：IO 引脚上下两边两个二极管用于防止引脚外部过高、过低的电压输入。当引脚电压高于 VDD 时，上方的二极管导通；当引脚电压低于 VSS 时，下方的二极管导通，防止不正常电压引入芯片导致芯片烧毁。但是尽管如此，还是不能直接外接大功率器件，须加大功率及隔离电路驱动，防止烧坏芯片或者外接器件无法正常工作。

VDD 通常指的是正电源电压或者是芯片的工作电压，对于 ESP32 来说，VDD = 3.3V
VSS 通常指的是地（GND），也就是电路中的零点压参考点。

P-MOS 管和 N-MOS 管：由 P-MOS 管和 N-MOS 管组成的单元电路使得 GPIO 具有“推挽输出”和“开漏输出”的模式。
TTL肖特基触发器：信号经过触发器后，模拟信号转化为0和1的数字信号。但是，当 GPIO 引脚作为 ADC 采集电压的输入通道时，用其“模拟输入”功能，此时信号不再经过触发器进行 TTL 电平转换。ADC 外设要采集到的原始的模拟信号。

2.1 输入模式详解

输入模式下，GPIO引脚通过输入缓冲器接收外部信号，核心差异在于是否启用内部上拉/下拉电阻，以及是否进入模拟输入状态。

2.1.1 浮空输入（Floating Input）

对于浮空输入而言，IO 端口的电平信号直接进入输入数据寄存器，其电平状态完全由外部输入决定。
如果在引脚悬空（无信号输入）的情况下，该端口的电平是不确定的。

特点：不启用内部上拉或下拉电阻，引脚电平完全由外部信号决定。

适用场景：

接收外部明确的电平信号（如传感器输出的标准数字信号）；
模拟通信协议的输入引脚（如UART的RX引脚）。

注意：悬空输入时，若外部信号未接入，引脚电平会处于不确定状态（漂浮状态），容易受到干扰，导致误检测，因此需确保外部有明确的电平驱动。

2.1.2 上拉输入（Pull-Up Input）

对于上拉输入而言，IO 端口的电平信号直接进入输入数据寄存器。
如果在引脚悬空（无信号输入）的情况下，该端口的电平为高电平。

通过在 GPIO 引脚和电源（VDD）之间连接一个电阻，可以确保在没有外部信号驱动时，引脚被“拉”到高电平。这个电阻称为上拉电阻。

特点：启用内部上拉电阻（电阻一端接VDD），默认情况下引脚为高电平；当外部信号拉低时，引脚电平变为低电平。

适用场景：

按键检测（按键一端接GND，另一端接GPIO，按下时引脚拉低）；
外部设备的状态反馈（如设备正常工作时输出低电平，故障时输出高电平）。

优势：避免引脚悬空，提高抗干扰能力。

2.1.3 下拉输入（Pull-Down Input）

对于下拉输入而言，IO 端口的电平信号直接进入输入数据寄存器。
如果在引脚悬空（无信号输入）的情况下，该端口的电平为低电平。

通过在 GPIO 引脚和地（GND 或 VSS）之间连接一个电阻，可以确保在没有外部信号驱动时，引脚被“拉”到低电平。这个电阻称为下拉电阻。

特点：启用内部下拉电阻（电阻一端接GND），默认情况下引脚为低电平；当外部信号拉高时，引脚电平变为高电平。

适用场景：与上拉输入互补，适用于外部信号为高电平有效（如设备触发信号为高电平）的场景。

2.1.4 模拟输入（Analog Input）

模拟输入模式下，IO 端口的模拟信号（电压信号，而非电平信号）不经过 TTL 施密特触发器2，直接输入到片上外设模块，比如 ADC 模块等。

特点：输入缓冲器关闭，引脚直接连接到芯片内部的模拟电路（如ADC模数转换器）。

适用场景：需要采集外部模拟信号（如电压、电流）时，如温度传感器（LM35）的模拟信号输出引脚连接到GPIO的模拟输入模式，配合ADC进行数据采集。

2.2 输出模式详解

输出模式下，GPIO通过输出驱动器向外部输出高低电平，核心差异在于输出驱动器的结构（推挽/开漏），以及是否启用上拉/下拉电阻。

GPIO 的输出模式有4种：通用推挽输出、通用开漏输出、复用推挽输出、复用开漏输出。观察一下我们可以发现，只要掌握推挽和开漏、通用和复用之间的区别，就可以掌握所有的输出模式。

2.2.1 模式配置寄存器（Mode Register）

回顾一下：GPIO 内部电路结构图，重点关注输出驱动器部分，有一对 MOS 管，我们把这部分放大，可以得

上面的 MOS管为 P-MOS，下面的 MOS 管为 N-MOS，P-MOS 的漏极接高电压 Vdd，N-MOS 的源极接低电压 Vss，两个 MOS 管之间有一条导线连接到 IO 引脚。

推挽输出模式下，一对 MOS 管交替导通：上面的导通，下面的就关断；下面的导通，上面的就关断

向 IO 写 0，P-MOS 关断，N-MOS 导通，引脚通过下方的 N-MOS 与 Vss 相连，输出低电压

向 IO 写 1，P-MOS 导通，N-MOS 关断，引脚通过上方的 P-MOS 与 Vdd 相连，输出高电压

开漏输出模式下，P-MOS 一直处于关断状态

向 IO 写 0，P-MOS 恒断，N-MOS 导通，引脚通过下方的 N-MOS 与 Vss 相连，输出低电压

向 IO 写 1，P-MOS 恒断，N-MOS 关断，引脚处于悬空状态，无论引脚侧电压有多大，电流恒为 0，根据欧姆定律，此时电阻无穷大。这种状态被称为高阻抗

总结：

推挽模式下，一对 MOS 管交替导通，对外输出低电压或高电平
开漏模式下，P-MOS保持关断，对外输出低电平或高阻抗

2.2.2. 通用和复用之间的区别

通用：直接控制 IO 引脚输出电压的方式
复用：把 IO 引脚控制权交由其他模式托管，比如串口模块、定时器模块等。

2.2.3. 输出模式的选择

推挽输出可以输出低电平和高电平两种状态，可以用于驱动 LED、蜂鸣器等外设。
开漏输出只能输出低电平，高电平输出依赖外部的上拉电阻实现，输出电平完全由上拉电阻所连接的电源电平决定。

这一特性使其可以很方便地调节输出电平，适用于需要电平转换的场景，
也使其可以实现“线与”功能。

所谓的“线与”指的是多个信号线直接连接在一起，只有当所有信号全部为高电平时，合在一起的总线为高电平；只要有任意一个或者多个信号为低电平，则总线为低电平。

IO 复用和复用功能重映射
什么是 IO 复用？
观察电脑的键盘，我们会发现上面的按键几乎都具有不止一个功能，比如用于输入数字 1 的按键也可以用于输入！，用于输入数字 2 的按键也可以用于输入 @ ，单片机的引脚与键盘上的按键类似，几乎每个都具有不止一个功能。

默认情况下，我们可以直接通过程序控制 IO 引脚输出高电平或者低电平，这种直接控制引脚的方式就是通用功能，而相对的其他功能，就是复用功能。回看一下ESP32 开发板引脚示意图，其中彩色的标识，就是对应引脚所具有的复用功能。

总结一下，IO 复用就是指同一个 IO 引脚具备多个不同的功能。

什么是复用功能重映射？
一般单个引脚可以同时兼具多种复用功能，以 STM32F103C8T6 为例，它的 PA9 引脚既可以作为定时器 1 的通道2 来使用，也可以作为串口1 的 TX 引脚来使用。如果我们想要同时使用串口1 和定时器1 该怎么办呢? 为了解决这个问题，芯片上给大多数模块都留有一组或多组备用引脚。对于 USART1 来说，备用引脚为 PB6 和 PB7，我们只要将 USART1 重映射到这两个引脚，冲突问题就解决了。

所谓的复用功能重映射，就是将冲突的复用功能移动到其他备用引脚上去。

2.3 GPIO配置的核心逻辑：寄存器操作

所有GPIO的工作模式配置、电平控制都是通过操作芯片内部的寄存器实现的。不同芯片的寄存器地址和位定义不同，但核心逻辑一致，主要包括以下几类寄存器：

2.3.1 模式配置寄存器（Mode Register）

用于配置GPIO引脚的工作模式（输入/输出/复用/模拟）。通常每个引脚占用2个寄存器位，通过设置不同的位值选择模式（如STM32的MODER寄存器，00=输入模式，01=通用输出模式，10=复用功能模式，11=模拟模式）。

2.3.2 输出类型寄存器（Output Type Register）

仅在输出模式或复用功能输出模式下有效，用于配置输出类型为推挽或开漏（如STM32的OTYPER寄存器，0=推挽输出，1=开漏输出）。

2.3.3 上拉/下拉配置寄存器（Pull-Up/Pull-Down Register）

用于配置是否启用内部上拉或下拉电阻，以及电阻类型（如STM32的PUPDR寄存器，00=无上下拉，01=上拉，10=下拉，11=保留）。

2.3.4 数据输出寄存器（Output Data Register）

用于控制输出模式下GPIO引脚的电平状态（如STM32的ODR寄存器，某一位为1时输出高电平，为0时输出低电平）。

2.3.5 数据输入寄存器（Input Data Register）

用于读取输入模式下GPIO引脚的当前电平状态（如STM32的IDR寄存器，某一位为1表示当前引脚为高电平，为0表示低电平）。

示例（STM32寄存器操作简化）：将PA0配置为推挽输出，输出高电平

// 1. 使能GPIOA时钟（STM32需先使能外设时钟）
RCC->AHB1ENR |= RCC_AHB1ENR_GPIOAEN;

// 2. 配置PA0为通用输出模式（MODER寄存器，01）
GPIOA->MODER &= ~(GPIO_MODER_MODE0_Msk); // 清除原有配置
GPIOA->MODER |= (1 << GPIO_MODER_MODE0_Pos);

// 3. 配置PA0为推挽输出（OTYPER寄存器，0）
GPIOA->OTYPER &= ~(GPIO_OTYPER_OT0_Msk);

// 4. 配置无上下拉（PUPDR寄存器，00）
GPIOA->PUPDR &= ~(GPIO_PUPDR_PUPD0_Msk);

// 5. 输出高电平（ODR寄存器，置1）
GPIOA->ODR |= (1 << 0);
}

第三章：GPIO实践操作：从基础案例到协议模拟

理论学习后，通过实践巩固知识是掌握GPIO的关键。本节以STM32（HAL库）和树莓派（Python）为例，覆盖基础控制、中断应用、协议模拟等典型场景。

3.1 基础实践：LED控制与按键检测

这是GPIO最基础的应用，分别对应输出模式和输入模式的核心用法。

3.1.1 案例1：STM32 HAL库控制LED闪烁

硬件连接：LED正极通过220Ω电阻接PA0，负极接GND（高电平点亮）。

3.1.2 案例2：树莓派Python检测按键状态

硬件连接：按键一端接GPIO17，另一端接GND；GPIO17启用内部上拉电阻（默认高电平，按下时拉低）。

软件代码（使用RPi.GPIO库）：

import RPi.GPIO as GPIO
import time

# 配置GPIO模式（BCM编码）
GPIO.setmode(GPIO.BCM)
# 配置GPIO17为输入模式，启用内部上拉电阻
GPIO.setup(17, GPIO.IN, pull_up_down=GPIO.PUD_UP)

try:
    while True:
        # 读取GPIO17的电平状态
        key_state = GPIO.input(17)
        if key_state == GPIO.LOW:
            print("按键被按下")
            time.sleep(0.2) # 消抖
        else:
            print("按键未按下")
        time.sleep(0.1)
except KeyboardInterrupt:
    # 程序退出时清理GPIO配置
    GPIO.cleanup()
}

关键注意：按键按下时会产生机械抖动（电平快速波动），需通过延时（软件消抖）或硬件RC电路（硬件消抖）避免误检测。

3.2 进阶实践：GPIO中断与事件触发

在输入模式下，若采用“轮询”方式检测引脚电平（如上述按键检测），会占用大量CPU资源。中断方式可以实现“事件触发”——只有当引脚电平发生变化时，才会触发中断服务函数，CPU无需持续轮询，提高系统效率。

3.2.1 案例3：STM32 HAL库实现按键中断

硬件连接：按键一端接PB0，另一端接GND；PB0配置为上拉输入（默认高电平，按下时拉低，触发下降沿中断）。

软件配置与代码：

// 1. GPIO中断初始化（CubeMX配置后自动生成）
void MX_GPIO_Init(void) {
  GPIO_InitTypeDef GPIO_InitStruct = {0};

  // 使能GPIOB时钟
  __HAL_RCC_GPIOB_CLK_ENABLE();

  // 配置PB0为上拉输入
  GPIO_InitStruct.Pin = GPIO_PIN_0;
  GPIO_InitStruct.Mode = GPIO_MODE_IT_FALLING; // 下降沿触发中断
  GPIO_InitStruct.Pull = GPIO_PULLUP;
  HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

  // 使能中断线0（PB0对应中断线0），设置优先级
  HAL_NVIC_SetPriority(EXTI0_IRQn, 0, 0);
  HAL_NVIC_EnableIRQ(EXTI0_IRQn);
}

// 2. 中断服务函数（中断触发时执行）
void EXTI0_IRQHandler(void) {
  // 检查是否是PB0触发的中断
  if (__HAL_GPIO_EXTI_GET_IT(GPIO_PIN_0) != 0) {
    // 清除中断标志位
    __HAL_GPIO_EXTI_CLEAR_IT(GPIO_PIN_0);
    // 中断处理逻辑（如翻转LED状态）
    HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_0);
  }
}

关键要点：

中断触发方式：可配置为上升沿（电平从低变高）、下降沿（电平从高变低）、双边沿（高低电平变化都触发）；
中断优先级：当多个中断同时触发时，CPU优先执行优先级高的中断；
中断标志位清除：中断处理完成后必须清除中断标志位，否则会持续触发中断。

3.3 高级实践：GPIO模拟通信协议

GPIO的灵活性使其可以模拟多种串行通信协议（如I2C、SPI、UART），适用于芯片无专用外设或外设资源不足的场景。

3.3.1 案例4：GPIO模拟I2C通信（主机发送数据）

I2C协议核心：两根线（SDA数据、SCL时钟），均为开漏输出，需外部上拉电阻；通过SCL时钟同步SDA数据的传输。

软件代码（STM32 HAL库，模拟I2C主机）：

// 定义I2C引脚（SDA=PA1，SCL=PA2）
#define SDA_PIN GPIO_PIN_1
#define SCL_PIN GPIO_PIN_2
#define I2C_PORT GPIOA

// 延时函数（模拟I2C时序，需根据实际需求调整）
void I2C_Delay(void) {
  uint32_t i = 1000;
  while (i--) ;
}

// 初始化I2C引脚（开漏输出）
void I2C_Init(void) {
  GPIO_InitTypeDef GPIO_InitStruct = {0};
  __HAL_RCC_GPIOA_CLK_ENABLE();

  GPIO_InitStruct.Pin = SDA_PIN | SCL_PIN;
  GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; // 开漏输出
  GPIO_InitStruct.Pull = GPIO_PULLUP; // 启用内部上拉（替代外部上拉电阻）
  GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
  HAL_GPIO_Init(I2C_PORT, &GPIO_InitStruct);

  // 初始状态：SDA、SCL均为高电平
  HAL_GPIO_WritePin(I2C_PORT, SDA_PIN | SCL_PIN, GPIO_PIN_SET);
}

// 发送I2C起始信号（SCL高电平时，SDA从高变低）
void I2C_Start(void) {
  HAL_GPIO_WritePin(I2C_PORT, SDA_PIN, GPIO_PIN_SET);
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_SET);
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SDA_PIN, GPIO_PIN_RESET);
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_RESET);
  I2C_Delay();
}

// 发送I2C停止信号（SCL高电平时，SDA从低变高）
void I2C_Stop(void) {
  HAL_GPIO_WritePin(I2C_PORT, SDA_PIN, GPIO_PIN_RESET);
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_SET);
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SDA_PIN, GPIO_PIN_SET);
  I2C_Delay();
}

// 发送一个字节数据
void I2C_SendByte(uint8_t data) {
  uint8_t i;
  for (i = 0; i < 8; i++) {
    // 发送最高位
    HAL_GPIO_WritePin(I2C_PORT, SDA_PIN, (data & 0x80) ? GPIO_PIN_SET : GPIO_PIN_RESET);
    I2C_Delay();
    // SCL高电平，从机读取数据
    HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_SET);
    I2C_Delay();
    // SCL低电平，准备下一位数据
    HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_RESET);
    I2C_Delay();
    data <<= 1; // 左移一位，准备发送下一位
  }
  // 等待从机应答（ACK）
  HAL_GPIO_WritePin(I2C_PORT, SDA_PIN, GPIO_PIN_SET); // 释放SDA
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_SET);
  I2C_Delay();
  HAL_GPIO_WritePin(I2C_PORT, SCL_PIN, GPIO_PIN_RESET);
  I2C_Delay();
}

// 主函数中使用
int main(void) {
  HAL_Init();
  SystemClock_Config();
  I2C_Init();

  while (1) {
    I2C_Start(); // 发送起始信号
    I2C_SendByte(0xA0); // 发送从机地址（写操作）
    I2C_SendByte(0x00); // 发送寄存器地址
    I2C_SendByte(0x55); // 发送数据
    I2C_Stop(); // 发送停止信号
    HAL_Delay(1000);
  }
}

关键要点：模拟通信协议的核心是严格遵循协议的时序要求（如I2C的起始/停止信号、时钟同步、数据位传输时序），延时函数的参数需根据实际硬件速度调整，确保时序准确。