Placas

O Cheap Yellow Display

A Sunton ESP32-2432S028R: um ESP32 clássico atrás de uma tela touch ILI9341 de 2,8 polegadas e 240x320, e um LED RGB que acende quando seus pinos estão em LOW.

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 IO22 do CN1: aqui IO22 está 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