2. ESP32 GPIO 基础：从寄存器到实战

GPIO 是嵌入式开发最基础、也最常用的外设。说白了，就是芯片和外界打交道的「手脚」。ESP32 有 34 个 GPIO 引脚，但并不是所有引脚都能随便用——嗯，这里要注意，有些引脚有特殊功能，比如 ADC、DAC、触摸传感器等。

我个人习惯，拿到一块新板子，第一件事就是看 GPIO 功能分配表。别嫌麻烦，这一步能省下后面很多调试时间。

2.1 GPIO 寄存器映射：硬件是怎么工作的？

ESP32 的 GPIO 外设挂在 APB 总线上，基地址是 0x3FF44000。每个 GPIO 引脚的控制寄存器都映射到这个地址空间里。

举个例子，GPIO 输出寄存器 GPIO_OUT_REG 的偏移量是 0x0004。你要让 GPIO2 输出高电平，就往这个寄存器的 bit 2 写 1。

你想想看，如果直接用寄存器操作，代码会写成什么样？

// 直接操作寄存器点亮 LED（GPIO2）
#define GPIO_OUT_REG       (*(volatile uint32_t *)0x3FF44004)
#define GPIO_ENABLE_REG    (*(volatile uint32_t *)0x3FF44020)

void gpio_init(void) {
    GPIO_ENABLE_REG |= (1 << 2);   // 设置 GPIO2 为输出
}

void led_on(void) {
    GPIO_OUT_REG |= (1 << 2);      // GPIO2 输出高电平
}

void led_off(void) {
    GPIO_OUT_REG &= ~(1 << 2);     // GPIO2 输出低电平
}

我在项目中遇到过，有人直接用寄存器操作，结果地址写错了，整块板子 GPIO 全乱套。所以，除非是 bootloader 或极端性能要求，否则我建议用 ESP-IDF 的驱动层 API。

2.2 数字输入输出：用 ESP-IDF 优雅地控制 GPIO

ESP-IDF 封装了一套 GPIO 驱动 API，用起来清爽多了。核心函数就几个：

• gpio_config() —— 一次性配置引脚模式、上拉/下拉、中断类型
• gpio_set_level() —— 设置输出电平
• gpio_get_level() —— 读取输入电平

来看一个完整的 LED 闪烁例子：

#include "driver/gpio.h"

#define LED_GPIO   GPIO_NUM_2

void app_main(void) {
    // 配置 GPIO2 为推挽输出
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << LED_GPIO),
        .mode = GPIO_MODE_OUTPUT,
        .pull_up_en = GPIO_PULLUP_DISABLE,
        .pull_down_en = GPIO_PULLDOWN_DISABLE,
        .intr_type = GPIO_INTR_DISABLE
    };
    gpio_config(&io_conf);

    while (1) {
        gpio_set_level(LED_GPIO, 1);
        vTaskDelay(500 / portTICK_PERIOD_MS);
        gpio_set_level(LED_GPIO, 0);
        vTaskDelay(500 / portTICK_PERIOD_MS);
    }
}

2.3 按键消抖实战：别让毛刺坑了你

机械按键按下和释放的瞬间，会产生 10~20ms 的抖动。如果不做消抖，一次按键可能被误判成多次。

我曾经在一个智能家居项目里，按键没做消抖，结果用户按一次灯，灯闪了三次。客户投诉说「这灯是不是有鬼」……从那以后，我再也不敢省消抖代码。

消抖有两种主流方式：

方式	原理	适用场景
硬件消抖	RC 低通滤波 + 施密特触发器	对实时性要求高的场合
软件消抖	延时采样 / 状态机去抖	大多数嵌入式应用，成本低

这里我推荐用 状态机消抖，不阻塞 CPU，适合 RTOS 环境：

#define KEY_GPIO       GPIO_NUM_0
#define DEBOUNCE_MS    20

typedef enum {
    KEY_STATE_IDLE,
    KEY_STATE_PRESSED,
    KEY_STATE_CONFIRM
} key_state_t;

key_state_t key_state = KEY_STATE_IDLE;
uint32_t last_tick = 0;

void key_scan(void) {
    uint8_t level = gpio_get_level(KEY_GPIO);
    uint32_t now = xTaskGetTickCount();

    switch (key_state) {
        case KEY_STATE_IDLE:
            if (level == 0) {  // 检测到按下（低电平有效）
                key_state = KEY_STATE_PRESSED;
                last_tick = now;
            }
            break;

        case KEY_STATE_PRESSED:
            if ((now - last_tick) > pdMS_TO_TICKS(DEBOUNCE_MS)) {
                if (gpio_get_level(KEY_GPIO) == 0) {
                    key_state = KEY_STATE_CONFIRM;
                    // 在这里执行按键动作
                    printf("Key pressed!\n");
                } else {
                    key_state = KEY_STATE_IDLE;  // 抖动干扰，复位
                }
            }
            break;

        case KEY_STATE_CONFIRM:
            if (level == 1) {  // 等待释放
                key_state = KEY_STATE_IDLE;
            }
            break;
    }
}

2.4 内部上拉/下拉电阻：省掉外部元件的秘诀

ESP32 每个 GPIO 内部都集成了 上拉电阻（约 45kΩ） 和 下拉电阻（约 45kΩ）。用内部电阻，可以省掉 PCB 上的外部电阻，降低成本。

配置方式很简单，在 gpio_config_t 结构体里设置：

gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_0),
    .mode = GPIO_MODE_INPUT,
    .pull_up_en = GPIO_PULLUP_ENABLE,    // 使能内部上拉
    .pull_down_en = GPIO_PULLDOWN_DISABLE,
    .intr_type = GPIO_INTR_DISABLE
};
gpio_config(&io_conf);

使用场景对照：

场景	推荐配置	原因
按键（一端接 GND）	内部上拉	按键按下时拉低，空闲时高电平
按键（一端接 VCC）	内部下拉	按键按下时拉高，空闲时低电平
I2C 总线	外部上拉（内部阻值太大）	内部 45kΩ 无法满足 I2C 上升时间要求
未使用的引脚	内部下拉	防止浮空引脚引入噪声和额外功耗

2.5 本章知识体系

下面这张图把 GPIO 的核心知识点串起来了，方便你对照复习：

GPIO 看似简单，但寄存器映射、输入输出配置、按键消抖、上拉下拉这四个知识点，是后续所有外设驱动的基础。我建议你拿到开发板后，先把这几个实验跑一遍，花不了多少时间，但后面写 I2C、SPI、UART 驱动时，你会感谢现在的自己。