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

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

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


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

Синтаксис

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

Параметры

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

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

Описание

Создает точку WiFi-доступа, к которой могут подключаться станции. Если в свойстве password будет пустая строка или null, соединение будет открыто, а если нет, то зашифровано. Функция callback(err) вызывается после попытки создания точки доступа: в случае успеха в аргументе err будет null, а в случае неудачи – строка с сообщением об ошибке.

В объекте options содержится следующее:

  • authMode – метод аутентификации. Возможные варианты: "open", "wpa2", "wpa", "wpa_wpa2". По умолчанию точка доступа открыта для подключения ("open"), но оставлять ее открытой не рекомендуется.
  • password – пароль для подключения станций к точке доступа (если в authMode не задано открытое соединение).
  • channel – канал, используемый для точки доступа (1-13). Если устройство в роли станции также подключено к другой точке доступа, то канал будет определяться той другой точкой доступа.
  • hidden – здесь задается, будет ли точка доступа видимой или нет (0 – видима, 1 – скрыта). По умолчанию видима.
Примечание
  • В будущем в объект options будет добавлено свойство для IP-адреса и маски подсети точки доступа.
  • Запуск startAP() автоматически включает режим точки доступа. Чтобы отключить его, воспользуйтесь stopAP().

Примеры

См.также

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