1. ESP32 开发环境搭建:从零到 Blink
各位同学,咱们正式开始。第一件事,就是把开发环境搭起来。很多初学者卡在这一步,其实没那么复杂。我见过有人折腾两天装不好驱动,结果只是线没插紧——嗯,这种坑咱们今天全给它填平。
1.1 你需要准备什么
先列个清单,别漏了东西:
| 项目 | 说明 | 备注 |
|---|---|---|
| ESP32 开发板 | 推荐 ESP32-DevKitC 或 NodeMCU-32S | 某宝几十块,别买太便宜的 |
| Micro USB 数据线 | 必须带数据传输功能 | 充电线不能用!我吃过亏 |
| 电脑 | Windows / macOS / Linux 均可 | 建议 Win10 以上 |
| Arduino IDE | 免费开源,版本 2.x 或 1.8.x | 我习惯用 2.x,界面清爽 |
| USB 转串口驱动 | CP2102 或 CH340,看板子芯片 | 这一步最容易翻车 |
1.2 安装 Arduino IDE
去官网 arduino.cc 下载。我建议直接下 2.x 版本,界面现代化,代码补全也好用。安装过程一路默认就行,没什么坑。
装完之后打开,你会看到一个白底编辑器。别慌,它就是个写代码的记事本,只不过能直接烧录到芯片里。
1.3 配置 ESP32 板卡支持
Arduino IDE 默认不认识 ESP32。你得告诉它:嘿,我要玩 ESP32 了。操作步骤如下:
- 打开 Arduino IDE,点击 文件 > 首选项
- 在「附加开发板管理器网址」里填入:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json - 点击 工具 > 开发板 > 开发板管理器
- 搜索
esp32,找到 Espressif 官方包,点击安装
这个过程会下载几百兆数据。网速慢的话,泡杯茶等一等。我曾经在客户现场用手机热点下这个包,等了快半小时——所以建议提前在家搞定。
1.4 安装 USB 驱动
这是最容易出问题的一步。你把 ESP32 插上电脑,如果设备管理器里出现黄色感叹号,那就是驱动没装好。
怎么判断芯片型号?看板子上的 USB 转串口芯片:
- CP2102:方形小芯片,Silicon Labs 出品
- CH340:长条形,国产芯片,某宝板子最常见
去官网下载对应驱动,安装后重启电脑。插上板子,你应该能在设备管理器里看到 COM 端口 下面多了一个设备。
1.5 第一个程序:Blink
环境搭好了,咱们写个经典程序——让板载 LED 闪烁。这相当于硬件世界的 "Hello World"。
在 Arduino IDE 里,点击 文件 > 示例 > 01.Basics > Blink,代码就出来了:
void setup() {
// 初始化数字引脚 LED_BUILTIN 为输出模式
pinMode(LED_BUILTIN, OUTPUT);
}
void loop() {
digitalWrite(LED_BUILTIN, HIGH); // 点亮 LED
delay(1000); // 等待 1 秒
digitalWrite(LED_BUILTIN, LOW); // 熄灭 LED
delay(1000); // 等待 1 秒
}
然后配置开发板:
- 工具 > 开发板 > ESP32 Arduino > ESP32 Dev Module
- 工具 > 端口:选择你刚才看到的 COM 口
点击上传按钮(右箭头)。你会看到 IDE 底部开始编译,然后出现 Connecting... 的提示。这时候注意——有些 ESP32 板子需要按住 BOOT 按钮 才能进入下载模式。我习惯在上传前先按住 BOOT,看到 Connecting... 时松手,成功率 100%。
上传成功后,板子上的 LED 就会以 1 秒间隔闪烁。恭喜,你的 ESP32 活了!
1.6 知识体系总览
下面这张图帮你理清整个搭建流程的逻辑关系:
1.7 常见问题速查
我把新手最常问的问题整理成了一张表,你遇到问题先来这里找答案:
| 问题 | 原因 | 解决办法 |
|---|---|---|
| 设备管理器看不到 COM 口 | 驱动没装 / 数据线不对 | 换数据线,重装驱动 |
| 上传时卡在 "Connecting..." | 没按住 BOOT 按钮 | 按住 BOOT,再点上传 |
| 编译报错 "ESP32 未找到" | 板卡包没装好 | 检查 JSON 网址,重装包 |
| LED 不亮 | 引脚不对 / 板子坏了 | 确认 LED_BUILTIN 引脚 |
| 上传成功但没反应 | 板子型号选错 | 重新选择 ESP32 Dev Module |
好了,你的 ESP32 已经在闪烁了。这意味着开发环境完全就绪,后面咱们就可以放心地玩 MQTT 和传感器了。