Подготавливаем среду программирования Visual Studio Code для HTML кода.
В данном уроке мы подготовим среду программирования и проверим ее работу.
Программировать мы будем в Visual Studio Code. Для начала необходимо скачать программу Visual Studio Code .
После скачивания программы устанавливаем ее, соглашаясь с необходимыми параметрами установки.
После установки нам еще необходимо добавить в VS Code расширение Live HTML Previewer. Для добавления расширения необходимо запустить VS Code и нажать иконку расширений в левой части окна или использовать сочетание клавиш Ctrl + Shift + X.
После этого в окне поиска набираем Live HTML Previewer и устанавливаем найденное расширение.
На данный момент нам больше ничего не нужно. Все остальное будем добавлять по мере необходимости.
Итак, открываем стартовое окно и выбираем место, где будут храниться наши файлы.
Далее нажимаем иконку создания файла.
Пишем название файла: index.html
Теперь можно внести первый HTML-код и проверить его работу.
<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>My first web page</title>
</head>
<body>
<h3 style="text-align: center;">
Hello World
</h3>
</body>
</html>
Теперь открываем созданный HTML-файл в браузере.
В браузере мы увидим:
Что мы написали
<!DOCTYPE html>
Строка <!DOCTYPE html> сообщает браузеру, что документ использует современный стандарт HTML.
<meta charset="UTF-8">
Данная строка задает кодировку страницы UTF-8.
<html lang="ru"> ... </html>
Тэг <html> является корневым элементом HTML-документа. Внутри него находится вся структура страницы.
1. Секция HEAD
<head> ... </head>
В секции <head> располагается служебная информация страницы: кодировка, название документа, настройки отображения, подключения CSS и другие данные.
Содержимое секции HEAD обычно не отображается непосредственно в рабочей области страницы.
Например:
<title>My first web page</title>
Тэг <title> задает название страницы, которое браузер отображает на вкладке.
2. Секция BODY
<body> ... </body>
Все, что находится внутри тэга <body>, относится к видимой части WEB-страницы.
В нашем примере используется заголовок:
<h3>Hello World</h3>
В HTML существуют заголовки от <h1> до <h6>.
Для выравнивания нашего заголовка по центру мы используем:
style="text-align: center;"
Раньше для центрирования часто использовался тэг <center>, однако сейчас он считается устаревшим, поэтому для выравнивания используется CSS.
Для переноса строки используется одиночный тэг:
<br>
Подвал страницы
При необходимости внутри секции <body> можно использовать семантический тэг:
<footer> ... </footer>
Он обычно используется для нижней части страницы: информации об авторе, ссылок, контактных данных и другого содержимого. Использовать его необязательно.
Теперь нам осталось перенести HTML-код в микроконтроллер ESP8266.
Рассмотрим два варианта: Arduino IDE и microPython.
Среда программирования Arduino IDE
Подключение ESP8266 к Wi-Fi сети и другие настройки микроконтроллера рассмотрены в других уроках. Здесь основной акцент делаем именно на HTML-коде и передаче WEB-страницы браузеру.
В данном случае микроконтроллер ESP8266 работает как WEB-сервер, а браузер работает как клиент.
Для проверки нового подключения клиента используем:
WiFiClient client = server.available();
if (!client) {
return;
}
Когда браузер обращается к IP-адресу ESP8266, сервер получает подключение клиента.
Далее ждем поступления HTTP-запроса.
while (client.connected() && !client.available()) {
delay(1);
}
После появления данных считываем строку запроса:
String request = client.readStringUntil('\r');
После этого необходимо отправить браузеру корректный HTTP-заголовок.
client.println("HTTP/1.1 200 OK");
client.println("Content-Type: text/html; charset=UTF-8");
client.println("Connection: close");
client.println();
После пустой строки начинается непосредственно HTML-страница.
Полный программный код:
#include <ESP8266WiFi.h>
char ssid[] = "*********";
char pass[] = "*********";
#define LISTEN_PORT 80
WiFiServer server(LISTEN_PORT);
void setup()
{
Serial.begin(115200);
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.println("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);
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 s = "";
s += "<!DOCTYPE html>";
s += "<html lang='ru'>";
s += "<head>";
s += "<meta charset='UTF-8'>";
s += "<meta name='viewport' content='width=device-width, initial-scale=1.0'>";
s += "<title>My first web page</title>";
s += "</head>";
s += "<body>";
s += "<h3 style='text-align:center;'>";
s += "Hello World";
s += "</h3>";
s += "</body>";
s += "</html>";
client.print(s);
delay(1);
client.stop();
Serial.println("Client disconnected");
}
Выполнив данный код, в браузере мы должны увидеть:
Реализация на microPython
Все нюансы настройки ESP8266 рассматриваются в уроках, посвященных данному микроконтроллеру. Здесь основной упор делаем на HTML-код и работу WEB-сервера.
Для автоматического подключения ESP8266 к Wi-Fi сети используем файл boot.py.
import network
import gc
ssid = '******'
password = '*****'
station = network.WLAN(network.STA_IF)
station.active(True)
if not station.isconnected():
station.connect(ssid, password)
while not station.isconnected():
pass
print('Connection successful')
print(station.ifconfig())
gc.collect()
Данный код подключает ESP8266 к Wi-Fi сети.
Вместо звездочек необходимо указать имя Wi-Fi сети и пароль.
Далее в файл main.py записываем WEB-сервер.
try:
import usocket as socket
except ImportError:
import socket
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>My first web page</title>
</head>
<body>
<h1 style="text-align:center;">
Hello World
</h1>
</body>
</html>"""
return html
s = socket.socket(
socket.AF_INET,
socket.SOCK_STREAM
)
s.bind(('', 80))
s.listen(5)
while True:
conn, addr = s.accept()
print(
'Got a connection from %s'
% str(addr)
)
request = conn.recv(1024)
print(
'Content = %s'
% str(request)
)
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')
)
conn.close()
Для удобства работы с HTML-кодом мы создали функцию:
def web_page():
Внутри этой функции находится HTML-страница, которую ESP8266 передает браузеру.
Далее создаем сетевой сокет:
s = socket.socket(
socket.AF_INET,
socket.SOCK_STREAM
)
Первый параметр AF_INET означает использование IPv4.
Второй параметр SOCK_STREAM означает потоковый сокет TCP.
Далее связываем сокет с портом 80:
s.bind(('', 80))
Пустая строка означает, что сервер принимает соединения на доступном сетевом интерфейсе.
Далее переводим сокет в режим ожидания входящих соединений:
s.listen(5)
Команда:
conn, addr = s.accept()
ожидает подключение браузера и создает отдельное соединение для работы с клиентом.
HTTP-запрос браузера читаем командой:
request = conn.recv(1024)
После этого подготавливаем HTML-страницу:
response = web_page()
Отправляем браузеру HTTP-заголовок, а затем HTML-код:
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')
)
После передачи страницы закрываем соединение:
conn.close()
На экране WEB-браузера должно появиться: