A visão geral, com exemplos rodando, está na página da placa.
O que é
The same classic ESP32 as o ESP32 DevKit V1, na parte de trás de uma placa amarela que é quase toda tela. A tela é uma ILI9341, 240 por 320 pixels, e sobre ela está um filme de toque resistivo XPT2046. Um soquete USB passa por um CH340 até a UART0, que é o monitor serial.
Tudo o que um primeiro sketch precisa está na placa, então um projeto de CYD normalmente não tem outros componentes nem fios nenhum. A tela, o controlador de toque e o LED RGB são ligados dentro da placa, como no real. Só os conectores JST recebem fios.
Na placa real a tela fica na horizontal sobre uma placa horizontal. O desenho aqui deixa a placa em pé, na vertical, para caber ao lado de uma protoboard. Gire o componente para deixá-lo na horizontal.
The connectors
Três conectores JST, desenhados ao longo da borda esquerda. Seus pinos têm os nomes que o desenho da placa do Wokwi dá a eles, então um projeto importado mantém seus fios.
| Conector | Pin | GPIO | Notas |
|---|---|---|---|
| P1 | VIN |
- | 5 V do USB enquanto a placa estiver conectada |
| P1 | TX |
1 | UART0 TX, também no CH340 |
| P1 | RX |
3 | UART0 RX, também no CH340 |
| P1 | GND |
- | Terra |
| P3 | GND |
- | Terra |
| P3 | IO35 |
35 | Somente entrada, ADC1 |
| P3 | IO22 |
22 | O SCL padrão do I2C |
| P3 | IO21 |
21 | O backlight da tela e o SDA padrão do I2C |
| CN1 | GND |
- | Terra |
| CN1 | IO27 |
27 | Um GPIO livre |
| CN1 | 3V3 |
- | Os 3,3 V do regulador |
Na placa real o CN1 também traz o IO22, a mesma trilha do P3. Aqui, como no desenho do Wokwi, IO22 está só no P3, e o CN1 é GND, IO27 e 3V3.
Não há pino EN nem RST em conector nenhum: o reset é o botão RST. IO35 é somente entrada, sem pull-up ou pull-down próprios.
Os GPIOs dentro da placa
Eles estão ligados aos componentes da placa e nenhum fio consegue alcançá-los. Estão listados para que um sketch de um tutorial faça sentido.
| GPIO | Ao que está ligado |
|---|---|
| 2 | DC da tela |
| 12 | MISO da tela |
| 13 | MOSI da tela |
| 14 | SCK da tela |
| 15 | CS da tela |
| 21 | Backlight da tela (também no P3) |
EN |
Reset da tela: o reset da placa também reinicia o painel |
| 25 | CLK do toque |
| 32 | DIN do toque (MOSI) |
| 39 | DO do toque (MISO), somente entrada |
| 33 | CS do toque |
| 36 | IRQ do toque, somente entrada, em nível baixo enquanto o filme é pressionado |
| 4 | LED RGB, vermelho, aceso em LOW |
| 16 | LED RGB, verde, aceso em LOW |
| 17 | LED RGB, azul, aceso com LOW |
| 0 | O botão BOOT |
| 34 | O sensor de luz (não modelado) |
| 26 | O amplificador do alto-falante (não modelado) |
| 5, 18, 19, 23 | O slot microSD no VSPI (não modelado) |
O runtime dá a um sketch os nomes de jczn_2432s028r do arduino-esp32 para tudo isso: CYD_TFT_MOSI é 13, CYD_TP_CS é 33, CYD_LED_RED é 4, e assim por diante, com CYD_LED_RED_ON() e o resto para o LED. Não há LED_BUILTIN, como nessa variante.
The screen
A tela é o componente ILI9341, no HSPI: MOSI 13, MISO 12, SCK 14, CS 15 e DC 2. O reset dela é o reset da placa, então o driver recebe -1 para ele.
Um sketch para esta placa não precisa de User_Setup.h aqui. Os tutoriais de CYD instalam um User_Setup.h para a TFT_eSPI e depois não nomeiam nenhum pino no sketch. O Mokxi já tem essa configuração embutida. Se o sketch não nomear pinos do TFT, a TFT_eSPI recebe os da 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
Numa placa real você instala a mesma configuração na pasta da biblioteca TFT_eSPI, como dizem os tutoriais. Um sketch que nomeia os próprios pinos os mantém, como faria com qualquer 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);
}
O backlight está no GPIO 21. O init() da TFT_eSPI o liga, como no upstream. Aqui o backlight fica aceso a menos que o GPIO 21 seja levado a LOW, então um pino que ninguém tocou o deixa aceso. Na placa real um transistor precisa do pino em HIGH, então coloque-o em HIGH você mesmo se seu sketch não usa a TFT_eSPI. Ele fica ligado ou desligado: não escurece com PWM.
O painel não é lido de volta. readPixel() e readRect() na tela devolvem preto, porque nada responde pelo MISO.
The touch film
Para tocar a tela, pressione-a enquanto o circuito roda, e arraste para mover o dedo. Solte e o dedo levanta.
O XPT2046 não está no barramento da tela. A placa o liga aos GPIO 25 (CLK), 32 (DIN), 39 (DO) e 33 (CS), com o IRQ no 36, então ele tem um barramento SPI só dele, do jeito que os tutoriais de CYD fazem:
#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);
}
As leituras são as do touch TFT: doze bits de onde seu dedo está no vidro. As bordas leem cerca de 200 e 3900, não 0 e 4095, então use map() para converter em pixels.
O LED RGB e os botões
O LED RGB são três LEDs de 3,3 V para os GPIO 4 (vermelho), 16 (verde) e 17 (azul), então cada cor acende quando seu pino está em LOW e apaga em HIGH. Acenda dois ou três de uma vez para misturá-los.
BOOT é o GPIO 0 e RST é o reset do chip, que reinicia a tela também. Os dois ficam sob a tela no desenho: pressione um deles enquanto o circuito roda para mantê-lo pressionado.
I2C nos conectores
Wire.begin() coloca SDA no 21 e SCL no 22, como no DevKit V1. Nesta placa o 21 também é o backlight, então tráfego de I2C nele faz a tela piscar. Os tutoriais de CYD usam IO27 e IO22 no lugar:
Wire.begin(27, 22); // SDA on CN1, SCL on P3
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 timers, ADC1 e PWM LEDC. A tela é o componente ILI9341 e o filme de toque é o XPT2046 do componente touch TFT, cada um nos GPIO aos quais a placa o liga. O LED RGB acende no desenho. A placa carrega sua própria string de programa, então recebe seus próprios exemplos, e a TFT_eSPI recebe a configuração da placa. Os sketches compilam na aba.
O que não é modelado
- O sensor de luz no GPIO 34.
- O amplificador do alto-falante no GPIO 26, e seu conector.
- O slot microSD no VSPI (GPIO 5, 18, 19 e 23).
- O segundo
IO22do CN1: aquiIO22está só no P3. - Ler o painel de volta: devolve preto.
- 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 no DevKit V1.
Projetos iniciais
CYD hello desenha uma saudação e três blocos de cores com a TFT_eSPI, e percorre vermelho, verde e azul no LED RGB.
CYD touch paint desenha onde você pressiona a tela. Toque nas cores no topo para trocar a tinta, ou "clear" para apagar tudo.
Em outros lugares
- A página da placa: /boards/cheap-yellow-display
- O pinout: /learn/esp32-cheap-yellow-display-pinout
- The chip: o ESP32 DevKit V1, e seu documento de contrato, the ESP32 DevKit model
- Projetos iniciais: CYD hello e CYD touch paint