خصائص النظام المتوافقة

تسرد هذه الصفحة خصائص النظام المتوافقة في VHAL. الخصائص المتوافقة مع VHAL يجب أن يكون إما خاصية نظام من القائمة أدناه أو خاصية مورّد. في Android 14 أعلى، يتم تحديد تعريفات الخصائص hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl

يتم تعريف السمة في واجهة AIDL، android.hardware.automotive.vehicle.property، وهي منفصلة عن VHAL (android.hardware.automotive.vehicle). عمليات تنفيذ VHAL وVHAL أن يعتمد العملاء على كلتا الواجهتين.

أوضاع الوصول المُنشأة تلقائيًا وتغيير الأوضاع

في نظام التشغيل Android 14 والإصدارات الأحدث، لدعم عمليات تنفيذ VHAL، نقدّم ملفات يتم إنشاؤها تلقائيًا عنوان C++ الملفات ملفات فئة Java مع وضع التغيير المسموح به أو وضع الوصول لخصائص النظام. عمليات تنفيذ VHAL للمورّد استخدامها للتأكّد من أن إعدادات الموقع تلبي المواصفات.

أ إلى ي

ADAPTIVE_CRUISE_control_LEAD_VEHICLE_MEASURED_DISTANCE

تم قياس المسافة التي تم قياسها من المركبة الرائدة عند استخدام "التحكّم التكيّفي في السرعة" (ACC) أو ميزة "التوقّعات". التحكّم في السرعة (PCC). عرض المسافة التي تم قياسها بالملليمتر بين النقطة الخلفية للمركبة الرائدة والنقطة الأمامية في مركبة ACC. maxInt32Value وminInt32Value في VehicleAreaConfig يجب تحديدهما. تشير رسالة الأشكال البيانية يجب أن تكون قيمة minInt32Value 0. يجب ملء maxInt32Value بـ أقصى نطاق يمكن أن يتيحه جهاز استشعار المسافة يجب أن تكون هذه القيمة غير سالبة.

عندما لا يتم رصد أي مركبة رئيسية (أي في حال عدم وجود مركبة قيادية أو المركبة بعيدة جدًا بحيث لا يمكن أن ترصده أداة الاستشعار)، يجب إرجاع هذه السمة StatusCode.NOT_AVAILABLE

