Aprender

Um TFT colorido ST7735 em um Arduino

Avançado

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
Arduino Uno: um ST7735 e um ST7789ao vivo0.000 s 0.00x
Clique para abrir no editor
O exemplo Two color screens: um ST7735 de 1,8 polegada no SPI de hardware e um ST7789 de 1,3 polegada em pinos próprios.

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 pinoVai paraNota
ST7735 VCC5 VA placa vermelha tem um regulador para o chip
ST7735 GNDGND
ST7735 SCKPino 13O clock do SPI de hardware
ST7735 SDAPino 11Dados SPI (MOSI). Não é I2C, apesar do que diz o rótulo
ST7735 CSPino 10Seleção de chip
ST7735 A0Pino 9O que outras placas chamam de DC: comando ou dado
ST7735 RESETPino 8
ST7735 LED5 VA luz de fundo
ST7789 SCL e SDAA1 e A0SPI por software em qualquer pino
ST7789 DC e RESPinos 7 e 6Essa 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.

O sketch das duas telas coloridas
#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 circuito

Perguntas

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.

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.