โหมดการรายงาน

เซนเซอร์สามารถสร้างเหตุการณ์ในรูปแบบต่างๆที่เรียกว่าโหมดการรายงาน เซ็นเซอร์แต่ละประเภทมีโหมดการรายงานเพียงโหมดเดียวเท่านั้น มีโหมดการรายงานสี่โหมด

ต่อเนื่อง

เหตุการณ์ถูกสร้างขึ้นในอัตราคงที่ซึ่งกำหนดโดยพารามิเตอร์ 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) ไม่มีการส่งเหตุการณ์อื่นใดจนกว่าเซ็นเซอร์จะเปิดใช้งานอีกครั้ง การเคลื่อนไหวที่มีนัยสำคัญ เป็นตัวอย่างของเซ็นเซอร์ประเภทนี้

เซ็นเซอร์แบบ One-shot บางครั้งเรียกว่าเซ็นเซอร์ทริกเกอร์

พารามิเตอร์ sampling_period_ns และ max_report_latency_ns ส่งผ่านไปยังฟังก์ชัน batch จะถูกละเว้น เหตุการณ์จากเหตุการณ์ที่เกิดขึ้นครั้งเดียวไม่สามารถเก็บไว้ในฮาร์ดแวร์ FIFO ได้ ต้องรายงานเหตุการณ์ทันทีที่สร้างขึ้น

พิเศษ

ดู คำอธิบายประเภทเซ็นเซอร์ แต่ละรายการสำหรับรายละเอียดเกี่ยวกับเวลาที่สร้างเหตุการณ์