Pong en una TFT a color: una ILI9341 en un Arduino Uno
Avanzado
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
La ILI9341 es el chip detrás de las pantallas TFT a color comunes de 2.4 y 2.8 pulgadas, de 240 por 320 píxeles. Es un gran salto respecto a un OLED pequeño. Obtienes 65,536 colores y espacio para un juego de verdad o un panel de control. Se comunica con el Arduino por SPI con unos pines de control extra.
El circuito de arriba es un Arduino Uno jugando Pong en una ILI9341, con un joystick para mover la paleta y un piezo para los pitidos. Presiona el joystick para sacar. Funciona en tu navegador con el sketch de abajo, y su forma de dibujar enseña lo más importante de estas pantallas: solo redibuja lo que se movió.
Lo que necesitas
- Un Arduino Uno
- Un módulo TFT SPI ILI9341 de 2.4 pulgadas (240x320)
- Un módulo de joystick y un buzzer piezo, para el juego
- Una protoboard grande y cables de conexión
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| TFT CS | Pin 10 | Selección de chip |
| TFT DC | Pin 9 | LOW para un comando, HIGH para datos |
| TFT SCK | Pin 13 | Reloj del SPI |
| TFT MOSI | Pin 11 | Datos SPI hacia la pantalla |
| TFT RST | 5 V | Conectado a alto aquí; o cablealo a un pin y nómbralo en el sketch |
| TFT LED | 5 V | La luz de fondo; sin ella la pantalla queda oscura |
| TFT VCC y GND | 5 V y GND | Revisa tu módulo: muchos requieren lógica de 3.3 V |
| VRX y VRY del joystick | A0, A1 | Los dos ejes |
| SW del joystick | Pin 2 | La pulsación |
| Piezo | Pin 6 y GND | Los pitidos |
DC: comando o datos
La ILI9341 tiene un pin extra que la diferencia de un chip SPI simple: DC, de datos o comando. Cuando DC está en LOW, el byte que envías es un comando, como "define la ventana" o "comienza a escribir píxeles". Cuando DC está en HIGH, los bytes son los datos de ese comando, incluidos los propios píxeles.
Dibujar un rectángulo son tres pasos. Define el rango de columnas, define el rango de filas y luego envía la cantidad correcta de colores de píxeles. Todas las bibliotecas hacen exactamente esto por debajo.
Por qué el juego solo redibuja lo que se movió
Cada píxel son 16 bits, y la pantalla completa son 76,800 píxeles. Eso es mucha información para un Uno. En Mokxi el modelo del Uno no tiene hardware SPI, así que cada bit se envía a mano, y limpiar toda la pantalla toma alrededor de un segundo y medio. El SPI por hardware de un Uno real es más rápido, pero un redibujado completo sigue siendo demasiado lento para un juego fluido.
Por eso el sketch dibuja el marco, las etiquetas y el marcador una sola vez. Después de eso, cada cuadro solo repinta la pelota y la franja de paleta que se movió: menos de dos mil píxeles, lo que mantiene el juego a 30 cuadros por segundo. El juego también vive en una ventana de 160 por 200 en medio de la pantalla, lo que acorta el borrado inicial.
Este hábito, dibujar una vez y luego actualizar solo lo que cambió, es la clave de cualquier proyecto de pantalla rápida, en cualquier placa.
static void drawFrame() {
tft.fillRect(FX, FY, FW, FH, BG);
tft.rect(FX - 2, FY - 2, FW + 4, FH + 4, EDGE, 2);
tft.text(FX, FY - 26, "PONG", ILI9341_WHITE, ILI9341_BLACK, 3);
tft.text(FX, FY + FH + 10, "SCORE", ILI9341_WHITE, ILI9341_BLACK, 2);
tft.text(FX + 110, FY + FH + 10, "LIVES", ILI9341_WHITE, ILI9341_BLACK, 2);
}Usar la biblioteca de Adafruit
El ejemplo usa mokxi_ili9341.h, un pequeño controlador que viene con Mokxi. En un Uno real, la mayoría de los tutoriales usan las bibliotecas Adafruit_ILI9341 y Adafruit_GFX, y Mokxi incluye headers con esos nombres y sus llamadas habituales también. El hello world de abajo está escrito como lo escriben esos tutoriales.
La versión de Mokxi tiene algunas diferencias. La fuente integrada es la propia 5x8 de Mokxi, y los headers de Fonts/ son las letras de Mokxi al tamaño de cada fuente. No se lee nada de vuelta desde la pantalla. Y el bus es SPI por software, así que dibuja lo que se movió en lugar de llenar toda la pantalla con frecuencia.
#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ILI9341.h>
Adafruit_ILI9341 tft(10, 9); // CS, DC; add a third pin for RST if it is wired
void setup() {
tft.begin();
tft.setRotation(1);
tft.fillScreen(ILI9341_BLACK);
tft.setTextColor(ILI9341_WHITE);
tft.setCursor(10, 10);
tft.print("Hello");
}
void loop() {
}Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Pruébalo en el editor
Cambia BALL_COLOUR a ILI9341_RED y la pelota se vuelve roja. Los colores son números RGB565 de 16 bits, así que también puedes escribir los tuyos, como 0xF81F para magenta.
Haz la paleta más ancha subiendo PADDLE_W de 36 a 60, y el juego se vuelve más fácil. Agranda la ventana cambiando FW y FH, y observa cómo el primer borrado toma más tiempo.
Errores comunes
Pantalla blanca u oscura. Revisa el pin LED: es la luz de fondo, y sin ella la pantalla queda oscura. Una pantalla blanca con la luz de fondo encendida normalmente significa que la inicialización nunca se ejecutó: revisa CS, DC y RST.
Lógica de 5 V en una pantalla de 3.3 V. Muchos módulos ILI9341 son componentes de 3.3 V. Algunos tienen un desplazador de nivel en la placa y otros no. Revisa el tuyo antes de conectarlo a un Uno, y usa desplazadores de nivel si es necesario.
Limpiar toda la pantalla en cada cuadro. Parpadea y avanza a trompicones. Dibuja el fondo una vez y repinta solo lo que cambió.
Confundir DC y CS en el constructor. El orden es primero CS, luego DC.
Abre este circuito en el editor. Arduino Uno: Pong en una ILI9341, cableado tal como se ejecuta al principio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Qué pines usa una ILI9341 en un Arduino Uno?
SCK al 13 y MOSI al 11 (los pines SPI del Uno), CS y DC a dos pines cualquiera que nombres en el sketch, RST a un pin o a la alimentación, y LED a la alimentación para la retroiluminación.
¿Por qué mi ILI9341 es tan lento en un Uno?
Una pantalla completa son 76,800 píxeles de 16 bits cada uno. Redibuja solo lo que cambia. En Mokxi el SPI del Uno se hace por software, así que es aún más lento, y el ejemplo de Pong muestra cómo trabajar con esa limitación.
¿Mokxi admite la versión táctil?
Sí. Hay un ILI9341 con panel táctil en la caja de componentes, que se lee con la biblioteca XPT2046_Touchscreen, y un proyecto de pintado táctil que la usa.
Sigue así
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.