Pinout do TTGO T-Display: todos os pinos, a tela e os dois botões
Iniciante
- 526componentes na bancada
- 46placas rodando agora
- 1.00xtempo real, em todas as placas
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.
| Pino | GPIO | O que ele pode fazer | Atenção a |
|---|---|---|---|
| GND | - | Terra. Quatro na fileira da esquerda e um na da direita. | - |
| 21 | 21 | PWM. I2C SDA (padrão). | - |
| 22 | 22 | PWM. I2C SCL (padrão). | - |
| 17 | 17 | PWM. | Um coringa seguro. |
| 2 | 2 | PWM. ADC2_CH2 e touch T2 no chip (não modelado). | Pino de strapping: precisa estar em nível baixo ou flutuando para fazer upload. |
| 15 | 15 | PWM. ADC2_CH3 e toque T3 no chip (não modelado). | Pino de strapping: nível baixo no reset silencia as mensagens de boot. |
| 13 | 13 | PWM. ADC2_CH4 e toque T4 no chip (não modelado). | O ADC2 para de funcionar enquanto o WiFi está ligado. |
| 12 | 12 | PWM. 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. |
| 36 | 36 | ADC1_CH0. Só entrada. | Sem driver de saída e sem pull-up ou pull-down interno. |
| 37 | 37 | ADC1_CH1. Só de entrada. | Sem driver de saída e sem pull-up ou pull-down interno. |
| 38 | 38 | ADC1_CH2. Só de entrada. | Sem driver de saída e sem pull-up ou pull-down interno. |
| 39 | 39 | ADC1_CH3. Só entrada. | Sem driver de saída e sem pull-up ou pull-down interno. |
| 32 | 32 | ADC1_CH4. PWM. Toque T9 (não modelado). | Um coringa seguro. |
| 33 | 33 | ADC1_CH5. PWM. Toque T8 (não modelado). | Um coringa seguro. |
| 25 | 25 | PWM. DAC1 e ADC2_CH8 no chip (não modelado). | O ADC2 para de funcionar enquanto o WiFi está ligado. |
| 26 | 26 | PWM. DAC2 e ADC2_CH9 no chip (não modelado). | O ADC2 para de funcionar enquanto o WiFi está ligado. |
| 27 | 27 | PWM. 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.
| GPIO | Ligado a | TFT_eSPI ou nome da variante | Notas |
|---|---|---|---|
| 19 | MOSI da tela | TFT_MOSI | - |
| 18 | SCLK da tela | TFT_SCLK | - |
| 5 | CS da tela | TFT_CS | Pino de strapping. |
| 16 | DC da tela | TFT_DC | - |
| 23 | Reset da tela | TFT_RST | - |
| 4 | Backlight da tela | TFT_BL | O init() do TFT_eSPI o coloca em HIGH. LOW desliga a imagem. |
| 35 | BUTTON1, o da direita | RIGHT_BUTTON | Só de entrada. Com pull-up na placa, modelado como 100 k. Lê LOW enquanto pressionado. |
| 0 | BUTTON2, o da esquerda, que é BOOT | LEFT_BUTTON | Pino de strapping: em LOW no reset, espera um upload. Use INPUT_PULLUP. |
| 34 | O divisor de tensão da bateria | - | Não modelado. Só de entrada. |
| 14 | Liga 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 circuitoPerguntas
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.
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.