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

好,咱们正式开始动手。这一章我带你把开发环境搭起来。别小看这一步,我见过太多同学卡在环境配置上,代码写好了却烧录不进去,急得直跺脚。咱们一步步来,稳扎稳打。

2.1 下载并安装Arduino IDE

Arduino IDE,说白了就是个写代码、编译、烧录的集成工具。它本身不复杂,但版本选不对会踩坑。

第一步:下载

去官网 arduino.cc 下载。我个人习惯用 Windows Win 10/11 版本,如果你用Mac或Linux,选对应版本就行。注意,别去第三方网站下,容易带捆绑软件。

第二步:安装

双击安装包,一路点“Next”。这里我建议你注意两点:

  • 安装路径不要有中文。我之前遇到过学生装在了“D:\软件\Arduino”,结果编译报错,查了半天是路径问题。
  • 勾选“安装USB驱动”。安装过程中会弹出一个选项,问你要不要装驱动,务必勾上。虽然咱们后面还要单独装CH340驱动,但这里先打个底。
小提示: 安装完成后,桌面会生成Arduino IDE图标。第一次打开可能会提示“是否允许访问网络”,点允许就行,后面下载板级支持包需要联网。

2.2 配置ESP32板级支持包

Arduino IDE默认不支持ESP32。你得手动给它“喂”一个支持包。嗯,这里有个坑,我详细说说。

第一步:添加开发板管理器URL

打开Arduino IDE,点击菜单栏 文件 → 首选项。在“附加开发板管理器网址”那里,粘贴下面这个链接:

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

如果你网络不好,这个链接可能打不开。我曾经在客户现场,用手机热点死活连不上,最后换了公司WiFi才搞定。你可以多试几次,或者用手机热点试试。

第二步:安装ESP32包

点击 工具 → 开发板 → 开发板管理器。在搜索框输入 ESP32,你会看到 “esp32 by Espressif Systems”。点击安装,版本选最新的稳定版(比如2.0.14)。

这个过程大概要下载100多MB,看网速。我建议你泡杯咖啡等着。安装完成后,关闭窗口。

注意: 如果你安装失败,八成是网络问题。可以尝试:
  • 切换网络环境(比如从WiFi切到手机热点)
  • 手动下载JSON文件放到本地(这个稍微复杂,需要改配置文件,新手不建议)
  • 使用代理工具(懂的都懂)

第三步:选择开发板

安装成功后,点击 工具 → 开发板 → ESP32 Arduino,选择 “ESP32 Dev Module”。这是最通用的型号,咱们课程用的就是它。

2.3 安装串口驱动

ESP32开发板上通常有两个USB转串口芯片:CH340CP2102。咱们用的板子大概率是CH340。为什么?便宜啊,量产成本低。但便宜也有便宜的麻烦——驱动容易出问题。

第一步:确认芯片型号

把ESP32开发板插到电脑USB口。打开 设备管理器(右键“此电脑” → 管理 → 设备管理器)。看“端口(COM和LPT)”下面,有没有出现一个带黄色感叹号的设备?如果有,说明驱动没装。

如果没有黄色感叹号,但显示“USB-SERIAL CH340”,恭喜你,系统自动装好了。如果显示“CP2102”,那驱动不同,需要去Silicon Labs官网下载。

第二步:安装CH340驱动

去网上搜“CH340驱动下载”,找个靠谱的网站。我一般用 “WCH官网”(南京沁恒微电子),或者用驱动精灵、360驱动大师这类工具自动安装。我个人习惯用官网的,干净无广告。

下载后解压,双击 SETUP.EXE,一路下一步。安装完成后,重新插拔一下USB线。再看设备管理器,应该能看到类似 COM3COM4 的端口号了。

重要: 记住这个COM口号!后面烧录程序时,Arduino IDE里要选对端口。我见过有人选了COM1,结果死活连不上,折腾半天才发现是端口错了。

2.4 测试:点亮板载LED

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

第一步:编写代码

打开Arduino IDE,新建一个文件,粘贴以下代码:

void setup() {
  pinMode(2, OUTPUT);  // 设置GPIO2为输出模式
}

void loop() {
  digitalWrite(2, HIGH);  // 点亮LED
  delay(1000);            // 等待1秒
  digitalWrite(2, LOW);   // 熄灭LED
  delay(1000);            // 等待1秒
}

第二步:配置并烧录

点击 工具 → 开发板,确认选的是 “ESP32 Dev Module”。点击 工具 → 端口,选择你刚才看到的COM口(比如COM3)。

然后点击左上角的 “→”箭头(上传按钮)。IDE会先编译,再烧录。第一次编译会慢一些,因为要下载一些依赖库。耐心等。

烧录过程中,你会看到开发板上的两个指示灯(TX和RX)疯狂闪烁。如果一切顺利,底部输出栏会显示 Done uploading

第三步:观察结果

烧录完成后,ESP32会自动复位。你应该能看到板载LED以1秒间隔闪烁。如果没反应,别急,检查以下几点:

  • 开发板型号选对了没?
  • 端口选对了没?
  • GPIO2是不是被其他外设占用了?有些开发板的LED可能接在其他引脚上,比如GPIO16。你可以查一下你的板子原理图。
避坑指南: 我曾经遇到过烧录时提示“A fatal error occurred: Failed to connect to ESP32”。这是因为ESP32在烧录时需要按住 BOOT按钮。具体操作:按住BOOT键不放,点上传按钮,看到“Connecting...”字样时松开BOOT键。百试百灵。

2.5 验证串口通信

LED闪烁只是第一步。咱们还得确认串口能正常收发数据。毕竟后面跟阿里云通信全靠它。

代码示例:串口打印

void setup() {
  Serial.begin(115200);  // 初始化串口,波特率115200
  pinMode(2, OUTPUT);
}

void loop() {
  Serial.println("Hello from ESP32!");  // 打印信息
  digitalWrite(2, !digitalRead(2));     // 翻转LED状态
  delay(2000);
}

烧录后,点击Arduino IDE右上角的 “串口监视器” 按钮(一个放大镜图标)。在串口监视器窗口,把波特率设置为 115200。你应该能看到每2秒打印一次“Hello from ESP32!”。

如果串口监视器一片空白,检查:

  • 波特率是否匹配?代码里是115200,监视器也得设成115200。
  • 端口是否选对?
  • 有没有其他程序占用了串口?比如串口助手、其他IDE等。
总结一下: 到这一步,你的开发环境就彻底搭好了。Arduino IDE能编译、能烧录、串口能通信。后面咱们就可以正式接入阿里云了。嗯,这一章内容不少,但都是基本功。你想想看,如果环境没搭好,后面写再多代码也是白搭。所以,花点时间把这一步走稳,后面就顺了。