تعلّم

لعبة ثعبان على مصفوفتين LED بمقاس 8x8

متقدم

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
Arduino Uno: ثعبان على مصفوفتي LEDمباشر0.000 s 0.00x
اضغط «تشغيل»، ثم حرّك عصا التحكم لبدء اللعب
مثال الثعبان على مصفوفتين: وحدتا MAX7219 لحقل بمقاس 8x16 وعصا تحكم. ادفع العصا لبدء اللعب.

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

الدائرة أعلاه تشغّلها على Arduino Uno مع وحدتَي مصفوفة LED ‏8x8 من نوع MAX7219، واحدة فوق الأخرى، لحقل بعرض ثماني نقاط وارتفاع ست عشرة. عصا التحكم توجّه الثعبان. اضغط «تشغيل» وينتظر الثعبان، بطول ثلاث نقاط مع تفاحة في مكان ما على الحقل. ادفع العصا أو اضغط عليها وينطلق الثعبان. اتركه وشأنه ويزحف مستقيمًا إلى الحائط السفلي في نحو ثلاث ثوانٍ ونصف؛ وتقول الشاشة التسلسلية "bitten". اضغط العصا للعب مرة أخرى.

ما تحتاجه

  • Arduino Uno
  • وحدتا مصفوفة LED ‏8x8 من نوع MAX7219
  • وحدة عصا تحكم (مقاوما متغيران ومفتاح ضغط)
  • لوحة تجارب وأسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
DIN في كلتا المصفوفتينالطرف 11بيانات مشتركة
CLK في كلتا المصفوفتينالطرف 13ساعة مشتركة
CS المصفوفة العلويةالطرف 10لكل وحدة طرف تحكم خاص بها
CS المصفوفة السفليةالطرف 9
VCC و GND للمصفوفتين5 V وGNDيحتاج MAX7219 إلى 4 V أو أكثر
VRX العصاA0يمين ويسار
VRY العصاA1أعلى وأسفل
Stick SWالطرف 2اضغط للبدء أو إعادة البدء
VCC و GND العصا5 V وGND

الشاشة

تحفظ شريحة MAX7219 ثمانية بايتات، واحدًا لكل صف في المصفوفة، وتمسحها ضوئيًا بنفسها، لذلك لا يكتب Uno إلا بايتًا واحدًا عند تغيّر شيء. الوحدتان تتشاركان البيانات والساعة، ولكل منهما طرف تحكم خاص. كل ما يرسله Uno بينما طرف CS منخفض يذهب إلى تلك الوحدة وحدها.

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

يستخدم المثال mokxi_max7219.h، مشغّلًا صغيرًا يأتي مع Mokxi: ‏setPixel() و clear() و show(). على لوحة حقيقية الخيار المعتاد هو مكتبة LedControl من مدير المكتبات، وهي متوفرة في Mokxi أيضًا باسم LedControl.h، حيث يقوم setLed(module, row, col, state) بالوظيفة نفسها التي يقوم بها setPixel().

الجسم والتفاحة والجدران

The snake is a ring buffer: an array of 128 cell numbers, one per dot on the field, with an index for the head. A cell number is row times 8 plus column. Each step works out the next cell from the heading, writes it at the head, and lights it. If the snake did not just eat, it also turns off the tail cell, so the snake moves without being redrawn. Two dots change per step, and the other 126 are left as they are.

الأكل هو مقارنة: إذا كانت خلية الرأس الجديدة هي خلية التفاحة، يزيد الطول واحدًا، وينقص زمن الخطوة 8 ms (انطلاقًا من 240 ms، حتى يقل عن 90)، وتوضع تفاحة جديدة في خلية فارغة. الموت هو فحصان: الخلية الجديدة خارج الحقل، أو أنها جزء من الجسم أصلًا. الجدران هنا جدران فعلًا، وليست التفافًا من طرف إلى آخر، حتى يمكنك أن تخسر.

يأتي موضع التفاحة من مولّد أرقام عشوائية صغير (سجل إزاحة LFSR بطول 16 بت). تُمزج حالته مع millis() عندما يعيد اللاعب اللعب، فتأتي كل لعبة جديدة مختلفة.

