מאפייני HAL משתמש

ארכיטקטורות רכב נוכחיות רבות מכילות מספר יחידות בקרה אלקטרוניות (ECU) מחוץ למערכת המידע והבידור השולטות בארגונומיה, כגון הגדרות מושבים והתאמת מראה. בהתבסס על ארכיטקטורות החומרה והכוח הנוכחיות, ECUs רבים מופעלים לפני הפעלת מערכת המידע והבידור המבוססת על אנדרואיד. ECUs אלה יכולים להתממשק עם מערכת מידע בידור מבוססת אנדרואיד דרך שכבת חומרת ההפשטה של ​​הרכב (VHAL) .

החל מ-Android 11, Android Automotive OS (AAOS) הציגה קבוצה חדשה של מאפיינים ב-VHAL ליצירה, החלפה, הסרה ושיוך אביזרים חיצוניים לזיהוי משתמשים. לדוגמה, מאפיינים חדשים אלה מאפשרים לנהג לקשור אביזר חיצוני, כגון שלט מפתח, למשתמש האנדרואיד שלו. לאחר מכן, כאשר הנהג מתקרב לרכב, ECU מתעורר ומזהה את שלט המפתח. ECU זה מציין ל-HAL איזה משתמש אנדרואיד צריך להתחיל אתחול המידע-בידור, מה שמפחית את הזמן שנהג ממתין לטעינת משתמש האנדרואיד שלו.

הפעל את המשתמש HAL

יש להפעיל במפורש את מאפייני User HAL על ידי הבטחת מאפיין המערכת android.car.user_hal_enabled מוגדר כ- true . (ניתן לעשות זאת גם בקובץ car.mk , כך שאין צורך להגדיר אותו ידנית.) בדוק ש- user_hal_enabled=true מופעל על ידי השלכת ה- UserHalService :

$ adb shell dumpsys car_service --hal UserHalService|grep enabled
user_hal_enabled=true

אתה יכול גם לבדוק user_hal_enabled באמצעות adb shell getprop android.car.user_hal_enabled או adb logcat CarServiceHelper *:s . אם המאפיין מושבת, הודעה כמו הבאה מוצגת כאשר system_server מופעל:

I CarServiceHelper: Not using User HAL

כדי להפעיל את user_hal_enabled באופן ידני, הגדר את מאפיין המערכת android.car.user_hal_enabled והפעל מחדש system_server :

$ adb shell setprop android.car.user_hal_enabled true
$ adb shell stop && adb shell start

הפלט של logcat מופיע באופן הבא:

I CarServiceHelper: User HAL enabled with timeout of 5000ms
D CarServiceHelper: Got result from HAL: OK
I CarServiceHelper: User HAL returned DEFAULT behavior

מאפייני HAL של משתמש

מאפייני מחזור חיים של משתמש

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

הערה: כאשר User HAL נתמך, יש ליישם את כל המאפיינים הבאים.

נכסים נוספים

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

ספריות עוזרים

לכל האובייקטים המשמשים בהודעות הבקשה והתגובה (כגון UserInfo , InitialUserInfoRequest , InitialUSerInfoResponse וכן הלאה) יש ייצוג ברמה גבוהה באמצעות C++ struct , אך יש לשטח את ההסרה לאובייקטים סטנדרטיים VehiclePropValue (ראה הדוגמאות למטה). כדי להקל על הפיתוח, ספריית C++ מסייעת מסופקת ב-AOSP כדי להמיר אוטומטית VehiclePropValue structs ולהיפך).

דוגמאות

INITIAL_USER_INFO

בקשה לדוגמא (באתחול ראשון)

VehiclePropValue { // flattened from InitialUserInfoRequest
prop: 299896583 // INITIAL_USER_INFO
prop.values.int32Values:
 [0] = 1 // Request ID
 [1] = 1 // InitialUserInfoRequestType.FIRST_BOOT
 [2] = 0 // user id of current user
 [3] = 1 // flags of current user (SYSTEM)
 [4] = 1 // number of existing users
 [5] = 0 // existingUser[0].id
 [6] = 1 // existingUser[0].flags
}

