رابط VHAL

AIDL VHAL در android.hardware.automotive.vehicle namespace تعریف شده است. رابط VHAL در IVehicle.aidl تعریف شده است. مگر اینکه مشخص شده باشد، همه روش ها باید برای یک نسخه VHAL خاص اجرا شوند.

نسخه ها

توصیه می شود آخرین نسخه VHAL را برای یک نسخه اندروید خاص پیاده سازی کنید.

توابع و تماس ها

توابع VHAL در IVehicle.aidl تعریف شده اند.

تماس‌های برگشتی در IVehicleCallback.aidl تعریف شده‌اند و حاوی این روش‌ها هستند.

اجرای VHAL توسط VHAL VTS در VtsHalAutomotiveVehicle_TargetTest.cpp تأیید شده است.

آزمایش تأیید می‌کند که روش‌های اصلی به درستی پیاده‌سازی شده‌اند و پیکربندی‌های ویژگی پشتیبانی شده درست هستند. آزمایش بر روی تمام نمونه‌های VHAL روی دستگاه اجرا می‌شود، اما AAOS فقط از نمونه پیش‌فرض استفاده می‌کند ( android.hardware.automotive.vehicle.IVehicle/default )

ارزش اموال خودرو

از ساختار VehiclePropValue برای توصیف مقدار هر ویژگی استفاده کنید که دارای این فیلدها است:

getValues ​​و setValues ​​ناهمزمان

عملیات getValues ​​و setValues ​​به صورت ناهمزمان انجام می شوند، به این معنی که این تابع ممکن است قبل از تکمیل عملیات واقعی get یا set برگردد. نتایج عملیات (به عنوان مثال، مقدار ویژگی برای getValues ​​و وضعیت موفقیت یا خطا برای setValues ) از طریق تماس‌های برگشتی به عنوان آرگومان ارسال می‌شوند.

پیاده سازی نباید نتیجه را در رشته بایندر که درخواست را مدیریت می کند مسدود کند. در عوض، توصیه می کنیم درخواست را در یک صف درخواست ذخیره کنید و از یک رشته کنترل کننده جداگانه برای رسیدگی به درخواست ها به صورت ناهمزمان استفاده کنید. برای جزئیات به پیاده سازی مرجع مراجعه کنید.

شکل 1. فرآیند ناهمزمان.

بسته بندی های بزرگ

تمام ساختارهایی با نام XXXs ، مانند VehiclePropConfigs ، SetValueRequests ، و VehiclePropValues LargeParcelable (یا StableLargeParcelable ) نامیده می شوند. هر کدام فهرستی از مقادیر مورد استفاده برای ارسال داده های بزرگ را نشان می دهد که ممکن است از محدودیت های کلاسور (4 کیلوبایت در اجرای کتابخانه LargeParcelable ) در سراسر مرزهای کلاسور فراتر رود. هر کدام یک تعریف ساختار مشابه دارند که شامل فیلدهای زیر است.

به عنوان مثال، VehiclePropConfigs به صورت زیر تعریف می شود:

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 شامل بارهای غیر خالی یا یک sharedMemoryFd غیر تهی است.

• اگر payloads خالی نباشد، فهرستی از داده‌های واقعی را ذخیره می‌کند که پیکربندی ویژگی است.
• اگر sharedMemoryFd تهی نباشد، حاوی یک فایل حافظه مشترک است که ساختار سریال VehiclePropConfigs را ذخیره می کند. این ساختار از تابع writeToParcel برای سریال سازی یک بسته استفاده می کند.

به عنوان یک مشتری جاوا برای VHAL، Car Service سریال‌سازی و سریال‌سازی را برای LargeParcelable انجام می‌دهد. برای پیاده سازی های VHAL و کلاینت های بومی، یک LargeParcelable باید با کتابخانه LargeParcelable یا یک کلاس Wrapper مفید برای کتابخانه در ParcelableUtils.h سریال شود و از سریال خارج شود.

به عنوان مثال، درخواست‌های تجزیه‌کننده یک کلاینت بومی برای getValues ​​که از یک binder دریافت می‌شود، به شرح زیر است:

// '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.
}

نمونه ای از پیاده سازی VHAL که نتایج را برای getValues ​​از طریق binder ارسال می کند در زیر نشان داده شده است:

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