> 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/siemens-s7-connect.md).

# Siemens S7 Connect

هذا بلوك الدالة يضبط معلمات الاتصال لوحدة التحكم المنطقية القابلة للبرمجة من طراز Siemens S7 (PLC) حتى تتمكن كتل الاتصال الأخرى من الوصول إلى الـ PLC باستخدام هذه الإعدادات. استخدمه لتوفير مخرج قابل لإعادة الاستخدام `S7 Client` يمكن توصيله بكتل القراءة والكتابة.

## 📥 المدخلات

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

## 📤 المخرجات

* `S7 Client` مقبض عميل عام يحتوي على معلومات الاتصال الخاصة بالـ PLC المكوّن.

## 🕹️ الضوابط

* `IP Address` أدخل عنوان IP الخاص بالـ PLC (القيمة الافتراضية معروضة في التحكم).
* `Rack` أدخل رقم الرف (Rack) الخاص بالـ PLC (الافتراضي الشائع: 0).
* `Slot` أدخل رقم الفتحة (Slot) الخاص بالـ PLC (الافتراضي الشائع: 1).
* `TCP Port` أدخل منفذ TCP الخاص بالـ PLC (الافتراضي: 102). استخدمه إذا كان الـ PLC يستخدم منفذاً غير قياسي.

كل عنصر تحكم هو حقل نص بسيط يمكنك تحريره مباشرة ليتطابق مع إعدادات الـ PLC لديك.

## 🎯 الميزات

* واجهة بسيطة لإدخال معلمات الاتصال القياسية لـ Siemens S7 بدون برمجة.
* يُنتج مقبض اتصال يمكن للكتل الأخرى استخدامه للتواصل مع الـ PLC.
* يبقي إعدادات التكوين مرئية وقابلة للتحرير داخل السيناريو المرئي.

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

1. املأ عناصر التحكم بالاتصال: عيّن `IP Address` و `Rack` و `Slot` و `TCP Port` لتطابق إعدادات الـ PLC لديك.
2. وصل مخرج البلوك `S7 Client` بكتل الاتصال التي تنفذ العمليات على الـ PLC (مثل كتل القراءة أو الكتابة).
3. شغّل السيناريو. ستكون معلومات الاتصال متاحة للكتل التالية حتى تتمكن من إنشاء جلسة مع الـ PLC وتنفيذ عمليات القراءة/الكتابة.

## ⚙️ آلية التشغيل

عند التشغيل، يوفّر هذا البلوك مقبض الاتصال المكوَّن عبر مخرجه `S7 Client`. يمكن للكتل الأخرى استخدام هذا المقبض لفتح جلسةٍ مع الـ PLC وتنفيذ عمليات قراءة/كتابة.

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

* استخدم هذا البلوك مع `Siemens S7 Read` و `Siemens S7 Write` لتبادل البيانات مع الـ PLC.
* إذا كنت تحتاج إلى مشاركة بيانات الـ PLC عبر أجزاء متعددة من السيناريو، اقترن بكتل `Data Write Global` و `Data Read Global` لجعل القيم متاحة حيثما يلزم.
* للاختبار، اجمعه مع `Debug Input` أو بلوك تسجيل بسيط للتحقق من أن عمليات القراءة/الكتابة تعيد القيم المتوقعة.
* إذا كنت تنوي التكامل مع أنظمة صناعية أخرى، فكّر باستخدام هذا البلوك جنباً إلى جنب مع `OPC UA Client` أو كتلة `REST API - Post` لنقل بيانات الـ PLC إلى خدمات أخرى أو لوحات عرض.

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

* فشل الاتصال: تحقق من أن `IP Address` صحيح ويمكن الوصول إليه من الجهاز الذي يشغّل السيناريو.
* المنفذ محجوب: تأكد أن منفذ TCP 102 (أو المنفذ الذي قمت بتكوينه) غير محجوب بواسطة جدار حماية.
* خطأ في Rack/Slot: تأكد من أرقام الRack والSlot حسب وثائق الجهاز أو أدوات الشركة المصنعة.
* مشاكل الشبكة: افحص الاتصالات الفيزيائية وتحقق من عدم وجود تطبيقات أخرى تتداخل مع الوصول إلى الـ PLC.
