Управляем светодиодами с WEB-страницы на ESP8266 и ESP32

В данном уроке добавим к предыдущему примеру возможность управлять двумя светодиодами непосредственно с WEB-страницы.

На странице будут две кнопки управления. При нажатии на кнопку браузер отправляет запрос микроконтроллеру, после чего ESP8266 или ESP32 изменяет состояние соответствующего выхода и возвращает браузеру новое состояние светодиода.

Передача команд выполняется с помощью JavaScript и AJAX, поэтому для переключения светодиода не требуется полностью перезагружать WEB-страницу.

В исходном примере также используется счетчик переключений. При каждом изменении состояния одного из светодиодов значение счетчика увеличивается на единицу. Отдельная кнопка позволяет обнулить счетчик.

HTML и JavaScript часть можно сначала проверить в Visual Studio Code, после чего разместить ее внутри программы микроконтроллера.

Полный программный код

#ifdef ESP8266

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>

ESP8266WebServer server(80);

const uint8_t LEDGpin = D7;
const uint8_t LEDRpin = D8;


#elif defined(ESP32)

#include <WiFi.h>
#include <WebServer.h>

WebServer server(80);

const uint8_t LEDGpin = 26;
const uint8_t LEDRpin = 25;


#else

#error "This program supports ESP8266 or ESP32 only"

#endif



const char *ssidAP = "myesp8266";
const char *passwordAP = "12345678";


IPAddress local_ip(
  192,
  168,
  2,
  1
);

IPAddress gateway(
  192,
  168,
  2,
  1
);

IPAddress subnet(
  255,
  255,
  255,
  0
);



bool LEDR = false;
bool LEDG = false;


uint32_t counter = 0;



String startHTML();



void handleRoot()
{
  server.send(
    200,
    "text/html; charset=UTF-8",
    startHTML()
  );
}



void LEDGfunct()
{
  LEDG = !LEDG;


  digitalWrite(
    LEDGpin,
    LEDG ? HIGH : LOW
  );


  counter++;


  server.send(
    200,
    "text/plain",
    LEDG ? "ON" : "OFF"
  );
}



void LEDRfunct()
{
  LEDR = !LEDR;


  digitalWrite(
    LEDRpin,
    LEDR ? HIGH : LOW
  );


  counter++;


  server.send(
    200,
    "text/plain",
    LEDR ? "ON" : "OFF"
  );
}



void zeroFunct()
{
  counter = 0;


  server.send(
    200,
    "text/plain",
    String(counter)
  );
}



void countFunct()
{
  server.send(
    200,
    "text/plain",
    String(counter)
  );
}



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


  pinMode(
    LEDGpin,
    OUTPUT
  );


  pinMode(
    LEDRpin,
    OUTPUT
  );


  digitalWrite(
    LEDGpin,
    LOW
  );


  digitalWrite(
    LEDRpin,
    LOW
  );


  WiFi.mode(
    WIFI_AP
  );


  WiFi.softAPConfig(
    local_ip,
    gateway,
    subnet
  );


  WiFi.softAP(
    ssidAP,
    passwordAP
  );


  Serial.println();


  Serial.print(
    "Soft-AP IP address = "
  );


  Serial.println(
    WiFi.softAPIP()
  );


  server.on(
    "/",
    handleRoot
  );


  server.on(
    "/LEDGurl",
    LEDGfunct
  );


  server.on(
    "/LEDRurl",
    LEDRfunct
  );


  server.on(
    "/zeroUrl",
    zeroFunct
  );


  server.on(
    "/countUrl",
    countFunct
  );


  server.begin();


  Serial.println(
    "HTTP server started"
  );
}



void loop()
{
  server.handleClient();
}



