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.