Esp8266_NTP_Clock_Weather 项目教程

1. 项目的目录结构及介绍

目录结构

Esp8266_NTP_Clock_Weather/
├── data/
│   └── weather.json
├── src/
│   ├── main.cpp
│   ├── config.h
│   ├── ntp.h
│   ├── ntp.cpp
│   ├── oled.h
│   ├── oled.cpp
│   ├── weather.h
│   └── weather.cpp
├── include/
│   └── config.h
├── lib/
│   └── Adafruit_SSD1306.h
├── platformio.ini
└── README.md

目录介绍

• data/: 存储天气数据的JSON文件。
• src/: 包含项目的主要源代码文件。
  • main.cpp: 主程序文件。
  • config.h: 配置文件头文件。
  • ntp.h 和 ntp.cpp: NTP时间同步功能的头文件和实现文件。
  • oled.h 和 oled.cpp: OLED显示功能的头文件和实现文件。
  • weather.h 和 weather.cpp: 天气数据获取功能的头文件和实现文件。
• include/: 包含项目的配置头文件。
• lib/: 包含第三方库文件，如Adafruit_SSD1306.h。
• platformio.ini: PlatformIO的配置文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

main.cpp

main.cpp 是项目的启动文件，负责初始化硬件、配置网络、同步时间、获取天气数据并显示在OLED屏幕上。以下是 main.cpp 的主要功能模块：

#include <Arduino.h>
#include "config.h"
#include "ntp.h"
#include "oled.h"
#include "weather.h"

void setup() {
    // 初始化串口
    Serial.begin(115200);
    
    // 初始化OLED屏幕
    oled_init();
    
    // 配置WiFi
    WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
    while (WiFi.status() != WL_CONNECTED) {
        delay(1000);
        Serial.println("Connecting to WiFi...");
    }
    
    // 同步NTP时间
    ntp_init();
    
    // 获取天气数据
    weather_init();
}

void loop() {
    // 更新时间显示
    ntp_update();
    
    // 更新天气数据
    weather_update();
    
    // 显示时间与天气
    oled_display();
    
    delay(60000); // 每分钟更新一次
}

3. 项目的配置文件介绍

config.h

config.h 是项目的配置文件，包含WiFi网络信息、NTP服务器地址、天气API密钥等配置项。以下是 config.h 的主要配置项：

#ifndef CONFIG_H
#define CONFIG_H

// WiFi配置
#define WIFI_SSID "your_wifi_ssid"
#define WIFI_PASSWORD "your_wifi_password"

// NTP服务器配置
#define NTP_SERVER "pool.ntp.org"
#define GMT_OFFSET_SEC 3600 // 时区偏移（秒）
#define DAYLIGHT_OFFSET_SEC 3600 // 夏令时偏移（秒）

// 天气API配置
#define WEATHER_API_KEY "your_api_key"
#define WEATHER_CITY "your_city"

#endif

配置项说明

• WIFI_SSID 和 WIFI_PASSWORD: WiFi网络的SSID和密码。
• NTP_SERVER: NTP服务器地址。
• GMT_OFFSET_SEC: 时区偏移（秒）。
• DAYLIGHT_OFFSET_SEC: 夏令时偏移（秒）。
• WEATHER_API_KEY: 天气API的密钥。
• WEATHER_CITY: 要获取天气数据的城市名称。

通过修改