Aprender

O jogo de fliperama Stacker em duas matrizes de LED

Avançado

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
ESP32-C3: o stacker de fliperamaao vivo0.000 s 0.00x
Aperte Rodar e depois aperte o botão grande para soltar a fileira
The Stacker example: two cascaded MAX7219 matrices for an 8x16 field and one arcade button. Press it to drop the row.

Stacker é aquele fliperama com a coluna alta de luzes: uma fileira desliza de um lado para o outro, você aperta o botão para soltá-la, e tudo que ficar pendurado sobre a fileira de baixo é cortado. Cada fileira é mais estreita e rápida que a anterior, e se você a aparar até sumir, o jogo acaba. É o exemplo mais aberto no Mokxi, e é um ótimo projeto porque o gabinete inteiro é um botão e dois módulos de LED baratos.

O circuito acima roda em um ESP32-C3 com código Arduino. Dois módulos de matriz MAX7219 8x8 ficam um sobre o outro, formando um campo com oito de largura e dezesseis de altura. Aperte Rodar e um bloco de três pontos de largura começa a deslizar pela base. Aperte o botão grande para soltá-lo. Encoste um bloco na fileira do topo e você ganha: a torre completa se mantém, o campo inteiro se preenche de baixo para cima e pisca, e um novo jogo começa. Deixe o jogo sozinho por quatro segundos e ele joga sozinho, errando de propósito de vez em quando, até alguém apertar o botão de novo.

O que você precisa

  • Uma placa ESP32-C3 (ou um Arduino Uno; veja abaixo)
  • Dois módulos de matriz de LEDs 8x8 MAX7219
  • Um botão de fliperama de 30 mm, ou qualquer botão de pressão
  • Uma protoboard e jumpers

Ligação

Componente e pinoVai paraNota
DIN da matriz de cimaGPIO 7Os dados vão só para o módulo de cima
DOUT da matriz de cimaDIN da matriz de baixoA cascata
CLK das duas matrizesGPIO 5Compartilhado
CS das duas matrizesGPIO 6Um único chip select para a cadeia
VCC e GND das matrizesPino 5V e GNDNão 3V3: o MAX7219 quer 4 V ou mais
Botão de fliperamaGPIO 3A outra perna no GND, o pull-up do próprio pino

A cascata: dois módulos, três fios

Cada MAX7219 tem um registrador de deslocamento de 16 bits e um pino DOUT na ponta oposta. Ligue o DOUT do módulo de cima no DIN do de baixo e compartilhe o clock e o chip select, e os dois funcionam como um único registrador de 32 bits. Envie 32 bits com CS em nível baixo e os primeiros 16 bits que você enviou param no segundo chip. Uma borda de subida de CS trava os dois de uma vez.

Por isso cada escrita é um par: primeiro o pacote do módulo de baixo, porque é ele que viaja mais longe, e depois o do módulo de cima. Isso é tudo que write_chain() faz. Custa um pino a menos que um chip select por módulo, e é assim que as placas baratas de matriz quatro em um são ligadas por dentro.

O sketch controla os chips com suas próprias funções curtas em vez de uma biblioteca, então a cascata fica à vista: um pacote são quatro bits não usados, um endereço de registrador de quatro bits e um byte de dados, enviados com o bit mais significativo primeiro. Em uma placa real, LedControl faz o mesmo com LedControl lc(DIN, CLK, CS, 2).

Um registrador em cada módulo, travados juntos
static void shift_packet(uint8_t address, uint8_t data) {
  uint16_t packet = ((uint16_t)(address & 0x0f) << 8) | data;
  for (int8_t bit = 15; bit >= 0; bit--) {
    digitalWrite(CLK_PIN, LOW);
    digitalWrite(DIN_PIN, (packet >> bit) & 1u ? HIGH : LOW);
    digitalWrite(CLK_PIN, HIGH);
  }
}

static void write_chain(uint8_t address, uint8_t bottom, uint8_t top) {
  digitalWrite(CS_PIN, LOW);
  shift_packet(address, bottom);  // pushed through the top chip
  shift_packet(address, top);
  digitalWrite(CS_PIN, HIGH);     // both latch here
}

Como o jogo funciona no código

A pilha são dezesseis bytes, um por nível, com um bit por coluna. Soltar o bloco é um único AND: as colunas do bloco E a fileira de baixo. O que sobrevive é a nova fileira, e a largura dela é a nova largura do bloco. Se nada sobreviver, o jogo acaba. O chão segura tudo, então a primeira queda sempre aterra.

O bloco começa com três de largura. A partir do nível 7, a fileira de cima do módulo de baixo, ele tem no máximo dois de largura, e nos três níveis do topo é um. O tempo de passo diminui com a altura, de 210 ms por coluna na base até 70 ms no topo, calculado como 210 menos 140 vezes o nível dividido por 15.

O botão conta pela borda: o sketch lembra se ele estava pressionado na última vez, então segurá-lo solta um bloco, não um por volta. Entre os passos, o sketch dorme 2 ms por vez, o que ainda lê o botão 500 vezes por segundo.

Em um Arduino Uno

Nada no sketch é exclusivo do ESP32: ele usa digitalWrite, digitalRead, millis, delay e random. Para rodar em um Uno, troque os quatro números de pinos (por exemplo DIN 11, CLK 13, CS 10 e o botão no 2) e alimente os módulos com o 5 V do Uno. Abra no editor, troque a placa e religue os fios.

Erros comuns

A metade de baixo fica apagada. Falta o fio da cascata do DOUT do módulo de cima para o DIN do módulo de baixo, ou ele está no pino errado. Retire-o no circuito acima e o bloco, que começa embaixo, desaparece; a metade de cima continua funcionando, como você vê quando a pilha chega nela.

As metades estão trocadas ou mostram a imagem uma da outra. Os pacotes estão na ordem errada. O primeiro enviado para no módulo mais distante.

Nada acende. O MAX7219 inicia desligado, escaneando uma fileira, com brilho zero. O sketch escreve shutdown, scan limit, decode mode e intensity no começo; deixe qualquer um deles de fora e o painel fica apagado.

Alimentar os módulos com 3,3 V. Eles precisam de 4 V ou mais, então use o pino 5V da placa.

O botão solta todos os blocos enquanto está pressionado. Conte a mudança de solto para pressionado, não o nível.

Abra este circuito no editor. ESP32-C3: o stacker de fliperama, ligado como roda no topo desta página. Mude um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Como faço um jogo de stacker com Arduino?

Use duas matrizes MAX7219 8x8 encadeadas para um campo de 8x16 e um botão. Guarde um byte por fileira, deslize o bloco com millis() e, quando o botão for pressionado, faça o AND do bloco com a fileira de baixo. O que sobrar é a nova fileira.

Posso fazer com uma única matriz 8x8?

Sim, com oito níveis em vez de dezesseis. Defina LEVELS como 8, desça os níveis de estreitamento e corte o segundo pacote de cada escrita.

Por que o jogo joga sozinho?

Após quatro segundos sem nenhuma pressão, ele entra em modo de demonstração, como um fliperama: ele mira na fileira de baixo e de vez em quando erra por uma coluna de propósito. Uma pressão real devolve o jogo.

Posso usar uma fita de LED WS2812?

Sim. Uma grade de 16x8 de LEDs WS2812 funciona do mesmo jeito com a biblioteca Adafruit NeoPixel. A lógica do jogo não muda, só o desenho.

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.