ESP8266 IoT Framework 项目教程

ESP8266 IoT Framework 项目教程

esp8266-iot-framework Framework for IoT projects implementing HTTPS requests, a React web interface, WiFi manager, live dashboard, configuration manager, file manager and OTA updates. 项目地址: https://gitcode.com/gh_mirrors/es/esp8266-iot-framework

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

esp8266-iot-framework/
├── docs/
│   └── README.md
├── examples/
│   ├── basic_example/
│   └── advanced_example/
├── src/
│   ├── main.cpp
│   ├── config.h
│   ├── wifi.cpp
│   └── mqtt.cpp
├── include/
│   ├── wifi.h
│   └── mqtt.h
├── lib/
│   └── third_party_lib/
├── tests/
│   └── test_wifi.cpp
├── platformio.ini
└── README.md

• docs/: 存放项目的文档文件，如 README.md。
• examples/: 包含项目的示例代码，分为 basic_example 和 advanced_example。
• src/: 项目的源代码文件夹，包含主要的源文件如 main.cpp、config.h、wifi.cpp 和 mqtt.cpp。
• include/: 存放项目的头文件，如 wifi.h 和 mqtt.h。
• lib/: 存放第三方库文件，如 third_party_lib。
• tests/: 包含项目的测试代码，如 test_wifi.cpp。
• platformio.ini: PlatformIO 的配置文件。
• README.md: 项目的说明文件。

2. 项目的启动文件介绍

项目的启动文件是 src/main.cpp。该文件是整个项目的入口点，负责初始化系统、配置网络、连接到 Wi-Fi 和 MQTT 服务器，并启动主要的应用程序逻辑。

#include "config.h"
#include "wifi.h"
#include "mqtt.h"

void setup() {
    // 初始化串口
    Serial.begin(115200);

    // 初始化 Wi-Fi
    initWiFi();

    // 初始化 MQTT
    initMQTT();
}

void loop() {
    // 主循环逻辑
    handleWiFi();
    handleMQTT();
}

• setup(): 初始化串口、Wi-Fi 和 MQTT。
• loop(): 主循环，处理 Wi-Fi 和 MQTT 的相关逻辑。

3. 项目的配置文件介绍

项目的配置文件是 src/config.h。该文件包含了项目的所有配置参数，如 Wi-Fi 的 SSID 和密码、MQTT 服务器的地址和端口等。

#ifndef CONFIG_H
#define CONFIG_H

// Wi-Fi 配置
#define WIFI_SSID "your_wifi_ssid"
#define WIFI_PASSWORD "your_wifi_password"

// MQTT 配置
#define MQTT_SERVER "your_mqtt_server"
#define MQTT_PORT 1883
#define MQTT_USER "your_mqtt_user"
#define MQTT_PASSWORD "your_mqtt_password"

#endif

• WIFI_SSID: Wi-Fi 的 SSID。
• WIFI_PASSWORD: Wi-Fi 的密码。
• MQTT_SERVER: MQTT 服务器的地址。
• MQTT_PORT: MQTT 服务器的端口。
• MQTT_USER: MQTT 的用户名。
• MQTT_PASSWORD: MQTT 的密码。

esp8266-iot-framework Framework for IoT projects implementing HTTPS requests, a React web interface, WiFi manager, live dashboard, configuration manager, file manager and OTA updates. 项目地址: https://gitcode.com/gh_mirrors/es/esp8266-iot-framework