דוגמה לתגובה (צור משתמש מנהל)

VehiclePropValue { // flattened from InitialUserInfoResponse
prop: 299896583 // INITIAL_USER_INFO
prop.values.int32Values:
  [0] = 1      // Request ID (must match request)
  [1] = 2      // InitialUserInfoResponseAction.CREATE
  [2] = -10000 // user id (not used on CREATE)
  [3] = 8      // user flags (ADMIN)
prop.values.stringValue: "en-US||Car Owner" // User locale and User name
}

החלף משתמש

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

איור 1. זרימת עבודה של מאפייני HAL של משתמש

דוגמה לבקשת זרימת עבודה מודרנית

VehiclePropValue { // flattened from SwitchUserRequest
prop: 299896585 // SWITCH_USER
prop.values.int32Values:
 [0]     = 42    // Request ID
 [1]     = 2     // SwitchUserMessageType::ANDROID_SWITCH ("modern")
 [2,3]   = 11,0  // target user id (11) and flags (none in this case)
 [4,5]   = 10,8  // current user id (10) and flags (ADMIN)
 [6]     = 3     // number of existing users (0, 10, 11)
 [7,8]   = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [9,10]  = 10,8  // existingUser[1] (id=10, flags=ADMIN)
 [11,12] = 11,0  // existingUser[2] (id=11, flags=NONE)
}

דוגמה לתגובת זרימת עבודה מודרנית

VehiclePropValue { // flattened from SwitchUserResponse
prop: 299896584 // SWITCH_USER
prop.values.int32Values:
 [0] = 42        // Request ID (must match request)
 [1] = 3         // SwitchUserMessageType::VEHICLE_RESPONSE
 [2] = 1         // SwitchUserStatus::SUCCESS
}

דוגמה לתגובת זרימת עבודה מודרנית לאחר המעבר

תגובה זו מתרחשת בדרך כלל כאשר מתג אנדרואיד מצליח:

VehiclePropValue { // flattened from SwitchUserRequest
prop: 299896584 // SWITCH_USER
prop.values.int32Values:
 [0]     = 42    // Request ID (must match "pre"-SWITCH_USER request )
 [1]     = 5     // SwitchUserMessageType::ANDROID_POST_SWITCH
 [2,3]   = 11,0  // target user id (11) and flags (none in this case)
 [4,5]   = 11,0  // current user id (11) and flags (none in this case)
 [6]     = 3     // number of existing users (0, 10, 11)
 [7,8]   = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [9,10]  = 10,8  // existingUser[1] (id=10, flags=ADMIN)
 [11,12] = 11,0  // existingUser[2] (id=11, flags=NONE)
}

תגובה מודרנית של זרימת עבודה לאחר המעבר

תגובה זו מתרחשת בדרך כלל כאשר מתג אנדרואיד נכשל:

VehiclePropValue { // flattened from SwitchUserRequest
prop: 299896584 // SWITCH_USER
prop.values.int32Values:
 [0]     = 42    // Request ID (must match "pre"-SWITCH_USER request )
 [1]     = 5     // SwitchUserMessageType::ANDROID_POST_SWITCH
 [2,3]   = 11,0  // target user id (11) and flags (none in this case)
 [4,5]   = 10,8  // current user id (10) and flags (ADMIN)
 [6]     = 3     // number of existing users (0, 10, 11)
 [7,8]   = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [9,10]  = 10,8  // existingUser[1] (id=10, flags=ADMIN)
 [11,12] = 11,0  // existingUser[2] (id=11, flags=NONE)
}

דוגמה לבקשת זרימת עבודה מדור קודם

