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 ищите по [ссылка этой ссылке].

См.также

Внешние ссылки