第一章:ESP32开发环境搭建

大家好,我是你们的嵌入式UI开发讲师。今天咱们来搞定ESP32开发环境搭建这件事。

说实话,我见过太多初学者卡在环境配置这一步。明明代码写对了,就是下载不进去。嗯,今天咱们一步步来,把坑都填平。

1.1 Arduino IDE安装

我个人习惯用Arduino IDE来开发ESP32。为什么?因为它简单、轻量,对新手特别友好。你想想看,一个IDE就能搞定代码编辑、编译、下载,多省事。

安装步骤其实很简单:

  1. 去官网下载Arduino IDE(我建议用1.8.x版本,稳定)
  2. 双击安装包,一路Next就行
  3. 安装路径别带中文,不然容易出怪问题
小提示: 我在项目中遇到过,有些电脑用最新版2.x的Arduino IDE,反而对ESP32支持不太好。如果你也遇到类似问题,不妨试试1.8.19版本。

1.2 ESP32板级支持包配置

装好IDE只是第一步。说白了,Arduino IDE本身不认识ESP32,你得告诉它:「嘿,我要用ESP32开发板」。这就需要安装板级支持包。

操作流程:

  1. 打开Arduino IDE,点击「文件」→「首选项」
  2. 在「附加开发板管理器网址」里填入:https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
  3. 点击「工具」→「开发板」→「开发板管理器」
  4. 搜索「ESP32」,找到由Espressif Systems提供的版本,点击安装
注意: 下载过程可能会比较慢,因为要拉取很多文件。我曾经等过半小时才装完。别急,喝杯咖啡先。

安装完成后,在「工具」→「开发板」菜单里,你就能看到一大串ESP32型号了。我们选「ESP32 Dev Module」就行。

1.3 驱动安装

把ESP32开发板插到电脑上,有时候系统会自动识别。但更多时候,你需要手动装驱动。

ESP32开发板通常用两种USB转串口芯片:

芯片型号 驱动名称 常见场景
CP2102 CP210x驱动 大多数ESP32开发板
CH340 CH340驱动 一些国产开发板

怎么看你的板子用哪种?看板子上的USB接口旁边,一般会印着芯片型号。我建议你直接两个驱动都装上,省得到时候折腾。

避坑指南: 我曾经遇到过,装好驱动后设备管理器里还是显示感叹号。后来发现是驱动签名问题。Windows 10/11需要禁用驱动签名强制,或者用管理员权限安装。这个坑我踩过,你注意一下。

1.4 第一个点亮LED程序

环境搭好了,咱们来写个经典的「Hello World」——点亮LED。ESP32开发板上通常自带一个LED,接在GPIO2引脚上。

代码很简单:

void setup() {
  // 初始化GPIO2为输出模式
  pinMode(2, OUTPUT);
}

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

这段代码的逻辑很直白:

  • setup()函数只运行一次,用来初始化
  • loop()函数会不断循环执行
  • digitalWrite()控制引脚输出高电平或低电平
  • delay()让程序暂停一段时间

写好后,点击工具栏的「→」按钮(上传),IDE会自动编译并下载到ESP32里。如果一切顺利,你会看到板子上的LED开始一闪一闪的。

常见问题: 上传时如果报错「A fatal error occurred: Failed to connect to ESP32」,多半是没按住BOOT按钮。解决方法:按住开发板上的BOOT键不放,再点上传,看到「Connecting...」字样时松开BOOT键。

1.5 验证环境是否正常

LED闪烁了,说明你的环境搭建成功了。但我建议你再做一件事——打开串口监视器看看。

在代码里加几行:

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

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

上传后,点击「工具」→「串口监视器」,设置波特率为115200。你会看到板子不断打印信息。这说明串口通信也正常了。

我的经验: 串口监视器是调试利器。后面做触摸屏UI时,很多问题都要靠它来定位。建议你从现在开始养成看串口输出的习惯。

好了,第一章的内容就到这里。环境搭好了,LED也亮了,咱们算是迈出了第一步。下一章我会带大家认识ESP32的GPIO和触摸输入,为做中控屏打好基础。

记住,做嵌入式开发,环境搭建是最磨人的一步。过了这关,后面就顺畅多了。