Arduino/Topics

البنية الأولية للشيفرة في أردوينو

لابد لكل شيفرة من شيفرات أردوينو أن تحوي الدالتين التاليتين:

setup()‎

تستدعى الدالة setup()‎ أولًا عند البدء بتنفيذ الشيفرة (المخطط [sketch] كما تُطلِق عليه أردوينو)، إذ تُستَعمل لتهيئة المتغيرات، وأوضاع الأرجل، وواجهات التخاطب، والبدء باستعمال المكتبات ...إلخ. انتبه إلى أنَّ الدالة setup()‎ ستُنفَّذ مرةً واحدةً فقط بعد تشغيل لوحة أردوينو أو تصفيرها (reset).

loop()‎

بعد إنشاء الدالة setup()‎ التي تهيئ وتضبط القيم الأولية المراد استعمالها، تعمل الدالة loop()‎ على «تكرار» الشيفرة المكتوبة بداخلها -كما يشير اسمها بالضبط- على التوالي متيحةً بذلك لبرنامجك بالتحكم بلوحة أردوينو والتغيُّر والاستجابة للبيئة والعناصر المرتبطة بها.

بنى التحكم

break

تُستعمَل الكلمة break المفتاحية للخروج من الحلقات for، أو while، أو do...while التكرارية، إذ تتخطى الشيفرة التي بعدها وشروط الحلقة المحددِّة وتخرج منها. تُستعمَل أيضًا للخروج من التعبير switch...case البرمجي.

continue

تتخطى الكلمة continue المفتاحية الشيفرة التي تليها في حلقة التكرار (مثل الحلقات for، أو while، أو do...while التكرارية) إلى عملية التحقق من التعبير الشرطي لتلك الحلقة ثم يُستأنَف عمل حلقة التكرار بشكل طبيعي.

dowhile

تعمل الحلقة do...while التكرارية بنفس الطريقة التي تعمل بها الحلقة while باستثناء أنه يُتحقق من الشرط في نهاية الحلقة وليس في بدايتها. هذا يعني أنَّ الحلقة ستُنفَّذ مرة واحدة على الأقل.

else

يسمح التعبير if...else الشرطي بالتحكم بشكل أوسع بتسلسل عملية التحقق من عدة شروط معينة عند تنفيذ الشيفرة عوضًا عن التحقق من شرط وحيد عند استعمال التعبير if. ستُنفَّذ العبارة else (إن وجدت) إن لم يتحقق الشرط المعطى في العبارة if ( أي أعطى القيمة false). يمكن أيضًا استعمال العبارة else مع العبارة if بالشكل else if لإضافة شرط آخر للتحقق منه وبذلك يمكن إجراء عدة عمليات تحقق متتابعة في الوقت نفسه.

for

تُستعمَل الحلقة for لتكرار كتلة برمجية معينة من الشيفرة عددًا محدَّدًا من المرات. يُستعمَل في هذه الحلقة عادةً عدادٌ لتتبع عدد مرات تكرار الشيفرة ومقاطعتها عند الوصول إلى عدد محدَّد. يمكن استعمال الحلقة for مع أية عملية تكرارٍ، وتُستعمَل بكثرة مع المصفوفات لتنفيذ عملية معينة على عناصرها التي قد تكون بيانات عادية أو أرجل معينة.

goto

تنقل الكلمة goto المفتاحية البرنامج إلى موضع معين ضمن الشيفرة.

if

يتحقَّق التعبير if الشرطي من شرط معيَّن وينفِّذ الكتلة البرمجية المكتوبة ضمنه إن كان محقَّقًا (أي كانت قيمته true).

return

تقاطع الكلمة return المفتاحية تنفيذ أيَّ دالةٍ وتعيد قيمةً من الدالة إلى من استدعاها إن حدُّدت.

switchcase

يتحقَّق التعبير switch...case -كما في if- من قيمة محدَّدة بطريقة تسمح للمبرمج بتحديد عدة شيفرات تُنفَّذ إحداها بناءً على تلك القيمة المفحوصة.

while

تكرِّر الحلقة while تنفيذ الكتلة البرمجية التي ضمنها بشكل مستمر ولا نهائي ما دامت قيمة الشرط المنطقي الموجود بين القوسين هي true (اطلع على البينة العامة في توثيق الحلقة)؛ متى ما أصبحت قيمة الشرط المنطقي false، تتوقف الحلقة وتخرج.

