ESP8266WiFi

Введение
Библиотека ESP8266WiFi разработана на основе ESP8266 SDK с использованием соглашений о названиях и общей философии функциональности библиотеки Arduino WiFi. Со временем множество функций Wi-Fi, перенесенных из ESP8266 SDK в esp8266/Arduino, переросло библиотеку WiFi Arduino, и стало очевидно, что нам потребуется предоставить отдельную документацию о том, что нового и дополнительного.
 
Эта документация познакомит вас с несколькими классами, методами и свойствами библиотеки ESP8266WiFi. Если вы новичок в C++ и Arduino, не волнуйтесь. Мы начнем с общих понятий, а затем перейдем к подробному описанию членов каждого конкретного класса, включая примеры использования.

Быстрый старт
Чтобы подключить модуль ESP к Wi-Fi (как мобильный телефон к точке доступа), вам понадобится всего пара строк кода:

#include <ESP8266WiFi.h> // подключаем библиотеку

void setup()
{
Serial.begin(115200);
Serial.println();

WiFi.begin("network-name", "pass-to-network"); // логин и пароль вашей WiFi сети

Serial.print("Подключение");
while (WiFi.status() != WL_CONNECTED)
{
delay(500);
Serial.print(".");
}
Serial.println();

Serial.print("Подключено, IP адрес: ");
Serial.println(WiFi.localIP());
}

void loop() {}

В строке WiFi.begin('network-name', 'pass-to-network') замените network-name и pass-to-network на имя и пароль сети Wi-Fi, к которой вы хотите подключиться. Затем загрузите этот скетч в модуль ESP и откройте монитор порта. Вы должны увидеть что-то вроде:

Как это работает?

В первой строке скетча #include <ESP8266WiFi.h> мы подключаем библиотеку ESP8266WiFi. Эта библиотека предоставляет специфичные для ESP8266 подпрограммы Wi-Fi, которые мы вызываем для подключения к сети.

Фактическое подключение к Wi-Fi инициализируется вызовом:
WiFi.begin("network-name", "pass-to-network");

Процесс подключения может занять пару секунд, и мы проверяем, завершилось ли это в следующем цикле:

while (WiFi.status() != WL_CONNECTED)
{
  delay(500);
  Serial.print(".");
}

Цикл while() будет продолжаться до тех пор, пока WiFi.status() отличается от WL_CONNECTED. Цикл выйдет, только если статус изменится на WL_CONNECTED.

В последней строке будет распечатан IP-адрес, назначенный модулю ESP:
Serial.println(WiFi.localIP());

Если вы не видите последнюю строчку, а только точки ........., то, скорее всего, в скетче неправильно введено имя или пароль вашей сети Wi-Fi. Подтвердите имя и пароль, подключившись заново к этой сети Wi-Fi с ПК или мобильного телефона.
 
Примечание: если соединение установлено, а затем по какой-то причине потеряно, ESP автоматически переподключится к последней использовавшейся точке доступа, как только она снова вернется в сеть. Это будет сделано автоматически библиотекой Wi-Fi без какого-либо вмешательства пользователя.