GPIO 基础与 LED 控制：数字输出原理、库函数、闪烁实验与 PWM 调光

各位同学，欢迎来到第二章。上一章我们搭好了开发环境，今天终于可以动手让硬件“活”起来了。这一章的核心就一个——控制 GPIO 引脚。说白了，就是让芯片的某个引脚输出高电平或低电平，去点亮或熄灭一个 LED。

听起来简单？嗯，确实不复杂。但这里面藏着嵌入式开发最基础也最重要的概念：数字输出、寄存器操作、库函数封装，以及后面会遇到的 PWM 调光。我当年刚入行时，以为点灯就是点灯，直到在一个工业项目里因为 GPIO 驱动能力不足导致继电器误动作……从那以后，我对每个引脚的电气特性都格外小心。

2.1 数字输出原理：从芯片引脚到 LED 点亮

先问一个问题：为什么 GPIO 输出高电平就能点亮 LED？

GPIO（General Purpose Input/Output）是芯片最基础的对外接口。每个 GPIO 引脚内部都有一个输出驱动器，可以把它理解成一个电子开关。当你在代码里设置引脚为高电平时，这个开关会把引脚连接到芯片内部的 VCC（通常是 3.3V）；设置为低电平时，则连接到 GND（0V）。

LED 的正极通过一个限流电阻接到 GPIO 引脚，负极接到 GND。当引脚输出高电平，电流从引脚流过 LED 到地，灯就亮了。就这么简单。

ESP32 的 GPIO 支持两种输出模式：

控制 LED 我们只用推挽输出。开漏模式后面讲 I²C 时会详细说。

2.2 GPIO 库函数：ESP-IDF 的封装与使用

ESP-IDF 提供了一套完整的 GPIO 驱动库。你不需要直接操作寄存器——虽然那样更底层，但可读性差，容易出错。我个人习惯先用库函数把功能调通，性能瓶颈时再考虑寄存器优化。

使用 GPIO 库函数分三步：

1. 配置引脚：调用 gpio_config() 设置引脚号、模式、上下拉等
2. 设置电平：调用 gpio_set_level() 输出高或低
3. 读取电平：调用 gpio_get_level() 读取输入状态（后面章节会用到）

来看一个完整的配置示例：

#include "driver/gpio.h"

#define LED_GPIO_PIN  GPIO_NUM_2   // 开发板上的 LED 通常接 GPIO2

void led_init(void) {
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << LED_GPIO_PIN),  // 选中 GPIO2
        .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);
}

配置完成后，控制 LED 就只需要一行代码：

gpio_set_level(LED_GPIO_PIN, 1);  // 点亮
gpio_set_level(LED_GPIO_PIN, 0);  // 熄灭

2.3 LED 闪烁实验：第一个完整的嵌入式程序

好了，理论讲完，我们动手写一个完整的 LED 闪烁程序。这个实验会用到 FreeRTOS 的延时函数 vTaskDelay()。

为什么不用 delay()？因为 vTaskDelay() 会让出 CPU 给其他任务，而 delay() 是忙等待，浪费 CPU 资源。在嵌入式系统里，永远不要用忙等待——除非你很清楚自己在做什么。

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"

#define LED_GPIO_PIN  GPIO_NUM_2

void app_main(void) {
    // 配置 GPIO
    gpio_config_t io_conf = {
        .pin_bit_mask = (1ULL << LED_GPIO_PIN),
        .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_PIN, 1);   // 点亮
        vTaskDelay(500 / portTICK_PERIOD_MS);  // 延时 500ms
        gpio_set_level(LED_GPIO_PIN, 0);   // 熄灭
        vTaskDelay(500 / portTICK_PERIOD_MS);
    }
}

编译、烧录、运行。如果一切正常，你会看到开发板上的 LED 以 1 秒为周期闪烁（亮 0.5 秒，灭 0.5 秒）。

2.4 PWM 调光基础：让 LED 呼吸起来

闪烁实验只能让 LED 全亮或全灭。如果想实现渐亮渐暗的呼吸效果，就需要 PWM（脉冲宽度调制）。

PWM 的原理很简单：以固定的频率快速切换高低电平，通过改变高电平占整个周期的比例（即占空比）来调节平均电压。人眼有视觉暂留效应，只要频率足够高（通常 1kHz 以上），看到的就不是闪烁，而是稳定的亮度。

ESP32 的 LEDC（LED Control）模块专门用于生成 PWM 信号。使用它需要配置：

• 定时器：决定 PWM 的频率和分辨率
• 通道：将定时器绑定到具体的 GPIO 引脚
• 占空比：通过 ledc_set_duty() 设置

下面是一个呼吸灯的核心代码片段：

#include "driver/ledc.h"

#define LEDC_TIMER      LEDC_TIMER_0
#define LEDC_MODE       LEDC_LOW_SPEED_MODE
#define LEDC_CHANNEL    LEDC_CHANNEL_0
#define LEDC_GPIO       GPIO_NUM_2
#define LEDC_FREQ       5000    // 5kHz 频率
#define LEDC_RESOLUTION LEDC_TIMER_10_BIT  // 10位分辨率，占空比范围 0-1023

void pwm_init(void) {
    // 配置定时器
    ledc_timer_config_t timer_conf = {
        .speed_mode = LEDC_MODE,
        .timer_num = LEDC_TIMER,
        .duty_resolution = LEDC_RESOLUTION,
        .freq_hz = LEDC_FREQ,
        .clk_cfg = LEDC_AUTO_CLK
    };
    ledc_timer_config(&timer_conf);

    // 配置通道
    ledc_channel_config_t channel_conf = {
        .gpio_num = LEDC_GPIO,
        .speed_mode = LEDC_MODE,
        .channel = LEDC_CHANNEL,
        .timer_sel = LEDC_TIMER,
        .duty = 0,
        .hpoint = 0
    };
    ledc_channel_config(&channel_conf);
}

// 设置占空比，duty 范围 0-1023
void set_brightness(int duty) {
    ledc_set_duty(LEDC_MODE, LEDC_CHANNEL, duty);
    ledc_update_duty(LEDC_MODE, LEDC_CHANNEL);
}

你可能会问：为什么不用软件延时配合 gpio_set_level() 模拟 PWM？理论上可以，但实际效果很差——CPU 被占满，无法处理其他任务，而且频率不稳定。硬件 PWM 模块是独立运行的，设置好之后 CPU 就可以去干别的事了。这也是嵌入式开发的一个重要原则：能用硬件外设解决的问题，就不要用软件去模拟。

好了，这一章的内容就是这些。从数字输出的基本原理，到 GPIO 库函数的使用，再到闪烁实验和 PWM 调光，每一步都是后面章节的基础。尤其是 PWM，后面驱动 OLED 屏幕的背光、控制舵机、调节电机速度，都会用到它。