For the complete documentation index, see llms.txt. This page is also available as Markdown.

TwinCAT Connect

هذا الكتلة الوظيفية تنشئ اتصالاً مع PLC من نوع TwinCAT ليتمكن باقي البلوكات من القراءة من PLC أو الكتابة إليه. استخدمها لإنشاء والحفاظ على اتصال العميل PLC والإبلاغ عن حالة الاتصال لبقية السيناريو الخاص بك.

📥 المدخلات

هذه الكتلة الوظيفية لا تحتوي على مآخذ إدخال.

📤 المخرجات

Connection مقبض الاتصال النشط (استخدمه مع بلوكات الاتصال اللاحقة).

Success قيمة منطقية تشير إلى ما إذا تم إنشاء اتصال ناجح مع PLC أم لا.

🕹️ عناصر التحكم

AMS ID أدخل معرف AMS الخاص بـ PLC (العنوان). عادةً ما يزودك به إعداد PLC أو مسؤول النظام.

Port أدخل رقم المنفذ المستخدم لاتصال TwinCAT. يوجد رقم منفذ شائع مملوء افتراضيًا (يمكنك تغييره إذا لزم الأمر).

Timeout (ms) اضبط مهلة الاتصال بالمللي ثانية. استخدم قيمة أكبر للشبكات البطيئة أو البعيدة.

ملاحظة: إذا لم تكن مكتبات دعم TwinCAT المطلوبة مثبتة على النظام، سيعرض البلوك رسالة في واجهته تشير إلى أن وحدات TwinCAT غير متاحة ولن يتمكن البلوك من الاتصال حتى تُثبّت المكونات المطلوبة.

🎯 الميزات

  • إخراج اتصال مستمر يمكن للبلوكات اللاحقة إعادة استخدامه بدون إعادة تهيئة.

  • يعرض نجاح الاتصال كقيمة منطقية لتفعيل تدفقات عمل شرطية.

  • عناصر تحكم بسيطة وموضّحة لضبط AMS ID وPort وTimeout (ms).

  • يبلغ بشكل واضح عن تبعيات النظام المفقودة حتى تعرف متى تكون مكونات TwinCAT مطلوبة.

⚙️ كيفية العمل

  • عند تشغيل البلوك يحاول إنشاء اتصال PLC باستخدام القيم الموجودة في AMS ID, Port وTimeout (ms).

  • عند النجاح يزود المخرج Connection بالاتصال المُنشأ ويضبط Success على true. عند الفشل يوفر اتصالًا فارغًا أو null ويضبط Success على false.

  • يمكن ترك مخرج الاتصال موصولًا ببلوكات الاتصال الأخرى حتى تستخدم نفس الارتباط المُنشأ دون إنشاء اتصالات متكررة.

  • يعرض البلوك رسائل خطأ واضحة في واجهة المستخدم إذا كانت الإعدادات مفقودة أو تبعيات النظام غير متوفرة.

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

  1. أدخل عنوان PLC في AMS ID ورقم المنفذ الهدف في Port.

  2. اضبط Timeout (ms) إذا كانت شبكتك بطيئة أو غير موثوقة.

  3. شغّل السيناريو؛ تحقق من مخرج Success للتأكد من نجاح الاتصال.

  4. وصّل مخرج Connection إلى البلوكات التي تقوم بعمليات القراءة/الكتابة على PLC.

💡 نصائح وحيل

  • استخدم بلوكات TwinCAT Read وTwinCAT Write بعد هذا البلوك لتنفيذ عمليات القراءة والكتابة باستخدام Connection المقدم.

  • اجمع بين Logic Input ومخرج Success لتقييد عمليات PLC فقط عند تفعيل الاتصال.

  • استخدم Debug Input أو بلوك عرض/تسجيل لعرض حالة الاتصال أو الأخطاء أثناء التطوير.

  • لحفظ أو معالجة القيم المقروءة من PLC لاحقًا، وصّل القُرّاء إلى بلوكات مثل CSV Export أو Data Write Global لحفظ النتائج.

  • إذا احتجت إلى تحفيز إجراءات عند ظهور أو اختفاء الاتصال، استخدم بلوكات منطقية مثل Rising Edge أو Set - Reset مع مخرج Success.

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

  • إذا أبلغ البلوك أن وحدات TwinCAT غير متاحة، تأكد من تثبيت وقت تشغيل TwinCAT والحزم البرمجية (Python packages) المطلوبة على الجهاز ثم أعد تشغيل التطبيق.

  • إذا ظل Success على false، تحقق من صحة وقابلية الوصول إلى AMS ID وPort من شبكتك.

  • زد قيمة Timeout (ms) عند الاتصال بـ PLCs بعيدة أو عند وجود تأخير متقطع في الشبكة.

  • إذا فشل الاتصال بشكل متقطع، استخدم دائرة منطق صغيرة (مثل Delay Step + منطق Retry مع Rising Edge) لمحاولة إعادة الاتصال فقط عند الحاجة.

آخر تحديث