4、开发环境配置:Arduino IDE安装与配置,ESP32板级支持包安装,CH340驱动安装与串口调试

好,咱们正式开始动手了。这一章,说白了就是给你的电脑“武装”起来。没有趁手的工具,再牛的代码也跑不起来。我见过不少新手,卡在环境配置这一步就放弃了,其实真没那么玄乎。

我个人习惯把开发环境比作“厨房”。Arduino IDE就是你的灶台,ESP32板级支持包就是你的锅碗瓢盆,而CH340驱动,嗯,就是那个连接煤气灶和煤气罐的管子。缺一不可。

4.1 下载与安装Arduino IDE

先去官网下载Arduino IDE。别去第三方网站下,我吃过这个亏,下载下来捆绑了一堆垃圾软件。记住,官网地址是 arduino.cc

  • Windows用户:下载Windows Installer版本,直接双击安装。一路默认选项就行,但有个地方要注意——安装路径里不要有中文。我曾经有个学员,装在了“D:\软件\Arduino”里,结果死活编译不过,改成英文路径就好了。
  • macOS用户:下载对应的.dmg文件,拖到Applications文件夹里就行。
  • Linux用户:用命令行解压,或者用包管理器安装。我个人建议用命令行,更干净。

安装完成后,打开界面。嗯,第一眼看上去有点简陋对吧?别急,麻雀虽小五脏俱全。菜单栏、工具栏、代码编辑区、状态栏,该有的都有。

小技巧: 我个人习惯把界面语言改成英文。为什么?因为报错信息在英文环境下更容易搜索到解决方案。中文翻译有时候会让人摸不着头脑。

4.2 配置ESP32板级支持包

Arduino IDE默认只支持自家的板子,比如Uno、Nano。咱们要用ESP32,得给它“喂”板级支持包(Board Support Package,简称BSP)。

步骤很简单,但有个坑,我先说出来:网络问题。ESP32的BSP包托管在GitHub和Arduino的服务器上,国内下载经常慢得像蜗牛,甚至直接失败。

具体操作如下:

  1. 打开Arduino IDE,点击 文件 -> 首选项
  2. 在“附加开发板管理器网址”里,填入以下链接:
    https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
  3. 点击“好”保存。
  4. 然后点击 工具 -> 开发板 -> 开发板管理器
  5. 在搜索框里输入“ESP32”,找到由Espressif Systems提供的那个,点击安装。

这里我要多说一句。如果你发现下载速度只有几KB/s,或者直接报错,别慌。我曾经在客户现场,网络环境极差,折腾了半小时没装上。后来我用了“离线安装法”——先去GitHub上把整个包手动下载下来,然后解压到Arduino的硬件目录里。具体路径是:你的Arduino安装目录/hardware/espressif/esp32

注意: 离线安装时,版本号一定要和JSON文件里的一致,否则IDE不认。我见过有人下载了最新版,但JSON里指向的是旧版,结果编译报一堆莫名其妙的错误。

安装完成后,在 工具 -> 开发板 菜单里,你应该能看到一大串ESP32的型号。选你手上那块板子,比如最常见的 ESP32 Dev Module

4.3 CH340驱动安装

为什么单独讲CH340?因为市面上绝大多数便宜的ESP32开发板,用的都是这个USB转串口芯片。你的电脑要通过它和ESP32“说话”。

Windows 10和Windows 11系统,通常会自动安装驱动。但如果你用的是Windows 7,或者系统没识别出来,那就得手动装了。

驱动下载地址我建议去WCH(南京沁恒)的官网找。别用驱动精灵之类的软件,它们给你装的版本可能不对。

  • Windows:下载后直接双击安装,重启电脑。
  • macOS:需要安装一个特殊的驱动,因为苹果从某个版本开始收紧了驱动签名。我记得在macOS Catalina上,还得去“安全性与隐私”里手动允许加载。
  • Linux:通常不需要额外装驱动,内核自带。但你要确保当前用户有权限访问串口设备。命令是:sudo usermod -a -G dialout $USER,然后注销重新登录。

怎么确认驱动装好了?把ESP32板子插到电脑上,打开设备管理器(Windows),在“端口(COM和LPT)”下面,应该能看到一个 USB-SERIAL CH340 (COMx) 之类的设备。如果看到黄色感叹号,说明驱动没装好。

核心要点: 驱动装好后,记下这个COM口号。比如COM3、COM4。后面在Arduino IDE里选择端口时,就要选这个。

4.4 串口调试:让板子“开口说话”

环境配好了,咱们得验证一下。写一个最简单的程序,让ESP32通过串口打印“Hello, World!”。

打开Arduino IDE,输入以下代码:

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

void loop() {
  // 打印信息
  Serial.println("Hello, World! 我是ESP32");
  // 延时1秒
  delay(1000);
}

然后,按这几个步骤操作:

  1. 选择开发板工具 -> 开发板 -> ESP32 Dev Module
  2. 选择端口工具 -> 端口 -> 选择你刚才记下的那个COM口。
  3. 点击上传:就是那个向右的箭头按钮。

上传时,你会看到状态栏里有一堆乱码一样的输出。别怕,那是正常的。ESP32在烧录时会自动复位进入下载模式。

上传成功后,点击右上角的“串口监视器”按钮(那个放大镜图标)。在串口监视器窗口的右下角,把波特率设为 115200。然后,你应该能看到板子每隔一秒打印一次“Hello, World! 我是ESP32”。

如果什么都没看到,或者全是乱码,检查两件事:

  • 波特率是不是115200?
  • 串口监视器里选择的端口,和上传时选的是不是同一个?
避坑指南: 我曾经遇到过一个情况,代码上传成功了,但串口监视器里死活没输出。折腾了半天,发现是板子上的一个跳线帽没插好,导致USB转串口芯片和主芯片之间的通路断了。所以,硬件上的物理连接也要检查。

嗯,到这里,你的开发环境就彻底配好了。你可以把ESP32想象成一个刚出生的婴儿,而串口就是它的嘴巴。现在,它终于能“开口说话”了。下一章,咱们就要教它认识各种传感器了。