giao diện VHAL

AIDL VHAL được định nghĩa 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ả các phương pháp phải được thực hiện.

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

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

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

Giá trị tài sản 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 get hoặc set thực tế hoàn tất. Kết quả hoạt động (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 chuyển dưới dạng đối số.

Việc triển khai không được chặn kết quả trong chuỗi liên kết xử lý yêu cầu. Thay vào đó, chúng tôi khuyên 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 chuỗi xử lý riêng để xử lý các yêu cầu một cách không đồng bộ. Xem phần Triển khai tham khảo để biết chi tiết.

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

Bưu kiện 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 giá trị đại diện cho một danh sách các giá trị được sử dụng để truyền dữ liệu lớn có thể vượt quá giới hạn liên kết (4KB trong triển khai thư viện LargeParcelable ) qua các ranh giới liên kết. Mỗi cái có một định nghĩa cấu trúc tương tự bao gồm 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 tải trọng không trống hoặc sharedMemoryFd không rỗng.

• Nếu payloads không trống, nó sẽ lưu 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ó chứa tệp bộ nhớ dùng chung lưu trữ cấu trúc được tuần tự hóa của VehiclePropConfigs . Cấu trúc sử dụng hàm writeToParcel để tuần tự hóa một Bưu kiện.

Là một máy khách Java cho VHAL, Car Service xử lý việc tuần tự hóa và giải tuần tự hóa cho LargeParcelable . Đối với các triển khai VHAL và máy khách gốc, một LargeParcelable phải được tuần tự hóa và giải tuần tự hóa 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ụ: các yêu cầu phân tích cú pháp của máy khách gốc cho getValues ​​nhận được từ chất kết dính như sau:

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

Một triển khai VHAL mẫu gửi kết quả cho getValues ​​thông qua chất kết dính đượ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.
}