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

Modbus Read

هذه الدالة تقرأ البيانات من خادم Modbus (coils أو registers) باستخدام اتصال Modbus client مقدم. استخدم عناصر التحكم على الشاشة لاختيار العنوان المستهدف، عدد القيم للقراءة، ونوع بيانات Modbus.

📥 المدخلات

Enable بوابة منطقية (boolean) تسمح أو تمنع عملية القراءة. عندما تكون False، لن يقوم البلوك بالقراءة ولن يعيد أي بيانات.

Modbus Client زوّد كائن اتصال Modbus client (عادةً يأتي من بلوك Modbus Connect). يستخدم البلوك هذا العميل للتواصل مع الخادم.

📤 المخرجات

Data نتيجة القراءة على شكل قائمة عامة. لقراءات السجلات (registers) تكون القائمة أرقاماً تمثل قيم السجلات؛ لقراءات الـ coils/discrete تكون قائمة من القيم البوليانية. إذا فشلت القراءة أو كانت معطلة، تكون المخرجات فارغة/None.

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

Address أدخل عنوان البدء (عدد صحيح) على جهاز Modbus للقراءة منه.

Quantity أدخل عدد العناصر المتتالية (registers أو coils) المراد قراءتها.

Data Type اختر نوع بيانات Modbus للقراءة: Coil, Discrete Input, Input Register، أو Holding Register.

🎯 الميزات

  • يدعم القراءة من أنواع البيانات القائمة على البت (coils/discrete inputs) وأيضًا الأنواع القائمة على الكلمة (input/holding registers).

  • يستخدم اتصال Modbus خارجي المزوّد إلى مدخل Modbus Client، مما يفصل إعدادات الاتصال عن إعدادات البلوك.

  • يعيد نتائج رقمية وبوليانية بسيطة في شكل قائمة مناسبة للتسجيل، الرسم البياني، أو المعالجة اللاحقة.

  • يحتوي على تقارير خطأ مدمجة تظهر حالات فشل الاتصال لتتمكن من اتخاذ إجراء (إعادة الاتصال، إعادة المحاولة، التنبيه).

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

عند التفعيل، يتحقق البلوك من مدخل Enable ويتطلب وجود عميل صالح على مدخل Modbus Client. يقرأ نطاق العناوين المُكوّن باستخدام Data Type المحدد ويعيد القيم على مخرج Data. إذا فشلت القراءة أو كان البلوك معطّلاً، لا يعيد بيانات ويسجل رسالة خطأ مفيدة.

💡 نصائح وحيل

  • استخدم Modbus Connect لإنشاء وتزويد اتصال Modbus Client المطلوب.

  • استخدم Logic Input أو Rising Edge للتحكم في توقيت القراءات (زر يدوي أو قراءة لمرة واحدة).

  • لكتابة قيم إلى جهاز، اجمع مع بلوك Modbus Write.

  • سجّل القراءات للمراجعة لاحقًا باستخدام CSV Export أو احفظها باستخدام Data Write Local / Data Write Global.

  • عرّض المخرجات الرقمية في الوقت الحقيقي عبر توصيلها إلى بلوك Scope.

  • استخدم Debug Input لفحص والتحقق من القيم المعادة في أثناء الإعداد واستكشاف الأخطاء.

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

  • لا توجد بيانات: تأكد من توصيل عميل صالح إلى مدخل Modbus Client وأن Enable قيمة True.

  • قيم خاطئة أو قراءات جزئية: تحقق أن Address و Quantity ضمن خريطة عناوين الجهاز وحدوده.

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

  • تنسيق بيانات غير متوقع: تأكد من اختيار Data Type الصحيح (coils vs registers) للقيم التي تتوقعها.

آخر تحديث