عندما لا تكون هذه السمة متاحة بسبب إيقاف ميزة "نسخة إلى" (على سبيل المثال، StatusCode#NOT_AVAILABLE_DISABLED خطأ)، ويجب عرض هذه السمة. StatusCode#NOT_AVAILABLE_DISABLED إذا CRUISE_CONTROL_STATE ويتم ضبط الحالة على القيمة ErrorState، تكون هذه السمة يجب أن تعرض القيمة StatusCode التي تتوافق مع القيمة ErrorState. بالنسبة مثلاً، إذا تم ضبط CRUISE_CONTROL_STATE على ErrorState#NOT_AVAILABLE_SPEED_LOW، ثم يجب عرض هذه السمة. StatusCode#NOT_AVAILABLE_SPEED_LOW

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MILLIMETER
الإصدار: Android 14

ADAPTIVE_CRUISE_Control_TARGET_TIME_GAP

الفجوة الزمنية الحالية المستهدفة في ACC أو PCC بالمللي ثانية. يجب أن تحدد هذه الخاصية السمة الفجوة الزمنية المستهدفة لمركبة رائدة. وتُعرف هذه الفجوة بأنها وقت لقطع المسافة بين النقطة في أقصى الجزء الخلفي للمركبة الرئيسية وبين النقطة الأمامية لمركبة التحكم في الوصول المباشر. القيمة الفعلية يمكن أن تكون الفاصل الزمني لمركبة رائدة أعلى أو أقل من هذه القيمة.

يجب تحديد القيم المحتملة للفجوة الزمنية المستهدفة في configArray في ترتيبًا تصاعديًا. يجب أن تكون جميع القيم موجبة. إذا كانت الملكية قابلة للكتابة، فيجب أن تكون جميع القيم قابلة للكتابة. عندما لا تكون هذه السمة متاحة بسبب إيقاف ميزة "نسخة إلى" (على سبيل المثال، CRUISE_CONTROL_ENABLED خطأ)، ويجب عرض هذه السمة. StatusCode#NOT_AVAILABLE_DISABLED

في حال تنفيذ CRUISE_CONTROL_STATE وضبط الحالة على ErrorState، ثم يجب أن تعرض هذه السمة قيمة StatusCode يتوافق مع القيمة ErrorState. على سبيل المثال: إذا تم ضبط CRUISE_CONTROL_STATE على ErrorState#NOT_AVAILABLE_SPEED_LOW، يجب أن تعرض هذه السمة السمة StatusCode#NOT_AVAILABLE_SPEED_LOW.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة إجراء ذلك. يمكنك تنفيذها من خلال حساب VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MILLI_SECS
الإصدار: Android 14

ABS_ACTIVE

نظام المكابح التلقائي (ABS) مفعَّل. يتم ضبطها على "صحيح" عندما تكون ABS نشطة إعادة الضبط على خطأ عند إيقاف تشغيل ABS. يمكن ضبط هذه السمة بشكل متقطع (النبض) استنادًا إلى حالة نظام ABS في الوقت الفعلي.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

ANDROID_EPOCH_TIME

التاريخ والوقت الحاليان، مشفّران كوقت الحقبة (بالمللي ثانية) تشير هذه القيمة إلى عدد بالمللي ثانية التي انقضت منذ 1/1/1970 بالتوقيت العالمي المنسق.

تشير هذه القيمة إلى عدد الثواني بالمللي ثانية التي انقضت منذ 1/1/1970 بالتوقيت العالمي المنسق. WRITEs إلى هذه القيمة لمنح VHAL وقت نظام Android، إذا كان VHAL. تتيح هذه السمة استخدام هذه السمة. وقد يفيد ذلك في مزامنة أنظمة المركبات الأخرى (ساعة لوحة القيادة) مع وقت Android.

WRITE نظام AAOS إلى هذا الموقع مرة واحدة أثناء التشغيل، وبعد ذلك WRITE عند نشر التغييرات في مصدر الوقت فقط سيملأ نظام التشغيل Android (AAOS) الطابع الزمني للمركبة PropValue.timestamp. بشكل صحيح. لا يرسل نظام التشغيل Android Automotive التعديلات المتعلقة بالانقضاء الطبيعي. int64Values[0] = تم توفير نظام التشغيل Unix الوقت (بالمللي ثانية).

قد يستغرق نشر الخاصية من خلال المكدس أكثر من 0 ملي ثانية، مع وجود تساعد السمة ذات الطابع الزمني في تقليل أي انحراف زمني. وبالتالي، بالنسبة إلى كل WRITE في الموقع، ويمكن استخدام الطابع الزمني لإلغاء هذا الانخفاض:

drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MILLI_SECS
الإصدار: Android 13

AP_POWER_BOOTUP_REASON

موقع للإبلاغ عن سبب تشغيل الطاقة الحالية. هذا الموقع الإلكتروني على STATIC. لن تتغيّر طوال المدة إلى أن يتم إيقاف التشغيل. على سبيل المثال، حتى إذا ضغط المستخدم زر التشغيل بعد التشغيل التلقائي مع فتح قفل الباب، يجب أن يظل سبب التمهيد مع يجب أن يكون VehicleApPowerBootupReason#USER_UNLOCK int32Values[0] VehicleApPowerBootupReason

تغيير الوضع: STATIC
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

تقرير AP_POWER_state_REPORT

خاصية للإبلاغ عن حالة طاقة معالج التطبيقات. يفترض أن حالة طاقة نقطة الوصول هي وحدة التحكم في الطاقة بواسطة وحدة تحكم طاقة منفصلة.

• قيمة تعداد AutomotiveApPowerStateReport في int32Values[0]
• int32Values[1] الوقت بالمللي ثانية للاستيقاظ، إذا لزم الأمر (وإلا 0)

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

AP_POWER_state_REQ

خاصية للتحكم في حالة طاقة معالج التطبيقات. يفترض أن حالة طاقة نقطة الوصول هي والتحكم فيه وحدة تحكم طاقة منفصلة. للحصول على معلومات الضبط يجب أن يحتوي VehiclePropConfig.configArray على علامة بت تجمع بين القيم في VehicleApPowerStateConfigFlag

• قيمة تعداد AutomotiveApPowerStateReq int32Values[0]
• int32Values[1] معلَمة إضافية ذات صلة بكل حالة، وتكون 0 في حال عدم استخدامها.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

autoMATIC_EMERGENCY_BRAKING_enabled

تفعِّل هذه الميزة أو أوقِفها. يمكنك ضبط القيمة "صحيح" لتفعيل AEB وعلى "خطأ" لإيقاف AEB. عند تفعيل AEB، يتم تشغيل نظام ADAS في تشغيل المركبة ومراقبتها لتجنب الاصطدامات المحتملة. يجب أن تتقدم بطلب انضمام إلى التطبيقات عالية السرعة فقط. لتفعيل نظام المكابح التلقائي منخفض السرعة، يجب استخدام LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED.

بشكل عام، يجب أن تعرض الدالة AUTOMATIC_EMERGENCY_BRAKING_ENABLED دائمًا القيمة true أو false. إذا كانت الميزة غير متاحة بسبب حالة مؤقتة، مثلاً سرعة المركبة كبيرة جدًا منخفضة، يجب نقل هذه المعلومات من خلال قيم ErrorState في الموقع الإلكتروني AUTOMATIC_EMERGENCY_BRAKING_STATE.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذ هذه الميزة على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

حالة الجهاز التلقائي

حالة مكابح الطوارئ التلقائية (AEB). تعرض حالة AEB الحالية. يجب أن يكون هذا الموقع دائمًا بإرجاع حالة صالحة محددة في autoVideoBrakingState أو ErrorState يجب ألا يعرض الرمز أخطاء من خلال StatusCode ويجب أن يستخدم حالات الخطأ المتوافقة. بدلاً من ذلك. يجب أن تنطبق هذه السمة على التطبيقات ذات السرعة العالية فقط. لتمثيل الولاية لنظام المكابح التلقائي منخفض السرعة، يجب استخدام LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE.

إذا تضمنت AEB تحذيرات من تصادمات أمامية قبل تشغيل المكابح، يجب أن تكون هذه التحذيرات من خلال خصائص تحذير الاصطدام الأمامي (FCW).

بالنسبة إلى رقم تعريف المنطقة العالمية (0)، يجب عرض سمة StatusCode#VehicleAreaConfig#supportedEnumValues يجب تحديد المصفوفة ما لم يتم تحديد جميع حالات AutomaticEmergencyBrakingState (بما في ذلك OTHER، وهو إجراء لا يُنصح به) وErrorState هما

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع Enun: ForwardCollisionWarningState/ErrorState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

BLIND_SPOT_WARNING_enabled

تفعيل وإيقاف تحذير النقطة العمياء (BSW) اضبط "صحيح" لتفعيل BSW وعلى "خطأ" لإيقاف BSW. عند تفعيل نظام BSW، يجب تشغيل نظام ADAS في المركبة، وتتبّع الكائنات في المناطق العمياء في المركبة.

بشكل عام، يجب أن تعرض الدالة BLIND_SPOT_WARNING_ENABLED دائمًا القيمة true أو false. إذا كانت هذه الميزة غير متوفرة بسبب بعض الحالات المؤقتة، مثلاً انخفاض سرعة المركبة بدرجة كبيرة، يجب نقل هذه المعلومات من خلال قيم ErrorState في الموقع الإلكتروني BLIND_SPOT_WARNING_STATE.

ويُشار إلى هذه السمة بأنّها VehiclePropertyAccess.READ_WRITE. ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذ هذه الإجراءات على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

حالة BLIND_SPOT_تحذير

حالة تحذير النقطة العمياء (BSW). تعرض الحالة الحالية لـ BSW. يجب أن يكون هذا الموقع دائمًا عرض حالة صالحة محددة في BlindSpotWarningState أو ErrorState يجب ألا يعرض هذا الرمز أي أخطاء من خلال StatusCode، ويجب أن يستخدم حالات الخطأ المتوافقة. بدلاً من ذلك.

StatusCode#VehicleAreaConfig#supportedEnumValues لكل رقم تعريف منطقة متاح يجب تحديد المصفوفة ما لم يتم تحديد جميع حالات كل من BlindSpotWarningState (بما في ذلك يُسمح باستخدام السمة OTHER، وهو إجراء لا ننصح به) وErrorState.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: BlindSpotWarningState/ErrorState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

حالة CABIN_LIGHTS_state

تعرض هذه السمة حالة أضواء المقصورة.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleLightState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

لوحة مفاتيح_CABIN_LIGHTS_SWITCH

مفتاح الإضاءة في المقصورة. موضع المفتاح الخارجي الذي يتحكّم في مصابيح المقصورة. قد يختلف هذا عن CABIN_LIGHTS_STATE إذا كانت الأضواء مضاءة لأن الباب مفتوحًا أو بسبب طلب صوتي. على سبيل المثال، عندما يكون مفتاح التبديل في الوضع إيقاف أو التلقائي.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذ هذه الميزة على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleLightSwitch
نوع الوحدة: لا ينطبق
الإصدار: Android 13

حالة_الإعلانات_ فقط

تغير حالة عرض المجموعة.

• الحدود: المساحة التي يتم عرض نشاط المجموعة العنقودية فيها.
• المساحة الداخلية: المنطقة التي يجب ألا يحتوي فيها النشاط على معلومات مهمة.

القيم المحتملة:

• int32[0] تفعيل، إيقاف: 0 - إيقاف، 1 - مفعّل، -1 - لا يهم
• int32[1] الحدود - لليسار: رقم موجب - الموضع الأيسر بالبكسل -1 - لا يهم (يجب تعيين جميع حقول الحدود)
• int32[2] حدود - أعلى: التنسيق نفسه مع "اليسار"
• int32[3] حدود - يمين: نفس التنسيق مع "يسار"
• int32[4] حدود - أسفل: التنسيق نفسه مع "يسار"
• int32[5] المساحة الداخلية - اليسار: رقم موجب - القيمة الفعلية للإدخال الأيسر بالبكسل -1 - لا يهم (يجب ضبط "لا أهتم" في جميع حقول الإدخال الداخلية)
• إدراج int32[6] - أعلى: التنسيق نفسه مع "اليسار"
• إدراج int32[7] - اليمين: التنسيق نفسه مع "اليسار"
• إدراج int32[8] - أسفل: التنسيق نفسه مع "اليسار"

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

حالة_الحظر

تُعلِم هذه السياسة حالة التنقّل. بايت: الرسالة المتسلسلة لـ NavigationStateProto.

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد:
نوع الوحدة: لا ينطبق
الإصدار: Android 13

مستوى_الإبلاغ_عن_وضع_التقرير

تعمل هذه السياسة على الإبلاغ عن حالة العرض الحالية وحالة المجموعة. يرسل ClusterHome هذه الرسالة عند التعامل مع CLUSTER_SWITCH_UI، CLUSTER_DISPLAY_STATE بالإضافة إلى ذلك، على "ClusterHome" إرسال هذا رسالة عند تشغيلها لأول مرة. عندما يتلقى نظام التشغيل ClusterOS هذه الرسالة، وإذا كان والتوقعات الداخلية مختلفة عن الرسالة المستلمة، فينبغي أن ترسل CLUSTER_SWITCH_UI، CLUSTER_DISPLAY_STATE مرة أخرى لمطابقة الولاية.

• تفعيل/إيقاف int32[0]: 0 - إيقاف، 1 - تفعيل
• int32[1] أرطال - يسار
• int32[2] أرطال - الأعلى
• int32[3] أرطال - يمين
• int32[4] أرطال - الأسفل
• مساحة داخلية واحدة (int32[5]) - يسار
• إدراج int32[6] داخلي - الأعلى
• صورة داخلية واحدة (int32[7]) - اليمين
• صورة داخلية واحدة (int32[8]) - الأسفل
• int32[9] نوع ClusterUI في وضع ملء الشاشة أو الشاشة الرئيسية. 0 يشير إلى ClusterHome ويتبع تعريف المصنّع الأصلي للجهاز القيم الأخرى.
• int32[10] نوع ClusterUI في الشاشة الفرعية في حال عرض واجهتَي المستخدم حاليًا يشير الرقم -1 إلى أن المنطقة لم تعد مستخدمة. بايت: الصفيفة لتمثيل توفر واجهة المستخدم العنقودية. يُشير الرقم 0 إلى أنّه غير متوفّر، ويشير الرقم 1 إلى توفّر السمة. على سبيل المثال، إذا كانت سيارة تتوفر ثلاثة عناصر ClusterUI محددة من قبل المصنّع الأصلي للجهاز مثل Home وMAPS وCALL، ولا تدعم سوى واجهة المستخدم CALL فقط عند توفُّر شبكة الجوّال. بعد ذلك، إذا كانت الشبكة الفرعية متاحة، ترسل [1 1 1] وفي حال كانت خارج الشبكة، يتم إرسال [1 1 0].

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: VehicleLightSwitch
نوع الوحدة: لا ينطبق
الإصدار: Android 13

COUNT_REQUEST_DISPLAY

طلبات لتغيير حالة عرض المجموعة لإظهار بعض واجهة المستخدم العنقودية. عندما تظهر الشاشة الحالية هذه الحالة غير مفعّلة ويرسل "ClusterHome" هذه الرسالة إلى نظام التشغيل ClusterOS لطلب تفعيل الشاشة لإظهار ClusterUI معينة. يجب أن يستجيب ClusterOS لهذا من خلال CLUSTER_DISPLAY_STATE

• int32 نوع واجهة المستخدم العنقودية المطلوب عرضه

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

واجهة المستخدم الجماعي

يؤدي هذا الخيار إلى بدء واجهة ClusterUI في العرض العنقودي.

• int32 يشير نوع ClusterUI المعروض 0 إلى ClusterHome، الرئيسية لعرض المجموعة، وتوفر واجهة المستخدم الافتراضية ونوعًا لوظيفة المشغل لشاشة المجموعة. وتكون القيم الأخرى متوافقة مع تعريف المصنّع الأصلي للجهاز.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

CREATE_USER

يتم استدعاء هذا الجهاز من خلال نظام Android بعد إنشاء مستخدم Android. يمكن أن تستخدم قناة HAL هذه السمة لإنشاء مستخدم مكافئ لها. هذا طلب غير متزامن: ينشئ Android الطلب من خلال تعيين يجب أن يستجيب AutomotivePropValue وHAL بإجراء تغيير في الخصائص يشير إلى ما إذا كان الطلب نجحت أو فشلت. وفي حال تعذَّر ذلك، يزيل نظام Android المستخدم.

يتم تحديد تنسيق الطلب عن طريق CreateUserRequest وتنسيق الرد من خلال CreateUserResponse. فعلى سبيل المثال، إذا كان النظام به مستخدمان (0 و10) ومستخدم ثالث (وهو الضيف المؤقت)، فسيكون الطلب على النحو التالي:

• int32[0] 42 // رقم تعريف الطلب
• int32[1] 11 // رقم تعريف Android للمستخدم الذي تم إنشاؤه
• int32[2] 6 // علامات Android (ضيف مؤقت) للمستخدم الذي تم إنشاؤه
• int32[3] 10 // المستخدم الحالي
• int32[4] 0 // عمليات إبلاغ المستخدم الحالي (بدون)
• int32[5] 3 // عدد المستخدمين
• int32[6] 0 // المستخدم الأول (المستخدم 0)
• int32[7] 0 // عمليات الإبلاغ من المستخدم الجديد (لا شيء)
• int32[8] 10 // مستخدم ثانية (المستخدم 10)
• int32[9] 0 // علامات المستخدم الثانية (لا شيء)
• int32[10] 11 // المستخدم الثالث (المستخدم 11)
• int32[11] 6 // سلسلة عمليات إبلاغ المستخدم الثالث (الضيف المؤقت): "ElGuesto" // اسم المستخدم الجديد

إذا نجح الطلب، تعرض HAL ما يلي:

• int32[0] 42 // رقم تعريف الطلب
• int32[1] 1 // CreateUserStatus::Success

ولكن إذا فشلت:

• int32[0] 42 // رقم تعريف الطلب
• int32[1] 2 // CreateUserStatus::FAILURE string: "D'OH!" //

المعنى هو مربع أسود ويتم تمريره إلى المتصل (مثل واجهة مستخدم الإعدادات)، والذي يأخذ الإجراء المناسب.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

CRITicalLY_LOW_TIRE_PRESSURE

وتشير هذه السمة إلى حدّ الضغط المنخفض جدًا لكل إطار. إنه يشير إلى متى لاستبدال إطاره أو إصلاحه. يجب أن تكون القيمة أقل من قيمة minFloatValue أو مساوية لها. في TIRE_PRESSURE. يجب تنفيذ قيم الحد الأدنى والحد الأقصى للخصائص (minFloatValue وmaxFloatValue) لا تنطبق على هذه السمة.

تغيير الوضع: STATIC
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:KILOPASCAL
الإصدار: Android 13

CRUISE_Control_Command

WRITE أوامر التحكم في السرعة (CC). يُرجى الانتقال إلى CruiseControlCommand للاطّلاع على تفاصيل كل طلب متوافق. بالنسبة إلى معرّف المنطقة العالمي (0)، يجب تحديد الصفيفة StatusCode#VehicleAreaConfig#supportedEnumValues ما لم يتم تحديد تتوفر حالات CruiseControlState. يتم إرسال أي أوامر غير متوافقة يتم إرسالها من خلال يجب أن تعرض هذه السمة StatusCode#INVALID_ARG عندما تكون هذه السمة غير متوفّرة. نظرًا لإيقاف الحقل "نسخة إلى" (على سبيل المثال، تكون السمة CRUISE_CONTROL_ENABLED خطأ)، تكون هذه السمة يجب إرجاع StatusCode#NOT_AVAILABLE_DISABLED إذا CRUISE_CONTROL_STATE ويتم تنفيذ الحالة وتعيين الحالة على قيمة ErrorState، فإن هذه يجب أن تعرض السمة StatusCode يتوافق مع القيمة ErrorState. على سبيل المثال، إذا تم ضبط CRUISE_CONTROL_STATE على ErrorState#NOT_AVAILABLE_SPEED_LOW، ثم يجب عرض هذه السمة. StatusCode#NOT_AVAILABLE_SPEED_LOW

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: CruiseControlCommand
نوع الوحدة: لا ينطبق
الإصدار: Android 14

CRUISE_control_enabled

يمكنك تفعيل التحكم في السرعة أو إيقافه. اضبط القيمة على "صحيح" لتفعيل "نسخة إلى" وعلى "خطأ" لإيقافها. هذا النمط تتم مشاركة السمة من خلال جميع أشكال CruiseControlType(s). عند تفعيل الترجمة والشرح، يصبح نظام ADAS في تشغيل المركبة والاستجابة للأوامر. بشكل عام، CRUISE_CONTROL_ENABLED يجب أن يكون ناتجها دائمًا true أو false. إذا كانت الميزة غير متاحة بسبب حالة مؤقتة، مثل انخفاض سرعة المركبة بدرجة كبيرة، فيجب نقل هذه المعلومات من خلال ErrorState في السمة CRUISE_CONTROL_STATE. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

CRUISE_control_state

الحالة الحالية للتحكم في السرعة (CC). تعرض هذه السمة الحالة الحالية الخاصة بحقل "نسخة إلى". بشكل عام، يجب أن تعرض هذه السمة حالة صالحة محددة في CruiseControlState أو ErrorState على سبيل المثال، إذا كانت الميزة غير متاحة بسبب حالة مؤقتة، سيتم من خلال ErrorState بالنسبة إلى معرّف المنطقة العالمي (0)، يجب تحديد المصفوفة VehicleAreaConfig#supportedEnumValue ما لم تكن جميع حالات CruiseControlState (بما في ذلك OTHER، الذي لا يُنصح به) وErrorState

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: CruiseControlState/ErrorState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

CRUISE_control_TARGET_SPEED

السرعة المستهدفة الحالية للتحكّم في السرعة (CC). يجب على المصنّعين الأصليين للأجهزة تعيين minFloatValue قيَم maxFloatValue لهذه السمة لتحديد قيم الحد الأدنى والحد الأقصى للسرعة المستهدفة. هذه يجب أن تكون القيم غير سالبة. تمثل maxFloatValue الحد الأقصى للسرعة المستهدفة. تمثّل minFloatValue الحد الأدنى للسرعة المستهدفة. عندما لا تكون هذه السمة متاحة بسبب إيقاف ميزة "نسخة إلى" (على سبيل المثال، CRUISE_CONTROL_ENABLED خطأ)، يجب أن تعرض هذه السمة StatusCode#NOT_AVAILABLE_DISABLED إذا CRUISE_CONTROL_STATE هو وتم تنفيذ الحالة على قيمةErrorState، فيجب أن تعرض هذه الخاصية StatusCode تتوافق مع قيمة errorState. على سبيل المثال، إذا تم ضبط CRUISE_CONTROL_STATE إلى ErrorState#NOT_AVAILABLE_SPEED_LOW، يجب أن تعرض هذه السمة StatusCode#NOT_AVAILABLE_SPEED_LOW

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:METER_PER_SEC
الإصدار: Android 14

نوع التحكم في البيانات

النوع الحالي من التحكم في السرعة (CC). عندما تكون CRUISE_CONTROL_ENABLED صحيحة، تُرجع هذه الخاصية نوع الترجمة والشرح المفعَّل حاليًا (على سبيل المثال، الترجمة والشرح العادية والترجمة والشرح التكيُّفية، الترجمة والشرح). يجب أن تعرض هذه السمة حالة صالحة تم تحديدها في CruiseControlType أو ErrorState على سبيل المثال، إذا كانت الميزة غير متاحة بسبب حالة مؤقتة، الذي/التي يجب نقل المعلومات من خلال ErrorState بالنسبة إلى رقم تعريف المنطقة العالمية (0)، يجب أن تكون القيمة StatusCode#VehicleAreaConfig#supportedEnumValues يجب تحديد الصفيفة إلا في جميع حالات CruiseControlType (بما فيها OTHER، والتي لا يُنصح به) و يُسمح باستخدام ErrorState. جارٍ محاولة الوصول إلى WRITE CruiseControlType#OTHER أو ErrorState إلى هذا يعرض الموقع IllegalArgumentException يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة القيام بذلك. تنفيذه باسم VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: CruiseControlType ErrorState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

الإعدادات الحالية

رمز الترس الحالي في حالة غير يدوية، قد لا يتطابق الترس المحدد مع الترس الحالي. بالنسبة على سبيل المثال، إذا كان الترس المحدد هو GEAR_DRIVE، فسيكون الترس الحالي واحدًا من GEAR_1 وGEAR_2 وما إلى ذلك، والتي تعكس الترس الفعلي تشغيل ناقل الحركة. يجب أن تمثل القيم في بيانات الإعداد قائمة التروس المتوافقة لهذه المركبة. على سبيل المثال، يجب أن تحتوي بيانات الإعداد لعملية الإرسال التلقائي على {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}، بالإضافة إلى التحديثات اليدوية الإرسال، يجب أن تكون القائمة {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...} لا يجب أن تكون هذه القائمة مطابقة لقائمة التروس المتوافقة التي تم الإبلاغ عنها في GEAR_SELECTION

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleGear
نوع الوحدة: لا ينطبق
الإصدار: Android 13

CURRENT_POWER_POLICY

إخطار سياسة الطاقة الحالية لطبقة VHAL. تضبط خدمة سياسة تشغيل السيارة هذه السمة. عند تغيير سياسة الطاقة الحالية

string: "sample_policy_id" // power policy ID

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

إيقاف الميزات

السماح بإيقاف الميزات الاختيارية في VHAL. يعرض هذا الموقع ميزات اختيارية تعطيلاً. يتم الإعلان عن جميع الميزات الاختيارية المسموح بها للنظام في خدمة السيارة. عنصر متراكب، config_allowed_optional_car_features تتيح هذه الخاصية إيقاف الميزات المحددة في التراكب. بدون هذه الخاصية، ستكون كل الميزات المعلنة في التراكب. يجب أن تتضمن القيمة READ جميع الميزات التي تم إيقافها بفاصلة (,) الفصل. على سبيل المثال: com.android.car.user.CarUserNoticeService,storage_monitoring

تغيير الوضع: STATIC
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

عرض ساطع

سمة لتمثيل سطوع الشاشة تحتوي بعض السيارات على عنصر تحكّم واحد سطوع كل الشاشات. تُستخدم هذه السمة لمشاركة التغييرات في عنصر التحكّم هذا. في السيارات التي تحتوي على أجهزة العرض التي يتم التحكم في سطوعها بشكل منفصل، فيجب استخدام PER_DISPLAY_BRIGHTNESS يجب ضبط سمة واحدة فقط من DISPLAY_BRIGHTNESS وPER_DISPLAY_BRIGHTNESS. تنفيذها. إذا كانت كلاهما المتاحة، ويستخدم AAOS PER_DISPLAY_BRIGHTNESS. وإذا كان ذلك قابلاً للكتابة، يمكن لنظام Android ضبط هذا عندما يغيّر المستخدم سطوع الشاشة من خلال "الإعدادات". إذا كان ذلك يقتصر على READ فقط، لا يزال بإمكان المستخدم تغيير مستوى سطوع الشاشة من خلال "الإعدادات"، ولكن يجب ألا ينعكس التغيير على الشاشات الأخرى.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

DISTANCE_DISPLAY_UNITS

وحدات المسافة المستخدَمة في العرض. يشير إلى الوحدات التي تستخدمها السيارة لعرض المسافات المستخدم. على سبيل المثال، "ميل" أو "متر" أو "كيلومتر". يتم تحديد وحدات المسافة في AutomotiveUnit. تُستخدَم السيارةPropConfig.configArray للإشارة إلى وحدات عرض المسافة المتوافقة. على سبيل المثال: configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE إذا كان تحديث DISTANCE_DISPLAY_UNITS يؤثر في قيم أخرى *_DISPLAY_UNITS ، فيجب تعديل قيمها وتوصيلها إلى إطار عمل AAOS أيضًا. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة إجراء ذلك. يمكنك تنفيذها من خلال حساب VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleUnit
نوع الوحدة: لا ينطبق
الإصدار: Android 13

DOOR_CHILD_LOCK_مفعَّلة

تم تفعيل ميزة قفل باب الأطفال. عرض القيمة "صحيح" إذا كانت ميزة قفل الباب للأطفال مفعّلة false إذا تم إيقافها. إذا تم تفعيل هذا الإعداد، لا يمكن فتح الباب من الداخل. هذه السمة معرَّفة. كـ VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذه VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

قفل الباب

يشير قفل الباب "صحيح" إلى أنّ الباب مقفل. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

نقل الباب

يجب أن تكون سمتا maxInt32Value وminInt32Value في كل AutomotiveAreaConfig: محددة. يجب أن تكون كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value يمثّل maxInt32Value أقصى سرعة لحركة الباب أثناء. فتح. يمثّل minInt32Value أقصى سرعة لحركة الباب أثناء. الإغلاق.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بمجرد مدخلاً إلى حد الموضع، فيجب إعادة تعيين القيمة إلى 0. إذا كانت قيمة قيمة DOOR_MOVE هي 0، فهذا يعني عدم حدوث حركة حاليًا.

لا تنطبق هذه السمة على أي وحدة معيّنة، ولكنّها في نطاق محدّد من سرعات الحركة النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة إجراء ذلك. يمكنك تنفيذها من خلال حساب VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

نقطة البيع

موضع الباب maxInt32Value وminInt32Value في يجب تحديد VehicleAreaConfig. يجب أن تكون كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. ويشير minInt32Value إلى أن الباب مغلق. minInt32Value يجب أن تكون القيمة 0. تشير السمة maxInt32Value إلى أنّ الباب مفتوح بالكامل. القيم بين minInt32Value و يشير maxInt32Value إلى حالة انتقال بين مغلق وكامل الوظائف المفتوحة.

لا تتوفر هذه السمة في أي وحدة معيّنة، ولكنّها في نطاق محدّد من المواضع النسبية. يمكن لبعض المركبات (الشاحنات الصغيرة) فتح الباب إلكترونيًا. وبالتالي، فإن القدرة على WRITE هذا الموقع. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess. READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذ هذه الخطوة على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

من E إلى G

ELECTRONIC_TOLL_CUSTOM_CARD_STATUS

حالة بطاقة نظام تحصيل الرسوم الإلكتروني تشير هذه السمة إلى حالة بطاقة نظام تحصيل رسوم العبور إلكترونيًا في هذه المركبة. إذا كانت الوحدة الرئيسية على علم ببطاقة نظام تحصيل رسوم العبور إلكترونيًا (ETC) مرفقة بالمركبة، يعرض الرمز ELECTRONIC_TOLL_COLLECTION_CARD_TYPE حالة البطاقة. وبخلاف ذلك، يجب أن تكون هذه السمة UNAVAILABLE.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: ElectronicTollCollectionCardStatus
نوع الوحدة: لا ينطبق
الإصدار: Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

نوع بطاقة تحصيل الرسوم الإلكترونية (ETC) تشير هذه السمة إلى نوع بطاقة نظام تحصيل رسوم العبور إلكترونيًا في هذه المركبة. إذا كانت الوحدة الرئيسية على دراية ببطاقة نظام تحصيل رسوم العبور إلكترونيًا (ETC) مرفقة بالمركبة، يجب أن تُعرِض هذه السمة نوع البطاقة المرفقة، وإلا يجب أن تكون هذه السمة UNAVAILABLE.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: ElectronicTollCollectionCardType
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

تفعيل ميزة "المساعدة في الحفاظ على المسار في حالات الطوارئ" (ELKA) أو إيقافها اضبط القيمة "صحيح" لتفعيل ELKA وعلى "خطأ" لإيقاف ELKA. عند تفعيل نظام ELKA، يجب تشغيل نظام ADAS في المركبة، وسيراقب السائق أي تغييرات غير آمنة في الممرات. عند رصد مناورة غير آمنة، يُرسل نظام ELKA تنبيهًا إلى قائد المركبة ويُجري تصحيحات في التوجيه لإبقاء المركبة في مسارها الأصلي. بشكل عام، يجب أن يعرض EMERGENCY_LANE_KEEP_ASSIST_ENABLED دائمًا القيمة true أو false. إذا لم تكن الميزة متاحة بسبب بعض الحالات المؤقتة، مثل أن تكون سرعة المركبة منخفضة جدًا، يجب نقل هذه المعلومات من خلال قيم ErrorState في سمة EMERGENCY_LANE_KEEP_ASSIST_STATE. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

حالة ميزة "مساعد الحفاظ على المسار في حالات الطوارئ" (ELKA) تعرض حالة ELKA الحالية. بشكل عام، يجب أن تعرض هذه السمة حالة صالحة محدّدة في EmergencyLaneKeepAssistState أو ErrorState على سبيل المثال، إذا لم تكن الميزة متاحة بسبب حالة مؤقتة، يجب نقل هذه المعلومات من خلال ErrorState. بالنسبة إلى رقم تعريف المنطقة الشاملة (0)، يجب تحديد مصفوفة VehicleAreaConfig#supportedEnumValues ما لم تكن جميع حالات EmergencyLaneKeepAssistState (بما في ذلك OTHER، غير المُستحسَن) و ErrorState متوافقة.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: EmergencyLaneKeepAssistState/ErrorState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

ENGINE_COOLANT_TEMP

درجة حرارة سائل تبريد المحرّك

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:CELSIUS
الإصدار: Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

يمثّل ميزة إيقاف المحرّك تلقائيًا في وضع الخمول. إذا كان هذا الحقل صحيحًا، قد تتوقف المركبة تلقائيًا عن استخدام المحرّك عندما لا يكون مطلوبًا، ثم تعيد تشغيله تلقائيًا عند الحاجة. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

ENGINE_OIL_LEVEL

مستوى زيت المحرك

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleOilLevel
نوع الوحدة: لا ينطبق
الإصدار: Android 13

ENGINE_OIL_TEMP

درجة حرارة زيت المحرّك

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:CELSIUS
الإصدار: Android 13

ENGINE_RPM

عدد دورات المحرّك في الدقيقة

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:RPM
الإصدار: Android 13

ENV_OUTSIDE_TEMPERATURE

درجة الحرارة خارج المنزل يجب أن تُظهر هذه السمة قراءة درجة حرارة البيئة خارج المركبة. إذا كانت هناك عدة أدوات استشعار لقياس درجة الحرارة الخارجية، يجب تعبئة هذه السمة بالمتوسط أو المتوسّط المرجّح للقراءات الذي يمثّل درجة الحرارة في البيئة الخارجية على أفضل وجه.

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:CELSIUS
الإصدار: Android 13

EV_BATTERY_DISPLAY_UNITS

وحدات بطاريات المركبات الكهربائية المخصّصة للعرض تشير هذه السمة إلى الوحدات التي تستخدمها السيارة لعرض معلومات بطارية المركبة الكهربائية للمستخدم. على سبيل المثال، واط ساعة (Wh) أو كيلوواط ساعة (kWh) أو أمبير ساعة (Ah). تُستخدَم VehiclePropConfig.configArray للإشارة إلى الطاقة الكهربائية المتوافقة. وحدات. يتم تحديد وحدات الطاقة الكهربائية في VehicleUnit، على سبيل المثال:

  configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR

إذا كان تعديل EV_BATTERY_DISPLAY_UNITS يؤثّر في قيم سمات *_DISPLAY_UNITS الأخرى، يجب تعديل قيمها وإعلامها بإطار عمل AAOS أيضًا. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleUnit
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

معدّل الشحن الفوري للمركبة الكهربائية بالمللي واط تشير القيمة الموجبة إلى أنّه يتم شحن البطارية. تشير القيمة السالبة إلى أنّ البطارية يتم تفريغها.

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MW
الإصدار: Android 13

EV_BATTERY_LEVEL

تعرِض هذه السمة مستوى شحن البطارية الحالي، سواء كانت مركبة كهربائية أو هجينة. ولن تتجاوز هذه القيمة EV_CURRENT_BATTERY_CAPACITY. لاحتساب نسبة شحن البطارية، استخدِم (EV_BATTERY_LEVEL, EV_CURRENT_BATTERY_CAPACITY)*100.

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:WH
الإصدار: Android 13

EV_BRAKE_REGENERATION_LEVEL

مستوى الكبح التوليدي لمركبة كهربائية يجب تحديد السمتَين maxInt32Value وminInt32Value في AutomotiveAreaConfig. يجب أن تكون كل القيم بين minInt32Value وmaxInt32Value مسموحًا بها. يجب أن تكون قيمة minInt32Value 0. يشير الرمز maxInt32Value إلى إعداد الحد الأقصى للطاقة التي يتم تجديدها من خلال الكبح. يشير الرمز minInt32Value إلى عدم تفعيل ميزة الكبح التوليدي. هذه السمة هي شكل أكثر دقة من EV_REGENERATIVE_BRAKING_STATE وتسمح للمستخدم بضبط مستوى أكثر تحديدًا للفرملة التوليدية إذا لم تكن الحالات الواردة في EvRegenerativeBrakingState دقيقة بما يكفي لمصنّع السيارات الأصلي. يتم تحديد هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

يشير إلى الحد الأقصى المسموح به لسحب التيار أثناء الشحن والذي يضبطه المستخدم. يتم استخدام EvChargeState::configArray[0] لتحديد الحد الأقصى للسحب الحالي الذي تسمح به المركبة في Amperes. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها باستخدام سمة VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITEREAD
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:AMPERE
الإصدار: Android 13

EV_CHARGE_PERCENT_LIMIT

يشير إلى الحد الأقصى للنسبة المئوية للرسوم التي يحددها المستخدم. يشير إلى الحد الأقصى للرسوم التي يحددها المستخدم. لعرض قيمة عائمة من 0 إلى 100. يتم استخدام configArray لتحديد القيم الصالحة. على سبيل المثال، إذا كانت المركبة تسمح باستخدام القيم التالية الخاصة بحدود نسبة الشحن: [20, 40, 60, 80, 100]، يجب أن تكون قيمة configArray {20, 40, 60, 80, 100} إذا كانت configArray فارغة، يجب أن تكون جميع القيم من 0 إلى 100 صالحة. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE,، READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_CHARGE_PORT_CONNECTED

تم توصيل منفذ شحن المركبة الكهربائية. إذا كانت المركبة تحتوي على منافذ شحن متعددة، يجب أن تعرض هذه السمة قيمة true عند توصيل أي من منافذ الشحن.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_CHARGE_PORT_OPEN

منفذ شحن المركبة الكهربائية مفتوح. إذا كانت المركبة تحتوي على منافذ شحن متعددة، يجب أن تعرض هذه السمة القيمة "صحيح" إذا كان أي من منافذ الشحن مفتوحًا. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITEREAD
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_CHARGE_STATE

حالة شحن السيارة تعرِض هذه السمة حالة الشحن الحالية للسيارة. إذا كانت نسبة الشحن المستهدَفة للمركبة غير 100%، يجب أن تعرض هذه السمة القيمة EvChargeState::STATE_FULLY_CHARGED عندما يصل مستوى شحن البطارية إلى المستوى المستهدَف. يُرجى الاطّلاع على EvChargeState::EV_CHARGE_PERCENT_LIMIT لمزيد من السياق.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: EvChargeState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

تحويل_الرسوم_الإلكترونية

بدء شحن بطارية المركبة الكهربائية أو إيقافه تمثّل هذه السمة الإعداد الذي يريده المستخدم. يؤدي ضبط هذه السمة على true إلى بدء شحن البطارية، وعلى false لإيقافه. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITEREAD
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_CHARGE_TIME_REMAINING

الوقت المتبقّي المقدَّر لشحن البطارية بالثواني تعرض القيمة 0 إذا لم تكن المركبة قيد الشحن.

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:SECS
الإصدار: Android 13

EV_CURRENT_BATTERY_CAPAcity

سعة البطارية الحالية القابلة للاستخدام في المركبة الكهربائية أو الهجينة لعرض القيمة الفعلية ل سعة البطارية، عندما يكون المركب كهربائيًا أو هجينًا. يسجِّل هذا السمة سعة البطارية القابلة للاستخدام في الوقت الفعلي، ويأخذ في الاعتبار عوامل مثل عمر البطارية ودرجة الحرارة. قد تختلف هذه القيمة عن INFO_EV_BATTERY_CAPACITY لأنّ INFO_EV_BATTERY_CAPACITY تعرِض سعة البطارية الاسمية منذ كانت المركبة جديدة.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:WH
الإصدار: Android 14

EV_REGENERATIVE_BRAKING_STATE

ضبط المكابح المتجددة أو نظام القيادة أحادي الدواسة في السيارة تعرِض هذه السمة الإعداد الحالي المرتبط بإعدادات الكبح التوليدي في السيارة. إذا كان المصنّع الأصلي للجهاز يتطلّب إعدادات أكثر من تلك المقدَّمة في EvRegenerativeBrakingState، يمكن استخدام سمة EV_BRAKE_REGENERATION_LEVEL بدلاً من ذلك، والتي تقدّم معلومات أكثر تفصيلاً.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: EvRegenerativeBrakingState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EV_STOPPING_MODE

تمثّل هذه السمة وضع التوقف الحالي للمركبة. بالنسبة إلى رقم تعريف المنطقة الشاملة (0)، يجب تحديد VehicleAreaConfig#supportedEnumValues ما لم تكن جميع قيم التعداد الخاصة EvStoppingMode متوافقة. قد يتم توسيع نطاق التعداد EvStoppingMode لتشمل المزيد من الولايات في المستقبل. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: EvStoppingMode
نوع الوحدة: لا ينطبق
الإصدار: Android 14

EVS_SERVICE_REQUEST

تفعيل خدمة EVS وطلبها يوفّر الموقع طريقة لبدء خدمات EVS. يجب أن يستخدم VHAL هذه السمة لطلب Android بدء خدمة EVS أو إيقافها.

• int32Values[0] نوع خدمة EVS يجب أن تكون القيمة عنصرًا في EvsServiceType.
• int32Values[1] حالة خدمة EVS يجب أن تكون القيمة إحدى القيم المحدَّدة في EvsServiceState.

على سبيل المثال، لتفعيل خدمة EVS الخاصة بالرؤية الخلفية، يمكن لنظام التشغيل Android ضبط قيمة السمة على:

[EvsServiceType::REAR_VIEW, EvsServiceState::ON]

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

EXTERNAL_CAR_TIME

اقتراح التاريخ والوقت الحاليَين لطلب البحث، مُشفَّرًا كوقت حقبة (بالملي ثانية) تشير هذه القيمة إلى عدد المللي ثانية التي انقضت منذ 1/1/1970 بالتوقيت العالمي المنسق. تشير هذه السمة إلى تغيير في CarTime إلى Android. إذا كانت السمة متاحة، يجب أن يسجّل VHAL أحدث بيانات CarTime الأكثر دقة عند قراءة هذه السمة، وأن تنشر تغييرًا على هذه السمة عند تغيير قيمة CarTime.

يجب نشر حدث عند حدوث تغيير لهذا السمة عند تغيُّر CarTime لأي سبب آخر غير مرور الوقت الطبيعي (يجب ألا يؤدي تغيُّر المدّة الزمنية التي تقل عن 500 ملي ثانية إلى بدء حدث عند حدوث تغيير). سيقرأ Android هذه السمة ويشترك فيها لجلب الوقت من VHAL. يمكن أن يكون ذلك مفيدًا لمزامنة وقت Android مع أنظمة المركبات الأخرى (ساعة الشرطة). int64Values[0] = الوقت الذي تم تقديمه (بالمللي ثانية) عند تلقّي قيمة جديدة للموقع، ينشئ AAOS القيمة ExternalTimesuggestion ويرسلها إلى TimeDetectorService.

إذا لم تكن المصادر الأخرى ذات أولوية أعلى، سيستخدم Android هذه البيانات لضبط وقت النظام. للحصول على معلومات عن كيفية ضبط أولويات مصادر الوقت وكيفية معالجة اقتراحات الوقت (بما في ذلك كيفية تعامل Android مع الارتعاش والانحراف والحد الأدنى من الدقة)، يُرجى الاطّلاع على مستندات "خدمة رصد الوقت".

drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift

ننصحك بشدة بعدم استخدام هذا السمة لاسترداد الوقت من وحدات التحكّم الإلكترونية باستخدام البروتوكولات (مثل GNSS وNTP وTelephony). بما أنّ بروتوكولات VHAL متوافقة مع Android، ننصحك باستخدام أنظمة Android بدلاً من توصيل الأجهزة من خلال VHAL مع هذا الموضع.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MILLI_SECS
الإصدار: Android 13

FOG_LIGHTS_STATE

حالة ضوء الضباب عرض الحالة الحالية للمصابيح الأمامية للضباب إذا كان:

• تحتوي السيارة على مصابيح ضباب أمامية وخلفية. يمكن التحكّم في مصابيح الضباب الأمامية والخلفية معًا فقط. يجب تنفيذ FOG_LIGHTS_STATE. يجب عدم تنفيذ FRONT_FOG_LIGHTS_STATE وREAR_FOG_LIGHTS_STATE.
• لا يمكن التحكّم في مصابيح الضباب الأمامية والخلفية إلا بشكل مستقل. يجب عدم تنفيذ FOG_LIGHTS_STATE ويجب تنفيذ FRONT_FOG_LIGHTS_STATE وREAR_FOG_LIGHTS_STATE.
• تحتوي السيارة على مصابيح أمامية للضباب فقط. يجب تنفيذ سمة واحدة فقط من FOG_LIGHTS_STATE أو FRONT_FOG_LIGHTS_STATE (وليس كليهما). يجب عدم تنفيذ REAR_FOG_LIGHTS_STATE.
• تحتوي السيارة على مصابيح ضباب خلفية فقط. يجب تنفيذ سمة واحدة فقط من FOG_LIGHTS_STATE أو REAR_FOG_LIGHTS_STATE (وليس كليهما). يجب عدم تنفيذ FRONT_FOG_LIGHTS_STATE.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleLightState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FOG_LIGHTS_SWITCH

مفتاح إضاءة الضباب. الإعداد المطلوب من المستخدِم. إذا كان:

• تحتوي السيارة على مصابيح ضباب أمامية وخلفية. إذا كان لا يمكن التحكّم في مصابيح الضباب الأمامية والخلفية إلا معًا، يجب تنفيذ FOG_LIGHTS_SWITCH. يجب عدم تنفيذ FRONT_FOG_LIGHTS_SWITCH وREAR_FOG_LIGHTS_SWITCH.
• يمكن التحكّم في مصابيح الضباب الأمامية والخلفية بشكل مستقل فقط. FOG_LIGHTS_SWITCH يجب عدم تنفيذه. يجب تنفيذ FRONT_FOG_LIGHTS_SWITCH وREAR_FOG_LIGHTS_SWITCH.
• تحتوي السيارة على مصابيح أمامية للضباب فقط. يجب تنفيذ سمة واحدة فقط من FOG_LIGHTS_SWITCH أو FRONT_FOG_LIGHTS_SWITCH (وليس كليهما). يجب عدم تنفيذ REAR_FOG_LIGHTS_SWITCH.
• تحتوي السيارة على مصابيح ضباب خلفية فقط. ويجب تنفيذ سمة واحدة فقط من السمة FOG_LIGHTS_SWITCH أو السمة REAR_FOG_LIGHTS_SWITCH (وليس كليهما). يجب عدم تنفيذ FRONT_FOG_LIGHTS_SWITCH.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleLightSwitch
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FORWARD_COLLISION_WARNING_enabled

فعِّل ميزة "تحذير من الاصطدام الأمامي" (FCW) أو أوقِفها. اضبط القيمة على true لتفعيل FCW وعلى false لإيقافها. عند تفعيل نظام التحذير من الاصطدام الأمامي (FCW)، يجب تفعيل نظام ADAS في المركبة و مراقبته بحثًا عن أي تصادمات محتملة. بشكل عام، يجب أن يعرض FORWARD_COLLISION_WARNING_ENABLED دائمًا القيمة true أو false. إذا كانت الميزة غير متاحة بسبب حالة مؤقتة معيّنة، كأن تكون سرعة المركبة منخفضة جدًا، يجب نقل هذه المعلومات من خلال قيم ErrorState في السمة FORWARD_COLLISION_WARNING_STATE.

تم تحديد هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

FORWARD_COLLISION_WARNING_STATE

حالة تحذير الاصطدام الأمامي (FCW). لعرض الحالة الحالية لميزة "القيادة بدون يدين" يجب أن تعرض هذه السمة دائمًا حالة صالحة محدّدة في ForwardCollisionWarningState أو ErrorState. ويجب ألّا تعرض أخطاء من خلال StatusCode، بل يجب استخدام حالات الخطأ المتوافقة بدلاً من ذلك. بالنسبة إلى رقم تعريف المنطقة الشاملة (0)، يجب تحديد مصفوفة VehicleAreaConfig#supportedEnumValues ما لم تكن جميع حالات كل من ForwardCollisionWarningState (بما في ذلك OTHER، غير المُستحسَن) وErrorState متوافقة.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعريف: ForwardCollisionWarningState/ErrorState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

FRONT_FOG_LIGHTS_state

حالة مصابيح الضباب الأمامية تعرِض الحالة الحالية للمصابيح الأمامية للضباب. يجب تنفيذ إحدى السمتَين FOG_LIGHTS_STATE أو FRONT_FOG_LIGHTS_STATE فقط. يُرجى الرجوع إلى المستندات حول FOG_LIGHTS_STATE للحصول على مزيد من المعلومات.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleLightState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FRONT_FOG_LIGHTS_SWITCH

مفتاح إيقاف مصابيح الضباب الأمامية في الجهة الأمامية. الإعداد المطلوب من المستخدِم. ويجب تنفيذ سمة واحدة فقط من FOG_LIGHTS_SWITCH أو FRONT_FOG_LIGHTS_SWITCH. يُرجى الرجوع إلى المستندات حول FOG_LIGHTS_SWITCH للحصول على مزيد من المعلومات.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleLightSwitch
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

وحدات استهلاك الوقود المعروضة. يشير إلى نوع الوحدات التي تستخدمها السيارة لعرض معلومات استهلاك الوقود للمستخدمين. يشير True إلى أنّ الوحدات هي المسافة على حجم الوقود، مثل MPG. تشير القيمة False إلى أنّ الوحدات هي حجم على مسافة، مثل لتر/100 كيلومتر. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FUEL_DOOR_OPEN

تم فتح باب الوقود. يجب أن تشير هذه السمة إلى ما إذا كان باب خزان الوقود في المركبة مفتوحًا أم لا. لا ينطبق هذا السمة على المركبات الكهربائية. وهذا يعني أنّه إذا كانت السمة INFO_FUEL_TYPE تحتوي فقط على FuelType::FUEL_TYPE_ELECTRIC، يجب عدم تنفيذ هذه السمة. بالنسبة إلى المركبات الكهربائية، نفِّذ EV_CHARGE_PORT_OPEN. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها باستخدام سمة VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FUEL_LEVEL

مقدار الوقود المتبقّي في المركبة، بالمليليتر يجب أن توضّح هذه السمة كمية الوقود الحالية المتبقّية في المركبة بالملليترات. لا ينطبق هذا الموقع على المركبات الكهربائية. وهذا يعني أنّه إذا كانت السمة INFO_FUEL_TYPE تحتوي فقط على FuelType::FUEL_TYPE_ELECTRIC، يجب عدم تنفيذ هذه السمة. بالنسبة إلى المركبات الكهربائية، نفِّذ يلي: EV_BATTERY_LEVEL لا يمكن أن تتجاوز القيمة INFO_FUEL_CAPACITY

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MILLILITER
الإصدار: Android 13

FUEL_LEVEL_LOW

تحذير من انخفاض مستوى الوقود. يرتبط هذا السمة بتحذير انخفاض مستوى الوقود على لوحة البيانات. بعد ضبط FUEL_LEVEL_LOW، يجب عدم محو القيمة إلى أن تتم إضافة المزيد من الوقود إلى المركبة. يمكن أن يفسّر هذا الموقع جميع مصادر الوقود في المركبة. على سبيل المثال، في ما يلي:

• مركبة تعمل بالبنزين، يستند هذا الموقع إلى مستوى البنزين فقط.
• مركبة تعمل بالبطارية: تستند هذه السمة إلى مستوى البطارية فقط.
• مركبة كهربائية هجينة، يمكن أن يستند هذا السمة إلى مجموعة من مستويات الوقود والبطارية، وذلك حسب تقدير المصنّع الأصلي للجهاز.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

FUEL_VOLUME_DISPLAY_UNITS

وحدات حجم الوقود المعروضة يشير إلى الوحدات التي تستخدمها السيارة لعرض حجم الوقود للمستخدم. على سبيل المثال، لتر أو غالون. يتم استخدام السمة VehiclePropConfig.configArray للإشارة إلى وحدات عرض حجم الوقود المتوافقة. يتم تحديد وحدات الحجم في VehicleUnit، على سبيل المثال، configArray[0] = LITER configArray[1] = GALLON إذا كان تعديل FUEL_VOLUME_DISPLAY_UNITS يؤثّر في قيم *_DISPLAY_UNITS الأخرى، يجب تعديل قيمها وإعلام إطار عمل AAOS أيضًا. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleUnit
نوع الوحدة: لا ينطبق
الإصدار: Android 13

اختيارات GEAR

الترس الذي اختاره المستخدم يجب أن تمثّل القيم في بيانات الضبط قائمة التروس المتوافقة مع هذه المركبة. على سبيل المثال، يجب أن تحتوي بيانات الإعداد لناقل الحركة التلقائي على {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_DRIVE, GEAR_1, GEAR_2,...} وبالنسبة إلى النقل اليدوي يجب أن تكون القائمة {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...} بالنسبة إلى مركبة ناقل الحركة التلقائي التي تسمح للسائق باختيار تروس معينة عند الطلب (مثل الوضع اليدوي)، يجب ضبط قيمة GEAR_SELECTION على الترس المحدد الذي يختاره السائق بدلاً من GEAR_DRIVE

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleGear
نوع الوحدة: لا ينطبق
الإصدار: Android 13

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

متطلبات الامتثال للّوائح التنظيمية العامة للأمان في الاتحاد الأوروبي تعرض قيمة للإشارة إلى ما إذا كان الامتثال للّوائح الأمنية العامة مطلوبًا أم لا، وفي حال كان الأمر كذلك، إلى نوع الشرط.

وضع التغيير: STATIC
وضع الوصول: READ
نوع التعداد: GsrComplianceRequirementType
نوع الوحدة: لا ينطبق
الإصدار: Android 14

GLOVE_BOX_DOOR_POS

سمة تمثّل الموضع الحالي لباب الصندوق يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متاحة. يشير الرمز minInt32Value إلى أنّ باب صندوق القفازات مغلق. يجب أن تكون قيمة minInt32Value 0. تشير السمة maxInt32Value إلى أنّ باب صندوق القفازات مفتوح بالكامل. تشير القيم بين minInt32Value و maxInt32Value إلى حالة انتقالية بين الوضعين المغلق والمفتوح بالكامل.

لا تقع هذه السمة في أي وحدة معيّنة، بل في نطاق محدّد من المواضع النسبية. يجب أن يتطابق معرّف المنطقة مع المقعد الذي يُفترض أن يتم استخدام صندوق القفازات من خلاله. على سبيل المثال، إذا كانت لوحة البيانات الأمامية اليمنى تتضمّن صندوق قفازات، يجب أن يكون رقم تعريف المنطقة SEAT_1_RIGHT.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

GLOVE_BOX_LOCKED

قفل صندوق القفازات أو فتح قفله إذا كانت القيمة true، يكون صندوق القفازات مقفلاً. إذا كانت القيمة "خطأ"، يعني ذلك أنّه سيتم فتح قفل صندوق القفازات. يجب أن يتطابق معرّف المنطقة مع المقعد المخصّص لاستخدام صندوق القفازات. على سبيل المثال، إذا كانت لوحة البيانات الأمامية اليمنى تتضمّن صندوق قفازات مضمَّنة، يجب أن يكون رقم تعريف المنطقة VehicleAreaSeat#ROW_1_RIGHT.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

من H إلى I

HANDS_ON_DETECTION_DRIVER_STATE

Hands On Detection (HOD) driver state. Returns whether the driver's hands are on the steering wheel. Generally, this property should return a valid state defined in the HandsOnDetectionDriverState or ErrorState For example, if the feature is not available due to some temporary state, that information should be conveyed through ErrorState If the vehicle wants to send a warning to the user because the driver's hands have been off the steering wheel for too long, the warning should be surfaced through HANDS_ON_DETECTION_WARNING For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both HandsOnDetectionDriverState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionDriverState/ErrorState
Unit type: N/A
Release: Android 14

HANDS_ON_DETECTION_ENABLED

Enable or disable Hands On Detection (HOD). Set true to enable HOD and false to disable HOD. When HOD is enabled, a system inside the vehicle should be monitoring the presence of the driver's hands on the steering wheel and send a warning if it detects that the driver's hands are no longer on the steering wheel. In general, HANDS_ON_DETECTION_ENABLED should always return true or false.

If the feature is not available due to some temporary state, that information must be conveyed through the ErrorState values in the HANDS_ON_DETECTION_STATE property. This property is defined as minInt32Value VehiclePropertyAccess.READ_WRITE, but OEMs can implement it is VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

HANDS_ON_DETECTION_WARNING

Hands On Detection (HOD) warning. Returns whether a warning is being sent to the driver for having their hands off the wheel for too long a duration. Generally, this property should return a valid state defined in HandsOnDetectionWarning or ErrorState For example, if the feature is not available due to some temporary state, that information should be conveyed through an ErrorState For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both HandsOnDetectionWarning (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionWarning/ErrorState
Unit type: N/A
Release: Android 14

HAZARD_LIGHTS_STATE

Hazard light status. Return the current status of hazard lights.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

HAZARD_LIGHTS_SWITCH

Hazard light switch. The setting that the user wants. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13

HEADLIGHTS_STATE

Headlights state. Returns the current state of headlights.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

HEADLIGHTS_SWITCH

Headlight switch. The setting that the user wants. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13

HIGH_BEAM_LIGHTS_STATE

High beam lights state. Returns the current state of high beam lights.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

HIGH_BEAM_LIGHTS_SWITCH

High beam light switch. The setting that the user wants. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13

HVAC_AC_ON

Turn AC on and off AC for the designated areaId. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

Actual fan speed.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_AUTO_ON

Turn automatic climate control on and off. If true, automatic climate control is on. If false, automatic climate control is off. If the vehicle does not support directly turning off automatic climate control, then OEMs should add logic in their VHAL implementation to set HVAC_AUTO_ON to false, which changes the necessary HVAC settings to indirectly turn off HVAC_AUTO_ON Ideally, this should not disrupt the user. OEMs should revert to the previous state any settings that were modified when automatic climate control is off. This way, the only outcome should be that HVAC_AUTO_ON is off. If restoring HVAC settings to previous settings is not possible, then the OEM should implement the least disruptive change.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_AUTO_RECIRC_ON

Automatic recirculation on or off. When automatic recirculation is on, the HVAC system may automatically switch to recirculation mode if the vehicle detects poor incoming air quality. This property is defined as VehiclePropertyAccess.READ_WRITE but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_DEFROSTER

Fan-based defrost for designated window. This property is defined as VehiclePropertyAccess.READ_WRITE but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_DUAL_ON

Enable temperature coupling between areas. The AreaIDs for the HVAC_DUAL_ON property shall contain a combination of HVAC_TEMPERATURE_SET AreaIDs that can be coupled together. If HVAC_TEMPERATURE_SET is mapped to AreaIDs[a_1, a_2, ..., a_n] and if HVAC_DUAL_ON can be enabled to couple a_i and a_j, then HVAC_DUAL_ON property must be mapped to [a_i | a_j]. Further, if a_k and a_l can also be coupled together separately, then HVAC_DUAL_ON must be mapped to [a_i | a_j, a_k | a_l]. For example, a car has two front seats (ROW_1_LEFT and ROW_1_RIGHT) and three back seats (ROW_2_LEFT, ROW_2_CENTER, and ROW_2_RIGHT). There are two temperature control units, driver side and passenger side, which can be optionally synchronized. This can be expressed this way in the AreaIDs:

HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]

When the property is enabled, the ECU must synchronize the temperature for the affected areas. Any parameters modified as a side effect of turning on or off the DUAL_ON parameter shall generate onPropertyEvent() callbacks to the VHAL. In addition, if setting a temperature (for example, driver temperature) changes another temperature (such as front passenger temperature), then the appropriate onPropertyEvent() callbacks must be generated.

If a user changes a temperature that breaks the coupling (for example, sets passenger temperature independently), then the VHAL must send the appropriate onPropertyEvent() callbacks (including HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx). This property is defined as VehiclePropertyAccess.READ_WRITE but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_ELECTRIC_DEFROSTER_ON

Electric defrosters' status.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_FAN_DIRECTION

Fan direction setting. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13

HVAC_FAN_DIRECTION_AVAILABLE

Fan positions available. This is a bit mask of fan positions available for the zone. Each available fan direction is denoted by a separate entry in the vector. A fan direction can have multiple bits from vehicle_hvac_fan_direction set. For instance, a typical car may have these fan positions:

- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)

