Propiedades del sistema compatibles

En esta página, se enumeran las propiedades del sistema compatibles con la VHAL. Propiedades compatibles con VHAL debe ser una propiedad del sistema de la siguiente lista o una propiedad del proveedor. En Android 14 y superior, las definiciones de propiedades se definen en hardware/interfaces/automotive/vehicle/aidl_property/android/hardware/automotive/vehicle/VehicleProperty.aidl

La definición de la propiedad se define en la interfaz del AIDL. android.hardware.automotive.vehicle.property, que es independiente del VHAL interfaz de programación de aplicaciones (android.hardware.automotive.vehicle) Implementaciones de VHAL y VHAL los clientes deben depender de ambas interfaces.

Modos de acceso generados automáticamente y modos de cambio

En Android 14 y versiones posteriores, para admitir implementaciones de VHAL, proporcionamos Encabezado de C++ archivos y Archivos de clase de Java con el modo de cambio o el modo de acceso permitido para propiedades del sistema. Implementaciones de VHAL del proveedor puedes usarlas para asegurarte de que la configuración de la propiedad cumpla con la especificación.

De la A a la 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 WRITEs 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 WRITEs 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 WRITEs 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 value
• int32Values[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 value
• int32Values[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 care
• int32[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 - on
• int32[1] Bounds - left
• int32[2] Bounds - top
• int32[3] Bounds - right
• int32[4] Bounds - bottom
• int32[5] Inset - left
• int32[6] Inset - top
• int32[7] Inset - right
• int32[8] Inset - bottom
• int32[9] Type of ClusterUI in the fullscreen or main screen. 0 indicates ClusterHome. 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 indicates ClusterHome, 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 id
• int32[1] 11 // Android id of the created user
• int32[2] 6 // Android flags (ephemeral guest) of the created user
• int32[3] 10 // current user
• int32[4] 0 // current user flags (none)
• int32[5] 3 // number of users
• int32[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 id
• int32[1] 1 // CreateUserStatus::SUCCESS

But if it fails:

• int32[0] 42 // request id
• int32[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 a G

ESTADO_DE_LA_TARJETA_DE_EL_ECTRONIC_TOLL_COLLECTION_

Estado de la tarjeta de cobro de peaje electrónico Esta propiedad indica el estado de la tarjeta ETC en este vehículo. Si la unidad principal detecta una tarjeta ETC conectada al vehículo, ELECTRONIC_TOLL_COLLECTION_CARD_TYPE muestra el estado de la tarjeta. De lo contrario, esta propiedad debe ser UNAVAILABLE.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: ElectronicTollCollectionCardStatus
Tipo de unidad: N/A
Versión: Android 13

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

Tipo de tarjeta de peaje electrónico (ETC). Esta propiedad indica el tipo de tarjeta ETC que tiene este vehículo. Si la consola central reconoce una tarjeta ETC adjunta al vehículo, esta propiedad debería devolver el tipo de tarjeta adjunta. De lo contrario, esta propiedad debe ser UNAVAILABLE.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: ElectronicTollCollectionCardType
Tipo de unidad: N/A
Versión: Android 13

EMERGENCY_LANE_KEEP_ASSIST_HABILITADO

Habilita o inhabilita la función de asistencia para el carril de emergencia (ELKA). Establece el valor en verdadero para habilitar ELKA y en falso para inhabilitarlo. Cuando el sistema ELKA está habilitado, el sistema ADAS del vehículo debe estar encendido y supervisar si el conductor realiza cambios de carril peligrosos. Cuando se detecta una maniobra insegura, ELKA alerta al conductor y aplica correcciones de dirección para mantener el vehículo en su carril original. En general, EMERGENCY_LANE_KEEP_ASSIST_ENABLED siempre debe mostrar verdadero o falso. Si la función no está disponible debido a algún estado temporal, como que la velocidad del vehículo es demasiado baja, esa información se debe transmitir a través de los valores de ErrorState en la propiedad EMERGENCY_LANE_KEEP_ASSIST_STATE. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

EMERGENCY_LANE_KEEP_ASSIST_STATE

Estado de la Asistencia de mantenimiento de carril de emergencia (ELKA). Devuelve el estado actual de ELKA. Por lo general, esta propiedad debe mostrar un estado válido definido en EmergencyLaneKeepAssistState o ErrorState. Por ejemplo, si la función no está disponible debido a algún estado temporal, esa información se debe transmitir a través de ErrorState. Para el ID de área global (0), se debe definir el array VehicleAreaConfig#supportedEnumValues, a menos que se admitan todos los estados de EmergencyLaneKeepAssistState (incluido OTRO, que no se recomienda) y ErrorState.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: EmergencyLaneKeepAssistState/ErrorState
Tipo de unidad: N/A
Versión: Android 14

ENGINE_COOLANT_TEMP

Temperatura del refrigerante del motor.

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:CELSIUS
Versión: Android 13

ENGINE_IDLE_AUTO_STOP_HABILITADO

Representa la función de detención automática del motor en inactivo. Si es verdadero, el vehículo puede apagar el motor automáticamente cuando no sea necesario y, luego, reiniciarlo automáticamente cuando sea necesario. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

ENGINE_OIL_LEVEL

Nivel de aceite del motor.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: VehicleOilLevel
Tipo de unidad: N/A
Versión: Android 13

ENGINE_OIL_TEMP

Temperatura del aceite del motor.

Cambiar modo: CONTINUOUS
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:CELSIUS
Versión: Android 13

ENGINE_RPM

Revoluciones del motor por minuto (RPM).

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:RPM
Versión: Android 13

ENV_OUTSIDE_TEMPERATURE

Temperatura exterior. Esta propiedad debe comunicar la lectura de la temperatura del entorno fuera del vehículo. Si hay varios sensores para medir la temperatura exterior, esta propiedad se debe propagar con la media o un promedio ponderado significativo de las lecturas que mejor representen la temperatura del entorno exterior.

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:CELSIUS
Versión: Android 13

EV_BATTERY_DISPLAY_UNITS

Unidades de batería de VE para la pantalla Indica qué unidades usa el vehículo para mostrarle al usuario la información de la batería del VE. Por ejemplo, vatios-hora (Wh), kilovatios-hora (kWh) o amperios-hora (Ah). VehiclePropConfig.configArray se utiliza para indicar la energía eléctrica admitida. unidades. Las unidades de energía eléctrica se definen en VehicleUnit. Por ejemplo:

  configArray[0] = WATT_HOUR configArray[1] = AMPERE_HOURS configArray[2] = KILOWATT_HOUR

Si la actualización de EV_BATTERY_DISPLAY_UNITS afecta los valores de otras propiedades *_DISPLAY_UNITS, sus valores también deben actualizarse y comunicarse al framework de AAOS. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleUnit
Tipo de unidad: N/A
Versión: Android 13

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

Tasa de carga instantánea del VE en milivatios. Un valor positivo indica que la batería se está cargando. Un valor negativo indica que la batería se está descargando.

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:MW
Versión: Android 13

EV_BATTERY_LEVEL

Muestra el nivel de batería actual, ya sea de VE o híbrido. Este valor no superará EV_CURRENT_BATTERY_CAPACITY. Para calcular el porcentaje de batería, usa (EV_BATTERY_LEVEL, EV_CURRENT_BATTERY_CAPACITY)*100.

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:WH
Versión: Android 13

EV_BRAKE_REGENERATION_LEVEL

Nivel de frenado regenerativo de un vehículo electrónico. Se deben definir maxInt32Value y minInt32Value en VehicleAreaConfig. Se deben admitir todos los valores entre minInt32Value y maxInt32Value. minInt32Value debe ser 0. maxInt32Value indica la configuración de la cantidad máxima de energía que se regenera a partir del frenado. El elemento minInt32Value indica la configuración de no frenado regenerativo. Esta propiedad es una forma más detallada de EV_REGENERATIVE_BRAKING_STATE. Permite que el usuario establezca un nivel más específico de frenado regenerativo si los estados en EvRegenerativeBrakingState no son lo suficientemente detallados para el OEM. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

EV_CHARGE_CURRENT_DRAW_LIMIT

Indica el umbral máximo de consumo de corriente para la carga que estableció el usuario. EvChargeState::configArray[0] se usa para especificar la corriente máxima que permite el vehículo en amperios. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITEREAD
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:AMPERE
Versión: Android 13

EV_CHARGE_PERCENT_LIMIT

Indica el umbral de porcentaje de carga máximo que estableció el usuario. Indica el umbral de porcentaje de carga máximo que estableció el usuario. Muestra un valor flotante de 0 a 100. configArray se usa para especificar los valores válidos. Por ejemplo, si el vehículo admite los siguientes valores de límite de porcentaje de carga: [20, 40, 60, 80, 100], el configArray debe ser {20, 40, 60, 80, 100}. Si el configArray está vacío, todos los valores de 0 a 100 deben ser válidos. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE,, READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

VE_CHARGE_PORT_CONNECTED

Se conectó el puerto de carga del VE. Si el vehículo tiene varios puertos de carga, esta propiedad debe mostrar el valor true cuando alguno de los puertos de carga está conectado.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

EV_CHARGE_PORT_OPEN

Puerto de carga de VE abierto. Si el vehículo tiene varios puertos de carga, esta propiedad debe mostrar el valor true si alguno de ellos está abierto. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITEREAD
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

EV_CHARGE_STATE

Estado de carga del vehículo Devuelve el estado de carga actual del vehículo. Si el vehículo tiene un porcentaje de carga objetivo distinto de 100, esta propiedad debe mostrar EvChargeState::STATE_FULLY_CHARGED cuando el nivel de carga de la batería alcance el nivel objetivo. Consulta EvChargeState::EV_CHARGE_PERCENT_LIMIT para obtener más contexto.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: EvChargeState
Tipo de unidad: N/A
Versión: Android 13

EV_CHARGE_SWITCH

Iniciar o detener la carga de la batería del VE Es el parámetro de configuración que desea el usuario. Configurar esta propiedad como verdadero inicia la carga de la batería y falso para detener la carga. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITEREAD
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

EV_CHARGE_TIME_REMAINING

Es el tiempo de carga restante estimado en segundos. Muestra 0 si el vehículo no se está cargando.

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:SECS
Versión: Android 13

EV_CURRENT_BATTERY_CAPACITY

Capacidad actual de la batería utilizable para VE o vehículo híbrido. Muestra el valor real de la capacidad de la batería, cuando es un vehículo eléctrico o híbrido. Esta propiedad captura la capacidad de batería utilizable en tiempo real teniendo en cuenta factores como el envejecimiento de la batería y la dependencia de la temperatura. Este valor puede diferir de INFO_EV_BATTERY_CAPACITY porque INFO_EV_BATTERY_CAPACITY muestra la capacidad nominal de la batería desde que el vehículo era nuevo.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:WH
Versión: Android 14

EV_REGENERATIVE_BRAKING_STATE

Frenado regenerativo o configuración de conducción con un solo pedal del vehículo Muestra el parámetro de configuración actual asociado con la configuración de frenado regenerativo del vehículo. Si el OEM requiere más opciones de configuración que las que se proporcionan en EvRegenerativeBrakingState, se puede usar la propiedad EV_BRAKE_REGENERATION_LEVEL en su lugar, lo que proporciona información más detallada.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: EvRegenerativeBrakingState
Tipo de unidad: N/A
Versión: Android 13

EV_STOPPING_MODE

Representa la propiedad del modo de detención actual del vehículo. Para el ID de área global (0), se debe definir VehicleAreaConfig#supportedEnumValues, a menos que se admitan todos los valores de enum de EvStoppingMode. Es posible que la enumeración EvStoppingMode se extienda para incluir más estados en el futuro. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs tienen la opción de implementarla solo como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: EvStoppingMode
Tipo de unidad: N/A
Versión: Android 14

EVS_SERVICE_REQUEST

Habilita y solicita un servicio de EVS. La propiedad proporciona una forma de activar los servicios de EVS. El VHAL debe usar esta propiedad para solicitarle a Android que inicie o detenga el servicio de EVS.

• int32Values[0] Tipo de servicio de EVS. El valor debe ser una enumeración en EvsServiceType.
• int32Values[1] Estado del servicio de EVS. El valor debe ser una de las enums en EvsServiceState.

Por ejemplo, para habilitar el servicio de EVS de la vista trasera, Android puede establecer el valor de la propiedad de la siguiente manera:

[EvsServiceType::REAR_VIEW, EvsServiceState::ON]

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

EXTERNAL_CAR_TIME

Es la sugerencia de fecha y hora actual para la cr, codificada como hora de época (en milisegundos). Este valor denota la cantidad de milisegundos que transcurrieron desde el 1/1/1970 UTC. Esta propiedad indica un cambio de CarTime a Android. Si la propiedad es compatible, VHAL debe informar el CarTime actual más preciso cuando se lee esta propiedad y publicar un cambio en esta propiedad cuando cambie el valor de CarTime.

Se debe publicar un evento de cambio para esta propiedad cuando CarTime cambie por cualquier motivo que no sea el transcurso natural del tiempo (un delta de tiempo inferior a 500 ms no debe activar un evento de cambio). Android leerá esta propiedad y se suscribirá a ella para recuperar la hora de VHAL. Esto puede ser útil para sincronizar la hora de Android con otros sistemas del vehículo (reloj del tablero). int64Values[0] = hora de época proporcionada (en milisegundos). Cada vez que se recibe un valor nuevo para la propiedad, AAOS crea y envía una sugerencia de hora externa al servicio TimeDetectorService.

Si otras fuentes no tienen una prioridad más alta, Android la usará para establecer la hora del sistema. Para obtener información sobre cómo ajustar las prioridades de la fuente de tiempo y cómo se manejan las sugerencias de hora (incluida la forma en que Android controla el jitter, la deriva y la resolución mínima), consulta la documentación del servicio de detector de tiempo.

drift = elapsedTime - PropValue.timestamp effectiveTime = PropValue.value.int64Values[0] + drift

Recomendamos que no se use esta propiedad para recuperar la hora de las ECU con protocolos (como GNSS, NTP y telefonía). Dado que Android ya admite estos protocolos, te recomendamos que uses sistemas Android en lugar de conectarlos a través de VHAL con esta propiedad.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:MILLI_SECS
Versión: Android 13

FOG_LIGHTS_STATE

Estado de luz antiniebla. Muestra el estado actual de las luces antiniebla. Si ocurre lo siguiente:

• El vehículo tiene faros antiniebla delantero y trasero. Las luces antiniebla delanteras y traseras solo se pueden controlar juntas. Se debe implementar FOG_LIGHTS_STATE. No se deben implementar FRONT_FOG_LIGHTS_STATE ni REAR_FOG_LIGHTS_STATE.
• Las luces antiniebla delanteras y traseras solo se pueden controlar de forma independiente. No se debe implementar FOG_LIGHTS_STATE, y se deben implementar FRONT_FOG_LIGHTS_STATE y REAR_FOG_LIGHTS_STATE.
• El vehículo solo tiene luces antiniebla delanteras. Solo se debe implementar una de FOG_LIGHTS_STATE o FRONT_FOG_LIGHTS_STATE (no ambas). No se debe implementar REAR_FOG_LIGHTS_STATE.
• El vehículo solo tiene luces antiniebla traseras. Solo se debe implementar una de las siguientes propiedades: FOG_LIGHTS_STATE o REAR_FOG_LIGHTS_STATE (no ambas). No se debe implementar FRONT_FOG_LIGHTS_STATE.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

FOG_LIGHTS_SWITCH

Interruptor de luces antiniebla. Es el parámetro de configuración que desea el usuario. Si ocurre lo siguiente:

• El vehículo tiene luces antiniebla delanteras y traseras. Si las luces antiniebla delanteras y traseras solo se pueden controlar juntas, se debe implementar FOG_LIGHTS_SWITCH. FRONT_FOG_LIGHTS_SWITCH y REAR_FOG_LIGHTS_SWITCH no deben implementarse.
• Los faros antiniebla delantero y trasero solo se pueden controlar de forma independiente. FOG_LIGHTS_SWITCH no se debe implementar. Se deben implementar FRONT_FOG_LIGHTS_SWITCH y REAR_FOG_LIGHTS_SWITCH.
• El vehículo solo tiene faros antiniebla delanteros. Solo se debe implementar uno de FOG_LIGHTS_SWITCH o FRONT_FOG_LIGHTS_SWITCH (no ambos). No se debe implementar REAR_FOG_LIGHTS_SWITCH.
• El vehículo solo tiene luces antiniebla traseras. Solo se debe implementar una de FOG_LIGHTS_SWITCH o REAR_FOG_LIGHTS_SWITCH (y no ambas). No se debe implementar FRONT_FOG_LIGHTS_SWITCH.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleLightSwitch
Tipo de unidad: N/A
Versión: Android 13

FORWARD_COLLISION_WARNING_ENABLED

Habilita o inhabilita la Advertencia de colisión directa (FCW). Se establece como verdadero para habilitar los FCW y como falso para inhabilitarlos. Cuando el FCW está habilitado, el sistema ADAS del vehículo debe estar encendido y supervisar posibles colisiones. En general, FORWARD_COLLISION_WARNING_ENABLED siempre debe mostrar verdadero o falso. Si la función no está disponible debido a algún estado temporal, como que la velocidad del vehículo es demasiado baja, esa información se debe transmitir a través de los valores ErrorState en la propiedad FORWARD_COLLISION_WARNING_STATE.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

FORWARD_COLLISION_WARNING_STATE

Estado de advertencia de colisión directa (FCW). Devuelve el estado actual de FCW. Esta propiedad siempre debe mostrar un estado válido definido en ForwardCollisionWarningState o ErrorState. No debe mostrar errores a través de StatusCode y, en su lugar, debe usar los estados de error admitidos. Para el ID de área global (0), se debe definir el array VehicleAreaConfig#supportedEnumValues, a menos que se admitan todos los estados de ForwardCollisionWarningState (incluido OTHER, que no se recomienda) y ErrorState.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: ForwardCollisionWarningState/ErrorState
Tipo de unidad: N/A
Versión: Android 14

FRONT_FOG_LIGHTS_STATE

Estado de los faros antiniebla delanteros. Devuelve el estado actual de las luces antiniebla delanteras. Solo se debe implementar una de las siguientes opciones: FOG_LIGHTS_STATE o FRONT_FOG_LIGHTS_STATE. Consulta la documentación sobre FOG_LIGHTS_STATE para obtener más información.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

FRONT_FOG_LIGHTS_SWITCH

Interruptor de luces antiniebla delanteras Es el parámetro de configuración que desea el usuario. Solo se debe implementar una de las siguientes opciones: FOG_LIGHTS_SWITCH o FRONT_FOG_LIGHTS_SWITCH. Consulta la documentación sobre FOG_LIGHTS_SWITCH para obtener más información.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleLightSwitch
Tipo de unidad: N/A
Versión: Android 13

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

Unidades de consumo de combustible para mostrar Indica el tipo de unidades que usa el automóvil para mostrarle al usuario la información sobre el consumo de combustible. Si es verdadero, significa que las unidades son de distancia sobre volumen, como MPG. Falso indica que las unidades son el volumen a la distancia, como L/100 km. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

FUEL_DOOR_OPEN

Puerta de combustible abierta. Esta propiedad debe indicar si la puerta de combustible del vehículo está abierta o cerrada. Esta propiedad no se aplica a los VE. Es decir, si INFO_FUEL_TYPE solo contiene FuelType::FUEL_TYPE_ELECTRIC, no se debe implementar esta propiedad. Para los VE, implementa EV_CHARGE_PORT_OPEN. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

NIVEL DE FUEL

Es la cantidad de combustible que queda en el vehículo, expresada en mililitros. Esta propiedad debe comunicar la cantidad actual de combustible restante en el vehículo en mililitros. Esta propiedad no se aplica a vehículos eléctricos. Es decir, si INFO_FUEL_TYPE solo contiene FuelType::FUEL_TYPE_ELECTRIC, no se debe implementar esta propiedad. Para los VE, implementa EV_BATTERY_LEVEL. El valor no puede exceder INFO_FUEL_CAPACITY.

Modo de cambio: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:MILLILITER
Versión: Android 13

FUEL_LEVEL_LOW

Advertencia de nivel bajo de combustible. Esta propiedad corresponde a la advertencia de combustible bajo en el panel. Una vez que se establezca el FUEL_LEVEL_LOW, no se debería liberar hasta que se agregue más combustible al vehículo. Esta propiedad puede representar todas las fuentes de combustible de un vehículo. Por ejemplo, en una de las siguientes ubicaciones:

• Vehículo de combustible: esta propiedad se basa solo en el nivel de combustible
• Vehículo con batería, esta propiedad se basa solo en el nivel de batería.
• Vehículo híbrido: Esta propiedad puede basarse en una combinación de niveles de combustible y batería, a discreción del OEM.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

FUEL_VOLUME_DISPLAY_UNITS

Unidades de volumen de combustible para la pantalla. Indica las unidades que usa el automóvil para mostrar el volumen de combustible al usuario. Por ejemplo, litro o galón. VehiclePropConfig.configArray se usa para indicar las unidades de visualización de volumen de combustible compatibles. Las unidades de volumen se definen en VehicleUnit. Por ejemplo, configArray[0] = LITER configArray[1] = GALLON. Si la actualización de FUEL_VOLUME_DISPLAY_UNITS afecta los valores de otras propiedades *_DISPLAY_UNITS, sus valores también deben actualizarse y comunicarse al framework de AAOS. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleUnit
Tipo de unidad: N/A
Versión: Android 13

GEAR_SELECTION

El engranaje que seleccionó el usuario. Los valores de los datos de configuración deben representar la lista de cambios compatibles para este vehículo. Por ejemplo, los datos de configuración de una transmisión automática deben contener {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_PARK, GEAR_DRIVE, GEAR_1, GEAR_2,...} y, para la transmisión manual, la lista debe ser {GEAR_NEUTRAL, GEAR_REVERSE, GEAR_1, GEAR_2,...}. Para un vehículo con transmisión automática que le permite al conductor seleccionar cambios específicos a pedido (por ejemplo, el modo manual), el valor de GEAR_SELECTION debe establecerse en el cambio específico que seleccionó el conductor en lugar de GEAR_DRIVE.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: VehicleGear
Tipo de unidad: N/A
Versión: Android 13

REQUISITO_DE_CUMPLIMIENTO_DEL_REGLAMENTACIÓN_DE_SEGURIDAD GENERAL

Es el requisito de cumplimiento de la Directiva General de Seguridad de la UE. Muestra un valor para indicar si se requiere el cumplimiento de la reglamentación general de seguridad y, de ser así, el tipo de requisito.

Modo de cambio: STATIC
Modo de acceso: READ
Tipo de enumeración: GsrComplianceRequirementType
Tipo de unidad: N/A
Versión: Android 14

GLOVE_BOX_DOOR_POS

Es una propiedad que representa la posición actual de la puerta de la guantera. Se deben definir maxInt32Value y minInt32Value en VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value. El minInt32Value indica que la puerta de la guantera está cerrada. minInt32Value debe ser 0. El maxInt32Value indica que la guantera está en la posición completamente abierta. Los valores entre minInt32Value y maxInt32Value indican un estado de transición entre las posiciones cerradas y completamente abiertas.

Esta propiedad no se encuentra en ninguna unidad en particular, pero sí en un rango especificado de posiciones relativas. El ID de área debe coincidir con el asiento en el que se usará la guantera. Por ejemplo, si el panel frontal derecho tiene una guantera incorporada, el ID del área debe ser SEAT_1_RIGHT.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

GLOVE_BOX_LOCKED

Trabar o destrabar la guantera Si es así, la guantera está bloqueada. Si es falso, la guantera está desbloqueada. El ID de área debe coincidir con el asiento donde se usará la guantera. Por ejemplo, si el panel frontal derecho tiene una guantera integrada, el ID del área debe ser VehicleAreaSeat#ROW_1_RIGHT.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

De H a I

MANUAL

Estado del controlador de detección de manos en el volante (HOD). Indica si las manos del conductor están en el volante. Por lo general, esta propiedad debe mostrar un estado válido definido en HandsOnDetectionDriverState o ErrorState. Por ejemplo, si la función no está disponible debido a algún estado temporal, esa información debe transmitirse a través de ErrorState. Si el vehículo quiere enviar una advertencia al usuario porque las manos del conductor estuvieron demasiado tiempo fuera del volante, la advertencia debe aparecer a través de HANDS_ON_DETECTION_WARNING, que incluye el ID de área global (0), que no es compatible con los siguientes estados: ErrorState (0) y no se admiten todos los estados del array ErrorState (0)HandsOnDetectionDriverStateVehicleAreaConfig#supportedEnumValues

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: HandsOnDetectionDriverState/ErrorState
Tipo de unidad: N/A
Versión: Android 14

HANDS_ON_DETECTION_HABILITADA

Habilita o inhabilita la detección de uso (HOD). Establece el valor en verdadero para habilitar el HOD y en falso para inhabilitarlo. Cuando el sistema HOD está habilitado, un sistema dentro del vehículo debe supervisar la presencia de las manos del conductor en el volante y enviar una advertencia si detecta que las manos del conductor ya no están en el volante. En general, HANDS_ON_DETECTION_ENABLED siempre debe mostrar verdadero o falso.

Si el atributo no está disponible debido a un estado temporal, esa información se debe transmitir a través de los valores ErrorState de la propiedad HANDS_ON_DETECTION_STATE. Esta propiedad se define como minInt32Value VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla si es VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 14

HANDS_ON_DETECTION_WARNING

Advertencia de detección de manos en el dispositivo (HOD). Muestra si se envía una advertencia al conductor por quitar las manos del volante durante un período prolongado. Por lo general, esta propiedad debe mostrar un estado válido definido en HandsOnDetectionWarning o ErrorState. Por ejemplo, si la función no está disponible debido a algún estado temporal, esa información se debe transmitir a través de un ErrorState. Para el ID de área global (0), se debe definir el array VehicleAreaConfig#supportedEnumValues, a menos que se admitan todos los estados de HandsOnDetectionWarning (incluido OTHER, que no se recomienda) y ErrorState.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: HandsOnDetectionWarning/ErrorState
Tipo de unidad: N/A
Versión: Android 14

HAZARD_LIGHTS_STATE

Estado de las luces de emergencia Muestra el estado actual de las luces de emergencia.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

HAZARD_LIGHTS_SWITCH

Interruptor de la luz de peligro. Es el parámetro de configuración que el usuario desea. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: VehicleLightSwitch
Tipo de unidad: N/A
Versión: Android 13

HEADLIGHTS_STATE

Estado de los faros. Muestra el estado actual de los faros.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

HEADLIGHTS_SWITCH

Interruptor de los faros. Es el parámetro de configuración que el usuario desea. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleLightSwitch
Tipo de unidad: N/A
Versión: Android 13

HIGH_BEAM_LIGHTS_STATE

Estado de las luces altas. Muestra el estado actual de las luces altas.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

HIGH_BEAM_LIGHTS_SWITCH

Interruptor de luz de luz alta. El parámetro de configuración que quiere el usuario. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleLightSwitch
Tipo de unidad: N/A
Versión: Android 13

HVAC_AC_ACTIVADO

Enciende y apaga el aire acondicionado para el área designada. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_ACTUAL_FAN_SPEED_RPM

Velocidad real del ventilador.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_ACTIVADO_AUTOMÁTICO

Activa y desactiva el control de climatización automático. Si esta opción está activada, se activará el sistema de climatización automático. Si es falso, el control automático de la climatización está desactivado. Si el vehículo no admite la desactivación directa del control automático de la climatización, los OEMs deben agregar lógica en su implementación de VHAL para establecer HVAC_AUTO_ON como falso, lo que cambia la configuración de HVAC necesaria para desactivar indirectamente HVAC_AUTO_ON. Idealmente, esto no debería interrumpir al usuario. Los OEM deben revertir al estado anterior los parámetros de configuración que se hayan modificado cuando la climatización automática está desactivada. De esta manera, el único resultado debería ser que HVAC_AUTO_ON esté desactivado. Si no es posible restablecer la configuración de HVAC a la configuración anterior, el OEM debe implementar el cambio menos disruptivo.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_AUTO_RECIRC_ON

Recirculación automática activada o desactivada. Cuando la recirculación automática está activada, el sistema de HVAC puede cambiar automáticamente al modo de recirculación si el vehículo detecta una mala calidad del aire entrante. Esta propiedad está definida como VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_DEFROSTER

Descongelamiento basado en el ventilador para la ventana designada. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_DUAL_ON

Habilita la vinculación de temperatura entre áreas. El AreaIDs de la propiedad HVAC_DUAL_ON debe contener una combinación de AreaIDs HVAC_TEMPERATURE_SET que se pueda vincular. Si HVAC_TEMPERATURE_SET se asigna a AreaIDs[a_1, a_2, ..., a_n] y si HVAC_DUAL_ON se puede habilitar para vincular a_i y a_j, la propiedad HVAC_DUAL_ON se debe asignar a [a_i | a_j]. Además, si a_k y a_l también se pueden acoplar por separado, HVAC_DUAL_ON debe asignarse a [a_i | a_j, a_k | a_l]. Por ejemplo, un automóvil tiene dos asientos delanteros (ROW_1_LEFT y ROW_1_RIGHT) y tres asientos traseros (ROW_2_LEFT, ROW_2_CENTER y ROW_2_RIGHT). Hay dos unidades de control de temperatura, la del conductor y la del pasajero, que se pueden sincronizar de forma opcional. Esto se puede expresar de esta manera en 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]

Cuando la propiedad está habilitada, la ECU debe sincronizar la temperatura de las áreas afectadas. Cualquier parámetro modificado como efecto secundario de activar o desactivar el parámetro DUAL_ON generará devoluciones de llamada onPropertyEvent() al VHAL. Además, si establecer una temperatura (por ejemplo, la del conductor) cambia otra (como la del pasajero delantero), se deben generar las devoluciones de llamada onPropertyEvent() adecuadas.

Si un usuario cambia una temperatura que rompe la vinculación (por ejemplo, establece la temperatura del pasajero de forma independiente), el VHAL debe enviar las devoluciones de llamada onPropertyEvent() adecuadas (incluida HVAC_DUAL_ON = false and HVAC_TEMPERATURE_SET[AreaID] = xxx). Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_ELECTRIC_DEFROSTER_ACTIVADO

Estado de los descongeladores eléctricos

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_FAN_DIRECTION

Configuración de la dirección del ventilador. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo enum: VehicleHvacFanDirections
Tipo de unidad: N/A
Versión: Android 13

VENTILADOR_HABILITADO_DISPOSITIVO_DISPONIBLE

Posiciones de ventilador disponibles. Esta es una máscara binaria de las posiciones de los ventiladores disponibles para la zona. Cada dirección de ventilador disponible se indica con una entrada independiente en el vector. Una dirección de ventilador puede tener varios bits del conjunto vehicle_hvac_fan_direction. Por ejemplo, un automóvil típico puede tener las siguientes posiciones del ventilador:

- 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)

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: VehicleHvacFanDirection
Tipo de unidad: N/A
Versión: Android 13

VENTILADOR_DE_HVAC_VELOCIDAD

Configuración de la velocidad del ventilador. Se deben definir maxInt32Value y minInt32Value en VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value.

• minInt32Value velocidad más baja del ventilador
• Velocidad máxima del ventilador: maxInt32Value

Esta propiedad no se encuentra en ninguna unidad específica, pero sí en un rango especificado de velocidades relativas. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden optar por implementarla solo como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_MAX_AC_ON

Activa o desactiva la electricidad MAX. Cuando esta función está activada, la ECU puede ajustar ciertos elementos, como la posición de la ventilación, la velocidad del ventilador y la temperatura, según sea necesario para enfriar el vehículo lo más rápido posible. Cualquier parámetro modificado como efecto secundario de activar o desactivar el parámetro de AC MAX genera devoluciones de llamada onPropertyEvent() a la VHAL. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ.

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_MAX_DEFROST_ON

Activa y desactiva la función MAX DEFROST. Cuando está activada, la ECU puede ajustar elementos como la posición de las rejillas, la velocidad del ventilador y la temperatura según sea necesario para descongelar las ventanas lo más rápido posible. Cualquier parámetro modificado como efecto secundario de activar o desactivar el parámetro MAX DEFROST genera devoluciones de llamada onPropertyEvent() a la VHAL. El AreaIDs para HVAC_MAX_DEFROST_ON indica que se puede controlar MAX DEFROST en el área. Por ejemplo, areaConfig.areaId = {ROW_1_LEFT | ROW_1_RIGHT} indica que HVAC_MAX_DEFROST_ON solo se puede controlar para las primeras filas. Esta propiedad está definida como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

POTENCIA_HABILITADA_ENCENDIDA

Representa el estado de alimentación global del sistema de HVAC. Si estableces esta propiedad como falsa, es POSIBLE que se marquen algunas propiedades que controlan funciones y subsistemas individuales de HVAC en el estado NO DISPONIBLE. Si estableces esta propiedad como verdadera, es POSIBLE que se marquen algunas propiedades que controlan funciones y subsistemas de HVAC individuales como el estado DISPONIBLE (a menos que alguna o todas las propiedades estén en el estado NO DISPONIBLE por sus propios méritos individuales).

HvacPower_DependentProperties son aquellas propiedades que requieren que se encienda el HVAC para habilitar la funcionalidad. En algunos automóviles, por ejemplo, para encender el aire acondicionado, primero se debe encender el sistema de HVAC. La lista HvacPower_DependentProperties se debe establecer en VehiclePropConfig.configArray. HvacPower_DependentProperties solo debe contener aquellas propiedades asociadas con VehicleArea:SEAT.

La asignación de AreaID para la propiedad HVAC_POWER_ON debe contener todos los AreaIDs a los que se asignan HvacPower_DependentProperties. Por ejemplo, un automóvil tiene dos:

1. Asientos delanteros (ROW_1_LEFT, ROW_1_RIGHT) y tres asientos traseros (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT). Si las funciones de HVAC (aire acondicionado, temperatura, etc.) del automóvil dependen de un solo controlador de potencia de HVAC, HVAC_POWER_ON se debe asignar a [ROW_1_LEFT | ROW_1_RIGHT | ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT]
2. Asientos en la primera fila (ROW_1_LEFT, ROW_1_RIGHT) y tres asientos en la segunda (ROW_2_LEFT, ROW_2_CENTER, ROW_2_RIGHT) y la tercera fila (ROW_3_LEFT, ROW_3_CENTER, ROW_3_RIGHT). Si el automóvil tiene controladores de temperatura en la primera fila que pueden funcionar por completo de forma independiente de los controladores de temperatura en la parte posterior del vehículo, HVAC_POWER_ON debe asignarse a un array de dos elementos:

   - ROW_1_LEFT | ROW_1_RIGHT - ROW_2_LEFT | ROW_2_CENTER | ROW_2_RIGHT | ROW_3_LEFT | ROW_3_CENTER | ROW_3_RIGHT
   

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs tienen la opción de implementarla solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_RECIRC_ON

Recirculación activada y desactivada. Controla el suministro de aire exterior a la cabina. Si la recirculación está activada, la mayor parte del flujo de aire que ingresa a la cabina se origina en ella. Si la recirculación está desactivada, la mayor parte del flujo de aire que ingresa a la cabina proviene del exterior del vehículo. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ

Modo de cambio: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_SEAT_TEMPERATURE

Calefacción y enfriamiento de los asientos Se deben definir maxInt32Value y minInt32Value en VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value. El maxInt32Value indica el parámetro de configuración de calefacción de la temperatura máxima del asiento. El valor de minInt32Value debe ser 0, a menos que el vehículo admita la refrigeración del asiento. En este caso, minInt32Value indica la configuración máxima de enfriamiento de la temperatura del asiento. Esta propiedad no se encuentra en ninguna unidad específica, sino en un rango especificado de parámetros de configuración de temperatura relativa. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_SEAT_VENTILATION

Ventilación del asiento. Se deben definir maxInt32Value y minInt32Value en VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value. minInt32Value debe ser 0. El valor maxInt32Value indica la configuración de ventilación máxima disponible para el asiento.

Esta propiedad no se encuentra en ninguna unidad en particular, pero sí en el rango especificado de configuración de ventilación.

Las apps de HVAC y el Asistente lo usan para habilitar, cambiar o leer el estado de la ventilación del asiento. No es lo mismo que la refrigeración de los asientos. Puede estar activado al mismo tiempo que el enfriamiento o no.

Esta propiedad se define como >VehiclePropertyAccess.READ_WRITE, pero los OEM solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

CALEFACCIÓN_LATERAL_MIRROR_HVAC

Calor en el espejo lateral. Los valores crecientes indican niveles de calefacción más altos para los espejos laterales. Debes definir maxInt32Value y minInt32Value en VehicleAreaConfig Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value. En los datos de configuración:

• maxInt32Value representa el nivel de calefacción máximo.
• minInt32Value DEBE ser 0 y no indica calefacción.

Esta propiedad no se encuentra en ninguna unidad en particular, sino en un rango especificado de parámetros de configuración de calefacción relativa. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs tienen la opción de implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_STEERING_WHEEL_HEAT

Establece la cantidad de calefacción y enfriamiento del volante. Se deben definir los elementos maxInt32Value y minInt32Value en VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value. El maxInt32Value indica la configuración máxima de calefacción del volante. El valor de minInt32Value debe ser 0, a menos que el vehículo también admita la refrigeración del volante. En este caso, minInt32Value indica la configuración máxima de enfriamiento del volante. Esta propiedad no se encuentra en ninguna unidad en particular, sino en un rango especificado de parámetros de configuración de calefacción. Esta propiedad se define como VehiclePropertyAccess.READ, pero los OEMs solo pueden implementarla como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HVAC_TEMPERATURE_CURRENT

Temperatura actual del sistema HVAC.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:CELSIUS
Versión: Android 13

TEMPERATURE_DISPLAY_UNITS

Unidades de temperatura para la pantalla. Indica si la temperatura se muestra en grados Celsius o Fahrenheit. VehiclePropConfig.configArray indica las unidades de visualización de temperatura compatibles. Por ejemplo, configArray[0] = CELSIUS configArray[1] = FAHRENHEIT. Este parámetro PUEDE usarse para mostrar cualquier temperatura de HVAC en el sistema. Los valores deben ser VehicleUnit.CELSIUS o VehicleUnit.FAHRENHEIT.

Si la actualización de HVAC_TEMPERATURE_DISPLAY_UNITS afecta los valores de otras propiedades *_DISPLAY_UNITS, sus valores deben actualizarse y comunicarse al framework de AAOS.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarla solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: VehicleUnit
Tipo de unidad: N/A
Versión: Android 13

TEMPERATURE_SET DE HVAC

Se estableció la temperatura final de HVAC en Celsius.

Se deben definir los elementos minFloatValue y maxFloatValue en VehicleAreaConfig:

• Se estableció la temperatura mínima en minFloatValue grados Celsius.
• La temperatura máxima establecida es de maxFloatValue en Celsius.

Si no se admiten todos los valores entre minFloatValue y maxFloatValue, usa configArray para enumerar los valores de temperatura válidos que se pueden establecer. Esto también describe una tabla de consulta para convertir la temperatura de Celsius a Fahrenheit (y viceversa) para el vehículo. Se debe definir configArray si la conversión de unidades estándar no es compatible con el vehículo.

configArray se establece de la siguiente manera:

• configArray[0] [límite inferior de la temperatura admitida en grados Celsius] * 10
• configArray[1] [límite superior de la temperatura admitida en grados Celsius] × 10
• configArray[2] [incremento en Celsius] * 10
• configArray[3] [límite inferior de la temperatura admitida en grados Fahrenheit] * 10
• configArray[4] [límite superior de la temperatura admitida en grados Fahrenheit] * 10
• configArray[5] [incremento en Fahrenheit] × 10

El valor de minFloatValue y maxFloatValue en VehicleAreaConfig debe ser igual a configArray[0] y configArray[1] respectivamente. Por ejemplo, si el vehículo admite valores de temperatura como [16.0, 16.5, 17.0 ,..., 28.0] in Celsius [60.5, 61.5, 62.5 ,..., 84.5] en grados Fahrenheit, configArray debe ser configArray = {160, 280, 5, 605, 845, 10}

Idealmente, la relación entre el incremento Celsius y el Fahrenheit debe ser lo más cercana a la relación real que va de 1 grado Celsius a 1.8 grados Fahrenheit. Debe haber una asignación uno a uno de todos los valores Celsius a los valores Fahrenheit definidos por configArray. Los clientes usan configArray para convertir la temperatura de esta propiedad de Celsius a Fahrenheit. Además, les permite a los clientes saber qué valor Celsius deben establecer en la propiedad para alcanzar el valor Fahreneheit deseado para el sistema. Si la ECU no tiene una asignación uno a uno de todos los valores Celsius a valores Fahrenheit, configArray solo debe definir la lista de valores Celsius y Fahrenheit que tienen una asignación uno a uno.

Por ejemplo, si la ECU admite valores Celsius de 16 a 28 y valores Fahrenheit de 60 a 85, cada uno con un incremento de 1, un configArray posible es el código>{160, 280, 10, 600, 840, 20}. En este caso, 85 no es una temperatura admitida.

Cualquier valor que se encuentre entre un valor válido debe redondearse al valor válido más cercano. Recomendamos que el OEM también implemente la propiedad HVAC_TEMPERATURE_VALUE_SUGGESTION del vehículo, ya que proporciona aplicaciones con un método simple para determinar los valores de temperatura que se pueden establecer para un vehículo y convertir valores entre Celsius y Fahrenheit.

Esta propiedad se define como VehiclePropertyAccess.READ, pero los OEMs pueden implementarla como VehiclePropertyAccess.READ

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:CELSIUS
Versión: Android 13

SUGGESTION: VALOR_DE_TEMPERATURE_DE HVAC

Valores sugeridos para establecer la temperatura de HVAC.

Implementa la propiedad para ayudar a las aplicaciones a comprender el valor de temperatura compatible más cercano en grados Celsius o Fahrenheit.

• floatValues[0] Es el valor solicitado que una app desea establecer para una temperatura.
• floatValues[1] Unidad para floatValues[0] y debe ser una de las siguientes opciones: {VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT}
• floatValues[2] Valores de OEM sugeridos en CELSIUS (este valor no se incluye en la solicitud).
• floatValues[3] Valores de OEM sugeridos en FAHRENHEIT (este valor no se incluye en la solicitud).

Una aplicación llama a set(VehiclePropValue propValue) con el valor y la unidad solicitados para el valor. Los OEMs deben mostrar los valores sugeridos en floatValues[2] y floatValues[3] mediante devoluciones de llamada de onPropertyEvent(). Los valores sugeridos deben cumplir con los valores que se pueden derivar de HVAC_TEMPERATURE_SET configArray. En otras palabras, los valores sugeridos y la tabla de valores de configArray deben ser los mismos.

Recomendamos que el OEM agregue lógica personalizada en su implementación de VHAL para evitar enviar solicitudes a la ECU de HVAC. La lógica puede ser la siguiente. Para convertir la temperatura de Celsius a Fahrenheit, haz lo siguiente:

// 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;

Por ejemplo, cuando un conductor usa el asistente de voz para establecer la temperatura del sistema HVAC en 66.2 grados Fahrenheit. Primero, una aplicación establece esta propiedad con el valor [66.2, (float)VehicleUnit.FAHRENHEIT,0,0]. Si un OEM sugiere establecer 19.0 en grados Celsius o 66.5 en grados Fahrenheit a pedido del usuario, VHAL debe generar una devolución de llamada con un valor de propiedad [66.2, (float)VehicleUnit.FAHRENHEIT, 19.0, 66.5]. Después de que el asistente de voz recibe la devolución de llamada, le informa al usuario y establece la temperatura del HVAC en el valor sugerido.

Otro ejemplo es que una app recibe 21 grados Celsius como valor de temperatura actual mediante una consulta a HVC_TEMPERATURE_SET, pero la app necesita saber qué valor se muestra en la IU del vehículo en grados Fahrenheit. Para ello, la app establece la propiedad en [21, (float)VehicleUnit.CELSIUS, 0, 0]. Si el valor sugerido por el OEM para 21 grados Celsius es 70 grados Fahrenheit, VHAL debe generar una devolución de llamada con el valor de la propiedad [21, (float)VehicleUnit.CELSIUS, 21.0, 70.0]. En este caso, la app puede saber que el valor es de 70.0 grados Fahrenheit en la IU del automóvil.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HW_CUSTOM_INPUT

Define un evento de entrada personalizado de socio OEM. Los socios OEM que quieran propagar eventos que no son compatibles con Android deben usar este evento de entrada. Está compuesta por un array solo de valores int32. Las propiedades de Android son las siguientes:

• int32Values[0]: Es el código de entrada que identifica la función que representa este evento. Los tipos de eventos válidos se definen desde CustomInputType.CUSTOM_EVENT_F1 hasta CustomInputType.CUSTOM_EVENT_F10. Representan el evento personalizado que definirán los socios OEM.
• int32Values[1] El tipo de visualización objetivo definido en VehicleDisplay Los eventos que no estén vinculados a una pantalla específica se deben enviar a VehicleDisplay#MAIN
• int32Values[2] Contador de repetición. Si es 0, el evento no se repite. Los valores 1 o superiores indican cuántas veces se repitió este evento.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: CustomInputType
Tipo de unidad: N/A
Versión: Android 13

HW_KEY_INPUT

Es la propiedad para enviar eventos de entrada de hardware a Android.

• Acción int32Values[0] definida por VehicleHwKeyInputAction
• Código de clave int32Values[1], se debe usar el código de clave de Android estándar
• int32Values[2] Pantalla de destino definida en VehicleDisplay Los eventos que no están vinculados a una pantalla específica se deben enviar a VehicleDisplay#MAIN
• int32Values[3] (Opcional) Cantidad de marcas. El valor debe ser igual o superior a 1. Cuando se omite, Android establece el valor predeterminado en 1.

Cambia el modo: .ON_CHANGE
Modo de acceso: READ
Tipo enum: N/A
Tipo de unidad: N/A
Versión: Android 13

HW_KEY_INPUT_V2

Es una propiedad para enviar eventos de entrada de hardware a Android.

• int32array[0] Pantalla de destino definida por VehicleDisplay, como:
  VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
• Código de clave int32array[1], debe usar el código de clave estándar de Android, como KEYCODE_HOME y KEYCODE_BACK.
• La acción int32array[2] se define en VehicleHwKeyInputAction, por ejemplo:
  VehicleHwKeyInputAction::ACTION_UP y VehicleHwKeyInputAction::ACTION_UP
• int32array[3] Repetir la cantidad del evento. Para los eventos de tecla presionada, este es el recuento de repetición con la primera vez que se presiona, el valor se inicia en 0 y de allí va en aumento. Para los eventos de activación de tecla, siempre es igual a 0.
• int64array[0] Tiempo de inactividad en nanosegundos transcurridos desde el último inicio. Indica el tiempo del evento de tecla abajo más reciente. Para el evento de presión, esta es la hora del evento de presión.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

HW_MOTION_INPUT

Es la propiedad para enviar eventos de entrada de hardware a Android.

• int32array[0] Visualización de destino definida por VehicleDisplay, por ejemplo:
  VehicleDisplay::MAIN, VehicleDisplay::INSTRUMENT_CLUSTER, VehicleDisplay::AUX
• int32array[1] Tipo de entrada definido en VehicleHwMotionInputSource, como:
  VehicleHwMotionInputSource::SOURCE_KEYBOARD, VehicleHwMotionInputSource::SOURCE_DPAD
• int32array[2] Código de acción definido en VehicleHwMotionInputAction, como:
  VehicleHwMotionInputAction::ACTION_UP, VehicleHwMotionInputAction::ACTION_DOWN
• La marca de estado del botón int32array[3] definida en VehicleHwMotionButtonStateFlag, por ejemplo:
  VehicleHwMotionButtonStateFlag::BUTTON_PRIMARY, VehicleHwMotionButtonStateFlag::BUTTON_SECONDARY
• int32array[4] Cantidad de eventos del puntero, N. N debe ser un número entero positivo.
• int32array[5:5+N-1] ID del puntero, longitud N
• int32array[5+N:5+2*N-1] Tipo de herramienta, longitud N. Según se define en VehicleHwMotionToolType, por ejemplo:
  VehicleHwMotionToolType::TOOL_TYPE_FINGER y VehicleHwMotionToolType::TOOL_TYPE_STYLUS
• floatArray[0:N-1] datos de x, longitud N
• Datos de floatArray[N:2*N-1] y, longitud N
• Datos de presión de floatArray[2*N:3*N-1], longitud N
• Datos de tamaño de floatArray[3*N:4*N-1], longitud N
• int64array[0] Tiempo de inactividad, nanosegundos transcurridos desde el inicio. Indica la hora en la que el usuario presionó la pantalla originalmente para iniciar un flujo de eventos de posición. Para el evento de presión, es la hora del evento de presión.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 14

HW_ROTARY_INPUT

Es una propiedad para enviar eventos rotativos de hardware a Android.

• int32Values[0] RotaryInputType para identificar qué perilla rotativa se gira.
• int32Values[1] Cantidad de puntos de detención (clics), positivo para el sentido de las manecillas del reloj, negativo para el sentido contrario a las manecillas del reloj.
• int32Values[2] La pantalla objetivo definida en VehicleDisplay Los eventos no vinculados a una pantalla específica se deben enviar a VehicleDisplay#MAIN
• int32values[3 .. 3 + abs(number of detents) - 2] Deltas en nanosegundos entre pares de detenciones consecutivas cuando la cantidad de detenciones es superior a 1 o inferior a -1.
• VehiclePropValue.timestamp Cuándo se produjo la rotación. Si la cantidad de retenciones es mayor que 1 o menor que -1, cuando se produjo la primera detención de la rotación.

Modo de cambio: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: RotaryInputType
Tipo de unidad: N/A
Versión: Android 13

IGNITION_STATE

Representa el estado de encendido.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enum: VehicleIgnitionState
Tipo de unidad: N/A
Versión: Android 13

INFO_DRIVER_SEAT

Las implementaciones de VHAL de ubicación del asiento del conductor deben ignorar el áreaId. Usar VehicleArea:GLOBAL

Modo de cambio: STATIC
Modo de acceso: READ
Tipo de enumeración: VehicleAreaSeat
Tipo de unidad: N/A
Versión: Android 13

INFO_EV_BATTERY_CAPACITY

Es la capacidad nominal de la batería de un vehículo eléctrico o híbrido. Muestra la capacidad nominal de la batería, ya sea de un vehículo eléctrico o híbrido. Esta es la capacidad total de la batería utilizable cuando el vehículo es nuevo. Este valor puede diferir de EV_CURRENT_BATTERY_CAPACITY porque EV_CURRENT_BATTERY_CAPACITY muestra la capacidad de la batería utilizable en tiempo real teniendo en cuenta factores como el vencimiento de la batería y la dependencia de la temperatura.

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:WH
Versión: Android 13

INFO_EV_CONNECTOR_TYPE

Lista de conectores que puede usar este VE. Si el vehículo tiene varios puertos de carga, esta propiedad debe mostrar todos los tipos de conectores posibles que puede usar al menos un puerto de carga del vehículo.

Modo de cambio: STATIC
Modo de acceso: READ
Tipo de enumeración: EvConnectorType
Tipo de unidad: N/A
Versión: Android 13

INFO_EV_PORT_LOCATION

Esta propiedad debe comunicar la ubicación del puerto de carga del VE con la enumeración PortLocationType. Si un vehículo tiene varios puertos, esta propiedad debe mostrar el puerto que permite la carga más rápida. Para comunicar todas las ubicaciones de los puertos, usa INFO_MULTI_EV_PORT_LOCATIONS.

INFO_EXTERIOR_DIMENSIONS

Dimensiones exteriores del vehículo:

• Altura: int32Values[0]
• Longitud: int32Values[1]
• Ancho: int32Values[2]
• Ancho, incluidos los espejos: int32Values[3]
• Base de ruedas, incluidos espejos: int32Values[4]
• Ancho de la pista frontal: int32Values[5]
• Ancho de la vía trasera: int32Values[6]
• Diámetro de giro de puerta a acera: int32Values[7]

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:MILLIMETER
Versión: Android 13

INFO_FUEL_CAPACITY

Es la capacidad de combustible del vehículo en mililitros. Esta propiedad debe indicar la cantidad máxima de combustible que se puede almacenar en el vehículo en mililitros. Esta propiedad no se aplica a los vehículos eléctricos (VE). Es decir, si INFO_FUEL_TYPE solo contiene FuelType::FUEL_TYPE_ELECTRIC, no se debe implementar INFO_FUEL_CAPACITY. Para los VE, implementa INFO_EV_BATTERY_CAPACITY.

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: VehicleUnit:MILLILITER
Versión: Android 13

INFO_FUEL_DOOR_LOCATION

Ubicación de la puerta de combustible Esta propiedad debe indicar la ubicación de la puerta de combustible del vehículo. Esta propiedad no se aplica a los VE. Es decir, si INFO_FUEL_TYPE solo contiene FuelType::FUEL_TYPE_ELECTRIC, no se debe implementar esta propiedad. Para los VE, implementa INFO_EV_PORT_LOCATION o INFO_MULTI_LOCATIONS.

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: PortLocationType
Tipo de unidad: N/A
Versión: Android 13

INFO_FUEL_TYPE

Es la lista de combustibles que puede usar el vehículo. Solo se debe incluir FuelType::FUEL_TYPE_ELECTRIC si el vehículo es recargable. Por ejemplo, un vehículo eléctrico completamente híbrido (FHEV) no debe incluir FuelType::FUEL_TYPE_ELECTRIC, ya que el valor INT32_VEC de INFO_FUEL_TYPE INFO_FUEL_TYPE se puede propagar como tal.

int32Values = { FuelType::FUEL_TYPE_UNLEADED }

Modo de cambio: STATIC
Modo de acceso: READ
Tipo de enumeración: FuelType
Tipo de unidad: N/A
Versión: Android 13

INFO_MAKE

Es el fabricante del vehículo. Esta propiedad debe comunicar el nombre de la marca pública del vehículo.

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

MODELO DE INFORMACIÓN

Modelo del vehículo. Esta propiedad debe comunicar el nombre público del modelo del vehículo.

Modo de cambio: STATIC
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

INFO_MODEL_YEAR

Es el año modelo del vehículo en formato "AAAA" según el calendario gregoriano.

Modo de cambio: STATIC
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:YEAR
Versión: Android 13

INFO_MULTI_EV_PORT_LOCATIONS

Varias ubicaciones de puertos de VE Implementa esta propiedad si el vehículo tiene varios puertos de VE. Las ubicaciones de los puertos se definen en PortLocationType. Por ejemplo, un automóvil tiene un puerto en la parte delantera izquierda y otro en la parte trasera izquierda:

int32Values[0] = PortLocationType::FRONT_LEFT int32Values[1] = PortLocationType::REAR_LEFT

Si un vehículo tiene solo un puerto, el valor de esta propiedad debe enumerar un elemento. Para describir la ubicación de un puerto, consulta INFO-EV-PORT-LOCATION

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: PortLocationType
Tipo de unidad: N/A
Versión: Android 13

INFORMACIÓN_VIN

VIN del vehículo.

Cambiar modo: ESTÁTICO
Modo de acceso: READ
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

INITIAL_USER_INFO

Define el usuario de Android que se usará durante la inicialización. El sistema Android llama a esta propiedad cuando la inicializa, y permite que la HAL defina qué usuario de Android se debe iniciar. Para realizar esta solicitud, se configura un VehiclePropValue (definido por InitialUserInfoRequest) y la HAL debe responder con un evento de cambio de propiedad (definido por InitialUserInfoResponse). Si el sistema HAL no responde después de un tiempo definido por el sistema Android, este último continúa como si HAL mostrara una respuesta de acción InitialUserInfoResponseAction:DEFAULT. Por ejemplo, en el primer inicio, la solicitud podría ser la siguiente:

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

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE
Tipo de enum: N/A
Tipo de unidad: N/A
Versión: Android 13

De la J a la R

LA CENTRO_DE_LANZAMIENTO_DE_ASSIST_COMANDO

Comandos de asistencia al centro de carriles (LCA). Comandos para activar y suspender el LCA. Cuando se envía el comando ACTIVATE de LaneCenteringAssistCommand, LANE_CENTERING_ASSIST_STATE debe establecerse en LaneCenteringAssistState#ACTIVATION_REQUESTED. Cuando el valor El comando ACTIVATE tiene éxito. LANE_CENTERING_ASSIST_STATE debe establecerse en LaneCenteringAssistState#ACTIVATED Cuando el comando DEACTIVATE de LaneCenteringAssistCommand tiene éxito, LANE_CENTERING_ASSIST_STATE se debe establecer en LaneCenteringAssistState#ENABLED

Para el ID de área global (0), se debe definir el VehicleAreaConfig#supportedEnumValues, a menos que todos Se admiten los valores de enumeración de LaneCenteringAssistCommand. Cuando esta propiedad no está disponible Debido a que la LCA está inhabilitada (por ejemplo, LANE_CENTERING_ASSIST_ENABLED es falso), esta propiedad debe mostrar StatusCode#NOT_AVAILABLE_DISABLED si LANE_CENTERING_ASSIST_STATE es implementar y la estado se establece en un valor ErrorState, entonces esta propiedad debe mostrar un StatusCode que se alinee con el valor de ErrorState. Por ejemplo, si LANE_CENTERING_ASSIST_STATE se establece en ErrorState#NOT_AVAILABLE_SPEED_LOW, esta propiedad debe mostrar StatusCode#NOT_AVAILABLE_SPEED_LOW

Cambiar modo: ON_CHANGE
Modo de acceso: WRITE
Tipo enum: LaneCenteringAssistCommand
Tipo de unidad: N/A
Versión: Android 14

GOOGLE_CENTERING_ASSIST_HABILITADO

Habilita o inhabilita la asistencia de centrado de carriles (LCA). Establece el valor como verdadero para habilitar el LCA y falso para inhabilitarlo. Cuando se habilita el LCA, el sistema de ADAS del vehículo se debe encender y esperar a que se produzca como una señal de activación del conductor. Una vez que se active la función, el sistema ADAS conducir el vehículo para mantenerlo centrado en el carril actual.

Es diferente de la Función para mantener el carril (LKA), que supervisa si el conductor se desvía hacia o sobre la marca de carril. Si se detecta una salida accidental de un carril, el aplica el control de dirección para devolver el vehículo al carril actual. En general, LANE_CENTERING_ASSIST_ENABLED siempre debe mostrar verdadero o falso. Si el botón no está disponible debido a un estado temporal, como que la velocidad del vehículo es demasiado baja o demasiado alto, esa información debe transmitirse a través de los valores ErrorState en el propiedad LANE_CENTERING_ASSIST_STATE.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

URL_CENTERING_ASSIST_STATE

estado de la Asistencia para centrar el carril (LCA). Muestra el estado actual del LCA. Esta propiedad siempre debe Devuelve un estado válido definido en LaneCenteringAssistState o ErrorState No debe mostrar errores a través de StatusCode y debe usar el error admitido estados.

Si la LCA incluye advertencias de salida de carril, estas deben aparecer a través del Carril. Propiedades de advertencia de salida (LDW).

Para el ID de área global (0), el array VehicleAreaConfig#supportedEnumValues debe ser definido, a menos que todos los estados de ambos LaneCenteringAssistState (incluido OTHER, que no se recomienda) y ErrorState.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo enum: LaneCenteringAssistState/ErrorState
Tipo de unidad: N/A
Versión: Android 14

LA VERDAD

Habilita o inhabilita la advertencia de salida de carril (LDW). Establece el valor verdadero para habilitar LDW y falso para inhabilitarlo. Cuando el LDW está habilitado, el sistema ADAS en la el vehículo debe estar encendido y supervisar si se está acercando a las líneas de carriles o cruzando las líneas. en cuyo caso se enviará una advertencia.

En general, LANE_DEPARTURE_WARNING_ENABLED siempre debe mostrar verdadero o falso. Si La función no está disponible debido a un estado temporal, como que la velocidad del vehículo es demasiado baja o demasiado alta, esa información debe transmitirse a través de los valores ErrorState en el propiedad LANE_DEPARTURE_WARNING_STATE.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden impleméntalo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

LA_VERSIÓN_DE_LA_AL_VENTA___ALGUNA_SERVICIO

Estado de advertencia de salida de carril (LDW). Muestra el estado actual de LDW. Esta propiedad siempre debe Devuelve un estado válido definido en LaneDepartureWarningState o ErrorState No debe mostrar errores a través de StatusCode y debe usar los estados de error admitidos. en su lugar.

Para el ID de área global (0), el array VehicleAreaConfig#supportedEnumValues debe ser definido, a menos que todos los estados de ambos LaneDepartureWarningState (incluido OTHER, que no se recomienda) y ErrorState.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo enum: LaneDepartureWarningState/ErrorState
Tipo de unidad: N/A
Versión: Android 14

URL_KEEP_ASSIST_HABILITADA

Habilita o inhabilita la función Función de mantenimiento de carril (LKA). Establece el valor verdadero para habilitar LKA y falso para inhabilitarlo. Cuando el LKA está habilitado, el sistema ADAS del vehículo debe encenderse y supervisar si el El conductor se desvía involuntariamente hacia o sobre la marca de carril. Si la salida accidental de un carril el sistema aplica el control de dirección para devolver el vehículo al carril actual. Esto es diferente de la Asistencia de Centrado de Carriles (LCA), que, cuando se activa, aplica para mantener el vehículo centrado en el carril actual.

En general, LANE_KEEP_ASSIST_ENABLED siempre debe mostrar verdadero o falso. Si el botón no está disponible debido a un estado temporal, como que la velocidad del vehículo es demasiado baja o demasiado alto, esa información debe transmitirse a través de los valores ErrorState en el propiedad LANE_KEEP_ASSIST_STATE.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden impleméntalo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

URL_KEEP_ASSIST_STATE

Estado de la asistencia para mantener el carril (LKA) Muestra el estado actual de LKA. Esta propiedad siempre debe mostrar un estado válido definido en LaneKeepAssistState o ErrorState. No debe detectar errores a través de StatusCode y, en su lugar, debe usar los estados de error admitidos

Si la LKA incluye advertencias de salida de carril antes de corregir la dirección, se mostrarán debe aparecer a través de las propiedades de advertencia de salida de carril (LDW).

Para el ID de área global (0), se debe definir el array VehicleAreaConfig#supportedEnumValues. a menos que todos los estados de LaneKeepAssistState (incluido OTHER, lo que no se recomienda) y ErrorState.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo enum: LaneKeepAssistState/ErrorState
Tipo de unidad: N/A
Versión: Android 14

UBICACIÓN_CARACTERIZACIÓN

Caracterización de las entradas utilizadas para el procesamiento de la ubicación. Esta propiedad debe indicar qué datos y entradas de sensores considera el sistema (si corresponde) cuando se calcula la ubicación del vehículo que se comparte con Android a través de la HAL de GNSS.

El valor debe mostrar una colección de marcas de bits. Las marcas de bits se definen en Caracterización de la ubicación. El valor también debe incluir exactamente uno de los valores DEAD_RECKONED o RAW_GNSS_ONLY entre su colección de marcas de bits.

Cuando no se admite esta propiedad, se supone que no se fusiona ninguna entrada de sensor adicional a las actualizaciones de GNSS proporcionadas a través de la HAL de GNSS. A menos que se especifique lo contrario mediante entre las interfaces de HAL del GNSS.

Cambiar modo: STATIC
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

MIRROR_AUTO_FOLD_HABILITADO

Representa la propiedad de la función de plegado automático de duplicación. Esta propiedad es verdadera cuando el atributo para se pliegan automáticamente los espejos laterales del vehículo (por ejemplo, cuando los espejos se pliegan hacia adentro) automáticamente cuando alguien baja y traba el vehículo).

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

MIRROR_AUTO_TILT_HABILITADO

Representa la propiedad de la función de duplicación automática de inclinación. Esta propiedad es verdadera cuando el atributo para inclinar automáticamente los espejos laterales del vehículo (por ejemplo, cuando los espejos se inclinan hacia abajo) automáticamente cuando se revierte el vehículo).

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

MIRROR_PLEGAR

Plegado tipo espejo. El valor verdadero indica que los espejos están plegados. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo como Solo VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

BLOQUEO_MIRROR

Bloqueo de espejo El valor verdadero indica que las posiciones de los espejos están bloqueadas y no se pueden cambiar. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

MIRROR_Y_MOVIMIENTO

Replica el movimiento Y. Los valores maxInt32Value y minInt32Value de cada uno Se debe definir VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value.

El objeto maxInt32Value representa la velocidad máxima de movimiento del espejo mientras se inclina. bien. El objeto minInt32Value representa la velocidad máxima de movimiento del espejo, mientras que inclinando hacia la izquierda.

Los valores absolutos más altos, ya sean positivos o negativos, indican una velocidad de movimiento más rápida. Una vez que alcanza el límite posicional, el valor se debe restablecer a 0. Si el valor de MIRROR_Y_MOVE es 0 actualmente, eso significa que no hay movimiento en ese momento.

Esta propiedad no se encuentra en ninguna unidad en particular, pero sí en un rango de movimiento relativo especificado de alta velocidad.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

MIRROR_Y_POS

Duplicar la posición Y La maxInt32Value y la minInt32Value en Se debe definir VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value. El elemento minInt32Value indica que el espejo está completamente inclinado hacia la izquierda.

Este debe ser un valor no positivo. El maxInt32Value indica que el espejo está inclinado. totalmente a la derecha. Debe ser un valor no negativo. 0 indica que el espejo no está inclinado en ninguna de las dirección IP.

Los valores entre minInt32Value y maxInt32Value indican una transición estado entre la izquierda posiciones extremas y derechas.

Esta propiedad no se encuentra en ninguna unidad en particular, pero sí en un rango especificado de posiciones relativas.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

MIRROR_Z_MOVE

Mover el espejo Z. Los valores maxInt32Value y minInt32Value de cada uno Se debe definir VehicleAreaConfig. Se deben admitir todos los números enteros entre minInt32Value y maxInt32Value.

El objeto maxInt32Value representa la velocidad máxima de movimiento del espejo mientras se inclina hacia arriba. El objeto minInt32Value representa la velocidad máxima de movimiento del espejo mientras se inclina hacia abajo. Los valores absolutos más altos, ya sean positivos o negativos, indican una velocidad de movimiento más rápida. Una vez que alcanza el límite posicional, el valor se debe restablecer a 0. Si el valor de MIRROR_Z_MOVE es 0 actualmente, eso significa que no hay movimiento en ese momento.

Esta propiedad no se encuentra en ninguna unidad en particular, pero sí en un rango de movimiento relativo especificado de alta velocidad.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

MIRROR_Z_POS

Duplicar la posición Z La maxInt32Value y la minInt32Value en Se debe definir VehicleAreaConfig. Todos los números enteros entre minInt32Value y maxInt32Value deben ser compatibles. El minInt32Value indica el espejo esté completamente inclinado hacia abajo. Este debe ser un valor no positivo. El maxInt32Value indica que el espejo está completamente inclinado hacia arriba. Debe ser un un valor no negativo. 0 indica que el espejo no está inclinado en ninguna dirección.

Los valores entre minInt32Value y maxInt32Value indican un estado de transición entre las posiciones totalmente descendentes y ascendentes.

Esta propiedad no se encuentra en ninguna unidad en particular, pero sí en un rango especificado de posiciones relativas.

Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo solo como VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

MODO_NOCHE

El valor verdadero indica que el sensor del modo nocturno detectó el entorno en la cabina del vehículo. tengan poca luz. La plataforma puede usar esto, por ejemplo, para habilitar una IU adecuada para mejorar en entornos oscuros o con poca luz.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

OBD2_FREEZE_FRAME

Informa una instantánea del valor de los sensores OBD2 disponibles en el momento en que se produjo una falla. y fue detectado. Se debe proporcionar un configArray con el mismo significado que se definió para OBD2_LIVE_FRAME

Los valores de esta propiedad se deben interpretar de un modo similar a los de OBD2_LIVE_FRAME, con la excepción de que el campo stringValue puede contener una código de solución de problemas de diagnóstico (DTC) que no esté vacío.

Una solicitud IVehicle#get de esta propiedad debe proporcionar un valor para int64Values[0]. Esto se interpreta como la marca de tiempo del fotograma congelado que se recuperará. Se puede obtener una lista de marcas de tiempo IVehicle#get de OBD2_FREEZE_FRAME_INFO

¿No debería haber ningún fotograma congelado disponible en la marca de tiempo dada, una respuesta de La implementación debe mostrar NOT_AVAILABLE. Debido a que los vehículos pueden tener almacenamiento limitado para los fotogramas congelados, es posible que una solicitud de fotogramas responda NOT_AVAILABLE incluso si la marca de tiempo asociada se obtuvo recientemente a través de OBD2_FREEZE_FRAME_INFO

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

OBD2_FREEZE_FRAME_CLEAR

Inmovilizar el marco despejado. Informa un resumen del valor de los sensores de OBD2 disponibles en ese momento. de que se produjo y se detectó una falla. Se debe proporcionar un configArray con el mismo significado que definido para OBD2_LIVE_FRAME

Los valores de esta propiedad se deben interpretar de un modo similar a los de OBD2_LIVE_FRAME, con la excepción de que el campo stringValue puede contener un campo de diagnóstico que no esté vacío código de solución de problemas (DTC).

Una solicitud IVehicle#get de esta propiedad debe proporcionar un valor para int64Values[0]. Esto será se interpreta como la marca de tiempo del fotograma congelado que se recuperará. Una lista de marcas de tiempo obtenido por un IVehicle#get de OBD2_FREEZE_FRAME_INFO

Si no hay ningún fotograma congelado disponible en la marca de tiempo especificada, se debe obtener una respuesta de NOT_AVAILABLE. que muestra la implementación. Debido a que los vehículos pueden tener almacenamiento limitado para los fotogramas congelados es posible que una solicitud de fotograma responda con NOT_AVAILABLE incluso si el elemento la marca de tiempo se obtuvo recientemente a través de OBD2_FREEZE_FRAME_INFO

Cambiar modo: ON_CHANGE
Modo de acceso: WRITE
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

OBD2_FREEZE_FRAME_INFO

Esta propiedad describe los fotogramas congelados actuales almacenados en la memoria del vehículo y disponibles para recuperación mediante OBD2_FREEZE_FRAME. Los valores se deben interpretar de la siguiente manera. Cada elemento de int64Values deben ser la marca de tiempo en la que se detectó un código de falla y el Se almacenó el fotograma congelado, y cada elemento de ese tipo se puede usar como la clave de OBD2_FREEZE_FRAME para recuperar el fotograma congelado correspondiente.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

FRAME_EN_VIVO_OBD2

Informa un resumen de los valores actuales (en vivo) de los sensores OBD2 disponibles. El configArray se establece de la siguiente manera:

• configArray[0] Cantidad de sensores con valores de número entero específicos del proveedor
• configArray[1] Cantidad de sensores con valor flotante específicos del proveedor

Los valores de esta propiedad se deben interpretar como en el siguiente ejemplo. Considera configArray = {2,3} int32Values debe ser un vector que contenga Obd2IntegerSensorIndex.LAST_SYSTEM_INDEX más dos elementos (o 33 elementos). floatValues debe ser un vector que contenga Obd2FloatSensorIndex.LAST_SYSTEM_INDEX más tres elementos (o 73 elementos).

Es posible que cada fotograma contenga un subconjunto diferente de valores de sensores, ambos sistemas los sensores proporcionados y los específicos del proveedor. Para ello, el elemento bytes del se usa como máscara de bits. Los bytes deben tener una cantidad suficiente de bytes para representar la cantidad total de sensores posibles (en este caso, 14 bytes para representar 106 valores posibles). Se debe leer como una máscara de bits contigua, de modo que cada bit indique la presencia o ausencia de un sensor del marco, que comienza con tantos bits como el tamaño de int32Values seguida de tantos bits como el tamaño de floatValues.

Por ejemplo, bytes[0] = 0x4C (0b01001100) significa lo siguiente:

• int32Values[0 and 1] no son valores de sensor válidos
• int32Values[2 and 3] son valores de sensor válidos
• int32Values[4 and 5] no son valores de sensor válidos
• int32Values[6] es un valor de sensor válido
• int32Values[7] no es un valor de sensor válido
• int32Values[0 and 1] no son valores de sensor válidos
• int32Values[2 and 3] son valores de sensor válidos
• int32Values[4 and 5] no son valores de sensor válidos
• int32Values[6] es un valor de sensor válido
• int32Values[7] no es un valor de sensor válido

Si es bytes[5] = 0x61 (0b01100001), entonces:

• int32Values[32] es un valor de sensor válido
• floatValues[0 thru 3] son valores de sensor no válidos
• floatValues[4 and 5] son valores de sensor válidos
• floatValues[6] no es un valor de sensor válido.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

ON_CHANGE

Cambiar modo:
Modo de acceso: READ_WRITE/READ
Tipo de enumeración: VehicleLightSwitch
Tipo de unidad:N/A
Versión: Android 13

APLICACIÓN_DE_PARKING_BRAKE_AUTO_APPLY

Aplica automáticamente el freno de estacionamiento. Si el valor es verdadero, esta propiedad indica El freno de estacionamiento automático está habilitado. Falso indica que el estacionamiento automático del automóvil la función de freno está inhabilitada. Esta propiedad se suele confundir con PARKING_BRAKE_ON. es que PARKING_BRAKE_ON indica si el freno de estacionamiento real activado o desactivado, mientras que PARKING_BRAKE_AUTO_APPLY indica si el freno de estacionamiento automático está habilitada o inhabilitada, y no describe el estado actual del estacionamiento real freno.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

ESTACIONAMIENTO_EN_FRECUENCIA

Estado del freno de estacionamiento. Si es verdadero, este valor de propiedad será verdadero el freno está activado. Falso indica que el freno de estacionamiento del vehículo está desactivado.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

PER_DISPLAY_BRIGHTNESS

Es la propiedad para representar el brillo de las pantallas que se controlan por separado. Algunos autos tienen una o más pantallas cuyo brillo se controla por separado y esta propiedad es para informar el brillo de la pantalla de cada pasajero. En autos donde todas las pantallas brillo se controla en conjunto, deben usar DISPLAY_BRIGHTNESS

Solo uno de PER_DISPLAY_BRIGHTNESS y PER_DISPLAY_BRIGHTNESS la implementación. Si ambos son disponible, AAOS usa PER_DISPLAY_BRIGHTNESS.

El puerto de pantalla identifica de forma única un conector físico en el dispositivo para la salida de pantalla. que varía de 0 a 255.

• int32Values[0] puerto de visualización
• Brillo: int32Values[1]

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 14

PERF_ODOMETER

Valor actual del odómetro del vehículo.

Cambiar modo: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:KILOMETER
Versión: Android 13

PERF_REAR_STEERING_ANGLE

Ángulo de dirección del modelo de bicicleta posterior del vehículo. El ángulo se mide en grados. La izquierda es negativa. Esta propiedad es independiente del ángulo del volante. Esta propiedad debe comunicar la de las ruedas traseras con respecto al vehículo, no el ángulo del volante.

Cambiar modo: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:DEGREES
Versión: Android 13

PERF_STEERING_ANGLE

Ángulo de dirección del modelo de bicicleta delantero del vehículo. El ángulo se mide en grados. La izquierda es negativa. Esta propiedad es independiente del ángulo del volante. Esta propiedad debe comunicar el ángulo de las ruedas delanteras con respecto al vehículo, no el ángulo del volante.

Cambiar modo: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:DEGREES
Versión: Android 13

VELOCIDAD_PERF._VEHÍCULO

La velocidad del vehículo. El valor debe ser positivo cuando el vehículo está en movimiento. negativo cuando el vehículo está en reversa. Este valor es independiente del valor del engranaje (CURRENT_GEAR o GEAR_SELECTION). Por ejemplo, GEAR_SELECTION es GEAR_NEUTRAL, PERF_VEHICLE_SPEED es positivo cuando el vehículo está en movimiento, negativo cuando va en reversa y cero cuando no está en movimiento.

Cambiar modo: CONTINUOUS
Modo de acceso: READ
Tipo de unidad: N/A
Tipo de unidad: VehicleUnit:METER_PER_SEC
Versión: Android 13

PANTALLA_DE_VEHÍCULO_PERF.

La velocidad del vehículo para las pantallas. Algunos automóviles muestran una velocidad ligeramente más lenta en el velocímetro. que la real.

Cambiar modo: CONTINUOUS
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:METER_PER_SEC
Versión: Android 13

POWER_POLICY_GROUP_REQ

Define una solicitud para establecer el grupo de políticas de energía que se usa para decidir una política de energía predeterminada por para la transición del estado de alimentación.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

POLÍTICA_DE_POTENCIA_REQ

Define una solicitud para aplicar la política de energía. VHAL configura esta propiedad para cambiar la política de encendido del auto. El servicio de la política de energía del automóvil se suscribe a esta propiedad y cambia la política de energía. El se hace con la configuración de VehiclePropValue con el ID de una política de energía, que se define en /vendor/etc/automotive/power_policy.xml Si no se define el ID proporcionado, el servicio de la política de energía del vehículo ignora la solicitud y se mantiene la política de energía actual.

string: "sample_policy_id" // power policy ID

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

POWER_POLICY_GROUP_REQ

Define una solicitud para establecer el grupo de políticas de energía que se usa para decidir una política de energía predeterminada por alimentación. para la transición de estado. VHAL establece esta propiedad con el ID de un grupo de políticas de energía. la política de energía predeterminada que se aplica durante la transición del estado de alimentación. Los grupos de políticas de energía se definen en /vendor/etc/power_policy.xml. Si no se define el ID proporcionado, el servicio de la política de energía del auto lo ignorará. la solicitud. El servicio de políticas de energía del automóvil se suscribe a esta propiedad y establece el grupo de políticas de energía. La aplicación real de la política de energía ocurre cuando cambia el estado de alimentación del sistema es una política de energía asignada válida para el nuevo estado de potencia.

string: "sample_policy_group_id" // power policy group ID

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

RANGO_restantes

Rango restante. Medidores restantes de combustible y carga. El rango restante debe corresponder a todos fuentes de energía de un vehículo. Por ejemplo, el rango de un automóvil híbrido es la suma de los rangos basados en en combustible y batería. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE. porque una app de navegación podría actualizar el rango si tiene una estimación más precisa según la la próxima ruta. Esta propiedad se puede implementar como VehiclePropertyAccess.READ. solo a discreción del OEM.

Cambiar modo: CONTINUOUS
Modo de acceso: READ_WRITE
Tipo de enumeración: N/A
Tipo de unidad: VehicleUnit:METER
Versión: Android 13

READING_LIGHTS_STATE

Muestra el estado actual de las luces de lectura.

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo enum: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

READING_LIGHTS_SWITCH

Mueve el interruptor para controlar las luces de lectura. Esto puede diferir de READING_LIGHTS_STATE si Las luces están encendidas porque hay una puerta abierta o debido a un comando por voz. Por ejemplo, mientras el interruptor esté en la posición desactivada o automática. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo como Solo VehiclePropertyAccess.READ.

REAR_FOG_LIGHTS_STATE

Muestra el estado actual de los faros antiniebla traseros. Solo se puede elegir una de FOG_LIGHTS_STATE o Se puede implementar REAR_FOG_LIGHTS_STATE. Consulta FOG_LIGHTS_STATE

Cambiar modo: ON_CHANGE
Modo de acceso: READ
Tipo enum: VehicleLightState
Tipo de unidad: N/A
Versión: Android 13

REAR_FOG_LIGHTS_SWITCH

Es el parámetro de configuración que desea el usuario. Solo se puede elegir una de FOG_LIGHTS_SWITCH o REAR_FOG_LIGHTS_SWITCH debe ser implementarse. Consulta FOG_LIGHTS_SWITCH para obtener más información. Esta propiedad se define como VehiclePropertyAccess.READ_WRITE, pero los OEMs pueden implementarlo como Solo VehiclePropertyAccess.READ.

Cambiar modo: ON_CHANGE
Modo de acceso: READ_WRITE/READ
Tipo enum: VehicleLightSwitch
Tipo de unidad: N/A
Versión: Android 13

QUITAR_USUARIO

Lo llama el sistema Android después de que se quita a un usuario de Android. La HAL puede usar esta propiedad para lo siguiente: quitar al usuario equivalente. Es un cálculo de solo escritura. El sistema Android no está esperando una respuesta de la HAL. Por lo tanto, esta solicitud no debe fallar. Si no se puede quitar el usuario de HAL equivalente, y la HAL debe marcarlo como inactivo o recuperarse de otra manera.

La solicitud se realiza mediante la configuración de VehiclePropValue con el contenido definido por RemoveUserRequest Por ejemplo, si el sistema tiene 3 usuarios (0, 10 y 11) y el usuario 11 quitada, la solicitud sería:

• int32[0] 42 // ID de solicitud
• int32[1] 11 // (ID de usuario de Android del usuario que se quitó)
• int32[2] 0 // (Marcas del usuario de Android del usuario que se quitó)
• int32[3] 10 // usuario actual
• int32[4] 0 // marcas del usuario actual (ninguna)
• int32[5] 2 // cantidad de usuarios
• int32[6] 0 // primer usuario (usuario 0)
• int32[7] 0 // primeras marcas del usuario (ninguna)
• int32[8] 10 // segundo usuario (usuario 10)
• int32[9] 0 // segundas marcas de usuario (ninguna)

Cambiar modo: STATIC
Modo de acceso: WRITE
Tipo de enumeración: N/A
Tipo de unidad: N/A
Versión: Android 13

D a Z

SEAT_AIRBAG_ENABLED

Represents feature to enable and disable a seat's ability to deploy airbag(s) when triggered (for example, in a collision). If true, it means the seat's airbags are enabled and, if triggered, they deploy. If true, the seat's airbags are disabled, and they do not deploy in any circumstances. This property does not indicate if the airbags are deployed.

This property can be set to VehiclePropertyAccess.READ read only for the purpose of regulation or safety concerns.

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

SEAT_BACKREST_ANGLE_1_MOVE

Seat backrest angle 1 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 seat backrest while angling forward. The minInt32Value represents the maximum movement speed of the seat backrest when reclining.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat backrest reaches the positional limit, the value must reset to 0. If the value for SEAT_BACKREST_ANGLE_1_MOVE is 0, no movement is occurring.

This property is represented 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

SEAT_BACKREST_ANGLE_1_POS

Seat backrest angle 1 position. Backrest angle 1 is the actuator closest to the bottom of the seat. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the seat backrest's full recline position with regard to the actuator at the bottom of the seat. The maxInt32Value indicates the seat backrest's most upright or forward position with regard to the actuator at the bottom of the seat.

Values between minInt32Value and maxInt32Value indicate a transition state between the full recline and the upright and forward positions.

This property is represented as 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

SEAT_BACKREST_ANGLE_2_MOVE

Seat backrest angle 2 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 seat backrest while angling forward. The minInt32Value represents the maximum movement speed of the seat backrest while reclining.

Larger absolute values, positive or negative, indicate a faster movement speed. Once the seat backrest reaches the positional limit, the value must reset to 0. If the value for SEAT_BACKREST_ANGLE_2_MOVE is currently 0, no movement is underway.

This property is represented as 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

SEAT_BACKREST_ANGLE_2_POS

Seat backrest angle 2 position. Backrest angle 2 is the next actuator up from the bottom of the seat.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be #0supported.

The minInt32Value indicates the seat backrest's full recline position with regard to the next actuator in the backrest from the one at the bottom of the seat (see SEAT_BACKREST_ANGLE_1_POS for details). maxInt32Value indicates the seat backrest's most upright and forward position with regard to the next actuator in the backrest from the one at the bottom of the seat (see SEAT_BACKREST_ANGLE_1_POS for details).

Values between minInt32Value and maxInt32Value indicate a transition state between the full recline and upright and forward positions.

This property is represented as 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

SEAT_BELT_BUCKLED

Seatbelt buckled. True indicates belt is buckled. Write access indicates automatic seat buckling capabilities. 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

SEAT_BELT_HEIGHT_MOVE

Seatbelt height 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 seat belt's shoulder anchor while moving up. The minInt32Value represents the maximum movement speed of the seat belt's shoulder anchor while moving down.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat belt reaches the positional limit, the value must reset to 0. If the value of SEAT_BELT_HEIGHT_MOVE is 0, no movement is underway.

This property is represented as a 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

SEAT_BELT_HEIGHT_POS

Seatbelt height position. Adjusts the shoulder belt anchor point.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the seat belt's shoulder anchor is at its lowest position. The maxInt32Value indicates the seat belt's shoulder anchor is at its highest position.

Values between minInt32Value and maxInt32Value indicate a transition state between the lowest and highest positions.

This property is represented as 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

SEAT_CUSHION_SIDE_SUPPORT_MOVE

Represents property for movement direction and speed of seat cushion side support.

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 seat cushion side support when growing wider (for example, support is decreasing). The minInt32Value represents the maximum movement speed of the seat cushion side support when growing narrower (for example, support is increasing).

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat cushion side support reaches the positional limit, the value must reset to 0. If the value of SEAT_CUSHION_SIDE_SUPPORT_MOVE is 0, then no movement is occurring.

This property is represented as 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 14

SEAT_CUSHION_SIDE_SUPPORT_POS

Represents property for seat's hipside (bottom cushion's side) support position.

