Properti kendaraan ADAS

Kami telah menambahkan properti ADAS baru berikut ke Android 14:

Kemampuan baru ini diilustrasikan dalam gambar berikut.

Fitur ADAS yang didukung

Gambar 1. Fitur ADAS yang didukung.

Daftar properti

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

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.
  • Properti Read dan Write yang dapat diterapkan sebagai Read-only.
STATE
  • Properti untuk mengomunikasikan status fitur melalui daftar status yang telah ditentukan.
  • Properti Int32 dengan enum yang ditentukan.
  • Kolom OTHER untuk mendukung kompatibilitas mundur.
  • Read-only properti.
  • Jenis area Mirror atau Global.
  • Menggunakan nilai yang ditentukan dalam ErrorStates.aidl.
  • Gunakan 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 yang akan didukung:
    • Variasi fitur jika berlaku.
    • Sesuaikan setelan fitur jika berlaku.

Contoh diagram status

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

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

Rem 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
  • Contoh diagram status berikut untuk AEB mencakup status yang didukung yang ditentukan di AutomaticEmergencyBrakingState.aidl.

    Status AEB 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.

    AEB saat status penggantian pengguna tidak didukung

    Gambar 3. AEB saat status USER_OVERRIDE tidak didukung.

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

    Error menyebabkan AEB tidak tersedia

    Gambar 4. Error menyebabkan AEB tidak tersedia.

    Bantuan pemusatan jalur

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

    Properti Nilai
    LANE_CENTERING_ASSIST_ENABLED VehiclePropertyType:BOOLEAN

    LANE_CENTERING_ASSIST_STATE

    Ditentukan di LaneCenteringAssistState.aidl

    VehiclePropertyType:INT32

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

    LANE_CENTERING_ASSIST_COMMAND

    Ditentukan di LaneCenteringAssistCommand.aidl

    VehiclePropertyType:INT32

    • ACTIVATE
    • DEACTIVATE

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

    Status LCA yang ditentukan di LaneCenteringAssistState.aidl

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

    Contoh LCA ini menyoroti 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 sebagai gantinya dibagikan ke aplikasi dengan cara yang sama seperti perubahan lain pada perubahan CarPropertyValue.

     Error menyebabkan LCA tidak tersedia.

    Gambar 6. Error menyebabkan LCA tidak tersedia.

    Deteksi penggunaan

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

    Properti Deskripsi
    HANDS_ON_DETECTION_ENABLED VehiclePropertyType:BOOLEAN

    HANDS_ON_DETECTION_STATE

    Ditentukan di HandsOnDetectionDriverState.aidl

    VehiclePropertyType:INT32

    • OTHER
    • HANDS_ON
    • HANDS_OFF
    • ErrorState

    HANDS_ON_DETECTION_WARNING

    Ditentukan di HandsOnDetectionWarning.aidl

    VehiclePropertyType:INT32

    • OTHER
    • NO_WARNING
    • WARNING
    • ErrorState

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

    HOD jika semua status yang ditentukan di HandsOnDeteksiionDriverState.aidl didukung.

    Gambar 7. HOD jika 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 pada Gambar 8.

    Nilai peringatan HOD

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