Properti kendaraan ADAS

Kami telah menambahkan properti ADAS baru berikut ke Android 14:

• Pengereman darurat otomatis (AEB)
• Deteksi sentuhan tangan (HOD)
• Bantuan menjaga posisi di tengah jalur (LCA)
• Peringatan tabrakan depan (FCW)
• Peringatan titik buta (BSW)
• Peringatan keluar jalur (LDW)
• Bantuan penjaga jalur (LKA)
• Bantuan menjaga jalur darurat (ELKA)
• Kontrol jelajah standar (CC)
• Adaptive cruise control (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. Berikut daftarnya.

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

Mendesain tema

Tema desain berikut diterapkan ke properti yang baru ditambahkan.

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

Contoh diagram status

Bagian ini menyediakan diagram status untuk sebagian kecil fitur ADAS yang didukung untuk menunjukkan cara kerja properti yang disertakan bersama-sama. Kami telah memberikan contoh fitur berikut.

• Pengereman darurat otomatis (AEB)
• Bantuan menjaga posisi di tengah jalur (LCA)
• Deteksi sentuhan (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 API getSupportedEnumValues() di AreaIdConfig.java.

Gambar 3. AEB saat status USER_OVERRIDE tidak didukung.

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

Gambar 4. Error menyebabkan AEB tidak tersedia.

Bantuan menjaga posisi di tengah jalur

Bantuan menjaga posisi di 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 menggambarkan LCA saat semua status yang ditentukan dalam LaneCenteringAssistState.aidl didukung. Garis hijau dapat berupa perintah yang dimulai dari LANE_CENTERING_ASSIST_COMMAND (jika diterapkan) 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 menyoroti error yang menyebabkan LCA tidak tersedia. Contoh ini menunjukkan cara menggunakan nilai yang ditentukan dalam ErrorState.aidl. Error ini tidak menyebabkan CarPropertyManager menampilkan error dan sebaliknya dibagikan ke aplikasi dengan cara yang sama seperti perubahan lain pada CarPropertyValue dibagikan.

Gambar 6. Error menyebabkan LCA tidak tersedia.

Deteksi saat digunakan

Tiga properti terkait ini ditentukan untuk deteksi saat perangkat dipegang (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

Di bawah ini adalah contoh HOD, yang mendukung semua status yang ditentukan di HandsOnDetectionDriverState.aidl.

Gambar 7. HOD saat semua status yang ditentukan di 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 di HandsOnDetectionWarning.aidl didukung.