מאפייני מערכת נתמכים

בדף הזה מפורטים מאפייני המערכת הנתמכים ב-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.

כשהנכס הזה לא זמין כי CC מושבת (לדוגמה, StatusCode#NOT_AVAILABLE_DISABLED הוא false), הנכס הזה חייב להחזיר 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
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:MILLIMETER
גרסה: Android 14

ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

הפער הנוכחי בין הזמן המשוער לזמן היעד ל-ACC או ל-PCC, באלפיות השנייה. המאפיין הזה צריך לציין את מרווח הזמן היעד לרכב מוביל. הפער הזה מוגדר כזמן הנסיעה במרחק בין הנקודה האחורית ביותר של הרכב המוביל לבין הנקודה הקדמית ביותר של הרכב עם ACC. מרווח הזמן בפועל מהרכב המוביל יכול להיות גבוה או נמוך מהערך הזה.

הערכים האפשריים להגדרה של הפער הזמן לטירגוט צריכים להיות מצוינים ב-configArray בסדר עולה. כל הערכים חייבים להיות חיוביים. אם אפשר לשנות את המאפיין, צריך שאפשר יהיה לשנות את כל הערכים שלו. כשהמאפיין הזה לא זמין כי התכונה 'עותק' מושבתת (לדוגמה, CRUISE_CONTROL_ENABLED הוא false), המאפיין הזה חייב להחזיר את הערך 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
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:MILLI_SECS
גרסה: Android 14

ABS_ACTIVE

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

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

ANDROID_EPOCH_TIME

התאריך והשעה הנוכחיים, בקידוד של תקופת זמן המערכת (באלפיות שנייה). הערך הזה מציין את מספר אלפיות השנייה שחלפו מאז 1 בינואר 1970 (UTC).

הערך הזה מציין את מספר אלפיות השנייה שעברו מאז 1 בינואר 1970 (UTC). CarServices WRITEs לערך הזה כדי לתת ל-VHAL את השעה של מערכת Android, אם ה-VHAL תומך במאפיין הזה. כך תוכלו לסנכרן מערכות אחרות ברכב (שעון בלוח הבקרה) עם השעה ב-Android.

מערכת AAOS WRITEת את הנכס הזה פעם אחת במהלך האתחול, ולאחר מכן WRITE רק כשיש שינוי במקור הזמן. מערכת AAOS תמלא את השדה VehiclePropValue.timestamp בצורה נכונה. AAOS לא שולח עדכונים על חלוף זמן טבעי. int64Values[0] = זמן Unix שסופק (באלפיות שנייה).

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

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

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:MILLI_SECS
גרסה: Android 13

AP_POWER_BOOTUP_REASON

מאפיין לדיווח על הסיבה להפעלה הנוכחית. זוהי מאפיין STATIC שלא ישתנה במשך כל זמן ההפעלה עד לכיבוי. לדוגמה, גם אם המשתמש לוחץ על לחצן ההפעלה אחרי הפעלה אוטומטית עם ביטול הנעילה של הדלת, הסיבה להפעלה חייבת להישאר עם VehicleApPowerBootupReason#USER_UNLOCK int32Values[0] חייב להיות VehicleApPowerBootupReason

מצב שינוי: STATIC
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

AP_POWER_STATE_REPORT

נכס לדיווח על סטטוס הכוח של מעבד האפליקציה. ההנחה היא שמצב החשמל של הנקודה לשיתוף אינטרנט נשלט על ידי בקר חשמל נפרד.

  • int32Values[0] ערך enum של VehicleApPowerStateReport
  • int32Values[1] הזמן להתעוררות, אם צריך, באלפיות שנייה (אחרת 0)

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

AP_POWER_STATE_REQ

נכס לצורך בקרה על מצב החשמל של מעבד האפליקציה. ההנחה היא שמצב החשמל של הנקודה לשיתוף אינטרנט נשלט על ידי בקר חשמל נפרד. למידע על ההגדרות, בשדה VehiclePropConfig.configArray צריך להופיע דגל ביטים שמכיל שילוב של הערכים בשדה VehicleApPowerStateConfigFlag

  • int32Values[0] ערך enum של VehicleApPowerStateReq
  • int32Values[1] פרמטר נוסף שרלוונטי לכל מצב, 0 אם לא נעשה בו שימוש.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

AUTOMATIC_EMERGENCY_BRAKING_ENABLED

מפעילים או משביתים את האפשרות 'בלימת חירום אוטומטית' (AEB). מגדירים את הערך כ-true כדי להפעיל את AEB וכ-false כדי להשבית את 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

AUTOMATIC_EMERGENCY_BRAKING_STATE

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

אם AEB כולל אזהרות מפני התנגשות קדימה לפני הפעלת הבלמים, צריך להציג את האזהרות האלה באמצעות הנכסים 'אזהרה מפני התנגשות קדימה' (FCW).

למזהה האזור הגלובלי (0), צריך להגדיר את המערך StatusCode#VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של AutomaticEmergencyBrakingState (כולל OTHER, שלא מומלץ) ושל ErrorState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג אנון: ForwardCollisionWarningState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

BLIND_SPOT_WARNING_ENABLED

הפעלה והשבתה של התראת שטח מת (BSW). מגדירים את הערך true כדי להפעיל את BSW ומגדירים את הערך false כדי להשבית את BSW. כשה-BSW מופעל, מערכת ה-ADAS ברכב צריכה להיות מופעלת ולעקוב אחרי אובייקטים בנקודות העיוורות של הרכב.

באופן כללי, BLIND_SPOT_WARNING_ENABLED תמיד צריך להחזיר את הערך true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין BLIND_SPOT_WARNING_STATE.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

BLIND_SPOT_WARNING_STATE

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

לכל מזהה אזור נתמך, צריך להגדיר מערך StatusCode#VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של BlindSpotWarningState (כולל OTHER, שלא מומלץ) ושל ErrorState.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: BlindSpotWarningState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

CABIN_LIGHTS_STATE

הפונקציה מחזירה את המצב של תאורת התא.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleLightState
סוג יחידה: לא רלוונטי
גרסה: Android 13

CABIN_LIGHTS_SWITCH

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

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה: לא רלוונטי
גרסה: Android 13

CLUSTER_DISPLAY_STATE

שינוי המצב של תצוגת האשכולות.

  • גבולות: האזור שבו יתבצע העיבוד הגרפי של הפעילות באשכול.
  • תצוגה מוטמעת: אזור שבו אסור להציב מידע חשוב בפעילות.

ערכים אפשריים:

  • int32[0] מופעל, מושבת: 0 – מושבת, 1 – מופעל, -1 – לא חשוב
  • int32[1] Bounds - left: מספר חיובי – המיקום השמאלי בפיקסלים -1 – לא חשוב (צריך להגדיר את כל השדות של Bounds)
  • int32[2] Bounds - top: same format with 'left'
  • int32[3] Bounds - right: same format with 'left'
  • int32[4] Bounds - bottom: same format with 'left'
  • int32[5] Inset - left: מספר חיובי – הערך בפועל של ההכנסה הימנית בפיקסלים -1 – לא חשוב (צריך להגדיר 'לא חשוב' בכל שדות ההכנסה)
  • int32[6] Inset – top: אותו פורמט עם 'left'
  • int32[7] מוטמע – ימין: אותו פורמט עם 'שמאל'
  • int32[8] Inset – bottom: same format with 'left'

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

CLUSTER_NAVIGATION_STATE

הודעה על מצב הניווט הנוכחי. bytes: ההודעה בסריאליזציה של NavigationStateProto.

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum:
סוג יחידה: לא רלוונטי
גרסה: Android 13

CLUSTER_REPORT_STATE

דיווח על מצב התצוגה הנוכחי ועל מצב ClusterUI. ClusterHome שולח את ההודעה הזו כשהוא מטפל ב-CLUSTER_SWITCH_UI, CLUSTER_DISPLAY_STATE בנוסף, ClusterHome צריך לשלוח את ההודעה הזו כשהוא מופעל בפעם הראשונה. כש-ClusterOS מקבל את ההודעה הזו, אם הציפייה הפנימית שונה מההודעה שהתקבלה, הוא צריך לשלוח שוב את CLUSTER_SWITCH_UI, CLUSTER_DISPLAY_STATE כדי להתאים את המצב.

  • int32[0] הפעלה/כיבוי: 0 – כבוי, 1 – מופעל
  • int32[1] Bounds - left
  • int32[2] Bounds - top
  • int32[3] Bounds – right
  • int32[4] Bounds - bottom
  • int32[5] הטיה פנימה – ימינה
  • int32[6] מוטמע – למעלה
  • int32[7] מוטמע – ימין
  • int32[8] מוטמע – תחתון
  • int32[9] הסוג של ClusterUI במסך המלא או במסך הראשי. הערך 0 מציין את הערך ClusterHome. אחרי ערכים אחרים מופיעה ההגדרה של יצרן הציוד המקורי.
  • int32[10] סוג ClusterUI במסך המשנה, אם מוצגים כרגע שני ממשקי המשתמש. הערך -1 מציין שהאזור לא בשימוש יותר. bytes: המערך שמייצג את הזמינות של ClusterUI. הערך 0 מציין שהאפשרות לא זמינה, והערך 1 מציין שהאפשרות זמינה. לדוגמה, אם ברכב יש תמיכה בשלושה ממשקי ClusterUI שהוגדרו על ידי יצרן ציוד מקורי, כמו 'דף הבית', 'מפות' ו'שיחה', ותמיכה בממשק המשתמש של 'שיחה' רק כשהרשת הסלולרית זמינה. לאחר מכן, אם הרשת זמינה, הוא שולח את הערך [1 1 1], ואם הוא מחוץ לרשת, הוא שולח את הערך [1 1 0].

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: VehicleLightSwitch
סוג יחידה: לא רלוונטי
גרסה: Android 13

CLUSTER_REQUEST_DISPLAY

בקשות לשינוי מצב התצוגה של האשכולות כדי להציג חלק מ-ClusterUI. כשמצב המסך הנוכחי כבוי, ClusterHome שולח את ההודעה הזו ל-ClusterOS כדי לבקש להפעיל את המסך ולהציג בו ממשק ClusterUI ספציפי. ClusterOS אמור להשיב עם הערך CLUSTER_DISPLAY_STATE

  • int32 סוג ClusterUI שרוצים להציג

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

CLUSTER_SWITCH_UI

הפעלת ClusterUI במסך האשכול.

  • int32 סוג ClusterUI להצגה. הערך 0 מציין את ClusterHome, מסך הבית של לוח הבקרה, ומספק את ממשק המשתמש שמוגדר כברירת מחדל וסוג של פונקציונליות של מרכז אפליקציות ללוח הבקרה. ערכים אחרים מוגדרים לפי ההגדרה של יצרן הציוד המקורי.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

CREATE_USER

המערכת של Android קוראת ל-method הזה אחרי שיוצרים משתמש ב-Android. ה-HAL יכול להשתמש במאפיין הזה כדי ליצור את המשתמש המקביל שלו. זוהי בקשה אסינכררונית: Android שולחת את הבקשה על ידי הגדרת VehiclePropValue, ו-HAL צריך להשיב עם שינוי במאפיין שמציין אם הבקשה בוצעה או נכשלה. אם הניסיון נכשל, מערכת Android מסירה את המשתמש.

הפורמט של הבקשה מוגדר על ידי CreateUserRequest והפורמט של התגובה מוגדר על ידי CreateUserResponse. לדוגמה, אם במערכת היו שני משתמשים (0 ו-10) ונוצר משתמש שלישי (שאינו אורח זמני), הבקשה תהיה:

  • int32[0] 42 // מזהה הבקשה
  • int32[1] 11 // מזהה Android של המשתמש שנוצר
  • int32[2] 6 // דגלים של Android (אורח זמני) של המשתמש שנוצר
  • int32[3] 10 // current user
  • int32[4] 0 // current user flags (none)
  • int32[5] 3 // מספר המשתמשים
  • int32[6] 0 // first user (user 0)
  • int32[7] 0 // first user flags (none)
  • int32[8] 10 // משתמש שני (משתמש 10)
  • int32[9] 0 // second user flags (none)
  • int32[10] 11 // משתמש שלישי (משתמש 11)
  • int32[11] 6 // third user flags (ephemeral guest) string: "ElGuesto" // name of the new user

אם הבקשה מסתיימת בהצלחה, ה-HAL מחזיר:

  • int32[0] 42 // מזהה הבקשה
  • int32[1] 1 // CreateUserStatus::SUCCESS

אבל אם הוא נכשל:

  • int32[0] 42 // מזהה הבקשה
  • int32[1] 2 // CreateUserStatus::FAILURE string: "D'OH!" //

המשמעות היא תיבת שחורה והיא מועברת למבצע הקריאה החוזרת (למשל, ממשק המשתמש של ההגדרות), שמבצע את הפעולה המתאימה.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

CRITICALLY_LOW_TIRE_PRESSURE

המאפיין הזה מציין את סף הלחץ הנמוך ביותר בכל צמיג. הוא מציין מתי צריך להחליף או לתקן צמיג. הערך חייב להיות שווה או קטן מ-minFloatValue ב-TIRE_PRESSURE. ערכי המאפיין המינימלי והמקסימלי (minFloatValue ו-maxFloatValue) לא רלוונטיים למאפיין הזה.

מצב שינוי: STATIC
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:KILOPASCAL
גרסה: Android 13

CRUISE_CONTROL_COMMAND

WRITE פקודות של בקרת שיוט (CC). פרטים על כל אחת מהפקודות הנתמכות מופיעים במאמר CruiseControlCommand. למזהה האזור הגלובלי (0), צריך להגדיר את המערך StatusCode#VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של CruiseControlState. כל פקודות שלא נתמכות שנשלחות דרך המאפיין הזה חייבות להחזיר את הערך StatusCode#INVALID_ARG. אם המאפיין הזה לא זמין כי התכונה 'עותקים' מושבתת (לדוגמה, הערך של CRUISE_CONTROL_ENABLED הוא false), המאפיין הזה חייב להחזיר את הערך 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
סוג Enumeration: CruiseControlCommand
סוג יחידה: N/A
גרסה: Android 14

CRUISE_CONTROL_ENABLED

מפעילים או משביתים את בקרת המהירות (CC). מגדירים את הערך כ-true כדי להפעיל את ה-CC וכ-false כדי להשבית אותו. כל הצורות של CruiseControlType משתפות את המאפיין הזה. כשה-CC מופעל, מערכת ה-ADAS ברכב אמורה להיות מופעלת ולהגיב לפקודות. באופן כללי, הפונקציה CRUISE_CONTROL_ENABLED תמיד צריכה להחזיר את הערכים true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין CRUISE_CONTROL_STATE. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

CRUISE_CONTROL_STATE

המצב הנוכחי של בקרת השיוט (CC). המאפיין הזה מחזיר את המצב הנוכחי של CC. באופן כללי, המאפיין הזה אמור להחזיר מצב תקין שמוגדר ב-CruiseControlState או ב-ErrorState. לדוגמה, אם התכונה לא זמינה בגלל מצב זמני כלשהו, המידע הזה צריך להישלח דרך ErrorState. כדי לציין את מזהה האזור הגלובלי (0), צריך להגדיר את המערך VehicleAreaConfig#supportedEnumValue, אלא אם יש תמיכה בכל המצבים של CruiseControlState (כולל OTHER, שלא מומלץ) ושל ErrorState.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: CruiseControlState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

CRUISE_CONTROL_TARGET_SPEED

מהירות היעד הנוכחית של בקרת השיוט (CC). יצרני ציוד מקורי צריכים להגדיר את הערכים minFloatValue ו-maxFloatValue למאפיין הזה כדי להגדיר את ערכי המהירות המינימלית והמקסימלית של היעד. הערכים האלה חייבים להיות לא שליליים. הערך maxFloatValue מייצג את הגבול העליון של מהירות היעד. הערך minFloatValue מייצג את הגבול התחתון של מהירות היעד. כשהנכס הזה לא זמין כי CC מושבת (לדוגמה, CRUISE_CONTROL_ENABLED הוא false), הנכס הזה חייב להחזיר את הערך 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
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:METER_PER_SEC
גרסה: Android 14

CRUISE_CONTROL_TYPE

הסוג הנוכחי של בקרת השיוט (CC). כשהערך של CRUISE_CONTROL_ENABLED הוא true, המאפיין הזה מחזיר את סוג ה-CC שמופעל כרגע (לדוגמה, CC רגיל ו-CC אדפטיבי, חזוי). בדרך כלל, המאפיין הזה אמור להחזיר מצב תקין שמוגדר ב-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
סוג Enum: CruiseControlType ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

CURRENT_GEAR

ההילוך הנוכחי. במקרה שאינו ידני, יכול להיות שההילוך שנבחר לא יתאים להילוך הנוכחי. לדוגמה, אם ההילוך שנבחר הוא 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
סוג Enum: VehicleGear
סוג יחידה: לא רלוונטי
גרסה: Android 13

CURRENT_POWER_POLICY

שליחת הודעה על מדיניות החשמל הנוכחית לשכבת VHAL. השירות של מדיניות הזנת המתח של הרכב מגדיר את המאפיין הזה כשמדיניות הזנת המתח הנוכחית משתנה

string: "sample_policy_id" // power policy ID

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

DISABLED_OPTIONAL_FEATURES

מאפשרת להשבית תכונות אופציונליות ב-VHAL. המאפיין הזה מדווח על תכונות אופציונליות שצריך להשבית. כל התכונות האופציונליות המותרות למערכת מוצהרות בשכבת-העל של שירות הרכב, config_allowed_optional_car_features. הנכס הזה מאפשר להשבית תכונות שהוגדרו בשכבת-העל. בלי הנכס הזה, כל התכונות שהוגדרו בשכבת-העל יופעלו. הערך READ צריך לכלול את כל התכונות שהושבתו, עם הפרדה באמצעות פסיק (,). לדוגמה, com.android.car.user.CarUserNoticeService,storage_monitoring

מצב שינוי: STATIC
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

DISPLAY_BRIGHTNESS

מאפיין שמייצג את הבהירות של המסך. בחלק מהרכבים יש אמצעי בקרה יחיד לשליטה בהבהירות של כל המסכים. הנכס הזה מיועד לשיתוף שינויים באמצעי הבקרה הזה. ברכב עם מסכים שהבהירות שלהם נשלטת בנפרד, צריך להשתמש ב-PER_DISPLAY_BRIGHTNESS. צריך להטמיע רק אחת מהאפשרויות DISPLAY_BRIGHTNESS או PER_DISPLAY_BRIGHTNESS. אם שני הערכים זמינים, PER_DISPLAY_BRIGHTNESS משמש את AAOS. אם אפשר לכתוב ב-SharedPreferences, מערכת Android יכולה להגדיר את הערך הזה כשהמשתמש משנה את הבהירות של המסך דרך ההגדרות. אם ההגדרה היא READ בלבד, המשתמש עדיין יכול לשנות את בהירות המסך דרך ההגדרות, אבל השינוי לא ישתקף במסכים אחרים.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

DISTANCE_DISPLAY_UNITS

יחידות המרחק שמוצגות. מציין את היחידות שבהן הרכב משתמש כדי להציג למשתמש את המרחקים. לדוגמה, מייל, מטר או קילומטר. יחידות המרחק מוגדרות ב-VehicleUnit. המאפיין VehiclePropConfig.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
סוג Enum: VehicleUnit
סוג יחידה: לא רלוונטי
גרסה: Android 13

DOOR_CHILD_LOCK_ENABLED

התכונה 'נעילה לילדים בדלת' מופעלת. הפונקציה מחזירה את הערך true אם התכונה של מנעול הילדים בדלת מופעלת, ואת הערך false אם היא מושבתת. אם ההגדרה הזו מופעלת, אי אפשר לפתוח את הדלת מבפנים. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

DOOR_LOCK

הערך True ב-Door lock מציין שהדלת נעולה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

DOOR_MOVE

צריך להגדיר את maxInt32Value ו-minInt32Value בכל VehicleAreaConfig. כל המספרים השלמים בין minInt32Value ל-maxInt32Value חייבים להיות נתמכים. הערך maxInt32Value מייצג את מהירות התנועה המרבית של הדלת בזמן הפתיחה. הערך minInt32Value מייצג את מהירות התנועה המקסימלית של הדלת בזמן סגירתה.

ערכים אבסולוטיים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. כשהדלת מגיעה למגבלת המיקום, צריך לאפס את הערך ל-0. אם הערך של DOOR_MOVE הוא 0, המשמעות היא שאין תנועה כרגע.

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

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

DOOR_POS

מיקום הדלת. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריכה להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. הסמל minInt32Value מציין שהדלת סגורה. הערך של minInt32Value חייב להיות 0. הסמל maxInt32Value מציין שהדלת פתוחה לגמרי. ערכים בין minInt32Value ל-maxInt32Value מציינים מצב מעבר בין המצבים 'סגור' ו'פתוח לגמרי'.

הנכס הזה לא נמצא ביחידה מסוימת, אלא בטווח מסוים של מיקומים יחסיים. בחלק מהרכבים (מיניבוסים) אפשר לפתוח את הדלת באופן אלקטרוני. לכן יש אפשרות WRITE את המאפיין הזה. הנכס הזה מוגדר בתור VehiclePropertyAccess READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

E עד G

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

סטטוס הכרטיס לחיוב אוטומטי באגרות. המאפיין הזה מציין את הסטטוס של כרטיס ETC ברכב הזה. אם היחידה הראשית מזהה כרטיס ETC שמחובר לרכב, הערך של ELECTRONIC_TOLL_COLLECTION_CARD_TYPE יהיה הסטטוס של הכרטיס. אחרת, המאפיין הזה צריך להיות UNAVAILABLE

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: ElectronicTollCollectionCardStatus
סוג יחידה: N/A
גרסה: Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

סוג הכרטיס לחיוב אוטומטי באגרות (ETC). המאפיין הזה מציין את סוג כרטיס ה-ETC ברכב הזה. אם היחידה הראשית מזהה כרטיס ETC שמחובר לרכב, המאפיין הזה צריך להחזיר את סוג הכרטיס המחובר. אחרת, המאפיין הזה צריך להיות UNAVAILABLE

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: ElectronicTollCollectionCardType
סוג יחידה: N/A
גרסה: Android 13

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

מפעילים או משביתים את התכונה 'עזרה לשמירה על נתיב במצב חירום' (ELKA). מגדירים את הערך true כדי להפעיל את ELKA, ואת הערך false כדי להשבית את ELKA. כשהתכונה ELKA מופעלת, מערכת ADAS ברכב אמורה להיות מופעלת ולעקוב אחרי שינויי נתיבים לא בטוחים של הנהג. כשהמערכת מזהה תמרון לא בטוח, היא מתריעה לנהג ומבצעת תיקוני היגוי כדי לשמור על הרכב בנתיב המקורי. באופן כללי, EMERGENCY_LANE_KEEP_ASSIST_ENABLED תמיד צריך להחזיר את הערך true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין EMERGENCY_LANE_KEEP_ASSIST_STATE. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

מצב של התכונה 'סיוע לשמירה על נתיב נסיעה במצב חירום' (ELKA). הפונקציה מחזירה את המצב הנוכחי של ELKA. באופן כללי, המאפיין הזה אמור להחזיר מצב תקין שמוגדר ב-EmergencyLaneKeepAssistState או ב-ErrorState. לדוגמה, אם התכונה לא זמינה בגלל מצב זמני כלשהו, המידע הזה צריך להישלח דרך ErrorState. למזהה האזור הגלובלי (0), צריך להגדיר את המערך VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של EmergencyLaneKeepAssistState (כולל OTHER, שלא מומלץ) ושל ErrorState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: EmergencyLaneKeepAssistState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

ENGINE_COOLANT_TEMP

הטמפרטורה של נוזל הקירור של המנוע.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:CELSIUS
גרסה: Android 13

ENGINE_IDLE_AUTO_STOP_ENABLED

מייצג את התכונה של עצירה אוטומטית של מנוע במצב סרק. אם הערך הוא True, המנוע עשוי להיכבות באופן אוטומטי כשאין צורך בו, ולאחר מכן להופעל מחדש באופן אוטומטי כשיש צורך בו. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

ENGINE_OIL_LEVEL

רמת שמן המנוע.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleOilLevel
סוג יחידה: N/A
גרסה: Android 13

ENGINE_OIL_TEMP

הטמפרטורה של שמן המנוע.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:CELSIUS
גרסה: Android 13

ENGINE_RPM

סיבובי המנוע לדקה (RPM).

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:RPM
גרסה: Android 13

ENV_OUTSIDE_TEMPERATURE

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

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:CELSIUS
גרסה: Android 13

EV_BATTERY_DISPLAY_UNITS

יחידות של סוללות לרכבים חשמליים (EV) להצגה. היחידה שבה נעשה שימוש ברכב כדי להציג למשתמש מידע על הסוללה של הרכב החשמלי. לדוגמה, שעות-ואט (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
סוג Enum: VehicleUnit
סוג יחידה: N/A
גרסה: Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

קצב הטעינה המיידי של רכב חשמלי (EV) במיליואט. ערך חיובי מציין שהסוללה נטענת. ערך שלילי מציין שהסוללה מתרוקנת.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:MW
גרסה: Android 13

EV_BATTERY_LEVEL

הפונקציה מחזירה את רמת הטעינה הנוכחית של הסוללה, בין אם מדובר ברכב חשמלי (EV) ובין אם ברכב היברידי. הערך הזה לא יעלה על EV_CURRENT_BATTERY_CAPACITY. כדי לחשב את אחוז הטעינה של הסוללה, משתמשים בנוסחה (EV_BATTERY_LEVEL, EV_CURRENT_BATTERY_CAPACITY)*100.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:WH
גרסה: Android 13

EV_BRAKE_REGENERATION_LEVEL

רמת הבלימה הרגנרטיבית של רכב חשמלי. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. כל הערכים בין minInt32Value ל-maxInt32Value חייבים להיות נתמכים. הערך של minInt32Value חייב להיות 0. השדה maxInt32Value מציין את ההגדרה של כמות האנרגיה המקסימלית שאפשר לייצר מהבלמים. הערך minInt32Value מציין את ההגדרה לבלימה רגנרטיבית. המאפיין הזה הוא צורה מפורטת יותר של EV_REGENERATIVE_BRAKING_STATE. הוא מאפשר למשתמש להגדיר רמה ספציפית יותר של בלימה רגנרטיבית אם המצבים ב-EvRegenerativeBrakingState לא מספיק מפורטים ל-OEM. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

הנתון הזה מציין את סף משיכת הזרם המקסימלי לטעינה שהוגדר על ידי המשתמש. השדה EvChargeState::configArray[0] משמש לציון זרם המשיכה המקסימלי שמותר ברכב באמפרים. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITEREAD
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:AMPERE
גרסה: Android 13

EV_CHARGE_PERCENT_LIMIT

הנתון הזה מציין את אחוז הסף המקסימלי של החיוב שהמשתמש הגדיר. הנתון הזה מציין את אחוז החיוב המקסימלי שהמשתמש הגדיר. הפונקציה מחזירה ערך של float בין 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

EV_CHARGE_PORT_CONNECTED

שקע הטעינה של הרכב החשמלי מחובר. אם לרכב יש כמה שקעי טעינה, המאפיין הזה צריך להחזיר את הערך true כשאחד משקעי הטעינה מחובר.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

EV_CHARGE_PORT_OPEN

שקע הטעינה של הרכב החשמלי פתוח. אם לרכב יש כמה שקעי טעינה, המאפיין הזה חייב להחזיר את הערך true אם אחד משקעי הטעינה פתוח. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITEREAD
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

EV_CHARGE_STATE

מצב הטעינה של הרכב הפונקציה מחזירה את מצב הטעינה הנוכחי של הרכב. אם לרכב יש אחוז טעינה יעד שאינו 100, המאפיין הזה צריך להחזיר את הערך EvChargeState::STATE_FULLY_CHARGED כשרמת הטעינה של הסוללה מגיעה לרמת היעד. לקבלת הקשר נוסף, אפשר לעיין במאמר EvChargeState::EV_CHARGE_PERCENT_LIMIT.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: EvChargeState
סוג יחידה: N/A
גרסה: Android 13

EV_CHARGE_SWITCH

הפעלה או הפסקה של הטעינה של סוללת הרכב החשמלי. ההגדרה שהמשתמש רוצה. הגדרת המאפיין הזה כ-true מתחילה את טעינת הסוללה, והגדרה כ-false מפסיקה את הטעינה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITEREAD
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

EV_CHARGE_TIME_REMAINING

משך הזמן המשוער שנותר לטעינה, בשניות. הפונקציה מחזירה את הערך 0 אם הרכב לא בטעינה.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:SECS
גרסה: Android 13

EV_CURRENT_BATTERY_CAPACITY

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

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:WH
גרסה: Android 14

EV_REGENERATIVE_BRAKING_STATE

בלימה רגנרטיבית או הגדרת נסיעה בלחיצת כפתור אחת ברכב. הפונקציה מחזירה את ההגדרה הנוכחית שמשויכת להגדרת הבלימה הרגנרטיבית ברכב. אם ל-OEM נדרשות הגדרות נוספות מעבר לאלה שסופקו ב-EvRegenerativeBrakingState, אפשר להשתמש בנכס EV_BRAKE_REGENERATION_LEVEL במקום זאת, שמספק מידע מפורט יותר.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: EvRegenerativeBrakingState
סוג יחידה: N/A
גרסה: Android 13

EV_STOPPING_MODE

מאפיין שמייצג את מצב העצירה הנוכחי של הרכב. למזהה האזור הגלובלי (0), צריך להגדיר את VehicleAreaConfig#supportedEnumValues אלא אם כל ערכי המאפיין המסווג של EvStoppingMode נתמכים. יכול להיות שהרשימה של המצבים ב-EvStoppingMode תתרחב בעתיד. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל ליצרני ציוד מקורי יש אפשרות להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: EvStoppingMode
סוג יחידה: לא רלוונטי
גרסה: Android 14

EVS_SERVICE_REQUEST

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

  • int32Values[0] סוג השירות של מערכת התצוגה החיצונית (EVS). הערך חייב להיות enum ב-EvsServiceType.
  • int32Values[1] הסטטוס של שירות מערכת התצוגה החיצונית (EVS). הערך חייב להיות אחד מהערכים של enums ב-EvsServiceState.

לדוגמה, כדי להפעיל את שירות ה-EVS לתצוגה אחורית, מערכת Android יכולה להגדיר את ערך המאפיין כך:

[EvsServiceType::REAR_VIEW, EvsServiceState::ON]

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

EXTERNAL_CAR_TIME

הצעה לתאריך ולשעה הנוכחיים של ה-CR, בקידוד של זמן Epoch (באלפיות השנייה). הערך הזה מציין את מספר אלפיות השנייה שעברו מאז 1 בינואר 1970 (UTC). הנכס הזה מאותת על שינוי ב-CarTime ל-Android. אם יש תמיכה במאפיין, ה-VHAL חייב לדווח על הערך המדויק ביותר של CarTime הנוכחי כשהנכס הזה נקרא, ולפרסם שינוי בנכס הזה כשערך CarTime ישתנה.

צריך לפרסם אירוע שינוי של המאפיין הזה כשזמן הנסיעה משתנה מכל סיבה שהיא מלבד חלוף הזמן הטבעי (הפרש זמן של פחות מ-500 אלפיות שנייה לא אמור להפעיל אירוע שינוי). Android יקרא את הנכס הזה ויירשם אליו כדי לאחזר את השעה מ-VHAL. האפשרות הזו יכולה להיות שימושית לסנכרון השעון של Android עם מערכות אחרות ברכב (שעון במסך הרכב). int64Values[0] = שעון Epoch שסופק (במילי-שניות) בכל פעם שמתקבל ערך חדש לנכס, מערכת AAOS יוצרת ומוסרת הצעה לזמן חיצוני ל-TimeDetectorService.

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

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

מומלץ מאוד לא להשתמש במאפיין הזה כדי לאחזר זמן מ-ECU באמצעות פרוטוקולים (כמו GNSS,‏ NTP וטלפוניה). מאחר שהפרוטוקולים האלה כבר נתמכים ב-Android, מומלץ להשתמש במערכות Android במקום לחבר דרך VHAL באמצעות המאפיין הזה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: 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
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: 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
סוג Enum: VehicleLightSwitch
סוג יחידה: N/A
גרסה: Android 13

FORWARD_COLLISION_WARNING_ENABLED

מפעילים או משביתים את התכונה 'אזהרה מפני התנגשות קדימה' (FCW). מגדירים את הערך כ-true כדי להפעיל את FCW וכ-false כדי להשבית את FCW. כשהתכונה FCW מופעלת, מערכת ה-ADAS ברכב צריכה להיות מופעלת ולעקוב אחרי התנגשויות פוטנציאליות. באופן כללי, הפונקציה FORWARD_COLLISION_WARNING_ENABLED צריכה תמיד להחזיר את הערכים true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין FORWARD_COLLISION_WARNING_STATE.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

FORWARD_COLLISION_WARNING_STATE

המצב של התראת התנגשות קדימה (FCW). הפונקציה מחזירה את המצב הנוכחי של 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
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: 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
סוג Enum: VehicleLightSwitch
סוג יחידה: N/A
גרסה: Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

יחידות של צריכת דלק להצגה. מציין את סוג היחידות שבהן הרכב משתמש כדי להציג למשתמשים את נתוני צריכת הדלק. הערך True מציין שהיחידות הן מרחק לנפח, כמו ליטר לקילומטר. הערך False מציין שהיחידות הן נפח יחסית למרחק, למשל ליטר ל-100 ק"מ. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

FUEL_LEVEL

כמות הדלק שנותר ברכב, במיליליטר. המאפיין הזה צריך לציין את כמות הדלק שנותרה ברכב, במיליליטר. המאפיין הזה לא רלוונטי לכלי רכב חשמליים. כלומר, אם INFO_FUEL_TYPE מכיל רק את הערך FuelType::FUEL_TYPE_ELECTRIC, אסור להטמיע את המאפיין הזה. לכלי רכב חשמליים, מטמיעים את הקוד EV_BATTERY_LEVEL Value can not exceed INFO_FUEL_CAPACITY

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:MILLILITER
גרסה: Android 13

FUEL_LEVEL_LOW

אזהרה על רמת דלק נמוכה. המאפיין הזה תואם לאזהרה על רמת דלק נמוכה בלוח הבקרה. אחרי שמגדירים את FUEL_LEVEL_LOW, לא צריך לנקות אותו עד שמוסיפים עוד דלק לרכב. המאפיין הזה יכול להביא בחשבון את כל מקורות הדלק ברכב. לדוגמה:

  • רכב מונעת בנזין,המאפיין הזה מבוסס אך ורק על רמת הדלק.
  • רכב חשמלי, המאפיין הזה מבוסס רק על רמת הטעינה בסוללה.
  • רכב היברידי: הנכס הזה יכול להתבסס על שילוב של רמות הדלק והסוללה, לפי שיקול דעתו של יצרן הציוד המקורי.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: VehicleUnit
סוג יחידה: N/A
גרסה: Android 13

GEAR_SELECTION

הציוד שנבחר על ידי המשתמש. הערכים בנתוני התצורה חייבים לייצג את רשימת ההילוכים הנתמכים ברכב הזה. לדוגמה, נתוני התצורה של תיבת הילוכים אוטומטית חייבים לכלול את הערך {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
סוג Enum: VehicleGear
סוג יחידה: N/A
גרסה: Android 13

GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT

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

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: GsrComplianceRequirementType
סוג יחידה: N/A
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

GLOVE_BOX_LOCKED

נעילה או ביטול נעילה של תא הכפפות. אם הערך הוא True, תא הכפפות נעול. אם הערך הוא false, תא הכפפות לא נעול. מזהה האזור חייב להתאים למושב שבו מיועדת לשימוש תא הכפפות. לדוגמה, אם לוח הבקרה הימני הקדמי כולל תא כפפות מוטמע, מזהה האזור צריך להיות VehicleAreaSeat#ROW_1_RIGHT.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

H עד I

HANDS_ON_DETECTION_DRIVER_STATE

מצב הנהג בזיהוי ידיים על ההגה (HOD). הפונקציה מחזירה תשובה אם הידיים של הנהג על ההגה. באופן כללי, המאפיין הזה אמור להחזיר מצב תקין שמוגדר ב-HandsOnDetectionDriverState או ב-ErrorState. לדוגמה, אם התכונה לא זמינה בגלל מצב זמני כלשהו, המידע הזה צריך להישלח דרך ErrorState. אם הרכב רוצה לשלוח אזהרה למשתמש כי ידי הנהיגה לא היו על ההגה במשך זמן רב מדי, האזהרה צריכה להופיע דרך HANDS_ON_DETECTION_WARNING. למזהה האזור הגלובלי (0), צריך להגדיר את מערך VehicleAreaConfig#supportedEnumValues, אלא אם כל המצבים של HandsOnDetectionDriverState (כולל OTHER, שלא מומלץ) ושל ErrorState נתמכים.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: HandsOnDetectionDriverState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

HANDS_ON_DETECTION_ENABLED

מפעילים או משביתים את התכונה 'זיהוי מגע' (HOD). מגדירים את הערך true כדי להפעיל את HOD ואת הערך false כדי להשבית את HOD. כשהתכונה HOD מופעלת, מערכת ברכב אמורה לעקוב אחרי נוכחות הידיים של הנהג על ההגה ולשלוח התראה אם היא מזהה שהידיים של הנהג כבר לא על ההגה. באופן כללי, הפונקציה HANDS_ON_DETECTION_ENABLED תמיד צריכה להחזיר את הערך true או false.

אם התכונה לא זמינה בגלל מצב זמני כלשהו, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין HANDS_ON_DETECTION_STATE. הנכס הזה מוגדר בתור minInt32Value VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

HANDS_ON_DETECTION_WARNING

אזהרה על זיהוי על ידי מגע (HOD). הפונקציה מחזירה אם נשלחת התראה לנהג כי הידיים שלו לא על ההגה במשך זמן רב מדי. באופן כללי, המאפיין הזה אמור להחזיר מצב תקין שמוגדר ב-HandsOnDetectionWarning או ב-ErrorState. לדוגמה, אם התכונה לא זמינה בגלל מצב זמני כלשהו, המידע הזה צריך להישלח באמצעות ErrorState. עבור מזהה האזור הגלובלי (0), צריך להגדיר את המערך VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של HandsOnDetectionWarning (כולל OTHER, שלא מומלץ) ושל ErrorState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: HandsOnDetectionWarning/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

HAZARD_LIGHTS_STATE

סטטוס אורות החירום. הפונקציה מחזירה את הסטטוס הנוכחי של אורות החירום.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: Android 13

HAZARD_LIGHTS_SWITCH

מתג אורות החירום. ההגדרה שהמשתמש רוצה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה: N/A
גרסה: Android 13

HEADLIGHTS_STATE

מצב הפנסים הקדמיים. הפונקציה מחזירה את המצב הנוכחי של הפנסים הקדמיים.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: Android 13

HEADLIGHTS_SWITCH

מתג הפנסים. ההגדרה שהמשתמש רוצה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה: N/A
גרסה: Android 13

HIGH_BEAM_LIGHTS_STATE

מצב הפנסים הקדמיים. הפונקציה מחזירה את המצב הנוכחי של תאורת גבוהה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: Android 13

HIGH_BEAM_LIGHTS_SWITCH

מתג אור גבוה. ההגדרה שהמשתמש רוצה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה: N/A
גרסה: Android 13

HVAC_AC_ON

הפעלה והשבתה של המיזוג באזור המסומן ב-areaId. המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

מהירות המאוורר בפועל.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_AUTO_ON

הפעלה והשבתה של בקרת אקלים אוטומטית. אם הערך הוא true, בקרת האקלים האוטומטית מופעלת. אם הערך הוא false, בקרת האקלים האוטומטית מושבתת. אם הרכב לא תומך בהשבתה ישירה של בקרת האקלים האוטומטית, יצרני ציוד מקורי צריכים להוסיף לוגיקה להטמעת VHAL כדי להגדיר את HVAC_AUTO_ON כ-false, וכך לשנות את הגדרות בקרת האקלים הנדרשות כדי להשבית את HVAC_AUTO_ON באופן עקיף. באופן אידיאלי, הפעולה הזו לא אמורה להפריע למשתמש. יצרני ציוד מקורי צריכים להחזיר למצב הקודם את כל ההגדרות ששונו כשבקרת האקלים האוטומטית מושבתת. כך, התוצאה היחידה אמורה להיות שהאפשרות HVAC_AUTO_ON תהיה מושבתת. אם אי אפשר לשחזר את הגדרות בקרת האקלים להגדרות הקודמות, יצרני הציוד המקורי צריכים להטמיע את השינוי שהכי פחות מפריע.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_AUTO_RECIRC_ON

הפעלה או השבתה של מערכת הסירקולציה האוטומטית. כשהמערכת מופעלת, מערכת בקרת האקלים עשויה לעבור אוטומטית למצב סירקולציה אם הרכב מזהה איכות אוויר נכנסת נמוכה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_DEFROSTER

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

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_DUAL_ON

הפעלת התאמת טמפרטורה בין אזורים. השדה AreaIDs של נכס HVAC_DUAL_ON צריך להכיל שילוב של HVAC_TEMPERATURE_SET AreaIDs שאפשר לצרף יחד. אם HVAC_TEMPERATURE_SET ממופה אל AreaIDs[a_1, a_2, ..., a_n] ואם אפשר להפעיל את HVAC_DUAL_ON כדי לשייך את a_i ל-a_j, אז צריך למפות את המאפיין HVAC_DUAL_ON אל [a_i | a_j]. בנוסף, אם אפשר לצרף את a_k ואת a_l בנפרד, צריך למפות את HVAC_DUAL_ON אל [a_i | a_j, a_k | a_l]. לדוגמה, ברכב יש שני מושבים קדמיים (ROW_1_LEFT ו-ROW_1_RIGHT) ושלוש מושבים אחוריים (ROW_2_LEFT,‏ ROW_2_CENTER ו-ROW_2_RIGHT). יש שתי יחידות לוויסות הטמפרטורה, בצד הנהג ובצד הנוסע, שאפשר לסנכרן אותן. אפשר לבטא את זה כך ב-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]

כשהנכס מופעל, ה-ECU צריך לסנכרן את הטמפרטורה באזורים המושפעים. כל פרמטר ששונה כתוצאה מכך שהפעלתם או השבתתם את הפרמטר DUAL_ON יגרום ליצירת קריאות חזרה (callbacks) מסוג onPropertyEvent() ל-VHAL. בנוסף, אם הגדרת טמפרטורה (לדוגמה, טמפרטורה של הנהג) משנה טמפרטורה אחרת (לדוגמה, טמפרטורה של הנוסע מלפנים), צריך ליצור את פונקציות ה-callbacks המתאימות של onPropertyEvent().

אם משתמש משנה טמפרטורה שמפרה את הצירוף (לדוגמה, מגדיר את הטמפרטורה של הנוסעים בנפרד), ה-VHAL צריך לשלוח את קריאות החזרה (callbacks) המתאימות של onPropertyEvent() (כולל HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx). המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_ELECTRIC_DEFROSTER_ON

הסטטוס של מכשירים להפשרת מזון חשמליים.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_FAN_DIRECTION

הגדרת כיוון המאוורר. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleHvacFanDirection
סוג יחידה: N/A
גרסה: Android 13

HVAC_FAN_DIRECTION_AVAILABLE

יש משרות פנויות למעריצים. זוהי מסכת ביט של מיקומי המאווררים שזמינים לאזור. כל כיוון זמין של המאוורר מסומן באמצעות רשומה נפרדת בוקטור. כיוון המאוורר יכול לכלול כמה ביטים מקבוצת vehicle_hvac_fan_direction. לדוגמה, במכונית רגילה יכולות להיות אלה המיקומים של המאוורר:

- 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)

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: VehicleHvacFanDirection
סוג יחידה: N/A
גרסה: Android 13

HVAC_FAN_SPEED

הגדרת מהירות המאוורר. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריך להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value.

  • minInt32Value מהירות המאוורר הנמוכה ביותר
  • maxInt32Value מהירות המאוורר הגבוהה ביותר

הנכס הזה לא מוגדר ביחידות ספציפיות, אלא בטווח ספציפי של מהירויות יחסיות. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להחליט להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_MAX_AC_ON

הפעלה או השבתה של מצב MAX AC. כשמצב MAX AC מופעל, ה-ECU יכול לשנות פריטים כמו מיקום פתחי האוורור, מהירות המאוורר והטמפרטורה לפי הצורך כדי לקרר את הרכב מהר ככל האפשר. כל פרמטר ששונה כתוצאה מכך שהפעלתם או השבתתם את הפרמטר MAX AC יוצר קריאות חזרה (callbacks) מסוג onPropertyEvent() ל-VHAL. המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_MAX_DEFROST_ON

מפעילים ומכבים את MAX DEFROST. כשהאפשרות MAX DEFROST מופעלת, ה-ECU יכול לשנות פריטים כמו מיקום פתחי האוורור, מהירות המאוורר והטמפרטורה לפי הצורך כדי להפשיר את החלונות במהירות האפשרית. כל פרמטר ששונה כתוצאה מכך שהפעלתם או השבתתם את הפרמטר MAX DEFROST יוצר קריאות חזרה (callbacks) מסוג onPropertyEvent() ל-VHAL. הערך AreaIDs עבור HVAC_MAX_DEFROST_ON מציין שאפשר לשלוט ב-MAX DEFROST באזור. לדוגמה, הערך areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} מציין שאפשר לשלוט ב-HVAC_MAX_DEFROST_ON רק בשורות הקדמיות. המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_POWER_ON

