Aprender

Pinout del TTGO T-Display: todos los pines, la pantalla y los dos botones

Principiante

O mira todas las lecciones.

  • 526componentes en el banco de trabajo
  • 46placas funcionando ahora
  • 1.00xtiempo real, en todas las placas
TTGO T-Display: holaen vivo0.000 s 0.00x
Haz clic para abrirlo en el editor
TFT_eSPI escribe en la pantalla de 135x240 con la configuración de LilyGO. Presiona BUTTON2 (GPIO 0) o BUTTON1 (GPIO 35) para contar.

El LilyGO TTGO T-Display es un ESP32 clásico en una placa de 51.5 por 25 mm con una pantalla ST7789 de 1.14 pulgadas y 135x240, dos botones, un conector USB-C y un conector de batería. Sus dos filas de doce pines están a 0.9 pulgadas de distancia, y la serigrafía imprime los números de GPIO del chip, así que el pin marcado 21 es el GPIO 21 en el código. Esta página lista todos los pines del header, luego los GPIO que la placa usa internamente para la pantalla, los botones y la batería.

El circuito de arriba es la placa en Mokxi: TFT_eSPI escribe en la pantalla y cuenta las presiones de los dos botones. Todo lo que está en las tablas está verificado contra el modelo de placa que ejecuta el simulador, y donde Mokxi hace menos que la placa, la fila lo indica.

Cada pin del header

Con la pantalla frente a ti y el conector USB-C abajo, como lo dibuja Mokxi, la fila izquierda se lee GND, GND, 21, 22, 17, 2, 15, 13, 12, GND, GND y 3V3, y la fila derecha se lee 3V3, 36, 37, 38, 39, 32, 33, 25, 26, 27, GND y 5V. La tabla lista cada nombre una sola vez, así que los cinco pines GND y los dos pines 3V3 son una sola fila cada uno.

No hay pines TX, RX ni EN: el GPIO 1 y el 3 van solo al chip USB, y el reset es el botón. El táctil, el DAC y el ADC2 están en la tabla porque los tutoriales los usan; Mokxi no los modela, y cada fila lo indica.

TTGO T-Display: la fila izquierda, luego la derecha
PinGPIOQué puede hacerTen cuidado con
GND-Tierra. Cuatro en la fila izquierda y uno en la derecha.-
2121PWM. I2C SDA (por defecto).-
2222PWM. I2C SCL (por defecto).-
1717PWM.Un pin seguro para todo.
22PWM. ADC2_CH2 y táctil T2 en el chip (no modelado).Pin de arranque: debe estar en bajo o flotante para cargar.
1515PWM. ADC2_CH3 y táctil T3 en el chip (no modelado).Pin de arranque: en bajo al reiniciar silencia los mensajes de arranque.
1313PWM. ADC2_CH4 y táctil T4 en el chip (no modelado).El ADC2 deja de funcionar mientras el WiFi está encendido.
1212PWM. ADC2_CH5 y táctil T5 en el chip (no modelado).Pin de arranque: en alto al reiniciar y la placa no arranca.
3V3-La salida de 3.3 V del regulador. Una al final de cada fila.No es un GPIO.
3636ADC1_CH0. Solo entrada.Sin driver de salida ni pull-up o pull-down interno.
3737ADC1_CH1. Solo entrada.Sin driver de salida ni pull-up o pull-down interno.
3838ADC1_CH2. Solo entrada.Sin driver de salida ni pull-up o pull-down interno.
3939ADC1_CH3. Solo entrada.Sin driver de salida ni pull-up o pull-down interno.
3232ADC1_CH4. PWM. Táctil T9 (no modelado).Un pin seguro para todo.
3333ADC1_CH5. PWM. Táctil T8 (no modelado).Un pin seguro para todo.
2525PWM. DAC1 y ADC2_CH8 en el chip (no modelado).El ADC2 deja de funcionar mientras el WiFi está encendido.
2626PWM. DAC2 y ADC2_CH9 en el chip (no modelado).El ADC2 deja de funcionar mientras el WiFi está encendido.
2727PWM. ADC2_CH7 y táctil T7 en el chip (no modelado).El ADC2 deja de funcionar mientras el WiFi está encendido.
5V-El riel de 5 V del USB. Pon 5 V aquí para alimentar la placa sin cable.No es un GPIO.

Los GPIO que la placa usa internamente

Estos están conectados a la pantalla, los botones y la batería, y el header no los expone. En Mokxi ningún cable puede llegar a ellos. Los pines de la pantalla son de la tabla propia de LilyGO, y el entorno de ejecución nombra los botones como lo hace la variante lilygo_t_display de arduino-esp32: LEFT_BUTTON es 0 y RIGHT_BUTTON es 35.