The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The maxInt32Value indicates the seat cushion side support is in its widest position (for example, least support). The minInt32Value indicates the seat cushion side support is in its thinnest position (for example, most support).

Values in between minInt32Value and maxInt32Value indicate a transition state between the thinnest and widest positions.

This property is represented as a specified range of relative positions.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

SEAT_DEPTH_MOVE

Seat depth 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 seat while getting deeper The minInt32Value represents the maximum movement speed of the seat while getting shallower.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat backrest reaches the positional limit, the value must reset to 0. If the value for SEAT_DEPTH_MOVE is currently 0, no movement is underway.

This property is represented as 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
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_DEPTH_POS

Seat depth position. Sets the seat depth, distance from back rest to front edge of seat.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the seat is in its shallowest position (for example, the position with the smallest distance between the front edge of the seat cushion and the rear end of the seat).

The maxInt32Value indicates the seat is in its deepest position (for example, the position with the largest distance between the front edge of the seat cushion and the rear end of the seat).

Values in between minInt32Value and maxInt32Value indicate a transition state between the shallowest and deepest positions.

This property is represented as a specified range of relative positions.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as only..

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_EASY_ACCESS_ENABLED

Represents property for Seat easy access feature. If true, the seat is automatically adjusted to make it easier for the occupant to enter and exit the vehicle. Each area ID must map to the seat that the user is trying to enter/exit with the help of the easy access feature. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as only.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

