Arduino/analog io/analogread

تقرأ الدالة analogRead()‎ قيمة رجل تشابهية محدَّدة وتعيدها.

تحوي لوحة أردوينو ست قنوات (سبع قنوات في اللوحات MKR، وثمان قنوات في اللوحات Mini و Nano، وست عشرة قناة في اللوحات Mega) تحويل من تشابهي إلى رقمي بدقة 10 بت. هذا يعني أنه ستُحوَّل قيمة الجهد التي تقع بين 0 و 5 فولط إلى قيمة عددية صحيحة مقابلة لها تقع بين 0 و 1023. وبالتالي، تكون دقة عمليات قراءة القيم هي التشابهية هي: 5 فولط / 1024 وحدة، أو 0.0049 فولط بكل وحدة (يعاد 4.9mV). يمكن أن يتغيَّر المجال والدقة باستعمال الدالة analogReference()‎.

تأخذ عملية قراءة الدخل التشابهي وقتًا محدَّدًا يقارب 100 مايكرو ثانية (0.0001 ثانية) لتنتهي، لذا يجب ألا تتجاوز مرات قراءة الدخل التشابهي الحد الأقصى الذي هو 10000 قراءة في الثانية.

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

analogRead(pin)

المعاملات

pin

عددٌ (من 0 إلى 5 في أغلب اللوحات، ومن 0 إلى 6 في اللوحات MKR، ومن 0 إلى 7 في اللوحات Mini و Nano، ومن 0 إلى 15 في اللوحات Mega) يشير إلى رجل الدخل التشابهية المراد قراءة قيمتها.

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

عددٌ صحيحٌ يقع بين 0 و 1023 يمثل قيمة الجهد المقابلة المقروءة من الرجل pin التشابهية.

أمثلة

مثالٌ عن قراءة جهد مقاومة متغيرة موصولة بالرجل 3 التشابهية وإظهاره على واجهة التخاطب التسلسلية:

int analogPin = 3;     // وصلت الرجل الوسطى لمقاومة متغيرة مع الرجل 3 التشابهية ووصلت
                       //  إحدى الرجلين الخارجيتين مع الأرضي والأخرى مع الجهد 5 فولط
int val = 0;           // متغير لتخزين القيمة المقروءة

void setup()
{
  Serial.begin(9600);              //  ضبط واجهة التخاطب التسلسلية
}

void loop()
{
  val = analogRead(analogPin);     // قراءة قيمة جهد المقاومة المتغيرة
  Serial.println(val);             // إطهار القيمة المقروءة
}

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

• إن لم توصل الرجل مع أي شيء، فستعيد الدالة analogRead()‎ قيمة متقلبة تعتمد على عددٍ من العوامل مثل قيم أرجل الدخل التشابهية الأخرى، ومدى قرب يدك من اللوحة وغيرها.

مصادر

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