3、ESP32开发环境搭建：Arduino IDE配置、ESP32板级支持包安装、WiFi联网与HTTP客户端库引入

好，咱们正式开始动手了。这一章，我带你把ESP32的开发环境搭起来。别小看这一步，很多新手卡在这里，其实说白了就是几个配置没搞对。我当年第一次玩ESP32时，也折腾了半个下午，后来发现就是个版本匹配问题。

3.1 为什么选Arduino IDE？

你可能要问：ESP-IDF官方框架不也挺好吗？没错，ESP-IDF功能强大，但学习曲线陡。对于农业气象站这种项目，我们追求的是快速验证、稳定运行。Arduino IDE虽然看起来简单，但生态成熟，库丰富，调试方便。

我个人习惯是：原型阶段用Arduino IDE，产品化时再考虑ESP-IDF。你想想看，咱们要对接的是气象传感器、WiFi、HTTP，这些在Arduino生态里都有现成库，何必重复造轮子？

3.2 下载与安装Arduino IDE

先去官网下载最新版。目前稳定版是2.x系列，界面比1.x好看不少，还自带串口监视器增强功能。

  • Windows用户：下载.exe安装包，一路Next就行
  • Mac用户：下载.dmg，拖到Applications文件夹
  • Linux用户：建议用AppImage版本，省去依赖烦恼
我的小建议：安装路径不要带中文，否则后面编译可能报一些莫名其妙的错。嗯，这是血泪教训。

3.3 安装ESP32板级支持包

这一步是关键。Arduino默认不支持ESP32，需要手动添加开发板管理器地址。

打开Arduino IDE，进入 文件 → 首选项，在“附加开发板管理器网址”里填入：

https://espressif.github.io/arduino-esp32/package_esp32_index.json

然后点击 工具 → 开发板 → 开发板管理器，搜索“ESP32”，找到由Espressif Systems官方提供的包，点击安装。

注意：这个包大概有200多MB，下载速度取决于你的网络。我曾经在客户现场用手机热点下载，等了快20分钟。建议提前准备好网络环境。

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

3.4 验证安装：点亮板载LED

光说不练假把式。咱们写个最简单的程序，确认环境没问题。

void setup() {
  Serial.begin(115200);
  pinMode(2, OUTPUT);  // ESP32板载LED通常接GPIO2
}

void loop() {
  digitalWrite(2, HIGH);
  delay(1000);
  digitalWrite(2, LOW);
  delay(1000);
  Serial.println("LED blinked!");
}

选好开发板和端口，点击上传。如果看到板载LED一闪一闪，恭喜你，环境搭好了。

避坑指南：上传时如果报“A fatal error occurred: Failed to connect to ESP32”，多半是没按住BOOT键。ESP32进入下载模式需要手动操作：按住BOOT，点一下EN，松开BOOT。我刚开始也老忘，后来干脆在桌面上贴了个便签。

3.5 WiFi联网：让ESP32连上互联网

农业气象站的核心是数据上云，所以联网是第一步。ESP32自带WiFi功能，用起来比ESP8266还稳。

先引入WiFi库：

#include <WiFi.h>

const char* ssid = "你的WiFi名称";
const char* password = "你的WiFi密码";

void setup() {
  Serial.begin(115200);
  WiFi.begin(ssid, password);
  
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
    Serial.print(".");
  }
  
  Serial.println("\nWiFi connected!");
  Serial.print("IP address: ");
  Serial.println(WiFi.localIP());
}

void loop() {
  // 保持连接
}

这里有个细节：WiFi.begin()是非阻塞的，所以要用while循环等待连接成功。我在项目中遇到过WiFi信号不稳定的情况，后来加了重连机制，效果好了很多。

经验之谈：农业气象站通常部署在野外，WiFi信号可能不太好。建议在代码里加个自动重连：if (WiFi.status() != WL_CONNECTED) { WiFi.reconnect(); }

3.6 HTTP客户端库引入

数据要上传到云端，HTTP请求是基本功。ESP32有两个常用库：

库名 特点 适用场景
HTTPClient 官方库，轻量，支持GET/POST 简单数据上传
WiFiClientSecure 支持HTTPS，带证书验证 需要加密传输的场景

引入方法很简单：在代码开头加上 #include <HTTPClient.h>。这个库是Arduino核心库的一部分，不需要额外安装。

来个完整的POST请求示例：

#include <WiFi.h>
#include <HTTPClient.h>

void sendDataToCloud(float temperature, float humidity) {
  if (WiFi.status() == WL_CONNECTED) {
    HTTPClient http;
    http.begin("http://你的服务器地址/api/upload");
    http.addHeader("Content-Type", "application/json");
    
    String payload = "{\"temp\":" + String(temperature) + 
                     ",\"humi\":" + String(humidity) + "}";
    
    int httpCode = http.POST(payload);
    
    if (httpCode > 0) {
      Serial.printf("HTTP response code: %d\n", httpCode);
      String response = http.getString();
      Serial.println(response);
    } else {
      Serial.printf("HTTP request failed: %s\n", http.errorToString(httpCode).c_str());
    }
    
    http.end();
  }
}
注意：HTTPClient对象每次使用后要调用end()释放资源。我见过有人循环里不断new对象，最后内存泄漏导致ESP32死机。说白了，资源管理要养成好习惯。

3.7 常见问题与解决方案

最后，我把这些年遇到的高频问题整理一下：

  • 编译报错“ESP32 not found”：检查开发板管理器地址是否填对，或者重新安装板级支持包
  • 上传失败“Timed out waiting for packet header”：按住BOOT键再试，或者换一根数据线（有些线只能充电不能传数据）
  • WiFi连不上：确认SSID和密码没错，检查路由器是否开启了MAC地址过滤
  • HTTP请求返回-1：服务器地址写错了，或者网络不通。先用浏览器访问一下那个地址试试

好了，环境搭好了，WiFi能连了，HTTP也能发了。下一章咱们开始接传感器，把真实的气象数据读出来。到时候你会发现，前面这些基础工作做得越扎实，后面就越顺手。

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