SEAT_FOOTWELL_LIGHTS_STATE

Represents property for the seat footwell lights state. SEAT_FOOTWELL_LIGHTS_STATE reflects the current state of the lights at any point in time. This is different from the function of SEAT_FOOTWELL_LIGHTS_SWITCH which represents the position of the switch controlling the lights.

Therefore, SEAT_FOOTWELL_LIGHTS_STATE may not match the value of SEAT_FOOTWELL_LIGHTS_SWITCH (for example, SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC and SEAT_FOOTWELL_LIGHTS_SWITCH=ON).

This property should only be implemented if SEAT_FOOTWELL_LIGHTS_STATE 's value may be different from that of CABIN_LIGHTS_STATE.

For each supported area ID, the VehicleAreaConfig#supportedEnumValues must be defined unless all enum values of VehicleLightState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 14

SEAT_FOOTWELL_LIGHTS_SWITCH

Represents property for the seat footwell lights switch. SEAT_FOOTWELL_LIGHTS_SWITCH represents the position of the switch controlling the lights. This is different from the function of SEAT_FOOTWELL_LIGHTS_STATE which reflects the current state of the lights at any point in time. Therefore, SEAT_FOOTWELL_LIGHTS_SWITCH may not match the value of SEAT_FOOTWELL_LIGHTS_STATE (for example, SEAT_FOOTWELL_LIGHTS_SWITCH=AUTOMATIC and SEAT_FOOTWELL_LIGHTS_SWITCH=ON).

