Подключение джойстика KY-023 к ESP32

Аналоговый джойстик с кнопкой

Джойстик KY-023 к ESP32 — питание 3,3 В, земля, VRX и VRY на два входа АЦП и SW на цифровой вывод с INPUT_PULLUP.

Схема подключения джойстика KY-023 к ESP32

Джойстик KY-023ESP32
SWGPIO25
VRXGPIO34
VRYGPIO35
VCC3V3
GNDGND

Схема из примера «Джойстик KY-023: две оси и кнопка».

Джойстик KY-023: две оси и кнопка

Открыть пример целиком

Выводы Джойстик KY-023

ВыводНазначение
SWкнопка: замыкает вывод на землю
VRXось X: напряжение от 0 до питания
VRYось Y: напряжение от 0 до питания
VCCпитание потенциометров
GNDобщий провод

Код для ESP32

// Джойстик: две оси на АЦП и кнопка.
//
// В центре ручки АЦП показывает примерно половину шкалы, но «примерно»
// у каждого экземпляра своё. Поэтому вокруг центра оставляем мёртвую
// зону: пока ручка в ней, направление не меняется.
//
// Кнопка замыкает SW на землю, а подтяжка внутренняя — INPUT_PULLUP.
//
// В симуляторе потяните ручку мышью; кружок SW — кнопка.

const int AXIS_X = 34;
const int AXIS_Y = 35;
const int BUTTON_PIN = 25;

const int JOY_CENTER = 2048;
const int DEAD_ZONE = 400;   // мёртвая зона в отсчётах АЦП

void setup() {
  Serial.begin(115200);
  pinMode(BUTTON_PIN, INPUT_PULLUP);
}

const char* direction(int x, int y) {
  int dx = x - JOY_CENTER, dy = y - JOY_CENTER;
  if (abs(dx) < DEAD_ZONE && abs(dy) < DEAD_ZONE) return "центр";
  if (abs(dx) >= abs(dy)) return dx > 0 ? "вправо" : "влево";
  return dy > 0 ? "вниз" : "вверх";
}

void loop() {
  int x = analogRead(AXIS_X);
  int y = analogRead(AXIS_Y);
  bool pressed = digitalRead(BUTTON_PIN) == LOW;

  Serial.printf("x=%d y=%d  %s%s\n", x, y, direction(x, y), pressed ? "  [кнопка]" : "");
  delay(200);
}

Скетч можно править и запускать в симуляторе без платы и установки среды.

Что учесть на ESP32

В железе

Выход осей не превышает напряжение питания модуля, поэтому с ESP32 его питают от 3,3 В. Направление осей зависит от того, как модуль повернут: «вверх» и «вправо» определяет установка, а не маркировка выводов.

Частые ошибки при подключении к ESP32

Другие детали для ESP32