القطع

القطع التي تُصنع منها الألعاب

شاشة، شيء تمسكه، وخمس ألعاب في المعرض تجمع بينهما.

الألعاب هي الجزء من Mokxi الذي يعود إليه الناس دومًا، لذا أربع قطع تستحق معرفتها جيدًا: شاشة OLED الصغيرة، وعصا الإبهام، والمِرمِز الدوّاري، وحلقة LED القابلة للعنونة. هذه الصفحة تشرح ما يفعله كل منها، وما يجب أن يفعله البرنامج الثابت لتشغيله، وأي مثال تفتحه لتراه يعمل.

شاشة SSD1306 OLED، 128x64

الشاشة الصغيرة الزرقاء والبيضاء التي في كل مجموعة هواة. سلكان وتغذية: إنها تابع I2C على العنوان 0x3c، وتُقرّ 0x3d أيضًا إذا ضبطت الخاصية على ذلك.

تحاكي القطعة مجموعة الأوامر التي ترسلها المكتبات الشائعة فعلًا (تشغيل الشاشة وإيقافها، ونمط العنونة، ونوافذ الأعمدة والصفحات، والتباين، وإعادة تخطيط المقاطع، واتجاه مسح COM، ومضخة الشحن) وعنونة الصفحات والأفقية كلتيهما، لذا مشغّل مكتوب لشاشة حقيقية يعمل هنا دون تغيير. ما تراه على مساحة العمل هو ذاكرة الرسوميات الخاصة بالشاشة نفسها، مرسومة بكسلًا بكسلًا.

لا توجد وحدة I2C طرفية في Uno أو ESP32-C3 في Mokxi، لذا يُدار الناقل برمجيًا بالبت: mokxi_i2c.h يسحب الخطين إلى الأسفل ثم يتركهما، ومقاوما السحب 4k7 الخاصتان بالوحدة تعيدانهما إلى الأعلى. أي طرفين يفيان بالغرض، ولهذا تستخدم الأمثلة الطرفين الذين يتوقعها الجميع.

إطار أحادي اللون 128x64 هو 1024 بايت. على ESP32-C3 هذا لا شيء؛ على Uno هو نصف ذاكرة الرقاقة، وإرساله كله عبر ناقل برمجي يستغرق ثلث ثانية. لهذا يرسل المشغّل فقط كتل الأعمدة الثمانية من كل صفحة تغيّرت، ولهذا تمحو اللعبة على هذه الشاشة الكرة حيث كانت وترسمها حيث هي الآن بدلًا من إعادة الرسم كاملًا.

شاهده: نرد OLED (ESP32-C3)، وبونغ OLED (Uno)، وبونغ OLED على ESP32-C3.

عصا الإبهام

مقاومتان متغيرتان بقيمة 10 ك لكل منهما ومفتاح ضغط: وحدة KY-023 ونسخها. اسحب الغطاء الأسود في مساحة العمل فيتحرك المحوران معًا؛ وعند الإفلات يعود إلى المنتصف بنابض، تمامًا كالقطعة الحقيقية. اضغط الغطاء أو أبقِه مضغوطًا لدفع العصا إلى الأسفل مباشرة، مما يقصّر SW إلى الأرضي.

كل محور مقسّم جهد حقيقي بين ما يكون على VCC وGND، مع مقاومة المسار نفسها خلف المنزلق، لذلك يرى مدخل ADC يحمل حملًا ما كان سيراه على المنضدة.

عصا التحكم تحتاج إلى ADC، وكلتا اللوحتين فيه واحدة. محوّل Uno هو محوّل ATmega328P ذو العشرة بت على A0 إلى A5؛ ومحوّل ESP32-C3 هو ADC1 باثني عشر بت على GPIO 0 إلى GPIO 4. فتعمل العصا على أي منهما، ويقرأ المحور من 0 إلى 1023 على واحدة ومن 0 إلى 4095 على الأخرى، وmokxi_joystick.h في مكتبة البرامج الثابتة تخفي هذا الاختلاف.

شاهدها: OLED pong (Uno)، وOLED pong على ESP32-C3، وعصا تحكم ESP32-C3، وSnake على مصفوفتين.

