इस पेज पर, वीएचएएल में इस्तेमाल की जा सकने वाली सिस्टम प्रॉपर्टी की सूची दी गई है. VHAL के साथ काम करने वाली प्रॉपर्टी
नीचे दी गई सूची में से, सिस्टम प्रॉपर्टी या वेंडर प्रॉपर्टी होनी चाहिए. Android 14 और
प्रॉपर्टी की परिभाषाएं
hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl
.
प्रॉपर्टी की परिभाषा एआईडीएल इंटरफ़ेस में दी गई है,
android.hardware.automotive.vehicle.property
, जो वीएचएएल से अलग है
इंटरफ़ेस (android.hardware.automotive.vehicle
) का इस्तेमाल करता है. VHAL लागू करना और VHAL
क्लाइंट दोनों इंटरफ़ेस पर निर्भर होना चाहिए.
अपने-आप जनरेट होने वाले ऐक्सेस मोड और मोड बदलें
Android 14 और उसके बाद वाले वर्शन में, VHAL को लागू करने के लिए, हम अपने-आप जनरेट होने वाली सुविधाएं उपलब्ध कराते हैं C++ हेडर फ़ाइलें और Java क्लास फ़ाइलें जिसमें सिस्टम प्रॉपर्टी के लिए, अनुमति वाले बदलाव मोड या ऐक्सेस मोड का इस्तेमाल किया गया हो. वेंडर VHAL लागू करना इनका इस्तेमाल यह पक्का करने के लिए कर सकता है कि प्रॉपर्टी कॉन्फ़िगरेशन, ज़रूरी शर्तों के मुताबिक हैं.
A से D तक
ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE
Measured distance from leading vehicle when using Adaptive Cruise Control (ACC) or Predictive
Cruise Control (PCC). Returns the measured distance in millimeters between the rear-most point
of the leading vehicle and the front-most point of the ACC vehicle. The maxInt32Value
and minInt32Value
in VehicleAreaConfig
must be defined. The
minInt32Value
should be 0. The maxInt32Value
should be populated with
the maximum range the distance sensor can support. This value should be non-negative.
When no lead vehicle is detected (that is, when there is no leading vehicle or the leading
vehicle is too far away for the sensor to detect), this property should return
StatusCode.NOT_AVAILABLE
When this property is not available because CC is disabled (for example,
StatusCode#NOT_AVAILABLE_DISABLED
is false), this property must return
StatusCode#NOT_AVAILABLE_DISABLED
If CRUISE_CONTROL_STATE
is implemented and the state is set to an ErrorState
value, then this property
must return a StatusCode
that aligns with the ErrorState
value. For
example, if CRUISE_CONTROL_STATE
is set to
ErrorState#NOT_AVAILABLE_SPEED_LOW
, then this property must return
StatusCode#NOT_AVAILABLE_SPEED_LOW
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLIMETER
Release: Android 14
ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP
Current target time gap for ACC or PCC in milliseconds. This property should specify the target time gap to a leading vehicle. This gap is defined as the time to travel the distance between the leading vehicle's rear-most point to the ACC vehicle's front-most point. The actual time gap from a leading vehicle can be above or below this value.
The possible values to set for the target time gap should be specified in configArray in
ascending order. All values must be positive. If the property is writable, all values must be
writable. When this property is not available because CC is disabled (for example,
CRUISE_CONTROL_ENABLED
is false), this property must return
StatusCode#NOT_AVAILABLE_DISABLED
If CRUISE_CONTROL_STATE
is implemented and the state is set to an
ErrorState
value, then this property must return a StatusCode
that
aligns with the ErrorState
value. For example,
if CRUISE_CONTROL_STATE
is set to ErrorState#NOT_AVAILABLE_SPEED_LOW
,
then this property must return StatusCode#NOT_AVAILABLE_SPEED_LOW
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: VehicleUnit:MILLI_SECS
Release: Android 14
ABS_ACTIVE
The automatic brake system (ABS) is active. Set to true when ABS is active and reset to false when ABS is off. This property can be intermittently set (pulse) based on the real-time state of the ABS system.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
ANDROID_EPOCH_TIME
Current date and time, encoded as Epoch time (in milliseconds). This value denotes the number of milliseconds seconds that have elapsed since 1/1/1970 UTC.
This value denotes the number of milliseconds seconds that have elapsed since 1/1/1970 UTC.
CarServices WRITE
s to this value to give VHAL the Android system's time, if the VHAL
supports this property. This can be useful to synchronize other vehicle systems (dash clock) with
Android's time.
AAOS WRITE
s to this property once during boot, and thereafter WRITE
only when time-source changes are propagated. AAOS will fill in VehiclePropValue.timestamp
correctly. AAOS does not send updates for natural elapse of time. int64Values[0] = provided Unix
time (in milliseconds).
The property may take more than 0 ms to get propagated through the stack and, having a
timestamped property helps reduce any time drift. So, for all WRITE
s to the property,
the timestamp can be used to negate this drift:
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: VehicleUnit:MILLI_SECS
Release: Android 13
AP_POWER_BOOTUP_REASON
Property to report bootup reason for the current power on. This is a STATIC
property
that won't change for the whole duration until power off. For example, even if the user presses
the power button after automatic power on with door unlock, the bootup reason must stay with
VehicleApPowerBootupReason#USER_UNLOCK
int32Values[0]
must be
VehicleApPowerBootupReason
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
AP_POWER_STATE_REPORT
Property to report power state of app processor. It is assumed that AP's power state is controller by separate power controller.
int32Values[0]
VehicleApPowerStateReport enum valueint32Values[1]
Time in ms to wake up, if necessary (otherwise 0)
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
AP_POWER_STATE_REQ
Property to control power state of app processor. It is assumed that AP's power state is
controlled by a separate power controller. For configuration information,
VehiclePropConfig.configArray
must have bit flag combining values in
VehicleApPowerStateConfigFlag
int32Values[0]
VehicleApPowerStateReq enum valueint32Values[1]
Aadditional parameter relevant for each state, 0 if not used.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
AUTOMATIC_EMERGENCY_BRAKING_ENABLED
Enable or disable Automatic Emergency Braking (AEB).
Set true to enable AEB and false to disable AEB. When AEB is enabled, the ADAS system in the
vehicle should be turned on and monitoring to avoid potential collisions. This property should
apply for higher speed applications only. For enabling low speed automatic emergency braking,
LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED
should be used.
In general, AUTOMATIC_EMERGENCY_BRAKING_ENABLED
should always return true or false.
If the feature is not available due to some temporary state, such as the vehicle speed being too
low, that information must be conveyed through the ErrorState
values in the
AUTOMATIC_EMERGENCY_BRAKING_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but
OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
AUTOMATIC_EMERGENCY_BRAKING_STATE
Automatic Emergency Braking (AEB) state. Returns the current state of AEB. This property must
always return a valid state defined in AutomaticEmergencyBrakingState or ErrorState
It must not surface errors through StatusCode
and must use the supported error states
instead. This property should apply for higher speed applications only. For representing the state
of the low speed automatic emergency braking system,
LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE
should be used.
If AEB includes forward collision warnings before activating the brakes, those warnings must be surfaced through the Forward Collision Warning (FCW) properties.
For the global area ID (0), the StatusCode#VehicleAreaConfig#supportedEnumValues
array must be defined unless all states of both AutomaticEmergencyBrakingState
(including OTHER
, which is not recommended) and ErrorState
are
supported.
Change mode: ON_CHANGE
Access mode: READ
Enun type: ForwardCollisionWarningState/ErrorState
Unit type: N/A
Release: Android 14
BLIND_SPOT_WARNING_ENABLED
Enable and disable Blind Spot Warning (BSW). Set true to enable BSW and false to disable BSW. When BSW is enabled, the ADAS system in the vehicle should be turned on and monitoring for objects in the vehicle's blind spots.
In general, BLIND_SPOT_WARNING_ENABLED
should always return true or false. If the
feature is not available due to some temporary state, such as the vehicle speed being too low,
that information must be conveyed through the ErrorState
values in the
BLIND_SPOT_WARNING_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
,
but OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
BLIND_SPOT_WARNING_STATE
Blind Spot Warning (BSW) state. Returns the current state of BSW. This property must always
return a valid state defined in BlindSpotWarningState
or ErrorState
It must not surface errors through StatusCode
and must use the supported error states
instead.
For each supported area ID, StatusCode#VehicleAreaConfig#supportedEnumValues
array must be defined unless all states of both BlindSpotWarningState
(including
OTHER
, which is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: BlindSpotWarningState/ErrorState
Unit type: N/A
Release: Android 14
CABIN_LIGHTS_STATE
Returns the state for the cabin lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
CABIN_LIGHTS_SWITCH
Cabin lights switch. The position of the physical switch which controls the cabin lights.
This might differ than the CABIN_LIGHTS_STATE
if the lights are on because a door is
open or because of a voice command. For example, when the switch is in the off or
automatic position.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but
OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
CLUSTER_DISPLAY_STATE
Changes the state of the cluster display.
- Bounds: Area to render the cluster Activity.
- Inset: Area that Activity should not place important information.
Possible values:
int32[0]
On, Off: 0 - off, 1 - on, -1 - don't careint32[1]
Bounds - left: positive number - left position in pixels -1 - don't care (should set all Bounds fields)int32[2]
Bounds - top: same format with 'left'int32[3]
Bounds - right: same format with 'left'int32[4]
Bounds - bottom: same format with 'left'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 - top: same format with 'left'int32[7]
Inset - right: same format with 'left'int32[8]
Inset - bottom: same format with 'left'
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
CLUSTER_NAVIGATION_STATE
Informs the current navigation state. bytes: the serialized message of NavigationStateProto.
Change mode: ON_CHANGE
Access mode: WRITE
Enum type:
Unit type: N/A
Release: Android 13
CLUSTER_REPORT_STATE
Reports the current display state and ClusterUI state.
ClusterHome
sends this message when it handles CLUSTER_SWITCH_UI
,
CLUSTER_DISPLAY_STATE
In addition, ClusterHome
should send this
message when it starts for the first time. When ClusterOS receives this message and if the
internal expectation is different with the received message, then it should send
CLUSTER_SWITCH_UI
, CLUSTER_DISPLAY_STATE
again to match the state.
int32[0]
on/off: 0 - off, 1 - onint32[1]
Bounds - leftint32[2]
Bounds - topint32[3]
Bounds - rightint32[4]
Bounds - bottomint32[5]
Inset - leftint32[6]
Inset - topint32[7]
Inset - rightint32[8]
Inset - bottomint32[9]
Type of ClusterUI in the fullscreen or main screen. 0 indicatesClusterHome
. Other values are followed by the OEM's definition.int32[10]
Type of ClusterUI in subscreen if the currently two UIs are shown. -1 indicates the area is no longer used. bytes: the array to represent the availability of ClusterUI. 0 indicates non-available and 1 indicates available. For example, if a car supports three OEM-defined ClusterUI such as HOME, MAPS, and CALL and only supports the CALL UI only when the cellular network is available. Then, if the nework is available, it sends [1 1 1] and, if out of network, sends [1 1 0].
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
CLUSTER_REQUEST_DISPLAY
Requests to change the cluster display state to show some ClusterUI. When the current display
state is off and ClusterHome
sends this message to ClusterOS to request to turn
the display on to show a specific ClusterUI. ClusterOS should response this with
CLUSTER_DISPLAY_STATE
int32
Type of ClusterUI to show
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
CLUSTER_SWITCH_UI
Starts the ClusterUI in cluster display.
int32
Type of ClusterUI to show 0 indicatesClusterHome
, the Home screen of the cluster display, and provides the default UI and a kind of launcher functionality for the cluster display. Other values are per the OEM's definition.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
CREATE_USER
Called by the Android System after an Android user was created. The HAL can use this property to create its equivalent user. This is an async request: Android makes the request by setting a VehiclePropValue, and HAL must respond with a property change indicating whether the request succeeded or failed. If it failed, the Android system removes the user.
The format of the request is defined by CreateUserRequest and the format of the response by CreateUserResponse. For example, if system had two users (0 and 10) and a third one (which is an ephemeral guest) was created, the request would be:
int32[0]
42 // request idint32[1]
11 // Android id of the created userint32[2]
6 // Android flags (ephemeral guest) of the created userint32[3]
10 // current userint32[4]
0 // current user flags (none)int32[5]
3 // number of usersint32[6]
0 // first user (user 0)int32[7]
0 // first user flags (none)int32[8]
10 // second user (user 10)int32[9]
0 // second user flags (none)int32[10]
11 // third user (user 11)int32[11]
6 // third user flags (ephemeral guest) string: "ElGuesto" // name of the new user
If the request succeeded, the HAL returns:
int32[0]
42 // request idint32[1]
1 // CreateUserStatus::SUCCESS
But if it fails:
int32[0]
42 // request idint32[1]
2 // CreateUserStatus::FAILURE string: "D'OH!" //
The meaning is a blackbox and is passed to the caller (such as the Settings UI), which takes the proper action.
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
CRITICALLY_LOW_TIRE_PRESSURE
This property indicates the critically low pressure threshold for each tire. It indicates when it to replace or to fix a tire. The value must be less than or equal to minFloatValue in TIRE_PRESSURE. The minimum and maximum property values (minFloatValue and maxFloatValue) do not apply to this property.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOPASCAL
Release: Android 13
CRUISE_CONTROL_COMMAND
WRITE
Cruise Control (CC) commands.
See CruiseControlCommand for the details about each supported command. For the global area ID (0),
the StatusCode#VehicleAreaConfig#supportedEnumValues
array must be defined unless all
states of CruiseControlState
are supported. Any unsupported commands sent through
this property must return StatusCode#INVALID_ARG
When this property is not available
because CC is disabled (for example, CRUISE_CONTROL_ENABLED
is false), this property
must return StatusCode#NOT_AVAILABLE_DISABLED
If CRUISE_CONTROL_STATE
is implemented and the state is set to an ErrorState
value, then this
property must return a StatusCode
that aligns with the ErrorState
value.
For example, if CRUISE_CONTROL_STATE
is set to
ErrorState#NOT_AVAILABLE_SPEED_LOW
, then this property must return
StatusCode#NOT_AVAILABLE_SPEED_LOW
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: CruiseControlCommand
Unit type: N/A
Release: Android 14
CRUISE_CONTROL_ENABLED
Enable or disable cruise control (CC). Set true to enable CC and false to disable CC. This
property is shared by all forms of CruiseControlType(s). When CC is enabled, the ADAS system in
the vehicle should be turned on and responding to commands. In general,
CRUISE_CONTROL_ENABLED
should always return true or false. If the feature is not available due to some temporary state,
such as the vehicle speed being too low, that information must be conveyed through the
ErrorState
values in the CRUISE_CONTROL_STATE
property. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
CRUISE_CONTROL_STATE
Current state of Cruise Control (CC). This property returns the current state of CC. Generally,
this property should return a valid state defined in the CruiseControlState or
ErrorState
For example, if the feature is not available due to some temporary state, that information
should be conveyed through ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValue
array must be defined unless all states of
CruiseControlState (including OTHER, which is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: CruiseControlState/ErrorState
Unit type: N/A
Release: Android 14
CRUISE_CONTROL_TARGET_SPEED
Current target speed for Cruise Control (CC). OEMs should set the minFloatValue and
maxFloatValue values for this property to define the min and max target speed values. These
values must be non-negative. The maxFloatValue represents the upper bound of the target speed.
The minFloatValue represents the lower bound of the target speed.
When this property is not available because CC is disabled (for example,
CRUISE_CONTROL_ENABLED
is false), this property must return StatusCode#NOT_AVAILABLE_DISABLED
If
CRUISE_CONTROL_STATE
is
implemented and the state is set to an ErrorState value, then this property must return a
StatusCode
that aligns with the ErrorState value. For example, if
CRUISE_CONTROL_STATE
is set
to ErrorState#NOT_AVAILABLE_SPEED_LOW
, then this property must return
StatusCode#NOT_AVAILABLE_SPEED_LOW
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 14
CRUISE_CONTROL_TYPE
Current type of Cruise Control (CC). When CRUISE_CONTROL_ENABLED
is true,
this property returns
the type of CC that is currently enabled (for example, standard CC and adaptive CC, predictive).
enerally, this property should return a valid state defined in the CruiseControlType
or
ErrorState
For example, if the feature is not available due to some temporary state,
that
information should be conveyed through ErrorState
For the global area ID (0), the StatusCode#VehicleAreaConfig#supportedEnumValues
array must be defined
unless all states of CruiseControlType
(including OTHER
, which is not
recommended) and
ErrorState
are supported. Trying to WRITE
CruiseControlType#OTHER
or an ErrorState
to this
property throws an IllegalArgumentException
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: CruiseControlType
ErrorState
Unit type: N/A
Release: Android 14
CURRENT_GEAR
Current gear. In a non-manual case, the selected gear might not match the current gear. For
example, if the selected gear is GEAR_DRIVE
, the current gear will be one of
GEAR_1
, GEAR_2
and so on, which reflects the actual gear the
transmission is running in. Values in the config data must represent the list of supported gears
for this vehicle. For example, config data for an automatic transmission must contain
{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_1, GEAR_2,...}
and, for manual
transmission, the list must be {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
This list need not be the same as that of the supported gears reported in
GEAR_SELECTION
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleGear
Unit type: N/A
Release: Android 13
CURRENT_POWER_POLICY
Notifies the current power policy to VHAL layer. Car power policy service sets this property when the current power policy is changed
string: "sample_policy_id" // power policy ID
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
DISABLED_OPTIONAL_FEATURES
Allow the disabling of optional features in VHAL. This property reports optional features that
should be disabled. All allowed optional features for the system is declared in the Car service
overlay, config_allowed_optional_car_features
This property allows disabling features defined in the overlay. Without this property, all
features declared in the overlay will be enabled.
Value READ
should include all features disabled with a comma (,
)
separation.
For example, com.android.car.user.CarUserNoticeService,storage_monitoring
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
DISPLAY_BRIGHTNESS
Property to represent brightness of the display. Some cars have a single control for the
brightness of all displays. This property is to share changes in that control. In cars that have
displays whose brightness is controlled separately, they must use
PER_DISPLAY_BRIGHTNESS
Only one of DISPLAY_BRIGHTNESS
and PER_DISPLAY_BRIGHTNESS
should be
implemented. If both are
available, PER_DISPLAY_BRIGHTNESS
is used by AAOS. If this is writable, Android can
set this
value when the user changes display brightness from Settings. If this is READ
-only,
user can still
change display brightness from Settings, but the change must not be reflected on other displays.
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
DISTANCE_DISPLAY_UNITS
Distance units for display. Indicates which units the car is using to display distances to the
user. For example, Mile, Meter, or Kilometer. Distance units are defined in VehicleUnit.
VehiclePropConfig.configArray is used to indicate the supported distance display units.
For example, configArray[0] = METER configArray[1] = KILOMETER configArray[2] = MILE
If updating DISTANCE_DISPLAY_UNITS
affects the values of other
*_DISPLAY_UNITS
properties, then their values must be updated and communicated to the AAOS framework, too.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
DOOR_CHILD_LOCK_ENABLED
Door child lock feature enabled. Returns true if the door child lock feature is enabled and
false if disabled. If enabled, the door can't be opened from the inside. This property is defined
as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
DOOR_LOCK
Door lock true indicates the door is locked. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
DOOR_MOVE
The maxInt32Value
and minInt32Value
in each VehicleAreaConfig must be
defined. All integers between minInt32Value
and maxInt32Value
must be
supported. The maxInt32Value
represents the maximum movement speed of the door while
opening. The minInt32Value
represents the maximum movement speed of the door while
closing.
Larger absolute values, either positive or negative, indicate a faster movement speed. Once the
door reaches the positional limit, the value must reset to 0. If the value of
DOOR_MOVE
is 0,
then that means there is no movement currently occurring.
This property is not in any particular unit but in a specified range of relative movement speeds.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
DOOR_POS
Door position. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The minInt32Value
indicates the door is closed. The minInt32Value
must be 0.
The maxInt32Value
indicates the door is fully open. Values between
minInt32Value
and
maxInt32Value
indicate a transition state between the closed and fully
open positions.
This property is not in any particular unit but in a specified range of relative positions.
Some vehicles (minivans) can open the door electronically. Hence, the ability to
WRITE
this property. This property is defined as VehiclePropertyAccess
READ_WRITE
, but OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE
/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
E से G
ELECTRONIC_TOLL_COLLECTION_CARD_STATUS
Electronic Toll Collection card status. This property indicates the status of ETC card in this
vehicle. If the head unit is aware of an ETC card attached to the vehicle,
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
gives that status of the card. Otherwise, this
property should be UNAVAILABLE
Change mode: ON_CHANGE
Access mode: READ
Enum type: ElectronicTollCollectionCardStatus
Unit type: N/A
Release: Android 13
ELECTRONIC_TOLL_COLLECTION_CARD_TYPE
Electronic Toll Collection (ETC) card type. This property indicates the type of ETC card in this
vehicle. If the head unit is aware of an ETC card attached to the vehicle, this property should
return the type of card attached; otherwise, this property should be UNAVAILABLE
Change mode: ON_CHANGE
Access mode: READ
Enum type: ElectronicTollCollectionCardType
Unit type: N/A
Release: Android 13
EMERGENCY_LANE_KEEP_ASSIST_ENABLED
Enable or disable Emergency Lane Keep Assist (ELKA). Set true to enable ELKA and false to
disable ELKA. When ELKA is enabled, the ADAS system in the vehicle should be on and monitoring
for unsafe lane changes by the driver. When an unsafe maneuver is detected, ELKA alerts the
driver and applies steering corrections to keep the vehicle in its original lane.
In general, EMERGENCY_LANE_KEEP_ASSIST_ENABLED
should always return true or false.
If the feature is not available due to some temporary state, such as the vehicle speed being too
low, that information must be conveyed through the ErrorState
values in the
EMERGENCY_LANE_KEEP_ASSIST_STATE
property. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
EMERGENCY_LANE_KEEP_ASSIST_STATE
Emergency Lane Keep Assist (ELKA) state. Returns the current state of ELKA. Generally, this
property should return a valid state defined in the EmergencyLaneKeepAssistState
or
ErrorState
For example, if the feature is not available due to some temporary state, that information
should be conveyed through ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValues
array must be defined unless all states of
EmergencyLaneKeepAssistState
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: EmergencyLaneKeepAssistState/ErrorState
Unit type: N/A
Release: Android 14
ENGINE_COOLANT_TEMP
Temperature of engine coolant.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
ENGINE_IDLE_AUTO_STOP_ENABLED
Represents feature for engine idle automatic stop. If true, the vehicle may automatically shut
off the engine when it is not needed and then automatically restart it when needed.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
ENGINE_OIL_LEVEL
Engine oil level.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleOilLevel
Unit type: N/A
Release: Android 13
ENGINE_OIL_TEMP
Temperature of engine oil.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
ENGINE_RPM
Engine revolutions per minute (RPM).
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:RPM
Release: Android 13
ENV_OUTSIDE_TEMPERATURE
Outside temperature. This property must communicate the temperature reading of the environment outside the vehicle. If there are multiple sensors for measuring the outside temperature, this property should be populated with the mean or a meaningful weighted average of the readings that best represent the temperature of the outside environment.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
EV_BATTERY_DISPLAY_UNITS
EV battery units for display. Indicates which units the car is using to display EV battery
information to the user. For example, watt-hours (Wh), kilowatt-hours (kWh) or ampere-hours (Ah).
VehiclePropConfig.configArray
is used to indicate the supported electrical energy.
units. Electrical energy units are defined in VehicleUnit
For example:
configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR
If updating EV_BATTERY_DISPLAY_UNITS
affects the values of other
*_DISPLAY_UNITS
properties,
then their values must be updated and communicated to the AAOS framework as well.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
EV_BATTERY_INSTANTANEOUS_CHARGE_RATE
EV instantaneous charge rate in milliwatts. A positive value indicates the battery is being charged. A negative value indicates the battery being discharged.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MW
Release: Android 13
EV_BATTERY_LEVEL
Returns the current battery level, whether EV or hybrid. This value will not exceed
EV_CURRENT_BATTERY_CAPACITY
To calculate the battery percentage, use
(EV_BATTERY_LEVEL
, EV_CURRENT_BATTERY_CAPACITY
)*100.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13
EV_BRAKE_REGENERATION_LEVEL
Regenerative braking level of a electronic vehicle. The maxInt32Value
and
minInt32Value
in VehicleAreaConfig must be defined. All values between
minInt32Value
and maxInt32Value
must be
supported. The minInt32Value
must be 0. The maxInt32Value
indicates
the setting for the maximum amount of energy regenerated from braking. The
minInt32Value
indicates the setting for no
regenerative braking. This property is a more granular form of
EV_REGENERATIVE_BRAKING_STATE
It allows the user to set a more specific level of regenerative braking if the states in
EvRegenerativeBrakingState
are not granular enough for the OEM. This property is
defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_CURRENT_DRAW_LIMIT
Indicates the maximum current draw threshold for charging set by the user.
EvChargeState::configArray[0]
is
used to specify the max current draw allowed by the vehicle in Amperes. This property is defined
as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITEREAD
Enum type: N/A
Unit type: VehicleUnit:AMPERE
Release: Android 13
EV_CHARGE_PERCENT_LIMIT
Indicates the maximum charge percent threshold set by the user. Indicates the maximum charge
percent threshold set by the user. Returns a float value from 0 to 100.
configArray is used to specify the valid values. For example, if the vehicle supports the
following charge percent limit values: [20, 40, 60, 80, 100] then the configArray should be
{20, 40, 60, 80, 100} If the configArray is empty then all values from 0 to 100 must be valid.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE,
, READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_PORT_CONNECTED
EV charge port connected. If the vehicle has multiple charging ports, this property must return
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_PORT_OPEN
EV charge port open. If the vehicle has multiple charging ports, this property must return
true if any of the charge ports are open. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITEREAD
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_STATE
Charging state of the car
Returns the current charging state of the car.
If the vehicle has a target charge percentage other than 100, this property must return
EvChargeState::STATE_FULLY_CHARGED
when the battery charge level has reached the
target level. See EvChargeState::EV_CHARGE_PERCENT_LIMIT
for more context.
Change mode: ON_CHANGE
Access mode: READ
Enum type: EvChargeState
Unit type: N/A
Release: Android 13
EV_CHARGE_SWITCH
Start or stop charging the EV battery. The setting wanted by the user. Setting this property
to true starts the battery charging, and false to stop charging. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITEREAD
Enum type: N/A
Unit type: N/A
Release: Android 13
EV_CHARGE_TIME_REMAINING
Estimated charge time remaining in seconds. Returns 0 if the vehicle is not charging.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:SECS
Release: Android 13
EV_CURRENT_BATTERY_CAPACITY
Current usable battery capacity for and EV or hybrid vehicle. Returns the actual value of
battery capacity, when EV or hybrid. This property captures the real-time usable battery capacity
taking into account factors such as battery aging and temperature dependency. This value might
differ from INFO_EV_BATTERY_CAPACITY
because INFO_EV_BATTERY_CAPACITY
returns the nominal battery capacity from when the vehicle was new.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 14
EV_REGENERATIVE_BRAKING_STATE
Regenerative braking or one-pedal drive setting of the car. Returns the current setting
associated with the regenerative braking setting in the car. If the OEM requires more setting
than those provided in EvRegenerativeBrakingState
, the
EV_BRAKE_REGENERATION_LEVEL
property can be used instead, which provides more
granular information.
Change mode: ON_CHANGE
Access mode: READ
Enum type: EvRegenerativeBrakingState
Unit type: N/A
Release: Android 13
EV_STOPPING_MODE
Represents property for the current stopping mode of the vehicle. For the global area ID (0),
the VehicleAreaConfig#supportedEnumValues
must be defined unless all enum values of
EvStoppingMode
are supported. The EvStoppingMode
enum may be extended to
include more states in the future. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs have the option to implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: EvStoppingMode
Unit type: N/A
Release: Android 14
EVS_SERVICE_REQUEST
Enable and request an EVS service. The property provides a way to trigger EVS services. The VHAL should use this property to request Android to start or stop EVS service.
int32Values[0]
Type of EVS service. The value must be and enum in EvsServiceType.int32Values[1]
State of the EVS service. The value must be one of enums in EvsServiceState.
For example, to enable rear view EVS service, Android can set the property value as:
[EvsServiceType::REAR_VIEW, EvsServiceState::ON]
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
EXTERNAL_CAR_TIME
Current date and time suggestion for the cr, encoded as Epoch time (in milliseconds). This value denotes the number of milliseconds seconds that have elapsed since 1/1/1970 UTC. This property signals a change in CarTime to Android. If the property is supported, VHAL must report the most accurate current CarTime when this property is read, and publish a change to this property when the CarTime value has changed.
An on-change event for this property must be published when CarTime changes for any reason other than the natural elapse of time (time delta smaller than 500ms should not trigger an on change event). Android will read and subscribe to this property to fetch time from VHAL. This can be useful to synchronize Android's time with other vehicle systems (dash clock). int64Values[0] = provided Epoch time (in milliseconds) Whenever a new Value for the property is received, AAOS creates and sends an ExternalTimeSuggestion to the TimeDetectorService.
If other sources do not have a higher priority, Android will use this to set the system time. For information on how to adjust time source priorities and how time suggestions are handled (including how Android handles gitter, drift, and minimum resolution), see the Time Detector Service documentation.
drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift
We strongly recommend that this propertynot be used to retrieve time from ECUs using protocols (such as GNSS, NTP, and Telephony). Since these protocols are already supported by Android, we recommend you use Android systems instead of wiring through the VHAL with this property.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLI_SECS
Release: Android 13
FOG_LIGHTS_STATE
Fog light state. Return the current state of fog lights. If the:
- Car has front and rear fog lights. Front and rear fog lights can only be controlled
together.
FOG_LIGHTS_STATE
must be implemented.FRONT_FOG_LIGHTS_STATE
andREAR_FOG_LIGHTS_STATE
must not be implemented. - Front and rear fog lights can only be controlled independently.
FOG_LIGHTS_STATE
must not be implemented andFRONT_FOG_LIGHTS_STATE
andREAR_FOG_LIGHTS_STATE
must be implemented. - Car has only front fog lights. Only one of
FOG_LIGHTS_STATE
orFRONT_FOG_LIGHTS_STATE
must be implemented (not both).REAR_FOG_LIGHTS_STATE
must not be implemented. - Car has only rear fog lights. Only one of
FOG_LIGHTS_STATE
orREAR_FOG_LIGHTS_STATE
must be implemented (not both).FRONT_FOG_LIGHTS_STATE
must not be implemented.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
FOG_LIGHTS_SWITCH
Fog light switch. The setting wanted by the user. If the:
- Car has both front and rear fog lights. If front and rear fog lights can only be controlled
together,
FOG_LIGHTS_SWITCH
must be implemented.FRONT_FOG_LIGHTS_SWITCH
andREAR_FOG_LIGHTS_SWITCH
must not be implemented. - Front and rear fog lights can only be controlled independently.
FOG_LIGHTS_SWITCH
must not be implemented.FRONT_FOG_LIGHTS_SWITCH
andREAR_FOG_LIGHTS_SWITCH
must be implemented. - Car has only front fog lights. Only one of
FOG_LIGHTS_SWITCH
orFRONT_FOG_LIGHTS_SWITCH
must be implemented (not both).REAR_FOG_LIGHTS_SWITCH
must not be implemented. - Car has only rear fog lights. Only one of
FOG_LIGHTS_SWITCH
orREAR_FOG_LIGHTS_SWITCH
must be implemented (and not both).FRONT_FOG_LIGHTS_SWITCH
must not be implemented.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
FORWARD_COLLISION_WARNING_ENABLED
Enable or disable Forward Collision Warning (FCW). Set to true to enable FCW and false to
disable FCW. When FCW is enabled, the ADAS system in the vehicle should be turned on and
monitoring for potential collisions. In general, FORWARD_COLLISION_WARNING_ENABLED
should always return true or false. If the feature is not available due to some temporary state,
such as the vehicle speed being too low, that information must be conveyed through the
ErrorState
values in the FORWARD_COLLISION_WARNING_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
FORWARD_COLLISION_WARNING_STATE
Forward Collision Warning (FCW) state. Returns the current state of FCW. This property must
always return a valid state defined in ForwardCollisionWarningState
or
ErrorState
It must not
surface errors through StatusCode and must use the supported error states instead.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be
defined unless all states of both ForwardCollisionWarningState
(including OTHER,
which is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enun type: ForwardCollisionWarningState/ErrorState
Unit type: N/A
Release: Android 14
FRONT_FOG_LIGHTS_STATE
Front fog lights state. Returns the current state of the front fog lights. Only one of
FOG_LIGHTS_STATE
or FRONT_FOG_LIGHTS_STATE
must be implemented.
Refer to the documentation on FOG_LIGHTS_STATE
for more information.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
FRONT_FOG_LIGHTS_SWITCH
Front fog lights switch. The setting wanted by the user. Only one of
FOG_LIGHTS_SWITCH
or FRONT_FOG_LIGHTS_SWITCH
must be implemented. Refer
to the documentation on FOG_LIGHTS_SWITCH
for more information.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME
Fuel consumption units for display.
Indicates type of units the car is using to display fuel consumption information to user
True indicates units are distance over volume such as MPG. False indicates units are volume
over distance such as L/100KM. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
FUEL_DOOR_OPEN
Fuel door open. This property must communicate if the fuel door on the vehicle is open or not.
This property does not apply to EVs. That is, if INFO_FUEL_TYPE
only
contains FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For
EVs, implement EV_CHARGE_PORT_OPEN
. This property is defined as
VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
FUEL_LEVEL
Fuel remaining in the vehicle, in milliliters. This property must communicate the current
amount of fuel remaining in the vehicle in milliliters. This property does not apply to electric
vehicles. That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For EVs, implement
EV_BATTERY_LEVEL
Value can not exceed INFO_FUEL_CAPACITY
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13
FUEL_LEVEL_LOW
Warning for fuel low level. This property corresponds to the low fuel warning on the dashboard.
Once FUEL_LEVEL_LOW
is set, it should not be cleared until more fuel is added to the
vehicle. This property can account for all fuel sources in a vehicle. For example, in a:
- Gas-powered vehicle, this property is based solely on gas level.
- Battery powered vehicle, this property is based only on battery level.
- Hybrid vehicle, this property may can based on a combination of gas and battery levels, at the OEM's discretion.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
FUEL_VOLUME_DISPLAY_UNITS
Fuel volume units for display. Indicates which units the car is using to display fuel volume
to the user. For example, Liter or Gallon. VehiclePropConfig.configArray
is used to
indicate the supported fuel volume display units. Volume units are defined in
VehicleUnit
For example, configArray[0] = LITER configArray[1] = GALLON
If updating FUEL_VOLUME_DISPLAY_UNITS
affects the values of other
*_DISPLAY_UNITS
properties,
then their values must be updated and communicated to the AAOS framework, too.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
GEAR_SELECTION
The gear selected by the user. Values in the config data must represent the list of supported
gears for this vehicle. For example, config data for an automatic transmission must contain
{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK,
and for
manual transmission the list must be GEAR_DRIVE
, GEAR_1, GEAR_2,...}{GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}
For an automatic transmission vehicle that allows the driver to select specific gears on demand
(for example, manual mode), the value for GEAR_SELECTION
must be set to the specific
gear selected by the driver instead of GEAR_DRIVE
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleGear
Unit type: N/A
Release: Android 13
GENERAL_SAFETY_REGULATION_COMPLIANCE_REQUIREMENT
EU's General security regulation compliance requirement. Returns a value to indicate if general security regulation compliance is required and, if so, the type of requirement.
Change mode: STATIC
Access mode: READ
Enum type: GsrComplianceRequirementType
Unit type: N/A
Release: Android 14
GLOVE_BOX_DOOR_POS
Property that represents the current position of the glove box door. The
maxInt32Value
and minInt32Value
in VehicleAreaConfig must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The minInt32Value
indicates that the glove box door is closed.
The minInt32Value
must be 0. The maxInt32Value
indicates that the
glove box door is in the fully open position. Values in between minInt32Value
and
maxInt32Value
indicate a transition state between the closed and fully open
positions.
This property is not in any particular unit but in a specified range of relative positions.
The area ID must match the seat by which the glove box is intended to be used. For example if the
front right dashboard has a glove box embedded in it, then the area ID should be
SEAT_1_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
GLOVE_BOX_LOCKED
Lock or unlock the glove box. If true, the glove box is locked. If false, the glove box is
unlocked. The area ID must match the seat by which the glove box is intended to be used. For
example, if the front right dashboard has an embedded glove box embedded, then the area ID should
be VehicleAreaSeat#ROW_1_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
H से I
HANDS_ON_DETECTION_DRIVER_STATE
Hands On Detection (HOD) driver state. Returns whether the driver's hands are on the steering
wheel. Generally, this property should return a valid state defined in the
HandsOnDetectionDriverState
or ErrorState
For example, if the feature
is not available due to
some temporary state, that information should be conveyed through ErrorState
If the vehicle wants to send a warning to the user because the driver's hands have been off the
steering wheel for too long, the warning should be surfaced through
HANDS_ON_DETECTION_WARNING
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must
be defined
unless all states of both HandsOnDetectionDriverState
(including OTHER, which is
not recommended)
and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionDriverState/ErrorState
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_ENABLED
Enable or disable Hands On Detection (HOD). Set true to enable HOD and false to disable HOD.
When HOD is enabled, a system inside the vehicle should be monitoring the presence of the driver's
hands on the steering wheel and send a warning if it detects that the driver's hands are no longer
on the steering wheel. In general, HANDS_ON_DETECTION_ENABLED
should always return
true or false.
If the feature is not available due to some temporary state, that information must be conveyed
through the ErrorState
values in the HANDS_ON_DETECTION_STATE
property.
This property is defined as minInt32Value
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it is
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HANDS_ON_DETECTION_WARNING
Hands On Detection (HOD) warning. Returns whether a warning is being sent to the driver for
having their hands off the wheel for too long a duration. Generally, this property should return
a valid state defined in HandsOnDetectionWarning
or ErrorState
For
example, if the feature is not available due to some temporary state, that information should
be conveyed through an ErrorState
For the global area ID (0), the
VehicleAreaConfig#supportedEnumValues
array must be defined unless all states
of both HandsOnDetectionWarning
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: HandsOnDetectionWarning/ErrorState
Unit type: N/A
Release: Android 14
HAZARD_LIGHTS_STATE
Hazard light status. Return the current status of hazard lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HAZARD_LIGHTS_SWITCH
Hazard light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HEADLIGHTS_STATE
Headlights state. Returns the current state of headlights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HEADLIGHTS_SWITCH
Headlight switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_STATE
High beam lights state. Returns the current state of high beam lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
HIGH_BEAM_LIGHTS_SWITCH
High beam light switch. The setting that the user wants. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
HVAC_AC_ON
Turn AC on and off AC for the designated areaId. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ACTUAL_FAN_SPEED_RPM
Actual fan speed.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_ON
Turn automatic climate control on and off.
If true, automatic climate control is on. If false, automatic climate control is off.
If the vehicle does not support directly turning off automatic climate control, then OEMs should
add logic in their VHAL implementation to set HVAC_AUTO_ON
to false, which changes
the necessary HVAC settings to indirectly turn off HVAC_AUTO_ON
Ideally, this
should not disrupt the user. OEMs should revert to the previous state any settings that were
modified when automatic climate control is off. This way, the only outcome should be that
HVAC_AUTO_ON
is off. If restoring HVAC settings to previous settings is not possible,
then the OEM should implement the least disruptive change.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_AUTO_RECIRC_ON
Automatic recirculation on or off. When automatic recirculation is on, the HVAC system may
automatically switch to recirculation mode if the vehicle detects poor incoming air quality.
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DEFROSTER
Fan-based defrost for designated window. This property is defined as
VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_DUAL_ON
Enable temperature coupling between areas. The AreaIDs
for the
HVAC_DUAL_ON
property
shall contain a combination of HVAC_TEMPERATURE_SET
AreaIDs
that can be
coupled
together. If HVAC_TEMPERATURE_SET
is mapped to AreaIDs
[a_1, a_2, ..., a_n]
and if HVAC_DUAL_ON
can be enabled to couple a_i and a_j, then
HVAC_DUAL_ON
property must be mapped to [a_i | a_j]. Further, if
a_k and a_l can also be coupled together separately, then
HVAC_DUAL_ON
must be mapped to [a_i | a_j, a_k | a_l].
For example, a car has two front seats (ROW_1_LEFT
and ROW_1_RIGHT
) and
three back seats (ROW_2_LEFT, ROW_2_CENTER, and ROW_2_RIGHT).
There are two temperature control units, driver side and passenger side, which can be optionally
synchronized. This can be expressed this way in the AreaIDs
:
HVAC_TEMPERATURE_SET > [ROW_1_LEFT | ROW_2_LEFT, ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT] HVAC_DUAL_ON > [ROW_1_LEFT | ROW_2_LEFT | ROW_1_RIGHT | ROW_2_CENTER | ROW_2_RIGHT]
When the property is enabled, the ECU must synchronize the temperature for the affected areas.
Any parameters modified as a side effect of turning on or off the DUAL_ON parameter shall generate
onPropertyEvent()
callbacks to the VHAL. In addition, if setting a temperature
(for example, driver temperature) changes another temperature (such as front passenger
temperature), then the appropriate onPropertyEvent()
callbacks must be generated.
If a user changes a temperature that breaks the coupling (for example, sets passenger temperature
independently), then the VHAL must send the appropriate onPropertyEvent()
callbacks
(including HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx
).
This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_ELECTRIC_DEFROSTER_ON
Electric defrosters' status.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION
Fan direction setting. This property is defined as VehiclePropertyAccess.READ_WRITE
,
but OEMs can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_DIRECTION_AVAILABLE
Fan positions available. This is a bit mask of fan positions available for the zone. Each
available fan direction is denoted by a separate entry in the vector. A fan direction can have
multiple bits from vehicle_hvac_fan_direction
set. For instance, a typical car may have these
fan positions:
- FAN_DIRECTION_FACE (0x1) - FAN_DIRECTION_FLOOR (0x2) - FAN_DIRECTION_FACE | FAN_DIRECTION_FLOOR (0x3) - FAN_DIRECTION_DEFROST (0x4) - FAN_DIRECTION_FLOOR | FAN_DIRECTION_DEFROST (0x6)
Change mode: STATIC
Access mode: READ
Enum type: VehicleHvacFanDirection
Unit type: N/A
Release: Android 13
HVAC_FAN_SPEED
Fan speed setting. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig must be defined. All integers between minInt32Value
and
maxInt32Value
must be supported.
minInt32Value
lowest fan speedmaxInt32Value
highest fan speed
This property is not in any specific unit but in a specified range of relative speeds. This
property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can elect to
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_AC_ON
MAX AC on or off. When MAX AC is on, the ECU can adjust items such as vent position, fan speed,
and temperature as needed to cool the vehicle as quickly as possible. Any parameters modified as
a side effect of turning on or off the MAX AC parameter generates onPropertyEvent()
callbacks to the VHAL. This property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_MAX_DEFROST_ON
Turn MAX DEFROST on and off. When MAX DEFROST is on, the ECU can adjust items such as vent
position, fan speed, and temperature as needed to defrost the windows as quickly as possible.
Any parameters modified as a side effect of turning on or off MAX DEFROST parameter generates
onPropertyEvent()
callbacks to the VHAL. The AreaIDs
for
HVAC_MAX_DEFROST_ON
indicate MAX DEFROST can be controlled in the area. For example,
areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT}
indicates that
HVAC_MAX_DEFROST_ON
can only be controlled for the front rows. This property is
defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it
as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_POWER_ON
Represents the global power state for HVAC. Setting this property to false MAY mark some properties that control individual HVAC features and subsystems in the UNAVAILABLE state. Setting this property to true MAY mark some properties that control individual HVAC features and subsystems to the AVAILABLE state (unless any or all of the properties are UNAVAILABLE on their own individual merits).
HvacPower_DependentProperties
are those properties that require HVAC to be powered
on to enable functionality. In some cars, for example, to turn on the AC, HVAC must first be
powered on. The HvacPower_DependentProperties
list must be set in the
VehiclePropConfig.configArray
HvacPower_DependentProperties
must only
contain those properties associated with VehicleArea:SEAT
AreaID mapping for HVAC_POWER_ON
property must contain all AreaIDs
that
HvacPower_DependentProperties
are mapped to. For example, a car has two:
- Front seats (
ROW_1_LEFT
,ROW_1_RIGHT
) and three back seats (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). If the HVAC features (AC, Temperature etc.) throughout the car are dependent on a single HVAC power controller, thenHVAC_POWER_ON
must be mapped to [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
- Seats in the front row (
ROW_1_LEFT
,ROW_1_RIGHT
) and three seat in the second (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT
) and third rows (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT
). If the car has temperature controllers in the front row that can operate entirely independently of temperature controllers in the back of the vehicle, thenHVAC_POWER_ON
must be mapped to a two element array:- ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_RECIRC_ON
Recirculation on and off. Controls the supply of exterior air to the cabin. Recirc
on means most of the airflow into the cabin originates in the cabin. Recirc
off means most of the airflow into the cabin comes from outside the car. This
property is defined as VehiclePropertyAccess.READ_WRITE
but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_TEMPERATURE
Seat heating and cooling. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum seat temperature heating setting.
The minInt32Value
must be 0, unless the vehicle supports seat cooling. In this case,
minInt32Value
indicates the maximum seat temperature cooling setting.
This property is not in any specific unit, but in a specified range of relative temperature
settings. This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs
can implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SEAT_VENTILATION
Seat ventilation. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported. The minInt32Value
must be 0. The
maxInt32Value
indicates the maximum ventilation setting available for the seat.
This property is not in any particular unit but in the specified range of ventilation settings.
Used by HVAC apps and Assistant to enable, change, or read state of seat ventilation. This is different than seating cooling. It can be on at the same time as cooling, or not.
This property is defined as >VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_SIDE_MIRROR_HEAT
Side mirror heat. Increasing values denote higher heating levels for side mirrors.
You must define maxInt32Value
and minInt32Value
in
VehicleAreaConfig
All integers between minInt32Value
and
maxInt32Value
must be supported. In config data:
maxInt32Value
represents maximum heating level.minInt32Value
MUST be 0 and indicates no heating.
This property is not in any particular unit but in a specified range of relative heating settings.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs have the
option to implement it as VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_STEERING_WHEEL_HEAT
Sets the amount of heating and cooling for the steering wheel. The maxInt32Value
and
minInt32Value
in VehicleAreaConfig
must be defined. All integers between
minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
indicates the maximum steering wheel heating setting. The
minInt32Value
should be 0, unless the vehicle supports steering wheel
cooling, too. In this case, the minInt32Value
indicates the maximum steering wheel
cooling setting. This property is not in any particular unit but in a specified range of heating
settings. This property is defined as VehiclePropertyAccess.READ
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_CURRENT
HVAC current temperature.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_DISPLAY_UNITS
Temperature units for display. Indicates if temperature is displayed in Celsius or Fahrenheit.
VehiclePropConfig.configArray
indicates the supported temperature display units. For
example,
configArray[0] = CELSIUS configArray[1] = FAHRENHEIT
This parameter MAY be used to
display any HVAC temperature in the system. Values must be one of
VehicleUnit.CELSIUS
or VehicleUnit.FAHRENHEIT
If updating HVAC_TEMPERATURE_DISPLAY_UNITS affects the values of other
*_DISPLAY_UNITS
properties, then their values must be updated and communicated to
the AAOS framework.
This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement
it is VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13
HVAC_TEMPERATURE_SET
HVAC target temperature set in Celsius.
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be defined:
minFloatValue
minimum temperature setting in Celsius.maxFloatValue
maximum temperature setting in Celsius.
If all the values between minFloatValue
and maxFloatValue
are not
supported, use the configArray
to list the valid temperature values that can be set.
This also describes a lookup table to convert the temperature from Celsius to Fahrenheit (and
vice versa) for the vehicle. The configArray
must be defined if standard unit
conversion is not supported on the vehicle.
The configArray
is set as follows:
configArray[0]
[lower bound of supported temperature in Celsius] * 10configArray[1]
[upper bound of supported temperature in Celsius] * 10configArray[2]
[increment in Celsius] * 10configArray[3]
[lower bound of the supported temperature in Fahrenheit] * 10configArray[4]
[upper bound of the supported temperature in Fahrenheit] * 10configArray[5]
[increment in Fahrenheit] * 10
The minFloatValue
and maxFloatValue
in VehicleAreaConfig
must be equal to configArray[0]
and
configArray[1]
respectively. For example, if the vehicle supports temperature values
as [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5]
in
Fahrenheit, the configArray
should be
configArray = {160, 280, 5, 605, 845, 10}
Ideally, the ratio of the Celsius increment to the Fahrenheit increment should be as close to
the actual ratio of 1 degree Celsius to 1.8 degrees Fahrenheit. There must be a one-to-one mapping
of all Celsius values to Fahrenheit values defined by the configArray
The
configArray
is used by
clients to convert this property's temperature from Celsius to Fahrenheit. Also, it lets clients
know what Celsius value to set the property to achieve their desired Fahreneheit value for the
system. If the ECU does not have a one-to-one mapping of all Celsius values to Fahrenheit values,
then the configArray
should only define the list of Celsius and Fahrenheit values
that have a one-to-one mapping.
For example, if the ECU supports Celsius values from 16 to 28 and Fahrenheit values from 60 to
85, each with an increment of 1, then one possible configArray
is
code>{160, 280, 10, 600, 840, 20}In this case, 85 is not a supported temperature.
Any value set in between a valid value should be rounded to the closest valid value. We highly
recommended that the OEM also implement the HVAC_TEMPERATURE_VALUE_SUGGESTION
vehicle property because it provides applications with a simple method for determining temperature
values that can be set for a vehicle and for converting values between Celsius and Fahrenheit.
This property is defined as VehiclePropertyAccess.READ
, but OEMs can implement it as
VehiclePropertyAccess.READ
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: VehicleUnit:CELSIUS
Release: Android 13
HVAC_TEMPERATURE_VALUE_SUGGESTION
Suggested values for setting HVAC temperature.
Implement the property to help applications understand the closest supported temperature value in Celsius or Fahrenheit.
floatValues[0]
Requested value that an app wants to set a temperature to.floatValues[1]
Unit forfloatValues[0]
and should be one of{VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
floatValues[2]
Value OEMs suggested in CELSIUS (this value is not included in the request).floatValues[3]
Value OEMs suggested in FAHRENHEIT (this value is not included in the request).
An application calls set(VehiclePropValue propValue)
with the requested value
and unit for the value. OEMs need to return the suggested values in
floatValues[2]
and floatValues[3]
by onPropertyEvent()
callbacks.
The suggested values must conform to the values that can be derived from the
HVAC_TEMPERATURE_SET
configArray
In other words, the suggested values
and the table of values
from the configArray
should be the same.
We recommended that the OEM add custom logic in their VHAL implementation to avoid making requests to the HVAC ECU. The logic can be as follows. To convert temperature from Celsius to Fahrenheit:
// Given tempC and the configArray float minTempC = configArray[0] / 10.0; float temperatureIncrementCelsius = configArray[2] / 10.0; float minTempF = configArray[3] / 10.0; float temperatureIncrementFahrenheit = configArray[5] / 10.0; // Round to the closest increment int numIncrements = round((tempC - minTempC) / temperatureIncrementCelsius); tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;
For example, when a driver uses the voice assistant to set HVAC temperature to 66.2 in Fahrenheit.
First, an application sets this property with the value
[66.2, (float)VehicleUnit.FAHRENHEIT,0,0]
If an OEM suggests to set 19.0 in Celsius or 66.5 in Fahrenheit at the user's request, then VHAL
must generate a callback with a property value
[66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]
After the voice assistant gets the callback, it informs the user and sets the HVAC temperature to
the suggested value.
Another example, an app receives 21 Celsius as the current temperature value by querying
HVC_TEMPERATURE_SET
but the app needs to know what value is displayed on the car's
UI in Fahrenheit. For this, the app sets the property to
[21, (float)VehicleUnit.CELSIUS, 0, 0]
If the suggested value by the OEM for 21 Celsius is 70 Fahrenheit, then VHAL must generate a
callback with property value [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]
In this
case, the app can know that the value is 70.0 Fahrenheit in the car's UI.
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_CUSTOM_INPUT
Defines a custom OEM partner input event. This input event must be used by OEM partners who want to propagate events not supported by Android. It is composed by an array of int32 values only. The Android properties are:
int32Values[0]
Input code identifying the function representing this event. Valid event types are defined byCustomInputType.CUSTOM_EVENT_F1
up toCustomInputType.CUSTOM_EVENT_F10
They represent the custom event to be defined by OEM partners.int32Values[1]
Target display type defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32Values[2]
Repeat counter, if 0 then event is not repeated. Values 1 or higher indicate how many times this event has been repeated.
Change mode: ON_CHANGE
Access mode: READ
Enum type: CustomInputType
Unit type: N/A
Release: Android 13
HW_KEY_INPUT
Property to feed hardware input events to Android.
int32Values[0]
Action defined by VehicleHwKeyInputActionint32Values[1]
Key code, must use standard android key codeint32Values[2]
Target display defined inVehicleDisplay
Events not tied to specific display must be sent toVehicleDisplay#MAIN
int32Values[3]
(Optional) Number of ticks. The value must be equal o greater than 1. When omitted, Android defaults to 1.
Change mode: .ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
HW_KEY_INPUT_V2
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
int32array[1]
Key code, must use the standard Android key code, such asKEYCODE_HOME
andKEYCODE_BACK
int32array[2]
action defined in VehicleHwKeyInputAction, such as:
VehicleHwKeyInputAction::ACTION_UP
,VehicleHwKeyInputAction::ACTION_UP
int32array[3]
Repeat count of the event. For key down events, this is the repeat count with the first down starting at 0 and counting up from there. For key up events, this is always equal to 0.int64array[0]
Down time in elapsed nanoseconds since the last boot. Denotes the time of the most recent key down event. For the down event, this is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_MOTION_INPUT
Property to feed hardware input events to Android.
int32array[0]
Target display defined byVehicleDisplay
, such as:
VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER
,VehicleDisplay::AUX
int32array[1]
Input type defined in VehicleHwMotionInputSource, such as:
VehicleHwMotionInputSource::SOURCE_KEYBOARD
,VehicleHwMotionInputSource::SOURCE_DPAD
int32array[2]
Action code defined in VehicleHwMotionInputAction, such as:
VehicleHwMotionInputAction::ACTION_UP
,VehicleHwMotionInputAction::ACTION_DOWN
int32array[3]
Button state flag defined in VehicleHwMotionButtonStateFlag, such as:
VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY
,VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
int32array[4]
Pointer events count, N. N must be a positive integer.int32array[5:5+N-1]
Pointer id, length Nint32array[5+N:5+2*N-1]
Tool type, length N. As defined inVehicleHwMotionToolType
, such as:
VehicleHwMotionToolType::TOOL_TYPE_FINGER
,VehicleHwMotionToolType::TOOL_TYPE_STYLUS
floatArray[0:N-1]
x data, length NfloatArray[N:2*N-1]
y data, length NfloatArray[2*N:3*N-1]
pressure data, length NfloatArray[3*N:4*N-1]
size data, length Nint64array[0]
Down time, elapsed nanoseconds since boot. Denotes the time when the user originally pressed down to start a stream of position events. For the down event, it is the event time of the down event.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
HW_ROTARY_INPUT
Property to feed hardware rotary events to Android.
int32Values[0]
RotaryInputType to identify which rotary knob is rotated.int32Values[1]
Number of detents (clicks), positive for clockwise, negative for counterclockwise.int32Values[2]
Target display defined inVehicleDisplay
Events not tied to a specific display must be sent toVehicleDisplay#MAIN
int32values[3 .. 3 + abs(number of detents) - 2]
Nanosecond deltas between pairs of consecutive detents when the number of detents is more than 1 or less than -1.VehiclePropValue.timestamp
When the rotation took place. If the number of detents is more than 1 or less than -1, when the first detent of rotation took place.
Change mode: ON_CHANGE
Access mode: READ
Enum type: RotaryInputType
Unit type: N/A
Release: Android 13
IGNITION_STATE
Represents ignition state.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleIgnitionState
Unit type: N/A
Release: Android 13
INFO_DRIVER_SEAT
Driver's seat location VHAL implementations must ignore the areaId. Use
VehicleArea:GLOBAL
Change mode: STATIC
Access mode: READ
Enum type: VehicleAreaSeat
Unit type: N/A
Release: Android 13
INFO_EV_BATTERY_CAPACITY
Nominal battery capacity for EV or hybrid vehicle. Returns the nominal battery capacity, EV
or hybrid. This is the total usable battery capacity when the vehicle is new. This value may
differ from EV_CURRENT_BATTERY_CAPACITY
because
EV_CURRENT_BATTERY_CAPACITY
returns the real-time usable battery capacity taking
into account factors such as battery aging and temperature dependency.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:WH
Release: Android 13
INFO_EV_CONNECTOR_TYPE
List of connectors this EV may use. If the vehicle has multiple charging ports, this property must return all possible connector types that can be used by at least one charging port on the vehicle.
Change mode: STATIC
Access mode: READ
Enum type: EvConnectorType
Unit type: N/A
Release: Android 13
INFO_EV_PORT_LOCATION
This property must communicate the location of the charging port on the EV using the
PortLocationType enum. If a vehicle has multiple ports, this property must return
the port that allows the fastest charging. To communicate all port locations, use
INFO_MULTI_EV_PORT_LOCATIONS
Access mode: READ
Enum type:
PortLocationType
Unit type: N/A
Release: Android 13
INFO_EXTERIOR_DIMENSIONS
Exterior dimensions of vehicle:
- Height:
int32Values[0]
- Length:
int32Values[1]
- Width:
int32Values[2]
- Width, including mirrors:
int32Values[3]
- Wheel base, including mirrors:
int32Values[4]
- Track width front:
int32Values[5]
- Track width rear:
int32Values[6]
- Curb-to-curb turning diameter:
int32Values[7]
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLIMETER
Release: Android 13
INFO_FUEL_CAPACITY
Fuel capacity of the vehicle in milliliters. This property must communicate the maximum amount
of fuel that can be stored in the vehicle in milliliters. This property does not apply to electric
vehicles (EV). That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, INFO_FUEL_CAPACITY must not be implemented.
For EVs, implement INFO_EV_BATTERY_CAPACITY.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLILITER
Release: Android 13
INFO_FUEL_DOOR_LOCATION
Fuel door location. This property must communicate the location of the fuel door on the vehicle.
This property does not apply to EVs. That is, if INFO_FUEL_TYPE
only contains
FuelType::FUEL_TYPE_ELECTRIC
, this property must not be implemented. For EVs,
implement INFO_EV_PORT_LOCATION
or INFO_MULTI_LOCATIONS
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_FUEL_TYPE
List of fuels the vehicle may use. FuelType::FUEL_TYPE_ELECTRIC
must only be
included if the vehicle can plug-in rechargeable. For example, a Fully Hybrid Electric Vehicle
(FHEV) must not include FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC
value for INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such.
int32Values = { FuelType::FUEL_TYPE_UNLEADED }
FuelType::FUEL_TYPE_ELECTRIC
as the INT32_VEC value for
INFO_FUEL_TYPE
INFO_FUEL_TYPE
can be populated as such,
int32Values = { FuelType::FUEL_TYPE_UNLEADED, FuelType::FUEL_TYPE_ELECTRIC }
Change mode: STATIC
Access mode: READ
Enum type: FuelType
Unit type: N/A
Release: Android 13
INFO_MAKE
Manufacturer of vehicle. This property must communicate the vehicle's public brand name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL
Model of vehicle. This property must communicate the vehicle's public model name.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INFO_MODEL_YEAR
Model year of vehicle in `YYYY` format based on the Gregorian calendar.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:YEAR
Release: Android 13
INFO_MULTI_EV_PORT_LOCATIONS
Multiple EV port locations. Implement this property if the vehicle has multiple EV ports. Port locations are defined in PortLocationType. For example, a car has one port front left and one port rear left:
int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT
If a vehicle has only one port, this property's value should list one element. To describe one port location, see INFO-EV-PORT-LOCATION
.
Change mode: STATIC
Access mode: READ
Enum type: PortLocationType
Unit type: N/A
Release: Android 13
INFO_VIN
VIN of vehicle.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
INITIAL_USER_INFO
Defines the Android user to be used during initialization. This property is called by
the Android system when it initializes and lets the HAL define which Android user should be
started. This request is made by setting a VehiclePropValue (defined by
InitialUserInfoRequest
), and the HAL must respond with a property change event (defined
by InitialUserInfoResponse).
If the HAL doesn't respond after a time defined by the Android system, the Android system proceeds
as if HAL returned a response of action InitialUserInfoResponseAction:DEFAULT.
For example, on first boot, the request could be:
int32[0] 42 // request id (arbitrary number set by Android system) int32[1] 1 // InitialUserInfoRequestType::FIRST_BOOT int32[2] 0 // id of current user (usersInfo.currentUser.userId) int32[3] 1 // flag of current user (usersInfo.currentUser.flags = SYSTEM) int32[4] 1 // number of existing users (usersInfo.numberUsers); int32[5] 0 // user #0 (usersInfo.existingUsers[0].userId) int32[6] 1 // flags of user #0 (usersInfo.existingUsers[0].flags)
int32[0] 42 // must match the request id from the request int32[1] 2 // action = InitialUserInfoResponseAction::CREATE int32[2] -10000 // userToSwitchOrCreate.userId (not used as user will be created) int32[3] 8 // userToSwitchOrCreate.flags = ADMIN string: "||Owner" // userLocales + separator + userNameToCreate
InitialUserInfoResponseAction:CREATE
). For example, to create the
same Owner user with en-US and pt-BR locales, the string value of the response is
en-US,pt-BR||Owner. As such, neither the locale nor the name can contain two vertical bars
(||
) in their values, although you can use a single vertical bar (|
).
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
J से R तक
LANE_CENTERING_ASSIST_COMMAND
Lane Centering Assist (LCA) commands. Commands to activate and suspend LCA.
When the command ACTIVATE
from LaneCenteringAssistCommand
is sent,
LANE_CENTERING_ASSIST_STATE
must be set to LaneCenteringAssistState#ACTIVATION_REQUESTED
When the
ACTIVATE
command succeeds,
LANE_CENTERING_ASSIST_STATE
must be set to LaneCenteringAssistState#ACTIVATED
When the command
DEACTIVATE
from LaneCenteringAssistCommand
succeeds,
LANE_CENTERING_ASSIST_STATE
must be set to
LaneCenteringAssistState#ENABLED
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
must be defined unless all
enum values of LaneCenteringAssistCommand
are supported. When this property is not available
because LCA is disabled (for example, LANE_CENTERING_ASSIST_ENABLED
is false), this
property must
return StatusCode#NOT_AVAILABLE_DISABLED
If LANE_CENTERING_ASSIST_STATE
is
implemented and the
state is set to an ErrorState
value, then this property must return a StatusCode
that aligns with
the ErrorState
value. For example, if LANE_CENTERING_ASSIST_STATE
is set to
ErrorState#NOT_AVAILABLE_SPEED_LOW
then this property must return
StatusCode#NOT_AVAILABLE_SPEED_LOW
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: LaneCenteringAssistCommand
Unit type: N/A
Release: Android 14
LANE_CENTERING_ASSIST_ENABLED
Enable or disable Lane Centering Assist (LCA). Set true to enable LCA and false to disable LCA. When LCA is enabled, the ADAS system in the vehicle should be turned on and waiting for an activation signal from the driver. Once the feature is activated, the ADAS system should be steering the vehicle to keep it centered in its current lane.
This is different from Lane Keep Assist (LKA) which monitors if the driver unintentionally
drifts toward or over the lane marking. If an unintentional lane departure is detected, the
system applies steering control to return the vehicle into the current lane.
In general, LANE_CENTERING_ASSIST_ENABLED
should always return true or false. If the
feature is not available due to some temporary state, such as the vehicle speed being too low or
too high, that information must be conveyed through the ErrorState
values in the
LANE_CENTERING_ASSIST_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
LANE_CENTERING_ASSIST_STATE
Lane Centering Assist (LCA) state. Returns the current state of LCA. This property must always
return a valid state defined in LaneCenteringAssistState
or ErrorState
It must not surface errors through StatusCode
and must use the supported error
states instead.
If LCA includes lane departure warnings, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be
defined unless all states of both LaneCenteringAssistState
(including OTHER, which
is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneCenteringAssistState/ErrorState
Unit type: N/A
Release: Android 14
LANE_DEPARTURE_WARNING_ENABLED
Enable or disable Lane Departure Warning (LDW). Set true to enable LDW and false to disable LDW. When LDW is enabled, the ADAS system in the vehicle should be turned on and monitoring if the vehicle is approaching or crossing lane lines, in which case a warning will be given.
In general, LANE_DEPARTURE_WARNING_ENABLED
should always return true or false. If
the feature is not available due to some temporary state, such as the vehicle speed being too low
or too high, that information must be conveyed through the ErrorState
values in the
LANE_DEPARTURE_WARNING_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
LANE_DEPARTURE_WARNING_STATE
Lane Departure Warning (LDW) state. Returns the current state of LDW. This property must always
return a valid state defined in LaneDepartureWarningState
or ErrorState
It must not surface errors through StatusCode
and must use the supported error states
instead.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be
defined unless all states of both LaneDepartureWarningState
(including OTHER, which
is not recommended) and ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneDepartureWarningState/ErrorState
Unit type: N/A
Release: Android 14
LANE_KEEP_ASSIST_ENABLED
Enable or disable Lane Keep Assist (LKA). Set true to enable LKA and false to disable LKA. When LKA is enabled, the ADAS system in the vehicle should be turned on and monitoring if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane. This is different from Lane Centering Assist (LCA) which, when activated, applies continuous steering control to keep the vehicle centered in the current lane.
In general, LANE_KEEP_ASSIST_ENABLED
should always return true or false. If the
feature is not available due to some temporary state, such as the vehicle speed being too low or
too high, that information must be conveyed through the ErrorState
values in the
LANE_KEEP_ASSIST_STATE
property.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
LANE_KEEP_ASSIST_STATE
Lane Keep Assist (LKA) state. Returns the current state of LKA. This property must always return
a valid state defined in LaneKeepAssistState
or ErrorState
It must not
surface errors through StatusCode
and must use the supported error states instead
If LKA includes lane departure warnings before applying steering corrections, those warnings must be surfaced through the Lane Departure Warning (LDW) properties.
For the global area ID (0), the VehicleAreaConfig#supportedEnumValues
array must be defined
unless all states of both LaneKeepAssistState
(including OTHER, which is not recommended) and
ErrorState
are supported.
Change mode: ON_CHANGE
Access mode: READ
Enum type: LaneKeepAssistState/ErrorState
Unit type: N/A
Release: Android 14
LOCATION_CHARACTERIZATION
Characterization of inputs used for computing location. This property must indicate what (if any) data and sensor inputs are considered by the system when computing the vehicle's location that is shared with Android through the GNSS HAL.
The value must return a collection of bit flags. The bit flags are defined in
LocationCharacterization. The value must also include exactly one of DEAD_RECKONED
or
RAW_GNSS_ONLY
among its collection of bit flags.
When this property is not supported, it is assumed that no additional sensor inputs are fused into the GNSS updates provided through the GNSS HAL. That is unless otherwise specified through the GNSS HAL interfaces.
Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14
MIRROR_AUTO_FOLD_ENABLED
Represents property for Mirror Auto Fold feature. This property is true when the feature for automatically folding the vehicle's side mirrors (for example, when the mirrors fold inward automatically when one exits and locks the vehicle) is enabled.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
MIRROR_AUTO_TILT_ENABLED
Represents property for Mirror Auto Tilt feature. This property is true when the feature for automatically tilting the vehicle's side mirrors (for example, when the mirrors tilt downward automatically when one reverses the vehicle) is enabled.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14
MIRROR_FOLD
Mirror fold. True indicates mirrors are folded. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_LOCK
Mirror lock. True indicates mirror positions are locked and not changeable.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Y_MOVE
Mirror Y move. The maxInt32Value
and minInt32Value
in each
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
represents the maximum movement speed of the mirror while tilting
right. The minInt32Value
represents the maximum movement speed of the mirror while
tilting left.
Larger absolute values, either positive or negative, indicate a faster movement speed. Once the mirror reaches the positional limit, the value must reset to 0. If MIRROR_Y_MOVE's value is currently 0, then that means there is no movement currently occurring.
This property is not in any particular unit but in a specified range of relative movement speeds.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Y_POS
Mirror Y position. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The minInt32Value
indicates the mirror is tilted completely to the left.
This must be a non-positive value. The maxInt32Value
indicates the mirror is tilted
completely
to the right. This must be a non-negative value. 0 indicates the mirror is not tilted in either
direction.
Values in between minInt32Value
and maxInt32Value
indicate a transition
state between the left
extreme and right extreme positions.
This property is not in any particular unit but in a specified range of relative positions.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Z_MOVE
Mirror Z move. The maxInt32Value
and minInt32Value
in each
VehicleAreaConfig
must be defined.
All integers between minInt32Value
and maxInt32Value
must be supported.
The maxInt32Value
represents the maximum movement speed of the mirror while tilting upwards.
The minInt32Value
represents the maximum movement speed of the mirror while tilting downwards.
Larger absolute values, either positive or negative, indicate a faster movement speed. Once the
mirror reaches the positional limit, the value must reset to 0. If MIRROR_Z_MOVE's value is
currently 0, then that means there is no movement currently occurring.
This property is not in any particular unit but in a specified range of relative movement speeds.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
MIRROR_Z_POS
Mirror Z position. The maxInt32Value
and minInt32Value
in
VehicleAreaConfig
must be defined. All integers between minInt32Value
and maxInt32Value
must be supported. The minInt32Value
indicates the
mirror is tilted completely downwards. This must be a non-positive value. The
maxInt32Value
indicates the mirror is tilted completely upwards. This must be a
non-negative value. 0 indicates the mirror is not tilted in either direction.
Values in between minInt32Value
and maxInt32Value
indicate a
transition state between the fully downward and fully upwards positions.
This property is not in any particular unit but in a specified range of relative positions.
This property is defined as VehiclePropertyAccess.READ_WRITE
, but OEMs can
implement it as VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13
NIGHT_MODE
True indicates that the night mode sensor has detected the car cabin environment to have low light. The platform can use this to, for example, enable an appropriate UI for better viewing in dark or low light environments.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_FREEZE_FRAME
Reports a snapshot of the value of the OBD2 sensors available at the time that a fault occurred
and was detected. A configArray must be provided with the same meaning as defined for
OBD2_LIVE_FRAME
The values of this property are to be interpreted in a similar fashion as those for
OBD2_LIVE_FRAME
, with the exception that the stringValue field may contain a
non-empty diagnostic troubleshooting code (DTC).
An IVehicle#get request of this property must provide a value for int64Values[0]. This is interpreted
as the timestamp of the freeze frame to retrieve. A list of timestamps can be obtained by an
IVehicle#get of OBD2_FREEZE_FRAME_INFO
Should no freeze frame be available at the given timestamp, a response of
NOT_AVAILABLE
must be returned by the implementation. Because vehicles may have
limited storage for freeze frames, it is possible for a frame request to respond with
NOT_AVAILABLE
even if the associated timestamp has been recently obtained through
OBD2_FREEZE_FRAME_INFO
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_FREEZE_FRAME_CLEAR
Freeze frame clear. Reports a snapshot of the value of the OBD2 sensors available at the time
that a fault occurred and was detected. A configArray must be provided with the same meaning as
defined for OBD2_LIVE_FRAME
The values of this property are to be interpreted in a similar fashion as those for
OBD2_LIVE_FRAME
, with the exception that the stringValue field may contain a non-empty diagnostic
troubleshooting code (DTC).
A IVehicle#get request of this property must provide a value for int64Values[0]. This will be
interpreted as the timestamp of the freeze frame to retrieve. A list of timestamps can be
obtained by a IVehicle#get of OBD2_FREEZE_FRAME_INFO
Should no freeze frame be available at the given timestamp, a response of NOT_AVAILABLE
must be
returned by the implementation. Because vehicles may have limited storage for freeze frames,
it is possible for a frame request to respond with NOT_AVAILABLE
even if the associated
timestamp has been recently obtained via OBD2_FREEZE_FRAME_INFO
Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_FREEZE_FRAME_INFO
This property describes the current freeze frames stored in vehicle memory and available for
retrieval through OBD2_FREEZE_FRAME
The values are to be interpreted as follows. Each element of
int64Values must be the timestamp at which a a fault code has been detected and the corresponding
freeze frame stored, and each such element can be used as the key to OBD2_FREEZE_FRAME
to
retrieve the corresponding freeze frame.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
OBD2_LIVE_FRAME
Reports a snapshot of the current (live) values of the OBD2 sensors available. The configArray is set as follows:
configArray[0]
Number of vendor-specific integer-valued sensorsconfigArray[1]
Number of vendor-specific float-valued sensors
The values of this property are to be interpreted as in the following example. Considering a
configArray = {2,3} int32Values
must be a vector containing
Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX
plus two elements (or, 33 elements).
floatValues
must be a vector containing
Obd2FloatSensorIndex.LAST_SYSTEM_INDEX
plus three elements (or, 73 elements).
It is possible for each frame to contain a different subset of sensor values, both system
provided sensors, and vendor-specific ones. In order to support this, the bytes element of the
property value is used as a bitmask. Bytes must have a sufficient number of bytes to represent
the total number of possible sensors (in this case, 14 bytes to represent 106 possible values).
It'is to be read as a contiguous bitmask such that each bit indicates the presence or absence of
a sensor from the frame, starting with as many bits as the size of int32Values
,
immediately followed by as many bits as the size of floatValues.
For example, should bytes[0] = 0x4C (0b01001100)
it means that:
int32Values[0 and 1]
are not valid sensor valuesint32Values[2 and 3]
are valid sensor valuesint32Values[4 and 5]
are not valid sensor valuesint32Values[6]
is a valid sensor valueint32Values[7]
is not a valid sensor valueint32Values[0 and 1]
are not valid sensor valuesint32Values[2 and 3]
are valid sensor valuesint32Values[4 and 5]
are not valid sensor valuesint32Values[6]
is a valid sensor valueint32Values[7]
is not a valid sensor value
If bytes[5] = 0x61 (0b01100001)
, then:
int32Values[32]
is a valid sensor valuefloatValues[0 thru 3]
are invalid sensor valuesfloatValues[4 and 5]
are valid sensor valuesfloatValues[6]
is not a valid sensor value.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
ON_CHANGE
Change mode:
Access mode: READ_WRITE/READ
Enum type:
Unit type:N/A
Release: Android 13
VehicleLightSwitch
PARKING_BRAKE_AUTO_APPLY
Auto-apply parking brake. When true, this property indicates that the car's
automatic parking brake is enabled. False indicates that the car's automatic parking
brake feature is disabled. This property is often confused with PARKING_BRAKE_ON
The
difference being that PARKING_BRAKE_ON
indicates if the actual parking brake is
on or off whereas PARKING_BRAKE_AUTO_APPLY
indicates if the automatic parking brake
feature is enabled or disabled and does not describe the current state of the actual parking
brake.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
PARKING_BRAKE_ON
Parking brake state. When true, this property true indicates that the car's parking brake is engaged. False indicates the car's parking brake is disengaged.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
PER_DISPLAY_BRIGHTNESS
Property to represent brightness of the displays which are controlled separately.
Some cars have one or more displays whose brightness is controlled separately and this property
is to inform the brightness of each passenger display. In cars where all displays' brightness
is controlled together, they must use DISPLAY_BRIGHTNESS
Only one of PER_DISPLAY_BRIGHTNESS
andPER_DISPLAY_BRIGHTNESS
should be implemented. If both are
available, PER_DISPLAY_BRIGHTNESS
is used by AAOS.
The display port uniquely identifies a physical connector on the device for display output, ranging from 0 to 255.
int32Values[0]
Display portint32Values[1]
Brightness
Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 14
PERF_ODOMETER
Current odometer value of the vehicle.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOMETER
Release: Android 13
PERF_REAR_STEERING_ANGLE
Rear bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the rear wheels with respect to the vehicle, not the angle of the steering wheel.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13
PERF_STEERING_ANGLE
Front bicycle model steering angle for vehicle. Angle is measured in degrees. Left is negative. This property is independent of the angle of the steering wheel. This property must communicate the angle of the front wheels with respect to the vehicle, not the angle of the steering wheel.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:DEGREES
Release: Android 13
PERF_VEHICLE_SPEED
Speed of the vehicle, The value must be positive when the vehicle is moving forward and
negative when the vehicle is reversing. This value is independent of gear value
(CURRENT_GEAR
or GEAR_SELECTION
). For example, if
GEAR_SELECTION
is GEAR_NEUTRAL
, PERF_VEHICLE_SPEED
is
positive when the vehicle is moving forward, negative when reversing, and zero when not moving.
Change mode: CONTINUOUS
Access mode: READ
Unit type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13
PERF_VEHICLE_SPEED_DISPLAY
Speed of the vehicle for displays, Some cars display a slightly slower speed on the speedometer than actual speed.
Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:METER_PER_SEC
Release: Android 13
POWER_POLICY_GROUP_REQ
Defines a request to set the power policy group used to decide a default power policy per power status transition.
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
POWER_POLICY_REQ
Defines a request to apply power policy. VHAL sets this property to change car power policy.
Car power policy service subscribes to this property and actually changes the power policy. The
request is made by setting the VehiclePropValue with the ID of a power policy which is defined at
/vendor/etc/automotive/power_policy.xml
If the given ID is not defined, car power policy service
ignores the request and the current power policy is maintained.
string: "sample_policy_id" // power policy ID
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
POWER_POLICY_GROUP_REQ
Defines a request to set the power policy group used to decide a default power policy per power status transition. VHAL sets this property with the ID of a power policy group to set the default power policy applied at power status transition. Power policy groups are defined at /vendor/etc/power_policy.xml. If the given ID is not defined, car power policy service ignores the request. Car power policy service subscribes to this property and sets the power policy group. The actual application of power policy takes place when the system power status changes and there is a valid mapped power policy for the new power status.
string: "sample_policy_group_id" // power policy group ID
Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13
RANGE_REMAINING
Range remaining. Meters remaining of fuel and charge. Range remaining shall account for all
energy sources in a vehicle. For example, a hybrid car's range is the sum of the ranges based
on fuel and battery. This property is defined as VehiclePropertyAccess.READ_WRITE
because a navigation app could update the range if it has a more accurate estimate based on the
upcoming route. This property can be implemented as VehiclePropertyAccess.READ
only at the OEM's discretion.
Change mode: CONTINUOUS
Access mode: READ_WRITE
Enum type: N/A
Unit type: VehicleUnit:METER
Release: Android 13
READING_LIGHTS_STATE
Return the current status of reading lights.
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
READING_LIGHTS_SWITCH
Switch t control the reading lights. This may differ from READING_LIGHTS_STATE
if
the lights are on because a door is open or due to a voice command. For example, while the switch
is in the off or automatic position. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
REAR_FOG_LIGHTS_STATE
Return the current state of the rear fog lights. Only one of FOG_LIGHTS_STATE
or
REAR_FOG_LIGHTS_STATE
can be implemented. See FOG_LIGHTS_STATE
Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 13
REAR_FOG_LIGHTS_SWITCH
The setting that the user wants. Only one of FOG_LIGHTS_SWITCH
or
REAR_FOG_LIGHTS_SWITCH
must
be implemented. See FOG_LIGHTS_SWITCH
to learn more. This property is defined as
VehiclePropertyAccess.READ_WRITE
, but OEMs can implement it as
VehiclePropertyAccess.READ
only.
Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleLightSwitch
Unit type: N/A
Release: Android 13
REMOVE_USER
Called by the Android System after an Android user was removed. The HAL can use this property to remove the equivalent user. This is write-only cal. The Android System is not expecting a reply from the HAL. Hence, this request should not fail. If the equivalent HAL user cannot be removed, then HAL should mark it as inactive or recover in another way.
The request is made by setting the VehiclePropValue with the contents defined by
RemoveUserRequest
For example, if system had 3 users (0, 10, and 11) and user 11
was removed, the request would be:
int32[0]
42 // request idint32[1]
11 // (Android user id of the removed user)int32[2]
0 // (Android user flags of the removed user)int32[3]
10 // current userint32[4]
0 // current user flags (none)int32[5]
2 // number of usersint32[6]
0 // first user (user 0)int32[7]
0 // first user flags (none)int32[8]
10 // second user (user 10)int32[9
] 0 // second user flags (none)
Change mode: STATIC
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13
S से Z
SEAT_AIRBAG_ENABLED
यह सुविधा, ट्रिगर होने पर (उदाहरण के लिए, टक्कर के दौरान) सीट के एयरबैग को चालू और बंद करने की सुविधा दिखाती है. अगर true
है, तो इसका मतलब है कि सीट के एयरबैग चालू हैं और ट्रिगर होने पर, वे चालू हो जाते हैं. अगर true
है, तो सीट के एयरबैग बंद होते हैं और वे किसी भी स्थिति में चालू नहीं होते. इस प्रॉपर्टी में यह जानकारी नहीं दी जाती है कि एयरबैग डिप्लॉय किए गए हैं या नहीं.
इस प्रॉपर्टी को VehiclePropertyAccess.READ
सिर्फ़ नियमों या सुरक्षा से जुड़ी समस्याओं के लिए पढ़ने के मकसद से सेट किया जा सकता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_BACKREST_ANGLE_1_MOVE
सीट के बैकस्टेस्ट के ऐंगल में एक बार बदलाव. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, सीट के बैकरेस्ट के आगे की ओर झुकने के दौरान, उसकी गति की सबसे ज़्यादा रफ़्तार दिखाता है. minInt32Value
से यह पता चलता है कि पीछे की ओर ले जाने पर, सीट के पीछे ज़्यादा से ज़्यादा हलचल कैसे हो सकती है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. जब सीट के बैकरेस्ट की स्थिति तय सीमा तक पहुंच जाए, तो वैल्यू को 0 पर रीसेट करना ज़रूरी है. अगर SEAT_BACKREST_ANGLE_1_MOVE
की वैल्यू 0 है, तो कोई हलचल नहीं होगी.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा में दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_BACKREST_ANGLE_1_POS
सीट के पीछे के हिस्से के ऐंगल 1 की पोज़िशन. बैकरेस्ट ऐंगल 1, सीट के सबसे नीचे वाला ऐक्चुएटर होता है. VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं. minInt32Value
से पता चलता है कि सीट के सबसे नीचे मौजूद ऐक्चुएटर के हिसाब से, सीट के बैकस्टेस्ट की पूरी झुकाव वाली स्थिति क्या है. maxInt32Value
से यह पता चलता है कि सीट के सबसे नीचे मौजूद एक्चुएटर के हिसाब से, सीट के बैकरेस्ट की दाईं या आगे की पोज़िशन सबसे ऊपर है या नहीं.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, पूरी रिक्लाइन और अपराइट और फ़ॉरवर्ड पोज़िशन के बीच के ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_BACKREST_ANGLE_2_MOVE
सीट की बैकस्टेस्ट के ऐंगल में दो बार बदलाव. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, सीट के बैकरेस्ट के आगे की ओर झुकने के दौरान, उसकी गति की सबसे ज़्यादा रफ़्तार दिखाता है. minInt32Value
, सीट के पीछे के हिस्से को पीछे झुकाने के दौरान, उसकी ज़्यादा से ज़्यादा गति दिखाता है.
बड़ी वैल्यू, चाहे वे सकारात्मक हों या नकारात्मक, गति की तेज़ी को दिखाती हैं. जब
सीट के बैकरेस्ट के लिए, पोज़िशन करने की सीमा पूरी हो जाएगी, तब वैल्यू को 0 पर रीसेट करना होगा. अगर SEAT_BACKREST_ANGLE_2_MOVE
की वैल्यू फ़िलहाल 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
यह प्रॉपर्टी VehiclePropertyAccess.READ_WRITE
के तौर पर बताई गई है. हालांकि, ओईएम
इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_BACKREST_ANGLE_2_POS
सीट के बैकरेस्ट के ऐंगल की दूसरी पोज़िशन. बैकरेस्ट ऐंगल 2, सीट के सबसे नीचे से ऊपर की ओर अगला ऐक्चुएटर होता है.
VehicleAreaConfig
में maxInt32Value
और minInt32Value
के लिए वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांकों के लिए, #0supported होना चाहिए.
minInt32Value
, सीट के सबसे नीचे मौजूद ऐक्चुएटर से लेकर, बैकरेस्ट के अगले ऐक्चुएटर तक, सीट के बैकरेस्ट की पूरी रीक्लाइन पोज़िशन दिखाता है. ज़्यादा जानकारी के लिए, SEAT_BACKREST_ANGLE_1_POS
देखें. maxInt32Value
, सीट के सबसे ऊपर और आगे की पोज़िशन के बारे में बताता है. यह जानकारी, सीट के सबसे नीचे मौजूद ऐक्टिवेटर से लेकर, बैकरेस्ट में मौजूद अगले ऐक्टिवेटर के बीच की होती है. ज़्यादा जानकारी के लिए SEAT_BACKREST_ANGLE_1_POS
देखें.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, पूरी तरह से झुकने और सीधे और आगे की ओर झुकने के बीच के ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_BELT_BUCKLED
सीट बेल्ट का बकल बंद हो. True का मतलब है कि बेल्ट बकल की गई है. लिखने का ऐक्सेस, सीट की ऑटोमैटिक बकल करने की सुविधाओं के बारे में बताता है. इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर तय किया गया है, लेकिन OEMs इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_BELT_HEIGHT_मूव
सीटबेल्ट की ऊंचाई में बदलाव. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
के बारे में बताना ज़रूरी है. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, सीट बेल्ट के ऊपर की ओर बढ़ते समय, उसके कंधे के ऐंकर की गति की ज़्यादा से ज़्यादा रफ़्तार दिखाता है. minInt32Value
, सीट बेल्ट के कंधे के ऐंकर के नीचे की ओर बढ़ने की ज़्यादा से ज़्यादा रफ़्तार दिखाता है.
पॉज़िटिव या नेगेटिव से बड़े निरपेक्ष मान, तेज़ रफ़्तार का संकेत देते हैं. जब सीट बेल्ट, पोज़िशन के लिए तय की गई सीमा तक पहुंच जाएगी, तब वैल्यू को 0 पर रीसेट करना होगा. अगर SEAT_BELT_HEIGHT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_BELT_HEIGHT_POS
सीटबेल्ट की ऊंचाई की पोज़िशन. यह कंधे की बेल्ट के एंकर पॉइंट को अडजस्ट करता है.
वाहन क्षेत्र के कॉन्फ़िगरेशन में maxInt32Value
और minInt32Value
के बारे में
बताया जाना चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक काम करने चाहिए.
minInt32Value
से पता चलता है कि सीट बेल्ट का कंधे का ऐंकर सबसे नीचे की पोज़िशन पर है. maxInt32Value
से पता चलता है कि सीट बेल्ट का कंधे का ऐंकर सबसे ऊपरी पोज़िशन पर है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे बड़ी पोज़िशन के बीच की ट्रांज़िशन स्थिति के बारे में बताती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_CUSHION_SIDE_SUPPORT_MOVE
चलने की दिशा और सीट के गद्दे की साइड को सपोर्ट करने वाली रफ़्तार के लिए प्रॉपर्टी दिखाता है.
हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी दी जानी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक काम करने चाहिए.
maxInt32Value
, सीट कुशन के साइड
सपोर्ट के चौड़े होने पर, उसकी गति की ज़्यादा से ज़्यादा स्पीड दिखाता है. उदाहरण के लिए, सपोर्ट कम हो रहा है. minInt32Value
से पता चलता है कि सीट के कुशन के साइड सपोर्ट की चौड़ाई कम होने पर, उसकी गति कितनी है
(उदाहरण के लिए, सपोर्ट बढ़ रहा है).
पॉज़िटिव या नेगेटिव से बड़े निरपेक्ष मान, तेज़ रफ़्तार का संकेत देते हैं. सीट कुशन के साइड सपोर्ट की पोज़िशन की सीमा तक पहुंचने के बाद, वैल्यू को 0 पर रीसेट करना होगा. अगर SEAT_CUSHION_SIDE_SUPPORT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव ऐक्टिविटी की स्पीड की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_CUSHION_SIDE_SUPPORT_POS
सीट के हिपसाइड (बॉटम कुशन की साइड) के सपोर्ट पोज़िशन की प्रॉपर्टी दिखाती है.
हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी देना ज़रूरी है. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक काम करने चाहिए.
maxInt32Value
से पता चलता है कि सीट कुशन साइड सपोर्ट, अपनी सबसे चौड़ी स्थिति में है. उदाहरण के लिए, सबसे कम सपोर्ट. minInt32Value
से पता चलता है कि सीट कुशन के साइड सपोर्ट की चौड़ाई सबसे कम है. उदाहरण के लिए, सबसे ज़्यादा सपोर्ट.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे पतली और सबसे चौड़ी पोज़िशन के बीच ट्रांज़िशन स्टेटस दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है. हालांकि, OEM इसे सिर्फ़ <covehiclepropertyaccess.read< code=""> के तौर पर लागू कर सकते हैं.</covehiclepropertyaccess.read<>
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_DEPTH_मूव
सीट की गहराई में बदलाव.
हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी दी जानी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, सीट की ज़्यादा से ज़्यादा हलचल की रफ़्तार को दिखाता है, जबकि यह ज़्यादा गहरी होती है. minInt32Value
से यह पता चलता है कि सीट के उथले होने पर, उसकी रफ़्तार ज़्यादा से ज़्यादा कितनी हो सकती है.
पॉज़िटिव या नेगेटिव से बड़े निरपेक्ष मान, तेज़ रफ़्तार का संकेत देते हैं. जब
सीट के बैकरेस्ट के लिए, पोज़िशन करने की सीमा पूरी हो जाएगी, तब वैल्यू को 0 पर रीसेट करना होगा. अगर SEAT_DEPTH_MOVE
की वैल्यू फ़िलहाल 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
Enum टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_DEPTH_POS
सीट की गहराई की पोज़िशन. सीट की गहराई, सीट के पीछे के हिस्से से सीट के सामने के हिस्से की दूरी सेट करता है.
वाहन क्षेत्र के कॉन्फ़िगरेशन में maxInt32Value
और minInt32Value
के बारे में बताना ज़रूरी है. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
minInt32Value
से पता चलता है कि सीट सबसे छोटी स्थिति में है. उदाहरण के लिए, वह स्थिति जिसमें सीट के कुशन के सामने वाले किनारे और सीट के पीछे के हिस्से के बीच सबसे कम दूरी हो.
maxInt32Value
से पता चलता है कि सीट सबसे पीछे की पोज़िशन में है. उदाहरण के लिए, वह पोज़िशन जिसमें सीट के कुशन के सामने वाले किनारे और सीट के पीछे के हिस्से के बीच सबसे ज़्यादा दूरी हो.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे ज़्यादा गति के बीच के ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है. हालांकि, OEM इसे सिर्फ़ <covehiclepropertyaccess.read< code=""> के तौर पर लागू कर सकते हैं..</covehiclepropertyaccess.read<>
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_EASY_ACCESS_ENABLED
सीट को आसानी से ऐक्सेस करने की सुविधा के लिए प्रॉपर्टी दिखाता है. अगर सही है, तो सीट अपने-आप अडजस्ट हो जाती है, ताकि यात्री कार में आसानी से जा सके और उससे बाहर निकल सके. हर क्षेत्र का आईडी, उस सीट से मैप होना चाहिए जिस पर उपयोगकर्ता आसानी से ऐक्सेस करने की सुविधा की मदद से, बैठने/उतरने की कोशिश कर रहा है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है. हालांकि, OEM इसे सिर्फ़ <covehiclepropertyaccess.read< code=""> के तौर पर लागू कर सकते हैं.</covehiclepropertyaccess.read<>
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_FOOTWELL_LIGHTS_राज्य
सीट के फ़ुटवेल लाइट की स्थिति के लिए प्रॉपर्टी को दिखाता है. SEAT_FOOTWELL_LIGHTS_STATE
, किसी भी समय लाइटों की मौजूदा स्थिति दिखाता है. यह SEAT_FOOTWELL_LIGHTS_SWITCH
के फ़ंक्शन से अलग है, जो लाइटों को कंट्रोल करने वाले स्विच की स्थिति के बारे में बताता है.
इसलिए, हो सकता है कि SEAT_FOOTWELL_LIGHTS_STATE
, SEAT_FOOTWELL_LIGHTS_SWITCH
की वैल्यू से मेल न खाए
(उदाहरण के लिए, SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
और SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
इस प्रॉपर्टी को सिर्फ़ तब लागू किया जाना चाहिए, जब SEAT_FOOTWELL_LIGHTS_STATE
की वैल्यू, CABIN_LIGHTS_STATE से अलग हो.
इस्तेमाल किए जा सकने वाले हर क्षेत्र के आईडी के लिए, VehicleAreaConfig#supportedEnumValues को तब तक तय करना ज़रूरी है, जब तक कि VehicleLightState की सभी वैल्यू इस्तेमाल नहीं की जा सकतीं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
एनम टाइप: VehicleLightState
इकाई का टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_FOOTWELL_LIGHTS_SWITCH
सीट के फ़ुटवेल लाइट स्विच की प्रॉपर्टी दिखाता है. SEAT_FOOTWELL_LIGHTS_SWITCH
, लाइटों को कंट्रोल करने वाले स्विच की स्थिति दिखाता है. यह SEAT_FOOTWELL_LIGHTS_STATUS के फ़ंक्शन से अलग है, जो किसी भी समय लाइटों की मौजूदा स्थिति को दिखाता है.
इसलिए, हो सकता है कि SEAT_FOOTWELL_LIGHTS_SWITCH
, SEAT_FOOTWELL_LIGHTS_STATE की वैल्यू से मेल न खाए (उदाहरण के लिए, SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC
और SEAT_FOOTWELL_LIGHTS_SWITCH=ON
).
इस प्रॉपर्टी को सिर्फ़ तब लागू किया जाना चाहिए, जब SEAT_FOOTWELL_LIGHTS_SWITCH की वैल्यू, CABIN_LIGHTS_SWITCH की वैल्यू से अलग हो.
इस्तेमाल किए जा सकने वाले हर इलाके के आईडी के लिए,VehicleAreaConfig#supportedEnumValues को तब तक तय किया जाना चाहिए, जब तक VehicleLightSwitch के सभी enum मान काम न करें.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: VehicleLightSwitch
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_FORE_AFT_MOVE
सीट आगे और पीछे की ओर चलती है. यह प्रॉपर्टी, सीट को उसी दिशा में आगे/पीछे ले जाती है जिसमें वह मौजूद है.
हरVehicleAreaConfig में maxInt32Value
और minInt32Value
तय किए जाने चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, आगे बढ़ते समय सीट की ज़्यादा से ज़्यादा गति दिखाता है. minInt32Value
, पीछे की ओर बढ़ते समय सीट की ज़्यादा से ज़्यादा गति दिखाता है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. सीट की वैल्यू, तय सीमा तक पहुंचने के बाद 0 पर रीसेट होनी चाहिए. अगर SEAT_FORE_AFT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव ऐक्टिविटी की स्पीड की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_FORE_AFT_POS
सीट के आगे और पीछे की पोज़िशन. सीट की पोज़िशन को आगे और पीछे सेट करता है.
VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए.
minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
minInt32Value
से पता चलता है कि सीट अपनी सबसे पीछे की पोज़िशन पर है.
maxInt32Value
से पता चलता है कि सीट सबसे आगे की लीनियर पोज़िशन पर है. minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे नज़दीकी और सबसे दूर की पोज़िशन के बीच ट्रांज़िशन स्टेटस दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_ANGLE_ गाइड
हेडरेस्ट के ऐंगल को मूव करना. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
के बारे में बताना ज़रूरी है. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
से पता चलता है कि सीट के हेडरेस्ट को सीधा या आगे की ओर ले जाते समय, उसकी गति कितनी ज़्यादा हो सकती है. minInt32Value
से पता चलता है कि सीट के हेडरेस्ट को थोड़ा नीचे ले जाते समय, उसकी गति कितनी ज़्यादा हो सकती है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. सीट का हेडरेस्ट अपनी तय सीमा तक पहुंचने के बाद, वैल्यू को 0 पर रीसेट करना ज़रूरी है. अगर SEAT_HEADREST_ANGLE_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
यह प्रॉपर्टी VehiclePropertyAccess.READ_WRITE
के तौर पर बताई गई है. हालांकि, OEM इसे सिर्फ़ <covehiclepropertyaccess.read< code=""> के तौर पर लागू कर सकते हैं..</covehiclepropertyaccess.read<>
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_ANGLE_POS
हेडरेस्ट के कोण की स्थिति. VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक काम करने चाहिए.
minInt32Value
से पता चलता है कि हेडरेस्ट पूरी तरह से पीछे की ओर झुका हुआ है. maxInt32Value
से पता चलता है कि हेडरेस्ट, सबसे ऊपर और आगे की ओर है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू से, पूरी तरह से पीछे झुकने और सबसे सीधे और आगे की ओर झुकने की स्थिति के बीच के ट्रांज़िशन की जानकारी मिलती है.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_FORE_AFT_MOVE
हेडरेस्ट को आगे और पीछे ले जाया जा सकता है. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
से यह पता चलता है कि आगे बढ़ते समय सीट के हेडरेस्ट में ज़्यादा से ज़्यादा कितनी तेज़ी से हलचल की जा सकती है. minInt32Value
, पीछे की ओर बढ़ते समय सीट के हेडरेस्ट की ज़्यादा से ज़्यादा गति दिखाता है.
पॉज़िटिव या नेगेटिव से बड़े निरपेक्ष मान, तेज़ रफ़्तार का संकेत देते हैं. सीट के हेडरेस्ट की पोज़िशन तय होने के बाद, वैल्यू को 0 पर रीसेट करना ज़रूरी है. अगर SEAT_HEADREST_FORE_AFT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव ऐक्टिविटी की स्पीड की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_FORE_AFT_POS
हेडरेस्ट की आगे और पीछे की पोज़िशन. VehicleAreaConfig
में maxInt32Value
और minInt32Value
के लिए वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
minInt32Value
से पता चलता है कि हेडरेस्ट, पीछे की ओर सबसे ज़्यादा लीनियर पोज़िशन में है.
maxInt32Value
से पता चलता है कि हेडरेस्ट, सबसे आगे की लीनियर पोज़िशन में है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, आगे और पीछे की पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_HEIGHT_MOVE
हेडरेस्ट की लंबाई में बदलाव. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, सीट के हेडरेस्ट के ऊपर की ओर बढ़ने के दौरान, उसकी गति की ज़्यादा से ज़्यादा रफ़्तार दिखाता है. minInt32Value
से पता चलता है कि नीचे जाते समय सीट के हेडरेस्ट में ज़्यादा से ज़्यादा हलचल कितनी हो सकती है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. जब सीट का हेडर, पोज़िशन के लिए तय की गई सीमा तक पहुंच जाए, तब इसकी वैल्यू 0 पर रीसेट होनी चाहिए. अगर SEAT_HEADREST_HEIGHT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_HEIGHT_POS
(अब इस्तेमाल नहीं किया जा सकता) हेडरेस्ट की ऊंचाई की पोज़िशन.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEADREST_HEIGHT_POS_V2
हेडरेस्ट की ऊंचाई की पोज़िशन. जिन सीटों पर हेडरेस्ट की सुविधा उपलब्ध है उनके लिए हेडरेस्ट की ऊंचाई सेट करता है. VehiclePropConfig.areaConfigs से पता चलता है कि कौनसी सीटें उपलब्ध हैं.
VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी दी गई होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
minInt32Value
से पता चलता है कि हेडरेस्ट सबसे नीचे की पोज़िशन पर है. maxInt32Value
से पता चलता है कि हेडरेस्ट सबसे ऊपर है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे ज़्यादा पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_HEIGHT_MOVE
सीट की ऊंचाई में बदलाव. हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
से पता चलता है कि सीट को ऊपर रखते समय, उसकी ज़्यादा से ज़्यादा ऐक्टिविटी स्पीड क्या है.
minInt32Value
, सीट के नीचे की ओर बढ़ने की ज़्यादा से ज़्यादा रफ़्तार दिखाता है.
पॉज़िटिव या नेगेटिव से बड़े निरपेक्ष मान, तेज़ रफ़्तार का संकेत देते हैं. सीट की वैल्यू, तय सीमा तक पहुंचने के बाद 0 पर रीसेट होनी चाहिए. अगर SEAT_HEIGHT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव ऐक्टिविटी की स्पीड की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_HEIGHT_POS
सीट की ऊंचाई की पोज़िशन. वाहन क्षेत्र के कॉन्फ़िगरेशन में maxInt32Value
और minInt32Value
के बारे में बताना ज़रूरी है. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
minInt32Value
से पता चलता है कि सीट सबसे नीचे की पोज़िशन पर है. maxInt32Value
से पता चलता है कि सीट सबसे ऊपर की पोज़िशन पर है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे ज़्यादा पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_LUMBAR_FORE_AFT_मूव
रीढ़ की हड्डी के आगे और पीछे की ओर होने वाली गति. हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, आगे बढ़ने के दौरान सीट के कमर के हिस्से के लिए बने सपोर्ट की, ज़्यादा से ज़्यादा मूवमेंट स्पीड दिखाता है. minInt32Value
, पीछे की ओर बढ़ते समय सीट के कमर के हिस्से को सहारा देने वाले हिस्से की ज़्यादा से ज़्यादा गति दिखाता है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं.
सीट के कमर के लिए बने सपोर्ट की पोज़िशन की सीमा तक पहुंचने के बाद, वैल्यू को 0 पर रीसेट करना होगा.
अगर SEAT_LUMBAR_FORE_AFT_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_LUMBAR_FORE_AFT_POS
लम्बर की आगे और पीछे की पोज़िशन. VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
minInt32Value
से पता चलता है कि कमर के लिए बने सपोर्ट की स्थिति सबसे पीछे है
(उदाहरण के लिए, कम से कम सपोर्ट वाली स्थिति). maxInt32Value
से पता चलता है कि कमर के लिए बने पैड, सबसे आगे की पोज़िशन में हैं. उदाहरण के लिए, सबसे ज़्यादा सपोर्ट वाली पोज़िशन.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, आगे और पीछे की पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस टाइप: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
कमर के साइड सपोर्ट को मूव करना. हर VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
से पता चलता है कि सीट के लंबर साइड को चढ़ते समय ज़्यादा से ज़्यादा मूवमेंट की स्पीड कितनी है. minInt32Value
से पता चलता है कि सीट के कमर के हिस्से के लिए बने साइड सपोर्ट की चौड़ाई कम होने के दौरान, उसकी गति कितनी ज़्यादा हो सकती है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. जब
सीट की कमर के लिए बने साइड सपोर्ट की पोज़िशन की सीमा पूरी हो जाती है, तो वैल्यू को 0 पर रीसेट करना ज़रूरी है. अगर
SEAT_LUMBAR_SIDE_SUPPORT_MOVE
की वैल्यू 0 है, तो कोई मूवमेंट नहीं होगा.
इस प्रॉपर्टी को, रिलेटिव ऐक्टिविटी की स्पीड की तय रेंज के तौर पर दिखाया जाता है.
यह प्रॉपर्टी VehiclePropertyAccess.READ_WRITE
के तौर पर बताई गई है. हालांकि, ओईएम
इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस टाइप: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_LUMBAR_SIDE_SUPPORT_POS
साइड सपोर्ट की पोज़िशन. VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं. minInt32Value
से पता चलता है कि कमर के साइड सपोर्ट की स्थिति सबसे कम है. उदाहरण के लिए, सबसे ज़्यादा सपोर्ट. maxInt32Value
से पता चलता है कि कमर के साइड सपोर्ट की चौड़ाई सबसे ज़्यादा है. उदाहरण के लिए, कम से कम सपोर्ट.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे पतली और सबसे चौड़ी पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस टाइप: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_LUMBAR_VERTICAL_मूव
सीट के लम्बर सपोर्ट की वर्टिकल मूवमेंट की दिशा और स्पीड की प्रॉपर्टी दिखाता है.
हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी दी जानी चाहिए. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं. maxInt32Value
से पता चलता है कि कमर के लिए बने सपोर्ट को सबसे तेज़ी से ऊपर की ओर ले जाया जा रहा है. minInt32Value
से पता चलता है कि कमर के लिए बने सपोर्ट को सबसे तेज़ी से नीचे ले जाया जा रहा है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. सीट कुशन के साइड सपोर्ट की पोज़िशन की सीमा तक पहुंचने के बाद, वैल्यू को 0 पर रीसेट करना होगा. अगर SEAT_LUMBAR_VERTICAL_MOVE की वैल्यू 0 है, तो इसका मतलब है कि सीट की कमर के हिस्से में कोई मूवमेंट नहीं हो रहा है.
इस प्रॉपर्टी को, रिलेटिव मूवमेंट स्पीड की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_LUMBAR_VERTICAL_POS
सीट के लम्बर सपोर्ट की वर्टिकल पोज़िशन की प्रॉपर्टी दिखाता है. हरVehicleAreaConfig में maxInt32Value
और minInt32Value
को तय किया जाना ज़रूरी है. minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं.
maxInt32Value
, कमर के लिए बने सपोर्ट की सबसे ऊपरी पोज़िशन दिखाता है.
minInt32Value
, कमर के लिए बने सपोर्ट की सबसे निचली पोज़िशन दिखाता है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे ज़्यादा पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_MEMORY_SELECT
यह पैरामीटर, सीट की पोज़िशन चुनने के लिए, मेमोरी प्रीसेट को चुनता है. VehicleAreaConfig में
maxInt32Value
और minInt32Value
तय करना ज़रूरी है.
minInt32Value
और maxInt32Value
के बीच के सभी पूर्णांक काम करने चाहिए.
minInt32Value
हमेशा 0 होता है और maxInt32Value
से, सीट की सेटिंग सेव करने के लिए उपलब्ध स्लॉट की संख्या तय होती है. उदाहरण के लिए, numSeatPresets - 1. उदाहरण के लिए,
अगर ड्राइवर की सीट में तीन मेमोरी प्रीसेट हैं, तो maxInt32Value
दो है. जब उपयोगकर्ता कोई प्रीसेट चुनता है, तो प्रीसेट का मनचाहा नंबर (0, 1 या 2) सेट हो जाता है.
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_MEMORY_SET
इस सेटिंग से उपयोगकर्ता, सीट की मौजूदा सेटिंग को पहले से चुने गए स्लॉट में सेव कर सकता है. VehicleAreaConfig
में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
की वैल्यू 0 होनी चाहिए. साथ ही, हर सीट की पोज़िशन के लिए maxInt32Value
की वैल्यू, SEAT_MEMORY_SELECT
के लिए maxInt32Value
की वैल्यू से मेल खानी चाहिए
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_OCCUPANCY
इससे पता चलता है कि किसी सीट पर कोई व्यक्ति बैठा है या नहीं. हालांकि, कार के लिए यह तय करना मुश्किल होता है. मान्य
वैल्यू, VehicleSeatOccupancyState
ईनम से हैं.
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: READ
एनम टाइप: VehicleSeatOccupancyState
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_TILT_MOVE
सीट झुकाने की सुविधा. हर
VehicleAreaConfig में maxInt32Value
और minInt32Value
तय करना ज़रूरी है. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं. maxInt32Value
से पता चलता है कि सीट के सामने वाले हिस्से की गति, ऊपर की ओर बढ़ते समय कितनी है. minInt32Value
से पता चलता है कि नीचे जाते समय सीट के आगे वाले किनारे पर, ज़्यादा से ज़्यादा ऐक्टिविटी स्पीड कितनी है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. जब सीट के निचले हिस्से की पोज़िशन, पोज़िशन के लिए तय की गई सीमा तक पहुंच जाए, तब वैल्यू 0 पर रीसेट होनी चाहिए. अगर SEAT_TILT_ गाइड की वैल्यू 0 है, तो कोई हलचल नहीं होगी.
इस प्रॉपर्टी को, रिलेटिव ऐक्टिविटी की स्पीड की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SEAT_TILT_POS
सीट की झुकाव की स्थिति. VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक काम करने चाहिए. minInt32Value
से पता चलता है कि सीट के निचले हिस्से का ऐंगल सबसे कम है. यह सीट के पीछे के हिस्से के मुकाबले, सीट के सबसे आगे के हिस्से की सबसे निचली स्थिति से मेल खाता है.
maxInt32Value
से पता चलता है कि सीट के निचले हिस्से का ऐंगल सबसे ज़्यादा है.
यह सीट के सामने वाले हिस्से की सबसे ऊपरी पोज़िशन होती है. यह सीट के पीछे वाले हिस्से के मुकाबले सबसे ऊपर होती है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे ज़्यादा पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
SEAT_WALK_IN_POS
यह प्रॉपर्टी, सीट की मौजूदा वॉक-इन पोज़िशन दिखाती है. minInt32Value
से, सीट की सामान्य स्थिति का पता चलता है. minInt32Value
की वैल्यू 0 होनी चाहिए. maxInt32Value
से पता चलता है कि सीट पूरी तरह से सुरक्षित है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सामान्य और वॉक-इन पोज़िशन के बीच ट्रांज़िशन की स्थिति दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
क्षेत्र का आईडी, उस सीट से मेल खाना चाहिए जो वॉक-इन सुविधा चालू होने पर, असल में चलती है. यह उस सीट से नहीं मेल खाना चाहिए जिस पर यात्री बैठेंगे.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE के तौर पर तय किया गया है. हालांकि, OEM
इसे VehiclePropertyAccess.READ के तौर पर लागू करें.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
SHUTDOWN_REQUEST
हेड यूनिट को बंद करने का अनुरोध करें.
हेड यूनिट के बंद होने पर कोई टास्क पूरा करने के लिए, यह ज़रूरी है (टास्क को रिमोट से पूरा करने की सुविधा). टास्क पूरा करने के लिए, हेड यूनिट को चालू करने के बाद, उसे बंद कर देना चाहिए. टास्क पूरा होने के बाद, हेड यूनिट यह मैसेज भेजती है.
जब कोई उपयोगकर्ता हेड यूनिट को बंद करना चाहता है, तब यह प्रॉपर्टी लागू नहीं होती.
आम तौर पर, हेड यूनिट के बाहर मौजूद किसी अलग सिस्टम (उदाहरण के लिए, पावर कंट्रोलर) को हेड यूनिट को बंद करने के लिए तैयार करने के लिए कहा जाता है.
बाहरी सिस्टम को यह पुष्टि करनी होगी कि यह अनुरोध मान्य है या नहीं. इसके लिए, यह देखना होगा कि गाड़ी का इस्तेमाल किया जा रहा है या नहीं. अगर SHUTDOWN_REQUEST भेजे जाने के बाद कोई उपयोगकर्ता वाहन में बैठता है, तो सिस्टम को इस अनुरोध को अनदेखा करना चाहिए. हमारा सुझाव है कि आप पावर कंट्रोलर में VehicleInUse प्रॉपर्टी को स्टोर करें और उसे VEHICLE_IN_USE प्रॉपर्टी के ज़रिए दिखाएं. अगर VehicleInUse के लिए वैल्यू 'सही है' है, तो बंद करने का अनुरोध अनदेखा किया जाना चाहिए.
अनुमति दिए जाने पर, बाहरी सिस्टम मुख्य यूनिट को शटडाउन सिग्नल भेजता है. इससे VHAL Android को SHUTDOWN_PREPARE मैसेज भेजेगा. इसके बाद, Android मैसेज को हैंडल करके शट डाउन प्रोसेस शुरू कर देगा.
इस प्रॉपर्टी का इस्तेमाल सिर्फ़ अनुरोध करने के लिए किया जा सकता है. साथ ही, इसमें सिर्फ़ लिखने की सुविधा उपलब्ध है. जब भी इस प्रॉपर्टी की वैल्यू सेट की जाती है, तो शटडाउन का अनुरोध जारी किया जाता है. भले ही, प्रॉपर्टी की मौजूदा वैल्यू कुछ भी हो. प्रॉपर्टी की मौजूदा वैल्यू का कोई मतलब नहीं है.
इस प्रॉपर्टी को सिर्फ़ लिखने के लिए बनाया गया है. इसलिए, इसकी सदस्यता नहीं ली जा सकती. साथ ही, प्रॉपर्टी में होने वाले बदलाव से जुड़ा कोई इवेंट जनरेट नहीं होता.
सेट की जाने वाली वैल्यू, शटडाउन के विकल्प के बारे में बताती है. यह
{@code VehicleApPowerStateShutdownParam}
में से एक होनी चाहिए,
उदाहरण के लिए,
VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY
. अगर सिस्टम में यह विकल्प काम नहीं करता है, तो हो सकता है कि सिस्टम बंद करने का यह विकल्प काम न करे. ऐसे मामले में, गड़बड़ी का मैसेज नहीं दिखता.
कॉन्फ़िगरेशन की जानकारी के लिए, VehiclePropConfig.configArray
में बिट फ़्लैग होना चाहिए, जो {@code VehicleApPowerStateConfigFlag}
में वैल्यू को जोड़ता है. इससे यह पता चलता है कि शटडाउन के कौनसे विकल्प काम करते हैं.
अगर दूसरे सिस्टम को बंद करने का अनुरोध नहीं भेजा जा सका, तो गड़बड़ी का मैसेज दिखाता है.
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: WRITE
एनम टाइप: VehicleApPowerStateShutdownParam
>
इकाई का टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_DEPTH_MOVE
स्टीयरिंग व्हील की गहराई से किया गया मूवमेंट. वाहन क्षेत्र के कॉन्फ़िगरेशन में maxInt32Value
और minInt32Value
के बारे में बताना ज़रूरी है. minInt32Value
और
maxInt32Value
के बीच की सभी वैल्यू इस्तेमाल की जा सकती हैं.
maxInt32Value
बताता है कि स्टीयरिंग व्हील ड्राइवर से दूर जा रहा है. minInt32Value
, ड्राइवर की तरफ़ जा रहे स्टीयरिंग व्हील के बारे में बताता है.
बड़े पूर्णांक, चाहे वे सकारात्मक हों या नकारात्मक, गति की तेज़ी का संकेत देते हैं. जब स्टीयरिंग व्हील, पोज़िशन की सीमा तक पहुंच जाता है, तो वैल्यू को 0 पर रीसेट करना ज़रूरी है. अगर STEERING_WHEEL_DEPTH_MOVE
की वैल्यू इस समय 0 है, तो कोई मूवमेंट नहीं चल रहा है.
इस प्रॉपर्टी को, गति की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_DEPTH_POS
स्टीयरिंग व्हील की गहराई की पोज़िशन. स्टीयरिंग व्हील की सभी प्रॉपर्टी के यूनीक आईडी, 0x0BE0 से शुरू होते हैं.
VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी दी गई होनी चाहिए. minInt32Value
और maxInt32Value
के बीच की सभी वैल्यू इस्तेमाल की जा सकती हैं. maxInt32Value
, स्टीयरिंग व्हील की उस स्थिति को दिखाता है जो ड्राइवर से सबसे दूर है. minInt32Value
से, स्टीयरिंग व्हील की उस स्थिति का पता चलता है जो ड्राइवर के सबसे करीब होती है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू,
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_EASY_ACCESS_ENABLED
स्टीयरिंग व्हील को आसानी से ऐक्सेस करने की सुविधा चालू हो. अगर यह सही है, तो ड्राइवर के स्टीयरिंग व्हील को अपने-आप अडजस्ट किया जाता है, ताकि ड्राइवर को वाहन में आसानी से चढ़ने और उतरने में मदद मिल सके.
यह प्रॉपर्टी VehiclePropertyAccess.READ_WRITE
के तौर पर बताई गई है. हालांकि, ओईएम
इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_HEIGHT_MOVE
स्टीयरिंग व्हील की ऊंचाई में बदलाव. VehicleAreaConfig में maxInt32Value
और minInt32Value
के लिए वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच की सभी वैल्यू इस्तेमाल की जा सकती हैं.
maxInt32Value
से पता चलता है कि स्टीयरिंग व्हील ऊपर की ओर जा रहा है. minInt32Value
से पता चलता है कि स्टीयरिंग व्हील नीचे की ओर जा रहा है.
बड़े पूर्णांक, चाहे वे सकारात्मक हों या नकारात्मक, गति की तेज़ी का संकेत देते हैं. स्टीयरिंग व्हील के अपनी सीमा तक पहुंचने के बाद, वैल्यू को 0 पर रीसेट करना ज़रूरी है. अगर
STEERING_WHEEL_HEIGHT_MOVE
की वैल्यू फ़िलहाल 0 है, तो इसका मतलब है कि फ़िलहाल कोई बदलाव नहीं हो रहा है.
इस प्रॉपर्टी को, गति की तय सीमा के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_HEIGHT_POS
स्टीयरिंग व्हील की ऊंचाई की पोज़िशन.
VehicleAreaConfig में maxInt32Value
और minInt32Value
की जानकारी दी गई होनी चाहिए. minInt32Value
और maxInt32Value
के बीच की सभी वैल्यू इस्तेमाल की जा सकती हैं. maxInt32Value
से पता चलता है कि स्टीयरिंग व्हील सबसे ऊपरी
पोज़िशन में है. minInt32Value
से पता चलता है कि स्टीयरिंग व्हील सबसे कम
पोज़िशन में है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, सबसे कम और सबसे ज़्यादा पोज़िशन के बीच ट्रांज़िशन स्टेटस दिखाती हैं.
इस प्रॉपर्टी को रिलेटिव पोज़िशन की तय रेंज के तौर पर दिखाया जाता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_LIGHTS_STATE
स्टीयरिंग व्हील की लाइटों की स्थिति. इससे स्टीयरिंग व्हील लाइट की मौजूदा स्थिति के बारे में पता चलता है. यह STEERING_WHEEL_LIGHTS_SWITCH
से अलग है, जो लाइट को कंट्रोल करने वाले स्विच की स्थिति दिखाता है. इसलिए, हो सकता है कि STEERING_WHEEL_LIGHTS_STATE
,
STEERING_WHEEL_LIGHTS_SWITCH
की वैल्यू से मेल न खाए. उदाहरण के लिए,
और
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
STEERING_WHEEL_LIGHTS_STATE=ON
.
इस प्रॉपर्टी को सिर्फ़ तब लागू करना चाहिए, जब STEERING_WHEEL_LIGHTS_STATE
की वैल्यू
CABIN_LIGHTS_स्टेट की वैल्यू से अलग हो.
ग्लोबल एरिया आईडी (0) के लिए, VehicleAreaConfig#supportedEnumValues को तब तक तय किया जाना चाहिए, जब तक कि VehicleLightState की सभी वैल्यू काम न करती हों.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
Enum टाइप: VehicleLightState
यूनिट टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_LIGHTS_SWITCH
स्टीयरिंग व्हील की लाइटों का स्विच. स्टीयरिंग व्हील की लाइट को कंट्रोल करने वाले स्विच की स्थिति दिखाता है. यह से अलग है , जो स्टीयरिंग व्हील की लाइट की मौजूदा स्थिति दिखाता है. इसलिए, हो सकता है कि STEERING_WHEEL_LIGHTS_SWITCH
,
STEERING_WHEEL_LIGHTS_STATE
की वैल्यू से मेल न खाए. उदाहरण के लिए,
STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC
और
STEERING_WHEEL_LIGHTS_STATE=ON
.
इस प्रॉपर्टी को सिर्फ़ तब लागू करना चाहिए, जब STEERING_WHEEL_LIGHTS_SWITCH
की वैल्यू, CABIN_LIGHTS_SWITCH
की वैल्यू से अलग हो.
ग्लोबल एरिया आईडी (0) के लिए, VehicleAreaConfig#supportedEnumValues
की वैल्यू तय की जानी चाहिए. ऐसा तब तक करना होगा, जब तक VehicleLightSwitch की सभी वैल्यू काम नहीं करतीं.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: VehicleLightSwitch
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_LOCKED
स्टीयरिंग व्हील लॉक किया गया. अगर यह सही है, तो स्टीयरिंग व्हील की पोज़िशन लॉक हो जाती है और उसे बदला नहीं जा सकता.
यह प्रॉपर्टी VehiclePropertyAccess.READ_WRITE
के तौर पर बताई गई है, लेकिन OEM इसे
<covehiclepropertyaccess.read< code=""> के तौर पर लागू कर सकते हैं./p>
</covehiclepropertyaccess.read<>
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STEERING_WHEEL_THEFT_LOCK_ENABLED
स्टीयरिंग व्हील चोरी के लिए लॉक की सुविधा चालू है. अगर सही हो, तो स्टीयरिंग व्हील कुछ परिस्थितियों में चोरी से बचने के लिए अपने आप लॉक हो जाता है. इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
STORAGE_ENCRYPTION_BINDING_SEED
बाहरी एन्क्रिप्शन बाइंडिंग सीड. इस वैल्यू को लोकल कुंजी स्टोरेज एन्क्रिप्शन कुंजी के साथ मिलाया जाता है. इस प्रॉपर्टी में 16 बाइट होते हैं. साथ ही, यह IVI से अलग ईसीयू पर सेव रहती है. शुरुआत में, प्रॉपर्टी को AAOS सेट अप करता है, जो इसे CSRNG का इस्तेमाल करके जनरेट करता है. इसके बाद, AAOS अगले बूट पर प्रॉपर्टी को पढ़ता है. बाइंडिंग सीड को भरोसेमंद तरीके से सेव किया जा सकता है. अगर सीड की जानकारी मिट जाती है, तो आईवीआई को फ़ैक्ट्री रीसेट कर दिया जाता है.
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SUPPORT_CUSTOMIZE_VENDOR_PERMISSION
वेंडर प्रॉपर्टी के लिए, पसंद के मुताबिक अनुमतियां देने की सुविधा.
अगर VHAL, वेंडर की अनुमतियों को पसंद के मुताबिक बनाने की सुविधा के साथ काम करता है, तो इस प्रॉपर्टी को लागू करें.
VehiclePropConfig.configArray का इस्तेमाल, वेंडर प्रॉपर्टी और उन अनुमतियों को दिखाने के लिए किया जाता है जिन्हें इस वेंडर प्रॉपर्टी के लिए चुना गया है. अनुमति, VehicleVendorPermission में मौजूद किसी एक एनम में से एक होनी चाहिए.
configArray इस तरह सेट किया गया है, configArray[n]: propId : property ID
के लिए
वेंडर प्रॉपर्टी जहां configArray[n+1] VehicleVendorPermission में एक एनम है और प्रॉपर्टी की वैल्यू पढ़ने की अनुमति दिखाता है.
configArray[n+2], VehicleVendorPermission में एक क्रम है. यह प्रॉपर्टी की वैल्यू लिखने की अनुमति दिखाता है. उदाहरण के लिए:
configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }
अगर वेंडर प्रॉपर्टी इस कलेक्शन में नहीं हैं, तो उनके पास वेंडर के लिए डिफ़ॉल्ट अनुमति होती है. अगर वेंडर ने PERMISSION_NOT_ACCESSIBLE चुना है, तो Android के पास प्रॉपर्टी का ऐक्सेस नहीं होगा. उदाहरण में, Android, vendor_prop_2 के लिए कोई वैल्यू नहीं लिख सकता.
बदलाव मोड: STATIC
ऐक्सेस मोड: READ
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
SUPPORTED_PROPERTY_IDS
(अब काम नहीं करता) काम करने वाले सभी प्रॉपर्टी आईडी की सूची.
बदलाव मोड: STATIC
ऐक्सेस मोड: READ
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 14
SWITCH_USER
इस नीति से, Android पर फ़ोरग्राउंड वाले उपयोगकर्ता को स्विच करने के अनुरोध के बारे में जानकारी मिलती है.
इस प्रॉपर्टी का इस्तेमाल मुख्य रूप से Android सिस्टम करता है, ताकि एचएएल को यह जानकारी दी जा सके कि फ़ोरग्राउंड में मौजूद मौजूदा Android उपयोगकर्ता बदल रहा है. हालांकि, एचएएल इसका इस्तेमाल, Android सिस्टम से उपयोगकर्ताओं को बदलने का अनुरोध करने के लिए भी कर सकता है. जब Android अनुरोध करता है, तो वहजी के लिए वाहन PropValue सेट करता है. साथ ही, एचएएल को प्रॉपर्टी में बदलाव के इवेंट के साथ जवाब देना होता है. जब एचएएल अनुरोध करता है, तो उसे प्रॉपर्टी में बदलाव करने वाले इवेंट के ज़रिए भी ऐसा करना चाहिए. मुख्य अंतर यह है कि पहले मामले में अनुरोध आईडी सकारात्मक होता है और दूसरे मामले में यह नकारात्मक होता है. SwitchUserMessageType भी अलग-अलग होता है.
दोनों अनुरोधों का फ़ॉर्मैट, SwitchUserRequest से तय होता है. साथ ही, ज़रूरत पड़ने पर रिस्पॉन्स का फ़ॉर्मैट, SwitchUserResponse से तय होता है. एचएएल (या Android सिस्टम) को आगे कैसे बढ़ना चाहिए, यह मैसेज टाइप (जिसे SwitchUserMessageType पैरामीटर से तय किया गया है) पर निर्भर करता है, जैसा कि नीचे बताया गया है.LEGACY_ANDROID_SWITCH
यह बताने के लिए कि Android सिस्टम में कोई बदलाव होने वाला है, Android सिस्टम कॉल करता है. ऐसा तब होता है, जब बदलाव का अनुरोध इस तरह से किया गया हो कि वह एचएएल में शामिल न हो (उदाहरण के लिए, adb Shell am switch-user). यह अनुरोध मिलने के बाद, HAL अपने इंटरनल उपयोगकर्ता को स्विच कर सकता है. हालांकि, उसे Android सिस्टम को जवाब देने की ज़रूरत नहीं है. अगर किसी वजह से, इसके अंदरूनी उपयोगकर्ता को बदला नहीं जा सकता, तो उसेSWITCH_USER(type=ANDROID_POST_SWITCH)
कॉल के ठीक होने का इंतज़ार करना होगा. उदाहरण के लिए, वह पिछले उपयोगकर्ता पर वापस स्विच करने के लिएSWITCH_USER(type=VEHICLE_REQUEST)
जारी कर सकता है. आम तौर पर, यह कभी भी काम नहीं करना चाहिए. ऐसा इसलिए, क्योंकि वापस स्विच करने से असली उपयोगकर्ता को भ्रम हो सकता है.
उदाहरण के लिए, अगर सिस्टम में उपयोगकर्ताओं की संख्या (0, 10, 11) है और वह 0 से 11 पर स्विच कर रहा है (जहां उनमें से किसी के पास कोई खास फ़्लैग नहीं है), तो अनुरोध इस तरह होगा:
int32[0]
42 // अनुरोध आईडीint32[1]
1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCHint32[2]
11 // टारगेट यूज़र आईडीint32[3]
0 // उपयोगकर्ता के फ़्लैग टारगेट करें (कोई नहीं)int32[4]
10 // मौजूदा उपयोगकर्ताint32[5]
0 // मौजूदा उपयोगकर्ता के फ़्लैग (कोई नहीं)int32[6]
3 // उपयोगकर्ताओं की संख्याint32[7]
0 // उपयोगकर्ता #0 (Android यूज़र आईडी 0)int32[8]
0 // उपयोगकर्ता #0 के फ़्लैग (कोई नहीं)int32[9]
10 // उपयोगकर्ता #1 (Android यूज़र आईडी 10)int32[10]
0 // उपयोगकर्ता #1 के फ़्लैग (कोई नहीं)int32[11]
11 // उपयोगकर्ता #2 (Android उपयोगकर्ता आईडी 11)int32[12]
0 // उपयोगकर्ता #2 के फ़्लैग (कोई नहीं)
ANDROID_SWITCH
Android सिस्टम, Android उपयोगकर्ता के बदलने का संकेत देने के लिए इसे कॉल करता है. हालांकि, Android आगे बढ़ने से पहले, HAL के जवाब का इंतज़ार करता है. यह अनुरोध मिलने के बाद, एचएएल को अपने इंटरनल उपयोगकर्ता को स्विच करना होगा. इसके बाद, Android कोSWITCH_USER(type=VEHICLE_RESPONSE)
के साथ जवाब देना होगा. इससे यह पता चलता है कि उसके इंटरनल उपयोगकर्ता को स्विच किया गया है या नहीं (SwitchUserStatus एनम के ज़रिए). उदाहरण के लिए, अगर Android का इस्तेमाल करने वाले उपयोगकर्ताओं की संख्या (0, 10, 11) है और वह 10 से 11 पर स्विच कर रहा है (जहां उनमें से किसी के पास कोई खास फ़्लैग नहीं है), तो अनुरोध इस तरह होगा:int32[0]
42 // अनुरोध आईडीint32[1]
2 // SwitchUserMessageType::ANDROID_SWITCHint32[2]
11 // उपयोगकर्ता आईडी लक्षित करेंint32[3]
0 // उपयोगकर्ता के फ़्लैग टारगेट करें (कोई नहीं)int32[4]
10 // मौजूदा उपयोगकर्ताint32[5]
0 // मौजूदा उपयोगकर्ता के फ़्लैग (कोई नहीं)int32[6]
3 // उपयोगकर्ताओं की संख्याint32[7]
0 // नया उपयोगकर्ता (उपयोगकर्ता 0)int32[8]
1 // नए उपयोगकर्ता के लिए फ़्लैग (सिस्टम)int32[9]
10 // दूसरा उपयोगकर्ता (उपयोगकर्ता 10)int32[10]
0 // दूसरे उपयोगकर्ता के फ़्लैग (कोई नहीं)int32[11]
11 // तीसरा उपयोगकर्ता (उपयोगकर्ता 11)int32[12]
0 // तीसरे उपयोगकर्ता के फ़्लैग (कोई नहीं)
अगर अनुरोध पूरा होता है, तो एचएएल को यह प्रॉपर्टी अपडेट करनी होगी:
int32[0]
42 // अनुरोध आईडीint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
1 // status: SwitchUserStatus::SUCCESS
अगर अनुरोध पूरा नहीं हो पाता है, तो आपको कुछ ऐसा जवाब मिलेगा:
int32[0]
42 // अनुरोध आईडीint32[1]
3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSEint32[2]
2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"- OEM-से जुड़ी गड़बड़ी का मैसेज
VEHICLE_RESPONSE
एचएएल ने यह बताने के लिए कॉल किया है कि ANDROID_SWITCH टाइप के अनुरोध को जारी रखा जाना चाहिए या रद्द किया जाना चाहिए. ANDROID_SWITCH भी देखें.VEHICLE_REQUEST
एचएएल (HAL) इसे कॉल करता है, ताकि फ़ोरग्राउंड में मौजूद मौजूदा Android उपयोगकर्ता को स्विच करने का अनुरोध किया जा सके. यह सुविधा तब काम आती है, जब Android ने शुरुआत में एक उपयोगकर्ता के तौर पर की हो, लेकिन गाड़ी ने ड्राइवर की पहचान किसी अन्य उपयोगकर्ता के तौर पर की हो. उदाहरण के लिए, उपयोगकर्ता A ने उपयोगकर्ता B के की फ़ोब का इस्तेमाल करके कार को अनलॉक किया. INITIAL_USER_INFO अनुरोध ने उपयोगकर्ता B को लौटाया, लेकिन फिर चेहरे की पहचान करने वाले सबसबसिस्टम ने उपयोगकर्ता की पहचान A के रूप में की. एचएएल, प्रॉपर्टी में बदलाव होने के किसी इवेंट के ज़रिए यह अनुरोध करता है (नकारात्मक अनुरोध आईडी पास करके). Android सिस्टम का जवाब, ANDROID_POST_SWITCH कॉल जारी करना होता है, जिसमें वही अनुरोध आईडी होता है. उदाहरण के लिए, अगर फ़ोरग्राउंड में चल रहे मौजूदा Android वर्शन का वर्शन 10 है और HAL ने 11 पर स्विच करने के लिए कहा है, तो अनुरोध इस तरह होगा:int32[0]
-108 // अनुरोध आईडीint32[1]
4 // messageType: SwitchUserMessageType::VEHICLE_REQUESTint32[2]
11 // Android यूज़र आईडी
अगर अनुरोध पूरा हो जाता है और Android डिवाइस पर तीन उपयोगकर्ता (0, 10, और 11) हैं, तो रिस्पॉन्स इस तरह होगा:
int32[0]
-108 // अनुरोध आईडीint32[1]
5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCHint32[2]
11 // टारगेट यूज़र आईडीint32[3]
0 // उपयोगकर्ता आईडी फ़्लैग लक्षित करें (कोई नहीं)int32[4]
11 // मौजूदा उपयोगकर्ताint32[5]
0 // मौजूदा उपयोगकर्ता के फ़्लैग (कोई नहीं)int32[6]
3 // उपयोगकर्ताओं की संख्याint32[7]
0 // नया उपयोगकर्ता (उपयोगकर्ता 0)int32[8]
0 // पहले उपयोगकर्ता के फ़्लैग (कोई नहीं)int32[9]
10 // दूसरा उपयोगकर्ता (उपयोगकर्ता 10)int32[10]
4 // दूसरे उपयोगकर्ता के फ़्लैग (कोई नहीं)int32[11]
11 // तीसरा उपयोगकर्ता (उपयोगकर्ता 11)int32[12]
3 // तीसरे उपयोगकर्ता के फ़्लैग (कोई नहीं)
मौजूदा और टारगेट यूज़र आईडी एक ही हैं. अगर अनुरोध पूरा नहीं हो पाता है, तो दोनों में अंतर होगा. उदाहरण के लिए, टारगेट उपयोगकर्ता की संख्या 11 होगी और मौजूदा उपयोगकर्ता 10 रहेगा.
ANDROID_POST_SWITCH
उपयोगकर्ता को स्विच करने का अनुरोध करने के बाद, Android सिस्टम इसे कॉल करता है. इस प्रॉपर्टी को किसी भी तरह के स्विच अनुरोध (उदाहरण के लिए, >code>LEGACY_ANDROID_SWITCH, >code>ANDROID_SWITCH याVEHICLE_REQUEST
) के बाद कॉल किया जाता है. इसका इस्तेमाल यह पता लगाने के लिए किया जा सकता है कि अनुरोध पूरा हुआ या नहीं.- प्रोसेस पूरी होने के बाद, उसे कॉल किया जाता है. ऐसा तब होता है, जब Android उपयोगकर्ता अनलॉक स्थिति में हो. साथ ही, रिस्पॉन्स में मौजूदा और टारगेट उपयोगकर्ता आईडी की वैल्यू एक जैसी हो. यह किसी Android ऐप्लिकेशन में Intent.ACTION_USER_UNLOCKED पाने के बराबर है.
- ऐसा न होने पर, उसे तुरंत कॉल किया जाता है और रिस्पॉन्स के तौर पर मौजूदा और टारगेट उपयोगकर्ता आईडी की वैल्यू अलग-अलग होती हैं. ऐसा इसलिए होता है, क्योंकि मौजूदा उपयोगकर्ता ने टारगेट में बदलाव नहीं किया.
- अगर HAL के पिछले अनुरोध का जवाब देने या उपयोगकर्ता के अनलॉक होने से पहले, स्विच करने का नया अनुरोध किया जाता है, तो ANDROID_POST_SWITCH अनुरोध नहीं किया जाता. उदाहरण के लिए, हो सकता है कि ड्राइवर गलती से उस उपयोगकर्ता पर स्विच कर दे जिसके पास लॉक के क्रेडेंशियल हैं. इसके बाद, क्रेडेंशियल डालने से पहले, वह सही उपयोगकर्ता पर स्विच कर दे.
यह अनुरोध मिलने के बाद, एचएएल अपनी इंटरनल स्थिति अपडेट कर सकता है. हालांकि, उसे Android सिस्टम को जवाब देने की ज़रूरत नहीं है.
- अनुरोध करें.
INITIAL_USER_INFO
के मुताबिक, पहली N वैल्यू (जहां इंडेक्स 1 पर अनुरोध के हिसाब से वैल्यूSwitchUserMessageType::ANDROID_POST_SWITCH
है), इसके बाद टारगेट उपयोगकर्ता आईडी (उदाहरण के लिए, Android उपयोगकर्ता आईडी जिस पर स्विच करने का अनुरोध किया गया था) और उसके फ़्लैग (UserFlags के मुताबिक) के लिए दो और वैल्यू. - जवाब: कोई नहीं. उदाहरण के लिए,
VEHICLE_REQUEST
देखें
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
TIRE_PRESSURE
टायर का दबाव. हर टायर की पहचान, उसके areaConfig.areaId कॉन्फ़िगरेशन से की जाती है. OEM के सुझाए गए दबाव की सीमा को सेव करने के लिए, minFloatValue और maxFloatValue का इस्तेमाल किया जाता है. व्हीकल एरिया कॉन्फ़िगरेशन में, minFloatValue और maxFloatValue के लिए वैल्यू के बारे में बताना ज़रूरी है.
areaConfig डेटा में minFloatValue, टायर के सुझाए गए दबाव के निचले हिस्से को दिखाता है. areaConfig डेटा में मौजूद maxFloatValue, टायर के लिए सुझाए गए दबाव की ऊपरी सीमा दिखाता है. उदाहरण के लिए, इस areaConfig से पता चलता है कि left_front टायर के लिए, टायर में हवा का सुझाया गया दबाव 200.0kPa से 240.0kPa है.
.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }
बदलाव मोड: CONTINUOUS
ऐक्सेस मोड: READ
एनम टाइप: लागू नहीं
यूनिट टाइप: VehicleUnit:KILOPASCAL
रिलीज़: Android 13
TIRE_PRESSURE_DISPLAY_UNITS
डिसप्ले के लिए टायर के दबाव की इकाइयां. इससे पता चलता है कि उपयोगकर्ता को टायर का दबाव दिखाने के लिए, कार किन यूनिट का इस्तेमाल कर रही है. उदाहरण के लिए, पीएसआई, बार या किलोपास्कल. VehiclePropConfig.configArray का इस्तेमाल, काम करने वाली प्रेशर डिसप्ले यूनिट के बारे में बताने के लिए किया जाता है. वाहन की यूनिट में प्रेशर यूनिट की जानकारी दी गई है. उदाहरण के लिए, configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR
अगर TIRE_PRESSURE_DISPLAY_UNITS एट्रिब्यूट की वैल्यू अपडेट करने से, अन्य *_DISPLAY_UNITS प्रॉपर्टी की वैल्यू पर असर पड़ता है, तो उनकी वैल्यू भी अपडेट करनी होगी. साथ ही, AAOS फ़्रेमवर्क को भी इसकी जानकारी देनी होगी.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है. हालांकि, OEM इसे सिर्फ़ <covehiclepropertyaccess.read< code=""> के तौर पर लागू कर सकते हैं./p>
</covehiclepropertyaccess.read<>
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: VehicleUnit
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
TRACTION_CONTROL_ACTIVE
सही पर सेट करें, जब ट्रैक्शन कंट्रोल (टीसी) चालू हो और टीसी बंद होने पर 'गलत' पर रीसेट हो जाता है. इस प्रॉपर्टी को टीसी सिस्टम की रीयल-टाइम स्थिति के आधार पर, रुक-रुककर सेट (पल्स) किया जा सकता है.
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: READ
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
TRAILER_PRESENT
कार के ट्रेलर की स्थिति दिखाता है.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
Enum टाइप: TrailerState
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
TURN_SIGNAL_STATE
वाहनों के टर्न सिग्नल की स्थिति.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
Enum टाइप: VehicleTurnSignal
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
USER_IDENTIFICATION_ASSOCIATION
ऐसी प्रॉपर्टी जिसका इस्तेमाल, मौजूदा उपयोगकर्ता को वाहन की पहचान करने के खास तरीकों (जैसे कि कुंजी एफ़ओबी) से जोड़ने (या असोसिएशन के बारे में क्वेरी करने) के लिए किया जाता है.
यह उपयोगकर्ता मैनेजमेंट प्रॉपर्टी है. हालांकि, इसे इस्तेमाल करना ज़रूरी नहीं है. OEM, उपयोगकर्ता मैनेजमेंट की सुविधा को तय किए बिना भी, अब भी इसकी सुविधा दे सकता है. असल में, इस प्रॉपर्टी का इस्तेमाल, उपयोगकर्ता से जुड़े मुख्य फ़ंक्शन के बिना भी किया जा सकता है. इन फ़ंक्शन के बारे में INITIAL_USER_INFO में बताया गया है.
असोसिएशन की क्वेरी करने के लिए, Android सिस्टम को User-IdentificationGetRequest से बताए गए तरीके के मुताबिक प्रॉपर्टी मिल जाती है. इसके लिए, कदम के हिसाब से असोसिएशन के बारे में क्वेरी की जाने वाली VehiclePropValue को पास किया जाता है. एचएएल को तुरंत जवाब देना चाहिए. साथ ही, UserIdentificationResponse के साथ VehiclePropValue दिखाना चाहिए.
ध्यान दें कि सिस्टम को चालू करने के दौरान, उपयोगकर्ता की पहचान की गई थी. टेकहे VHAL लागू करने पर, गेट कॉल से नया असोसिएशन शुरू करने के बजाय, सिर्फ़ पहले से पहचाने गए असोसिएशन (जैसे, कार को अनलॉक करने के लिए इस्तेमाल की जाने वाली कुंजी एफ़ओबी) को लौटाना चाहिए.
टाइप को असोसिएट करने के लिए, Android सिस्टम प्रॉपर्टी सेट करता है. इसके लिए, वह VehiclePropValue को पास करता है. इसमें, UserIdentificationSetRequest के मुताबिक, सेट किए जा रहे असोसिएशन के टाइप और वैल्यू होती हैं.
इसके बाद, एचएएल, प्रॉपर्टी में हुए बदलाव के इवेंट का इस्तेमाल करता है. इस इवेंट की VehiclePropValue, UserIdentificationResponse से तय होती है. इससे अनुरोध के बाद, टाइप की मौजूदा स्थिति का पता चलता है.
उदाहरण के लिए, यह पता करने के लिए कि मौजूदा उपयोगकर्ता (10) उस एफ़ओबी से जुड़ा है जिसने कार को अनलॉक किया था और OEM ने जो कस्टम तरीका उपलब्ध कराया है, अनुरोध इस तरह का होगा:
int32[0]
42 // अनुरोध आईडीint32[1]
10 (Android यूज़र आईडी)int32[2]
0 (Android उपयोगकर्ता फ़्लैग)int32[3]
2 (क्वेरी किए गए टाइप की संख्या)int32[4]
1 (पहला टाइप जिसकी क्वेरी की गई, UserIdentificationAssociationType::KEY_FOB)int32[5]
101 (दूसरी तरह क्वेरी की गई, UserIdentificationAssociationType::CUSTOM_1)
अगर उपयोगकर्ता एफ़ओबी से जुड़ा है, लेकिन कस्टम मैकेनिज़्म से नहीं, तो रिस्पॉन्स यह होगा:
int32[0]
42 // अनुरोध आईडीint32[1]
2 (जवाब में असोसिएशन की संख्या)int32[2]
1 (पहला टाइप: UserIdentificationAssociationType::KEY_FOB)int32[3]
2 (पहली वैल्यू: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)int32[4]
101 (पहला टाइप: UserIdentificationAssociationType::CUSTOM_1)int32[5]
4 (दूसरी वैल्यू: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)
इसके बाद, उपयोगकर्ता को कस्टम मेकेनिज्म से जोड़ने के लिए, एक सेट अनुरोध किया जाता है:
int32[0]
43 // अनुरोध आईडीint32[1]
10 (Android यूज़र आईडी)int32[2]
0 (Android उपयोगकर्ता फ़्लैग)int32[3]
1 (सेट किए जा रहे असोसिएशन की संख्या)int32[4]
101 (पहला टाइप: UserIdentificationAssociationType::CUSTOM_1)
अनुरोध पूरा होने पर, जवाब इस तरह होगा:
int32[0]
43 // अनुरोध आईडीint32[1]
1 (रिस्पॉन्स में असोसिएशन की संख्या)int32[2]
101 (पहला टाइप: UserIdentificationAssociationType::CUSTOM_1)int32[3]
1 (पहली वैल्यू: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
सेट करने का अनुरोध, असोसिएशन जोड़ता है, लेकिन मौजूदा असोसिएशन नहीं हटाता. पिछले उदाहरण में, आखिरी स्थिति में दो असोसिएशन (FOB और CUSTOM_1) होंगे. अगर उपयोगकर्ता को सिर्फ़ CUSTOM_1 से जोड़ना है, न कि FOB से, तो अनुरोध इस तरह का होगा:
int32[0]
43 // अनुरोध आईडीint32[1]
10 (Android यूज़र आईडी)int32[2]
2 (सेट किए गए टाइप की संख्या)int32[3]
1 (पहला टाइप: UserIdentificationAssociationType::KEY_FOB)int32[4]
2 (पहली वैल्यू: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)int32[5]
101 (दूसरा टाइप: UserIdentificationAssociationType::CUSTOM_1)int32[6]
1 (दूसरी वैल्यू: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
VEHICLE_CURB_WEIGHT
वाहन का कुल वज़न किलोग्राम में दिखाता है. कुल वज़न, वाहन का कुल वज़न होता है. इसमें स्टैंडर्ड उपकरण और ऑपरेशन के लिए ज़रूरी सभी चीज़ें शामिल होती हैं. जैसे, मोटर ऑयल, ट्रांसमिशन ऑयल, ब्रेक फ़्लूइड, कूलेंट, एयर कंडीशनिंग रेफ़्रिजरेंट, और टैंक की नोमिनल क्षमता पर ईंधन का वज़न. इसमें यात्रियों या कार्गो का वज़न शामिल नहीं होता.
configArray[0] का इस्तेमाल, किलोग्राम में वाहन के कुल वज़न की जानकारी देने के लिए किया जाता है. वाहन का कुल वज़न, वाहन का वह ज़्यादा से ज़्यादा वज़न है जो मैन्युफ़ैक्चरर ने बताया है. इसमें वाहन का चेसिस, बॉडी, इंजन, इंजन, ईंधन, ऐक्सेसरी, ड्राइवर, यात्रियों, और कार्गो का वज़न शामिल है. हालांकि, इसमें किसी भी ट्रेलर का वज़न शामिल नहीं है.
बदलाव मोड: STATIC
ऐक्सेस मोड: READ
एनम टाइप: लागू नहीं
यूनिट टाइप: VehicleUnit:KILOGRAM
रिलीज़: Android 13
VEHICLE_IN_USE
यह बताता है कि वाहन का इस्तेमाल किया जा रहा है या नहीं. इस्तेमाल में होने का मतलब है कि कोई व्यक्ति मौजूद है और वह वाहन का इस्तेमाल करना चाहता है. इसका यह मतलब नहीं है कि वाहन में कोई व्यक्ति मौजूद है. उदाहरण के लिए, अगर कोई व्यक्ति, वाहन को रिमोट से अनलॉक करता है, तो वाहन का इस्तेमाल किया जा रहा माना जाता है. अगर इस प्रॉपर्टी का इस्तेमाल किया जा सकता है, तो:
- जब भी उपयोगकर्ता कार को चालू करता है या सिस्टम को उपयोगकर्ता के मौजूद होने का पता चलता है,
तो
VEHICLE_IN_USE
को 'सही है' पर सेट करना ज़रूरी है. जब भी उपयोगकर्ता वाहन को बंद करता है या सिस्टम को पता चलता है कि उपयोगकर्ता मौजूद नहीं है, तोVEHICLE_IN_USE
को 'गलत है' पर सेट किया जाना चाहिए. - अगर उपयोगकर्ता वाहन को बंद कर देता है या सिस्टम को पता चलता है कि उपयोगकर्ता मौजूद नहीं है, तो
VEHICLE_IN_USE
को 'गलत है' पर सेट किया जाना चाहिए. - अगर उपयोगकर्ता वाहन को चालू करता है या सिस्टम को पता चलता है कि उपयोगकर्ता मौजूद है, तो
VEHICLE_IN_USE
को 'सही है' पर सेट किया जाना चाहिए.
यह प्रॉपर्टी AP_POWER_BOOTUP_REASON
से इस मायने में अलग है कि
AP_POWER_BOOTUP_REASON
को सिस्टम के बूट होने के दौरान सिर्फ़ एक बार सेट किया जाता है. हालांकि, सिस्टम के बूट होने के दौरान, यह प्रॉपर्टी कई बार बदल सकती है. उदाहरण के लिए, फ़िलहाल किसी डिवाइस का इस्तेमाल नहीं किया जा रहा है. रिमोट टास्क को पूरा करने के लिए, सिस्टम को बूटअप करना. VEHICLE_IN_USE
गलत है. रिमोट टास्क के लागू होने के दौरान, उपयोगकर्ता गाड़ी में बैठता है और उसे चालू करता है.
VEHICLE_IN_USE
को 'सही' पर सेट किया गया हो. ड्राइविंग सेशन के बाद, उपयोगकर्ता गाड़ी को बंद कर देता है.
VEHICLE_IN_USE
'गलत है' पर सेट होता है.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 14
VEHICLE_MAP_SERVICE
वाहन में मैप इस्तेमाल करने की सुविधा (वीएमएस) का मैसेज. यह प्रॉपर्टी, वीएमएस मैसेज भेजने के लिए MIXED डेटा का इस्तेमाल करती है.
इसके कॉन्टेंट की व्याख्या इस तरह की जानी चाहिए. VmsMessageIntegerValuesInde
में तय किए गए इंडेक्स का इस्तेमाल, int32Values से पढ़ने के लिए किया जाता है. बाइट, VMS प्रोटोकॉल में बताए गए क्रम में लगाए गए वीएमएस मैसेज होते हैं. ये फ़्रेमवर्क के लिए साफ़ तौर पर नहीं दिखते. IVehicle#get हमेशा StatusCode::NOT_AVAILABLE
दिखाना चाहिए.
बदलाव मोड: ON_CHANGEREAD_WRITE
ऐक्सेस मोड: READ_WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
VEHICLE_Speed_DISPLAY_UNITS
डिसप्ले के लिए स्पीड यूनिट. इससे उपयोगकर्ता को स्पीड दिखाने के लिए इस्तेमाल की जाने वाली इकाइयों के टाइप के बारे में पता चलता है. जैसे, m/s, km/h या mph. VehiclePropConfig.configArray से पता चलता है कि रफ़्तार की जानकारी दिखाने के लिए, कौनसी यूनिट इस्तेमाल की जा सकती हैं. दबाव की इकाइयों की जानकारी, VehicleUnit में दी जाती है. उदाहरण के लिए:
.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
अगर VEHICLE_SPEED_DISPLAY_UNITS
को अपडेट करने से, अन्य
*_DISPLAY_UNITS properties
की वैल्यू पर असर पड़ता है, तो उन वैल्यू को अपडेट करना होगा और AAOS फ़्रेमवर्क को इसकी सूचना देनी होगी.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
VHAL_HEARTBEAT
इस एट्रिब्यूट की मदद से, उस इवेंट की जानकारी दी जाती है जिसे VHAL, Car Watchdog को हेटबीट के तौर पर सिग्नल भेजता है. अगर VHAL इस प्रॉपर्टी के साथ काम करता है, तो VHAL को हर तीन सेकंड में इस प्रॉपर्टी में सिस्टम के अपटाइम की जानकारी लिखनी चाहिए. Car Watchdog इस प्रॉपर्टी की सदस्यता लेता है और यह जांच करता है कि प्रॉपर्टी हर तीन सेकंड में अपडेट होती है या नहीं. तीन सेकंड के बफ़र टाइम के साथ, कार वॉचडॉग, पिछले दिल की धड़कन से लेकर छह सेकंड तक, दिल की धड़कन के सिग्नल का इंतज़ार करता है. अगर ऐसा नहीं होता है, तो कार वॉचडॉग को वह वीएचएएल खराब मानता है और उसे बंद कर देता है. अगर यह प्रॉपर्टी VHAL के साथ काम नहीं करती है, तो Car Watchdog, VHAL के स्टेटस की जांच नहीं करता.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
Enum टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
वॉचडॉग_एलाइव
यह एक ऐसा इवेंट तय करता है जिसे कार वॉचडॉग अपडेट करता है, ताकि यह पता चल सके कि वह चालू है. कार वॉचडॉग, हर तीन सेकंड में इस प्रॉपर्टी को सिस्टम के अपटाइम के तौर पर मिलीसेकंड में सेट करता है. बूट होने के दौरान, अपडेट होने में ज़्यादा समय लग सकता है.
बदलाव मोड: ON_CHANGE
ऐक्सेस मोड: WRITE
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
WATCHDOG_TERMINATED_PROCESS
Car Watchdog की मदद से बंद की गई प्रोसेस और बंद करने की वजह के बारे में बताता है.
int32Values[0] 1 // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: WRITE
Enum टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
WHEEL_TICK
रिपोर्ट में व्हील के टीक दिखते हैं. वेक्टर का पहला एलिमेंट, रीसेट की गई गिनती होती है. रीसेट करने से यह पता चलता है कि पिछली टिक काउंट की तुलना, पहले और आने वाले समय में नहीं की जा सकती. टिक की गिनती में कोई रुकावट आई है.
अगले चार एलिमेंट, अलग-अलग व्हील के लिए इस क्रम में सही का निशान दिखाते हैं:
- आगे बाईं ओर
- आगे दाईं ओर
- पीछे दाईं ओर
- पीछे बाईं ओर
सभी टिक की संख्या एक साथ जुड़ी होती है. वाहन के आगे बढ़ने पर टिक की संख्या बढ़ती है और वाहन के पीछे जाने पर, टिक की संख्या कम होती है. गाड़ी शुरू होने पर, टिक को 0 पर रीसेट किया जाना चाहिए.
int64Values[0]
गिनती रीसेट करनाint64Values[1]
आगे वाला बायां टिकint64Values[2]
आगे दाईं ओर वाला टिकint64Values[3]
पीछे दाईं ओर मौजूद टिकint64Values[4]
पीछे बाईं ओर टिक
configArray
का इस्तेमाल, हर पहिये के टिक के लिए माइक्रोमीटर की वैल्यू और यह बताने के लिए किया जाता है कि कौनसे पहिये काम करते हैं. configArray को इस तरह सेट किया जाता है:
configArray[0], bits [0:3] Supported wheels
enum Wheel का इस्तेमाल करता है. उदाहरण के लिए, अगर सभी व्हील पर कार काम करती है, तो:
configArray[0]
VehicleAreaWheel::LEFT_FRONT | VehicleAreaWheel::RIGHT_FRONT | VehicleAreaWheel::LEFT_REAR | VehicleAreaWheel::RIGHT_REARconfigArray[1]
सामने वाले बाएं पहिये के हर टिक के लिए माइक्रोमीटरconfigArray[2]
सामने के दाएं पहिये के हर टिक के लिए माइक्रोमीटरconfigArray[3]
पीछे के दाएं पहिये के हर टिक के लिए माइक्रोमीटरconfigArray[4]
पीछे के बाएं पहिये के हर टिक के लिए माइक्रोमीटर.
अगर किसी व्हील का इस्तेमाल नहीं किया जा सकता, तो उसकी वैल्यू हमेशा 0 पर सेट होनी चाहिए.
VehiclePropValue.timestamp
भरना ज़रूरी है.
बदलाव मोड: CONTINUOUS
ऐक्सेस मोड: READ
एनम टाइप: लागू नहीं
यूनिट टाइप: लागू नहीं
रिलीज़: Android 13
WINDOW_LOCK
विंडो चाइल्ड लॉक. 'सही है' का मतलब है कि विंडो को चाइल्ड-लॉक किया गया है. इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर बताया गया है, लेकिन ओईएम इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
Enum टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
WINDOW_MOVE
विंडो को एक जगह से दूसरी जगह ले जाना. हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं. maxInt32Value
से पता चलता है कि विंडो, प्लेन में सबसे तेज़ी से खुल रही है/प्लेन से बाहर की दिशा में सबसे तेज़ी से बंद हो रही है. minInt32Value
से पता चलता है कि विंडो, प्लेन में बंद हो रही है/प्लेन से बाहर की तरफ़ सबसे तेज़ रफ़्तार से खुल रही है.
बड़ी निरपेक्ष वैल्यू, चाहे वे पॉज़िटिव हों या नेगेटिव, गति की तेज़ी का संकेत देती हैं. जब विंडो, पोज़िशन के लिए तय की गई सीमा तक पहुंच जाती है, तो वैल्यू 0 पर रीसेट होनी चाहिए. अगर WINDOW_MOVE
की वैल्यू 0 है, तो इसका मतलब है कि कोई बदलाव नहीं हो रहा है. इस प्रॉपर्टी को, गति की तय सीमा के हिसाब से दिखाया जाता है.
ऐसी विंडो के लिए जो प्लेन के बाहर खुल सकती है (सनरूफ़ का वेंट मोड), यह पैरामीटर इस तरह काम करता है. अगर:
- सनरूफ़ खुली है:
Max
सनरूफ़ को और खोलें. पूरी तरह खुलने पर, यह अपने-आप बंद हो जाएगी.Min
सनरूफ़ बंद करें. सनरूफ़ बंद होने पर, यह सुविधा अपने-आप बंद हो जाएगी.
- वेंट खुला है:
Max
वेंट बंद होने पर, वेंट बंद होने पर यह अपने-आप बंद हो जाता है.Min
वेंट को थोड़ा और खोलने के लिए, वेंट के पूरी तरह से खुलने पर उसे अपने-आप बंद कर दें.
- सनरूफ़ बंद है:
Max
सनरूफ़ खोलें और पूरी तरह खुलने पर, अपने-आप बंद होने की सुविधा.Min
वेंट खोलें, वेंट पूरी तरह खुलने पर अपने-आप बंद हो जाए.
यह प्रॉपर्टी VehiclePropertyAccess.READ_WRITE
के तौर पर बताई गई है. हालांकि, ओईएम
इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
Windows_POS
विंडो की पोज़िशन. हर VehicleAreaConfig में maxInt32Value
और minInt32Value
की वैल्यू तय होनी चाहिए. minInt32Value
और
maxInt32Value
के बीच के सभी पूर्णांक इस्तेमाल किए जा सकते हैं. minInt32Value
से पता चलता है कि विंडो
बंद है या पूरी तरह से खुली हुई है. अगर विंडो, प्लेन के बाहर नहीं खुल सकती, तो
minInt32Value
, विंडो के पूरी तरह से बंद होने पर उसकी पोज़िशन होती है. यह 0 होनी चाहिए. अगर विंडो, प्लैन के बाहर खुल सकती है, तो minInt32Value
से पता चलता है कि विंडो, प्लैन के बाहर अपनी जगह पर पूरी तरह से खुली हुई है. यह एक नेगेटिव वैल्यू है. ज़्यादा जानकारी के लिए, यह उदाहरण देखें. maxInt32Value
से पता चलता है कि विंडो पूरी तरह से खुली है.
minInt32Value
और maxInt32Value
के बीच की वैल्यू, प्लेन के बाहर पूरी तरह से बंद/पूरी तरह से खुली स्थिति और पूरी तरह से खुली स्थिति के बीच ट्रांज़िशन की स्थिति दिखाती हैं. यह प्रॉपर्टी किसी खास इकाई में नहीं होती, बल्कि रिलेटिव पोज़िशन की तय रेंज में होती है. उदाहरण के लिए, ऐसी विंडो के लिए प्रॉपर्टी इस तरह काम करनी चाहिए जो प्लैन से बाहर निकल सकती है: ऐसी विंडो के लिए जो प्लैन से बाहर निकल सकती है (सनरूफ़ का वेंट मोड), यह पैरामीटर नेगेटिव वैल्यू के साथ इस तरह काम करता है:
Max
Sunroof की सुविधा पूरी तरह से खुली है (सनरूफ़ के बंद होने पर 0).Min
सनरूफ़ वेंट पूरी तरह से खुला है (सनरूफ़ बंद होने पर 0).
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: लागू नहीं
इकाई टाइप: लागू नहीं
रिलीज़: Android 13
WINDSHIELD_WIPERS_PERIOD
विंडशील्ड वाइपर पीरियड (मिलीसेकंड). यह विंडशील्ड वाइपर के एक पूरे साइकल के लिए, मिलीसेकंड में तुरंत होने वाली समयावधि दिखाता है. पूरे साइकल का मतलब है कि वाइपर, एक आखिरी पोज़िशन से शुरू होकर, आखिरी पोज़िशन पर वापस आ जाए. जब इंटरमिटेंट वाइपर सेटिंग चुनी जाती है, तो इंटरमिटेंट वाइपिंग के रोके जाने के दौरान, इस प्रॉपर्टी की वैल्यू 0 पर सेट होनी चाहिए. VehicleAreaConfig में
maxInt32Value
और minInt32Value
तय करना ज़रूरी है.
हर क्षेत्र के आईडी के लिए maxInt32Value
में, वाइपर की सबसे ज़्यादा अवधि की जानकारी होनी चाहिए. हर एरिया आईडी के लिए,
minInt32Value
को 0 पर सेट किया जाना चाहिए.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
Enum टाइप: लागू नहीं
यूनिट टाइप: VehicleUnit:MILLI_SECS
रिलीज़: Android 14
WINDSHIELD_WIPERS_STATE
विंडशील्ड वाइपर की स्थिति. विंडशील्ड वाइपर की मौजूदा स्थिति दिखाता है. ऐसा हो सकता है कि
WINDSHIELD_WIPERS_STATE
की वैल्यू,
WINDSHIELD_WIPERS_SWITCH
की वैल्यू से मेल न खाए. उदाहरण के लिए, WINDSHIELD_WIPERS_STATE: ON
और
WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO
अगर WINDSHIELD_WIPERS_STATE: ON
और WINDSHIELD_WIPERS_PERIOD
को लागू किया जाता है, तो WINDSHIELD_WIPERS_PERIOD
में वाइपर के एक पूरे साइकल की समयावधि दिखनी चाहिए.
काम करने वाले हर क्षेत्र के आईडी के लिए, VehicleAreaConfig#supportedEnumValues
कलेक्शन को तय करना ज़रूरी है. ऐसा तब तक करना होगा, जब तक WindshieldWipersState
में सभी राज्यों के लिए काम नहीं करता. इसमें OTHER भी शामिल है, जिसका सुझाव नहीं दिया जाता.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ
Enum टाइप: WindshieldWipersState
यूनिट टाइप: लागू नहीं
रिलीज़: Android 14
WINDSHIELD_WIPERS_SWITCH
विंडशील्ड वाइपर का स्विच. विंडशील्ड वाइपर को कंट्रोल करने वाले स्विच की स्थिति दिखाता है. ऐसा हो सकता है कि WINDSHIELD_WIPERS_SWITCH
की वैल्यू,
WINDSHIELD_WIPERS_STATE
की वैल्यू से मेल न खाए. उदाहरण के लिए, WINDSHIELD_WIPERS_SWITCH: AUTO
और
WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON
काम करने वाले हर इलाके के आईडी के लिए,
VehicleAreaConfig#supportedEnumValues
कलेक्शन को तब तक तय किया जाना चाहिए, जब तक कि WindshieldWipersSwitch
में सभी राज्यों के लिए काम न करता हो. इसमें OTHER भी शामिल है, जिसका सुझाव नहीं दिया जाता.
इस प्रॉपर्टी को VehiclePropertyAccess.READ_WRITE
के तौर पर परिभाषित किया गया है, लेकिन OEM इसे सिर्फ़ VehiclePropertyAccess.READ
के तौर पर लागू कर सकते हैं. अगर इस प्रॉपर्टी को
VehiclePropertyAccess.READ_WRITE
के तौर पर लागू किया गया है और OTHER स्थिति
VehicleAreaConfig#supportedEnumValues
कलेक्शन में दी गई है, तो लिखने के लिए OTHER वैल्यू
इस्तेमाल नहीं की जा सकती. यह सिर्फ़ पढ़ने के लिए इस्तेमाल की जा सकने वाली वैल्यू है.
मोड बदलें: ON_CHANGE
ऐक्सेस मोड: READ_WRITE
/READ
एनम टाइप: WindshieldWipersSwitch
इकाई टाइप: लागू नहीं
रिलीज़: Android 14