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

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

ต่อเนื่อง

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

เมื่อเปลี่ยน

เหตุการณ์จะถูกสร้างขึ้นก็ต่อเมื่อค่าที่วัดได้มีการเปลี่ยนแปลง การเปิดใช้งานเซ็นเซอร์ที่ระดับ HAL (การเรียก activate(..., enable=1) จะทำให้เกิดเหตุการณ์ซึ่งหมายความว่า HAL ต้องส่งคืนเหตุการณ์ทันทีเมื่อเปิดใช้งานเซ็นเซอร์เมื่อเปลี่ยน เซ็นเซอร์ตัวอย่างที่ใช้โหมดการรายงานเมื่อเปลี่ยนแปลง ได้แก่ ประเภทของเซ็นเซอร์นับก้าว ความใกล้ชิด และอัตราการเต้นของหัวใจ

พารามิเตอร์ sampling_period_ns ที่ส่งไปยังฟังก์ชัน batch ตช์ใช้เพื่อตั้งเวลาขั้นต่ำระหว่างเหตุการณ์ที่ต่อเนื่องกัน ซึ่งหมายความว่าไม่ควรสร้างเหตุการณ์จนกว่าจะหมดเวลา sampling_period_ns _period_ns นาโนวินาทีตั้งแต่เหตุการณ์ล่าสุด แม้ว่าค่าจะเปลี่ยนไปตั้งแต่นั้นเป็นต้นมา หากค่าเปลี่ยนไป จะต้องสร้างเหตุการณ์ทันทีที่ sampling_period_ns ผ่านไปตั้งแต่เหตุการณ์ที่แล้ว

ตัวอย่างเช่น สมมติว่า:

  • เราเปิดใช้งานตัวนับขั้นตอนด้วย sampling_period_ns = 10 * 10^9 (10 วินาที)
  • เราเดินเป็นเวลา 55 วินาทีแล้วยืนนิ่งเป็นเวลาหนึ่งนาที
  • เหตุการณ์ถูกสร้างขึ้นทุก ๆ 10 วินาทีในช่วงนาทีแรก (รวมถึงเวลา t=0 เนื่องจากการสั่งงานของเซ็นเซอร์ และ t=60 วินาที) รวมเป็นเจ็ดเหตุการณ์ ไม่มีการสร้างเหตุการณ์ในนาทีที่ 2 เนื่องจากค่าของการนับขั้นตอนไม่เปลี่ยนแปลงหลังจาก t=60 วินาที

นัดเดียว

เมื่อตรวจพบเหตุการณ์ เซ็นเซอร์จะปิดใช้งานตัวเองแล้วส่งเหตุการณ์เดียวผ่าน HAL ลำดับมีความสำคัญเพื่อหลีกเลี่ยงสภาพการแข่งขัน (ต้องปิดการใช้งานเซ็นเซอร์ก่อนที่จะรายงานเหตุการณ์ผ่าน HAL) จะไม่มีการส่งเหตุการณ์อื่นจนกว่าจะเปิดใช้งานเซ็นเซอร์อีกครั้ง การเคลื่อนไหว ที่สำคัญคือตัวอย่างของเซ็นเซอร์ประเภทนี้

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

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

พิเศษ

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