> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# GPIO وPWM وADC: ما تفعله دوال Arduino في الشريحة
- URL: https://arabroot.io/articles/الارجل-الرقمية-والتماثلية-فهم-gpio-ثم-pwm-مع-محول-adc/
- Published: 2026-11-10T20:02:19.000Z
- Updated: 2026-11-11T18:52:57.000Z
- Description: ما الذي يحدث في الشريحة عندما تكتب digitalWrite وanalogWrite وanalogRead، بقياسات حقيقية: كم تكلف كل دالة، ونسبة التشغيل الفعلية، ولماذا لا يعمل PWM على كل الأرجل.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الإلكترونيات والطائرات المسيرة والطباعة ثلاثية الأبعاد

في [المشروع الأول](https://arabroot.io/articles/%D9%85%D8%B4%D8%B1%D9%88%D8%B9%D9%83-%D8%A7%D9%84%D8%A7%D9%88%D9%84-%D9%85%D8%B9-arduino-%D9%85%D9%86-%D9%88%D9%85%D9%8A%D8%B6-led-%D8%A7%D9%84%D9%89-%D9%82%D8%B1%D8%A7%D8%A1%D8%A9-%D8%A7%D9%84%D8%AD%D8%B3%D8%A7%D8%B3/) استخدمنا أربع دوال فقط: `pinMode` و`digitalWrite` و`digitalRead` و`analogRead`، وفي مقال المصطلحات أضفنا `analogWrite`. وهذه الدوال الخمس هي ما يستخدمه أغلب من يكتب لـ Arduino لسنوات دون أن يسأل: ماذا تفعل هذه الدوال في الشريحة؟ وهذا السؤال لا يهم ما دام كل شيء يعمل، ولكنه يصبح مهماً جداً في أول مرة تحتاج فيها سرعة أكبر، أو تكتب `analogWrite` على رجل لا تتغير، أو تقرأ حساساً سريعاً فتكتشف أن القراءة تأخذ وقتاً لم تحسبه.

والأمر يشبه ما يحدث مع أي إطار عمل في البرمجيات: تستطيع أن تبني تطبيقاً كاملاً دون أن تعرف كيف يعمل الـ ORM من الداخل، ولكن في أول مشكلة أداء حقيقية سوف تحتاج أن تنزل طبقة وترى الاستعلامات التي يرسلها. وفي هذا المقال سوف ننزل هذه الطبقة في الشريحة: الأرجل الرقمية GPIO ومسجلاتها، وإشارة PWM التي يولدها المؤقت، ومحول ADC، وكل واحدة منها بقياس حقيقي على الشريحة المحاكاة، فنعرف بالأرقام كم تكلفنا كل دالة.

وسوف نناقش في هذا المقال ما يلي:

- الأرجل الرقمية من الداخل: المسجلات الثلاثة خلف كل رجل.
- لماذا `digitalWrite` أبطأ من الكتابة المباشرة في المسجل، وبكم.
- كيف يولد المؤقت إشارة PWM، ولماذا لا تعمل على كل الأرجل.
- محول ADC: كم تأخذ القراءة الواحدة، وما الرقم الذي يعطيه لكل جهد.
- مختبر يقيس كل ذلك على الشريحة المحاكاة، ثم نكسر `analogWrite` على رجل دون PWM.

## الأرجل على اللوحة

قبل الكود، انظر إلى الأرجل نفسها، فالصورة التالية مقربة لصف الأرجل الرقمية في لوحة Uno، ولاحظ الأرقام من 0 إلى 13، ولاحظ أن بعضها مكتوب بجانبه الرمز \~، وهو ما سنحتاجه بعد قليل:

![صورة مقربة للحافة العليا للوحة Arduino Uno: صفان من المقابس السوداء، وتحتها الأرقام 13 و12 و~11 و~10 و~9 و8 ثم 7 و~6 و~5 و4 و~3 و2 و1 و0 مع سهمي TX وRX، وعلى اليسار AREF وGND، وتحتها عبارة DIGITAL (PWM~)](https://arabroot.io/content/images/2026/11/gpio-pwm-adc-01-headers.webp)

الأرجل الرقمية في Uno، والرمز \~ بجانب 3 و5 و6 و9 و10 و11 يعني أنها تدعم PWM. الصورة: MakeMagazinDE، رخصة CC BY-SA 4.0، المصدر: [Wikimedia Commons](https://commons.wikimedia.org/wiki/File:Arduino%5Funo%5Fr3.jpg?ref=arabroot.io) (تم قصها وتحويلها إلى WebP).

والأرقام المطبوعة على اللوحة أرقام Arduino، وليست أرقام الشريحة، فالشريحة ATmega328P لا تعرف «الرجل 13»، وإنما تقسم أرجلها إلى منافذ Ports، كل منفذ ثمانية بتات، ولكل منفذ اسم: B وC وD. والأرجل الرقمية من 0 إلى 7 في Uno هي المنفذ D، ومن 8 إلى 13 هي المنفذ B، والأرجل A0 إلى A5 هي المنفذ C، ولذلك قلنا في المقال الأول إن الرجل 13 هي البت 5 في المنفذ B.

## ثلاثة مسجلات خلف كل رجل

ولكل منفذ ثلاثة مسجلات Registers، أي ثلاثة مواقع في ذاكرة الشريحة كل بت فيها موصول بإحدى الأرجل الثماني، والشكل التالي يبينها للمنفذ B:

![رسم: أرجل Uno من 13 إلى 8 فوق ستة أعمدة هي البتات من 5 إلى 0 في المنفذ B، وتحتها ثلاثة صفوف بالمسجلات DDRB وPORTB وPINB، والبت 5 تحت الرجل 13 برتقالي في الثلاثة، والبتان 7 و6 مكتوب تحتهما crystal، وعلى اليمين شرح كل مسجل: الاتجاه 1 مخرج و0 مدخل وهذا ما تكتبه pinMode، وما تكتبه 1 يعني 5 فولت وعلى المدخل يشغل المقاومة الرافعة، وما تقرؤه الجهد على السلك الآن وهذا ما تعيده digitalRead](https://arabroot.io/content/images/2026/11/gpio-pwm-adc-02-registers.webp)

المسجلات الثلاثة للمنفذ B، والرجل 13 هي البت 5 في كل منها

- **مسجل الاتجاه DDRB:** اختصار Data Direction Register، والبت 1 يجعل الرجل مخرجاً، و0 يجعلها مدخلاً، و`pinMode(13, OUTPUT)` تكتب 1 في البت 5 منه.
- **مسجل الخرج PORTB:** إذا كانت الرجل مخرجاً فالبت 1 يعني 5 فولت و0 يعني صفراً، و`digitalWrite` تكتب فيه. وإذا كانت الرجل مدخلاً فالبت 1 يشغل المقاومة الرافعة الداخلية، وهذا بالضبط ما رأيناه في المقال الأول عندما نسينا `pinMode` فشغلت `digitalWrite` المقاومة الرافعة بدل المؤشر.
- **مسجل الدخل PINB:** يعكس الجهد الحقيقي على السلك الآن، و`digitalRead` تقرأ منه. وللكتابة فيه معنى خاص سوف تراه أحياناً: كتابة 1 في بت منه تقلب حالة الرجل، وقد استخدمناها في مقال Raspberry Pi والمتحكم داخل المقاطعة.

ولاحظ البتين 6 و7 في المنفذ B، فهما موصولان بالكريستالة التي رأيناها في مقال المصطلحات، ولذلك لا توجد لهما أرجل على لوحة Uno. وقد شرحنا الكتابة في المسجلات بلغة C دون مكتبة Arduino في [مقال لغة C للأنظمة المدمجة](https://arabroot.io/articles/%D9%84%D8%BA%D8%A9-c-%D9%84%D9%84%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D9%85%D8%AF%D9%85%D8%AC%D8%A9-embedded-c-%D8%A7%D9%84%D8%B0%D8%A7%D9%83%D8%B1%D8%A9-%D9%88%D8%A7%D9%84%D9%85%D8%B3%D8%AC%D9%84%D8%A7%D8%AA/)، وهنا يهمنا سؤال واحد: إذا كانت `digitalWrite` تكتب في المسجل في النهاية، فهل هناك فرق في السرعة بينها وبين الكتابة المباشرة؟

## كم تكلفك digitalWrite؟

الكتابة المباشرة في المسجل تعليمة واحدة للشريحة، فالسطر `PORTB |= _BV(PORTB5)` يترجمه المترجم إلى تعليمة `sbi` تأخذ دورتي ساعة، أي 0.125 ميكروثانية على 16 MHz. أما `digitalWrite` فتقوم بعمل أكثر بكثير، وهذا الكود من [مكتبة Arduino لشرائح AVR](https://github.com/arduino/ArduinoCore-avr/blob/master/cores/arduino/wiring%5Fdigital.c?ref=arabroot.io):

```cpp
void digitalWrite(uint8_t pin, uint8_t val)
{
	uint8_t timer = digitalPinToTimer(pin);
	uint8_t bit = digitalPinToBitMask(pin);
	uint8_t port = digitalPinToPort(pin);
	volatile uint8_t *out;

	if (port == NOT_A_PIN) return;

	// If the pin that support PWM output, we need to turn it off
	// before doing a digital write.
	if (timer != NOT_ON_TIMER) turnOffPWM(timer);

	out = portOutputRegister(port);

	uint8_t oldSREG = SREG;
	cli();

	if (val == LOW) {
		*out &= ~bit;
	} else {
		*out |= bit;
	}

	SREG = oldSREG;
}
```

في الكود أعلاه لاحظ التالي:

- الدالة لا تعرف رقم الرجل مسبقاً، فتبحث في ثلاثة جداول مخزنة في الفلاش: أي مؤقت على هذه الرجل، وأي بت، وأي منفذ، وكل بحث يقرأ من الفلاش بتعليمات خاصة.
- إذا كانت الرجل تدعم PWM فإنها توقفه أولاً، والسبب أن المؤقت إذا كان يتحكم في الرجل فلن يكون للكتابة في المسجل أثر.
- تحفظ حالة المقاطعات وتوقفها بالأمر `cli` أثناء الكتابة ثم تعيدها، لكي لا تقطعها مقاطعة تكتب في المنفذ نفسه.

وهذا كله عمل صحيح ومفيد، فهو يجعل الدالة آمنة لأي رجل في أي لوحة، ولكن له ثمن سوف نقيسه في المختبر.

## PWM من الداخل: المؤقت يعمل وحده

شرحنا في مقال المصطلحات أن PWM يعني أن الرجل تعمل وتنطفئ بسرعة، وأن نسبة التشغيل تحدد متوسط الطاقة، والسؤال الآن: من الذي يشغلها ويطفئها مئات المرات في الثانية بينما برنامجك يعمل؟ والإجابة المؤقت Timer، وهو عداد داخل الشريحة يعد نبضات الساعة وحده، وفي الوضع الذي يضبطه Arduino للرجلين 5 و6 يعد المؤقت 0 من 0 إلى 255 ثم يعود، وفي كل دورة يقارن العدد بقيمة في مسجل اسمه OCR0A، فتكون الرجل HIGH ما دام العدد أقل من هذه القيمة أو يساويها، وLOW بعدها. و`analogWrite(6, 64)` تكتب 64 في هذا المسجل فقط، ثم تعود فوراً، والمؤقت يكمل العمل في العتاد دون أي تدخل من برنامجك.

ولهذا السبب لا تعمل `analogWrite` إلا على الأرجل المكتوب بجانبها \~، لأنها الأرجل الموصولة بمخارج المؤقتات الثلاثة في الشريحة، كل مؤقت باثنتين: المؤقت 0 للرجلين 5 و6، والمؤقت 1 للرجلين 9 و10، والمؤقت 2 للرجلين 3 و11\. وحسب [صفحة analogWrite في توثيق Arduino](https://docs.arduino.cc/language-reference/en/functions/analog-io/analogWrite/?ref=arabroot.io) فتردد الرجلين 5 و6 قرابة 980 هرتز والباقي قرابة 490، والسبب أن Arduino يضبط المؤقتات بأوضاع مختلفة، وقد قسنا 976.6 هرتز للرجل 6 في مقال المصطلحات.

⚠️

المؤقت 0 هو نفسه الذي تعتمد عليه `millis` و`delay` في Arduino، ولذلك لا تغير إعداداته بنفسك لتغير تردد PWM على الرجلين 5 و6، والسبب أن كل حساب للوقت في برنامجك سوف يختل معه. وإذا احتجت تردداً آخر فاستخدم رجلاً على المؤقت 1 أو 2.

## محول ADC: القراءة ليست مجانية

ومحول ADC في ATmega328P يعمل بطريقة اسمها التقريب المتتالي Successive Approximation: يقارن جهد الرجل بجهود يولدها داخلياً، بتاً بعد بت، من الأكبر إلى الأصغر، كمن يبحث عن رقم بالبحث الثنائي Binary Search، فيحتاج عشر خطوات لعشرة بتات. وكل خطوة تحتاج نبضة من ساعة خاصة بالمحول، وورقة البيانات تقول إن المحول يحتاج ساعة بين 50 و200 كيلوهرتز ليعطي دقته الكاملة، وإن القراءة العادية تأخذ 13 نبضة من هذه الساعة، وإن أول قراءة بعد تشغيل المحول تأخذ 25 نبضة لتهيئة الدارة التناظرية. ومكتبة Arduino تقسم ساعة الشريحة على 128 لتعطي المحول 125 كيلوهرتز، كما في [ملف wiring.c](https://github.com/arduino/ArduinoCore-avr/blob/master/cores/arduino/wiring.c?ref=arabroot.io)، والشكل التالي يحسب ما يعنيه ذلك:

![ثلاث بطاقات: ساعة المحول 125 kHz من 16 MHz ÷ 128، وزمن القراءة الواحدة 13 × 8 µs = 104 µs ومن المختبر 108 µs، وأول قراءة بعد التشغيل 25 × 8 µs = 200 µs ومن المختبر 204 µs، وتحتها خط مستقيم من 0 فولت إلى 5 فولت عليه نقاط: 1 فولت 204، و2.5 فولت 511، و3.3 فولت 675، و5 فولت 1023](https://arabroot.io/content/images/2026/11/gpio-pwm-adc-06-adc.webp)

كل قراءة تأخذ قرابة 104 ميكروثانية، والأولى قرابة 200

أي أن `analogRead` تحتاج قرابة 0.1 ملي ثانية، وخلالها ينتظر برنامجك، فهي تبدأ التحويل ثم تنتظر حتى ينتهي. وهذا لا يهم إذا قرأت حساس حرارة أربع مرات في الثانية كما في المشروع الأول، ولكنه يعني أنك لا تستطيع أن تقرأ أكثر من قرابة 9000 قراءة في الثانية بهذه الطريقة، فإذا أردت أن تسجل صوتاً مثلاً فهذا لا يكفي.

والجهد الذي يقارن به المحول اسمه المرجع Reference، وهو 5 فولت افتراضياً في Uno، ويمكن تغييره بالدالة [analogReference](https://docs.arduino.cc/language-reference/en/functions/analog-io/analogReference/?ref=arabroot.io) إلى مرجع داخلي قدره 1.1 فولت، فتصبح كل خطوة قرابة 1.07 ملي فولت بدل 4.88، وهذا مفيد لحساس مثل LM35 لا يتجاوز مخرجه فولتاً واحداً في الغرفة، وقد اقترحناه تدريباً في مقال ورقة البيانات.

## المختبر: أربعة قياسات على الشريحة

سوف نقيس كل ما سبق على الشريحة المحاكاة في simavr، ببرنامج بلغة C فوق مكتبة simavr اسمه `probe`، يعمل كجهاز قياس على الطاولة، وله ثلاثة أوضاع: `speed` يعد كم مرة تصبح الرجل 13 HIGH في الثانية، و`pwm` يقيس نسبة الوقت الذي تكون فيه الرجلان 6 و7 HIGH بعد كل `analogWrite`، و`adc` يعطي الرجل A0 جهوداً معروفة ويطبع ما قرأه البرنامج. ويقرأ `probe` المسجلات بعد كل تعليمة تنفذها الشريحة، فهو أدق من أي جهاز قياس حقيقي يمكن أن تشتريه للمبتدئين.

والبرامج أربعة صغيرة، وهذا الأول `speed_dw.ino` يقلب الرجل 13 بأسرع ما يمكن بالدالة `digitalWrite`:

```cpp
// How fast can the chip flip a pin? 1) with the Arduino functions.
void setup() { pinMode(13, OUTPUT); }
void loop() {
  while (true) {                       // no loop() overhead: flip as fast as possible
    digitalWrite(13, HIGH);
    digitalWrite(13, LOW);
  }
}
```

والثاني `speed_reg.ino` يفعل الشيء نفسه بالمسجل مباشرة:

```cpp
// How fast can the chip flip a pin? 2) writing the port register directly (pin 13 = bit 5 of PORTB).
void setup() { DDRB |= _BV(DDB5); }    // the same as pinMode(13, OUTPUT)
void loop() {
  while (true) {
    PORTB |= _BV(PORTB5);              // pin 13 HIGH: one instruction (sbi)
    PORTB &= ~_BV(PORTB5);             // pin 13 LOW: one instruction (cbi)
  }
}
```

والثالث `pwm.ino` يكتب ست قيم بالدالة `analogWrite` على الرجل 6 التي تدعم PWM، وعلى الرجل 7 التي لا تدعمه، ستين ملي ثانية لكل قيمة، والرابع `adc.ino` يقرأ A0 كل خمسين ملي ثانية ويقيس مدة كل قراءة بالدالة `micros`:

```cpp
void loop() {
  unsigned long t0 = micros();
  int raw = analogRead(A0);
  unsigned long dt = micros() - t0;
  Serial.print("raw="); Serial.print(raw);
  Serial.print(" mV="); Serial.print(raw * 5000L / 1024);
  Serial.print(" took="); Serial.print(dt); Serial.println(" us");
  delay(50);
}
```

والمختبر في Docker بملف `Dockerfile` فيه simavr وarduino-cli كالمقالات السابقة، ونشغله من مجلد `lab` بالأمرين التاليين:

```bash
docker build -t gpio-lab:1 .
docker run --rm -v "$PWD:/lab" gpio-lab:1 sh ./run.sh
```

### القياس الأول: سرعة الرجل

والمخرج للبرنامجين الأولين سوف يكون كما يلي:

```text
### digitalWrite()
pin 13: 1500 rising edges in 10 ms, one period = 106.6 clock cycles = 6.660 us, 150 kHz
### PORTB register
pin 13: 26502 rising edges in 10 ms, one period = 6.0 clock cycles = 0.377 us, 2653 kHz
```

في المخرج أعلاه لاحظ التالي:

- مع `digitalWrite` تحتاج دورة كاملة، HIGH ثم LOW، قرابة 107 دورات ساعة، أي 6.66 ميكروثانية، فتتغير الرجل 150 ألف مرة في الثانية.
- مع المسجل تحتاج الدورة 6 دورات ساعة فقط: دورتان لتعليمة `sbi`، ودورتان لتعليمة `cbi`، ودورتان للقفز إلى بداية الحلقة، فتتغير الرجل 2.65 مليون مرة في الثانية، أي أسرع قرابة 18 مرة.
- وقد يتساءل البعض: هل يعني هذا أن تترك `digitalWrite`؟ والإجابة لا في أغلب الحالات، فستة ميكروثانية لا تهم لمؤشر أو مرحل أو زر، وثمن الكتابة المباشرة أن الكود لا يعمل إلا على هذه الشريحة، ولا يوقف PWM، ولا يحمي من المقاطعات. وإنما تنزل إلى المسجل عندما تقيس فتجد أن `digitalWrite` هي عنق الزجاجة، كما تفعل مع أي تحسين أداء في البرمجيات: قس أولاً، ثم حسن.

### القياس الثاني: نسبة التشغيل الحقيقية

والمخرج للبرنامج الثالث سوف يكون كما يلي:

```text
analogWrite(  0): pin 6 HIGH   0.0% of the time, pin 7 HIGH   0.0%   (0/255 =   0.0%)
analogWrite( 32): pin 6 HIGH  12.8% of the time, pin 7 HIGH   0.0%   (32/255 =  12.5%)
analogWrite( 64): pin 6 HIGH  25.4% of the time, pin 7 HIGH   0.0%   (64/255 =  25.1%)
analogWrite(128): pin 6 HIGH  50.5% of the time, pin 7 HIGH 100.0%   (128/255 =  50.2%)
analogWrite(191): pin 6 HIGH  75.1% of the time, pin 7 HIGH 100.0%   (191/255 =  74.9%)
analogWrite(255): pin 6 HIGH 100.0% of the time, pin 7 HIGH 100.0%   (255/255 = 100.0%)
```

والشكل التالي يرسم ثلاثاً من هذه القيم بالمقياس الحقيقي:

![أربعة رسوم موجات على محور زمني من 0 إلى 3072 ميكروثانية: analogWrite(6, 32) نبضات ضيقة 12.8%، وanalogWrite(6, 128) نبضات نصف الدورة 50.5%، وanalogWrite(6, 191) نبضات ثلاثة أرباع الدورة 75.1%، وفي مربع أحمر analogWrite(7, 100) خط منخفض ثابت 0% وanalogWrite(7, 200) خط مرتفع ثابت 100%، ومكتوب الرجل 7 لا مؤقت لها LOW أو HIGH فقط](https://arabroot.io/content/images/2026/11/gpio-pwm-adc-04-pwm.webp)

نسبة التشغيل على الرجل 6 بثلاث قيم، والرجل 7 التي لا تعرف إلا LOW وHIGH

في المخرج والشكل أعلاه لاحظ التالي:

- نسبة التشغيل على الرجل 6 أكبر قليلاً من القيمة قسمة 255، فالقيمة 32 أعطت 12.8% وليس 12.5%، والسبب طريقة المقارنة في المؤقت: الرجل تبقى HIGH ما دام العدد أقل من القيمة أو يساويها، أي 33 خطوة من 256، و33 قسمة 256 تساوي 12.9%. وهذا الفرق لا يهم لسطوع مؤشر، ولكنه يهم إذا كنت تحسب جهداً متوسطاً بدقة.
- القيمتان 0 و255 خاصتان: مكتبة Arduino لا تستخدم المؤقت لهما، وإنما تكتب LOW أو HIGH مباشرة، ولذلك كانت النسبة 0% و100% بالضبط.

### القياس الثالث: المحول

والمخرج للبرنامج الرابع سوف يكون كما يلي، والجهد في أول كل سطر هو ما أعطاه `probe` للرجل A0:

```text
[    2.48 ms] A0 =    0 mV  ->  raw=0 mV=0 took=204 us
[   53.45 ms] A0 = 1000 mV  ->  raw=204 mV=996 took=108 us
[  104.34 ms] A0 = 2500 mV  ->  raw=511 mV=2495 took=108 us
[  155.18 ms] A0 = 3300 mV  ->  raw=675 mV=3295 took=108 us
[  206.11 ms] A0 = 4995 mV  ->  raw=1021 mV=4985 took=108 us
[  257.01 ms] A0 = 5000 mV  ->  raw=1023 mV=4995 took=108 us
[  307.89 ms] A0 = 5000 mV  ->  raw=1023 mV=4995 took=112 us
```

في المخرج أعلاه لاحظ التالي:

- أول قراءة أخذت 204 ميكروثانية، والباقي 108، وهذا مطابق لما حسبناه من ورقة البيانات: 25 نبضة ثم 13 نبضة من ساعة 125 كيلوهرتز، والفرق الصغير وقت الدالة نفسها و`micros`، التي تعد بخطوات قدرها 4 ميكروثانية في Uno.
- كل رقم يقابل خطوة قدرها 4.88 ملي فولت، فالجهد 1000 ملي فولت أعطى 204، وعندما حوله البرنامج إلى ملي فولت أعطى 996، والفرق 4 ملي فولت أقل من خطوة واحدة.
- الجهد 4995 أعطى 1021، و5000 أعطى 1023، فأعلى رقم 1023 يعني «من 4995 ملي فولت تقريباً إلى 5 فولت»، ولا يوجد رقم 1024، لأن عشرة بتات تعطي من 0 إلى 1023.

## اكسرها لتفهمها: analogWrite على رجل دون PWM

والآن انظر إلى عمود الرجل 7 في القياس الثاني: البرنامج كتب على الرجلين القيم نفسها بالسطر نفسه، والرجل 7 لم تعط أي نسبة بين الصفر والمئة، وإنما 0% للقيم 0 و32 و64، ثم 100% من القيمة 128\. والسبب في [ملف wiring\_analog.c](https://github.com/arduino/ArduinoCore-avr/blob/master/cores/arduino/wiring%5Fanalog.c?ref=arabroot.io) في مكتبة Arduino، فعندما لا يجد المؤقت للرجل يكتب هذا:

```cpp
if (val < 128) {
	digitalWrite(pin, LOW);
} else {
	digitalWrite(pin, HIGH);
}
```

أي أن المكتبة لا تعطيك خطأ ولا تحذيراً، وإنما تحول القيمة إلى أقرب حالة رقمية، فإذا وصلت مؤشراً بالرجل 7 وكتبت له سطوعاً يتغير من 0 إلى 255، فسوف تراه مطفأ نصف الوقت ثم يضيء دفعة واحدة بكامل سطوعه، وتظن أن المؤشر أو الكود فيه خلل. وهذا الخطأ شائع جداً، لأن الكود صحيح، والمترجم راض، والمحاكي البسيط لا يشكو، ولذلك القاعدة: قبل أن تستخدم `analogWrite` انظر إلى الرمز \~ بجانب الرجل على اللوحة، أو إلى مخطط الأرجل Pinout للوحتك، لأن اللوحات تختلف، والأرجل التي تدعم PWM في Uno غيرها في Mega وفي ESP32.

## أخطاء شائعة مع الأرجل وPWM وADC

- **analogWrite على رجل دون \~:** تعطيك LOW أو HIGH فقط كما رأينا.
- **تغيير إعدادات المؤقت 0:** يختل معه `millis` و`delay`.
- **قراءة analogRead في حلقة سريعة جداً:** كل قراءة 104 ميكروثانية، فعشر قراءات متتالية ملي ثانية كاملة من وقت حلقتك.
- **الاعتماد على 1024 كأعلى قيمة:** أعلى رقم 1023، فإذا قسمت على 1024 أو 1023 فاختر واحداً بوعي، فالفرق صغير ولكنه يظهر عند أعلى قيمة.
- **الكتابة في المسجل وPWM يعمل:** إذا كان المؤقت يتحكم في الرجل فالكتابة في PORT لا تغيرها، و`digitalWrite` توقف PWM قبل الكتابة، أما الكتابة المباشرة فلا.
- **رجل المدخل التناظري معلقة:** قراءة A0 دون أي شيء موصول بها تعطيك أرقاماً عشوائية، كالرجل الرقمية المعلقة في مقال المصطلحات.

## تدريب عملي

1. غير في `speed_reg.ino` الكتابة إلى `PINB = _BV(PINB5);` مرة واحدة في الحلقة، وتوقع قبل التشغيل عدد دورات الساعة لكل دورة كاملة، ثم قسها بالأمر `probe build/speed_reg/speed_reg.ino.elf 10 speed`.
2. غير القيم في `pwm.ino` إلى 1 و2 و254، وتوقع قبل التشغيل نسبة التشغيل لكل واحدة على الرجل 6 بقاعدة «القيمة زائد واحد قسمة 256»، ثم قارن توقعك بالمخرج، وفكر لماذا لا يمكن أن تحصل على نسبة 0.4% بالضبط.
3. أضف في `adc.ino` السطر `analogReference(INTERNAL);` في `setup`، وأعط A0 جهد 500 ملي فولت، وقارن الرقم وحجم الخطوة بما رأيته على مرجع 5 فولت.

## حذف المختبر Cleanup

```bash
docker image rm gpio-lab:1
```

الأمر يحذف الـ Image، وتبقى البرامج وملفات المخرجات في مجلد `lab`، والملفات المترجمة في `build`.

## الخلاصة Summary

- خلف كل رجل ثلاثة بتات في ثلاثة مسجلات: DDR للاتجاه، وPORT لما تكتبه أو للمقاومة الرافعة، وPIN لما تقرؤه، والرجل 13 هي البت 5 في المنفذ B.
- `digitalWrite` آمنة لأي رجل ولكنها تأخذ قرابة 53 دورة ساعة، والكتابة المباشرة في المسجل تعليمة بدورتين، أي أسرع قرابة 18 مرة، فاستخدمها عندما يثبت القياس أنك تحتاجها.
- إشارة PWM يولدها المؤقت في العتاد، و`analogWrite` تكتب قيمة في مسجل المقارنة فقط، ونسبة التشغيل الحقيقية على الرجل 6 هي القيمة زائد واحد قسمة 256.
- PWM متاح على الأرجل \~ فقط، وعلى غيرها تعطي `analogWrite` LOW تحت 128 وHIGH من 128 دون أي تحذير.
- قراءة `analogRead` تأخذ 13 نبضة من ساعة 125 كيلوهرتز، قرابة 104 ميكروثانية، والأولى 200، وكل رقم خطوة قدرها 4.88 ملي فولت.

وفي المقال القادم من هذه المرحلة بإذن الله سوف نخرج من الرجل الواحدة إلى [التواصل بين القطع](https://arabroot.io/articles/%D8%A8%D8%B1%D9%88%D8%AA%D9%88%D9%83%D9%88%D9%84%D8%A7%D8%AA-%D8%A7%D9%84%D8%A7%D8%AA%D8%B5%D8%A7%D9%84-%D8%A7%D9%84%D8%AA%D8%B3%D9%84%D8%B3%D9%84%D9%8A-%D9%85%D9%82%D8%A7%D8%B1%D9%86%D8%A9-i2c-%D8%AB%D9%85-spi-%D9%85%D8%B9-uart/): كيف ترسل الشريحة البايتات إلى حساس أو شاشة عبر UART وI2C وSPI، وكيف ترى هذه البايتات على السلك.

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، والتجربة على arduino-cli 1.5.1 مع حزمة arduino:avr 1.8.8 للوحة Arduino Uno، والمحاكي simavr 1.6 من Debian 13 في Docker Engine 29.8.0، والأرقام من ورقة بيانات ATmega328P ومن مصدر مكتبة Arduino لشرائح AVR.