ESPAsyncWiFiManager 使用指南

ESPAsyncWiFiManager 使用指南

ESPAsyncWiFiManagerPort WiFiManager to ESP Async Server项目地址:https://gitcode.com/gh_mirrors/es/ESPAsyncWiFiManager

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

ESPAsyncWiFiManager 项目的目录结构如下：

ESPAsyncWiFiManager/
├── examples/
│   ├── Async_AutoConnect/
│   ├── Async_ConfigOnDRD/
│   ├── Async_ConfigOnDoubleReset/
│   ├── Async_ConfigOnStartup/
│   ├── Async_MQTT_ESP32/
│   ├── Async_MQTT_ESP8266/
│   ├── Async_SmartConfig/
│   ├── Async_WiFi_MQTT/
│   └── README.md
├── src/
│   ├── ESPAsyncWiFiManager.cpp
│   ├── ESPAsyncWiFiManager.h
│   └── README.md
├── LICENSE
├── README.md
└── library.properties

目录介绍

• examples/: 包含多个示例项目，展示了如何使用 ESPAsyncWiFiManager 进行 WiFi 管理和配置。
  • Async_AutoConnect/: 自动连接到已保存的 WiFi 网络。
  • Async_ConfigOnDRD/: 在设备重启两次后进行配置。
  • Async_ConfigOnDoubleReset/: 在设备双重启后进行配置。
  • Async_ConfigOnStartup/: 在设备启动时进行配置。
  • Async_MQTT_ESP32/: 在 ESP32 上使用 MQTT 进行 WiFi 管理。
  • Async_MQTT_ESP8266/: 在 ESP8266 上使用 MQTT 进行 WiFi 管理。
  • Async_SmartConfig/: 使用 SmartConfig 进行 WiFi 配置。
  • Async_WiFi_MQTT/: 结合 WiFi 管理和 MQTT。
• src/: 包含 ESPAsyncWiFiManager 的核心源代码文件。
  • ESPAsyncWiFiManager.cpp: 主要实现文件。
  • ESPAsyncWiFiManager.h: 头文件。
• LICENSE: 项目的许可证文件。
• README.md: 项目的主 README 文件，包含项目的基本信息和使用说明。
• library.properties: Arduino 库的属性文件。

2. 项目的启动文件介绍

ESPAsyncWiFiManager 的启动文件主要是 ESPAsyncWiFiManager.cpp 和 ESPAsyncWiFiManager.h。这两个文件定义了 ESPAsyncWiFiManager 类及其方法，用于管理 WiFi 连接和配置。

ESPAsyncWiFiManager.h

#ifndef ESPAsyncWiFiManager_h
#define ESPAsyncWiFiManager_h

#include <Arduino.h>
#include <ESPAsyncWebServer.h>
#include <DNSServer.h>
#include <WiFi.h>
#include <WiFiClient.h>
#include <WiFiAP.h>
#include <WiFiGeneric.h>
#include <WiFiMulti.h>
#include <WiFiScan.h>
#include <WiFiServer.h>
#include <WiFiSTA.h>
#include <WiFiType.h>
#include <WiFiUdp.h>

class ESPAsyncWiFiManager {
public:
    ESPAsyncWiFiManager(AsyncWebServer* server, DNSServer* dns);
    void autoConnect(const char* ssid, const char* password = NULL);
    void startConfigPortal(const char* ssid, const char* password = NULL);
    bool isConnected();
    void setAPStaticIPConfig(IPAddress ip, IPAddress gw, IPAddress sn);
    void setSTAStaticIPConfig(IPAddress ip, IPAddress gw, IPAddress sn);
    void setDebugOutput(boolean debug);
    void setAPCallback(void (*func)(ESPAsyncWiFiManager* wm));
    void setSaveConfigCallback(void (*func)(void));
    void setPreSaveConfigCallback(void (*func)(void));
    void setConfigPortalTimeout(unsigned long seconds);
    void setConnectTimeout(unsigned long seconds);
    void setSaveTimeout(unsigned long seconds);
    void setBreakAfterConfig(boolean shouldBreak);
    void setCaptivePortalEnable(boolean enabled);
    void setCountry(const char* country);
    void setWiFiAPChannel(int channel);
    void setWiFiAutoReconnect(boolean autoReconnect);
    void setWiFiPhyMode(WiFiPhyMode_t mode);
    void setWiFiTxPower(int power);
    void setWiFiRetryCount(int count);
   

ESPAsyncWiFiManagerPort WiFiManager to ESP Async Server项目地址:https://gitcode.com/gh_mirrors/es/ESPAsyncWiFiManager