Aprender

Pong em um TFT colorido: um ILI9341 em um Arduino Uno

Avançado

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: Pong em um ILI9341ao vivo0.000 s 0.00x
Aperte o analógico para sacar, depois empurre para a esquerda e para a direita
O exemplo do console Pong em um ATmega328P simulado. Aperte o analógico para sacar.

O ILI9341 é o chip por trás das telas TFT coloridas comuns de 2,4 e 2,8 polegadas, 240 por 320 pixels. É um grande salto em relação a um OLED pequeno. Você tem 65.536 cores e espaço para um jogo de verdade ou um painel. Ele conversa com o Arduino por SPI com alguns pinos extras de controle.

O circuito acima é um Arduino Uno jogando Pong em um ILI9341, com um controle analógico para mover a raquete e um piezo para os bipes. Aperte o analógico para sacar. Ele roda no seu navegador com o sketch abaixo, e a forma como ele desenha ensina a coisa mais importante sobre essas telas: redesenhe apenas o que se moveu.

O que você precisa

  • Um Arduino Uno
  • Um módulo TFT SPI ILI9341 de 2,4 polegadas (240x320)
  • Um módulo de controle analógico e um buzzer piezo, para o jogo
  • Uma protoboard grande e fios jumpers

Ligação

Componente e pinoVai paraNota
TFT CSPino 10Seleção de chip
TFT DCPino 9LOW para um comando, HIGH para dados
TFT SCKPino 13Clock do SPI
TFT MOSIPino 11Dados SPI para a tela
TFT RST5 VLigado em alto aqui; ou ligue em um pino e dê o nome dele no sketch
TFT LED5 VA luz de fundo; sem ela a tela fica escura
TFT VCC e GND5 V e GNDConfira o seu módulo: muitos querem lógica de 3,3 V
VRX e VRY do analógicoA0, A1Os dois eixos
SW do analógicoPino 2O aperto
PiezoPino 6 e GNDOs bipes

DC: comando ou dados

O ILI9341 tem um pino extra que o diferencia de um chip SPI comum: DC, para dados ou comando. Quando DC está em LOW, o byte que você envia é um comando, como "defina a janela" ou "comece a escrever pixels". Quando DC está em HIGH, os bytes são os dados daquele comando, incluindo os próprios pixels.

Desenhar um retângulo são três passos. Defina o intervalo de colunas, defina o intervalo de linhas e então envie a quantidade certa de cores de pixel. Toda biblioteca faz exatamente isso por baixo dos panos.

Por que o jogo só redesenha o que se moveu

Cada pixel tem 16 bits, e a tela inteira tem 76.800 pixels. São muitos dados para um Uno. No Mokxi o modelo do Uno não tem hardware SPI, então cada bit é enviado manualmente, e limpar a tela inteira leva cerca de um segundo e meio. O SPI de hardware de um Uno real é mais rápido, mas um redesenho completo ainda é lento demais para um jogo fluido.

Por isso o sketch desenha o quadro, os rótulos e a pontuação uma única vez. Depois disso, cada quadro repinta só a bola e a faixa da raquete que se moveu: menos de dois mil pixels, o que mantém o jogo a 30 quadros por segundo. O jogo também fica em uma janela de 160 por 200 no meio da tela, o que deixa a limpeza única mais curta.

Esse hábito, desenhar uma vez e depois atualizar só o que mudou, é a chave para qualquer projeto rápido de display, em qualquer placa.

Desenhando as partes fixas uma única vez, do exemplo do console 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);
}

Usando a biblioteca Adafruit

O exemplo usa mokxi_ili9341.h, um driver pequeno que vem com o Mokxi. Em um Uno real, a maioria dos tutoriais usa as bibliotecas Adafruit_ILI9341 e Adafruit_GFX, e o Mokxi inclui cabeçalhos com esses nomes e suas chamadas usuais também. O hello world abaixo é escrito do jeito que esses tutoriais escrevem.

A versão do Mokxi tem algumas diferenças. A fonte incluída é a 5x8 própria do Mokxi, e os cabeçalhos de Fonts/ são as letras do Mokxi no tamanho de cada fonte. Nada é lido de volta da tela. E o barramento é SPI por software, então desenhe o que se moveu em vez de preencher a tela inteira com frequência.

Hello world com a biblioteca Adafruit ILI9341
#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 no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.

Experimente no editor

Mude BALL_COLOUR para ILI9341_RED e a bola fica vermelha. As cores são números RGB565 de 16 bits, então você também pode criar as suas, como 0xF81F para magenta.

Deixe a raquete mais larga aumentando PADDLE_W de 36 para 60, e o jogo fica mais fácil. Aumente a janela mudando FW e FH, e veja a primeira limpeza demorar mais.

Erros comuns

Tela branca ou escura. Confira o pino LED: ele é a luz de fundo, e sem ela a tela fica escura. Tela branca com a luz de fundo acesa normalmente significa que a inicialização nunca rodou: confira CS, DC e RST.

Lógica de 5 V em uma tela de 3,3 V. Muitos módulos ILI9341 são componentes de 3,3 V. Alguns têm um conversor de nível na placa e outros não. Confira o seu antes de ligar em um Uno, e use conversores de nível se precisar.

Limpar a tela inteira a cada quadro. Isso pisca e se arrasta. Desenhe o fundo uma única vez e repinte só o que mudou.

Trocar DC e CS no construtor. A ordem é CS primeiro, depois DC.

Abra este circuito no editor. Arduino Uno: Pong em um ILI9341, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Quais pinos um ILI9341 usa em um Arduino Uno?

SCK no 13 e MOSI no 11 (os pinos SPI do Uno), CS e DC em quaisquer dois pinos que você nomear no sketch, RST em um pino ou na alimentação, e LED na alimentação para a luz de fundo.

Por que meu ILI9341 está tão lento no Uno?

Uma tela cheia tem 76.800 pixels de 16 bits cada. Redesenhe apenas o que muda. No Mokxi o SPI do Uno é feito em software, então é ainda mais lento, e o exemplo Pong mostra como trabalhar dentro desse limite.

O Mokxi suporta a versão com toque?

Sim. Há um ILI9341 com tela de toque na caixa de componentes, lido com a biblioteca XPT2046_Touchscreen, e um projeto Touch paint que a usa.

Monte isto de verdade

Abra o editor, mude um valor e veja o número mudar junto. Nada para instalar, e não precisa de conta.