Modbus Write

تقوم هذه الوظيفة بإرسال قيم إلى خادم Modbus باستخدام عميل Modbus المزوّد. استخدمها لكتابة coils أو holding registers من مخطط السيناريو الخاص بك.

📥 المدخلات

• Enable إدخال منطقي يتحكم فيما إذا كانت عملية الكتابة ستتم أم لا. إذا لم يُزوّد أو كانت قيمته False، فلن تحاول الوحدة الكتابة.

• Modbus Client يتوقع هذا الإدخال كائن العميل الذي يُنتَج بواسطة Modbus Connect. زود عميلًا صالحًا لتمكين الاتصال.

• Data بيانات عامة للكتابة. تقبل قيمة مفردة أو قائمة (للكتابة إلى عدة coils/registers).

📤 المخرجات

لا تنتج هذه الوظيفة أية مخرجات.

🕹️ الضوابط

• Address أدخل عنوان السجل/الـ coil في Modbus للكتابة إليه. استخدم أعداد صحيحة تتوافق مع خريطة الجهاز لديك.

• Data Type اختر بين Coil وHolding Register لتحديد نوع مورد Modbus الذي سيتم الكتابة إليه.

🎯 الميزات

• يدعم كتابة قيمة مفردة أو قائمة إلى عناوين متعددة عندما يدعم الجهاز ذلك.

• يتيح اختيار نوع المورد الهدف عبر قائمة منسدلة بسيطة: Coil أو Holding Register.

• يحترم إدخال Enable حتى يمكنك التحكم بالكتابة منطقياً أو عبر مدخلات المستخدم.

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

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

عند تشغيل البلوك:

• إذا كان إدخال Enable False أو مفقودًا، فلن تُجرى محاولة كتابة.

• إذا لم يُزوَّد أي عميل عند Modbus Client، فلن تؤدي الوحدة أي كتابة.

• عند التمكين ووجود عميل صالح، ترسل الوحدة بيانات Data إلى العنوان الموجود في Address باستخدام نوع البيانات المختار في Data Type.

• تُبلغ الأخطاء (مشكلات الاتصال، عنوان غير صالح، بيانات غير مدعومة) في السجل بحيث يمكنك اتخاذ الإجراء المناسب.

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

• أضِف بلوك Modbus Connect وصل مخرجه Modbus Client إلى إدخال Modbus Client في هذا البلوك.

• اضبط Address إلى عنوان السجل أو الـ coil الذي تريد الكتابة إليه.

• اختر Data Type كـ Coil للقيم البوليانية/coils أو Holding Register للسجلات العددية.

• قدّم قيمك إلى إدخال Data (قيمة مفردة أو قائمة).

• استخدم Logic Input أو أي عنصر تحكم آخر لتبديل Enable عند رغبتك في تنفيذ الكتابة.

💡 نصائح وحيل

• استخدم Modbus Connect للحصول على عميل موثوق وتأكد من الاتصال عبر Modbus Read قبل محاولة الكتابة.

• قم بتحريك إدخال Enable بواسطة Logic Input أو بلوك شرطي (مثل Equals / Greater) حتى تتم الكتابات فقط في الشروط المرغوبة.

• حضّر قيم الكتابة باستخدام Number Input أو بتجميع البيانات عبر بلوكات مثل String Merge أو Data Write Global / Data Write Local عندما تحتاج إلى تجهيز القيم.

• إذا كنت بحاجة لحفظ أو تصدير القيم التي تكتبها، اجمع هذا البلوك مع CSV Export أو REST API - Post للاحتفاظ بسجلات خارجية أو إرسال إشعارات.

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

• لا تتم أي كتابة: تحقق أن Enable True وأن Modbus Client صالح ومتصل.

• أخطاء عنوان غير صالح: تأكد أن Address عدد صحيح ضمن خريطة عنوان الجهاز ويتطابق مع Data Type المختار.

• تنسيق بيانات غير متوقع: استخدم boolean أو قائمة booleans لـ Coil؛ استخدم أرقام أو قائمة أرقام لـ Holding Register.

• فشل الكتابة: تحقق من الاتصال باستخدام Modbus Read وتأكد أن الخادم يقبل الكتابة إلى العنوان المستهدف. اطلع على رسائل السجل للتفاصيل.