Подготавливаем среду программирования 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-браузера должно появиться: