Los juegos son la parte de Mokxi a la que la gente vuelve una y otra vez, así que vale la pena conocer bien cuatro componentes: el OLED pequeño, la palanca de mando, el codificador rotatorio y el anillo de LEDs direccionable. Esta página explica qué hace cada uno, qué tiene que hacer el firmware para manejarlo y qué ejemplo abrir para verlo funcionando.
El OLED SSD1306, 128x64
La pantallita azul y blanca que todo kit de electrónica tiene. Dos cables y alimentación: es un esclavo I2C en la dirección 0x3c, y también reconoce 0x3d si configuras la propiedad de esa manera.
El componente modela el conjunto de comandos que las bibliotecas comunes realmente envían (encender y apagar la pantalla, el modo de direccionamiento, las ventanas de columna y página, el contraste, el remapeo de segmentos, la dirección de barrido de COM y la bomba de carga) y tanto el direccionamiento por página como el horizontal, así que un controlador escrito para un panel real funciona aquí sin cambios. Lo que ves en el lienzo es la propia RAM de gráficos del panel, dibujada píxel por píxel.
No hay periférico I2C ni en el Uno ni en el ESP32-C3 en Mokxi, así que el bus se implementa por software: mokxi_i2c.h baja las dos líneas y las suelta, y las pull-ups de 4k7 del propio módulo las devuelven arriba. Sirven cualesquiera dos pines, y por eso los ejemplos usan los dos que todos esperan.
Un fotograma monocromático de 128x64 son 1024 bytes. En un ESP32-C3 eso no es nada; en un Uno es la mitad de la memoria del chip, y enviarla toda por un bus de software toma un tercio de segundo. Por eso el controlador envía solo los bloques de ocho columnas de cada página que cambiaron, y por eso un juego en este panel borra la pelota donde estaba y la dibuja donde está, en lugar de repintar todo.
Para verlo: Dado OLED (ESP32-C3), Pong OLED (Uno) y Pong OLED en un ESP32-C3.
La palanca de mando
Dos potenciómetros de 10 k y un interruptor de presión: el módulo KY-023 y sus clones. Arrastra la tapa negra en el lienzo y ambos ejes se mueven; suéltala y regresa con un resorte al centro, como lo hace el real. Haz clic o mantén presionada la tapa para empujar la palanca hacia abajo, lo que pone SW a tierra.
Cada eje es un divisor real entre lo que esté en VCC y GND, con la impedancia propia de la pista detrás del cursor, así que una entrada ADC con carga ve lo que vería en el banco de trabajo.
Una palanca de control necesita un ADC, y ambas placas tienen uno. El del Uno es el conversor de diez bits del ATmega328P en A0 a A5; el del ESP32-C3 es el ADC1, de doce bits, en GPIO 0 a GPIO 4. Así que una palanca funciona en cualquiera, un eje lee de 0 a 1023 en una y de 0 a 4095 en la otra, y mokxi_joystick.h en la biblioteca de firmware oculta la diferencia.
Míralo: OLED pong (Uno), OLED pong en un ESP32-C3, Palanca de control en ESP32-C3 y Snake en dos matrices.
El codificador rotatorio (KY-040)
Un eje que cuenta clics en cualquier sentido, con un interruptor debajo. Tres contactos a tierra: CLK y DT son las dos mitades de un codificador en cuadratura y SW es el de presión. El módulo lleva pull-ups de 10 k en el par de cuadratura; SW no tiene ninguna, y por eso todo sketch lo lee con INPUT_PULLUP.
Tres formas de girarlo en el lienzo:
- arrastra alrededor de la perilla: el rumbo del puntero respecto al eje es el ángulo del eje;
- la rueda de desplazamiento sobre la perilla: una muesca es un detent, alejándose de ti en sentido horario;
- arrastra hacia arriba y abajo: para una pantalla táctil, y para un arrastre que empieza sobre el eje mismo, donde un rumbo no significa nada.
Girarlo no hace saltar los pines de un estado al siguiente. Un clic son cuatro pasos de cuarto, reproducidos cada ocho milisegundos, así que un firmware que consulta en un bucle ve la secuencia como la vería en un banco de trabajo. Y los contactos rebotan, una vez por paso de cuarto, porque esa es toda la lección: un sketch que espera un flanco de bajada en CLK cuenta tres clics por cada uno. Desactiva el rebote en las propiedades cuando el codificador no sea lo importante.
mokxi_rotary.h lo hace de la forma correcta, con la tabla de estados de dieciséis entradas: una transición vale +1, -1 o nada cuando el par saltó dos estados a la vez, que es como se ve un rebote. Un clic se reporta cuando cuatro pasos de cuarto se han acumulado y el eje vuelve a un detent.
Míralo: Simón de anillo.
El anillo y la tira 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 elige el dibujo. strip es una fila, matrix mide dieciséis de ancho, y ring curva la fila en un círculo, el LED 0 a las doce y los demás en sentido horario, que es como vienen numerados los anillos que compra la gente. Un anillo es una tira eléctricamente, así que nada del cableado ni del firmware cambia; solo cambia el dibujo.
El driver, mokxi_ws2812.h, genera los pulsos con un bucle contado en lugar de un temporizador, porque el SYSTIMER del ESP32-C3 late a 16 MHz y leerlo toma más tiempo que el pulso que se mide. Es un header para ESP32-C3: a 16 MHz un Uno tiene veinte ciclos para un bit completo y seis y medio para el primer pulso, algo que digitalWrite no puede hacer sin una página de ensamblador escrito a mano.
Míralo: Simón de anillo y Tira de arcoíris.
Los cinco juegos
Abre cualquiera desde el menú de Ejemplos, o desde las plantillas del sitio.
| Juego | Placa | Pantalla | Entrada |
|---|---|---|---|
| OLED pong | Uno | SSD1306 | palanca de control |
| OLED pong on an ESP32-C3 | ESP32-C3 | SSD1306 | palanca de control |
| Snake on two matrices | Uno | dos MAX7219 | palanca de control |
| Ring Simon | ESP32-C3 | anillo WS2812 | codificador rotatorio |
| OLED dice | ESP32-C3 | SSD1306 | botón de arcade |
Los dos pong son el mismo circuito en las dos placas, que es la forma más corta de ver qué cambia una placa y qué no.
Cada uno es firmware real compilado para la placa que nombra, ejecutándose sobre el mismo núcleo que todo lo demás aquí. Presiona Ejecutar y luego maneja la entrada con el puntero: arrastra la tapa de la palanca, gira la perilla del codificador, mantén presionado el botón.
There is a sixth, Stacker, on two MAX7219 matrices with one button, and it plays itself until you press something.