أوضاع الإبلاغ

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

مستمر

يتمّ إنشاء الأحداث بمعدّل ثابت يحدّده المَعلمة sampling_period_ns التي يتمّ تمريرها إلى الدالة batch. أمثلة على أدوات الاستشعار استخدام وضع الإبلاغ المستمر مقاييس التسارع والجيروسكوب

عند التغيير

لا يتمّ إنشاء الأحداث إلا إذا تغيّرت القيم المقاسة. يؤدي تفعيل أداة الاستشعار على مستوى HAL (باستدعاء activate(..., enable=1) عليها) إلى بدء حدث أيضًا، ما يعني أنّه يجب أن يعرض HAL حدثًا على الفور عند تفعيل أداة استشعار عند التغيُّر . أمثلة على أدوات الاستشعار التي تستخدم وضع الإبلاغ عند التغيير أنواع أدوات استشعار الدرج والتقارب ومعدّل نبضات القلب.

تُستخدَم المَعلمة sampling_period_ns التي تم تمريرها إلى الدالة batch لضبط الحد الأدنى للوقت بين الأحداث المتتالية، ما يعني أنّه لا يجب إنشاء حدث إلا بعد مرور sampling_period_ns نانوسانية منذ الحدث الأخير، حتى إذا تغيّرت القيمة منذ ذلك الحين. إذا تغيّرت القيمة، يجب إنشاء حدث بعد مرور sampling_period_ns منذ الحدث الأخير.

على سبيل المثال، لنفترض ما يلي:

  • نفعّل عدّاد الخطوات باستخدام sampling_period_ns = 10 * 10^9. (10 ثوانٍ)
  • نمشي لمدة 55 ثانية، ثم نقف لمدة دقيقة واحدة.
  • يتم إنشاء الأحداث كل 10 ثوانٍ تقريبًا خلال المدّة الأولى (بما في ذلك في الوقت t=0 بسبب بدء تشغيل المستشعر، وt=60 ثانية)، بإجمالي سبعة أحداث. لا يتم إنشاء أي حدث في الدقيقة الثانية لأنّ القيمة من عدد الخطوات لم يتغيّر بعد t=60 ثانية.

طلب بمثال واحد

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

يُشار أحيانًا إلى أجهزة استشعار اللقطة الواحدة باسم أدوات استشعار المشغّل.

sampling_period_ns وmax_report_latency_ns يتم تجاهل المعلمات التي تم تمريرها إلى الدالة batch. لا يمكن تخزين الأحداث من الأحداث لمرة واحدة في قوائم FIFO للأجهزة، ويجب الإبلاغ عن الأحداث فور إنشائها.

الأحداث الخاصة

الاطّلاع على نوع جهاز الاستشعار الفردي الأوصاف للحصول على تفاصيل عن وقت إنشاء الأحداث.