告别手动校时！用ESP8266 AT指令获取苏宁/心知天气API，打造智能时钟和天气站
用ESP8266打造智能时钟与天气站：从API获取到OLED显示的完整指南
在智能家居DIY领域，ESP8266凭借其Wi-Fi功能和低廉价格成为创客们的首选。本文将带您实现一个融合网络时间和天气信息的智能显示终端，告别传统手动校时的繁琐，让您的电子时钟自动同步互联网时间，并实时显示当地天气状况。
1. 项目准备与硬件搭建
1.1 所需材料清单
- ESP8266开发板（如NodeMCU或Wemos D1 mini）
- OLED显示屏（128x64 I2C接口）
- 杜邦线若干
- USB数据线（用于供电和编程）
- 面包板（可选，便于原型搭建）
1.2 硬件连接示意图
将OLED显示屏与ESP8266按照以下方式连接：
| OLED引脚 | ESP8266引脚 | 功能说明 |
|---|---|---|
| GND | GND | 地线 |
| VCC | 3.3V | 电源 |
| SCL | D1 (GPIO5) | I2C时钟 |
| SDA | D2 (GPIO4) | I2C数据 |
提示：不同型号的ESP8266开发板引脚定义可能略有差异，请根据实际板型调整连接。
2. 开发环境配置
2.1 Arduino IDE设置
- 安装最新版Arduino IDE（1.8.x或更高）
- 添加ESP8266开发板支持：
- 打开首选项→附加开发板管理器网址
- 添加：
http://arduino.esp8266.com/stable/package_esp8266com_index.json
- 安装ESP8266开发板包：
# 在开发板管理器中搜索"esp8266"并安装
2.2 必要库安装
在Arduino IDE中安装以下库：
- ESP8266WiFi（内置）
- ArduinoJson（6.x版本）
- Adafruit_SSD1306
- Adafruit_GFX
// 示例：包含必要头文件 #include <ESP8266WiFi.h> #include <ArduinoJson.h> #include <Adafruit_SSD1306.h> #include <Adafruit_GFX.h>3. 网络时间获取与解析
3.1 苏宁时间API接入
苏宁提供了简单的HTTP时间接口，返回JSON格式的当前时间：
String getNetworkTime() { WiFiClient client; if (!client.connect("quan.suning.com", 80)) { return "Connection failed"; } client.print("GET /getSysTime.do HTTP/1.1\r\n"); client.print("Host: quan.suning.com\r\n\r\n"); delay(500); String response; while(client.available()){ response = client.readStringUntil('\n'); if(response.indexOf("{") >= 0) break; } DynamicJsonDocument doc(256); deserializeJson(doc, response); String sysTime = doc["sysTime2"]; client.stop(); return sysTime; }3.2 时间数据解析技巧
API返回的时间格式通常为："2023-08-20 15:30:45"，我们需要将其拆分为可显示的组件：
void parseDateTime(String datetime, int& year, int& month, int& day, int& hour, int& minute, int& second) { year = datetime.substring(0,4).toInt(); month = datetime.substring(5,7).toInt(); day = datetime.substring(8,10).toInt(); hour = datetime.substring(11,13).toInt(); minute = datetime.substring(14,16).toInt(); second = datetime.substring(17,19).toInt(); }4. 心知天气API集成
4.1 API申请与配置
- 注册心知天气开发者账号
- 获取API密钥（免费版足够基础使用）
- 确定您所在城市的location ID
4.2 天气数据获取实现
以下代码展示了如何获取当前天气状况：
String getWeatherData(String apiKey, String location) { WiFiClient client; if (!client.connect("api.seniverse.com", 80)) { return "{}"; } String url = "/v3/weather/now.json?key=" + apiKey + "&location=" + location + "&language=zh-Hans&unit=c"; client.print("GET " + url + " HTTP/1.1\r\n"); client.print("Host: api.seniverse.com\r\n\r\n"); delay(500); String response; while(client.available()){ String line = client.readStringUntil('\n'); if(line.indexOf("{") >= 0) { response = line; break; } } client.stop(); return response; }4.3 天气数据解析示例
解析返回的JSON数据，提取关键天气信息：
void parseWeather(String json, String& condition, float& temperature) { DynamicJsonDocument doc(512); deserializeJson(doc, json); JsonObject now = doc["results"][0]["now"]; condition = now["text"].as<String>(); temperature = now["temperature"].as<float>(); }5. OLED显示实现
5.1 屏幕初始化
设置OLED显示屏并创建显示对象：
#define SCREEN_WIDTH 128 #define SCREEN_HEIGHT 64 #define OLED_RESET -1 Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET); void setupDisplay() { if(!display.begin(SSD1306_SWITCHCAPVCC, 0x3C)) { Serial.println(F("SSD1306 allocation failed")); for(;;); } display.clearDisplay(); display.setTextColor(WHITE); }5.2 时间与天气信息显示
设计一个清晰的界面布局，同时显示时间和天气：
void displayInfo(String timeStr, String weather, float temp) { display.clearDisplay(); // 显示时间（大字体） display.setTextSize(2); display.setCursor(0,0); display.print(timeStr.substring(11,16)); // 显示时:分 // 显示日期 display.setTextSize(1); display.setCursor(0,20); display.print(timeStr.substring(0,10)); // 显示年-月-日 // 显示天气信息 display.setCursor(0,35); display.print("天气: " + weather); display.setCursor(0,50); display.print("温度: "); display.print(temp); display.print("°C"); display.display(); }6. 系统整合与优化
6.1 主程序逻辑框架
将各个模块整合到一个完整的系统中：
void loop() { static unsigned long lastUpdate = 0; if(millis() - lastUpdate > 60000) { // 每分钟更新一次 String currentTime = getNetworkTime(); String weatherJson = getWeatherData("YOUR_API_KEY", "yourcity"); String weatherCondition; float temperature; parseWeather(weatherJson, weatherCondition, temperature); displayInfo(currentTime, weatherCondition, temperature); lastUpdate = millis(); } }6.2 省电优化技巧
- 在两次更新之间将ESP8266设置为深度睡眠模式
- 根据时间段调整更新频率（夜间可减少更新）
- 使用
display.dim(true)降低OLED亮度
// 深度睡眠示例 ESP.deepSleep(60e6); // 睡眠60秒7. 进阶功能扩展
7.1 多城市天气支持
通过按钮切换显示不同城市的天气信息：
// 定义城市列表 String cities[] = {"beijing", "shanghai", "guangzhou"}; int currentCity = 0; // 在loop()中添加按钮检测 if(digitalRead(BUTTON_PIN) == LOW) { currentCity = (currentCity + 1) % 3; updateDisplay(); }7.2 天气预测显示
扩展心知天气API调用，获取未来几天预报：
String getForecast(String apiKey, String location) { WiFiClient client; if (!client.connect("api.seniverse.com", 80)) { return "{}"; } String url = "/v3/weather/daily.json?key=" + apiKey + "&location=" + location + "&language=zh-Hans&unit=c&start=0&days=3"; client.print("GET " + url + " HTTP/1.1\r\n"); client.print("Host: api.seniverse.com\r\n\r\n"); // ...处理响应... }7.3 自动亮度调节
根据环境光线调整OLED亮度：
void autoAdjustBrightness() { int lightLevel = analogRead(LDR_PIN); int brightness = map(lightLevel, 0, 1023, 0, 255); analogWrite(OLED_BRIGHTNESS_PIN, brightness); }8. 常见问题解决
8.1 WiFi连接不稳定
- 确保信号强度足够（RSSI > -70）
- 尝试更换WiFi信道
- 增加连接超时时间：
WiFi.begin(ssid, password); int retries = 0; while (WiFi.status() != WL_CONNECTED && retries < 20) { delay(500); retries++; }8.2 API请求失败处理
实现简单的重试机制和错误显示：
String safeGetNetworkTime() { for(int i=0; i<3; i++) { String time = getNetworkTime(); if(time.length() > 10) return time; delay(1000); } return "00:00:00"; }8.3 显示内容刷新闪烁
采用双缓冲技术减少闪烁：
void smoothRefresh() { display.clearDisplay(); // 绘制所有内容到内存 display.display(); // 一次性更新屏幕 }