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
Status driver Deteksi Tangan di Setir (HOD). Menampilkan apakah tangan pengemudi berada di roda
kemudi. Umumnya, properti ini akan menampilkan status yang valid yang ditentukan dalam
HandsOnDetectionDriverState
atau ErrorState
. Misalnya, jika fitur
tidak tersedia karena
beberapa status sementara, informasi tersebut harus disampaikan melalui ErrorState
Jika kendaraan ingin mengirim peringatan kepada pengguna karena tangan pengemudi telah berada di luar
kemudi terlalu lama, peringatan harus ditampilkan melalui
HANDS_ON_DETECTION_WARNING
Untuk ID area global (0), array VehicleAreaConfig#supportedEnumValues
harus
ditentukan
kecuali jika semua status HandsOnDetectionDriverState
(termasuk OTHER, yang
tidak direkomendasikan)
dan ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: HandsOnDetectionDriverState/ErrorState
Jenis unit: T/A
Rilis: Android 14
HANDS_ON_DETECTION_ENABLED
Mengaktifkan atau menonaktifkan Deteksi Sentuhan Tangan (HOD). Tetapkan ke true untuk mengaktifkan HOD dan false untuk menonaktifkan HOD.
Saat HOD diaktifkan, sistem di dalam kendaraan harus memantau keberadaan tangan
pengemudi di setir dan mengirim peringatan jika mendeteksi bahwa tangan pengemudi tidak lagi
berada di setir. Secara umum, HANDS_ON_DETECTION_ENABLED
harus selalu menampilkan
benar atau salah.
Jika fitur tidak tersedia karena beberapa status sementara, informasi tersebut harus disampaikan
melalui nilai ErrorState
di properti HANDS_ON_DETECTION_STATE
.
Properti ini ditentukan sebagai minInt32Value
VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat menerapkannya
hanya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
HANDS_ON_DETECTION_WARNING
Peringatan Hands On Detection (HOD). Menampilkan apakah peringatan dikirim ke pengemudi karena
tangannya tidak berada di kemudi dalam durasi yang terlalu lama. Umumnya, properti ini akan menampilkan
status yang valid yang ditentukan dalam HandsOnDetectionWarning
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
HandsOnDetectionWarning
(termasuk OTHER, yang tidak direkomendasikan) dan
ErrorState
didukung.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: HandsOnDetectionWarning/ErrorState
Jenis unit: T/A
Rilis: Android 14
HAZARD_LIGHTS_STATE
Status lampu hazard. Menampilkan status lampu hazard saat ini.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
HAZARD_LIGHTS_SWITCH
Tombol lampu hazard. Setelan yang diinginkan pengguna. 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
HEADLIGHTS_STATE
Status lampu depan. Menampilkan status lampu depan saat ini.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
HEADLIGHTS_SWITCH
Tombol lampu depan. Setelan yang diinginkan pengguna. 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
HIGH_BEAM_LIGHTS_STATE
Status lampu utama. Menampilkan status lampu utama saat ini.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 13
HIGH_BEAM_LIGHTS_SWITCH
Sakelar lampu utama. Setelan yang diinginkan pengguna. 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
HVAC_AC_ON
Mengaktifkan dan menonaktifkan AC untuk areaId yang ditentukan. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM 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
HVAC_ACTUAL_FAN_SPEED_RPM
Kecepatan kipas sebenarnya.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HVAC_AUTO_ON
Mengaktifkan dan menonaktifkan kontrol suhu otomatis.
Jika benar, kontrol suhu otomatis aktif. Jika salah (false), kontrol iklim otomatis nonaktif.
Jika kendaraan tidak mendukung penonaktifan kontrol iklim otomatis secara langsung, OEM harus
menambahkan logika dalam penerapan VHAL mereka untuk menetapkan HVAC_AUTO_ON
ke salah (false), yang mengubah
setelan HVAC yang diperlukan untuk menonaktifkan HVAC_AUTO_ON
secara tidak langsung. Idealnya, hal ini
tidak akan mengganggu pengguna. OEM harus mengembalikan setelan apa pun yang
diubah saat kontrol iklim otomatis nonaktif ke status sebelumnya. Dengan cara ini, satu-satunya hasil yang akan diperoleh adalah
HVAC_AUTO_ON
nonaktif. Jika tidak dapat memulihkan setelan HVAC ke setelan sebelumnya, OEM harus menerapkan perubahan yang paling tidak mengganggu.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HVAC_AUTO_RECIRC_ON
Resirkulasi otomatis aktif atau nonaktif. Jika resirkulasi otomatis aktif, sistem HVAC dapat
beralih secara otomatis ke mode resirkulasi jika kendaraan mendeteksi kualitas udara masuk yang buruk.
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
HVAC_DEFROSTER
Pemanas berbasis kipas untuk jendela yang ditentukan. Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM 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
HVAC_DUAL_ON
Mengaktifkan pengaitan suhu antar-area. AreaIDs
untuk
properti HVAC_DUAL_ON
harus berisi kombinasi HVAC_TEMPERATURE_SET
AreaIDs
yang dapat
digabungkan
bersama-sama. Jika HVAC_TEMPERATURE_SET
dipetakan ke AreaIDs
[a_1, a_2, ..., a_n]
dan jika HVAC_DUAL_ON
dapat diaktifkan untuk menggabungkan a_i dan a_j, maka
properti HVAC_DUAL_ON
harus dipetakan ke [a_i | a_j]. Selain itu, jika
a_k dan a_l juga dapat digabungkan secara terpisah, maka
HVAC_DUAL_ON
harus dipetakan ke [a_i | a_j, a_k | a_l].
Misalnya, mobil memiliki dua kursi depan (ROW_1_LEFT
dan ROW_1_RIGHT
) dan
tiga kursi belakang (ROW_2_LEFT, ROW_2_CENTER, dan ROW_2_RIGHT).
Ada dua unit kontrol suhu, sisi pengemudi dan sisi penumpang, yang dapat disinkronkan secara opsional. Hal ini dapat dinyatakan dengan cara ini di 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]
Jika properti diaktifkan, ECU harus menyinkronkan suhu untuk area yang terpengaruh.
Setiap parameter yang diubah sebagai efek samping dari mengaktifkan atau menonaktifkan parameter DUAL_ON akan menghasilkan
callback onPropertyEvent()
ke VHAL. Selain itu, jika menyetel suhu
(misalnya, suhu pengemudi) mengubah suhu lain (seperti suhu penumpang
depan), callback onPropertyEvent()
yang sesuai harus dibuat.
Jika pengguna mengubah suhu yang merusak pengaitan (misalnya, menetapkan suhu penumpang
secara independen), VHAL harus mengirim callback onPropertyEvent()
yang sesuai
(termasuk HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
).
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM 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
HVAC_ELECTRIC_DEFROSTER_ON
Status pencairan es listrik.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM 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
HVAC_FAN_DIRECTION
Setelan arah kipas. 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: VehicleHvacFanDirection
Jenis unit: T/A
Rilis: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
Posisi penggemar tersedia. Ini adalah bit mask posisi kipas yang tersedia untuk zona. Setiap
arah kipas yang tersedia dilambangkan dengan entri terpisah dalam vektor. Arah kipas dapat memiliki
beberapa bit dari kumpulan vehicle_hvac_fan_direction
. Misalnya, mobil biasa mungkin memiliki posisi
kipas berikut:
- 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)
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: VehicleHvacFanDirection
Jenis unit: T/A
Rilis: Android 13
HVAC_FAN_SPEED
Setelan kecepatan kipas. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung.
minInt32Value
kecepatan kipas terendahmaxInt32Value
kecepatan kipas tertinggi
Properti ini tidak dalam unit tertentu, tetapi dalam rentang kecepatan relatif yang ditentukan. Properti
ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat memilih untuk
menerapkannya hanya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HVAC_MAX_AC_ON
AC MAX aktif atau nonaktif. Jika AC MAX aktif, ECU dapat menyesuaikan item seperti posisi ventilasi, kecepatan kipas,
dan suhu sesuai kebutuhan untuk mendinginkan kendaraan secepat mungkin. Setiap parameter yang diubah sebagai
efek samping dari mengaktifkan atau menonaktifkan parameter MAX AC akan menghasilkan callback
onPropertyEvent()
ke VHAL. Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
,
tetapi OEM 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
HVAC_MAX_DEFROST_ON
Aktifkan dan nonaktifkan MAX DEFROST. Jika MAX DEFROST aktif, ECU dapat menyesuaikan item seperti posisi
ventilasi, kecepatan kipas, dan suhu sesuai kebutuhan untuk mencairkan es di kaca secepat mungkin.
Setiap parameter yang diubah sebagai efek samping dari mengaktifkan atau menonaktifkan parameter MAX DEFROST akan menghasilkan
callback onPropertyEvent()
ke VHAL. AreaIDs
untuk
HVAC_MAX_DEFROST_ON
menunjukkan MAX DEFROST dapat dikontrol di area tersebut. Misalnya,
areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
menunjukkan bahwa
HVAC_MAX_DEFROST_ON
hanya dapat dikontrol untuk baris depan. Properti ini
ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM 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
HVAC_POWER_ON
Merepresentasikan status daya global untuk HVAC. Menetapkan properti ini ke salah (false) DAPAT menandai beberapa properti yang mengontrol setiap fitur dan subsistem HVAC dalam status TIDAK TERSEDIA. Menetapkan properti ini ke benar DAPAT menandai beberapa properti yang mengontrol setiap fitur dan subsistem HVAC ke status TERSEDIA (kecuali jika salah satu atau semua properti TIDAK TERSEDIA berdasarkan nilai masing-masing).
HvacPower_DependentProperties
adalah properti yang memerlukan HVAC untuk diaktifkan
guna mengaktifkan fungsi. Di beberapa mobil, misalnya, untuk mengaktifkan AC, HVAC harus diaktifkan terlebih dahulu. Daftar HvacPower_DependentProperties
harus ditetapkan di
VehiclePropConfig.configArray
HvacPower_DependentProperties
hanya boleh
berisi properti yang terkait dengan VehicleArea:SEAT
Pemetaan AreaID untuk properti HVAC_POWER_ON
harus berisi semua AreaIDs
yang
dipetakan ke HvacPower_DependentProperties
. Misalnya, mobil memiliki dua:
- Kursi depan (
ROW_1_LEFT
,ROW_1_RIGHT
) dan tiga kursi belakang (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Jika fitur HVAC (AC, Suhu, dll.) di seluruh mobil bergantung pada satu pengontrol daya HVAC,HVAC_POWER_ON
harus dipetakan ke [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- Kursi di baris depan (
ROW_1_LEFT
,ROW_1_RIGHT
) dan tiga kursi di baris kedua (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) dan ketiga (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). Jika mobil memiliki pengontrol suhu di baris depan yang dapat beroperasi sepenuhnya secara independen dari pengontrol suhu di bagian belakang kendaraan, makaHVAC_POWER_ON
harus dipetakan ke array dua elemen:- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM memiliki
opsi untuk menerapkannya hanya sebagai VehiclePropertyAccess.READ
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HVAC_RECIRC_ON
Recirculasi aktif dan nonaktif. Mengontrol suplai udara luar ke kabin. Recirc
on berarti sebagian besar aliran udara ke kabin berasal dari kabin. Sirkulasi ulang
nonaktif berarti sebagian besar aliran udara ke kabin berasal dari luar mobil. Properti
ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM 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
HVAC_SEAT_TEMPERATURE
Pemanas dan pendingin kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan setelan pemanas suhu kursi maksimum.
minInt32Value
harus 0, kecuali jika kendaraan mendukung pendingin kursi. Dalam hal ini,
minInt32Value
menunjukkan setelan pendinginan suhu kursi maksimum.
Properti ini tidak dalam unit tertentu, tetapi dalam rentang setelan suhu
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
HVAC_SEAT_VENTILATION
Ventilasi kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung. minInt32Value
harus 0. maxInt32Value
menunjukkan setelan ventilasi maksimum yang tersedia untuk kursi.
Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang setelan ventilasi yang ditentukan.
Digunakan oleh aplikasi HVAC dan Asisten untuk mengaktifkan, mengubah, atau membaca status ventilasi kursi. Hal ini berbeda dengan pendingin kursi. Lampu dapat menyala bersamaan dengan pendingin, atau tidak.
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
HVAC_SIDE_MIRROR_HEAT
Pemanas kaca spion samping. Nilai yang meningkat menunjukkan tingkat pemanasan yang lebih tinggi untuk kaca spion samping.
Anda harus menentukan maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. Dalam data konfigurasi:
maxInt32Value
mewakili tingkat pemanasan maksimum.minInt32Value
HARUS 0 dan menunjukkan tidak ada pemanasan.
Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang setelan pemanasan relatif yang ditentukan.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM memiliki
opsi untuk menerapkannya sebagai VehiclePropertyAccess.READ
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HVAC_STEERING_WHEEL_HEAT
Menetapkan jumlah pemanas dan pendingin untuk setir. maxInt32Value
dan
minInt32Value
di VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan setelan pemanas setir maksimum. minInt32Value
harus 0, kecuali jika kendaraan juga mendukung pendinginan
setir. Dalam hal ini, minInt32Value
menunjukkan setelan pendinginan
setir maksimum. Properti ini tidak berada dalam unit tertentu, tetapi dalam rentang setelan pemanas
yang ditentukan. Properti ini ditentukan sebagai VehiclePropertyAccess.READ
, 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
HVAC_TEMPERATURE_CURRENT
Suhu saat ini HVAC.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
Satuan suhu untuk ditampilkan. Menunjukkan apakah suhu ditampilkan dalam Celcius atau Fahrenheit.
VehiclePropConfig.configArray
menunjukkan satuan tampilan suhu yang didukung. Misalnya,
configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
Parameter ini DAPAT digunakan untuk
menampilkan suhu HVAC apa pun dalam sistem. Nilai harus berupa salah satu dari
VehicleUnit.CELSIUS
atau VehicleUnit.FAHRENHEIT
Jika memperbarui HVAC_TEMPERATURE_DISPLAY_UNITS memengaruhi nilai properti
*_DISPLAY_UNITS
lainnya, nilainya harus diperbarui dan dikomunikasikan ke
framework AAOS.
Properti ini ditentukan sebagai
VehiclePropertyAccess.READ_WRITE
, tetapi OEM dapat menerapkan
VehiclePropertyAccess.READ
saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: VehicleUnit
Jenis unit: T/A
Rilis: Android 13
HVAC_TEMPERATURE_SET
Suhu target HVAC disetel dalam Celcius.
minFloatValue
dan maxFloatValue
di VehicleAreaConfig
harus ditentukan:
minFloatValue
setelan suhu minimum dalam Celsius.maxFloatValue
setelan suhu maksimum dalam Celcius.
Jika semua nilai antara minFloatValue
dan maxFloatValue
tidak
didukung, gunakan configArray
untuk mencantumkan nilai suhu yang valid yang dapat ditetapkan.
Ini juga menjelaskan tabel pencarian untuk mengonversi suhu dari Celsius ke Fahrenheit (dan
sebaliknya) untuk kendaraan. configArray
harus ditentukan jika konversi unit standar
tidak didukung di kendaraan.
configArray
ditetapkan sebagai berikut:
configArray[0]
[batas bawah suhu yang didukung dalam Celcius] * 10configArray[1]
[batas atas suhu yang didukung dalam Celcius] * 10configArray[2]
[increment in Celsius] * 10configArray[3]
[batas bawah suhu yang didukung dalam Fahrenheit] * 10configArray[4]
[batas atas suhu yang didukung dalam Fahrenheit] * 10configArray[5]
[increment in Fahrenheit] * 10
minFloatValue
dan maxFloatValue
di VehicleAreaConfig
harus sama dengan configArray[0]
dan
configArray[1]
. Misalnya, jika kendaraan mendukung nilai suhu
sebagai [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
dalam
Fahrenheit, configArray
harus
configArray = {160, 280, 5, 605, 845, 10}
Idealnya, rasio penambahan Celsius terhadap penambahan Fahrenheit harus mendekati
rasio sebenarnya yaitu 1 derajat Celsius terhadap 1,8 derajat Fahrenheit. Harus ada pemetaan satu-ke-satu
dari semua nilai Celsius ke nilai Fahrenheit yang ditentukan oleh configArray
. configArray
digunakan oleh
klien untuk mengonversi suhu properti ini dari Celsius ke Fahrenheit. Selain itu, ini memungkinkan klien mengetahui nilai Celsius untuk menetapkan properti guna mencapai nilai Fahrenheit yang diinginkan untuk sistem. Jika ECU tidak memiliki pemetaan satu-ke-satu dari semua nilai Celcius ke nilai Fahrenheit,
configArray
hanya boleh menentukan daftar nilai Celcius dan Fahrenheit
yang memiliki pemetaan satu-ke-satu.
Misalnya, jika ECU mendukung nilai Celcius dari 16 hingga 28 dan nilai Fahrenheit dari 60 hingga
85, masing-masing dengan penambahan 1, maka salah satu kemungkinan configArray
adalah
code>{160, 280, 10, 600, 840, 20}Dalam hal ini, 85 bukan suhu yang didukung.
Setiap nilai yang ditetapkan di antara nilai yang valid harus dibulatkan ke nilai valid terdekat. Sebaiknya OEM juga menerapkan properti kendaraan HVAC_TEMPERATURE_VALUE_SUGGESTION
karena menyediakan metode sederhana bagi aplikasi untuk menentukan nilai suhu yang dapat ditetapkan untuk kendaraan dan untuk mengonversi nilai antara Celcius dan Fahrenheit.
Properti ini ditentukan sebagai VehiclePropertyAccess.READ
, tetapi OEM dapat menerapkannya sebagai
VehiclePropertyAccess.READ
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE/READ
Jenis enum: T/A
Jenis unit: VehicleUnit:CELSIUS
Rilis: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
Nilai yang disarankan untuk menetapkan suhu HVAC.
Terapkan properti untuk membantu aplikasi memahami nilai suhu terdekat yang didukung dalam Celcius atau Fahrenheit.
floatValues[0]
Nilai yang diminta yang ingin ditetapkan suhunya oleh aplikasi.floatValues[1]
Satuan untukfloatValues[0]
dan harus berupa salah satu dari{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2]
Nilai OEM yang disarankan dalam CELSIUS (nilai ini tidak disertakan dalam permintaan).floatValues[3]
Nilai OEM yang disarankan dalam FAHRENHEIT (nilai ini tidak disertakan dalam permintaan).
Aplikasi memanggil set(VehiclePropValue propValue)
dengan nilai dan unit yang diminta untuk nilai tersebut. OEM harus menampilkan nilai yang disarankan di
floatValues[2]
dan floatValues[3]
dengan callback
onPropertyEvent()
.
Nilai yang disarankan harus sesuai dengan nilai yang dapat berasal dari
HVAC_TEMPERATURE_SET
configArray
Dengan kata lain, nilai yang disarankan
dan tabel nilai
dari configArray
harus sama.
Sebaiknya OEM menambahkan logika kustom dalam penerapan VHAL mereka untuk menghindari pembuatan permintaan ke ECU HVAC. Logikanya dapat berupa sebagai berikut. Untuk mengonversi suhu dari Celsius ke 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;
Misalnya, saat pengemudi menggunakan asisten suara untuk menyetel suhu HVAC ke 66,2 dalam Fahrenheit.
Pertama, aplikasi menetapkan properti ini dengan nilai
[66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
Jika OEM menyarankan untuk menetapkan 19,0 dalam Celcius atau 66,5 dalam Fahrenheit sesuai permintaan pengguna, VHAL
harus membuat callback dengan nilai properti
[66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
Setelah asisten suara mendapatkan callback, asisten suara akan memberi tahu pengguna dan menetapkan suhu HVAC ke
nilai yang disarankan.
Contoh lain, aplikasi menerima 21 Celsius sebagai nilai suhu saat ini dengan mengkueri
HVC_TEMPERATURE_SET
, tetapi aplikasi perlu mengetahui nilai yang ditampilkan di UI
mobil dalam Fahrenheit. Untuk ini, aplikasi menetapkan properti ke
[21, (float)VehicleUnit.CELSIUS, 0, 0]
Jika nilai yang disarankan oleh OEM untuk 21 Celcius adalah 70 Fahrenheit, VHAL harus menghasilkan
callback dengan nilai properti [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
Dalam hal
ini, aplikasi dapat mengetahui bahwa nilainya adalah 70,0 Fahrenheit di UI mobil.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HW_CUSTOM_INPUT
Menentukan peristiwa input partner OEM kustom. Peristiwa input ini harus digunakan oleh partner OEM yang ingin menyebarkan peristiwa yang tidak didukung oleh Android. Nilai ini hanya terdiri dari array nilai int32. Properti Android adalah:
int32Values[0]
Kode input yang mengidentifikasi fungsi yang mewakili peristiwa ini. Jenis peristiwa yang valid ditentukan olehCustomInputType.CUSTOM_EVENT_F1
hinggaCustomInputType.CUSTOM_EVENT_F10
Jenis peristiwa ini mewakili peristiwa kustom yang akan ditentukan oleh partner OEM.int32Values[1]
Jenis tampilan target yang ditentukan diVehicleDisplay
Peristiwa yang tidak terikat dengan tampilan tertentu harus dikirim keVehicleDisplay#MAIN
int32Values[2]
Penghitung ulangi, jika 0, peristiwa tidak diulang. Nilai 1 atau lebih tinggi menunjukkan berapa kali peristiwa ini telah diulang.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: CustomInputType
Jenis unit: T/A
Rilis: Android 13
HW_KEY_INPUT
Properti untuk memasukkan peristiwa input hardware ke Android.
int32Values[0]
Tindakan yang ditentukan oleh VehicleHwKeyInputActionint32Values[1]
Kode kunci, harus menggunakan kode kunci android standarint32Values[2]
Tampilan target yang ditentukan diVehicleDisplay
Peristiwa yang tidak terikat dengan tampilan tertentu harus dikirim keVehicleDisplay#MAIN
int32Values[3]
(Opsional) Jumlah jeda. Nilai harus sama dengan atau lebih besar dari 1. Jika dihilangkan, Android akan ditetapkan secara default ke 1.
Ubah mode: .ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
HW_KEY_INPUT_V2
Properti untuk memasukkan peristiwa input hardware ke Android.
int32array[0]
Tampilan target yang ditentukan olehVehicleDisplay
seperti:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1]
Kode kunci, harus menggunakan kode kunci Android standar, sepertiKEYCODE_HOME
danKEYCODE_BACK
- Tindakan
int32array[2]
yang ditentukan di VehicleHwKeyInputAction, seperti:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
int32array[3]
Jumlah pengulangan peristiwa. Untuk peristiwa tombol ditekan, ini adalah jumlah ulangan dengan tombol pertama ditekan dimulai dari 0 dan dihitung dari sana. Untuk peristiwa tombol atas, nilai ini selalu sama dengan 0.int64array[0]
Waktu nonaktif dalam nanodetik yang berlalu sejak booting terakhir. Menunjukkan waktu peristiwa tombol ditekan terbaru. Untuk peristiwa down, ini adalah waktu peristiwa down.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
HW_MOTION_INPUT
Properti untuk memasukkan peristiwa input hardware ke Android.
int32array[0]
Tampilan target yang ditentukan olehVehicleDisplay
, seperti:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
int32array[1]
Jenis input yang ditentukan di VehicleHwMotionInputSource, seperti:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
Kode tindakan yang ditentukan di VehicleHwMotionInputAction, seperti:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
int32array[3]
Flag status tombol yang ditentukan di VehicleHwMotionButtonStateFlag, seperti:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
Jumlah peristiwa pointer, N. N harus berupa bilangan bulat positif.int32array[5:5+N-1]
ID pointer, panjang Nint32array[5+N:5+2*N-1]
Jenis alat, panjang N. Seperti yang ditentukan dalamVehicleHwMotionToolType
, seperti:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
- Data
floatArray[0:N-1]
x, panjang N - Data y
floatArray[N:2*N-1]
, panjang N - Data tekanan
floatArray[2*N:3*N-1]
, panjang N - Data ukuran
floatArray[3*N:4*N-1]
, panjang N int64array[0]
Waktu nonaktif, nanodetik yang berlalu sejak booting. Menunjukkan waktu saat pengguna awalnya menekan ke bawah untuk memulai streaming peristiwa posisi. Untuk peristiwa down, ini adalah waktu peristiwa down.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 14
HW_ROTARY_INPUT
Properti untuk memasukkan peristiwa rotasi hardware ke Android.
int32Values[0]
RotaryInputType untuk mengidentifikasi tombol putar yang diputar.int32Values[1]
Jumlah detent (klik), positif untuk searah jarum jam, negatif untuk berlawanan arah jarum jam.int32Values[2]
Tampilan target yang ditentukan dalam PeristiwaVehicleDisplay
yang tidak terikat dengan tampilan tertentu harus dikirim keVehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2]
Delta nanodetik antara pasangan jeda berturut-turut jika jumlah jeda lebih dari 1 atau kurang dari -1.VehiclePropValue.timestamp
Kapan rotasi terjadi. Jika jumlah detent lebih dari 1 atau kurang dari -1, saat detent rotasi pertama terjadi.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: RotaryInputType
Jenis unit: T/A
Rilis: Android 13
IGNITION_STATE
Merepresentasikan status pengapian.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleIgnitionState
Jenis unit: T/A
Rilis: Android 13
INFO_DRIVER_SEAT
Implementasi VHAL lokasi kursi pengemudi harus mengabaikan areaId. Gunakan
VehicleArea:GLOBAL
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: VehicleAreaSeat
Jenis unit: T/A
Rilis: Android 13
INFO_EV_BATTERY_CAPACITY
Kapasitas baterai nominal untuk kendaraan listrik atau hibrida. Menampilkan kapasitas baterai nominal, EV
atau hibrida. Ini adalah total kapasitas baterai yang dapat digunakan saat kendaraan masih baru. Nilai ini mungkin
berbeda dengan EV_CURRENT_BATTERY_CAPACITY
karena
EV_CURRENT_BATTERY_CAPACITY
menampilkan kapasitas baterai yang dapat digunakan secara real-time dengan
mempertimbangkan faktor-faktor seperti penuaan baterai dan dependensi suhu.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:WH
Rilis: Android 13
INFO_EV_CONNECTOR_TYPE
Daftar konektor yang dapat digunakan Kendaraan Listrik ini. Jika kendaraan memiliki beberapa port pengisian daya, properti ini harus menampilkan semua kemungkinan jenis konektor yang dapat digunakan oleh setidaknya satu port pengisian daya di kendaraan.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: EvConnectorType
Jenis unit: T/A
Rilis: Android 13
INFO_EV_PORT_LOCATION
Properti ini harus menyampaikan lokasi port pengisian daya di Kendaraan Listrik menggunakan
enum PortLocationType. Jika kendaraan memiliki beberapa port, properti ini harus menampilkan
port yang memungkinkan pengisian daya tercepat. Untuk mengomunikasikan semua lokasi port, gunakan
INFO_MULTI_EV_PORT_LOCATIONS
Mode akses: BACA
Jenis enum:
PortLocationType
Jenis unit: T/A
Rilis: Android 13
INFO_EXTERIOR_DIMENSIONS
Dimensi eksterior kendaraan:
- Tinggi:
int32Values[0]
- Durasi:
int32Values[1]
- Lebar:
int32Values[2]
- Lebar, termasuk cermin:
int32Values[3]
- Jarak sumbu roda, termasuk spion:
int32Values[4]
- Lebar jalur depan:
int32Values[5]
- Lebar jalur belakang:
int32Values[6]
- Diameter belok dari tepi jalan ke tepi jalan:
int32Values[7]
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLIMETER
Rilis: Android 13
INFO_FUEL_CAPACITY
Kapasitas bahan bakar kendaraan dalam mililiter. Properti ini harus menyampaikan jumlah maksimum
bahan bakar yang dapat disimpan di kendaraan dalam milililiter. Properti ini tidak berlaku untuk kendaraan
listrik (EV). Artinya, jika INFO_FUEL_TYPE
hanya berisi
FuelType::FUEL_TYPE_ELECTRIC
, INFO_FUEL_CAPACITY tidak boleh diterapkan.
Untuk kendaraan listrik, terapkan INFO_EV_BATTERY_CAPACITY.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLILITER
Rilis: Android 13
INFO_FUEL_DOOR_LOCATION
Lokasi tutup tangki bahan bakar. Properti ini harus menyampaikan lokasi pintu bahan bakar pada kendaraan.
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 INFO_EV_PORT_LOCATION
atau INFO_MULTI_LOCATIONS
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: PortLocationType
Jenis unit: T/A
Rilis: Android 13
INFO_FUEL_TYPE
Daftar bahan bakar yang dapat digunakan kendaraan. FuelType::FUEL_TYPE_ELECTRIC
hanya boleh
disertakan jika kendaraan dapat dicolokkan dan dapat diisi ulang. Misalnya, Kendaraan Listrik Hybrid Penuh
(FHEV) tidak boleh menyertakan FuelType::FUEL_TYPE_ELECTRIC
karena nilai INT32_VEC
untuk INFO_FUEL_TYPE
INFO_FUEL_TYPE
dapat diisi seperti itu.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
FuelType::FUEL_TYPE_ELECTRIC
sebagai nilai INT32_VEC untuk
INFO_FUEL_TYPE
INFO_FUEL_TYPE
dapat diisi seperti itu,
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: FuelType
Jenis unit: T/A
Rilis: Android 13
INFO_MAKE
Produsen kendaraan. Properti ini harus menyampaikan nama merek publik kendaraan.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
INFO_MODEL
Model kendaraan. Properti ini harus menyampaikan nama model publik kendaraan.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
INFO_MODEL_YEAR
Tahun model kendaraan dalam format `YYYY` berdasarkan kalender Gregorian.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:YEAR
Rilis: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
Beberapa lokasi port Kendaraan Listrik Umum. Terapkan properti ini jika kendaraan memiliki beberapa port Kendaraan Listrik Umum. Lokasi port ditentukan di PortLocationType. Misalnya, mobil memiliki satu port kiri depan dan satu port kiri belakang:
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
Jika kendaraan hanya memiliki satu port, nilai properti ini harus mencantumkan satu elemen. Untuk mendeskripsikan satu lokasi port, lihat INFO-EV-PORT-LOCATION
.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: PortLocationType
Jenis unit: T/A
Rilis: Android 13
INFO_VIN
VIN kendaraan.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
INITIAL_USER_INFO
Menentukan pengguna Android yang akan digunakan selama inisialisasi. Properti ini dipanggil oleh
sistem Android saat melakukan inisialisasi dan memungkinkan HAL menentukan pengguna Android mana yang harus
dimulai. Permintaan ini dibuat dengan menetapkan VehiclePropValue (ditentukan oleh
InitialUserInfoRequest
), dan HAL harus merespons dengan peristiwa perubahan properti (ditentukan
oleh InitialUserInfoResponse).
Jika HAL tidak merespons setelah waktu yang ditentukan oleh sistem Android, sistem Android akan melanjutkan
seolah HAL menampilkan respons tindakan InitialUserInfoResponseAction:DEFAULT.
Misalnya, saat booting pertama, permintaannya dapat berupa:
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
). Misalnya, untuk membuat
pengguna Pemilik yang sama dengan lokalitas en-US dan pt-BR, nilai string responsnya adalah
en-US,pt-BR||Pemilik. Dengan demikian, lokalitas maupun nama tidak boleh berisi dua batang vertikal
(||
) dalam nilainya, meskipun Anda dapat menggunakan satu batang vertikal (|
).
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: 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
Merepresentasikan fitur untuk mengaktifkan dan menonaktifkan kemampuan kursi untuk mengaktifkan airbag saat dipicu
(misalnya, dalam tabrakan). Jika true
, berarti airbag kursi diaktifkan dan,
jika dipicu, airbag akan mengembang. Jika true
, airbag kursi akan dinonaktifkan, dan tidak akan
mengembang dalam situasi apa pun. Properti ini tidak menunjukkan apakah airbag diaktifkan.
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 antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan kecepatan gerakan maksimum sandaran kursi saat
miring ke depan. minInt32Value
menunjukkan kecepatan gerakan maksimum sandaran
kursi saat direbahkan.
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
Posisi sudut sandaran kursi 1. Sudut sandaran 1 adalah aktuator yang paling dekat dengan bagian bawah
kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung. minInt32Value
menunjukkan
posisi sandaran kursi yang direbahkan sepenuhnya sehubungan dengan aktuator di bagian bawah kursi. maxInt32Value
menunjukkan posisi sandaran kursi yang paling tegak atau maju
sehubungan dengan 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 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
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
miring 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 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_2_POS
Posisi sudut sandaran kursi 2. Sudut sandaran 2 adalah aktuator berikutnya dari bagian bawah kursi.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig
harus ditentukan. 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 status transisi
antara posisi berbaring penuh, tegak, dan maju.
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
SEAT_BELT_BUCKLED
Sabuk pengaman diikat. True menunjukkan sabuk terpasang. Akses tulis menunjukkan kemampuan pengencang sabuk pengaman 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: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_BELT_HEIGHT_MOVE
Pergerakan tinggi sabuk pengaman. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum anchor bahu
sabuk pengaman saat bergerak ke atas. minInt32Value
mewakili kecepatan gerakan maksimum
anchor bahu sabuk pengaman saat 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 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_BELT_HEIGHT_POS
Posisi tinggi sabuk pengaman. Menyesuaikan titik anchor sabuk bahu.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
minInt32Value
menunjukkan anchor bahu sabuk pengaman berada di posisi
terendah. maxInt32Value
menunjukkan bahwa anchor bahu sabuk pengaman berada di
posisi tertinggi.
Nilai antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi 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
SEAT_CUSHION_SIDE_SUPPORT_MOVE
Merepresentasikan properti untuk arah gerakan dan kecepatan dukungan sisi bantalan kursi.
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum dukungan samping
bantalan kursi saat semakin lebar (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, berarti 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
.
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
Merepresentasikan properti untuk posisi dukungan sisi pinggul (sisi bantalan bawah) kursi.
maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat
antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan bahwa dukungan samping bantalan kursi berada di posisi terluasnya (misalnya,
dukungan paling sedikit). 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 paling tipis dan paling lebar.
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<>
Mode perubahan: 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 ditentukan. 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 ditentukan sebagai VehiclePropertyAccess.READ_WRITE
, tetapi OEM hanya dapat
menerapkannya sebagai VehiclePropertyAccess.READ
.
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 punggung ke tepi depan kursi.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua bilangan bulat
antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan kursi berada dalam posisi paling dangkal (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 ditentukan 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 14
SEAT_FOOTWELL_LIGHTS_STATE
Merepresentasikan properti untuk status lampu ruang kaki kursi. SEAT_FOOTWELL_LIGHTS_STATE
mencerminkan
status lampu saat ini pada waktu tertentu. Hal ini berbeda dengan fungsi
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
dengan 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 tombol yang mengontrol lampu. Hal ini berbeda dengan fungsi
SEAT_FOOTWELL_LIGHTS_STATE yang mencerminkan status lampu saat ini pada waktu tertentu.
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 dengan nilai CABIN_LIGHTS_SWITCH.
Untuk setiap ID area yang didukung, 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
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: VehicleLightSwitch
Jenis unit: T/A
Rilis: Android 13
SEAT_FORE_AFT_MOVE
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 ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus
didukung.
maxInt32Value
mewakili kecepatan gerakan 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 direset 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 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_FORE_AFT_POS
Posisi depan dan belakang kursi. Menetapkan posisi kursi ke depan dan belakang.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan.
Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
minInt32Value
menunjukkan bahwa kursi berada di posisi linear paling belakang.
maxInt32Value
menunjukkan bahwa kursi berada di posisi linear paling depan. Nilai
antara minInt32Value
dan maxInt32Value
menunjukkan status transisi
antara posisi terdekat dan terjauh.
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
SEAT_HEADREST_ANGLE_MOVE
Gerakan sudut headrest. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum headrest kursi saat
bergerak ke posisi tegak atau maju. minInt32Value
mewakili kecepatan gerakan
maksimum headrest kursi saat bergerak ke posisi dangkal.
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
SEAT_HEADREST_ANGLE_MOVE
adalah 0, berarti tidak ada gerakan yang terjadi.
Properti ini direpresentasikan sebagai rentang kecepatan gerakan 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_HEADREST_ANGLE_POS
Posisi sudut headrest. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan. 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
status transisi antara posisi berbaring penuh dan posisi paling tegak dan ke depan.
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
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_FORE_AFT_MOVE
Sandaran kepala bergerak ke depan dan ke belakang. maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum headrest kursi
saat bergerak maju. minInt32Value
mewakili kecepatan gerakan maksimum
headrest kursi saat bergerak mundur.
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
SEAT_HEADREST_FORE_AFT_MOVE
adalah 0, berarti 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
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_FORE_AFT_POS
Posisi sandaran kepala depan dan belakang. maxInt32Value
dan minInt32Value
di VehicleAreaConfig
harus ditentukan. Semua bilangan bulat 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
.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_HEADREST_HEIGHT_MOVE
Gerakan tinggi headrest. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig
harus ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum headrest 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, berarti 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
.
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 di antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi 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 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 direset ke 0. Jika nilai
SEAT_HEIGHT_MOVE
adalah 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
.
Mode perubahan: 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 di antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi 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
SEAT_LUMBAR_FORE_AFT_MOVE
Gerakan lumbar ke depan dan ke belakang. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum dukungan lumbar kursi
saat bergerak maju. minInt32Value
mewakili kecepatan gerakan maksimum
penyangga lumbar kursi saat 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 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_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 dukungan lumbar berada di posisi paling belakang
(misalnya, posisi yang paling tidak mendukung). maxInt32Value
menunjukkan bahwa dukungan
lumbar berada di posisi paling depan (misalnya, posisi yang paling mendukung).
Nilai di 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
.
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 ditentukan. Semua bilangan bulat antara minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
mewakili kecepatan gerakan maksimum dukungan sisi lumbar
kursi saat semakin lebar. minInt32Value
mewakili kecepatan gerakan
maksimum dari dukungan sisi lumbar kursi saat 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
.
Mode perubahan: ON_CHANGE
Jenis akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
Posisi dukungan samping 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
.
Mode perubahan: 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 bahwa dukungan lumbar bergerak dengan kecepatan
ke atas tercepat. minInt32Value
menunjukkan bahwa dukungan lumbar bergerak dengan kecepatan menurun
tercepat.
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 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_LUMBAR_VERTICAL_POS
Merepresentasikan properti untuk posisi vertikal dukungan lumbar kursi. maxInt32Value
dan minInt32Value
di setiap VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara
minInt32Value
dan maxInt32Value
harus didukung.
maxInt32Value
menunjukkan posisi tertinggi penyangga lumbar.
minInt32Value
menunjukkan posisi terendah penyangga lumbar.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi 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
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
SEAT_MEMORY_SET
Setelan ini memungkinkan pengguna menyimpan setelan posisi kursi saat ini ke slot preset
yang dipilih. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig
harus ditentukan. minInt32Value
harus 0, dan
maxInt32Value
untuk setiap posisi kursi harus cocok dengan maxInt32Value
untuk
SEAT_MEMORY_SELECT
Mode perubahan: ON_CHANGE
Mode akses: WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SEAT_OCCUPANCY
Menunjukkan apakah kursi tertentu ditempati, sesuai kemampuan mobil untuk menentukan. Nilai yang valid berasal dari enum VehicleSeatOccupancyState
.
Mode perubahan: 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 saat bergerak ke atas. minInt32Value
mewakili kecepatan gerakan maksimum tepi depan kursi
saat 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 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_TILT_POS
Posisi kemiringan kursi. maxInt32Value
dan minInt32Value
di
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. minInt32Value
menunjukkan bahwa bagian bawah kursi miring pada posisi sudut terendah. Ini sesuai dengan tepi depan
kursi pada posisi serendah mungkin relatif terhadap ujung belakang kursi.
maxInt32Value
menunjukkan bahwa bagian bawah kursi miring pada posisi sudut tertingginya.
Ini sesuai dengan tepi depan kursi pada posisi setinggi mungkin relatif terhadap bagian
belakang kursi.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi 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 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 kursi berada dalam posisi masuk penuh.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status transisi
antara posisi normal dan walk-in.
Properti ini direpresentasikan sebagai rentang posisi relatif yang 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 ditentukan sebagai VehiclePropertyAccess.READ_WRITE, tetapi OEM dapat
terapkan sebagai VehiclePropertyAccess.READ saja.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SHUTDOWN_REQUEST
Meminta head unit untuk dimatikan.
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. Unit kepala mengirimkan pesan ini setelah tugas selesai.
Properti ini tidak berlaku saat pengguna ingin mematikan head unit.
Hal ini biasanya melibatkan pemberitahuan ke sistem terpisah di luar head unit (misalnya pengontrol daya) untuk bersiap mematikan head unit.
Sistem eksternal harus memvalidasi bahwa permintaan ini valid dengan memeriksa apakah kendaraan sedang digunakan. Jika pengguna memasuki kendaraan setelah SHUTDOWN_REQUEST dikirim, sistem harus mengabaikan permintaan ini. Sebaiknya simpan properti VehicleInUse di pengontrol daya dan tampilkan melalui properti VEHICLE_IN_USE. Permintaan penonaktifan harus diabaikan jika VehicleInUse bernilai benar.
Jika diizinkan, sistem eksternal akan mengirimkan sinyal penonaktifan ke head unit, yang menyebabkan VHAL mengirim 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 nilai properti ini ditetapkan, permintaan untuk melakukan shutdown akan dikeluarkan, apa pun nilai properti saat ini. Nilai properti saat ini tidak ada artinya.
Karena properti ini hanya dapat ditulis, langganan tidak diizinkan dan tidak ada peristiwa perubahan properti yang dihasilkan.
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 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.
Mode perubahan: 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 setir yang 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
setir mencapai batas posisi, nilai harus direset ke 0. Jika nilai
STEERING_WHEEL_DEPTH_MOVE
saat ini 0, tidak ada gerakan yang sedang berlangsung.
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_DEPTH_POS
Posisi kedalaman setir. Semua ID unik properti roda kemudi dimulai dari 0x0BE0.
maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan. Semua nilai antara minInt32Value
dan maxInt32Value
harus
didukung. maxInt32Value
menunjukkan posisi roda kemudi yang paling jauh dari
pengemudi. minInt32Value
menunjukkan posisi kemudi yang paling dekat dengan
pengemudi.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan
status transisi antara
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 14
STEERING_WHEEL_EASY_ACCESS_ENABLED
Fitur akses mudah kemudi diaktifkan. Jika benar, setir pengemudi akan otomatis disesuaikan untuk memudahkan pengemudi masuk dan keluar 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
STEERING_WHEEL_HEIGHT_MOVE
Gerakan ketinggian setir. 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, berarti 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 ditentukan. Semua nilai antara minInt32Value
dan maxInt32Value
harus
didukung. maxInt32Value
menunjukkan bahwa roda kemudi berada dalam posisi
tertinggi. minInt32Value
menunjukkan bahwa roda kemudi berada di posisi
terendah.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan
status transisi 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 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.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: VehicleLightState
Jenis unit: T/A
Rilis: Android 14
STEERING_WHEEL_LIGHTS_SWITCH
Tombol lampu setir. Menampilkan posisi tombol yang mengontrol lampu
setir. 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
.
Mode perubahan: 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 kemudi anti-pencurian 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.
Mode perubahan: 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 dipertahankan di ECU yang terpisah dari IVI. Properti ini awalnya ditetapkan oleh AAOS, yang membuatnya menggunakan CSRNG. AAOS kemudian membaca properti pada booting berikutnya. Seed binding diharapkan dapat dipertahankan dengan andal. Setiap hilangnya seed akan menyebabkan reset IVI ke setelan pabrik.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SUPPORT_CUSTOMIZE_VENDOR_PERMISSION
Mendukung izin penyesuaian 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 enum di VehicleVendorPermission.
configArray ditetapkan sebagai berikut, configArray[n]: propId : property ID
untuk
properti vendor dengan configArray[n+1] adalah enum di VehicleVendorPermission dan menunjukkan
izin 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 tidak ada dalam array ini, properti vendor akan memiliki izin vendor default. Jika vendor memilih PERMISSION_NOT_ACCESSIBLE, Android tidak memiliki akses ke properti. Dalam contoh ini, Android tidak dapat menulis nilai untuk vendor_prop_2.
Mode perubahan: STATIC
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
SUPPORTED_PROPERTY_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
SWITCH_USER
Menentukan permintaan untuk mengalihkan 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, permintaan tersebut akan menetapkan 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 (jika 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 setelah menerima permintaan ini, tetapi tidak perlu membalas ke sistem Android. Jika pengguna internalnya tidak dapat diubah karena alasan tertentu, panggilan tersebut harus menunggu panggilanSWITCH_USER(type=ANDROID_POST_SWITCH)
pulih (misalnya, panggilan tersebut dapat mengeluarkanSWITCH_USER(type=VEHICLE_REQUEST)
untuk beralih kembali ke pengguna sebelumnya). Idealnya, tindakan ini tidak boleh 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 // request idint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // target user idint32[3]
0 // flag pengguna target (tidak ada)int32[4]
10 // pengguna saat iniint32[5]
0 // flag 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 // flag 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 (tidak ada yang memiliki tanda khusus), permintaannya adalah:int32[0]
42 // request idint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // target user idint32[3]
0 // flag pengguna target (tidak ada)int32[4]
10 // pengguna saat iniint32[5]
0 // flag 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 // tanda pengguna kedua (tidak ada)int32[11]
11 // Pengguna ke-3 (pengguna 11)int32[12]
0 // Flag pengguna ke-3 (tidak ada)
Jika permintaan berhasil, HAL harus memperbarui properti dengan:
int32[0]
42 // request idint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
Jika permintaan gagal, responsnya akan seperti ini:
int32[0]
42 // request idint32[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 dilanjutkan atau dibatalkan. Lihat juga ANDROID_SWITCH.VEHICLE_REQUEST
Dipanggil oleh HAL untuk meminta agar pengguna Android latar depan saat ini diubah. Hal 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 // request idint32[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 // request idint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // target user idint32[3]
0 // flag ID pengguna target (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 // flag 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, 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. Hal ini setara dengan menerima Intent.ACTION_USER_UNLOCKED di aplikasi Android.
- Jika gagal, metode ini akan langsung dipanggil dan nilai ID pengguna saat ini dan target dalam respons akan 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.
- Permintaan. Nilai N pertama seperti yang ditentukan oleh
INITIAL_USER_INFO
(dengan nilai khusus permintaan pada indeks 1 adalahSwitchUserMessageType::ANDROID_POST_SWITCH
), lalu dua nilai lagi untuk ID pengguna target (misalnya, ID pengguna Android yang diminta untuk dialihkan) dan flag-nya (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. minFloatValue dan maxFloatValue masing-masing digunakan untuk menyimpan rentang tekanan yang direkomendasikan OEM. Nilai untuk minFloatValue dan maxFloatValue di VehicleAreaConfig harus ditentukan.
minFloatValue dalam data areaConfig mewakili batas bawah tekanan ban yang direkomendasikan. maxFloatValue dalam data areaConfig mewakili batas atas 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, } }
Mode perubahan: 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 yang digunakan mobil untuk menampilkan tekanan ban kepada pengguna. Misalnya, PSI, Bar, atau Kilopascal. VehiclePropConfig.configArray digunakan untuk menunjukkan unit tampilan tekanan yang didukung. Unit 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 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: VehicleUnit
Jenis unit: T/A
Rilis: Android 13
TRACTION_CONTROL_ACTIVE
Tetapkan ke benar (true) saat kontrol traksi (TC) aktif dan reset ke salah (false) saat TC nonaktif. Properti ini dapat disetel secara berkala (pulsa) berdasarkan status sistem TC secara real time.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
TRAILER_PRESENT
Menampilkan status trailer mobil.
Mode perubahan: 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. Bahkan, properti ini dapat digunakan tanpa mendukung fungsi inti terkait pengguna yang dijelaskan di INITIAL_USER_INFO.
Untuk membuat kueri pengaitan, sistem Android mendapatkan properti, yang meneruskan VehiclePropValue yang berisi jenis pengaitan yang dikueri, seperti yang ditentukan oleh UserIdentificationGetRequest. HAL harus segera ditampilkan, yang menampilkan VehiclePropValue dengan UserIdentificationResponse.
Perhatikan bahwa identifikasi pengguna terjadi saat sistem melakukan booting. Implementasi VHAL takehe hanya boleh menampilkan pengaitan yang telah diidentifikasi (seperti kunci FOB yang digunakan untuk membuka kunci mobil), bukan memulai pengaitan baru dari panggilan get.
Untuk mengaitkan jenis, sistem Android menetapkan properti, yang meneruskan VehiclePropValue yang berisi jenis dan nilai pengaitan yang ditetapkan, seperti yang ditentukan 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 dan mekanisme kustom yang disediakan oleh OEM, permintaannya adalah:
int32[0]
42 // request idint32[1]
10 (ID pengguna Android)int32[2]
0 (Flag 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 dikaitkan 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 // request idint32[1]
10 (ID pengguna Android)int32[2]
0 (Flag pengguna Android)int32[3]
1 (jumlah asosiasi yang ditetapkan)int32[4]
101 (jenis pertama: UserIdentificationAssociationType::CUSTOM_1)
Jika permintaan berhasil, responsnya akan berupa:
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. Pada contoh sebelumnya, status akhir akan menjadi dua pengaitan (FOB dan CUSTOM_1). Untuk mengaitkan pengguna dengan CUSTOM_1 saja, tetapi tidak dengan FOB, 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
VEHICLE_CURB_WEIGHT
Menampilkan berat 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. Berat kotor kendaraan adalah berat operasi maksimum kendaraan seperti yang ditentukan oleh produsen termasuk sasis, bodi, mesin, cairan mesin, bahan bakar, aksesori, pengemudi, penumpang, dan kargo kendaraan, 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 berada di dalam kendaraan. Misalnya, jika pengguna manusia membuka kunci kendaraan dari jarak jauh, kendaraan dianggap sedang digunakan. Jika properti ini didukung:
- Setiap kali pengguna menyalakan kendaraan atau sistem mendeteksi kehadiran pengguna,
VEHICLE_IN_USE
harus ditetapkan ke benar. 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 true.
Properti ini berbeda dengan AP_POWER_BOOTUP_REASON
dalam arti bahwa
AP_POWER_BOOTUP_REASON
hanya ditetapkan sekali selama booting sistem. Namun, properti ini
dapat berubah beberapa kali selama siklus booting sistem. Misalnya, perangkat saat ini tidak
digunakan. Sistem melakukan booting untuk menjalankan tugas jarak jauh. VEHICLE_IN_USE
salah. Saat
tugas jarak jauh dieksekusi, pengguna masuk ke kendaraan dan menyalakan kendaraan.
VEHICLE_IN_USE
disetel ke true. Setelah sesi mengemudi, pengguna mematikan kendaraan,
VEHICLE_IN_USE
disetel ke salah (false).
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
VEHICLE_MAP_SERVICE
Pesan Layanan Peta Kendaraan (VMS). Properti ini menggunakan data CAMPURAN untuk menyampaikan pesan VMS.
Kontennya harus ditafsirkan sebagai berikut. Indeks yang ditentukan dalam VmsMessageIntegerValuesInde
digunakan untuk membaca dari int32Values. byte adalah pesan VMS yang diserialisasi seperti yang ditentukan dalam protokol VMS, yang tidak transparan untuk framework. IVehicle#get harus selalu menampilkan
StatusCode::NOT_AVAILABLE
.
Mode perubahan: 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 satuan yang digunakan untuk menampilkan kecepatan kepada pengguna. Misalnya, m/s, km/jam, 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 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
VHAL_HEARTBEAT
Menentukan peristiwa yang disinyalir VHAL ke Car Watchdog sebagai heartbeat. Jika VHAL mendukung properti ini, VHAL harus menulis waktu aktif 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 detak jantung diberi sinyal hingga enam detik dari detak jantung 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.
Mode perubahan: 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 menetapkan properti ini ke waktu aktif sistem dalam milidetik setiap tiga detik. Saat booting, update mungkin memerlukan 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 tanda centang untuk setiap roda dalam urutan berikut:
- Kiri depan
- Kanan depan
- Kanan belakang
- Kiri belakang
Semua jumlah centang bersifat kumulatif. Jumlah tick bertambah saat kendaraan bergerak maju, dan menurun 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 klik roda dan roda mana
yang didukung configArray ditetapkan sebagai berikut:
configArray[0], bits [0:3] Supported wheels
Menggunakan enum Wheel. 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 tanda roda kanan depanconfigArray[3]
Mikrometer per tanda roda kanan belakangconfigArray[4]
Mikrometer per klik roda belakang kiri.
Jika roda tidak didukung, nilainya akan selalu ditetapkan ke 0.
VehiclePropValue.timestamp
harus diisi.
Mode perubahan: CONTINUOUS
Mode akses: READ
Jenis enum: T/A
Jenis unit: T/A
Rilis: Android 13
WINDOW_LOCK
Kunci anak jendela. Benar (true) menunjukkan bahwa jendela terkunci anak. 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_MOVE
Pemindahan jendela. maxInt32Value
dan minInt32Value
di setiap
VehicleAreaConfig harus ditentukan. Semua bilangan bulat antara minInt32Value
dan
maxInt32Value
harus didukung. maxInt32Value
menunjukkan jendela terbuka dalam bidang/menutup dalam arah di luar bidang dengan kecepatan
tercepat. 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
jendela mencapai batas posisi, nilai 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 terbuka:
Max
Membuka sunroof lebih jauh, berhenti secara otomatis saat terbuka sepenuhnya.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
Membuka sunroof, berhenti secara otomatis saat sunroof terbuka sepenuhnya.Min
Buka ventilasi, berhenti secara otomatis 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 di luar bidang. Jika jendela tidak dapat terbuka di luar bidang, minInt32Value
adalah posisi jendela saat tertutup sepenuhnya dan harus 0. Jika
jendela dapat terbuka di luar bidang, minInt32Value
menunjukkan bahwa jendela terbuka sepenuhnya
di posisinya di luar bidang dan merupakan nilai negatif. Lihat contoh di bawah untuk penjelasan
yang lebih mendetail. maxInt32Value
menunjukkan bahwa jendela terbuka sepenuhnya.
Nilai di antara minInt32Value
dan maxInt32Value
menunjukkan status
transisi antara posisi tertutup/terbuka sepenuhnya di luar bidang dan terbuka sepenuhnya. Properti ini tidak
dalam unit tertentu, tetapi dalam rentang posisi relatif yang ditentukan. 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 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
WINDSHIELD_WIPERS_PERIOD
Periode wiper kaca depan (milidetik). Menampilkan jangka waktu instan untuk satu siklus penuh kaca depan dalam milidetik. Siklus penuh didefinisikan sebagai wiper yang bergerak dari
dan kembali ke posisi diam. Saat setelan wiper intermiten dipilih, nilai properti ini
harus ditetapkan ke 0 selama periode jeda penghapusan intermiten. maxInt32Value
dan minInt32Value
di VehicleAreaConfig harus ditentukan.
maxInt32Value
untuk setiap ID area harus menentukan periode wiper terpanjang. minInt32Value
harus ditetapkan ke 0 untuk setiap ID area.
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: T/A
Jenis unit: VehicleUnit:MILLI_SECS
Rilis: Android 14
WINDSHIELD_WIPERS_STATE
Status wiper kaca depan. Menampilkan status penyeka kaca saat ini. Nilai
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
diterapkan, WINDSHIELD_WIPERS_PERIOD
harus mencerminkan jangka waktu satu siklus
wiper penuh.
Untuk setiap ID area yang didukung, array VehicleAreaConfig#supportedEnumValues
harus ditentukan kecuali jika semua status di WindshieldWipersState
didukung (termasuk OTHER, yang tidak direkomendasikan).
Mode perubahan: ON_CHANGE
Mode akses: READ
Jenis enum: WindshieldWipersState
Jenis unit: T/A
Rilis: Android 14
WINDSHIELD_WIPERS_SWITCH
Tombol wiper kaca depan. Menampilkan posisi tombol yang mengontrol penghapus kaca depan. 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 di
WindshieldWipersSwitch
didukung (termasuk OTHER, 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.
Mode perubahan: ON_CHANGE
Mode akses: READ_WRITE
/READ
Jenis enum: WindshieldWipersSwitch
Jenis unit: T/A
Rilis: Android 14