عرض مصدر Arduino/analog io/analogread

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

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

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

==البنية العامة==
<syntaxhighlight lang="arduino">
analogRead(pin)
</syntaxhighlight>
==المعاملات==
===<code>pin</code>===
عددٌ  (من 0 إلى 5 في أغلب اللوحات، ومن 0 إلى 6 في اللوحات MKR، ومن 0 إلى 7 في اللوحات Mini و Nano، ومن 0 إلى 15 في اللوحات Mega) يشير إلى رجل الدخل التشابهية المراد قراءة قيمتها.
==القيم المعادة==
عددٌ صحيحٌ يقع بين 0 و 1023 يمثل قيمة الجهد المقابلة المقروءة من الرجل <code>pin</code> التشابهية.
==أمثلة==
مثالٌ عن قراءة جهد مقاومة متغيرة موصولة بالرجل 3 التشابهية وإظهاره على واجهة التخاطب التسلسلية:<syntaxhighlight lang="arduino">
int analogPin = 3;     // وصلت الرجل الوسطى لمقاومة متغيرة مع الرجل 3 التشابهية ووصلت
                       //  إحدى الرجلين الخارجيتين مع الأرضي والأخرى مع الجهد 5 فولط
int val = 0;           // متغير لتخزين القيمة المقروءة

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

void loop()
{
  val = analogRead(analogPin);     // قراءة قيمة جهد المقاومة المتغيرة
  Serial.println(val);             // إطهار القيمة المقروءة
}
</syntaxhighlight>
==ملاحظات وتحذيرات==
*إن لم توصل الرجل مع أي شيء، فستعيد الدالة <code>analogRead()‎</code> قيمة متقلبة تعتمد على عددٍ من العوامل مثل قيم أرجل الدخل التشابهية الأخرى، ومدى قرب يدك من اللوحة وغيرها.
==انظر أيضًا==
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/analog-io/analogread/ صفحة الدالة analogRead()‎ في توثيق أردوينو الرسمي.]