Создаем кнопки управления светодиодом на WEB-странице ESP8266
В предыдущих уроках мы уже научились выводить WEB-страницу с микроконтроллера ESP8266. Теперь добавим на нее элементы управления.
Создадим две кнопки: ON и OFF. При нажатии на них браузер будет отправлять ESP8266 команду, а микроконтроллер — изменять состояние светодиода.
Рассмотрим два варианта программы: на microPython и на C++ в Arduino IDE.
В данном примере: светодиод управляется через GPIO2. Для используемой платы ESP8266 этот вывод обозначен как D4. В программе используется инверсная логика: LOW — светодиод включен, HIGH — выключен.
Как работает управление с WEB-страницы
Сами кнопки создаются обычным HTML-кодом:
<a href="?led=on"> <button>ON</button> </a> <a href="?led=off"> <button>OFF</button> </a>
При нажатии кнопки браузер переходит не на другую страницу, а отправляет на ESP8266 запрос с дополнительным параметром.
Для кнопки ON запрос содержит:
?led=on
Для кнопки OFF:
?led=off
Микроконтроллер анализирует полученный HTTP-запрос и в зависимости от команды включает или выключает светодиод.
Реализация на microPython
В данном примере предполагается, что подключение ESP8266 к Wi-Fi уже выполнено. Здесь рассматриваем непосредственно WEB-сервер и управление GPIO2.
from machine import Pin
import gc
try:
import usocket as socket
except ImportError:
import socket
led = Pin(2, Pin.OUT)
# Светодиод выключен при старте
led.value(1)
def web_page():
html = """<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta
name="viewport"
content="width=device-width, initial-scale=1.0"
>
<title>ESP8266 LED Control</title>
</head>
<body>
<div style="text-align:center;">
<h1>
Управление светодиодом
</h1>
<p>
<a href="?led=on">
<button>
ON
</button>
</a>
<a href="?led=off">
<button>
OFF
</button>
</a>
</p>
</div>
</body>
</html>"""
return html
s = socket.socket(
socket.AF_INET,
socket.SOCK_STREAM
)
s.bind(
('', 80)
)
s.listen(5)
while True:
conn = None
try:
gc.collect()
conn, addr = s.accept()
print(
'Got a connection from %s'
% str(addr)
)
request = conn.recv(1024)
print(
'Content = %s'
% str(request)
)
if b'/?led=on' in request:
print(
'LED ON'
)
led.value(0)
elif b'/?led=off' in request:
print(
'LED OFF'
)
led.value(1)
response = web_page()
conn.send(
b'HTTP/1.1 200 OK\r\n'
)
conn.send(
b'Content-Type: text/html; charset=UTF-8\r\n'
)
conn.send(
b'Connection: close\r\n\r\n'
)
conn.sendall(
response.encode('utf-8')
)
except OSError as e:
print(
'Connection error:',
e
)
finally:
if conn:
conn.close()
Настройка вывода
Сначала GPIO2 настраивается как выход:
led = Pin(
2,
Pin.OUT
)
При старте программы записываем единицу, поэтому светодиод находится в выключенном состоянии:
led.value(1)
Получение команды из браузера
ESP8266 принимает HTTP-запрос:
request = conn.recv(1024)
Далее проверяем, содержится ли в запросе команда включения:
if b'/?led=on' in request:
led.value(0)
Или команда выключения:
elif b'/?led=off' in request:
led.value(1)
После обработки команды ESP8266 снова отправляет браузеру HTML-страницу.
Реализация в Arduino IDE
Теперь реализуем тот же принцип на C++. ESP8266 подключается к существующей Wi-Fi сети и запускает WEB-сервер на стандартном HTTP-порту 80.
#include <ESP8266WiFi.h>
const char ssid[] = "YOUR_WIFI_NAME";
const char pass[] = "YOUR_WIFI_PASSWORD";
#define LISTEN_PORT 80
#define LED_PIN 2
WiFiServer server(
LISTEN_PORT
);
void setup()
{
pinMode(
LED_PIN,
OUTPUT
);
// Светодиод выключен при старте
digitalWrite(
LED_PIN,
HIGH
);
Serial.begin(115200);
Serial.println();
Serial.print(
"Connecting to "
);
Serial.println(
ssid
);
WiFi.begin(
ssid,
pass
);
while (
WiFi.status() != WL_CONNECTED
)
{
delay(500);
Serial.print(".");
}
Serial.println();
Serial.println(
"WiFi connected."
);
Serial.print(
"IP address: "
);
Serial.println(
WiFi.localIP()
);
server.begin();
}
void loop()
{
WiFiClient client =
server.available();
if (!client)
{
return;
}
Serial.println(
"New client"
);
while (
client.connected() &&
!client.available()
)
{
delay(1);
}
String request =
client.readStringUntil('\r');
Serial.println(
request
);
if (
request.indexOf(
"/?led=on"
) >= 0
)
{
Serial.println(
"GPIO2 ON"
);
digitalWrite(
LED_PIN,
LOW
);
}
else if (
request.indexOf(
"/?led=off"
) >= 0
)
{
Serial.println(
"GPIO2 OFF"
);
digitalWrite(
LED_PIN,
HIGH
);
}
while (
client.available()
)
{
client.read();
}
client.println(
"HTTP/1.1 200 OK"
);
client.println(
"Content-Type: text/html; charset=UTF-8"
);
client.println(
"Connection: close"
);
client.println();
String page = "";
page += "<!DOCTYPE html>";
page += "<html lang='ru'>";
page += "<head>";
page +=
"<meta charset='UTF-8'>";
page +=
"<meta name='viewport' "
"content='width=device-width, "
"initial-scale=1.0'>";
page +=
"<title>"
"ESP8266 LED Control"
"</title>";
page += "</head>";
page += "<body>";
page +=
"<div style='text-align:center;'>";
page +=
"<h1>"
"Управление светодиодом"
"</h1>";
page +=
"<p>"
"<a href='?led=on'>"
"<button>ON</button>"
"</a>"
" "
"<a href='?led=off'>"
"<button>OFF</button>"
"</a>"
"</p>";
page += "</div>";
page += "</body>";
page += "</html>";
client.print(
page
);
delay(1);
client.stop();
Serial.println(
"Client disconnected"
);
}
Подключение к Wi-Fi
В этих строках указываем имя Wi-Fi сети и пароль:
const char ssid[] = "YOUR_WIFI_NAME"; const char pass[] = "YOUR_WIFI_PASSWORD";
После подключения ESP8266 выводит свой IP-адрес в Serial Monitor. Именно этот адрес необходимо открыть в браузере.
Получение HTTP-запроса
Браузер отправляет запрос, который считываем в переменную:
String request =
client.readStringUntil('\r');
Затем ищем в полученной строке команду включения:
request.indexOf( "/?led=on" )
Если команда обнаружена, устанавливаем на GPIO2 логический ноль:
digitalWrite( LED_PIN, LOW );
Для выключения светодиода используется команда ?led=off и на GPIO2 устанавливается логическая единица.
Формирование WEB-страницы
HTML-код страницы формируется внутри обычной строки String.
Самая важная часть — две ссылки с кнопками:
page += "<a href='?led=on'>" "<button>ON</button>" "</a>"; page += "<a href='?led=off'>" "<button>OFF</button>" "</a>";
При нажатии кнопки браузер отправляет новый запрос микроконтроллеру. ESP8266 получает параметр led=on или led=off, изменяет состояние GPIO2 и повторно отправляет страницу браузеру.
Что получили в результате
В этом уроке мы впервые добавили на WEB-страницу простое управление микроконтроллером.
Теперь браузер используется уже не только для отображения информации, но и для передачи команд ESP8266.
Пока внешний вид кнопок максимально простой. В следующем уроке займемся оформлением элементов страницы с помощью CSS.