تعلّم

لعبة البناء الأركيد على مصفوفتي LED

متقدم

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

  • 526قطعة على المنضدة
  • 46لوحة تعمل الآن
  • 1.00xزمن حقيقي، على كل لوحة
ESP32-C3: لعبة الرك stacked الآركيدمباشر0.000 s 0.00x
اضغط «تشغيل» ثم اضغط الزر الكبير لإسقاط الصف
The Stacker example: two cascaded MAX7219 matrices for an 8x16 field and one arcade button. Press it to drop the row.

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

الدائرة أعلاه تشغّلها على لوحة ESP32-C3 بكود Arduino. تقف وحدتا مصفوفة MAX7219 مقاس 8x8 واحدة فوق الأخرى لتشكّلا ملعبًا بعرض ثمانية نقاط وارتفاع ستة عشر. اضغط «تشغيل» فيبدأ مكعب بعرض ثلاث نقاط بالانزلاق على طول الأسفل. اضغط الزر الكبير لإسقاطه. إذا هبط المكعب على الصف الأعلى فقد فزت: تبقى البرج المكتمل ثابتًا، يمتلئ الملعب كله من الأسفل إلى الأعلى ويومض، وتبدأ لعبة جديدة. اترك اللعبة أربع ثوانٍ دون لمس وتلعب بنفسها، وأحيانًا تخطئ عمدًا، حتى يضغط أحدهم الزر مرة أخرى.

ما تحتاجه

  • لوحة ESP32-C3 (أو Arduino Uno؛ انظر أدناه)
  • وحدتا مصفوفة LED ‏8x8 من نوع MAX7219
  • زر آركيد مقاس 30 mm، أو أي زر ضغط
  • لوحة تجارب وأسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
DIN للمصفوفة العلياGPIO 7البيانات تذهب إلى الوحدة العليا فقط
DOUT للمصفوفة العلياDIN للمصفوفة السفلىالتسلسل (cascade)
CLK في كلتا المصفوفتينGPIO 5مشترك
CS للمصفوفتينGPIO 6تحديد شريحة واحدة للسلسلة
VCC و GND للمصفوفتينطرف 5V وطرف GNDليس 3V3: تحتاج MAX7219 إلى 4 V أو أكثر
زر أركيدGPIO 3الرجل الأخرى إلى GND، بمقاومة رفع الطرف الداخلية

التسلسل: وحدتان، ثلاثة أسلاك

تحتوي كل MAX7219 على سجل إزاحة بعرض 16 بت وطرف DOUT في نهايتها. صِل DOUT للوحدة العليا بـ DIN للسفلى وشارك الساعة وتحديد الشريحة، فتعمل الوحدتان كسجل واحد بعرض 32 بت. أرسل 32 بت مع خفض CS وستنتهي أول 16 بت أرسلتها داخل الشريحة الثانية. حافة صاعدة واحدة من CS تثبّت الاثنتين معًا.

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

يشغّل الكود الرقائق بدواله القصيرة الخاصة بدلًا من مكتبة، فيبقى التسلسل ظاهرًا للعيان: الحزمة الواحدة هي أربع بتات غير مستخدمة، وعنوان سجل من أربع بتات، وبايت بيانات، تُرسَل بتّها الأعلى أولًا. على لوحة حقيقية يقوم LedControl بالأمر نفسه عبر LedControl lc(DIN, CLK, CS, 2).

سجل واحد في كل وحدة، يُثبَّتان معًا
static void shift_packet(uint8_t address, uint8_t data) {
  uint16_t packet = ((uint16_t)(address & 0x0f) << 8) | data;
  for (int8_t bit = 15; bit >= 0; bit--) {
    digitalWrite(CLK_PIN, LOW);
    digitalWrite(DIN_PIN, (packet >> bit) & 1u ? HIGH : LOW);
    digitalWrite(CLK_PIN, HIGH);
  }
}

