单片机与物联网 / 系统课时
控制数字输出
控制数字输出
数字输出是 ESP32 控制外部世界的最小动作:先把一个可输出 GPIO 配置为输出模式,再写入高、低电平。本节以外接 LED 为主示例,并说明蜂鸣器等负载的驱动边界,完成“接线—编程—验证—排错”的完整闭环。
学习目标
- 正确把 GPIO 配置为数字输出并切换高、低电平
- 安全连接外接 LED,理解限流电阻与公共地的作用
- 根据现象判断接线、引脚和负载类型造成的常见问题
接线前先确认电气边界
ESP32 GPIO 通常使用 3.3 V 逻辑电平,适合控制 LED 这类低功耗指示负载,但不能把 GPIO 当作通用电源输出。不同 ESP32 芯片和开发板的可用引脚并不完全相同,应优先查看开发板原理图,避开仅输入、被 Flash/PSRAM 占用或会影响启动配置的引脚。
外接 LED 建议采用“GPIO → 限流电阻 → LED → GND”的方式。这样写入高电平时电流从 GPIO 流向地,LED 点亮;写入低电平时熄灭。限流电阻不能省略。

用 Arduino Core 控制外接 LED
下面使用 Arduino Core。示例假设 LED 经 330 Ω 电阻连接到 GPIO 18 和 GND;如果你的开发板 GPIO 18 不存在或不适合使用,请把 LED_PIN 改成原理图确认过的可输出 GPIO。
const int LED_PIN = 18;
void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
digitalWrite(LED_PIN, LOW); // 先给出确定的初始状态
}
void loop() {
digitalWrite(LED_PIN, HIGH);
Serial.println("LED=HIGH");
delay(500);
digitalWrite(LED_PIN, LOW);
Serial.println("LED=LOW");
delay(500);
}预期输出
LED=HIGH
LED=LOW
LED=HIGH
LED=LOW
...同时可以看到外接 LED 约每 500 ms 亮灭一次。串口输出用于确认程序确实在切换状态;如果串口正常但 LED 不亮,问题更可能位于 GPIO 选择或接线,而不是主循环。
从代码到引脚电平
pinMode(LED_PIN, OUTPUT) 决定引脚由 ESP32 主动驱动;digitalWrite(..., HIGH) 和 digitalWrite(..., LOW) 决定输出逻辑电平。对于本节的“GPIO 经电阻接 LED 再到 GND”接法,HIGH 对应点亮,LOW 对应熄灭。
开发板自带 LED 不一定采用这种极性,有些板卡会经过额外驱动电路或采用低电平点亮,因此不能只凭“板载 LED 的亮灭方向”推断 GPIO API 是否正确。入门阶段用外接 LED 更容易建立一致的判断标准。
现象不对时按顺序排查
先确认程序是否正在运行,再检查引脚,最后检查负载。这样比反复改代码更快。
| 现象 | 优先检查 | 处理 |
|---|---|---|
| 串口有 HIGH/LOW,LED 不亮 | LED 极性、限流电阻、GPIO 编号、GND | 重新核对接线并确认所选引脚支持输出 |
| LED 始终亮或逻辑相反 | 实际接线极性或板载驱动电路 | 用外接 LED 验证,必要时反转控制逻辑 |
| 上电后启动异常 | 选到了影响启动或板载功能的引脚 | 换用开发板文档推荐的普通 GPIO |
| 蜂鸣器只“咔哒”一下 | 使用了无源蜂鸣器 | 改用 PWM 产生音频频率,或改用有源蜂鸣器 |
| 负载工作但 ESP32 不稳定 | GPIO 直接承担过大电流 | 使用晶体管或 MOSFET 驱动并确保共地 |
数字输出的核心只有“配置方向”和“写入电平”两步,但可靠控制还取决于正确的引脚选择和负载驱动。只要把 GPIO 当作逻辑控制信号而不是电源,就能从 LED 平滑扩展到蜂鸣器、继电器驱动级和其他执行器。