تعلّم

مصفوفة LED مع MAX7219 على Arduino، تتقافز عليها كرة

متوسط

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

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

ثمانية وستون LED تحتاج إلى ثمانية وستين طرفًا لو وصّلتها واحدًا واحدًا، بينما Arduino Uno فيه عشرون طرفًا فقط. MAX7219 هو الشريحة التي تحل هذه المشكلة: توجد على ظهر وحدات المصفوفة الحمراء الرخيصة 8x8، وتحتاج ثلاثة أسلاك من اللوحة، وتقوم بمسح الـ LED الأربعة والستين كلها بنفسها. الدائرة أعلاه هي Uno تقفز بنقطة حجمها اثنان في اثنين داخل إحدى تلك المصفوفات، وتعمل في متصفحك بالكود نفسه الذي يمكنك قراءته أدناه.

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

ما تحتاجه

  • Arduino Uno
  • وحدة مصفوفة LED ‏8x8 مع MAX7219 على ظهرها (النوع الأحمر الشائع)
  • خمسة أسلاك توصيل، أنثى إلى ذكر إذا كانت الوحدة لها أطراف رأسية
  • لوحة تجارب لمسارات الطاقة (اختياري)

التوصيل

القطعة والطرفيتصل بـملاحظة
VCC الوحدة5 Vيحتاج MAX7219 إلى ما بين 4 و 5.5 فولت، فاستخدم 5 V وليس 3.3 V
GND الوحدةGNDمشترك مع اللوحة
DIN الوحدةالطرف 11دخل البيانات التسلسلي
CS الوحدةالطرف 10مكتوب عليه LOAD في بعض الوحدات؛ حافته الصاعدة تثبّت الحزمة
CLK الوحدةالطرف 13ساعة الإزاحة
DOUT الوحدةDIN للوحدة التاليةلا يستخدم إلا عند تسلسل مصفوفة ثانية

كيف يرسم MAX7219 صورة

تحتفظ الشريحة بثمانية سجلات في كل منها ثماني بتات، سجل واحد لكل صف من صفوف المصفوفة. البت 1 يعني LED مضيئًا والبت 0 يعني LED مطفأً، والبت 7 هو العمود الأقصى يسارًا. فالصورة كلها هي ثماني بايتات، وتغيير صف من الشاشة هو كتابة بايت واحد في سجل واحد. ثم تضيء الشريحة الصفوف واحدًا واحدًا بسرعة تجعل عينك تراها كلها الثمانية دفعة واحدة.

الحديث إليها يكون عبر حزمة من ست عشرة بتة: أنزل CS، وأخرج عبر DIN و CLK عنوان سجل وبايت بيانات نبضة نبضة، ثم ارفع CS. الحافة الصاعدة لـ CS هي ما يجعل الشريحة تنفّذ الحزمة. السجلات من 1 إلى 8 هي الصفوف؛ أما البقية فتضبط السطوع (ستة عشر مستوى)، وعدد الصفوف الممسوحة، وتفعيل فك ترميز الأرقام، وما إذا كانت الشريحة في وضع الإيقاف.

هذه الأخيرة تصيب الجميع مرة واحدة. عند التشغيل يكون كل سجل صفرًا، أي إيقاف، ومسح صف واحد، وأدنى سطوع. المصفوفة التي تبقى مطفأة هي في الغالب كود لم يكتب قط سجلات Shutdown و Scan Limit و Intensity. استدعاء begin() في الكود يفعل ذلك بالضبط.

الكود، إطارًا بإطار

يحتفظ المشغّل ببايتات الصفوف الثمانية في ذاكرة RAM الخاصة بـ Uno. تنقل الحلقة الكرة بكسلًا واحدًا، وترتدها عن أي جدار وصلت إليه، وتصفّر المخزن المؤقت، وترسم الكرة بـ fillRect، وترسم خطًا على طول أي جدار تمت ملامسته، ثم تستدعي show() التي ترسل الصفوف الثمانية كلها إلى الشريحة. بعد ذلك تنتظر 90 ms، فتتحرك الكرة نحو إحدى عشرة مرة في الثانية.

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

جزء الرسم من الحلقة، من مثال كرة المصفوفة
matrix.clear();
if (flash & 0x01) matrix.fillRect(0, 0, 8, 1, true);  // top wall
if (flash & 0x02) matrix.fillRect(7, 0, 1, 8, true);  // right wall
if (flash & 0x04) matrix.fillRect(0, 7, 8, 1, true);  // bottom wall
if (flash & 0x08) matrix.fillRect(0, 0, 1, 8, true);  // left wall
matrix.fillRect(x, y, BALL, BALL, true);
matrix.show();

// A bounce is also a flicker of brightness, which costs one packet.
matrix.setIntensity(flash ? 15 : 8);
delay(FRAME_MS);

الدالة المساعدة، والمكتبة التي كنت ستستخدمها على Uno حقيقي

يتضمن المثال mokxi_max7219.h، مشغّلًا صغيرًا يأتي مع Mokxi: Max7219 matrix(DIN, CS, CLK, blocks)، ثم begin() و setPixel() و fillRect() و text() و show(). على لوحة حقيقية الخيار المعتاد هو مكتبة LedControl من Arduino Library Manager، وهي مضمّنة في Mokxi أيضًا باسم LedControl.h، أو MD_MAX72XX للنص المتحرك عبر عدة وحدات.