Change mode: STATIC
Access mode: READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13

HVAC_FAN_SPEED

Fan speed setting. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

• minInt32Value lowest fan speed
• maxInt32Value highest fan speed

This property is not in any specific unit but in a specified range of relative speeds. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can elect to implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_MAX_AC_ON

MAX AC on or off. When MAX AC is on, the ECU can adjust items such as vent position, fan speed, and temperature as needed to cool the vehicle as quickly as possible. Any parameters modified as a side effect of turning on or off the MAX AC parameter generates onPropertyEvent() callbacks to the VHAL. This property is defined as VehiclePropertyAccess.READ_WRITE but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_MAX_DEFROST_ON

Turn MAX DEFROST on and off. When MAX DEFROST is on, the ECU can adjust items such as vent position, fan speed, and temperature as needed to defrost the windows as quickly as possible. Any parameters modified as a side effect of turning on or off MAX DEFROST parameter generates onPropertyEvent() callbacks to the VHAL. The AreaIDs for HVAC_MAX_DEFROST_ON indicate MAX DEFROST can be controlled in the area. For example, areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} indicates that HVAC_MAX_DEFROST_ON can only be controlled for the front rows. This property is defined as VehiclePropertyAccess.READ_WRITE but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_POWER_ON

Represents the global power state for HVAC. Setting this property to false MAY mark some properties that control individual HVAC features and subsystems in the UNAVAILABLE state. Setting this property to true MAY mark some properties that control individual HVAC features and subsystems to the AVAILABLE state (unless any or all of the properties are UNAVAILABLE on their own individual merits).

