ESP32实战：用VSCode+IDF打造智能天气站（附全流程代码解析）

当你的ESP32开发环境已经就绪，却不知如何迈出项目实战的第一步时，这篇文章将带你从零构建一个能联网获取实时天气数据的智能硬件。不同于基础环境搭建教程，我们将聚焦于 真实项目开发全流程 ，涵盖Wi-Fi连接、API调用、数据解析等物联网核心技能。

1. 创建智能天气站工程骨架

在VSCode中按下 Ctrl+Shift+P 调出命令面板，输入 ESP-IDF: New Project 创建工程。建议选择 esp-idf 目录下的 hello_world 模板作为起点——它已经包含了基本的项目结构，我们可以在此基础上进行改造。

关键目录结构解析：

weather_station/
├── main/
│   ├── CMakeLists.txt  # 主程序编译配置
│   └── main.c         # 项目入口文件
├── components/        # 自定义组件（后续添加）
└── sdkconfig          # 芯片功能配置

提示：在 sdkconfig 中启用 CONFIG_LWIP_IPV6 和 CONFIG_ESP_WIFI_ENABLED 选项，为后续网络功能做准备。

2. 实现Wi-Fi智能连接模块

在 main 目录下新建 wifi_connector.c ，实现自动重连的健壮Wi-Fi模块：

#include "esp_wifi.h"
#include "esp_event.h"
#include "nvs_flash.h"

#define WIFI_SSID "YOUR_SSID"
#define WIFI_PASS "YOUR_PASSWORD"

void wifi_event_handler(void* arg, esp_event_base_t event_base, 
                       int32_t event_id, void* event_data) {
    if (event_base == WIFI_EVENT && event_id == WIFI_EVENT_STA_START) {
        esp_wifi_connect();
    } else if (event_base == IP_EVENT && event_id == IP_EVENT_STA_GOT_IP) {
        ip_event_got_ip_t* event = (ip_event_got_ip_t*) event_data;
        ESP_LOGI("WIFI", "Got IP:" IPSTR, IP2STR(&event->ip_info.ip));
    }
}

void wifi_init_sta() {
    esp_netif_init();
    esp_event_loop_create_default();
    esp_netif_create_default_wifi_sta();

    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
    esp_wifi_init(&cfg);

    esp_event_handler_instance_t instance_any_id;
    esp_event_handler_instance_register(WIFI_EVENT, ESP_EVENT_ANY_ID, 
                                      &wifi_event_handler, NULL, &instance_any_id);

    wifi_config_t wifi_config = {
        .sta = {
            .ssid = WIFI_SSID,
            .password = WIFI_PASS,
            .threshold.authmode = WIFI_AUTH_WPA2_PSK
        },
    };
    esp_wifi_set_mode(WIFI_MODE_STA);
    esp_wifi_set_config(ESP_IF_WIFI_STA, &wifi_config);
    esp_wifi_start();
}

内存优化技巧：

• 使用 CONFIG_WIFI_STA_DISCONNECTED_RETRY_DELAY_MS 配置重连间隔
• 通过 esp_wifi_set_storage(WIFI_STORAGE_RAM) 减少NVS写入

3. 构建高效HTTP客户端

天气数据获取需要稳定的HTTP连接。我们采用ESP-IDF内置的 esp_http_client 组件：

#include "esp_http_client.h"

#define WEATHER_API "http://api.openweathermap.org/data/2.5/weather?q=Beijing&appid=YOUR_API_KEY"

esp_err_t fetch_weather_data() {
    esp_http_client_config_t config = {
        .url = WEATHER_API,
        .timeout_ms = 5000,
    };
    esp_http_client_handle_t client = esp_http_client_init(&config);

    // 设置自定义User-Agent
    esp_http_client_set_header(client, "User-Agent", "ESP32-Weather-Station");

    esp_err_t err = esp_http_client_perform(client);
    if (err == ESP_OK) {
        int status_code = esp_http_client_get_status_code(client);
        if (status_code == 200) {
            char *response = malloc(esp_http_client_get_content_length(client));
            esp_http_client_read(client, response, esp_http_client_get_content_length(client));
            // 解析JSON响应...
        }
    }
    esp_http_client_cleanup(client);
    return err;
}

性能优化点：

• 启用 CONFIG_ESP_HTTP_CLIENT_ENABLE_HTTPS 支持加密连接
• 使用 esp_http_client_set_post_field 实现POST请求
• 通过 taskWDT 监控HTTP请求超时

4. 解析与显示天气数据

采用 cJSON 库处理API返回的JSON数据。首先在 CMakeLists.txt 中添加组件依赖：

set(COMPONENT_REQUIRES 
    cJSON
    esp_http_client
    wifi
)

JSON解析示例：

void parse_weather(const char *json_str) {
    cJSON *root = cJSON_Parse(json_str);
    if (!root) {
        ESP_LOGE("WEATHER", "JSON parse error");
        return;
    }

    cJSON *main = cJSON_GetObjectItem(root, "main");
    float temp = cJSON_GetObjectItem(main, "temp")->valuedouble - 273.15; // 开尔文转摄氏度
    
    cJSON *weather = cJSON_GetArrayItem(cJSON_GetObjectItem(root, "weather"), 0);
    const char *desc = cJSON_GetObjectItem(weather, "description")->valuestring;

    ESP_LOGI("WEATHER", "当前温度: %.1f°C, 天气状况: %s", temp, desc);
    cJSON_Delete(root);
}

数据显示优化方案：

• 使用 lvgl 库构建OLED界面
• 实现数据缓存避免频繁API请求
• 添加 CONFIG_ESP_TIMER_IMPL 定时刷新数据

5. 编译优化与固件烧录

在项目根目录的 CMakeLists.txt 中添加内存优化配置：

idf_build_set_property(COMPILE_OPTIONS "-Os" APPEND)
idf_build_set_property(COMPILE_OPTIONS "-fdata-sections" APPEND) 
idf_build_set_property(COMPILE_OPTIONS "-ffunction-sections" APPEND)

关键编译参数对比：

优化选项	代码大小	内存占用	执行速度
-O0	最大	高	最慢
-Os	较小	中等	较快
-O3	较大	低	最快

烧录前检查分区表配置：

# partitions.csv
nvs,      data, nvs,     0x9000,  0x4000
otadata,  data, ota,     0xd000,  0x2000
app0,     app,  ota_0,   0x10000, 0x140000
spiffs,   data, spiffs,  0x150000,0x2B0000

6. 调试技巧与异常处理

添加自定义看门狗监控任务：

void task_monitor(void *pvParameters) {
    while(1) {
        vTaskDelay(10000 / portTICK_PERIOD_MS);
        ESP_LOGI("MONITOR", "Free heap: %d", esp_get_free_heap_size());
        
        if(uxTaskGetStackHighWaterMark(NULL) < 512) {
            ESP_LOGE("MONITOR", "Stack overflow risk!");
        }
    }
}

常见问题解决方案：

• Wi-Fi频繁断开 ：检查 esp_wifi_set_ps(WIFI_PS_NONE) 关闭省电模式
• HTTP请求失败 ：增加 CONFIG_ESP_TLS_READ_BUFFER_SIZE 到4096
• 内存不足 ：使用 heap_caps_print_heap_info(MALLOC_CAP_8BIT) 分析内存分布

在项目开发过程中，我发现在ESP32上使用 esp_http_client 时，为每个请求创建新连接会导致内存碎片。最佳实践是复用连接句柄，并在空闲时调用 esp_http_client_cleanup 释放资源。