> 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/communication/modbus-connect.md).

# Modbus Connect

هذا البلوك الوظيفي ينشئ اتصال Modbus TCP إلى جهاز بعيد ويوفر مخرجًا قابلاً لإعادة الاستخدام باسم `Modbus Client` يمكن للبلوكات الأخرى استخدامه لإجراء عمليات قراءة/كتابة.

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

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

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

`Modbus Client` مرجع عميل Modbus متصل يمكن توصيله إلى بلوكات الاتصال لقراءة أو كتابة السجلات.

## 🕹️ عناصر التحكم <a href="#controls" id="controls"></a>

`IP Address` أدخل عنوان IP لخادم Modbus TCP (مثال: 192.168.0.10).

`TCP Port` أدخل منفذ Modbus TCP (القيمة الافتراضية شائعةً 502).

## ⚙️ آلية التشغيل <a href="#running-mechanism" id="running-mechanism"></a>

* عند التنفيذ، يحاول البلوك الاتصال بخادم Modbus على العنوان والمنفذ المحددين في عناصر التحكم.
* إذا تم تغيير العنوان أو المنفذ، أو انقطع الاتصال، سيحاول البلوك إعادة الاتصال تلقائيًا ويستمر في توفير مخرج `Modbus Client` محدث للبلوكات الأخرى.
* تستقبل البلوكات الأخرى مرجع `Modbus Client` من منفذ المخرج وتستخدمه لأداء مهام الاتصال (قراءة/كتابة).

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

* خرج اتصال دائم بحيث يمكن لعدة بلوكات مشاركة نفس العميل.
* إعادة اتصال تلقائية عند تغيير العنوان أو فقدان الاتصال.
* عناصر تحكم واجهة بسيطة لإعداد IP والمنفذ.

## 📝 كيفية الاستخدام <a href="#usage" id="usage"></a>

1. اضبط `IP Address` و`TCP Port` في عناصر التحكم.
2. دع السيناريو يعمل — سيقوم البلوك بإنشاء الاتصال وتوفير `Modbus Client` على المخرج.
3. قم بتوصيل مخرج `Modbus Client` ببلوكات الاتصال التي تحتاجه (مثل بلوكات القراءة/الكتابة) لتنفيذ عمليات Modbus.

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

* لقراءة البيانات بشكل دوري، وصل مخرج `Modbus Client` ببلوك `Modbus Read` واستخدم `Logic Input` أو مشغل آخر للتحكم بزمن تنفيذ القراءات.
* لكتابة أوامر أو قيم، قم بتغذية `Modbus Client` إلى بلوك `Modbus Write` واستخدم مشغل منطقي لإجراء الكتابات عند الحاجة فقط.
* أرسل القياسات البعيدة عبر الدمج مع `MQTT Publish` (وصل خرج بلوك القراءة إلى `MQTT Publish`) للمراسلة الخفيفة الوزن.
* احفظ أو سجّل القيم بإرسال نواتج القراءة إلى `SQL-DB Operations` أو `CSV Export` للتخزين الدائم والتحليل لاحقًا.
* استخدم `Debug Input` أو `Scope` لفحص القيم الناتجة من بلوكات القراءة أثناء الإعداد واستكشاف الأخطاء.

(تلميح: البلوكات الموصى بها للعمل المرافق — `Modbus Read`, `Modbus Write`, `Logic Input`, `MQTT Publish`, `SQL-DB Operations`, `CSV Export`, `Debug Input`, `Scope`)

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

* رفض الاتصال أو انتهاء المهلة — تحقق من صحة `IP Address` و`TCP Port` وأن خادم Modbus متاح على الشبكة.
* قواعد جدار ناري أو شبكية — تأكد أن المنفذ المستخدم لـ Modbus TCP مسموح بمروره عبر الجدران النارية على الطرفين.
* تعدد العملاء — إذا كان الخادم يقيّد الاتصالات، تجنّب إنشاء العديد من الاتصالات المتزامنة؛ شارك مخرج `Modbus Client` الموفّر مع البلوكات الأخرى.
* إذا بدا الاتصال غير مستقر، تحقق من جودة الشبكة وحاول استخدام كابل شبكة أو منفذ تبديل مختلف.