Properti kendaraan ADAS

Kami telah menambahkan properti ADAS baru berikut ke Android 14:

• Pengereman darurat otomatis (AEB)
• Deteksi tangan di kemudi (HOD)
• Bantuan pemusatan jalur (LCA)
• Peringatan tabrakan depan (FCW)
• Peringatan titik buta (BSW)
• Peringatan keluar jalur (LDW)
• Bantuan penjagaan jalur (LKA)
• Bantuan penjagaan jalur darurat (ELKA)
• Kontrol penjelajahan standar (CC)
• Kontrol penjelajahan adaptif (ACC)

Kemampuan baru ini diilustrasikan dalam gambar berikut.

Gambar 1. Fitur ADAS yang didukung.

Daftar properti

Untuk mendukung fitur baru ini, daftar properti ditambahkan ke Android 14. Properti tersebut tercantum di bawah.

Properti
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_DISTANCE AUTOMATIC_EMERGENCY_BRAKING_ENABLED AUTOMATIC_EMERGENCY_BRAKING_STATE BLIND_SPOT_WARNING_ENABLED BLIND_SPOT_WARNING_STATE CRUISE_CONTROL_ENABLED CRUISE_CONTROL_TYPE CRUISE_CONTROL_STATE CRUISE_CONTROL_COMMAND CRUISE_CONTROL_TARGET_SPEED EMERGENCY_LANE_KEEP_ASSIST_ENABLED EMERGENCY_LANE_KEEP_ASSIST_STATE	FORWARD_COLLISION_WARNING_ENABLED FORWARD_COLLISION_WARNING_STATE HANDS_ON_DETECTION_ENABLED HANDS_ON_DETECTION_DRIVER_STATE HANDS_ON_DETECTION_WARNING LANE_DEPARTURE_WARNING_ENABLED LANE_DEPARTURE_WARNING_STATE LANE_KEEP_ASSIST_ENABLED LANE_KEEP_ASSIST_STATE LANE_CENTERING_ASSIST_ENABLED LANE_CENTERING_ASSIST_COMMAND LANE_CENTERING_ASSIST_STATE

Tema desain

Tema desain berikut diterapkan ke properti yang baru ditambahkan.

Properti	Deskripsi
DIAKTIFKAN	Properti untuk menunjukkan apakah fitur diaktifkan atau dinonaktifkan. Properti boolean yang true diaktifkan dan false dinonaktifkan. Read dan Write properti yang dapat diimplementasikan sebagai Read-only.
PROVINSI	Properti untuk mengomunikasikan status fitur melalui daftar status yang telah ditentukan. Properti Int32 dengan enum yang ditentukan. Kolom OTHER untuk mendukung kompatibilitas mundur. Properti Read-only. Jenis area Cermin atau Global. Menggunakan nilai yang ditentukan dalam ErrorStates.aidl. Menggunakan getSupportedEnumValues() API di AreaIdConfig.java.
Lain-lain	Properti COMMAND untuk fitur saat input pengguna diperlukan. Properti WARNING untuk saat status dapat direpresentasikan secara terpisah. Properti lain untuk mendukung: Variasi fitur jika berlaku. Menyesuaikan setelan fitur jika berlaku.

Contoh diagram status

Bagian ini menyediakan diagram status untuk subset fitur ADAS yang didukung untuk menunjukkan cara properti yang disertakan bekerja sama. Kami telah memberikan contoh fitur berikut.

• Pengereman darurat otomatis (AEB)
• Bantuan pemusatan jalur (LCA)
• Deteksi tangan di kemudi (HOD)

Pengereman darurat otomatis

Dua properti ditentukan untuk AEB seperti yang dijelaskan dalam tabel ini.

Properti	Nilai
AUTOMATIC_EMERGENCY_BRAKING_ENABLED	VehiclePropertyType:BOOLEAN
AUTOMATIC_EMERGENCY_BRAKING_STATE Ditentukan dalam AutomaticEmergencyBrakingState.aidl.	VehiclePropertyType:INT32 OTHER ENABLED ACTIVATED USER_OVERRIDE ErrorState

