📡 Проект: веб-панель положения джойстика KY-023 через ESP8266

В других проектах на сайте джойстик KY-023 управляет цветом светодиода или включает реле резким отклонением. Здесь он подключён к ESP8266, которая просто отдаёт текущие значения обеих осей как веб-страницу — панель наблюдения за положением рукоятки, без какого-либо управления чем-либо дальше.

Как это работает

Считывание осей такое же, как и в остальных проектах с этим джойстиком: два потенциометра на одной рукоятке читаются через `analogRead()` как числа от 0 до 1023 по каждой оси X и Y. Разница — в том, что происходит с этими числами: вместо пересчёта в цвет светодиода или сравнения с порогом для реле ESP8266 просто подставляет оба текущих значения в HTML-страницу по каждому запросу браузера.

Такая простая панель полезна прежде всего для отладки — перед тем, как решать, какие пороги задавать в более сложном проекте (например, в проекте с реле, срабатывающим по отклонению), удобно сначала посмотреть на реальные числа в покое и в крайних положениях именно вашего экземпляра джойстика.

Пошаговая сборка

Так как реализации данного модуля бывают разные, если у вас на плате нет тех контактов, которые указаны ниже — сориентируйтесь по названиям контактов на своей плате.

KY-023: VRx → A0, VRy → A1 ESP8266, VCC → 5V или 3.3V по маркировке платы, GND → GND.

Скетч

// ВНИМАНИЕ: рекомендую отладить код через монитор порта, так как я языковая
// модель, а не специализированный кодер, и могу что-то упустить. Основу
// и идею я накидал, но проверьте под свою схему.

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

const char* WIFI_SSID = "ваша_сеть";
const char* WIFI_PASSWORD = "ваш_пароль";

ESP8266WebServer server(80);
const int X_PIN = A0;
const int Y_PIN = A1;

void handleRoot() {
  int xValue = analogRead(X_PIN);
  int yValue = analogRead(Y_PIN);

  String html = "<html><body><h1>Джойстик</h1>";
  html += "<p>X: " + String(xValue) + "</p>";
  html += "<p>Y: " + String(yValue) + "</p>";
  html += "</body></html>";

  server.send(200, "text/html", html);
}

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

  WiFi.begin(WIFI_SSID, WIFI_PASSWORD);
  while (WiFi.status() != WL_CONNECTED) {
    delay(500);
  }
  Serial.println("IP адрес: " + WiFi.localIP().toString());

  server.on("/", handleRoot);
  server.begin();
}

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

Библиотеки ESP8266WiFi и ESP8266WebServer входят в стандартный пакет поддержки ESP8266 для Arduino IDE. На ESP8266 обычно доступен только один аналоговый вход (A0) — если у вашей платы действительно только один аналоговый пин, читать вторую ось придётся через внешний аналого-цифровой мультиплексор или отдельный модуль АЦП, уточните по маркировке именно вашей платы.

Частые проблемы

Страница не открывается — убедитесь, что устройство в той же WiFi-сети, что и ESP8266, используйте точный IP-адрес.
Доступен только один аналоговый пин на плате — многие варианты ESP8266 физически имеют только один аналоговый вход; в этом случае подключите только одну ось или используйте внешний АЦП для второй.
Значения в покое не около 512 — у многих экземпляров джойстика центр заметно смещён, это нормально; используйте реальные значения из монитора порта как точку отсчёта.
Числа на странице не меняются — обновите страницу (F5) для нового запроса, значения считаются именно в момент обращения.

Как улучшить проект

Добавить автоматическое обновление страницы вместо ручного F5.
Отдавать данные в формате JSON вместо HTML, если нужна интеграция с другой системой, а не чтение человеком.
Объединить с идеей проекта включения реле — сначала откалибровать пороги через эту панель, затем перенести готовые значения в проект с автоматикой.