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
Примечание
  • В аргумент options скоро будет добавлена возможность задать статический IP-адрес, а также связанные с ним маску подсети и сетевой шлюз.
  • Единственной ошибкой, которую возвращает функция обратного вызова, будет "Bad password" (неправильный пароль). Все остальные ошибки (вроде ненайденной точки доступа или истечения таймаута DHCP) будут просто перезапускать соединение. Если вам все же нужны сообщения об этих временных ошибках, то можете просто задать собственный таймаут и воспользоваться полем status в объекте, возвращаемом функцией getDetails().
  • При использовании connect() режим станции включается автоматически, и чтобы снова его отключить, воспользуйтесь disconnect().

Примеры

См.также

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