HvacPower_DependentProperties are those properties that require HVAC to be powered on to enable functionality. In some cars, for example, to turn on the AC, HVAC must first be powered on. The HvacPower_DependentProperties list must be set in the VehiclePropConfig.configArray HvacPower_DependentProperties must only contain those properties associated with VehicleArea:SEAT

AreaID mapping for HVAC_POWER_ON property must contain all AreaIDs that HvacPower_DependentProperties are mapped to. For example, a car has two:

1. Front seats (ROW_1_LEFT, ROW_1_RIGHT) and three back seats (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). If the HVAC features (AC, Temperature etc.) throughout the car are dependent on a single HVAC power controller, then HVAC_POWER_ON must be mapped to [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
2. Seats in the front row (ROW_1_LEFT, ROW_1_RIGHT) and three seat in the second (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) and third rows (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT). If the car has temperature controllers in the front row that can operate entirely independently of temperature controllers in the back of the vehicle, then HVAC_POWER_ON must be mapped to a two element array:

   - ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
   

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs have the option to implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_RECIRC_ON

Recirculation on and off. Controls the supply of exterior air to the cabin. Recirc on means most of the airflow into the cabin originates in the cabin. Recirc off means most of the airflow into the cabin comes from outside the car. This property is defined as VehiclePropertyAccess.READ_WRITE but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_SEAT_TEMPERATURE

Seat heating and cooling. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The maxInt32Value indicates the maximum seat temperature heating setting. The minInt32Value must be 0, unless the vehicle supports seat cooling. In this case, minInt32Value indicates the maximum seat temperature cooling setting. This property is not in any specific unit, but in a specified range of relative temperature settings. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_SEAT_VENTILATION

Seat ventilation. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value must be 0. The maxInt32Value indicates the maximum ventilation setting available for the seat.

This property is not in any particular unit but in the specified range of ventilation settings.

Used by HVAC apps and Assistant to enable, change, or read state of seat ventilation. This is different than seating cooling. It can be on at the same time as cooling, or not.

This property is defined as >VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_SIDE_MIRROR_HEAT

Side mirror heat. Increasing values denote higher heating levels for side mirrors. You must define maxInt32Value and minInt32Value in VehicleAreaConfig All integers between minInt32Value and maxInt32Value must be supported. In config data:

• maxInt32Value represents maximum heating level.
• minInt32Value MUST be 0 and indicates no heating.

This property is not in any particular unit but in a specified range of relative heating settings. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs have the option to implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_STEERING_WHEEL_HEAT

Sets the amount of heating and cooling for the steering wheel. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The maxInt32Value indicates the maximum steering wheel heating setting. The minInt32Value should be 0, unless the vehicle supports steering wheel cooling, too. In this case, the minInt32Value indicates the maximum steering wheel cooling setting. This property is not in any particular unit but in a specified range of heating settings. This property is defined as VehiclePropertyAccess.READ, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HVAC_TEMPERATURE_CURRENT

HVAC current temperature.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13

HVAC_TEMPERATURE_DISPLAY_UNITS

Temperature units for display. Indicates if temperature is displayed in Celsius or Fahrenheit. VehiclePropConfig.configArray indicates the supported temperature display units. For example, configArray[0] = CELSIUS configArray[1] = FAHRENHEIT This parameter MAY be used to display any HVAC temperature in the system. Values must be one of VehicleUnit.CELSIUS or VehicleUnit.FAHRENHEIT

If updating HVAC_TEMPERATURE_DISPLAY_UNITS affects the values of other *_DISPLAY_UNITSproperties, then their values must be updated and communicated to the AAOS framework.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it is VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13

HVAC_TEMPERATURE_SET

HVAC target temperature set in Celsius.

The minFloatValue and maxFloatValue in VehicleAreaConfig must be defined:

• minFloatValue minimum temperature setting in Celsius.
• maxFloatValue maximum temperature setting in Celsius.

If all the values between minFloatValue and maxFloatValue are not supported, use the configArray to list the valid temperature values that can be set. This also describes a lookup table to convert the temperature from Celsius to Fahrenheit (and vice versa) for the vehicle. The configArray must be defined if standard unit conversion is not supported on the vehicle.

The configArray is set as follows:

• configArray[0] [lower bound of supported temperature in Celsius] * 10
• configArray[1] [upper bound of supported temperature in Celsius] * 10
• configArray[2] [increment in Celsius] * 10
• configArray[3] [lower bound of the supported temperature in Fahrenheit] * 10
• configArray[4] [upper bound of the supported temperature in Fahrenheit] * 10
• configArray[5] [increment in Fahrenheit] * 10

The minFloatValue and maxFloatValue in VehicleAreaConfig must be equal to configArray[0] and configArray[1] respectively. For example, if the vehicle supports temperature values as [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] in Fahrenheit, the configArray should be configArray = {160, 280, 5, 605, 845, 10}

Ideally, the ratio of the Celsius increment to the Fahrenheit increment should be as close to the actual ratio of 1 degree Celsius to 1.8 degrees Fahrenheit. There must be a one-to-one mapping of all Celsius values to Fahrenheit values defined by the configArray The configArray is used by clients to convert this property's temperature from Celsius to Fahrenheit. Also, it lets clients know what Celsius value to set the property to achieve their desired Fahreneheit value for the system. If the ECU does not have a one-to-one mapping of all Celsius values to Fahrenheit values, then the configArray should only define the list of Celsius and Fahrenheit values that have a one-to-one mapping.

For example, if the ECU supports Celsius values from 16 to 28 and Fahrenheit values from 60 to 85, each with an increment of 1, then one possible configArray is code>{160, 280, 10, 600, 840, 20}In this case, 85 is not a supported temperature.

Any value set in between a valid value should be rounded to the closest valid value. We highly recommended that the OEM also implement the HVAC_TEMPERATURE_VALUE_SUGGESTION vehicle property because it provides applications with a simple method for determining temperature values that can be set for a vehicle and for converting values between Celsius and Fahrenheit.

This property is defined as VehiclePropertyAccess.READ, but OEMs can implement it as VehiclePropertyAccess.READ

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13

HVAC_TEMPERATURE_VALUE_SUGGESTION

Suggested values for setting HVAC temperature.

Implement the property to help applications understand the closest supported temperature value in Celsius or Fahrenheit.

• floatValues[0] Requested value that an app wants to set a temperature to.
• floatValues[1] Unit for floatValues[0] and should be one of {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
• floatValues[2] Value OEMs suggested in CELSIUS (this value is not included in the request).
• floatValues[3] Value OEMs suggested in FAHRENHEIT (this value is not included in the request).

An application calls set(VehiclePropValue propValue) with the requested value and unit for the value. OEMs need to return the suggested values in floatValues[2] and floatValues[3] by onPropertyEvent() callbacks. The suggested values must conform to the values that can be derived from the HVAC_TEMPERATURE_SET configArray In other words, the suggested values and the table of values from the configArray should be the same.

We recommended that the OEM add custom logic in their VHAL implementation to avoid making requests to the HVAC ECU. The logic can be as follows. To convert temperature from Celsius to Fahrenheit:

// Given tempC and the configArray float minTempC = configArray[0] / 10.0; float temperatureIncrementCelsius = configArray[2] / 10.0; float minTempF = configArray[3] / 10.0; float temperatureIncrementFahrenheit = configArray[5] / 10.0; // Round to the closest increment int numIncrements = round((tempC - minTempC) / temperatureIncrementCelsius); tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;

For example, when a driver uses the voice assistant to set HVAC temperature to 66.2 in Fahrenheit. First, an application sets this property with the value [66.2, (float)VehicleUnit.FAHRENHEIT,0,0] If an OEM suggests to set 19.0 in Celsius or 66.5 in Fahrenheit at the user's request, then VHAL must generate a callback with a property value [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5] After the voice assistant gets the callback, it informs the user and sets the HVAC temperature to the suggested value.

Another example, an app receives 21 Celsius as the current temperature value by querying HVC_TEMPERATURE_SET but the app needs to know what value is displayed on the car's UI in Fahrenheit. For this, the app sets the property to [21, (float)VehicleUnit.CELSIUS, 0, 0] If the suggested value by the OEM for 21 Celsius is 70 Fahrenheit, then VHAL must generate a callback with property value [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0] In this case, the app can know that the value is 70.0 Fahrenheit in the car's UI.

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

HW_CUSTOM_INPUT

Defines a custom OEM partner input event. This input event must be used by OEM partners who want to propagate events not supported by Android. It is composed by an array of int32 values only. The Android properties are:

• int32Values[0] Input code identifying the function representing this event. Valid event types are defined by CustomInputType.CUSTOM_EVENT_F1 up to CustomInputType.CUSTOM_EVENT_F10 They represent the custom event to be defined by OEM partners.
• int32Values[1] Target display type defined in VehicleDisplay Events not tied to a specific display must be sent to VehicleDisplay#MAIN
• int32Values[2] Repeat counter, if 0 then event is not repeated. Values 1 or higher indicate how many times this event has been repeated.

Change mode: ON_CHANGE
Access mode: READ
Enum type: CustomInputType
Unit type: N/A
Release: Android 13

HW_KEY_INPUT

Property to feed hardware input events to Android.

• int32Values[0] Action defined by VehicleHwKeyInputAction
• int32Values[1] Key code, must use standard android key code
• int32Values[2] Target display defined in VehicleDisplay Events not tied to specific display must be sent to VehicleDisplay#MAIN
• int32Values[3] (Optional) Number of ticks. The value must be equal o greater than 1. When omitted, Android defaults to 1.

Change mode: .ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

HW_KEY_INPUT_V2

Property to feed hardware input events to Android.

• int32array[0] Target display defined by VehicleDisplay such as:
  VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
• int32array[1] Key code, must use the standard Android key code, such as KEYCODE_HOME and KEYCODE_BACK
• int32array[2] action defined in VehicleHwKeyInputAction, such as:
  VehicleHwKeyInputAction::ACTION_UP, VehicleHwKeyInputAction::ACTION_UP
• int32array[3] Repeat count of the event. For key down events, this is the repeat count with the first down starting at 0 and counting up from there. For key up events, this is always equal to 0.
• int64array[0] Down time in elapsed nanoseconds since the last boot. Denotes the time of the most recent key down event. For the down event, this is the event time of the down event.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14

HW_MOTION_INPUT

Property to feed hardware input events to Android.

• int32array[0] Target display defined by VehicleDisplay, such as:
  VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
• int32array[1] Input type defined in VehicleHwMotionInputSource, such as:
  VehicleHwMotionInputSource::SOURCE_KEYBOARD, VehicleHwMotionInputSource::SOURCE_DPAD
• int32array[2] Action code defined in VehicleHwMotionInputAction, such as:
  VehicleHwMotionInputAction::ACTION_UP, VehicleHwMotionInputAction::ACTION_DOWN
• int32array[3] Button state flag defined in VehicleHwMotionButtonStateFlag, such as:
  VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY, VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
• int32array[4] Pointer events count, N. N must be a positive integer.
• int32array[5:5+N-1] Pointer id, length N
• int32array[5+N:5+2*N-1] Tool type, length N. As defined in VehicleHwMotionToolType, such as:
  VehicleHwMotionToolType::TOOL_TYPE_FINGER, VehicleHwMotionToolType::TOOL_TYPE_STYLUS
• floatArray[0:N-1] x data, length N
• floatArray[N:2*N-1] y data, length N
• floatArray[2*N:3*N-1] pressure data, length N
• floatArray[3*N:4*N-1] size data, length N
• int64array[0] Down time, elapsed nanoseconds since boot. Denotes the time when the user originally pressed down to start a stream of position events. For the down event, it is the event time of the down event.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14

HW_ROTARY_INPUT

Property to feed hardware rotary events to Android.

• int32Values[0] RotaryInputType to identify which rotary knob is rotated.
• int32Values[1] Number of detents (clicks), positive for clockwise, negative for counterclockwise.
• int32Values[2] Target display defined in VehicleDisplay Events not tied to a specific display must be sent to VehicleDisplay#MAIN
• int32values[3 .. 3 + abs(number of detents) - 2] Nanosecond deltas between pairs of consecutive detents when the number of detents is more than 1 or less than -1.
• VehiclePropValue.timestamp When the rotation took place. If the number of detents is more than 1 or less than -1, when the first detent of rotation took place.

Change mode: ON_CHANGE
Access mode: READ
Enum type: RotaryInputType
Unit type: N/A
Release: Android 13

IGNITION_STATE

Represents ignition state.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleIgnitionState
Unit type: N/A
Release: Android 13

INFO_DRIVER_SEAT

Driver's seat location VHAL implementations must ignore the areaId. Use VehicleArea:GLOBAL

Change mode: STATIC
Access mode: READ
Enum type: VehicleAreaSeat
Unit type: N/A
Release: Android 13

INFO_EV_BATTERY_CAPACITY

Nominal battery capacity for EV or hybrid vehicle. Returns the nominal battery capacity, EV or hybrid. This is the total usable battery capacity when the vehicle is new. This value may differ from EV_CURRENT_BATTERY_CAPACITY because EV_CURRENT_BATTERY_CAPACITY returns the real-time usable battery capacity taking into account factors such as battery aging and temperature dependency.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13

INFO_EV_CONNECTOR_TYPE

List of connectors this EV may use. If the vehicle has multiple charging ports, this property must return all possible connector types that can be used by at least one charging port on the vehicle.

Change mode: STATIC
Access mode: READ
Enum type: EvConnectorType
Unit type: N/A
Release: Android 13

INFO_EV_PORT_LOCATION

This property must communicate the location of the charging port on the EV using the PortLocationType enum. If a vehicle has multiple ports, this property must return the port that allows the fastest charging. To communicate all port locations, use INFO_MULTI_EV_PORT_LOCATIONS

INFO_EXTERIOR_DIMENSIONS

Exterior dimensions of vehicle:

• Height: int32Values[0]
• Length: int32Values[1]
• Width: int32Values[2]
• Width, including mirrors: int32Values[3]
• Wheel base, including mirrors: int32Values[4]
• Track width front: int32Values[5]
• Track width rear: int32Values[6]
• Curb-to-curb turning diameter: int32Values[7]

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLIMETER
Release: Android 13

INFO_FUEL_CAPACITY

Fuel capacity of the vehicle in milliliters. This property must communicate the maximum amount of fuel that can be stored in the vehicle in milliliters. This property does not apply to electric vehicles (EV). That is, if INFO_FUEL_TYPE only contains FuelType::FUEL_TYPE_ELECTRIC, INFO_FUEL_CAPACITY must not be implemented. For EVs, implement INFO_EV_BATTERY_CAPACITY.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13

INFO_FUEL_DOOR_LOCATION

Fuel door location. This property must communicate the location of the fuel door on the vehicle. This property does not apply to EVs. That is, if INFO_FUEL_TYPE only contains FuelType::FUEL_TYPE_ELECTRIC, this property must not be implemented. For EVs, implement INFO_EV_PORT_LOCATION or INFO_MULTI_LOCATIONS

Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13

INFO_FUEL_TYPE

List of fuels the vehicle may use. FuelType::FUEL_TYPE_ELECTRIC must only be included if the vehicle can plug-in rechargeable. For example, a Fully Hybrid Electric Vehicle (FHEV) must not include FuelType::FUEL_TYPE_ELECTRIC as the INT32_VEC value for INFO_FUEL_TYPE INFO_FUEL_TYPE can be populated as such.

int32Values = { FuelType::FUEL_TYPE_UNLEADED }

Change mode: STATIC
Access mode: READ
Enum type: FuelType
Unit type: N/A
Release: Android 13

INFO_MAKE

Manufacturer of vehicle. This property must communicate the vehicle's public brand name.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

INFO_MODEL

Model of vehicle. This property must communicate the vehicle's public model name.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

INFO_MODEL_YEAR

Model year of vehicle in `YYYY` format based on the Gregorian calendar.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:YEAR
Release: Android 13

INFO_MULTI_EV_PORT_LOCATIONS

Multiple EV port locations. Implement this property if the vehicle has multiple EV ports. Port locations are defined in PortLocationType. For example, a car has one port front left and one port rear left:

int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT

If a vehicle has only one port, this property's value should list one element. To describe one port location, see INFO-EV-PORT-LOCATION

Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13

INFO_VIN

VIN of vehicle.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

INITIAL_USER_INFO

Defines the Android user to be used during initialization. This property is called by the Android system when it initializes and lets the HAL define which Android user should be started. This request is made by setting a VehiclePropValue (defined by InitialUserInfoRequest), and the HAL must respond with a property change event (defined by InitialUserInfoResponse). If the HAL doesn't respond after a time defined by the Android system, the Android system proceeds as if HAL returned a response of action InitialUserInfoResponseAction:DEFAULT. For example, on first boot, the request could be:

int32[0] 42  // request id (arbitrary number set by Android system)
int32[1] 1   // InitialUserInfoRequestType::FIRST_BOOT
int32[2] 0   // id of current user (usersInfo.currentUser.userId)
int32[3] 1   // flag of current user (usersInfo.currentUser.flags = SYSTEM)
int32[4] 1   // number of existing users (usersInfo.numberUsers);
int32[5] 0   // user #0  (usersInfo.existingUsers[0].userId)
int32[6] 1   // flags of user #0  (usersInfo.existingUsers[0].flags)

int32[0] 42  // must match the request id from the request
int32[1] 2   // action = InitialUserInfoResponseAction::CREATE
int32[2] -10000  // userToSwitchOrCreate.userId (not used as user will be created)
int32[3] 8   // userToSwitchOrCreate.flags = ADMIN string: "||Owner" // userLocales + separator + userNameToCreate

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

من ي إلى ر

LANE_CENTERING_ASSIST_COMMAND

Lane Centering Assist (LCA) commands. Commands to activate and suspend LCA. When the command ACTIVATE from LaneCenteringAssistCommand is sent, LANE_CENTERING_ASSIST_STATE must be set to LaneCenteringAssistState#ACTIVATION_REQUESTED When the ACTIVATE command succeeds, LANE_CENTERING_ASSIST_STATE must be set to LaneCenteringAssistState#ACTIVATED When the command DEACTIVATE from LaneCenteringAssistCommand succeeds, LANE_CENTERING_ASSIST_STATE must be set to LaneCenteringAssistState#ENABLED

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues must be defined unless all enum values of LaneCenteringAssistCommand are supported. When this property is not available because LCA is disabled (for example, LANE_CENTERING_ASSIST_ENABLED is false), this property must return StatusCode#NOT_AVAILABLE_DISABLED If LANE_CENTERING_ASSIST_STATE is implemented and the state is set to an ErrorState value, then this property must return a StatusCode that aligns with the ErrorState value. For example, if LANE_CENTERING_ASSIST_STATE is set to ErrorState#NOT_AVAILABLE_SPEED_LOW then this property must return StatusCode#NOT_AVAILABLE_SPEED_LOW

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: LaneCenteringAssistCommand
Unit type: N/A
Release: Android 14

LANE_CENTERING_ASSIST_ENABLED

Enable or disable Lane Centering Assist (LCA). Set true to enable LCA and false to disable LCA. When LCA is enabled, the ADAS system in the vehicle should be turned on and waiting for an activation signal from the driver. Once the feature is activated, the ADAS system should be steering the vehicle to keep it centered in its current lane.

This is different from Lane Keep Assist (LKA) which monitors if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane. In general, LANE_CENTERING_ASSIST_ENABLED should always return true or false. If the feature is not available due to some temporary state, such as the vehicle speed being too low or too high, that information must be conveyed through the ErrorState values in the LANE_CENTERING_ASSIST_STATE property.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

LANE_CENTERING_ASSIST_STATE

Lane Centering Assist (LCA) state. Returns the current state of LCA. This property must always return a valid state defined in LaneCenteringAssistState or ErrorState It must not surface errors through StatusCode and must use the supported error states instead.

If LCA includes lane departure warnings, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both LaneCenteringAssistState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneCenteringAssistState/ErrorState
Unit type: N/A
Release: Android 14

LANE_DEPARTURE_WARNING_ENABLED

Enable or disable Lane Departure Warning (LDW). Set true to enable LDW and false to disable LDW. When LDW is enabled, the ADAS system in the vehicle should be turned on and monitoring if the vehicle is approaching or crossing lane lines, in which case a warning will be given.

In general, LANE_DEPARTURE_WARNING_ENABLED should always return true or false. If the feature is not available due to some temporary state, such as the vehicle speed being too low or too high, that information must be conveyed through the ErrorState values in the LANE_DEPARTURE_WARNING_STATE property.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

LANE_DEPARTURE_WARNING_STATE

Lane Departure Warning (LDW) state. Returns the current state of LDW. This property must always return a valid state defined in LaneDepartureWarningState or ErrorState It must not surface errors through StatusCode and must use the supported error states instead.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both LaneDepartureWarningState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneDepartureWarningState/ErrorState
Unit type: N/A
Release: Android 14

LANE_KEEP_ASSIST_ENABLED

Enable or disable Lane Keep Assist (LKA). Set true to enable LKA and false to disable LKA. When LKA is enabled, the ADAS system in the vehicle should be turned on and monitoring if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane. This is different from Lane Centering Assist (LCA) which, when activated, applies continuous steering control to keep the vehicle centered in the current lane.

In general, LANE_KEEP_ASSIST_ENABLED should always return true or false. If the feature is not available due to some temporary state, such as the vehicle speed being too low or too high, that information must be conveyed through the ErrorState values in the LANE_KEEP_ASSIST_STATE property.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

LANE_KEEP_ASSIST_STATE

Lane Keep Assist (LKA) state. Returns the current state of LKA. This property must always return a valid state defined in LaneKeepAssistState or ErrorState It must not surface errors through StatusCode and must use the supported error states instead

If LKA includes lane departure warnings before applying steering corrections, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues array must be defined unless all states of both LaneKeepAssistState (including OTHER, which is not recommended) and ErrorState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneKeepAssistState/ErrorState
Unit type: N/A
Release: Android 14

LOCATION_CHARACTERIZATION

Characterization of inputs used for computing location. This property must indicate what (if any) data and sensor inputs are considered by the system when computing the vehicle's location that is shared with Android through the GNSS HAL.

The value must return a collection of bit flags. The bit flags are defined in LocationCharacterization. The value must also include exactly one of DEAD_RECKONED or RAW_GNSS_ONLY among its collection of bit flags.

When this property is not supported, it is assumed that no additional sensor inputs are fused into the GNSS updates provided through the GNSS HAL. That is unless otherwise specified through the GNSS HAL interfaces.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14

MIRROR_AUTO_FOLD_ENABLED

Represents property for Mirror Auto Fold feature. This property is true when the feature for automatically folding the vehicle's side mirrors (for example, when the mirrors fold inward automatically when one exits and locks the vehicle) is enabled.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

MIRROR_AUTO_TILT_ENABLED

Represents property for Mirror Auto Tilt feature. This property is true when the feature for automatically tilting the vehicle's side mirrors (for example, when the mirrors tilt downward automatically when one reverses the vehicle) is enabled.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

MIRROR_FOLD

Mirror fold. True indicates mirrors are folded. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_LOCK

Mirror lock. True indicates mirror positions are locked and not changeable. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Y_MOVE

Mirror Y move. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The maxInt32Value represents the maximum movement speed of the mirror while tilting right. The minInt32Value represents the maximum movement speed of the mirror while tilting left.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the mirror reaches the positional limit, the value must reset to 0. If MIRROR_Y_MOVE's value is currently 0, then that means there is no movement currently occurring.

This property is not in any particular unit but in a specified range of relative movement speeds.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Y_POS

Mirror Y position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the mirror is tilted completely to the left.

This must be a non-positive value. The maxInt32Value indicates the mirror is tilted completely to the right. This must be a non-negative value. 0 indicates the mirror is not tilted in either direction.

Values in between minInt32Value and maxInt32Value indicate a transition state between the left extreme and right extreme positions.

This property is not in any particular unit but in a specified range of relative positions.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Z_MOVE

Mirror Z move. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The maxInt32Value represents the maximum movement speed of the mirror while tilting upwards. The minInt32Value represents the maximum movement speed of the mirror while tilting downwards. Larger absolute values, either positive or negative, indicate a faster movement speed. Once the mirror reaches the positional limit, the value must reset to 0. If MIRROR_Z_MOVE's value is currently 0, then that means there is no movement currently occurring.

This property is not in any particular unit but in a specified range of relative movement speeds.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

MIRROR_Z_POS

Mirror Z position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the mirror is tilted completely downwards. This must be a non-positive value. The maxInt32Value indicates the mirror is tilted completely upwards. This must be a non-negative value. 0 indicates the mirror is not tilted in either direction.

Values in between minInt32Value and maxInt32Value indicate a transition state between the fully downward and fully upwards positions.

This property is not in any particular unit but in a specified range of relative positions.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

NIGHT_MODE

True indicates that the night mode sensor has detected the car cabin environment to have low light. The platform can use this to, for example, enable an appropriate UI for better viewing in dark or low light environments.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_FREEZE_FRAME

Reports a snapshot of the value of the OBD2 sensors available at the time that a fault occurred and was detected. A configArray must be provided with the same meaning as defined for OBD2_LIVE_FRAME

The values of this property are to be interpreted in a similar fashion as those for OBD2_LIVE_FRAME, with the exception that the stringValue field may contain a non-empty diagnostic troubleshooting code (DTC).

An IVehicle#get request of this property must provide a value for int64Values[0]. This is interpreted as the timestamp of the freeze frame to retrieve. A list of timestamps can be obtained by an IVehicle#get of OBD2_FREEZE_FRAME_INFO

Should no freeze frame be available at the given timestamp, a response of NOT_AVAILABLE must be returned by the implementation. Because vehicles may have limited storage for freeze frames, it is possible for a frame request to respond with NOT_AVAILABLE even if the associated timestamp has been recently obtained through OBD2_FREEZE_FRAME_INFO

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_FREEZE_FRAME_CLEAR

Freeze frame clear. Reports a snapshot of the value of the OBD2 sensors available at the time that a fault occurred and was detected. A configArray must be provided with the same meaning as defined for OBD2_LIVE_FRAME

The values of this property are to be interpreted in a similar fashion as those for OBD2_LIVE_FRAME, with the exception that the stringValue field may contain a non-empty diagnostic troubleshooting code (DTC).

A IVehicle#get request of this property must provide a value for int64Values[0]. This will be interpreted as the timestamp of the freeze frame to retrieve. A list of timestamps can be obtained by a IVehicle#get of OBD2_FREEZE_FRAME_INFO

Should no freeze frame be available at the given timestamp, a response of NOT_AVAILABLE must be returned by the implementation. Because vehicles may have limited storage for freeze frames, it is possible for a frame request to respond with NOT_AVAILABLE even if the associated timestamp has been recently obtained via OBD2_FREEZE_FRAME_INFO

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_FREEZE_FRAME_INFO

This property describes the current freeze frames stored in vehicle memory and available for retrieval through OBD2_FREEZE_FRAME The values are to be interpreted as follows. Each element of int64Values must be the timestamp at which a a fault code has been detected and the corresponding freeze frame stored, and each such element can be used as the key to OBD2_FREEZE_FRAME to retrieve the corresponding freeze frame.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

OBD2_LIVE_FRAME

Reports a snapshot of the current (live) values of the OBD2 sensors available. The configArray is set as follows:

• configArray[0] Number of vendor-specific integer-valued sensors
• configArray[1] Number of vendor-specific float-valued sensors

The values of this property are to be interpreted as in the following example. Considering a configArray = {2,3} int32Values must be a vector containing Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX plus two elements (or, 33 elements). floatValues must be a vector containing Obd2FloatSensorIndex.LAST_SYSTEM_INDEX plus three elements (or, 73 elements).

It is possible for each frame to contain a different subset of sensor values, both system provided sensors, and vendor-specific ones. In order to support this, the bytes element of the property value is used as a bitmask. Bytes must have a sufficient number of bytes to represent the total number of possible sensors (in this case, 14 bytes to represent 106 possible values). It'is to be read as a contiguous bitmask such that each bit indicates the presence or absence of a sensor from the frame, starting with as many bits as the size of int32Values, immediately followed by as many bits as the size of floatValues.

For example, should bytes[0] = 0x4C (0b01001100) it means that:

• int32Values[0 and 1] are not valid sensor values
• int32Values[2 and 3] are valid sensor values
• int32Values[4 and 5] are not valid sensor values
• int32Values[6] is a valid sensor value
• int32Values[7] is not a valid sensor value
• int32Values[0 and 1] are not valid sensor values
• int32Values[2 and 3] are valid sensor values
• int32Values[4 and 5] are not valid sensor values
• int32Values[6] is a valid sensor value
• int32Values[7] is not a valid sensor value

If bytes[5] = 0x61 (0b01100001), then:

• int32Values[32] is a valid sensor value
• floatValues[0 thru 3] are invalid sensor values
• floatValues[4 and 5] are valid sensor values
• floatValues[6] is not a valid sensor value.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

ON_CHANGE

Change mode:
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type:N/A
Release: Android 13

PARKING_BRAKE_AUTO_APPLY

Auto-apply parking brake. When true, this property indicates that the car's automatic parking brake is enabled. False indicates that the car's automatic parking brake feature is disabled. This property is often confused with PARKING_BRAKE_ON The difference being that PARKING_BRAKE_ON indicates if the actual parking brake is on or off whereas PARKING_BRAKE_AUTO_APPLY indicates if the automatic parking brake feature is enabled or disabled and does not describe the current state of the actual parking brake.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

PARKING_BRAKE_ON

Parking brake state. When true, this property true indicates that the car's parking brake is engaged. False indicates the car's parking brake is disengaged.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

PER_DISPLAY_BRIGHTNESS

Property to represent brightness of the displays which are controlled separately. Some cars have one or more displays whose brightness is controlled separately and this property is to inform the brightness of each passenger display. In cars where all displays' brightness is controlled together, they must use DISPLAY_BRIGHTNESS

Only one of PER_DISPLAY_BRIGHTNESS andPER_DISPLAY_BRIGHTNESS should be implemented. If both are available, PER_DISPLAY_BRIGHTNESS is used by AAOS.

The display port uniquely identifies a physical connector on the device for display output, ranging from 0 to 255.

• int32Values[0] Display port
• int32Values[1] Brightness

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 14

PERF_ODOMETER

Current odometer value of the vehicle.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOMETER
Release: Android 13

PERF_REAR_STEERING_ANGLE

Rear bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the rear wheels with respect to the vehicle, not the angle of the steering wheel.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13

PERF_STEERING_ANGLE

Front bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the front wheels with respect to the vehicle, not the angle of the steering wheel.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13

PERF_VEHICLE_SPEED

Speed of the vehicle, The value must be positive when the vehicle is moving forward and negative when the vehicle is reversing. This value is independent of gear value (CURRENT_GEAR or GEAR_SELECTION). For example, if GEAR_SELECTION is GEAR_NEUTRAL, PERF_VEHICLE_SPEED is positive when the vehicle is moving forward, negative when reversing, and zero when not moving.

Change mode: CONTINUOUS
Access mode: READ
Unit type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13

PERF_VEHICLE_SPEED_DISPLAY

Speed of the vehicle for displays, Some cars display a slightly slower speed on the speedometer than actual speed.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13

POWER_POLICY_GROUP_REQ

Defines a request to set the power policy group used to decide a default power policy per power status transition.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

POWER_POLICY_REQ

Defines a request to apply power policy. VHAL sets this property to change car power policy. Car power policy service subscribes to this property and actually changes the power policy. The request is made by setting the VehiclePropValue with the ID of a power policy which is defined at /vendor/etc/automotive/power_policy.xml If the given ID is not defined, car power policy service ignores the request and the current power policy is maintained.

string: "sample_policy_id" // power policy ID

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

POWER_POLICY_GROUP_REQ

Defines a request to set the power policy group used to decide a default power policy per power status transition. VHAL sets this property with the ID of a power policy group to set the default power policy applied at power status transition. Power policy groups are defined at /vendor/etc/power_policy.xml. If the given ID is not defined, car power policy service ignores the request. Car power policy service subscribes to this property and sets the power policy group. The actual application of power policy takes place when the system power status changes and there is a valid mapped power policy for the new power status.

string: "sample_policy_group_id" // power policy group ID

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

RANGE_REMAINING

Range remaining. Meters remaining of fuel and charge. Range remaining shall account for all energy sources in a vehicle. For example, a hybrid car's range is the sum of the ranges based on fuel and battery. This property is defined as VehiclePropertyAccess.READ_WRITE because a navigation app could update the range if it has a more accurate estimate based on the upcoming route. This property can be implemented as VehiclePropertyAccess.READ only at the OEM's discretion.

Change mode: CONTINUOUS
Access mode: READ_WRITE
Enum type: N/A
Unit type: VehicleUnit:METER
Release: Android 13

READING_LIGHTS_STATE

Return the current status of reading lights.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

READING_LIGHTS_SWITCH

Switch t control the reading lights. This may differ from READING_LIGHTS_STATE if the lights are on because a door is open or due to a voice command. For example, while the switch is in the off or automatic position. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

REAR_FOG_LIGHTS_STATE

Return the current state of the rear fog lights. Only one of FOG_LIGHTS_STATE or REAR_FOG_LIGHTS_STATE can be implemented. See FOG_LIGHTS_STATE

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13

REAR_FOG_LIGHTS_SWITCH

The setting that the user wants. Only one of FOG_LIGHTS_SWITCH or REAR_FOG_LIGHTS_SWITCH must be implemented. See FOG_LIGHTS_SWITCH to learn more. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READonly.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13

REMOVE_USER

Called by the Android System after an Android user was removed. The HAL can use this property to remove the equivalent user. This is write-only cal. The Android System is not expecting a reply from the HAL. Hence, this request should not fail. If the equivalent HAL user cannot be removed, then HAL should mark it as inactive or recover in another way.

The request is made by setting the VehiclePropValue with the contents defined by RemoveUserRequest For example, if system had 3 users (0, 10, and 11) and user 11 was removed, the request would be:

• int32[0] 42 // request id
• int32[1] 11 // (Android user id of the removed user)
• int32[2] 0 // (Android user flags of the removed user)
• int32[3] 10 // current user
• int32[4] 0 // current user flags (none)
• int32[5] 2 // number of users
• int32[6] 0 // first user (user 0)
• int32[7] 0 // first user flags (none)
• int32[8] 10 // second user (user 10)
• int32[9] 0 // second user flags (none)

Change mode: STATIC
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

من ي إلى ي

SEAT_AIRBAG_ENABLED

يمثّل هذه الميزة التي تتيح تفعيل أو إيقاف قدرة المقعد على انتفاخ الوسائد الهوائية عند بدء تشغيلها (على سبيل المثال، في حالة حدوث تصادم). إذا كانت القيمة true، يعني ذلك أنّ أكياس الهواء في المقعد مفعّلة، وفي حال تنشيطها، يتم نشرها. إذا كانت القيمة true، تكون أكياس الهواء في المقعد غير مفعَّلة، ولا يتم تفعيلها في أيّ ظروف. لا تشير هذه السمة إلى ما إذا تم تفعيل أكياس الهواء.

يمكن ضبط هذه السمة على VehiclePropertyAccess.READ للقراءة فقط بغرض الامتثال للوائح التنظيمية أو لأسباب تتعلق بالسلامة.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_BACKREST_ANGLE_1_MOVE

زاوية مسند الظهر في المقعد: حركة واحدة يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. تمثّل السمة maxInt32Value الحد الأقصى لسرعة حركة مسند ظهر المقعد مع تحريكه للأمام. يمثّل الرمز minInt32Value أقصى سرعة للحركة في مسند ظهر المقعد عند الاستلقاء.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند ظهر المقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_BACKREST_ANGLE_1_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة في نطاق محدّد من سرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_BACKREST_ANGLE_1_POS

زاوية مسند الظهر للمقعد، موضع 1 زاوية مسند الظهر 1 هي المحرّك الأقرب إلى أسفل المقعد. يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. يشير الرمز minInt32Value إلى موضع الاستلقاء الكامل لمسند ظهر المقعد بالنسبة إلى المحرِّك في أسفل المقعد. أمّا السمة maxInt32Value، فيشير إلى أقصى وضع مستقيم أو أمامي لمسند المقعد في ما يتعلق بالمشغّل في أسفل المقعد.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين وضع الاستلقاء الكامل والوضعين المنتصب والمتقدم.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

تم تحديد هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_BACKREST_ANGLE_2_MOVE

زاوية مسند الظهر للمقعد: حركة 2 يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

تمثّل السمة maxInt32Value الحد الأقصى لسرعة حركة مسند ظهر المقعد مع تحريكه للأمام. يمثّل الرمز minInt32Value أقصى سرعة للحركة في مسند الظهر المقعد أثناء الاستلقاء.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند ظهر المقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_BACKREST_ANGLE_2_MOVE هي 0 حاليًا، يعني ذلك أنّه لا يتم إجراء أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_BACKREST_ANGLE_2_POS

الموضع 2 من زاوية مسند ظهر المقعد زاوية مسند الظهر 2 هي المحرّك التالي من أسفل المقعد.

يجب تحديد السمتَين maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value مسموحًا بها.

يشير الرمز minInt32Value إلى موضع الاستلقاء الكامل لمسند ظهر المقعد بالنسبة إلى المحرّك التالي في مسند الظهر من المحرّك في أسفل المقعد (راجِع SEAT_BACKREST_ANGLE_1_POS لمعرفة التفاصيل). يشير الرمز maxInt32Value إلى موضع مسند ظهر المقعد الأكثر استقامةً وإلى الأمام بالنسبة إلى المحرّك التالي في مسند الظهر من المحرّك في أسفل المقعد (راجِع SEAT_BACKREST_ANGLE_1_POS للاطّلاع على التفاصيل).

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين الوضعين الكاملَين للانحناء والوضعَين المنتصبَين للأمام والخلف.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_BELT_BUCKLED

تم تثبيت حزام الأمان. تشير القيمة true إلى أنّ الحزام مشدود. يشير إذن الوصول للكتابة إلى إمكانيات ربط أحزمة الأمان التلقائية. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_BELT_HEIGHT_MOVE

تغيير ارتفاع حزام الأمان يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يمثّل maxInt32Value الحد الأقصى لسرعة حركة مثبّت الكتف الخاص بحزام المقعد أثناء التحرك للأعلى. يمثّل الرمز minInt32Value الحد الأقصى لسرعة التحرك لمشبك حزام الأمان على الكتف أثناء التحرك للأسفل.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل حزام المقعد إلى الحد الأقصى لتحديد الموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_BELT_HEIGHT_MOVE هي 0، يعني ذلك أنّه لا يتم تنفيذ أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_BELT_HEIGHT_POS

موضع ارتفاع حزام الأمان لضبط نقطة تثبيت حزام الكتف

يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يشير الرمز minInt32Value إلى أنّ حلقة تثبيت حزام الأمان على الكتف في أدنى موضع لها. يشير الرمز maxInt32Value إلى أنّ حلقة تثبيت حزام الأمان على الكتف في أعلى موضع لها.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أدنى وأعلى المواقف.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_CUSHION_SIDE_SUPPORT_MOVE

يمثّل سمة لاتجاه الحركة وسرعة الدعم الجانبي لكرسي المقعد.

يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value مسموحًا بها.

يمثّل maxInt32Value الحد الأقصى لسرعة حركة جانب وسادة المقعد عند توسيع العرض (على سبيل المثال، ينخفض الدعم). يمثّل minInt32Value الحد الأقصى لسرعة حركة الدعم الجانبي لكرسي المقعد عند تناقص عرضه (على سبيل المثال، يزداد الدعم).

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند جانبي وسادة المقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_CUSHION_SIDE_SUPPORT_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_CUSHION_SIDE_SUPPORT_POS

يمثّل هذا السمة موضع الدعم في منطقة الورك (جانب الوسادة السفلية) في المقعد.

يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب إدخال كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value.

يشير الرمز maxInt32Value إلى أنّ الوسادة الجانبية للوسادة في أوسع موضع لها (على سبيل المثال، أقل دعم). يشير الرمز minInt32Value إلى أنّ الدعم الجانبي لوسادة المقعد في أدنى كثافة (على سبيل المثال، أقصى دعم).

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقالية بين مواضع الخطوط الأكثر رقةً والأكثر اتساعًا.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي السيارات تنفيذها على أنّها <covehiclepropertyaccess.read< code=""> فقط.</covehiclepropertyaccess.read<>

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_DEPTH_MOVE

تحريك عمق المقعد

يجب تحديد السمتَين maxInt32Value وminInt32Value في كل فئة "مركبة" في "مساحة التخزين". يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value مسموحًا بها.

يمثّل الرمز maxInt32Value أقصى سرعة حركة للمقعد أثناء انحداره إلى أسفل. ويمثّل الرمز minInt32Value أقصى سرعة حركة للمقعد أثناء انحداره إلى أعلى.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند ظهر المقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_DEPTH_MOVE هي 0 حاليًا، يعني ذلك أنّه لا يتم إجراء أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_DEPTH_POS

موضع عمق المقعد لضبط عمق المقعد والمسافة من مسند الظهر إلى الحافة الأمامية للمقعد

يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب إدخال كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value.

يشير الرمز minInt32Value إلى أنّ المقعد في أدنى وضع له (على سبيل المثال، الوضع الذي يضم أصغر مسافة بين الحافة الأمامية لكرسي المقعد ومؤخرته).

يشير الرمز maxInt32Value إلى أنّ المقعد في وضعه الأكثر انخفاضًا (على سبيل المثال، الوضع الذي يضم أكبر مسافة بين الحافة الأمامية لكرسي المقعد ومؤخرته).

تشير القيم التي تقع بين minInt32Value وmaxInt32Value إلى حالة انتقال بين المواضع سطحًا وأعمق.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها <covehiclepropertyaccess.read< code=""> فقط..</covehiclepropertyaccess.read<>

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_EASY_ACCESS_ENABLED

لتمثيل خاصية لميزة الوصول السهل إلى المقعد إذا كان صحيحًا، يتم ضبط المقعد تلقائيًا لتسهيل دخول الراكب إلى المركبة والخروج منها. يجب ربط كل رقم تعريف منطقة بالمقعد الذي يحاول المستخدم الدخول إليه أو الخروج منه من خلال ميزة الوصول السهل. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي السيارات تنفيذها على أنّها <covehiclepropertyaccess.read< code=""> فقط.</covehiclepropertyaccess.read<>

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

ولاية SEAT_FOOTWELL_LIGHTS_state

يمثّل سمة لحالة مصابيح القدم في المقعد. يعرض SEAT_FOOTWELL_LIGHTS_STATE الحالة الحالية للمصابيح في أي وقت. يختلف ذلك عن وظيفة SEAT_FOOTWELL_LIGHTS_SWITCH التي تمثّل موضع المفتاح الذي يتحكّم في الأضواء.

لذلك، قد لا تتطابق قيمة SEAT_FOOTWELL_LIGHTS_STATE مع قيمة SEAT_FOOTWELL_LIGHTS_SWITCH (على سبيل المثال، SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC وSEAT_FOOTWELL_LIGHTS_SWITCH=ON).

يجب عدم تنفيذ هذه السمة إلا إذا كانت قيمة SEAT_FOOTWELL_LIGHTS_STATE قد تكون مختلفة عن قيمة CABIN_LIGHTS_STATE.

لكل رقم تعريف منطقة متوافق، يجب تحديد VehicleAreaConfig#supportedEnumValues ما لم يكن جميع قيم التعداد الخاصة بـ VehicleLightState متوافقة.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleLightState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_FOOTWELL_LIGHTS_SWITCH

يمثّل خاصيّة لمفتاح أضواء منطقة القدمين في المقعد. يمثّل الرمز SEAT_FOOTWELL_LIGHTS_SWITCH موضع مفتاح التحكّم في المصابيح. يختلف ذلك عن وظيفة دالة SEAT_FOOTWELL_LIGHTS_STATE التي تعرض الحالة الحالية للأضواء في أي وقت. لذلك، قد لا تتطابق القيمة SEAT_FOOTWELL_LIGHTS_SWITCH مع قيمة SEAT_FOOTWELL_LIGHTS_STATE (على سبيل المثال، SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC وSEAT_FOOTWELL_LIGHTS_SWITCH=ON).

يجب تنفيذ هذه السمة فقط إذا كانت قيمة SEAT_FOOTWELL_LIGHTS_SWITCH مختلفة عن قيمة CABIN_LIGHTS_SWITCH.

بالنسبة إلى كل رقم تعريف منطقة متوافق، يجب تحديد قيمة OrganizationAreaConfig#supportedEnumValues الخاصة بك إلّا إذا كانت جميع قيم التعداد الخاصة بـ AutomotiveLightSwitch متوافقة.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: AutomotiveLightSwitch
نوع الوحدة: لا تنطبق
الإصدار: Android 13

SEAT_FORE_AFT_MOVE

حركة المقعد إلى الأمام والخلف تؤدي هذه السمة إلى تحريك المقعد بالكامل للأمام/الخلف في الاتجاه الذي يواجهه.

يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value مسموحًا بها.

تمثّل السمة maxInt32Value أقصى سرعة لحركة المقعد أثناء السير للأمام. يمثّل الرمز minInt32Value الحد الأقصى لسرعة حركة المقعد أثناء التحرك للخلف.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_FORE_AFT_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_FORE_AFT_POS

موضع المقعد الأمامي والخلفي لضبط موضع المقعد للأمام وللخلف

يجب تحديد سمتَي maxInt32Value وminInt32Value في AutomotiveAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يشير الرمز minInt32Value إلى أنّ المقعد في أقصى موضع خطي خلفي. يشير الرمز maxInt32Value إلى أنّ المقعد في أقصى موضع أمامي خطي. تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أقرب موضع وأبعد موضع.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEADREST_ANGLE_MOVE

يتم تحريك زاوية مسند الرأس. يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يمثّل الرمز maxInt32Value الحد الأقصى لسرعة حركة مسند الرأس في المقعد أثناء الانتقال إلى وضع مستقيم أو إلى الأمام. يمثّل minInt32Value الحد الأقصى لسرعة حركة مسند الرأس في المقعد أثناء الانتقال إلى موضع منخفض.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد بلوغ مسند الرأس في المقعد الحدّ الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_HEADREST_ANGLE_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي السيارات تنفيذها على أنّها <covehiclepropertyaccess.read< code=""> فقط..</covehiclepropertyaccess.read<>

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEADREST_ANGLE_POS

موضع زاوية مسند الرأس يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يشير الرمز minInt32Value إلى أنّ مسند الرأس في وضع الاستلقاء الكامل. يشير الرمز maxInt32Value إلى أنّ مسند الرأس في وضعه الأكثر استقامةً وإلى الأمام.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين وضع الاستلقاء الكامل والموضع الأكثر استقامةً وإلى الأمام.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEADREST_FORE_AFT_MOVE

يمكن تحريك مسند الرأس للأمام والخلف. يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يمثّل maxInt32Value الحد الأقصى لسرعة حركة مسند رأس المقعد أثناء السير للأمام. وتمثّل السمة minInt32Value الحد الأقصى لسرعة حركة مسند الرأس عند التحرك للخلف.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند الرأس في المقعد إلى الحد الأقصى للوضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_HEADREST_FORE_AFT_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEADREST_FORE_AFT_POS

موضع مسند الرأس الأمامي والخلفي يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يشير الرمز minInt32Value إلى أنّ مسند الرأس في أقصى موضع خطي خلفي. يشير الرمز maxInt32Value إلى أنّ مسند الرأس في أقصى موضع أمامي.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين الوضعَين "إلى الأمام" و"إلى الخلف".

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEADREST_HEIGHT_MOVE

تحريك ارتفاع مسند الرأس يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يمثّل maxInt32Value الحد الأقصى لسرعة حركة مسند رأس المقعد أثناء التحرك للأعلى. وتمثّل السمة minInt32Value الحد الأقصى لسرعة حركة مسند رأس المقعد أثناء التحرك للأسفل.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند الرأس في المقعد إلى الحد الأقصى للوضع، يجب إعادة ضبط القيمة على 0. وإذا كانت قيمة SEAT_HEADREST_HEIGHT_MOVE تساوي 0، لن تحدث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEADREST_HEIGHT_POS

(تم إيقافه نهائيًا) موضع ارتفاع مسند الرأس

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_headREST_HEIGHT_POS_V2

موضع ارتفاع مسند الرأس تتيح هذه السياسة ضبط ارتفاع مسند الرأس في المقاعد المتوافقة. تحدِّد VehiclePropConfig.areaConfigs المقاعد المتوافقة.

يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يشير minInt32Value إلى أنّ مسند الرأس في أدنى موضع. ويشير maxInt32Value إلى أنّ مسند الرأس في أعلى موضع.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أدنى وأعلى المواضع.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_HEIGHT_MOVE

تغيير ارتفاع المقعد يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يمثّل maxInt32Value الحد الأقصى لسرعة حركة المقعد عند التحرك للأعلى.

يمثّل minInt32Value الحد الأقصى لسرعة حركة المقعد عند التحرك للأسفل.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. وإذا كانت قيمة SEAT_HEIGHT_MOVE هي 0، لا تحدث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_HEIGHT_POS

موضع ارتفاع المقعد يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة.

يشير minInt32Value إلى أنّ المقعد في أدنى موضعه. يشير الرمز maxInt32Value إلى أنّ المقعد في أعلى موضع له.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أدنى وأعلى المواضع.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_LUMBAR_FORE_AFT_MOVE

حركة الفقرات القطنية للأمام والخلف يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة.

يمثّل maxInt32Value الحد الأقصى لسرعة حركة مساندة أسفل الظهر في المقعد أثناء التحرك للأمام. يمثّل minInt32Value الحد الأقصى لسرعة الحركة لمساندة أسفل الظهر في المقعد أثناء التحرك للخلف.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند الظهر القطني إلى الحد الأقصى للوضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_LUMBAR_FORE_AFT_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_LUMBAR_FORE_AFT_POS

موضع الخشب في الأمام والخلف يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة.

يشير الرمز minInt32Value إلى أنّ دعامة أسفل الظهر في أقصى موضع خلفي (على سبيل المثال، الموضع الأقل دعمًا). يشير الرمز maxInt32Value إلى أنّ داعِم المنطقة القطنية في أقصى موضع أمامي (على سبيل المثال، الموضع الأكثر دعمًا).

تشير القيم التي تقع بين minInt32Value وmaxInt32Value إلى حالة انتقال بين الموضعَين الأمامي والخلفي.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
نوع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

تحريك الدعم الجانبي لأسفل الظهر يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة.

يمثّل الرمز maxInt32Value الحد الأقصى لسرعة حركة مسند الظهر الجانبي في المقعد أثناء توسيع نطاق الحركة. يمثّل الرمز minInt32Value الحد الأقصى لسرعة التنقّل في الدعامة الجانبية للفقرات القطنية في المقعد أثناء تناقص سمكها.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد بلوغ حد أسفل الظهر في المقعد الحدّ الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_LUMBAR_SIDE_SUPPORT_MOVE هي 0، يعني ذلك عدم حدوث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
نوع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_POS

موضع الدعم الجانبي لأسفل الظهر يجب تحديد السمتَين maxInt32Value وminInt32Value في AutomotiveAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة. يشير الرمز minInt32Value إلى أنّ الدعم الجانبي للفقرات القطنية في أدنى وضع له (على سبيل المثال، أقصى دعم). ويشير maxInt32Value إلى أنّ دعامة الظهر لأسفل هي في أوسع موضع (مثلاً، أقل دعم).

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أرق موضع وأوسع موضع.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
نوع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_LUMBAR_VERTICAL_MOVE

يمثّل سمة لاتجاه الحركة العمودية وسرعة دعم أسفل الظهر في المقعد.

يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. يشير الرمز maxInt32Value إلى أنّ دعامة أسفل الظهر تتحرك بأسرع سرعة للأعلى. يشير الرمز minInt32Value إلى أنّ دعامة أسفل الظهر تتحرك بأسرع سرعة للأسفل.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن يصل مسند جانبي وسادة المقعد إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_LUMBAR_VERTical_MOVE هي 0، لن تحدث أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_LUMBAR_VERTICAL_POS

يمثّل سمة لموضع عمود الدعم القطني في المقعد. يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. يشير الرمز maxInt32Value إلى أعلى موضع للدعم القطني. أما القيمة minInt32Value، فيشير إلى أدنى موضع لدعامة الظهر.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أدنى وأعلى المواضع.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_MEMORY_SELECT

تختار هذه المَعلمة الذاكرة المُعدّة مسبقًا لاستخدامها في اختيار موضع المقعد. يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. تكون قيمة minInt32Value دائمًا 0، ويكون maxInt32Value هو العنصر الذي يحدِّد عدد خانات الذاكرة المتاحة لإعدادات المقاعد المُعدّة مسبقًا (على سبيل المثال، numSeatPresets - 1). على سبيل المثال، إذا كان مقعد السائق يتضمّن ثلاثة إعدادات مسبقة للذاكرة، يكون maxInt32Value هو اثنان. عندما يختار المستخدم إعدادًا مُسبَقًا، يتم ضبط الرقم المطلوب للإعداد المُسبَق (0 أو 1 أو 2).

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_MEMORY_SET

يتيح هذا الإعداد للمستخدم حفظ إعدادات موضع المقعد الحالي في الخانة المحدّدة مسبقًا المحددة. يجب تحديد السمتَين maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن يكون minInt32Value يساوي 0، ويجب أن يتطابق maxInt32Value لكل موضع مقعد مع maxInt32Value لملف SEAT_MEMORY_SELECT.

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

سيات_OCCUPANCY

تشير إلى ما إذا كان مقعد معيّن مشغولاً، وذلك حسب قدرة السيارة على تحديد ذلك. يجب أن تكون القيم الصالحة من التعداد VehicleSeatOccupancyState.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleSeatOccupancyState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_TILT_MOVE

حركة إمالة المقعد يجب تحديد السمتَين maxInt32Value وminInt32Value في كل "مركبةAreaConfig". يجب أن تكون كل الأعداد الصحيحة بين minInt32Value وmaxInt32Value متوافقة. يمثّل الرمز maxInt32Value الحد الأقصى لسرعة حركة الحافة الأمامية للمقعد أثناء التحرك للأعلى. يمثّل الرمز minInt32Value الحد الأقصى لسرعة حركة الحافة الأمامية المقعد أثناء التحرك للأسفل.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. وبعد وصول أسفل المقعد إلى الحد الأقصى لموضع الإعلان، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة SEAT_TILT_MOVE هي 0 حاليًا، لن تكون هناك حركة قيد التطبيق.

يتم تمثيل هذه السمة كنطاق محدّد لسرعات الحركة النسبية.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SEAT_TILT_POS

وضع إمالة المقعد يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة. أمّا السمة minInt32Value، فتشير إلى أنّ المقعد السفلي مضبوط على زاوية أدنى موضع زاوٍ له. يتوافق ذلك مع الحافة الأمامية للمقعد في أدنى موضع ممكن بالنسبة إلى الطرف الخلفي للمقعد. يشير الرمز maxInt32Value إلى أنّ الجزء السفلي من المقعد مائل إلى أعلى مستوى زاوي. ويتوافق ذلك مع الحافة الأمامية للمقعد في أعلى موضع ممكن بالنسبة إلى القسم الخلفي من المقعد.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أدنى وأعلى المواضع.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SEAT_WALK_IN_POS

يمثّل سمة تشير إلى موضع الجلسة الحالي للدخول. يشير الرمز minInt32Value إلى موضع المقعد العادي. يجب أن تكون قيمة minInt32Value 0. يشير الرمز maxInt32Value إلى أنّ المقعد في وضع العبور الكامل.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين الوضعَين العادي والمشي.

يتم تمثيل هذه الخاصية كنطاق محدد من المواضع النسبية.

يجب أن يتطابق معرّف المنطقة مع المقعد الذي يتحرك فعليًا عند تفعيل ميزة "المشي"، وليس المقعد المقصود الذي سيجلس فيه الركاب.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للسيارات

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SHUTDOWN_REQUEST

اطلب إيقاف تشغيل الوحدة الرئيسية.

هذا الإجراء مطلوب لتنفيذ مهمة عندما يكون نظام التحكّم الرئيسي في السيارة مطفأً (ميزة المهام عن بُعد). بعد تشغيل الوحدة الرئيسية لتنفيذ المهمة، يجب إيقاف تشغيلها. وترسِل الوحدة الرئيسية هذه الرسالة بعد انتهاء المهمة.

لا ينطبق هذا السمة عندما يريد المستخدم إيقاف تشغيل وحدة التحكّم.

ويتضمن ذلك عادةً إرسال إشارة إلى نظام منفصل خارج الوحدة الرئيسية (مثل وحدة التحكّم في الطاقة) للاستعداد لإيقاف الوحدة الرئيسية.

يجب أن يُثبت النظام الخارجي صلاحية هذا الطلب من خلال التحقّق مما إذا كانت المركبة في استخدام. إذا دخل أحد المستخدمين إلى المركبة بعد إرسال SHUTDOWN_REQUEST، يجب أن يتجاهل النظام هذا الطلب. يُنصح بتخزين السمة AutomotiveInUse في وحدة التحكّم في الطاقة وإبرازها من خلال السمة VEHICLE_IN_USE. يجب تجاهل طلب إيقاف التشغيل إذا تم ضبط حالة نقطة OnHub على صحيح.

إذا كان مسموحًا به، يرسل النظام الخارجي إشارة إيقاف إلى الوحدة الرئيسية، ما يؤدي إلى إرسال VHAL رسالة SHUTDOWN_PREPARE إلى Android. سيبدأ Android بعد ذلك عملية إيقاف التشغيل من خلال معالجة الرسالة.

هذه السمة مخصّصة فقط لإصدار طلب وتتيح الكتابة فقط. في كل مرة يتم فيها ضبط قيمة هذه الخاصية، يتم إصدار طلب لإيقاف التشغيل بغض النظر عن قيمة الخاصية الحالية. إنّ قيمة الخاصية الحالية لا معنى لها.

بما أنّ هذا الموقع مخصّص للكتابة فقط، لا يُسمح بالاشتراك ولا يتم إنشاء حدث تغيير موقع.

تشير القيمة المطلوب ضبطها إلى خيار إيقاف التشغيل، يجب أن تكون واحدة من {@code VehicleApPowerStateShutdownParam} مثل VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY. وقد لا يتم الالتزام بخيار إيقاف التشغيل هذا إذا لم يكن النظام يتيح استخدام هذا الخيار. وفي هذه الحالة، لن يتم عرض أي خطأ.

للحصول على معلومات الضبط، يجب أن يتضمّن VehiclePropConfig.configArray علامة بت تجمع القيم في {@code VehicleApPowerStateConfigFlag} للإشارة إلى خيارات الإيقاف المتوافقة.

يعرض رسالة خطأ إذا تعذّر إرسال طلب إيقاف التشغيل إلى النظام الآخر.

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: VehicleApPowerStateShutdownParam>
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_DEPTH_MOVE

حركة عمق عجلة القيادة يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون كل القيم بين minInt32Value وmaxInt32Value متوافقة.

أمّا maxInt32Value، فيشير إلى انطلاق عجلة القيادة بعيدًا عن السائق. يشير الرمز minInt32Value إلى أنّ عجلة القيادة تتحرك باتجاه السائق.

تشير الأعداد الصحيحة الأكبر حجمًا، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن تصل عجلة القيادة إلى الحد الأقصى للوضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة STEERING_WHEEL_DEPTH_MOVE هي 0 حاليًا، يعني ذلك أنّه لا يتم إجراء أي حركة.

يتم تمثيل هذه السمة كنطاق محدّد من سرعات التنقّل النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_DEPTH_POS

موضع عمق عجلة القيادة تبدأ جميع أرقام التعريف الفريدة لمواصفات عجلة القيادة من 0x0BE0.

يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون جميع القيم بين minInt32Value وmaxInt32Value متوافقة. يشير الرمز maxInt32Value إلى موضع عجلة القيادة الأبعد عن السائق. يشير الرمز minInt32Value إلى موضع عجلة القيادة الأقرب إلى السائق.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقالية بين

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_EASY_ACCESS_ENABLED

تم تفعيل ميزة الوصول السهل إلى عجلة القيادة. إذا كان هذا الحقل صحيحًا، يتم تلقائيًا تعديل عجلة القيادة الخاصة بالسائق لتسهيل دخول السائق إلى المركبة والخروج منها.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_HEIGHT_MOVE

حركة ارتفاع عجلة القيادة يجب تحديد السمتَين maxInt32Value وminInt32Value في AutomotiveAreaConfig. يجب أن تكون جميع القيم بين minInt32Value و maxInt32Value متوافقة.

يشير الرمز maxInt32Value إلى أنّ عجلة القيادة تتحرك للأعلى. يشير الرمز minInt32Value إلى أنّ عجلة القيادة تتحرك للأسفل.

تشير الأعداد الصحيحة الأكبر حجمًا، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن تصل عجلة القيادة إلى الحد الأقصى للوضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة السمة STEERING_WHEEL_HEIGHT_MOVE هي 0 حاليًا، هذا يعني أنّه ما مِن حركة في الوقت الحالي.

يتم تمثيل هذه السمة كنطاق محدّد من سرعات التنقّل النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_HEIGHT_POS

موضع ارتفاع عجلة القيادة

يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن تكون كل القيم بين minInt32Value وmaxInt32Value مسموحًا بها. تشير السمة maxInt32Value إلى أنّ عجلة القيادة في أعلى موضع. يشير الرمز minInt32Value إلى أنّ عجلة القيادة في أدنى موضع.

تشير القيم بين minInt32Value وmaxInt32Value إلى حالة انتقال بين أدنى موضع وأعلى موضع.

يتم تمثيل هذه السمة كنطاق محدّد من المواضع النسبية.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

حالة STEERING_WHEEL_LIGHTS_state

حالة مصابيح عجلة القيادة يمثل الوضع الحالي لأضواء عجلة القيادة. ويختلف ذلك عن السمة STEERING_WHEEL_LIGHTS_SWITCH التي تمثّل موضع مفتاح التبديل الذي يتحكّم بالمصابيح. لذلك، قد لا تتطابق القيمة STEERING_WHEEL_LIGHTS_STATE مع قيمة STEERING_WHEEL_LIGHTS_SWITCH (على سبيل المثال، STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC و STEERING_WHEEL_LIGHTS_STATE=ON).

يجب تنفيذ هذه السمة فقط إذا كانت قيمة STEERING_WHEEL_LIGHTS_STATE مختلفة عن قيمة CABIN_LIGHTS_state.

بالنسبة إلى معرّف المنطقة الشاملة (0)، يجب تحديد VehicleAreaConfig#supportedEnumValues ما لم تكن كل قيم التعداد الخاصة بـ VehicleLightState متوافقة.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleLightState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_LIGHTS_SWITCH

مفتاح الإضاءة في عجلة القيادة. يمثّل موضع المفتاح الذي يتحكّم في مصابيح عجلة التوجيه. يختلف ذلك عن رمز الذي يمثّل الحالة الحالية لأضواء عجلة القيادة. لذلك، قد لا تتطابق STEERING_WHEEL_LIGHTS_SWITCH مع قيمة STEERING_WHEEL_LIGHTS_STATE. على سبيل المثال، STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC و STEERING_WHEEL_LIGHTS_STATE=ON.

يجب عدم تنفيذ هذه السمة إلا إذا كانت قيمة STEERING_WHEEL_LIGHTS_SWITCH يمكن أن تختلف عن قيمة CABIN_LIGHTS_SWITCH.

بالنسبة إلى رقم تعريف المنطقة الشامل (0)، يجب تحديد VehicleAreaConfig#supportedEnumValues ما لم تكن جميع قيم التعداد الخاصة بـ AutomotiveLightSwitch متوافقة.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleLightSwitch
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_LOCKED

عجلة القيادة مقفلة. إذا تم ضبط السياسة على "صحيح"، يعني ذلك أنّ موضع عجلة القيادة مقفل وغير قابل للتغيير. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي السيارات تنفيذها على أنّها <covehiclepropertyaccess.read< code=""> فقط./p> </covehiclepropertyaccess.read<>

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

تم تفعيل ميزة قفل سرقة عجلة القيادة. إذا كان هذا الحقل صحيحًا، يتم قفل عجلة القيادة تلقائيًا لمنع السرقة في حالات معيّنة. يتم تعريف هذه السمة على AutomotivePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للجهاز تطبيقها على AutomotivePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

STORAGE_ENCRYPTION_BINDING_SEED

تشفير المحتوى الأساسي والملزم الخارجي يتم دمج هذه القيمة مع مفتاح تشفير تخزين المفاتيح على الجهاز. تحتوي هذه السمة على 16 بايت، ومن المتوقّع أن يتم الاحتفاظ بها في وحدة تحكّم إلكترونية منفصلة عن وحدة التحكّم في الوسائط داخل السيارة. يتم إعداد الموقع في البداية من قِبل AAOS، الذي ينشئه باستخدام CSRNG. بعد ذلك، يقرأ نظام التشغيل AAOS السمة عند بدء التشغيل اللاحق. من المتوقّع أن يتم الاحتفاظ ببذرة الربط بشكل موثوق. ويؤدي فقدان أي بذرة إلى إعادة ضبط الجهاز على الإعدادات الأصلية لجهاز IVI.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

إتاحة إمكانية تخصيص الأذونات لمواقع المورّدين

طبِّق هذه السمة إذا كان VHAL يتيح ميزة تخصيص أذونات المورّد. يتم استخدام وسيلة الفوترة PropConfig.configArray للإشارة إلى خصائص المورّدين والأذونات التي تم اختيارها لهذا الموقع الإلكتروني. يجب أن يكون الإذن واحدًا من تعداد في AutomotiveVendorPermission. يتم ضبط configArray على النحو التالي، configArray[n]: propId : property ID لسمة vendor حيث يكون configArray[n+1] عنصرًا في VehicleVendorPermission ويشير إلى إذن قراءة قيمة السمة.

configArray[n+2] هي مجموعة أرقام صحيحة في VehicleVendorPermission وتشير إلى الإذن بكتابة قيمة للسمة. مثلاً:

configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }

إذا لم تكن خصائص المورّد مضمّنة في هذه الصفيف، سيكون لها إذن المورّد التلقائي. إذا اختار المورّد PERMISSION_NOT_ACCESSIBLE، لن يتمكّن نظام التشغيل Android من الوصول إلى السمة. في المثال، لا يمكن لنظام التشغيل Android كتابة قيمة لسمة vendor_prop_2.

تغيير الوضع: STATIC
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

SUPPORTED_PROPERTY_IDS

(متوقفة نهائيًا) قائمة بجميع أرقام تعريف المواقع المتوافقة

تغيير الوضع: STATIC
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

SWITCH_USER

تحدِّد طلبًا لتبديل مستخدم Android في المقدّمة.

يستخدم نظام Android هذه السمة بشكل أساسي لإعلام HAL بأنّه يتم تبديل مستخدم Android الحالي في المقدّمة، ولكن يمكن أن يستخدمه HAL أيضًا لطلب تبديل مستخدمي نظام Android. عندما يُرسل Android الطلب، يتم ضبط VehiclePropValue ويجب أن يستجيب HAL بحدث تغيير في السمة. عندما يقدّم HAL الطلب، يجب أن يتم ذلك أيضًا من خلال حدث تغيير في الموقع (الفرق الرئيسي هو أنّ معرّف الطلب هو موجب في الحالة الأولى وسالب في الحالة الثانية). يختلف أيضًا SwitchUserMessageType.

• LEGACY_ANDROID_SWITCH يستدعي هذا الإجراء نظام Android للإشارة إلى أنّ مستخدم Android على وشك التغيير عند تقديم طلب التغيير بطريقة لا تتكامل مع بروتوكول HAL (على سبيل المثال، من خلال adb shell am Switch-user). يمكن أن تنقل عملية HAL مستخدمها الداخلي بعد أن يتلقّى هذا الطلب، ولكن لا تحتاج إلى الرد على نظام Android. إذا تعذّر تغيير مستخدمه الداخلي لأي سبب، يجب الانتظار إلى أن يتم تلقّي مكالمة SWITCH_USER(type=ANDROID_POST_SWITCH) لاسترداده (على سبيل المثال، يمكنه إصدار SWITCH_USER(type=VEHICLE_REQUEST) للتبديل مرة أخرى إلى المستخدم السابق). من المفترض أنّه لن يتعذّر إكمال هذا الإجراء مطلقًا (لأنّ التبديل مرة أخرى قد يؤدي إلى إرباك المستخدم النهائي).
  على سبيل المثال، إذا كان النظام يتضمّن مستخدمين (0 و10 و11) وكان يتم التبديل من 0 إلى 11 (حيث لا يتضمّن أيّ منهم أي علامة خاصة)، سيكون الطلب على النحو التالي:
  
  • int32[0] 42 // رقم تعريف الطلب
  • int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
  • int32[2] 11 // رقم تعريف المستخدم المستهدف
  • int32[3] 0 // علامات المستخدِم المستهدَف (ما مِن علامات)
  • int32[4] 10 // المستخدم الحالي
  • int32[5] 0 // عمليات إبلاغ المستخدم الحالي (بدون)
  • int32[6] 3 // عدد المستخدِمين
  • int32[7] 0 // المستخدم رقم 0 (رقم تعريف مستخدم Android 0)
  • int32[8] 0 // علامات المستخدم رقم 0 (ما مِن علامات)
  • int32[9] 10 // المستخدم رقم 1 (رقم تعريف مستخدم Android‏ 10)
  • int32[10] 0 // علامات المستخدم رقم 1 (ما مِن علامات)
  • int32[11] 11 // المستخدم رقم 2 (رقم تعريف مستخدم Android 11)
  • int32[12] 0 // علامات المستخدم رقم 2 (ما مِن علامات)
• ANDROID_SWITCH يتم استدعاء هذا الإجراء من قِبل نظام Android للإشارة إلى أنّ مستخدم Android على وشك التغيير، ولكن ينتظر Android ردّ HAL (لمدة تصل إلى بعض الوقت) قبل المتابعة. يجب أن يبدّل HAL مستخدمه الداخلي بعد تلقّي هذا الطلب، ثم يردّ على Android باستخدام SWITCH_USER(type=VEHICLE_RESPONSE) يشير إلى ما إذا تم تبديل المستخدم الداخلي أم لا (من خلال التعداد SwitchUserStatus). على سبيل المثال، إذا كان نظام التشغيل Android يتضمّن مستخدمين (0 و10 و11) وحال التحوّل من الإصدار 10 إلى الإصدار 11 (حيث لا يتضمّن أيّ منهما أي علامة خاصة)، سيكون الطلب على النحو التالي:
  • int32[0] 42 // معرّف الطلب
  • int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
  • int32[2] 11 // target user id
  • int32[3] 0 // علامات المستخدِم المستهدَف (ما مِن علامات)
  • int32[4] 10 // المستخدم الحالي
  • int32[5] 0 // عمليات إبلاغ المستخدم الحالي (بدون)
  • int32[6] 3 // عدد المستخدِمين
  • int32[7] 0 // المستخدم الأول (المستخدم 0)
  • int32[8] 1 // علامات المستخدم الأول (SYSTEM)
  • int32[9] 10 // المستخدم الثاني (المستخدم 10)
  • int32[10] 0 // علامات المستخدم الثانية (لا شيء)
  • int32[11] 11 // المستخدم الثالث (المستخدم 11)
  • int32[12] 0 // علامات المستخدم الثالث (ما مِن علامات)

  إذا نجح الطلب، على HAL تعديل السمة باستخدام ما يلي:

  • int32[0] 42 // معرّف الطلب
  • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
  • int32[2] 1 // الحالة: SwitchUserStatus::Success

  في حال تعذّر إكمال الطلب، سيكون الردّ على النحو التالي:

  • int32[0] 42 // معرّف الطلب
  • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
  • int32[2] 2 // الحالة: SwitchUserStatus::FAILUREstring: "108-D'OH!"
  • رسالة خطأ خاصة بالمُصنّع الأصلي
• VEHICLE_RESPONSE تم استدعاء هذا الإجراء من قِبل HAL لتوضيح ما إذا كان يجب تنفيذ الطلب من النوع ANDROID_SWITCH أو إلغاءه. راجع أيضًا ANDROID_SWITCH.
• VEHICLE_REQUEST يتم استدعاء هذه الوظيفة من HAL لطلب تبديل مستخدم Android الحالي في المقدّمة. ويُعدّ هذا الإجراء مفيدًا في الحالات التي بدأ فيها Android كمستخدم واحد، إلا أنّ المركبة حدّدت السائق على أنه مستخدم آخر. على سبيل المثال، فتح المستخدم "أ" قفل السيارة باستخدام مفتاح السوار الخاص بالمستخدم "ب". عرَض الطلب INITIAL_USER_INFO المستخدم "ب"، ولكن بعد ذلك، حدَّد النظام الفرعي لميزة "التعرّف على الوجه" المستخدم على أنّه "أ". يقدّم HAL هذا الطلب من خلال حدث تغيير في السمة (من خلال تمرير معرّف طلب سلبي)، ويستجيب نظام Android من خلال إصدار مكالمة ANDROID_POST_SWITCH التي تحمل معرّف الطلب نفسه. على سبيل المثال، إذا كان مستخدم Android الحالي في المقدّمة هو الإصدار 10 وطلب HAL التبديل إلى الإصدار 11، سيكون الطلب على النحو التالي:
  • int32[0] -108 // معرّف الطلب
  • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
  • int32[2] 11 // رقم تعريف مستخدم Android

  إذا تمكّن الطلب من الوصول إلى Android وكان لديه ثلاثة مستخدمين (0 و10 و11)، سيكون الردّ على النحو التالي:

  • int32[0] -108 // معرّف الطلب
  • int32[1] 5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCH
  • int32[2] 11 // target user id
  • int32[3] 0 // علامات رقم تعريف المستخدم المستهدَف (بدون)
  • int32[4] 11 // المستخدم الحالي
  • int32[5] 0 // علامات المستخدم الحالي (ما مِن علامات)
  • int32[6] 3 // عدد المستخدِمين
  • int32[7] 0 // first user (user 0)
  • int32[8] 0 // علامات المستخدم الأول (ما مِن علامات)
  • int32[9] 10 // مستخدم ثانية (المستخدم 10)
  • int32[10] 4 // علامات المستخدم الثاني (لا توجد)
  • int32[11] 11 // المستخدم الثالث (المستخدم 11)
  • int32[12] 3 // عمليات إبلاغ المستخدم الثالث (بدون)

  أرقام تعريف المستخدمين الحالية والمستهدفة متطابقة. في حال تعذّر تنفيذ الطلب، سيكون العنوانان مختلفَين. على سبيل المثال، سيكون المستخدِم المستهدَف هو 11 وسيظلّ المستخدِم الحالي هو 10.

• ANDROID_POST_SWITCH تم استدعاء هذا الإجراء من خلال نظام Android بعد تقديم طلب تبديل المستخدم. يتمّ استدعاء هذه السمة بعد طلبات التبديل من أيّ نوع (على سبيل المثال، >code>LEGACY_ANDROID_SWITCH أو >code>ANDROID_SWITCH أو VEHICLE_REQUEST)، ويمكن استخدامها لتحديد ما إذا كان الطلب قد تمّ بنجاح أم تعذّر.
  • عند نجاحه، يتم استدعاؤه عندما يكون مستخدم Android في حالة غير مقفلة وتكون قيمة معرّفات المستخدمين الحالي والهدف في الاستجابة متطابقة. ويعادل ذلك تلقّي Intent.ACTION_USER_UNLOCKED في تطبيق Android.
  • وفي حال تعذّر ذلك، يتمّ استدعاؤه على الفور وتختلف قيمة معرّفات المستخدمَين الحالي والمستهدف في الاستجابة (لأنّ المستخدم الحالي لم يتغيّر إلى المستهدَف).
  • إذا تم تقديم طلب تبديل جديد قبل أن يستجيب HAL للطلب السابق أو قبل فتح قفل الجهاز، لن يتم تقديم طلب ANDROID_POST_SWITCH. على سبيل المثال، قد يبدّل السائق عن طريق الخطأ المستخدم غير الصحيح الذي لديه بيانات اعتماد القفل، ثم يبدّل إلى المستخدم الصحيح قبل إدخال بيانات الاعتماد.

  يمكن لواجهة HAL تعديل حالتها الداخلية بعد تلقّي هذا الطلب، ولكن ليس عليها الردّ على نظام Android.

  • الطلب أوّل قيم N كما هو محدّد في INITIAL_USER_INFO (حيث تكون قيمة الطلب المحدّدة في الفهرس 1 هي SwitchUserMessageType::ANDROID_POST_SWITCH)، ثم قيمتَان إضافيتان ل رقم تعريف المستخدم المستهدَف (على سبيل المثال، رقم تعريف مستخدم Android الذي تم طلب التبديل إليه) وعلاماته (على النحو المحدّد في UserFlags)
  • الردّ: لا شيء. على سبيل المثال، راجِع VEHICLE_REQUEST.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

TIRE_PRESSURE

ضغط الإطارات يتم تحديد كل إطار من خلال إعداد areaConfig.areaId. ويتم استخدام قيمة minFloatValue وmaxFloatValue المعنية لتخزين نطاق الضغط الذي يقترحه المصنّع الأصلي للجهاز. يجب تحديد قيم minFloatValue وmaxFloatValue في VehicleAreaConfig.

تمثّل minFloatValue في بيانات areaConfig الحدّ الأدنى للضغط المُقترَح للإطار. يمثّل maxFloatValue في بيانات areaConfig الحد الأقصى لضغط الإطار المُقترَح. على سبيل المثال، يشير هذا العنصر areaConfig إلى ضغط الهواء المُقترَح في الإطار left_front من 200.0kPa إلى 240.0kPa.

.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:KILOPASCAL
الإصدار: Android 13

TIRE_PRESSURE_DISPLAY_UNITS

وحدات ضغط الإطارات المعروضة يشير إلى الوحدات التي تستخدمها السيارة لعرض ضغط الإطارات للمستخدم. على سبيل المثال، PSI أو Bar أو Kilopascal. يتم استخدام VehiclePropConfig.configArray لتحديد units display pressure المتوافقة. يتم تحديد وحدات الضغط في VehicleUnit. على سبيل المثال، configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

إذا كان تعديل TIRE_PRESSURE_DISPLAY_UNITS يؤثر في قيم سمات *_DISPLAY_UNITS الأخرى، يجب تعديل قيمها وإرسالها إلى إطار عمل AAOS أيضًا. تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي السيارات تنفيذها على أنّها <covehiclepropertyaccess.read< code=""> فقط./p> </covehiclepropertyaccess.read<>

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: VehicleUnit
نوع الوحدة: لا ينطبق
الإصدار: Android 13

TRACTION_CONTROL_ACTIVE

يتم ضبطها على "صحيح" عندما يكون نظام التحكّم في الجرّ (TC) مفعّلاً، ويتم إعادة ضبطها على "خطأ" عندما يكون نظام التحكّم في الجرّ غير مفعّل. يمكن ضبط هذه السمة بشكل متقطّع (نبض) استنادًا إلى الحالة في الوقت الفعلي لنظام التحكّم في الجرّ.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

فيلم TRAILER_PRESENT

تعرض حالة المقطورة للسيارة.

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: TrailerState
نوع الوحدة: لا ينطبق
الإصدار: Android 13

حالة الدوران

حالة المركبات الانعطاف

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: VehicleTurnSignal
نوع الوحدة: لا ينطبق
الإصدار: Android 13

USER_IDENTIFICATION_ASSOCIATION

السمة المستخدَمة لربط المستخدم الحالي (أو الاستعلام عن الربط) بآليات تحديد هوية خاصة بالمركبة (مثل مفتاح FOB)

هذه خاصيّة اختيارية لإدارة المستخدِمين. وسيظل بإمكان المصنّع الأصلي للجهاز توفير ميزة إدارة المستخدمين بدون تحديدها. في الواقع، يمكن استخدام هذه السمة بدون توفير الدوال الأساسية المتعلقة بالمستخدم الموضّحة في INITIAL_USER_INFO.

لطلب البحث عن عملية الربط، يحصل نظام Android على السمة، ويجري الاستعلام عن AutomotivePropValue التي تحتوي على أنواع عمليات الربط، على النحو المحدّد في UserIdentificationGetRequest. يجب أن يظهر HAL على الفور، مع عرض VehiclePropValue مع UserIdentificationResponse.

لاحِظ أنّ تحديد هوية المستخدم تم أثناء بدء تشغيل النظام. يجب تنفيذ VHAL فقط لعملية الربط التي تم تحديدها مسبقًا (مثل مفتاح FOB المستخدَم لفتح قفل السيارة)، بدلاً من بدء عملية ربط جديدة من خلال مكالمة الحصول على البيانات.

لربط الأنواع، يضبط نظام Android السمة، مع تمرير VehiclePropValue يحتوي على أنواع عمليات الربط التي يتم ضبطها، كما هو محدّد في UserIdentificationSetRequest.

بعد ذلك، يستخدم HAL حدث تغيير خاصية (يتم تحديد VehiclePropValue من خلال UserIdentificationResponse) يشير إلى الحالة الحالية للأنواع بعد الطلب.

على سبيل المثال، للاستعلام عمّا إذا كان المستخدم الحالي (10) مرتبطًا بمفتاح FOB الذي فتح قفل السيارة وآلية مخصّصة يوفّرها المصنّع الأصلي للجهاز، يكون الطلب على النحو التالي:

• int32[0] 42 // معرّف الطلب
• int32[1] 10 (رقم تعريف مستخدم Android)
• int32[2] 0 (علامات المستخدمين على Android)
• int32[3] 2 (عدد الأنواع التي تم الاستعلام عنها)
• int32[4] 1 (النوع الأول الذي تم الاستعلام عنه، UserIdentificationAssociationType::KEY_FOB)
• int32[5] 101 (النوع الثاني الذي تم الاستعلام عنه، UserIdentificationAssociationType::CUSTOM_1)

إذا كان المستخدم مرتبطًا بوحدة تحكّم في حدود الجلسة ولكن ليس بالآلية المخصّصة، يكون الردّ على النحو التالي:

• int32[0] 42 // معرّف الطلب
• int32[1] 2 (عدد الارتباطات في الردّ)
• int32[2] 1 (النوع الأول: UserIdentificationAssociationType::KEY_FOB)
• int32[3] 2 (القيمة الأولى: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
• int32[4] 101 (النوع الأول: UserIdentificationAssociationType::CUSTOM_1)
• int32[5] 4 (القيمة الثانية: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

بعد ذلك، لربط المستخدم بالآلية المخصّصة، يتم تقديم طلب ضبط:

• int32[0] 43 // رقم تعريف الطلب
• int32[1] 10 (رقم تعريف مستخدم Android)
• int32[2] 0 (علامات المستخدمين على Android)
• int32[3] 1 (عدد عمليات الربط التي يتم ضبطها)
• int32[4] 101 (النوع الأول: UserIdentificationAssociationType::CUSTOM_1)

إذا نجح الطلب، سيكون الردّ على النحو التالي:

• int32[0] 43 // معرّف الطلب
• int32[1] 1 (عدد الارتباطات في الردّ)
• int32[2] 101 (النوع الأول: UserIdentificationAssociationType::CUSTOM_1)
• int32[3] 1 (القيمة الأولى: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)

يضيف طلب الإعداد عمليات الربط، ولكنّه لا يزيل عمليات الربط الحالية. في المثال السابق ، ستكون الحالة النهائية عبارة عن ربطَين (FOB وCUSTOM_1). لربط المستخدم بـ CUSTOM_1 فقط ولكن ليس FOB، يكون الطلب كالتالي:

• int32[0] 43 // معرّف الطلب
• int32[1] 10 (رقم تعريف مستخدم Android)
• int32[2] 2 (عدد الأنواع المحدّدة)
• int32[3] 1 (النوع الأول: UserIdentificationAssociationType::KEY_FOB)
• int32[4] 2 (القيمة الأولى: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)
• int32[5] 101 (النوع الثاني: UserIdentificationAssociationType::CUSTOM_1)
• int32[6] 1 (القيمة الثانية: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

VEHICLE_CURB_WEIGHT

تعرض وزن السيارة الرصيف بالكيلوغرام. الوزن الإجمالي للمركبة هو الوزن الإجمالي للمركبة مع المعدات العادية وجميع المواد الاستهلاكية اللازمة للتشغيل، مثل زيت المحرك وزيت ناقل الحركة وسائل المكابح والمبرد وغاز تكييف الهواء ووزن الوقود عند السعة الاسمية للخزان في حال عدم تحميل الركاب أو الحمولة.

تُستخدم سمة configArray[0] لتحديد وزن المركبة الإجمالي بالكيلوغرام. الوزن الإجمالي للمركبة هو الحد الأقصى للوزن التشغيلي للمركبة على النحو المحدّد من قِبل الشركة المصنّعة، ويشمل ذلك الشاسيه والجسم والمحرك والسوائل الخاصة بالمحرك والوقود والملحقات والسائق والركاب والحمولة، باستثناء أي مقطورات.

تغيير الوضع: STATIC
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:KILOGRAM
الإصدار: Android 13

VEHICLE_IN_USE

يشير إلى ما إذا كانت المركبة قيد الاستخدام. تعني كلمة "قيد الاستخدام" أنّ هناك شخصًا بشري ويهدف إلى استخدام المركبة. ولا يعني ذلك بالضرورة أنّ المستخدم البشري داخل المركبة. على سبيل المثال، إذا فتح المستخدم للمركبة عن بُعد، تُعتبر المركبة قيد الاستخدام. إذا كانت هذه السمة متاحة:

• في كل مرة يشغّل فيها المستخدم المركبة أو يكتشف النظام أنّ هناك مستخدمًا، يجب ضبط السمة VEHICLE_IN_USE على "صحيح". في كل مرة يوقف فيها المستخدم تشغيل المركبة أو عندما يرصد النظام عدم وجود المستخدم، يجب ضبط VEHICLE_IN_USE على خطأ.
• إذا أوقف المستخدم السيارة أو رصد النظام عدم وجود المستخدم، يجب ضبط VEHICLE_IN_USE على خطأ.
• إذا شغّل المستخدم المركبة أو رصد النظام وجود المستخدم، يجب ضبط VEHICLE_IN_USE على true.

تختلف هذه السمة عن AP_POWER_BOOTUP_REASON من حيث أنّه يتم ضبط AP_POWER_BOOTUP_REASON مرة واحدة فقط أثناء تشغيل النظام. ومع ذلك، قد تتغير هذه السمة عدة مرات أثناء دورة تشغيل النظام. على سبيل المثال، ثمة جهاز غير مُستخدَم حاليًا. بدء تشغيل النظام لتنفيذ مهمة عن بُعد القيمة VEHICLE_IN_USE غير صحيحة. أثناء تنفيذ المَهمّة عن بُعد، يدخل المستخدم إلى المركبة ويشغّلها. تمّ ضبط VEHICLE_IN_USE على "صحيح". بعد جلسة قيادة، يوقف المستخدم تشغيل المركبة، ويُضبط VEHICLE_IN_USE على false.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 14

VEHICLE_MAP_SERVICE

رسالة خدمة توفير بيانات التنقّل للمركبة (VMS) يستخدم هذا الموقع بيانات MIXED لإرسال رسائل نظام إدارة الفيديو. ويتم تفسير محتوياتها على النحو التالي. يتم استخدام الفهارس المحدّدة في VmsMessageIntegerValuesInde للقراءة من قيم int32Values. وحدات البايت هي رسالة VMS تسلسلية كما هو محدّد في بروتوكول الجهاز الافتراضي (VMS)، وهي قيمة معتمة لإطار العمل. يجب أن تعرض IVehicle#get دائمًا StatusCode::NOT_AVAILABLE.

تغيير الوضع: ON_CHANGEREAD_WRITE
وضع الوصول: READ_WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

VEHICLE_SPEED_DISPLAY_UNITS

وحدات السرعة المعروضة يشير إلى نوع الوحدات المستخدَمة لعرض السرعة للمستخدم. على سبيل المثال، متر في الثانية أو كيلومتر في الساعة أو ميل في الساعة يشير VehiclePropConfig.configArray إلى وحدات عرض السرعة المتوافقة. يتم تحديد وحدات الضغط في AutomotiveUnit. مثلاً:

.configArray: { VehicleUnit::METER_PER_SEC, VehicleUnit::KILOMETERS_PER_HOUR, VehicleUnit::MILES_PER_HOUR }

• configArray[0] METER_PER_SEC
• configArray[1] MILES_PER_HOUR
• configArray[2] KILOMETERS_PER_HOUR

إذا كان تعديل VEHICLE_SPEED_DISPLAY_UNITS يؤثر في قيم *_DISPLAY_UNITS properties الأخرى، يجب تعديل هذه القيم وإبلاغ إطار عمل AAOS بها.

يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن للمصنّعين الأصليين للأجهزة تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

نبض القلب

لتحديد الحدث الذي يشير إليه إشارة VHAL إلى Car Watchdog على أنّه نبض القلب. إذا كان VHAL متوافقًا مع هذه السمة، من المفترض أن يكتب VHAL وقت تشغيل النظام في هذه السمة كل ثلاث ثوانٍ. يشترك تطبيق Car Watchdog في هذه السمة ويتحقّق من تعديلها كل ثلاث ثوانٍ. مع وقت التخزين المؤقت الذي يبلغ ثلاث ثوانٍ، ينتظر تطبيق Car Watchdog إشارة بدء قياس سرعة السيارة لمدة تصل إلى ست ثوانٍ من آخر إشارة بدء قياس سرعة السيارة. وفي حال عدم استيفاء هذه الشروط، يعتبر Car Watchdog أنّ VHAL غير صالح ويوقفه. إذا لم تكن هذه السمة متوافقة مع VHAL، لن يتحقق تطبيق Car Watchdog من حالة VHAL.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WATCHDOG_ALIVE

تحدِّد هذه السياسة حدثًا يعدِّله مراقب السيارات للإشارة إلى أنّه نشط. يضبط تطبيق Car Watchdog هذه القيمة على وقت عمل النظام بالملي ثانية كل ثلاث ثوانٍ. أثناء بدء التشغيل، قد يستغرق التحديث وقتًا أطول.

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WATCHDOG_TERMINATED_PROCESS

يحدِّد هذه السمة عملية أُغلقت بواسطة Car Watchdog وسبب الإغلاق.

int32Values[0] 1  // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command

تغيير الوضع: ON_CHANGE
وضع الوصول: WRITE
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WHEEL_TICK

مؤشرات عجلة التقارير. العنصر الأول في المتجه هو عدد عمليات إعادة الضبط. تشير إعادة الضبط إلى أنّه لا يمكن مقارنة أعداد العلامات السابقة بهذا العدد والأرقام المستقبلية. حدث نوع من الانقطاع في عملية عدّ النقرات.

تمثل العناصر الأربعة التالية علامات للعجلات الفردية بالترتيب التالي:

1. نافذة أمامية يسرى
2. نافذة أمامية يمنى
3. الجهة الخلفية اليمنى
4. الجهة الخلفية اليسرى

تكون جميع أعداد النقرات تراكمية. يزداد عدد النقرات عندما تتحرك المركبة إلى الأمام، وينخفض عندما تتحرك المركبة إلى الخلف. من المفترض أن يتم إعادة ضبط العلامات على 0 عند بدء تشغيل المركبة.

• int64Values[0] إعادة ضبط العدد
• علامات التجزئة الأمامية اليسرى لـ int64Values[1]
• int64Values[2] علامات على الجانب الأيمن الأمامي
• int64Values[3] علامات الجهة الخلفية اليمنى
• int64Values[4] علامات التصفيح الخلفي الأيسر

يتم استخدام configArray للإشارة إلى قيمة الميكرومتر لكل علامة عجلة والاطّلاع على العجلات المتوافقة. يتم ضبط configArray على النحو التالي:

configArray[0], bits [0:3] Supported wheels

تستخدم عجلة التعداد. على سبيل المثال، إذا كانت جميع العجلات متوافقة، عندئذٍ:

• configArray[0] عجلة مساحة السيارة::LEFT_FRONT | عجلة مساحة السيارة::RIGHT_FRONT | عجلة مساحة السيارة::LEFT_REAR | عجلة مساحة السيارة::RIGHT_REAR
• configArray[1] الميكرومتر لكل علامة على العجلة الأمامية اليسرى
• configArray[2] ميكرومتر لكل علامة على العجلة الأمامية اليمنى
• configArray[3] ميكرومتر لكل علامة عجلة خلفية يمنى
• configArray[4] ميكرومتر لكل مؤشر عجلة يسرى خلفية

إذا لم تكن عجلة معيّنة متاحة، يجب ضبط قيمتها دائمًا على 0.

يجب ملء الحقل VehiclePropValue.timestamp.

تغيير الوضع: CONTINUOUS
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WINDOW_LOCK

قفل الأطفال في النافذة تشير القيمة True إلى أنّ النافذة مقفلة على الأطفال. يتم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WINDOW_MOVE

نقل النافذة يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة. وتشير السمة maxInt32Value إلى أنّ النافذة تفتح في الطائرة أو الإغلاق في اتجاه خارج الطائرة بأسرع سرعة. يشير الرمز minInt32Value إلى أنّ النافذة تغلق في المستوى/تفتح في اتجاه خارج المستوى بأسرع سرعة.

تشير القيم المطلقة الأكبر، سواء كانت موجبة أو سالبة، إلى سرعة حركة أسرع. بعد أن تصل نافذة إلى الحد الأقصى للموضع، يجب إعادة ضبط القيمة على 0. إذا كانت قيمة WINDOW_MOVE هي 0، يعني ذلك أنّه لا يتم تنفيذ أي حركة. يتم تمثيل هذه السمة في نطاق محدّد من سرعات الحركة النسبية.

بالنسبة إلى النافذة التي قد تفتح خارج المستوى (وضع فتحة التهوية للفتحة العلوية)، تعمل هذه المَعلمة على النحو التالي: في حال:

• فتحة السقف مفتوحة:
  • Max افتح فتحة السقف بشكل أكبر، وتوقَّف تلقائيًا عند الفتح بالكامل.
  • Min إغلاق فتحة السقف، وسيتم إيقافها تلقائيًا عند إغلاق فتحة السقف
• فتحة التهوية مفتوحة:
  • Max إغلاق فتحة التهوية، سيتوقّف الجهاز تلقائيًا عند إغلاق فتحة التهوية
  • Min افتح فتحة التهوية أكثر، ثم أوقِف العملية تلقائيًا عندما تكون فتحة التهوية مفتوحة بالكامل.
• فتحة السقف مغلقة:
  • Max افتح فتحة السقف، وتوقّف تلقائيًا عندما تكون فتحة السقف مفتوحة بالكامل.
  • Min افتح فتحة التهوية وتوقَّف تلقائيًا عندما تكون التهوية مفتوحة بالكامل.

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WINDOW_POS

موضع النافذة يجب تحديد maxInt32Value وminInt32Value في كل VehicleAreaConfig. يجب أن تكون جميع الأعداد الصحيحة بين minInt32Value و maxInt32Value متوافقة. يشير الرمز minInt32Value إلى أنّ النافذة مغلقة أو مفتوحة بالكامل خارج المستوى. إذا تعذّر فتح النافذة خارج المستوى، عندئذٍ minInt32Value هو موضع النافذة عند إغلاقها بالكامل ويجب أن يكون 0. إذا كان من الممكن فتح النافذة خارج المستوى، تشير السمة minInt32Value إلى أنّ النافذة مفتوحة بالكامل في موضعها خارج المستوى وتكون قيمة سالبة. اطّلِع على المثال أدناه للحصول على شرح أكثر تفصيلاً. يشير الرمز maxInt32Value إلى أنّ النافذة مفتوحة بالكامل.

تشير القيم التي تقع بين minInt32Value وmaxInt32Value إلى حالة انتقال بين الموضعين المغلق/المفتوح بالكامل خارج المستوى والوضع مفتوح بالكامل. لا تقع هذه السمة في أي وحدة معيّنة، بل في نطاق محدّد من المواضع النسبية. على سبيل المثال، في ما يلي كيفية عمل السمة للنافذة التي يمكن أن تتحرّك خارج المستوى: بالنسبة إلى النافذة التي يمكن أن تفتح خارج المستوى (وضع التهوية للفتحة العلوية) تعمل هذه المَعلمة مع القيم السالبة على النحو التالي:

• Max فتحة السقف مفتوحة بالكامل (0 لسقف السقف مغلق)
• Min فتح فتحة السقف بالكامل (0 للسقف المغلق)

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: لا ينطبق
نوع الوحدة: لا ينطبق
الإصدار: Android 13

WINDSHIELD_WIPERS_PERIOD

مدة ماسحات الزجاج الأمامي (مللي ثانية) تعرِض هذه السمة الفترة الزمنية الفورية لمرّة واحدة كاملة من دورة ماسحات الزجاج الأمامي بالمللي ثانية. وتُعرف الدورة الكاملة بأنها ممسحة تنتقل من موضع الباقي وتعود إليه. عند اختيار إعداد مسح متقطّع، يجب ضبط قيمة هذه السمة على 0 أثناء فترة الإيقاف المؤقت لمسح البيانات المتقطّع. يجب تحديد maxInt32Value وminInt32Value في VehicleAreaConfig. يجب أن يحدّد maxInt32Value لكل رقم تعريف منطقة أطول فترة للمسح. يجب ضبط القيمة minInt32Value على 0 لكل رقم تعريف منطقة.

تغيير الوضع: ON_CHANGE
وضع الوصول: READ
نوع التعداد: لا ينطبق
نوع الوحدة: VehicleUnit:MILLI_SECS
الإصدار: Android 14

حالة WINDSHIELD_WIPERS_state

حالة ماسحات الزجاج الأمامي تعرِض هذه السمة الحالة الحالية لمماسحات الزجاج الأمامي. قد لا تتطابق قيمة WINDSHIELD_WIPERS_STATE مع قيمة WINDSHIELD_WIPERS_SWITCH. على سبيل المثال، WINDSHIELD_WIPERS_STATE: ON و WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO في حال تنفيذ WINDSHIELD_WIPERS_STATE: ON وWINDSHIELD_WIPERS_PERIOD ، يجب أن تعكس WINDSHIELD_WIPERS_PERIOD الفترة الزمنية لدورة كاملة من مساحات الزجاج.

لكل رقم تعريف منطقة متوافق، يجب تحديد مصفوفة VehicleAreaConfig#supportedEnumValues ما لم تكن جميع الولايات في WindshieldWipersState متوافقة (بما في ذلك OTHER، والذي لا يُنصح به).

وضع التغيير: ON_CHANGE
وضع الوصول: READ
نوع التعداد: WindshieldWipersState
نوع الوحدة: لا ينطبق
الإصدار: Android 14

WINDSHIELD_WIPERS_SWITCH

مفتاح تبديل ماسحات الزجاج الأمامي يمثّل موضع مفتاح التحكّم في مسّاحات الزجاج الأمامي. قد لا تتطابق قيمة WINDSHIELD_WIPERS_SWITCH مع قيمة WINDSHIELD_WIPERS_STATE، على سبيل المثال، WINDSHIELD_WIPERS_SWITCH: AUTO و WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON. يجب تحديد مصفوفة VehicleAreaConfig#supportedEnumValues لكل معرّف منطقة متوافق، ما لم تكن جميع الولايات في WindshieldWipersSwitch متوافقة (بما في ذلك OTHER، وهو خيار غير مُقترَح).

تم تعريف هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE، ولكن يمكن لمصنّعي المعدّات الأصلية تنفيذها على أنّها VehiclePropertyAccess.READ فقط. إذا تم تنفيذ هذه السمة على أنّها VehiclePropertyAccess.READ_WRITE وكانت الحالة "OTHER" مدرَجة في المصفوفة VehicleAreaConfig#supportedEnumValues، لن تكون القيمة "OTHER" متاحة للكتابة، بل هي قيمة مسموح بها فقط للقراءة.

وضع التغيير: ON_CHANGE
وضع الوصول: READ_WRITE/READ
نوع التعداد: WindshieldWipersSwitch
نوع الوحدة: لا ينطبق
الإصدار: Android 14