מציין את מצב החשמל הגלובלי של בקרת האקלים. הגדרת המאפיין הזה כ-false עשויה לסמן חלק מהמאפיינים ששולטים בתכונות ובתת-מערכות נפרדות של בקרת אקלים במצב UNAVAILABLE. הגדרת המאפיין הזה כ-true עשויה לסמן חלק מהנכסים ששולטים בתכונות ובתת-מערכות נפרדות של מיזוג אוויר למצב 'זמין' (אלא אם אחד או כל הנכסים הם במצב 'לא זמין' בזכות עצמם).

HvacPower_DependentProperties הם נכסים שבהם צריך להפעיל את מיזוג האוויר כדי להפעיל את הפונקציונליות. לדוגמה, בחלק מהרכבים צריך להפעיל קודם את המיזוג כדי להפעיל את המזגן. יש להגדיר את הרשימה HvacPower_DependentProperties ב-VehiclePropConfig.configArray. HvacPower_DependentProperties חייבת להכיל רק את המאפיינים המשויכים ל-VehicleArea:SEAT

מיפוי של AreaID לנכס HVAC_POWER_ON חייב לכלול את כל הערכים של AreaIDs שאליהם ממופה HvacPower_DependentProperties. לדוגמה, לרכב יש שני:

  1. המושבים הקדמיים (ROW_1_LEFT, ROW_1_RIGHT) ושלושת המושבים האחוריים (ROW_2_LEFT, ‏ ROW_2_CENTER, ‏ ROW_2_RIGHT). אם תכונות בקרת האקלים (מזגן, טמפרטורה וכו') ברכב תלויות במתג יחיד של בקרת אקלים, צריך למפות את HVAC_POWER_ON אל [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
  2. מושבים בשורה הקדמית (ROW_1_LEFT, ROW_1_RIGHT) ושלושה מושבים בשורות השנייה (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) והשלישית (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT). אם ברכב יש פקדי טמפרטורה בשורה הקדמית שיכולים לפעול באופן עצמאי לחלוטין מפקדי הטמפרטורה בחלק האחורי של הרכב, צריך למפות את HVAC_POWER_ON למערך של שני רכיבים:
    - ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
    

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל ליצרני ציוד מקורי יש אפשרות להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_RECIRC_ON

הפעלה או השבתה של מערכת הסירקולציה. המערכת קובעת את אספקת האוויר החיצוני לתא הנוסעים. אם האפשרות 'מחזור אוויר' מופעלת, רוב זרימת האוויר לתא מגיע מתוך התא. אם האפשרות 'מחזור אוויר' מושבתת, רוב זרימת האוויר לתא הנוסעים מגיעה מחוץ לרכב. המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_SEAT_TEMPERATURE

חימום וקירור של המושבים. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריך להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. הערך maxInt32Value מציין את הגדרת החימום המקסימלית של טמפרטורת המושב. הערך של minInt32Value חייב להיות 0, אלא אם הרכב תומך בקירור המושבים. במקרה כזה, הערך minInt32Value מציין את הגדרת הקירור המקסימלית של טמפרטורת המושב. הנכס הזה לא מוגדר ביחידות ספציפיות, אלא בטווח מסוים של הגדרות טמפרטורה יחסית. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_SEAT_VENTILATION

אוורור המושב. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריך להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. הערך של minInt32Value חייב להיות 0. הערך maxInt32Value מציין את הגדרת האוורור המקסימלית שזמינה במושב.

הנכס הזה לא נמצא ביחידת ספציפית, אלא בטווח שצוין של הגדרות האוורור.

האפליקציות של בקרת האקלים ו-Assistant משתמשות בנתון הזה כדי להפעיל, לשנות או לקרוא את מצב האוורור של המושב. ההגדרה הזו שונה מהגדרת הקירור במושבים. אפשר להפעיל אותו בו-זמנית עם הקירור או לא.

הנכס הזה מוגדר בתור >VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_SIDE_MIRROR_HEAT

חימום של מראות הצד. ערכים גבוהים יותר מציינים רמות חימום גבוהות יותר של מראות הצד. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריך לתמוך בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. בנתוני התצורה:

  • maxInt32Value מייצג את רמת החימום המקסימלית.
  • הערך של minInt32Value חייב להיות 0, והוא מציין שאין חימום.

הנכס הזה לא נמצא ביחידת חימום מסוימת, אלא בטווח מסוים של הגדרות חימום יחסיות. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל ליצרני ציוד מקורי יש אפשרות להטמיע אותו בתור VehiclePropertyAccess.READ

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_STEERING_WHEEL_HEAT

הגדרת עוצמת החימום והקירור של ההגה. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. כל המספרים השלמים בין minInt32Value ל-maxInt32Value חייבים להיות נתמכים. ה-maxInt32Value מציין את ההגדרה המקסימלית לחימום ההגה. הערך של minInt32Value צריך להיות 0, אלא אם הרכב תומך גם בקירור של ההגה. במקרה כזה, ה-minInt32Value מציין את הגדרת הקירור המקסימלית של ההגה. המאפיין הזה לא נמצא ביחידת חימום מסוימת, אלא בטווח מסוים של הגדרות חימום. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HVAC_TEMPERATURE_CURRENT

הטמפרטורה הנוכחית של בקרת האקלים.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:CELSIUS
גרסה: Android 13

HVAC_TEMPERATURE_DISPLAY_UNITS

יחידות הטמפרטורה שמוצגות. מציין אם הטמפרטורה מוצגת בצלזיוס או בפרנהייט. VehiclePropConfig.configArray מציין את יחידות הצגת הטמפרטורה הנתמכות. לדוגמה, configArray[0] = CELSIUS configArray[1] = FAHRENHEIT אפשר להשתמש בפרמטר הזה כדי להציג את הטמפרטורה של כל רכיב בקרת אקלים במערכת. הערכים האפשריים הם VehicleUnit.CELSIUS או VehicleUnit.FAHRENHEIT

אם העדכון של HVAC_TEMPERATURE_DISPLAY_UNITS משפיע על הערכים של מאפייני *_DISPLAY_UNITS אחרים, צריך לעדכן את הערכים שלהם ולעדכן את מסגרת AAOS.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleUnit
סוג יחידה: N/A
גרסה: Android 13

HVAC_TEMPERATURE_SET

טמפרטורת היעד של בקרת האקלים מוגדרת במעלות צלזיוס.

צריך להגדיר את minFloatValue ו-maxFloatValue ב-VehicleAreaConfig:

  • הגדרת הטמפרטורה המינימלית minFloatValue במעלות צלזיוס.
  • maxFloatValue הגדרת הטמפרטורה המקסימלית במעלות צלזיוס.

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

הערך של configArray מוגדר באופן הבא:

  • configArray[0] [הגבול התחתון של הטמפרטורה הנתמכת בצלזיוס] * 10
  • configArray[1] [הגבול העליון של הטמפרטורה הנתמכת במעלות צלזיוס] * 10
  • configArray[2] [עלייה בצלזיוס] * 10
  • configArray[3] [הגבול התחתון של הטמפרטורה הנתמכת בפרנהייט] * 10
  • configArray[4] [הגבול העליון של הטמפרטורה הנתמכת בפרנהייט] * 10
  • configArray[5] [increment in Fahrenheit] * 10

הערכים של minFloatValue ו-maxFloatValue ב-VehicleAreaConfig חייבים להיות שווים ל-configArray[0] ול-configArray[1], בהתאמה. לדוגמה, אם הרכב תומך בערכים של טמפרטורה כמו [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] במעלות פרנהייט, הערך של configArray צריך להיות configArray = {160, 280, 5, 605, 845, 10}

באופן אידיאלי, היחס בין העלייה בצלזיוס לעלייה בפרנהייט צריך להיות קרוב ליחס בפועל של מעלה צלזיוס אחת ל-1.8 מעלות פרנהייט. צריך להיות מיפוי אחד-לאחד של כל ערכי הצלזיוס לערכי הפרנהייט שמוגדרים על ידי configArray. הלקוחות משתמשים ב-configArray כדי להמיר את הטמפרטורה של הנכס הזה מצלזיוס לפרנהייט. בנוסף, הוא מאפשר ללקוחות לדעת איזה ערך צלזיוס להגדיר לנכס כדי להגיע לערך הפרנהייט הרצוי במערכת. אם ב-ECU אין מיפוי אחד-לאחד של כל הערכים בסולם צלזיוס לערכי פרנהייט, צריך להגדיר ב-configArray רק את רשימת הערכים בסולם צלזיוס ובסולם פרנהייט שיש להם מיפוי אחד-לאחד.

לדוגמה, אם ה-ECU תומך בערכי צלזיוס מ-16 עד 28 ובערכים של פרנהייט מ-60 עד 85, כל אחד עם הגדלה של 1, אז ערך אפשרי אחד של configArray הוא קוד>{160, 280, 10, 600, 840, 20}. במקרה הזה, 85 היא לא טמפרטורה נתמכת.

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

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:CELSIUS
גרסה: Android 13

HVAC_TEMPERATURE_VALUE_SUGGESTION

ערכים מוצעים להגדרת הטמפרטורה של בקרת האקלים.

הטמעת המאפיין תעזור לאפליקציות להבין את ערך הטמפרטורה הקרוב ביותר שנתמך בצלזיוס או בפרנהייט.

  • floatValues[0] הערך המבוקש שהאפליקציה רוצה להגדיר לטמפרטורה.
  • floatValues[1] יחידה של floatValues[0], והיא צריכה להיות אחת מ-{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
  • floatValues[2] הערך שהציעו יצרני ציוד מקורי בצלזיוס (הערך הזה לא נכלל בבקשה).
  • floatValues[3] הערך שהציעו יצרני ציוד מקורי במדד פרנהייט (הערך הזה לא נכלל בבקשה).

אפליקציה קוראת ל-set(VehiclePropValue propValue) עם הערך המבוקש והיחידה של הערך. יצרני ציוד מקורי צריכים להחזיר את הערכים המוצעים בשדות floatValues[2] ו-floatValues[3] באמצעות קריאות חזרה (callbacks) של onPropertyEvent(). הערכים המוצעים חייבים להתאים לערכים שאפשר להפיק מ-HVAC_TEMPERATURE_SET configArray. במילים אחרות, הערכים המוצעים וטבלת הערכים מ-configArray צריכים להיות זהים.

המלצנו ל-OEM להוסיף לוגיקה מותאמת אישית להטמעת ה-VHAL כדי להימנע מהגשת בקשות ל-ECU של בקרת האקלים. הלוגיקה יכולה להיות כך: כדי להמיר טמפרטורה מצלזיוס לפרנהייט:

// 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;

לדוגמה, כשנהג משתמש באסיסטנט הקולי כדי להגדיר את הטמפרטורה של בקרת האקלים ל-66.2 מעלות פרנהייט. קודם כל, אפליקציה מגדירה את המאפיין הזה עם הערך [66.2, (float)VehicleUnit.FAHRENHEIT,0,0] אם יצרן ציוד מקורי מציע להגדיר 19.0 בצלזיוס או 66.5 בפרנהייט לפי בקשת המשתמש, אז VHAL חייב ליצור קריאה חוזרת עם ערך המאפיין [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5] אחרי שעוזרת הקול מקבלת את הקריאה החוזרת, היא מעדכנת את המשתמש ומגדירה את הטמפרטורה של מיזוג האוויר לערך שהציע.

דוגמה נוספת: אפליקציה מקבלת את הערך 21 מעלות צלזיוס כערך הטמפרטורה הנוכחית באמצעות שאילתה ל-HVC_TEMPERATURE_SET, אבל האפליקציה צריכה לדעת איזה ערך מוצג בממשק המשתמש של הרכב במעלות פרנהייט. לשם כך, האפליקציה מגדירה את המאפיין לערך [21, (float)VehicleUnit.CELSIUS, 0, 0]. אם הערך שהציע יצרן הציוד המקורי ל-21 מעלות צלזיוס הוא 70 מעלות פרנהייט, VHAL צריך ליצור קריאה חוזרת (callback) עם ערך המאפיין [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]. במקרה כזה, האפליקציה יכולה לדעת שהערך הוא 70.0 מעלות פרנהייט בממשק המשתמש של הרכב.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HW_CUSTOM_INPUT

הגדרת אירוע קלט מותאם אישית של שותף OEM. שותפי OEM שרוצים להפיץ אירועים שלא נתמכים ב-Android צריכים להשתמש באירוע הקלט הזה. הוא מורכב ממערך של ערכים מסוג int32 בלבד. המאפיינים של Android הם:

  • int32Values[0] קוד קלט שמזהה את הפונקציה שמייצגת את האירוע הזה. סוגי האירועים התקינים מוגדרים על ידי CustomInputType.CUSTOM_EVENT_F1 עד CustomInputType.CUSTOM_EVENT_F10. הם מייצגים את האירוע המותאם אישית ששותפי ה-OEM מגדירים.
  • int32Values[1] סוג המסך היעד שמוגדר ב-VehicleDisplay אירועים שלא קשורים למסך ספציפי חייבים להישלח אל VehicleDisplay#MAIN
  • int32Values[2] ספירת חזרות. אם הערך הוא 0, האירוע לא יחזור על עצמו. ערכים של 1 ומעלה מצביעים על מספר הפעמים שהאירוע הזה חזר על עצמו.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: CustomInputType
סוג יחידה: N/A
גרסה: Android 13

HW_KEY_INPUT

נכס להעברת אירועי קלט של חומרה ל-Android.

  • int32Values[0] פעולה שמוגדרת על ידי VehicleHwKeyInputAction
  • int32Values[1] קוד מפתח, צריך להשתמש בקוד מפתח רגיל של Android
  • int32Values[2] צג היעד שמוגדר ב-VehicleDisplay אירועים שלא קשורים לצג ספציפי חייבים להישלח אל VehicleDisplay#MAIN
  • int32Values[3] (אופציונלי) מספר הצלצולים. הערך חייב להיות שווה ל-1 או גדול ממנו. אם השדה הזה יושמט, ברירת המחדל ב-Android תהיה 1.

שינוי מצב: .ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

HW_KEY_INPUT_V2

נכס להעברת אירועי קלט של חומרה ל-Android.

  • int32array[0] צג היעד שמוגדר על ידי VehicleDisplay, למשל:
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
  • int32array[1] קוד מפתח, צריך להשתמש בקוד המפתח הרגיל של Android, כמו KEYCODE_HOME ו-KEYCODE_BACK
  • פעולת int32array[2] שמוגדרת ב-VehicleHwKeyInputAction, למשל:
    VehicleHwKeyInputAction::ACTION_UP, VehicleHwKeyInputAction::ACTION_UP
  • int32array[3] מספר החזרות של האירוע. באירועי הקשה למטה, זהו מספר החזרות, כאשר הקשה למטה הראשונה מתחילה ב-0 וממשיכה למעלה. באירועי key up, הערך הזה תמיד שווה ל-0.
  • int64array[0] זמן השבתה בננו-שניות שחלפו מאז האתחול האחרון. הזמן של אירוע הקשה האחרון על מקש. באירוע ההשבתה, זוהי שעת האירוע של אירוע ההשבתה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

HW_MOTION_INPUT

מאפיין להעברת אירועי קלט של חומרה ל-Android.

  • int32array[0] תצוגת היעד שמוגדרת על ידי VehicleDisplay, למשל:
    VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
  • int32array[1] סוג הקלט שמוגדר ב-VehicleHwMotionInputSource, למשל:
    VehicleHwMotionInputSource::SOURCE_KEYBOARD, VehicleHwMotionInputSource::SOURCE_DPAD
  • int32array[2] קוד הפעולה שמוגדר ב-VehicleHwMotionInputAction, למשל:
    VehicleHwMotionInputAction::ACTION_UP, VehicleHwMotionInputAction::ACTION_DOWN
  • int32array[3] דגל מצב הלחצן שמוגדר ב-VehicleHwMotionButtonStateFlag, למשל:
    VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY, VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
  • int32array[4] מספר אירועי הסמן, N. הערך של N חייב להיות מספר שלם חיובי.
  • int32array[5:5+N-1] מזהה מצביע, באורך N
  • int32array[5+N:5+2*N-1] סוג הכלי, אורך N. כפי שמוגדר בקטע VehicleHwMotionToolType, למשל:
    VehicleHwMotionToolType::TOOL_TYPE_FINGER, VehicleHwMotionToolType::TOOL_TYPE_STYLUS
  • floatArray[0:N-1] x נתונים, אורך N
  • floatArray[N:2*N-1] נתוני y, באורך N
  • נתוני לחץ floatArray[2*N:3*N-1], באורך N
  • floatArray[3*N:4*N-1] נתוני גודל, אורך N
  • int64array[0] זמן השבתה, מיליוניית השנייה שחלפו מאז ההפעלה. הזמן שבו המשתמש לחץ למטה בפעם הראשונה כדי להתחיל את הזרם של אירועי המיקום. באירוע ההשבתה, זהו מועד האירוע של אירוע ההשבתה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

HW_ROTARY_INPUT

נכס להעברת אירועים של ציוד רוטורי ל-Android.

  • int32Values[0] RotaryInputType כדי לזהות איזו לחצן חוגה מסתובב.
  • int32Values[1] מספר הפסקות (קליקים), חיובי בכיוון השעון, שלילי בכיוון ההפוך לשעון.
  • int32Values[2] צג היעד שמוגדר ב-VehicleDisplay אירועים שלא קשורים לצג ספציפי חייבים להישלח אל VehicleDisplay#MAIN
  • int32values[3 .. 3 + abs(number of detents) - 2] דלתא של ננו-שנייה בין זוגות של נעילה רציפה כשמספר הנעילות הוא יותר מ-1 או פחות מ--1.
  • VehiclePropValue.timestamp מתי התרחש הסיבוב. אם מספר העצירות הוא יותר מ-1 או פחות מ-1, מתי התרחשה עצירתו הראשונה של הסיבוב.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: RotaryInputType
סוג יחידה: N/A
גרסה: Android 13

IGNITION_STATE

מציין את מצב ההצתה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleIgnitionState
סוג יחידה: N/A
גרסה: Android 13

INFO_DRIVER_SEAT

הטמעות VHAL של מיקום המושב של הנהג חייבות להתעלם מ-areaId. שימוש ב-VehicleArea:GLOBAL

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: VehicleAreaSeat
סוג יחידה: N/A
גרסה: Android 13

INFO_EV_BATTERY_CAPACITY

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

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: VehicleUnit:WH
גרסה: Android 13

INFO_EV_CONNECTOR_TYPE

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

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: EvConnectorType
סוג יחידה: N/A
גרסה: Android 13

INFO_EV_PORT_LOCATION

הנכס הזה צריך לציין את המיקום של שקע הטעינה ברכב החשמלי באמצעות המאפיין המצטבר PortLocationType. אם לרכב יש כמה שקעים, המאפיין הזה צריך להחזיר את השקע שמאפשר את הטעינה המהירה ביותר. כדי לשלוח את כל מיקומי היציאות, משתמשים ב-INFO_MULTI_EV_PORT_LOCATIONS

מיקום היציאה לרכב חשמלי: STATIC
מצב גישה: קריאה
סוג Enumeration: PortLocationType
סוג יחידה: N/A
גרסה: Android 13

INFO_EXTERIOR_DIMENSIONS

המימדים החיצוניים של הרכב:

  • גובה: int32Values[0]
  • אורך: int32Values[1]
  • רוחב: int32Values[2]
  • רוחב, כולל מראות: int32Values[3]
  • בסיס הגלגלים, כולל מראות: int32Values[4]
  • רוחב הטראק בחזית: int32Values[5]
  • רוחב המסלול האחורי: int32Values[6]
  • קוטר סיבוב מדרכה למדרכה: int32Values[7]

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: VehicleUnit:MILLIMETER
גרסה: Android 13

INFO_FUEL_CAPACITY

קיבולת הדלק של הרכב במיליליטר. המאפיין הזה צריך לציין את כמות הדלק המקסימלית שאפשר לאחסן ברכב, במיליליטר. המאפיין הזה לא רלוונטי לכלי רכב חשמליים (EV). כלומר, אם INFO_FUEL_TYPE מכיל רק את FuelType::FUEL_TYPE_ELECTRIC, אסור להטמיע את INFO_FUEL_CAPACITY. לכלי רכב חשמליים, מטמיעים את INFO_EV_BATTERY_CAPACITY.

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: VehicleUnit:MILLILITER
גרסה: Android 13

INFO_FUEL_DOOR_LOCATION

המיקום של פתח מכל הדלק. הנכס הזה צריך לציין את המיקום של דלת מילוי הדלק ברכב. המאפיין הזה לא רלוונטי לכלי רכב חשמליים. כלומר, אם INFO_FUEL_TYPE מכיל רק את הערך FuelType::FUEL_TYPE_ELECTRIC, אין להטמיע את המאפיין הזה. לכלי רכב חשמליים, מטמיעים את INFO_EV_PORT_LOCATION או את INFO_MULTI_LOCATIONS

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: PortLocationType
סוג יחידה: N/A
גרסה: Android 13

INFO_FUEL_TYPE

רשימת סוגי הדלק שבהם ניתן להשתמש ברכב. צריך לכלול את השדה FuelType::FUEL_TYPE_ELECTRIC רק אם הרכב יכול להתחבר לטעינה. לדוגמה, אסור לכלול FuelType::FUEL_TYPE_ELECTRIC ברכב חשמלי היברידי מלא (FHEV), כי אפשר לאכלס את הערך INT32_VEC של INFO_FUEL_TYPE INFO_FUEL_TYPE כזה.

int32Values = { FuelType::FUEL_TYPE_UNLEADED }
לעומת זאת, רכב חשמלי היברידי נטען (PHEV) הוא רכב נטען שאפשר לחבר לחשמל, וצריך לכלול את הערך FuelType::FUEL_TYPE_ELECTRIC כערך INT32_VEC עבור INFO_FUEL_TYPE INFO_FUEL_TYPE, שאפשר לאכלס כערך כזה, int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: FuelType
סוג יחידה: N/A
גרסה: Android 13

INFO_MAKE

יצרן הרכב. המאפיין הזה צריך לציין את שם המותג הציבורי של הרכב.

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: N/A
גרסה: Android 13

INFO_MODEL

דגם הרכב. המאפיין הזה צריך להכיל את שם הדגם הציבורי של הרכב.

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: N/A
גרסה: Android 13

INFO_MODEL_YEAR

שנת הדגם של הרכב בפורמט 'YYYY' לפי לוח השנה הגרגוריאני.

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: VehicleUnit:YEAR
גרסה: Android 13

INFO_MULTI_EV_PORT_LOCATIONS

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

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

אם לרכב יש רק יציאה אחת, הערך של המאפיין הזה צריך לכלול אלמנט אחד. כדי לתאר מיקום של שקע אחד, אפשר לעיין במאמר INFO-EV-PORT-LOCATION

.

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: PortLocationType
סוג יחידה: N/A
גרסה: Android 13

INFO_VIN

מספר VIN של הרכב.

שינוי מצב: STATIC
מצב גישה: READ
סוג Enum: N/A
סוג יחידה: N/A
גרסה: Android 13

INITIAL_USER_INFO

הגדרת משתמש Android שישמש במהלך האינטראקציה הראשונית. מערכת Android מפעילה את המאפיין הזה במהלך האימות, ומאפשרת ל-HAL לקבוע איזה משתמש Android צריך להפעיל. הבקשה הזו נשלחת על ידי הגדרת VehiclePropValue (המוגדרת על ידי InitialUserInfoRequest), וה-HAL חייב להשיב באמצעות אירוע שינוי נכס (המוגדרת על ידי InitialUserInfoResponse). אם ה-HAL לא מגיב לאחר פרק הזמן שהוגדר על ידי מערכת Android, מערכת Android ממשיכה כאילו ה-HAL החזיר תגובה של הפעולה InitialUserInfoResponseAction:DEFAULT. לדוגמה, בהפעלה הראשונה, הבקשה עשויה להיות:

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)
אם ה-HAL מגיב על ידי יצירת משתמש אדמין בשם 'בעלים', התגובה תהיה:
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
ערך המחרוזת מייצג כמה ערכים, שמפרידים ביניהם סימני ||. הערך הראשון הוא קוד השפה והאזור (אופציונלי) של המשתמש שייווצר (אם הוא ריק, המערכת משתמשת בערך ברירת המחדל של Android). הערך השני הוא השם (אופציונלי) של המשתמש שייווצר (כשסוג התגובה הוא InitialUserInfoResponseAction:CREATE). לדוגמה, כדי ליצור את אותו משתמש בעלים עם קודי השפה והאזור en-US ו-pt-BR, ערך המחרוזת של התגובה הוא en-US,pt-BR||Owner. לכן, לא ניתן לכלול בשמות ובשפות את התו 'קו אנכי' (||) בשני קווים, אבל אפשר להשתמש בקו אנכי אחד (|).

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

J עד R

LANE_CENTERING_ASSIST_COMMAND

פקודות של התכונה 'סיוע במרכוז בנתיב' (LCA). פקודות להפעלה ולהשעיה של LCA. כששולחים את הפקודה ACTIVATE מ-LaneCenteringAssistCommand, צריך להגדיר את LANE_CENTERING_ASSIST_STATE לערך LaneCenteringAssistState#ACTIVATION_REQUESTED. כשהפקודה ACTIVATE מסתיימת בהצלחה, צריך להגדיר את LANE_CENTERING_ASSIST_STATE לערך LaneCenteringAssistState#ACTIVATED. כשהפקודה DEACTIVATE מ-LaneCenteringAssistCommand מסתיימת בהצלחה, צריך להגדיר את LANE_CENTERING_ASSIST_STATE לערך LaneCenteringAssistState#ENABLED.

למזהה האזור הגלובלי (0), צריך להגדיר את VehicleAreaConfig#supportedEnumValues אלא אם יש תמיכה בכל הערכים של המאפיין enum של LaneCenteringAssistCommand. כשהנכס הזה לא זמין כי LCA מושבת (לדוגמה, LANE_CENTERING_ASSIST_ENABLED הוא false), הנכס הזה חייב להחזיר את הערך StatusCode#NOT_AVAILABLE_DISABLED. אם LANE_CENTERING_ASSIST_STATE מיושם והמצב מוגדר לערך ErrorState, הנכס הזה חייב להחזיר את הערך StatusCode שתואם לערך ErrorState. לדוגמה, אם LANE_CENTERING_ASSIST_STATE מוגדר ל-ErrorState#NOT_AVAILABLE_SPEED_LOW, המאפיין הזה חייב להחזיר את הערך StatusCode#NOT_AVAILABLE_SPEED_LOW.

שינוי מצב: ON_CHANGE
מצב גישה: WRITE
סוג Enum: LaneCenteringAssistCommand
סוג יחידה: לא רלוונטי
גרסה: Android 14

LANE_CENTERING_ASSIST_ENABLED

מפעילים או משביתים את התכונה 'סיוע במרכז נתיב' (LCA). מגדירים את הערך כ-true כדי להפעיל את LCA וכ-false כדי להשבית אותו. כש-LCA מופעל, מערכת ADAS ברכב אמורה להיות מופעלת ולהמתין לאות הפעלה מהנהג. אחרי שהתכונה מופעלת, מערכת ADAS אמורה להסיט את הרכב כדי לשמור על מרכזתו בנתיב הנוכחי.

ההבדל בינו לבין התכונה 'סיוע לשמירה על נתיב' (LKA) הוא שהיא עוקבת אחרי הנהג כדי לראות אם הוא יוצא בטעות מהנתיב או חוצה אותו. אם מזוהה סטייה לא מכוונת מהנתיב, המערכת מפעילה בקרת היגוי כדי להחזיר את הרכב לנתיב הנוכחי. באופן כללי, LANE_CENTERING_ASSIST_ENABLED תמיד צריך להחזיר את הערך true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי או גבוהה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין LANE_CENTERING_ASSIST_STATE.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

LANE_CENTERING_ASSIST_STATE

המצב של התכונה 'סיוע במרכוז בנתיב' (LCA). הפונקציה מחזירה את המצב הנוכחי של LCA. המאפיין הזה תמיד חייב להחזיר מצב תקין שמוגדר ב-LaneCenteringAssistState או ב-ErrorState. אסור להציג שגיאות דרך StatusCode, ובמקום זאת צריך להשתמש במצבי השגיאה הנתמכים.

אם LCA כולל אזהרות על סטייה מנתיב, צריך להציג את האזהרות האלה באמצעות המאפיינים של אזהרה על סטייה מנתיב (LDW).

למזהה האזור הגלובלי (0), צריך להגדיר את המערך VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של LaneCenteringAssistState (כולל OTHER, שלא מומלץ) וגם של ErrorState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: LaneCenteringAssistState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

LANE_DEPARTURE_WARNING_ENABLED

מפעילים או משביתים את ההגדרה 'אזהרה על סטייה מנתיב' (LDW). מגדירים את הערך כ-true כדי להפעיל את LDW וכ-false כדי להשבית אותו. כשהמערכת LDW מופעלת, מערכת ADAS ברכב צריכה להיות מופעלת ולעקוב אחרי הרכב כדי לזהות אם הוא מתקרב לקווי נתיב או חוצה אותם, ובמקרה כזה תופיע אזהרה.

באופן כללי, LANE_DEPARTURE_WARNING_ENABLED תמיד צריך להחזיר את הערך true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי או גבוהה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין LANE_DEPARTURE_WARNING_STATE.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

LANE_DEPARTURE_WARNING_STATE

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

למזהה האזור הגלובלי (0), צריך להגדיר את המערך VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של LaneDepartureWarningState (כולל OTHER, שלא מומלץ) וגם של ErrorState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: LaneDepartureWarningState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

LANE_KEEP_ASSIST_ENABLED

מפעילים או משביתים את התכונה 'סיוע לשמירה על נתיב' (LKA). מגדירים את הערך כ-true כדי להפעיל את LKA וכ-false כדי להשבית את LKA. כשה-LKA מופעל, מערכת ה-ADAS ברכב צריכה להיות מופעלת ולעקוב אחרי הסטייה של הנהג ללא כוונה לכיוון סימון הנתיבים או מעבר אליו. אם מזוהה סטייה לא מכוונת מהנתיב, המערכת מפעילה בקרת היגוי כדי להחזיר את הרכב לנתיב הנוכחי. ההבדל הוא ש-LCA מפעילה בקרה רציפה על ההיגוי כדי לשמור על מרכז הרכב בנתיב הנוכחי, בעוד ש-LDW מפעילה בקרה רציפה על ההיגוי כדי לשמור על מרכז הרכב בנתיב הנוכחי.

באופן כללי, LANE_KEEP_ASSIST_ENABLED תמיד צריך להחזיר את הערך true או false. אם התכונה לא זמינה בגלל מצב זמני כלשהו, למשל אם מהירות הרכב נמוכה מדי או גבוהה מדי, צריך להעביר את המידע הזה באמצעות הערכים של ErrorState במאפיין LANE_KEEP_ASSIST_STATE.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

LANE_KEEP_ASSIST_STATE

המצב של התכונה 'סיוע לשמירת נתיב' (LKA). הפונקציה מחזירה את המצב הנוכחי של LKA. המאפיין הזה תמיד צריך להחזיר מצב תקין שמוגדר ב-LaneKeepAssistState או ב-ErrorState. אסור להציג שגיאות דרך StatusCode, ובמקום זאת צריך להשתמש במצבי השגיאה הנתמכים.

אם מערכת LKA כוללת אזהרות על סטייה מהנתיב לפני החלת תיקוני היגוי, האזהרות האלה חייבות להופיע באמצעות המאפיינים של אזהרה על סטייה מהנתיב (LDW).

למזהה האזור הגלובלי (0), צריך להגדיר את המערך VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל המצבים של LaneKeepAssistState (כולל OTHER, שלא מומלץ) וגם של ErrorState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: LaneKeepAssistState/ErrorState
סוג יחידה: לא רלוונטי
גרסה: Android 14

LOCATION_CHARACTERIZATION

אפיון של מקורות הקלט שמשמשים לחישוב המיקום. הנכס הזה צריך לציין אילו נתונים ומידע מהחיישנים (אם יש כאלה) המערכת מביאה בחשבון כשהיא מחשבת את המיקום של הרכב, שמשותף עם Android דרך GNSS HAL.

הערך חייב להחזיר אוסף של דגלים של ביט. דגלים של ביט מוגדרים ב-LocationCharacterization. הערך חייב לכלול גם בדיוק אחד מ-DEAD_RECKONED או מ-RAW_GNSS_ONLY באוסף של דגלים ביטים.

כשהנכס הזה לא נתמך, ההנחה היא שאין שילוב של עוד קלט חיישנים בעדכוני ה-GNSS שסופקו דרך GNSS HAL. אלא אם צוין אחרת באמצעות ממשקי ה-HAL של GNSS.

מצב שינוי: STATIC
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

MIRROR_AUTO_FOLD_ENABLED

מייצג את המאפיין של התכונה 'קיפול אוטומטי של מראה'. המאפיין הזה נכון כשהתכונה של קיפול אוטומטי של מראות הצד ברכב מופעלת (לדוגמה, כשהמראות מתקפלים פנימה באופן אוטומטי כשיוצאים מהרכב ונועלים אותו).

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

MIRROR_AUTO_TILT_ENABLED

מאפיין שמייצג את התכונה 'הטיה אוטומטית של המראה'. המאפיין הזה נכון כשהתכונה להטיה האוטומטית של מראות הצד ברכב מופעלת (לדוגמה, כשהמראות נוטות למטה באופן אוטומטי כשהרכב חוזר לאחור).

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

MIRROR_FOLD

קיפול מראה. הערך True מציין שהמראות מקופלות. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

MIRROR_LOCK

נעילה של המראה. הערך True מציין שמיקומי המראה נעולים ולא ניתן לשנות אותם. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

MIRROR_Y_MOVE

Mirror Y move. צריך להגדיר את maxInt32Value ו-minInt32Value בכל VehicleAreaConfig. צריכה להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value.

הערך maxInt32Value מייצג את מהירות התנועה המקסימלית של המראה בזמן הטיה ימינה. הערך minInt32Value מייצג את מהירות התנועה המקסימלית של המראה בזמן הטיה שמאלה.

ערכים אבסולוטיים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. כשהמראה מגיע למגבלת המיקום, צריך לאפס את הערך ל-0. אם הערך של MIRROR_Y_MOVE הוא 0, המשמעות היא שאין תנועה כרגע.

הנכס הזה לא מוגדר ביחידות מסוימות, אלא בטווח מסוים של מהירויות תנועה יחסיות.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

MIRROR_Y_POS

מיקום Y במראה. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריכה להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. הסמל minInt32Value מציין שהמראה מוטה לגמרי שמאלה.

הערך הזה חייב להיות שלילי. הערך maxInt32Value מציין שהמראה מוטה לגמרי שמאלה. הערך הזה חייב להיות לא שלילי. הערך 0 מציין שהמראה לא מוטה לאף כיוון.

ערכים בין minInt32Value ל-maxInt32Value מציינים מצב מעבר בין המיקום הקיצוני הימני למיקום הקיצוני הימני.

הנכס הזה לא נמצא ביחידה מסוימת, אלא בטווח מסוים של מיקומים יחסיים.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

MIRROR_Z_MOVE

תנועת Z בשיקוף. צריך להגדיר את maxInt32Value ו-minInt32Value בכל VehicleAreaConfig. צריכה להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value.

הערך maxInt32Value מייצג את מהירות התנועה המקסימלית של המראה בזמן ההטיה כלפי מעלה. הערך minInt32Value מייצג את מהירות התנועה המקסימלית של המראה בזמן ההטיה כלפי מטה. ערכים אבסולוטיים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. כשהמראה מגיע למגבלת המיקום, צריך לאפס את הערך ל-0. אם הערך של MIRROR_Z_MOVE הוא 0, המשמעות היא שאין תנועה כרגע.

הנכס הזה לא מוגדר ביחידות מסוימות, אלא בטווח מסוים של מהירויות תנועה יחסיות.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

MIRROR_Z_POS

מיקום Z במראה. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריך להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. הערך minInt32Value מציין שהמראה מוטה לגמרי למטה. הערך הזה חייב להיות שלילי. הערך maxInt32Value מציין שהמראה מוטה לגמרי כלפי מעלה. הערך חייב להיות ערך לא שלילי. הערך 0 מציין שהמראה לא מוטה בשום כיוון.

ערכים בין minInt32Value ל-maxInt32Value מצביעים על מצב מעבר בין המיקום התחתון ביותר למיקום העליון ביותר.

הנכס הזה לא נמצא ביחידה מסוימת, אלא בטווח מסוים של מיקומים יחסיים.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

NIGHT_MODE

הערך True מציין שהחיישן של מצב הלילה זיהה שסביבת תא הנוסעים ברכב מוארת באור נמוך. הפלטפורמה יכולה להשתמש בנתונים האלה, למשל, כדי להפעיל ממשק משתמש מתאים לצפייה טובה יותר בסביבות חשוכות או בתאורה חלשה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

OBD2_FREEZE_FRAME

דיווח על תמונת מצב של הערך של חיישני OBD2 שזמינים בזמן שהתרחשה תקלה וזוהתה. צריך לספק configArray עם אותה משמעות שמוגדרת ל-OBD2_LIVE_FRAME

הערכים של המאפיין הזה צריכים להתפרש באופן דומה לערכים של OBD2_LIVE_FRAME, מלבד העובדה ששדה stringValue עשוי להכיל קוד פתרון בעיות אבחון (DTC) לא ריק.

בבקשה מסוג IVehicle#get של המאפיין הזה צריך לציין ערך עבור int64Values[0]. המערכת מפרשת את הערך הזה בתור חותמת הזמן של מסגרת ההקפאה שרוצים לאחזר. אפשר לקבל רשימה של חותמות זמן באמצעות קריאה של IVehicle#get ל-OBD2_FREEZE_FRAME_INFO

אם לא יהיה פריים קפוא זמין בחותמת הזמן שצוינה, ההטמעה צריכה להחזיר תשובה של NOT_AVAILABLE. יכול להיות שבכלי הרכב יש נפח אחסון מוגבל לפריימים מושהים, ולכן יכול להיות שבקשת פריים תקבל תשובה עם הערך NOT_AVAILABLE גם אם חותמת הזמן המשויכת התקבלה לאחרונה דרך OBD2_FREEZE_FRAME_INFO.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

OBD2_FREEZE_FRAME_CLEAR

הקפאת הפריים נמחקה. דיווח על תמונת מצב של הערך של חיישני OBD2 שזמינים בזמן שהתרחשה וזוהתה תקלה. צריך לספק configArray עם אותה משמעות שהוגדרה ל-OBD2_LIVE_FRAME

יש לפרש את הערכים של המאפיין הזה באופן דומה לאלה של OBD2_LIVE_FRAME, למעט ששדה stringValue עשוי להכיל קוד אבחון לא ריק לפתרון בעיות (DTC).

בבקשה מסוג IVehicle#get של המאפיין הזה צריך לציין ערך עבור int64Values[0]. היא תתפרש כחותמת הזמן של מסגרת ההקפאה שרוצים לאחזר. אפשר לקבל רשימה של חותמות זמן באמצעות IVehicle#get של OBD2_FREEZE_FRAME_INFO

אם לא יהיה פריים קפוא זמין בחותמת הזמן שצוינה, ההטמעה צריכה להחזיר NOT_AVAILABLE בתגובה. יכול להיות שהרכבים יהיו עם נפח אחסון מוגבל לפריימים מושהים, ולכן ייתכן שבקשת פריים תקבל תשובה עם NOT_AVAILABLE גם אם חותמת הזמן המשויכת התקבלה לאחרונה דרך OBD2_FREEZE_FRAME_INFO.

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

OBD2_FREEZE_FRAME_INFO

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

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

OBD2_LIVE_FRAME

הדוח כולל תמונת מצב של הערכים הנוכחיים (הפעילים) של חיישני OBD2 הזמינים. ה-configArray מוגדר באופן הבא:

  • configArray[0] מספר חיישנים עם ערך שלם ספציפי לספק
  • configArray[1] מספר חיישני ערך צף ספציפיים לספק

צריך לפרש את הערכים של המאפיין הזה כמו בדוגמה הבאה. הערך של configArray = {2,3} int32Values חייב להיות וקטור שמכיל את Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX ועוד שני אלמנטים (או 33 אלמנטים). floatValues חייב להיות וקטור שמכיל את Obd2FloatSensorIndex.LAST_SYSTEM_INDEX ועוד שלושה רכיבים (או 73 רכיבים).

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

לדוגמה, אם הערך של bytes[0] = 0x4C (0b01001100) הוא 1, המשמעות היא:

  • int32Values[0 and 1] הם לא ערכים חוקיים של חיישנים
  • int32Values[2 and 3] הם ערכים חוקיים של חיישנים
  • int32Values[4 and 5] הם לא ערכים חוקיים של חיישנים
  • int32Values[6] הוא ערך חיישן חוקי
  • הערך int32Values[7] אינו ערך חיישן חוקי
  • int32Values[0 and 1] הם לא ערכים חוקיים של חיישנים
  • int32Values[2 and 3] הם ערכים חוקיים של חיישנים
  • int32Values[4 and 5] הם לא ערכים חוקיים של חיישנים
  • int32Values[6] הוא ערך חיישן חוקי
  • הערך int32Values[7] אינו ערך חיישן חוקי

אם bytes[5] = 0x61 (0b01100001), אז:

  • int32Values[32] הוא ערך חיישן חוקי
  • floatValues[0 thru 3] הם ערכי חיישנים לא חוקיים
  • floatValues[4 and 5] הם ערכים חוקיים של חיישנים
  • הערך floatValues[6] אינו ערך תקין של חיישן.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

ON_CHANGE

שינוי מצב:
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה:N/A
גרסה: Android 13

PARKING_BRAKE_AUTO_APPLY

הפעלה אוטומטית של בלם החניה. כשהערך של המאפיין הזה הוא True, המשמעות היא שבלם החניה האוטומטי של הרכב מופעל. הערך False מציין שתכונת הבלמים האוטומטיים לחנייה של הרכב מושבתת. לרוב, המאפיין הזה מתבלבל עם PARKING_BRAKE_ON. ההבדל הוא ש-PARKING_BRAKE_ON מציין אם בלם החניה בפועל מופעל או מושבת, ואילו PARKING_BRAKE_AUTO_APPLY מציין אם התכונה של בלם החניה האוטומטי מופעלת או מושבתת, ולא מתאר את המצב הנוכחי של בלם החניה בפועל.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

PARKING_BRAKE_ON

מצב בלם היד. כשהערך של המאפיין הזה הוא true, המשמעות היא שבלם החניה של הרכב מופעל. ערך False מציין שבלם החניה של הרכב לא מופעל.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

PER_DISPLAY_BRIGHTNESS

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

צריך להטמיע רק אחד מבין PER_DISPLAY_BRIGHTNESS ו-PER_DISPLAY_BRIGHTNESS. אם שני הערכים זמינים, PER_DISPLAY_BRIGHTNESS משמש את AAOS.

Display port הוא מזהה ייחודי של מחבר פיזי במכשיר ליציאת מסך, בטווח שבין 0 ל-255.

  • int32Values[0] DisplayPort
  • int32Values[1] בהירות

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

PERF_ODOMETER

הערך הנוכחי של מד המרחק ברכב.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:KILOMETER
גרסה: Android 13

PERF_REAR_STEERING_ANGLE

זווית ההיגוי של דגם האופניים האחורי ברכב. הזווית נמדדת במעלות. כיוון שמאל הוא שלילי. הנכס הזה לא תלוי בזווית של ההגה. המאפיין הזה צריך להעביר את הזווית של הגלגלים האחוריים ביחס לרכב, ולא את הזווית של ההגה.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:DEGREES
גרסה: Android 13

PERF_STEERING_ANGLE

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

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:DEGREES
גרסה: Android 13

PERF_VEHICLE_SPEED

מהירות הרכב. הערך חייב להיות חיובי כשהרכב נוסע קדימה ושלילי כשהרכב נוסע לאחור. הערך הזה לא תלוי בערך ההילוך (CURRENT_GEAR או GEAR_SELECTION). לדוגמה, אם GEAR_SELECTION הוא GEAR_NEUTRAL, הערך של PERF_VEHICLE_SPEED הוא חיובי כשהרכב נוסע קדימה, שלילי כשהרכב נוסע לאחור ואפס כשהרכב לא זז.

שינוי מצב: CONTINUOUS
מצב גישה: READ
סוג יחידה: לא רלוונטי
סוג יחידה: VehicleUnit:METER_PER_SEC
גרסה: Android 13

PERF_VEHICLE_SPEED_DISPLAY

מהירות הרכב בתצוגות. בחלק מהמכוניות מוצגת מהירות איטית יותר במד המהירות מאשר המהירות בפועל.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:METER_PER_SEC
גרסה: Android 13

POWER_POLICY_GROUP_REQ

הגדרת בקשה להגדרת קבוצת מדיניות צריכת החשמל שתשמש לקביעת מדיניות צריכת החשמל שמוגדרת כברירת מחדל לכל מעבר במצב צריכת החשמל.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

POWER_POLICY_REQ

הגדרת בקשה להחיל מדיניות צריכת חשמל. VHAL מגדיר את המאפיין הזה כדי לשנות את מדיניות הזנת המתח של הרכב. שירות מדיניות הזנת המתח ברכב נרשם לנכס הזה ומשנה בפועל את מדיניות הזנת המתח. הבקשה נשלחת על ידי הגדרת VehiclePropValue עם המזהה של מדיניות צריכת החשמל שמוגדרת ב-/vendor/etc/automotive/power_policy.xml. אם המזהה לא מוגדר, שירות מדיניות צריכת החשמל ברכב מתעלם מהבקשה וממשיך להשתמש במדיניות הקיימת.

string: "sample_policy_id" // power policy ID

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

POWER_POLICY_GROUP_REQ

הגדרת בקשה להגדרת קבוצת מדיניות צריכת החשמל שמשמשת לקביעת מדיניות צריכת החשמל שמוגדרת כברירת מחדל לכל מעבר בין מצבי צריכת החשמל. VHAL מגדיר את המאפיין הזה עם המזהה של קבוצת מדיניות צריכת חשמל כדי להגדיר את מדיניות צריכת החשמל שמוגדרת כברירת מחדל במעבר בין מצבי צריכת החשמל. קבוצות של מדיניות צריכת חשמל מוגדרות בקובץ ‎/vendor/etc/power_policy.xml. אם המזהה לא מוגדר, השירות של מדיניות צריכת החשמל ברכב מתעלם מהבקשה. השירות של מדיניות הזנת המתח ברכב נרשם לנכס הזה ומגדיר את הקבוצה של מדיניות הזנת המתח. היישום בפועל של מדיניות צריכת החשמל מתבצע כשסטטוס צריכת החשמל של המערכת משתנה, ויש מדיניות צריכת חשמל ממופה תקפה לסטטוס החדש.

string: "sample_policy_group_id" // power policy group ID

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

RANGE_REMAINING

הטווח שנותר. המרחק שנותר לדלק ולטעינה. טווח הנסיעה שנותר יכלול את כל מקורות האנרגיה ברכב. לדוגמה, הטווח של רכב היברידי הוא הסכום של הטווחים שמבוססים על דלק ועל סוללה. המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE כי אפליקציית ניווט יכולה לעדכן את הטווח אם יש לה הערכה מדויקת יותר על סמך המסלול הקרוב. אפשר להטמיע את הנכס הזה בתור VehiclePropertyAccess.READ רק לפי שיקול דעתו של יצרן הציוד המקורי.

מצב שינוי: CONTINUOUS
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: VehicleUnit:METER
גרסה: Android 13

READING_LIGHTS_STATE

הפונקציה מחזירה את הסטטוס הנוכחי של תאורת הקריאה.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: Android 13

READING_LIGHTS_SWITCH

מעבר לתאורת הקריאה. הערך הזה עשוי להיות שונה מ-READING_LIGHTS_STATE אם התאורה מופעלת כי הדלת פתוחה או בגלל פקודה קולית. לדוגמה, כשהמתג במצב כבוי או אוטומטי. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

REAR_FOG_LIGHTS_STATE

הפונקציה מחזירה את המצב הנוכחי של פנסי הערפל האחוריים. אפשר להטמיע רק אחד מבין FOG_LIGHTS_STATE או REAR_FOG_LIGHTS_STATE. ראו FOG_LIGHTS_STATE

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleLightState
סוג יחידה: N/A
גרסה: Android 13

REAR_FOG_LIGHTS_SWITCH

ההגדרה שהמשתמש רוצה. צריך להטמיע רק אחת מהעמודות FOG_LIGHTS_SWITCH או REAR_FOG_LIGHTS_SWITCH. מידע נוסף זמין בכתובת FOG_LIGHTS_SWITCH. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור VehiclePropertyAccess.READ.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה: N/A
גרסה: Android 13

REMOVE_USER

המערכת של Android קוראת לזה אחרי שמשתמש ב-Android הוסר. ה-HAL יכול להשתמש במאפיין הזה כדי להסיר את המשתמש המקביל. זוהי קריאה לכתיבה בלבד. מערכת Android לא מצפה לתשובה מ-HAL. לכן, הבקשה הזו לא אמורה להיכשל. אם לא ניתן להסיר את המשתמש המקביל ב-HAL, צריך לסמן אותו כלא פעיל או לשחזר אותו בדרך אחרת.

הבקשה נשלחת על ידי הגדרת VehiclePropValue עם התוכן שמוגדר על ידי RemoveUserRequest. לדוגמה, אם במערכת היו 3 משתמשים (0,‏ 10 ו-11) והמשתמש 11 הוסר, הבקשה תהיה:

  • int32[0] 42 // מזהה הבקשה
  • int32[1] 11 // (מזהה המשתמש ב-Android של המשתמש שהוסרה)
  • int32[2] 0 // (דגלי משתמש ב-Android של המשתמש שהוסרה)
  • int32[3] 10 // current user
  • int32[4] 0 // current user flags (none)
  • int32[5] 2 // מספר המשתמשים
  • int32[6] 0 // first user (user 0)
  • int32[7] 0 // first user flags (none)
  • int32[8] 10 // משתמש שני (משתמש 10)
  • int32[9] 0 // second user flags (none)

מצב שינוי: STATIC
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

א' עד ת'

SEAT_AIRBAG_ENABLED

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

אפשר להגדיר את הנכס הזה ל-VehiclePropertyAccess.READ לקריאה בלבד למטרות שקשורות לרגולציה או לבטיחות.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי סוג יחידה: לא רלוונטי
גרסה: Android 13

SEAT_BACKREST_ANGLE_2_POS

זווית 2 של משענת גב המושב. זווית משענת 2 של משענת הגב היא האקטטור הבא מתחתית הרצפה מושב.

maxInt32Value וminInt32Value בVehicleAreaConfig חייב להיות מוגדר. כל המספרים השלמים בין minInt32Value ל-maxInt32Value חייבים להיות ‎#0supported.

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

ערכים בין minInt32Value ל-maxInt32Value מציינים מצב מעבר בין המצב שבו המושב מוטה לאחור לגמרי לבין המצבים 'ישיבה זקופה' ו'ישיבה קדימה'.

המאפיין הזה מיוצג כטווח מוגדר של מיקומים יחסיים.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SEAT_BELT_BUCKLED

חגורת הבטיחות חגורת בטיחות. הערך True מציין שהחגורה חובקת. גישת כתיבה מצביעה על אבחנה אוטומטית של המושבים. יכולות. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

SEAT_DEPTH_MOVE

שינוי עומק המושב.

הערכים maxInt32Value ו-minInt32Value בכל VehicleAreaConfig חייבים להיות מוגדר. צריך להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value.

הערך maxInt32Value מייצג את מהירות התנועה המקסימלית של המושב בזמן שהוא מתקבע. הערך minInt32Value מייצג את מהירות התנועה המקסימלית של המושב בזמן שהוא מתקבע.

ערכים מוחלטים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. כשמשענת הגב של המושב מגיעה למגבלת המיקום, צריך לאפס את הערך ל-0. אם הערך של הערך של SEAT_DEPTH_MOVE כרגע הוא 0, אין תנועה בתנועה.

המאפיין הזה מיוצג כטווח מסוים של מהירויות תנועה יחסיות.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

SEAT_EASY_ACCESS_ENABLED

מייצג את הנכס לתכונה 'גישה נוחה למושבים'. אם הערך הוא true, המושב יותאם באופן אוטומטי כדי להקל על הנוסע להיכנס לרכב ולצאת ממנו. כל מזהה אזור צריך להיות ממופה אל מושב שהמשתמש מנסה להיכנס או לצאת בעזרת תכונת הגישה הקלה. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור <covehiclepropertyaccess.read< code="">.</covehiclepropertyaccess.read<>

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enumeration: VehicleLightState
סוג יחידה: N/A
גרסה: 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.

לכל מזהה אזור נתמך, צריך להגדיר את VehicleAreaConfig#supportedEnumValues, אלא אם יש תמיכה בכל ערכי המאפיין VehicleLightSwitch.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enumeration: VehicleLightSwitch
סוג יחידה: N/A
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

SEAT_FORE_AFT_POS

המיקום של המושב בחלק הקדמי או האחורי של המטוס. מגדיר את מיקום המושב קדימה ואחורה.

יש להגדיר את maxInt32Value ואת minInt32Value ב-VehicleAreaConfig. יש תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value.

האות minInt32Value מציין שהמושב נמצא במיקום הליניארי האחורי ביותר. הערך maxInt32Value מציין שהמושב נמצא במיקום הליניארי הקדמי ביותר. ערכים בין minInt32Value ל-maxInt32Value מציין מצב מעבר בין המיקום הקרוב ביותר למיקום הרחוק ביותר.

המאפיין הזה מיוצג כטווח מוגדר של מיקומים יחסיים.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SEAT_HEADREST_HEIGHT_POS

(הוצא משימוש) מיקום גובה משענת הראש.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

SEAT_HEIGHT_POS

מיקום גובה המושב. maxInt32Value וminInt32Value ב- יש להגדיר את הערך VehicleAreaConfig. כל המספרים השלמים בין minInt32Value לבין חייבת להיות תמיכה ב-maxInt32Value.

הסמל minInt32Value מציין שהמושב נמצא במיקום הנמוך ביותר. maxInt32Value מציין שהמושב נמצא במיקום הגבוה ביותר.

ערכים בין minInt32Value לבין maxInt32Value מציינים מצב מעבר בין המיקום הנמוך ביותר למיקום הגבוה ביותר.

המאפיין הזה מיוצג כטווח שצוין של מיקומים יחסיים.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_POS

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

ערכים בין minInt32Value ל-maxInt32Value מציינים מצב מעבר בין המיקום הצר ביותר למיקום הרחב ביותר.

המאפיין הזה מיוצג כטווח שצוין של מיקומים יחסיים.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
סוג גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

SEAT_LUMBAR_VERT נתונים_MOVE

מאפיין שמייצג את כיוון התנועה האנכית ואת המהירות של התמיכה לגב התחתון בכיסא.

הערכים maxInt32Value ו-minInt32Value בכל VehicleAreaConfig חייבים להיות מוגדר. כל המספרים השלמים בין minInt32Value ל-maxInt32Value חייבים להיות נתמך. הערך maxInt32Value מציין שהתמיכה בגב התחתון נעה במהירות הגבוהה ביותר במהירות גבוהה. האות minInt32Value מציין שהתמיכה לגב התחתון נעה במהירות הכי מהירה למטה.

ערכים מוחלטים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. כשהתמיכה הצדדית של כרית המושב מגיעה למגבלת המיקום, צריך לאפס את הערך ל-0. אם הערך של SEAT_LUMBAR_VERTICAL_MOVE הוא 0, אין תנועה.

המאפיין הזה מיוצג כטווח מסוים של מהירויות תנועה יחסיות.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

SEAT_MEMORY_SELECT

הפרמטר הזה בוחר את ההגדרה הקבועה מראש בזיכרון שתשמש לבחירת מיקום המושב. צריך להגדיר את הערכים maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. צריכה להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. הערך של minInt32Value הוא תמיד 0, והערך של maxInt32Value קובע את מספר חריצי הזיכרון הזמינים להגדרות מוגדרות מראש של מושב (לדוגמה, numSeatPresets - 1). לדוגמה, אם למושב הנהג יש שלוש הגדרות זיכרון מוגדרות מראש, הערך של maxInt32Value הוא שתיים. כשהמשתמש בוחר הגדרה קבועה מראש, מוגדר מספר ההגדרה הקבועה מראש הרצויה (0, 1 או 2).

שינוי מצב: ON_CHANGE
מצב גישה: WRITE
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SEAT_MEMORY_SET

ההגדרה הזו מאפשרת למשתמש לשמור את הגדרות מיקום המושב הנוכחיות בהגדרה הקבועה מראש שנבחרה משבצת זמן אחת. maxInt32Value וminInt32Value ב- צריך להגדיר VehicleAreaConfig. הערך של minInt32Value חייב להיות 0, והערך של maxInt32Value לכל מיקום מושב חייב להתאים לערך של maxInt32Value עבור SEAT_MEMORY_SELECT.

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

SEAT_OCCUPANCY

מציין אם תפוס מושב מסוים, למיטב יכולתו של הרכב לקבוע. נתונים תקפים הערכים הם מתוך 'טיפוסים בני מנייה (enum)' VehicleSeatOccupancyState.

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג הטיפוסים בני מנייה (enum) : VehicleSeatOccupancyState
סוג היחידה: לא רלוונטי
גרסה: Android 13

SEAT_TILT_MOVE

הזזה של הטיית המושב צריך להגדיר את maxInt32Value ו-minInt32Value בכל ‎VehicleAreaConfig. צריך להיות תמיכה בכל המספרים השלמים בין minInt32Value ל-maxInt32Value. maxInt32Value מייצג את מהירות התנועה המקסימלית של הקצה הקדמי של המושב בזמן הזזה למעלה. minInt32Value מייצג את מהירות התנועה המקסימלית של הקצה הקדמי של המושב תוך כדי תנועה למטה.

ערכים אבסולוטיים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. פעם אחת המושב התחתון מגיע למגבלת המיקום. הערך צריך להתאפס ל-0. אם הערך של SEAT_TILT_MOVE הוא 0, אין תנועה.

המאפיין הזה מיוצג כטווח מסוים של מהירויות תנועה יחסיות.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SEAT_TILT_POS

מיקום ההטיה של המושב. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. כל המספרים השלמים בין minInt32Value לבין חייבת להיות תמיכה ב-maxInt32Value. הערך minInt32Value מציין שהחלק התחתון של המושב מוטה למצב הזוויתי הנמוך ביותר. זה תואם לנתוני המושב הקצה הקדמי במיקום הנמוך ביותר האפשרי ביחס לקצה האחורי של המושב. הערך maxInt32Value מציין שהחלק התחתון של המושב נמצא בזווית הזוויתית ביותר שלו. זה תואם לקצה הקדמי של המושב במיקום הגבוה ביותר האפשרי ביחס לחלק האחורי סוף המושב.

ערכים בין minInt32Value לבין maxInt32Value מציינים מצב מעבר בין המיקום הנמוך ביותר למיקום הגבוה ביותר.

המאפיין הזה מיוצג כטווח שצוין של מיקומים יחסיים.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

SEAT_WALK_IN_POS

מאפיין שמייצג את המיקום הנוכחי של הכיסא ללא הזמנה מראש. הסמל minInt32Value מציין את מיקום המושב הרגיל. הערך של minInt32Value חייב להיות 0. הסמל maxInt32Value מציין שהמושב נמצא במצב פתוח לחלוטין.

ערכים בין minInt32Value ל-maxInt32Value מציינים מצב מעבר בין המצבים 'רגיל' ו'כניסה ללא תיאום מראש'.

המאפיין הזה מיוצג כטווח שצוין של מיקומים יחסיים.

מזהה האזור חייב להתאים למיקום המושב שנע בפועל כשהתכונה 'כניסה ללא עצירה' מופעלת, ולא למיקום המושב שבו הנוסעים אמורים לשבת.

המאפיין הזה מוגדר כ-vehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים

מטמיעים אותה כ-VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

בקשה

מבקשים להסתיר את היחידה הראשית.

צריך לעשות זאת כדי לבצע משימה כשהיחידה הראשית כבויה. אחרי שהיחידה הראשית (HU) מופעלת כדי לבצע את המשימה, היחידה הראשית (HU) צריכה להיות כבויה. היחידה הראשית שולחת את ההודעה הזו בסיום המשימה.

המאפיין הזה לא רלוונטי כשמשתמש רוצה לכבות את היחידה הראשית.

בדרך כלל, הפעולה הזו כוללת הודעה למערכת נפרדת מחוץ ליחידה הראשית (למשל, בקר מתח) להתכונן להשבתת היחידה הראשית.

המערכת החיצונית צריכה לוודא שהבקשה הזו תקפה על ידי בדיקה אם הרכב נמצא לשימוש. אם משתמש נכנס לרכב לאחר שליחת SHUTDOWN_REQUEST, המערכת חייבת להתעלם הבקשה הזו. מומלץ לאחסן מאפיין VehicleInUse בבקר חשמל חושפת אותו באמצעות נכס VEHICLE_IN_USE. אם הערך של VehicleInUse הוא True, המערכת חייבת להתעלם מבקשת כיבוי.

אם המערכת החיצונית תקבל הרשאה, היא תשלח אות כיבוי ליחידה הראשית, וכתוצאה מכך VHAL ישלח את ההודעה SHUTDOWN_PREPARE ל-Android. לאחר מכן, מערכת Android תתחיל את תהליך הכיבוי על ידי מטפלים בהודעה.

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

הנכס הזה מוגדר לכתיבה בלבד, לכן אסור להירשם או אירוע של שינוי נכס שנוצר.

הערך להגדרה מציין את אפשרות ההשבתה. הוא חייב להיות אחד מ-{@code VehicleApPowerStateShutdownParam}. לדוגמה, VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY. יכול להיות שאפשרות הכיבוי הזו לא אם המערכת אינה תומכת באפשרות כזו. במקרה כזה, לא תוחזר שגיאה.

למידע על הגדרות אישיות, חייב להיות ב-VehiclePropConfig.configArray סימון ביט שמשלבים ערכים ב-{@code VehicleApPowerStateConfigFlag} כדי לציין איזה כיבוי לפי ההצעות.

הפונקציה מחזירה שגיאה אם לא הצליחה לשלוח את בקשת ההשבתה למערכת השנייה.

שינוי מצב: ON_CHANGE
מצב גישה: WRITE
סוג Enum: VehicleApPowerStateShutdownParam>
סוג יחידה: N/A
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

STEERING_WHEEL_EASY_ACCESS_ENABLED

התכונה 'גישה קלה ללחצנים על ההגה' מופעלת. אם הערך הוא True, ההגה של הנהג יותאם באופן אוטומטי כדי שיהיה קל יותר לנהג להיכנס לרכב ולצאת ממנו.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

STEERING_WHEEL_HEIGHT_MOVE

תנועה של הגובה של ההגה. צריך להגדיר את maxInt32Value ו-minInt32Value ב-VehicleAreaConfig. כל הערכים בין minInt32Value לבין חייבת להיות תמיכה ב-maxInt32Value.

maxInt32Value מציין שההגה זז למעלה. התווית minInt32Value מציינת שההגה זז למטה.

מספרים שלמים גדולים יותר, חיוביים או שליליים, מציינים מהירות תנועה גבוהה יותר. כשהגה מגיע למגבלת המיקום, צריך לאפס את הערך ל-0. אם הערך של STEERING_WHEEL_HEIGHT_MOVE הוא 0, המשמעות היא שאין תנועה כרגע.

המאפיין הזה מיוצג כטווח מסוים של מהירויות תנועה יחסיות.

הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: 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
סוג Enum: 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 אלא אם כל ערכי המאפיין VehicleLightSwitch נתמכים.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: VehicleLightSwitch
סוג יחידה: לא רלוונטי
גרסה: Android 14

STEERING_WHEEL_LOCKED

ההגה נעול. אם הערך הוא True, מיקום ההגה נעול ולא ניתן לשינוי. הנכס הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו רק בתור <covehiclepropertyaccess.read< code="">./p> </covehiclepropertyaccess.read<>

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

STEERING_WHEEL_THEFT_LOCK_ :

התכונה 'נעילת ההגה למניעת גניבה' מופעלת. אם הערך הוא True, ההגה ננעל אוטומטית בהתאם ל: למניעת גניבה במצבים מסוימים. המאפיין הזה מוגדר כ-VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים ליישם אותו בתור VehiclePropertyAccess.READ בלבד.

מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 14

STORAGE_ENCRYPTION_BINDING_SEED

ערך הבסיס של קישור הצפנה חיצוני. הערך הזה מעורב עם המפתח המקומי להצפנת אחסון מפתחות. הנכס הזה מכיל 16 בייטים, והוא צפוי להישמר ב-ECU בנפרד מ-IVI. הנכס מוגדר בהתחלה על ידי AAOS, שיוצר אותו באמצעות CSRNG. ואז AAOS קורא את הטקסט בנעליים הבאות. ערך הבסיס לקישור צפוי להישמר באופן מהימן. כל אובדן של התוצאה של גרעין היא איפוס של ה-IVI להגדרות המקוריות.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

תמיכה בהתאמה אישית של הרשאות לנכסי ספק.

צריך להטמיע את הנכס הזה אם ב-VHAL יש תמיכה בתכונה 'התאמה אישית של הרשאות ספק'. VehiclePropConfig.configArray משמש כדי לציין את המאפיינים וההרשאות של הספק נבחרו לנכס הספק הזה. ההרשאה חייבת להיות מסוג 'טיפוסים בני מנייה (enum)' ב-vehicleVendorPermissions. configArray מוגדר כך, configArray[n]: propId : property ID עבור נכס של ספק שבו הערך configArray[n+1] הוא enum ב-vehicleVendorPermissions ומציין את הרשאה לקריאת ערך הנכס.

configArray[n+2] הוא enum ב-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 לא יכולה לכתוב ערך עבור provider_prof_2.

שינוי מצב: STATIC
מצב גישה: READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

SUPPORTED_PROPERTY_IDS

(התכונה הוצאה משימוש) רשימה של כל מזהי הנכסים הנתמכים.

שינוי מצב: STATIC
מצב גישה: READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

SWITCH_USER

מגדירה בקשה להחלפת משתמש Android שפועל בחזית.

הנכס הזה משמש בעיקר את מערכת Android כדי להודיע ל-HAL שהגרסה הנוכחית משתמש Android שפועל בחזית עובר בין מכשירים, אבל הוא יכול גם לשמש את HAL כדי לבקש מערכת Android כדי להחליף משתמש. כשהבקשה נשלחת על ידי Android, היא מגדירה ערך VehiclePropValue וה-HAL חייב להגיב עם אירוע של שינוי נכס. כשמגיש הבקשה HAL שולח את הבקשה, הוא חייב לעשות זאת גם באמצעות אירוע של שינוי נכס (ההבדל העיקרי הוא שמזהה הבקשה הוא חיובית במקרה הראשון ושלילית במקרה השני). גם הערך של SwitchUserMessageType שונה.

הפורמט של שתי הבקשות מוגדר על ידי SwitchUserRequest, והפורמט של התגובה (במקרה הצורך) מוגדר על ידי SwitchUserResponse. האופן שבו צריך להמשיך ב-HAL (או במערכת Android) תלוי בסוג ההודעה (שמוגדר על ידי הפרמטר SwitchUserMessageType), כפי שמוגדר בהמשך.
  • LEGACY_ANDROID_SWITCH בוצעה שיחה על ידי מערכת Android כדי לציין משתמש Android עומד להשתנות, כשבקשת השינוי נשלחה בדרך שלא משולבת עם HAL (לדוגמה, דרך adb Shell am touch-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 // target user flags (none)
    • int32[4] 10 // המשתמש הנוכחי
    • int32[5] 0 // current user flags (none)
    • int32[6] 3 // מספר המשתמשים
    • int32[7] 0 // משתמש מס' 0 (מזהה משתמש 0 ב-Android)
    • int32[8] 0 // דגלים של משתמש #0 (ללא)
    • int32[9] 10 // משתמש מס' 1 (מזהה משתמש Android 10)
    • int32[10] 0 // flags of user #1 (none)
    • int32[11] 11 // משתמש מס' 2 (מזהה משתמש ב-Android 11)
    • int32[12] 0 // flags of user #2 (none)
  • ANDROID_SWITCH המערכת של Android קוראת ל-HAL כדי לציין שהמשתמש ב-Android עומד להשתנות, אבל Android ממתינה לתשובה של ה-HAL (עד פרק זמן מסוים) לפני שהיא ממשיכה. חובה לספק HAL להחליף את המשתמש הפנימי שלו אחרי שהוא מקבל את הבקשה, ואז להשיב ל-Android עם SWITCH_USER(type=VEHICLE_RESPONSE) שמציין אם המשתמש הפנימי הוחלף או לא (באמצעות enum SwitchUserStatus). לדוגמה, אם ל-Android יש משתמשים (0, 10, 11) והוא עובר מ-10 ל-11 (אף אחד מהם לא כולל דגל מיוחד), הבקשה תהיה:
    • int32[0] 42 // request id
    • int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
    • int32[2] 11 // מזהה משתמש יעד
    • int32[3] 0 // target user flags (none)
    • int32[4] 10 // המשתמש הנוכחי
    • int32[5] 0 // current user flags (none)
    • int32[6] 3 // מספר המשתמשים
    • int32[7] 0 // first user (user 0)
    • int32[8] 1 // first user flags (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 // status: SwitchUserStatus::SUCCESS

    אם הבקשה נכשלת, התשובה תיראה כך:

    • int32[0] 42 // request id
    • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
    • int32[2] 2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"
    • הודעת שגיאה ספציפית ל-OEM
  • VEHICLE_RESPONSE ה-HAL קורא ל-method הזה כדי לציין אם צריך להמשיך בבקשה מסוג 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 // מזהה משתמש יעד
    • int32[3] 0 // target user id flags (none)
    • int32[4] 11 // current user
    • int32[5] 0 // דגלים נוכחיים (none)
    • int32[6] 3 // מספר המשתמשים
    • int32[7] 0 // משתמש ראשון (משתמש 0)
    • int32[8] 0 // first user flags (none)
    • int32[9] 10 // משתמש שני (משתמש 10)
    • int32[10] 4 // second user flags (none)
    • int32[11] 11 // משתמש שלישי (משתמש 11)
    • int32[12] 3 // third user flags (none)

    מזהי המשתמשים הנוכחיים והיעד זהים. אם הבקשה נכשלת, הערכים יהיו שונים. לדוגמה, המשתמש היעד יהיה 11 והמשתמש הנוכחי יישאר 10.

  • ANDROID_POST_SWITCH התקבלה שיחה ממערכת Android אחרי שנשלחה בקשה להחלפת משתמש. הנכס הזה נקרא אחרי בקשות החלפה מכל סוג שהוא (לדוגמה, >קוד>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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

TIRE_PRESSURE

לחץ אוויר בצמיגים. כל צמיג מזוהה באמצעות תצורת areaConfig.areaId שלו. minFloatValue ו-maxFloatValue התואמים משמשים לאחסון ה-OEM- טווח הלחץ המומלץ. צריך להגדיר ערכים ל-minFloatValue ול-maxFloatValue ב-VehicleAreaConfig.

ערך minFloatValue בנתוני areaConfig מייצג את הגבול התחתון של הצמיג המומלץ לחץ. הערך maxFloatValue בנתוני areaConfig מייצג את הערך העליון של לחץ האוויר המומלץ בצמיגים. לדוגמה, הפרמטר areaConfig מציין את המאפיינים המומלצים לחץ הצמיג בצמיג שמאלי, מ-200.0kPa ל-240.0kPa.

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

שינוי מצב: CONTINUOUS
מצב גישה: READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג יחידה: VehicleUnit:KILOPASCAL
גרסה: Android 13

TIRE_PRESSURE_DISPLAY_UNITS

יחידות לחץ אוויר בצמיגים להצגה. מציין את היחידות שבהן נעשה שימוש ברכב כדי להציג את לחץ האוויר בצמיגים למשתמש. לדוגמה, PSI, Bar או Kilopascal. השדה VehiclePropConfig.configArray משמש לציון היחידות הנתמכות להצגת לחץ. יחידות לחץ מוגדרות ב-VehicleUnit. לדוגמה, configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

אם עדכון של TIRE_PRESSURE_DISPLAY_UNITS משפיע על הערכים של נכסי *_DISPLAY_UNITS אחרים, צריך לעדכן את הערכים שלהם ולהעביר אותם גם ל-framework של AAOS. המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור <covehiclepropertyaccess.read< code=""> בלבד./p> </covehiclepropertyaccess.read<>

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג הטיפוסים בני מנייה (enum) : VehicleUnit
סוג היחידה: לא רלוונטי
גרסה: Android 13

TRACTION_CONTROL_ACTIVE

המאפיין מוגדר כ-true כשבקרת המתיחות (TC) פעילה, ומתאפס ל-false כשהיא מושבתת. אפשר להגדיר את המאפיין הזה לסירוגין (פולס) על סמך המצב בזמן אמת של מערכת בקרת המתיחות.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

TRAILER_PRESENT

הפונקציה מחזירה את מצב הגרירה של הרכב.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: TrailerState
סוג יחידה: N/A
גרסה: Android 13

TURN_SIGNAL_STATE

מצב הרכבים שבו מופעלים האותות.

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: VehicleTurnSignal
סוג יחידה: N/A
גרסה: Android 13

USER_IDENTIFICATION_ASSOCIATION

נכס שמשמש לשיוך (או שליחת שאילתה לשיוך) של המשתמש הנוכחי למשתמש ספציפי לרכב מנגנוני זיהוי (כמו FOB).

זהו מאפיין אופציונלי של ניהול משתמשים. ה-OEM עדיין יכול לתמוך בניהול משתמשים ללא להגדיר אותו. למעשה, אפשר להשתמש בנכס הזה בלי לתמוך בפונקציות הליבה שקשורות למשתמש שמתוארות ב-INITIAL_USER_INFO.

כדי לשלוח שאילתות לגבי השיוך, מערכת Android מקבלת את הנכס ומעבירה את VehiclePropValue שמכיל את סוגי השיוך שעבורם נשלחות השאילתות, כפי שהוגדר על ידי UserIdentificationGetRequest. מדד ה-HAL חייב לחזור מיד, ולהחזיר ערך של VehiclePropValue UserIdentificationResponse.

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

כדי לשייך בין סוגים, מערכת Android מגדירה את הנכס ומעבירה ערך VehiclePropValue שמכיל הסוגים והערכים של השיוכים שמוגדרים, כפי שמוגדרים על ידי UserIdentificationSetRequest.

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

לדוגמה, שאילתה אם המשתמש הנוכחי (10) משויך ל-FOB שביטל את הנעילה של הרכב ובמנגנון מותאם אישית שסופק על ידי ה-OEM, הבקשה היא:

  • 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)

אם המשתמש משויך ל-FOB אבל לא למנגנון המותאם אישית, התגובה תהיה:

  • int32[0] 42 // request id
  • 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 // request id
  • int32[1] 10 (מזהה משתמש ב-Android)
  • int32[2] 0 (דגלים של משתמשי Android)
  • int32[3] 1 (מספר השיוכים המוגדרים)
  • int32[4] 101 (הסוג הראשון: UserIdentificationAssociationType::CUSTOM_1)

אם הבקשה מצליחה, התגובה תהיה:

  • int32[0] 43 // request id
  • 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 // request id
  • 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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

VEHICLE_CURB_WEIGHT

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

הפונקציה configArray[0] משמשת לציון המשקל ברוטו של הרכב בקילוגרמים. מחיר הרכב המשקל הוא משקל הנסיעה המקסימלי של הרכב, כפי שצוין על ידי היצרן כולל שלדת הרכב, גוף הרכב, המנוע, נוזלי המנוע, דלק, אביזרים, הנהג, נוסעים ומטען, אבל לא כולל נגררים.

שינוי מצב: STATIC
מצב גישה: READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג יחידה: VehicleUnit:KILOGRAM
גרסה: Android 13

VEHICLE_IN_USE

מציין אם הרכב נמצא בשימוש. 'בשימוש' פירושו שיש אדם אנושי ומתכוון להשתמש בו את הרכב. זה לא אומר בהכרח שהמשתמש האנושי נמצא ברכב. לדוגמה, אם המשתמש האנושי פותח את הרכב מרחוק, הרכב נחשב ל'בשימוש'. אם הנכס הזה נתמך:

  • בכל פעם שהמשתמש מפעיל את הרכב או שהמערכת מזהה שהמשתמש נמצא ברכב, צריך להגדיר את VEHICLE_IN_USE כ-true. בכל פעם שהמשתמש מכבה את הרכב, או המערכת מזהה שהמשתמש לא נמצא, יש להגדיר את VEHICLE_IN_USE כ-False.
  • אם המשתמש מכבה את הרכב או שהמערכת מזהה שהמשתמש לא נמצא, הערך של VEHICLE_IN_USE צריך להיות False.
  • אם המשתמש מתניע את הרכב או שהמערכת מזהה שהמשתמש נמצא כרגע, צריך להגדיר את VEHICLE_IN_USE כ-True.

המאפיין הזה שונה מ-AP_POWER_BOOTUP_REASON בכך AP_POWER_BOOTUP_REASON מוגדר רק פעם אחת במהלך אתחול המערכת. עם זאת, הנכס הזה עשוי להשתנות כמה פעמים במהלך מחזור הפעלה של המערכת. לדוגמה, מכשיר שלא נמצא כרגע בשימוש. הפעלת המערכת כדי לבצע משימה מרחוק. הערך של VEHICLE_IN_USE הוא false. בזמן המשימה מרחוק מתבצעת, המשתמש נכנס לרכב ונדלק את הרכב. הערך של VEHICLE_IN_USE מוגדר כ-true. אחרי סשן נסיעה, המשתמש מכבה את הרכב, VEHICLE_IN_USE מוגדר כ-false.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 14

VEHICLE_MAP_SERVICE

הודעה על שירות מפות Google לרכב (VMS). הנכס הזה משתמש בנתונים MIXED כדי להעביר הודעות VMS. יש לפרש את התוכן שלו באופן הבא. המדדים שמוגדרים ב-VmsMessageIntegerValuesInde משמשים לקריאה מ-int32Values. בייטים הם הודעות VMS טוריות, כפי שמוגדר ב-VMS שהוא אטום ל-framework. הפונקציה IVehicle#get תמיד צריכה להחזיר את הערך StatusCode::NOT_AVAILABLE.

שינוי מצב: ON_CHANGEREAD_WRITE
מצב גישה: READ_WRITE
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

VEHICLE_SPEED_DISPLAY_UNITS

יחידות מהירות להצגה. מציין את סוג היחידות שבהן מוצגת המהירות למשתמש. לדוגמה, מ"ש, קמ"ש או מייל בשעה. הערך של VehiclePropConfig.configArray מציין את המהירות הנתמכת יחידות תצוגה. יחידות לחץ מוגדרות ב-VehicleUnit. לדוגמה:

.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
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

VHAL_HEARTBEAT

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

מצב שינוי: ON_CHANGE
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

WatchDOG_ALIVE

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

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

WatchDOG_TERMINATED_Process

מגדירה תהליך שהסתיים על ידי טיימר המפקח (watchdog) של Cardog והסיבה לסגירה.

int32Values[0] 1  // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command

מצב שינוי: ON_CHANGE
מצב גישה: WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: 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

נעשה שימוש ב-enum Wheel. לדוגמה, אם כל הגלגלים נתמכים, אז:

  • configArray[0] VehicleAreaWheel::LEFT_FRONT | VehicleAreaWheel::RIGHT_FRONT | VehicleAreaWheel::LEFT_REAR | VehicleAreaWheel::RIGHT_REAR
  • configArray[1] מיקרומטרים לכל סימן שנתת בגלגל הקדמי הימני
  • configArray[2] מיקרומטרים לכל שנתות על ידי גלגל ימני קדמי
  • configArray[3] מיקרומטרים לכל שנתות על ידי גלגל ימני
  • configArray[4] מיקרומטרים לכל שנתות על ידי גלגל שמאלי אחורי.

אם גלגל לא נתמך, הערך שלו יוגדר תמיד ל-0.

צריך למלא את השדה VehiclePropValue.timestamp.

מצב שינוי: CONTINUOUS
מצב גישה: READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

window_LOCK

נעילת חלון לילדים. True מציין שהחלון נעול לילדים. המאפיין הזה מוגדר כך VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13

Windows_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
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

Windows_POS

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

ערכים בין minInt32Value ל-maxInt32Value מציינים מצב מעבר בין המצבים 'סגור'/'פתוח לגמרי' מחוץ לתוכנית לבין המצב 'פתוח לגמרי'. הנכס הזה לא בכל יחידה ספציפית אבל בטווח מסוים של מיקומים יחסיים. לדוגמה, כך המאפיין אמור לפעול בחלון שיכול לזוז מחוץ למטוס: בחלון שיכול להיפתח מחוץ למטוס (מצב אוורור של חלון גג) הפרמטר פועל עם ערכים שליליים באופן הבא:

  • Max גג שמש פתוח באופן מלא (0 כשגג סגור).
  • Min אוורור בגג שמש פתוח במלואו (0 אם גג סגור).
במצב הזה, הערך 0 מציין שהחלון סגור.

המאפיין הזה מוגדר בתור VehiclePropertyAccess.READ_WRITE, אבל יצרני ציוד מקורי יכולים להטמיע אותו בתור VehiclePropertyAccess.READ בלבד.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג היחידה: לא רלוונטי
גרסה: Android 13

WINDSHIELD_WIPERS_PERIOD

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

שינוי מצב: ON_CHANGE
מצב גישה: READ
סוג טיפוסים בני מנייה (enum) : לא רלוונטי
סוג יחידה: 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
סוג Enum: 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 והמצב 'אחר' רשומים המערך VehicleAreaConfig#supportedEnumValues, אז OTHER אינו ערך נתמך לכתיבה, זהו ערך נתמך רק לקריאה.

שינוי מצב: ON_CHANGE
מצב גישה: READ_WRITE/READ
סוג הטיפוסים בני מנייה (enum) : WindshieldWipersSwitch
סוג היחידה: לא רלוונטי
גרסה: Android 14