📚 课程目录第2章 GPIO基础与LED控制

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

各位同学，欢迎来到第二章。这一章我们开始真正动手了——控制ESP32的引脚，让LED亮起来、灭下去，再玩点高级的呼吸效果。

GPIO，全称General-Purpose Input/Output，通用输入输出口。说白了，它就是芯片伸出来的那些金属脚，你可以让它们输出高电平（3.3V）或低电平（0V），也可以读取外部信号是高还是低。ESP32有34个GPIO引脚，但不是所有都能随便用，后面我会讲哪些是坑。

核心概念：数字输出 = 让引脚输出0或1。0对应0V，1对应3.3V。就这么简单。

数字输出原理

ESP32内部，每个GPIO引脚都连接着一个输出驱动器。当你通过软件把引脚设为高电平时，内部寄存器会控制一个MOS管导通，把引脚拉到VDD（3.3V）。设为低电平时，另一个MOS管导通，把引脚拉到GND（0V）。

嗯，这里要注意：ESP32的GPIO输出电流有限，单个引脚最大能提供40mA，但整个芯片总电流不能超过某个值。我在项目中遇到过有人直接拿GPIO驱动继电器，结果芯片烧了——那玩意儿需要上百毫安。驱动LED没问题，但一定要串电阻限流。

LED的正向压降一般是2V左右，工作电流10-20mA。用3.3V驱动，串一个220Ω或330Ω的电阻就刚刚好。你想想看，如果不串电阻，LED会把电流拉到多大？理论上会烧掉LED或GPIO。

参数	典型值	说明
GPIO高电平	3.3V	与VDD相同
GPIO低电平	0V	与GND相同
最大输出电流	40mA/引脚	建议不超过20mA
LED正向压降	1.8-2.2V	红色LED较低
限流电阻	220-470Ω	根据亮度调整

GPIO库函数

ESP-IDF提供了完整的GPIO驱动API。我个人习惯用这套函数，简洁明了。核心就几个：

gpio_config() — 配置引脚模式、上下拉、中断等
gpio_set_level() — 设置引脚输出高或低
gpio_get_level() — 读取引脚电平

配置一个引脚为输出模式，代码长这样：

// 配置GPIO2为输出模式
gpio_config_t io_conf = {
    .pin_bit_mask = (1ULL << GPIO_NUM_2),
    .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);

// 输出高电平
gpio_set_level(GPIO_NUM_2, 1);

// 输出低电平
gpio_set_level(GPIO_NUM_2, 0);

小技巧：用 gpio_set_level() 时，第二个参数传0或1。别传true/false，虽然C语言里它们等价，但可读性差。我习惯用0和1，一目了然。

为什么用 gpio_config() 而不是直接操作寄存器？因为ESP-IDF帮你做了很多底层处理，比如时钟使能、IO MUX配置。直接操作寄存器虽然快，但可移植性差，而且容易踩坑。我曾经为了省几个时钟周期直接写寄存器，结果换了个芯片版本就不兼容了——教训啊。

LED闪烁实验

好了，理论讲完，咱们动手。经典的点灯程序，其实就是让LED以一定频率交替亮灭。

核心逻辑：

配置GPIO为输出模式
循环中：输出高电平 → 延时 → 输出低电平 → 延时
延时用 vTaskDelay() 或 esp_rom_delay_us()

完整代码：

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

#define LED_GPIO GPIO_NUM_2

void app_main(void)
{
    // 配置GPIO
    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);  // 延时500ms
        gpio_set_level(LED_GPIO, 0);   // 灭
        vTaskDelay(500 / portTICK_PERIOD_MS);
    }
}

注意：ESP32开发板上，GPIO2通常连接着一个板载LED。但有些开发板用的是GPIO1或GPIO5。上电前先查一下原理图，别焊了半天发现引脚不对。

编译烧录后，你会看到LED以1Hz的频率闪烁。如果你用的是ESP32-C3或S3，引脚号可能不同，记得改宏定义。

PWM调光

闪烁太单调了？咱们来点高级的——PWM调光，让LED平滑地由亮变暗，再由暗变亮，像呼吸一样。

PWM，脉冲宽度调制。说白了，就是快速开关引脚，通过调整高电平占整个周期的比例（占空比）来改变平均电压。人眼有视觉暂留效应，只要频率够高（通常1kHz以上），看到的就是连续亮度变化。

ESP32有两个硬件PWM控制器，每个控制器有多个通道。我建议用LEDC（LED Control）外设，它是专门为LED调光设计的。

配置步骤：

配置定时器（频率、分辨率）
配置通道（绑定GPIO、定时器）
设置占空比

代码示例：

#include "driver/ledc.h"

#define LED_GPIO GPIO_NUM_2
#define LEDC_TIMER LEDC_TIMER_0
#define LEDC_CHANNEL LEDC_CHANNEL_0
#define LEDC_MODE LEDC_LOW_SPEED_MODE
#define LEDC_DUTY_RES LEDC_TIMER_13_BIT  // 分辨率13位，占空比0-8191
#define LEDC_FREQUENCY 5000  // 5kHz

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

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

void app_main(void)
{
    ledc_init();

    while (1) {
        // 渐亮
        for (int duty = 0; duty < 8191; duty += 50) {
            ledc_set_duty(LEDC_MODE, LEDC_CHANNEL, duty);
            ledc_update_duty(LEDC_MODE, LEDC_CHANNEL);
            vTaskDelay(10 / portTICK_PERIOD_MS);
        }
        // 渐暗
        for (int duty = 8191; duty >= 0; duty -= 50) {
            ledc_set_duty(LEDC_MODE, LEDC_CHANNEL, duty);
            ledc_update_duty(LEDC_MODE, LEDC_CHANNEL);
            vTaskDelay(10 / portTICK_PERIOD_MS);
        }
    }
}

经验之谈：分辨率越高，调光越细腻，但最大频率会降低。13位分辨率下，最大频率约5kHz。如果要做电机控制，可能需要更低分辨率换取更高频率。我做过一个项目，用10位分辨率跑20kHz，效果很好。

为什么调光要用PWM而不是直接调电压？因为ESP32没有模拟输出。PWM是数字芯片实现模拟效果的标准做法。你想想看，一个引脚要么0V要么3.3V，但通过快速切换，平均电压可以是0到3.3V之间的任意值——这就是PWM的精髓。

下面这张图展示了本章的知识脉络，从GPIO基础到PWM应用，每一步都是递进的：

最后说一句：PWM调光看似简单，但实际项目中坑不少。比如LEDC的时钟源选择，不同时钟源会影响频率精度。我建议用 LEDC_AUTO_CLK，让驱动自己选最优时钟。还有，占空比更新后一定要调用 ledc_update_duty()，否则不会生效——这个我踩过，查了半天才发现。

好了，这一章的内容就是这些。把代码跑起来，看看LED呼吸的效果，你会很有成就感。