الدالة digitalRead()‎ في أردوينو

تقرأ الدالة digitalRead()‎ قيمة أحد الأرجل الرقمية التي تكون إمَّا HIGH أو LOW.

البنية العامة

digitalRead(pin)

المعاملات

pin

عددٌ يشير إلى الرجل الرقمية المراد قراءة قيمتها.

القيم المعادة

تعاد القيمة HIGH أو LOW التي تمثِّل قيمة الرجل pin الرقمية.

أمثلة

ضبط قيمة الرجل 13 إلى نفس قيمة الرجل 7 المعرَّفة على أنَّها رجل دخل:

int ledPin = 13;   // هنالك ضوء ليد متصل بالرجل 13 الرقمية
int inPin = 7;     // زر ضغط متصل بالرجل 7 الرقمية
int val = 0;       // مغير لتخزين القيمة المقروءة

void setup()
{
  pinMode(ledPin, OUTPUT);      // ضبط الرجل 13 الرقمية على أنها رجل خرج 
  pinMode(inPin, INPUT);        // ضبط الرجل 7 الرقمية على أنها رجل دخل
}

void loop()
{
  val = digitalRead(inPin);     // قراءة رجل الدخل
  digitalWrite(ledPin, val);    // ضبط حالة الضوء إلى قيمة الزر
}

ملاحظات وتحذيرات

• إن لم توصل الرجل مع أي شيء، فيمكن أن تعيد الدالة digitalRead()‎ إمَّا القيمة HIGH أو LOW (وهذا قد يتغير بشكل عشوائي).

• يمكن استعمال أرجل الدخل التشابهية على أنَّها أرجل رقمية أيضًا، ويشار إليها آنذاك بالشكل A0، أو A1 ...إلخ.

انظر أيضًا

• الدالة digitalWrite()‎: تكتب إمَّا القيمة HIGH أو القيمة LOW على رجل رقمية معيَّنة.
• الدالة pinMode()‎: تهيِّئ رجل معيَّنة لتسلك إمَّا سلوك دخل (input) أو سلوك خرج (output).
• درس تعليمي يشرح الأرجل الرقمية في لوحة أردوينو.

مصادر

• صفحة الدالة digitalRead()‎ في توثيق أردوينو الرسمي.