تعلّم

لعبة Pong على شاشة TFT ملونة: شاشة ILI9341 على لوحة Arduino Uno

متقدم

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

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

شريحة ILI9341 هي الشريحة المستخدمة في شاشات TFT الملونة الشائعة بمقاسي 2.4 و2.8 بوصة، بدقة 240 في 320 بكسل. إنها خطوة كبيرة مقارنة بشاشة OLED صغيرة. تحصل على 65,536 لونًا ومساحة تكفي لعبة حقيقية أو لوحة معلومات. تتواصل مع Arduino عبر SPI مع بضعة أطراف تحكم إضافية.

الدائرة أعلاه هي Arduino Uno تشغّل لعبة Pong على شاشة ILI9341، مع عصا تحكم لتحريك المضرب وقطعة piezo لأصوات التنبيه. اضغط العصا للإرسال. تعمل مباشرة في متصفحك بالكود أدناه، وطريقة الرسم فيها تعلّمك أهم شيء عن هذه الشاشات: أعد رسم ما تحرّك فقط.

ما تحتاجه

  • Arduino Uno
  • وحدة شاشة ILI9341 SPI TFT بمقاس 2.4 بوصة (240x320)
  • وحدة عصا تحكم وقطعة piezo buzzer، من أجل اللعبة
  • لوحة تجارب كاملة الحجم وأسلاك توصيل

التوصيل

القطعة والطرفيتصل بـملاحظة
TFT CSالطرف 10تحديد الشريحة
TFT DCالطرف 9مستوى LOW للأوامر ومستوى HIGH للبيانات
TFT SCKالطرف 13ساعة SPI
TFT MOSIالطرف 11بيانات SPI إلى الشاشة
TFT RST5 Vمربوطة بمستوى عالٍ هنا؛ أو وصّلها بطرف وسمِّه في الكود
TFT LED5 Vالإضاءة الخلفية؛ بدونها تبقى الشاشة معتمة
TFT VCC وGND5 V وGNDتحقّق من وحدتك: كثير منها يتطلب منطق 3.3 V
الطرفان VRX وVRY للعصاA0, A1المحوران
Stick SWالطرف 2الضغط
Piezoالطرف 6 وGNDالنغمات الصوتية

DC: أمر أم بيانات

لدى ILI9341 طرف إضافي واحد يميّزه عن شريحة SPI العادية: وهو DC، للبيانات أو الأوامر. عندما يكون DC في مستوى منخفض (LOW)، فإن البايت الذي ترسله يكون أمرًا، مثل «حدد النافذة» أو «ابدأ كتابة البكسلات». وعندما يكون DC في مستوى مرتفع (HIGH)، تكون البايتات هي البيانات الخاصة بذلك الأمر، بما في ذلك البكسلات نفسها.

رسم المستطيل يتم في ثلاث خطوات: حدد مدى الأعمدة، ثم حدد مدى الصفوف، ثم أرسل عدد ألوان البكسلات المطلوب. كل مكتبة تفعل ذلك بالضبط في الخلفية.

لماذا تعيد اللعبة رسم ما تحرّك فقط

كل بكسل يمثل 16 بت، والشاشة كاملة تبلغ 76,800 بكسل. هذا قدر كبير من البيانات بالنسبة إلى Uno. في Mokxi لا يمتلك طراز Uno عتاد SPI، لذا يُرسَل كل بت يدويًا، ومسح الشاشة كاملة يستغرق نحو ثانية ونصف. عتاد SPI في Uno حقيقي أسرع، لكن إعادة الرسم الكاملة تبقى بطيئة جدًا على لعبة سلسة.

لذلك يرسم الكود الإطار والتسميات والنتيجة مرة واحدة. وبعد ذلك، كل إطار يعيد رسم الكرة وشريط المضرب الذي تحرّك فقط: أقل من ألفي بكسل، وهذا يحافظ على سرعة 30 إطارًا في الثانية. كما تعمل اللعبة داخل نافذة 160 في 200 في وسط الشاشة، مما يجعل المسح الأول أقصر.

هذه العادة، الرسم مرة واحدة ثم تحديث ما تغيّر فقط، هي مفتاح أي مشروع شاشة سريع، على أي لوحة.

