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

تهيِّئ الدالة <code>analogReference()‎</code> قيمة الجهد المرجعي (reference voltage) المستعمل من أجل الدخل التشابهي (أي القيمة المستعملة بوصفها أعلى قيمة ضمن مجال القيم المدخلة).

==البنية العامة==
<syntaxhighlight lang="arduino">
analogReference(type)
</syntaxhighlight>
==المعاملات==
===<code>type</code>===
نوع الجهد المرجعي المراد استعماله. الخيارات المتاحة التي يمكن استعمالها مع هذا المعامل هي:
* في لوحات أردوينو التي تعتمد على متحكمات AVR (مثل لوحات Uno، و Mega، وغيرها):
** <code>DEFAULT</code>: الجهد المرجعي الافتراضي للدخل التشابهي وهو 5V (في اللوحات ذات الجهد 5V) أو 3.3V (في اللوحات ذات الجهد 3.3V).
** <code>INTERNAL</code>: جهد مرجعي داخلي (built-in reference) وهو 1.1V في المتحكمات ATmega168 و ATmega328P أو 2.56V في المتحكمات ATmega8 (هذا الخيار غير متاح في لوحات أردوينو Mega).
** <code>INTERNAL1V1</code>: جهد مرجعي داخلي يساوي 1.1V (في لوحات أردوينو Mega فقط).
** <code>INTERNAL2V56</code>: جهد مرجعي داخلي يساوي 2.56V (في لوحات أردوينو Mega فقط).
** <code>EXTERNAL</code>: الجهد المرجعي هو الجهد المطبق على الرجل AREF، ويجب ألا يزيد عن 5V.
* في لوحات أردوينو التي تعتمد على متحكمات SAMD (مثل لوحات Zero وغيرها):
** <code>AR_DEFAULT</code>: الجهد المرجعي الافتراضي للدخل التشابهي وهو 3.3V.
** <code>AR_INTERNAL</code>: جهد مرجعي داخلي يساوي 2.23V.
** <code>AR_INTERNAL1V0</code>: جهد مرجعي داخلي يساوي 1.0V.
** <code>AR_INTERNAL1V65</code>: جهد مرجعي داخلي يساوي 1.65V.
** <code>AR_INTERNAL2V23</code>: جهد مرجعي داخلي يساوي 2.23V.
** <code>AR_EXTERNAL</code>: الجهد المرجعي هو الجهد المطبق على الرجل AREF.
* في لوحات أردوينو التي تعتمد على متحكمات SAM (مثل لوحات Due):
** <code>AR_DEFAULT</code>: الجهد المرجعي الافتراضي للدخل التشابهي وهو 3.3V. هذا الخيار هو الخيار الوحيد المدعوم في لوحات أردوينو Due.

==القيم المعادة==
لا يعاد أي شيء.
==ملاحظات وتحذيرات==
بعد تغيير الجهد التشابهي المرجعي، قد تكون بضعة القراءات الأولى من الدالة <code>analogRead()‎</code> غير دقيقة.

'''لا تستعمل أي جهد أقل من 0V وأكبر من 5V مع الجهد المرجعي الخارجي المطبق على الرجل AREF. إن كنت تستعمل مرجعًا خارجيًّا على الرجل AREF، فيجب ضبط الجهد المرجعي إلى <code>EXTERNAL</code> (أو مايقابلها في لوحات أخرى) عبر الدالة <code>analogReference()‎</code> قبل استدعاء <code>analogRead()‎</code>.''' إن لم تفعل ذلك، سيحدث تماسٌ بين الجهد المرجعي الفعَّال (المولد داخليًّا) والجهد المطبَّق على الرجل AREF مما قد يؤدي إلى تضرر المتحكم في لوحتك.

بدلًا من ذلك، يمكنك وصل الجهد المرجعي الخارجي المطبق على الرجل AREF عبر مقاومة 5K، إذ يسمح لك ذلك بالتبديل بين الجهد المرجعي الداخلي والخارجي. انتبه إلى هذه المقاومة ستعدِّل الجهد الذي يراد استعماله كجهد مرجعي خارجي لأنه يوجد مقاومة 32K داخلية موصولة بالرجل AREF. تسلك هاتان المقاومتان سلوك مقسم جهدٍ، لذا إن طُبِّق مثلًا جهد بقيمة 2.5V عبر مقاومة، فستكون قيمته الفعلية المطبقة على الرجل AREF هي 2.5 * 32 / (32 + 5) =~ 2.2V.

==انظر أيضًا==
==مصادر==
*[https://www.arduino.cc/reference/en/language/functions/analog-io/analogreference/ صفحة الدالة analogReference()‎ في توثيق أردوينو الرسمي.]