This property should only be implemented if SEAT_FOOTWELL_LIGHTS_SWITCH's value may be different from that of CABIN_LIGHTS_SWITCH.

For each supported area ID, the VehicleAreaConfig#supportedEnumValues must be defined unless all enum values of VehicleLightSwitch are supported.

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

SEAT_FORE_AFT_MOVE

Seat fore and aft move. This property moves the entire seat forward/backward in the direction that it is facing.

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 seat while moving forward. The minInt32Value represents the maximum movement speed of the seat while moving backward.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat reaches the positional limit, the value must reset to 0. If the value of SEAT_FORE_AFT_MOVE is 0, no movement is occurring.

This property is represented as 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

SEAT_FORE_AFT_POS

Seat fore and aft position. Sets the seat position forward and backward.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the seat is at its rearward-most linear position. The maxInt32Value indicates the seat is at its forward-most linear position. Values between minInt32Value and maxInt32Value indicate a transition state between the closest and farthest positions.

This property is represented as 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

SEAT_HEADREST_ANGLE_MOVE

Headrest angle 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 seat's headrest while moving into an upright or forward position. The minInt32Value represents the maximum movement speed of the seat's headrest while moving into a shallow position.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat's headrest reaches the positional limit, the value must reset to 0. If the value of SEAT_HEADREST_ANGLE_MOVE is 0, thenno movement is occurring.

