Componentes

Os componentes dos quais os jogos são feitos

Uma tela, algo para segurar, e os cinco jogos da galeria que juntam tudo isso.

Jogos são a parte do Mokxi para a qual as pessoas sempre voltam, então vale conhecer bem quatro componentes: o pequeno OLED, o thumb stick, o encoder rotativo e o anel de LEDs endereçáveis. Esta página mostra o que cada um faz, o que o firmware precisa fazer para controlá-lo e qual exemplo abrir para vê-lo funcionando.

O OLED SSD1306, 128x64

A pequena tela azul e branca que todo kit de eletrônica tem. Dois fios e alimentação: ele é um escravo I2C no endereço 0x3c, e também responde por 0x3d se você configurar a propriedade assim.

O componente modela o conjunto de comandos que as bibliotecas comuns realmente enviam (ligar e desligar o display, o modo de endereçamento, as janelas de coluna e página, contraste, remapeamento de segmentos, direção de varredura COM e a bomba de carga) e tanto o endereçamento por página quanto o horizontal, então um driver escrito para um painel real funciona aqui sem alterações. O que você vê no canvas é a própria RAM gráfica do painel, desenhada pixel por pixel.

Não há periférico I2C nem no Uno nem no ESP32-C3 no Mokxi, então o barramento é feito por software: mokxi_i2c.h puxa as duas linhas para baixo e as solta, e os pull-ups de 4k7 do próprio módulo as trazem de volta para cima. Quaisquer dois pinos servem, e é por isso que os exemplos usam os dois que todos esperam.

Um quadro monocromático de 128x64 tem 1024 bytes. No ESP32-C3 isso não é nada; no Uno é metade da memória do chip, e enviar tudo por um barramento de software leva um terço de segundo. É por isso que o driver envia apenas os blocos de oito colunas de cada página que mudaram, e por isso um jogo nesse painel apaga a bola onde ela estava e a desenha onde ela está, em vez de repintar tudo.

Veja em: OLED dice (ESP32-C3), OLED pong (Uno) e OLED pong no ESP32-C3.

O thumb stick

Dois potenciômetros de 10 k e um botão de pressão: o módulo KY-023 e seus clones. Arraste a tampa preta no canvas e os dois eixos se movem; solte e ela volta por mola para o centro, como faz a de verdade. Clique ou segure a tampa para empurrar o analógico para baixo, o que liga SW ao terra.

Cada eixo é um divisor de verdade entre o que estiver em VCC e GND, com a impedância própria da trilha atrás do cursor, então uma entrada de ADC com carga enxerga o mesmo que enxergaria na bancada.

Um analógico precisa de um ADC, e as duas placas têm um. O do Uno é o conversor de dez bits do ATmega328P em A0 a A5; o do ESP32-C3 é o ADC1, de doze bits, nos GPIO 0 a GPIO 4. Então um analógico funciona em ambos, um eixo lê de 0 a 1023 em um e de 0 a 4095 no outro, e mokxi_joystick.h na biblioteca de firmware esconde a diferença.

Veja: OLED pong (Uno), OLED pong no ESP32-C3, Analógico no ESP32-C3 e Snake em duas matrizes.

O encoder rotativo (KY-040)

Um eixo que conta cliques nos dois sentidos, com um botão embaixo. Três contatos ao terra: CLK e DT são as duas metades de um encoder em quadratura e SW é o botão de pressão. O módulo traz pull-ups de 10 k no par de quadratura; SW não tem nenhum, e é por isso que todo sketch lê esse pino com INPUT_PULLUP.

Três jeitos de girá-lo no canvas:

  • arraste em volta do botão: a direção do ponteiro em relação ao eixo é o ângulo do eixo;
  • a roda de rolagem sobre o botão: um clique é um detent, para longe de você no sentido horário;
  • arraste para cima e para baixo: para tela de toque, e para um arrasto que começa no próprio eixo, onde uma direção não significa nada.

Girá-lo não faz os pinos saltarem de um estado para o outro. Um clique são quatro quartos de passo, espaçados oito milissegundos cada, então um firmware que faz polling num loop vê a sequência como veria numa bancada. E os contatos tremem, uma vez por quarto de passo, porque essa é a lição inteira: um sketch que espera uma borda de descida em CLK conta três cliques para um. Desligue o tremido nas propriedades quando o encoder não for o foco.

mokxi_rotary.h faz do jeito certo, com a tabela de estados de dezesseis entradas: uma transição vale +1, -1 ou nada quando o par saltou dois estados de uma vez, que é como um bounce se parece. Um clique é relatado quando quatro quartos de passo se somaram e o eixo voltou a um detent.

Veja: Ring Simon.

O anel e a fita de WS2812

Addressable RGB LEDs on one wire, with no clock: a bit is a high pulse whose length is the bit, 0.4 microseconds for a zero and 0.8 for a one, twenty-four bits an LED, green first. The part decodes those pulses off the pin's own edges with the timing tolerance a real strip has, and fifty microseconds of quiet latches the frame.

layout escolhe o desenho. strip é uma fileira, matrix tem dezesseis de largura, e ring curva a fileira num círculo, LED 0 no meio-dia e o resto no sentido horário, que é como os anéis que as pessoas compram são numerados. Um anel é uma fita eletricamente, então nada na ligação ou no firmware muda; só o desenho muda.

O driver, mokxi_ws2812.h, gera os pulsos com um loop contado em vez de um timer, porque o SYSTIMER do ESP32-C3 tica a 16 MHz e lê-lo demora mais que o pulso sendo medido. É um header para ESP32-C3: a 16 MHz um Uno tem vinte ciclos para um bit inteiro e seis e meio para o primeiro pulso, o que digitalWrite não consegue fazer sem uma página de assembly escrita à mão.

Veja: Simon de anel e Fita arco-íris.

Os cinco jogos

Abra qualquer um deles no menu Exemplos, ou nos modelos do site.

Jogo Placa Tela Entrada
OLED pong Uno SSD1306 analógico
OLED pong on an ESP32-C3 ESP32-C3 SSD1306 analógico
Snake on two matrices Uno duas MAX7219 analógico
Ring Simon ESP32-C3 anel de WS2812 encoder rotativo
OLED dice ESP32-C3 SSD1306 botão de fliperama

Os dois pongs são o mesmo circuito nas duas placas, que é o caminho mais curto para ver o que uma placa muda e o que não muda.

Cada um é firmware de verdade compilado para a placa que nomeia, rodando no mesmo core em que tudo aqui roda. Aperte Rodar, depois controle a entrada com o ponteiro: arraste a tampa do analógico, gire o knob do encoder, segure o botão pressionado.

There is a sixth, Stacker, on two MAX7219 matrices with one button, and it plays itself until you press something.