Aprender

Pong en una TFT a color: una ILI9341 en un Arduino Uno

Avanzado

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
Arduino Uno: Pong en una ILI9341en vivo0.000 s 0.00x
Presiona el joystick para sacar y luego muévelo a la izquierda y a la derecha
El ejemplo de la consola Pong en un ATmega328P simulado. Presiona el joystick para sacar.

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 pinVa aNota
TFT CSPin 10Selección de chip
TFT DCPin 9LOW para un comando, HIGH para datos
TFT SCKPin 13Reloj del SPI
TFT MOSIPin 11Datos SPI hacia la pantalla
TFT RST5 VConectado a alto aquí; o cablealo a un pin y nómbralo en el sketch
TFT LED5 VLa luz de fondo; sin ella la pantalla queda oscura
TFT VCC y GND5 V y GNDRevisa tu módulo: muchos requieren lógica de 3.3 V
VRX y VRY del joystickA0, A1Los dos ejes
SW del joystickPin 2La pulsación
PiezoPin 6 y GNDLos 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.

Dibujar las partes fijas una sola vez, del ejemplo de la consola Pong
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.

Hello world con la biblioteca ILI9341 de Adafruit
#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 circuito

Preguntas

¿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.

Á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.