This property is represented as a specified range of relative movement speeds.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as only..

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_HEADREST_ANGLE_POS

Headrest angle position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the headrest is in its full recline position. The maxInt32Value indicates the headrest is in its most upright and forward position.

Values in between minInt32Value and maxInt32Value indicate a transition state between the full recline and most upright and forward positions.

This property is represented as 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

SEAT_HEADREST_FORE_AFT_MOVE

Headrest fore and aft 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 seat's headrest while moving forward. The minInt32Value represents the maximum movement speed of the seat's headrest while moving backward.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat's headrest reaches the positional limit, the value must reset to 0. If the value of SEAT_HEADREST_FORE_AFT_MOVE is 0, then no movement is occurring.

This property is represented as 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

SEAT_HEADREST_FORE_AFT_POS

Headrest fore and aft position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the headrest is in its rearward-most linear position. The maxInt32Value indicates the headrest is in its forward-most linear position.

Values between minInt32Value and maxInt32Value indicate a transition state between the forward and backward positions.

This property is represented as 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

SEAT_HEADREST_HEIGHT_MOVE

Headrest height 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 seat's headrest while moving up. The minInt32Value represents the maximum movement speed of the seat's headrest while moving down.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat's headrest reaches the positional limit, the value must reset to 0. If the value for SEAT_HEADREST_HEIGHT_MOVE is 0, then no movement is occurring.

