Aprender

Fight stick DIY com Arduino Pro Micro

Intermediário

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Pro Micro: uma alavanca e seis botõesao vivo0.000 s 0.00x
Aperte Rodar e use as setas do teclado
As setas controlam a alavanca, Z e X são os botões 5 e 6, e os botões de fliperama são cliques. Observe o Monitor Serial.

Um fight stick é uma das coisas mais gratificantes de construir com um microcontrolador. A eletrônica é simples: uma alavanca que são quatro chaves, uma fileira de botões de fliperama com uma chave cada, e uma pequena placa que os lê e diz ao console ou PC o que está pressionado. O Pro Micro é um favorito para isso porque seu ATmega32U4 tem USB embutida no chip, então a mesma placa que lê seus botões pode aparecer no computador como um controle de videogame.

O circuito acima é um stick num Pro Micro no Mokxi: uma alavanca de quatro direções nos pinos 2 a 5, quatro botões de fliperama nos pinos 6 a 9, e mais dois botões nos pinos 1 e 0. Aperte Rodar, mova a alavanca com as setas e clique nos botões. O Monitor Serial imprime a direção em notação de teclado numérico e os botões pressionados, uma linha a cada mudança.

Uma coisa antes de tudo, porque é importante: o Mokxi não simula a parte do controle de jogo USB. O Pro Micro simulado modela seu USB como uma conexão serial com o Monitor Serial e nada mais, então o sketch imprime o relatório que ele enviaria em vez de enviá-lo. O que você pode testar aqui é tudo que vem antes disso: a ligação, os pull-ups, o debounce, a lógica de direção e o mapa de botões. Quando isso estiver certo, você grava a mesma lógica em uma placa real e adiciona a biblioteca USB na bancada.

Por que um Pro Micro

A maioria das placas Arduino conversa com o computador por meio de um chip separado de USB para serial, então, para o PC, elas são sempre uma porta serial. O ATmega32U4 do Pro Micro, do Leonardo e do Micro é diferente: o dispositivo USB está no próprio chip, e o sketch decide o que a placa é. É por isso que a biblioteca Arduino Keyboard e a biblioteca Arduino Joystick da comunidade funcionam nessas placas e não em um Uno. A própria documentação da biblioteca Joystick diz que ela precisa de uma placa baseada no 32U4 e não funciona em um Uno ou em um 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.

Ele tem uma surpresa para quem está chegando agora: não há LED no pino 13. As duas luzes na placa são as de RX e TX, e elas acendem quando o pino delas vai para LOW. O sketch de exemplo usa a luz de RX para mostrar que um botão está pressionado, então há retorno na própria placa.

Ligando a alavanca e os botões

Todo interruptor de um arcade stick é ligado do mesmo jeito. Um terminal vai para o terra, o outro vai para um pino, e o pull-up interno do pino mantém o nível HIGH até o interruptor puxá-lo para LOW. Assim, um botão pressionado lê LOW, e não são necessários resistores em lugar nenhum. Em um caso real, os terras costumam ser um único fio encadeado de botão em botão, e essa única cadeia volta a um pino GND da placa.

Uma alavanca é feita de quatro microinterruptores, um por direção, ao redor de um eixo. Muitas alavancas vêm com um chicote de cinco fios: um terra e um fio para cada uma das direções: cima, baixo, esquerda e direita. Este exemplo usa o D-pad do pad de console no lugar dela, o que traz dois botões extras; a configuração de balanço dele está ativada, o que se comporta como a placa-guia de uma alavanca. O modelo de arcade stick para Pico usa o componente de alavanca estilo Sanwa do Mokxi, com direito ao chicote de cinco pinos.

Os microinterruptores de botões de fliperama costumam ter três abas: comum, normalmente aberto e normalmente fechado. Use comum e normalmente aberto. A aba normalmente fechado fica fechada quando o botão está solto, o que lê ao contrário com um pull-up. A página sobre pull-up explica por que o pino precisa de um.

Debounce sem adicionar atraso

