Aprender

Ligando botões de fliperama a um Pro Micro ou um Pico

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Raspberry Pi Pico: um botão de fliperama no GP15ao vivo0.000 s 0.00x
Segure o botão
Segure o botão: a lâmpada no GP14 e o LED do próprio Pico acendem enquanto ele está pressionado. Sem resistor no botão, apenas o pull-up interno.

Um botão de fliperama é um êmbolo com uma microchave embaixo. Ligar um a um microcontrolador leva dois fios e nenhum outro componente: um ao terra e um a um pino. Esta página cobre os detalhes que confundem as pessoas: quais abas usar, como passar o terra, quais pinos escolher em um Pro Micro e um Pico, e como ler o botão em código.

O circuito acima é um botão de fliperama de 30 mm em um Raspberry Pi Pico no Mokxi. Aperte Rodar e segure o botão: GP15 lê o botão, e uma lâmpada no GP14 e o LED da própria Pico acendem enquanto ele está segurado. Os projetos do fight stick e do controle sem alavanca vinculados abaixo fazem o mesmo com um conjunto completo de botões em um Pro Micro.

Quais abas usar

A microchave embaixo de um botão geralmente tem duas ou três abas. Com duas, não há o que escolher. Com três, elas são comum, normalmente aberta e normalmente fechada. Ligue a comum e a normalmente aberta: esse par fica aberto quando o botão está solto e fechado enquanto está pressionado. A aba normalmente fechada faz o oposto, e um botão ligado a ela lê como segurado o tempo todo e solto enquanto você o pressiona.

Alavancas funcionam da mesma forma. Uma alavanca é composta de quatro microchaves, uma para cada direção, e muitas vêm com um chicote de cinco fios: um terra compartilhado pelas quatro chaves, e um fio para cada direção.

Um ground para tudo

Cada botão precisa de um caminho até o terra, mas não de um fio de terra próprio de volta à placa. O método usual é uma ligação em cascata: um fio que vai da aba de terra do primeiro botão ao próximo, e assim por diante, com uma ponta ligada a um pino GND. O terra da alavanca entra na mesma cadeia. Assim, cada botão precisa de apenas um fio de sinal próprio.

Confira se a cadeia realmente alcança todos os botões. Um botão cuja aba de ground ficou esquecida é o defeito mais comum em um arcade stick novo, e parece um botão morto ou um pino com problema. No simulador você pode puxar um fio de ground e ver exatamente isso.

Pull-ups, não resistores

Um pino sem nada o alimentando fica flutuando e lê valores aleatórios. A solução é um pull-up: um resistor ligado à alimentação que mantém o pino em HIGH até o switch puxá-lo ao ground. Tanto o ATmega32U4 do Pro Micro quanto o RP2040 do Pico têm um embutido em cada pino, ativado com INPUT_PULLUP, então o botão não precisa de resistor nenhum. Como resultado, a lógica fica invertida: um botão pressionado lê LOW.

Nenhuma das placas precisa de mais nada para um botão. Diodos só são necessários para uma matriz de teclas, e um controle não deve usar matriz: dê a cada botão o seu próprio pino para qualquer combinação poder ser mantida ao mesmo tempo.

Um botão, lido com o 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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Pinos em um Pro Micro

O Pro Micro modelado no Mokxi expõe 18 pinos de entrada e saída: os digitais 0 a 10, 14, 15 e 16, e A0 a A3, que também funcionam como pinos digitais. Qualquer um deles pode ler um botão. Os pinos 0 e 1 são a porta serial de hardware, mas um sketch que se comunica por USB os deixa livres, e o exemplo do arcade stick os usa para dois botões. Não há LED no pino 13; as luzes RX e TX acendem quando o pino delas está em LOW.

O projeto do arcade stick coloca a alavanca nos pinos 2 a 5 e os botões em 6 a 9, 1 e 0. O projeto sem alavanca usa 2 a 7 para os botões, 8 para um switch de modo e A0 a A3 para LEDs.

Pinos em um Pico

Um Raspberry Pi Pico tem 26 pinos GPIO nos seus headers, de sobra para um layout completo sem alavanca e ainda com espaço para iluminação. Qualquer GPIO pode ler um botão com o pull-up ativado. Planeje o layout para que cada fio dentro do gabinete seja curto e organizado, e mantenha um mapa escrito de qual botão está em qual número de GP, porque o firmware ou o sketch vai precisar dele.

No Mokxi, o Pico roda sketches de Arduino com digitalRead, INPUT_PULLUP e interrupções em todos os pinos. Ele não modela o USB do Pico, seus blocos PIO nem o ADC, então você pode testar a ligação e a lógica dos botões, mas não um relatório USB nem iluminação via PIO.

Botões iluminados

Muitos botões de fliperama aceitam um LED, e muitos projetos usam LEDs endereçáveis WS2812 em vez disso, um ou dois sob cada botão em um único fio de dados. Em um Pico de verdade, o timing do WS2812 normalmente vem do PIO; em um 32U4, ele vem de código de biblioteca cuidadosamente cronometrado. No Mokxi, as fitas WS2812 funcionam a partir do ESP32-C3 e do C6, então o projeto de iluminação está em um C3, com quatro botões de fliperama em que cada um acende o seu próprio par de LEDs.

Confira antes de soldar

Ligue o circuito no simulador do jeito que você planeja ligar o gabinete, e rode um sketch que imprima cada botão conforme ele muda. Se cada botão imprimir o próprio nome no pino certo, o chicote está certo. O que o simulador não consegue conferir é a parte física: a qualidade da crimpagem, um conector quick-disconnect frouxo ou um switch desgastado. Um multímetro no modo de continuidade encontra isso em um minuto.

Abra este circuito no editor. Raspberry Pi Pico: um botão de fliperama no GP15, ligado como funciona no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Quais abas do botão de fliperama eu conecto?

Comum e normalmente aberto. Deixe a aba normalmente fechado vazia, ou o botão lê invertido.

Preciso de resistores para botões de fliperama?

Não. Ative o pull-up interno do pino com INPUT_PULLUP. O pino lê HIGH quando o botão está solto e LOW quando está pressionado.

Todos os botões podem compartilhar um fio de ground?

Sim. Ligue as abas de ground dos botões em cascata e leve uma ponta a um pino GND. O ground da alavanca entra na mesma cadeia.

O Mokxi simula o Pico como um controle USB?

Não. O Mokxi roda sketches de Arduino no seu modelo de Pico, mas não modela o USB do Pico, então você testa a ligação e o código, não o relatório USB.

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.