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

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Нет описания правки
Нет описания правки
Строка 31: Строка 31:
* '''bssid''' – MAC-адрес точки доступа (строка в формате "00:00:00:00:00:00"). Только для [[ESP8266]]
* '''bssid''' – MAC-адрес точки доступа (строка в формате "00:00:00:00:00:00"). Только для [[ESP8266]]


'''Примечания:'''
{{Примечания1|
* В аргумент '''options''' скоро будет добавлена возможность задать статический [[IP-адрес]], а также связанные с ним маску подсети и сетевой шлюз.
* В аргумент '''options''' скоро будет добавлена возможность задать статический [[IP-адрес]], а также связанные с ним маску подсети и сетевой шлюз.
* Единственной ошибкой, которую возвращает функция обратного вызова, будет "Bad password" (неправильный пароль). Все остальные ошибки (вроде ненайденной точки доступа или истечения таймаута [[DHCP]]) будут просто перезапускать соединение. Если вам все же нужны сообщения об этих временных ошибках, то можете просто задать собственный таймаут и воспользоваться полем status в объекте, возвращаемом функцией getDetails().
* Единственной ошибкой, которую возвращает функция обратного вызова, будет "Bad password" (неправильный пароль). Все остальные ошибки (вроде ненайденной точки доступа или истечения таймаута [[DHCP]]) будут просто перезапускать соединение. Если вам все же нужны сообщения об этих временных ошибках, то можете просто задать собственный таймаут и воспользоваться полем status в объекте, возвращаемом функцией getDetails().
* При использовании connect() режим станции включается автоматически, и чтобы снова его отключить, воспользуйтесь disconnect().
* При использовании connect() режим станции включается автоматически, и чтобы снова его отключить, воспользуйтесь disconnect().
}}


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

Версия от 17:04, 10 июня 2023

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


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

Синтаксис

require("Wifi").connect(ssid, options, callback)

Параметры

  • ssid – ID точки доступа
  • options – опциональный объект с настройками подключения
  • callback – функция callback(err), которая будет вызвана после выполнения попытки соединения. При успешном установлении соединения в err будет null, а при неудаче – строка с ошибкой

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

Описание

Подключается к точке доступа в режиме станции. Если у вас есть соединение с точкой доступа, а ее SSID и пароль отличаются от тех, что были заданы в аргументах, то произойдет отключение. Другими словами, если заданные SSID и пароль идентичны тем, что заданы в точке доступа, к которой вы подключены, то ничего не изменится. После выполнения попытки соединения будет запущена функция обратного вызова с одним параметром err: при успешном подключении в нем будет null, а при неуспешном – строка с ошибкой. При включенном DHCP эта функция обратного вызова будет запущена после получения IP-адреса, а при использовании статического IP-адреса – при подключении к точке доступа. Эта функция обратного вызова также запускается, если соединение уже существует и не нуждается в изменении.

В объекте из аргумента options может содержаться следующее:

  • password – строка с паролем, который будет использован для доступа к сети
  • dnsServers (массив строк) – массив, содержащий до двух DNS-серверов (строка в десятичном формате с точками)
  • channel – WiFi-канал точки доступа (целое число в диапазоне 0-14; «0» означает любой канал). Только для ESP8266
  • bssid – MAC-адрес точки доступа (строка в формате "00:00:00:00:00:00"). Только для ESP8266

Шаблон:Примечания1

Примеры

См.также

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