הגדרות הנכס

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

שדה	תיאור
prop	מזהה הנכס. המאפיין הזה חייב להיות אחד ממאפייני המערכת המוגדרים מתוך מאפייני המערכת הנתמכים או מאפיין של ספק. מזהה הנכס נוצר באמצעות אופרטור ביטים (bit-or) של השדות הבאים (מימין לשמאל): (0x00000000) 16 ביט: מזהה ייחודי מטווח 0x0100 עד 0xffff. (0x00000000) 8 ביט: סוגי נכסים שמגדירים את הסוג של הנכס. (0x00000000) 4 ביט: סוגים של אזורים. (0x00000000) 4 ביט: VehiclePropertyGroup> הערך הוא SYSTEM (0x10000000) או VENDOR (0x20000000). במאמר מאפייני ספקים מפורטות תכונות שאפשר להתאים אישית. לדוגמה, INFO_VIN (0x11100100) = UniqueID (0x00000100) | VehiclePropertyType.STRING (0x00100000) | VehicleArea.GLOBAL (0x01000000) | VehiclePropertyGroup.SYSTEM (0x10000000)
access	מצב הגישה לנכס. הערך חייב להיות אחד מהערכים הבאים: READ, WRITE או READ_WRITE. הערך הזה צריך להיות שווה למצב הגישה שמוגדר בקטע Supported System Properties.
changeMode	שינוי המצב של הנכס. חייב להיות אחד מהערכים הבאים: STATIC,‏ ON_CHANGE או CONTINUOUS. STATIC פירושו שערך המאפיין לא משתנה אף פעם אחרי הפעלת המערכת. המשמעות של ON_CHANGE היא ש-VHAL חייב לדווח כשהערך משתנה. הערך CONTINUOUS מציין שהערך של המאפיין משתנה באופן קבוע, ו-VHAL צריך לדווח על סמך קצב הדגימה של המינוי. מצב השינוי צריך להיות שווה למצב השינוי שמוגדר בקטע מאפייני מערכת נתמכים.
configArray	מערך אופציונלי שמכיל הגדרות אישיות ספציפיות למאפיין. השדה יכול להיות ריק.
configString	מחרוזת אופציונלית שמכילה הגדרות ספציפיות לנכס. השדה יכול להיות ריק.
minSampleRate וגם maxSampleRate קצב הדגימה המינימלי והמקסימלי שנתמך למאפיין רציף. לא בשימוש אם המאפיין לא רציף.

סוגי נכסים

מוגדרים כ-enums ב-VehiclePropertyType.aidl. סוגי הנכסים הנתמכים מפורטים בטבלה הבאה.

סוג הנכס	ערך	תיאור
מחרוזת	0x00100000	מאפיין מחרוזת, נעשה בו שימוש בשדה stringValue בערך של מאפיין הרכב.
בוליאני	0x00200000	מאפיין בוליאני, שמשתמש ברכיב הראשון בשדה int32Values בקטע ערך מאפיין הרכב. 0 פירושו false, ו-None 0 פירושו true.
INT32	0x00400000	מאפיין של מספר שלם, שמשתמש ברכיב הראשון בשדה int32Values בקטע ערך מאפיין הרכב.
INT32_VEC	0x00410000	המאפיין Integer[], משתמש ברכיבים בשדה int32Values בקטע ערך מאפיין הרכב.
INT64	0x00500000	נכס ארוך, משתמש ברכיב הראשון בשדה int64Values בערך נכס הרכב.
INT64_VEC	0x00510000	המאפיין Long[] משתמש ברכיבים בשדה int64Values בקטע ערך מאפיין הרכב.
FLOAT	0x00600000	נכס צף, משתמש ברכיב הראשון בשדה floatValues בערך נכס הרכב.
FLOAT_VEC	0x00610000	המאפיין Float[] משתמש ברכיבים בשדה floatValues בערך נכס הרכב.
נפח אחסון פנוי	0x00700000	המאפיין byte[], משתמש ברכיבים בשדה byteValues בקטע ערך המאפיין Vehicle.
MIXED	0x00e00000	נכס מסוג מעורב. כל שילוב של סוגי סקלר או וקטורים. צריך לציין את הפורמט המדויק במערך ה-config בהגדרות של הנכס. בנכסים מסוג MIXED של ספקים, צריך לעצב את configArray במבנה הזה: configArray[0], 1 מציין שלנכס יש ערך מחרוזת configArray[1], 1 מציין שלנכס יש ערך בוליאני configArray[2], 1 מציין שלנכס יש ערך של מספר שלם configArray[3], המספר מציין את הגודל של Integer[] בנכס configArray[4], 1 מציין שלנכס יש ערך ארוך configArray[5], המספר מציין את הגודל של Long[] בנכס configArray[6], 1 מציין שהנכס מכיל ערך של נקודה צפה configArray[7], המספר מציין את הגודל של Float[] במאפיין configArray[8], המספר מציין את הגודל של הבייט[] בנכס. לדוגמה, הערך configArray = {1, 1, 1, 3, 0, 0, 0, 0, 0} מציין שהמאפיין מכיל ערך מחרוזת, ערך בוליאני, ערך שלם ומערך עם שלושה מספרים שלמים.

