تعلّم

عصا قتال DIY على Pro Micro من Arduino

متوسط

أو تصفّح كل الدروس.

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Pro Micro: ذراع وستة أزرارمباشر0.000 s 0.00x
اضغط «تشغيل»، ثم استخدم مفاتيح الأسهم
مفاتيح الأسهم تُحرّك الذراع، وZ وX هما الزران 5 و6، وأزرار الأركيد نقرات. راقب الشاشة التسلسلية.

عصا القتال من أكثر الأشياء المُجزية التي يمكن بناؤها بمتحكم دقيق. الإلكترونيات بسيطة: ذراع هو أربعة مفاتيح، وصف من أزرار الأركيد كلٌّ منها مفتاح واحد، ولوحة صغيرة تقرأها وتخبر الجهاز أو الحاسوب بما هو مضغوط. تُعد Pro Micro المفضّلة لذلك لأن شريحتها ATmega32U4 تحتوي على USB مدمجًا، فاللوحة نفسها التي تقرأ أزرارك يمكن أن تظهر على الحاسوب كذراع تحكم للألعاب.

الدائرة أعلاه هي عصا على Pro Micro في Mokxi: ذراع رباعي الاتجاهات على الأطراف 2 إلى 5، وأربعة أزرار أركيد على الأطراف 6 إلى 9، وزران إضافيان على الطرفين 1 و0. اضغط «تشغيل»، وحرّك الذراع بمفاتيح الأسهم، وانقر على الأزرار. تطبع الشاشة التسلسلية الاتجاه برموز لوحة الأرقام والأزرار المضغوطة، سطرًا في كل مرة يتغيّر فيها شيء.

أمر واحد قبل كل شيء لأنه مهم: Mokxi لا يحاكي جزء وحدة تحكم ألعاب USB. يحاكي Pro Micro وصلته عبر USB كاتصال تسلسلي إلى الشاشة التسلسلية لا أكثر، لذا يطبع الكود التقرير الذي كان سيرسله بدلًا من إرساله. ما يمكنك اختباره هنا هو كل ما يسبق تلك المرحلة: التوصيلات، ومقاومات الرفع، ومعالجة الارتداد (debounce)، ومنطق الاتجاهات، وخريطة الأزرار. وعندما يصبح ذلك صحيحًا، ترفع المنطق نفسه إلى لوحة حقيقية وتضيف مكتبة USB على المنضدة.

لماذا Pro Micro؟

معظم لوحات Arduino تتواصل مع الحاسوب عبر شريحة منفصلة تحوّل USB إلى اتصال تسلسلي، لذا تبدو للحاسوب دائمًا كمنفذ تسلسلي. أما شريحة ATmega32U4 الموجودة في Pro Micro وLeonardo وMicro فمختلفة: جهاز USB موجود في الشريحة نفسها، والكود هو الذي يحدد ما تكونه اللوحة. لهذا تعمل مكتبة Arduino Keyboard ومكتبة Arduino Joystick المجتمعية على هذه اللوحات ولا تعمل على Uno. توثيق مكتبة Joystick نفسه يقول إنها تحتاج إلى لوحة مبنية على 32U4 ولن تعمل على Uno أو Mega.

The Pro Micro also has enough pins. The one Mokxi models, the 5 volt, 16 MHz SparkFun board, brings out 18 input and output pins, and a stick needs four for the lever and one per button. Eight buttons plus a lever is twelve pins, with room left for a start or select button and a mode switch.

لكن فيها مفاجأة للمبتدئين: لا يوجد LED على الطرف 13. المصباحان على اللوحة هما مصباحا RX وTX، ويضيئان عندما يصبح طرفهما منخفضًا (LOW). يستخدم الكود النموذجي مصباح RX ليدل على أن زرًا مضغوطًا، فتحصل على تغذية راجعة على اللوحة نفسها.

توصيل الذراع والأزرار

كل مفتاح على العصا يُوصَّل بالطريقة نفسها. رِجلٌ واحدة إلى الأرضي (GND)، والأخرى إلى طرف، ومقاومة الرفع الداخلية في الطرف تُبقيه مرتفعًا (HIGH) حتى يسحبه المفتاح إلى المنخفض (LOW). إذن الزر المضغوط يُقرأ منخفضًا، ولا حاجة إلى مقاومات في أي مكان. في علبة حقيقية تُجمع الأرضيات عادة بسلك واحد متسلسل من زر إلى زر، وذلك السلك الواحد يعود إلى طرف GND على اللوحة.

