ממשק VHAL

ממשק AIDL VHAL מוגדר ב-android.hardware.automotive.vehicle namespace. ממשק VHAL מוגדר בכתובת IVehicle.aidl. אלא אם צוין אחרת, צריך להטמיע את כל השיטות עבור גרסה ספציפית של VHAL.

גרסאות

מומלץ להטמיע את הגרסה האחרונה של VHAL לגרסה ספציפית של Android.

פונקציות וקריאות חוזרות

הפונקציות של VHAL מוגדרות בכתובת IVehicle.aidl.

הפונקציות ל-callback מוגדרות ב-IVehicleCallback.aidl והן כוללות את ה-methods האלה.

ההטמעה של VHAL מאומתת על ידי VHAL VTS בכתובת VtsHalAutomotiveVehicle_TargetTest.cpp.

הבדיקה מוודאת שהשיטות הבסיסיות הוטמעו בצורה נכונה ושההגדרות של הנכס הנתמך נכונות. הבדיקה מופעלת מול כל המופעים של VHAL במכשיר, אבל AAOS משתמש רק במופע ברירת המחדל (android.hardware.automotive.vehicle.IVehicle/default)

ערך מאפיין הרכב

משתמשים במבנה VehiclePropValue כדי לתאר את הערך של כל מאפיין, שכולל את השדות הבאים:

הפונקציות האסינכרוניות getValues ו-setValues

הפעולות getValues ו-setValues מתבצעות באופן אסינכרוני, כלומר הפונקציה עשויה להחזיר ערך לפני שהפעולה בפועל של קבלת או הגדרת הערך הושלמה. תוצאות הפעולה (לדוגמה, ערך הנכס עבור getValues או סטטוס ההצלחה או השגיאה עבור setValues) מועברות באמצעות פונקציות הקריאה החוזרת שמועברות כארגומנטים.

ההטמעה לא יכולה לחסום את התוצאה בשרשור של ה-Binder שמטפל בבקשה. במקום זאת, מומלץ לאחסן את הבקשה בתור בקשות ולהשתמש בשרשור נפרד של handler כדי לטפל בבקשות באופן אסינכרוני. פרטים נוספים זמינים במאמר בנושא הטמעה לדוגמה.

איור 1. תהליך אסינכרוני.

‫parcelable גדולים

כל המבנים שנקראים XXXs, כמו VehiclePropConfigs,‏ SetValueRequests ו-VehiclePropValues, נקראים LargeParcelable (או StableLargeParcelable). כל אחד מהם מייצג רשימה של ערכים שמשמשים להעברת נתונים גדולים שעשויים לחרוג מהמגבלות של Binder (4KB בהטמעה של ספריית LargeParcelable) מעבר לגבולות של Binder. לכל אחד מהם יש הגדרת מבנה דומה שכוללת את השדות הבאים.

לדוגמה, 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 שאינו null.

• אם payloads לא ריק, הוא מכיל רשימה של הנתונים בפועל, שהם הגדרות הנכס.
• אם sharedMemoryFd לא ריק, הוא מכיל קובץ של זיכרון משותף, שבו מאוחסנת התבנית הסדרתית של VehiclePropConfigs. המבנה משתמש בפונקציה writeToParcel כדי לבצע סריאליזציה של Parcel.

בתור לקוח Java של 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.
}