04-ESP8226的WiFi通用库学习

ESP8266通用库的头文件名，ESP8266WiFiGeneric.h

按照内容区分为下面几个类别：

WiFi事件类：

//STA模式下连接
WiFiEventHandler onStationModeConnected(std::function<void(const WiFiEventStationModeConnected&)>);
//STA模式下断开连接
WiFiEventHandler onStationModeDisconnected(std::function<void(const WiFiEventStationModeDisconnected&)>);
//STA模式下验证模式更改
WiFiEventHandler onStationModeAuthModeChanged(std::function<void(const WiFiEventStationModeAuthModeChanged&)>);
//STA模式下获取IP
WiFiEventHandler onStationModeGotIP(std::function<void(const WiFiEventStationModeGotIP&)>);
//STA模式DHCP超时
WiFiEventHandler onStationModeDHCPTimeout(std::function<void(void)>);
//AP模式下被连接
WiFiEventHandler onSoftAPModeStationConnected(std::function<void(const WiFiEventSoftAPModeStationConnected&)>);
//AP模式下被断开
WiFiEventHandler onSoftAPModeStationDisconnected(std::function<void(const WiFiEventSoftAPModeStationDisconnected&)>);
//AP模式下探针接收请求
WiFiEventHandler onSoftAPModeProbeRequestReceived(std::function<void(const WiFiEventSoftAPModeProbeRequestReceived&)>);
//WiFi模式改变
WiFiEventHandler onWiFiModeChange(std::function<void(const WiFiEventModeChange&)>);

上面函数返回的WiFi中断事件与下面枚举定义对应

typedef enum WiFiEvent
{WIFI_EVENT_STAMODE_CONNECTED = 0,WIFI_EVENT_STAMODE_DISCONNECTED,WIFI_EVENT_STAMODE_AUTHMODE_CHANGE,WIFI_EVENT_STAMODE_GOT_IP,WIFI_EVENT_STAMODE_DHCP_TIMEOUT,WIFI_EVENT_SOFTAPMODE_STACONNECTED,WIFI_EVENT_SOFTAPMODE_STADISCONNECTED,WIFI_EVENT_SOFTAPMODE_PROBEREQRECVED,WIFI_EVENT_MODE_CHANGE,WIFI_EVENT_SOFTAPMODE_DISTRIBUTE_STA_IP,WIFI_EVENT_MAX,WIFI_EVENT_ANY = WIFI_EVENT_MAX,
} WiFiEvent_t;

WiFI睡眠模式：

//设置睡眠模式
bool setSleepMode(WiFiSleepType_t type, uint8_t listenInterval = 0);//获取睡眠模式WiFiSleepType_t getSleepMode();//获得调制解调器睡眠和轻度睡眠的最大睡眠水平的收听间隔
uint8_t getListenInterval ();//延时关闭WiFi
bool forceSleepBegin(uint32 sleepUs = 0);//唤醒WiFi
bool forceSleepWake();

WiFi配置相关：

//获取WiFi的phy模式
WiFiPhyMode_t getPhyMode();//设置输出功率
void setOutputPower(float dBm);//WiFi配置信息是否保存在flash中
static void persistent(bool persistent);//配置WiFi模式
bool mode(WiFiMode_t);//获取WiFi模式
WiFiMode_t getMode();//使能STA模式
bool enableSTA(bool enable);//使能AP模式
bool enableAP(bool enable);

官方例程：

/*This sketch shows how to use WiFi event handlers.In this example, ESP8266 works in AP mode.Three event handlers are demonstrated:- station connects to the ESP8266 AP- station disconnects from the ESP8266 AP- ESP8266 AP receives a probe request from a stationWritten by Markus Sattler, 2015-12-29.Updated for new event handlers by Ivan Grokhotkov, 2017-02-02.This example is released into public domain,or, at your option, CC0 licensed.
*/#include <ESP8266WiFi.h>
#include <stdio.h>#ifndef APSSID
#define APSSID "esp8266"
#define APPSK  "88888888"
#endifconst char* ssid     = APSSID;
const char* password = APPSK;//定义WiFi中断事件的结构体变量
WiFiEventHandler stationConnectedHandler;
WiFiEventHandler stationDisconnectedHandler;
WiFiEventHandler probeRequestPrintHandler;
WiFiEventHandler probeRequestBlinkHandler;bool blinkFlag;void setup() {Serial.begin(115200);pinMode(LED_BUILTIN, OUTPUT);digitalWrite(LED_BUILTIN, HIGH);// Don't save WiFi configuration in flash - optionalWiFi.persistent(false);// Set up an access pointWiFi.mode(WIFI_AP);WiFi.softAP(ssid, password);// Register event handlers.// Callback functions will be called as long as these handler objects exist.// Call "onStationConnected" each time a station connectsstationConnectedHandler = WiFi.onSoftAPModeStationConnected(&onStationConnected);// Call "onStationDisconnected" each time a station disconnectsstationDisconnectedHandler = WiFi.onSoftAPModeStationDisconnected(&onStationDisconnected);// Call "onProbeRequestPrint" and "onProbeRequestBlink" each time// a probe request is received.// Former will print MAC address of the station and RSSI to Serial,// latter will blink an LED.probeRequestPrintHandler = WiFi.onSoftAPModeProbeRequestReceived(&onProbeRequestPrint);probeRequestBlinkHandler = WiFi.onSoftAPModeProbeRequestReceived(&onProbeRequestBlink);
}void onStationConnected(const WiFiEventSoftAPModeStationConnected& evt) {Serial.print("Station connected: ");Serial.println(macToString(evt.mac));
}void onStationDisconnected(const WiFiEventSoftAPModeStationDisconnected& evt) {Serial.print("Station disconnected: ");Serial.println(macToString(evt.mac));
}void onProbeRequestPrint(const WiFiEventSoftAPModeProbeRequestReceived& evt) {Serial.print("Probe request from: ");Serial.print(macToString(evt.mac));Serial.print(" RSSI: ");Serial.println(evt.rssi);
}void onProbeRequestBlink(const WiFiEventSoftAPModeProbeRequestReceived&) {// We can't use "delay" or other blocking functions in the event handler.// Therefore we set a flag here and then check it inside "loop" function.blinkFlag = true;
}void loop() {if (millis() > 10000 && probeRequestPrintHandler) {// After 10 seconds, disable the probe request event handler which prints.// Other three event handlers remain active.Serial.println("Not printing probe requests any more (LED should still blink)");probeRequestPrintHandler = WiFiEventHandler();}if (blinkFlag) {blinkFlag = false;digitalWrite(LED_BUILTIN, LOW);delay(100);digitalWrite(LED_BUILTIN, HIGH);}delay(10);
}String macToString(const unsigned char* mac) {char buf[20];snprintf(buf, sizeof(buf), "%02x:%02x:%02x:%02x:%02x:%02x",mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]);return String(buf);
}

中断事件回调函数的使用：

将中断事件的返回值给定义的结构体变量stationConnectedHandler，作为自定义中断标志位使用。

onStationConnected)是链接中断处理函数

stationConnectedHandler = WiFi.onSoftAPModeStationConnected(&onStationConnected);

中断标志位可以在loop逻辑中判断使用，记得使用后要清除自定义中断标志位。一并的中断函数也被清除

probeRequestPrintHandler = WiFiEventHandler();

onStationConnected是链接中断处理函数

stationConnectedHandler = WiFi.onSoftAPModeStationConnected(&onStationConnected);

中断标志位可以在loop函数逻辑中判断使用，记得使用后要清除自定义中断标志位。一并的中断函数也被清除

probeRequestPrintHandler = WiFiEventHandler();