صيغ إضافية

‎#define

التعبير ‎#define هو أحد العناصر المفيدة في C، إذ يسمح بإعطاء اسمٍ لقيمةٍ ثابتةٍ قبل أن يُفسَّر البرنامج. الثوابت المعرَّفة باستعمال هذا التعبير في أردوينو لا تحتل أيَّة مساحةٍ من ذاكرة البرنامج على الشريحة (chip). سيبدِّل المفسِّر (compiler) القيمة المعرَّفة مكان المراجع التي تشير إلى هذه الثوابت أثناء عملية تصريف الشيفرة.

‎#include

يُستعمَل التعبير ‎#include لتضمين مكتبات خارجية في شيفرتك. هذا يساعد المبرمج على الوصول إلى مجموعة أكبر من مكتبات C القياسية (التي هي مجموعة من الدوال المُنشَأ مسبقًا) والمكتبات التي كُتبَت خصِّيصًا لأردوينو.

;

تُستعمَل الفاصلة المنقوطة ; لإنهاء كل تعبير برمجي في لغة أردوينو C.

{}

القوسان المعقوصان {} (curly braces، أو braces فقط أو curly brackets) هما جزءٌ لا يتجزأ من لغة C. يستعملان في بُنى عديدة مثل بنى التحكم وغيرها وهذا يربك أحيانًا المبتدئين أثناء تعلمهم اللغة.

//

تبدأ التعليقات السطرية بخطين مائلين متجاورين // وتنتهي بنهاية السطر بشكل تلقائي. سيُتجاهل أي شيء يلي الرمزين // حتى نهاية السطر أثناء تفسير الشيفرة.

/* */