String startHTML()
{
  return R"=====(
<!DOCTYPE html>

<html lang="en">


<head>

  <meta charset="UTF-8">

  <meta
    name="viewport"
    content="width=device-width, initial-scale=1.0"
  >


  <title>
    ESP8266 local network
  </title>


  <style>

    body {
      margin-top: 50px;
      font-family: Arial;
      font-size: 20px;
      text-align: center;
    }


    .btn {
      display: block;

      width: 280px;

      margin: 10px auto;

      padding: 30px;

      border: none;

      font-size: 24px;

      color: black;

      cursor: pointer;
    }


    .on {
      background-color: SkyBlue;
    }


    .off {
      background-color: LightSteelBlue;
    }


    .zero {
      background-color: Thistle;
    }


    table {
      width: 100%;
    }


    td {
      width: 50%;

      font-size: 25px;

      padding: 10px;
    }


    p {
      font-size: 25px;

      margin-top: 40px;
    }


    @media (max-width: 650px) {

      td {
        display: block;

        width: 100%;
      }


      .btn {
        width: 90%;

        max-width: 280px;
      }
    }

  </style>


</head>



<body>


  <h1>
    ESP8266 local area network
  </h1>



  <table>

    <tr>

      <td>

        Green LED is

        <span id="LEDG">
          OFF
        </span>

        now

      </td>


      <td>

        Red LED is

        <span id="LEDR">
          OFF
        </span>

        now

      </td>

    </tr>

  </table>



  <table>

    <tr>

      <td>

        <button
          class="btn off"
          id="greenButton"
          onclick="sendData('green')"
        >

          Press to turn Green LED ON

        </button>

      </td>


      <td>

        <button
          class="btn off"
          id="redButton"
          onclick="sendData('red')"
        >

          Press to turn Red LED ON

        </button>

      </td>

    </tr>

  </table>



  <p>

    Counter is

    <span id="counter">
      0
    </span>

    now

  </p>



  <button
    class="btn zero"
    onclick="sendData('zero')"
  >

    Press to zero counter

  </button>



  <script>


    function sendData(target)
    {
      let url = "";

      let variable = "";

      let buttonId = "";

      let ledName = "";


      if (target === "red")
      {
        url = "/LEDRurl";

        variable = "LEDR";

        buttonId = "redButton";

        ledName = "Red LED";
      }


      else if (target === "green")
      {
        url = "/LEDGurl";

        variable = "LEDG";

        buttonId = "greenButton";

        ledName = "Green LED";
      }


      else if (target === "zero")
      {
        url = "/zeroUrl";

        variable = "counter";
      }



      const xhr =
        new XMLHttpRequest();


      xhr.onreadystatechange =
        function()
        {
          if (
            this.readyState === 4 &&
            this.status === 200
          )
          {

            document.getElementById(
              variable
            ).textContent =
              this.responseText;



            if (
              target === "red" ||
              target === "green"
            )
            {

              const state =
                this.responseText.trim();


              const button =
                document.getElementById(
                  buttonId
                );


              if (state === "ON")
              {
                button.className =
                  "btn on";


                button.textContent =
                  "Press to turn " +
                  ledName +
                  " OFF";
              }


              else
              {
                button.className =
                  "btn off";


                button.textContent =
                  "Press to turn " +
                  ledName +
                  " ON";
              }

            }

          }
        };


      xhr.open(
        "GET",
        url,
        true
      );


      xhr.send();
    }



    function reloadCounter()
    {
      const xhr =
        new XMLHttpRequest();


      xhr.onreadystatechange =
        function()
        {
          if (
            this.readyState === 4 &&
            this.status === 200
          )
          {
            document.getElementById(
              "counter"
            ).textContent =
              this.responseText;
          }
        };


      xhr.open(
        "GET",
        "/countUrl",
        true
      );


      xhr.send();
    }



    setInterval(
      reloadCounter,
      1000
    );


  </script>


</body>


</html>
)=====";
}

Основные части программы

Выбор ESP8266 или ESP32

В начале программы используется условная компиляция. В зависимости от выбранной в Arduino IDE платы подключается библиотека для ESP8266 или ESP32 и задаются соответствующие выводы светодиодов.

#ifdef ESP8266

#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>

ESP8266WebServer server(80);


#elif defined(ESP32)

#include <WiFi.h>
#include <WebServer.h>

WebServer server(80);

#endif

Благодаря этому один и тот же пример можно использовать как для ESP8266, так и для ESP32.

Создание точки доступа Wi-Fi

Микроконтроллер работает в режиме точки доступа. Имя сети и пароль задаются здесь:

const char *ssidAP = "myesp8266";
const char *passwordAP = "12345678";

IP-адрес точки доступа задаем вручную:

IPAddress local_ip(
  192,
  168,
  2,
  1
);

После подключения телефона или компьютера к сети myesp8266 WEB-страница будет доступна по адресу 192.168.2.1.

Обработчики WEB-запросов

Для каждой команды создается свой адрес.

server.on(
  "/",
  handleRoot
);

server.on(
  "/LEDGurl",
  LEDGfunct
);

server.on(
  "/LEDRurl",
  LEDRfunct
);

server.on(
  "/zeroUrl",
  zeroFunct
);

server.on(
  "/countUrl",
  countFunct
);

При обращении к корневому адресу / микроконтроллер отправляет браузеру всю WEB-страницу.

Адреса /LEDGurl и /LEDRurl используются для управления светодиодами.

Переключение светодиода

При получении команды состояние светодиода инвертируется:

LEDG = !LEDG;

После этого новое состояние устанавливается на выводе:

digitalWrite(
  LEDGpin,
  LEDG ? HIGH : LOW
);

Каждое переключение увеличивает счетчик:

counter++;

После выполнения команды микроконтроллер возвращает браузеру состояние светодиода:

server.send(
  200,
  "text/plain",
  LEDG ? "ON" : "OFF"
);

AJAX-запрос с WEB-страницы

При нажатии кнопки JavaScript создает HTTP-запрос к микроконтроллеру:

xhr.open(
  "GET",
  url,
  true
);

xhr.send();

После получения ответа JavaScript изменяет надпись ON/OFF и текст соответствующей кнопки. Полностью перезагружать страницу при этом не требуется.

Счетчик переключений

Значение счетчика браузер запрашивает автоматически один раз в секунду:

setInterval(
  reloadCounter,
  1000
);

По адресу /countUrl микроконтроллер возвращает текущее значение переменной counter.

При нажатии кнопки обнуления выполняется запрос /zeroUrl, после чего значение счетчика устанавливается в ноль.