4、GPIO控制：点亮LED、读取按键状态、理解上拉/下拉电阻

各位同学，欢迎来到第四讲。今天咱们要跟ESP32的“手脚”——GPIO引脚——打交道。说白了，GPIO就是芯片上那些可以编程控制的针脚，既能输出高低电平去驱动LED，也能读取外部信号，比如按键有没有被按下。

我个人习惯把GPIO比作一个“双向开关”。你可以命令它输出高电平（3.3V）或低电平（0V），也可以让它“听”外面的电平是高还是低。嗯，这里要注意，不是所有引脚都能干所有事，有些引脚有特殊功能，比如ADC、触摸等，但作为通用输入输出，大部分引脚都行。

4.1 点亮LED：最简单的输出实验

先来个经典的“Hello World”——点亮LED。在ESPHome里，控制GPIO输出非常简单。你只需要在配置里声明一个output组件，然后把它绑定到一个light组件上。

我在项目中遇到过不少新手直接把LED正极接GPIO，负极接GND，结果发现灯不亮或者烧了引脚。为什么？因为GPIO的驱动能力有限，一般只能提供几毫安电流。正确的做法是：GPIO → 电阻（约330Ω） → LED正极 → LED负极 → GND。

下面是一个完整的ESPHome配置示例：

# 点亮一个LED
output:
  - platform: gpio
    pin: GPIO2
    id: my_led

light:
  - platform: binary
    name: "板载LED"
    output: my_led

这段代码做了三件事：

定义了一个GPIO输出，引脚是GPIO2，给它起了个ID叫my_led
创建了一个二进制灯（开/关），名字叫“板载LED”
把这个灯绑定到刚才的输出上

上传到ESP32后，你就能在Home Assistant里看到这个灯了。点击开关，LED就会亮灭。是不是很简单？

小技巧： 如果你用的是ESP32开发板，很多板子上的LED已经串联了电阻，直接接在GPIO2上。但如果你自己搭电路，千万别忘了加限流电阻！我一般用330Ω，电流大约10mA，既亮又安全。

4.2 读取按键状态：输入信号怎么抓

输出搞定了，咱们来看看输入。读取按键状态，本质上就是检测GPIO引脚上的电平变化。按键按下时，引脚被拉到低电平或高电平，我们通过程序读取这个变化。

ESPHome里用binary_sensor组件来处理按键。看这个例子：

# 读取按键状态
binary_sensor:
  - platform: gpio
    pin:
      number: GPIO0
      mode:
        input: true
        pullup: true
    name: "按键"
    filters:
      - debounce: 50ms
    on_press:
      then:
        - light.toggle: my_led

这里有几个关键点：

pin.number：指定引脚号，我用的是GPIO0，很多开发板上它连接着BOOT按键
mode.input: true：明确告诉芯片，这个引脚是输入模式
mode.pullup: true：启用内部上拉电阻，后面会细说
filters - debounce: 50ms：去抖滤波，防止按键抖动产生误触发
on_press：按下时触发动作，这里我让它切换LED的亮灭

上传后，你按下按键，LED就会翻转状态。嗯，这里要注意，GPIO0在ESP32上还有一个特殊身份——下载模式引脚。如果上电时它被拉低，芯片会进入固件下载模式。所以平时用这个引脚做按键没问题，但别在启动时按住不放。

4.3 上拉与下拉电阻：为什么需要它们？

你可能会问：为什么读取按键时要启用上拉电阻？直接读引脚不行吗？

这个问题问得好。想象一下，按键一端接GND，另一端接GPIO。按键没按下时，GPIO引脚是悬空的，电平不确定，可能读到0也可能读到1，这就是所谓的“浮空状态”。上拉电阻的作用就是给这个悬空的引脚一个确定的电平——高电平。

我画了一张图帮你理解：

看上图，当按键没按下时，GPIO通过10kΩ电阻被拉到3.3V，读到高电平。按下后，GPIO直接连到GND，读到低电平。这个10kΩ电阻就是上拉电阻，它保证了引脚不会浮空。

