نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة.
ما هي
The same classic ESP32 as ESP32 DevKit V1، على ظهر لوحة صفراء معظمها شاشة. الشاشة هي ILI9341، بأبعاد 240 في 320 بكسل، وفوقها غشاء لمس مقاوم من نوع XPT2046. منفذ USB يمر عبر CH340 إلى UART0، وهو الشاشة التسلسلية.
كل ما يحتاجه أول كود موجود على اللوحة، لذا فمشروع CYD عادةً لا يحتوي قطعًا أخرى ولا أسلاكًا على الإطلاق. الشاشة ومتحكم اللمس وLED RGB موصّلة داخل اللوحة، كما في اللوحة الحقيقية. موصلات JST وحدها تأخذ أسلاكًا.
في اللوحة الحقيقية تقع الشاشة بالعرض على لوحة بالعرض. الرسم هنا يضع اللوحة عمودية، بالطول، لتتسع بجانب لوحة تجارب. أدر القطعة لتضعها بالعرض.
The connectors
ثلاثة موصلات JST، مرسومة على طول الحافة اليسرى. أطرافها مسماة كما سمّاها رسم Wokwi للوحة، حتى يحافظ المشروع المستورد على أسلاكه.
| الموصل | Pin | GPIO | الملاحظات |
|---|---|---|---|
| P1 | VIN |
- | 5 V من USB أثناء توصيل اللوحة |
| P1 | TX |
1 | UART0 TX، وهو أيضًا على CH340 |
| P1 | RX |
3 | UART0 RX، وهو أيضًا على CH340 |
| P1 | GND |
- | الأرضي |
| P3 | GND |
- | الأرضي |
| P3 | IO35 |
35 | للإدخال فقط، ADC1 |
| P3 | IO22 |
22 | SCL الافتراضي لـ I2C |
| P3 | IO21 |
21 | إضاءة الشاشة الخلفية، وSDA الافتراضي لـ I2C |
| CN1 | GND |
- | الأرضي |
| CN1 | IO27 |
27 | GPIO حر |
| CN1 | 3V3 |
- | 3.3 V من المنظّم |
في اللوحة الحقيقية يحمل CN1 أيضًا IO22، على نفس المسار الخاص بـ P3. أما هنا، كما في رسم Wokwi، فـ IO22 موجود على P3 فقط، وCN1 هو GND وIO27 و3V3.
لا يوجد طرف EN أو RST على أي موصل: إعادة التعيين تتم بزر RST. أما IO35 فللإدخال فقط، وليس له مقاومة سحب أو سحب خاصة به.
أطراف GPIO داخل اللوحة
هذه موصّلة بالقطع الموجودة على اللوحة ولا يمكن لأي سلك الوصول إليها. تُدرج هنا حتى يصبح الكود القادم من درس تعليمي مفهومًا.
| GPIO | ما هو موصّل به |
|---|---|
| 2 | DC الشاشة |
| 12 | MISO الشاشة |
| 13 | MOSI الشاشة |
| 14 | SCK الشاشة |
| 15 | CS الشاشة |
| 21 | الإضاءة الخلفية للشاشة (وهي أيضًا على P3) |
EN |
إعادة تعيين الشاشة: إعادة تعيين اللوحة تعيد تعيين الشاشة أيضًا |
| 25 | CLK اللمس |
| 32 | DIN اللمس (MOSI) |
| 39 | DO اللمس (MISO)، للإدخال فقط |
| 33 | CS اللمس |
| 36 | لمس IRQ، للإدخال فقط، ينخفض أثناء الضغط على الغشاء |
| 4 | LED ثنائي اللون، الأحمر، يضيء عند LOW |
| 16 | LED ثنائي اللون، الأخضر، يضيء عند LOW |
| 17 | LED بألوان RGB، الأزرق، يضيء عند LOW |
| 0 | زر BOOT |
| 34 | حساس الضوء (غير محاكى) |
| 26 | مضخم مكبر الصوت (غير محاكى) |
| 5, 18, 19, 23 | فتحة microSD على VSPI (غير محاكاة) |
توفر بيئة التشغيل للكود أسماء arduino-esp32 للوحة jczn_2432s028r لكل هذه: CYD_TFT_MOSI هو 13، وCYD_TP_CS هو 33، وCYD_LED_RED هو 4، وهكذا، مع CYD_LED_RED_ON() وبقية الدوال لـ LED. لا يوجد LED_BUILTIN، كما في تلك النسخة.
The screen
الشاشة هي قطعة ILI9341، على HSPI: MOSI على 13، وMISO على 12، وSCK على 14، وCS على 15 وDC على 2. إعادة تعيينها هي إعادة تعيين اللوحة نفسها، لذا يُعطى المشغّل القيمة -1 لها.
لا يحتاج الكود الخاص بهذه اللوحة إلى User_Setup.h هنا. تدروس CYD تثبّت User_Setup.h لمكتبة TFT_eSPI ثم لا تذكر أي أطراف في الكود. Mokxi يتضمن هذا الإعداد مسبقًا. إذا لم يذكر الكود أطراف TFT، تحصل TFT_eSPI على أطراف اللوحة:
#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
على لوحة حقيقية تثبّت الإعداد نفسه في مجلد مكتبة TFT_eSPI، كما تقول الدروس. الكود الذي يذكر أطرافه بنفسه يحتفظ بها، كما يفعل مع أي 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);
}
الإضاءة الخلفية على GPIO 21. دالة init() في TFT_eSPI تشغّلها، كما في الأصل. هنا تضيء الإضاءة الخلفية ما لم تُسحب GPIO 21 إلى LOW، لذا يتركها أي طرف لم يلمسه أحد مضاءة. على اللوحة الحقيقية يحتاج ترانزستور إلى سحب الطرف إلى HIGH، لذا اضبطه على HIGH بنفسك إذا كان كودك لا يستخدم TFT_eSPI. إنها تعمل أو لا تعمل: لا تخفت مع PWM.
لا تُقرأ محتويات الشاشة. دالتا readPixel() وreadRect() على الشاشة تعطيان اللون الأسود، لأن لا شيء يجيب عبر MISO.
The touch film
للمس الشاشة، اضغط عليها أثناء تشغيل الدائرة، واسحب لتحريك إصبعك. اترك الشاشة ليرتفع الإصبع.
شريحة XPT2046 ليست على ناقل الشاشة. توصّلها اللوحة بـ GPIO 25 (CLK) و32 (DIN) و39 (DO) و33 (CS)، مع IRQ على 36، فتحصل على ناقل SPI خاص بها، على طريقة دروس 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);
}
القراءات هي قراءات touch TFT: اثنا عشر بتًا من موضع إصبعك على الزجاج. تقرأ الحواف نحو 200 و3900، وليس 0 و4095، لذا استخدم map() لتحويلها إلى بكسلات.
LED بألوان RGB والأزرار
LED بألوان RGB هو ثلاثة LED من 3.3 V إلى GPIO 4 (الأحمر) و16 (الأخضر) و17 (الأزرق)، فيضيء كل لون عندما يكون طرفه LOW وينطفئ عند HIGH. أشعل لونين أو ثلاثة معًا لمزجها.
BOOT هو GPIO 0 وRST هو إعادة تعيين الشريحة، وهي تعيد تعيين الشاشة أيضًا. كلاهما تحت الشاشة في الرسم: اضغط أحدهما أثناء تشغيل الدائرة لتبقيه مضغوطًا.
I2C على الموصلات
تضع Wire.begin() خط SDA على 21 وSCL على 22، كما في DevKit V1. على هذه اللوحة الطرف 21 هو الإضاءة الخلفية أيضًا، لذا فإن حركة I2C عليه تجعل الشاشة ترمش. تستخدم دروس CYD IO27 وIO22 بدلًا من ذلك:
Wire.begin(27, 22); // SDA on CN1, SCL on P3
WiFi
تنضم إلى شبكة Mokxi المحاكاة، مع اسم الشبكة وكلمة المرور كخصائص للوحة. لا يوجد راديو ولا 802.11 ولا إنترنت حقيقي: شبكة WiFi محاكاة يوضح ما هو مطابق للواقع وما ليس كذلك.
What is modeled
شريحة موديل DevKit V1 كاملة: نواة Xtensa LX6 واحدة، وGPIO، وUART0، والمؤقتات، وADC1 وLEDC PWM. الشاشة هي قطعة ILI9341 وطبقة اللمس هي XPT2046 من قطعة touch TFT، كل منهما على الأطراف التي توصّلها اللوحة بها. يضيء LED بألوان RGB في الرسم. تحمل اللوحة نص برنامجها الخاص، فتُعرض أمثلتها الخاصة، وتحصل TFT_eSPI على إعداد اللوحة. تُترجَم الأكواد في علامة التبويب.
ما لم يُنمذج
- حساس الضوء على GPIO 34.
- مضخم مكبر الصوت على GPIO 26، وموصّله.
- فتحة microSD على VSPI (GPIO 5 و18 و19 و23).
IO22الثاني لـ CN1: هناIO22موجود على P3 فقط.- قراءة محتويات الشاشة: تعطي اللون الأسود.
- The second core, ADC2, the DAC, touch sensing on the chip's own pins and a real radio. Bluetooth Classic and LE are محاكيان، كما في DevKit V1.
مشاريع البداية
يرسم CYD hello تحية وثلاثة مربعات ملونة باستخدام TFT_eSPI، ويدير LED بألوان RGB عبر الأحمر والأخضر والأزرق.
يرسم CYD touch paint حيث تضغط على الشاشة. اضغط على الألوان في الأعلى لتغيير الحبر، أو على "clear" للمسح.
في مواضع أخرى
- صفحة اللوحة: /boards/cheap-yellow-display
- خريطة الأطراف: /learn/esp32-cheap-yellow-display-pinout
- The chip: ESP32 DevKit V1، وثيقة عقدها، the ESP32 DevKit model
- مشاريع البداية: CYD hello وCYD touch paint