ESP8266:Прошивки/Arduino/Библиотеки/Библиотека ESP8266WiFi/Класс Generic

Содержание

Введение

Модули

AT-команды

Прошивки

Примеры

Проекты

Типовые проблемы

Библиотеки

Перевод: Максим Кузьмин

Проверка/Оформление/Редактирование: Мякишев Е.А.

Черновик

Класс Generic в библиотеке ESP8266WiFi

Функции и свойства, описанные в этой статье, разработаны специально для 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 ищите по [ссылка этой ссылке].