引言
上一章我们成功搭建了开发环境并点亮了板载 LED，迈出了嵌入式开发的第一步。但要让 ESP32-S3 真正"感知"外部世界并做出响应，需要深入理解 GPIO（通用输入输出） 这一最基础、最关键的外设模块。
本章将从 GPIO 的工作原理出发，依次讲解输出控制、输入读取、按键消抖和中断机制，最后通过一个完整的按键控制 LED 示例，让你掌握嵌入式开发中 GPIO 最核心的用法。
一、GPIO 基础概念
1.1 什么是 GPIO
GPIO（General Purpose Input/Output）即通用输入输出引脚，是 MCU 与外部世界交互的最基本通道。ESP32-S3 共有 45 个可编程 GPIO 引脚（GPIO0 ~ GPIO48，部分保留），每个引脚都可以独立配置为输入或输出模式。
1.2 GPIO 工作模式
ESP32-S3 的 GPIO 支持以下主要模式：
| 模式 | 功能 | 典型应用 |
|---|---|---|
| 推挽输出 | 输出高/低电平，驱动能力强 | 驱动 LED、蜂鸣器 |
| 开漏输出 | 只能拉低，高电平需外接上拉 | I2C 通信总线 |
| 浮空输入 | 引脚电平由外部决定 | 读取按键（需外接上拉/下拉） |
| 上拉输入 | 内部上拉电阻，默认高电平 | 读取按键（节省外部电阻） |
| 下拉输入 | 内部下拉电阻，默认低电平 | 读取按键 |
注意： ESP32-S3 内部上拉电阻约 45kΩ，下拉电阻约 45kΩ。在低功耗或噪声敏感场景下，建议使用外部上拉/下拉电阻。
二、GPIO 输出：控制 LED
2.1 初始化与输出函数
上一章我们通过点灯程序接触了 GPIO 输出，这里进一步系统化介绍相关 API。
c
#include "driver/gpio.h"
#define LED_GPIO GPIO_NUM_48 // 板载 LED 引脚
void led_init(void) {
// 步骤1：复位 GPIO 到默认状态
gpio_reset_pin(LED_GPIO);
// 步骤2：配置为推挽输出模式
gpio_set_direction(LED_GPIO, GPIO_MODE_OUTPUT);
// 步骤3：设置初始电平（默认低电平，LED 熄灭）
gpio_set_level(LED_GPIO, 0);
}核心 API 说明：
gpio_reset_pin()--- 复位引脚到默认状态（输入模式，关闭上拉/下拉）gpio_set_direction()--- 设置引脚方向（输入/输出/双向等）gpio_set_level()--- 设置输出电平（0 或 1）
2.2 实现呼吸灯效果
除了简单的亮灭交替，利用延迟函数可以轻松实现呼吸灯效果：
c
void breathe_led(void) {
for (int duty = 0; duty < 256; duty++) {
gpio_set_level(LED_GPIO, 1);
ets_delay_us(duty); // 延时 duty 微秒
gpio_set_level(LED_GPIO, 0);
ets_delay_us(256 - duty); // 补足周期
}
}这里通过调节 PWM 占空比实现亮度渐变。当然，ESP32-S3 也内置了硬件 LEDC 控制器用于更精准的 PWM 输出，后续章节会专门介绍。
三、GPIO 输入：读取按键
3.1 按键电路原理
机械按键在未按下时处于断开状态，按下后导通。最简单的按键电路如下：
scss
VCC (3.3V)
│
[R] 10kΩ 上拉电阻
│
├──── GPIO 引脚
│
[SW] 按键
│
GND当按键未按下时，GPIO 引脚通过上拉电阻保持高电平；按下后引脚直接接地，电平变为低。这种 "按下为低" 的电路是嵌入式中最常见的按键接法。
3.2 配置输入模式
c
#define BUTTON_GPIO GPIO_NUM_0 // BOOT 按键引脚
void button_init(void) {
gpio_reset_pin(BUTTON_GPIO);
gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
gpio_set_pull_mode(BUTTON_GPIO, GPIO_PULLUP_ONLY); // 内部上拉
}使用内部上拉时，外部电路可以省略上拉电阻，但注意内部上拉阻值较大（~45kΩ），在强干扰环境中建议使用外部 10kΩ 上拉。
3.3 轮询读取按键
c
void app_main(void) {
led_init();
button_init();
int last_state = 1; // 上一次按键状态（默认高电平）
while (1) {
int level = gpio_get_level(BUTTON_GPIO); // 读取当前电平
if (level == 0 && last_state == 1) {
// 检测到下降沿：按键按下
gpio_set_level(LED_GPIO, !gpio_get_level(LED_GPIO)); // 翻转 LED
printf("Button pressed! LED toggled.\n");
}
last_state = level;
vTaskDelay(10 / portTICK_PERIOD_MS); // 每 10ms 轮询一次
}
}3.4 按键消抖
机械按键在按下和释放的瞬间会产生抖动，持续约 5--20ms。如果不做消抖处理，一次按键可能被误判为多次。
c
#define DEBOUNCE_MS 20 // 消抖时间
void app_main(void) {
led_init();
button_init();
int stable = 1; // 稳定后的电平
int last_raw = 1; // 上次原始电平
TickType_t last_change = 0; // 上次变化时间
while (1) {
int raw = gpio_get_level(BUTTON_GPIO);
if (raw != last_raw) {
// 电平发生变化，记录时间
last_change = xTaskGetTickCount();
}
if ((xTaskGetTickCount() - last_change) >= pdMS_TO_TICKS(DEBOUNCE_MS)) {
// 电平稳定超过消抖时间
if (stable != raw) {
stable = raw;
if (stable == 0) {
// 按键确认按下
gpio_set_level(LED_GPIO, !gpio_get_level(LED_GPIO));
printf("Button debounced! LED toggled.\n");
}
}
}
last_raw = raw;
vTaskDelay(5 / portTICK_PERIOD_MS); // 每 5ms 采样一次
}
}消抖的原理很简单：连续采样，只有当电平稳定超过一定时间后才认为有效。
四、GPIO 中断：让程序主动响应
轮询方式虽然简单，但存在明显缺陷：
- CPU 被绑死在循环中，无法处理其他任务
- 轮询间隔捉襟见肘------太短浪费 CPU，太长可能错过脉冲
中断（Interrupt） 解决了这个问题：当指定事件发生时（如引脚电平变化），CPU 暂停当前任务，跳转到中断服务函数（ISR）执行，处理完成后再返回。
4.1 中断配置
c
#include "esp_log.h"
static const char *TAG = "GPIO_INTERRUPT";
static SemaphoreHandle_t button_semaphore; // 信号量，用于 ISR 和任务之间通信
// 中断服务函数
static void IRAM_ATTR button_isr_handler(void *arg) {
// 在 ISR 中不能调用 printf 等阻塞函数
// 通过信号量通知任务层处理
xSemaphoreGiveFromISR(button_semaphore, NULL);
}
void interrupt_init(void) {
// 1. 创建信号量
button_semaphore = xSemaphoreCreateBinary();
// 2. 配置 GPIO
gpio_reset_pin(BUTTON_GPIO);
gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
gpio_set_pull_mode(BUTTON_GPIO, GPIO_PULLUP_ONLY);
// 3. 设置中断类型：下降沿触发（高→低）
gpio_set_intr_type(BUTTON_GPIO, GPIO_INTR_NEGEDGE);
// 4. 安装 GPIO 中断服务
gpio_install_isr_service(ESP_INTR_FLAG_DEFAULT);
// 5. 注册中断回调
gpio_isr_handler_add(BUTTON_GPIO, button_isr_handler, NULL);
}4.2 中断类型
ESP32-S3 支持以下中断触发方式：
| 中断类型 | 宏定义 | 触发条件 |
|---|---|---|
| 上升沿触发 | GPIO_INTR_POSEDGE |
电平从低→高 |
| 下降沿触发 | GPIO_INTR_NEGEDGE |
电平从高→低 |
| 任意沿触发 | GPIO_INTR_ANYEDGE |
电平发生变化 |
| 低电平触发 | GPIO_INTR_LOWLEVEL |
引脚为低电平 |
| 高电平触发 | GPIO_INTR_HIGHLEVEL |
引脚为高电平 |
4.3 完整示例：按键中断控制 LED
下面是一个完整的实战示例，将本章所有知识点整合在一起：
c
#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "freertos/semphr.h"
#include "driver/gpio.h"
#include "esp_rom_sys.h"
#define LED_GPIO GPIO_NUM_48
#define BUTTON_GPIO GPIO_NUM_0
static SemaphoreHandle_t btn_sem;
// ISR ------ 中断服务函数
static void IRAM_ATTR btn_isr(void *arg) {
xSemaphoreGiveFromISR(btn_sem, NULL);
}
void app_main(void) {
// 初始化 LED 输出
gpio_reset_pin(LED_GPIO);
gpio_set_direction(LED_GPIO, GPIO_MODE_OUTPUT);
gpio_set_level(LED_GPIO, 0);
// 初始化按键输入（内部上拉）
gpio_reset_pin(BUTTON_GPIO);
gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
gpio_set_pull_mode(BUTTON_GPIO, GPIO_PULLUP_ONLY);
// 配置中断：下降沿触发
gpio_set_intr_type(BUTTON_GPIO, GPIO_INTR_NEGEDGE);
// 安装中断服务并注册回调
gpio_install_isr_service(ESP_INTR_FLAG_LEVEL3);
gpio_isr_handler_add(BUTTON_GPIO, btn_isr, NULL);
// 创建二值信号量
btn_sem = xSemaphoreCreateBinary();
printf("GPIO interrupt example started. Press the button!\n");
while (1) {
// 等待信号量（由 ISR 给出）
if (xSemaphoreTake(btn_sem, portMAX_DELAY) == pdTRUE) {
// 消抖：中断触发后等待 20ms 再读取
vTaskDelay(pdMS_TO_TICKS(20));
// 确认按键确实按下
if (gpio_get_level(BUTTON_GPIO) == 0) {
int level = gpio_get_level(LED_GPIO);
gpio_set_level(LED_GPIO, !level);
printf("Interrupt triggered! LED %s\n",
level ? "OFF" : "ON");
}
}
}
}4.4 ISR 编写注意事项
中断服务函数有严格限制，务必遵守以下规则：
- 函数必须加
IRAM_ATTR属性，确保代码在 IRAM 中执行 - 禁止调用阻塞函数 ：如
printf、vTaskDelay等 - 保持简短：ISR 中仅做标志位或信号量通知，不处理业务逻辑
- 避免复杂运算：浮点运算、大的循环都不适合在 ISR 中执行
五、总结
本章系统性地介绍了 ESP32-S3 的 GPIO 编程，核心要点如下：
- GPIO 模式：掌握推挽输出、上拉输入等模式的区别与适用场景
- 输出控制 ：通过
gpio_set_level控制引脚电平，实现 LED 亮灭和呼吸效果 - 输入读取 ：利用内部上拉简化按键电路，通过
gpio_get_level读取引脚状态 - 按键消抖：机械按键必须消抖，软件消抖是经济有效的方案
- 中断机制：替代轮询，提高 CPU 利用率，实现高效的响应式编程
下篇预告
第3章：定时器与PWM输出 ------ 学习 ESP32-S3 的硬件定时器和 LEDC 控制器，实现精确的时序控制和 PWM 调光、舵机驱动等功能。
本文基于 ESP-IDF v5.x 编写，GPIO 引脚号请根据实际开发板调整。