Джойстик KY-023: подключение к ESP32 и Arduino

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

Два потенциометра по осям X и Y плюс кнопка в оси ручки. Оси читаются аналоговыми входами, кнопка — цифровым.

Как работает

В джойстике два потенциометра, повёрнутых друг к другу под прямым углом. Ручка отклоняется, и напряжение на VRX и VRY меняется от 0 до напряжения питания; в центре оно примерно половина. Кнопка SW замыкается при нажатии на ручку.

Центр у каждого экземпляра немного свой, поэтому вокруг него оставляют мёртвую зону: пока значение в ней, направление не меняют. Кнопка замыкает SW на землю, поэтому ей нужна подтяжка: INPUT_PULLUP.

Выводы

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

Подключение к ESP32

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

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

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

Открыть пример целиком
Код скетча
// Джойстик: две оси на АЦП и кнопка.
//
// В центре ручки АЦП показывает примерно половину шкалы, но «примерно»
// у каждого экземпляра своё. Поэтому вокруг центра оставляем мёртвую
// зону: пока ручка в ней, направление не меняется.
//
// Кнопка замыкает 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);
}

Подключение к Arduino Uno

Джойстик KY-023Arduino Uno
SWD2
VRXA0
VRYA1
VCC5V
GNDGND

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

Arduino Uno: джойстик KY-023

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

const int AXIS_X = A0;
const int AXIS_Y = A1;
const int BUTTON_PIN = 2;

const int JOY_CENTER = 512;
const int DEAD_ZONE = 100;

void setup() {
  Serial.begin(9600);
  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.print("x=");
  Serial.print(x);
  Serial.print(" y=");
  Serial.print(y);
  Serial.print(" ");
  Serial.print(direction(x, y));
  if (pressed) Serial.print(" [кнопка]");
  Serial.println();
  delay(200);
}

В железе

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

Частые ошибки

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