Создаем кнопки управления светодиодом на 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>


            &nbsp;


            <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>"
    "&nbsp;"
    "<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.