VehiclePropValue { // flattened from SwitchUserRequest
prop: 299896584 // SWITCH_USER
prop.values.int32Values:
 [0]     = 2     // Request ID
 [1]     = 1     // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
 [2,3]   = 10,8  // target user id (10) and flags (ADMIN)
 [4,5]   = 0,1   // current user id (0) and flags (SYSTEM)
 [6]     = 3     // number of existing users (0, 10, 11)
 [7,8]   = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [9,10]  = 10,8  // existingUser[1] (id=10, flags=ADMIN)
 [11,12] = 11,0  // existingUser[2] (id=11, flags=NONE)
}

דוגמה לבקשת זרימת עבודה של רכב

VehiclePropValue { // flattened from SwitchUserRequest
prop: 299896584 // SWITCH_USER
prop.values.int32Values:
 [0]     = -108  // Request ID (must be negative)
 [1]     = 4     // SwitchUserMessageType::VEHICLE_REQUEST
 [2]     = 11    // target user id
}

תגובה מדור קודם של זרימת עבודה לאחר המעבר

תגובה זו מתרחשת בדרך כלל כאשר מתג אנדרואיד מצליח:

VehiclePropValue { // flattened from SwitchUserRequest
prop: 299896584 // SWITCH_USER
prop.values.int32Values:
 [0]     = -108  // Request ID (must match from vehicle request )
 [1]     = 5     // SwitchUserMessageType::ANDROID_POST_SWITCH
 [2,3]   = 11,0  // target user id (11) and flags (none in this case)
 [4,5]   = 11,0  // current user id (11) and flags (none in this case)
 [6]     = 3     // number of existing users (0, 10, 11)
 [7,8]   = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [9,10]  = 10,8  // existingUser[1] (id=10, flags=ADMIN)
 [11,12] = 11,0  // existingUser[2] (id=11, flags=NONE)
}

צור משתמש

בקשה לדוגמא

VehiclePropValue { // flattened from CreateUserRequest
prop: 299896585 // CREATE_USER
prop.values.int32Values:
 [0]      = 42  // Request ID
 [1,2]    = 11,6     // Android id of the created user and flags (id=11, flags=GUEST, EPHEMERAL)
 [3,4]    = 10,0  // current user id (10) and flags (none in this case)
 [5]      = 3  // number of existing users (0, 10, 11)
 [6,7]    = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [8,9]    = 10,8  // existingUser[1] (id=10, flags=ADMIN)
 [10,11] = 11,6 // newUser[2] (id=11, flags=GUEST,EPHEMERAL)
}

דוגמה לתגובה

VehiclePropValue { // flattened from CreateUserResponse
prop: 299896585 // CREATE_USER
prop.values.int32Values:
 [0] = 42        // Request ID (must match request)
 [1] = 3         // CreateUserStatus::SUCCESS
}

REMOVE_USER

בקשה לדוגמא

VehiclePropValue { // flattened from RemoveUserRequest
prop: 299896586 // REMOVE_USER
prop.values.int32Values:
 [0]      = 42  // Request ID
 [1,2]    = 11,0     // Android id of the removed user and flags (none in this case)
 [3,4]    = 10,0  // current user id (10) and flags (none in this case)
 [5]      = 2  // number of existing users (0, 10)
 [6,7]    = 0,1   // existingUser[0] (id=0, flags=SYSTEM)
 [8,9]    = 10,8  // existingUser[1] (id=10, flags=ADMIN)
}

USER_IDENTIFICATION_ASSOCIATION

הגדר דוגמה (שלט מפתח המשויך למשתמש 10)

VehiclePropValue { // flattened from UserIdentificationSetRequest
prop: 299896587 // USER_IDENTIFICATION_ASSOCIATION
prop.values.int32Values:
 [0]      = 43  // Request ID
 [1,2]    = 10,0     // Android id (10) and flags (none in this case)
 [3]    = 1  // number of associations being set
 [4]      = 1  // 1st type: UserIdentificationAssociationType::KEY_FOB
 [5]    = 1   // 1st value: UserIdentificationAssociationSetValue::ASSOCIATE_CURRENT_USER
}