باستخدام LedControl الإعداد نفسه هو LedControl lc(11, 13, 10, 1)، ثم lc.shutdown(0, false) و lc.setIntensity(0, 8) و lc.clearDisplay(0) في setup()، و lc.setLed(0, row, column, true) أو lc.setRow(0, row, value) للرسم. انتبه لترتيب الأطراف: يأخذ LedControl البيانات ثم الساعة ثم CS، بينما يأخذ مشغّل Mokxi البيانات ثم CS ثم الساعة. الخطأ في هذا الترتيب هو السبب الأكثر شيوعًا لبقاء أول كود مصفوفة بلا أي عرض.

الطرفان 11 و 13 هما أيضًا طرفا SPI العتاديان في Uno ‏(MOSI و SCK)، ولهذا تستخدمهما أغلب مخططات التوصيل. المكتبة التي تستخدم SPI العتادي تحتاج DIN على 11 و CLK على 13؛ أما CS فيمكن أن يكون أي طرف.

جرّبه في المحرر

غيّر FRAME_MS من 90 إلى 30 فتتسارع الكرة. غيّر BALL إلى 1 فتصبح بكسلًا واحدًا يمكنه بلوغ كل مربع.

استبدل الكرة بنص: ‏matrix.text(0, 0, "A") يرسم حرفًا من خط 5x7 المدمج. ثم جرّب وجهًا مبتسمًا كثماني بايتات، بايت لكل صف، مكتوبة بـ setPixel في حلقتين.

اضبط خاصية عدد الوحدات على 4 والوسيطة الأخيرة في المنشئ على 4، فيصبح أمام الكود نفسه لوحة 32 في 8 للعمل عليها، وهي بالضبط وحدات «أربع في واحدة» المباعة للنص المتحرك.

من أين تشتري القطع

تُباع وحدة المصفوفة الحمراء الجاهزة مع MAX7219 مثبتًا مسبقًا على ظهرها تحت علامات تجارية عامة كثيرة، عادة في مجموعات، عبر أسواق التسوق الإلكترونية الكبرى. وإن كنت تفضل بناءها بنفسك، تبيع Adafruit شريحة MAX7219CNG منفردة ومصفوفة حمراء مصغّرة 8x8 تناسبها. وتحمل SparkFun و DigiKey كلتاهما مصفوفات LED ورقائق مشغّلة؛ ابحث في فهارسهما عن MAX7219. روابط صفحات Adafruit موجودة في المصادر أدناه. هذه متاجر أمريكية، مذكورة كمثال فقط. الأسعار والتوفر يختلفان حسب البلد، فخارج الولايات المتحدة ابحث عن اسم القطعة نفسه في متجر إلكترونيات محلي أو متجر إلكتروني يشحن إليك.

أخطاء شائعة

مصفوفة مطفأة بعد الرفع. تشتغل الشريحة في وضع الإيقاف بأدنى سطوع. تأكد أن setup يكتب تعطيل Shutdown، وحد مسح 7، وقيمة سطوع.

الصورة معكوسة أو مدوّرة. تُبنى الوحدات باتجاهات مختلفة. اعكس الإحداثية x أو y في كودك بدل إعادة التوصيل.

تبديل CS و CLK. يختلف ترتيب الأطراف في المنشئ بين المكتبات، كما سبق.

تغذية عدة وحدات من طرف 5 V في Uno. وحدة واحدة بسطوع معتدل لا مشكلة فيها؛ لكن سلسلة من أربع مع إضاءة LED كثيرة قد تسحب أكثر مما ينبغي أن يوفره منظم اللوحة أو منفذ USB. أعطِ السلسلة الطويلة تغذية 5 V خاصة بها مع أرضية مشتركة.

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

افتح الدائرة

الأسئلة

كم طرفًا تحتاج مصفوفة MAX7219 على لوحة Arduino؟

ثلاثة أطراف إشارة (DIN و CS و CLK) إضافة إلى 5 V والأرضي. يمكن تسلسل وحدات أخرى على الأطراف الثلاثة نفسها، من DOUT في وحدة إلى DIN في التالية.

أي مكتبة أستخدم لـ MAX7219 على لوحة Arduino حقيقية؟

LedControl هي الأبسط لنقاط وصفوف مفردة. أما MD_MAX72XX مع MD_Parola فوقها فهي الخيار المعتاد للنص المتحرك عبر عدة وحدات. يستخدم Mokxi ملفه الخاص الصغير mokxi_max7219.h ويوفّر LedControl.h أيضًا.

هل يعرض Mokxi تعدد إرسال MAX7219؟

لا. الشريحة الحقيقية تضيء صفًا واحدًا في كل مرة بتردد يقارب 800 Hz، أما النموذج فيعرض كل صف مفعّل دفعة واحدة، وتكون الشدة سطوعًا لا تيارًا. أما السجلات وحالة التشغيل والتسلسل فهي كما في الشريحة.

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

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