Pong em um TFT colorido: um ILI9341 em um Arduino Uno
Avançado
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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 pino | Vai para | Nota |
|---|---|---|
| TFT CS | Pino 10 | Seleção de chip |
| TFT DC | Pino 9 | LOW para um comando, HIGH para dados |
| TFT SCK | Pino 13 | Clock do SPI |
| TFT MOSI | Pino 11 | Dados SPI para a tela |
| TFT RST | 5 V | Ligado em alto aqui; ou ligue em um pino e dê o nome dele no sketch |
| TFT LED | 5 V | A luz de fundo; sem ela a tela fica escura |
| TFT VCC e GND | 5 V e GND | Confira o seu módulo: muitos querem lógica de 3,3 V |
| VRX e VRY do analógico | A0, A1 | Os dois eixos |
| SW do analógico | Pino 2 | O aperto |
| Piezo | Pino 6 e GND | Os 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.
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.
#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 circuitoPerguntas
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.
Continuar
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.