Giao diện VHAL

VHAL AIDL được định nghĩa 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.

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

Để biết thêm thông tin, hãy xem IXe.aidl và IXeCallback.aidl.

Việc triển khai VHAL được xác thực bởi VHAL VTS tại VtsHalAutomotiveXe_TargetTest.cpp. Thử nghiệm xác minh rằng các phương thức cơ bản được triển khai đúng cách và thuộc tính được hỗ trợ cấu hình là chính xác.

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

Sử dụng VehiclePropValue cấu trúc này để mô tả giá trị của mỗi thuộc tính, bao gồm các trường sau:

Các getValues và setValue không đồng bộ

Các thao tác getValues và setValues được thực hiện không đồng bộ, tức là hàm có thể trả về trước khi thao tác get hoặc set 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à thành công hoặc trạng thái lỗi của setValues) được gử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 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ộ. Xem Triển khai tham chiếu cho chi tiết.

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

Gói hàng có kích thước 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 LargeParcelable (hoặc StableLargeParcelable). Mỗi loại đạ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 liên kết (4KB trong LargeParcelable) qua ranh giới liên kết. Mỗi công cụ đều có định nghĩa cấu trúc chứa các trường sau.

Ví dụ: VehiclePropConfigs được định nghĩa 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 các tải trọng không trống hoặc không rỗng sharedMemoryFd

• Nếu payloads không trống, lệnh này sẽ lưu trữ một danh sách các dữ liệu thực tế, cấu hình thuộc tính.
• Nếu sharedMemoryFd khác rỗng, thì tệp này chứa một tệp bộ nhớ dùng chung có chức năng lưu trữ cấu trúc chuyển đổi 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 Bưu kiện.

Là một ứng dụng Java cho VHAL, Car Service xử lý quá trình chuyển đổi tuần tự và huỷ chuyển đổi tuần tự cho LargeParcelable. Đối với việc 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 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.
}

Quá trình triển khai VHAL mẫu sẽ 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.
}