static void write_chain(uint8_t address, uint8_t bottom, uint8_t top) {
  digitalWrite(CS_PIN, LOW);
  shift_packet(address, bottom);  // pushed through the top chip
  shift_packet(address, top);
  digitalWrite(CS_PIN, HIGH);     // both latch here
}

كيف تُلعَب اللعبة في الكود

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

يبدأ المكعب بعرض ثلاثة أعمدة. من المستوى 7، الصف الأعلى للوحدة السفلى، يصبح عرضه اثنين على الأكثر، وفي المستويات الثلاثة العليا يصبح واحدًا. تنخفض مدة الخطوة مع الارتفاع، من 210 ms لكل عمود في الأسفل إلى 70 ms في الأعلى، وتُحسب بطرح 140 مضروبًا في المستوى مقسومًا على 15 من 210.

يعتمد الزر على حافته: يتذكّر الكود هل كان مضغوطًا في المرة السابقة، فالضغط المطوّل يُسقط مكعبًا واحدًا لا واحدًا في كل دورة. بين الخطوات ينام الكود 2 ms في كل مرة، ومع ذلك يقرأ الزر 500 مرة في الثانية.

على Arduino Uno بدلًا من ذلك

لا شيء في الكود خاص بـ ESP32: يستخدم digitalWrite و digitalRead و millis و delay و random. لتشغيله على Uno، غيّر أرقام الأطراف الأربعة (مثلًا DIN على 11 و CLK على 13 و CS على 10 والزر على 2) وغذِّ الوحدات من خرج 5 V في Uno. افتحه في المحرر، بدّل اللوحة، وأعد التوصيل.

أخطاء شائعة

يبقى النصف السفلي مطفأً. سلك التسلسل من DOUT للوحدة العليا إلى DIN للوحدة السفلى مفقود أو على الطرف الخطأ. اسحبه في الدائرة أعلاه وسيختفي المكعب الذي يبدأ من الأسفل، بينما يبقى النصف الأعلى يعمل، كما ترى حين يصل البرج إليه.

النصفان معكوسان أو يعرض كل منهما صورة الآخر. الحزم بترتيب خاطئ. أول حزمة تُرسَل تهبط في الوحدة الأبعد.

لا يضيء شيء إطلاقًا. تبدأ MAX7219 في وضع إيقاف التشغيل، بمسح صف واحد، وبسطوع صفري. يكتب الكود shutdown و scan limit و decode mode و intensity في البداية؛ احذف أيًّا منها وتبقى اللوحة مطفأة.

تغذية الوحدات من 3.3 V. تحتاج إلى 4 V أو أكثر، فاستخدم طرف 5V في اللوحة.

الزر يُسقط كل كتلة أثناء الضغط. عُدّ التغيّر من مرتفع إلى منخفض، لا المستوى.

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

افتح الدائرة

الأسئلة

كيف أصنع لعبة التكديس بـ Arduino؟

استخدم مصفوفتي MAX7219 مقاس 8x8 متسلسلتين لملعب 8x16 وزرًا واحدًا. احتفظ ببايت واحد لكل صف، حرّك الكتلة بـ millis()، وعند الضغط على الزر طبّق AND مع الصف الذي تحته. ما يتبقى هو الصف الجديد.

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

نعم، بثمانية مستويات بدل ستة عشر. اجعل LEVELS تساوي 8، انقل مستويات التضييق إلى الأسفل، واحذف الحزمة الثانية من كل كتابة.

لماذا تلعب اللعبة بنفسها؟

بعد أربع ثوانٍ دون ضغط تدخل وضع الاستعراض، مثل ماكينة الآركيد: تصوّب على الصف الذي تحته وتخطئ أحيانًا بعمود واحد عمدًا. ضغطة حقيقية واحدة تعيد اللعبة إليك.

هل يمكنني استخدام شريط WS2812 بدلًا من ذلك؟

نعم. شبكة WS2812 مقاس 16x8 تعمل بالطريقة نفسها مع مكتبة Adafruit NeoPixel. منطق اللعبة لا يتغيّر، فقط الرسم.

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

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