This property is represented as 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

SEAT_HEADREST_HEIGHT_POS

(Deprecated) Headrest height position.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_HEADREST_HEIGHT_POS_V2

Headrest height position. Sets the headrest height for supported seats. VehiclePropConfig.areaConfigs specifies which seats are supported.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the headrest is in its lowest position. The maxInt32Value indicates the headrest is in its highest position.

Values in between minInt32Value and maxInt32Value indicate a transition state between the lowest and highest positions.

This property is represented as 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 14

SEAT_HEIGHT_MOVE

Seat height move. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

maxInt32Value represents the maximum movement speed of the seat when moving up.

minInt32Value represents the maximum movement speed of the seat when moving down.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat reaches the positional limit, the value must reset to 0. If the value of SEAT_HEIGHT_MOVE value is 0, no movement is occurring.

This property is represented as 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

SEAT_HEIGHT_POS

Seat height position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the seat is in its lowest position. The maxInt32Value indicates the seat is in its highest position.

Values in between minInt32Value and maxInt32Value indicate a transition state between the lowest and highest positions.

This property is represented as 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

SEAT_LUMBAR_FORE_AFT_MOVE

Lumbar fore and aft 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 seat's lumbar support while moving forward. The minInt32Value represents the maximum movement speed of the seat's lumbar support while moving backward.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat's lumbar support reaches the positional limit, the value must reset to 0. If the value of SEAT_LUMBAR_FORE_AFT_MOVE is 0, then no movement is occurring.

This property is represented as 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

SEAT_LUMBAR_FORE_AFT_POS

Lumber fore and aft position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported.

The minInt32Value indicates the lumbar support is in its rearward most position (for example, least supportive position). The maxInt32Value indicates the lumbar support is in its forward most position (for example, most supportive position).

Values in between minInt32Value and maxInt32Value indicate a transition state between the forward and rearward positions.

This property is represented as 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 type: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

Lumbar side support 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 seat's lumbar side support while getting wider. The minInt32Value represents the maximum movement speed of the seat's lumbar side support while getting thinner.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat's lumbar side support reaches the positional limit, the value must reset to 0. If the value of SEAT_LUMBAR_SIDE_SUPPORT_MOVE 0, then no movement is occurring.

