3、开发环境搭建：ESP-IDF与Arduino IDE配置、串口驱动安装、第一个点灯程序

好，咱们正式开始动手了。这一章我带你搭环境。说实话，很多初学者倒在这一步——不是代码不会写，是环境配不好。我当年刚接触ESP32时，光装驱动就折腾了一下午。所以这一章，我会把坑都指出来，你跟着走就行。

3.1 开发环境选型：ESP-IDF vs Arduino IDE

做制氧机这种产品级项目，我个人习惯用ESP-IDF。为什么？因为它更底层，内存管理、任务调度、WiFi协议栈，你都能直接控制。但我也理解，很多朋友是从Arduino转过来的，上手快。

我的建议是：学习阶段用Arduino IDE，产品开发用ESP-IDF。咱们这门课，我会两种都讲，但核心代码基于ESP-IDF。你想想看，如果模组跑着跑着内存溢出了，Arduino IDE可不好查。

选型对比表

特性 ESP-IDF Arduino IDE
底层控制力 强（FreeRTOS原生） 弱（封装层）
学习曲线 陡峭 平缓
调试能力 GDB + 日志系统 串口打印
库生态 官方库 + 组件注册表 第三方库丰富
适合场景 量产产品、多任务系统 原型验证、教学

3.2 ESP-IDF环境搭建（Windows版）

先说ESP-IDF。我建议你用v5.1.2版本，别追最新版。为什么？因为最新版有时会改API，咱们项目用到的一些库可能不兼容。我曾经在v5.2上踩过坑，WiFi配网接口变了，折腾了两天才发现是版本问题。

安装步骤：

  1. 去乐鑫官网下载ESP-IDF离线安装包（Windows版）
  2. 双击安装，路径不要有中文和空格。我习惯放 C:\esp\esp-idf
  3. 安装完成后，桌面会出现 ESP-IDF 5.1 CMD 快捷方式
  4. 打开这个CMD，输入 idf.py --version 验证

小技巧： 安装时勾选「Add to PATH」选项，这样你可以在任意终端里用idf.py命令。不过我个人不推荐，因为多个版本容易冲突。还是用专门的CMD窗口吧。

3.3 Arduino IDE配置ESP32

如果你选择Arduino路线，配置更简单。但要注意：Arduino的ESP32库有多个分支，别装错了。

配置步骤：

  1. 下载Arduino IDE 2.x版本（1.x也行，但2.x的自动补全好用）
  2. 打开IDE，进入 文件 -> 首选项 -> 附加开发板管理器网址
  3. 填入：https://espressif.github.io/arduino-esp32/package_esp32_index.json
  4. 进入 工具 -> 开发板 -> 开发板管理器，搜索ESP32
  5. 安装 esp32 by Espressif Systems 版本2.0.14（别装3.x，API不兼容）

注意： 安装过程中会下载工具链，大概500MB。如果你网络慢，可以手动下载离线包。我曾经在客户现场用手机热点装，等了40分钟...后来学乖了，提前下载好离线包。

3.4 串口驱动安装（CH340/CP2102）

这一步最容易出问题。市面上ESP32开发板用的串口芯片主要有两种：CH340G和CP2102。你买板子时问清楚卖家。

驱动安装：

  • CH340G： 去WCH官网下载驱动，Windows10以上系统有时自动识别
  • CP2102： 去Silicon Labs官网下载，注意区分32位和64位

装好后，插上开发板，打开设备管理器。如果看到 COM3 或类似端口，说明驱动成功。如果显示黄色感叹号...嗯，我曾经遇到过，是因为驱动签名问题。Windows10需要禁用驱动强制签名才能装。

避坑指南： 我曾经在Win11上装CH340驱动，死活不识别。后来发现是USB线的问题——有些便宜线只有充电功能，没有数据线。换根好点的USB数据线就好了。

3.5 第一个点灯程序（Blink）

好了，环境搭好了，咱们写第一个程序。点灯，嵌入式界的"Hello World"。但你别小看它，它能验证整个工具链是否正常。

ESP-IDF版本：

#include <stdio.h>
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "driver/gpio.h"

#define BLINK_GPIO GPIO_NUM_2  // 大多数ESP32开发板LED在GPIO2

void app_main(void)
{
    gpio_reset_pin(BLINK_GPIO);
    gpio_set_direction(BLINK_GPIO, GPIO_MODE_OUTPUT);

    while (1) {
        gpio_set_level(BLINK_GPIO, 1);
        vTaskDelay(1000 / portTICK_PERIOD_MS);
        gpio_set_level(BLINK_GPIO, 0);
        vTaskDelay(1000 / portTICK_PERIOD_MS);
    }
}

编译烧录步骤：

  1. 打开ESP-IDF CMD，进入项目目录
  2. 运行 idf.py set-target esp32
  3. 运行 idf.py menuconfig（第一次可以跳过，用默认配置）
  4. 运行 idf.py build 编译
  5. 连接开发板，运行 idf.py -p COM3 flash monitor

如果一切顺利，你会看到LED以1秒间隔闪烁。同时终端会打印启动日志。看到 Hello world! 了吗？那是ESP-IDF自带的示例输出。

小技巧： 如果烧录失败，按住开发板上的BOOT键不放，再按一下EN键，然后松开BOOT。这是ESP32的下载模式。我刚开始不知道这个，每次烧录都要试好几次。

Arduino IDE版本：

void setup() {
  pinMode(2, OUTPUT);
}

void loop() {
  digitalWrite(2, HIGH);
  delay(1000);
  digitalWrite(2, LOW);
  delay(1000);
}

选好开发板（ESP32 Dev Module）和端口，点上传。就这么简单。但我要提醒你：Arduino IDE的延时函数 delay() 会阻塞整个系统。在制氧机这种需要同时处理WiFi、传感器、控制逻辑的项目里，千万别这么用。后面我会教你怎么用FreeRTOS的任务延时。

3.6 验证环境是否正常

点灯成功只是第一步。你还需要验证串口通信是否正常。在ESP-IDF的monitor里，你应该能看到类似这样的输出：

I (0) cpu_start: App cpu up.
I (0) cpu_start: Pro cpu start user code
I (1) heap_init: Initializing. RAM available for dynamic allocation:
I (1) heap_init: At 3FFAE6A0 len 00001960 (6 KiB): DRAM
I (1) heap_init: At 3FFB2EC8 len 0002D138 (180 KiB): DRAM
I (1) heap_init: At 3FFE0440 len 00003AE0 (14 KiB): D/IRAM
I (1) heap_init: At 3FFE4350 len 0001BCB0 (111 KiB): D/IRAM
I (1) heap_init: At 40087FE0 len 00018020 (96 KiB): IRAM

看到这些日志，说明你的开发环境完全OK了。如果看不到，检查串口波特率——ESP-IDF默认是115200，Arduino IDE默认也是115200。

注意： 有些开发板的LED不在GPIO2。比如ESP32-S3在GPIO48，ESP32-C3在GPIO8。买板子时问清楚，或者看原理图。我曾经拿错板子，点灯点了半小时没反应，最后发现是GPIO搞错了。

好，环境搭好了，灯也亮了。下一章咱们开始写真正的通信协议。你想想看，一个制氧机模组，怎么跟云端说话？咱们从最基础的JSON格式开始。

← 上一章 📖 返回目录 下一章 →