كتلة الوظيفة FS_READ

تقرأ كتلة الوظيفة FS_READ البيانات من ملف.

تحذير: عند قراءة الملفات الكبيرة جدًا، قد تتعطل PLC أو النظام بأكمله ولا يمكن تشغيله مرة أخرى. استخدم المدخل LENGTH=0 بحذر فقط.

يجب أن يتم تهيئة نظام الملفات مسبقًا باستخدام FS_INIT. تحدث جميع العمليات بشكل غير متزامن لكل وسائط تخزين تم إنشاؤها.

مدخل READ

عند حافة إيجابية، يتم قراءة البيانات من وسيط التخزين.

مدخل DEV

يحدد الجهاز الذي سيتم الوصول إليه من خلاله إلى الملفات. يتم استخدام الجهاز لكل مشروع ويمكن إدارتها في قائمة السياق تحت المشروع ▸ التخزين الخارجي.

مدخل PATH

يحدد المسار إلى الملف على وسيط التخزين. يتوافق المسار مع مسار ملف Unix في تنسيق UTF-8، إذا تم دعمه. يتم عرض المسار كما يلي:

المجلد/المجلد الفرعي/الملف.txt

مدخل OFFSET

يحدد الإزاحة بالبايت التي سيتم البدء في القراءة منها. إذا لم يتم تحديد أي إزاحة، يتم قراءة الملف من البداية.

مدخل LENGTH

يحدد الطول الأقصى الذي يتم فيه إنهاء القراءة. إذا لم يتم تحديد المدخل، يتم القراءة حتى نهاية الملف.

ملاحظة: الحجم القابل للقراءة الأقصى عند LENGTH=0 يبلغ 1,024,000 بايت لأسباب أمنية.

مخرج DONE

يعيد المخرج نبضة عند النجاح لإجراء العملية التالية. تحدث النبضة عند إنهاء العملية، حتى إذا حدث خطأ ما.

مخرج DATA

يعيد البيانات التي تم قراءتها. يتم تخزين الحالة للاستخدام اللاحق.

مخرج EOF

إذا تم الوصول إلى نهاية الملف، يكون المدخل صحيحًا.

مخرج BOM

إذا تم العثور على UTF-8 Byte Order Mark، يكون المخرج صحيحًا. يتم تحديد BOM في كل عملية قراءة.

مخرج ERROR

يعيد نصًا مع رسالة خطأ في حالة الخطأ. وهو FALSE إذا لم يحدث أي خطأ. يتم تخزين الحالة للاستخدام اللاحق.

السبب المحتمل:

• لم يتم تشغيل خدمة وسائط التخزين.
• لم يتم تهيئة الذاكرة.
• بيانات تسجيل الدخول غير صالحة.
• لا يمكن الوصول إلى الخادم البعيد.
• وسيط التخزين لا يوجد.
• المسار المحدد غير صالح.