Örneklerin çalıştığı genel bakış şurada: kart sayfası.
Nedir
The same classic ESP32 as ESP32 DevKit V1, çoğunlukla ekrandan oluşan sarı bir kartın arkasında. Ekran 240'a 320 piksel bir ILI9341 ve üzerinde XPT2046 dirençli dokunmatik film var. Bir USB soketi CH340 üzerinden UART0'a gider, o da seri monitördür.
İlk kodun ihtiyaç duyduğu her şey kartın üzerinde, bu yüzden bir CYD projesinde genelde başka parça ve hiç kablo olmaz. Ekran, dokunmatik denetleyici ve RGB LED gerçek karttaki gibi kartın içinde kabloludur. Sadece JST konnektörler kablo alır.
Gerçek kartta ekran yatay bir kartın üzerinde yatay durur. Buradaki çizim, bir breadboard'un yanına sığsın diye kartı dikey, portre modunda tutar. Parçayı döndürüp yatay yatırabilirsin.
The connectors
Sol kenar boyunca çizilmiş üç JST konnektör. Pinleri, Wokwi'nin kart çiziminin adlandırdığı gibi adlandırılır, böylece içe aktarılan bir proje kablolarını korur.
| Konnektör | Pin | GPIO | Notlar |
|---|---|---|---|
| P1 | VIN |
- | Kart takılıyken USB'den gelen 5 V |
| P1 | TX |
1 | UART0 TX, ayrıca CH340 üzerinde |
| P1 | RX |
3 | UART0 RX, ayrıca CH340 üzerinde |
| P1 | GND |
- | Toprak |
| P3 | GND |
- | Toprak |
| P3 | IO35 |
35 | Sadece giriş, ADC1 |
| P3 | IO22 |
22 | Varsayılan I2C SCL |
| P3 | IO21 |
21 | Ekranın arka ışığı ve varsayılan I2C SDA |
| CN1 | GND |
- | Toprak |
| CN1 | IO27 |
27 | Boş bir GPIO |
| CN1 | 3V3 |
- | Regülatörün 3.3 V'u |
Gerçek kartta CN1, P3 ile aynı izi paylaşan IO22'yi de taşır. Burada, Wokwi'nin çiziminde olduğu gibi, IO22 sadece P3'tedir ve CN1 GND, IO27 ve 3V3'ten oluşur.
Hiçbir konnektörde EN veya RST pini yoktur: sıfırlama RST butonudur. IO35 sadece giriştir ve kendi pull-up veya pull-down'u yoktur.
Kartın içindeki GPIO'lar
Bunlar kart üzerindeki parçalara kabloludur ve hiçbir kablo onlara ulaşamaz. Kılavuzdan gelen bir kodun anlamlı olması için listelenirler.
| GPIO | Neye kablolu |
|---|---|
| 2 | Ekran DC |
| 12 | Ekran MISO |
| 13 | Ekran MOSI |
| 14 | Ekran SCK |
| 15 | Ekran CS |
| 21 | Ekran arka ışığı (ayrıca P3'te) |
EN |
Ekran sıfırlaması: kartın sıfırlaması paneli de sıfırlar |
| 25 | Dokunmatik CLK |
| 32 | Dokunmatik DIN (MOSI) |
| 39 | Dokunmatik DO (MISO), sadece giriş |
| 33 | Dokunmatik CS |
| 36 | Dokunmatik IRQ, sadece giriş, film basılıyken düşük |
| 4 | RGB LED, kırmızı, LOW iken yanar |
| 16 | RGB LED, yeşil, LOW iken yanar |
| 17 | RGB LED, mavi, LOW ile yanar |
| 0 | BOOT butonu |
| 34 | Işık sensörü (modellenmedi) |
| 26 | Hoparlör amplifikatörü (modellenmedi) |
| 5, 18, 19, 23 | VSPI üzerindeki microSD yuvası (modellenmedi) |
Çalışma ortamı, bir koda arduino-esp32'nin jczn_2432s028r sürümündeki adların tümünü verir: CYD_TFT_MOSI 13'tür, CYD_TP_CS 33'tür, CYD_LED_RED 4'tür ve geri kalanlar böyledir; LED için CYD_LED_RED_ON() ve diğerleri vardır. O sürümdeki gibi LED_BUILTIN yoktur.
The screen
Ekran ILI9341 parçasıdır ve HSPI üzerindedir: MOSI 13, MISO 12, SCK 14, CS 15 ve DC 2. Sıfırlaması kartın sıfırlamasıdır, bu yüzden bir sürücüye bunun için -1 verilir.
Bu kart için bir kodda burada User_Setup.h gerekmez. CYD öğreticileri TFT_eSPI için bir User_Setup.h kurar ve sonra kodda hiçbir pin adı vermez. Mokxi bu kurulumu hazır olarak bulundurur. Kod TFT pinlerinin adını vermezse, TFT_eSPI kartın kurulumunu alır:
#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
Gerçek bir kartta, öğreticilerin dediği gibi aynı kurulumu TFT_eSPI kütüphane klasörüne kurarsın. Kendi pinlerinin adını veren bir kod, bunları herhangi bir User_Setup.h ile olduğu gibi korur.
#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);
}
Arka ışık GPIO 21'dedir. TFT_eSPI'nin init() işlevi onu, yukarı akıştaki gibi açar. Burada arka ışık, GPIO 21 LOW sürülmediği sürece yanar, yani kimse dokunmadığı bir pin onu açık bırakır. Gerçek kartta bir transistörün pini HIGH sürülmesini gerektirmesi nedeniyle, kodun TFT_eSPI kullanmıyorsa pin'i kendin HIGH yap. Işık ya açıktır ya kapalıdır: PWM ile kısamazsın.
Panel geri okunmaz. Ekrandaki readPixel() ve readRect() siyah verir, çünkü MISO üzerinden cevap veren bir şey yoktur.
The touch film
Ekrana dokunmak için, devre çalışırken üzerine bas ve parmağını hareket ettirmek için sürükle. Bıraktığında parmak kalkar.
XPT2046 ekranın veri yolunda değildir. Kart onu GPIO 25 (CLK), 32 (DIN), 39 (DO) ve 33 (CS) üzerine kablolamıştır ve IRQ'su 36'dadır, yani CYD öğreticilerinin yaptığı gibi kendi başına bir SPI veri yolu alır:
#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);
}
Ölçümler dokunmatik TFT'ninkilerdir: parmağın camdaki konumundan on iki bit. Kenarlar 0 ve 4095 değil, yaklaşık 200 ve 3900 okur, bu yüzden bunları map() ile piksele çevir.
RGB LED ve butonlar
RGB LED, 3,3 V'dan GPIO 4 (kırmızı), 16 (yeşil) ve 17 (mavi)'ye uzanan üç LED'dir, yani her renk pin'i LOW olduğunda yanar ve HIGH olduğunda söner. Karıştırmak için ikisini veya üçünü aynı anda yak.
BOOT GPIO 0'dır ve RST çipin sıfırlamasıdır; bu ekranı da sıfırlar. İkisi de çizimde ekranın altındadır: basılı tutmak için devre çalışırken birine bas.
Konnektörlerdeki I2C
Wire.begin(), DevKit V1'deki gibi SDA'yı 21'e ve SCL'yi 22'ye koyar. Bu kartta 21 ayrıca arka ışıktır, yani üzerindeki I2C trafiği ekranı titretir. CYD öğreticileri bunun yerine IO27 ve IO22 kullanır:
Wire.begin(27, 22); // SDA on CN1, SCL on P3
WiFi
Mokxi'nin simüle edilmiş ağına katılır; ağ adı ve şifre kartın özellikleridir. Radyo, 802.11 ve gerçek internet yoktur: Simulated WiFi hangilerinin sadık, hangilerinin olmadığını anlatır.
What is modeled
DevKit V1 modelinin çipi, bütünüyle: bir Xtensa LX6 çekirdeği, GPIO, UART0, zamanlayıcılar, ADC1 ve LEDC PWM. Ekran ILI9341 parçasıdır ve dokunmatik film, dokunmatik TFT parçasının XPT2046'sıdır; her biri, kartın kabloladığı GPIO'lardadır. RGB LED çizimde yanar. Kart kendi program dizisini taşır, yani kendi örnekleri sunulur ve TFT_eSPI kartın kurulumunu alır. Kodlar sekmede derlenir.
Modellenmeyenler
- GPIO 34'teki ışık sensörü.
- GPIO 26'daki hoparlör amplifikatörü ve konnektörü.
- VSPI üzerindeki microSD yuvası (GPIO 5, 18, 19 ve 23).
- CN1'in ikinci
IO22pini: buradaIO22yalnızca P3'tedir. - Paneli geri okumak: siyah verir.
- The second core, ADC2, the DAC, touch sensing on the chip's own pins and a real radio. Bluetooth Classic and LE are simüle edilmiştir, DevKit V1'deki gibi.
Başlangıç projeleri
CYD hello, TFT_eSPI ile bir karşılama ve üç renk bloğu çizer ve RGB LED'i kırmızı, yeşil ve mavi arasında döndürür.
CYD touch paint, ekrana bastığın yerde çizer. Mürekkebi değiştirmek için üstteki renklere dokun ya da temizlemek için "clear"a bas.
Başka yerlerde
- Kart sayfası: /boards/cheap-yellow-display
- Pin şeması: /learn/esp32-cheap-yellow-display-pinout
- The chip: ESP32 DevKit V1, ve sözleşme belgesi, the ESP32 DevKit model
- Başlangıç projeleri: CYD hello ve CYD touch paint