הגדרת מזהה אזור

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

שדה	תיאור
areaId	המזהה של האזור הזה. למידע נוסף, אפשר לעיין בקטע מזהי אזורים.
minInt32Value וגם maxInt32Value	ערך מינימלי ומקסימלי אופציונלי לנכסים מסוג INT32. המערכת מתעלמת מכל סוגי הקבצים האחרים. המערכת תתעלם מהמאפיין אם שני הערכים הם 0. בנכס גלובלי, אם צריך להגדיר ערך מינימלי ומקסימלי, צריך להשתמש בהגדרת אזור אחת עם מזהה האזור 0.
minInt64Value וגם maxInt64Value	ערך מינימלי ומקסימלי אופציונלי למאפיינים מסוג INT64. המערכת מתעלמת מכל סוגי הקבצים האחרים. המערכת תתעלם מהמאפיין אם שני הערכים הם 0. בנכס גלובלי, אם צריך להגדיר ערך מינימלי ומקסימלי, צריך להשתמש בהגדרת אזור אחת עם מזהה האזור 0.
minFloatValue וגם maxFloatValue	ערך מינימום וערך מקסימום אופציונליים למאפיינים מסוג Float. המערכת מתעלמת מכל סוגי הקבצים האחרים. המערכת תתעלם אם הערך של שניהם הוא 0.0. בנכס גלובלי, אם צריך להגדיר ערך מינימלי ומקסימלי, צריך להשתמש בהגדרת אזור אחת עם מזהה האזור 0.
(חדש ב-Android 14) supportedEnumValues	רשימה אופציונלית של ערכים נתמכים אם המאפיין מוגדר כמאפיין מסוג enum. אם לא צוין (ריק) או לפני Android 14, המערכת תתייחס לכל הערכים של המאפיין בתור נתמכים. בנכס גלובלי, אם צריך להגדיר ערכים נתמכים של enum, צריך להשתמש בהגדרה אחת של אזור עם מזהה האזור 0.

סוגי אזורים

מוגדרים כ-enums ב-VehicleArea.aidl. סוגי האזורים הנתמכים מפורטים בהמשך.

סוג האזור	ערך	תיאור
GLOBAL	0x01000000	הנכס הזה הוא נכס גלובלי ואין לו כמה אזורים.
WINDOW	0x03000000	אזור שמבוסס על חלונות, באמצעות VehicleAreaWindow enum.
MIRROR	0x04000000	אזור שמבוסס על מראות, משתמש ב-VehicleAreaMirror enum.
סיאט	0x05000000	אזור שמבוסס על מושבים, נעשה בו שימוש ב-enum של VehicleAreaSeat.
DOOR	0x06000000	אזור שמבוסס על דלתות, באמצעות VehicleAreaDoor enum.
WHEEL	0x07000000	אזור שמבוסס על גלגלים, משתמש ב-VehicleAreaWheel enum.

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

• ROW_1_LEFT = 0x0001
• ROW_1_CENTER = 0x0002
• ROW_1_RIGHT = 0x0004
• ROW_2_LEFT = 0x0010
• ROW_2_CENTER = 0x0020
• ROW_2_RIGHT = 0x0040
• ROW_3_LEFT = 0x0100
• ...

מזהי אזורים

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

פריט	תיאור
ROW_1_LEFT | ROW_1_RIGHT	מזהה האזור חל על שני המושבים הקדמיים.
ROW_2_LEFT	ההגדרה חלה רק על המושב האחורי השמאלי.
ROW_2_RIGHT	ההגדרה חלה רק על המושב הימני האחורי.

מידע נוסף זמין במאמר בקרת אקלים (HVAC).