2. 开发环境搭建:Arduino IDE 安装、ESP32 板级支持包配置、串口驱动安装与测试

好,咱们正式开始动手了。

做嵌入式开发,第一道坎就是环境搭建。很多人觉得这步简单,随便装个软件就行。但我见过太多学员卡在这一步——不是驱动装不上,就是板子认不出来,折腾半天连个灯都点不亮。

今天咱们就把这事彻底搞定。我会带着你一步步走完 Arduino IDE 的安装、ESP32 板级支持包的配置、串口驱动的安装,最后再写个测试程序验证一下。整个过程大概 20 分钟,你跟着做就行。

2.1 下载与安装 Arduino IDE

Arduino IDE 是咱们的主力开发工具。虽然它界面朴素,但胜在轻量、生态好。我个人习惯用 1.8.x 版本,稳定,兼容性好。2.0 版本虽然界面好看些,但偶尔有小毛病。

下载地址: 去 Arduino 官网,找到 Software 页面,选 Windows 版本(或者 macOS/Linux,看你系统)。

安装步骤:

  1. 双击安装包,一路 Next。
  2. 安装路径建议用默认的,别改到中文目录下。
  3. 安装过程中会提示是否安装驱动,勾上就行。
  4. 装完后桌面会有 Arduino 图标,双击打开。
小提示: 如果你用的是 Windows 10 或 11,系统可能会自动从微软商店装一个 UWP 版的 Arduino IDE。那个版本功能不全,建议卸载掉,用官网的经典版。

2.2 配置 ESP32 板级支持包

Arduino IDE 默认只支持 Arduino 自家的板子。要让它认识 ESP32,得手动添加板级支持包。

具体操作:

  1. 打开 Arduino IDE,点击菜单栏 文件 → 首选项
  2. 在「附加开发板管理器网址」那里,粘贴下面这个地址:
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
  1. 点击「好」保存。
  2. 然后点击 工具 → 开发板 → 开发板管理器
  3. 在搜索框里输入 esp32,找到由 Espressif Systems 提供的那个包。
  4. 点击「安装」,版本选最新的稳定版就行(我写这个的时候是 2.0.14)。
注意: 这个包大概 200MB 左右,下载速度取决于你的网络。如果卡住了,可以试试换个时间段,或者用手机热点。我曾经在客户现场遇到过网络极差的情况,最后是用手机热点才搞定的。

安装完成后,在 工具 → 开发板 菜单里,你应该能看到一大串 ESP32 相关的板子型号。选 ESP32 Dev Module 就行,这是最通用的型号。

2.3 安装串口驱动

ESP32 开发板通过 USB 转串口芯片与电脑通信。常见的芯片有两种:CP2102 和 CH340。我手头这块板子用的是 CP2102,但市面上很多便宜的板子用的是 CH340。

怎么判断? 看板子上的芯片型号,或者直接插上电脑,打开设备管理器看有没有未知设备。

驱动下载:

  • CP2102: 去 Silicon Labs 官网下载 CP210x 驱动程序。
  • CH340: 去 WCH 官网下载 CH340 驱动。国内很多开发板卖家也会提供。

安装很简单,双击 exe 文件,一路下一步就行。装完后重新插拔一下 USB 线。

验证驱动是否成功:

打开设备管理器(Windows 上右键「此电脑」→ 管理 → 设备管理器)。

展开「端口(COM 和 LPT)」,你应该能看到类似 Silicon Labs CP210x USB to UART Bridge (COM3) 这样的条目。

记下这个 COM 端口号,后面要用。

如果你看到的是黄色感叹号,说明驱动没装好。试试手动更新驱动,或者换个 USB 口。我遇到过几次是因为 USB 延长线质量太差导致的,换根线就好了。

2.4 编写测试程序:点亮板载 LED

环境搭好了,咱们写个程序验证一下。ESP32 开发板上通常有一个板载 LED,连接到 GPIO2 引脚。

测试代码:

void setup() {
  // 初始化串口,波特率 115200
  Serial.begin(115200);
  
  // 设置 GPIO2 为输出模式
  pinMode(2, OUTPUT);
  
  Serial.println("ESP32 启动成功!");
}

void loop() {
  // 点亮 LED
  digitalWrite(2, HIGH);
  Serial.println("LED 亮");
  delay(1000);
  
  // 熄灭 LED
  digitalWrite(2, LOW);
  Serial.println("LED 灭");
  delay(1000);
}

上传步骤:

  1. 把 ESP32 开发板用 USB 线连到电脑。
  2. 在 Arduino IDE 中,工具 → 开发板 选择 ESP32 Dev Module
  3. 工具 → 端口 选择你刚才记下的 COM 口。
  4. 点击左上角的「→」箭头(上传按钮)。
  5. 等待编译和上传完成。上传时 ESP32 会自动进入下载模式,不需要手动按 BOOT 按钮。
常见问题: 如果上传失败,提示 A fatal error occurred: Failed to connect to ESP32,可以试试按住开发板上的 BOOT 按钮不放,再点上传,等出现连接提示时松开。这是 ESP32 的一个经典坑,我刚开始玩的时候也栽过。

2.5 验证串口通信

程序上传成功后,打开 Arduino IDE 的串口监视器(右上角的放大镜图标)。

设置:

  • 波特率选 115200(和代码里一致)。
  • 右下角选 换行符

你应该能看到串口不断输出:

ESP32 启动成功!
LED 亮
LED 灭
LED 亮
LED 灭
...

同时,板子上的 LED 会以 1 秒为间隔闪烁。

看到这个,说明你的开发环境已经完全搭建成功了。串口通信正常,GPIO 控制正常,整个链路都通了。

总结一下咱们做了什么:

  • 安装了 Arduino IDE
  • 配置了 ESP32 板级支持包
  • 安装了 USB 转串口驱动
  • 编写并上传了第一个测试程序
  • 验证了串口通信和 GPIO 控制

接下来,咱们就可以正式开始做智能插座的项目了。

嗯,环境搭建这块就到这里。如果你在安装过程中遇到任何问题,别急,翻翻上面的避坑指南,或者直接去网上搜一下错误信息。搞嵌入式就是这样,环境搭建往往是最磨人的,但一旦通了,后面就顺了。