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

ألعاب MicroPython على شاشة صغيرة

ابنِ ألعابًا فضائية بلغة MicroPython على Raspberry Pi Pico مع شاشة OLED وزرين وبيزو، من أول بكسل إلى أفعى فضائية.

ابدأ الدورة. هذه دورة للمبتدئين: إن كنت تستطيع كتابة سطر Python واحد، فستستطيع متابعتها.

الوحدة

تستخدم كل الدروس الوحدة الصغيرة نفسها، لذا لا تتغير التوصيلات أبدًا:

  • Raspberry Pi Pico يعمل بالبرنامج الثابت الرسمي لـ MicroPython.
  • شاشة SSD1306 OLED بمقاس 128 × 64 على I2C0: طرف SDA على GP4، وطرف SCL على GP5.
  • الزر A على GP15 والزر B على GP14، وكلاهما موصّل بالأرضي، ويُقرآن عبر مقاومات الرفع الداخلية في Pico.
  • قطعة piezo على GP16، تعمل عبر PWM.

البرنامج المشغِّل ssd1306.py من مكتبة micropython-lib يوضع في تبويب بجانب main.py، تمامًا كما ينسخه Thonny إلى لوحة Pico حقيقية.

درسًا درسًا

  1. الرسم على شاشة OLED. البكسلات والخطوط والمستطيلات والنصوص والدوائر، وسبب عدم ظهور أي شيء قبل استدعاء show(). يَعُدّ البرنامج بكسلاته المضيئة بنفسه، فيمكنك توقّع رقم والتحقق منه.
  2. تحريك نقطة. حلقة اللعبة: مسح، رسم، عرض، تحريك. اجعل سفينة ترتد عن الجدران، وتوقّع الإطار الذي تنعطف فيه، وقِس عدد إطاراتك في الثانية (نقل I2C هو العامل المحدِّد).
  3. Reading buttons. Pull-ups and why pressed reads 0, held versus tapped, edge detection, and the 3 ms of contact bounce that reading once a frame steps over.
  4. النقاط. كشف تصادم المستطيلات في سطر واحد، ورسم النتيجة بتنسيق %، ونهاية اللعبة بعد ثلاث إصابات فائتة.
  5. أعداء عشوائيون. حقل كويكبات مبني من القوائم، وrandom.randint، والبذور للحصول على ألعاب قابلة للتكرار، وثلاث أرواح ومستويات تتسارع.
  6. الصوت. نغمات PWM على قطعة piezo: نغمة افتتاح، وصوت اصطدام هابط، وأخفض نغمة يمكن لمحرك PWM في RP2040 إصدارها، ولحن مخزّن كقائمة من أزواج.
  7. مشروع: الثعبان. كل شيء معًا.

الختام: ثعبان الفضاء

تصبح الشاشة شبكة من 32 × 16. الثعبان قائمة من الخلايا، الرأس أولًا: كل حركة تُدخل رأسًا جديدًا وتُخرج الذيل، إلا إذا كان قد أكل للتو. الزر A ينعطف يسارًا والزر B يمينًا، ويتسارع الثعبان كلما كبر، ولا تقع الأكلة داخله أبدًا، وفي الخطوة الأخيرة تنقلك الحواف إلى الجهة الأخرى، كما في لعبة Asteroids. ثم تضيف ميزة من ابتكارك.

كيف يختلف محرك Pico

لوحة Pico على مساحة العمل تُقلع ببرنامج MicroPython v1.29 الحقيقي على RP2040 محاكى، لذا الكود هو نفسه الذي ستشغّله على لوحة حقيقية تمامًا. بعض الأمور التي يجب معرفتها:

  • التوقيت حقيقي. استدعاء oled.show() كاملًا يستغرق نحو 26 ms عند 400 kHz، لذا تتطابق معدلات الإطارات مع وحدة حقيقية.
  • الأزرار ترتج. مثل المفاتيح الحقيقية، ترتج أزرار الضغط لبضعة أجزاء من الألف من الثانية. تقرأها الألعاب مرة واحدة في كل إطار، وهو ما يخفي ذلك.
  • العشوائية قابلة للتكرار. تضع الدروس بذرة في random فتكون كل تشغيلة متطابقة. دون بذرة، يبذّر MicroPython نفسه من الشريحة.
  • نواة واحدة. يشغّل المحاكي نواة واحدة من RP2040، لذا فـ _thread غير متاح. هذه الألعاب لا تحتاجه أبدًا.

إلى أين بعد ذلك

تأخذ دورة التزامن: المهام والتسابق وasync لوحة Pico نفسها إلى أبعد من ذلك: المقاطعات وasyncio وقوائم الانتظار. أما MicroPython على Pico فيغطي بقية أجزاء اللوحة: المحول ADC وتدرجات PWM والحساسات.