Cycle Timer

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

📥 المدخلات

هذه الدالة لا تحتوي على مدخلات.

📤 المخرجات

• Seconds — يعيد الزمن المنقضي (بالثواني) منذ التقييم السابق. عند أول تقييم بعد وضع البلوك أو إعادة التهيئة ستكون القيمة صفرًا.

🕹️ Controls

• No Controls — هذا البلوك ليس له عناصر تحكم للمستخدم. يقوم بتحديث الطابع الزمني الداخلي تلقائيًا عند كل تشغيل.

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

• في كل مرة يتم فيها تقييم البلوك داخل السيناريو، يقارن الوقت الحالي بالوقت المسجل في التقييم السابق ويعيد الفرق كقيمة Seconds.

• التقييم الأول يعمل كمهيئة ويُعيد صفرًا لعدم وجود طابع زمني سابق.

• يقيس البلوك الزمن الحقيقي (wall-clock) بدقة عالية، مما يجعله مناسبًا لقياس فترات قصيرة بين خطوات أو أحداث.

🎯 Features

• قياس فترات تلقائي وخفيف بدون إعدادات.

• توقيت عالي الدقة مناسب للملف الزمني ومراقبة الدورات.

• القيم متاحة فورًا لمعالجة لاحقة أو تسجيل.

📝 Usage Instructions

1. ضع البلوك في السيناريو في المكان الذي تريد قياس الزمن بين التقييمات فيه.

2. اقرأ مخرج Seconds في البلوكات اللاحقة لتسجيل أو تحليل أو تفعيل إجراءات بناءً على الزمن المنقضي.

3. تذكّر أن القياس الأول بعد وضع البلوك أو إعادة التهيئة يكون صفرًا.

تركيبات شائعة:

• استخدم مع Rising Edge أو Logic Input لقياس الزمن بين أحداث منفصلة أو إجراءات يدوية.

• استخدم مع مصادر الصورة مثل Camera USB, Stream Reader أو Video لقياس فترات الإطارات أو زمن معالجة الصورة.

• مرّر المخرج إلى Round للحصول على عرض رقمي مُنسق، أو إلى Scope لعرض مخطط زمني مباشر لأزمنة الدورات.

• أرسل القيم إلى CSV Export أو Image Logger لتسجيل تاريخ أزمنة الدورات.

💡 Tips and Tricks

• لمراقبة استقرار المعالجة، مرّر Seconds إلى Scope لرؤية التذبذب والقمم على مدى الوقت.

• للتسجيل على المدى الطويل، استخدم CSV Export لجمع قيم Seconds للتحليل اللاحق.

• عند القياس بين إجراءات يدوية، اجمعه مع Keyboard/Barcode Reader أو Logic Input لالتقاط مدد دقيقة من حدث لحدث.

• إذا احتجت عرضًا منسقًا، استخدم Round لتقليل المنازل العشرية قبل عرض القيم في واجهة المستخدم.

🛠️ Troubleshooting

• إذا كنت ترى دائمًا قيمًا تساوي صفرًا، تأكد أن السيناريو يعمل بتكرار وأنه غير متوقف؛ التقييم الأول بعد وضع البلوك أو إعادة التهيئة مصمم أن يكون صفرًا.

• إذا أظهرت القياسات فترات صغيرة غير متوقعة جدًا، تحقق أن البلوك لا يتم تقييمه عدة مرات خلال نفس الخطوة المنطقية بواسطة تركيبات التدفق الأخرى. فكر باستخدام مُحدِث حدث مثل Rising Edge ليقيس البلوك فقط عند اللحظات المقصودة.

• لتقليل القمم الضوضائية في القياسات قصيرة المدى، قم بتمهيد أو متوسط عدة قيم متتالية من Seconds باستخدام معالجة لاحقة أو بتسجيلها ثم معالجتها بعد ذلك.