Espruino:Справочник по API/Библиотека WiFi/scan(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
(не показаны 3 промежуточные версии 2 участников) | |||
Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=<ref>[https://www.espruino.com/Reference#l_Wifi_scan www.espruino.com - require("Wifi").scan(callback)]</ref>= | =Функция Wifi.scan()<ref>[https://www.espruino.com/Reference#l_Wifi_scan www.espruino.com - require("Wifi").scan(callback)]</ref>= | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript" | <syntaxhighlight lang="javascript"> | ||
require("Wifi").scan(callback) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==Параметры== | ==Параметры== | ||
* '''callback''' – функция callback(err, ap_list), вызываемая после завершения сканирования. При успешном выполнении в err будет null, а в ap_list – массив, а при неуспешном в err будет строка с ошибкой, а в ap_list – undefined. | |||
==Возвращаемое значение== | ==Возвращаемое значение== | ||
Строка 21: | Строка 21: | ||
==Описание== | ==Описание== | ||
Выполняет сканирование точек доступа. Это включит режим станции (если он еще не включен). После завершения сканирования будет запущена функция обратного вызова, в аргументе ap_list которой будет массив с найденными точками доступа, и каждая точка доступа будет объектом, содержащим следующее: | |||
* '''ssid''' – строка с [[SSID]]. | |||
* '''mac''' – [[MAC-адрес]] точки доступа в формате «00:00:00:00:00:00». | |||
* '''authMode''' – режим аутентификации: open, wep, wpa, wpa2 или wpa_wpa2. | |||
* '''channel''' – WiFi-канал (1-13). | |||
* '''hidden''' – если [[SSID]] скрыт, здесь будет стоять true (только для [[ESP32]]/[[ESP8266]]). | |||
* '''rssi''' – мощность сигнала (в дБ) в диапазоне от «-110» до «0». | |||
{{Примечание1| | |||
* Чтобы выполнить сканирование, будет включен режим станции, который в итоге останется включенным. Чтобы снова выключить его, воспользуйтесь Wifi.disconnect(). | |||
* Одновременно можно выполнять только одно сканирование. | |||
}} | |||
== Примеры == | == Примеры == | ||
Строка 29: | Строка 40: | ||
=См.также= | =См.также= | ||
=Внешние ссылки= | =Внешние ссылки= | ||
Строка 35: | Строка 46: | ||
<references /> | <references /> | ||
{{Навигационная таблица/Espruino | {{Навигационная таблица/Портал/Espruino}} | ||
Текущая версия от 17:08, 10 июня 2023
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция Wifi.scan()[1]
Синтаксис
require("Wifi").scan(callback)
Параметры
- callback – функция callback(err, ap_list), вызываемая после завершения сканирования. При успешном выполнении в err будет null, а в ap_list – массив, а при неуспешном в err будет строка с ошибкой, а в ap_list – undefined.
Возвращаемое значение
Описание
Выполняет сканирование точек доступа. Это включит режим станции (если он еще не включен). После завершения сканирования будет запущена функция обратного вызова, в аргументе ap_list которой будет массив с найденными точками доступа, и каждая точка доступа будет объектом, содержащим следующее:
- ssid – строка с SSID.
- mac – MAC-адрес точки доступа в формате «00:00:00:00:00:00».
- authMode – режим аутентификации: open, wep, wpa, wpa2 или wpa_wpa2.
- channel – WiFi-канал (1-13).
- hidden – если SSID скрыт, здесь будет стоять true (только для ESP32/ESP8266).
- rssi – мощность сигнала (в дБ) в диапазоне от «-110» до «0».
Примеры
См.также
Внешние ссылки