المحوّل الدوّار (KY-040)

عمود يَعُدّ النقرات في كلا الاتجاهين، مع مفتاح تحته. ثلاثة تلامسات إلى الأرضي: CLK وDT هما نصفا مشفّر رباعي الأطوار وSW هو زر الضغط. تحمل الوحدة مقاومات سحب بقيمة 10 ك على زوج الأطوار؛ أما SW فلا مقاومة له، ولهذا يقرأه كل كود بـ INPUT_PULLUP.

ثلاث طرق لتدويره في مساحة العمل:

  • اسحب حول المقبض: زاوية المؤشر بالنسبة إلى العمود هي زاوية العمود؛
  • عجلة التمرير فوق المقبض: كل نقرة واحدة درجة واحدة، بعيدًا عنك باتجاه عقارب الساعة؛
  • اسحب لأعلى ولأسفل: لشاشات اللمس، وللسحب الذي يبدأ على العمود نفسه حيث لا معنى للزاوية.

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

تتعامل mokxi_rotary.h معه بالطريقة الصحيحة، بجدول حالات من ستة عشر مدخلًا: كل انتقال يسجّل ‎+1 أو ‎-1 أو لا شيء عندما يقفز الزوج حالتين دفعة واحدة، وهو شكل الارتداد. وتُبلَّغ النقرة عندما تتجمع أربع خطوات ربعية ويعود العمود إلى درجة تثبيت.

شاهدها: Ring Simon.

حلقة وشريط WS2812

Addressable RGB LEDs on one wire, with no clock: a bit is a high pulse whose length is the bit, 0.4 microseconds for a zero and 0.8 for a one, twenty-four bits an LED, green first. The part decodes those pulses off the pin's own edges with the timing tolerance a real strip has, and fifty microseconds of quiet latches the frame.

يحدد layout الصورة. strip صف واحد، وmatrix بعرض ستة عشر، وring يثني الصف إلى دائرة، LED 0 عند الثانية عشرة والباقي باتجاه عقارب الساعة، وهو ترقيم الحلقات التي يشتريها الناس. الحلقة شريط كهربائيًا، فلا شيء في التوصيل أو البرامج الثابتة يتغير؛ يتغير الرسم فقط.

المشغّل، mokxi_ws2812.h، يصنع النبضات بحلقة معدودة لا بمؤقت، لأن SYSTIMER في ESP32-C3 ينبض بمعدل 16 MHz وقراءته تستغرق وقتًا أطول من النبضة المقاسة. إنه ملف ترويسة لـ ESP32-C3: عند 16 MHz يملك Uno عشرين دورة للبتة كاملة وستّ دورات ونصفًا للنبضة الأولى، وهو ما لا تستطيع digitalWrite فعله دون صفحة كاملة من لغة التجميع المكتوبة يدويًا.

شاهدها: Ring Simon وشريط قوس قزح.

الألعاب الخمس

افتح أيًّا منها من قائمة الأمثلة، أو من القوالب على الموقع.

اللعبة اللوحة الشاشة الإدخال
OLED pong Uno SSD1306 عصا تحكم
OLED pong on an ESP32-C3 ESP32-C3 SSD1306 عصا تحكم
Snake on two matrices Uno MAX7219 اثنان عصا تحكم
Ring Simon ESP32-C3 حلقة WS2812 محوّل دوّار
OLED dice ESP32-C3 SSD1306 زر أركيد

لعبتا البونغ هما الدائرة نفسها على اللوحتين، وهو أقصر طريق لترى ما تغيّره اللوحة وما لا تغيّره.

كل منها برنامج ثابت حقيقي مُترجم للوحة التي تحمل اسمها، ويعمل على نفس النواة التي يعمل عليها كل شيء آخر هنا. اضغط تشغيل، ثم حرّك المدخل بالمؤشر: اسحب رأس العصا، أو أدر مقبض المشفّر الدوّار، أو استمر بالضغط على الزر.

There is a sixth, Stacker, on two MAX7219 matrices with one button, and it plays itself until you press something.