Placas

A LilyGO TTGO T-Display

Um ESP32 clássico com uma tela colorida ST7789 de 1,14 polegada e 135x240 em suas próprias linhas SPI, e dois botões, no GPIO 0 e no GPIO 35.

A visão geral, com exemplos rodando, está na página da placa.

O que é

The same classic ESP32 as o ESP32 DevKit V1, on a black board 51.5 by 25 mm with the screen filling the middle. Two twelve-pin rows run down the long edges, 0.9 inch apart, so it straddles a breadboard with one row free on each side. A USB-C socket goes to UART0, which is the serial monitor, and a small JST socket takes a LiPo cell.

A tela e os dois botões já vêm ligados dentro da placa, como na placa real, então um primeiro sketch não precisa de outros componentes. A placa não tem LED de usuário.

Os pinos

Os números na serigrafia são os números de GPIO. De cima para baixo, como no desenho, com a tela de frente para você e o soquete USB-C embaixo:

Esquerda Direita
GND 3V3
GND 36
21 37
22 38
17 39
2 32
15 33
13 25
12 26
GND 27
GND GND
3V3 5V

36, 37, 38 e 39 são somente entrada, sem pull-up ou pull-down próprios. A biblioteca Wire usa 21 para SDA e 22 para SCL. Não há pinos TX ou RX: os GPIO 1 e 3 vão só para o chip USB. Também não há pino EN. 5V é o barramento do USB.

2, 12 e 15 são pinos de strapping no chip. O Mokxi não modela strapping, então a placa inicia com o que estiver ligado ali; em uma bancada, um pull-up no 12 impede que ela dê boot.

Os GPIOs dentro da placa

Estes já vêm ligados aos componentes da placa e nenhum fio consegue alcançá-los.

GPIO Ao que está ligado
19 MOSI da tela
18 SCLK da tela
5 CS da tela
16 DC da tela
23 Reset da tela
4 Backlight da tela
35 BUTTON1, com um pull-up na placa
0 BUTTON2, que é o BOOT
34 O divisor da bateria (não modelado)
14 Comuta o divisor da bateria (não modelado)

SPI.begin() sem pinos usa 18, 19, 23 e 5, que nesta placa são as linhas da tela. Para um segundo dispositivo SPI, indique pinos livres: SPI.begin(sck, miso, mosi, ss).

The screen

A tela é o componente ST7789 no seu tamanho 135x240. O ST7789 tem 240 por 320 pixels de memória, e este vidro é uma janela para ela a partir da coluna 52 e da linha 40, então um driver precisa somar esses deslocamentos ou desenha onde ninguém vê. O vidro é IPS e mostra as cores do controlador invertidas até o driver enviar INVON. A TFT_eSPI faz as duas coisas, como todo driver de ST7789 faz. Um driver escrito à mão que deixar o INVON de fora gera um negativo fotográfico, aqui como na placa.

Um sketch para esta placa não precisa de User_Setup.h aqui. A LilyGO distribui uma configuração da TFT_eSPI para a placa, Setup25_TTGO_T_Display.h, e o Mokxi já a tem incluída. Se o sketch não nomear pinos da TFT, a TFT_eSPI usa os da placa:

#define ST7789_DRIVER
#define TFT_WIDTH 135
#define TFT_HEIGHT 240
#define CGRAM_OFFSET
#define TFT_MOSI 19
#define TFT_SCLK 18
#define TFT_CS 5
#define TFT_DC 16
#define TFT_RST 23
#define TFT_BL 4
#define TFT_BACKLIGHT_ON HIGH

Em uma placa real você instala essa configuração na pasta da biblioteca TFT_eSPI: em User_Setup_Select.h, comente a padrão e use Setup25_TTGO_T_Display.h. Um sketch que nomeia os próprios pinos os mantém.

#include <TFT_eSPI.h>

TFT_eSPI tft = TFT_eSPI();

void setup() {
  tft.init();
  tft.setRotation(1); // landscape, 240 wide
  tft.fillScreen(TFT_BLACK);
  tft.drawString("T-Display", 20, 20, 4);
}

O backlight está no GPIO 4, e o init() da TFT_eSPI o liga, como no upstream. Coloque-o em LOW e a imagem apaga. O painel não pode ser lido de volta: readPixel() na tela dá preto.

The buttons

Os dois botões colocam o pino em LOW enquanto pressionados. Aperte qualquer um deles no desenho enquanto o circuito roda para mantê-lo pressionado.

  • BUTTON1, o da direita, é o GPIO 35. O GPIO 35 é somente entrada e não tem pull próprio, então a placa tem um pull-up, modelado como 100 k. pinMode(35, INPUT) é suficiente.
  • BUTTON2, o da esquerda, é o GPIO 0, que também é o BOOT. Use pinMode(0, INPUT_PULLUP).

O runtime os nomeia como a variante lilygo_t_display do arduino-esp32 faz: LEFT_BUTTON é 0 e RIGHT_BUTTON é 35. Não há LED_BUILTIN, como nessa variante.

WiFi

Ele entra na rede simulada do Mokxi, com o nome da rede e a senha como propriedades da placa. Não há rádio, nem 802.11, nem internet de verdade: WiFi simulado diz o que é fiel e o que não é.

What is modeled

O chip do modelo DevKit V1, inteiro: um núcleo Xtensa LX6, GPIO, UART0, os temporizadores, ADC1 e PWM LEDC. A tela é o componente ST7789 em 135x240, com seus deslocamentos de janela e seu vidro inversor, nos GPIOs aos quais a placa a liga. BUTTON1 é um botão de pressão com pull-up de 100 k, e BUTTON2 é o BOOT da placa. A placa tem sua própria string de programa, então recebe seus próprios exemplos, e a TFT_eSPI usa a configuração da LilyGO. Os sketches compilam na aba.

O que não é modelado

  • The battery connector and its charger.
  • The battery divider on GPIO 34, switched by GPIO 14.
  • Ler o painel de volta: devolve preto.
  • The second core, ADC2, the DAC, touch sensing and a real radio. Bluetooth Classic and LE are simulados, como no DevKit V1.

Projeto inicial

T-Display hello escreve na tela com a TFT_eSPI e conta os apertos nos dois botões.

Em outros lugares