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, en el reverso de una placa amarilla que es casi toda pantalla. La pantalla es una ILI9341, de 240 por 320 píxeles, y sobre ella va una película táctil resistiva XPT2046. Un socket USB pasa por un CH340 hacia UART0, que es el monitor serie.
Todo lo que un primer sketch necesita está en la placa, así que un proyecto de CYD normalmente no tiene otros componentes ni un solo cable. La pantalla, el controlador táctil y el LED RGB están cableados dentro de la placa, como en la real. Solo los conectores JST aceptan cables.
En la placa real la pantalla va en horizontal sobre una placa horizontal. El dibujo de aquí pone la placa de pie, en vertical, para que quepa junto a una protoboard. Rota el componente para ponerla en horizontal.
The connectors
Tres conectores JST, dibujados a lo largo del borde izquierdo. Sus pines se nombran como los nombra el dibujo de la placa de Wokwi, así que un proyecto importado conserva sus cables.
| Conector | Pin | GPIO | Notas |
|---|---|---|---|
| P1 | VIN |
- | 5 V del USB mientras la placa está conectada |
| P1 | TX |
1 | UART0 TX, también en el CH340 |
| P1 | RX |
3 | UART0 RX, también en el CH340 |
| P1 | GND |
- | Tierra |
| P3 | GND |
- | Tierra |
| P3 | IO35 |
35 | Solo entrada, ADC1 |
| P3 | IO22 |
22 | El SCL de I2C por defecto |
| P3 | IO21 |
21 | El backlight de la pantalla, y el SDA de I2C por defecto |
| CN1 | GND |
- | Tierra |
| CN1 | IO27 |
27 | Un GPIO libre |
| CN1 | 3V3 |
- | Los 3.3 V del regulador |
En la placa real CN1 también lleva IO22, la misma pista que el de P3. Aquí, como en el dibujo de Wokwi, IO22 está solo en P3, y CN1 es GND, IO27 y 3V3.
No hay pin de EN ni de RST en ningún conector: el reset es el botón RST. IO35 es solo de entrada, sin pull-up ni pull-down propios.
Los GPIO dentro de la placa
Están cableados a los componentes de la placa y ningún cable puede alcanzarlos. Se listan para que un sketch de un tutorial tenga sentido.
| GPIO | A qué está conectado |
|---|---|
| 2 | DC de la pantalla |
| 12 | MISO de la pantalla |
| 13 | MOSI de la pantalla |
| 14 | SCK de la pantalla |
| 15 | CS de la pantalla |
| 21 | Backlight de la pantalla (también en P3) |
EN |
Reset de la pantalla: el reset de la placa también reinicia el panel |
| 25 | CLK del táctil |
| 32 | DIN del táctil (MOSI) |
| 39 | DO del táctil (MISO), solo entrada |
| 33 | CS del táctil |
| 36 | IRQ del táctil, solo entrada, en bajo mientras se presiona la película |
| 4 | LED RGB, rojo, encendido en LOW |
| 16 | LED RGB, verde, encendido en LOW |
| 17 | LED RGB, azul, enciende con LOW |
| 0 | El botón BOOT |
| 34 | El sensor de luz (no modelado) |
| 26 | El amplificador del altavoz (no modelado) |
| 5, 18, 19, 23 | La ranura microSD en VSPI (no modelada) |
El entorno de ejecución le da a un sketch los nombres de jczn_2432s028r de arduino-esp32 para todo esto: CYD_TFT_MOSI es 13, CYD_TP_CS es 33, CYD_LED_RED es 4, y así sucesivamente, con CYD_LED_RED_ON() y el resto para el LED. No existe LED_BUILTIN, como en esa variante.
The screen
La pantalla es el componente ILI9341, en HSPI: MOSI 13, MISO 12, SCK 14, CS 15 y DC 2. Su reset es el reset de la placa, así que un controlador recibe -1 para él.
Un sketch para esta placa no necesita User_Setup.h aquí. Los tutoriales de CYD instalan un User_Setup.h para TFT_eSPI y luego no nombran pines en el sketch. Mokxi tiene esa configuración integrada. Si el sketch no nombra pines de la TFT, TFT_eSPI recibe los de la placa:
#define ILI9341_2_DRIVER
#define TFT_WIDTH 240
#define TFT_HEIGHT 320
#define TFT_MISO 12
#define TFT_MOSI 13
#define TFT_SCLK 14
#define TFT_CS 15
#define TFT_DC 2
#define TFT_RST -1
#define TFT_BL 21
#define TFT_BACKLIGHT_ON HIGH
En una placa real instalas la misma configuración en la carpeta de la biblioteca TFT_eSPI, como dicen los tutoriales. Un sketch que nombra sus propios pines los conserva, como lo haría con cualquier User_Setup.h.
#include <TFT_eSPI.h>
TFT_eSPI tft = TFT_eSPI();
void setup() {
tft.init();
tft.setRotation(1); // landscape
tft.fillScreen(TFT_BLACK);
tft.drawCentreString("Hello, CYD!", 160, 30, 4);
}
La luz de fondo está en el GPIO 21. El init() de TFT_eSPI la enciende, igual que en el original. Aquí la luz de fondo está encendida salvo que el GPIO 21 se ponga en LOW, así que un pin que nadie ha tocado la deja encendida. En la placa real un transistor necesita el pin en HIGH, así que ponlo en HIGH tú mismo si tu sketch no usa TFT_eSPI. Está encendida o apagada: no se atenúa con PWM.
El panel no se puede leer de vuelta. readPixel() y readRect() en la pantalla devuelven negro, porque nada responde por MISO.
The touch film
Para tocar la pantalla, presiona sobre ella mientras el circuito se ejecuta, y arrastra para mover el dedo. Suelta y el dedo se levanta.
El XPT2046 no está en el bus de la pantalla. La placa lo conecta a los GPIO 25 (CLK), 32 (DIN), 39 (DO) y 33 (CS), con su IRQ en 36, así que recibe un bus SPI propio, como lo hacen los tutoriales de CYD:
#include <SPI.h>
#include <XPT2046_Touchscreen.h>
SPIClass touchscreenSPI = SPIClass(VSPI);
XPT2046_Touchscreen touchscreen(33, 36); // CS, IRQ
void setup() {
touchscreenSPI.begin(25, 39, 32, 33); // CLK, MISO, MOSI, CS
touchscreen.begin(touchscreenSPI);
touchscreen.setRotation(1);
}
Las lecturas son las de la TFT táctil: doce bits de dónde está tu dedo en el vidrio. Los bordes leen unos 200 y 3900, no 0 y 4095, así que pásalos por map() a píxeles.
El LED RGB y los botones
El LED RGB son tres LEDs de 3.3 V a los GPIO 4 (rojo), 16 (verde) y 17 (azul), así que cada color enciende cuando su pin está en LOW y se apaga con HIGH. Enciende dos o tres a la vez para mezclarlos.
BOOT es el GPIO 0 y RST es el reset del chip, que también reinicia la pantalla. Ambos están debajo de la pantalla en el dibujo: presiona uno mientras el circuito se ejecuta para mantenerlo presionado.
I2C en los conectores
Wire.begin() pone SDA en 21 y SCL en 22, como en la DevKit V1. En esta placa 21 es también la luz de fondo, así que el tráfico de I2C en él hace parpadear la pantalla. Los tutoriales de CYD usan IO27 y IO22 en su lugar:
Wire.begin(27, 22); // SDA on CN1, SCL on P3
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 ILI9341 y la película táctil es el XPT2046 del componente de TFT táctil, cada uno en los GPIO a los que la placa lo conecta. El LED RGB enciende en el dibujo. La placa trae su propia cadena de programa, así que se le ofrecen sus propios ejemplos, y TFT_eSPI recibe la configuración de la placa. Los sketches se compilan en la pestaña.
Lo que no está modelado
- El sensor de luz en el GPIO 34.
- El amplificador del altavoz en el GPIO 26, y su conector.
- La ranura microSD en VSPI (GPIO 5, 18, 19 y 23).
- El segundo
IO22de CN1: aquíIO22solo está en P3. - Leer el panel de vuelta: devuelve negro.
- The second core, ADC2, the DAC, touch sensing on the chip's own pins and a real radio. Bluetooth Classic and LE are simulados, como en la DevKit V1.
Proyectos iniciales
CYD hello dibuja un saludo y tres bloques de color con TFT_eSPI, y recorre el LED RGB por rojo, verde y azul.
CYD touch paint dibuja donde presionas la pantalla. Toca los colores de la parte superior para cambiar la tinta, o "clear" para limpiarla.
En otras partes
- La página de la placa: /boards/cheap-yellow-display
- El pinout: /learn/esp32-cheap-yellow-display-pinout
- The chip: la ESP32 DevKit V1, y su documento de contrato, the ESP32 DevKit model
- Proyectos iniciales: CYD hello y CYD touch paint