WiFi class

Основной класс для работы с подключением к WiFi. Необходим для подключения ESP32, ESP 8266, а так же ардуинок с WiFi шилдом.

WiFi.begin()

Инициализирует подключение по заданным параметрам и возвращает текущий статус.

Синтаксис

WiFi.begin(ssid, keyIndex, key, pass);

Параметры

ssid — Необязательный параметр. Имя точки доступа к которой вы хотите подключиться

keyIndex — Необязательный параметр. Сети использующие WEP шифрование могут иметь до 4 ключей. Этот параметр указывает индекс ключа который вы хотите использовать.

key — Необязательный параметр. Шестнадцатеричная строка, используемая как ключ безопасности для WEP сетей.

pass — Необязательный параметр. Сети с шифрованием WPA используют пароль в виде строки от 8 символов.

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

WL_CONNECTED если есть подключение к сети
WL_IDLE_STATUS если нет подключения к сети

WiFi.disconnect()

Отключение от текущей сети

Синтаксис

WiFi.disconnect();

Параметры

Нет

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

Нет

WiFi.config()

Позволяет установить статический IP адрес, сменить DNS, шлюз и адрес подсети.

Синтаксис

WiFi.config(ip, dns, gateway, subnet);

Параметры

ip — IP адрес устройства (массив из 4 байт)

dns — адрес DNS сервера.

gateway — Необязательный параметр. IP адрес сетевого шлюза (массив из 4 байт)

subnet — Необязательный параметр. маска подсети (массив из 4 байт). По умолчанию: 255.255.255.0

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

Нет

WiFi.setDNS()

Настройка DNS серверов

Синтаксис

WiFi.setDNS(dns_server1, dns_server2);

Параметры

dns_server1: IP адрес основного DNS сервера
dns_server2: IP адрес дополнительного DNS сервера

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

Нет

WiFi.SSID()

Получает имя текущей точки доступа

Синтаксис

WiFi.SSID(wifiAccessPoint);

Параметры

wifiAccessPoint — Необязательный параметр. Уточняет от какой сети получить информацию

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

Строка с названием текущей точки доступа.

WiFi.BSSID()

Получает MAC адрес роутера

Синтаксис

WiFi.BSSID(bssid);

Параметры

bssid : массив из 6 байт

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

Массив, содержащий MAC адрес роутера к которому подключен микроконтроллер

WiFi.RSSI()

Получает силу сигнала текущего подключения

Синтаксис

WiFi.RSSI(wifiAccessPoint);

Параметры

wifiAccessPoint: Необязательный параметр. Уточняет от какой сети получить информацию.

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

Число, текущая сила сигнала в dBm

WiFi.encryptionType()

Получает тип шифрование текущей сети

Синтаксис

WiFi.encryptionType(wifiAccessPoint);

Параметры

wifiAccessPoint: Необязательный параметр. Уточняет от какой сети получить информацию.

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

byte : значение обозначающее тип шифрования

TKIP (WPA) = 2
WEP = 5
CCMP (WPA) = 4
NONE = 7
AUTO = 8

WiFi.scanNetworks()

Ищет доступные WiFi сети и возвращает их число

Синтаксис

WiFi.scanNetworks();

Параметры

Нет

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

byte число найденных сетей.

WiFi.status()

Возвращает текущий статус соединения

Синтаксис

WiFi.status();

Параметры

Нет

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

WL_CONNECTED: подключен к WiFi сети
WL_NO_SHIELD: нет WiFi шилда
WL_IDLE_STATUS: временный статус. Срабатывает после вызова WiFi.begin() остается до истечения попыток подключения (WL_CONNECT_FAILED) или до установки соединения (WL_CONNECTED);
WL_NO_SSID_AVAIL: SSID не доступен
WL_SCAN_COMPLETED: сканирование сетей завершено
WL_CONNECT_FAILED: не получилось подключиться после всех попыток
WL_CONNECTION_LOST: соединение потеряно
WL_DISCONNECTED: отключен от сети