การใช้งานข้อมูลอ้างอิง

เรามีการใช้งานอ้างอิงสำหรับ VHAL ของ AIDL มีการใช้เธรดบริการหลักที่ VehicleService.cpp การติดตั้งใช้งานอินเทอร์เฟซ VHAL อยู่ที่ DefaultVehicleHal.cpp

การใช้งานข้อมูลอ้างอิงจะขึ้นอยู่กับสถาปัตยกรรมแบบ 2 ชั้น ในเลเยอร์ด้านบน DefaultVehicleHal จะใช้อินเทอร์เฟซ VHAL AIDL และให้ตรรกะ VHAL แบบทั่วไปสำหรับอุปกรณ์ฮาร์ดแวร์ทั้งหมด ส่วน FakeVehicleHardware ในเลเยอร์ด้านล่างจะใช้อินเทอร์เฟซ IVehicleHardware คลาสนี้จะจำลองตรรกะ VHAL ของการโต้ตอบกับฮาร์ดแวร์หรือบัสของยานพาหนะจริง และเป็นแบบเฉพาะอุปกรณ์ ผู้ให้บริการสามารถปรับใช้สถาปัตยกรรมเดียวกันนี้ นำมาใช้ซ้ำกับคลาส DefaultVehicleHal เดียวกัน (ขยายคลาสเพื่อเขียนทับเมธอด) และให้บริการ IVehicleHardware ของตนเองได้ (ไม่บังคับ)

การใช้การอ้างอิง VHAL
รูปที่ 1 การติดตั้งใช้งาน VHAL อ้างอิง

DefaultVehicleHal มีตรรกะต่อไปนี้ ซึ่งถือว่าเป็นแบบทั่วไปและนำไปใช้กับการติดตั้งใช้งาน VHAL ได้

  • ใช้งานอินเทอร์เฟซ IVehicle
  • ดำเนินการตรวจสอบอินพุตขั้นพื้นฐาน รวมถึงตรวจสอบรหัสที่ซ้ำกัน
  • จัดสรรออบเจ็กต์ไคลเอ็นต์ (เช่น GetValuesClient) สําหรับการดำเนินการแต่ละรายการสําหรับไคลเอ็นต์ Binder แต่ละราย และเพิ่มแต่ละรายการลงในพูลส่วนกลาง
  • จัดการตรรกะ Callback ที่ไม่พร้อมกัน เช่น การเพิ่มคำขอที่รอดำเนินการลงในกลุ่มคำขอที่รอดำเนินการ แก้ปัญหาคําขอที่รอดําเนินการเมื่อเราได้รับผลลัพธ์หรือแสดงข้อผิดพลาดเมื่อคําขอที่รอดําเนินการรายการใดรายการหนึ่งหมดเวลา
  • ทำให้เป็นอนุกรมและดีซีเรียลไลซ์ LargeParcelable (ดู ParcelableUtils.h)
  • จัดการการสมัครใช้บริการ (ดู SubscriptionManager.h)
  • ตรวจสอบสิทธิ์ (ดูฟังก์ชัน checkReadPermission และ checkWritePermission)
  • เรียก IVehicleHardware.checkHealth เป็นระยะๆ และส่งสัญญาณชีพจร (ดูฟังก์ชัน checkHealth)

IVehicleHardware คืออินเทอร์เฟซทั่วไปที่ใช้แสดงการใช้งานเฉพาะฮาร์ดแวร์ของ VHAL การใช้งานอ้างอิงสําหรับ IVehicleHardware คือ FakeVehicleHardware ซึ่งใช้แผนที่ในหน่วยความจําเพื่อจัดเก็บค่าพร็อพเพอร์ตี้และไม่สื่อสารกับบัสยานพาหนะจริง โปรแกรมนี้มีไว้เพื่อใช้งานบนโปรแกรมจำลองและไม่มีทรัพยากรที่เจาะจงฮาร์ดแวร์ การติดตั้งใช้งานของผู้ให้บริการต้องไม่ใช้รูปแบบเดิมและต้องเพิ่มตรรกะเฉพาะสำหรับบัสของยานพาหนะ

ใน Android 14 FakeVehicleHardware จะอ่านการกําหนดค่าพร็อพเพอร์ตี้ที่รองรับขณะรันไทม์ในระหว่างการเริ่มต้นจากโฟลเดอร์ /vendor/etc/automotive/vhalconfig/ ของอุปกรณ์ ซึ่งมีไฟล์การกําหนดค่ารูปแบบ JSON ดูรูปแบบไฟล์การกําหนดค่าและเนื้อหาไฟล์การกําหนดค่าได้ที่ไฟล์ README อ้างอิง VHAL

FakeVehicleHardware ยังรองรับการลบล้างไฟล์การกําหนดค่าสําหรับการทดสอบด้วย หากตั้งค่าพร็อพเพอร์ตี้ของระบบ persist.vendor.vhal_init_value_override ไว้ ระบบจะใช้ไฟล์การกำหนดค่าจากโฟลเดอร์ /vendor/etc/automotive/vhaloverride/ ในอุปกรณ์เพื่อลบล้างการกำหนดค่าที่มีอยู่ การใช้งานของผู้ให้บริการอาจใช้แนวทางที่คล้ายกันเพื่อให้การกำหนดค่าพร็อพเพอร์ตี้ที่รองรับ VHAL ไม่ได้เป็นแบบฮาร์ดโค้ดและสามารถตัดสินใจแบบไดนามิกได้เมื่อเริ่มต้น การกำหนดค่าคุณสมบัติของรถยนต์ต้องเป็นคงที่เมื่อเริ่มใช้อุปกรณ์