الفرق بين المراجعتين لصفحة: «Arduino/analog io/analogwrite»

المراجعة الحالية بتاريخ 07:18، 17 أكتوبر 2018

تكتب الدالة analogWrite()‎ قيمةً تشابهيةً (إشارة عبر معدل عرض النبضة [PWM]) على رجل محدَّدة. يمكن استعمالها لإضاء ضوء ليد بمستويات سطوع مختلفة أو قيادة محرك بسرعات مختلفة.

بعد استدعاء الدالة analogWrite()‎ ستولد الرجل موجة مربعة ثابتة ذات دورة عمل (duty cycle) محدَّدة حتى الاستدعاء التالي للدالة analogWrite()‎ (أو استدعاء الدالة digitalRead()‎ أو digitalWrite()‎) على نفس الرجل. تردد إشارة معدل عرض النبضة (PWM) هي 490 هرتز تقريبًا. في لوحات أردوينو Uno وما يشابهها، تردد الرجل 5 والرجل 6 يقارب 980 هرتز.

في أغلب لوحات أردوينو (تلك ذات المتحكمات ATmega168 أو ATmega328P)، تعمل هذه الدالة على الأرجل 3 و 5 و 6 و 9 و 10 و 11. في لوحات أردوينو Mega، تعمل هذه الدالة على الأرجل من 2 إلى 13 و من 44 إلى 46. أمَّا في لوحات أردوينو الأقدم ذات المتحكمات ATmega8، تعمل الدالة analogWrite()‎ على الأرجل 9 و 10 و 11 فقط.

تدعم لوحات أردوينو DUE استعمال الدالة analogWrite()‎ مع الأرجل من 2 إلى 13 بالإضافة إلى الرجل DAC0 و DAC1. تستعمل الرجل DAC0 والرجل DAC1 في تحويل الإشارة الرقمية إلى تشابهية (عبر محول رقمي تشابهي [Digital-to-Analog Converter]) وتسلك سلوك خرج تشابهي حقيقي. لا تحتاج إلى استدعاء الدالة pinMode()‎ لضبط الرجل إلى رجل خرج قبل استدعاء الدالة analogWrite()‎.

ليس للدالة analogWrite()‎ أية صلة بالأرجل التشابهية أو الدالة analogRead()‎.

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

analogWrite(pin, value)

المعاملات

`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);    // ضبط حالة الضوء إلى قيمة الزر
}

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

يكون للإشارات PWM المولَّدة على الرجل 5 والرجل 6 دورات عمل (duty cycles) أعلى من المتوقع بسبب التفاعلات مع الدالتين millis()‎ و delay()‎ اللتين تتشاركان المؤقت الداخلي نفسه المستعمل في توليد الإشارات PWM تلك. سيلاحظ هذا الأمر أغلب الأحيان عند ضبط دورة العمل إلى قيم منخفضة (مثل ضبطها إلى قيمة بين 0 و 10) والذي قد ينتج عنها القيمة 0 التي لا تُطفِئ (turning off) الإشارة المخرجة على الرجل 5 والرجل 6 بشكل كامل.

انظر أيضًا

الدالة analogRead()‎: تقرأ قيمة رجل تشابهية محدَّدة وتعيدها.
الدالة analogReference()‎: تهيِّئ قيمة الجهد المرجعي (reference voltage) المستعمل من أجل الدخل التشابهي (أي القيمة المستعملة بوصفها أعلى قيمة ضمن مجال القيم المدخلة).
الدالة analogWriteResolution()‎: هي دالةٌ ملحقةٌ بالواجهة البرمجية التشابهية (Analog API) مخصَّصةٌ للوحات أردوينو Due، إذ تُستعمَل لضبط دقة الدالة analogWrite()‎.
درس تعليمي يشرح أرجل الدخل التشابهية.
مثال عملي حول إضاءة ضوء ليد بشكل متقطع.

مصادر

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

@@ سطر 39: / سطر 39: @@
 ==ملاحظات وتحذيرات==
 يكون للإشارات PWM المولَّدة على الرجل 5 والرجل 6 دورات عمل (duty cycles) أعلى من المتوقع بسبب التفاعلات مع الدالتين <code>[[Arduino/time/millis|millis()‎]]</code> و <code>[[Arduino/time/delay|delay()‎]]</code> اللتين تتشاركان المؤقت الداخلي نفسه المستعمل في توليد الإشارات PWM تلك. سيلاحظ هذا الأمر أغلب الأحيان عند ضبط دورة العمل إلى قيم منخفضة (مثل ضبطها إلى قيمة بين 0 و 10) والذي قد ينتج عنها القيمة 0 التي لا تُطفِئ (turning off) الإشارة المخرجة على الرجل 5 والرجل 6 بشكل كامل.
-*
 ==انظر أيضًا==
 * الدالة <code>[[Arduino/analog io/analogread|analogRead()‎]]</code>: تقرأ قيمة رجل تشابهية محدَّدة وتعيدها.
@@ سطر 47: / سطر 47: @@
 * مثال عملي حول إضاءة ضوء ليد بشكل متقطع.
-*
 ==مصادر==
 *[https://www.arduino.cc/reference/en/language/functions/analog-io/analogwrite/ صفحة الدالة analogwrite()‎ في توثيق أردوينو الرسمي.]
 [[تصنيف: Arduino]]
 [[تصنيف: Arduino Function]]
+[[تصنيف: Arduino I/O]]
 [[تصنيف: Arduino Analog I/O]]