Um TFT colorido ST7735 em um Arduino
Avançado
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
O ST7735 é o chip por trás das telas coloridas de 1,8 polegada baratas: 128 por 160 pixels, 65.536 cores, numa placa vermelha com slot para cartão SD atrás. Ele fala SPI, então precisa de um clock, uma linha de dados e alguns pinos de controle, e a biblioteca Adafruit ST7735 cuida do resto.
O circuito acima é um Uno com duas telas coloridas: a ST7735 de 1,8 polegada nos pinos SPI de hardware do Uno e uma ST7789 de 1,3 polegada em pinos próprios. Cada uma desenha um tÃtulo e depois um pequeno quadrado atravessa a tela mudando de cor pelo caminho. Aperte Rodar e veja a ST7735 acender primeiro, e a ST7789 cerca de dois segundos depois.
O que você precisa
- Um Arduino Uno
- Uma TFT ST7735 de 1,8 polegada, 128x160 (a placa SPI vermelha)
- Uma TFT ST7789 de 1,3 polegada, 240x240 (opcional, para a segunda metade)
- Uma protoboard e jumpers
Ligação
| Componente e pino | Vai para | Nota |
|---|---|---|
| ST7735 VCC | 5 V | A placa vermelha tem um regulador para o chip |
| ST7735 GND | GND | |
| ST7735 SCK | Pino 13 | O clock do SPI de hardware |
| ST7735 SDA | Pino 11 | Dados SPI (MOSI). Não é I2C, apesar do que diz o rótulo |
| ST7735 CS | Pino 10 | Seleção de chip |
| ST7735 A0 | Pino 9 | O que outras placas chamam de DC: comando ou dado |
| ST7735 RESET | Pino 8 | |
| ST7735 LED | 5 V | A luz de fundo |
| ST7789 SCL e SDA | A1 e A0 | SPI por software em qualquer pino |
| ST7789 DC e RES | Pinos 7 e 6 | Essa placa não tem pino CS |
Como a tela é acionada
A ST7735 guarda a imagem inteira na própria memória, 16 bits por pixel. Para desenhar, o Uno envia um comando que define uma janela (uma faixa de colunas, depois uma faixa de linhas) e em seguida transmite as cores de cada pixel dela. É por isso que um quadrado preenchido é rápido e uma imagem de tela cheia é lenta: os bytes precisam viajar pelo fio nos dois casos.
O pino A0 (DC na maioria das outras placas) diz ao chip quais bytes são comandos e quais são pixels: nÃvel baixo para comando, nÃvel alto para dado. CS em nÃvel baixo significa "isso é para você". A biblioteca aciona os dois por você, mas se algum dos fios estiver frouxo, nada faz sentido para o chip e a tela fica escura.
Colors are 16-bit "565" numbers: 5 bits of red, 6 of green and 5 of blue. ST77XX_GREEN and the other names are ready-made ones, and color565(r, g, b) turns three 0 to 255 values into one, which is how the sketch makes its changing square.
O sketch
Adafruit_ST7735 small(10, 9, 8) recebe CS, DC e RESET e usa o SPI de hardware do Uno para o clock e os dados, pinos 13 e 11. initR(INITR_BLACKTAB) desperta o chip e o configura para o painel, e depois as chamadas de sempre da Adafruit GFX desenham: fillScreen, setCursor, print, fillRect.
A ST7789 usa o construtor de cinco números, Adafruit_ST7789 square(-1, 7, A0, A1, 6): sem CS (-1), DC no 7, dados no A0, clock no A1 e RES no 6. Com pinos próprios de clock e dados, a biblioteca envia cada bit manualmente, o que funciona em qualquer pino e é bem mais lento que o SPI de hardware. Isso, junto com a inicialização mais demorada da ST7789, faz com que ela acenda cerca de dois segundos depois da ST7735.
#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Adafruit_ST7789.h>
Adafruit_ST7735 small(10, 9, 8);
Adafruit_ST7789 square(-1, 7, A0, A1, 6); // no CS; DC, SDA, SCL, RES
void setup() {
small.initR(INITR_BLACKTAB);
small.fillScreen(ST77XX_BLACK);
small.setTextColor(ST77XX_GREEN);
small.setCursor(4, 4);
small.print("ST7735 128X160");
square.init(240, 240, SPI_MODE3);
square.setRotation(2);
square.fillRect(0, 0, 240, 40, ST77XX_BLUE);
square.setTextColor(ST77XX_WHITE);
square.setTextSize(2);
square.setCursor(8, 12);
square.print("ST7789 IPS");
}
void loop() {
// A block that walks around each screen, in a color that changes as it goes.
static uint8_t step = 0;
uint16_t color = Adafruit_ST7789::color565((uint8_t)(step * 16), 255 - step * 16, 128);
small.fillRect((int16_t)(8 + (step % 8) * 14), 40, 12, 12, color);
square.fillRect((int16_t)(10 + (step % 8) * 28), 120, 24, 24, color);
step = (uint8_t)((step + 1) % 16);
delay(100);
}Abrir este sketch no editorSó o código: o editor posiciona a placa e os componentes que ele consegue ler do sketch.
Abas preta, verde e vermelha
A memória do chip tem 132 por 162, um pouco maior que o vidro de 128 por 160, e os fabricantes montam o vidro em posições ligeiramente diferentes dentro dela. Eles marcam qual foi usada com a cor da aba no filme protetor da tela, e a biblioteca tem uma configuração de initR para cada uma: INITR_BLACKTAB, INITR_GREENTAB e INITR_REDTAB, além de INITR_144GREENTAB para as quadradas de 1,44 polegada.
Escolha a errada e a imagem fica deslocada: uma faixa de ruÃdo ou preta ao longo de duas bordas, ou vermelho e azul trocados. Se for isso que você vê, teste as outras abas antes de suspeitar da ligação. Tirou o filme e perdeu a aba? Teste uma por uma; uma delas vai desenhar bordas limpas.
ST7735 ou ST7789?
A ST7789 entende quase os mesmos comandos, então o código quase não muda, mas ela aciona vidros IPS maiores e mais nÃtidos: 240 por 240 nas placas quadradas de 1,3 polegada, 240 por 320 em outras. Painéis IPS parecem iguais de qualquer ângulo, enquanto o vidro mais barato da ST7735 desbota quando inclinado.
Muitas placas ST7789 de 1,3 polegada não têm pino CS, então o chip escuta todo clock que chega em seus fios. Coloque uma no mesmo barramento SPI de outra tela e ela vai tomar os bytes daquela tela como seus, e é por isso que a daqui tem pinos próprios. Elas também pedem o modo 3 de SPI, o terceiro número em init(240, 240, SPI_MODE3).
Para uma tela ainda maior, as placas de 2,4 e 2,8 polegadas usam um ILI9341 a 240 por 320, com toque em muitas delas. Há uma página sobre isso abaixo.
Erros comuns
Tela escura com a luz de fundo acesa. Normalmente A0 (DC) ou CS não está conectado, ou está no pino errado. Solte qualquer um deles no circuito acima e a ST7735 não mostra nada.
Tratar SDA e SCK como I2C por causa dos nomes. Eles são SPI: SDA vai no pino 11 (MOSI) e SCK no pino 13 de um Uno.
A aba errada em initR, causando imagens deslocadas ou bordas com ruÃdo. Teste as outras.
Alimentar os pinos de sinal a 5 V permanentemente. O regulador da placa vermelha fornece 3,3 V ao chip, mas os pinos de sinal vão direto a ele, e a ST7735 é um componente de 3,3 V. Muita gente usa com um Uno de 5 V mesmo assim; um conversor de nÃvel, ou uma placa de 3,3 V, é o caminho seguro.
Deixar RESET flutuando. No circuito acima o sketch ainda inicia com RESET desconectado, porque initR envia primeiro um reset por software, mas um pino flutuando numa placa real pode captar ruÃdo e reiniciar o chip sem aviso. Ligue-o a um pino ou ao VCC.
Redesenhar a tela inteira a cada loop. Um preenchimento total de 128 por 160 são 40.960 bytes pelo fio; desenhe só o que mudou.
Abra este circuito no editor. Arduino Uno: uma ST7735 e uma ST7789, ligadas como no circuito que roda no topo desta página. Troque um componente ou um valor e rode de novo.
Abrir o circuitoPerguntas
Como conectar uma ST7735 a um Arduino Uno?
VCC no 5 V, GND no GND, SCK no 13, SDA no 11, CS no 10, A0 (DC) no 9, RESET no 8 e LED no 5 V. Depois Adafruit_ST7735 tft(10, 9, 8) e tft.initR(INITR_BLACKTAB).
De qual biblioteca eu preciso para a ST7735?
Adafruit ST7735 and ST7789 Library, junto com a Adafruit GFX para as chamadas de desenho. A mesma biblioteca aciona os dois chips.
Por que minha tela ST7735 fica branca ou vazia?
Tela branca é a luz de fundo acesa sem nada desenhado: confira CS, A0 (DC) e RESET, e se o sketch chama initR. Imagens deslocadas ou bordas com ruÃdo indicam a configuração de aba errada.
Posso usar o slot de cartão SD atrás da placa?
Sim, numa placa real: ele compartilha SCK, MOSI e MISO, com seu próprio pino CS. A placa simulada não inclui o cartão SD.
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.