GPIO基础与数字信号：从点亮一盏灯说起

各位同学，欢迎来到第二章。上一章我们搭好了开发环境，今天来点实在的——跟GPIO打交道。

GPIO，全称General Purpose Input Output，通用输入输出口。说白了，就是芯片上那些可以编程控制的引脚。你可以让它输出高电平（3.3V）或低电平（0V），也可以读取外部信号是高还是低。

我个人习惯把GPIO比作芯片的「手脚」——它能对外界做动作（输出），也能感知外界（输入）。ESP32有34个GPIO引脚，但不是所有都能随便用，这个后面会讲。

GPIO模式配置：用之前先想好

在ESP32上操作GPIO，第一步永远是配置模式。就像你拿一把螺丝刀之前，得先想好是拧螺丝还是撬东西。

ESP-IDF里用 gpio_set_direction() 函数来配置。看个例子：

#include <driver/gpio.h>

#define LED_GPIO   GPIO_NUM_2
#define BTN_GPIO   GPIO_NUM_0

void app_main(void)
{
    // 配置LED引脚为输出模式
    gpio_set_direction(LED_GPIO, GPIO_MODE_OUTPUT);
    
    // 配置按键引脚为输入模式
    gpio_set_direction(BTN_GPIO, GPIO_MODE_INPUT);
}

常用的模式就这几种：

digitalWrite与digitalRead：最基础的操作

模式配好了，接下来就是读写操作。ESP-IDF里对应的函数是 gpio_set_level() 和 gpio_get_level()。

// 输出：点亮LED
gpio_set_level(LED_GPIO, 1);   // 高电平，LED亮
gpio_set_level(LED_GPIO, 0);   // 低电平，LED灭

// 输入：读取按键状态
int level = gpio_get_level(BTN_GPIO);
if (level == 0) {
    printf("按键被按下\n");
}

这里有个细节：gpio_set_level() 的第二个参数，传0或1就行。但 gpio_get_level() 返回的是 int 类型，不是bool。虽然值只有0和1，但类型上要注意。

按键输入与消抖：别被「毛刺」骗了

按键输入看起来简单，但实际项目中坑不少。我记得第一次做产品原型时，用按键控制LED开关，结果按一下灯闪了好几下。查了半天，原来是没做消抖。

为什么会这样？机械按键内部是金属弹片，按下和释放的瞬间会多次弹跳，产生一连串的脉冲信号。这个弹跳时间通常持续5-20ms。如果不处理，程序会误认为你按了好多次。

消抖有两种主流方式：

硬件消抖

在按键引脚上加一个RC低通滤波器。电阻R和电容C组成积分电路，把毛刺平滑掉。参数一般选R=10kΩ，C=0.1μF，时间常数约1ms。

软件消抖

更灵活，成本更低。核心思路：检测到电平变化后，延时一段时间再确认。

#define DEBOUNCE_MS  20   // 消抖延时20ms

int read_button_debounced(gpio_num_t gpio)
{
    static int last_level = 1;  // 假设默认高电平
    static uint64_t last_time = 0;
    
    int cur_level = gpio_get_level(gpio);
    uint64_t now = esp_timer_get_time() / 1000;  // 转成ms
    
    if (cur_level != last_level) {
        if ((now - last_time) > DEBOUNCE_MS) {
            last_level = cur_level;
            last_time = now;
            return cur_level;  // 返回稳定后的电平
        }
    } else {
        last_time = now;
    }
    
    return -1;  // 表示无有效变化
}

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

ESP32的GPIO内部集成了可编程的上拉和下拉电阻。什么意思？就是你可以通过软件配置，让引脚在悬空时保持一个确定的电平，而不需要在外围加电阻。

配置方法很简单：

// 使能内部上拉电阻（默认高电平）
gpio_set_pull_mode(BTN_GPIO, GPIO_PULLUP_ONLY);

// 使能内部下拉电阻（默认低电平）
gpio_set_pull_mode(BTN_GPIO, GPIO_PULLDOWN_ONLY);

// 都不使能（高阻态）
gpio_set_pull_mode(BTN_GPIO, GPIO_FLOATING);

三种模式对比：

知识体系总览

这一章的内容，我用一张图串起来：

这张图把本章的核心知识点串起来了。从GPIO这个根节点出发，分三条线：模式配置、读写操作、按键消抖。底部是内部上拉/下拉电阻，它贯穿输入输出的各个环节。