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ừ khi đượ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 xác thực bằng VHAL VTS tại VtsHalAutomotiveVehicle_TargetTest.cpp.

Quy trình kiểm thử xác minh rằng các phương thức cơ bản được triển khai chính xác và cấu hình tài sản được hỗ trợ là chính xác. Quy trình kiểm thử 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 xe

Sử dụng cấu trúc VehiclePropValue để mô tả giá trị của từng thuộc tính, trong đó 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 hoàn tất thao tác lấy hoặc đặt thực 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 phân phối thông 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 luồng trình xử lý riêng để xử lý các yêu cầu 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ộ.

Các gói lớn

Tất cả cấu trúc có tên XXXs, chẳng hạn như VehiclePropConfigs, SetValueRequests và VehiclePropValues đượ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 liên kết (4 KB trong quá trình triển khai thư viện LargeParcelable) qua các ranh giới liên kết. Mỗi loại đều 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 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ì thuộc tính này sẽ lưu trữ danh sách dữ liệu thực tế, tức là cấu hình thuộc tính.
• Nếu sharedMemoryFd không rỗng, thì tệp này sẽ chứa một tệp bộ nhớ dùng chung, lưu trữ cấu trúc tuần tự của VehiclePropConfigs. Cấu trúc này sử dụng hàm writeToParcel để chuyển đổi tuần tự một Gói.

Là một ứng dụng Java cho VHAL, Dịch vụ ô tô xử lý việc chuyển đổi tuần tự và huỷ chuyển đổi tuần tự cho LargeParcelable. Đối với các triển khai VHAL và ứng dụng gốc, bạn nên chuyển đổi tuần tự và chuyển đổi tuần tự lại LargeParcelable 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 ứng dụng gốc phân tích cú pháp các yêu cầu 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à ví dụ về cách triển khai VHAL để gửi kết quả cho getValues thông qua trình 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.
}