اللوحات

Cheap Yellow Display

Sunton ESP32-2432S028R: شريحة ESP32 كلاسيكية خلف شاشة لمس ILI9341 قياس 2.8 بوصة بدقة 240x320، وLED متعدد الألوان يضيء عندما تكون أطرافه LOW.

نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة.

ما هي

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" للمسح.

في مواضع أخرى