TTGO T-Display: los GPIO dentro de la placa
GPIOConectado aTFT_eSPI o nombre de la varianteNotas
19MOSI de la pantallaTFT_MOSI-
18SCLK de la pantallaTFT_SCLK-
5CS de la pantallaTFT_CSPin de strapping.
16DC de la pantallaTFT_DC-
23Reset de la pantallaTFT_RST-
4Retroiluminación de la pantallaTFT_BLEl init() de TFT_eSPI lo pone en HIGH. LOW apaga la imagen.
35BUTTON1, el de la derechaRIGHT_BUTTONSolo entrada. Con pull-up en la placa, modelado como 100 k. Lee LOW mientras está presionado.
0BUTTON2, el de la izquierda, que es BOOTLEFT_BUTTONPin de strapping: bajo al reiniciar espera una carga. Usa INPUT_PULLUP.
34El divisor de voltaje de la batería-No modelado. Solo entrada.
14Activa el divisor de la batería-Sin modelar.

Alimentación: 5V, 3V3 y GND

5V es el riel del USB cuando hay un cable conectado, y una entrada cuando no lo hay. 3V3 es la salida del regulador, que también alimenta la pantalla, así que sirve para un sensor y no para un motor. El conector de la batería alimenta un cargador en la placa real; Mokxi no modela ninguno de los dos, y la placa funciona desde el USB mientras dure la simulación.

Cada GPIO es de 3.3 V y ninguno tolera 5 V. La salida de un módulo de 5 V necesita un divisor o un desplazador de nivel antes de llegar a un pin.

La pantalla y la configuración de TFT_eSPI

La pantalla es una ST7789, de 135 por 240, en MOSI 19, SCLK 18, CS 5, DC 16 y RST 23, con la retroiluminación en GPIO 4. LilyGO incluye una configuración de TFT_eSPI para ella, Setup25_TTGO_T_Display.h. En una placa real esa configuración se instala en la carpeta de la biblioteca TFT_eSPI: en User_Setup_Select.h, comenta la predeterminada e incluye Setup25_TTGO_T_Display.h.

En Mokxi un sketch para esta placa no necesita User_Setup.h. Si no nombra pines de la TFT, TFT_eSPI toma la configuración de la placa: ST7789_DRIVER a 135x240, MOSI 19, SCLK 18, CS 5, DC 16, RST 23 y BL 4.

Dos cosas atrapan a un controlador escrito a mano. La ST7789 tiene 240 por 320 píxeles de memoria, y este cristal es una ventana hacia ella desde la columna 52 y la fila 40, así que un controlador sin esos desplazamientos dibuja donde nadie puede ver. Y el cristal es IPS, así que muestra los colores invertidos hasta que el controlador envía INVON. TFT_eSPI maneja ambas cosas, y Mokxi modela ambas, así que un controlador que está mal en la placa también está mal aquí.

Los dos botones

Ambos botones ponen su pin en LOW mientras están presionados. BUTTON1, a la derecha, es el GPIO 35. El GPIO 35 es solo de entrada y no tiene pull propio, así que la placa lleva una pull-up, y basta con pinMode(35, INPUT). BUTTON2, a la izquierda, es el GPIO 0, el botón BOOT, así que usa pinMode(0, INPUT_PULLUP) y no lo mantengas presionado al encender.

En Mokxi puedes presionar cualquiera de los botones en el dibujo mientras el circuito se ejecuta. La placa no tiene LED de usuario, así que no existe LED_BUILTIN, igual que en la variante de arduino-esp32 para ella.

Analógico, PWM, I2C y 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.

El PWM es LEDC, en cualquier pin con driver de salida. Wire.begin() usa 21 para SDA y 22 para SCL. SPI.begin() sin pines usa 18, 19, 23 y 5, que en esta placa son las líneas de la pantalla, así que para un segundo dispositivo SPI nombra pines libres, como SPI.begin(25, 27, 26, 33) para SCK, MISO, MOSI y SS. En Mokxi ambos buses corren por software, porque los controladores de I2C y SPI del chip no están modelados.

Abre este circuito en el editor. TTGO T-Display: hello, cableado tal como corre arriba en esta página. Cambia un componente o un valor y ejecútalo de nuevo.

Abrir el circuito

Preguntas

¿En qué pines está la pantalla del T-Display?

MOSI 19, SCLK 18, CS 5, DC 16 y RST 23, con la retroiluminación en 4. Ninguno está en el header.

¿Cuáles pines son los botones del T-Display?

BUTTON1, el de la derecha, es el GPIO 35, con una pull-up en la placa. BUTTON2, el de la izquierda, es el GPIO 0, que es BOOT. Ambos leen LOW mientras se presionan.

¿Cuáles pines son I2C en el TTGO T-Display?

SDA es 21 y SCL es 22, los pines que usa `Wire.begin()`. Ambos están en la fila izquierda.

¿Cuáles pines del T-Display son analógicos?

ADC1 está en 32, 33, 36, 37, 38 y 39, y esos siguen funcionando con el WiFi activado. Mantén la señal por debajo de 3.3 V.

¿Qué pin del T-Display uso para un botón?

17, 21, 22, 25 a 27, 32 o 33, con `INPUT_PULLUP` y el botón a tierra. A 36 a 39 les falta una pull-up de 10 k propia, y 2, 12 y 15 son pines de strapping.

¿Cómo leo el voltaje de la batería del T-Display?

En la placa real, pon el GPIO 14 en HIGH para activar el divisor y lee el GPIO 34. Mokxi no modela la batería, su cargador ni el divisor.

Ármalo en la vida real

Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.