คุณสมบัติผู้ใช้ HAL

สถาปัตยกรรมรถยนต์ในปัจจุบันจำนวนมากมีชุดควบคุมอิเล็กทรอนิกส์ (ECU) หลายชุดที่อยู่นอกระบบสาระบันเทิงที่ควบคุมการยศาสตร์ เช่น การตั้งค่าเบาะนั่งและการปรับกระจก ขึ้นอยู่กับสถาปัตยกรรมฮาร์ดแวร์และพลังงานในปัจจุบัน ECU จำนวนมากทำงานก่อนที่ระบบสาระบันเทิงที่ใช้ Android จะถูกเปิดใช้งาน ECU เหล่านี้สามารถเชื่อมต่อกับระบบสาระบันเทิงบน Android ผ่าน Vehicle Hardware Abstraction Layer (VHAL)

เริ่มต้นใน Android 11 Android Automotive OS (AAOS) ได้แนะนำคุณสมบัติชุดใหม่บน VHAL สำหรับการสร้าง การสลับ การถอด และการเชื่อมโยงอุปกรณ์เสริมภายนอกเพื่อระบุผู้ใช้ ตัวอย่างเช่น คุณสมบัติใหม่เหล่านี้ช่วยให้ไดรเวอร์ จับคู่ อุปกรณ์เสริมภายนอก เช่น พวงกุญแจ กับผู้ใช้ Android ได้ จากนั้น เมื่อคนขับเข้าใกล้รถ ECU จะตื่นขึ้นและตรวจพบกุญแจกล ECU นี้ระบุ HAL ว่าผู้ใช้ Android รายใดที่ระบบสาระบันเทิงควรเริ่มต้นการบูต ซึ่งจะช่วยลดเวลาที่ไดรเวอร์รอให้ผู้ใช้ Android ของตนโหลด

เปิดใช้งานผู้ใช้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 สำหรับสถานะวงจรชีวิตของผู้ใช้ ซึ่งเปิดใช้งานการซิงโครไนซ์วงจรชีวิตผู้ใช้ระหว่างระบบ Android และ ECU ภายนอก คุณสมบัติเหล่านี้ใช้โปรโตคอลคำขอและการตอบสนอง ซึ่งระบบ Android จะส่งคำขอโดยการตั้งค่าคุณสมบัติและ HAL ตอบสนองโดยการออกเหตุการณ์การเปลี่ยนแปลงคุณสมบัติ

หมายเหตุ: เมื่อรองรับ User HAL จะต้องใช้งานคุณสมบัติต่อไปนี้ ทั้งหมด

คุณสมบัติเพิ่มเติม

ต่อไปนี้เป็นพร็อพเพอร์ตี้เพิ่มเติม ซึ่งไม่เกี่ยวข้องกับสถานะของวงจรชีวิตของผู้ใช้ แต่ละรายการสามารถนำไปใช้ได้โดยไม่สนับสนุน 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
}

ตัวอย่างการตอบสนองหลังสวิตช์เวิร์กโฟลว์สมัยใหม่

การตอบสนองนี้มักเกิดขึ้นเมื่อสวิตช์ Android ทำงานสำเร็จ:

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

การตอบสนองหลังสวิตช์เวิร์กโฟลว์สมัยใหม่

การตอบสนองนี้มักเกิดขึ้นเมื่อสวิตช์ Android ล้มเหลว:

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
}

การตอบสนองหลังสวิตช์เวิร์กโฟลว์ดั้งเดิม

การตอบสนองนี้มักเกิดขึ้นเมื่อสวิตช์ Android ทำงานสำเร็จ:

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

CREATE_USER

ขอตัวอย่าง

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

ตั้งค่าตัวอย่าง (คีย์ fob ที่เกี่ยวข้องกับผู้ใช้ 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
}