1. 点亮板载LED

任务目标

编写并烧录一个最小固件,控制ESP32开发板上的板载LED以1秒间隔闪烁(亮500ms、灭500ms),以此熟悉GPIO输出模式配置与延时函数的使用。

硬件与环境

  • 硬件:任意常见ESP32开发板(如ESP32-DevKitC、NodeMCU-32S)。
  • 板载LED引脚:大多数开发板为GPIO2(如NodeMCU-32S、ESP32-DevKitC V4),部分板型为GPIO1或GPIO8。若不确定,请查阅您开发板的原理图或丝印标注。
  • 软件:Arduino IDE(需安装esp32开发板支持包,或使用PlatformIO + ESP32平台)。
  • 驱动:确保USB转串口驱动(CP210x或CH340)已正确安装,开发板可被电脑识别。

关键完整代码

以下代码为完整可编译程序,直接实现LED闪烁功能:

// 板载LED引脚定义(NodeMCU-32S / DevKitC V4 通常为GPIO2)
const int ledPin = 2;

void setup() {
  // 将LED引脚配置为输出模式
  pinMode(ledPin, OUTPUT);
}

void loop() {
  digitalWrite(ledPin, HIGH);   // 点亮LED
  delay(500);                   // 保持500ms
  digitalWrite(ledPin, LOW);    // 熄灭LED
  delay(500);                   // 保持500ms
}

编译与烧录步骤

  1. 在Arduino IDE中,选择正确的开发板型号:工具 → 开发板 → ESP32 Dev Module(或对应您的板型)。
  2. 选择正确的串口端口:工具 → 端口 → COMx(Windows)或 /dev/cu.usbserial-xxx(macOS/Linux)。
  3. 将上述代码粘贴到编辑器,点击上传按钮(→)。等待编译并烧录完成,IDE底部会显示“Done uploading”。

验证方法与判定标准

  • 烧录完成后,开发板会自动复位并运行程序。
  • 通过条件:观察板载LED以约1Hz频率稳定闪烁(亮0.5秒、灭0.5秒),周期约1秒。若LED常亮或常灭,请检查引脚定义是否正确(尝试改为GPIO0、GPIO1、GPIO8等常见板载LED引脚)。
  • 若需重新验证,可按下开发板上的EN/RST复位按钮,程序将从头运行,LED闪烁应重新开始。

常见问题

  • 编译报错“A fatal error occurred: Failed to connect to ESP32”:通常是因为未进入下载模式。按住开发板BOOT按钮不放,点击上传,待出现“Connecting...”提示时松开BOOT按钮。
  • 上传成功但LED不亮:确认开发板供电正常(USB连接即可),并核对板载LED实际连接的GPIO引脚号。