Serial Connect

تفتح هذه الدالة اتصالًا تسلسليًا (COM) وتديره. استخدمها للاتصال بالأجهزة التسلسلية، مراقبة حالة الاتصال، وإتاحة معرف اتصال يمكن للكتل الأخرى الرجوع إليه.

📥 المدخلات

لا يحتوي هذا function block على أي مدخلات.

📤 المخرجات

• ConnId — معرف فريد للاتصال التسلسلي المفتوح. استخدم هذه القيمة للإشارة إلى الاتصال من كتل أخرى.

• Connected? — علم منطقي يشير إلى ما إذا كان الاتصال التسلسلي نشطًا حاليًا أم لا.

🕹️ الضوابط

• Port — اسم منفذ COM للاتصال (مثال: COM3).

• Baud — سرعة الاتصال (مثال: 115200).

• Read timeout (s) — زمن الانتظار بالثواني لعمليات القراءة.

• Line delimiter — اختيار نهاية السطر المستخدمة من جهازك (LF / CRLF / CR).

• AutoReconnect — مفتاح يفعّل إعادة الاتصال التلقائية عند فقدان الاتصال.

• Reconnect interval (s) — الفاصل الزمني بين محاولات إعادة الاتصال عند تفعيل AutoReconnect.

• Idle disconnect (s) — زمن الخمول بعده سيتم إغلاق الاتصال تلقائيًا لتحرير المنفذ.

🎨 الميزات

• إدارة اتصال تلقائية: يفتح الاتصال بالمعلمات المكوّنة ويجعل ConnId متاحًا لباقي البلوكات.

• إعادة اتصال تلقائية: يحاول إعادة الاتصال عندما يصبح الجهاز غير متاح (اختياري).

• فصل عند الخمول: يغلق المنفذ عند عدم الاستخدام لمنع قفل الجهاز للتطبيقات الأخرى.

• إعدادات قابلة للقراءة من قبل الإنسان: اختر نمط نهاية السطر واضبط مهلات الانتظار لتتناسب مع الجهاز المتصل.

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

1. اضبط قيمتي Port وBaud لتطابق جهازك.

2. كونفِجَر Read timeout (s) وLine delimiter حسب بروتوكول جهازك.

3. فعّل AutoReconnect واضبط Reconnect interval (s) إذا رغبت أن يستعيد البلوك الاتصال تلقائيًا بعد الانقطاع.

4. عدِّل Idle disconnect (s) حتى يغلق البلوك المنفذ عند عدم الاستخدام.

5. شغّل السيناريو. سيفتح البلوك الاتصال ويخرج ConnId وConnected?. استخدم ConnId في كتل الاتصال الأخرى التي تقبل مرجع اتصال.

📊 التقييم

عند التقييم، يضمن البلوك وجود اتصال تسلسلي بالإعدادات الحالية. إذا تغيّرت الإعدادات، يتم تحرير الاتصال السابق وإنشاء اتصال جديد. تعكس المخرجات معرف الاتصال النشط وما إذا كان الاتصال مقيمًا حاليًا.

💡 نصائح وحيل

• استخدم Led Output لعكس حالة Connected? بصريًا في واجهة المستخدم.

• استخدم String Input أو Number Input وString Merge لصياغة الأوامر المرسلة عبر الرابط التسلسلي.

• استخدم Data Write Global / Data Read Global لمشاركة ConnId أو نتائج السلسلة التسلسلية مع أجزاء أخرى من السيناريو دون توصيل مباشر.

• قم بتغذية بيانات السيريال إلى Data to JSON أو CSV Export لتسجيل التواصل وتحليله لاحقًا.

• أعد توجيه البيانات المفككة إلى الأنظمة البعيدة باستخدام MQTT Publish أو REST API - Post للتكامل مع السحابة أو المراقبة.

• استخدم Debug Input لفحص الرسائل أثناء تطوير سير العمل التسلسلي.

• اجمعها مع Send Mail لإرسال تنبيهات عبر البريد عند فقدان الاتصال أو عند وصول رسائل محددة.

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

• إذا بقيت Connected? على false: تحقق من تطابق منفذ الجهاز وإعدادات الـ baud؛ افحص تعريفات الجهاز ومدير الأجهزة في نظام التشغيل.

• إذا لم تتمكن من فتح المنفذ: تأكد من أن لا تطبيق آخر يستخدم نفس منفذ COM. أغلق البرامج الأخرى أو فعّل خيار فصل الخمول في تلك الأنظمة.

• إذا ظهرت الأسطر مقطوعة أو مدمجة: جرّب إعدادًا مختلفًا لـ Line delimiter أو زد قيمة Read timeout (s).

• إذا حدثت فواصل متكررة: فعّل AutoReconnect وزد Reconnect interval (s) لمنح الجهاز وقتًا للعودة.

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