Aprender

Cablear botones de arcade a un Pro Micro o a un Pico

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Raspberry Pi Pico: un botón de arcade en GP15en vivo0.000 s 0.00x
Mantén presionado el botón
Mantén presionado el botón: la lámpara en GP14 y el LED propio del Pico se encienden mientras está presionado. Sin resistencia en el botón, solo la pull-up interna.

Un botón de arcade es un pulsador con un microinterruptor debajo. Cablearlo a un microcontrolador requiere dos cables y nada más: uno a tierra y otro a un pin. Esta página cubre los detalles que suelen confundir: qué pestañas usar, cómo llevar la tierra, qué pines elegir en un Pro Micro y un Pico, y cómo leer el botón en el código.

El circuito de arriba es un botón de arcade de 30 mm en una Raspberry Pi Pico en Mokxi. Presiona Ejecutar y mantén el botón: GP15 lo lee, y una lámpara en GP14 y el LED propio del Pico se encienden mientras está presionado. Los proyectos de fight stick y sin palanca enlazados abajo hacen lo mismo con un juego completo de botones en un Pro Micro.

Qué pestañas usar

El microinterruptor debajo de un botón suele tener dos o tres pestañas. Con dos, no hay nada que elegir. Con tres, son común, normalmente abierto y normalmente cerrado. Conecta común y normalmente abierto: ese par está abierto cuando el botón está arriba y cerrado mientras se presiona. La pestaña normalmente cerrada hace lo contrario, y un botón cableado a ella se lee como presionado todo el tiempo y suelto mientras lo presionas.

Las palancas funcionan igual. Una palanca son cuatro microinterruptores, uno por dirección, y muchas vienen con un arnés de cinco cables: una tierra compartida por los cuatro interruptores y un cable por cada dirección.

Una sola tierra para todo

Cada botón necesita un camino a tierra, pero no su propio cable de tierra de regreso a la placa. El método habitual es una cadena en serie: un cable que va de la lengüeta de tierra del primer botón al siguiente, y así sucesivamente, con un extremo conectado a un pin GND. La tierra de la palanca se une a la misma cadena. Así cada botón solo necesita un cable de señal propio.

Asegúrate de que la cadena realmente llegue a todos los botones. Un botón cuya lengüeta de tierra se haya pasado por alto es la falla más común en un stick nuevo, y parece un botón muerto o un pin dañado. En el simulador puedes quitar un cable de tierra y ver justo eso.

Pull-ups, no resistencias

Un pin sin nada que lo impulse queda flotando y lee valores aleatorios. La solución es un pull-up: una resistencia hacia la alimentación que mantiene el pin en HIGH hasta que el interruptor lo lleva a tierra. Tanto el ATmega32U4 del Pro Micro como el RP2040 del Pico tienen uno integrado en cada pin, que se activa con INPUT_PULLUP, así que el botón no necesita ninguna resistencia. Como resultado, la lógica queda invertida: un botón presionado lee LOW.

Ninguna de las dos placas necesita nada más para un botón. Los diodos solo se necesitan para una matriz de teclas, y un controlador no debería usar una matriz: dale a cada botón su propio pin para que se puedan mantener presionadas cualquier combinación a la vez.

Un botón, leído con el pull-up interno
const int BUTTON_PIN = 15;  // GP15 on a Pico, or any free pin

void setup() {
  pinMode(BUTTON_PIN, INPUT_PULLUP);
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  bool pressed = digitalRead(BUTTON_PIN) == LOW;
  digitalWrite(LED_BUILTIN, pressed ? HIGH : LOW);
}

Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.

Pines en un Pro Micro

El Pro Micro modelado en Mokxi expone 18 pines de entrada y salida: digitales 0 a 10, 14, 15 y 16, y A0 a A3, que también funcionan como pines digitales. Cualquiera de ellos puede leer un botón. Los pines 0 y 1 son el puerto serie de hardware, pero un sketch que se comunica por USB los deja libres, y el ejemplo del fight stick los usa para dos botones. No hay LED en el pin 13; las lámparas RX y TX se encienden cuando su pin está en LOW.

El proyecto de fight stick pone la palanca en los pines 2 a 5 y los botones en 6 a 9, 1 y 0. El proyecto leverless usa 2 a 7 para los botones, 8 para un interruptor de modo y A0 a A3 para los LED.

Pines en una Pico

Una Raspberry Pi Pico tiene 26 pines GPIO en sus headers, de sobra para una disposición leverless completa con espacio para iluminación. Cualquier GPIO puede leer un botón con su pull-up activado. Planea la disposición para que cada tendido de cable dentro del gabinete sea corto y ordenado, y lleva un mapa escrito de qué botón está en qué número GP, porque el firmware o el sketch lo necesita.

En Mokxi, la Pico ejecuta sketches de Arduino con digitalRead, INPUT_PULLUP e interrupciones en cada pin. No modela el USB de la Pico, sus bloques PIO ni su ADC, así que puedes probar el cableado y la lógica de los botones, pero no un reporte USB ni una iluminación controlada por PIO.

Botones iluminados

Muchos botones de arcade aceptan un LED, y muchas construcciones usan en cambio LED direccionables WS2812, uno o dos debajo de cada botón en un solo cable de datos. En una Pico real el tiempo de las WS2812 suele venir del PIO; en un 32U4 viene de código de biblioteca cuidadosamente cronometrado. En Mokxi, las tiras WS2812 funcionan desde la ESP32-C3 y la C6, así que el proyecto de iluminación está en una C3, con cuatro botones de arcade que encienden cada uno su propio par de LED.

Revisa antes de soldar

Cablea el circuito en el simulador tal como piensas cablear el gabinete, y ejecuta un sketch que imprima cada botón cuando cambie. Si cada botón imprime su propio nombre en el pin correcto, el arnés está bien. Lo que el simulador no puede revisar es la parte física: la calidad de los terminales, una conexión rápida floja o un interruptor desgastado. Un multímetro en modo de continuidad los encuentra en un minuto.

Abre este circuito en el editor. Raspberry Pi Pico: un botón de arcade en GP15, cableado como funciona al principio de esta página. Cambia un componente o un valor y vuelve a ejecutarlo.

Abrir el circuito

Preguntas

¿Qué lengüetas del botón de arcade conecto?

Común y normalmente abierto. Deja vacía la lengüeta normalmente cerrada, o el botón se lee al revés.

¿Necesito resistencias para los botones de arcade?

No. Activa el pull-up interno del pin con INPUT_PULLUP. El pin lee HIGH cuando el botón está suelto y LOW cuando se presiona.

¿Pueden todos los botones compartir un solo cable de tierra?

Sí. Encadena en serie las lengüetas de tierra de botón en botón y lleva un extremo a un pin GND. La tierra de la palanca se une a la misma cadena.

¿Mokxi simula la Pico como controlador USB?

No. Mokxi ejecuta sketches de Arduino en su modelo de Pico pero no modela el USB de la Pico, así que pruebas el cableado y el código, no el reporte USB.

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