Contatos de metal oscilam. Quando um interruptor fecha, ele abre e fecha mais algumas vezes nos primeiros milissegundos antes de estabilizar. Um sketch que lê rápido o bastante enxerga cada uma dessas bordas como um toque separado. Os botões de fliperama do exemplo têm a configuração de bounce ativada, então você pode ver isso acontecer.

O debounce usual do Arduino espera o pino ficar estável por um tempo antes de acreditar nele. Isso funciona, mas em um controle adiciona a espera a cada toque. O exemplo faz o contrário: uma mudança conta no momento em que chega, e a entrada então ignora seu pino por um breve bloqueio, 5 milissegundos no sketch. A oscilação cai dentro do bloqueio e é descartada, e o toque em si não é atrasado nem um pouco.

Rodamos dos dois jeitos no arcade stick simulado. Com o bloqueio em zero, um toque e soltura de um botão que oscila imprimiu seis linhas: toque, soltura, toque, e o mesmo de novo na volta. Com o bloqueio em 5 milissegundos imprimiu duas, e o toque foi reportado no mesmo milissegundo de antes. Firmwares de gamepad como o GP2040-CE têm uma configuração de debounce pelo mesmo motivo.

O bloqueio, do sketch de exemplo
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
}

Notação de numpad e uma direção limpa

Jogadores de jogos de luta escrevem direções como os dígitos do teclado numérico: 5 é neutro, 6 é para frente para um personagem virado para a direita, 2 é para baixo, 3 é para baixo e frente, 8 é para cima, e assim por diante. O exemplo reporta a alavanca do mesmo jeito, o que deixa o Monitor Serial legível para qualquer um que já tenha lido uma lista de combos.

O sketch transforma os quatro interruptores em dois eixos, esquerda menos direita e cima menos baixo, e a direção é 5 mais o eixo horizontal mais três vezes o vertical. Se os dois interruptores de um par fecharem juntos, o eixo resulta em zero, então a direção volta ao neutro. A placa-guia de uma alavanca não consegue produzir esse estado, mas um controle sem alavanca consegue, e a página sobre limpeza SOCD cobre as regras para isso.

Do simulador para um arcade stick de verdade

Quando o Monitor Serial mostrar a direção e os botões certos para cada entrada, a lógica está pronta. Depois, passe o mesmo estado para uma biblioteca HID onde o exemplo chama report(). O Mokxi inclui a API da biblioteca Arduino Joystick como Joystick.h, e Keyboard.h, para o Pro Micro, Leonardo e Micro: uma chamada de setButton() por botão e um hat switch ou dois eixos para a alavanca, seguidos de sendState(). No simulador, cada report é uma linha [Joystick] no Monitor Serial; gravado em uma placa real, o mesmo sketch é um controle de jogo USB.

Esse último passo é o que o Mokxi não consegue verificar para você: se o console ou o PC aceita a placa, e qual modo de entrada ele espera, depende da biblioteca e do host. Muitos montadores nem escrevem firmware e gravam firmwares de gamepad prontos. De qualquer forma, a ligação que você provou aqui é a ligação que você solda.

Abra este circuito no editor. Pro Micro: uma alavanca e seis botões, ligados como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Um Arduino Uno pode ser um arcade stick?

Não diretamente. O chip principal do Uno não tem USB próprio, então as bibliotecas Keyboard e Joystick não rodam nele. Use uma placa com ATmega32U4, como um Pro Micro, Leonardo ou Micro, ou uma placa com RP2040, como uma Pico.

Botões de fliperama precisam de resistores?

Não. Ligue um terminal ao terra e o outro a um pino com INPUT_PULLUP. O pull-up interno do chip mantém o pino em HIGH, e um toque o puxa para LOW.

O Mokxi simula o controle USB?

Não. O Pro Micro simulado modela seu USB apenas como uma conexão serial, então o exemplo imprime seu relatório no Monitor Serial. Você testa a ligação e a lógica aqui, depois adiciona a biblioteca USB e grava uma placa real.

Quanto tempo o debounce deve ter?

O bastante para cobrir a oscilação dos seus interruptores, e nem um pouco mais. O exemplo usa um bloqueio de 5 milissegundos que começa depois que o toque é aceito, então ele não atrasa o toque.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.