Espruino:Справочник по API/Библиотека WiFi/connect(): различия между версиями
Нет описания правки |
Myagkij (обсуждение | вклад) Нет описания правки |
||
(не показаны 2 промежуточные версии 2 участников) | |||
Строка 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(). | ||
}} | |||
== Примеры == | == Примеры == | ||
Строка 42: | Строка 43: | ||
=См.также= | =См.также= | ||
=Внешние ссылки= | =Внешние ссылки= | ||
Строка 48: | Строка 49: | ||
<references /> | <references /> | ||
{{Навигационная таблица/Espruino | {{Навигационная таблица/Портал/Espruino}} | ||
Текущая версия от 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
Примеры
См.также
Внешние ссылки