Aprender

Projete seu button box de sim racing no navegador

Avançado

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Pro Micro: um button box completoao vivo0.000 s 0.00x
Aperte Rodar, depois gire os botões giratórios e acione as chaves
Gire os botões giratórios, acione as chaves deslizantes e segure os botões de fliperama. O monitor serial mostra cada evento e o relatório [Joystick].

Um button box coloca na sua mão os controles que você alcança durante uma corrida: uma chave de ignição e um botão de partida, botões giratórios para controle de tração e ABS, chaves para limpadores e faróis, uma chave protegida para o limitador de pit e uma fileira de botões para o rádio e o pedido de pit. Por dentro, é uma placa pequena e muitas chaves, e a placa que a maioria dos boxes DIY usa é uma Pro Micro ou uma Leonardo, porque o ATmega32U4 delas é o próprio dispositivo USB e pode aparecer no PC como um controle de jogo.

A caixa acima é um modelo completo. Gire os botões giratórios, acione as chaves e segure os botões enquanto ela roda, e o monitor serial mostra cada evento e o relatório de controle que a caixa enviaria. O sketch mantém todo o painel em duas tabelas no topo, então mudar a caixa é mudar uma linha: qual pino, que tipo de chave, qual botão ela aciona.

Uma coisa logo de início: o Mokxi não simula a conexão USB com um PC. A biblioteca Joystick imprime o relatório que enviaria como uma linha [Joystick]. Tudo até esse ponto é real e está rodando: a ligação, os pull-ups, o debounce, a decodificação dos encoders, o tempo dos pulsos e o mapa de botões. Grave o mesmo sketch em uma Pro Micro real e os relatórios vão pelo USB.

Quer a versão passo a passo? A aula "Botões e chaves que um jogo entende" percorre isso com checkpoints.

Abrir a aula

Planeje o painel, depois conte os pinos

Comece pelo que você realmente aperta nos seus jogos, depois conte as entradas. Este modelo tem dois encoders com push (três pinos cada), uma chave de ignição e um botão START, três chaves, quatro botões momentâneos e três LEDs de status: dezoito pinos, que é todos os que uma Pro Micro oferece. Uma Leonardo adiciona mais alguns.

Além disso, os montadores ligam seus botões em matriz com um diodo em cada chave, exatamente como um teclado faz, então 25 botões cabem em dez pinos. A página de matriz de teclado explica a matriz e o diodo, e é o mesmo circuito se as chaves são teclas ou botões de fliperama.

Toda chave aqui é ligada do mesmo jeito: um terminal no GND, outro em um pino com o pull-up interno ativado. Uma chave fechada lê LOW e não é preciso nenhum resistor, exceto em série com os LEDs.

Por que as chaves deveriam enviar pulsos

Um jogo vincula um controle ao apertar de um botão. Uma chave com trava que mantém o botão pressionado enquanto está ligada parece ao jogo uma pressão muito longa, e desligá-la, o que solta o botão, não faz nada. Então o sketch tem três tipos de chave. PULSE envia uma pressão curta a cada acionamento, para controles que alternam no jogo, como limpadores. PULSE_BOTH envia uma pressão em um botão ao ligar e em outro ao desligar, para jogos com comandos separados de ligar e desligar, então a chave nunca sai de sincronia. HOLD mantém o botão pressionado enquanto a chave está ligada, para ferramentas que leem um botão segurado como um estado.

A chave de ignição tem o próprio tipo. START é uma chave STARTER: ela só é segurada enquanto a chave está ligada, então um toque no botão com a chave desligada não envia nada, como em um carro real.

O painel, como o sketch o descreve
const Switch SWITCHES[] = {
  {6, IGNITION, 0, 1, "ignition"},
  {A3, STARTER, 2, NONE, "start"},
  {8, PULSE, 3, NONE, "wipers"},
  {9, PULSE_BOTH, 4, 5, "lights"},
  {7, HOLD, 6, NONE, "pit limiter"},
  {A2, MOMENTARY, 7, NONE, "pit request"},
};

Encoders que nunca perdem um clique

Controle de tração, ABS e balanceamento de freio geralmente ficam vinculados a um par de botões, um para subir e outro para descer, então cada clique de um botão giratório deveria ser uma pressão. Duas coisas dão errado com código de encoder ingênuo. Encoders baratos trepidam, então um clique conta como três; e um jogo lê o controle uma vez por quadro, então uma pressão curta demais, ou duas pressões sem intervalo, podem ser perdidas.

O modelo lê cada encoder com uma tabela de estados: toda mudança válida dos dois contatos soma ou subtrai um, uma trepidação soma um e tira de volta na hora, e só uma contagem líquida em repouso em um detente vira um clique. Cada clique é então enfileirado e reproduzido como uma pressão de PULSE_MS seguida de GAP_MS solto, então um giro rápido chega com todos os seus cliques. Os encoders no Mokxi trepidam como os reais, então você pode ver a tabela dar conta.

Luzes, e o que elas podem saber

Os três LEDs seguem cada um uma chave: a ignição, o limitador de pit e os faróis. Isso é honesto sobre o que um box sozinho pode saber. Um LED que mostra o que o carro está fazendo, como um limitador de pit que o jogo desligou, precisa da telemetria do jogo, e em um rig real esse é o trabalho de uma ferramenta como o SimHub, falando com a placa pelo USB. A ligação e os pinos que você define aqui são os mesmos de qualquer jeito.

Um câmbio, um freio de mão e um painel de voo

O mesmo curso continua além do box. O modelo de câmbio lê um padrão H a partir de dois pots com linhas de trigger e de liberação para uma marcha nunca trepidar, usa um botão de apertar para o ré, adiciona pás sequenciais, e transforma um sensor hall em um eixo de freio de mão com zonas mortas. O modelo de painel de voo tem um botão giratório de piloto automático para proa, altitude e velocidade vertical em um display de quatro dígitos, um botão de AP e uma alavanca de trem com três luzes verdes e uma vermelha em trânsito.

Para simuladores de voo, seja claro sobre o display: em um painel real os números voltam do simulador por uma ponte como MobiFlight, SimConnect ou DCS-BIOS. O modelo mantém a própria contagem, o que serve para testar a ligação e o botão giratório, e diz isso.

Abra este circuito no editor. Pro Micro: um button box completo, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Qual placa um button box deveria usar?

Uma cujo chip é o próprio dispositivo USB: uma Pro Micro, Leonardo ou Micro (ATmega32U4), ou uma placa RP2040 com firmware adequado. Uma Uno não pode ser um controle de jogo com a biblioteca Joystick, porque o USB dela é um chip serial separado.

O Mokxi simula o controle de jogo USB?

Não. A biblioteca Joystick imprime no monitor serial cada relatório que enviaria. Você testa aqui a ligação, a lógica das chaves e o mapa de botões, depois grava o mesmo sketch em uma placa real.

Quantos botões uma Pro Micro aguenta?

Dezoito entradas ligadas diretamente, uma por pino. Com uma matriz de diodos, linhas vezes colunas: cinco linhas e cinco colunas são 25 botões em dez pinos. A biblioteca Joystick relata até 32 botões.

As chaves deveriam segurar o botão ou pulsá-lo?

Pulsar, para a maioria das vinculações de jogo, porque os jogos agem com uma pressão. Use pulsos separados de ligar e desligar quando o jogo tem os dois comandos, e segure apenas para ferramentas que leem um botão segurado como um estado.

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.