Diagram status contoh berikut untuk AEB mencakup status yang didukung yang ditentukan dalam AutomaticEmergencyBrakingState.aidl.

Gambar 2. Status AEB yang ditentukan dalam AutomaticEmergencyBrakingState.aidl.

Gambar ini memberikan contoh AEB saat status USER_OVERRIDE tidak didukung. Status yang didukung harus ditentukan melalui getSupportedEnumValues() API di AreaIdConfig.java.

Gambar 3. AEB saat status USER_OVERRIDE tidak didukung.

Dalam contoh AEB yang diilustrasikan dalam Gambar 4, error yang menyebabkan AEB tidak tersedia ditandai. Hal ini menunjukkan cara nilai yang ditentukan dalam ErrorState.aidl harus digunakan. Error ini tidak menghasilkan pengecualian yang ditampilkan oleh CarPropertyManager dan malah dibagikan ke aplikasi dengan cara yang sama seperti perubahan lainnya pada CarPropertyValue.

Gambar 4. Error menyebabkan AEB tidak tersedia.

Bantuan pemusatan jalur

Bantuan pemusatan jalur (LCA) menyediakan tiga properti terkait dan yang ditentukan.

Properti	Nilai
LANE_CENTERING_ASSIST_ENABLED	VehiclePropertyType:BOOLEAN
LANE_CENTERING_ASSIST_STATE Ditentukan dalam LaneCenteringAssistState.aidl	VehiclePropertyType:INT32 OTHER ENABLED ACTIVATION_REQUESTED ACTIVATED USER_OVERRIDE FORCED_DEACTIVATION_WARNING ErrorState
LANE_CENTERING_ASSIST_COMMAND Ditentukan dalam LaneCenteringAssistCommand.aidl	VehiclePropertyType:INT32 ACTIVATE DEACTIVATE

Diagram status berikut mengilustrasikan LCA saat semua status yang ditentukan dalam LaneCenteringAssistState.aidl didukung. Garis hijau dapat berupa perintah yang dimulai dari LANE_CENTERING_ASSIST_COMMAND (saat diimplementasikan) atau dimulai melalui mekanisme lain di kendaraan dan mencerminkan perubahan status di Android Automotive OS (AAOS).

Gambar 5. Status LCA yang ditentukan dalam LaneCenteringAssistState.aidl.

Contoh LCA ini menandai error yang menyebabkan LCA tidak tersedia. Hal ini menunjukkan cara menggunakan nilai yang ditentukan dalam ErrorState.aidl. Error ini tidak menyebabkan CarPropertyManager menampilkan error dan malah dibagikan ke aplikasi dengan cara yang sama seperti perubahan lainnya pada CarPropertyValue dibagikan.

Gambar 6. Error menyebabkan LCA tidak tersedia.

Deteksi tangan di kemudi

Ketiga properti terkait ini ditentukan untuk deteksi tangan di kemudi (HOD).

Properti	Deskripsi
HANDS_ON_DETECTION_ENABLED	VehiclePropertyType:BOOLEAN
HANDS_ON_DETECTION_STATE Ditentukan dalam HandsOnDetectionDriverState.aidl	VehiclePropertyType:INT32 OTHER HANDS_ON HANDS_OFF ErrorState
HANDS_ON_DETECTION_WARNING Ditentukan dalam HandsOnDetectionWarning.aidl	VehiclePropertyType:INT32 OTHER NO_WARNING WARNING ErrorState

Diilustrasikan di bawah adalah contoh HOD, yang semua status yang ditentukan dalam HandsOnDetectionDriverState.aidl didukung.

Gambar 7. HOD saat semua status yang ditentukan dalam HandsOnDetectionDriverState.aidl didukung.

Selain properti HANDS_ON_DETECTION_STATE, HOD juga menyediakan properti peringatan terpisah, HANDS_ON_DETECTION_WARNING. Diagram status untuk nilai peringatan HOD diilustrasikan dalam Gambar 8.

Gambar 8. HOD saat semua nilai yang ditentukan dalam HandsOnDetectionWarning.aidl didukung.