Tinjauannya, dengan contoh yang berjalan, ada di halaman board.
Apa ini
The same classic ESP32 as ESP32 DevKit V1, di punggung board kuning yang hampir seluruhnya layar. Layarnya ILI9341, 240 kali 320 piksel, dan di atasnya ada film sentuh resistif XPT2046. Soket USB tersambung lewat CH340 ke UART0, yang menjadi Serial Monitor.
Semua yang dibutuhkan sketch pertama sudah ada di board, jadi proyek CYD biasanya tanpa komponen lain dan tanpa kabel sama sekali. Layar, pengontrol sentuh, dan LED RGB sudah disambung di dalam board, seperti di board sungguhan. Hanya konektor JST yang memakai kabel.
Di board sungguhan layar terpasang mendatar di board yang juga mendatar. Gambar di sini menegakkan board, dalam orientasi portrait, agar muat di samping breadboard. Putar komponen untuk meletakkannya mendatar.
The connectors
Tiga konektor JST, digambar di sepanjang sisi kiri. Pin-pinnya dinamai seperti gambar board buatan Wokwi menamainya, jadi proyek yang diimpor tetap menyimpan kabelnya.
| Konektor | Pin | GPIO | Catatan |
|---|---|---|---|
| P1 | VIN |
- | 5 V dari USB selama board terhubung |
| P1 | TX |
1 | UART0 TX, juga di CH340 |
| P1 | RX |
3 | UART0 RX, juga di CH340 |
| P1 | GND |
- | Ground |
| P3 | GND |
- | Ground |
| P3 | IO35 |
35 | Hanya input, ADC1 |
| P3 | IO22 |
22 | SCL I2C bawaan |
| P3 | IO21 |
21 | Backlight layar, sekaligus SDA I2C bawaan |
| CN1 | GND |
- | Ground |
| CN1 | IO27 |
27 | GPIO bebas |
| CN1 | 3V3 |
- | 3,3 V dari regulator |
Di board sungguhan CN1 juga membawa IO22, jalur yang sama dengan P3. Di sini, seperti gambar Wokwi, IO22 hanya di P3, dan CN1 adalah GND, IO27, dan 3V3.
Tidak ada pin EN atau RST di konektor mana pun: reset lewat tombol RST. IO35 hanya input, tanpa pull-up atau pull-down sendiri.
GPIO di dalam board
Pin ini tersambung ke komponen di board dan tidak ada kabel yang bisa mencapainya. Mereka didaftar agar sketch dari tutorial masuk akal.
| GPIO | Tersambung ke apa |
|---|---|
| 2 | DC layar |
| 12 | MISO layar |
| 13 | MOSI layar |
| 14 | SCK layar |
| 15 | CS layar |
| 21 | Backlight layar (juga di P3) |
EN |
Reset layar: reset board mereset panel juga |
| 25 | CLK sentuh |
| 32 | DIN sentuh (MOSI) |
| 39 | DO sentuh (MISO), hanya input |
| 33 | CS sentuh |
| 36 | IRQ sentuh, hanya input, rendah saat film ditekan |
| 4 | LED RGB, merah, menyala saat LOW |
| 16 | LED RGB, hijau, menyala saat LOW |
| 17 | LED RGB, biru, menyala saat LOW |
| 0 | Tombol BOOT |
| 34 | Sensor cahaya (tidak dimodelkan) |
| 26 | Penguat speaker (tidak dimodelkan) |
| 5, 18, 19, 23 | Slot microSD di VSPI (tidak dimodelkan) |
Runtime memberi sketch arduino-esp32 nama jczn_2432s028r untuk semuanya: CYD_TFT_MOSI adalah 13, CYD_TP_CS adalah 33, CYD_LED_RED adalah 4, dan seterusnya, dengan CYD_LED_RED_ON() dan sisanya untuk LED. Tidak ada LED_BUILTIN, seperti pada varian itu.
The screen
Layar adalah komponen ILI9341, di HSPI: MOSI 13, MISO 12, SCK 14, CS 15 dan DC 2. Reset-nya adalah reset board, jadi driver diberi -1 untuk itu.
Sketch untuk board ini tidak butuh User_Setup.h di sini. Tutorial CYD memasang User_Setup.h untuk TFT_eSPI lalu tidak menyebut pin apa pun di sketch. Mokxi sudah punya setup itu bawaan. Jika sketch tidak menyebut pin TFT, TFT_eSPI memakai milik board:
#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
Di board sungguhan kamu memasang setup yang sama di folder library TFT_eSPI, seperti kata tutorial. Sketch yang menyebut pin-nya sendiri tetap memakainya, seperti halnya dengan User_Setup.h mana pun.
#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);
}
Backlight ada di GPIO 21. init() dari TFT_eSPI menyalakannya, seperti di upstream. Di sini backlight menyala kecuali GPIO 21 ditarik LOW, jadi pin yang belum disentuh siapa pun membiarkannya menyala. Di board sungguhan sebuah transistor butuh pin ditarik HIGH, jadi set sendiri ke HIGH jika sketch-mu tidak memakai TFT_eSPI. Nyala atau mati saja: tidak bisa diredupkan dengan PWM.
Panel tidak bisa dibaca balik. readPixel() dan readRect() pada layar menghasilkan hitam, karena tidak ada yang menjawab lewat MISO.
The touch film
Untuk menyentuh layar, tekan layar saat rangkaian berjalan, dan geser untuk menggerakkan jarimu. Lepaskan dan jarinya terangkat.
XPT2046 tidak ada di bus layar. Board menyambungkannya ke GPIO 25 (CLK), 32 (DIN), 39 (DO) dan 33 (CS), dengan IRQ di 36, jadi ia dapat bus SPI sendiri, seperti cara tutorial CYD melakukannya:
#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);
}
Pembacaannya milik touch TFT: dua belas bit dari posisi jarimu di kaca. Tepinya terbaca sekitar 200 dan 3900, bukan 0 dan 4095, jadi map() nilainya ke piksel.
LED RGB dan tombol-tombolnya
LED RGB adalah tiga LED dari 3,3 V ke GPIO 4 (merah), 16 (hijau) dan 17 (biru), jadi tiap warna menyala saat pin-nya LOW dan padam saat HIGH. Nyalakan dua atau tiga sekaligus untuk mencampurnya.
BOOT adalah GPIO 0 dan RST adalah reset chip, yang mereset layar juga. Keduanya ada di bawah layar pada gambar: tekan salah satu saat rangkaian berjalan untuk menahannya tetap turun.
I2C pada konektor
Wire.begin() menaruh SDA di 21 dan SCL di 22, seperti di DevKit V1. Di board ini 21 juga dipakai backlight, jadi lalu lintas I2C di sana membuat layar berkedip. Tutorial CYD memakai IO27 dan IO22 sebagai gantinya:
Wire.begin(27, 22); // SDA on CN1, SCL on P3
WiFi
Ia bergabung ke jaringan simulasi Mokxi, dengan nama jaringan dan sandi sebagai properti board. Tidak ada radio, tidak ada 802.11 dan tidak ada internet sungguhan: Simulated WiFi menjelaskan bagian mana yang akurat dan bagian mana yang tidak.
What is modeled
Chip model DevKit V1, utuh: satu core Xtensa LX6, GPIO, UART0, timer, ADC1 dan PWM LEDC. Layarnya adalah komponen ILI9341 dan film sentuhnya adalah XPT2046 dari komponen touch TFT, masing-masing di GPIO yang board sambungkan. LED RGB menyala pada gambar. Board membawa string programnya sendiri, jadi ditawarkan contoh-contohnya sendiri, dan TFT_eSPI mendapat setup board. Sketch dikompilasi di tab.
Yang tidak dimodelkan
- Sensor cahaya di GPIO 34.
- Penguat speaker di GPIO 26, beserta konektornya.
- Slot microSD di VSPI (GPIO 5, 18, 19 dan 23).
IO22kedua milik CN1: di siniIO22hanya ada di P3.- Membaca balik panel: hasilnya hitam.
- The second core, ADC2, the DAC, touch sensing on the chip's own pins and a real radio. Bluetooth Classic and LE are disimulasikan, seperti di DevKit V1.
Proyek pemula
CYD hello menggambar sapaan dan tiga blok warna dengan TFT_eSPI, dan menggilir LED RGB melalui merah, hijau dan biru.
CYD touch paint menggambar di tempat kamu menekan layar. Ketuk warna di sepanjang atas untuk mengganti tinta, atau "clear" untuk menghapusnya.
Di tempat lain
- Halaman board: /boards/cheap-yellow-display
- Pinout: /learn/esp32-cheap-yellow-display-pinout
- The chip: ESP32 DevKit V1, dan dokumen kontraknya, the ESP32 DevKit model
- Proyek pemula: CYD hello dan CYD touch paint