التوجيه بعصا تحكم

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

يُرفض الالتفاف مباشرة إلى رقبة الثعبان نفسه. بدون هذه القاعدة، تنتهي اللعبة فورًا بنقرة سريعة من الأسفل إلى الأعلى.

تُقرأ العصا كل بضعة أجزاء من الثانية بين الخطوات، وليس مرة واحدة في كل خطوة. نقرة تبدأ وتنتهي داخل خطوة واحدة مدتها 240 ms كانت ستضيع دون ذلك.

قراءة العصا كاتجاه
static void steer() {
  int16_t x = stick.dx();
  int16_t y = stick.dy();
  int8_t wantX = 0, wantY = 0;
  int16_t ax = x < 0 ? -x : x;
  int16_t ay = y < 0 ? -y : y;
  if (ax > ay) {
    if (ax > THROW) wantX = x > 0 ? 1 : -1;
  } else if (ay > THROW) {
    wantY = y > 0 ? 1 : -1;
  }
  if (wantX == 0 && wantY == 0) return;
  waiting = false;                    // the first push starts the game
  if (wantX != 0 && dx != 0) return;  // no reversing into the neck
  if (wantY != 0 && dy != 0) return;
  dx = wantX;
  dy = wantY;
}

أخطاء شائعة

يبقى نصف الحقل مظلمًا. عادة ما يكون سلك CS لتلك الوحدة مفكوكًا أو على طرف خاطئ، أو أن VCC موصول بـ 3.3 V. يحتاج MAX7219 إلى 4 V أو أكثر.

ينعطف الثعبان من تلقاء نفسه لحظة بدء اللعبة. العصا الحقيقية لا تستقر عند 512 بالضبط، لذا قارن بموضع الاستقرار المقروء عند التشغيل، لا بالرقم 512، وأضف منطقة ميتة. قراءة طرفين تناظريين متتاليين على Uno فيها فخ ثانٍ: القراءة الأولى بعد تبديل القنوات قد تحمل قيمة القناة السابقة، فتخلّص منها.

تنتهي اللعبة قبل أن تلمس العصا. على حقل ارتفاعه ستة عشر صفًا، يصل ثعبان يتحرك كل 240 ms إلى الجدار في نحو ثلاث ثوانٍ. لهذا السبب ينتظر الكود الدفعة الأولى.

استخدام delay() لزمن الخطوة. تأخير بمقدار 240 ms يعني أن العصا لا تُقرأ طوال 240 ms. استخدم millis() واقرأ العصا في الأثناء.

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

افتح هذه الدائرة في المحرر. Arduino Uno: ثعبان على مصفوفتي LED، موصّلة كما تعمل أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.

افتح الدائرة

الأسئلة

كيف أصنع لعبة ثعبان على مصفوفة LED ‏8x8 باستخدام Arduino؟

شغّل المصفوفة بشريحة MAX7219 ومكتبة LedControl، وخزّن الثعبان كمصفوفة من الخلايا، وحرّك الرأس خلية واحدة في كل خطوة، وأطفئ الذيل إن لم يكن الثعبان قد أكل للتو، وأنهِ اللعبة عندما تخرج الرأس من الشبكة أو تهبط على الجسم.

هل يمكنني لعب الثعبان على مصفوفة واحدة 8x8؟

نعم. غيّر الحقل إلى 8 صفوف واحذف الوحدة الثانية. ستكون لعبة قصيرة على 64 نقطة، ولهذا يستخدم هذا المثال وحدتين لتحصل على 128.

هل يمكنني استخدام شاشة OLED أو TFT بدلًا منها؟

نعم. المنطق نفسه؛ تتغير نداءات الرسم فقط. لدى Mokxi نسخة TFT أيضًا، على شاشة ILI9341 بمقاس 240x320، مرتبطة أسفل هذه الصفحة.

هل يمكنني استخدام أزرار بدلًا من عصا التحكم؟

نعم. أربعة أزرار على أطراف INPUT_PULLUP، كل منها يضبط dx و dy، مع فحص منع الالتفاف للخلف نفسه.

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

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