الذراع عبارة عن أربعة مفاتيح دقيقة، واحد لكل اتجاه، حول محور. تأتي كثير من الأذرع مع حزمة من خمسة أسلاك: سلك أرضي وسلك لكل من الأعلى والأسفل واليمين واليسار. يستخدم هذا المثال لوحة اتجاهات (D-pad) من ذراع تحكم المنصة بدلًا منها، وتجلب معها زرين إضافيين؛ وإعداد الذراع التأرجحية مفعّل، وسلوكه يشبه بوابة الذراع. أما قالب عصا القتال لـ Pico فيستخدم قطعة ذراع Mokxi بنمط Sanwa بدلًا من ذلك، بحزمة من خمسة أطراف وكل ما يلزم.

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

معالجة الارتداد دون إضافة تأخير

التلامسات المعدنية ترتد. عندما يُغلق مفتاح، يفتح ويغلق عدة مرات في الميلي ثانية الأولى قبل أن يستقر. الكود الذي يقرأ بسرعة كافية يرى كل حافة من تلك الحواف كضغطة مستقلة. أزرار الأركيد في المثال مفعّل فيها إعداد الارتداد، لذا يمكنك رؤية ذلك يحدث.

طريقة Arduino المعتادة لمعالجة الارتداد تنتظر حتى يبقى الطرف مستقرًا لفترة قبل تصديقه. هذا ينجح، لكنه على وحدة تحكم يضيف الانتظار إلى كل ضغطة. المثال يفعل العكس: التغيير يُحتسب لحظة وصوله، ثم يتجاهل المدخل طرفه لفترة حجب قصيرة، 5 ميلي ثانية في الكود. يقع الارتداد داخل فترة الحجب فيُرمى، بينما الضغطة نفسها لا تتأخر إطلاقًا.

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

فترة الحجب، من كود المثال
bool down = digitalRead(PINS[i]) == LOW;
if (down != held[i] && now - changedAt[i] >= LOCK_MS) {
  held[i] = down;       // accept the change at once
  changedAt[i] = now;   // then ignore this pin for LOCK_MS
}

تدوين لوحة الأرقام واتجاه نظيف

لاعبو ألعاب القتال يكتبون الاتجاهات كالأرقام على لوحة أرقام لوحة المفاتيح: 5 هو الوضع المحايد، و6 هو الأمام لشخصية تواجه اليمين، و2 هو الأسفل، و3 هو الأسفل والأمام، و8 هو الأعلى، وهكذا. يعرض المثال الذراع بالطريقة نفسها، وهذا يجعل الشاشة التسلسلية مقروءة لأي شخص قرأ قائمة سلاسل حركات (combo).

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

من المحاكي إلى عصا حقيقية

عندما تعرض الشاشة التسلسلية الاتجاه والأزرار الصحيحة لكل مدخل، يصبح المنطق جاهزًا. بعدها سلّم الحالة نفسها إلى مكتبة HID حيث يستدعي المثال report(). يوفر Mokxi واجهة مكتبة Arduino Joystick كـ Joystick.h، وKeyboard.h، لـ Pro Micro وLeonardo وMicro: استدعاء setButton() لكل زر، ومفتاح قبعة (hat) أو محوران للذراع، ثم sendState(). في المحاكي كل تقرير هو سطر [Joystick] على الشاشة التسلسلية؛ وعند رفعه إلى لوحة حقيقية، يصبح الكود نفسه وحدة تحكم ألعاب USB.

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

افتح هذه الدائرة في المحرر. Pro Micro: ذراع وستة أزرار، موصولة كما تعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

هل يمكن أن تكون Arduino Uno عصا قتال؟

ليس مباشرة. الشريحة الرئيسية في Uno لا تملك USB خاصًا بها، لذا لا تعمل مكتبتا Keyboard وJoystick عليها. استخدم لوحة بشريحة ATmega32U4، مثل Pro Micro أو Leonardo أو Micro، أو لوحة RP2040 مثل Pico.

هل تحتاج أزرار الأركيد إلى مقاومات؟

لا. وصّل رِجلًا واحدة إلى الأرضي والأخرى إلى طرف مع INPUT_PULLUP. مقاومة الرفع الداخلية في الشريحة تُبقي الطرف مرتفعًا (HIGH)، والضغطة تسحبه إلى المنخفض (LOW).

هل يحاكي Mokxi وحدة تحكم USB؟

لا. يحاكي Pro Micro وصلته عبر USB كاتصال تسلسلي فقط، لذا يطبع المثال تقريره إلى الشاشة التسلسلية. تختبر هنا التوصيلات والمنطق، ثم تضيف مكتبة USB وترفع البرنامج إلى لوحة حقيقية.

كم يجب أن تكون مدة معالجة الارتداد؟

طويلة بما يكفي لتغطية ارتداد مفاتيحك ولا أطول. يستخدم المثال فترة حجب مدتها 5 ميلي ثانية تبدأ بعد قبول الضغطة، لذا لا تؤخر الضغطة.

ابنِ هذا على أرض الواقع

افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.