Aprender

Pinout do TTGO T-Display: todos os pinos, a tela e os dois botões

Iniciante

Ou veja todas as aulas.

  • 526componentes na bancada
  • 46placas rodando agora
  • 1.00xtempo real, em todas as placas
TTGO T-Display: helloao vivo0.000 s 0.00x
Clique para abrir no editor
O TFT_eSPI escreve na tela de 135x240 com a configuração da LilyGO. Aperte BUTTON2 (GPIO 0) ou BUTTON1 (GPIO 35) para contar.

O LilyGO TTGO T-Display é um clássico ESP32 numa placa de 51,5 por 25 mm com uma tela ST7789 de 1,14 polegada e 135x240, dois botões, um conector USB-C e um conector de bateria. Suas duas fileiras de doze pinos ficam a 0,9 polegada de distância, e a serigrafia imprime os números de GPIO do chip, então o pino marcado 21 é o GPIO 21 no código. Esta página lista todos os pinos do header e, depois, os GPIOs que a placa usa internamente para a tela, os botões e a bateria.

O circuito acima é a placa no Mokxi: o TFT_eSPI escreve na tela e conta os apertos dos dois botões. Tudo nas tabelas foi conferido com o modelo de placa que o simulador roda, e onde o Mokxi faz menos que a placa, a linha avisa.

Cada pino do conector

Com a tela virada para você e o conector USB-C embaixo, como o Mokxi desenha, a fileira da esquerda lê GND, GND, 21, 22, 17, 2, 15, 13, 12, GND, GND e 3V3, e a da direita lê 3V3, 36, 37, 38, 39, 32, 33, 25, 26, 27, GND e 5V. A tabela lista cada nome uma vez, então os cinco pinos GND e os dois pinos 3V3 viram uma linha cada.

Não há pinos TX, RX ou EN: os GPIO 1 e 3 vão só para o chip USB, e o reset é o botão. O touch, o DAC e o ADC2 estão na tabela porque tutoriais os usam; o Mokxi não os modela, e cada linha avisa.

TTGO T-Display: a fileira da esquerda, depois a da direita
PinoGPIOO que ele pode fazerAtenção a
GND-Terra. Quatro na fileira da esquerda e um na da direita.-
2121PWM. I2C SDA (padrão).-
2222PWM. I2C SCL (padrão).-
1717PWM.Um coringa seguro.
22PWM. ADC2_CH2 e touch T2 no chip (não modelado).Pino de strapping: precisa estar em nível baixo ou flutuando para fazer upload.
1515PWM. ADC2_CH3 e toque T3 no chip (não modelado).Pino de strapping: nível baixo no reset silencia as mensagens de boot.
1313PWM. ADC2_CH4 e toque T4 no chip (não modelado).O ADC2 para de funcionar enquanto o WiFi está ligado.
1212PWM. ADC2_CH5 e toque T5 no chip (não modelado).Pino de strapping: nível alto no reset e a placa não inicia.
3V3-A saída de 3,3 V do regulador. Um no fim de cada fileira.Não é um GPIO.
3636ADC1_CH0. Só entrada.Sem driver de saída e sem pull-up ou pull-down interno.
3737ADC1_CH1. Só de entrada.Sem driver de saída e sem pull-up ou pull-down interno.
3838ADC1_CH2. Só de entrada.Sem driver de saída e sem pull-up ou pull-down interno.
3939ADC1_CH3. Só entrada.Sem driver de saída e sem pull-up ou pull-down interno.
3232ADC1_CH4. PWM. Toque T9 (não modelado).Um coringa seguro.
3333ADC1_CH5. PWM. Toque T8 (não modelado).Um coringa seguro.
2525PWM. DAC1 e ADC2_CH8 no chip (não modelado).O ADC2 para de funcionar enquanto o WiFi está ligado.
2626PWM. DAC2 e ADC2_CH9 no chip (não modelado).O ADC2 para de funcionar enquanto o WiFi está ligado.
2727PWM. ADC2_CH7 e toque T7 no chip (não modelado).O ADC2 para de funcionar enquanto o WiFi está ligado.
5V-O trilho de 5 V do USB. Ponha 5 V aqui para rodar a placa sem cabo.Não é um GPIO.

Os GPIOs que a placa usa internamente

Estes são ligados à tela, aos botões e à bateria, e o header não os traz para fora. No Mokxi, nenhum fio consegue alcançá-los. Os pinos da tela vêm da tabela da própria LilyGO, e o runtime nomeia os botões como a variante lilygo_t_display do arduino-esp32 faz: LEFT_BUTTON é 0 e RIGHT_BUTTON é 35.

TTGO T-Display: os GPIOs dentro da placa
GPIOLigado aTFT_eSPI ou nome da varianteNotas
19MOSI da telaTFT_MOSI-
18SCLK da telaTFT_SCLK-
5CS da telaTFT_CSPino de strapping.
16DC da telaTFT_DC-
23Reset da telaTFT_RST-
4Backlight da telaTFT_BLO init() do TFT_eSPI o coloca em HIGH. LOW desliga a imagem.
35BUTTON1, o da direitaRIGHT_BUTTONSó de entrada. Com pull-up na placa, modelado como 100 k. Lê LOW enquanto pressionado.
0BUTTON2, o da esquerda, que é BOOTLEFT_BUTTONPino de strapping: em LOW no reset, espera um upload. Use INPUT_PULLUP.
34O divisor de tensão da bateria-Não modelado. Só de entrada.
14Liga o divisor da bateria-Não modelado.

