> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/arabic/alblwkat-alwzyfyh/blocks-reference/input-output/data-inputs/pwm-pulse-width-modulation.md).

# PWM (Pulse Width Modulation)

تقوم هذه دالة البلوك بتوليد إشارة منطقية دورية (True/False) مُعدَّلة بعرض النبضة يمكن استخدامها لمحاكاة أو تشغيل مشغلات زمنية. استخدمها لإنشاء إشارات تشغيل/إيقاف متكررة إما بالزمن (ثوانٍ) أو بعدد العينات (خطوات متقطعة).

## 📥 المدخلات

هذا البلوك لا يحتوي على أي مدخلات.

## 📤 المخرجات

* `Boolean` الإشارة الدورية True/False الناتجة وفقًا للوضع والزوایا الزمنية المُعدَّة.

## 🕹️ الضوابط

* `Interval` أدخل الفترة الكاملة لدورة واحدة. في وضع الوقت تكون بالثواني، وفي وضع العينات تكون بعدد العينات/الخطوات.
* `Up Duration` أدخل المدة التي تبقى فيها الإشارة True ضمن كل دورة. الوحدات تتطابق مع الوضع المحدد (ثوانٍ أو عينات).
* `Time mode` التبديل بين Seconds (وضع قائم على الزمن) و Samples (وضع قائم على عدد العينات).

## 🎨 الميزات

* وضع PWM قائم على الزمن لإشارات دورية متزامنة مع الوقت الحقيقي.
* وضع PWM قائم على العينات لإشارات متزامنة مع الخطوات أو الفريمات.
* إمكانية ضبط دورة العمل عبر `Interval` و`Up Duration`.
* مخرج منطقي بسيط يسهل دمجه مع بلوكات المنطق والمخرجات.

## 📝 تعليمات الاستخدام

1. اختر وضع التشغيل باستخدام `Time mode`.
2. اضبط `Interval` لتحديد طول الدورة الكاملة.
3. اضبط `Up Duration` لتحديد الجزء النشط (True) من كل دورة. تأكد أن قيمة `Up Duration` أقل من أو تساوي `Interval`.
4. وصل مخرج `Boolean` بأي بلوك يحتاج إشارة رقمية/تحقق (مثلاً `Led Output` للعرض، أو بلوكات منطقية للتحكم في سلوك آخر).

## 📊 التقييم

أثناء التشغيل، ينتج البلوك نمطًا متكررًا من True/False. في وضع الوقت يتبع النمط الثواني الحقيقية. في وضع العينات يتقدم النمط مع كل تشغيل/خطوة. نسبة دورة العمل تساوي (`Up Duration` ÷ `Interval`).

## 💡 نصائح وحيل

* استخدم `Scope` لتصوير الإشارة والتحقق من التوقيت ونسبة دورة العمل في الوقت الحقيقي.
* استخدم `Rising Edge` لاكتشاف التحولات وتشغيل إجراءات لمرة واحدة على الحافة الصاعدة.
* عد النبضات باستخدام `Counter` لقياس التكرارات أو تشغيل عمليات حسب الدُفعات.
* ادمج مع `And` أو `Or` لتمرير إشارة الـ PWM بناءً على شروط أخرى (مثلاً إدخال يدوي `Logic Input`).
* استخدم `Delay Step`, `ON Delay` أو `OFF Delay` لتشكيل أو إزالة الاهتزازات من الانتقالات.
* احتفظ أو جمد القيم باستخدام `Data Memory` عندما تحتاج قيمة مستقرة بين التحديثات.

## 🛠️ استكشاف الأخطاء وإصلاحها

* الإخراج دائمًا True أو دائمًا False
  * تحقق من إعدادات `Up Duration` و`Interval` وتأكد أن `Time mode` المحدد يتطابق مع الوحدات المتوقعة (ثوانٍ مقابل عينات).
* التوقيت غير مضبوط في وضع الوقت
  * تأكد من أن ساعة النظام تعمل وأن بلوكات أخرى لا تُعيق التنفيذ. استخدم `Scope` للتأكد من التوقيت الحقيقي.
* وضع العينات لا يتقدم كما هو متوقع
  * تأكد من أن النظام يولد خطوات/عينات (حلقة التشغيل أو البلوكات السابقة يجب أن توفر تكرارات). استخدم `Counter` أو `Cycle Timer` لفحص تقدم الخطوات.