Espruino:Справочник по API/Библиотека WiFi/connect()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

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


Функция 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

Примеры

См.также

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