Espruino:Справочник по API/Библиотека WiFi/getStatus(): различия между версиями

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 3: Строка 3:
{{Myagkij-редактор}}
{{Myagkij-редактор}}


=<ref>[https://www.espruino.com/Reference#l_Wifi_getStatus www.espruino.com - require("Wifi").getStatus(callback)]</ref>=
=Функция Wifi.getStatus()<ref>[https://www.espruino.com/Reference#l_Wifi_getStatus www.espruino.com - require("Wifi").getStatus(callback)]</ref>=


==Синтаксис==
==Синтаксис==


<syntaxhighlight lang="javascript" enclose="div">
<syntaxhighlight lang="javascript" enclose="div">
 
require("Wifi").getStatus(callback)
</syntaxhighlight>
</syntaxhighlight>


==Параметры==
==Параметры==


 
* '''callback''' – опциональная функция callback(status), вызываемая вместе с возвращением информации о текущем состоянии WiFi-соединения. То есть status – это тот же объект, что будет возвращен этой функцией напрямую


==Возвращаемое значение==
==Возвращаемое значение==


 
Объект с информацией о текущем состоянии WiFi-соединения (если она доступна незамедлительно).


==Описание==
==Описание==


Возвращает общую информацию о текущем WiFi-соединении, касающуюся и станции, и точки доступа. Чтобы получить более глубокую информацию о WiFi-настройках станции и точки доступа, используйте функции getDetails() и getAPDetails() соответственно. В объекте status содержатся следующие свойства:
* '''station''' – текущее состояние станции: off, connecting, ...
* '''ap''' – текущее состояние точки доступа: disabled или enabled.
* '''mode''' – режим, в котором устройство работает в данный момент: off, sta, ap, sta+ap.
* '''phy''' – используемый стандарт WiFi-связи: 11b, 11g, 11n (в документации ESP8266 об этом точно не говорится, но из того, что есть, можно предположить, что 11n означает b/g/n). Эта настройка ограничивает модуляцию радиоволны, а не задает модуляцию, используемую точкой доступа в данный момент.
* '''powersave''' – текущий режим энергопотребления: none (WiFi работает всегда), ps-poll (WiFi выключен между маяками; интервал маяка задается в DTIM-настройке точки доступа). Помните, что WiFi включен всегда в режимах ap и sta+ap, так что при их использовании энергосбережение невозможно.
* '''savedMode''' – режим работы, который будет задан после загрузки: off, sta, ap, sta+ap.


'''Примечание:''' Эта функция доступна только для плат на базе ESP32 и ESP8266, работающих на [[Espruino]].


== Примеры ==
== Примеры ==

Версия от 17:38, 28 февраля 2021

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


Функция Wifi.getStatus()[1]

Синтаксис

require("Wifi").getStatus(callback)

Параметры

  • callback – опциональная функция callback(status), вызываемая вместе с возвращением информации о текущем состоянии WiFi-соединения. То есть status – это тот же объект, что будет возвращен этой функцией напрямую

Возвращаемое значение

Объект с информацией о текущем состоянии WiFi-соединения (если она доступна незамедлительно).

Описание

Возвращает общую информацию о текущем WiFi-соединении, касающуюся и станции, и точки доступа. Чтобы получить более глубокую информацию о WiFi-настройках станции и точки доступа, используйте функции getDetails() и getAPDetails() соответственно. В объекте status содержатся следующие свойства:

  • station – текущее состояние станции: off, connecting, ...
  • ap – текущее состояние точки доступа: disabled или enabled.
  • mode – режим, в котором устройство работает в данный момент: off, sta, ap, sta+ap.
  • phy – используемый стандарт WiFi-связи: 11b, 11g, 11n (в документации ESP8266 об этом точно не говорится, но из того, что есть, можно предположить, что 11n означает b/g/n). Эта настройка ограничивает модуляцию радиоволны, а не задает модуляцию, используемую точкой доступа в данный момент.
  • powersave – текущий режим энергопотребления: none (WiFi работает всегда), ps-poll (WiFi выключен между маяками; интервал маяка задается в DTIM-настройке точки доступа). Помните, что WiFi включен всегда в режимах ap и sta+ap, так что при их использовании энергосбережение невозможно.
  • savedMode – режим работы, который будет задан после загрузки: off, sta, ap, sta+ap.

Примечание: Эта функция доступна только для плат на базе ESP32 и ESP8266, работающих на Espruino.

Примеры

См.также

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