> 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/outputs-exports/led-output.md).

# Led Output

هذا الـ function block يوفر مؤشرًا بصريًا بسيطًا لإشارات boolean. استخدمه للتحقق السريع مما إذا كانت حالة في السيناريو TRUE أو FALSE أو غير معرفة.

## 📥 المدخلات <a href="#inputs" id="inputs"></a>

`Boolean` هذا المقبس يستقبل إشارة boolean لتشغيل مؤشر LED. قم بتوصيل أي خرج منطقي أو نتيجة شرطية هنا.

## 📤 المخرجات <a href="#outputs" id="outputs"></a>

لا يحتوي هذا الـ function block على مخرجات.

## 🕹️ الضوابط <a href="#controls" id="controls"></a>

`led` مؤشر LED المرئي الظاهر على البلوك:

* رمادي — الإدخال غير معرف / None.
* أخضر — الإدخال TRUE.
* أحمر — الإدخال FALSE.

## 🎨 الميزات <a href="#features" id="features"></a>

* تغذية راجعة بصرية في الزمن الحقيقي لإشارات boolean.
* ترميز لوني واضح لثلاث حالات: غير معرف، TRUE، و FALSE.
* خفيف وسهل الاستخدام للشاشات اللوحية ولوحات المعلومات أو للتصحيح السريع.

## 📝 إرشادات الاستخدام <a href="#usage" id="usage"></a>

1. زود مدخل `Boolean` بإشارة boolean.
2. راقب لون `led` لفهم الحالة الحالية:
   * أخضر لـ TRUE
   * أحمر لـ FALSE
   * رمادي عند عدم وجود قيمة

استخدم هذا البلوك على شاشات UI حيث تكون التغذية البصرية الفورية مفيدة.

## 📊 التقييم <a href="#evaluation" id="evaluation"></a>

عند تشغيل السيناريو، يتحقق البلوك من القيمة الواردة إلى مقبس `Boolean` ويحدّث لون `led` بناءً على ذلك. إذا لم تكن هناك قيمة، يظهر المؤشر حالة غير المعرفة.

## 💡 نصائح وحيل <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* للاختبار اليدوي، قم بتوصيل `Logic Input` إلى مقبس `Boolean` بحيث يمكن للمشغل تبديل الـ LED يدويًا.
* اجمع فحوصات الشروط قبل الـ LED باستخدام بلوكات منطقية مثل `And`, `Or`, و `Not` لعرض شروط مركبة.
* استخدم بلوكات مقارنة مثل `Equals`, `Greater`, أو `Smaller` لتحويل القياسات الرقمية إلى إشارات boolean للـ LED.
* استخدم كاشفات الحافة مثل `Rising Edge` أو `Edge Rising` لعرض نبضات حدث بدلاً من الحالات المستمرة.
* أضف سلوكًا زمنيًا باستخدام `Delay Step`, `ON Delay`, أو `OFF Delay` إذا رغبت أن يستجيب الـ LED فقط بعد شرط مستمر لمدة معينة.
* استخدم `Set - Reset` لتثبيت حالة ما وإبقاء الـ LED مضاءً حتى يتم إعادة تعيينه صراحة.
* ادمج مع بلوكات بيانات أو اتصال في الأعلى (مثلاً استخدم `Data Write Local` / `Data Write Global` أو `MQTT Publish` على المنطق الذي يغذي هذا البلوك) لعرض حالات يتم التحكم بها عن بعد أو عبر الشبكة محليًا.

## 🛠️ استكشاف الأخطاء وإصلاحها <a href="#troubleshooting" id="troubleshooting"></a>

* يبقى LED رماديًا: تحقق من أن البلوك السابق ينتج قيمة boolean. فكر في استخدام `Is None` أو `Logic Input` بسيط لاختبار المسار.
* LED دائمًا أحمر/أخضر لكن الحالة تبدو خاطئة: تحقّق من المنطق بالأعلى (مقارنات، دمج) باستخدام مؤشرات وسيطة أو بلوكات تصحيح قبل التوصيل إلى LED.
* تحتاج مؤشرًا مستمرًا لأحداث عابرة: استخدم `Set - Reset` أو نمط حافة-إلى-قفل بحيث تتحول نبضة قصيرة إلى حالة مرئية مستمرة.
