الدروس ولعبة التعلّم

تطبيقات اللمس على Cheap Yellow Display

اصنع أجهزة بشاشة لمس على Cheap Yellow Display: أشكال وخطوط ونقاط لمس وأزرار على الشاشة وساعة WiFi ولوحة مهمة فضائية.

The board

يفتح كل درس اللوحة بنفسه: Cheap Yellow Display، أو CYD (لوحة Sunton ESP32-2432S028R). فهي تحمل كل ما تحتاجه الدورة، فلا حاجة لأي توصيلات:

  • شرق ESP32 كلاسيكي مع WiFi
  • شاشة ILI9341 بمقاس 320 × 240 على SPI ‏(MOSI 13 وSCK 14 وCS 15 وDC 2 والإضاءة الخلفية 21)، تُشغَّل بمكتبة TFT_eSPI
  • متحكم لمس مقاومتي XPT2046 على أطرافه الخاصة (CLK 25 وDIN 32 وDO 39 وCS 33 وIRQ 36)، يُقرأ بمكتبة XPT2046_Touchscreen
  • LED من نوع RGB على GPIO 4 و16 و17، كل لون يضيء عند مستوى LOW

اضغط على شاشة اللوحة بالفأرة لتلمسها. خذ الدورة من /learn/path/cyd-touch-apps على /learn.

الدروس

  1. جولة في اللوحة. ما على اللوحة وأين، وLED من نوع RGB الذي يضيء عندما يكون طرفه عند LOW.
  2. رسم الأشكال. إحداثيات يزيد فيها y نحو الأسفل، وبكسلات وخطوط ومستطيلات ودوائر ومثلثات، وألوان RGB565، وحركة بالمسح وإعادة الرسم.
  3. النصوص والخطوط. الخطوط المرقّمة وقياسها بـtextWidth()، ومرجع النص، والتحجيم، وعدّاد نقط لا يرمش.
  4. نقاط اللمس. قراءات اللمس الخام، وتحويلها إلى بكسلات، والضغط والرفع، وما تفعله المعايرة السيئة.
  5. أزرار على الشاشة. بنية struct لكل زر، واختبار إصابة، ومظهر مضغوط، وأزرار تضبط لون LED.
  6. ساعة WiFi. الانضمام إلى WiFi، وسؤال خادم NTP، والمناطق الزمنية، وأرقام المقاطع السبعة.
  7. مشروع: لوحة مهمة فضائية. أزرار ARM وLAUNCH وABORT تقود آلة حالات مع قفل أمان، وعدّ تنازلي لا يعطل شيئًا، وأوامر تُرسل عبر المنفذ التسلسلي.

ماذا يفعل كل كود

Sketch ماذا تفعل
cydtour يطبع خريطة اللوحة، ويقول مرحبًا، ويدير ألوان LED من نوع RGB.
cydshapes يرسم إطلاقًا ليليًا من الأشكال ويحرّك قمرًا صناعيًا عبره.
cydtext يقيس الخطوط، ووسّط النص، ويعدّ نقطًا بالخط 7.
cydtouch يطبع كل لمسة، خامًا وبالبكسل، ويرسم علامة تصويب.
cydbuttons ثلاثة أزرار لمس تضيء LED بالأحمر أو الأخضر أو الأزرق.
cydclock ينضم إلى WiFi، ويسأل NTPClient عن الوقت، ويعرضه كبيرًا.
cydpanel لوحة المهمة: SAFE وARMED والعدّ التنازلي وLIFTOFF.

حدود صريحة

  • الخطوط. يرسم Mokxi الخطوط المرقّمة من TFT_eSPI بحروفه الخاصة مكبَّرة إلى ما يقارب حجمها، فتكون كل الحروف بعرض واحد. على لوحة حقيقية يكون الخطّان 2 و4 متناسبين وتُقاس قليلاً بشكل مختلف؛ ولهذا يستخدم المساق القياس بـ textWidth().
  • الوقت. الشبكة محاكاة ولا تتصل بخادم وقت حقيقي، لذا تعرض ساعة WiFi ساعة المحاكاة نفسها: 2026-01-01 00:00:00 UTC عند الضغط على «تشغيل»، مضافاً إليها الثواني المنقضية. أما اللوحة الحقيقية فتعرض الوقت الحقيقي.
  • اللمس. يضغط الفأرة في نقطة واحدة بضغط ثابت. أما الشاشة المقاومية الحقيقية فتحتاج إلى معايرة، وهو ما يشرحه الدرس 4.
  • غير محاكى. حساس الإضاءة في CYD، ومخرج السماعة، ومنفذ microSD.

‏CircuitPython على الـ Pico، دورة أخرى في الأنظمة المدمجة للمبتدئين.