ESP32 开发第一程：4 个关卡从点亮 LED 到无线更新固件

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32

arduino-esp32 是乐鑫官方为 ESP32 系列芯片维护的 Arduino 核心，让你用熟悉的digitalWrite、WiFi.begin就能开发带 Wi-Fi 和蓝牙的设备，不用碰寄存器。本文按 4 个关卡推进：装核心、刷 Blink、连 Wi-Fi、无线更新固件，每关都给出入口条件、动作序列和出口验证，你随时可以自查是否走对路线。

开始前 30 秒：确认你手上有这三样

动手前花 30 秒核对清单，缺一样就先补齐再往下走：

• 一块 ESP32 开发板（DevKitC 等任意型号均可，板子中间那块模块就是 SoC，两侧排开的引脚是你真正要接线的 GPIO）；
• 一根能传数据的数据线——注意，只充电的线刷不了固件，端口列表为空时先怀疑它；
• 最新版 Arduino IDE。

✅ 三条都满足，直接进关卡一；缺数据线就先换线，这是新手卡得最多的地方。

关卡一：在 Arduino IDE 安装 esp32 核心包

入口条件：Arduino IDE 能打开，工具 > 开发板菜单里没有任何 ESP32 选项。

动作序列：

1. 文件 > 首选项（macOS 为Arduino IDE > 首选项），在Additional Boards Manager URLs一栏填入官方稳定版索引地址（完整地址见 docs/en/installing.rst），点确定。
2. 打开工具 > 开发板 > 开发板管理器，搜索esp32，点安装。包体上百 MB，耐心等它下完。
3. 下载反复失败时改用命令行，把仓库克隆进 sketchbook 的 hardware 目录：

mkdir -p ~/Arduino/hardware/espressif && cd ~/Arduino/hardware/espressif git clone https://gitcode.com/GitHub_Trending/ar/arduino-esp32 esp32 cd esp32/tools && python3 get.py

出口验证：重启 IDE，工具 > 开发板里出现一排 ESP32 板型选项。

关卡二：用 Blink 例程刷进第一颗 LED

入口条件：关卡一验证通过，工具 > 开发板能选到ESP32 Dev Module。

动作序列：

1. 工具 > 开发板选ESP32 Dev Module，工具 > 串口选一个COM或/dev/tty端口。
2. 文件 > 示例 > Arduino > Blink，直接点上传。
3. 传完后打开工具 > 串口监视器，波特率设 115200。

出口验证：串口监视器滚动出启动日志，其中一行类似I (418) cpu_start: cpu freq: 160000000，板载 LED 以 1 秒为周期闪烁。5 分钟内走到这一步，说明整条链路（核心、工具链、数据线）都是通的。

典型报错翻译：如果上传卡住并抛出

Failed to connect to ESP32: Timed out waiting for packet header

翻译成人话就是：板子没进下载模式。解法按顺序试：先换一根数据线、换一个 USB 口；还不行就按住板子上的BOOT键再点上传，出现连接提示后松开。更多原因排查见 docs/en/troubleshooting.rst。

💡 串口监视器会独占串口，上传前记得先关掉它，否则上传必失败。

关卡三：让 ESP32 连上 Wi-Fi 的最小代码

入口条件：Blink 能正常上传，串口日志正常。

动作序列：新建 sketch，把下面内容写进编辑器，替换成你的 Wi-Fi 名称和密码：

#include <WiFi.h> void setup() { Serial.begin(115200); WiFi.begin("你的SSID", "你的密码"); } void loop() { static uint32_t last = 0; if (millis() - last > 1000) { last = millis(); if (WiFi.status() == WL_CONNECTED) { Serial.println(WiFi.localIP()); } else { Serial.println("connecting..."); } } }

上传后打开串口监视器（波特率 115200）。

出口验证：串口每隔 1 秒打一次，从connecting...变成类似192.168.1.x的 IP，联网成功。ESP32 此时是以站点（STA）身份接入路由器，和你手机连 Wi-Fi 是同一种身份，这块板子从此和你电脑处在同一局域网里——这是后面 OTA 的前提。

一句话讲清机制：arduino-esp32 核心像个翻译官，你写的WiFi.begin是人话指令，它翻成芯片能执行的操作，Wi-Fi 驱动、Flash 管理这些脏活全由底层的 ESP-IDF 代劳。

关卡四：不拔线更新固件的 OTA 实操

入口条件：关卡三的 Wi-Fi 代码已在板子上稳定跑通（OTA 和板子必须在同一局域网）。

动作序列：

1. 打开例程文件 > 示例 > ESP32 > ArduinoOTA > BasicOTA，源码在 libraries/ArduinoOTA/examples/BasicOTA/BasicOTA.ino，把ssid和password改成你的 Wi-Fi。
2. 第一版仍走 USB 正常上传——OTA 能力得先刷到板子上才行。
3. 之后改完代码，在 IDE 里选草图 > 导出编译的 Binary，得到.bin固件文件。
4. 用 IDE 自带的上传工具指向板子 IP，或浏览器访问板子的 OTA 页面，选中.bin点更新，串口里能看到进度百分比。

出口验证：上传工具显示成功、串口打印End，板子自动重启并运行新逻辑——全程没碰 USB 线。

💡 BasicOTA 例程支持ArduinoOTA.setPassword(...)设置校验密码，设备要长期挂在网络上时建议加上。

收尾自查清单

• 工具 > 开发板能看到 ESP32 板型选项
• Blink 上传成功，串口出现cpu freq日志，板载 LED 闪烁
• 串口能稳定打出192.168.x.x的 IP
• 改代码后能在不插 USB 线的情况下完成一次 OTA 升级
• 手上备一根确认能传数据的数据线（下次救命用）

四关都勾上，arduino-esp32 的入门能力面（装环境 → 最小示例 → 联网 → 无线升级）你就完整打通了，接下来照例程目录往传感器、网络服务方向延伸即可。

【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32