رسم الأجزاء الثابتة مرة واحدة، من مثال جهاز Pong
static void drawFrame() {
  tft.fillRect(FX, FY, FW, FH, BG);
  tft.rect(FX - 2, FY - 2, FW + 4, FH + 4, EDGE, 2);
  tft.text(FX, FY - 26, "PONG", ILI9341_WHITE, ILI9341_BLACK, 3);
  tft.text(FX, FY + FH + 10, "SCORE", ILI9341_WHITE, ILI9341_BLACK, 2);
  tft.text(FX + 110, FY + FH + 10, "LIVES", ILI9341_WHITE, ILI9341_BLACK, 2);
}

استخدام مكتبة Adafruit

يستخدم المثال mokxi_ili9341.h، وهو مشغّل صغير يأتي مع Mokxi. على Uno حقيقي، تستخدم معظم الأدلة مكتبتَي Adafruit_ILI9341 وAdafruit_GFX، ويأتي Mokxi بملفات ترويسة بهذين الاسمين وباستدعاءاتهما المعتادة أيضًا. مثال «مرحبًا بالعالم» أدناه مكتوب بالطريقة التي تُكتب بها في تلك الأدلة.

تختلف نسخة Mokxi في بعض الأمور: الخط المدمج هو خط Mokxi الخاص بمقاس 5x8، وملفات Fonts/ هي حروف Mokxi بمقاس كل خط. لا يُقرأ أي شيء من الشاشة. والناقل هو SPI برمجي، لذا ارسم ما تحرّك بدلًا من ملء الشاشة كاملة باستمرار.

«مرحبًا بالعالم» مع مكتبة Adafruit ILI9341
#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ILI9341.h>

Adafruit_ILI9341 tft(10, 9);  // CS, DC; add a third pin for RST if it is wired

void setup() {
  tft.begin();
  tft.setRotation(1);
  tft.fillScreen(ILI9341_BLACK);
  tft.setTextColor(ILI9341_WHITE);
  tft.setCursor(10, 10);
  tft.print("Hello");
}

void loop() {
}

افتح هذا الكود في المحررالكود وحده: يضع المحرر اللوحة والقطع التي يستطيع قراءتها من الكود.

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

غيّر BALL_COLOUR إلى ILI9341_RED وتتحول الكرة إلى اللون الأحمر. الألوان أعداد RGB565 بحجم 16 بت، لذا يمكنك أيضًا كتابة لونك الخاص، مثل 0xF81F للأرجواني.

اجعل المضرب أعرض برفع PADDLE_W من 36 إلى 60، فتصبح اللعبة أسهل. اجعل النافذة أكبر بتغيير FW وFH، ولاحظ أن المسح الأول يستغرق وقتًا أطول.

أخطاء شائعة

شاشة بيضاء أو شاشة داكنة. افحص طرف LED: فهو الإضاءة الخلفية، وتبقى الشاشة داكنة بدونه. الشاشة البيضاء مع تفعيل الإضاءة الخلفية تعني غالبًا أن التهيئة لم تعمل أبدًا: افحص CS وDC وRST.

منطق 5 V على شاشة 3.3 V. كثير من وحدات ILI9341 قطع تعمل بـ3.3 V. بعضها يحتوي على محول مستويات على اللوحة وبعضها لا يحتوي. افحص وحدتك قبل توصيلها بـUno، واستخدم محولات المستويات إن لزم الأمر.

مسح الشاشة كاملة في كل إطار. هذا يسبب الوميض والبطء. ارسم الخلفية مرة واحدة وأعد رسم ما تغيّر فقط.

الخلط بين DC وCS في المُنشئ. الترتيب هو CS أولًا، ثم DC.

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

افتح الدائرة

الأسئلة

ما الأطراف التي تستخدمها ILI9341 على Arduino Uno؟

وصّل SCK بالطرف 13 وMOSI بالطرف 11 (أطراف SPI في Uno)، ووصّل CS وDC بأي طرفين تحدّدهما في الكود، وRST بطرف ما أو بمصدر التغذية، وLED بمصدر التغذية للإضاءة الخلفية.

لماذا شاشة ILI9341 بطيئة جدًا على Uno؟

الشاشة الكاملة هي 76,800 بكسل، كل بكسل 16 بت. أعد رسم ما يتغيّر فقط. في Mokxi يتم تنفيذ SPI على Uno برمجيًا، لذا فهو أبطأ أكثر، ومثال Pong يوضح كيفية التعامل مع ذلك.

هل يدعم Mokxi النسخة التي تدعم اللمس؟

نعم. توجد نسخة من ILI9341 بلوحة لمس في صندوق القطع، تُقرأ بمكتبة XPT2046_Touchscreen، ومشروع Touch paint يستخدمها.

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

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