Giao diện VHAL

VHAL AIDL được xác định trong android.hardware.automotive.vehicle namespace. Giao diện VHAL được xác định tại IVehicle.aidl. Trừ phi được chỉ định, tất cả các phương thức đều phải được triển khai cho một phiên bản VHAL cụ thể.

Phiên bản

Bạn NÊN triển khai phiên bản VHAL mới nhất cho một phiên bản Android cụ thể.

Hàm và lệnh gọi lại

Các hàm VHAL được xác định tại IVehicle.aidl.

Các lệnh gọi lại được xác định tại IVehicleCallback.aidl và chứa các phương thức này.

Việc triển khai VHAL được VTS VHAL xác thực tại VtsHalAutomotiveVehicle_TargetTest.cpp.

Bài kiểm thử này xác minh rằng các phương thức cơ bản được triển khai đúng cách và các cấu hình thuộc tính được hỗ trợ là chính xác. Thử nghiệm chạy trên tất cả các phiên bản VHAL trên thiết bị, tuy nhiên, AAOS chỉ sử dụng phiên bản mặc định (android.hardware.automotive.vehicle.IVehicle/default)

Giá trị thuộc tính của xe

Sử dụng cấu trúc VehiclePropValue để mô tả giá trị của từng thuộc tính, có các trường sau:

getValues và setValues không đồng bộ

Các thao tác getValues và setValues được thực hiện không đồng bộ, nghĩa là hàm có thể trả về trước khi thao tác nhận hoặc đặt thực tế hoàn tất. Kết quả của thao tác (ví dụ: giá trị thuộc tính cho getValues và trạng thái thành công hoặc lỗi cho setValues) được gửi qua các lệnh gọi lại được truyền dưới dạng đối số.

Quá trình triển khai không được chặn kết quả trong luồng liên kết xử lý yêu cầu. Thay vào đó, bạn nên lưu trữ yêu cầu trong hàng đợi yêu cầu và sử dụng một luồng trình xử lý riêng để xử lý các yêu cầu không đồng bộ. Hãy xem Triển khai tham chiếu để biết thông tin chi tiết.

Hình 1. Quy trình không đồng bộ.

Các đối tượng Parcelable lớn

Tất cả các cấu trúc có tên XXXs, chẳng hạn như VehiclePropConfigs, SetValueRequests và VehiclePropValues đều được gọi là LargeParcelable (hoặc StableLargeParcelable). Mỗi cấu trúc đại diện cho một danh sách các giá trị dùng để truyền dữ liệu lớn có thể vượt quá giới hạn của trình liên kết (4 KB trong quá trình triển khai thư viện LargeParcelable) trên các ranh giới của trình liên kết. Mỗi đối tượng có một định nghĩa cấu trúc tương tự chứa các trường sau.

Ví dụ: VehiclePropConfigs được xác định là:

parcelable VehiclePropConfigs {
    // The list of vehicle property configs if they fit the binder memory
    // limitation.
    VehiclePropConfig[] payloads;
    // Shared memory file to store configs if they exceed binder memory
    // limitation. Created by VHAL, readable only at client. Client could keep
    // the fd opened or keep the FD mapped to access configs.
    @nullable ParcelFileDescriptor sharedMemoryFd;
}

VehiclePropConfigs chứa tải trọng không trống hoặc sharedMemoryFd không rỗng.

• Nếu payloads không trống, thì nó sẽ lưu trữ một danh sách dữ liệu thực tế, đó là cấu hình thuộc tính.
• Nếu sharedMemoryFd không phải là giá trị rỗng, thì nó sẽ chứa một tệp bộ nhớ dùng chung, lưu trữ cấu trúc được chuyển đổi tuần tự của VehiclePropConfigs. Cấu trúc này dùng hàm writeToParcel để chuyển đổi tuần tự một Parcel.

Là một ứng dụng Java cho VHAL, Car Service xử lý quá trình tuần tự hoá và huỷ tuần tự hoá cho LargeParcelable. Đối với các hoạt động triển khai VHAL và ứng dụng gốc, LargeParcelable phải được chuyển đổi tuần tự và giải tuần tự bằng thư viện LargeParcelable hoặc một lớp trình bao bọc hữu ích cho thư viện trong ParcelableUtils.h.

Ví dụ: một yêu cầu phân tích cú pháp ứng dụng gốc cho getValues nhận được từ một liên kết như sau:

// 'requests' are from the binder.
GetValueRequests requests;
expected<LargeParcelableBase::BorrowedOwnedObject, ScopedAStatus> deserializedResults = fromStableLargeParcelable(requests);
if (deserializedResults.ok()) {
    const std::vector& getValueRequests = deserializedResults.value().getObject()->payloads;
    // Use the getValueRequests.
  } else {
    // handle error.
}

Dưới đây là một ví dụ về hoạt động triển khai VHAL gửi kết quả cho getValues thông qua liên kết:

std::vector results = getResults();
GetValueResults parcelableResults;
ScopedAStatus status = vectorToStableLargeParcelable(std::move(results), &parcelableResults);
if (status.isOk()) {
    // Send parcelableResults through callback.
} else {
    // Handle error.
}