手把手教你为Arduino项目添加天气功能：从申请和风天气Key到TFT屏幕显示
从零构建Arduino天气站：和风天气API与TFT屏幕实战指南
1. 项目概述与核心组件
在智能硬件开发领域，实时天气数据显示是一个兼具实用性和技术挑战的经典项目。通过将和风天气API与Arduino平台结合，我们可以打造一个功能完整的桌面天气站，不仅能显示当前温度、湿度等基础信息，还能通过TFT屏幕呈现直观的天气图标。这个项目涉及多个技术环节的串联，包括：
- API通信：通过HTTP/HTTPS协议获取压缩格式的天气数据
- 数据解压：使用UZlib库处理GZIP压缩流
- JSON解析：提取关键天气参数
- 可视化呈现：在TFT屏幕上布局显示信息
所需硬件组件清单：
| 组件类型 | 推荐型号 | 备注 |
|---|---|---|
| 主控板 | ESP8266/ESP32 | 需支持Wi-Fi连接 |
| 显示屏 | ILI9341 TFT | 2.4-3.2英寸为宜 |
| 传感器 | 可选BME280 | 本地环境监测 |
2. 和风天气API配置详解
2.1 开发者账号申请
访问和风天气开发者平台，完成注册后进入控制台。免费版提供每日1000次API调用，完全满足个人项目需求。关键步骤包括：
- 创建新应用
- 选择"Web API"类型
- 获取API Key（通常以"HE"开头）
注意：API Key应妥善保管，避免在代码中直接明文存储
2.2 接口调用规范
和风天气提供多种接口，本项目主要使用：
// 实时天气接口 String nowUrl = "https://devapi.qweather.com/v7/weather/now?location=" + location + "&key=" + key; // 3天预报接口 String forecastUrl = "https://devapi.qweather.com/v7/weather/3d?location=" + location + "&key=" + key;参数说明：
location：位置ID（可通过城市搜索API获取）key：开发者认证密钥
3. 数据获取与处理技术
3.1 网络请求实现
使用ESP8266HTTPClient库发起HTTPS请求时，需特别注意：
WiFiClientSecure client; HTTPClient http; client.setInsecure(); // 跳过证书验证（简化示例） http.begin(client, url); http.addHeader("Accept-Encoding", "gzip"); // 声明支持压缩 int httpCode = http.GET();3.2 GZIP解压处理
和风天气返回的数据采用GZIP压缩，需使用UZlib库解压：
#include <ArduinoUZlib.h> uint8_t output[2048]; size_t outSize = 0; int result = ArduinoUZlib::decompress( inputData, inputLength, output, outSize );解压后的数据为JSON格式，可通过ArduinoJson库解析：
DynamicJsonDocument doc(2048); deserializeJson(doc, output); float temperature = doc["now"]["temp"]; String weatherText = doc["now"]["text"];4. TFT屏幕显示优化
4.1 界面布局设计
推荐采用分层显示结构：
- 顶部区域：城市名称+当前时间
- 中部左侧：天气图标（80x80像素）
- 中部右侧：温度/湿度数值
- 底部区域：三日预报摘要
4.2 天气图标实现
和风天气提供标准天气代码，可映射为自定义图标：
String getWeatherIcon(String code) { if(code == "100") return "晴"; if(code == "101") return "多云"; // 其他天气状态映射... }实际显示时建议使用位图字体或预先设计的图标集。以下是一个典型的显示函数：
void drawWeather(TFT_eSPI &tft, WeatherData data) { tft.setTextColor(TFT_WHITE, TFT_BLACK); tft.drawString(data.city, 10, 10, 4); // 显示温度（红色突出） tft.setTextColor(TFT_RED, TFT_BLACK); tft.drawString(data.temp + "°C", 100, 50, 6); // 绘制天气图标 drawIcon(tft, data.icon, 20, 50); }5. 系统集成与优化技巧
5.1 内存管理要点
由于嵌入式设备资源有限，需特别注意：
- 使用
String类时避免内存碎片 - 及时释放JSON解析占用的内存
- 合理设置网络超时（建议15-30秒）
5.2 数据更新策略
平衡实时性和功耗的更新方案：
unsigned long lastUpdate = 0; void loop() { if(millis() - lastUpdate > 600000) { // 每10分钟更新 fetchWeather(); lastUpdate = millis(); } // 其他处理逻辑... }5.3 错误处理机制
健壮的异常处理应包括：
- 网络连接失败重试（最多3次）
- API响应错误码解析
- 数据校验（如温度范围检查）
- 本地缓存机制（断电后可显示最后有效数据）
6. 进阶功能扩展
6.1 多城市切换
通过按钮或旋钮实现城市切换：
String cities[] = {"北京", "上海", "广州"}; int currentCity = 0; void switchCity() { currentCity = (currentCity + 1) % 3; updateWeather(cities[currentCity]); }6.2 环境传感器集成
结合BME280传感器显示本地微气候：
| 传感器参数 | 显示位置 | 更新频率 |
|---|---|---|
| 温度 | 主屏幕右下角 | 实时 |
| 湿度 | 预报区域上方 | 每2分钟 |
| 气压 | 可选折叠区域 | 每5分钟 |
6.3 低功耗优化
对于电池供电场景：
- 使用深度睡眠模式
- 降低屏幕亮度/刷新率
- 优化Wi-Fi连接时间
- 采用分段式数据获取（先获取基础数据，再按需获取详细预报）
7. 项目调试与问题排查
当遇到显示异常时，建议按以下步骤排查：
检查网络连接
- 确认Wi-Fi信号强度
- 测试基础网络连通性（如Ping测试）
验证API响应
Serial.print("HTTP Code: "); Serial.println(httpCode); Serial.println(payload);内存使用监控
Serial.printf("Free Heap: %d\n", ESP.getFreeHeap());显示测试模式
void testScreen(TFT_eSPI &tft) { tft.fillScreen(TFT_BLACK); tft.drawRect(0,0,tft.width(),tft.height(),TFT_WHITE); // 添加更多测试图形... }
实际开发中，我发现在ESP8266上同时处理网络通信和屏幕刷新时，容易出现内存不足的情况。通过将大缓冲区声明为静态变量，并优化JSON解析流程，最终实现了稳定运行。