This property is represented as 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 type: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_LUMBAR_SIDE_SUPPORT_POS

Lumbar side support position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the lumbar side support is in its thinnest position (for example, most support). The maxInt32Value indicates the lumbar side support is in its widest position (for example, least support).

Values in between minInt32Value and maxInt32Value indicate a transition state between the thinnest and widest positions.

This property is represented as 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 type: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

SEAT_LUMBAR_VERTICAL_MOVE

Represents property for vertical movement direction and speed of seat lumbar support.

The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The maxInt32Value indicates the lumbar support is moving at the fastest upward speed. The minInt32Value indicates the lumbar support is moving at the fastest down speed.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat cushion side support reaches the positional limit, the value must reset to 0. If the value of SEAT_LUMBAR_VERTICAL_MOVE's is 0, then no movement is occurring.

This property is represented as 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 14

SEAT_LUMBAR_VERTICAL_POS

Represents property for seat's lumbar support vertical position. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. maxInt32Value indicates the lumbar support's highest position. minInt32Value indicates the lumbar support's lowest position.

Values in between minInt32Value and maxInt32Value indicate a transition state between the lowest and highest positions.

This property is represented as 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

SEAT_MEMORY_SELECT

This parameter selects the memory preset to use to select the seat position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value is always 0, and the maxInt32Value determines the number of seat preset memory slots available (for example, numSeatPresets - 1). For instance, if the driver's seat has three memory presets, the maxInt32Value is two. When the user selects a preset, the desired preset number (0, 1, or 2) is set.

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_MEMORY_SET

This setting allows the user to save the current seat position settings into the selected preset slot. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. The minInt32Value must be 0, and the maxInt32Value for each seat position must match the maxInt32Value for SEAT_MEMORY_SELECT

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

SEAT_OCCUPANCY

Indicates if a specific seat is occupied, to the best of the car's ability to determine. Valid values are from the VehicleSeatOccupancyState enum.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleSeatOccupancyState
Unit type: N/A
Release: Android 13

SEAT_TILT_MOVE

Seat tilt 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 front edge of the seat while moving up. The minInt32Value represents the maximum movement speed of the front edge of the seat while moving down.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the seat bottom reaches the positional limit, the value must reset to 0. If SEAT_TILT_MOVE's value is currently 0, no movement is underway.

This property is represented as 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

SEAT_TILT_POS

Seat tilt position. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the seat bottom is angled at its lowest angular position. This corresponds to the seat's front edge at its lowest possible position relative to the rear end of the seat. The maxInt32Value indicates the seat bottom is angled at its highest angular position. This corresponds to the seat's front edge at its highest possible position relative to the rear end of the seat.

Values in between minInt32Value and maxInt32Value indicate a transition state between the lowest and highest positions.

This property is represented as 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 14

SEAT_WALK_IN_POS

Represents property that indicates the current walk-in position of the seat. The minInt32Value indicates the normal seat position. The minInt32Value must be 0. The maxInt32Value indicates the seat is in the full walk-in position.

Values in between minInt32Value and maxInt32Value indicate a transition state between the normal and walk-in positions.

This property is represented as a specified range of relative positions.

The area ID must match the seat that actually moves when the walk-in feature activates, not the intended seat the passengers will sit in.

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SHUTDOWN_REQUEST

Request the head unit to be shu down.

This is required for executing a task when the head unit is powered off (remote task feature). After the head unit is powered-on to execute the task, the head unit should be shut down. The head unit sends this message once the task is finished.

This property doesn't apply when a user wants to shut down the head unit.

This usually involves telling a separate system outside the head unit (for instance a power controller) to prepare to shut down the head unit.

The external system must validate that this request is valid by checking if the vehicle is in use. If a user enters the vehicle after a SHUTDOWN_REQUEST is sent, then the system must ignore this request. It is recommended to store a VehicleInUse property in the power controller and exposes it through VEHICLE_IN_USE property. A shutdown request must be ignored if VehicleInUse is true.

If allowed, the external system sends a shutdown signal to the head unit, which causes VHAL to send SHUTDOWN_PREPARE message to Android. Android will then start the shut down process by handling the message.

This property is only for issuing a request and only supports writing. Every time this property value is set, the request to shutdown is issued no matter what the current property value is. The current property value is meaningless.

Since this property is write-only, subscribing is not allowed and no property change event is generated.

The value to set indicates the shutdown option, it must be one of {@code VehicleApPowerStateShutdownParam} For example, VehicleApPowerStateShutdownParam.SLEEP_IMMEDIATELY. This shutdown option might not be honored if the system doesn't support such option. In such a case, an error is not returned.

For configuration information, VehiclePropConfig.configArray must have bit flag combining values in {@code VehicleApPowerStateConfigFlag} to indicate which shutdown options are supported.

Returns error if failed to send the shutdown request to the other system.

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: VehicleApPowerStateShutdownParam>
Unit type: N/A
Release: Android 14

STEERING_WHEEL_DEPTH_MOVE

Steering wheel depth movement. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All values between minInt32Value and maxInt32Value must be supported.

The maxInt32Value indicates the steering wheel moving away from the driver. The minInt32Value indicates the steering wheel moving towards the driver.

Larger integers, either positive or negative, indicate a faster movement speed. Once the steering wheel reaches the positional limit, the value must reset to 0. If the value of STEERING_WHEEL_DEPTH_MOVE is currently 0, no movement is underway.

This property is represented as 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 14

STEERING_WHEEL_DEPTH_POS

Steering wheel depth position. All steering wheel properties' unique ids start from 0x0BE0.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All values between minInt32Value and maxInt32Value must be supported. The maxInt32Value indicates the steering wheel position furthest from the driver. The minInt32Value indicates the steering wheel position closest to the driver.

Values in between minInt32Value and maxInt32Value indicate a transition state between the

This property is represented as 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 14

STEERING_WHEEL_EASY_ACCESS_ENABLED

Steering wheel easy access feature enabled. If true, the driver's steering wheel is automatically adjusted to make it easier for the driver to enter and exit the vehicle.

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

STEERING_WHEEL_HEIGHT_MOVE

Steering wheel height movement. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All values between minInt32Value and maxInt32Value must be supported.

The maxInt32Value indicates the steering wheel moving up. The minInt32Value indicates the steering wheel moving down.

Larger integers, either positive or negative, indicate a faster movement speed. Once the steering wheel reaches the positional limit, the value must reset to 0. If STEERING_WHEEL_HEIGHT_MOVE's value is currently 0, then that means there is no movement currently occurring.

This property is represented as 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 14

STEERING_WHEEL_HEIGHT_POS

Steering wheel height position.

The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. All values between minInt32Value and maxInt32Value must be supported. The maxInt32Value indicates the steering wheel being in the highest position. The minInt32Value indicates the steering wheel being in the lowest position.

Values in between minInt32Value and maxInt32Value indicate a transition state between the lowest and highest positions.

This property is represented as 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 14

STEERING_WHEEL_LIGHTS_STATE

Steering wheel lights state. Represents the current state of the steering wheel lights. This is different from STEERING_WHEEL_LIGHTS_SWITCH which represents the position of the switch controlling the lights. Therefore, STEERING_WHEEL_LIGHTS_STATE may not match the value of STEERING_WHEEL_LIGHTS_SWITCH (for example, STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC and STEERING_WHEEL_LIGHTS_STATE=ON).

This property should only be implemented if STEERING_WHEEL_LIGHTS_STATE's value may be different from that of CABIN_LIGHTS_STATE.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues must be defined unless all enum values of VehicleLightState are supported.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleLightState
Unit type: N/A
Release: Android 14

STEERING_WHEEL_LIGHTS_SWITCH

Steering wheel lights switch. Represents the position of the switch controlling the steering wheel lights. This differs from , which represents the current state of the steering wheel lights. Therefore, STEERING_WHEEL_LIGHTS_SWITCH may not match the value of STEERING_WHEEL_LIGHTS_STATE. For example, STEERING_WHEEL_LIGHTS_SWITCH=AUTOMATIC and STEERING_WHEEL_LIGHTS_STATE=ON.

This property should only be implemented if the value for STEERING_WHEEL_LIGHTS_SWITCH can differ from that of CABIN_LIGHTS_SWITCH.

For the global area ID (0), the VehicleAreaConfig#supportedEnumValues must be defined unless all enum values of VehicleLightSwitch are supported.

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 14

STEERING_WHEEL_LOCKED

Steering wheel locked. If true, the steering wheel's position is locked and not changeable. This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as only./p>

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: N/A
Unit type: N/A
Release: Android 14

STEERING_WHEEL_THEFT_LOCK_ENABLED

Steering wheel theft lock feature enabled. If true, the steering wheel locks automatically to prevent theft in certain situations. 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

STORAGE_ENCRYPTION_BINDING_SEED

External encryption binding seed. This value is mixed with the local key storage encryption key. This property holds 16 bytes, and is expected to be persisted on an ECU separate from the IVI. The property is initially set by AAOS, who generates it using a CSRNG. AAOS then reads the property on subsequent boots. The binding seed is expected to be reliably persisted. Any loss of the seed results in a factory reset of the IVI.

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

SUPPORT_CUSTOMIZE_VENDOR_PERMISSION

Support customize permissions for vendor properties.

Implement this property if VHAL support customize vendor permissions feature. VehiclePropConfig.configArray is used to indicate vendor properties and permissions which selected for this vendor property. The permission must be one of enum in VehicleVendorPermission. The configArray is set as follows, configArray[n]: propId : property ID for the vendor property where configArray[n+1] is an enum in VehicleVendorPermission and indicates the permission for reading the value of the property.

configArray[n+2] is an enum in VehicleVendorPermission and indicates the permission for writing a value of the property. For example:

configArray: { vendor_prop_1, PERMISSION_VENDOR_SEAT_READ, PERMISSION_VENDOR_SEAT_WRITE, vendor_prop_2, PERMISSION_VENDOR_INFO, PERMISSION_NOT_ACCESSIBLE, }

If vendor properties are not in this array, they have the default vendor permission. If vendor chose PERMISSION_NOT_ACCESSIBLE, Android does not have access to the property. In the example, Android can not write a value for vendor_prop_2.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

SUPPORTED_PROPERTY_IDS

(Deprecated) List of all supported property IDs.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 14

SWITCH_USER

Defines a request to switch the foreground Android user.

This property is used primarily by the Android system to inform the HAL that the current foreground Android user is switching, but it could also be used by the HAL to request the Android system to switch users. When the request is made by Android, it sets a VehiclePropValue and the HAL must respond with a property change event. When the HAL makes the request, it must also do it through a property change event (the main difference is that the request id is positive in the former case, and negative in the latter). The SwitchUserMessageType also differs.

• LEGACY_ANDROID_SWITCH Called by the Android system to indicate the Android user is about to change, when the change request was made in a way that is not integrated with the HAL (for example, through adb shell am switch-user). The HAL can switch its internal user once it receives this request, but it doesn't need to reply back to the Android system. If its internal user cannot be changed for some reason, then it must wait for the SWITCH_USER(type=ANDROID_POST_SWITCH) call to recover (for example, it could issue a SWITCH_USER(type=VEHICLE_REQUEST) to switch back to the previous user). Ideally it should never fail (as switching back could confuse the end user).
  For example, if the system have users (0, 10, 11) and it's switching from 0 to 11 (where none of them have any special flag), the request would be:
  
  • int32[0] 42 // request id
  • int32[1] 1 // SwitchUserMessageType::LEGACY_ANDROID_SWITCH
  • int32[2] 11 // target user id
  • int32[3] 0 // target user flags (none)
  • int32[4] 10 // current user
  • int32[5] 0 // current user flags (none)
  • int32[6] 3 // number of users
  • int32[7] 0 // user #0 (Android user id 0)
  • int32[8] 0 // flags of user #0 (none)
  • int32[9] 10 // user #1 (Android user id 10)
  • int32[10] 0 // flags of user #1 (none)
  • int32[11] 11 // user #2 (Android user id 11)
  • int32[12] 0 // flags of user #2 (none)
• ANDROID_SWITCH Called by the Android system to indicate the Android user is about to change, but Android waits for the HAL's response (up to some time) before proceeding. The HAL must switch its internal user once it receives this request, then respond back to Android with a SWITCH_USER(type=VEHICLE_RESPONSE) indicating whether its internal user was switched or not (through the SwitchUserStatus enum). For example, if Android has users (0, 10, 11) and it's switching from 10 to 11 (where none of them have any special flag), the request would be:
  • int32[0] 42 // request id
  • int32[1] 2 // SwitchUserMessageType::ANDROID_SWITCH
  • int32[2] 11 // target user id
  • int32[3] 0 // target user flags (none)
  • int32[4] 10 // current user
  • int32[5] 0 // current user flags (none)
  • int32[6] 3 // number of users
  • int32[7] 0 // first user (user 0)
  • int32[8] 1 // first user flags (SYSTEM)
  • int32[9] 10 // second user (user 10)
  • int32[10] 0 // second user flags (none)
  • int32[11] 11 // 3rd user (user 11)
  • int32[12] 0 // 3rd user flags (none)

  If the request succeeds, the HAL must update the property with:

  • int32[0] 42 // request id
  • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
  • int32[2] 1 // status: SwitchUserStatus::SUCCESS

  If the request fails, the response would be something like:

  • int32[0] 42 // request id
  • int32[1] 3 // messageType: SwitchUserMessageType::VEHICLE_RESPONSE
  • int32[2] 2 // status: SwitchUserStatus::FAILURE string: "108-D'OH!"
  • OEM-specific error message
• VEHICLE_RESPONSE Called by the HAL to indicate whether a request of type ANDROID_SWITCH should proceed or abort. See also ANDROID_SWITCH.
• VEHICLE_REQUEST Called by the HAL to request that the current foreground Android user is switched. This is useful in situations where Android started as one user, but the vehicle identified the driver as another user. For example, user A unlocked the car using the key fob of user B. The INITIAL_USER_INFO request returned user B, but then a face recognition subsubsystem identified the user as A. The HAL makes this request by a property change event (passing a negative request id), and the Android system response is to issue an ANDROID_POST_SWITCH call which the same request id. For example, if the current foreground Android user is 10 and the HAL asked to switch to 11, the request would be:
  • int32[0] -108 // request id
  • int32[1] 4 // messageType: SwitchUserMessageType::VEHICLE_REQUEST
  • int32[2] 11 // Android user id

  If the request succeeded and Android has three users (0, 10, and 11), the response would be:

  • int32[0] -108 // request id
  • int32[1] 5 // messageType: SwitchUserMessageType::ANDROID_POST_SWITCH
  • int32[2] 11 // target user id
  • int32[3] 0 // target user id flags (none)
  • int32[4] 11 // current user
  • int32[5] 0 // current user flags (none)
  • int32[6] 3 // number of users
  • int32[7] 0 // first user (user 0)
  • int32[8] 0 // first user flags (none)
  • int32[9] 10 // second user (user 10)
  • int32[10] 4 // second user flags (none)
  • int32[11] 11 // third user (user 11)
  • int32[12] 3 // third user flags (none)

  The current and target user ids are the same. If the request fails, then they would differ. For example, the target user would be 11 and the current user would remain 10.

