Properti kendaraan ADAS

Kami telah menambahkan properti ADAS baru berikut ke Android 14:

Kemampuan baru ini diilustrasikan pada gambar berikut.

Fitur ADAS yang didukung

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 pada properti yang baru ditambahkan.

Properti Keterangan
DIAKTIFKAN
  • Properti untuk menunjukkan apakah suatu fitur diaktifkan atau dinonaktifkan.
  • Properti Boolean yang true diaktifkan dan false dinonaktifkan.
  • Properti Read dan Write yang dapat diimplementasikan sebagai Read-only .
NEGARA
  • Properti untuk mengomunikasikan status fitur melalui daftar status yang telah ditentukan sebelumnya.
  • Properti Int32 dengan enum yang ditentukan.
  • Bidang OTHER untuk mendukung kompatibilitas ke belakang.
  • Properti Read-only .
  • Tipe area Cermin atau Global.
  • Menggunakan nilai yang ditentukan dalam ErrorStates.aidl .
  • Gunakan API getSupportedEnumValues() di AreaIdConfig.java .
Aneka ragam
  • Properti COMMAND untuk fitur ketika input pengguna diperlukan.
  • Properti WARNING ketika keadaan dapat direpresentasikan secara terpisah.
  • Properti lain yang perlu didukung:
    • Variasi fitur bila berlaku.
    • Sesuaikan pengaturan fitur bila memungkinkan.

Contoh diagram keadaan

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

  • Pengereman darurat otomatis (AEB)
  • Bantuan pemusatan jalur (LCA)
  • Deteksi langsung (HOD)

Pengereman darurat otomatis

Dua properti ditentukan untuk AEB seperti dijelaskan dalam tabel ini.

Properti Nilai-nilai
AUTOMATIC_EMERGENCY_BRAKING_ENABLED VehiclePropertyType:BOOLEAN

AUTOMATIC_EMERGENCY_BRAKING_STATE

Didefinisikan dalam AutomaticEmergencyBrakingState.aidl .

VehiclePropertyType:INT32

  • OTHER
  • ENABLED
  • ACTIVATED
  • USER_OVERRIDE
  • ErrorState

    • Contoh diagram status untuk AEB berikut mencakup status yang didukung yang ditentukan dalam AutomaticEmergencyBrakingState.aidl .

    Status AEB ditentukan di AutomaticEmergencyBrakingState.aidl

    Gambar 2. Status AEB ditentukan di AutomaticEmergencyBrakingState.aidl.

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

    AEB ketika status penggantian pengguna tidak didukung

    Gambar 3. AEB ketika status USER_OVERRIDE tidak didukung.

    Dalam contoh AEB yang diilustrasikan pada Gambar 4, kesalahan yang menyebabkan AEB menjadi tidak tersedia disorot. Ini menunjukkan bagaimana nilai yang ditentukan dalam ErrorState.aidl harus digunakan. Kesalahan ini tidak menghasilkan pengecualian yang diberikan oleh CarPropertyManager dan malah dibagikan ke aplikasi dengan cara yang sama seperti perubahan lainnya pada CarPropertyValue .

    Kesalahan menyebabkan AEB menjadi tidak tersedia

    Gambar 4. Kesalahan menyebabkan AEB tidak tersedia.

    Bantuan pemusatan jalur

    Lane centering assist (LCA) menyediakan tiga properti yang terkait dan ditentukan.

    Properti Nilai-nilai
    LANE_CENTERING_ASSIST_ENABLED VehiclePropertyType:BOOLEAN

    LANE_CENTERING_ASSIST_STATE

    Didefinisikan di LaneCenteringAssistState.aidl

    VehiclePropertyType:INT32

    • OTHER
    • ENABLED
    • ACTIVATION_REQUESTED
    • ACTIVATED
    • USER_OVERRIDE
    • FORCED_DEACTIVATION_WARNING
    • ErrorState

    LANE_CENTERING_ASSIST_COMMAND

    Didefinisikan di LaneCenteringAssistCommand.aidl

    VehiclePropertyType:INT32

    • ACTIVATE
    • DEACTIVATE

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

    Status LCA ditentukan di LaneCenteringAssistState.aidl

    Gambar 5. Status LCA ditentukan di LaneCenteringAssistState.aidl.

    Contoh LCA ini menyoroti kesalahan yang menyebabkan LCA menjadi tidak tersedia. Ini menunjukkan cara menggunakan nilai yang ditentukan dalam ErrorState.aidl . Kesalahan ini tidak menyebabkan CarPropertyManager melakukan kesalahan dan malah dibagikan dengan aplikasi dengan cara yang sama seperti perubahan lain pada perubahan CarPropertyValue dibagikan.

    Kesalahan menyebabkan LCA menjadi tidak tersedia.

    Gambar 6. Error menyebabkan LCA menjadi tidak tersedia.

    Deteksi langsung

    Ketiga properti terkait ini ditentukan untuk deteksi langsung (HOD).

    Properti Keterangan
    HANDS_ON_DETECTION_ENABLED VehiclePropertyType:BOOLEAN

    HANDS_ON_DETECTION_STATE

    Didefinisikan di HandsOnDetectionDriverState.aidl

    VehiclePropertyType:INT32

    • OTHER
    • HANDS_ON
    • HANDS_OFF
    • ErrorState

    HANDS_ON_DETECTION_WARNING

    Didefinisikan di HandsOnDetectionWarning.aidl

    VehiclePropertyType:INT32

    • OTHER
    • NO_WARNING
    • WARNING
    • ErrorState

    Ilustrasi di bawah ini adalah contoh HOD, yang mendukung semua status yang ditetapkan di HandsOnDetectionDriverState.aidl .

    HOD ketika semua status yang ditentukan di HandsOnDetectionDriverState.aidl didukung.

    Gambar 7. HOD ketika 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 nilai peringatan HOD diilustrasikan pada Gambar 8.

    Nilai peringatan HOD

    Gambar 8. HOD ketika semua nilai yang ditentukan di HandsOnDetectionWarning.aidl didukung.