Aprender

Fight stick casero con un Arduino Pro Micro

Intermedio

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Pro Micro: una palanca y seis botonesen vivo0.000 s 0.00x
Presiona Ejecutar y usa las flechas del teclado
Las flechas mueven la palanca, Z y X son los botones 5 y 6, y los botones de arcade son clics. Observa el monitor serie.

Un fight stick es una de las cosas más satisfactorias que puedes construir con un microcontrolador. La electrónica es simple: una palanca que son cuatro interruptores, una fila de botones de arcade que son un interruptor cada uno, y una placa pequeña que los lee y le dice a la consola o a la PC qué está presionado. El Pro Micro es el favorito para esto porque su ATmega32U4 tiene USB integrado en el chip, así que la misma placa que lee tus botones puede aparecer en la computadora como un control de videojuegos.

El circuito de arriba es un stick en un Pro Micro en Mokxi: una palanca de cuatro direcciones en los pines 2 a 5, cuatro botones de arcade en los pines 6 a 9, y dos botones más en los pines 1 y 0. Presiona Ejecutar, mueve la palanca con las flechas y haz clic en los botones. El monitor serie imprime la dirección en notación de teclado numérico y los botones presionados, una línea cada vez que algo cambia.

Una cosa de entrada, porque importa: Mokxi no simula la parte del controlador USB de juego. El Pro Micro simulado modela su USB como una conexión serie hacia el monitor serie y nada más, así que el sketch imprime el reporte que enviaría en lugar de enviarlo. Lo que puedes probar aquí es todo lo anterior a ese punto: el cableado, las pull-up, el antirrebote, la lógica de dirección y el mapa de botones. Cuando eso está bien, grabas la misma lógica en una placa real y agregas la biblioteca USB en el banco de trabajo.

Por qué un Pro Micro

La mayoría de las placas Arduino se comunican con la computadora mediante un chip aparte de USB a serie, así que para la PC siempre son un puerto serie. El ATmega32U4 del Pro Micro, el Leonardo y el Micro es distinto: el dispositivo USB está en el propio chip, y el sketch decide qué es la placa. Por eso la biblioteca Keyboard de Arduino y la biblioteca comunitaria Arduino Joystick funcionan en estas placas y no en un Uno. La propia documentación de la biblioteca Joystick dice que necesita una placa basada en un 32U4 y que no funcionará en un Uno ni en un Mega.

The Pro Micro also has enough pins. The one Mokxi models, the 5 volt, 16 MHz SparkFun board, brings out 18 input and output pins, and a stick needs four for the lever and one per button. Eight buttons plus a lever is twelve pins, with room left for a start or select button and a mode switch.

Tiene una sorpresa para los recién llegados: no hay LED en el pin 13. Las dos luces de la placa son las de RX y TX, y se encienden cuando su pin pasa a LOW. El sketch de ejemplo usa la luz RX para indicar que un botón está presionado, así que hay retroalimentación en la propia placa.

Cableado de la palanca y los botones

Todos los interruptores de un stick se conectan igual. Una pata va a tierra, la otra a un pin, y la pull-up interna del pin lo mantiene en HIGH hasta que el interruptor lo baja a LOW. Así, un botón presionado se lee como LOW, y no hacen falta resistencias en ninguna parte. En un gabinete real las tierras suelen ser un solo cable encadenado de botón en botón, y esa única cadena regresa a un pin GND de la placa.

Una palanca son cuatro microinterruptores, uno por dirección, alrededor de un eje. Muchas palancas vienen con un mazo de cinco cables: una tierra y un cable para arriba, abajo, izquierda y derecha. Este ejemplo usa el D-pad del pad de consola en su lugar, que trae dos botones extra; su ajuste de tipo balancín está activado, lo que se comporta como la guía de una palanca. La plantilla de fight stick para Pico usa en cambio el componente de palanca estilo Sanwa de Mokxi, con su mazo de cinco pines y todo.

Los microinterruptores de los botones de arcade suelen tener tres lengüetas: común, normalmente abierto y normalmente cerrado. Usa común y normalmente abierto. La lengüeta de normalmente cerrado está cerrada cuando el botón está suelto, lo que se lee al revés con una pull-up. La página sobre pull-up explica por qué el pin necesita una.

Antirrebote sin agregar retardo

