Espruino:Справочник по API/Библиотека WiFi/getStatus(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
Строка 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.
Примеры
См.также
Внешние ссылки