ESP8266:Прошивки/Arduino/Библиотеки/Библиотека ESP8266WiFi/Класс Generic
Класс Generic в библиотеке ESP8266WiFi[1]
Функции и свойства, описанные в этой статье, разработаны специально для ESP8266. В документации WiFi-библиотеки Arduino их нет.
onEvent()
void onEvent (WiFiEventCb cb, WiFiEvent_t event=WIFI_EVENT_ANY) __attribute__((deprecated))
О том, как использовать onEvent(), смотрите в скетче-примере «WiFiClientEvents.ino».
Обработчик событий WiFiEventHandler
- WiFiEventHandler onStationModeConnected (std::function< void(const WiFiEventStationModeConnected &)>)
- WiFiEventHandler onStationModeDisconnected (std::function< void(const WiFiEventStationModeDisconnected &)>)
- WiFiEventHandler onStationModeAuthModeChanged (std::function< void(const WiFiEventStationModeAuthModeChanged &)>)
- WiFiEventHandler onStationModeGotIP (std::function< void(const WiFiEventStationModeGotIP &)>)
- WiFiEventHandler onStationModeDHCPTimeout (std::function< void(void)>)
- WiFiEventHandler onSoftAPModeStationConnected (std::function< void(const WiFiEventSoftAPModeStationConnected &)>)
- WiFiEventHandler onSoftAPModeStationDisconnected (std::function< void(const WiFiEventSoftAPModeStationDisconnected &)>)
Пример использования WiFiEventHandler смотрите в [ссылка статье, описывающей примеры использования функций класса Generic].
persistent()
ESP8266 способен подключаться к последней использованной WiFi-сети (либо после запуска, либо после сброса), используя настройки, хранящиеся в специальных участках flash-памяти. По умолчанию эти настройки записываются на flash-память каждый раз, когда используются в функциях вроде WiFi.begin(ssid, password). Причем запись происходит всякий раз, независимо от того, изменились ли SSID и пароль или нет.
Это может привести к износу flash-памяти – в зависимости от того, как часто вызываются эти функции.
Если выставить аргумент persistent на false, то SSID и пароль будут записаны на flash-память только в том случае, если новые значения не будут соответствовать тем, что хранятся во flash-памяти.
Обратите внимание, что функции WiFi.disconnect() и WiFi.softAPdisconnect() сбрасывают текущие SSID и пароль. Если persistent будет выставлен на false, то использование этих функций не затронет SSID и пароль, хранящиеся во flash-памяти.
Более подробно об этой функции, а также о том, как она была реализована, читайте в отчете #1054.
mode()
Выглядит следующим образом:
WiFi.mode(m)
Позволяет выставить режим на WIFI_AP, WIFI_STA, WIFI_AP_STA и WIFI_OFF.
getMode()
Выглядит следующим образом:
WiFi.getMode()
Возвращает текущий WiFi-режим, т.е. один из четырех, что можно задать в функции mode().
Другие функции
- int32_t channel (void)
- bool setSleepMode (WiFiSleepType_t type)
- WiFiSleepType_t getSleepMode ()
- bool setPhyMode (WiFiPhyMode_t mode)
- WiFiPhyMode_t getPhyMode ()
- void setOutputPower (float dBm)
- WiFiMode_t getMode ()
- bool enableSTA (bool enable)
- bool enableAP (bool enable)
- bool forceSleepBegin (uint32 sleepUs=0)
- bool forceSleepWake ()
- int hostByName (const char *aHostname, IPAddress &aResult)
Документация к этим функциям пока не подготовлена.
Примеры использования функций класса Generic ищите по [ссылка этой ссылке].
