בדף הזה מפורטים מאפייני המערכת הנתמכים ב-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 של ספקים יכולות להשתמש בהם כדי לוודא שהגדרות הנכס עומדות במפרט.
A עד D
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 WRITE
s לערך הזה כדי לתת ל-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 של VehicleApPowerStateReportint32Values[1]
הזמן להתעוררות, אם צריך, באלפיות שנייה (אחרת 0)
מצב שינוי: ON_CHANGE
מצב גישה: READ_WRITE
סוג Enum: לא רלוונטי
סוג יחידה: לא רלוונטי
גרסה: Android 13
AP_POWER_STATE_REQ
נכס לצורך בקרה על מצב החשמל של מעבד האפליקציה. ההנחה היא שמצב החשמל של הנקודה לשיתוף אינטרנט נשלט על ידי בקר חשמל נפרד. למידע על ההגדרות, בשדה VehiclePropConfig.configArray
צריך להופיע דגל ביטים שמכיל שילוב של הערכים בשדה VehicleApPowerStateConfigFlag
int32Values[0]
ערך enum של VehicleApPowerStateReqint32Values[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 - leftint32[2]
Bounds - topint32[3]
Bounds – rightint32[4]
Bounds - bottomint32[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 userint32[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
שקע הטעינה של הרכב החשמלי מחובר. אם לרכב יש כמה שקעי טעינה, המאפיין הזה צריך להחזיר את הערך
מצב שינוי: 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
. לדוגמה, לרכב יש שני:
- המושבים הקדמיים (
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]
- מושבים בשורה הקדמית (
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]
[הגבול התחתון של הטמפרטורה הנתמכת בצלזיוס] * 10configArray[1]
[הגבול העליון של הטמפרטורה הנתמכת במעלות צלזיוס] * 10configArray[2]
[עלייה בצלזיוס] * 10configArray[3]
[הגבול התחתון של הטמפרטורה הנתמכת בפרנהייט] * 10configArray[4]
[הגבול העליון של הטמפרטורה הנתמכת בפרנהייט] * 10configArray[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]
פעולה שמוגדרת על ידי VehicleHwKeyInputActionint32Values[1]
קוד מפתח, צריך להשתמש בקוד מפתח רגיל של Androidint32Values[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]
מזהה מצביע, באורך Nint32array[5+N:5+2*N-1]
סוג הכלי, אורך N. כפי שמוגדר בקטעVehicleHwMotionToolType
, למשל:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x נתונים, אורך NfloatArray[N:2*N-1]
נתוני y, באורך N- נתוני לחץ
floatArray[2*N:3*N-1]
, באורך N floatArray[3*N:4*N-1]
נתוני גודל, אורך Nint64array[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
מצב גישה: קריאה
סוג 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 }
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)
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
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]
DisplayPortint32Values[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 userint32[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_SWITCHint32[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 idint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[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_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
אם הבקשה נכשלת, התשובה תיראה כך:
int32[0]
42 // request idint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[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_REQUESTint32[2]
11 // מזהה המשתמש ב-Android
אם הבקשה תאושר וב-Android יש שלושה משתמשים (0, 10 ו-11), התשובה תהיה:
int32[0]
-108 // מזהה הבקשהint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // מזהה משתמש יעדint32[3]
0 // target user id flags (none)int32[4]
11 // current userint32[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 idint32[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 idint32[1]
10 (מזהה משתמש ב-Android)int32[2]
0 (דגלים של משתמשי Android)int32[3]
1 (מספר השיוכים המוגדרים)int32[4]
101 (הסוג הראשון: UserIdentificationAssociationType::CUSTOM_1)
אם הבקשה מצליחה, התגובה תהיה:
int32[0]
43 // request idint32[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 idint32[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
מדווח על סימונים של גלגל העכבר. הרכיב הראשון בווקטור הוא ספירת איפוס. איפוס מציין לא ניתן להשוות בין מספרי השתלטים הקודמים למספר הזה ולמספרים עתידיים. סוג של אי-רציפות התרחשה ספירת ההצעות.
ארבעת הרכיבים הבאים מייצגים סימונים של גלגלים נפרדים בסדר הבא:
- רמקול קדמי שמאלי
- רמקול קדמי ימני
- חלון אחורי ימני
- חלון אחורי שמאלי
כל הסימונים המצטברים הם מצטברים. ספירת הנקודות נספרת כשהרכב נע קדימה, וגם להקטנה כשהרכב נע אחורה. צריך לאפס את סימני הפחם ל-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_REARconfigArray[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 אם גג סגור).
המאפיין הזה מוגדר בתור 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