1. 项目概述与核心思路最近在折腾一个放在书桌上的桌面天气站核心需求很简单一块低功耗的电子墨水屏每天定时更新几次天气信息显示清晰、不刺眼并且最好能连续运行几个月不用充电。为了实现这个目标我选择了基于ESP32-S3的开发板搭配一块7.5英寸的三色电子墨水屏软件上则完全依赖Open-Meteo这个免费、无需注册的天气API。整个项目的核心逻辑链条非常清晰设备上电 - 连接Wi-Fi - 向Open-Meteo发起HTTP请求获取JSON格式的天气数据 - 解析数据并格式化 - 在内存中构建显示画面 - 驱动eInk屏幕刷新 - 进入深度睡眠等待下一次唤醒。这个流程看似标准但在实际实现中从网络请求的稳定性、JSON解析的内存管理到eInk屏幕特殊的驱动时序和深度睡眠的唤醒源配置每一步都有不少细节需要抠。本文将不仅分享可运行的代码更会重点剖析这些环节中容易踩坑的地方以及我的优化心得目标是让你也能复现一个稳定、省电的离线天气显示终端。为什么选择Open-Meteo和eInk这个组合首先Open-Meteo API基于开放数据提供了丰富的天气参数温度、湿度、风速、降水概率、紫外线指数等且响应格式规范对于嵌入式设备非常友好。其次电子墨水屏的特性是仅在刷新时耗电静态显示时功耗几乎为零这与需要周期性更新数据的天气显示场景是天作之合。通过深度睡眠ESP32在绝大部分时间处于微安级的休眠电流使得整个系统可以用一块不大的电池或USB供电长期运行。这个项目麻雀虽小却涵盖了物联网设备开发的几个关键知识点网络通信、数据解析、外设驱动和电源管理非常适合作为嵌入式开发者的练手项目。2. 硬件选型与开发环境搭建2.1 核心硬件组件解析硬件是整个项目的物理基础选型直接决定了项目的可行性、功耗和成本。我的选择如下主控芯片ESP32-S3开发板。我选用的是集成Wi-Fi和蓝牙的ESP32-S3模组。相比经典的ESP32S3系列提供了更多的GPIO、更快的CPU和更丰富的外设对于驱动较大尺寸的eInk屏需要更多IO和内存进行帧缓冲更有优势。更重要的是它支持超低功耗的深度睡眠模式并能通过定时器或外部引脚如按键唤醒完美契合我们的需求。市面上常见的NodeMCU-32S S3、Seeed Studio XIAO ESP32S3等都是不错的选择。显示单元7.5英寸三色电子墨水屏。我选择的是7.5英寸、800x480分辨率的黑白红三色eInk屏。选择这个尺寸是因为它足够显示多日的天气预报信息视觉体验好。三色黑、白、红则可以用来高亮显示重要信息比如最高温用红色表示。需要注意的是eInk屏的驱动芯片有多种如UC8151D、SSD1681等必须选择与你的屏幕驱动芯片匹配的库。购买时务必确认供应商提供了Arduino或ESP-IDF的驱动库。电源与连接为了便于开发和调试我直接使用USB供电。在实际部署中可以换用锂电池配合充放电管理电路。ESP32-S3与eInk屏之间通过杜邦线连接主要需要连接SPI总线CLK, MOSI, MISO, CS、数据/命令选择线DC、复位线RST和忙状态线BUSY。具体引脚定义需要根据你的开发板和屏幕的引脚说明来连接。注意驱动eInk屏需要消耗较大的瞬时电流特别是在全局刷新时。务必确保你的电源无论是USB还是电池能够提供足够的电流通常需要500mA以上否则可能导致屏幕刷新不全、主板重启等问题。2.2 软件开发环境配置软件环境我选择了Arduino IDE因为它对ESP32的支持已经非常成熟库管理方便适合快速原型开发。安装Arduino IDE与ESP32开发板支持从Arduino官网下载并安装IDE。然后在“文件”-“首选项”的“附加开发板管理器网址”中添加ESP32的板支持网址https://espressif.github.io/arduino-esp32/package_esp32_index.json。接着在“工具”-“开发板”-“开发板管理器”中搜索“esp32”安装“Espressif Systems”提供的ESP32开发板包。安装必要的库本项目主要依赖两个库WiFi和HTTP客户端库这些通常已包含在ESP32基础包中。eInk屏幕驱动库这需要根据你屏幕的具体型号来安装。例如如果你的屏幕使用GxEPD2库驱动可以通过Arduino IDE的库管理器搜索“GxEPD2”并安装。安装后库中会提供对应屏幕尺寸和驱动芯片的示例程序这是验证硬件连接是否正确的最佳起点。项目代码结构规划在Arduino IDE中创建一个新项目。代码将主要包含以下几个部分网络连接凭证Wi-Fi SSID和密码的定义。Open-Meteo API请求URL的构建。HTTP GET请求函数。JSON数据解析函数。eInk屏幕的初始化和绘图函数。深度睡眠的配置与唤醒逻辑。3. 核心代码实现与分步解析下面我将分模块详细解析代码的关键部分。请注意以下代码是概念性的示例你需要根据实际的屏幕驱动库和引脚定义进行调整。3.1 网络连接与API数据获取这是设备与外界通信的第一步稳定性和错误处理至关重要。// 引入必要的库 #include WiFi.h #include HTTPClient.h #include ArduinoJson.h // 你的Wi-Fi凭证 const char* ssid YOUR_SSID; const char* password YOUR_PASSWORD; // Open-Meteo API 基础URL和参数 // 以北京为例 (纬度: 39.9042, 经度: 116.4074) float latitude 39.9042; float longitude 116.4074; String url https://api.open-meteo.com/v1/forecast; url ?latitude String(latitude, 4); url longitude String(longitude, 4); url current_weathertrue; url dailytemperature_2m_max,temperature_2m_min,weathercode; url timezoneauto; void connectToWiFi() { Serial.print(Connecting to ); Serial.println(ssid); WiFi.begin(ssid, password); int attempts 0; while (WiFi.status() ! WL_CONNECTED attempts 20) { // 最多尝试20次约10秒 delay(500); Serial.print(.); attempts; } if (WiFi.status() WL_CONNECTED) { Serial.println(\nWiFi connected!); Serial.print(IP address: ); Serial.println(WiFi.localIP()); } else { Serial.println(\nWiFi connection FAILED. Going to deep sleep.); // 连接失败进入深度睡眠稍后重试 goToDeepSleep(300); // 睡眠5分钟后再试 } } String fetchWeatherData() { if (WiFi.status() ! WL_CONNECTED) { Serial.println(WiFi not connected!); return ; } HTTPClient http; String payload ; Serial.println(Requesting URL: url); http.begin(url); int httpCode http.GET(); if (httpCode HTTP_CODE_OK) { payload http.getString(); Serial.println(Received payload (first 200 chars):); Serial.println(payload.substring(0, 200)); } else { Serial.printf(HTTP GET failed, error: %s\n, http.errorToString(httpCode).c_str()); } http.end(); return payload; }关键点解析与避坑指南Wi-Fi连接超时与重试在connectToWiFi函数中我设置了最多20次尝试约10秒。在实际环境中Wi-Fi连接可能不稳定必须设置超时。如果连接失败不是让程序死循环而是选择进入深度睡眠隔一段时间再唤醒重试。这比不断重连更省电也避免了设备“卡死”。API URL构建Open-Meteo的API非常灵活。示例中我们请求了current_weather当前天气和daily每日预报数据。weathercode是WMO天气代码可以用来判断天气状况晴、雨、雪等便于后续显示对应的图标。timezoneauto让API返回本地时间。HTTP请求错误处理http.GET()的返回值必须检查。HTTP_CODE_OK即200表示成功。其他代码如404、500或网络超时都需要处理。http.errorToString()函数可以帮我们把错误代码转换成可读的信息。内存管理http.getString()会将整个响应内容读入一个String对象。对于天气API响应通常不大几KB但在资源受限的嵌入式设备上仍需注意。如果响应巨大应考虑流式解析。这里我们返回String供后续解析。3.2 JSON数据解析与处理拿到API返回的JSON字符串后我们需要从中提取出有用的信息。这里使用流行的ArduinoJson库。// 定义一个结构体来存储解析后的天气数据 struct WeatherData { float currentTemp; int currentWeatherCode; float dailyMaxTemp[3]; // 未来三天的最高温 float dailyMinTemp[3]; // 未来三天的最低湿 int dailyWeatherCode[3]; // 未来三天的天气代码 String updateTime; }; bool parseWeatherData(const String jsonPayload, WeatherData data) { // 静态JsonDocument大小需要根据实际JSON响应调整 const size_t capacity JSON_OBJECT_SIZE(5) JSON_OBJECT_SIZE(3) JSON_ARRAY_SIZE(3)*JSON_OBJECT_SIZE(10) 2048; StaticJsonDocumentcapacity doc; DeserializationError error deserializeJson(doc, jsonPayload); if (error) { Serial.print(F(deserializeJson() failed: )); Serial.println(error.f_str()); return false; } // 解析当前天气 JsonObject current doc[current_weather]; data.currentTemp current[temperature]; data.currentWeatherCode current[weathercode]; data.updateTime current[time].asString(); // 解析每日预报 JsonObject daily doc[daily]; JsonArray timeArray daily[time]; JsonArray maxTempArray daily[temperature_2m_max]; JsonArray minTempArray daily[temperature_2m_min]; JsonArray weatherCodeArray daily[weathercode]; // 取从明天开始的三天数据索引0通常是今天 for (int i 1; i 3 i timeArray.size(); i) { data.dailyMaxTemp[i-1] maxTempArray[i]; data.dailyMinTemp[i-1] minTempArray[i]; data.dailyWeatherCode[i-1] weatherCodeArray[i]; } Serial.println(Data parsed successfully.); Serial.print(Current Temp: ); Serial.println(data.currentTemp); return true; }关键点解析与避坑指南ArduinoJson内存分配这是最容易出问题的地方。StaticJsonDocumentcapacity在栈上分配固定大小的内存。capacity必须足够大以容纳整个JSON结构否则解析会失败。官方提供了 ArduinoJson Assistant 工具你可以将完整的API响应粘贴进去它会帮你计算所需的capacity。务必使用这个工具凭感觉猜测大小十有八九会崩溃。错误检查deserializeJson()的返回值DeserializationError必须检查。常见的错误有NoMemory容量不足、InvalidInputJSON格式错误等。数据提取使用方括号[]和点运算符.可以方便地访问JSON对象和数组。注意类型转换例如asString()、asint()等。数组索引Open-Meteo返回的每日数据数组第一个元素索引0通常是“今天”。在我们的场景中屏幕上可能显示“明天”、“后天”的预报所以从索引1开始取数据。务必检查数组边界防止访问越界。3.3 eInk屏幕驱动与画面绘制这是视觉输出的核心。eInk屏幕的刷新有其特殊性需要严格按照驱动芯片的时序操作。// 根据你的屏幕库引入头文件和定义对象 #include GxEPD2_BW.h // 如果是黑白屏 #include GxEPD2_3C.h // 如果是三色屏 #include Fonts/FreeMonoBold12pt7b.h // 选择一种字体 // 假设使用GxEPD2库驱动7.5寸三色屏 GxEPD2_3CGxEPD2_750c, GxEPD2_750c::HEIGHT display(GxEPD2_750c(/*CS*/15, /*DC*/27, /*RST*/26, /*BUSY*/25)); void initDisplay() { display.init(115200, true, 2, false); // 初始化参数根据库文档调整 display.setRotation(1); // 设置旋转方向0为竖屏1为横屏 display.setTextColor(GxEPD_BLACK); // 设置默认文本颜色为黑色 display.setFullWindow(); // 设置为全窗口刷新模式 } void drawWeatherScreen(const WeatherData data) { display.firstPage(); do { display.fillScreen(GxEPD_WHITE); // 清屏为白色背景 // 1. 绘制当前天气区域左上角 display.setCursor(20, 40); display.setFont(FreeMonoBold12pt7b); display.print(Now:); display.setCursor(20, 80); display.print(data.currentTemp, 1); // 显示一位小数 display.print(C); // 根据天气代码绘制图标简化示例 int x_icon 120; int y_icon 50; if(data.currentWeatherCode 0) { // 晴天 display.fillCircle(x_icon, y_icon, 20, GxEPD_BLACK); } else if(data.currentWeatherCode 0 data.currentWeatherCode 50) { // 多云等 // 绘制云朵简化图形... } // 2. 绘制未来三天预报横向排列 int dayX 20; int dayY 150; int daySpacing 150; const char* days[] {TOM, DAT, THR}; // 明天后天大后天 for(int i 0; i 3; i) { int xPos dayX i * daySpacing; // 日期 display.setCursor(xPos, dayY); display.setFont(FreeMonoBold12pt7b); display.print(days[i]); // 最高温用红色显示 display.setTextColor(GxEPD_RED); display.setCursor(xPos, dayY 40); display.print(H:); display.print(data.dailyMaxTemp[i], 0); // 取整显示 display.print(C); // 最低温 display.setTextColor(GxEPD_BLACK); display.setCursor(xPos, dayY 70); display.print(L:); display.print(data.dailyMinTemp[i], 0); display.print(C); // 这里也可以根据dailyWeatherCode[i]绘制小图标 } // 3. 绘制更新时间底部 display.setTextColor(GxEPD_BLACK); display.setFont(nullptr); // 恢复默认字体 display.setCursor(20, 450); display.print(Updated: ); display.print(data.updateTime.substring(11, 16)); // 显示HH:MM } while (display.nextPage()); // 循环直到绘制完成所有页对于部分刷新库 Serial.println(Screen update complete.); // 更新完成后根据库的要求可能需要调用 powerOff() 以节省功耗 // display.powerOff(); }关键点解析与避坑指南屏幕初始化display.init()的参数非常重要特别是通信频率和复位等待时间。请务必参考你所使用屏幕的驱动库示例代码中的正确参数。错误的初始化会导致通信失败或屏幕花屏。刷新模式eInk屏有全刷和局刷两种模式。全刷setFullWindow()会清除整个屏幕的所有残留图像显示效果最干净但耗时较长可能2-3秒且全刷次数有限通常约数万次。局刷setPartialWindow()只刷新指定区域速度快几百毫秒对屏幕寿命影响小但多次局刷后可能产生“鬼影”。建议的实践是在显示内容布局变化大时如从天气界面切换到其他界面使用全刷在仅更新部分数据如只更新温度数字时使用局刷。本项目每次更新都是全新的天气数据使用全刷更稳妥。绘制循环display.firstPage()和while (display.nextPage())是GxEPD2库的典型绘制模式。它内部可能将一帧画面分多次发送给屏幕。你只需要在循环体内描述完整的画面即可库会处理分页逻辑。字体与内存使用自定义字体如FreeMonoBold12pt7b会占用较多的程序存储空间Flash。如果空间紧张可以使用内置的默认字体或者只引入1-2种必需的字体。通过setFont(nullptr)可以切换回默认字体。颜色使用对于三色屏黑、白、红GxEPD_RED、GxEPD_BLACK、GxEPD_WHITE是预定义的颜色。注意红色和黑色不能叠加在同一像素上屏幕的每个像素点只能显示一种颜色黑、白或红。3.4 深度睡眠与定时唤醒为了实现超低功耗在完成屏幕刷新后我们需要让ESP32进入深度睡眠。// 定义唤醒引脚例如使用GPIO0连接一个按键到GND内部上拉 #define BUTTON_PIN 0 void goToDeepSleep(int sleepSeconds) { Serial.println(Preparing to go into deep sleep...); Serial.flush(); // 确保所有串口数据发送完毕 // 配置唤醒源 // 1. 定时器唤醒睡眠指定秒数后自动唤醒 esp_sleep_enable_timer_wakeup(sleepSeconds * 1000000ULL); // 微秒 // 2. 外部引脚唤醒可选按按键唤醒 // 引脚电平从高变低时唤醒即按键按下接地 // esp_sleep_enable_ext0_wakeup((gpio_num_t)BUTTON_PIN, 0); Serial.println(Entering deep sleep now.); delay(100); // 短暂延迟确保串口消息发出 esp_deep_sleep_start(); // 进入深度睡眠 // 程序在此停止直到被唤醒后从setup()重新开始执行 } void setup() { Serial.begin(115200); delay(1000); // 给串口监视器一个连接时间 // 检查唤醒原因 esp_sleep_wakeup_cause_t wakeup_reason esp_sleep_get_wakeup_cause(); switch(wakeup_reason) { case ESP_SLEEP_WAKEUP_TIMER: Serial.println(Woke up from timer); break; case ESP_SLEEP_WAKEUP_EXT0: Serial.println(Woke up from external button); break; default: Serial.println(Not a deep sleep wakeup (first boot)); break; } initDisplay(); connectToWiFi(); String jsonData fetchWeatherData(); if (!jsonData.isEmpty()) { WeatherData currentWeather; if (parseWeatherData(jsonData, currentWeather)) { drawWeatherScreen(currentWeather); } else { Serial.println(Failed to parse weather data. Displaying error.); // 可以在屏幕上绘制错误信息 } } else { Serial.println(Failed to fetch weather data.); // 可以在屏幕上绘制网络错误信息 } // 所有任务完成进入深度睡眠例如30分钟1800秒后唤醒 goToDeepSleep(1800); } void loop() { // Deep sleep模式下loop()永远不会被执行 // 因为每次唤醒都是从setup()重新开始 }关键点解析与避坑指南深度睡眠的本质调用esp_deep_sleep_start()后CPU、RAM和大部分外设都会断电。只有RTC实时时钟模块和少数用于唤醒的电路还在工作。因此所有存储在RAM中的变量都会丢失。程序再次启动时会像第一次上电一样从setup()函数开始执行。这是与“浅睡眠”最大的区别。唤醒源配置可以配置多个唤醒源。最常见的是定时器唤醒和外部引脚唤醒。esp_sleep_enable_timer_wakeup()的参数单位是微秒计算时注意不要溢出使用ULL后缀表示无符号长整型。外部引脚唤醒如esp_sleep_enable_ext0_wakeup对于添加一个手动刷新按钮非常有用。串口与延迟在进入睡眠前调用Serial.flush()确保调试信息已发送完毕。添加一个短暂的delay(100)给串口传输留出时间否则最后的日志可能看不到。功耗测量在深度睡眠下ESP32-S3的电流可以低至10微安左右。但请注意你的整个电路板包括稳压器、指示灯等可能还有额外的功耗。实际测量整板睡眠电流是优化续航的关键。断开USB用万用表串联测量电池供电时的电流。setup()中的唤醒原因判断通过esp_sleep_get_wakeup_cause()可以知道设备为什么被唤醒这对于不同的唤醒源执行不同的逻辑很有用例如按键唤醒立即刷新定时唤醒则等待更长时间。4. 系统集成、优化与问题排查将上述模块组合起来就构成了完整的项目。但在实际部署中还需要考虑一些集成和优化问题。4.1 完整工作流程与主循环设计项目的完整流程在setup()函数中已经体现。这里再强调一下其执行顺序和设计考量初始化与唤醒诊断初始化串口用于调试并判断唤醒原因。这对于后期调试设备行为非常有用。硬件初始化初始化eInk屏幕。为什么先初始化屏幕而不是先连Wi-Fi因为如果网络连接或数据获取失败我们至少可以在屏幕上显示一个错误状态如“连接中...”或“更新失败”给用户反馈。如果先连Wi-Fi失败后屏幕还是黑屏用户体验不好。网络连接连接Wi-Fi并做好失败处理失败则直接睡眠。数据获取与解析获取并解析天气数据。这两步都可能失败需要有相应的错误处理例如解析失败时显示上一次成功的数据或显示错误图标。画面绘制将解析好的数据绘制到屏幕上。进入深度睡眠完成所有任务后计算下一次唤醒的时间并进入睡眠。这种“执行任务 - 睡眠”的单次执行模式非常适合由定时器或事件触发的低功耗物联网设备。4.2 功耗优化实战技巧Wi-Fi射频功耗在connectToWiFi()中连接成功后可以调用WiFi.disconnect(true)和WiFi.mode(WIFI_OFF)来彻底关闭Wi-Fi射频这能在进入深度睡眠前节省一点点电流。但注意这需要你在每次唤醒后重新初始化Wi-Fi。屏幕电源管理有些eInk驱动库在display.init()或刷新完成后会自动将屏幕置于睡眠状态。有些则需要手动调用display.powerDown()或display.hibernate()。务必查阅你所使用屏幕的驱动库文档确认正确的省电调用方法。让屏幕进入睡眠状态可以进一步降低整体功耗。不必要的组件在最终产品中可以移除或禁用开发板上的调试LED、USB转串口芯片等。这些都会消耗额外的电流。睡眠时间权衡睡眠时间越长平均功耗越低但数据更新不及时。需要根据实际需求如天气数据的更新频率和电源容量电池大小来权衡。例如每30分钟更新一次对于天气显示来说通常足够了。4.3 常见问题与排查实录在开发过程中我遇到了以下几个典型问题这里分享排查思路问题屏幕刷新后全白或全黑没有内容。排查首先检查硬件连接SPI线CLK, MOSI, MISO, CS是否接错、虚焊。BUSY引脚至关重要必须正确连接否则主控无法知道屏幕是否忙会导致通信时序混乱。检查初始化参数display.init()中的引脚编号、SPI频率是否正确。参考供应商提供的例程。检查电源用万用表测量屏幕供电电压通常是3.3V是否稳定。在屏幕刷新瞬间电压是否有大幅跌落如果跌落严重说明电源带载能力不足需要更换功率更大的电源或靠近屏幕端加一个大电容如100uF。简化测试先不连接网络不解析数据仅仅在setup()里初始化屏幕然后画一个最简单的矩形或文字看是否能显示。以此隔离问题。问题JSON解析总是失败返回NoMemory或乱码。排查使用ArduinoJson Assistant这是最重要的步骤。将串口打印出的完整API响应复制到Assistant中它会给出准确的capacity值。务必使用这个值。检查网络响应确保fetchWeatherData()函数返回的payload是完整的JSON字符串没有被截断。可以通过串口打印其长度和内容片段确认。增大堆栈如果使用了复杂的递归解析或非常大的文档可能需要调整Arduino IDE中ESP32的“栈大小”设置在工具菜单中但这种情况在本项目中不常见。问题设备无法从深度睡眠中唤醒。排查确认唤醒源配置检查esp_sleep_enable_timer_wakeup的微秒数计算是否正确。检查外部唤醒引脚的上拉/下拉电阻配置是否正确通常需要内部上拉按键另一端接地。测量睡眠电流如果睡眠电流过大远高于几十微安可能是某些GPIO引脚在睡眠时产生了漏电流。确保所有未使用的GPIO引脚设置为INPUT_PULLUP或OUTPUT_LOW。特别是连接了eInk屏幕的引脚在睡眠前最好也将其设置为低电平输出或输入上拉。检查复位电路有些开发板的深度睡眠需要特定的电路设计。查阅你的开发板手册确认其支持深度睡眠且无需额外改动。问题Wi-Fi连接时好时坏。排查信号强度使用WiFi.RSSI()打印信号强度。如果低于-70dBm可能不稳定。考虑调整设备位置或使用外置天线。增加重试和超时如代码所示在连接循环中加入次数限制和delay避免无限阻塞。保存凭证对于固定地点的设备可以考虑使用WiFi.begin()的“智能配置”模式或者将凭证存储在非易失性存储如Preferences库中但这不是必须的。这个基于Open-Meteo API和eInk屏的天气站项目从构思到稳定运行涉及了嵌入式开发的多个层面。它不仅仅是一段代码的拼接更是对硬件特性、网络通信、数据解析和电源管理的综合实践。最大的收获在于理解了如何围绕“低功耗”这个核心目标来设计整个系统的运行节奏快速工作长久睡眠。当你看到屏幕清晰地显示出天气信息而设备电流表显示仅有个位数的微安电流时那种成就感正是嵌入式开发的乐趣所在。希望这篇详细的实践记录能帮你绕过我踩过的那些坑顺利做出你自己的智能天气显示设备。