Halaman ini mencantumkan properti sistem yang didukung di VHAL. Properti yang didukung oleh VHAL
harus berupa properti sistem dari daftar di bawah atau properti vendor. Di Android 14 dan
yang lebih tinggi, definisi properti ditentukan di
hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
.
Definisi properti ditentukan di antarmuka AIDL,
android.hardware.automotive.vehicle.property
, yang terpisah dari antarmuka
VHAL (android.hardware.automotive.vehicle
). Implementasi VHAL dan klien
VHAL harus bergantung pada kedua antarmuka.
Mode akses dan mode perubahan yang dibuat secara otomatis
Di Android 14 dan yang lebih tinggi, untuk mendukung implementasi VHAL, kami menyediakan file header C++ dan file class Java yang dibuat secara otomatis dengan mode perubahan atau mode akses yang diizinkan untuk properti sistem. Implementasi VHAL vendor dapat menggunakannya untuk memastikan konfigurasi properti memenuhi spesifikasi.
A ke D
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
Jarak yang diukur dari kendaraan di depan saat menggunakan Adaptive Cruise Control (ACC) atau Predictive
Cruise Control (PCC). Menampilkan jarak yang diukur dalam milimeter antara titik paling belakang
kendaraan terdepan dan titik paling depan kendaraan ACC. maxInt32Value
dan minInt32Value
di VehicleAreaConfig
harus ditentukan. minInt32Value
harus 0. maxInt32Value
harus diisi dengan
rentang maksimum yang dapat didukung sensor jarak. Nilai ini harus positif.
Jika tidak ada kendaraan utama yang terdeteksi (yaitu, jika tidak ada kendaraan utama atau kendaraan utama terlalu jauh sehingga tidak dapat terdeteksi oleh sensor), properti ini akan menampilkan StatusCode.NOT_AVAILABLE
Jika properti ini tidak tersedia karena CC dinonaktifkan (misalnya,
StatusCode#NOT_AVAILABLE_DISABLED
bernilai salah), properti ini harus menampilkan
StatusCode#NOT_AVAILABLE_DISABLED
. Jika CRUISE_CONTROL_STATE
diterapkan dan status ditetapkan ke nilai ErrorState
, properti ini
harus menampilkan StatusCode
yang selaras dengan nilai ErrorState
. Misalnya, jika CRUISE_CONTROL_STATE
ditetapkan ke
ErrorState#NOT_AVAILABLE_SPEED_LOW
, properti ini harus menampilkan
StatusCode#NOT_AVAILABLE_SPEED_LOW
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLIMETER
Rilis: Android 14
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
Jeda waktu target saat ini untuk ACC atau PCC dalam milidetik. Properti ini harus menentukan target selisih waktu ke kendaraan terdepan. Jeda ini didefinisikan sebagai waktu untuk menempuh jarak antara titik paling belakang kendaraan terdepan ke titik paling depan kendaraan ACC. Jeda waktu yang sebenarnya dari kendaraan terdepan dapat berada di atas atau di bawah nilai ini.
Nilai yang mungkin ditetapkan untuk selang waktu target harus ditentukan dalam configArray dalam
urutan menaik. Semua nilai harus positif. Jika properti dapat ditulis, semua nilai harus
dapat ditulis. Jika properti ini tidak tersedia karena CC dinonaktifkan (misalnya,
CRUISE_CONTROL_ENABLED
salah), properti ini harus menampilkan
StatusCode#NOT_AVAILABLE_DISABLED
Jika CRUISE_CONTROL_STATE
diterapkan dan status ditetapkan ke
nilai ErrorState
, properti ini harus menampilkan StatusCode
yang
selaras dengan nilai ErrorState
. Misalnya,
jika CRUISE_CONTROL_STATE
ditetapkan ke ErrorState#NOT_AVAILABLE_SPEED_LOW
,
properti ini harus menampilkan StatusCode#NOT_AVAILABLE_SPEED_LOW
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLI_SECS
Rilis: Android 14
ABS_ACTIVE
Sistem rem otomatis (ABS) aktif. Tetapkan ke benar (true) saat ABS aktif dan reset ke salah (false) saat ABS nonaktif. Properti ini dapat disetel secara berkala (pulsa) berdasarkan status real-time sistem ABS.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
ANDROID_EPOCH_TIME
Tanggal dan waktu saat ini, dienkode sebagai waktu Epoch (dalam milidetik). Nilai ini menunjukkan jumlah detik milidetik yang telah berlalu sejak 1/1/1970 UTC.
Nilai ini menunjukkan jumlah detik milidetik yang telah berlalu sejak 1/1/1970 UTC.
WRITE
CarServices ke nilai ini untuk memberi VHAL waktu sistem Android, jika VHAL
mendukung properti ini. Hal ini dapat berguna untuk menyinkronkan sistem kendaraan lainnya (jam dasbor) dengan
waktu Android.
AAOS WRITE
ke properti ini sekali selama booting, dan setelahnya WRITE
hanya saat perubahan sumber waktu disebarkan. AAOS akan mengisi VehiclePropValue.timestamp
dengan benar. AAOS tidak mengirim update untuk berlalunya waktu secara alami. int64Values[0] = waktu Unix
yang diberikan (dalam milidetik).
Properti mungkin memerlukan waktu lebih dari 0 md untuk disebarkan melalui stack dan, memiliki properti dengan stempel waktu akan membantu mengurangi drift waktu. Jadi, untuk semua WRITE
ke properti,
stempel waktu dapat digunakan untuk meniadakan drift ini:
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLI_SECS
Rilis: Android 13
AP_POWER_BOOTUP_REASON
Properti untuk melaporkan alasan booting untuk pengaktifan daya saat ini. Ini adalah properti STATIC
yang tidak akan berubah selama durasi hingga daya mati. Misalnya, meskipun pengguna menekan
tombol daya setelah daya otomatis aktif dengan kunci pintu terbuka, alasan booting harus tetap dengan
VehicleApPowerBootupReason#USER_UNLOCK
int32Values[0]
harus
VehicleApPowerBootupReason
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
AP_POWER_STATE_REPORT
Properti untuk melaporkan status daya pemroses aplikasi. Diasumsikan bahwa status daya AP dikontrol oleh pengontrol daya terpisah.
int32Values[0]
Nilai enum VehicleApPowerStateReportint32Values[1]
Waktu dalam md untuk bangun, jika diperlukan (jika tidak, 0)
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
AP_POWER_STATE_REQ
Properti untuk mengontrol status daya pemroses aplikasi. Diasumsikan bahwa status daya AP
dikontrol oleh pengontrol daya terpisah. Untuk informasi konfigurasi,
VehiclePropConfig.configArray
harus memiliki flag bit yang menggabungkan nilai di
VehicleApPowerStateConfigFlag
int32Values[0]
Nilai enum VehicleApPowerStateReqint32Values[1]
Parameter tambahan yang relevan untuk setiap status, 0 jika tidak digunakan.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
AUTOMATIC_EMERGENCY_BRAKING_ENABLED
Aktifkan atau nonaktifkan Rem Darurat Otomatis (AEB).
Tetapkan ke true untuk mengaktifkan AEB dan false untuk menonaktifkan AEB. Jika AEB diaktifkan, sistem ADAS di
kendaraan harus diaktifkan dan dipantau untuk menghindari potensi tabrakan. Properti ini hanya
berlaku untuk aplikasi dengan kecepatan lebih tinggi. Untuk mengaktifkan pengereman darurat otomatis kecepatan rendah,
LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
harus digunakan.
Secara umum, AUTOMATIC_EMERGENCY_BRAKING_ENABLED
harus selalu menampilkan true atau false.
Jika fitur tidak tersedia karena beberapa status sementara, seperti kecepatan kendaraan terlalu
rendah, informasi tersebut harus disampaikan melalui nilai ErrorState
di
properti AUTOMATIC_EMERGENCY_BRAKING_STATE
.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
AUTOMATIC_EMERGENCY_BRAKING_STATE
Status Automatic Emergency Braking (AEB). Menampilkan status AEB saat ini. Properti ini harus
selalu menampilkan status yang valid yang ditentukan di AutomaticEmergencyBrakingState atau ErrorState
Properti ini tidak boleh menampilkan error melalui StatusCode
dan harus menggunakan status error yang didukung
sebagai gantinya. Properti ini hanya berlaku untuk aplikasi dengan kecepatan lebih tinggi. Untuk merepresentasikan status
sistem pengereman darurat otomatis kecepatan rendah,
LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE
harus digunakan.
Jika AEB menyertakan peringatan tabrakan depan sebelum mengaktifkan rem, peringatan tersebut harus ditampilkan melalui properti Peringatan Tabrakan Depan (FCW).
Untuk ID area global (0), array StatusCode#VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status AutomaticEmergencyBrakingState
(termasuk OTHER
, yang tidak direkomendasikan) dan ErrorState
didukung.
Change mode: ON_CHANGE
Access mode: READ
Enun type: ForwardCollisionWarningState/ErrorState
Unit type: T/A
Release: Android 14
BLIND_SPOT_WARNING_ENABLED
Mengaktifkan dan menonaktifkan Peringatan Blind Spot (BSW). Tetapkan ke true untuk mengaktifkan BSW dan false untuk menonaktifkan BSW. Jika BSW diaktifkan, sistem ADAS di kendaraan harus diaktifkan dan memantau objek di blind spot kendaraan.
Secara umum, BLIND_SPOT_WARNING_ENABLED
harus selalu menampilkan true atau false. Jika
fitur tidak tersedia karena beberapa status sementara, seperti kecepatan kendaraan yang terlalu rendah,
informasi tersebut harus disampaikan melalui nilai ErrorState
di
properti BLIND_SPOT_WARNING_STATE
.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
,
tetapi OEM hanya dapat menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
BLIND_SPOT_WARNING_STATE
Status Peringatan Blind Spot (BSW). Menampilkan status BSW saat ini. Properti ini harus selalu
menampilkan status yang valid yang ditentukan dalam BlindSpotWarningState
atau ErrorState
Properti ini tidak boleh menampilkan error melalui StatusCode
dan harus menggunakan status error yang didukung
sebagai gantinya.
Untuk setiap ID area yang didukung, array StatusCode#VehicleAreaConfig#supportedEnumValues
harus ditentukan, kecuali jika semua status BlindSpotWarningState
(termasuk OTHER
, yang tidak direkomendasikan) dan ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: BlindSpotWarningState/ErrorState
Jenis unit: T/A
Rilis: Android 14
CABIN_LIGHTS_STATE
Menampilkan status untuk lampu kabin.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
CABIN_LIGHTS_SWITCH
Tombol lampu kabin. Posisi tombol fisik yang mengontrol lampu kabin.
Hal ini mungkin berbeda dengan CABIN_LIGHTS_STATE
jika lampu menyala karena pintu
terbuka atau karena perintah suara. Misalnya, saat tombol berada dalam posisi nonaktif atau
otomatis.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
CLUSTER_DISPLAY_STATE
Mengubah status tampilan cluster.
- Batas: Area untuk merender Aktivitas cluster.
- Inset: Area yang tidak boleh menempatkan informasi penting oleh Aktivitas.
Nilai yang mungkin:
int32[0]
Aktif, Nonaktif: 0 - nonaktif, 1 - aktif, -1 - tidak peduliint32[1]
Batas - kiri: angka positif - posisi kiri dalam piksel -1 - tidak peduli (harus menetapkan semua kolom Batas)int32[2]
Batas - atas: format yang sama dengan 'kiri'int32[3]
Batas - kanan: format yang sama dengan 'kiri'int32[4]
Batas - bawah: format yang sama dengan 'kiri'int32[5]
Inset - left: positive number - actual left inset value in pixels -1 - don't care (should set "don't care" all Inset fields)int32[6]
Inset - atas: format yang sama dengan 'kiri'int32[7]
Inset - kanan: format yang sama dengan 'kiri'int32[8]
Inset - bottom: format yang sama dengan 'left'
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
CLUSTER_NAVIGATION_STATE
Memberi tahu status navigasi saat ini. byte: pesan serialisasi NavigationStateProto.
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum:
Jenis unit: T/A
Rilis: Android 13
CLUSTER_REPORT_STATE
Melaporkan status tampilan dan status ClusterUI saat ini.
ClusterHome
mengirim pesan ini saat menangani CLUSTER_SWITCH_UI
,
CLUSTER_DISPLAY_STATE
Selain itu, ClusterHome
harus mengirim pesan
ini saat dimulai untuk pertama kalinya. Saat ClusterOS menerima pesan ini dan jika
ekspektasi internal berbeda dengan pesan yang diterima, ClusterOS harus mengirim
CLUSTER_SWITCH_UI
, CLUSTER_DISPLAY_STATE
lagi agar cocok dengan status.
int32[0]
aktif/nonaktif: 0 - nonaktif, 1 - aktifint32[1]
Batas - kiriint32[2]
Batas - atasint32[3]
Batas - kananint32[4]
Batas - bawahint32[5]
Inset - kiriint32[6]
Inset - atasint32[7]
Inset - kananint32[8]
Inset - bawahint32[9]
Jenis ClusterUI di layar utama atau layar penuh. 0 menunjukkanClusterHome
. Nilai lainnya diikuti dengan definisi OEM.int32[10]
Jenis ClusterUI di sublayar jika saat ini dua UI ditampilkan. -1 menunjukkan bahwa area tidak lagi digunakan. byte: array untuk merepresentasikan ketersediaan ClusterUI. 0 menunjukkan tidak tersedia dan 1 menunjukkan tersedia. Misalnya, jika mobil mendukung tiga ClusterUI yang ditentukan OEM seperti HOME, MAPS, dan CALL dan hanya mendukung UI CALL hanya jika jaringan seluler tersedia. Kemudian, jika jaringan tersedia, jaringan tersebut akan mengirim [1 1 1] dan, jika tidak ada jaringan, akan mengirim [1 1 0].
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
CLUSTER_REQUEST_DISPLAY
Permintaan untuk mengubah status tampilan cluster guna menampilkan beberapa ClusterUI. Jika status tampilan saat ini
nonaktif dan ClusterHome
mengirim pesan ini ke ClusterOS untuk meminta agar
layar diaktifkan untuk menampilkan ClusterUI tertentu. ClusterOS akan meresponsnya dengan
CLUSTER_DISPLAY_STATE
int32
Jenis ClusterUI yang akan ditampilkan
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
CLUSTER_SWITCH_UI
Memulai ClusterUI di tampilan cluster.
int32
Jenis ClusterUI untuk menampilkan 0 menunjukkanClusterHome
, layar Beranda tampilan cluster, dan menyediakan UI default serta jenis fungsi peluncur untuk tampilan cluster. Nilai lainnya sesuai dengan definisi OEM.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
CREATE_USER
Dipanggil oleh Sistem Android setelah pengguna Android dibuat. HAL dapat menggunakan properti ini untuk membuat pengguna yang setara. Ini adalah permintaan asinkron: Android membuat permintaan dengan menetapkan VehiclePropValue, dan HAL harus merespons dengan perubahan properti yang menunjukkan apakah permintaan berhasil atau gagal. Jika gagal, sistem Android akan menghapus pengguna.
Format permintaan ditentukan oleh CreateUserRequest dan format respons ditentukan oleh CreateUserResponse. Misalnya, jika sistem memiliki dua pengguna (0 dan 10) dan pengguna ketiga (yang merupakan tamu sementara) dibuat, permintaannya akan menjadi:
int32[0]
42 // request idint32[1]
11 // ID Android pengguna yang dibuatint32[2]
6 // Flag Android (tamu sementara) dari pengguna yang dibuatint32[3]
10 // pengguna saat iniint32[4]
0 // flag pengguna saat ini (tidak ada)int32[5]
3 // jumlah penggunaint32[6]
0 // pengguna pertama (pengguna 0)int32[7]
0 // flag pengguna pertama (tidak ada)int32[8]
10 // pengguna kedua (pengguna 10)int32[9]
0 // tanda pengguna kedua (tidak ada)int32[10]
11 // pengguna ketiga (pengguna 11)int32[11]
6 // string flag pengguna ketiga (tamu sementara): "ElGuesto" // nama pengguna baru
Jika permintaan berhasil, HAL akan menampilkan:
int32[0]
42 // request idint32[1]
1 // CreateUserStatus::SUCCESS
Namun, jika gagal:
int32[0]
42 // request idint32[1]
2 // String CreateUserStatus::FAILURE: "D'OH!" //
Artinya adalah blackbox dan diteruskan ke pemanggil (seperti UI Setelan), yang mengambil tindakan yang tepat.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
CRITICALLY_LOW_TIRE_PRESSURE
Properti ini menunjukkan nilai minimum tekanan yang sangat rendah untuk setiap ban. Indikator ini menunjukkan waktu untuk mengganti atau memperbaiki ban. Nilai harus kurang dari atau sama dengan minFloatValue di TIRE_PRESSURE. Nilai properti minimum dan maksimum (minFloatValue dan maxFloatValue) tidak berlaku untuk properti ini.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:KILOPASCAL
Rilis: Android 13
CRUISE_CONTROL_COMMAND
WRITE
Perintah Kontrol Kecepatan (CC).
Lihat CruiseControlCommand untuk mengetahui detail tentang setiap perintah yang didukung. Untuk ID area global (0),
array StatusCode#VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua
status CruiseControlState
didukung. Setiap perintah yang tidak didukung yang dikirim melalui
properti ini harus menampilkan StatusCode#INVALID_ARG
Jika properti ini tidak tersedia
karena CC dinonaktifkan (misalnya, CRUISE_CONTROL_ENABLED
bernilai salah), properti ini
harus menampilkan StatusCode#NOT_AVAILABLE_DISABLED
Jika CRUISE_CONTROL_STATE
diterapkan dan status ditetapkan ke nilai ErrorState
, properti
ini harus menampilkan StatusCode
yang selaras dengan nilai ErrorState
.
Misalnya, jika CRUISE_CONTROL_STATE
ditetapkan ke
ErrorState#NOT_AVAILABLE_SPEED_LOW
, properti ini harus menampilkan
StatusCode#NOT_AVAILABLE_SPEED_LOW
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: CruiseControlCommand
Jenis unit: T/A
Rilis: Android 14
CRUISE_CONTROL_ENABLED
Mengaktifkan atau menonaktifkan cruise control (CC). Tetapkan ke true untuk mengaktifkan CC dan false untuk menonaktifkan CC. Properti
ini digunakan bersama oleh semua bentuk CruiseControlType. Jika CC diaktifkan, sistem ADAS di
kendaraan harus diaktifkan dan merespons perintah. Secara umum,
CRUISE_CONTROL_ENABLED
harus selalu menampilkan true atau false. Jika fitur tidak tersedia karena beberapa status sementara,
seperti kecepatan kendaraan yang terlalu rendah, informasi tersebut harus disampaikan melalui
nilai ErrorState
di properti CRUISE_CONTROL_STATE
. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
CRUISE_CONTROL_STATE
Status saat ini dari Kontrol Kecepatan (CC). Properti ini menampilkan status CC saat ini. Umumnya,
properti ini akan menampilkan status yang valid yang ditentukan di CruiseControlState atau
ErrorState
Misalnya, jika fitur tidak tersedia karena beberapa status sementara, informasi tersebut
harus disampaikan melalui ErrorState
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValue
harus ditentukan kecuali jika semua status
CruiseControlState (termasuk OTHER, yang tidak direkomendasikan) dan ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: CruiseControlState/ErrorState
Jenis unit: T/A
Rilis: Android 14
CRUISE_CONTROL_TARGET_SPEED
Kecepatan target saat ini untuk Cruise Control (CC). OEM harus menetapkan nilai minFloatValue dan
maxFloatValue untuk properti ini guna menentukan nilai kecepatan target minimum dan maksimum. Nilai ini
tidak boleh negatif. maxFloatValue mewakili batas atas kecepatan target.
minFloatValue mewakili batas bawah kecepatan target.
Jika properti ini tidak tersedia karena CC dinonaktifkan (misalnya,
CRUISE_CONTROL_ENABLED
bernilai salah), properti ini harus menampilkan StatusCode#NOT_AVAILABLE_DISABLED
. Jika
CRUISE_CONTROL_STATE
diterapkan dan status ditetapkan ke nilai ErrorState, properti ini harus menampilkan
StatusCode
yang selaras dengan nilai ErrorState. Misalnya, jika
CRUISE_CONTROL_STATE
ditetapkan
ke ErrorState#NOT_AVAILABLE_SPEED_LOW
, properti ini harus menampilkan
StatusCode#NOT_AVAILABLE_SPEED_LOW
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:METER_PER_SEC
Rilis: Android 14
CRUISE_CONTROL_TYPE
Jenis Kontrol Kecepatan Konstan (CC) saat ini. Jika CRUISE_CONTROL_ENABLED
bernilai benar, properti ini akan menampilkan jenis CC yang saat ini diaktifkan (misalnya, CC standar dan CC adaptif, prediktif).
Secara umum, properti ini akan menampilkan status yang valid yang ditentukan dalam CruiseControlType
atau
ErrorState
Misalnya, jika fitur tidak tersedia karena beberapa status sementara,
informasi
tersebut harus disampaikan melalui ErrorState
Untuk ID area global (0), array
StatusCode#VehicleAreaConfig#supportedEnumValues
harus ditentukan
kecuali jika semua status CruiseControlType
(termasuk OTHER
, yang tidak
direkomendasikan) dan
ErrorState
didukung. Mencoba WRITE
CruiseControlType#OTHER
atau ErrorState
ke properti
ini akan menampilkan IllegalArgumentException
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya hanya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: CruiseControlType
ErrorState
Jenis unit: T/A
Rilis: Android 14
CURRENT_GEAR
Gigi saat ini. Dalam kasus non-manual, gigi yang dipilih mungkin tidak cocok dengan gigi saat ini. Misalnya,
jika gigi yang dipilih adalah GEAR_DRIVE
, gigi saat ini akan menjadi salah satu
dari GEAR_1
, GEAR_2
, dan seterusnya, yang mencerminkan gigi sebenarnya
yang digunakan transmisi. Nilai dalam data konfigurasi harus mewakili daftar roda gigi yang didukung
untuk kendaraan ini. Misalnya, data konfigurasi untuk transmisi otomatis harus berisi
{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}
dan, untuk transmisi
manual, daftarnya harus {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
Daftar ini tidak harus sama dengan gigi yang didukung yang dilaporkan di
GEAR_SELECTION
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleGear
Jenis unit: T/A
Rilis: Android 13
CURRENT_POWER_POLICY
Memberi tahu kebijakan daya saat ini ke lapisan VHAL. Layanan kebijakan daya mobil menetapkan properti ini saat kebijakan daya saat ini diubah
string: "sample_policy_id" // power policy ID
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
DISABLED_OPTIONAL_FEATURES
Mengizinkan penonaktifan fitur opsional di VHAL. Properti ini melaporkan fitur opsional yang harus dinonaktifkan. Semua fitur opsional yang diizinkan untuk sistem dideklarasikan dalam overlay
layanan Mobil, config_allowed_optional_car_features
Properti ini memungkinkan penonaktifan fitur yang ditentukan dalam overlay. Tanpa properti ini, semua
fitur yang dideklarasikan dalam overlay akan diaktifkan.
Nilai READ
harus menyertakan semua fitur yang dinonaktifkan dengan pemisahan koma (,
).
Misalnya, com.android.car.user.CarUserNoticeService,storage_monitoring
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
DISPLAY_BRIGHTNESS
Properti untuk menampilkan kecerahan layar. Beberapa mobil memiliki satu kontrol untuk
kecerahan semua layar. Properti ini digunakan untuk membagikan perubahan pada kontrol tersebut. Di mobil yang memiliki
layar yang kecerahannya dikontrol secara terpisah, layar tersebut harus menggunakan
PER_DISPLAY_BRIGHTNESS
Hanya satu dari DISPLAY_BRIGHTNESS
dan PER_DISPLAY_BRIGHTNESS
yang harus
diimplementasikan. Jika keduanya
tersedia, PER_DISPLAY_BRIGHTNESS
akan digunakan oleh AAOS. Jika dapat ditulis, Android dapat
menetapkan nilai
ini saat pengguna mengubah kecerahan layar dari Setelan. Jika ini khusus READ
,
pengguna masih dapat
mengubah kecerahan layar dari Setelan, tetapi perubahan tersebut tidak boleh tercermin di layar lain.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
DISTANCE_DISPLAY_UNITS
Satuan jarak untuk ditampilkan. Menunjukkan unit yang digunakan mobil untuk menampilkan jarak kepada
pengguna. Misalnya, Mil, Meter, atau Kilometer. Satuan jarak ditentukan dalam VehicleUnit.
VehiclePropConfig.configArray digunakan untuk menunjukkan satuan tampilan jarak yang didukung.
Misalnya, configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE
Jika memperbarui DISTANCE_DISPLAY_UNITS
memengaruhi nilai properti
*_DISPLAY_UNITS
lainnya, nilainya juga harus diperbarui dan dikomunikasikan ke framework AAOS.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: VehicleUnit
Jenis unit: T/A
Rilis: Android 13
DOOR_CHILD_LOCK_ENABLED
Fitur kunci pengaman anak di pintu diaktifkan. Menampilkan true (benar) jika fitur kunci anak pintu diaktifkan dan
false (salah) jika dinonaktifkan. Jika diaktifkan, pintu tidak dapat dibuka dari dalam. Properti ini ditentukan
sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
DOOR_LOCK
Kunci pintu benar (true) menunjukkan bahwa pintu terkunci. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
DOOR_MOVE
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung. maxInt32Value
mewakili kecepatan gerakan maksimum pintu saat
terbuka. minInt32Value
menunjukkan kecepatan gerakan maksimum pintu saat
menutup.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah pintu
mencapai batas posisi, nilai harus direset ke 0. Jika nilai
DOOR_MOVE
adalah 0,
berarti tidak ada gerakan yang terjadi saat ini.
Properti ini tidak dalam unit tertentu, tetapi dalam rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
DOOR_POS
Posisi pintu. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan pintu tertutup. minInt32Value
harus 0.
maxInt32Value
menunjukkan bahwa pintu terbuka sepenuhnya. Nilai antara
minInt32Value
dan
maxInt32Value
menunjukkan status transisi antara posisi tertutup dan
terbuka sepenuhnya.
Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang posisi relatif yang ditentukan.
Beberapa kendaraan (minivan) dapat membuka pintu secara elektronik. Oleh karena itu, kemampuan untuk
WRITE
properti ini. Properti ini ditentukan sebagai VehiclePropertyAccess
READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
E ke G
ELECTRONIC_TOLL_COLLECTION_CARD_STATUS
Status kartu Pengumpulan Tol Elektronik. Properti ini menunjukkan status kartu ETC di
kendaraan ini. Jika head unit mengetahui kartu ETC yang terpasang ke kendaraan,
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
akan memberikan status kartu tersebut. Jika tidak, properti ini harus berupa UNAVAILABLE
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: ElectronicTollCollectionCardStatus
Jenis unit: T/A
Rilis: Android 13
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
Jenis kartu Pengumpulan Tol Elektronik (ETC). Properti ini menunjukkan jenis kartu ETC di
kendaraan ini. Jika head unit mengetahui kartu ETC yang terpasang ke kendaraan, properti ini harus
menampilkan jenis kartu yang terpasang; jika tidak, properti ini harus berupa UNAVAILABLE
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: ElectronicTollCollectionCardType
Jenis unit: T/A
Rilis: Android 13
EMERGENCY_LANE_KEEP_ASSIST_ENABLED
Mengaktifkan atau menonaktifkan Bantuan Tetap di Jalur Darurat (ELKA). Tetapkan ke true untuk mengaktifkan ELKA dan false untuk
menonaktifkan ELKA. Jika ELKA diaktifkan, sistem ADAS di kendaraan harus aktif dan memantau
perubahan jalur yang tidak aman oleh pengemudi. Saat manuver yang tidak aman terdeteksi, ELKA akan memberi tahu
pengemudi dan menerapkan koreksi kemudi untuk menjaga kendaraan tetap berada di jalur aslinya.
Secara umum, EMERGENCY_LANE_KEEP_ASSIST_ENABLED
harus selalu menampilkan true atau false.
Jika fitur tidak tersedia karena beberapa status sementara, seperti kecepatan kendaraan terlalu
rendah, informasi tersebut harus disampaikan melalui nilai ErrorState
di
properti EMERGENCY_LANE_KEEP_ASSIST_STATE
. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
EMERGENCY_LANE_KEEP_ASSIST_STATE
Status Bantuan Pertahanan Jalur Darurat (ELKA). Menampilkan status ELKA saat ini. Umumnya, properti
ini akan menampilkan status yang valid yang ditentukan dalam EmergencyLaneKeepAssistState
atau
ErrorState
Misalnya, jika fitur tidak tersedia karena beberapa status sementara, informasi tersebut
harus disampaikan melalui ErrorState
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status
EmergencyLaneKeepAssistState
(termasuk OTHER, yang tidak direkomendasikan) dan
ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: EmergencyLaneKeepAssistState/ErrorState
Jenis unit: T/A
Rilis: Android 14
ENGINE_COOLANT_TEMP
Suhu pendingin mesin.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13
ENGINE_IDLE_AUTO_STOP_ENABLED
Mewakili fitur untuk penghentian otomatis mesin saat tidak ada aktivitas. Jika benar, kendaraan dapat otomatis mematikan
mesin saat tidak diperlukan, lalu otomatis memulai ulang saat diperlukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
ENGINE_OIL_LEVEL
Tingkat oli mesin.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleOilLevel
Jenis unit: T/A
Rilis: Android 13
ENGINE_OIL_TEMP
Suhu oli mesin.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13
ENGINE_RPM
Revolusi mesin per menit (RPM).
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:RPM
Rilis: Android 13
ENV_OUTSIDE_TEMPERATURE
Suhu di luar ruangan. Properti ini harus menyampaikan pembacaan suhu lingkungan di luar kendaraan. Jika ada beberapa sensor untuk mengukur suhu luar, properti ini harus diisi dengan rata-rata atau rata-rata berbobot yang bermakna dari pembacaan yang paling mewakili suhu lingkungan luar.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13
EV_BATTERY_DISPLAY_UNITS
Unit baterai Kendaraan Listrik Umum untuk ditampilkan. Menunjukkan unit yang digunakan mobil untuk menampilkan informasi baterai
EV kepada pengguna. Misalnya, watt-hour (Wh), kilowatt-hour (kWh), atau ampere-hour (Ah).
VehiclePropConfig.configArray
digunakan untuk menunjukkan energi listrik yang didukung.
unit. Unit energi listrik ditentukan dalam VehicleUnit
Misalnya:
configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR
Jika memperbarui EV_BATTERY_DISPLAY_UNITS
memengaruhi nilai properti
*_DISPLAY_UNITS
lainnya,
nilainya juga harus diperbarui dan dikomunikasikan ke framework AAOS.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleUnit
Jenis unit: T/A
Rilis: Android 13
EV_BATTERY_INSTANTANEOUS_CHARGE_RATE
Kecepatan pengisian daya instan EV dalam miliwat. Nilai positif menunjukkan bahwa baterai sedang diisi dayanya. Nilai negatif menunjukkan baterai sedang dikosongkan.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MW
Rilis: Android 13
EV_BATTERY_LEVEL
Menampilkan level baterai saat ini, baik kendaraan listrik atau hibrida. Nilai ini tidak akan melebihi
EV_CURRENT_BATTERY_CAPACITY
Untuk menghitung persentase baterai, gunakan
(EV_BATTERY_LEVEL
, EV_CURRENT_BATTERY_CAPACITY
)*100.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:WH
Rilis: Android 13
EV_BRAKE_REGENERATION_LEVEL
Tingkat pengereman regeneratif kendaraan elektronik. maxInt32Value
dan
minInt32Value
di VehicleAreaConfig harus ditentukan. Semua nilai antara
minInt32Value
dan maxInt32Value
harus
didukung. minInt32Value
harus 0. maxInt32Value
menunjukkan
setelan untuk jumlah maksimum energi yang dihasilkan dari pengereman. minInt32Value
menunjukkan setelan untuk tidak
melakukan pengereman regeneratif. Properti ini adalah bentuk yang lebih terperinci dari
EV_REGENERATIVE_BRAKING_STATE
Properti ini memungkinkan pengguna menetapkan tingkat pengereman regeneratif yang lebih spesifik jika status di
EvRegenerativeBrakingState
tidak cukup terperinci untuk OEM. Properti ini
ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
EV_CHARGE_CURRENT_DRAW_LIMIT
Menunjukkan nilai minimum arus maksimum untuk pengisian daya yang ditetapkan oleh pengguna.
EvChargeState::configArray[0]
digunakan untuk menentukan arus maksimum yang diizinkan oleh kendaraan dalam Ampere. Properti ini ditentukan
sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITEREAD
Jenis enum: T/A
Jenis unit: VehicleUnit:AMPERE
Rilis: Android 13
EV_CHARGE_PERCENT_LIMIT
Menunjukkan nilai minimum persentase tagihan maksimum yang ditetapkan oleh pengguna. Menunjukkan nilai minimum persentase
tagihan maksimum yang ditetapkan oleh pengguna. Menampilkan nilai float dari 0 hingga 100.
configArray digunakan untuk menentukan nilai yang valid. Misalnya, jika kendaraan mendukung
nilai batas persentase pengisian daya berikut: [20, 40, 60, 80, 100], configArray harus berupa
{20, 40, 60, 80, 100}. Jika configArray kosong, semua nilai dari 0 hingga 100 harus valid.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE,
, READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
EV_CHARGE_PORT_CONNECTED
Port pengisian daya kendaraan listrik terhubung. Jika kendaraan memiliki beberapa port pengisian daya, properti ini harus menampilkan
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
EV_CHARGE_PORT_OPEN
Port pengisian daya kendaraan listrik terbuka. Jika kendaraan memiliki beberapa port pengisian daya, properti ini harus menampilkan
benar jika salah satu port pengisian daya terbuka. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITEREAD
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
EV_CHARGE_STATE
Status pengisian daya mobil
Menampilkan status pengisian daya mobil saat ini.
Jika kendaraan memiliki persentase pengisian daya target selain 100, properti ini harus menampilkan
EvChargeState::STATE_FULLY_CHARGED
saat tingkat pengisian daya baterai telah mencapai
tingkat target. Lihat EvChargeState::EV_CHARGE_PERCENT_LIMIT
untuk konteks selengkapnya.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: EvChargeState
Jenis unit: T/A
Rilis: Android 13
EV_CHARGE_SWITCH
Mulai atau hentikan pengisian daya baterai Kendaraan Listrik. Setelan yang diinginkan pengguna. Menetapkan properti ini
ke benar akan memulai pengisian daya baterai, dan salah untuk menghentikan pengisian daya. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITEREAD
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
EV_CHARGE_TIME_REMAINING
Estimasi sisa waktu pengisian daya dalam detik. Menampilkan 0 jika kendaraan tidak mengisi daya.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:SECS
Rilis: Android 13
EV_CURRENT_BATTERY_CAPACITY
Kapasitas baterai saat ini yang dapat digunakan untuk kendaraan listrik (EV) atau hybrid. Menampilkan nilai aktual
kapasitas baterai, saat EV atau hybrid. Properti ini menangkap kapasitas baterai yang dapat digunakan secara real time
dengan mempertimbangkan faktor-faktor seperti penuaan baterai dan dependensi suhu. Nilai ini mungkin
berbeda dengan INFO_EV_BATTERY_CAPACITY
karena INFO_EV_BATTERY_CAPACITY
menampilkan kapasitas baterai nominal dari saat kendaraan masih baru.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:WH
Rilis: Android 14
EV_REGENERATIVE_BRAKING_STATE
Rem regeneratif atau setelan mengemudi satu pedal mobil. Menampilkan setelan saat ini
yang terkait dengan setelan pengereman regeneratif di mobil. Jika OEM memerlukan lebih banyak setelan
daripada yang disediakan di EvRegenerativeBrakingState
, properti
EV_BRAKE_REGENERATION_LEVEL
dapat digunakan sebagai gantinya, yang memberikan informasi
yang lebih terperinci.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: EvRegenerativeBrakingState
Jenis unit: T/A
Rilis: Android 13
EV_STOPPING_MODE
Mewakili properti untuk mode perhentian kendaraan saat ini. Untuk ID area global (0),
VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua nilai enum
EvStoppingMode
didukung. Enum EvStoppingMode
dapat diperluas untuk
menyertakan lebih banyak status di masa mendatang. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM memiliki opsi untuk menerapkannya sebagai
VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: EvStoppingMode
Jenis unit: T/A
Rilis: Android 14
EVS_SERVICE_REQUEST
Mengaktifkan dan meminta layanan EVS. Properti ini menyediakan cara untuk memicu layanan EVS. VHAL harus menggunakan properti ini untuk meminta Android memulai atau menghentikan layanan EVS.
int32Values[0]
Jenis layanan EVS. Nilainya harus berupa enum di EvsServiceType.int32Values[1]
Status layanan EVS. Nilainya harus berupa salah satu enum di EvsServiceState.
Misalnya, untuk mengaktifkan layanan EVS tampilan belakang, Android dapat menetapkan nilai properti sebagai:
[EvsServiceType::REAR_VIEW, EvsServiceState::ON]
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
EXTERNAL_CAR_TIME
Saran tanggal dan waktu saat ini untuk cr, yang dienkode sebagai waktu Epoch (dalam milidetik). Nilai ini menunjukkan jumlah detik milidetik yang telah berlalu sejak 1/1/1970 UTC. Properti ini menandakan perubahan CarTime ke Android. Jika properti didukung, VHAL harus melaporkan CarTime saat ini yang paling akurat saat properti ini dibaca, dan memublikasikan perubahan pada properti ini saat nilai CarTime telah berubah.
Peristiwa on-change untuk properti ini harus dipublikasikan saat CarTime berubah karena alasan apa pun selain berlalunya waktu secara alami (delta waktu yang lebih kecil dari 500 md tidak boleh memicu peristiwa on change). Android akan membaca dan berlangganan properti ini untuk mengambil waktu dari VHAL. Hal ini dapat berguna untuk menyinkronkan waktu Android dengan sistem kendaraan lainnya (jam dasbor). int64Values[0] = waktu Epoch yang diberikan (dalam milidetik) Setiap kali Nilai baru untuk properti diterima, AAOS akan membuat dan mengirim ExternalTimeSuggestion ke TimeDetectorService.
Jika sumber lain tidak memiliki prioritas yang lebih tinggi, Android akan menggunakannya untuk menyetel waktu sistem. Untuk informasi tentang cara menyesuaikan prioritas sumber waktu dan cara saran waktu ditangani (termasuk cara Android menangani gitter, drift, dan resolusi minimum), lihat dokumentasi Layanan Time Detector.
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
Sebaiknya properti ini tidak digunakan untuk mengambil waktu dari ECU menggunakan protokol (seperti GNSS, NTP, dan Telepon). Karena protokol ini sudah didukung oleh Android, sebaiknya gunakan sistem Android, bukan menghubungkan melalui VHAL dengan properti ini.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLI_SECS
Rilis: Android 13
FOG_LIGHTS_STATE
Status lampu kabut. Menampilkan status lampu kabut saat ini. Jika:
- Mobil memiliki lampu kabut depan dan belakang. Lampu kabut depan dan belakang hanya dapat dikontrol
secara bersamaan.
FOG_LIGHTS_STATE
harus diimplementasikan.FRONT_FOG_LIGHTS_STATE
danREAR_FOG_LIGHTS_STATE
tidak boleh diimplementasikan. - Lampu kabut depan dan belakang hanya dapat dikontrol secara terpisah.
FOG_LIGHTS_STATE
tidak boleh diterapkan danFRONT_FOG_LIGHTS_STATE
sertaREAR_FOG_LIGHTS_STATE
harus diterapkan. - Mobil hanya memiliki lampu kabut depan. Hanya salah satu dari
FOG_LIGHTS_STATE
atauFRONT_FOG_LIGHTS_STATE
yang harus diterapkan (bukan keduanya).REAR_FOG_LIGHTS_STATE
tidak boleh diterapkan. - Mobil hanya memiliki lampu kabut belakang. Hanya salah satu dari
FOG_LIGHTS_STATE
atauREAR_FOG_LIGHTS_STATE
yang harus diterapkan (bukan keduanya).FRONT_FOG_LIGHTS_STATE
tidak boleh diterapkan.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
FOG_LIGHTS_SWITCH
Tombol lampu kabut. Setelan yang diinginkan pengguna. Jika:
- Mobil memiliki lampu kabut depan dan belakang. Jika lampu kabut depan dan belakang hanya dapat dikontrol
secara bersamaan,
FOG_LIGHTS_SWITCH
harus diterapkan.FRONT_FOG_LIGHTS_SWITCH
danREAR_FOG_LIGHTS_SWITCH
tidak boleh diimplementasikan. - Lampu kabut depan dan belakang hanya dapat dikontrol secara terpisah.
FOG_LIGHTS_SWITCH
tidak boleh diterapkan.FRONT_FOG_LIGHTS_SWITCH
danREAR_FOG_LIGHTS_SWITCH
harus diterapkan. - Mobil hanya memiliki lampu kabut depan. Hanya salah satu dari
FOG_LIGHTS_SWITCH
atauFRONT_FOG_LIGHTS_SWITCH
yang harus diterapkan (bukan keduanya).REAR_FOG_LIGHTS_SWITCH
tidak boleh diterapkan. - Mobil hanya memiliki lampu kabut belakang. Hanya salah satu dari
FOG_LIGHTS_SWITCH
atauREAR_FOG_LIGHTS_SWITCH
yang harus diterapkan (dan bukan keduanya).FRONT_FOG_LIGHTS_SWITCH
tidak boleh diterapkan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
FORWARD_COLLISION_WARNING_ENABLED
Aktifkan atau nonaktifkan Peringatan Tabrakan Depan (FCW). Tetapkan ke true untuk mengaktifkan FCW dan false untuk
menonaktifkan FCW. Jika FCW diaktifkan, sistem ADAS di kendaraan harus diaktifkan dan
memantau potensi tabrakan. Secara umum, FORWARD_COLLISION_WARNING_ENABLED
harus selalu menampilkan true atau false. Jika fitur tidak tersedia karena beberapa status sementara,
seperti kecepatan kendaraan yang terlalu rendah, informasi tersebut harus disampaikan melalui
nilai ErrorState
di properti FORWARD_COLLISION_WARNING_STATE
.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
FORWARD_COLLISION_WARNING_STATE
Status Peringatan Tabrakan Depan (FCW). Menampilkan status FCW saat ini. Properti ini harus
selalu menampilkan status yang valid yang ditentukan dalam ForwardCollisionWarningState
atau
ErrorState
. Properti ini tidak boleh
menampilkan error melalui StatusCode dan harus menggunakan status error yang didukung.
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status ForwardCollisionWarningState
(termasuk OTHER, yang tidak direkomendasikan) dan ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enun: ForwardCollisionWarningState/ErrorState
Jenis unit: T/A
Rilis: Android 14
FRONT_FOG_LIGHTS_STATE
Status lampu kabut depan. Menampilkan status lampu kabut depan saat ini. Hanya salah satu dari
FOG_LIGHTS_STATE
atau FRONT_FOG_LIGHTS_STATE
yang harus diterapkan.
Lihat dokumentasi tentang FOG_LIGHTS_STATE
untuk mengetahui informasi selengkapnya.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
FRONT_FOG_LIGHTS_SWITCH
Tombol lampu kabut depan. Setelan yang diinginkan pengguna. Hanya salah satu dari
FOG_LIGHTS_SWITCH
atau FRONT_FOG_LIGHTS_SWITCH
yang harus diterapkan. Lihat
dokumentasi tentang FOG_LIGHTS_SWITCH
untuk mengetahui informasi selengkapnya.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME
Unit konsumsi bahan bakar untuk ditampilkan.
Menunjukkan jenis unit yang digunakan mobil untuk menampilkan informasi konsumsi bahan bakar kepada pengguna
Benar menunjukkan unit adalah jarak per volume seperti MPG. Salah menunjukkan bahwa unit adalah volume
berdasarkan jarak seperti L/100KM. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
FUEL_DOOR_OPEN
Pintu bahan bakar terbuka. Properti ini harus menyampaikan apakah pintu bahan bakar pada kendaraan terbuka atau tidak.
Properti ini tidak berlaku untuk Kendaraan Listrik. Artinya, jika INFO_FUEL_TYPE
hanya
berisi FuelType::FUEL_TYPE_ELECTRIC
, properti ini tidak boleh diterapkan. Untuk
Kendaraan Listrik, terapkan EV_CHARGE_PORT_OPEN
. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
FUEL_LEVEL
Bahan bakar yang tersisa di kendaraan, dalam mililiter. Properti ini harus menyampaikan jumlah
bahan bakar yang tersisa di kendaraan saat ini dalam mililiter. Properti ini tidak berlaku untuk kendaraan
listrik. Artinya, jika INFO_FUEL_TYPE
hanya berisi
FuelType::FUEL_TYPE_ELECTRIC
, properti ini tidak boleh diterapkan. Untuk Kendaraan Listrik, terapkan
EV_BATTERY_LEVEL
Nilai tidak boleh melebihi INFO_FUEL_CAPACITY
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLILITER
Rilis: Android 13
FUEL_LEVEL_LOW
Peringatan untuk level bahan bakar yang rendah. Properti ini sesuai dengan peringatan bahan bakar rendah di dasbor.
Setelah ditetapkan, FUEL_LEVEL_LOW
tidak boleh dihapus hingga lebih banyak bahan bakar ditambahkan ke
kendaraan. Properti ini dapat memperhitungkan semua sumber bahan bakar di kendaraan. Misalnya, dalam:
- Kendaraan bertenaga bensin, properti ini hanya didasarkan pada level bensin.
- Kendaraan bertenaga baterai, properti ini hanya didasarkan pada level baterai.
- Kendaraan hibrida, properti ini dapat didasarkan pada kombinasi level bahan bakar dan baterai, sesuai kebijaksanaan OEM.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
FUEL_VOLUME_DISPLAY_UNITS
Unit volume bahan bakar untuk ditampilkan. Menunjukkan unit yang digunakan mobil untuk menampilkan volume bahan bakar
kepada pengguna. Misalnya, Liter atau Galon. VehiclePropConfig.configArray
digunakan untuk
menunjukkan unit tampilan volume bahan bakar yang didukung. Satuan volume ditentukan dalam
VehicleUnit
Misalnya, configArray[0] = LITER configArray[1] = GALLON
Jika memperbarui FUEL_VOLUME_DISPLAY_UNITS
memengaruhi nilai properti
*_DISPLAY_UNITS
lainnya,
nilainya juga harus diperbarui dan dikomunikasikan ke framework AAOS.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleUnit
Jenis unit: T/A
Rilis: Android 13
GEAR_SELECTION
Roda gigi yang dipilih oleh pengguna. Nilai dalam data konfigurasi harus mewakili daftar roda gigi
yang didukung untuk kendaraan ini. Misalnya, data konfigurasi untuk transmisi otomatis harus berisi
{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK,
dan untuk
transmisi manual, daftarnya harus GEAR_DRIVE
, GEAR_1, GEAR_2,...}{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
Untuk kendaraan transmisi otomatis yang memungkinkan pengemudi memilih gigi tertentu sesuai permintaan
(misalnya, mode manual), nilai untuk GEAR_SELECTION
harus ditetapkan ke gear
tertentu yang dipilih oleh pengemudi, bukan GEAR_DRIVE
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleGear
Jenis unit: T/A
Rilis: Android 13
GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
Persyaratan kepatuhan terhadap General Data Protection Regulation Uni Eropa. Menampilkan nilai untuk menunjukkan apakah kepatuhan terhadap peraturan keamanan umum diperlukan dan, jika ya, jenis persyaratannya.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: GsrComplianceRequirementType
Jenis unit: T/A
Rilis: Android 14
GLOVE_BOX_DOOR_POS
Properti yang mewakili posisi pintu laci penyimpanan saat ini. maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa pintu kotak sarung tangan tertutup.
minInt32Value
harus 0. maxInt32Value
menunjukkan bahwa pintu glove box berada dalam posisi terbuka sepenuhnya. Nilai di antara minInt32Value
dan
maxInt32Value
menunjukkan status transisi antara posisi tertutup dan sepenuhnya terbuka.
Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang posisi relatif yang ditentukan.
ID area harus cocok dengan kursi tempat kotak sarung tangan dimaksudkan untuk digunakan. Misalnya, jika
dasbor kanan depan memiliki kotak sarung tangan yang disematkan di dalamnya, ID area harus
SEAT_1_RIGHT
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
GLOVE_BOX_LOCKED
Mengunci atau membuka kunci glove box. Jika true (benar), kotak sarung tangan terkunci. Jika salah, kotak sarung tangan
tidak terkunci. ID area harus cocok dengan kursi tempat kotak sarung tangan dimaksudkan untuk digunakan. Misalnya, jika dasbor kanan depan memiliki kotak sarung tangan yang disematkan, ID area harus
VehicleAreaSeat#ROW_1_RIGHT
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
H hingga I
HANDS_ON_DETECTION_DRIVER_STATE
Hands On Detection (HOD) driver state. Returns whether the driver's hands are on the steering
wheel. Generally, this property should return a valid state defined in the
HandsOnDetectionDriverState
or ErrorState
For example, if the feature
is not available due to
some temporary state, that information should be conveyed through ErrorState
If the vehicle wants to send a warning to the user because the driver's hands have been off the
steering wheel for too long, the warning should be surfaced through
HANDS_ON_DETECTION_WARNING
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must
be defined
unless all states of both HandsOnDetectionDriverState
(including OTHER, which is
not recommended)
and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionDriverState/ErrorState
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_ENABLED
Enable or disable Hands On Detection (HOD). Set true to enable HOD and false to disable HOD.
When HOD is enabled, a system inside the vehicle should be monitoring the presence of the driver's
hands on the steering wheel and send a warning if it detects that the driver's hands are no longer
on the steering wheel. In general, HANDS_ON_DETECTION_ENABLED
should always return
true or false.
If the feature is not available due to some temporary state, that information must be conveyed
through the ErrorState
values in the HANDS_ON_DETECTION_STATE
property.
This property is defined as minInt32Value
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it is
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_WARNING
Hands On Detection (HOD) warning. Returns whether a warning is being sent to the driver for
having their hands off the wheel for too long a duration. Generally, this property should return
a valid state defined in HandsOnDetectionWarning
or ErrorState
For
example, if the feature is not available due to some temporary state, that information should
be conveyed through an ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValues
array must be defined unless all states
of both HandsOnDetectionWarning
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionWarning/ErrorState
Unit type: N/A
Release: Android 14
HAZARD_LIGHTS_STATE
Hazard light status. Return the current status of hazard lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HAZARD_LIGHTS_SWITCH
Hazard light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HEADLIGHTS_STATE
Headlights state. Returns the current state of headlights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HEADLIGHTS_SWITCH
Headlight switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_STATE
High beam lights state. Returns the current state of high beam lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_SWITCH
High beam light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HVAC_AC_ON
Turn AC on and off AC for the designated areaId. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ACTUAL_FAN_SPEED_RPM
Actual fan speed.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_ON
Turn automatic climate control on and off.
If true, automatic climate control is on. If false, automatic climate control is off.
If the vehicle does not support directly turning off automatic climate control, then OEMs should
add logic in their VHAL implementation to set HVAC_AUTO_ON
to false, which changes
the necessary HVAC settings to indirectly turn off HVAC_AUTO_ON
Ideally, this
should not disrupt the user. OEMs should revert to the previous state any settings that were
modified when automatic climate control is off. This way, the only outcome should be that
HVAC_AUTO_ON
is off. If restoring HVAC settings to previous settings is not possible,
then the OEM should implement the least disruptive change.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_RECIRC_ON
Automatic recirculation on or off. When automatic recirculation is on, the HVAC system may
automatically switch to recirculation mode if the vehicle detects poor incoming air quality.
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DEFROSTER
Fan-based defrost for designated window. This property is defined as
VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DUAL_ON
Enable temperature coupling between areas. The AreaIDs
for the
HVAC_DUAL_ON
property
shall contain a combination of HVAC_TEMPERATURE_SET
AreaIDs
that can be
coupled
together. If HVAC_TEMPERATURE_SET
is mapped to AreaIDs
[a_1, a_2, ..., a_n]
and if HVAC_DUAL_ON
can be enabled to couple a_i and a_j, then
HVAC_DUAL_ON
property must be mapped to [a_i | a_j]. Further, if
a_k and a_l can also be coupled together separately, then
HVAC_DUAL_ON
must be mapped to [a_i | a_j, a_k | a_l].
For example, a car has two front seats (ROW_1_LEFT
and ROW_1_RIGHT
) and
three back seats (ROW_2_LEFT, ROW_2_CENTER, and ROW_2_RIGHT).
There are two temperature control units, driver side and passenger side, which can be optionally
synchronized. This can be expressed this way in the AreaIDs
:
HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT] HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
When the property is enabled, the ECU must synchronize the temperature for the affected areas.
Any parameters modified as a side effect of turning on or off the DUAL_ON parameter shall generate
onPropertyEvent()
callbacks to the VHAL. In addition, if setting a temperature
(for example, driver temperature) changes another temperature (such as front passenger
temperature), then the appropriate onPropertyEvent()
callbacks must be generated.
If a user changes a temperature that breaks the coupling (for example, sets passenger temperature
independently), then the VHAL must send the appropriate onPropertyEvent()
callbacks
(including HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
).
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
Electric defrosters' status.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION
Fan direction setting. This property is defined as VehiclePropertyAccess.READ_WRITE
,
but OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
Fan positions available. This is a bit mask of fan positions available for the zone. Each
available fan direction is denoted by a separate entry in the vector. A fan direction can have
multiple bits from vehicle_hvac_fan_direction
set. For instance, a typical car may have these
fan positions:
- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)
Change mode: STATIC
Access mode: READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_SPEED
Fan speed setting. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig must be defined. All integers between minInt32Value
and
maxInt32Value
must be supported.
minInt32Value
lowest fan speedmaxInt32Value
highest fan speed
This property is not in any specific unit but in a specified range of relative speeds. This
property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can elect to
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_AC_ON
MAX AC on or off. When MAX AC is on, the ECU can adjust items such as vent position, fan speed,
and temperature as needed to cool the vehicle as quickly as possible. Any parameters modified as
a side effect of turning on or off the MAX AC parameter generates onPropertyEvent()
callbacks to the VHAL. This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_DEFROST_ON
Turn MAX DEFROST on and off. When MAX DEFROST is on, the ECU can adjust items such as vent
position, fan speed, and temperature as needed to defrost the windows as quickly as possible.
Any parameters modified as a side effect of turning on or off MAX DEFROST parameter generates
onPropertyEvent()
callbacks to the VHAL. The AreaIDs
for
HVAC_MAX_DEFROST_ON
indicate MAX DEFROST can be controlled in the area. For example,
areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
indicates that
HVAC_MAX_DEFROST_ON
can only be controlled for the front rows. This property is
defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it
as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_POWER_ON
Represents the global power state for HVAC. Setting this property to false MAY mark some properties that control individual HVAC features and subsystems in the UNAVAILABLE state. Setting this property to true MAY mark some properties that control individual HVAC features and subsystems to the AVAILABLE state (unless any or all of the properties are UNAVAILABLE on their own individual merits).
HvacPower_DependentProperties
are those properties that require HVAC to be powered
on to enable functionality. In some cars, for example, to turn on the AC, HVAC must first be
powered on. The HvacPower_DependentProperties
list must be set in the
VehiclePropConfig.configArray
HvacPower_DependentProperties
must only
contain those properties associated with VehicleArea:SEAT
AreaID mapping for HVAC_POWER_ON
property must contain all AreaIDs
that
HvacPower_DependentProperties
are mapped to. For example, a car has two:
- Front seats (
ROW_1_LEFT
,ROW_1_RIGHT
) and three back seats (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). If the HVAC features (AC, Temperature etc.) throughout the car are dependent on a single HVAC power controller, thenHVAC_POWER_ON
must be mapped to [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- Seats in the front row (
ROW_1_LEFT
,ROW_1_RIGHT
) and three seat in the second (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) and third rows (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). If the car has temperature controllers in the front row that can operate entirely independently of temperature controllers in the back of the vehicle, thenHVAC_POWER_ON
must be mapped to a two element array:- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_RECIRC_ON
Recirculation on and off. Controls the supply of exterior air to the cabin. Recirc
on means most of the airflow into the cabin originates in the cabin. Recirc
off means most of the airflow into the cabin comes from outside the car. This
property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_TEMPERATURE
Seat heating and cooling. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum seat temperature heating setting.
The minInt32Value
must be 0, unless the vehicle supports seat cooling. In this case,
minInt32Value
indicates the maximum seat temperature cooling setting.
This property is not in any specific unit, but in a specified range of relative temperature
settings. This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs
can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_VENTILATION
Seat ventilation. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported. The minInt32Value
must be 0. The
maxInt32Value
indicates the maximum ventilation setting available for the seat.
This property is not in any particular unit but in the specified range of ventilation settings.
Used by HVAC apps and Assistant to enable, change, or read state of seat ventilation. This is different than seating cooling. It can be on at the same time as cooling, or not.
This property is defined as >VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SIDE_MIRROR_HEAT
Side mirror heat. Increasing values denote higher heating levels for side mirrors.
You must define maxInt32Value
and minInt32Value
in
VehicleAreaConfig
All integers between minInt32Value
and
maxInt32Value
must be supported. In config data:
maxInt32Value
represents maximum heating level.minInt32Value
MUST be 0 and indicates no heating.
This property is not in any particular unit but in a specified range of relative heating settings.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_STEERING_WHEEL_HEAT
Sets the amount of heating and cooling for the steering wheel. The maxInt32Value
and
minInt32Value
in VehicleAreaConfig
must be defined. All integers between
minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum steering wheel heating setting. The
minInt32Value
should be 0, unless the vehicle supports steering wheel
cooling, too. In this case, the minInt32Value
indicates the maximum steering wheel
cooling setting. This property is not in any particular unit but in a specified range of heating
settings. This property is defined as VehiclePropertyAccess.READ
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_CURRENT
HVAC current temperature.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
Temperature units for display. Indicates if temperature is displayed in Celsius or Fahrenheit.
VehiclePropConfig.configArray
indicates the supported temperature display units. For
example,
configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
This parameter MAY be used to
display any HVAC temperature in the system. Values must be one of
VehicleUnit.CELSIUS
or VehicleUnit.FAHRENHEIT
If updating HVAC_TEMPERATURE_DISPLAY_UNITS affects the values of other
*_DISPLAY_UNITS
properties, then their values must be updated and communicated to
the AAOS framework.
This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it is VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_SET
HVAC target temperature set in Celsius.
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be defined:
minFloatValue
minimum temperature setting in Celsius.maxFloatValue
maximum temperature setting in Celsius.
If all the values between minFloatValue
and maxFloatValue
are not
supported, use the configArray
to list the valid temperature values that can be set.
This also describes a lookup table to convert the temperature from Celsius to Fahrenheit (and
vice versa) for the vehicle. The configArray
must be defined if standard unit
conversion is not supported on the vehicle.
The configArray
is set as follows:
configArray[0]
[lower bound of supported temperature in Celsius] * 10configArray[1]
[upper bound of supported temperature in Celsius] * 10configArray[2]
[increment in Celsius] * 10configArray[3]
[lower bound of the supported temperature in Fahrenheit] * 10configArray[4]
[upper bound of the supported temperature in Fahrenheit] * 10configArray[5]
[increment in Fahrenheit] * 10
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be equal to configArray[0]
and
configArray[1]
respectively. For example, if the vehicle supports temperature values
as [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
in
Fahrenheit, the configArray
should be
configArray = {160, 280, 5, 605, 845, 10}
Ideally, the ratio of the Celsius increment to the Fahrenheit increment should be as close to
the actual ratio of 1 degree Celsius to 1.8 degrees Fahrenheit. There must be a one-to-one mapping
of all Celsius values to Fahrenheit values defined by the configArray
The
configArray
is used by
clients to convert this property's temperature from Celsius to Fahrenheit. Also, it lets clients
know what Celsius value to set the property to achieve their desired Fahreneheit value for the
system. If the ECU does not have a one-to-one mapping of all Celsius values to Fahrenheit values,
then the configArray
should only define the list of Celsius and Fahrenheit values
that have a one-to-one mapping.
For example, if the ECU supports Celsius values from 16 to 28 and Fahrenheit values from 60 to
85, each with an increment of 1, then one possible configArray
is
code>{160, 280, 10, 600, 840, 20}In this case, 85 is not a supported temperature.
Any value set in between a valid value should be rounded to the closest valid value. We highly
recommended that the OEM also implement the HVAC_TEMPERATURE_VALUE_SUGGESTION
vehicle property because it provides applications with a simple method for determining temperature
values that can be set for a vehicle and for converting values between Celsius and Fahrenheit.
This property is defined as VehiclePropertyAccess.READ
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
Suggested values for setting HVAC temperature.
Implement the property to help applications understand the closest supported temperature value in Celsius or Fahrenheit.
floatValues[0]
Requested value that an app wants to set a temperature to.floatValues[1]
Unit forfloatValues[0]
and should be one of{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2]
Value OEMs suggested in CELSIUS (this value is not included in the request).floatValues[3]
Value OEMs suggested in FAHRENHEIT (this value is not included in the request).
An application calls set(VehiclePropValue propValue)
with the requested value
and unit for the value. OEMs need to return the suggested values in
floatValues[2]
and floatValues[3]
by onPropertyEvent()
callbacks.
The suggested values must conform to the values that can be derived from the
HVAC_TEMPERATURE_SET
configArray
In other words, the suggested values
and the table of values
from the configArray
should be the same.
We recommended that the OEM add custom logic in their VHAL implementation to avoid making requests to the HVAC ECU. The logic can be as follows. To convert temperature from Celsius to Fahrenheit:
// Given tempC and the configArray float minTempC = configArray[0] / 10.0; float temperatureIncrementCelsius = configArray[2] / 10.0; float minTempF = configArray[3] / 10.0; float temperatureIncrementFahrenheit = configArray[5] / 10.0; // Round to the closest increment int numIncrements = round((tempC - minTempC) / temperatureIncrementCelsius); tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;
For example, when a driver uses the voice assistant to set HVAC temperature to 66.2 in Fahrenheit.
First, an application sets this property with the value
[66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
If an OEM suggests to set 19.0 in Celsius or 66.5 in Fahrenheit at the user's request, then VHAL
must generate a callback with a property value
[66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
After the voice assistant gets the callback, it informs the user and sets the HVAC temperature to
the suggested value.
Another example, an app receives 21 Celsius as the current temperature value by querying
HVC_TEMPERATURE_SET
but the app needs to know what value is displayed on the car's
UI in Fahrenheit. For this, the app sets the property to
[21, (float)VehicleUnit.CELSIUS, 0, 0]
If the suggested value by the OEM for 21 Celsius is 70 Fahrenheit, then VHAL must generate a
callback with property value [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
In this
case, the app can know that the value is 70.0 Fahrenheit in the car's UI.
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_CUSTOM_INPUT
Defines a custom OEM partner input event. This input event must be used by OEM partners who want to propagate events not supported by Android. It is composed by an array of int32 values only. The Android properties are:
int32Values[0]
Input code identifying the function representing this event. Valid event types are defined byCustomInputType.CUSTOM_EVENT_F1
up toCustomInputType.CUSTOM_EVENT_F10
They represent the custom event to be defined by OEM partners.int32Values[1]
Target display type defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32Values[2]
Repeat counter, if 0 then event is not repeated. Values 1 or higher indicate how many times this event has been repeated.
Change mode: ON_CHANGE
Access mode: READ
Enum type: CustomInputType
Unit type: N/A
Release: Android 13
HW_KEY_INPUT
Property to feed hardware input events to Android.
int32Values[0]
Action defined by VehicleHwKeyInputActionint32Values[1]
Key code, must use standard android key codeint32Values[2]
Target display defined inVehicleDisplay
Events not tied to specific display must be sent toVehicleDisplay#MAIN
int32Values[3]
(Optional) Number of ticks. The value must be equal o greater than 1. When omitted, Android defaults to 1.
Change mode: .ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_KEY_INPUT_V2
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1]
Key code, must use the standard Android key code, such asKEYCODE_HOME
andKEYCODE_BACK
int32array[2]
action defined in VehicleHwKeyInputAction, such as:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
int32array[3]
Repeat count of the event. For key down events, this is the repeat count with the first down starting at 0 and counting up from there. For key up events, this is always equal to 0.int64array[0]
Down time in elapsed nanoseconds since the last boot. Denotes the time of the most recent key down event. For the down event, this is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_MOTION_INPUT
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
, such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
int32array[1]
Input type defined in VehicleHwMotionInputSource, such as:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
Action code defined in VehicleHwMotionInputAction, such as:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
int32array[3]
Button state flag defined in VehicleHwMotionButtonStateFlag, such as:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
Pointer events count, N. N must be a positive integer.int32array[5:5+N-1]
Pointer id, length Nint32array[5+N:5+2*N-1]
Tool type, length N. As defined inVehicleHwMotionToolType
, such as:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x data, length NfloatArray[N:2*N-1]
y data, length NfloatArray[2*N:3*N-1]
pressure data, length NfloatArray[3*N:4*N-1]
size data, length Nint64array[0]
Down time, elapsed nanoseconds since boot. Denotes the time when the user originally pressed down to start a stream of position events. For the down event, it is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_ROTARY_INPUT
Property to feed hardware rotary events to Android.
int32Values[0]
RotaryInputType to identify which rotary knob is rotated.int32Values[1]
Number of detents (clicks), positive for clockwise, negative for counterclockwise.int32Values[2]
Target display defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2]
Nanosecond deltas between pairs of consecutive detents when the number of detents is more than 1 or less than -1.VehiclePropValue.timestamp
When the rotation took place. If the number of detents is more than 1 or less than -1, when the first detent of rotation took place.
Change mode: ON_CHANGE
Access mode: READ
Enum type: RotaryInputType
Unit type: N/A
Release: Android 13
IGNITION_STATE
Represents ignition state.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleIgnitionState
Unit type: N/A
Release: Android 13
INFO_DRIVER_SEAT
Driver's seat location VHAL implementations must ignore the areaId. Use
VehicleArea:GLOBAL
Change mode: STATIC
Access mode: READ
Enum type: VehicleAreaSeat
Unit type: N/A
Release: Android 13
INFO_EV_BATTERY_CAPACITY
Nominal battery capacity for EV or hybrid vehicle. Returns the nominal battery capacity, EV
or hybrid. This is the total usable battery capacity when the vehicle is new. This value may
differ from EV_CURRENT_BATTERY_CAPACITY
because
EV_CURRENT_BATTERY_CAPACITY
returns the real-time usable battery capacity taking
into account factors such as battery aging and temperature dependency.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13
INFO_EV_CONNECTOR_TYPE
List of connectors this EV may use. If the vehicle has multiple charging ports, this property must return all possible connector types that can be used by at least one charging port on the vehicle.
Change mode: STATIC
Access mode: READ
Enum type: EvConnectorType
Unit type: N/A
Release: Android 13
INFO_EV_PORT_LOCATION
This property must communicate the location of the charging port on the EV using the
PortLocationType enum. If a vehicle has multiple ports, this property must return
the port that allows the fastest charging. To communicate all port locations, use
INFO_MULTI_EV_PORT_LOCATIONS
Access mode: READ
Enum type:
PortLocationType
Unit type: N/A
Release: Android 13
INFO_EXTERIOR_DIMENSIONS
Exterior dimensions of vehicle:
- Height:
int32Values[0]
- Length:
int32Values[1]
- Width:
int32Values[2]
- Width, including mirrors:
int32Values[3]
- Wheel base, including mirrors:
int32Values[4]
- Track width front:
int32Values[5]
- Track width rear:
int32Values[6]
- Curb-to-curb turning diameter:
int32Values[7]
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLIMETER
Release: Android 13
INFO_FUEL_CAPACITY
Fuel capacity of the vehicle in milliliters. This property must communicate the maximum amount
of fuel that can be stored in the vehicle in milliliters. This property does not apply to electric
vehicles (EV). That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, INFO_FUEL_CAPACITY must not be implemented.
For EVs, implement INFO_EV_BATTERY_CAPACITY.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13
INFO_FUEL_DOOR_LOCATION
Fuel door location. This property must communicate the location of the fuel door on the vehicle.
This property does not apply to EVs. That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For EVs,
implement INFO_EV_PORT_LOCATION
or INFO_MULTI_LOCATIONS
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_FUEL_TYPE
List of fuels the vehicle may use. FuelType::FUEL_TYPE_ELECTRIC
must only be
included if the vehicle can plug-in rechargeable. For example, a Fully Hybrid Electric Vehicle
(FHEV) must not include FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC
value for INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC value for
INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such,
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
Change mode: STATIC
Access mode: READ
Enum type: FuelType
Unit type: N/A
Release: Android 13
INFO_MAKE
Manufacturer of vehicle. This property must communicate the vehicle's public brand name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL
Model of vehicle. This property must communicate the vehicle's public model name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL_YEAR
Model year of vehicle in `YYYY` format based on the Gregorian calendar.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:YEAR
Release: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
Multiple EV port locations. Implement this property if the vehicle has multiple EV ports. Port locations are defined in PortLocationType. For example, a car has one port front left and one port rear left:
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
If a vehicle has only one port, this property's value should list one element. To describe one port location, see INFO-EV-PORT-LOCATION
.
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_VIN
VIN of vehicle.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INITIAL_USER_INFO
Defines the Android user to be used during initialization. This property is called by
the Android system when it initializes and lets the HAL define which Android user should be
started. This request is made by setting a VehiclePropValue (defined by
InitialUserInfoRequest
), and the HAL must respond with a property change event (defined
by InitialUserInfoResponse).
If the HAL doesn't respond after a time defined by the Android system, the Android system proceeds
as if HAL returned a response of action InitialUserInfoResponseAction:DEFAULT.
For example, on first boot, the request could be:
int32[0] 42 // request id (arbitrary number set by Android system) int32[1] 1 // InitialUserInfoRequestType::FIRST_BOOT int32[2] 0 // id of current user (usersInfo.currentUser.userId) int32[3] 1 // flag of current user (usersInfo.currentUser.flags = SYSTEM) int32[4] 1 // number of existing users (usersInfo.numberUsers); int32[5] 0 // user #0 (usersInfo.existingUsers[0].userId) int32[6] 1 // flags of user #0 (usersInfo.existingUsers[0].flags)
int32[0] 42 // must match the request id from the request int32[1] 2 // action = InitialUserInfoResponseAction::CREATE int32[2] -10000 // userToSwitchOrCreate.userId (not used as user will be created) int32[3] 8 // userToSwitchOrCreate.flags = ADMIN string: "||Owner" // userLocales + separator + userNameToCreate
InitialUserInfoResponseAction:CREATE
). For example, to create the
same Owner user with en-US and pt-BR locales, the string value of the response is
en-US,pt-BR||Owner. As such, neither the locale nor the name can contain two vertical bars
(||
) in their values, although you can use a single vertical bar (|
).
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
J ke R
LANE_CENTERING_ASSIST_COMMAND
Perintah Lane Centering Assist (LCA). Perintah untuk mengaktifkan dan menangguhkan LCA.
Saat perintah ACTIVATE
dari LaneCenteringAssistCommand
dikirim,
LANE_CENTERING_ASSIST_STATE
harus ditetapkan ke LaneCenteringAssistState#ACTIVATION_REQUESTED
. Saat
perintah ACTIVATE
berhasil,
LANE_CENTERING_ASSIST_STATE
harus ditetapkan ke LaneCenteringAssistState#ACTIVATED
.
Saat perintah
DEACTIVATE
dari LaneCenteringAssistCommand
berhasil,
LANE_CENTERING_ASSIST_STATE
harus ditetapkan ke
LaneCenteringAssistState#ENABLED
Untuk ID area global (0), VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua
nilai enum LaneCenteringAssistCommand
didukung. Jika properti ini tidak tersedia
karena LCA dinonaktifkan (misalnya, LANE_CENTERING_ASSIST_ENABLED
bernilai salah), properti
ini harus
menampilkan StatusCode#NOT_AVAILABLE_DISABLED
. Jika LANE_CENTERING_ASSIST_STATE
diterapkan dan
status ditetapkan ke nilai ErrorState
, properti ini harus menampilkan StatusCode
yang selaras dengan
nilai ErrorState
. Misalnya, jika LANE_CENTERING_ASSIST_STATE
ditetapkan ke
ErrorState#NOT_AVAILABLE_SPEED_LOW
, properti ini harus menampilkan
StatusCode#NOT_AVAILABLE_SPEED_LOW
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: LaneCenteringAssistCommand
Jenis unit: T/A
Rilis: Android 14
LANE_CENTERING_ASSIST_ENABLED
Aktifkan atau nonaktifkan Bantuan Pemusatan Jalur (LCA). Tetapkan ke true untuk mengaktifkan LCA dan false untuk menonaktifkan LCA. Saat LCA diaktifkan, sistem ADAS di kendaraan harus diaktifkan dan menunggu sinyal aktivasi dari pengemudi. Setelah fitur diaktifkan, sistem ADAS akan mengemudikan kendaraan agar tetap berada di tengah jalurnya saat ini.
Fitur ini berbeda dengan Lane Keep Assist (LKA) yang memantau apakah pengemudi tidak sengaja
menyimpang ke arah atau melewati marka jalan. Jika penyimpangan jalur yang tidak disengaja terdeteksi, sistem akan menerapkan kontrol kemudi untuk mengembalikan kendaraan ke jalur saat ini.
Secara umum, LANE_CENTERING_ASSIST_ENABLED
harus selalu menampilkan true atau false. Jika
fitur tidak tersedia karena beberapa status sementara, seperti kecepatan kendaraan terlalu rendah atau
terlalu tinggi, informasi tersebut harus disampaikan melalui nilai ErrorState
di
properti LANE_CENTERING_ASSIST_STATE
.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
LANE_CENTERING_ASSIST_STATE
Status Lane Centering Assist (LCA). Menampilkan status LCA saat ini. Properti ini harus selalu
menampilkan status yang valid yang ditentukan dalam LaneCenteringAssistState
atau ErrorState
Properti ini tidak boleh menampilkan error melalui StatusCode
dan harus menggunakan status error
yang didukung.
Jika LCA menyertakan peringatan penyimpangan jalur, peringatan tersebut harus ditampilkan melalui properti Peringatan Penyimpangan Jalur (LDW).
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status LaneCenteringAssistState
(termasuk OTHER, yang tidak direkomendasikan) dan ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: LaneCenteringAssistState/ErrorState
Jenis unit: T/A
Rilis: Android 14
LANE_DEPARTURE_WARNING_ENABLED
Aktifkan atau nonaktifkan Peringatan Penyimpangan Jalur (LDW). Tetapkan ke true untuk mengaktifkan LDW dan false untuk menonaktifkan LDW. Jika LDW diaktifkan, sistem ADAS di kendaraan harus diaktifkan dan memantau apakah kendaraan mendekati atau melintasi garis lajur, jika demikian, peringatan akan diberikan.
Secara umum, LANE_DEPARTURE_WARNING_ENABLED
harus selalu menampilkan true atau false. Jika
fitur tidak tersedia karena beberapa status sementara, seperti kecepatan kendaraan terlalu rendah
atau terlalu tinggi, informasi tersebut harus disampaikan melalui nilai ErrorState
di
properti LANE_DEPARTURE_WARNING_STATE
.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
LANE_DEPARTURE_WARNING_STATE
Status Peringatan Penyimpangan Jalur (LDW). Menampilkan status LDW saat ini. Properti ini harus selalu
menampilkan status yang valid yang ditentukan dalam LaneDepartureWarningState
atau ErrorState
Properti ini tidak boleh menampilkan error melalui StatusCode
dan harus menggunakan status error yang didukung
sebagai gantinya.
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status LaneDepartureWarningState
(termasuk OTHER, yang tidak direkomendasikan) dan ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: LaneDepartureWarningState/ErrorState
Jenis unit: T/A
Rilis: Android 14
LANE_KEEP_ASSIST_ENABLED
Aktifkan atau nonaktifkan Lane Keep Assist (LKA). Tetapkan ke true untuk mengaktifkan LKA dan false untuk menonaktifkan LKA. Jika LKA diaktifkan, sistem ADAS di kendaraan harus diaktifkan dan memantau apakah pengemudi secara tidak sengaja menyimpang ke arah atau melewati marka jalan. Jika penyimpangan jalur yang tidak disengaja terdeteksi, sistem akan menerapkan kontrol kemudi untuk mengembalikan kendaraan ke jalur saat ini. Hal ini berbeda dengan Lane Centering Assist (LCA) yang, saat diaktifkan, menerapkan kontrol kemudi berkelanjutan untuk menjaga kendaraan tetap berada di tengah jalur saat ini.
Secara umum, LANE_KEEP_ASSIST_ENABLED
harus selalu menampilkan true atau false. Jika
fitur tidak tersedia karena beberapa status sementara, seperti kecepatan kendaraan terlalu rendah atau
terlalu tinggi, informasi tersebut harus disampaikan melalui nilai ErrorState
di
properti LANE_KEEP_ASSIST_STATE
.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
LANE_KEEP_ASSIST_STATE
Status Lane Keep Assist (LKA). Menampilkan status LKA saat ini. Properti ini harus selalu menampilkan
status yang valid yang ditentukan di LaneKeepAssistState
atau ErrorState
. Properti ini tidak boleh
menampilkan error melalui StatusCode
dan harus menggunakan status error yang didukung
Jika LKA menyertakan peringatan penyimpangan jalur sebelum menerapkan koreksi kemudi, peringatan tersebut harus ditampilkan melalui properti Peringatan Penyimpangan Jalur (LDW).
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues
harus ditentukan
kecuali jika semua status LaneKeepAssistState
(termasuk OTHER, yang tidak direkomendasikan) dan
ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: LaneKeepAssistState/ErrorState
Jenis unit: T/A
Rilis: Android 14
LOCATION_CHARACTERIZATION
Karakterisasi input yang digunakan untuk menghitung lokasi. Properti ini harus menunjukkan data dan input sensor apa (jika ada) yang dipertimbangkan oleh sistem saat menghitung lokasi kendaraan yang dibagikan ke Android melalui HAL GNSS.
Nilai harus menampilkan kumpulan flag bit. Flag bit ditentukan di
LocationCharacterization. Nilai juga harus menyertakan tepat satu dari DEAD_RECKONED
atau
RAW_GNSS_ONLY
di antara kumpulan flag bitnya.
Jika properti ini tidak didukung, diasumsikan bahwa tidak ada input sensor tambahan yang digabungkan ke dalam update GNSS yang disediakan melalui HAL GNSS. Kecuali jika ditentukan lain melalui antarmuka HAL GNSS.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
MIRROR_AUTO_FOLD_ENABLED
Merepresentasikan properti untuk fitur Lipat Otomatis Cermin. Properti ini bernilai benar jika fitur untuk melipat spion samping kendaraan secara otomatis (misalnya, saat spion dilipat ke dalam secara otomatis saat seseorang keluar dan mengunci kendaraan) diaktifkan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
MIRROR_AUTO_TILT_ENABLED
Merepresentasikan properti untuk fitur Mirror Auto Tilt. Properti ini bernilai benar jika fitur untuk memiringkan spion samping kendaraan secara otomatis (misalnya, saat spion miring ke bawah secara otomatis saat kendaraan dimundurkan) diaktifkan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
MIRROR_FOLD
Lipat cermin. True menunjukkan spion dilipat. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat menerapkannya sebagai
VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
MIRROR_LOCK
Kunci cermin. Benar menunjukkan posisi pencerminan dikunci dan tidak dapat diubah.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
MIRROR_Y_MOVE
Mencerminkan gerakan Y. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum cermin saat miring
ke kanan. minInt32Value
mewakili kecepatan gerakan maksimum cermin saat
miring ke kiri.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah mirror mencapai batas posisi, nilai harus direset ke 0. Jika nilai MIRROR_Y_MOVE saat ini adalah 0, berarti tidak ada gerakan yang terjadi saat ini.
Properti ini tidak dalam unit tertentu, tetapi dalam rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
MIRROR_Y_POS
Mencerminkan posisi Y. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa cermin miring sepenuhnya ke kiri.
Nilai ini harus berupa nilai non-positif. maxInt32Value
menunjukkan bahwa cermin miring
sepenuhnya
ke kanan. Nilai ini harus berupa nilai positif. 0 menunjukkan bahwa cermin tidak miring ke salah satu
arah.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status transisi
antara posisi ekstrem kiri
dan ekstrem kanan.
Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
MIRROR_Z_MOVE
Gerakan Z cermin. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum cermin saat dimiringkan ke atas.
minInt32Value
mewakili kecepatan gerakan maksimum cermin saat dimiringkan ke bawah.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah mirror mencapai batas posisi, nilai harus direset ke 0. Jika nilai MIRROR_Z_MOVE saat ini adalah 0, berarti tidak ada gerakan yang terjadi saat ini.
Properti ini tidak dalam unit tertentu, tetapi dalam rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
MIRROR_Z_POS
Mencerminkan posisi Z. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung. minInt32Value
menunjukkan
cermin dimiringkan sepenuhnya ke bawah. Nilai ini harus berupa nilai non-positif. maxInt32Value
menunjukkan bahwa cermin dimiringkan sepenuhnya ke atas. Nilai ini harus berupa
nilai positif. 0 menunjukkan bahwa cermin tidak miring ke salah satu arah.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan
status transisi antara posisi sepenuhnya ke bawah dan sepenuhnya ke atas.
Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
NIGHT_MODE
Benar menunjukkan bahwa sensor mode malam telah mendeteksi lingkungan kabin mobil memiliki cahaya redup. Platform ini dapat menggunakannya untuk, misalnya, mengaktifkan UI yang sesuai untuk tampilan yang lebih baik di lingkungan gelap atau minim cahaya.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
OBD2_FREEZE_FRAME
Melaporkan snapshot nilai sensor OBD2 yang tersedia pada saat terjadi kerusakan
dan terdeteksi. configArray harus diberikan dengan arti yang sama seperti yang ditentukan untuk
OBD2_LIVE_FRAME
Nilai properti ini harus ditafsirkan dengan cara yang serupa dengan yang digunakan untuk
OBD2_LIVE_FRAME
, dengan pengecualian bahwa kolom stringValue dapat berisi
kode pemecahan masalah diagnostik (DTC) yang tidak kosong.
Permintaan IVehicle#get dari properti ini harus memberikan nilai untuk int64Values[0]. Ini ditafsirkan
sebagai stempel waktu frame beku yang akan diambil. Daftar stempel waktu dapat diperoleh dengan
IVehicle#get dari OBD2_FREEZE_FRAME_INFO
Jika tidak ada frame beku yang tersedia pada stempel waktu yang diberikan, respons
NOT_AVAILABLE
harus ditampilkan oleh implementasi. Karena kendaraan mungkin memiliki
penyimpanan terbatas untuk frame beku, permintaan frame dapat merespons dengan
NOT_AVAILABLE
meskipun stempel waktu terkait baru saja diperoleh melalui
OBD2_FREEZE_FRAME_INFO
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
OBD2_FREEZE_FRAME_CLEAR
Freeze frame dihapus. Melaporkan snapshot nilai sensor OBD2 yang tersedia pada saat
terjadi dan terdeteksi kerusakan. configArray harus diberikan dengan arti yang sama seperti yang ditentukan untuk OBD2_LIVE_FRAME
Nilai properti ini harus ditafsirkan dengan cara yang serupa dengan yang digunakan untuk
OBD2_LIVE_FRAME
, dengan pengecualian bahwa kolom stringValue dapat berisi kode pemecahan masalah
diagnostik (DTC) yang tidak kosong.
Permintaan IVehicle#get dari properti ini harus memberikan nilai untuk int64Values[0]. Ini akan
ditafsirkan sebagai stempel waktu frame beku yang akan diambil. Daftar stempel waktu dapat diperoleh oleh IVehicle#get dari OBD2_FREEZE_FRAME_INFO
Jika tidak ada frame beku yang tersedia pada stempel waktu yang diberikan, respons NOT_AVAILABLE
harus
ditampilkan oleh implementasi. Karena kendaraan mungkin memiliki penyimpanan terbatas untuk frame beku,
permintaan frame dapat merespons dengan NOT_AVAILABLE
meskipun stempel waktu
terkait baru-baru ini diperoleh melalui OBD2_FREEZE_FRAME_INFO
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
OBD2_FREEZE_FRAME_INFO
Properti ini menjelaskan frame beku saat ini yang disimpan dalam memori kendaraan dan tersedia untuk
pengambilan melalui OBD2_FREEZE_FRAME
Nilainya harus ditafsirkan sebagai berikut. Setiap elemen
int64Values harus berupa stempel waktu saat kode error telah terdeteksi dan frame beku
yang sesuai disimpan, dan setiap elemen tersebut dapat digunakan sebagai kunci ke OBD2_FREEZE_FRAME
untuk
mengambil frame beku yang sesuai.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
OBD2_LIVE_FRAME
Melaporkan ringkasan nilai sensor OBD2 saat ini (live) yang tersedia. configArray ditetapkan sebagai berikut:
configArray[0]
Jumlah sensor bernilai bilangan bulat khusus vendorconfigArray[1]
Jumlah sensor bernilai float khusus vendor
Nilai properti ini harus ditafsirkan seperti dalam contoh berikut. Mengingat
configArray = {2,3} int32Values
harus berupa vektor yang berisi
Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX
ditambah dua elemen (atau, 33 elemen).
floatValues
harus berupa vektor yang berisi
Obd2FloatSensorIndex.LAST_SYSTEM_INDEX
ditambah tiga elemen (atau, 73 elemen).
Setiap frame dapat berisi subset nilai sensor yang berbeda, baik sensor
yang disediakan sistem, maupun sensor khusus vendor. Untuk mendukung hal ini, elemen byte dari
nilai properti digunakan sebagai bitmask. Byte harus memiliki jumlah byte yang memadai untuk mewakili
jumlah total kemungkinan sensor (dalam hal ini, 14 byte untuk mewakili 106 kemungkinan nilai).
Nilai ini harus dibaca sebagai bitmask yang berurutan sehingga setiap bit menunjukkan keberadaan atau tidak adanya
sensor dari frame, dimulai dengan jumlah bit sebanyak ukuran int32Values
,
yang segera diikuti dengan jumlah bit sebanyak ukuran floatValues.
Misalnya, jika bytes[0] = 0x4C (0b01001100)
, artinya:
int32Values[0 and 1]
bukan nilai sensor yang validint32Values[2 and 3]
adalah nilai sensor yang validint32Values[4 and 5]
bukan nilai sensor yang validint32Values[6]
adalah nilai sensor yang validint32Values[7]
bukan nilai sensor yang validint32Values[0 and 1]
bukan nilai sensor yang validint32Values[2 and 3]
adalah nilai sensor yang validint32Values[4 and 5]
bukan nilai sensor yang validint32Values[6]
adalah nilai sensor yang validint32Values[7]
bukan nilai sensor yang valid
Jika bytes[5] = 0x61 (0b01100001)
, maka:
int32Values[32]
adalah nilai sensor yang validfloatValues[0 thru 3]
adalah nilai sensor yang tidak validfloatValues[4 and 5]
adalah nilai sensor yang validfloatValues[6]
bukan nilai sensor yang valid.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
ON_CHANGE
Mode perubahan:
Mode akses: READ_WRITE/READ
Jenis enum:
VehicleLightSwitch
Jenis unit:T/A
Rilis: Android 13
PARKING_BRAKE_AUTO_APPLY
Menerapkan rem parkir secara otomatis. Jika benar, properti ini menunjukkan bahwa rem parkir otomatis
mobil diaktifkan. Salah menunjukkan bahwa fitur rem parkir otomatis
mobil dinonaktifkan. Properti ini sering kali dikacaukan dengan PARKING_BRAKE_ON
. Perbedaannya adalah PARKING_BRAKE_ON
menunjukkan apakah rem parkir sebenarnya
aktif atau nonaktif, sedangkan PARKING_BRAKE_AUTO_APPLY
menunjukkan apakah fitur rem parkir otomatis
diaktifkan atau dinonaktifkan dan tidak menjelaskan status rem parkir
sebenarnya saat ini.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
PARKING_BRAKE_ON
Status rem parkir. Jika benar, properti ini menunjukkan bahwa rem parkir mobil aktif. Salah menunjukkan bahwa rem parkir mobil dilepas.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
PER_DISPLAY_BRIGHTNESS
Properti untuk merepresentasikan kecerahan layar yang dikontrol secara terpisah.
Beberapa mobil memiliki satu atau beberapa layar yang kecerahannya dikontrol secara terpisah dan properti ini
untuk menginformasikan kecerahan setiap layar penumpang. Di mobil yang kecerahan semua layarnya
dikontrol secara bersamaan, mobil tersebut harus menggunakan DISPLAY_BRIGHTNESS
Hanya salah satu dari PER_DISPLAY_BRIGHTNESS
danPER_DISPLAY_BRIGHTNESS
yang harus diterapkan. Jika keduanya
tersedia, PER_DISPLAY_BRIGHTNESS
akan digunakan oleh AAOS.
Port tampilan secara unik mengidentifikasi konektor fisik di perangkat untuk output tampilan, yang berkisar dari 0 hingga 255.
int32Values[0]
Port tampilanint32Values[1]
Kecerahan
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
PERF_ODOMETER
Nilai odometer kendaraan saat ini.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:KILOMETER
Rilis: Android 13
PERF_REAR_STEERING_ANGLE
Sudut kemudi model sepeda belakang untuk kendaraan. Sudut diukur dalam derajat. Kiri adalah negatif. Properti ini tidak bergantung pada sudut kemudi. Properti ini harus menyampaikan sudut roda belakang sehubungan dengan kendaraan, bukan sudut kemudi.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:DEGREES
Rilis: Android 13
PERF_STEERING_ANGLE
Sudut kemudi model sepeda depan untuk kendaraan. Sudut diukur dalam derajat. Kiri adalah negatif. Properti ini tidak bergantung pada sudut kemudi. Properti ini harus menyampaikan sudut roda depan sehubungan dengan kendaraan, bukan sudut kemudi.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:DEGREES
Rilis: Android 13
PERF_VEHICLE_SPEED
Kecepatan kendaraan, Nilai harus positif saat kendaraan bergerak maju dan
negatif saat kendaraan mundur. Nilai ini tidak bergantung pada nilai roda gigi
(CURRENT_GEAR
atau GEAR_SELECTION
). Misalnya, jika
GEAR_SELECTION
adalah GEAR_NEUTRAL
, PERF_VEHICLE_SPEED
positif saat kendaraan bergerak maju, negatif saat mundur, dan nol saat tidak bergerak.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis unit: T/A
Jenis unit: VehicleUnit:METER_PER_SEC
Rilis: Android 13
PERF_VEHICLE_SPEED_DISPLAY
Kecepatan kendaraan untuk layar, Beberapa mobil menampilkan kecepatan yang sedikit lebih lambat di speedometer daripada kecepatan sebenarnya.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:METER_PER_SEC
Rilis: Android 13
POWER_POLICY_GROUP_REQ
Menentukan permintaan untuk menetapkan grup kebijakan daya yang digunakan untuk menentukan kebijakan daya default per transisi status daya.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
POWER_POLICY_REQ
Menentukan permintaan untuk menerapkan kebijakan daya. VHAL menetapkan properti ini untuk mengubah kebijakan daya mobil.
Layanan kebijakan daya mobil berlangganan properti ini dan benar-benar mengubah kebijakan daya. Permintaan
dibuat dengan menetapkan VehiclePropValue dengan ID kebijakan daya yang ditentukan di
/vendor/etc/automotive/power_policy.xml
Jika ID yang diberikan tidak ditentukan, layanan kebijakan daya mobil
akan mengabaikan permintaan dan kebijakan daya saat ini akan dipertahankan.
string: "sample_policy_id" // power policy ID
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
POWER_POLICY_GROUP_REQ
Menentukan permintaan untuk menetapkan grup kebijakan daya yang digunakan untuk menentukan kebijakan daya default per transisi status daya. VHAL menetapkan properti ini dengan ID grup kebijakan daya untuk menetapkan kebijakan daya default yang diterapkan pada transisi status daya. Grup kebijakan daya ditentukan di /vendor/etc/power_policy.xml. Jika ID yang diberikan tidak ditentukan, layanan kebijakan daya mobil akan mengabaikan permintaan. Layanan kebijakan daya mobil berlangganan properti ini dan menetapkan grup kebijakan daya. Penerapan kebijakan daya yang sebenarnya terjadi saat status daya sistem berubah dan ada kebijakan daya yang dipetakan dan valid untuk status daya baru.
string: "sample_policy_group_id" // power policy group ID
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
RANGE_REMAINING
Jarak yang tersisa. Meter yang tersisa dari bahan bakar dan daya. Rentang yang tersisa harus memperhitungkan semua
sumber energi dalam kendaraan. Misalnya, jangkauan mobil hibrida adalah jumlah jangkauan berdasarkan
bahan bakar dan baterai. Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
karena aplikasi navigasi dapat memperbarui rentang jika memiliki estimasi yang lebih akurat berdasarkan
rute mendatang. Properti ini hanya dapat diimplementasikan sebagai VehiclePropertyAccess.READ
atas pertimbangan OEM.
Mode perubahan: CONTINUOUS
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: VehicleUnit:METER
Rilis: Android 13
READING_LIGHTS_STATE
Menampilkan status lampu baca saat ini.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
READING_LIGHTS_SWITCH
Tombol untuk mengontrol lampu baca. Hal ini mungkin berbeda dengan READING_LIGHTS_STATE
jika lampu menyala karena pintu terbuka atau karena perintah suara. Misalnya, saat tombol
berada dalam posisi nonaktif atau otomatis. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat menerapkannya sebagai
VehiclePropertyAccess.READ
saja.
REAR_FOG_LIGHTS_STATE
Menampilkan status lampu kabut belakang saat ini. Hanya salah satu dari FOG_LIGHTS_STATE
atau
REAR_FOG_LIGHTS_STATE
yang dapat diterapkan. Lihat FOG_LIGHTS_STATE
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
REAR_FOG_LIGHTS_SWITCH
Setelan yang diinginkan pengguna. Hanya salah satu dari FOG_LIGHTS_SWITCH
atau
REAR_FOG_LIGHTS_SWITCH
yang harus
diterapkan. Lihat FOG_LIGHTS_SWITCH
untuk mempelajari lebih lanjut. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat menerapkannya sebagai
VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
REMOVE_USER
Dipanggil oleh Sistem Android setelah pengguna Android dihapus. HAL dapat menggunakan properti ini untuk menghapus pengguna yang setara. Ini adalah panggilan hanya tulis. Sistem Android tidak mengharapkan balasan dari HAL. Oleh karena itu, permintaan ini tidak akan gagal. Jika pengguna HAL yang setara tidak dapat dihapus, HAL harus menandainya sebagai tidak aktif atau memulihkan dengan cara lain.
Permintaan dibuat dengan menetapkan VehiclePropValue dengan konten yang ditentukan oleh
RemoveUserRequest
Misalnya, jika sistem memiliki 3 pengguna (0, 10, dan 11) dan pengguna 11
dihapus, permintaannya adalah:
int32[0]
42 // request idint32[1]
11 // (ID pengguna Android dari pengguna yang dihapus)int32[2]
0 // (Flag pengguna Android dari pengguna yang dihapus)int32[3]
10 // pengguna saat iniint32[4]
0 // flag pengguna saat ini (tidak ada)int32[5]
2 // jumlah penggunaint32[6]
0 // pengguna pertama (pengguna 0)int32[7]
0 // flag pengguna pertama (tidak ada)int32[8]
10 // pengguna kedua (pengguna 10)int32[9
] 0 // flag pengguna kedua (tidak ada)
Mode perubahan: STATIC
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
S ke Z
SEAT_AIRBAG_ENABLED
Mewakili fitur untuk mengaktifkan dan menonaktifkan kemampuan kursi untuk mengeluarkan kantong udara saat dipicu
(misalnya, dalam tabrakan). Jika true
, artinya kantong udara kursi diaktifkan dan,
jika dipicu, mereka akan men-deploy-nya. Jika true
, airbag kursi akan dinonaktifkan, dan tidak akan
mengembang dalam situasi apa pun. Properti ini tidak menunjukkan apakah kantong udara sudah dikerahkan.
Properti ini dapat disetel ke VehiclePropertyAccess.READ
hanya baca untuk tujuan
peraturan atau masalah keamanan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_BACKREST_ANGLE_1_MOVE
Sudut sandaran kursi 1 bergerak. maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig
harus ditentukan. Semua bilangan bulat di antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum sandaran kursi saat
miring ke depan. minInt32Value
menunjukkan kecepatan pergerakan maksimum kursi
sandaran saat berbaring.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
sandaran kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai untuk
SEAT_BACKREST_ANGLE_1_MOVE
adalah 0, tidak ada gerakan yang terjadi.
Properti ini direpresentasikan dalam rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_BACKREST_ANGLE_1_POS
Sudut sandaran kursi 1. Sudut cadangan 1 adalah aktuator yang paling dekat dengan bagian bawah
di seluruh kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditetapkan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung. minInt32Value
menunjukkan
posisi berbaring penuh sandaran kursi sehubungan dengan aktuator di bagian bawah kursi. Tujuan
maxInt32Value
menunjukkan posisi sandaran kursi yang paling tegak atau depan dengan
memperhatikan aktuator di bagian bawah kursi.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan status transisi
antara posisi berbaring penuh dan posisi tegak serta ke depan.
Properti ini ditampilkan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_BACKREST_ANGLE_2_MOVE
Kursi sandaran punggung sudut 2 bergerak. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum sandaran kursi saat
mengarahkannya ke depan. minInt32Value
mewakili kecepatan gerakan maksimum sandaran
kursi saat direbahkan.
Nilai absolut yang lebih besar, positif atau negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
sandaran kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai untuk
SEAT_BACKREST_ANGLE_2_MOVE
saat ini 0, tidak ada gerakan yang sedang berlangsung.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_BACKREST_ANGLE_2_POS
Posisi sudut sandaran kursi 2. Sudut sandaran 2 adalah aktuator berikutnya dari bagian bawah di seluruh kursi.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig
harus ditetapkan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus #0supported.
minInt32Value
menunjukkan posisi sandaran kursi yang direbahkan sepenuhnya sehubungan
dengan aktuator berikutnya di sandaran dari yang ada di bagian bawah kursi (lihat
SEAT_BACKREST_ANGLE_1_POS
untuk mengetahui detailnya). maxInt32Value
menunjukkan
posisi sandaran kursi yang paling tegak dan ke depan sehubungan dengan aktuator berikutnya di sandaran
dari yang ada di bagian bawah kursi (lihat SEAT_BACKREST_ANGLE_1_POS
untuk mengetahui detailnya).
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
antara posisi berbaring penuh dan tegak dan maju.
Properti ini ditampilkan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
KURSI_BELT_BUCKLED
Sabuk pengaman terpasang. True menunjukkan sabuk gesper. Akses tulis menunjukkan kemampuan pengencang sabuk pengaman otomatis. Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM
dapat menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_BELT_HEIGHT_MOVE
Pergerakan tinggi sabuk pengaman. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditetapkan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum bahu sabuk pengaman
anchor sambil bergerak ke atas. minInt32Value
menunjukkan kecepatan gerakan maksimum
jangkar bahu sabuk pengaman sambil bergerak ke bawah.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
sabuk pengaman mencapai batas posisi, nilai harus direset ke 0. Jika nilai
SEAT_BELT_HEIGHT_MOVE
adalah 0, tidak ada gerakan yang sedang berlangsung.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif tertentu.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_BELT_HEIGHT_POS
Posisi ketinggian sabuk pengaman. Sesuaikan titik link sabuk bahu.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
minInt32Value
menunjukkan bahwa anchor bahu sabuk pengaman berada di titik terendah
posisi Anda. maxInt32Value
menunjukkan bahwa anchor bahu sabuk pengaman berada di titik
posisi tertinggi.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
status di antara posisi terendah dan tertinggi.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_CUSHION_SIDE_SUPPORT_MOVE
Mewakili properti untuk arah gerakan dan kecepatan penyangga samping bantalan kursi.
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum sisi bantalan kursi
dukungan saat menjadi lebih luas (misalnya, dukungan menurun). minInt32Value
mewakili kecepatan gerakan maksimum dukungan samping bantalan kursi saat semakin sempit
(misalnya, dukungan meningkat).
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
dukungan samping bantalan kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai
SEAT_CUSHION_SIDE_SUPPORT_MOVE
adalah 0, maka tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_CUSHION_SIDE_SUPPORT_POS
Mewakili properti untuk posisi penyangga sisi pinggul (sisi bantalan bawah).
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat
antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan bahwa penyangga sisi bantalan kursi berada di posisi terlebar (misalnya,
paling sedikit mendukung). minInt32Value
menunjukkan bahwa dukungan samping bantalan kursi berada dalam posisi
tertipis (misalnya, sebagian besar dukungan).
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status transisi antara
posisi tertipis dan terluas.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai <covehiclepropertyaccess.read< code=""> saja.</covehiclepropertyaccess.read<>
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_DEPTH_MOVE
Pergerakan kedalaman kursi.
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus
didefinisikan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum kursi saat menjadi
lebih dalam. minInt32Value
mewakili kecepatan gerakan maksimum kursi saat
menjadi lebih dangkal.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
sandaran kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai untuk
SEAT_DEPTH_MOVE
saat ini 0, tidak ada gerakan yang sedang berlangsung.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_DEPTH_POS
Posisi kedalaman kursi. Menetapkan kedalaman kursi, jarak dari sandaran belakang ke tepi depan kursi.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua bilangan bulat
antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa kursi berada di posisi terendah (misalnya, posisi dengan
jarak terkecil antara tepi depan bantalan kursi dan ujung belakang kursi).
maxInt32Value
menunjukkan bahwa kursi berada di posisi terdalamnya (misalnya, posisi dengan jarak terbesar antara tepi depan bantalan kursi dan ujung belakang kursi).
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status transisi antara
posisi paling dangkal dan paling dalam.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai <covehiclepropertyaccess.read< code=""> only..</covehiclepropertyaccess.read<>
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_EASY_ACCESS_ENABLED
Mewakili properti untuk fitur Akses mudah kursi. Jika benar, kursi akan otomatis disesuaikan
untuk memudahkan penumpang masuk dan keluar kendaraan. Setiap ID area harus dipetakan ke
kursi yang dicoba dimasuki/ditinggalkan pengguna dengan bantuan fitur akses mudah.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai <covehiclepropertyaccess.read< code=""> khusus.</covehiclepropertyaccess.read<>
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_FOOTWELL_LIGHTS_STATE
Mewakili properti untuk status lampu kaki kursi. SEAT_FOOTWELL_LIGHTS_STATE
mencerminkan
kondisi lampu saat ini pada waktu tertentu. Fungsi ini berbeda dengan
SEAT_FOOTWELL_LIGHTS_SWITCH
yang mewakili posisi tombol yang mengontrol lampu.
Oleh karena itu, SEAT_FOOTWELL_LIGHTS_STATE
mungkin tidak cocok dengan nilai SEAT_FOOTWELL_LIGHTS_SWITCH
(misalnya, SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
dan SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
Properti ini hanya boleh diterapkan jika nilai SEAT_FOOTWELL_LIGHTS_STATE
mungkin berbeda
dari CABIN_LIGHTS_State.
Untuk setiap ID area yang didukung, VehicleAreaConfig#supportedEnumValues harus ditentukan kecuali jika semua nilai enum VehicleLightState didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 14
SEAT_FOOTWELL_LIGHTS_SWITCH
Merepresentasikan properti untuk tombol lampu ruang kaki kursi. SEAT_FOOTWELL_LIGHTS_SWITCH
mewakili
posisi sakelar yang mengendalikan lampu. Fungsi ini berbeda dengan
SEAT_FOOTWELL_LIGHTS_State yang mencerminkan status lampu saat ini kapan pun.
Oleh karena itu, SEAT_FOOTWELL_LIGHTS_SWITCH
mungkin tidak cocok dengan nilai SEAT_FOOTWELL_LIGHTS_state
(misalnya, SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
dan SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
Properti ini hanya boleh diterapkan jika nilai SEAT_FOOTWELL_LIGHTS_SWITCH mungkin berbeda dari CABIN_LIGHTS_SWITCH.
Untuk setiap ID area yang didukung, VehicleAreaConfig#supportedEnumValues harus ditentukan, kecuali jika semua nilai enum VehicleLightSwitch didukung.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
BERGERAK_KURUS_FASIA_AFT
Kursi bergerak ke depan dan ke belakang. Properti ini memindahkan seluruh kursi ke depan/belakang sesuai dengan arah yang menghadap.
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus
didefinisikan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
maxInt32Value
menunjukkan kecepatan pergerakan maksimum kursi saat bergerak
maju. minInt32Value
mewakili kecepatan gerakan maksimum kursi saat
bergerak mundur.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
kursi mencapai batas posisi, nilai harus diatur ulang ke 0. Jika nilai
SEAT_FORE_AFT_MOVE
adalah 0, tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_FORE_AFT_POS
Posisi depan dan belakang kursi. Mengatur posisi kursi maju dan mundur.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan kursi berada di posisi linear paling belakang.
maxInt32Value
menunjukkan bahwa kursi berada di posisi linear paling depan. Nilai-nilai
antara minInt32Value
dan maxInt32Value
menunjukkan status transisi
antara posisi terdekat dan terjauh.
Properti ini ditampilkan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_ANGLE_MOVE
Gerakan sudut headrest. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditetapkan. Semua bilangan bulat di antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum dari sandaran kepala kursi saat
bergerak ke posisi tegak atau maju. minInt32Value
menunjukkan jumlah maksimum
kecepatan gerakan sandaran kepala kursi sambil bergerak ke posisi dangkal.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Satu kali
sandaran kepala kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai
SEAT_HEADREST_ANGLE_MOVE
adalah 0, maka tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai <covehiclepropertyaccess.read< code=""> saja..</covehiclepropertyaccess.read<>
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_ANGLE_POS
Posisi sudut headrest. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditetapkan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa headrest berada dalam posisi direbahkan sepenuhnya. maxInt32Value
menunjukkan bahwa headrest berada dalam posisi paling tegak dan paling maju.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan
keadaan transisi antara posisi berbaring penuh dan posisi paling tegak dan maju.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkan properti ini sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_FORE_AFT_BERGERAK
Sandaran kepala bergerak ke depan dan ke belakang. maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig
harus ditentukan. Semua bilangan bulat di antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum dari sandaran kepala kursi
sembari bergerak maju. minInt32Value
menunjukkan kecepatan gerakan maksimum
sandaran kepala kursi sambil bergerak mundur.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Satu kali
sandaran kepala kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai
SEAT_HEADREST_FORE_AFT_MOVE
adalah 0, maka tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_FORE_AFT_POS
Posisi depan dan belakang sandaran kepala. maxInt32Value
dan minInt32Value
di VehicleAreaConfig
harus ditentukan. Semua bilangan bulat di antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa headrest berada di posisi linear paling belakang.
maxInt32Value
menunjukkan headrest berada di posisi linear paling depan.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan status transisi antara posisi maju dan mundur.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_HEIGHT_MOVE
Gerakan tinggi sandaran kepala. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum dari sandaran kepala kursi saat
bergerak ke atas. minInt32Value
mewakili kecepatan gerakan maksimum headrest
kursi saat bergerak ke bawah.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
headrest kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai untuk
SEAT_HEADREST_HEIGHT_MOVE
adalah 0, maka tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_HEIGHT_POS
(Tidak digunakan lagi) Posisi tinggi headrest.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_HEIGHT_POS_V2
Posisi tinggi headrest. Menetapkan tinggi headrest untuk kursi yang didukung. VehiclePropConfig.areaConfigs menentukan kursi mana yang didukung.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
minInt32Value
menunjukkan headrest berada di posisi terendah. maxInt32Value
menunjukkan headrest berada di posisi tertingginya.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
status di antara posisi terendah dan tertinggi.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_HEIGHT_MOVE
Pergerakan tinggi kursi. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum kursi saat bergerak ke atas.
minInt32Value
menunjukkan kecepatan gerakan maksimum kursi saat bergerak ke bawah.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
kursi mencapai batas posisi, nilai harus diatur ulang ke 0. Jika nilai
Nilai SEAT_HEIGHT_MOVE
adalah 0, tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEIGHT_POS
Posisi tinggi kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung.
minInt32Value
menunjukkan kursi berada di posisi terendah. maxInt32Value
menunjukkan kursi berada di posisi tertinggi.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
status di antara posisi terendah dan tertinggi.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
BERGERAK_KURUS_LUMBAR_FORE_AFT
Gerakan pinggul ke depan dan belakang. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum penopang pinggang kursi
sembari bergerak maju. minInt32Value
menunjukkan kecepatan gerakan maksimum
penyangga pinggang di kursi sambil bergerak mundur.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat.
Setelah dukungan lumbar kursi mencapai batas posisi, nilai harus direset ke 0.
Jika nilai SEAT_LUMBAR_FORE_AFT_MOVE
adalah 0, berarti tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_LUMBAR_FORE_AFT_POS
Posisi depan dan belakang kayu. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa penopang pinggang berada di posisi paling belakang
(misalnya, posisi yang paling tidak mendukung). maxInt32Value
menunjukkan pinggang
pendukung berada di posisinya yang paling maju (misalnya, posisi yang paling mendukung).
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
di antara posisi maju dan belakang.
Properti ini ditampilkan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Jenis akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
Dukungan sisi pinggang bergerak. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditetapkan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum dukungan sisi lumbar
kursi saat semakin lebar. minInt32Value
mewakili gerakan maksimum
kecepatan penyangga sisi pinggang kursi sambil menjadi lebih tipis.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
dukungan sisi lumbar kursi mencapai batas posisi, nilai harus direset ke 0. Jika
nilai SEAT_LUMBAR_SIDE_SUPPORT_MOVE
0, tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Jenis akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
Posisi penyangga sisi pinggang. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. minInt32Value
menunjukkan bahwa dukungan sisi lumbar berada dalam posisi paling tipis (misalnya, sebagian besar dukungan). maxInt32Value
menunjukkan bahwa dukungan sisi lumbar berada di posisi terluasnya (misalnya,
dukungan paling sedikit).
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi antara posisi paling tipis dan paling lebar.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Jenis akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_LUMBAR_VERTICAL_MOVE
Merepresentasikan properti untuk arah gerakan vertikal dan kecepatan dukungan lumbar kursi.
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung. maxInt32Value
menunjukkan dukungan pinggang bergerak paling cepat
kecepatan ke atas. minInt32Value
menunjukkan dukungan pinggang bergerak paling cepat
kecepatan turunnya.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah dukungan samping bantalan kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai SEAT_LUMBAR_VERTICAL_MOVE adalah 0, berarti tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_LUMBAR_VERTICAL_POS
Mewakili properti untuk posisi vertikal penopang pinggang kursi. maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat di antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan posisi tertinggi dukungan pinggang.
minInt32Value
menunjukkan posisi terendah dukungan pinggang.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
status di antara posisi terendah dan tertinggi.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_MEMORY_SELECT
Parameter ini memilih preset memori yang akan digunakan untuk memilih posisi kursi. maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
selalu 0, dan maxInt32Value
menentukan
jumlah slot memori preset kursi yang tersedia (misalnya, numSeatPresets - 1). Misalnya,
jika kursi pengemudi memiliki tiga preset memori, maxInt32Value
adalah dua. Saat
pengguna memilih preset, nomor preset yang diinginkan (0, 1, atau 2) akan ditetapkan.
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SET_MEMORY_KURSI
Setelan ini memungkinkan pengguna menyimpan setelan posisi kursi saat ini ke preset yang dipilih
slot waktu. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditetapkan. minInt32Value
harus 0, dan
maxInt32Value
untuk setiap posisi kursi harus sama dengan maxInt32Value
untuk
SEAT_MEMORY_SELECT
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
KURSI_SATU_SATU
Menunjukkan apakah kursi tertentu ditempati, sesuai kemampuan mobil untuk menentukan. Nilai yang valid berasal dari enum VehicleSeatOccupancyState
.
Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleSeatOccupancyState
Jenis unit: T/A
Rilis: Android 13
SEAT_TILT_MOVE
Gerakan kemiringan kursi. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. maxInt32Value
mewakili kecepatan gerakan maksimum tepi depan kursi sambil bergerak ke atas. Tujuan
minInt32Value
merepresentasikan kecepatan gerakan maksimum tepi depan kursi
sambil bergerak ke bawah.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah bagian bawah kursi mencapai batas posisi, nilai harus direset ke 0. Jika nilai SEAT_TILT_MOVE saat ini adalah 0, tidak ada gerakan yang sedang berlangsung.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_TILT_POS
Posisi kemiringan kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. minInt32Value
menunjukkan bahwa dasar kursi miring pada posisi sudut terendahnya. Ini sesuai dengan tepi depan
kursi pada posisi serendah mungkin relatif terhadap ujung belakang kursi.
maxInt32Value
menunjukkan bahwa dasar kursi miring pada posisi sudut tertingginya.
Hal ini sesuai dengan tepi depan kursi pada posisi setinggi mungkin dibandingkan dengan bagian belakang
batas waktu.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
status di antara posisi terendah dan tertinggi.
Properti ini direpresentasikan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
SEAT_WALK_IN_POS
Mewakili properti yang menunjukkan posisi walk-in kursi saat ini. minInt32Value
menunjukkan posisi kursi normal. minInt32Value
harus 0. maxInt32Value
menunjukkan bahwa kursi berada dalam posisi masuk penuh.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
keadaan antara posisi normal dan berjalan kaki.
Properti ini ditampilkan sebagai rentang posisi relatif yang telah ditentukan.
ID area harus cocok dengan kursi yang benar-benar bergerak saat fitur walk-in diaktifkan, bukan kursi yang dimaksud yang akan ditempati penumpang.
Properti ini didefinisikan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
PERMINTAAN_PENGHAPUSAN
Minta head unit untuk disenyapkan.
Hal ini diperlukan untuk menjalankan tugas saat head unit dinonaktifkan (fitur tugas jarak jauh). Setelah head unit dinyalakan untuk menjalankan tugas, head unit harus dimatikan. Kepala akan mengirimkan pesan ini setelah tugas selesai.
Properti ini tidak berlaku saat pengguna ingin mematikan head unit.
Hal ini biasanya melibatkan informasi tentang sistem terpisah di luar head unit (misalnya daya pengontrol) untuk mempersiapkan mematikan head unit.
Sistem eksternal harus memvalidasi bahwa permintaan ini valid dengan memeriksa apakah kendaraan sedang beroperasi gunakan. Jika pengguna memasuki kendaraan setelah SHUTDOWN_REQUEST dikirim, sistem harus mengabaikan terhadap permintaan ini. Sebaiknya simpan properti VehicleInUse di pengontrol daya dan mengeksposnya melalui properti VEHICLE_IN_USE. Permintaan penonaktifan harus diabaikan jika VehicleInUse benar.
Jika diizinkan, sistem eksternal akan mengirimkan sinyal penonaktifan ke head unit, yang menyebabkan VHAL kirim pesan SHUTDOWN_PREPARE ke Android. Android kemudian akan memulai proses penonaktifan dengan menangani pesan.
Properti ini hanya untuk mengeluarkan permintaan dan hanya mendukung penulisan. Setiap kali properti ini ditetapkan, permintaan untuk mematikan akan dikeluarkan tidak peduli berapa nilai properti saat ini. Nilai properti saat ini tidak bermakna.
Karena properti ini hanya tulis, berlangganan tidak dibolehkan dan tidak ada peristiwa perubahan properti yang dibuat.
Nilai yang akan ditetapkan menunjukkan opsi penonaktifan, yang harus berupa salah satu dari
{@code VehicleApPowerStateShutdownParam}
Misalnya,
VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY
. Opsi penonaktifan ini mungkin tidak
diberlakukan jika sistem tidak mendukung opsi tersebut. Dalam kasus seperti itu, error tidak akan ditampilkan.
Untuk informasi konfigurasi, VehiclePropConfig.configArray
harus memiliki flag bit
yang menggabungkan nilai di {@code VehicleApPowerStateConfigFlag}
untuk menunjukkan opsi
shutdown yang didukung.
Menampilkan error jika gagal mengirim permintaan penonaktifan ke sistem lain.
Ubah mode: ON_CHANGE
Mode akses: WRITE
Jenis enum: VehicleApPowerStateShutdownParam
>
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_DEPTH_MOVE
Gerakan kedalaman roda kemudi. maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua nilai antara minInt32Value
dan
maxInt32Value
harus didukung.
maxInt32Value
menunjukkan roda kemudi bergerak menjauh dari pengemudi. minInt32Value
menunjukkan setir bergerak ke arah pengemudi.
Bilangan bulat yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
roda kemudi mencapai batas posisi, nilainya harus direset ke 0. Jika nilai
STEERING_WHEEL_DEPTH_MOVE
saat ini 0, tidak ada gerakan yang sedang berlangsung.
Properti ini digambarkan sebagai rentang relatif tertentu kecepatan gerak.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_DEPTH_POS
Posisi kedalaman setir. Semua ID unik properti setir dimulai dari 0x0BE0.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus
didefinisikan. Semua nilai antara minInt32Value
dan maxInt32Value
harus
didukung. maxInt32Value
menunjukkan posisi setir terjauh dari
{i>driver<i}. minInt32Value
menunjukkan posisi setir yang terdekat dengan
{i>driver<i}.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan
status transisi antara
Properti ini ditampilkan sebagai rentang posisi relatif yang telah ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_EASY_ACCESS_ENABLED
Fitur akses mudah setir diaktifkan. Jika benar, setir pengemudi akan otomatis disesuaikan untuk memudahkan pengemudi masuk dan keluar dari kendaraan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
{i>STEERING_WHEEL_HEIGHT_MOVE<i}
Gerakan ketinggian roda kemudi. maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua nilai antara minInt32Value
dan
maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kemudi bergerak ke atas. minInt32Value
menunjukkan kemudi bergerak ke bawah.
Bilangan bulat yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
setir mencapai batas posisi, nilai harus direset ke 0. Jika
Nilai STEERING_WHEEL_HEIGHT_MOVE
saat ini 0, artinya tidak ada gerakan
yang sedang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_HEIGHT_POS
Posisi tinggi setir.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus
didefinisikan. Semua nilai antara minInt32Value
dan maxInt32Value
harus
didukung. maxInt32Value
menunjukkan bahwa roda kemudi berada dalam posisi
tertinggi. minInt32Value
menunjukkan roda kemudi berada di posisi terendah
posisi Anda.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan
status transisi antara posisi terendah dan tertinggi.
Properti ini ditampilkan sebagai rentang posisi relatif yang ditentukan.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_LIGHTS_STATE
Status lampu setir. Menampilkan status lampu kemudi saat ini. Hal ini
berbeda dengan STEERING_WHEEL_LIGHTS_SWITCH
yang mewakili posisi tombol
yang mengontrol lampu. Oleh karena itu, STEERING_WHEEL_LIGHTS_STATE
mungkin tidak cocok dengan nilai
STEERING_WHEEL_LIGHTS_SWITCH
(misalnya,
dan
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
STEERING_WHEEL_LIGHTS_STATE=ON
).
Properti ini hanya boleh diterapkan jika nilai STEERING_WHEEL_LIGHTS_STATE
mungkin berbeda
dengan CABIN_LIGHTS_STATE.
Untuk ID area global (0), VehicleAreaConfig#supportedEnumValues harus ditentukan, kecuali jika semua nilai enum VehicleLightState didukung.
Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 14
LAMPU_WHEEL_STEERING_SWITCH
Tombol lampu setir. Menunjukkan posisi tombol yang mengontrol kemudi
lampu roda. Hal ini berbeda dengan , yang mewakili status lampu kemudi saat ini. Oleh karena itu, STEERING_WHEEL_LIGHTS_SWITCH
mungkin tidak cocok dengan
nilai STEERING_WHEEL_LIGHTS_STATE
. Misalnya,
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
dan
STEERING_WHEEL_LIGHTS_STATE=ON
.
Properti ini hanya boleh diterapkan jika nilai untuk
STEERING_WHEEL_LIGHTS_SWITCH
dapat berbeda dengan nilai
CABIN_LIGHTS_SWITCH
.
Untuk ID area global (0), VehicleAreaConfig#supportedEnumValues
harus
ditentukan kecuali jika semua nilai enum VehicleLightSwitch didukung.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_LOCKED
Setir terkunci. Jika benar, posisi kemudi akan dikunci dan tidak dapat diubah.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai <covehiclepropertyaccess.read< code=""> only./p>
</covehiclepropertyaccess.read<>
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_THEFT_LOCK_ENABLED
Fitur kunci pencurian setir diaktifkan. Jika benar, roda kemudi akan terkunci secara otomatis untuk mencegah pencurian dalam situasi tertentu. Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat menerapkannya sebagai VehiclePropertyAccess.READ saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
STORAGE_ENCRYPTION_BINDING_SEED
Seed binding enkripsi eksternal. Nilai ini digabungkan dengan kunci enkripsi penyimpanan kunci lokal. Properti ini menyimpan 16 byte, dan diharapkan disimpan pada ECU yang terpisah dari IVI. Properti awalnya ditetapkan oleh AAOS, yang membuatnya menggunakan CSRNG. AAOS kemudian membaca pada booting berikutnya. Seed binding diharapkan dapat dipertahankan dengan andal. Kehilangan seed akan menghasilkan {i> factory reset<i} dari IVI.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SUPPORT_CUSTOMIZE_VENDOR_PERMISSION
Mendukung penyesuaian izin untuk properti vendor.
Terapkan properti ini jika VHAL mendukung fitur penyesuaian izin vendor.
VehiclePropConfig.configArray digunakan untuk menunjukkan properti dan izin vendor yang
dipilih untuk properti vendor ini. Izin harus berupa salah satu dari enum di VehicleVendorPermission.
configArray disetel sebagai berikut, configArray[n]: propId : property ID
untuk
properti vendor dengan configArray[n+1] adalah enum di VehicleVendorPermission dan menunjukkan
izin akses untuk membaca nilai properti.
configArray[n+2] adalah enum di VehicleVendorPermission dan menunjukkan izin untuk menulis nilai properti. Contoh:
configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }
Jika properti vendor tidak ada dalam array ini, properti tersebut memiliki izin vendor default. Jika vendor pilih PERMISSION_NOT_ACCESSIBLE, Android tidak memiliki akses ke properti. Dalam contoh ini, Android tidak dapat menulis nilai untuk vendor_prop_2.
Ubah mode: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SUPPORTED_PROPERTI_IDS
(Tidak digunakan lagi) Daftar semua ID properti yang didukung.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
BERALIH_PENGGUNA
Menentukan permintaan untuk mengganti pengguna Android latar depan.
Properti ini terutama digunakan oleh sistem Android untuk memberi tahu HAL bahwa pengguna Android latar depan saat ini sedang beralih, tetapi juga dapat digunakan oleh HAL untuk meminta sistem Android untuk beralih pengguna. Saat permintaan dibuat oleh Android, Android akan menyetel VehiclePropValue dan HAL harus merespons dengan peristiwa perubahan properti. Saat membuat permintaan, HAL juga harus melakukannya melalui peristiwa perubahan properti (perbedaan utamanya adalah ID permintaan positif dalam kasus pertama, dan negatif dalam kasus kedua). SwitchUserMessageType juga berbeda.
Format kedua permintaan ditentukan oleh SwitchUserRequest dan format respons (saat diperlukan) ditentukan oleh SwitchUserResponse. Cara HAL (atau sistem Android) harus dilanjutkan bergantung pada jenis pesan (yang ditentukan oleh parameter SwitchUserMessageType), seperti yang ditentukan di bawah.LEGACY_ANDROID_SWITCH
Dipanggil oleh sistem Android untuk menunjukkan bahwa pengguna Android akan berubah, saat permintaan perubahan dibuat dengan cara yang tidak terintegrasi dengan HAL (misalnya, melalui adb shell am switch-user). HAL dapat mengalihkan pengguna internalnya sekali permintaan ini diterima, tetapi tidak perlu membalas ke sistem Android. Jika pengguna internal tidak dapat diubah karena alasan tertentu, maka harus menungguSWITCH_USER(type=ANDROID_POST_SWITCH)
panggilan untuk memulihkan (misalnya, dapat menghasilkanSWITCH_USER(type=VEHICLE_REQUEST)
untuk beralih kembali ke pengguna sebelumnya). Idealnya jangan sampai gagal (karena beralih kembali dapat membingungkan pengguna akhir).
Misalnya, jika sistem memiliki pengguna (0, 10, 11) dan beralih dari 0 ke 11 (tidak ada yang memiliki tanda khusus), permintaannya adalah:
int32[0]
42 // id permintaanint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // id pengguna targetint32[3]
0 // tanda pengguna target (tidak ada)int32[4]
10 // pengguna saat iniint32[5]
0 // tanda pengguna saat ini (tidak ada)int32[6]
3 // jumlah penggunaint32[7]
0 // pengguna #0 (ID pengguna Android 0)int32[8]
0 // flag pengguna #0 (tidak ada)int32[9]
10 // pengguna #1 (ID pengguna Android 10)int32[10]
0 // flag pengguna #1 (tidak ada)int32[11]
11 // pengguna #2 (ID pengguna Android 11)int32[12]
0 // tanda pengguna #2 (tidak ada)
ANDROID_SWITCH
Dipanggil oleh sistem Android untuk menunjukkan bahwa pengguna Android akan berubah, tetapi Android menunggu respons HAL (hingga beberapa waktu) sebelum melanjutkan. HAL harus mengalihkan pengguna internalnya setelah menerima permintaan ini, lalu merespons kembali ke Android denganSWITCH_USER(type=VEHICLE_RESPONSE)
yang menunjukkan apakah pengguna internalnya telah dialihkan atau tidak (melalui enum SwitchUserStatus). Misalnya, jika Android memiliki pengguna (0, 10, 11) dan beralih dari 10 ke 11 (di mana tidak ada yang memiliki flag khusus), permintaannya adalah:int32[0]
42 // id permintaanint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // id pengguna targetint32[3]
0 // tanda pengguna target (tidak ada)int32[4]
10 // pengguna saat iniint32[5]
0 // tanda pengguna saat ini (tidak ada)int32[6]
3 // jumlah penggunaint32[7]
0 // pengguna pertama (pengguna 0)int32[8]
1 // flag pengguna pertama (SISTEM)int32[9]
10 // pengguna kedua (pengguna 10)int32[10]
0 // flag pengguna kedua (tidak ada)int32[11]
11 // Pengguna ke-3 (pengguna 11)int32[12]
0 // Tanda pengguna ke-3 (tidak ada)
Jika permintaan berhasil, HAL harus memperbarui properti dengan:
int32[0]
42 // id permintaanint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
Jika permintaan gagal, responsnya akan seperti ini:
int32[0]
42 // id permintaanint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
2 // status: string SwitchUserStatus::FAILURE: "108-D'OH!"- Pesan error khusus OEM
VEHICLE_RESPONSE
Dipanggil oleh HAL untuk menunjukkan apakah permintaan berjenis ANDROID_SWITCH harus melanjutkan atau membatalkan. Lihat juga ANDROID_SWITCH.VEHICLE_REQUEST
Dipanggil oleh HAL untuk meminta agar pengguna Android latar depan saat ini diubah. Ini berguna dalam situasi saat Android dimulai sebagai satu pengguna, tetapi kendaraan mengidentifikasi pengemudi sebagai pengguna lain. Misalnya, pengguna A membuka kunci mobil menggunakan fob kunci pengguna B. Permintaan INITIAL_USER_INFO menampilkan pengguna B, tetapi kemudian subsistem pengenalan wajah mengidentifikasi pengguna sebagai A. HAL membuat permintaan ini dengan peristiwa perubahan properti (meneruskan ID permintaan negatif), dan respons sistem Android adalah mengeluarkan panggilan ANDROID_POST_SWITCH yang memiliki ID permintaan yang sama. Misalnya, jika pengguna Android latar depan saat ini adalah 10 dan HAL diminta untuk beralih ke 11, permintaannya adalah:int32[0]
-108 // id permintaanint32[1]
4 // messageType: SwitchUserMessageType::VEHICLE_REQUESTint32[2]
11 // ID pengguna Android
Jika permintaan berhasil dan Android memiliki tiga pengguna (0, 10, dan 11), responsnya adalah:
int32[0]
-108 // id permintaanint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // id pengguna targetint32[3]
0 // tanda target ID pengguna (tidak ada)int32[4]
11 // pengguna saat iniint32[5]
0 // flag pengguna saat ini (tidak ada)int32[6]
3 // jumlah penggunaint32[7]
0 // pengguna pertama (pengguna 0)int32[8]
0 // tanda pengguna pertama (tidak ada)int32[9]
10 // pengguna kedua (pengguna 10)int32[10]
4 // flag pengguna kedua (tidak ada)int32[11]
11 // pengguna ketiga (pengguna 11)int32[12]
3 // flag pengguna ketiga (tidak ada)
ID pengguna saat ini dan target sama. Jika permintaan gagal, maka keduanya akan berbeda. Misalnya, pengguna target adalah 11 dan pengguna saat ini akan tetap 10.
ANDROID_POST_SWITCH
Dipanggil oleh sistem Android setelah permintaan untuk beralih pengguna dibuat. Properti ini dipanggil setelah permintaan tombol apa pun (misalnya, >code>LEGACY_ANDROID_SWITCH, >code>ANDROID_SWITCH, atauVEHICLE_REQUEST
) dan dapat digunakan untuk menentukan apakah permintaan berhasil atau gagal.- Jika berhasil, metode ini akan dipanggil saat pengguna Android berada dalam status tidak terkunci dan nilai ID pengguna saat ini dan target dalam respons sama. Ini adalah setara dengan menerima Intent.ACTION_USER_UNLOCKED di aplikasi Android.
- Jika gagal, fitur tersebut akan langsung dipanggil dan nilai ID pengguna saat ini dan target responsnya berbeda (karena pengguna saat ini tidak berubah menjadi target).
- Jika permintaan tombol baru dibuat sebelum HAL merespons tombol sebelumnya atau sebelum pengguna dibuka kuncinya, permintaan ANDROID_POST_SWITCH tidak akan dibuat. Misalnya, driver mungkin tidak sengaja beralih ke pengguna yang salah, yang memiliki kredensial kunci, lalu beralih ke pengguna yang benar sebelum memasukkan kredensial.
HAL dapat memperbarui status internalnya setelah menerima permintaan ini, tetapi tidak perlu membalas sistem Android.
- Minta. Nilai N pertama seperti yang ditetapkan oleh
INITIAL_USER_INFO
(dengan permintaan khusus nilai pada indeks 1 adalahSwitchUserMessageType::ANDROID_POST_SWITCH
), lalu dua nilai lagi untuk id pengguna target (misalnya, id pengguna Android yang diminta untuk dialihkan) dan penandanya (seperti yang ditentukan oleh UserFlags). - Respons: tidak ada. Misalnya, lihat
VEHICLE_REQUEST
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
TIRE_PRESSURE
Tekanan ban. Setiap ban diidentifikasi oleh konfigurasi areaConfig.areaId. Tujuan masing-masing minFloatValue dan maxFloatValue digunakan untuk menyimpan rentang tekanan yang direkomendasikan. Nilai untuk minFloatValue dan maxFloatValue di VehicleAreaConfig harus ditentukan.
minFloatValue dalam data areaConfig mewakili batas bawah tekanan ban yang direkomendasikan. maxFloatValue di data areaConfig mewakili batas atas dari tekanan ban yang direkomendasikan. Misalnya, areaConfig ini menunjukkan tekanan ban kiri depan yang direkomendasikan mulai dari 200,0 kPa hingga 240,0 kPa.
.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }
Ubah mode: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:KILOPASCAL
Rilis: Android 13
TIRE_PRESSURE_DISPLAY_UNITS
Unit tekanan ban untuk ditampilkan. Menunjukkan unit mana yang digunakan mobil untuk menampilkan tekanan ban kepada pengguna. Misalnya, PSI, Bar, atau Kilopascal. VehiclePropConfig.configArray digunakan untuk menunjukkan unit tampilan tekanan yang didukung. Satuan tekanan ditentukan dalam VehicleUnit. Misalnya, configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR
Jika memperbarui TIRE_PRESSURE_DISPLAY_UNITS memengaruhi nilai properti *_DISPLAY_UNITS lainnya,
nilainya juga harus diperbarui dan dikomunikasikan ke framework AAOS.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai <covehiclepropertyaccess.read< code=""> saja./p>
</covehiclepropertyaccess.read<>
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: VehicleUnit
Jenis unit: T/A
Rilis: Android 13
TRACTION_CONTROL_ACTIVE
Tetapkan ke true saat kontrol traksi (TC) aktif dan direset ke false saat TC nonaktif. Ini dapat disetel sesekali (pulsa) berdasarkan keadaan waktu nyata sistem TC.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
TRAILER_PRESENT
Menampilkan status trailer mobil.
Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: TrailerState
Jenis unit: T/A
Rilis: Android 13
TURN_SIGNAL_STATE
Status lampu sein kendaraan.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleTurnSignal
Jenis unit: T/A
Rilis: Android 13
USER_IDENTIFICATION_ASSOCIATION
Properti yang digunakan untuk mengaitkan (atau membuat kueri asosiasi) pengguna saat ini dengan mekanisme identifikasi khusus kendaraan (seperti fob kunci).
Ini adalah properti pengelolaan pengguna opsional. OEM masih dapat mendukung pengelolaan pengguna tanpa menentukannya. Faktanya, properti ini dapat digunakan tanpa mendukung informasi inti terkait pengguna fungsi yang dijelaskan pada INITIAL_USER_INFO.
Untuk membuat kueri pengaitan, sistem Android mendapatkan properti, dengan meneruskan VehiclePropValue yang berisi jenis asosiasi yang dikueri, seperti yang ditentukan oleh {i>UserIdentificationGetRequest<i}. HAL harus segera ditampilkan, menampilkan VehiclePropValue dengan {i>UserIdentificationResponse<i}.
Perhatikan bahwa identifikasi pengguna terjadi saat sistem melakukan booting. implementasi Takehe VHAL hanya boleh mengembalikan pengaitan yang telah diidentifikasi (seperti FOB kunci yang digunakan untuk membuka kunci mobil), bukan memulai pengaitan baru dari awal panggilan telepon.
Untuk mengaitkan jenis, sistem Android menetapkan properti, dengan meneruskan VehiclePropValue yang berisi jenis dan nilai pengaitan yang ditetapkan, seperti yang ditetapkan oleh UserIdentificationSetRequest.
HAL kemudian menggunakan peristiwa perubahan properti (yang VehiclePropValue-nya ditentukan oleh UserIdentificationResponse) yang menunjukkan status jenis saat ini setelah permintaan.
Misalnya, untuk membuat kueri apakah pengguna saat ini (10) dikaitkan dengan FOB yang membuka kunci mobil serta mekanisme kustom yang disediakan oleh OEM, permintaannya adalah:
int32[0]
42 // request idint32[1]
10 (ID pengguna Android)int32[2]
0 (tanda pengguna Android)int32[3]
2 (jumlah jenis yang dikueri)int32[4]
1 (jenis pertama yang dikueri, UserIdentificationAssociationType::KEY_FOB)int32[5]
101 (jenis kedua yang dikueri, UserIdentificationAssociationType::CUSTOM_1)
Jika pengguna terkait dengan FOB, tetapi tidak dengan mekanisme kustom, responsnya adalah:
int32[0]
42 // request idint32[1]
2 (jumlah asosiasi dalam respons)int32[2]
1 (jenis pertama: UserIdentificationAssociationType::KEY_FOB)int32[3]
2 (nilai pertama: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)int32[4]
101 (jenis pertama: UserIdentificationAssociationType::CUSTOM_1)int32[5]
4 (nilai kedua: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)
Kemudian, untuk mengaitkan pengguna dengan mekanisme kustom, permintaan yang ditetapkan akan dibuat:
int32[0]
43 // id permintaanint32[1]
10 (ID pengguna Android)int32[2]
0 (tanda pengguna Android)int32[3]
1 (jumlah asosiasi yang ditetapkan)int32[4]
101 (jenis pertama: UserIdentificationAssociationType::CUSTOM_1)
Jika permintaan berhasil, responsnya adalah:
int32[0]
43 // request idint32[1]
1 (jumlah pengaitan dalam respons)int32[2]
101 (jenis pertama: UserIdentificationAssociationType::CUSTOM_1)int32[3]
1 (nilai pertama: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
Permintaan set menambahkan pengaitan, tetapi tidak menghapus pengaitan yang ada. Di misalnya, status akhir adalah dua asosiasi (FOB dan CUSTOM_1). Untuk mengaitkan pengguna dengan hanya CUSTOM_1 tetapi bukan FOB, maka permintaannya adalah:
int32[0]
43 // request idint32[1]
10 (ID pengguna Android)int32[2]
2 (jumlah jenis yang ditetapkan)int32[3]
1 (jenis pertama: UserIdentificationAssociationType::KEY_FOB)int32[4]
2 (nilai pertama: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)int32[5]
101 (jenis kedua: UserIdentificationAssociationType::CUSTOM_1)int32[6]
1 (nilai kedua: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
BERAT_CURB_VEHICLE
Menampilkan berat curb kendaraan dalam kilogram. Bobot kosong adalah berat total kendaraan dengan peralatan standar dan semua bahan habis pakai operasi yang diperlukan seperti oli motor, oli transmisi, cairan rem, pendingin, refrigeran AC, dan berat bahan bakar pada kapasitas tangki nominal saat tidak mengangkut penumpang atau kargo.
configArray[0] digunakan untuk menentukan berat kotor kendaraan dalam kilogram. Kotor kendaraan berat adalah berat pengoperasian maksimum kendaraan seperti yang ditentukan oleh produsen termasuk sasis kendaraan, bodi, mesin, cairan mesin, bahan bakar, aksesori, pengemudi, penumpang dan kargo tetapi tidak termasuk trailer.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:KILOGRAM
Rilis: Android 13
VEHICLE_IN_USE
Menunjukkan apakah kendaraan sedang digunakan. Sedang digunakan berarti ada pengguna manusia dan bermaksud menggunakan kendaraan. Hal ini bukan berarti pengguna manusia ada di dalam kendaraan. Misalnya, jika pengguna manusia membuka kunci kendaraan dari jarak jauh, kendaraan tersebut dianggap sedang digunakan. Jika properti ini didukung:
- Setiap kali pengguna menyalakan kendaraan
atau sistem mendeteksi adanya pengguna,
VEHICLE_IN_USE
harus ditetapkan ke true. Setiap kali pengguna mematikan kendaraan atau sistem mendeteksi bahwa pengguna tidak ada,VEHICLE_IN_USE
harus ditetapkan ke salah (false). - Jika pengguna mematikan kendaraan atau sistem mendeteksi bahwa pengguna tidak ada,
VEHICLE_IN_USE
harus disetel ke salah (false). - Jika pengguna menyalakan kendaraan atau sistem mendeteksi kehadiran pengguna,
VEHICLE_IN_USE
harus disetel ke benar (true).
Properti ini berbeda dengan AP_POWER_BOOTUP_REASON
dalam artian
AP_POWER_BOOTUP_REASON
hanya disetel sekali selama booting sistem. Namun, properti ini
dapat berubah beberapa kali selama siklus booting sistem. Misalnya, perangkat saat ini tidak
sedang digunakan. Sistem melakukan booting untuk menjalankan tugas jarak jauh. VEHICLE_IN_USE
salah. Meskipun
tugas jarak jauh dijalankan, pengguna
masuk ke kendaraan dan menyalakan kendaraan.
VEHICLE_IN_USE
ditetapkan ke benar (true). Setelah sesi mengemudi, pengguna mematikan kendaraan,
VEHICLE_IN_USE
disetel ke salah (false).
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
LAYANAN_PETA_VEHICLE
Pesan Layanan Maps Kendaraan (VMS). Properti ini menggunakan data CAMPURAN untuk menyampaikan pesan VMS.
Isinya harus ditafsirkan sebagai berikut. Indeks yang ditentukan dalam VmsMessageIntegerValuesInde
yang digunakan untuk membaca dari int32Values. adalah pesan VMS serialisasi, seperti
yang ditentukan dalam VMS,
, yang buram bagi kerangka kerja. IVehicle#get harus selalu menampilkan
StatusCode::NOT_AVAILABLE
.
Ubah mode: ON_CHANGEREAD_WRITE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
VEHICLE_SPEED_DISPLAY_UNITS
Unit kecepatan untuk ditampilkan. Menunjukkan jenis unit yang digunakan untuk menampilkan kecepatan kepada pengguna. Misalnya, m/d, km/j, atau mph. VehiclePropConfig.configArray menunjukkan unit tampilan kecepatan yang didukung. Unit tekanan ditentukan dalam VehicleUnit. Contoh:
.configArray: { VehicleUnit::METER_PER_SEC, VehicleUnit::KILOMETERS_PER_HOUR, VehicleUnit::MILES_PER_HOUR }
configArray[0]
METER_PER_SEC
configArray[1]
MILES_PER_HOUR
configArray[2]
KILOMETERS_PER_HOUR
Jika memperbarui VEHICLE_SPEED_DISPLAY_UNITS
memengaruhi nilai *_DISPLAY_UNITS properties
lainnya, nilai tersebut harus diperbarui dan disampaikan ke
framework AAOS.
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
VHAL_HEARTBEAT
Menentukan peristiwa yang ditandai oleh VHAL Anjing Pengawas Mobil sebagai detak jantung. Jika VHAL mendukung properti ini, VHAL harus menuliskan waktu beroperasi sistem ke properti ini setiap tiga detik. Car Watchdog berlangganan properti ini dan memeriksa apakah properti tersebut diperbarui setiap tiga detik. Dengan waktu buffering tiga detik, Car Watchdog menunggu heartbeat diberi sinyal hingga enam detik dari heartbeat terakhir. Jika tidak, Car Watchdog menganggap VHAL tidak responsif dan menghentikannya. Jika properti ini tidak didukung oleh VHAL, Car Watchdog tidak akan memeriksa status kesehatan VHAL.
Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WATCHDOG_ALIVE
Menentukan peristiwa yang diperbarui oleh Car Watchdog untuk menunjukkan bahwa peristiwa tersebut aktif. Car Watchdog menyetel ini ke waktu beroperasi sistem dalam milidetik setiap tiga detik. Saat booting, pembaruan dapat memakan waktu lebih lama.
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WATCHDOG_TERMINATED_PROCESS
Menentukan proses yang dihentikan oleh Car Watchdog dan alasan penghentian.
int32Values[0] 1 // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WHEEL_TICK
Melaporkan klik roda. Elemen pertama dalam vektor adalah jumlah reset. Reset menunjukkan jumlah tanda centang sebelumnya tidak sebanding dengan ini dan yang akan datang. Terjadi semacam ketidakkontinuan dalam penghitungan tick.
Empat elemen berikutnya mewakili tick untuk setiap roda dengan urutan berikut:
- Kiri depan
- Kanan depan
- Kanan belakang
- Kiri belakang
Semua jumlah tick bersifat kumulatif. Jumlah tick bertambah saat kendaraan bergerak maju, dan pengurangan saat kendaraan bergerak mundur. Tanda centang harus direset ke 0 saat kendaraan dimulai.
int64Values[0]
Jumlah resetint64Values[1]
Tanda centang kiri depanint64Values[2]
Centang kanan depanint64Values[3]
Centang kanan belakangint64Values[4]
Tanda centang kiri belakang
configArray
digunakan untuk menunjukkan nilai mikrometer per titik skala dan
didukung configArray disetel sebagai berikut:
configArray[0], bits [0:3] Supported wheels
Menggunakan Wheel enum. Misalnya, jika semua roda didukung, maka:
configArray[0]
VehicleAreaWheel::LEFT_FRONT | VehicleAreaWheel::RIGHT_FRONT | VehicleAreaWheel::LEFT_REAR | VehicleAreaWheel::RIGHT_REARconfigArray[1]
Mikrometer per tanda roda kiri depanconfigArray[2]
Mikrometer per tick roda kanan depanconfigArray[3]
Mikrometer per tick roda kanan belakangconfigArray[4]
Mikrometer per tick roda kiri belakang.
Jika roda tidak didukung, nilainya harus selalu ditetapkan ke 0.
VehiclePropValue.timestamp
harus diisi.
Ubah mode: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WINDOW_LOCK
Penguncian jendela anak. True menunjukkan jendela terkunci dari anak-anak. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat menerapkannya sebagai
VehiclePropertyAccess.READ
.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WINDOW_MOVE
Perpindahan jendela. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. maxInt32Value
menunjukkan jendela terbuka dalam bidang/penutupan keluar dari arah bidang paling cepat
kecepatan tinggi. minInt32Value
menunjukkan jendela menutup dalam bidang/membuka dalam
arah di luar bidang dengan kecepatan tercepat.
Nilai absolut yang lebih besar, baik positif maupun negatif, menunjukkan kecepatan gerakan yang lebih cepat. Setelah
mencapai batas posisi, nilainya harus direset ke 0. Jika nilai
WINDOW_MOVE
adalah 0, tidak ada gerakan yang sedang berlangsung. Properti ini direpresentasikan dalam
rentang kecepatan gerakan relatif yang ditentukan.
Untuk jendela yang dapat terbuka di luar bidang (mode ventilasi sunroof), parameter ini berfungsi sebagai berikut. Jika:
- Sunroof buka:
Max
Buka lebih jauh sunroof, berhenti otomatis saat sepenuhnya terbuka.Min
Menutup sunroof, berhenti secara otomatis saat sunroof ditutup.
- Ventilasi terbuka:
Max
Menutup ventilasi, berhenti secara otomatis saat ventilasi ditutup.Min
Buka ventilasi lebih jauh, berhenti secara otomatis saat ventilasi terbuka sepenuhnya.
- Sunroof ditutup:
Max
Buka sunroof, berhenti otomatis saat sunroof terbuka sepenuhnya.Min
Buka ventilasi, otomatis berhenti saat ventilasi terbuka sepenuhnya.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WINDOW_POS
Posisi jendela. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. minInt32Value
menunjukkan jendela
tertutup atau terbuka sepenuhnya dari pesawat. Jika jendela tidak dapat terbuka di luar bidang, maka
minInt32Value
adalah posisi jendela saat ditutup sepenuhnya dan harus 0. Jika
jendela dapat terbuka di luar bidang, minInt32Value
menunjukkan bahwa jendela terbuka sepenuhnya
dalam posisinya di luar bidang dan merupakan nilai negatif. Lihat contoh di bawah untuk penjelasan
yang lebih mendetail. maxInt32Value
menunjukkan jendela terbuka sepenuhnya.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan transisi
antara posisi di luar bidang tertutup/terbuka sepenuhnya dan terbuka sepenuhnya. Properti ini tidak
di unit tertentu, tetapi dalam rentang posisi relatif tertentu. Misalnya, berikut cara kerja
properti untuk jendela yang dapat bergerak keluar dari bidang: Untuk jendela yang dapat terbuka di luar
bidang (mode ventilasi sunroof), parameter ini berfungsi dengan nilai negatif sebagai berikut:
Max
Sunroof terbuka sepenuhnya (0 untuk sunroof tertutup).Min
Ventilasi sunroof terbuka sepenuhnya (0 untuk sunroof tertutup).
Properti ini ditetapkan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat
menerapkannya sebagai VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WINDSHIELD_WIPERS_PERIOD
Periode penyeka kaca depan (milidetik). Menampilkan jangka waktu instan untuk satu siklus penuh
wiper kaca depan dalam milidetik. Siklus penuh didefinisikan sebagai wiper yang bergerak dari
dan kembali ke posisi diam. Jika setelan penghapusan total yang terputus-putus dipilih, properti ini
harus ditetapkan ke 0 selama periode jeda penghapusan total. Tujuan
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan.
maxInt32Value
untuk setiap ID area harus menentukan periode penghapusan total terpanjang. Tujuan
minInt32Value
harus ditetapkan ke 0 untuk setiap ID area.
Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLI_SECS
Rilis: Android 14
WINDSHIELD_WIPERS_NEGARA
Status wiper kaca depan. Menampilkan kondisi penyeka kaca saat ini. Nilai dari
WINDSHIELD_WIPERS_STATE
mungkin tidak cocok dengan nilai
WINDSHIELD_WIPERS_SWITCH
Misalnya, WINDSHIELD_WIPERS_STATE: ON
dan
WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO
Jika WINDSHIELD_WIPERS_STATE: ON
dan WINDSHIELD_WIPERS_PERIOD
adalah
diterapkan, maka WINDSHIELD_WIPERS_PERIOD
harus mencerminkan jangka waktu satu
siklus penyeka.
Untuk setiap ID area yang didukung, array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status di WindshieldWipersState
didukung (termasuk OTHER, yang tidak direkomendasikan).
Ubah mode: ON_CHANGE
Mode akses: READ
Jenis enum: WindshieldWipersState
Jenis unit: T/A
Rilis: Android 14
SENIN
Tombol wiper kaca depan. Menunjukkan posisi tombol yang mengontrol kaca depan
penyeka. Nilai WINDSHIELD_WIPERS_SWITCH
mungkin tidak cocok dengan nilai
WINDSHIELD_WIPERS_STATE
Misalnya, WINDSHIELD_WIPERS_SWITCH: AUTO
dan
WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON
Untuk setiap ID area yang didukung,
Array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status dalam
WindshieldWipersSwitch
didukung (termasuk yang LAINNYA, yang tidak direkomendasikan).
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
. Jika properti ini diterapkan sebagai
VehiclePropertyAccess.READ_WRITE
dan status OTHER tercantum dalam
array VehicleAreaConfig#supportedEnumValues
, OTHER bukan nilai yang didukung
untuk penulisan. Nilai ini hanya didukung untuk pembacaan.
Ubah mode: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: WindshieldWipersSwitch
Jenis unit: T/A
Rilis: Android 14