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.
الدروس
- جولة في اللوحة. ما على اللوحة وأين، وLED من نوع RGB الذي يضيء عندما يكون طرفه عند LOW.
- رسم الأشكال. إحداثيات يزيد فيها y نحو الأسفل، وبكسلات وخطوط ومستطيلات ودوائر ومثلثات، وألوان RGB565، وحركة بالمسح وإعادة الرسم.
- النصوص والخطوط. الخطوط المرقّمة وقياسها بـtextWidth()، ومرجع النص، والتحجيم، وعدّاد نقط لا يرمش.
- نقاط اللمس. قراءات اللمس الخام، وتحويلها إلى بكسلات، والضغط والرفع، وما تفعله المعايرة السيئة.
- أزرار على الشاشة. بنية struct لكل زر، واختبار إصابة، ومظهر مضغوط، وأزرار تضبط لون LED.
- ساعة WiFi. الانضمام إلى WiFi، وسؤال خادم NTP، والمناطق الزمنية، وأرقام المقاطع السبعة.
- مشروع: لوحة مهمة فضائية. أزرار 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.
Related
CircuitPython على الـ Pico، دورة أخرى في الأنظمة المدمجة للمبتدئين.