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
- A página da placa: /boards/ttgo-t-display
- O pinout: /learn/ttgo-t-display-pinout
- The chip: o ESP32 DevKit V1, e seu documento de contrato, the ESP32 DevKit model
- Projeto inicial: T-Display hello