Aprender

Un joystick de Arduino, leído y dibujado en ocho LEDs

Intermedio

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: gráfica de barras con joysticken vivo0.000 s 0.00x
Arrastra el stick u oprímelo para cambiar de ejes
El ejemplo de gráfica de barras en un ATmega328P simulado. Arrastra el stick para mover la barra y oprímelo para leer el otro eje.

El módulo de stick de cada kit de inicio, el KY-023 y sus clones, parece una pieza de control de videojuego y resulta ser dos potenciómetros y un botón bajo una sola tapa. Eso lo hace uno de los mejores componentes para aprender entrada analógica, porque puedes sentir cómo cambia el número al moverlo. El circuito de arriba es un Arduino Uno leyendo un eje de un stick y dibujándolo como una barra en ocho LEDs, ejecutándose ahora mismo en tu navegador con el mismo sketch que puedes leer abajo.

Arrastra la tapa negra en el lienzo y la barra la sigue. Suéltala y regresa al centro con cuatro lámparas encendidas. Presiona el stick hacia abajo y la barra cambia al otro eje, y el monitor serie dice cuál estás viendo.

Lo que necesitas

  • Un Arduino Uno
  • Un módulo joystick de dos ejes (KY-023 o similar)
  • Ocho LEDs: tres verdes, tres amarillos y dos rojos
  • Ocho resistencias de 220 ohm, una por LED
  • Una protoboard y cables jumper

Cableado

Componente y pinVa aNota
VCC del joystick5 VAlimenta ambas pistas del potenciómetro
GND del joystickGNDEl otro extremo de ambas pistas
VRX del joystickA0El cursor del eje X
VRY del joystickA1El cursor del eje Y
SW del joystickPin 12Se conecta a GND al presionarlo; la resistencia pull-up integrada lo mantiene en alto
Ocho LEDs, cada uno con 220 ohmPines 2 a 9De izquierda a derecha, cátodos a GND

Qué hay dentro de un módulo de joystick

Cada eje es un potenciómetro de 10 k con un extremo en VCC, el otro en GND y su cursor en VRX o VRY. Al inclinar la palanca el cursor se mueve, así que el pin ve un voltaje entre 0 y 5 volts: unos 2.5 volts en reposo, cerca de 0 en un extremo del recorrido y cerca de 5 en el otro. Es exactamente el divisor de voltaje que armarías con una perilla, solo que con un resorte que la regresa al centro.

El botón es aún más simple. Al presionar la tapa se cierra un interruptor de SW a tierra, y nada más. En la mayoría de los módulos no hay resistencia, así que el pin necesita una pull-up para leer HIGH cuando el botón no está presionado, y el Uno tiene una integrada que el sketch activa con INPUT_PULLUP. Presionado lee LOW.

Como los ejes son solo voltajes, el módulo también funciona en una placa de 3.3 volts. Aliméntalo con 3.3 V y la misma palanca lee de 0 a 3.3 volts. En un ESP32 el conversor es de doce bits, así que la escala completa va de 0 a 4095 en lugar de 0 a 1023.

Leerlo: analogRead y map

analogRead(A0) turns the voltage on the pin into a number from 0 to 1023, where 0 is 0 volts and 1023 is the 5 volt reference. A centered stick reads somewhere near 512. The sketch then uses map() to turn that 0 to 1023 range into a number of lamps from 0 to 8, and lights that many LEDs from the left. That really is the whole bar graph: the meter is one line of arithmetic, and the LEDs are only where the answer is written down.

map() puede devolver 8 con una lectura de exactamente 1023, que es uno más allá del último índice del arreglo, así que el sketch lo limita a 8 lámparas. También solo imprime en el monitor serie cuando cambia el número de lámparas, lo que mantiene el monitor legible en lugar de hacer scroll con cientos de líneas idénticas por segundo.

El ciclo, del ejemplo de la gráfica de barras
void loop() {
  if (stick.clicked()) {
    useY = !useY;
    Serial.println(useY ? "reading the Y axis" : "reading the X axis");
  }

  int raw = useY ? stick.y() : stick.x();
  int lit = (int)map(raw, 0, 1023, 0, LEDS);
  if (lit > LEDS) {
    lit = LEDS;
  }
  bar(lit);
  delay(40);
}

La función auxiliar, y la versión simple de Arduino

El ejemplo usa un header pequeño que viene con Mokxi, mokxi_joystick.h. No tiene nada de magia: x() y y() son analogRead en los dos pines de los ejes, pressed() es digitalRead en SW comparado con LOW, y clicked() es verdadero una vez por presión, en el flanco, para que mantener la palanca presionada no invierta el eje una y otra vez.

En un Uno real sin ese header, escribe las mismas tres cosas tú mismo: pinMode(12, INPUT_PULLUP) en setup(), analogRead(A0) y analogRead(A1) para los ejes, y recuerda el último estado del botón para actuar solo cuando pasa de HIGH a LOW. El resto del sketch es código Arduino estándar y corre sin cambios.

El header también tiene dx() y dy(), que miden desde donde estaba la palanca en reposo cuando se ejecutó begin() e ignoran una pequeña zona muerta a su alrededor. Úsalos para dirigir un juego o un robot, donde una palanca que reposa en 519 en lugar de 512 debe contar como quieta. La gráfica de barras usa la lectura cruda a propósito, porque debe quedar mitad encendida cuando la palanca está centrada.

Pruébalo en el editor

Abre el circuito y cambia LEDS y la lista de pines para usar solo cuatro lámparas. La barra ahora se mueve en pasos más grandes, porque map() divide el mismo rango en menos partes.

Luego haz un indicador de dirección en lugar de una barra: enciende solo la lámpara en la posición lit y no todas las lámparas por debajo. Es un cambio de un solo carácter en la función bar(), de i < lit a i == lit.

Por último, agrega un servomotor en el pin 10 y envíale map(raw, 0, 1023, 0, 180). La palanca ahora dirige un servomotor, que es el inicio de una base panorámica o un brazo robótico.

Errores comunes

Olvidar la pull-up en SW. Sin INPUT_PULLUP el pin del botón queda flotando y lee presiones aleatorias, a veces con solo tocar los cables.

Esperar exactamente 512 en reposo. Las palancas reales se asientan a unas cuentas del centro, y cada eje se asienta distinto. Mide la posición de reposo al inicio, o usa una zona muerta.

Intercambiar VRX y VRY, o descubrir que un eje funciona al revés. Ambos casos son normales: los módulos vienen montados en distintas orientaciones. Intercambia los pines en el código o invierte la lectura con 1023 - raw.

Sin resistencias en los LEDs. Cada LED necesita su propia resistencia de 220 ohm para mantener la corriente en un nivel seguro para el pin.

Abre este circuito en el editor. Arduino Uno: gráfica de barras con joystick, cableado como se ejecuta en la parte superior de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Cómo conecto un joystick a un Arduino?

VCC a 5 V, GND a GND, VRX y VRY a dos pines analógicos como A0 y A1, y SW a cualquier pin digital con la pull-up integrada activada. Lee los ejes con analogRead y el botón con digitalRead.

¿Qué valores da un joystick de Arduino?

En un Uno cada eje lee de 0 a 1023, con el centro cerca de 512. En una placa de 12 bits como un ESP32 lee de 0 a 4095. El botón lee LOW al presionarlo y HIGH al soltarlo.

¿Puedo usar un joystick con una Raspberry Pi Pico?

Sí, en sus pines ADC: GP26 y GP27 para los dos ejes, y cualquier otro pin para el botón. El conversor de la Pico está simulado, así que analogRead lee la palanca y el header del joystick compila para ella.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.