مكتبات الاردوينو | Arduinno Libraries - الجزء الثاني

مكتبات الاردوينو البرمجية - الجزء الثاني

انقر هنا لقرائة الجزء الاول

استخدام المكتبة.

أولاً، جعل Morse داخل مسار المكتبات sub-directory للمسار sketchbook الخاص بك. نسخ أو نقل الملفات Morse.h و Morse.cpp في هذا الدليل. الآن تشغيل بيئة Arduino. إذا قمت بفتحقائمة سكيتش > "استيراد مكتبة" ، يجب أن تشاهد Morse بداخلها. وسيتم تجميع المكتبة مع السكيتشات المستخدمه. إذا لم تبنى المكتبة ، تأكد من أن الملفات ينتهي حقاً بـ.cpp  و .h (بدون إضافة .pde أو.txt ملحق، على سبيل المثال).

دعونا نرى كيف يمكنك نسخ سكيتش الـ SOS القديمة باستخدام المكتبة الجديدة:

#include <Morse.h>

Morse morse(13);void setup()
{
}void loop()
{
  morse.dot(); morse.dot(); morse.dot();
  morse.dash(); morse.dash(); morse.dash();
  morse.dot(); morse.dot(); morse.dot();
  delay(3000);
}

[Get Code]

هناك بعض الاختلافات من الرسم القديم (إلى جانب حقيقة أن بعض الشفرات البرمجية انتقلت إلى مكتبة).

أولاً، لقد أضفنا عبارة #include إلى الجزء العلوي من السكيتش. وهذا يجعل المكتبة Morse  متاحة للسكيتش، ويشمل ذلك الشفرات البرمجية(Codes) التي أرسلت إلى اللوح. وهذا يعني إذا لم تعد بحاجة المكتبة في السكيتش، يجب عليك حذف العبارة #include لتوفير مساحة.

Morse morse(13);

[Get Code]

عندما يحصل تنفيذ هذا السطر (الذي يحدث بالفعل حتى قبل داله setup())، سوف تسمى المنشئ لفئة Morse، وتمرير الوسيطة التي كنت أعطيت هنا (في حاله اعطيت فقط(13)).

لاحظ أن لدينا setup() هي الآن فارغة؛ وهذا يرجع إلى أن الدعوة إلى pinMode() يحدث داخل المكتبة (عندما يتم إنشاء المثيل).

وأخيراً، استدعاء الدوال dot() و dash() ، نحن بحاجة إلى إضافة بادئة لهم مع morse. -اسم مثيل الذي نريد استخدامه . ونحن يمكن أن يكون مثيلات متعددة من فئة مورس، كل على رأسها (pin) الخاص المخزنة في المتغير _pin الخاصة لذلك المثيل. بواسطة استدعاء دالة على حالة معينة، يمكننا تحديد متغيرات المثيل الذي ينبغي أن تستخدم خلال ذلك الاستدعاء للدالة. هذا اذا كان الاثنين بحوزتنا :

Morse morse(13);
Morse morse2(12);

[Get Code]

ثم داخل استدعاء إلى morse2.dot() , _pin سيكون 12-

إذا كنت حاولت سكيتش جديد، ربما كنت لاحظت أن لا شيء من مكتبتنا تم التعرف عليه او سلط عليه الضوء. ولسوء الحظ، برنامج اردوينو لا يمكن تلقائياً معرفة ما كنت تعرف في المكتبة الخاصة بك (على الرغم من أنه سيكون سمة او خاصية لطيفة )، لذلك عليك أن تعطيه القليل من المساعدة. للقيام بذلك، قم بإنشاء ملف يسمىkeywords.txt في المجلد Morse directory. ينبغي أن تبدو مثل هذا:

Morse   KEYWORD1
dash    KEYWORD2
dot     KEYWORD2

[Get Code]

كل سطر يحتوي على اسم keyword ، متبوعاً بعلامة تبويب (not spaces)، متبوعاً بالنوع من keyword.

الفئات ينبغي أن يكون KEYWORD1 وهي برتقالية اللون؛

الدوال ينبغي أن يكون KEYWORD2 وبنية اللون.

 عليك إعادة تشغيل البيئة اردوينو للحصول على الاعتراف بالكلمات الرئيسية keyword الجديدة.

كما أنه من اللطيف ان تزويد الناس بسكيتش يستخدم المكتبة الخاصة بك. للقيام بذلك، قم بإنشاء مجلد امثلة داخل مجلد مورس. بعد ذلك، انقل أو انسخ من المجلد الذي يحتوي السكيتش (دعنا نسميها SOS) كتبناها فوق مجلد الامثلة. (يمكنك العثور على السكيتش باستخدام Sketch > Show Sketch Folder command.) إذا قمت بإعادة تشغيل البيئة اردوينو (هذه المرة الأخيرة، اعدكم J)--سترى مكتبة Morse داخل المجلد File > Sketchbook > Examples

القائمة التي تحتوي على المثال الخاص بك. قد ترغب في إضافة بعض التعليقات التي توضح كيفية استخدام المكتبة الخاصة بك أفضل.

إذا كنت ترغب في التحقق من مكتبة كاملة (مع الكلمات الرئيسية(Keyword) والمثال)، يمكنك تحميل البرنامج: كاملاً Morse.zip.

للحصول على مزيد من المعلومات انظر Arduino-style API ، للحصول على معلومات حول جعل Arduino-style API  نمط جيد للمكتبة الخاصة بك.

arduino-language Arduinoiraq examples faq getstarted know-more learning