خريطة أطراف Cheap Yellow Display لـ ESP32: الموصّلات والشاشة وغشاء اللمس
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
اللوحة Cheap Yellow Display، أي ESP32-2432S028R من Sunton، هي ESP32 كلاسيكية على ظهر شاشة ILI9341 مقاس 240x320 وقطر 2.8 بوصة مع غشاء لمس مقاوم من نوع XPT2046. معظم أطراف GPIO فيها مستهلكة في اللوحة نفسها: الشاشة، ومتحكم اللمس، وLED بصيغة RGB، وحساس ضوء، ومضخم مكبر صوت، ومنفذ microSD. وما تبقى يخرج على ثلاثة موصّلات صغيرة من نوع JST هي P1 وP3 وCN1. تعرض هذه الصفحة كل طرف عليها، ثم كل GPIO تستخدمه اللوحة في داخلها، حتى يصبح الكود المنقول من درس تعليمي مفهومًا.
الدائرة أعلاه هي اللوحة وهي تعمل في Mokxi: تكتب TFT_eSPI على الشاشة ويتنقل LED بصيغة RGB بين الأحمر والأخضر والأزرق. الأرقام في هذه الصفحة مقروءة من النموذج نفسه الذي يشغّله المحاكي، وحيثما كان Mokxi أقل من اللوحة الحقيقية، تذكر الصفحة ذلك.
كل طرف على الموصّلات
يحتوي P1 على VIN وTX وRX وGND. ويحتوي P3 على GND وIO35 وIO22 وIO21. أما CN1 فيحتوي على GND وIO27 و3V3. هذه هي الأطراف الوحيدة التي يمكن لسلك الوصول إليها؛ وكل ما عدا ذلك موصّل بقطعة على اللوحة. الأسماء هي الأسماء المكتوبة على الطباعة الحريرية، ويستخدم Mokxi الأسماء التي يمنحها رسم Wokwi للوحة، حتى تحافظ المشاريع المستوردة على أسلاكها.
On the real board CN1 also carries IO22, the same trace as P3’s. In Mokxi, as in Wokwi’s drawing, IO22 is only on P3, and CN1 is GND, IO27 and 3V3. Touch on the chip’s own pins, the DAC and ADC2 are in the table because tutorials use them; Mokxi does not model them, and each row says so.
| الطرف | GPIO | ما يستطيعه | احذر من |
|---|---|---|---|
| VIN | - | خط 5 V القادم من USB، على P1. ضع 5 V هنا لتشغيل اللوحة دون كابل. | ليس GPIO. |
| TX | 1 | TX الخاص بـ UART0: Serial وشريحة USB إلى تسلسلي. على P1. | اتركه حراً، وإلا تعطل الرفع والشاشة التسلسلية. |
| RX | 3 | RX الخاص بـ UART0: Serial وشريحة USB إلى تسلسلي. على P1. | اتركه حراً، وإلا تعطل الرفع والشاشة التسلسلية. |
| GND | - | الأرضي. يوجد طرف على كل موصّل: P1 وP3 وCN1. | - |
| IO21 | 21 | PWM. وSDA الخاص بـ I2C (افتراضيًا). إضاءة الشاشة الخلفية. على P3. | اجعله LOW فتظلم الشاشة؛ وحركة I2C عليه تُرمش الإضاءة الخلفية. |
| IO22 | 22 | PWM. وSCL الخاص بـ I2C (افتراضيًا). على P3. | موجود على CN1 أيضًا على اللوحة الحقيقية؛ أما في Mokxi فعلى P3 فقط. |
| IO35 | 35 | ADC1_CH7. للإدخال فقط. على P3. | لا يوجد مشغّل خرج ولا مقاومة رفع أو خفض داخلية. |
| 3V3 | - | مخرج المنظّم 3.3 V، على CN1. | ليس GPIO. |
| IO27 | 27 | PWM. وADC2_CH7 واللمس T7 على الشريحة (غير محاكاة). على CN1. | هو SDA المعتاد على هذه اللوحة، باستخدام Wire.begin(27, 22)، حتى تبقى الإضاءة الخلفية ثابتة. |
أطراف GPIO التي تستخدمها اللوحة في الداخل
هذه موصّلة بالقطع الموجودة على اللوحة، ولا يخرجها أي موصّل. وفي Mokxi لا يمكن لسلك الوصول إليها أيضًا. يمنح وقت التشغيل الكودَ أسماء متغير jczn_2432s028r الخاص بـ arduino-esp32 لها: CYD_TFT_MOSI هو 13، وCYD_TP_CS هو 33، وCYD_LED_RED هو 4، وCYD_LDR هو 34.
الشاشة على HSPI ومتحكم اللمس على خطوط خاصة به، تشغّلها الدروس بوصفها VSPI. أما منفذ microSD فهو على أطراف VSPI المعتادة. حساس الضوء ومكبر الصوت ومنفذ microSD غير محاكاة في Mokxi.
| GPIO | موصّل بـ | الاسم في متغير jczn_2432s028r | الملاحظات |
|---|---|---|---|
| 2 | DC الشاشة | CYD_TFT_DC | طرف Strapping. |
| 12 | MISO الشاشة | CYD_TFT_MISO | طرف Strapping. لا يُقرأ أي شيء من هنا: readPixel() تعطي اللون الأسود. |
| 13 | MOSI الشاشة | CYD_TFT_MOSI | - |
| 14 | SCK الشاشة | CYD_TFT_SCK | - |
| 15 | CS الشاشة | CYD_TFT_CS | طرف Strapping. |
| 21 | الإضاءة الخلفية للشاشة، وأيضًا على P3 | CYD_TFT_BL | الدالة init() في TFT_eSPI ترفعها إلى HIGH. |
| EN | إعادة ضبط الشاشة | - | إعادة تعيين اللوحة تعيد تعيين الشاشة أيضًا، لذلك فإن TFT_RST هي -1. |
| 25 | CLK اللمس | CYD_TP_CLK | - |
| 32 | DIN اللمس (MOSI) | CYD_TP_MOSI | - |
| 39 | مخرج اللمس (MISO) | CYD_TP_MISO | للإدخال فقط. |
| 33 | CS اللمس | CYD_TP_CS | - |
| 36 | خط اللمس IRQ | CYD_TP_IRQ | للإدخال فقط. يكون LOW أثناء الضغط على الشاشة. |
| 4 | LED ثنائي اللون، الأحمر | CYD_LED_RED | يضيء عند LOW. |
| 16 | LED RGB، الأخضر | CYD_LED_GREEN | يضيء عند LOW. |
| 17 | LED RGB، الأزرق | CYD_LED_BLUE | يضيء عند LOW. |
| 0 | زر BOOT | CYD_USER_BUTTON | طرف تمهيد: إن انخفض عند إعادة الضبط تنتظر رفعاً. |
| 34 | حساس الضوء | CYD_LDR | غير مُ نمذجته. |
| 26 | مضخم السماعة | CYD_AUDIO_OUT | غير مُنمذج، ولا موصله أيضًا. |
| 5 | microSD CS | CYD_SD_SS | غير مُ نمذجته. طرف خاص بالإقلاع (strapping). |
| 18 | microSD SCK | CYD_SD_SCK | غير مُ نمذجته. |
| 19 | microSD MISO | CYD_SD_MISO | غير مُ نمذجته. |
| 23 | microSD MOSI | CYD_SD_MOSI | غير مُ نمذجته. |
الطاقة: VIN و3V3 وGND
الطرف VIN على P1 هو خط 5 V القادم من USB أثناء توصيل اللوحة، وهو مدخل عندما لا تكون موصولة. الطرف 3V3 على CN1 هو خرج المنظّم، وهو الذي يشغّل الشاشة أيضًا، لذا أبقِ ما توصّله به صغيرًا: حساس، لا محرك. الطرف GND موجود على الموصلات الثلاثة كلها.
كل أطراف GPIO تعمل على 3.3 V ولا يحتمل أي منها 5 V. لا يُنمذج Mokxi حدود المنظّم، لذا فالدائرة التي تُحمّل المنظّم الحقيقي فوق طاقته تعمل هنا رغم ذلك.
الشاشة وإعداد TFT_eSPI
الشاشة من نوع ILI9341، بأبعاد 240 في 320، على HSPI: الطرف MOSI هو 13، وMISO هو 12، وSCK هو 14، وCS هو 15، وDC هو 2، والإضاءة الخلفية على GPIO 21. إعادة التعيين الخاصة بها هي إعادة تعيين اللوحة نفسها، لذا يُعطى المشغّل القيمة -1. دروس CYD تثبّت ملف User_Setup.h لمكتبة TFT_eSPI بهذه الأطراف ثم تكتب أكوادًا لا تذكر أيًا منها. على لوحة حقيقية تنسخ ذلك الإعداد إلى مجلد مكتبة TFT_eSPI.
في Mokxi لا يحتاج الكود الخاص بهذه اللوحة إلى ملف User_Setup.h. إذا لم يذكر أي أطراف للشاشة، تحصل TFT_eSPI على إعداد اللوحة: ILI9341_2_DRIVER، وMISO 12، وMOSI 13، وSCLK 14، وCS 15، وDC 2، وRST -1، وBL 21. والكود الذي يذكر أطرافه الخاصة يحتفظ بها.
الإضاءة الخلفية مضاءة ما لم يُدفع GPIO 21 إلى LOW، لذا ففي Mokxi يتركها الطرف الذي لم يلمسه أحد مضاءة. على اللوحة الحقيقية يحتاج ترانزستور إلى دفع الطرف إلى HIGH. الدالة init() في TFT_eSPI تدفعه إلى HIGH، كما في النسخة الأصلية، لذا لن تلاحظ الأمر مع TFT_eSPI. لا تُقرأ الشاشة في Mokxi: الدالتان readPixel() وreadRect() تعطيان اللون الأسود.
طبقة اللمس
وحدة التحكم باللمس XPT2046 ليست على ناقل الشاشة. توصّلها اللوحة بالأطراف GPIO 25 (CLK) و32 (DIN) و39 (DO) و33 (CS)، وخط IRQ على 36. الدروس تعطيها ناقلًا خاصًا بها مع XPT2046_Touchscreen: SPIClass touchscreenSPI = SPIClass(VSPI);، ثم touchscreenSPI.begin(25, 39, 32, 33); ثم touchscreen.begin(touchscreenSPI);.
In Mokxi you touch the screen by pressing on it while the circuit runs. The readings are twelve bits from where your finger is on the glass, and the edges read about 200 and 3900 rather than 0 and 4095, so map() them to pixels.
LED بألوان RGB والأزرار
LED RGB هو ثلاثة LED من 3.3 V إلى الأطراف GPIO 4 (الأحمر) و16 (الأخضر) و17 (الأزرق)، لذا يضيء كل لون عندما يكون طرفه LOW وينطفئ عند HIGH. لا يوجد LED_BUILTIN، كما في نسخة arduino-esp32 الخاصة بهذه اللوحة.
الزر BOOT هو GPIO 0 والزر RST لإعادة تعيين الشريحة. ولا يوجد أي منهما على موصل.
أي طرف أستخدم؟
لاتصال I2C استخدم IO27 وIO22: Wire.begin(27, 22);. الدالة Wire.begin() بلا أطراف تضع SDA على 21، وهو طرف الإضاءة الخلفية، فترمش الشاشة أثناء انشغال الناقل. لحساس تناظري استخدم IO35، وهو من ADC1 ويستمر في العمل مع تشغيل WiFi، وهو للإدخال فقط. لمخرج مثل LED أو مرحّل استخدم IO27 أو IO22. لمنفذ تسلسلي ثانٍ، الطرفان TX وRX مشغولان بـ Serial، لذا أعطِ Serial2.begin() طرفين من الأطراف الحرة.
ADC1 فقط هو الآمن في مشروع مع WiFi، لأن الراديو يستخدم ADC2 على ESP32 حقيقي. يُنمذج في Mokxi الطرف ADC1 فقط، لذا فلا قراءة تناظرية لـ IO27 هنا.
افتح هذه الدائرة في المحرر. Cheap Yellow Display: مرحبًا، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
افتح الدائرةالأسئلة
ما هي منافذ لوحة CYD؟
المنفذ P1 هو VIN وTX وRX وGND. المنفذ P3 هو GND وIO35 وIO22 وIO21. أما CN1 فهو GND وIO22 وIO27 و3V3 على اللوحة الحقيقية؛ وفي Mokxi، كما في رسم Wokwi، فإن CN1 هو GND وIO27 و3V3، بينما IO22 موجود على P3.
على أي الأطراف توجد شاشة CYD؟
على HSPI: الطرف MOSI هو 13، وMISO هو 12، وSCK هو 14، وCS هو 15، وDC هو 2، مع الإضاءة الخلفية على 21 وإعادة التعيين على طرف EN في اللوحة. إعداد TFT_eSPI للوحة هو ILI9341_2_DRIVER مع RST بقيمة -1.
على أي الأطراف توجد شاشة اللمس في CYD؟
شريحة XPT2046 موجودة على CLK بقيمة 25، وMOSI بقيمة 32، وMISO بقيمة 39، وCS بقيمة 33، مع IRQ على 36. أنشئ لها SPIClass(VSPI) خاصًا بها واستدعِ `touchscreenSPI.begin(25, 39, 32, 33)`.
ما الأطراف التي يمكنني استخدامها لـ I2C على Cheap Yellow Display؟
الطرف IO27 لـ SDA والطرف IO22 لـ SCL، مع `Wire.begin(27, 22)`. الطرف الافتراضي لـ SDA، وهو 21، هو الإضاءة الخلفية.
هل أحتاج إلى ملف User_Setup.h لمكتبة TFT_eSPI؟
على لوحة حقيقية، نعم: ثبّت إعداد CYD في مجلد مكتبة TFT_eSPI. أما في Mokxi فلا: أي كود لا يذكر أطراف TFT يحصل على هذا الإعداد تلقائيًا.
لماذا يعمل LED الملون بالعكس؟
كل لون موصّل من 3.3 V إلى طرفه، لذا يضيء عندما يكون الطرف LOW. الأمر `digitalWrite(4, LOW)` يشغّل اللون الأحمر.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.