الدروس ولعبة التعلّم

اكتب مكتبة Arduino بنفسك

اكتب TinyDigits، برنامج تشغيل شاشة TM1637، انطلاقًا من ورقة البيانات حتى النهاية، وانشره كملف zip يمكن لأي شخص تثبيته.

كيف يعمل

دورة اكتب مكتبة Arduino بنفسك هي دورة متوسطة المستوى بلغة ++C على لوحة Arduino Uno. يعمل كل درس على جهاز يوم القيامة من المعرض: شاشة TM1637 بأربعة أرقام على A0 (CLK) وA1 (DIO)، وثلاثة أزرار على الأطراف 6 و7 و8، وثلاثة مصابيح على الأطراف 2 و3 و4.

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

الدروس

  1. الملف الرأسي و.cpp: مشغّل مكتوب يدويًا من ورقة البيانات (بدء، إيقاف، ثمانية بتات بدءًا من الأقل أهمية وACK عند النبضة التاسعة)، مقسّم إلى ملف رأسي يقول ماذا يفعل و.cpp يقول كيف. حواجز التضمين، وstatic للخصوصية، وextern لقاعدة التعريف الواحد.
  2. تصميم الأصناف: TinyDigits كصنف. دالة إنشاء لا تلمس العتاد، وbegin() التي تخبرك إن ردّت الشريحة، ودوال ترفض ما لا تستطيع فعله، ودالة جديدة، ووسيطة افتراضية، وشاشة ثانية على أطراف لا توصيلات عليها.
  3. أمثلة: عرض واحد شامل استُبدل بثلاثة أمثلة يعلّم كل منها شيئًا واحدًا: HelloDigits، وزر عدّ تنازلي، وSelfTest.
  4. الدليل والكلمات المفتاحية: تعليقات توثيق تذكر المجالات وحالات الفشل، ومساعدة تُطبع من ثوابت المكتبة نفسها، وتوثيق وعد بقيمة ‎-9999 بينما تتوقف أربعة أرقام عند ‎-999، وملف keywords.txt للبيئة.
  5. Versioning: MAJOR.MINOR.PATCH as numbers a sketch tests in #if, a patch for a tidy-up that blanked zero, and a breaking change to setBrightness that earns 2.0.0.
  6. الضغط والمشاركة: تخطيط مكتبة Arduino، وملف library.properties يُطبع من الترويسة حتى تبقى الإصدارة في مكان واحد، وفحص قبل الإصدار يرفض إطلاق النسخة، وملف zip يُثبَّت عبر + Add library في Mokxi وAdd .ZIP Library في بيئة Arduino.

المشروع: ساعة مهمة

عدّ تنازلي للإطلاق على المكتبة الجاهزة، مع أزرار START وHOLD وRESET، ومصابيح للعدّ والإطلاق والتوقف، ونبض millis() لا ينحرف أبدًا. تضيف showText() إلى المكتبة كإصدار ثانوي (2.1.0)، وتجعل الساعة تعرض GO عند الإطلاق، ثم تجعلها لك: عدّ بالدقائق مع النقطتين، أو آخر ثلاث ثوانٍ وامضة، أو شاشة ثانية.

ما يفعله Uno بشكل مختلف

  • تبويب الكود يحصل على أسماء Arduino مجانًا؛ أما تبويب .cpp فيجب أن يبدأ بـ #include <Arduino.h>، كما في بيئة Arduino.
  • شريحة TM1637 ليست I2C، لذا يستخدم المشغّل طرفين عاديين. يعمل A0 وA1 كطرفين رقميين 14 و15.
  • تستخدم المكتبة مقاومات السحب الذاتية في الشريحة (INPUT_PULLUP) لتترك الخطين مرتفعين، فالطرف الذي لا شيء عليه يقرأ مرتفعًا ولا تجد begin() إشارة ACK.
  • int حجمه 16 بت على Uno، لذا تحفظ showNumber أرقامها في unsigned int ومجالها داخل ‎-999 إلى 9999.

قبل وبعد

يغطي C++ للبرامج الحقيقية الأصناف والمراجع والترويسات التي يبني عليها هذا المسار. تعمل المكتبة الجاهزة في أي مشروع: أضف ملف zip تحت المكتبات وضمّنه بأقواس زاوية.