VHAL इंटरफ़ेस

एआईडीएल वीएचएएल को android.hardware.automotive.vehicle namespace में तय किया गया है. वीएचएएल इंटरफ़ेस को IVehicle.aidl में तय किया गया है. जब तक कोई खास जानकारी न दी गई हो, तब तक किसी खास वीएचएएल वर्शन के लिए सभी तरीकों को लागू करना ज़रूरी है.

वर्शन

हमारा सुझाव है कि किसी खास Android वर्शन के लिए, वीएचएएल का नया वर्शन लागू करें.

फ़ंक्शन और कॉलबैक

वीएचएएल फ़ंक्शन को IVehicle.aidl में तय किया गया है.

कॉलबैक को IVehicleCallback.aidl में तय किया गया है. इनमें ये तरीके शामिल हैं.

वीएचएएल के लागू होने की पुष्टि, वीएचएएल वीटीएस से की जाती है VtsHalAutomotiveVehicle_TargetTest.cpp.

टेस्ट से पुष्टि होती है कि बुनियादी तरीके सही तरीके से लागू किए गए हैं और इस्तेमाल की जा सकने वाली प्रॉपर्टी के कॉन्फ़िगरेशन सही हैं. टेस्ट, डिवाइस पर मौजूद वीएचएएल के सभी इंस्टेंस के ख़िलाफ़ चलता है. हालांकि, AAOS सिर्फ़ डिफ़ॉल्ट इंस्टेंस (android.hardware.automotive.vehicle.IVehicle/default) का इस्तेमाल करता है

वाहन की प्रॉपर्टी की वैल्यू

VehiclePropValue स्ट्रक्चर का इस्तेमाल करके, हर प्रॉपर्टी की वैल्यू के बारे में बताया जाता है. इसमें ये फ़ील्ड होते हैं:

एसिंक्रोनस तरीके से getValues और setValues का इस्तेमाल करना

getValues और setValues कार्रवाइयां एसिंक्रोनस तरीके से की जाती हैं, इसका मतलब है कि असल वैल्यू पाने या सेट करने की कार्रवाई पूरी होने से पहले, फ़ंक्शन वैल्यू दिखा सकता है. कार्रवाई के नतीजे (उदाहरण के लिए, getValues के लिए प्रॉपर्टी की वैल्यू और गड़बड़ी वाला स्टेटस setValues के लिए), आर्ग्युमेंट के तौर पर पास किए गए कॉलबैक के ज़रिए डिलीवर किए जाते हैं.

अनुरोध को हैंडल करने वाले बाइंडर थ्रेड में, नतीजे के आधार पर लागू करने की प्रोसेस को ब्लॉक नहीं किया जाना चाहिए. इसके बजाय, हमारा सुझाव है कि आप अनुरोध को अनुरोध की लाइन में सेव करें और अनुरोधों को एसिंक्रोनस तरीके से हैंडल करने के लिए, अलग हैंडलर थ्रेड का इस्तेमाल करें. ज़्यादा जानकारी के लिए, रेफ़रंस के तौर पर लागू करने की प्रोसेस देखें.

पहली इमेज. एसिंक्रोनस प्रोसेस.

बड़े पार्सल वाले स्ट्रक्चर

XXXs नाम वाले सभी स्ट्रक्चर, जैसे कि VehiclePropConfigs, SetValueRequests, और VehiclePropValues को LargeParcelable (या, StableLargeParcelable) कहा जाता है. हर स्ट्रक्चर, वैल्यू की एक सूची दिखाता है. इसका इस्तेमाल, बड़े डेटा को पास करने के लिए किया जाता है. यह डेटा, बाइंडर की सीमाओं (LargeParcelable लाइब्रेरी के लागू होने पर 4 केबी) से ज़्यादा हो सकता है. इसे बाइंडर की सीमाओं के पार भेजा जा सकता है. हर स्ट्रक्चर की परिभाषा एक जैसी होती है. इसमें ये फ़ील्ड शामिल होते हैं.

उदाहरण के लिए, 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 फ़ंक्शन का इस्तेमाल करता है.

वीएचएएल के लिए Java क्लाइंट के तौर पर, Car Service, क्रम से लगाने और क्रम से हटाने की प्रोसेस को हैंडल करता है LargeParcelable. वीएचएएल के लागू होने और नेटिव क्लाइंट के लिए, LargeParcelable को LargeParcelable लाइब्रेरी या ParcelableUtils.h में मौजूद लाइब्रेरी के लिए काम की रैपर क्लास के साथ क्रम से लगाया और क्रम से हटाया जाना चाहिए.

उदाहरण के लिए, बाइंडर से मिले getValues के अनुरोधों को पार्स करने वाला नेटिव क्लाइंट इस तरह काम करता है:

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

वीएचएएल के लागू होने का एक उदाहरण यहां दिया गया है. इसमें बाइंडर के ज़रिए getValues के नतीजे भेजे जाते हैं यहां दिखाया गया है:

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