Triển khai tham chiếu

Chúng tôi cung cấp một cách triển khai tham chiếu cho AIDL VHAL. Luồng dịch vụ chính được triển khai tại VehicleService.cpp. Cách triển khai giao diện VHAL nằm tại DefaultVehicleHal.cpp.

Cách triển khai tham chiếu dựa trên kiến trúc 2 lớp. Ở lớp trên, DefaultVehicleHal, triển khai giao diện VHAL AIDL và cung cấp logic VHAL chung cho tất cả các thiết bị phần cứng. Ở lớp dưới, FakeVehicleHardware, triển khai giao diện IVehicleHardware. Lớp này mô phỏng logic VHAL tương tác với phần cứng thực hoặc bus xe và dành riêng cho thiết bị. Ngoài ra, nhà cung cấp có thể điều chỉnh cùng một kiến trúc này, sử dụng lại cùng một lớp DefaultVehicleHal (mở rộng lớp này để ghi đè một phương thức) và cung cấp cách triển khai IVehicleHardware riêng.

Triển khai tham chiếu VHAL
Hình 1. Cách triển khai tham chiếu VHAL

DefaultVehicleHal chứa logic sau đây. Logic này được coi là chung và có thể áp dụng cho mọi cách triển khai VHAL .

  • Triển khai giao diện IVehicle.
  • Thực hiện các bước kiểm tra đầu vào cơ bản, bao gồm cả bước kiểm tra các mã nhận dạng trùng lặp.
  • Phân bổ các đối tượng máy khách (ví dụ: GetValuesClient) cho từng thao tác cho từng máy khách trình liên kết và thêm từng đối tượng vào một nhóm chung.
  • Quản lý logic gọi lại không đồng bộ, chẳng hạn như thêm một yêu cầu đang chờ xử lý vào nhóm yêu cầu đang chờ xử lý. Giải quyết các yêu cầu đang chờ xử lý khi chúng tôi nhận được kết quả hoặc trả về lỗi khi một trong các yêu cầu đang chờ xử lý hết thời gian chờ.
  • Tuần tự hoá và giải tuần tự hoá LargeParcelable (xem ParcelableUtils.h).
  • Quản lý gói thuê bao (xem SubscriptionManager.h).
  • Kiểm tra quyền. (Xem các hàm checkReadPermission và checkWritePermission ).
  • Định kỳ gọi IVehicleHardware.checkHealth và gửi tín hiệu nhịp tim (xem hàm checkHealth).

IVehicleHardware là một giao diện chung dùng để biểu thị cách triển khai dành riêng cho phần cứng của VHAL. Cách triển khai tham chiếu cho IVehicleHardware là FakeVehicleHardware, cách triển khai này sử dụng một bản đồ trong bộ nhớ để lưu trữ giá trị thuộc tính và không giao tiếp với bus xe thực. Cách triển khai này được thiết kế để chạy trên trình mô phỏng và không có các phần phụ thuộc dành riêng cho phần cứng. Cách triển khai của nhà cung cấp không được sử dụng nguyên trạng và phải thêm logic dành riêng cho bus xe.

Kể từ Android 14, FakeVehicleHardware sẽ đọc cấu hình thuộc tính được hỗ trợ tại thời gian chạy trong quá trình khởi chạy từ thư mục /vendor/etc/automotive/vhalconfig/ của thiết bị. Thư mục này chứa một tệp cấu hình theo kiểu JSON. Hãy xem tệp README VHAL tham chiếu để biết định dạng tệp cấu hình và nội dung tệp cấu hình.

FakeVehicleHardware cũng hỗ trợ ghi đè tệp cấu hình để kiểm thử. Nếu thuộc tính hệ thống persist.vendor.vhal_init_value_override được đặt (thuộc tính này phải được đặt tại thời gian xây dựng hoặc rất sớm trong quá trình khởi động trước khi khởi chạy VHAL), thì thuộc tính này sẽ sử dụng tệp cấu hình từ thư mục /vendor/etc/automotive/vhaloverride/ trên thiết bị để ghi đè cấu hình hiện có. Cách triển khai của nhà cung cấp có thể sử dụng một phương pháp tương tự để cấu hình thuộc tính được VHAL- hỗ trợ không được mã hoá cứng và có thể được quyết định một cách linh hoạt tại thời gian bắt đầu. Danh sách cấu hình thuộc tính xe phải ở trạng thái tĩnh sau khi VHAL được khởi chạy.

Kể từ Android 16, GRPCVehicleHardware cung cấp một cách triển khai IVehicleHardware tham chiếu khác. Cách triển khai này giả định rằng có một máy chủ riêng chạy trên một máy hoặc máy ảo từ xa chứa logic xử lý thuộc tính. VHAL chạy trên các thiết bị AAOS đóng vai trò là một proxy chuyển tiếp các yêu cầu đến máy chủ từ xa. Hãy xem grpc để biết thêm chi tiết.