下拉电阻原理类似，只是把电阻接到GND，按键接到VCC。按下时读到高电平，松开时读到低电平。

  核心要点：
  上拉电阻：默认高电平，按下变低电平（内部上拉常用10kΩ~100kΩ）
下拉电阻：默认低电平，按下变高电平
ESP32内部有可编程的上拉/下拉电阻，省去了外部元件
启用内部上拉：pullup: true；启用内部下拉：pulldown: true

4.4 避坑指南：我踩过的那些坑

做嵌入式这么多年，GPIO这块我栽过不少跟头。分享几个典型问题：

引脚不够用？ 我曾经在一个项目里用了12个按键，每个都配外部上拉电阻，板子密密麻麻。后来改用内部上拉，省了12个电阻和一堆走线。ESP32的内部上拉足够稳定，放心用。
按键误触发？ 机械按键按下时会有抖动，产生多个脉冲。不加去抖处理，一次按下可能触发多次。我习惯加50ms的去抖滤波，效果很好。
引脚烧了？ 有一次我把LED直接接在GPIO上，没加电阻，结果LED很亮，但GPIO引脚烫得能煎鸡蛋。后来查手册才知道，ESP32单个GPIO最大输出电流是40mA，但建议不要超过12mA。所以，限流电阻不是可选项，是必选项。
上电瞬间电平不确定？ 有些外设在上电瞬间会误动作，因为GPIO在初始化前是浮空的。我的做法是在配置里加上inverted: true或者用外部上拉/下拉，确保上电时电平是确定的。

警告： 千万不要用GPIO直接驱动大功率设备，比如电机、继电器线圈。这些设备需要驱动电路（如三极管、MOS管或继电器模块）。直接驱动会烧毁GPIO引脚，甚至损坏整个芯片。我见过有人用GPIO直接驱动5V继电器，结果芯片冒烟了。

4.5 实战：做一个带按键的智能灯

理论讲完了，咱们来点实战。把前面学的输出和输入结合起来，做一个可以通过按键控制的智能灯。

硬件连接：

LED正极 → 330Ω电阻 → GPIO2
LED负极 → GND
按键一端 → GPIO0
按键另一端 → GND

ESPHome完整配置：

esphome:
  name: smart_light
  platform: ESP32
  board: nodemcu-32s

# 启用日志和API
logger:
api:

# 定义输出
output:
  - platform: gpio
    pin: GPIO2
    id: led_output

# 定义灯
light:
  - platform: binary
    name: "智能灯"
    output: led_output
    id: smart_light_id

# 定义按键
binary_sensor:
  - platform: gpio
    pin:
      number: GPIO0
      mode:
        input: true
        pullup: true
    name: "控制按键"
    filters:
      - debounce: 50ms
    on_press:
      then:
        - light.toggle: smart_light_id
    on_double_click:
      then:
        - light.turn_on:
            id: smart_light_id
            brightness: 100%

这个配置比之前多了个on_double_click事件——双击按键时，把灯调到最亮。你看，通过组合不同的触发事件，一个按键就能实现多种控制。

我个人习惯在按键事件里加一些反馈，比如按下时让LED闪一下，或者蜂鸣器响一声。这样用户操作时能获得即时反馈，体验会好很多。

好了，这一章的内容就到这里。GPIO控制是嵌入式开发的基础，掌握了输出和输入，你就能做出很多有趣的东西。下一章我们会深入传感器，看看怎么读取模拟信号和数字信号。记住，多动手，多实践，遇到问题先查手册，再问搜索引擎，最后再来问我。

可可精品资料库

📚 课程目录

4、GPIO控制：点亮LED、读取按键状态、理解上拉/下拉电阻

4.1 点亮LED：最简单的输出实验

4.2 读取按键状态：输入信号怎么抓

4.3 上拉与下拉电阻：为什么需要它们？

4.4 避坑指南：我踩过的那些坑

4.5 实战：做一个带按键的智能灯