Placas

La LilyGO TTGO T-Display

Un ESP32 clásico con una pantalla a color ST7789 de 1.14 pulgadas y 135x240 en sus propias líneas SPI, y dos botones, en el GPIO 0 y el GPIO 35.

La descripción general, con ejemplos en ejecución, está en la página de la placa.

Qué es

The same classic ESP32 as la 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.

La pantalla y ambos botones están cableados dentro de la placa, como en la real, así que un primer sketch no necesita otros componentes. La placa no tiene LED de usuario.

Los pines

Los números del serigrafiado son los números de GPIO. De arriba abajo como aparecen en el dibujo, con la pantalla frente a ti y el conector USB-C abajo:

Izquierda Derecha
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 y 39 son solo de entrada, sin pull-up ni pull-down propios. Wire usa 21 para SDA y 22 para SCL. No hay pines TX ni RX: los GPIO 1 y 3 van solo al chip USB. Tampoco hay pin EN. 5V es el riel de USB.

2, 12 y 15 son pines de arranque (strapping) del chip. Mokxi no modela el strapping, así que la placa arranca con lo que haya conectado ahí; en un escritorio, un pull-up en 12 impide que arranque.

Los GPIO dentro de la placa

Estos van cableados a los componentes de la placa y ningún cable puede alcanzarlos.

GPIO A qué está conectado
19 MOSI de la pantalla
18 SCLK de la pantalla
5 CS de la pantalla
16 DC de la pantalla
23 Reset de la pantalla
4 Retroiluminación de la pantalla
35 BUTTON1, con un pull-up en la placa
0 BUTTON2, que es BOOT
34 El divisor de la batería (no modelado)
14 Conmuta el divisor de la batería (no modelado)

SPI.begin() sin pines usa 18, 19, 23 y 5, que en esta placa son las líneas de la pantalla. Para un segundo dispositivo SPI, indica pines libres: SPI.begin(sck, miso, mosi, ss).

The screen

La pantalla es el componente ST7789 en su tamaño de 135x240. El 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 driver tiene que sumar esos desplazamientos o dibuja donde nadie puede ver. El cristal es IPS y muestra los colores del controlador invertidos hasta que el driver envía INVON. TFT_eSPI hace ambas cosas, como todo driver de ST7789. Un driver escrito a mano que omita INVON obtiene un negativo fotográfico, aquí igual que en la placa.

Un sketch para esta placa no necesita User_Setup.h aquí. LilyGO distribuye una configuración de TFT_eSPI para la placa, Setup25_TTGO_T_Display.h, y Mokxi la trae integrada. Si el sketch no nombra pines de TFT, TFT_eSPI toma los de la 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

En una placa real instalas esa configuración en la carpeta de la biblioteca TFT_eSPI: en User_Setup_Select.h, comenta la predeterminada y usa Setup25_TTGO_T_Display.h. Un sketch que nombra sus propios pines los conserva.

#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);
}

La retroiluminación está en el GPIO 4, y init() de TFT_eSPI la enciende, igual que en el original. Ponla en LOW y la imagen se apaga. El panel no se puede leer: readPixel() sobre la pantalla da negro.

The buttons

Ambos botones ponen su pin en LOW mientras se mantienen presionados. Mantén presionado cualquiera de los dos en el dibujo mientras el circuito se ejecuta para sostenerlo.

  • BUTTON1, el de la derecha, es el GPIO 35. El GPIO 35 es solo de entrada y no tiene pull propio, así que la placa lleva un pull-up, modelado como 100 k. Basta con pinMode(35, INPUT).
  • BUTTON2, el de la izquierda, es el GPIO 0, que también es BOOT. Usa pinMode(0, INPUT_PULLUP).

El entorno los nombra como lo hace la variante lilygo_t_display de arduino-esp32: LEFT_BUTTON es 0 y RIGHT_BUTTON es 35. No hay LED_BUILTIN, igual que en esa variante.

WiFi

Se une a la red simulada de Mokxi, con el nombre de red y la contraseña como propiedades de la placa. No hay radio, ni 802.11, ni internet real: WiFi simulado dice qué es fiel y qué no.

What is modeled

El chip del modelo DevKit V1, completo: un núcleo Xtensa LX6, GPIO, UART0, los temporizadores, ADC1 y PWM LEDC. La pantalla es el componente ST7789 a 135x240, con sus desplazamientos de ventana y su cristal invertido, en los GPIO a los que la placa la conecta. BUTTON1 es un botón pulsador con una resistencia pull-up de 100 k, y BUTTON2 es el BOOT de la placa. La placa trae su propia cadena de programa, así que se ofrecen sus propios ejemplos, y TFT_eSPI recibe la configuración de LilyGO. Los sketches se compilan en la pestaña.

Lo que no está modelado

  • The battery connector and its charger.
  • The battery divider on GPIO 34, switched by GPIO 14.
  • Leer el panel de vuelta: devuelve negro.
  • The second core, ADC2, the DAC, touch sensing and a real radio. Bluetooth Classic and LE are simulados, como en la DevKit V1.

Proyecto inicial

T-Display hello escribe en la pantalla con TFT_eSPI y cuenta las pulsaciones de los dos botones.

En otras partes