Los contactos metálicos rebotan. Cuando un interruptor se cierra, se abre y se cierra unas cuantas veces durante los primeros milisegundos antes de asentarse. Un sketch que lee con suficiente rapidez ve cada uno de esos flancos como una pulsación aparte. Los botones de arcade del ejemplo tienen su ajuste de rebote activado, para que puedas verlo pasar.

El antirrebote habitual de Arduino espera a que un pin se mantenga estable un rato antes de creerle. Eso funciona, pero en un controlador suma esa espera a cada pulsación. El ejemplo lo hace al revés: un cambio cuenta en el momento en que llega, y la entrada luego ignora su pin durante un breve bloqueo, 5 milisegundos en el sketch. El rebote cae dentro del bloqueo y se descarta, y la pulsación en sí no se retrasa nada.

Lo probamos de ambas maneras en el stick simulado. Con el bloqueo en cero, una pulsación y soltada de un botón con rebote imprimió seis líneas: pulsación, soltada, pulsación, y lo mismo otra vez al soltar. Con el bloqueo en 5 milisegundos imprimió dos, y la pulsación se reportó en el mismo milisegundo que antes. El firmware de gamepad GP2040-CE tiene un ajuste de antirrebote por la misma razón.

El bloqueo, del sketch de ejemplo
bool down = digitalRead(PINS[i]) == LOW;
if (down != held[i] && now - changedAt[i] >= LOCK_MS) {
  held[i] = down;       // accept the change at once
  changedAt[i] = now;   // then ignore this pin for LOCK_MS
}

Notación de numpad y una dirección limpia

Los jugadores de juegos de pelea escriben las direcciones como los dígitos del teclado numérico: 5 es neutral, 6 es adelante para un personaje mirando a la derecha, 2 es abajo, 3 es abajo y adelante, 8 es arriba, y así. El ejemplo reporta la palanca de la misma manera, lo que hace legible el monitor serie para cualquiera que haya leído una lista de combos.

El sketch convierte los cuatro interruptores en dos ejes, izquierda menos derecha y arriba menos abajo, y la dirección es 5 más el eje horizontal más tres veces el vertical. Si alguna vez se cierran juntos los dos interruptores de un par, el eje da cero, así que la dirección regresa a neutral. El marco de una palanca no puede producir ese estado, pero un controlador sin palanca sí, y la página sobre limpieza SOCD cubre las reglas para eso.

Del simulador a un stick real

Cuando el monitor serie muestre la dirección y los botones correctos para cada entrada, la lógica está lista. Luego entrega el mismo estado a una biblioteca HID donde el ejemplo llama a report(). Mokxi incluye la API de la biblioteca Arduino Joystick como Joystick.h, y Keyboard.h, para el Pro Micro, el Leonardo y el Micro: una llamada a setButton() por botón y un hat switch o dos ejes para la palanca, seguido de sendState(). En el simulador cada reporte es una línea [Joystick] en el monitor serie; grabado en una placa real, el mismo sketch es un controlador USB de juego.

Ese último paso es el único que Mokxi no puede verificar por ti: si la consola o la PC acepta la placa, y qué modo de entrada espera, depende de la biblioteca y del anfitrión. Muchos constructores se saltan escribir firmware y de plano graban firmware de gamepad ya hecho. En cualquier caso, el cableado que comprobaste aquí es el cableado que sueldas.

Abre este circuito en el editor. Pro Micro: una palanca y seis botones, conectados como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿Un Arduino Uno puede ser un stick de pelea?

No directamente. El chip principal del Uno no tiene USB propio, así que las bibliotecas Keyboard y Joystick no corren en él. Usa una placa con ATmega32U4, como un Pro Micro, Leonardo o Micro, o una placa RP2040 como una Pico.

¿Los botones de arcade necesitan resistencias?

No. Conecta una pata a tierra y la otra a un pin con INPUT_PULLUP. La pull-up interna del chip mantiene el pin en HIGH, y una pulsación lo baja a LOW.

¿Mokxi simula el controlador USB?

No. El Pro Micro simulado modela su USB solo como una conexión serie, así que el ejemplo imprime su reporte en el monitor serie. Aquí pruebas el cableado y la lógica, y luego agregas la biblioteca USB y grabas una placa real.

¿Cuánto debe durar el antirrebote?

Lo suficiente para cubrir el rebote de tus interruptores y nada más. El ejemplo usa un bloqueo de 5 milisegundos que empieza después de aceptar la pulsación, así que no la retrasa.

Á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.