Alimentação: 5V, 3V3 e GND

5V é o barramento do USB quando um cabo está conectado, e uma entrada quando não está. 3V3 é a saída do regulador, que também alimenta a tela, então serve para um sensor e não para um motor. O conector da bateria alimenta um carregador na placa real; o Mokxi não modela nenhum dos dois, e a placa funciona via USB enquanto a simulação roda.

Cada GPIO é de 3,3 V e nenhum tolera 5 V. A saída de um módulo de 5 V precisa de um divisor ou de um conversor de nível antes de chegar a um pino.

A tela e a configuração do TFT_eSPI

A tela é uma ST7789, 135 por 240, em MOSI 19, SCLK 18, CS 5, DC 16 e RST 23, com o backlight no GPIO 4. A LilyGO fornece uma configuração TFT_eSPI para ela, Setup25_TTGO_T_Display.h. Numa placa real você instala essa configuração na pasta da biblioteca TFT_eSPI: em User_Setup_Select.h, comente a padrão e inclua Setup25_TTGO_T_Display.h.

No Mokxi um sketch para esta placa não precisa de User_Setup.h. Se ele não citar pinos de TFT, o TFT_eSPI recebe a configuração da placa: ST7789_DRIVER a 135x240, MOSI 19, SCLK 18, CS 5, DC 16, RST 23 e BL 4.

Duas coisas pegam um driver escrito à mão. A 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 sem esses deslocamentos desenha onde ninguém consegue ver. E o vidro é IPS, então mostra as cores invertidas até o driver enviar INVON. O TFT_eSPI cuida de ambos, e o Mokxi modela ambos, então um driver que está errado na placa está errado aqui também.

Os dois botões

Os dois botões puxam o pino para LOW enquanto pressionados. O BUTTON1, à direita, é o GPIO 35. O GPIO 35 é só entrada e não tem pull-up próprio, então a placa carrega um pull-up, e pinMode(35, INPUT) basta. O BUTTON2, à esquerda, é o GPIO 0, o botão BOOT, então use pinMode(0, INPUT_PULLUP) e não o mantenha pressionado na inicialização.

No Mokxi você aperta qualquer um dos botões no desenho enquanto o circuito roda. A placa não tem LED de usuário, então não existe LED_BUILTIN, como na variante do arduino-esp32 para ela.

Analógico, PWM, I2C e SPI

Only ADC1 is safe in a project with WiFi: on a real ESP32 the radio uses ADC2. ADC1 is on six pins here: 36, 37, 38, 39, 32 and 33. Mokxi models ADC1 only, twelve bits, with a real part’s curve at the default 11 dB. GPIO 34, which is ADC1 as well, is the battery divider on this board and is not on the header.

O PWM é LEDC, em qualquer pino com driver de saída. Wire.begin() usa 21 para SDA e 22 para SCL. SPI.begin() sem pinos usa 18, 19, 23 e 5, que nesta placa são as linhas da tela, então para um segundo dispositivo SPI cite pinos livres, como SPI.begin(25, 27, 26, 33) para SCK, MISO, MOSI e SS. No Mokxi os dois barramentos rodam em software, porque os controladores de I2C e SPI do chip não são modelados.

Abra este circuito no editor. TTGO T-Display: hello, ligado como roda no topo desta página. Troque um componente ou um valor e rode de novo.

Abrir o circuito

Perguntas

Em quais pinos está a tela do T-Display?

MOSI 19, SCLK 18, CS 5, DC 16 e RST 23, com o backlight no 4. Nenhum deles está no header.

Quais pinos são os botões do T-Display?

O BUTTON1, o da direita, é o GPIO 35, com um pull-up na placa. O BUTTON2, o da esquerda, é o GPIO 0, que é o BOOT. Os dois leem LOW enquanto pressionados.

Quais pinos são I2C no TTGO T-Display?

SDA é 21 e SCL é 22, os pinos que `Wire.begin()` usa. Os dois estão na fileira esquerda.

Quais pinos do T-Display são analógicos?

O ADC1 está em 32, 33, 36, 37, 38 e 39, e esses continuam funcionando com o WiFi ligado. Mantenha o sinal abaixo de 3,3 V.

Qual pino do T-Display devo usar para um botão?

17, 21, 22, 25 a 27, 32 ou 33, com `INPUT_PULLUP` e o botão para o terra. 36 a 39 precisam de um pull-up de 10 k seu, e 2, 12 e 15 são pinos de strapping.

Como leio a tensão da bateria do T-Display?

Na placa real, coloque o GPIO 14 em HIGH para ligar o divisor e leia o GPIO 34. O Mokxi não modela a bateria, o carregador dela nem o divisor.

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.