Giao diện VHAL

AIDL VHAL đượ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ả 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.

Quá trình triển khai VHAL được VHAL VTS 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. Bài kiểm thử này chạy trên tất cả các thực thể VHAL trên thiết bị, tuy nhiên, AAOS chỉ sử dụng thực thể 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 một cách 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ả 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 trình 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 một cách không đồng bộ. Hãy xem phần Triển khai tham chiếu để biết thông tin chi tiết.

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

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ị được dùng để truyền dữ liệu lớn có thể vượt quá các giới hạn của trình liên kết (4KB 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 cấu trúc có định nghĩa cấu trúc tương tự chứa các trường sau.

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

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 các tải trọng không trống hoặc không rỗngsharedMemoryFd.

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

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

Ví dụ: ứng dụng gốc phân tích cú pháp các yêu cầu cho getValues nhận được từ trình 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ề quá trình triển khai VHAL gửi kết quả cho getValues thông qua trình liên kết là được hiển thị bên dưới:

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