تبدأ التعليقات الكتلية (block comment) أو التعليقات متعددة الأسطر (multi-line comment) بالرمز */ وتنتهي بالرمز /*. يمكن أن يمتد هذا التعليق على عدَّة أسطر بحسب الحاجة؛ ومتى ما قرأ المفسِّر الرمز */، سيتجاهل كل ما كُتِب بعده حتى يصل إلى الرمز /*.

المعاملات في لغة أردوينو C

المعاملات الحسابية

تجري المعاملات الحسابية (Arithmetic Operators) العمليات الحسابية الأساسية الأربعة (الجمع والطرح والضرب والقسمة) بالإضافة إلى عمليات أخرى مثل حساب باقي القسمة وإسناد قيمٍ إلى متغيراتٍ.

معاملات الموازنة

تجري معاملات الموازنة (Comparison Operators) عمليةَ موازنةٍ -كما هو اسمها- بين قيمتين أو متغيِّرين أو متغير وقيمة معينة ثم تعيد قيمة منطقية تمثِّل حالة أحد المعاملين (أكبر أو أصغر أو يساوي ...إلخ) نسبةً للآخر.

المعاملات المنطقية

تجري المعاملات المنطقية (Boolean Operators) العمليات المنطقية (العملية AND أو العملية OR أو العملية NOT) على القيم أو التعابير المنطقية ثم تعيد القيمة المنطقية الناتجة.

معاملات وصول المؤشر

معاملات وصول المؤشر هي (Pointer Access Operators) هي المعاملات التي تُستعمَل مع المؤشرات لتوفير وصول المؤشر إلى عناوين المتغيرات في الذاكرة والإشارة إليها، وإمكانية وصول المتغيرات إلى القيم المحتواة في عناوين الذاكرة التي تشير إليها المؤشرات.

معاملات الأعداد الثنائية

تجري معاملات الأعداد الثنائية (Bitwise Operators) جميع العمليات المنطقية وعمليات الإزاحة على بتات الأعداد والقيم الثنائية ثم تعيد القيمة الناتجة.

معاملات مركَّبة

تستعمل المعاملات المركبة (Compound Operators) في كتابة الشيفرات في أردوينو بكثرة لتصفير وضبط وقلب بتات معينة في القيم الثنائية وغيرها من العمليات المهمة التي تسهِّل وتبسِّط عملية كتابة الشيفرة كثيرًا.

أنواع البيانات

الكائن string

تنشئ الدالة String()‎ نسخةً من الصنف String الذي يوفِّر الكثير من الأدوات للتعامل مع السلاسل النصية وإجراء عمليات عليها.

array

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

bool

يخزِّن المتغير الذي يصرَّح عنه بأنَّه من النوع bool إحدى القيمتين المنطقيَّتين التاليتين: true، أو false عبر حجز بايتٍ واحدٍ من الذاكرة فقط.

boolean

النوع boolean هو نوع غير قياسي، وهو اسمٌ بديل للنوع bool المُعرَّف في أردوينو.

byte

يُخزِّن النوع byte عددًا عديم الإشارة بحجم 8 بت.

char

يحجز النوع char بايتًا واحدًا من الذاكرة ويخزِّن فيه قيمة محرف محدَّد.

double

يحجز النوع double أربعة بايتات من الذاكرة فقط في لوحات أردوينو Uno (والتي تعتمد على متحكمات ATMega) أو ثمانية بايتات في اللوحات Due لتخزين عدد عشري فيها.

float

يحجز النوع float أربعة بايتات من الذاكرة لتخزين عدد عشري فيها.

int

يحجز النوع int حجمًا مقداره 2 بايت من الذاكرة في لوحات أردوينو Uno (وتلك التي تعتمد على متحكمات ATMega) أو 4 بايت في لوحات أردوينو Due (وتلك التي تعتمد على متحكمات SAMD) لتخزين عدد صحيح فيه.

long

تحجز النوع long حجمًا كبيرًا من الذاكرة مقداره 4 بايت يُستعمَل لتخزين الأعداد التي تتسم بأنَّها طويلة.

short

يحجز النوع short في جميع لوحات أردوينو (التي تعتمد على المتحكمات ATMega و ARM) حجمًا من الذاكرة مقداره 2 بايت لتخزين عدد قصير فيه.

string

يمثِّل النوع string سلسلةً نصيةً مؤلفةً من عدة محارف مرتبطة مع بعضها بعضًا. تُستعمَل مصفوفة من المحارف لتخزين هذا النوع من البيانات واستدعائها والتعامل معها لاحقًا.

unsigned char

يحجز النوع unsigned char حجمًا من الذاكرة مقداره 1 بايت فقط.

unsigned int

يحجز النوع unsigned int حجمًا من الذاكرة مقداره 2 بايت في لوحات أردونيو Uno واللوحات التي تعتمد على متحكمات ATMega أو 4 بايت في لوحات أردوينو Due لتخزين عدد صحيح عديم الإشارة فيها.

unsigned long

يحجز النوع unsigned long حجمًا كبيرًا من الذاكرة مقداره 4 بايت يُستعمَل لتخزين الأعداد عديمة الإشارة التي تتسم بأنَّها طويلة.

void

تُستعمَل الكلمة المفتاحية void مع الدوال التي يُعرِّفها المبرمج في الشيفرة لتُشير إلى أنَّه لا يُتوقَّع أن تعيد هذه الدالة بعد انتهاء تنفيذها أيَّة بيانات إلى من استدعاها.

word

تُخزِّن المتغيرات التي من النوع word عددًا عديم الإشارة بحجم 2 بايت.

الدوال

دوال التحكم بأرجل الدخل والخرج الرقمية

تستعمَل الدوال الموجودة في هذا القسم للتعامل مع الأرجل الرقمية والتحكم بها.

دوال التحكم بأرجل الدخل والخرج التشابهية

تستعمَل الدوال الموجودة في هذا القسم للتعامل مع أرجل الدخل والخرج التشابهي والتحكم بها وبدقة القيم المقروءة منها أو المكتوبة عليها.

دوال متقدمة للتحكم بأرجل الدخل والخرج

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

دوال التوقيت

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

الدوال الرياضية

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

دوال التعامل مع المحارف

تعمل هذه الدوال مع المحارف بشكل عام، إذ تتحقَّق من كون محرف محدَّد ينتمي إلى مجموعةٍ معيَّنة من المحارف.

دوال التحويل

تعمل دوال التحويل على التحويل بين مختلف أنواع البيانات في أردوينو.

دوال التحكم بالبتات والبايتات

تعمل الدوال الموجودة في هذا القسم في مستوى البتات (bits)، إذ تقرأ قيمة بت معيَّن وتكتب قيمة محدَّدة عليه وتستخرج البايت العلوي أو السفلي من البيانات وغيرها من العمليات المفيدة والمتقدمة.

دوال التحكم بالمقاطعات

تتحكم الدوال الموجودة في هذا القسم بالمقاطعات في أردوينو، إذ تعمل على تفعيل مقاطعةٍ معيَّنةٍ على إحدى الأرجل أو تعطيلها أو تفعيل جميع المقاطعات أو تعطيلها.

دوال التحكم بالاتصالات

تحتوي لوحة أردوينو على العديد من برتوكولات الاتصال المستعملة في التواصل مع البيئة الخارجية المحيطة باللوحة مثل التواصل مع الحاسوب وعناصر إلكترونية أخرى. الدوال الأساسية للتحكم بعمليات الاتصال الموجودة في أردوينو هي:

• واجهة الاتصال التسلسلية، و
• نقل البيانات عبر المجاري.

دوال التحكم عبر المنفذ USB

توفر لوحة أردوينو إمكانية التحكم ببعض أجزاء الحاسوب المتصل مع اللوحة عبر المنفذ USB. تتوافر مكتبتان أساسيتان يمكن باستعمالها التحكم بلوحة المفاتيح والفأرة هما:

• المكتبة Keyboard، و
• المكتبة Mouse.

الثوابت والمتغيرات

الثوابت

الأعداد الصحيحة الثابتة

الأعداد الصحيحة الثابتة هي أعداد استعملت مباشرةً في الشيفرة مثل 123. افتراضيًّا، تعامل هذه الأعداد على أنَّها أعداد صحيحة (integer) ولكن يمكن تحويلها إلى أنواع أخرى من الأعداد باستعمال أحد المبدلات (modifiers) مثل U أو L.

الأعداد العشرية الثابتة

الأعداد العشرية الثابتة هي أعداد استعملت مباشرةً في الشيفرة مثل 12.34. تُبدَّل الأعداد الثابتة ذات الفاصلة العشرية في وقت تصريف الشيفرة إلى القيمة المساوية والمقابلة لهذا التعبير المكتوب.

الثوابت

الثوابت هي تعابير معرَّفة مسبقًا في لغة أردوينو. تُستعمَل لتسهيل عمل المبرمجين أثناء كتابتهم للشيفرة، بالإضافة إلى جعل الشيفرة أكثر قابلية للقراءة. تُصنَّف الثوابت في مجموعات بحسب وظيفتها.

مجال وقيود المتغير (Variable Scope & Qualifiers)

const

الكلمة const المفتاحية هي اختصار للكلمة «ثابت» (constant)، وهي مقيِّدةٌ للمتغيرات التي تٌستعمَل معها، إذ تعدِّل سلوك المتغير لتجعله في وضع «القراءة فقط» (read-only).

scope

تملك المتغيرات في لغة C، التي اشتقَّت لغة أردونيو منها، خاصيةً تدعى «مجال» (scope) تحدِّد مجال استعمال هذه المتغيرات ومن يمكنه الوصول إليها. هذا يختلف عن الإصدارات الحديثة للغاتٍ مثل BASIC التي يكون فيها المتغير عامًّا (global) دومًا.

static

تُستعمَل الكلمة المفتاحية static عند إنشاء متغيرات مرئيَّة لدالةٍ واحدة فقط من أجل الحفاظ على محتواها بعد انتهاء تنفيذ تلك الدالة المستدعاة وحتى الاستدعاء التالي لها خلافًا للمتغيرات المحلية التي تُنشَأ وتدمَّر في كل مرة تُستدعَى فيها الدالة.

volatile

تصنَّف الكلمة volatile المفتاحية ضمن «مقيدات المتغيرات» (variable qualifier)، وتُستعمَل عادةً قبل نوع المتغير عند تعريفه لتوجيه المصرِّف إلى تحميل المتغير من الذاكرة RAM وليس من سجلات التخزين للذاكرة المؤقتة (الذاكرة flash) حيث تُخزَّن جميع متغيرات البرنامج.

أدوات إضافية

PROGMEM

تخبر الكلمة PROGMEM المفتاحية المصرَّف بأنَّ يضع بيانات المتغير التي استعملت معه في الذاكرة flash بدلًا من وضعها في الذاكرة SRAM حيث يجب أن تخزَّن بالحالة الطبيعية.

sizeof()‎

تعيد الدالة sizeof()‎ الحجم المحجوز من الذاكرة بالبايت لمتغير أو مصفوفة معيَّنة.

مصادر

• توثيق أردوينو الرسمي.