• ANDROID_POST_SWITCH Called by the Android system after a request to switch a user was made. This property is called after switch requests of any type (for example, >code>LEGACY_ANDROID_SWITCH, >code>ANDROID_SWITCH, or VEHICLE_REQUEST) and can be used to determine if the request succeeded or failed.
  • When it succeeds, it's called when the Android user is in the unlocked state and the value of the current and target users ids in the response are the same. This is equivalent to receiving an Intent.ACTION_USER_UNLOCKED in an Android app.
  • When it fails, it's called right away and the value of the current and target users ids in the response differ (since the current user didn't change to the target).
  • If a new switch request is made before the HAL responded to the previous one or before the user was unlocked, then the ANDROID_POST_SWITCH request is not made. For example, the driver might accidentally switch to the wrong user, which has lock credentials, and then switch to the correct user before entering the credentials.

  The HAL can update its internal state once it receives this request, but it needn't reply to the Android system.

  • Request. The first N values as defined by INITIAL_USER_INFO (where the request-specific value at index 1 is SwitchUserMessageType::ANDROID_POST_SWITCH), then two more values for the target user id (for example, the Android user id that was requested to be switched to) and its flags (as defined by UserFlags).
  • Response: none. For example, see VEHICLE_REQUEST

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

TIRE_PRESSURE

Tire pressure. Each tire is identified by its areaConfig.areaId config. The respective minFloatValue and maxFloatValue are used to store the OEM- recommended pressure range. Values for minFloatValue and maxFloatValue in VehicleAreaConfig must be defined.

The minFloatValue in the areaConfig data represents the lower bound of the recommended tire pressure. The maxFloatValue in the areaConfig data represents the upper bound of the recommended tire pressure. For example, this areaConfig indicates the recommended tire pressure of left_front tire as from 200.0kPa to 240.0kPa.

.areaConfigs: { VehicleAreaConfig { .areaId: VehicleAreaWheel::LEFT_FRONT, .minFloatValue: 200.0, .maxFloatValue: 240.0, } }

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOPASCAL
Release: Android 13

TIRE_PRESSURE_DISPLAY_UNITS

Tire pressure units for display. Indicates which units the car is using to display tire pressure to the user. For example, PSI, Bar or Kilopascal. VehiclePropConfig.configArray is used to indicate the supported pressure display units. Pressure units are defined in VehicleUnit. For example, configArray[0]: KILOPASCAL configArray[1]: PSI configArray[2]: BAR

If updating TIRE_PRESSURE_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 only./p>

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: VehicleUnit
Unit type: N/A
Release: Android 13

TRACTION_CONTROL_ACTIVE

Set to true when traction control (TC) is active and reset to false when TC is off. This property can be intermittently set (pulse) based on the real-time state of the TC system.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

TRAILER_PRESENT

Returns the trailer state of the car.

Change mode: ON_CHANGE
Access mode: READ
Enum type: TrailerState
Unit type: N/A
Release: Android 13

TURN_SIGNAL_STATE

State of the vehicles turn signals.

Change mode: ON_CHANGE
Access mode: READ
Enum type: VehicleTurnSignal
Unit type: N/A
Release: Android 13

USER_IDENTIFICATION_ASSOCIATION

Property used to associate (or query the association) the current user with vehicle-specific identification mechanisms (such as key FOB).

This is an optional user management property. The OEM can still support user management without defining it. In fact, this property could be used without supporting the core user-related functions described on INITIAL_USER_INFO.

To query the association, the Android system gets the property, passing a VehiclePropValue containing the types of associations are being queried, as defined by UserIdentificationGetRequest. The HAL must return right away, returning a VehiclePropValue with a UserIdentificationResponse.

Notice that user identification took place while the system was booting up. takehe VHAL implementation should only return the already identified association (such as the key FOB used to unlock the car), instead of starting a new association from the get call.

To associate types, the Android system sets the property, passing a VehiclePropValue containing the types and values of associations being set, as defined by the UserIdentificationSetRequest.

The HAL then uses a property change event (whose VehiclePropValue is defined by UserIdentificationResponse) indicating the current status of the types after the request.

For example, to query if the current user (10) is associated with the FOB that unlocked the car and a custom mechanism provided by the OEM, the request is:

• int32[0] 42 // request id
• int32[1] 10 (Android user id)
• int32[2] 0 (Android user flags)
• int32[3] 2 (number of types queried)
• int32[4] 1 (first type queried, UserIdentificationAssociationType::KEY_FOB)
• int32[5] 101 (second type queried, UserIdentificationAssociationType::CUSTOM_1)

If the user is associated with the FOB but not with the custom mechanism, the response is:

• int32[0] 42 // request id
• int32[1] 2 (number of associations in the response)
• int32[2] 1 (first type: UserIdentificationAssociationType::KEY_FOB)
• int32[3] 2 (first value: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)
• int32[4] 101 (first type: UserIdentificationAssociationType::CUSTOM_1)
• int32[5] 4 (second value: UserIdentificationAssociationValue::NOT_ASSOCIATED_ANY_USER)

Then to associate the user with the custom mechanism, a set request is made:

• int32[0] 43 // request id
• int32[1] 10 (Android user id)
• int32[2] 0 (Android user flags)
• int32[3] 1 (number of associations being set)
• int32[4] 101 (first type: UserIdentificationAssociationType::CUSTOM_1)

If the request succeeded, the response would be:

• int32[0] 43 // request id
• int32[1] 1 (number of associations in the response)
• int32[2] 101 (first type: UserIdentificationAssociationType::CUSTOM_1)
• int32[3] 1 (first value: UserIdentificationAssociationValue::ASSOCIATED_CURRENT_USER)

The set request adds associations but doesn't remove the existing associations. In the previous example, the end state would be two associations (FOB and CUSTOM_1). To associate the user with just CUSTOM_1 but not FOB, then the request would have been:

• int32[0] 43 // request id
• int32[1] 10 (Android user id)
• int32[2] 2 (number of types set)
• int32[3] 1 (first type: UserIdentificationAssociationType::KEY_FOB)
• int32[4] 2 (first value: UserIdentificationAssociationValue::DISASSOCIATE_CURRENT_USER)
• int32[5] 101 (second type: UserIdentificationAssociationType::CUSTOM_1)
• int32[6] 1 (second value: UserIdentificationAssociationValue::ASSOCIATE_CURRENT_USER)

Change mode: ON_CHANGE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

VEHICLE_CURB_WEIGHT

Returns the vehicle's curb weight in kilograms. Curb weight is the total weight of the vehicle with standard equipment and all necessary operating consumables such as motor oil, transmission oil, brake fluid, coolant, air conditioning refrigerant, and weight of fuel at nominal tank capacity while not loaded with either passengers or cargo.

configArray[0] is used to specify the vehicle's gross weight in kilograms. The vehicle's gross weight is the maximum operating weight of the vehicle as specified by the manufacturer including the vehicle's chassis, body, engine, engine fluids, fuel, accessories, driver, passengers and cargo but excluding that of any trailers.

Change mode: STATIC
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:KILOGRAM
Release: Android 13

VEHICLE_IN_USE

Indicates if the vehicle is in use. In use means a human user is present and intendeds to use the vehicle. This doesn't necessarily mean the human user is in the vehicle. For example, if the human user unlocks the vehicle remotely, the vehicle is considered to be in use. If this property is supported:

• Each time the user powers on the vehicle or the system detects the user is present, VEHICLE_IN_USE must be set to true. Each time the user powers off the vehicle or the system detects the user is not present, VEHICLE_IN_USE must be set to false.
• If the user powers off the vehicle or the system detects the user is not present, VEHICLE_IN_USE must be set to false.
• If the user powers on the vehicle or the system detects the user is present, VEHICLE_IN_USE must be set to true.

This property differs from AP_POWER_BOOTUP_REASON in the sense that AP_POWER_BOOTUP_REASON is only set once during system boot. However, this property might change multiple times during a system boot cycle. For example, a device is currently not in use. The system bootup to execute a remote task. VEHICLE_IN_USE is false. While the remote task is executing, the user enters the vehicle and powers on the vehicle. VEHICLE_IN_USE is set to true. After a driving session, user powers off the vehicle, VEHICLE_IN_USE is set to false.

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

VEHICLE_MAP_SERVICE

Vehicle Maps Service (VMS) message. This property uses MIXED data to communicate VMS messages. Its contents are to be interpreted as follows. The indices defined in VmsMessageIntegerValuesInde are used to read from int32Values. bytes is a serialized VMS message as defined in the VMS protocol, which is opaque to the framework. IVehicle#get must always return StatusCode::NOT_AVAILABLE.

Change mode: ON_CHANGEREAD_WRITE
Access mode: READ_WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

VEHICLE_SPEED_DISPLAY_UNITS

Speed units for display. Indicates the type of units used to display speed to the user. For example, m/s, km/h, or mph. VehiclePropConfig.configArray indicates the supported speed display units. Pressure units are defined in VehicleUnit. For example:

.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

If updating VEHICLE_SPEED_DISPLAY_UNITS affects the values of other *_DISPLAY_UNITS properties, then those values must be updated and communicated to the AAOS framework.

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

VHAL_HEARTBEAT

Defines an event that VHAL signals to Car Watchdog as a heartbeat. If VHAL supports this property, VHAL should write system uptime to this property at every three seconds. Car Watchdog subscribes to this property and checks if the property is updated every three seconds. With the buffer time of three seconds, Car Watchdog waits for a heartbeat to be signaled up to six seconds from the last heartbeat. If not, Car Watchdog considers VHAL unhealthy and terminates it. If this property is not supported by VHAL, Car Watchdog doesn't check VHAL health status.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

WATCHDOG_ALIVE

Defines an event that Car Watchdog updates to indicate it's active. Car Watchdog sets this property to system uptime in milliseconds at every three seconds. While booting, the update could take longer.

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

WATCHDOG_TERMINATED_PROCESS

Defines a process terminated by Car Watchdog and the reason for the termination.

int32Values[0] 1  // ProcessTerminationReason showing why a process is terminated. string: "/system/bin/log" // Process execution command

Change mode: ON_CHANGE
Access mode: WRITE
Enum type: N/A
Unit type: N/A
Release: Android 13

WHEEL_TICK

Reports wheel ticks. The first element in the vector is a reset count. A reset indicates previous tick counts are not comparable with this and future ones. Some sort of discontinuity in tick counting has occurred.

The next four elements represent ticks for individual wheels in the following order:

1. Front left
2. Front right
3. Rear right
4. Rear left

All tick counts are cumulative. Tick counts increment when the vehicle moves forward, and decrement when the vehicle moves backward. The ticks should be reset to 0 when the vehicle is started.

• int64Values[0] Reset count
• int64Values[1] Front left ticks
• int64Values[2] Front right ticks
• int64Values[3] Rear right ticks
• int64Values[4] Rear left ticks

configArray is used to indicate the micrometers-per-wheel-tick value and which wheels are supported configArray is set as follows:

configArray[0], bits [0:3] Supported wheels

Uses enum Wheel. For example, if all wheels are supported, then:

• configArray[0] VehicleAreaWheel::LEFT_FRONT | VehicleAreaWheel::RIGHT_FRONT | VehicleAreaWheel::LEFT_REAR | VehicleAreaWheel::RIGHT_REAR
• configArray[1] Micrometers per front left wheel tick
• configArray[2] Micrometers per front right wheel tick
• configArray[3] Micrometers per rear right wheel tick
• configArray[4] Micrometers per rear left wheel tick.

If a wheel is not supported, its value shall always be set to 0.

The VehiclePropValue.timestamp must be filled in.

Change mode: CONTINUOUS
Access mode: READ
Enum type: N/A
Unit type: N/A
Release: Android 13

WINDOW_LOCK

Window child lock. True indicates the window is child-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

WINDOW_MOVE

Window move. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The maxInt32Value indicates the window is opening in plane/closing in the out of plane direction at the fastest speed. The minInt32Value indicates the window is closing in plane/opening in the out of plane direction at the fastest speed.

Larger absolute values, either positive or negative, indicate a faster movement speed. Once the window reaches the positional limit, the value must reset to 0. If the value of WINDOW_MOVE is 0, no movement is underway. This property is represented in a specified range of relative movement speeds.

For a window that may open out of plane (a vent mode of sunroof), this parameter works as follows. If:

• Sunroof is open:
  • Max Open the sunroof further, stop automatically when fully open.
  • Min Close the sunroof, stop automatically when sunroof is closed.
• Vent is open:
  • Max Close the vent, stop automatically stop when vent is closed.
  • Min Open the vent further, stop automatically when vent is fully open.
• Sunroof is closed:
  • Max Open the sunroof, stop automatically when sunroof is fully open.
  • Min Open the vent, stop automatically when vent is fully 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

WINDOW_POS

Window position. The maxInt32Value and minInt32Value in each VehicleAreaConfig must be defined. All integers between minInt32Value and maxInt32Value must be supported. The minInt32Value indicates the window is closed or fully open out of plane. If the window cannot open out of plane, then minInt32Value is the position of the window when fully closed and must be 0. If the window can open out of plane, the minInt32Value indicates the window is fully open in its position out of plane and is a negative value. See the example below for a more detailed explanation. The maxInt32Value indicates the window is fully open.

Values in between minInt32Value and maxInt32Value indicate a transition state between the closed/fully open out-of-plane and fully open positions. This property is not in any specific unit but in a specified range of relative positions. For example, this is how the property should work for a window that can move out of plane: For a window that may open out of plane (vent mode of sunroof) this parameter works with negative values as follows:

• Max Sunroof fully open (0 for sunroof closed).
• Min Sunroof vent fully open (0 for sunroof closed).

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

WINDSHIELD_WIPERS_PERIOD

Windshield wipers period (milliseconds). Returns the instantaneous time period for one full cycle of the windshield wipers in milliseconds. A full cycle is defined as a wiper moving from and returning to the rest position. When an intermittent wiper setting is selected, this property value must be set to 0 during the pause period of the intermittent wiping. The maxInt32Value and minInt32Value in VehicleAreaConfig must be defined. The maxInt32Value for each area ID must specify the longest wiper period. The minInt32Value must be set to 0 for each area ID.

Change mode: ON_CHANGE
Access mode: READ
Enum type: N/A
Unit type: VehicleUnit:MILLI_SECS
Release: Android 14

WINDSHIELD_WIPERS_STATE

Windshield wipers state. Returns the current state of the windshield wipers. The value of WINDSHIELD_WIPERS_STATE may not match the value of WINDSHIELD_WIPERS_SWITCH For example, WINDSHIELD_WIPERS_STATE: ON and WINDSHIELD_WIPERS_SWITCH: WindshieldWipersSwitch#AUTO If WINDSHIELD_WIPERS_STATE: ON and WINDSHIELD_WIPERS_PERIOD is implemented, then WINDSHIELD_WIPERS_PERIOD must reflect the time period of one full cycle of the wipers.

For each supported area ID, the VehicleAreaConfig#supportedEnumValues array must be defined unless all states in WindshieldWipersState are supported (including OTHER, which is not recommended).

Change mode: ON_CHANGE
Access mode: READ
Enum type: WindshieldWipersState
Unit type: N/A
Release: Android 14

WINDSHIELD_WIPERS_SWITCH

Windshield wipers switch. Represents the position of the switch controlling the windshield wipers. The value of WINDSHIELD_WIPERS_SWITCH may not match the value of WINDSHIELD_WIPERS_STATE For example, WINDSHIELD_WIPERS_SWITCH: AUTO and WINDSHIELD_WIPERS_STATE: WindshieldWipersState#ON For each supported area ID, the VehicleAreaConfig#supportedEnumValues array must be defined unless all states in WindshieldWipersSwitch are supported (including OTHER, which is not recommended).

This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs can implement it as VehiclePropertyAccess.READ only. If this property is implemented as VehiclePropertyAccess.READ_WRITE and the OTHER state is listed in the VehicleAreaConfig#supportedEnumValues array, then OTHER is not a supported value for writing It is only a supported value for reading.

Change mode: ON_CHANGE
Access mode: READ_WRITE/READ
Enum type: WindshieldWipersSwitch
Unit type: N/A
Release: Android 14