Pinout del TTGO T-Display: todos los pines, la pantalla y los dos botones
Principiante
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
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.
| Pin | GPIO | Qué puede hacer | Ten cuidado con |
|---|---|---|---|
| GND | - | Tierra. Cuatro en la fila izquierda y uno en la derecha. | - |
| 21 | 21 | PWM. I2C SDA (por defecto). | - |
| 22 | 22 | PWM. I2C SCL (por defecto). | - |
| 17 | 17 | PWM. | Un pin seguro para todo. |
| 2 | 2 | PWM. ADC2_CH2 y táctil T2 en el chip (no modelado). | Pin de arranque: debe estar en bajo o flotante para cargar. |
| 15 | 15 | PWM. ADC2_CH3 y táctil T3 en el chip (no modelado). | Pin de arranque: en bajo al reiniciar silencia los mensajes de arranque. |
| 13 | 13 | PWM. ADC2_CH4 y táctil T4 en el chip (no modelado). | El ADC2 deja de funcionar mientras el WiFi está encendido. |
| 12 | 12 | PWM. 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. |
| 36 | 36 | ADC1_CH0. Solo entrada. | Sin driver de salida ni pull-up o pull-down interno. |
| 37 | 37 | ADC1_CH1. Solo entrada. | Sin driver de salida ni pull-up o pull-down interno. |
| 38 | 38 | ADC1_CH2. Solo entrada. | Sin driver de salida ni pull-up o pull-down interno. |
| 39 | 39 | ADC1_CH3. Solo entrada. | Sin driver de salida ni pull-up o pull-down interno. |
| 32 | 32 | ADC1_CH4. PWM. Táctil T9 (no modelado). | Un pin seguro para todo. |
| 33 | 33 | ADC1_CH5. PWM. Táctil T8 (no modelado). | Un pin seguro para todo. |
| 25 | 25 | PWM. DAC1 y ADC2_CH8 en el chip (no modelado). | El ADC2 deja de funcionar mientras el WiFi está encendido. |
| 26 | 26 | PWM. DAC2 y ADC2_CH9 en el chip (no modelado). | El ADC2 deja de funcionar mientras el WiFi está encendido. |
| 27 | 27 | PWM. 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.
| GPIO | Conectado a | TFT_eSPI o nombre de la variante | Notas |
|---|---|---|---|
| 19 | MOSI de la pantalla | TFT_MOSI | - |
| 18 | SCLK de la pantalla | TFT_SCLK | - |
| 5 | CS de la pantalla | TFT_CS | Pin de strapping. |
| 16 | DC de la pantalla | TFT_DC | - |
| 23 | Reset de la pantalla | TFT_RST | - |
| 4 | Retroiluminación de la pantalla | TFT_BL | El init() de TFT_eSPI lo pone en HIGH. LOW apaga la imagen. |
| 35 | BUTTON1, el de la derecha | RIGHT_BUTTON | Solo entrada. Con pull-up en la placa, modelado como 100 k. Lee LOW mientras está presionado. |
| 0 | BUTTON2, el de la izquierda, que es BOOT | LEFT_BUTTON | Pin de strapping: bajo al reiniciar espera una carga. Usa INPUT_PULLUP. |
| 34 | El divisor de voltaje de la batería | - | No modelado. Solo entrada. |
| 14 | Activa 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 circuitoPreguntas
¿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.
Sigue así
Á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.