ESP8266:Прошивки/Arduino/Библиотеки/Библиотека ESP8266WiFi/Класс Generic: различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
(Новая страница: «{{ESP8266 панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} {{Черновик}} =Класс Generic в библ…»)
 
Нет описания правки
 
(не показана 1 промежуточная версия этого же участника)
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


{{Черновик}}
 


=Класс Generic в библиотеке ESP8266WiFi<ref>[http://arduino-esp8266.readthedocs.io/en/latest/esp8266wifi/generic-class.html arduino-esp8266.readthedocs.io - Generic Class]</ref>=
=Класс Generic в библиотеке ESP8266WiFi<ref>[http://arduino-esp8266.readthedocs.io/en/latest/esp8266wifi/generic-class.html arduino-esp8266.readthedocs.io - Generic Class]</ref>=
Строка 43: Строка 43:
Выглядит следующим образом:
Выглядит следующим образом:


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
WiFi.mode(m)
WiFi.mode(m)
</syntaxhighlight>
</syntaxhighlight>
Строка 53: Строка 53:
Выглядит следующим образом:
Выглядит следующим образом:


<syntaxhighlight lang="c" enclose="div">
<syntaxhighlight lang="c">
WiFi.getMode()
WiFi.getMode()
</syntaxhighlight>
</syntaxhighlight>

Текущая версия от 12:51, 18 июня 2023

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



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

См.также

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