VehiclePropertyIds

public final class VehiclePropertyIds
extends Object

java.lang.Object
   ↳ android.car.VehiclePropertyIds

List of vehicle property IDs.

Property IDs are used with the CarPropertyManager APIs (e.g. CarPropertyManager.getProperty(int, int) or CarPropertyManager.setProperty(Class, int, int, Object)).

Summary

Constants

int ABS_ACTIVE

ABS is active.

int ACCELERATOR_PEDAL_COMPRESSION_PERCENTAGE

Accelerator pedal compression percentage.

int ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

Measured distance from leading vehicle when using Adaptive Cruise Control (ACC) or Predictive Cruise Control in millimeters.

int ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

Current target time gap for Adaptive Cruise Control (ACC) or Predictive Cruise Control in milliseconds.

int AP_POWER_BOOTUP_REASON

This constant is deprecated. use CarPowerManager instead.

int AP_POWER_STATE_REPORT

This constant is deprecated. use CarPowerManager instead.

int AP_POWER_STATE_REQ

This constant is deprecated. use CarPowerManager instead.

int AUTOMATIC_EMERGENCY_BRAKING_ENABLED

Enable or disable Automatic Emergency Braking (AEB).

int AUTOMATIC_EMERGENCY_BRAKING_STATE

Automatic Emergency Braking (AEB) state.

int BLIND_SPOT_WARNING_ENABLED

Enable and disable Blind Spot Warning (BSW).

int BLIND_SPOT_WARNING_STATE

Blind Spot Warning (BSW) state.

int BRAKE_FLUID_LEVEL_LOW

Brake fluid level low.

int BRAKE_PAD_WEAR_PERCENTAGE

Brake pad wear percentage.

int BRAKE_PEDAL_COMPRESSION_PERCENTAGE

Brake pedal compression percentage.

int CABIN_LIGHTS_STATE

Cabin lights.

int CABIN_LIGHTS_SWITCH

Cabin lights switch.

int CRITICALLY_LOW_TIRE_PRESSURE

Critically low tire pressure.

int CROSS_TRAFFIC_MONITORING_ENABLED

Enable or disable Cross Traffic Monitoring.

int CROSS_TRAFFIC_MONITORING_WARNING_STATE

Cross Traffic Monitoring Warning state.

int CRUISE_CONTROL_COMMAND

Write Cruise Control (CC) commands.

int CRUISE_CONTROL_ENABLED

Enable or disable Cruise Control (CC).

int CRUISE_CONTROL_STATE

Current state of Cruise Control (CC).

int CRUISE_CONTROL_TARGET_SPEED

Current target speed for Cruise Control (CC) in meters per second.

int CRUISE_CONTROL_TYPE

Current type of Cruise Control (CC).

int CURRENT_GEAR

Vehicle transmission's current VehicleGear.

int DISPLAY_BRIGHTNESS

This constant is deprecated. use CarPowerManager instead.

int DISTANCE_DISPLAY_UNITS

Distance units for display.

int DOOR_CHILD_LOCK_ENABLED

Door child lock feature enabled.

int DOOR_LOCK

Door lock.

int DOOR_MOVE

Door move.

int DOOR_POS

Door position.

int DRIVER_DISTRACTION_STATE

Driver distraction state.

int DRIVER_DISTRACTION_SYSTEM_ENABLED

Enable or disable driver distraction monitoring.

int DRIVER_DISTRACTION_WARNING

Driver distraction warning.

int DRIVER_DISTRACTION_WARNING_ENABLED

Enable or disable driver distraction warnings.

int DRIVER_DROWSINESS_ATTENTION_STATE

Driver drowsiness and attention level state.

int DRIVER_DROWSINESS_ATTENTION_SYSTEM_ENABLED

Enable or disable driver drowsiness and attention monitoring.

int DRIVER_DROWSINESS_ATTENTION_WARNING

Driver drowsiness and attention warning.

int DRIVER_DROWSINESS_ATTENTION_WARNING_ENABLED

Enable or disable driver drowsiness and attention warnings.

int ELECTRONIC_STABILITY_CONTROL_ENABLED

Enable or disable Electronic Stability Control (ESC).

int ELECTRONIC_STABILITY_CONTROL_STATE

Electronic Stability Control (ESC) state.

int ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

Electronic Toll Collection card status.

int ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

Electronic Toll Collection card type.

int EMERGENCY_LANE_KEEP_ASSIST_ENABLED

Enable or disable Emergency Lane Keep Assist (ELKA).

int EMERGENCY_LANE_KEEP_ASSIST_STATE

Emergency Lane Keep Assist (ELKA) state.

int ENGINE_COOLANT_TEMP

Temperature of engine coolant in celsius.

int ENGINE_IDLE_AUTO_STOP_ENABLED

Represents feature for engine idle automatic stop.

int ENGINE_OIL_LEVEL

Engine oil level.

int ENGINE_OIL_TEMP

Temperature of engine oil in celsius.

int ENGINE_RPM

Engine rpm.

int ENV_OUTSIDE_TEMPERATURE

Outside temperature in celsius.

int EPOCH_TIME

Current date and time, encoded as Unix time.

int EV_BATTERY_AVERAGE_TEMPERATURE

EV battery average temperature

Exposes the temperature of the battery in an EV.

int EV_BATTERY_DISPLAY_UNITS

EV battery units for display.

int EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

EV instantaneous charge rate in milliwatts.

int EV_BATTERY_LEVEL

EV battery level.

int EV_BRAKE_REGENERATION_LEVEL

Regenerative braking level of an electronic vehicle.

int EV_CHARGE_CURRENT_DRAW_LIMIT

The vehicle's selected alternating current (AC) EV charging draw limit in Amperes.

int EV_CHARGE_PERCENT_LIMIT

EV charge percent limit.

int EV_CHARGE_PORT_CONNECTED

EV charge port connected.

int EV_CHARGE_PORT_OPEN

EV charge port open.

int EV_CHARGE_STATE

Charging state of the car.

int EV_CHARGE_SWITCH

Start or stop charging the EV battery.

int EV_CHARGE_TIME_REMAINING

Estimated charge time remaining in seconds.

int EV_CURRENT_BATTERY_CAPACITY

Current usable battery capacity for EV or hybrid vehicle.

int EV_REGENERATIVE_BRAKING_STATE

Regenerative braking or one-pedal drive setting on the car.

int EV_STOPPING_MODE

Represents property for the current stopping mode of the vehicle.

int FOG_LIGHTS_STATE

Fog light state.

int FOG_LIGHTS_SWITCH

Fog light switch.

int FORWARD_COLLISION_WARNING_ENABLED

Enable or disable Forward Collision Warning (FCW).

int FORWARD_COLLISION_WARNING_STATE

Forward Collision Warning State (FCW) state.

int FRONT_FOG_LIGHTS_STATE

Front fog lights state.

int FRONT_FOG_LIGHTS_SWITCH

Front fog lights switch.

int FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

Fuel consumption units for display.

int FUEL_DOOR_OPEN

Fuel door open.

int FUEL_LEVEL

Fuel level in milliliters.

int FUEL_LEVEL_LOW

Warning for fuel low level.

int FUEL_VOLUME_DISPLAY_UNITS

Fuel volume units for display.

int GEAR_SELECTION

Currently selected gear by user.

int GENERAL_SAFETY_REGULATION_COMPLIANCE

EU's General security regulation compliance requirement.

int GLOVE_BOX_DOOR_POS

Property that represents the current position of the glove box door.

int GLOVE_BOX_LOCKED

Lock or unlock the glove box.

int HANDS_ON_DETECTION_DRIVER_STATE

Hands On Detection (HOD) driver state.

int HANDS_ON_DETECTION_ENABLED

Enable or disable Hands On Detection (HOD).

int HANDS_ON_DETECTION_WARNING

Hands On Detection (HOD) warning.

int HAZARD_LIGHTS_STATE

Hazard light status.

int HAZARD_LIGHTS_SWITCH

Hazard light switch.

int HEADLIGHTS_STATE

Headlights State.

int HEADLIGHTS_SWITCH

Headlight switch.

int HEAD_UP_DISPLAY_ENABLED

Head up display (HUD) enabled

This property allows the user to turn on/off the HUD for their seat.

int HIGH_BEAM_LIGHTS_STATE

High beam lights state.

int HIGH_BEAM_LIGHTS_SWITCH

High beam light switch.

int HVAC_ACTUAL_FAN_SPEED_RPM

Actual fan speed.

int HVAC_AC_ON

On/off AC for designated areaId.

int HVAC_AUTO_ON

On/off automatic mode.

int HVAC_AUTO_RECIRC_ON

Automatic recirculation on/off.

int HVAC_DEFROSTER

On/off defrost for designated window.

int HVAC_DUAL_ON

Enable temperature coupling between areas.

int HVAC_ELECTRIC_DEFROSTER_ON

ELECTRIC DEFROSTER.

int HVAC_FAN_DIRECTION

The current ERROR(CarHvacFanDirection/android.car.hardware.CarHvacFanDirection CarHvacFanDirection) setting.

int HVAC_FAN_DIRECTION_AVAILABLE

List of supported ERROR(CarHvacFanDirection/android.car.hardware.CarHvacFanDirection CarHvacFanDirection) values for the vehicle.

int HVAC_FAN_SPEED

Fan speed setting.

int HVAC_MAX_AC_ON

On/off max AC.

int HVAC_MAX_DEFROST_ON

On/off max defrost.

int HVAC_POWER_ON

Represents global power state for HVAC.

int HVAC_RECIRC_ON

Recirculation on/off.

int HVAC_SEAT_TEMPERATURE

Seat heating/cooling.

int HVAC_SEAT_VENTILATION

Seat ventilation.

int HVAC_SIDE_MIRROR_HEAT

Side Mirror Heat.

int HVAC_STEERING_WHEEL_HEAT

Steering Wheel Heating/Cooling.

int HVAC_TEMPERATURE_CURRENT

HVAC current temperature in celsius.

int HVAC_TEMPERATURE_DISPLAY_UNITS

Temperature units for display.

int HVAC_TEMPERATURE_SET

HVAC target temperature set in Celsius.

int HVAC_TEMPERATURE_VALUE_SUGGESTION

Suggested values for setting HVAC temperature.

int HW_KEY_INPUT

This constant is deprecated. car service internal use only.

int IGNITION_STATE

Vehicle's ignition state.

int IMPACT_DETECTED

Impact detected.

int INFO_DRIVER_SEAT

Driver's seat location.

int INFO_EV_BATTERY_CAPACITY

Nominal usable battery capacity for EV or hybrid vehicle.

int INFO_EV_CONNECTOR_TYPE

List of EvChargingConnectorTypes this vehicle may use.

int INFO_EV_PORT_LOCATION

PortLocationType for the EV port location.

int INFO_EXTERIOR_DIMENSIONS

Vehicle's exterior dimensions in millimeters.

int INFO_FUEL_CAPACITY

Fuel capacity of the vehicle in milliliters.

int INFO_FUEL_DOOR_LOCATION

PortLocationType for the fuel door location.

int INFO_FUEL_TYPE

List the FuelTypes the vehicle may use.

int INFO_MAKE

Manufacturer of vehicle.

int INFO_MODEL

Model of vehicle.

int INFO_MODEL_TRIM

Public trim name of the vehicle.

int INFO_MODEL_YEAR

Model year of vehicle in YYYY format based on Gregorian calendar.

int INFO_MULTI_EV_PORT_LOCATIONS

List PortLocationTypes for Multiple EV port locations.

int INFO_VEHICLE_SIZE_CLASS

Vehicle Size Class.

int INFO_VIN

VIN of vehicle

Property Config:

Required Permission:

int INSTANTANEOUS_EV_EFFICIENCY

Instantaneous EV efficiency in km/kWh.

int INSTANTANEOUS_FUEL_ECONOMY

Instantaneous Fuel Economy in L/100km.

int INVALID

Undefined property.

int LANE_CENTERING_ASSIST_COMMAND

Lane Centering Assist (LCA) commands.

int LANE_CENTERING_ASSIST_ENABLED

Enable or disable Lane Centering Assist (LCA).

int LANE_CENTERING_ASSIST_STATE

Lane Centering Assist (LCA) state.

int LANE_DEPARTURE_WARNING_ENABLED

Enable or disable Lane Departure Warning (LDW).

int LANE_DEPARTURE_WARNING_STATE

Lane Departure Warning (LDW) state.

int LANE_KEEP_ASSIST_ENABLED

Enable or disable Lane Keep Assist (LKA).

int LANE_KEEP_ASSIST_STATE

Lane Keep Assist (LKA) state.

int LOCATION_CHARACTERIZATION

Characterization of inputs used for computing location.

int LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED

Enable or disable Low Speed Automatic Emergency Braking.

int LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE

Low Speed Automatic Emergency Braking state.

int LOW_SPEED_COLLISION_WARNING_ENABLED

Enable or disable Low Speed Collision Warning.

int LOW_SPEED_COLLISION_WARNING_STATE

Low Speed Collision Warning State state.

int MIRROR_AUTO_FOLD_ENABLED

Represents property for the Mirror Auto Fold feature.

int MIRROR_AUTO_TILT_ENABLED

Represents property for the Mirror Auto Tilt feature.

int MIRROR_FOLD

Mirror Fold.

int MIRROR_LOCK

Mirror Lock.

int MIRROR_Y_MOVE

Mirror Y Move.

int MIRROR_Y_POS

Mirror Y Position.

int MIRROR_Z_MOVE

Mirror Z Move.

int MIRROR_Z_POS

Mirror Z Position.

int NIGHT_MODE

Night mode.

int OBD2_FREEZE_FRAME

This constant is deprecated. use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

int OBD2_FREEZE_FRAME_CLEAR

This constant is deprecated. use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

int OBD2_FREEZE_FRAME_INFO

This constant is deprecated. use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

int OBD2_LIVE_FRAME

This constant is deprecated. use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

int PARKING_BRAKE_AUTO_APPLY

Auto-apply parking brake.

int PARKING_BRAKE_ON

Parking brake state.

int PERF_ODOMETER

Current odometer value of the vehicle in kilometers.

int PERF_REAR_STEERING_ANGLE

Rear bicycle model steering angle for vehicle in degrees.

int PERF_STEERING_ANGLE

Front bicycle model steering angle for vehicle in degrees.

int PERF_VEHICLE_SPEED

Speed of the vehicle in meters per second.

int PERF_VEHICLE_SPEED_DISPLAY

Speed of the vehicle in meters per second for displays.

int PER_DISPLAY_BRIGHTNESS

This constant is deprecated. use CarPowerManager instead.

int RANGE_REMAINING

Range remaining in meters.

int READING_LIGHTS_STATE

Reading lights.

int READING_LIGHTS_SWITCH

Reading lights switch.

int REAR_FOG_LIGHTS_STATE

Rear fog lights state.

int REAR_FOG_LIGHTS_SWITCH

Rear fog lights switch.

int SEAT_AIRBAGS_DEPLOYED

State of deployment for seat airbags.

int SEAT_AIRBAG_ENABLED

Represents feature to enable/disable a seat's ability to deploy airbag(s) when triggered (e.g. by a crash).

int SEAT_BACKREST_ANGLE_1_MOVE

Seat backrest angle 1 move.

int SEAT_BACKREST_ANGLE_1_POS

Seat backrest angle 1 position.

int SEAT_BACKREST_ANGLE_2_MOVE

Seat backrest angle 2 move.

int SEAT_BACKREST_ANGLE_2_POS

Seat backrest angle 2 position.

int SEAT_BELT_BUCKLED

Seatbelt buckled.

int SEAT_BELT_HEIGHT_MOVE

Seatbelt height move.

int SEAT_BELT_HEIGHT_POS

Seatbelt height position.

int SEAT_BELT_PRETENSIONER_DEPLOYED

Seat belt pretensioner deployed.

int SEAT_CUSHION_SIDE_SUPPORT_MOVE

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

int SEAT_CUSHION_SIDE_SUPPORT_POS

Represents property for seat\u2019s hipside (bottom cushion\u2019s side) support position.

int SEAT_DEPTH_MOVE

Seat depth move.

int SEAT_DEPTH_POS

Seat depth position.

int SEAT_EASY_ACCESS_ENABLED

Represents property for Seat easy access feature.

int SEAT_FOOTWELL_LIGHTS_STATE

Represents property for state of the footwell lights.

int SEAT_FOOTWELL_LIGHTS_SWITCH

Represents property for switch of the footwell lights.

int SEAT_FORE_AFT_MOVE

Seat fore/aft move.

int SEAT_FORE_AFT_POS

Seat fore/aft position.

int SEAT_HEADREST_ANGLE_MOVE

Headrest angle move.

int SEAT_HEADREST_ANGLE_POS

Headrest angle position.

int SEAT_HEADREST_FORE_AFT_MOVE

Headrest fore/aft move.

int SEAT_HEADREST_FORE_AFT_POS

Headrest fore/aft position.

int SEAT_HEADREST_HEIGHT_MOVE

Headrest height move.

int SEAT_HEADREST_HEIGHT_POS

This constant is deprecated. because it is defined as type VehicleAreaType.VEHICLE_AREA_TYPE_GLOBAL, which means all seats use the same value. Use SEAT_HEADREST_HEIGHT_POS_V2 instead which fixes this issue by being defined as type VehicleAreaType.VEHICLE_AREA_TYPE_SEAT.

int SEAT_HEADREST_HEIGHT_POS_V2

Headrest height position.

int SEAT_HEIGHT_MOVE

Seat height move.

int SEAT_HEIGHT_POS

Seat height position.

int SEAT_LUMBAR_FORE_AFT_MOVE

Lumbar fore/aft move.

int SEAT_LUMBAR_FORE_AFT_POS

Lumber fore/aft position.

int SEAT_LUMBAR_SIDE_SUPPORT_MOVE

Lumbar side support move.

int SEAT_LUMBAR_SIDE_SUPPORT_POS

Lumbar side support position.

int SEAT_LUMBAR_VERTICAL_MOVE

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

int SEAT_LUMBAR_VERTICAL_POS

Represents property for seat\u2019s lumbar support vertical position.

int SEAT_MEMORY_SELECT

Seat memory select.

int SEAT_MEMORY_SET

Seat memory set.

int SEAT_OCCUPANCY

Seat Occupancy.

int SEAT_TILT_MOVE

Seat tilt move.

int SEAT_TILT_POS

Seat tilt position.

int SEAT_WALK_IN_POS

Represents property that indicates the current walk-in position of the seat.

int STEERING_WHEEL_DEPTH_MOVE

Steering wheel depth movement.

int STEERING_WHEEL_DEPTH_POS

Steering wheel depth position.

int STEERING_WHEEL_EASY_ACCESS_ENABLED

Steering wheel easy access feature enabled.

int STEERING_WHEEL_HEIGHT_MOVE

Steering wheel height movement.

int STEERING_WHEEL_HEIGHT_POS

Steering wheel height position.

int STEERING_WHEEL_LIGHTS_STATE

Steering wheel lights state.

int STEERING_WHEEL_LIGHTS_SWITCH

Steering wheel lights switch.

int STEERING_WHEEL_LOCKED

Steering wheel locked.

int STEERING_WHEEL_THEFT_LOCK_ENABLED

Steering wheel theft lock feature enabled.

int TIRE_PRESSURE

Tire pressure in kilopascals.

int TIRE_PRESSURE_DISPLAY_UNITS

Tire pressure units for display.

int TRACTION_CONTROL_ACTIVE

Traction Control is active.

int TRAILER_PRESENT

Indicates if there is a trailer present or not.

int TURN_SIGNAL_LIGHT_STATE

Turn signal light state.

int TURN_SIGNAL_STATE

This constant is deprecated. because it ambiguously defines the state of the vehicle turn signals without making clear if it means the state of the turn signal lights or the state of the turn signal switch. TURN_SIGNAL_LIGHT_STATE and TURN_SIGNAL_SWITCH rectify this problem.

See VehicleTurnSignal for possible values for TURN_SIGNAL_STATE.

Property Config:

Required Permission:

int TURN_SIGNAL_SWITCH

Turn signal switch.

int ULTRASONICS_SENSOR_DETECTION_RANGE

Static data for the detection range of each ultrasonic sensor in millimeters.

int ULTRASONICS_SENSOR_FIELD_OF_VIEW

Static data for the field of view of each ultrasonic sensor in degrees.

int ULTRASONICS_SENSOR_MEASURED_DISTANCE

The distance reading of the nearest detected object per sensor in millimeters.

int ULTRASONICS_SENSOR_ORIENTATION

Static data for the orientation of each ultrasonic sensor installed on the vehicle.

int ULTRASONICS_SENSOR_POSITION

Static data for the position of each ultrasonic sensor installed on the vehicle.

int ULTRASONICS_SENSOR_SUPPORTED_RANGES

Static data for the supported ranges of each ultrasonic sensor in millimeters.

int VALET_MODE_ENABLED

Valet mode enabled

This property allows the user to enable/disable valet mode in their vehicle.

int VEHICLE_CURB_WEIGHT

Vehicle\u2019s curb weight in kilograms.

int VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL

Current state of vehicle autonomy.

int VEHICLE_DRIVING_AUTOMATION_TARGET_LEVEL

Target state of vehicle autonomy.

int VEHICLE_HORN_ENGAGED

Vehicle horn engaged.

int VEHICLE_MAP_SERVICE

This constant is deprecated. use ERROR(/android.car.vms.VmsClientManager) instead.

int VEHICLE_PASSIVE_SUSPENSION_HEIGHT

Vehicle Passive Suspension Height in mm.

int VEHICLE_SPEED_DISPLAY_UNITS

Speed units for display.

int WHEEL_TICK

Reports wheel ticks.

int WINDOW_LOCK

Window Child Lock.

int WINDOW_MOVE

Window Move.

int WINDOW_POS

Window Position.

int WINDSHIELD_WIPERS_PERIOD

Windshield wipers period (milliseconds).

int WINDSHIELD_WIPERS_STATE

Windshield wipers state.

int WINDSHIELD_WIPERS_SWITCH

Windshield wipers switch.

Public constructors

VehiclePropertyIds()

This constructor is deprecated. to prevent others from instantiating this class

Public methods

static String toString(int propertyId)

Gets a user-friendly representation of a property.

Inherited methods

Constants

ABS_ACTIVE

public static final int ABS_ACTIVE

ABS is active.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_DYNAMICS_STATE

Constant Value: 287310858 (0x1120040a)

ACCELERATOR_PEDAL_COMPRESSION_PERCENTAGE

public static final int ACCELERATOR_PEDAL_COMPRESSION_PERCENTAGE

Accelerator pedal compression percentage.

This property communicates the percentage that the physical accelerator pedal in the vehicle is compressed. This property returns a float value from 0 to 100.

0 indicates the pedal's uncompressed position.

100 indicates the pedal's maximally compressed position.

Property Config:

Required Permissions:

Constant Value: 291504911 (0x1160030f)

ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

public static final int ADAPTIVE_CRUISE_CONTROL_LEAD_VEHICLE_MEASURED_DISTANCE

Measured distance from leading vehicle when using Adaptive Cruise Control (ACC) or Predictive Cruise Control in millimeters.

Returns the measured distance in meters from the lead vehicle for ACC between the rear-most point of the leading vehicle and the front-most point of the ACC vehicle.

CarPropertyConfig.getMinValue(int) returns 0.

CarPropertyConfig.getMaxValue(int) returns the maximum range the distance sensor can support. This value will 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 will throw a PropertyNotAvailableException.

When this property is unavailable (for example when CRUISE_CONTROL_ENABLED is false), reading this property will throw a PropertyNotAvailableException.

Property Config:

Required Permission:

Constant Value: 289411093 (0x11401015)

ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

public static final int ADAPTIVE_CRUISE_CONTROL_TARGET_TIME_GAP

Current target time gap for Adaptive Cruise Control (ACC) or Predictive Cruise Control 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 unavailable (for example when CRUISE_CONTROL_ENABLED is false), reading or writing this property will throw a PropertyNotAvailableException.

Property Config:

Required Permissions:

Constant Value: 289411092 (0x11401014)

AP_POWER_BOOTUP_REASON

public static final int AP_POWER_BOOTUP_REASON

This constant is deprecated.
use CarPowerManager instead.

Property to report bootup reason for the current power on.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_POWER

Constant Value: 289409538 (0x11400a02)

AP_POWER_STATE_REPORT

public static final int AP_POWER_STATE_REPORT

This constant is deprecated.
use CarPowerManager instead.

Property to report power state of application processor.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_POWER

Constant Value: 289475073 (0x11410a01)

AP_POWER_STATE_REQ

public static final int AP_POWER_STATE_REQ

This constant is deprecated.
use CarPowerManager instead.

Property to control power state of application processor.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_POWER

Constant Value: 289475072 (0x11410a00)

AUTOMATIC_EMERGENCY_BRAKING_ENABLED

public static final int AUTOMATIC_EMERGENCY_BRAKING_ENABLED

Enable or disable Automatic Emergency Braking (AEB).

Returns true if AEB is enabled and false if AEB is disabled. When AEB is enabled, the ADAS system in the vehicle should be turned on and monitoring to avoid potential collisions. This property applies for higher speed applications only. For enabling low speed automatic emergency braking, ERROR(/LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED) will be used.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313920 (0x11201000)

AUTOMATIC_EMERGENCY_BRAKING_STATE

public static final int AUTOMATIC_EMERGENCY_BRAKING_STATE

Automatic Emergency Braking (AEB) state.

Returns the current state of AEB. This property will always return a valid state defined in ERROR(/android.car.hardware.property.AutomaticEmergencyBrakingState) or ERROR(/android.car.hardware.property.ErrorState). This property should apply for higher speed applications only. For representing the state of the low speed automatic emergency braking system, ERROR(/LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE) should be used.

If AEB includes forward collision warnings before activating the brakes, those warnings will be surfaced through the Forward Collision Warning (FCW) properties.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.AutomaticEmergencyBrakingState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411073 (0x11401001)

BLIND_SPOT_WARNING_ENABLED

public static final int BLIND_SPOT_WARNING_ENABLED

Enable and disable Blind Spot Warning (BSW).

Returns true if BSW is enabled and false if BSW is disabled. When BSW is enabled, the ADAS system in the vehicle should be turned on and monitoring for objects in the vehicle\u2019s blind spots.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313924 (0x11201004)

BLIND_SPOT_WARNING_STATE

public static final int BLIND_SPOT_WARNING_STATE

Blind Spot Warning (BSW) state.

Returns the current state of BSW. This property will always return a valid state defined in ERROR(/android.car.hardware.property.BlindSpotWarningState) or ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.BlindSpotWarningState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 339742725 (0x14401005)

BRAKE_FLUID_LEVEL_LOW

public static final int BRAKE_FLUID_LEVEL_LOW

Brake fluid level low.

This property communicates that the brake fluid level in the vehicle is low according to the OEM. This value will match the vehicle's brake fluid level status as displayed on the instrument cluster. If the brake fluid level is low, this property will be set to true. If not, it will be set to false.

Property Config:

Required Permissions:

Constant Value: 287310610 (0x11200312)

BRAKE_PAD_WEAR_PERCENTAGE

public static final int BRAKE_PAD_WEAR_PERCENTAGE

Brake pad wear percentage.

This property communicates the amount of brake pad wear accumulated by the vehicle as a percentage. This property returns a float value from 0 to 100.

0 indicates the brake pad has no wear.

100 indicates the brake pad is maximally worn.

Property Config:

Required Permissions:

Constant Value: 392168209 (0x17600311)

BRAKE_PEDAL_COMPRESSION_PERCENTAGE

public static final int BRAKE_PEDAL_COMPRESSION_PERCENTAGE

Brake pedal compression percentage.

This property communicates the percentage that the physical brake pedal in the vehicle is compressed. This property returns a float value from 0 to 100.

0 indicates the pedal's uncompressed position.

100 indicates the pedal's maximally compressed position.

Property Config:

Required Permissions:

Constant Value: 291504912 (0x11600310)

CABIN_LIGHTS_STATE

public static final int CABIN_LIGHTS_STATE

Cabin lights.

Property Config:

Required Permission:


Requires Car.PERMISSION_READ_INTERIOR_LIGHTS

Constant Value: 289410817 (0x11400f01)

CABIN_LIGHTS_SWITCH

public static final int CABIN_LIGHTS_SWITCH

Cabin lights switch.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_INTERIOR_LIGHTS

Constant Value: 289410818 (0x11400f02)

CRITICALLY_LOW_TIRE_PRESSURE

public static final int CRITICALLY_LOW_TIRE_PRESSURE

Critically low tire pressure.

For each area ID listed in CarPropertyConfig.getAreaIds(), the corresponding CRITICALLY_LOW_TIRE_PRESSURE will be less than or equal the AreaIdConfig.getMinValue() of TIRE_PRESSURE for the same area ID.

Property Config:

Required Permission:


Requires Car.PERMISSION_TIRES

Constant Value: 392168202 (0x1760030a)

CROSS_TRAFFIC_MONITORING_ENABLED

public static final int CROSS_TRAFFIC_MONITORING_ENABLED

Enable or disable Cross Traffic Monitoring.

Returns true if Cross Traffic Monitoring is enabled and false if Cross Traffic Monitoring is disabled. When Cross Traffic Monitoring is enabled, the ADAS system in the vehicle should be turned on and monitoring for potential sideways collisions.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313955 (0x11201023)

CROSS_TRAFFIC_MONITORING_WARNING_STATE

public static final int CROSS_TRAFFIC_MONITORING_WARNING_STATE

Cross Traffic Monitoring Warning state.

Returns the current state of Cross Traffic Monitoring Warning. This property will always return a valid state defined in ERROR(/android.car.hardware.property.CrossTrafficMonitoringWarningState) or ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.CrossTrafficMonitoringWarningState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411108 (0x11401024)

CRUISE_CONTROL_COMMAND

public static final int CRUISE_CONTROL_COMMAND

Write Cruise Control (CC) commands.

See ERROR(/android.car.hardware.property.CruiseControlCommand) for the details about each supported command.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.CruiseControlCommand) are supported.

When this property is unavailable (for example when CRUISE_CONTROL_ENABLED is false), writing this property will throw a PropertyNotAvailableException.

Property Config:

Required Permission:

Constant Value: 289411090 (0x11401012)

CRUISE_CONTROL_ENABLED

public static final int CRUISE_CONTROL_ENABLED

Enable or disable Cruise Control (CC).

Return true if CC is enabled and false if CC is disabled. This property is shared by all forms of ERROR(/android.car.hardware.property.CruiseControlType)).

When CC is enabled, the ADAS system in the vehicle should be turned on and responding to commands.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313935 (0x1120100f)

CRUISE_CONTROL_STATE

public static final int CRUISE_CONTROL_STATE

Current state of Cruise Control (CC).

This property returns the state of CC. Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.CruiseControlState) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.CruiseControlState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411089 (0x11401011)

CRUISE_CONTROL_TARGET_SPEED

public static final int CRUISE_CONTROL_TARGET_SPEED

Current target speed for Cruise Control (CC) in meters per second.

AreaIdConfig.getMinValue() and AreaIdConfig.getMaxValue() return the min and max target speed values respectively. These values will be non-negative.

AreaIdConfig.getMinValue() represents the lower bound of the target speed.

AreaIdConfig.getMaxValue() represents the upper bound of the target speed.

When this property is unavailable (for example when CRUISE_CONTROL_ENABLED is false), reading this property will throw a PropertyNotAvailableException.

Property Config:

Required Permission:

Constant Value: 291508243 (0x11601013)

CRUISE_CONTROL_TYPE

public static final int 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, adaptive CC, etc.). Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.CruiseControlType) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.CruiseControlType) and ERROR(/android.car.hardware.property.ErrorState) are supported. Trying to write ERROR(/android.car.hardware.property.CruiseControlType#OTHER) or an ERROR(/android.car.hardware.property.ErrorState) to this property will throw an IllegalArgumentException.

Property Config:

Required Permissions:

Constant Value: 289411088 (0x11401010)

CURRENT_GEAR

public static final int CURRENT_GEAR

Vehicle transmission's current VehicleGear.

CURRENT_GEAR's value may not match that of GEAR_SELECTION. For example, if the GEAR_SELECTION is VehicleGear.GEAR_DRIVE in a vehicle with an automatic transmission, the CURRENT_GEAR will be one of VehicleGear.GEAR_FIRST, VehicleGear.GEAR_SECOND, etc, which reflects the actual gear the transmission is currently running in.

configArray represents the list of supported VehicleGears for CURRENT_GEAR. For example, the configArray for an EV vehicle is set as follows:

Example automatic transmission configArray:

Example manual transmission configArray:

Property Config:

Required Permission:


Requires Car.PERMISSION_POWERTRAIN

Constant Value: 289408001 (0x11400401)

DISPLAY_BRIGHTNESS

public static final int DISPLAY_BRIGHTNESS

This constant is deprecated.
use CarPowerManager instead.

Property to represent brightness of the display.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_POWER

Constant Value: 289409539 (0x11400a03)

DISTANCE_DISPLAY_UNITS

public static final int DISTANCE_DISPLAY_UNITS

Distance units for display.

Indicates which units the car is using to display distances to the user.

configArray represents the list of supported units for DISTANCE_DISPLAY_UNITS. Here is an example configArray:

Property Config:

Required Permissions:

Constant Value: 289408512 (0x11400600)

DOOR_CHILD_LOCK_ENABLED

public static final int DOOR_CHILD_LOCK_ENABLED

Door child lock feature enabled.

Returns true if the door child lock feature is enabled and false if it is disabled. If enabled, the door is unable to be opened from the inside.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_DOORS

Constant Value: 371198723 (0x16200b03)

DOOR_LOCK

public static final int DOOR_LOCK

Door lock.

True indicates that the door is locked.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_DOORS

Constant Value: 371198722 (0x16200b02)

DOOR_MOVE

public static final int DOOR_MOVE

Door move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the door is opening and negative values mean the door is closing. Larger integers, either positive or negative, indicate a faster speed. Once the door reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the maximum movement speed of the door while closing.

MinMaxSupportedValue.getMaxValue() indicates the maximum movement speed of the door while opening.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_DOORS

Constant Value: 373295873 (0x16400b01)

DOOR_POS

public static final int DOOR_POS

Door position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is 0. It indicates the door is closed.

MinMaxSupportedValue.getMaxValue() indicates the door is fully open.

All integers between the min and max values are supported and indicate a transition state between the closed and fully open positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_DOORS

Constant Value: 373295872 (0x16400b00)

DRIVER_DISTRACTION_STATE

public static final int DRIVER_DISTRACTION_STATE

Driver distraction state.

Returns the current detected driver distraction state.

Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.DriverDistractionState) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through ERROR(/android.car.hardware.property.ErrorState).

If the vehicle is sending a warning to the user because the driver is too distracted, the warning should be surfaced through DRIVER_DISTRACTION_WARNING.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.DriverDistractionState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411102 (0x1140101e)

DRIVER_DISTRACTION_SYSTEM_ENABLED

public static final int DRIVER_DISTRACTION_SYSTEM_ENABLED

Enable or disable driver distraction monitoring.

Set true to enable driver distraction monitoring and false to disable driver distraction monitoring. When driver distraction monitoring is enabled, a system inside the vehicle should be monitoring the distraction level of the driver and warn the driver if needed.

Property Config:

Required Permissions:

Constant Value: 287313949 (0x1120101d)

DRIVER_DISTRACTION_WARNING

public static final int DRIVER_DISTRACTION_WARNING

Driver distraction warning.

Returns whether a warning is being sent to the driver for being distracted.

Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.DriverDistractionWarning) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through an ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.DriverDistractionWarning) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411104 (0x11401020)

DRIVER_DISTRACTION_WARNING_ENABLED

public static final int DRIVER_DISTRACTION_WARNING_ENABLED

Enable or disable driver distraction warnings.

Set true to enable driver distraction warnings and false to disable driver distraction warnings. When driver distraction warnings are enabled, the driver distraction monitoring system inside the vehicle should warn the driver when it detects the driver is distracted.

Property Config:

Required Permissions:

Constant Value: 287313951 (0x1120101f)

DRIVER_DROWSINESS_ATTENTION_STATE

public static final int DRIVER_DROWSINESS_ATTENTION_STATE

Driver drowsiness and attention level state.

Returns the current detected state of driver drowiness and attention level based on the Karolinska Sleepiness Scale (KSS).

Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.DriverDrowsinessAttentionState) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through ERROR(/android.car.hardware.property.ErrorState).

If the vehicle is sending a warning to the user because the driver is too drowsy, the warning should be surfaced through DRIVER_DROWSINESS_ATTENTION_WARNING.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.DriverDrowsinessAttentionState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411098 (0x1140101a)

DRIVER_DROWSINESS_ATTENTION_SYSTEM_ENABLED

public static final int DRIVER_DROWSINESS_ATTENTION_SYSTEM_ENABLED

Enable or disable driver drowsiness and attention monitoring.

Set true to enable driver drowsiness and attention monitoring and false to disable driver drowsiness and attention monitoring. When driver drowsiness and attention monitoring is enabled, a system inside the vehicle will monitor the drowsiness and attention level of the driver and warn the driver if needed.

Property Config:

Required Permissions:

Constant Value: 287313945 (0x11201019)

DRIVER_DROWSINESS_ATTENTION_WARNING

public static final int DRIVER_DROWSINESS_ATTENTION_WARNING

Driver drowsiness and attention warning.

Returns whether a warning is being sent to the driver for being drowsy or not attentive.

Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.DriverDrowsinessAttentionWarning) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through an ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.DriverDrowsinessAttentionWarning) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411100 (0x1140101c)

DRIVER_DROWSINESS_ATTENTION_WARNING_ENABLED

public static final int DRIVER_DROWSINESS_ATTENTION_WARNING_ENABLED

Enable or disable driver drowsiness and attention warnings.

Set true to enable driver drowsiness and attention warnings and false to disable driver drowsiness and attention warnings. When driver drowsiness and attention warnings are enabled, the driver drowsiness and attention monitoring system inside the vehicle should warn the driver when it detects the driver is drowsy or not attentive.

Property Config:

Required Permissions:

Constant Value: 287313947 (0x1120101b)

ELECTRONIC_STABILITY_CONTROL_ENABLED

public static final int ELECTRONIC_STABILITY_CONTROL_ENABLED

Enable or disable Electronic Stability Control (ESC).

Returns true if ESC is enabled and false if ESC is disabled. When ESC is enabled, a system in the vehicle should be controlling the tires during instances with high risk of skidding to actively prevent the same from happening.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287310862 (0x1120040e)

ELECTRONIC_STABILITY_CONTROL_STATE

public static final int ELECTRONIC_STABILITY_CONTROL_STATE

Electronic Stability Control (ESC) state.

Returns the current state of ESC. This property will always return a valid state defined in ERROR(/android.car.hardware.property.ElectronicStabilityControlState) or ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.ElectronicStabilityControlState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289408015 (0x1140040f)

ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

public static final int ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

Electronic Toll Collection card status.

This property indicates the status of ETC(Electronic Toll Collection) card in the vehicle. If the head unit is aware of an ETC card attached to the vehicle, ETC_CARD_STATUS gives that status of the card; otherwise, this property should be UNAVAILABLE. The property value should be one of VehicleElectronicTollCollectionCardStatus.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289410874 (0x11400f3a)

ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

public static final int ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

Electronic Toll Collection card type.

This property indicates the type of ETC(Electronic Toll Collection) card in the vehicle. If the head unit is aware of an ETC card attached to the vehicle, this property should return the type of card attached; otherwise, this property should be UNAVAILABLE. The property value should be one of VehicleElectronicTollCollectionCardType.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289410873 (0x11400f39)

EMERGENCY_LANE_KEEP_ASSIST_ENABLED

public static final int EMERGENCY_LANE_KEEP_ASSIST_ENABLED

Enable or disable Emergency Lane Keep Assist (ELKA).

Return true if ELKA is enabled and false if ELKA is disabled. When ELKA is enabled, the ADAS system in the vehicle should be on and monitoring for unsafe lane changes by the driver. When an unsafe maneuver is detected, ELKA alerts the driver and applies steering corrections to keep the vehicle in its original lane.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313933 (0x1120100d)

EMERGENCY_LANE_KEEP_ASSIST_STATE

public static final int EMERGENCY_LANE_KEEP_ASSIST_STATE

Emergency Lane Keep Assist (ELKA) state.

Returns the current state of ELKA. Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.EmergencyLaneKeepAssistState) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.EmergencyLaneKeepAssistState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411086 (0x1140100e)

ENGINE_COOLANT_TEMP

public static final int ENGINE_COOLANT_TEMP

Temperature of engine coolant in celsius.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_ENGINE_DETAILED

Constant Value: 291504897 (0x11600301)

ENGINE_IDLE_AUTO_STOP_ENABLED

public static final int ENGINE_IDLE_AUTO_STOP_ENABLED

Represents feature for engine idle automatic stop.

If true, the vehicle may automatically shut off the engine when it is not needed and then automatically restart it when needed.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_ENGINE_DETAILED

Constant Value: 287310624 (0x11200320)

ENGINE_OIL_LEVEL

public static final int ENGINE_OIL_LEVEL

Engine oil level.

Returns the status of the oil level for the vehicle. See VehicleOilLevel for possible values for ENGINE_OIL_LEVEL.

Property Config:

Required Permission:

Constant Value: 289407747 (0x11400303)

ENGINE_OIL_TEMP

public static final int ENGINE_OIL_TEMP

Temperature of engine oil in celsius.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_ENGINE_DETAILED

Constant Value: 291504900 (0x11600304)

ENGINE_RPM

public static final int ENGINE_RPM

Engine rpm.

Property Config:

Required Permission:

Constant Value: 291504901 (0x11600305)

ENV_OUTSIDE_TEMPERATURE

public static final int ENV_OUTSIDE_TEMPERATURE

Outside temperature in celsius.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_ENVIRONMENT

Constant Value: 291505923 (0x11600703)

EPOCH_TIME

public static final int EPOCH_TIME

Current date and time, encoded as Unix time.

This value denotes the number of milliseconds that have elapsed since 1/1/1970 UTC.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_EPOCH_TIME

Constant Value: 290457094 (0x11500606)

EV_BATTERY_AVERAGE_TEMPERATURE

public static final int EV_BATTERY_AVERAGE_TEMPERATURE

EV battery average temperature

Exposes the temperature of the battery in an EV. If multiple batteries exist in the EV, or multiple temperature sensors exist, this property will be set to a meaningful weighted average that best represents the overall temperature of the battery system.

Property Config:

Required Permissions:

Constant Value: 291504910 (0x1160030e)

EV_BATTERY_DISPLAY_UNITS

public static final int EV_BATTERY_DISPLAY_UNITS

EV battery units for display.

Indicates which units the vehicle is using to display EV battery information to the user.

configArray represents the list of supported units for EV_BATTERY_DISPLAY_UNITS. Here is an example configArray:

Property Config:

Required Permissions:

Constant Value: 289408515 (0x11400603)

EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

public static final int EV_BATTERY_INSTANTANEOUS_CHARGE_RATE

EV instantaneous charge rate in milliwatts.

Positive rate indicates battery is being charged, and Negative rate indicates battery being discharged.

Property Config:

Required Permission:


Requires Car.PERMISSION_ENERGY

Constant Value: 291504908 (0x1160030c)

EV_BATTERY_LEVEL

public static final int EV_BATTERY_LEVEL

EV battery level.

Returns the current battery level in VehicleUnit.WATT_HOUR, if EV or hybrid. This value will not exceed EV_CURRENT_BATTERY_CAPACITY. To calculate the battery percentage, use: (EV_BATTERY_LEVEL/EV_CURRENT_BATTERY_CAPACITY)*100.

Property Config:

Required Permission:


Requires Car.PERMISSION_ENERGY

Constant Value: 291504905 (0x11600309)

EV_BRAKE_REGENERATION_LEVEL

public static final int EV_BRAKE_REGENERATION_LEVEL

Regenerative braking level of an electronic vehicle.

Returns the current setting for the regenerative braking level. Larger setting values mean more energy regenerated from braking while smaller setting values mean less energy regenerated from braking. 0 means the setting for no regenerative braking.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for the global areaId.

the result for getMinMaxSupportedValue indicates the range of possible values.

Property Config:

Required Permissions:

Constant Value: 289408012 (0x1140040c)

EV_CHARGE_CURRENT_DRAW_LIMIT

public static final int EV_CHARGE_CURRENT_DRAW_LIMIT

The vehicle's selected alternating current (AC) EV charging draw limit in Amperes.

This may or may not match the vehicle's maximum possible draw limit. This maximum draw limit in Amperes is listed in the first entry in its CarPropertyConfig.getConfigArray().

If property is writable, the user may adjust this value.

Property Config:

Required Permissions:

Constant Value: 291508031 (0x11600f3f)

EV_CHARGE_PERCENT_LIMIT

public static final int EV_CHARGE_PERCENT_LIMIT

EV charge percent limit.

Indicates the maximum charge percent threshold set by the user. Returns a float value from 0 to 100.

configArray is optional. If it is populated, it represents the valid charge percent limit values for the vehicle. Here is an example configArray:

  • configArray[0] = 20
  • configArray[1] = 40
  • configArray[2] = 60
  • configArray[3] = 80

Property Config:

Required Permissions:

Constant Value: 291508032 (0x11600f40)

EV_CHARGE_PORT_CONNECTED

public static final int EV_CHARGE_PORT_CONNECTED

EV charge port connected.

If the vehicle has multiple charging ports, this property will return true if any of the charge ports are connected.

Property Config:

Required Permission:


Requires Car.PERMISSION_ENERGY_PORTS

Constant Value: 287310603 (0x1120030b)

EV_CHARGE_PORT_OPEN

public static final int EV_CHARGE_PORT_OPEN

EV charge port open.

If the vehicle has multiple charging ports, this property will return true if any of the charge ports are open.

Property Config:

Required Permissions:

Constant Value: 287310602 (0x1120030a)

EV_CHARGE_STATE

public static final int EV_CHARGE_STATE

Charging state of the car.

Returns the current charging state of the car. See EvChargeState for possible values for EV_CHARGE_STATE.

If the vehicle has a target charge percentage other than 100, this property will return EvChargeState.STATE_FULLY_CHARGED when the battery charge level has reached the target level. See EV_CHARGE_PERCENT_LIMIT for more context.

Property Config:

Required Permission:

Constant Value: 289410881 (0x11400f41)

EV_CHARGE_SWITCH

public static final int EV_CHARGE_SWITCH

Start or stop charging the EV battery.

The setting that the user wants. Setting this property to true starts the battery charging and setting to false stops charging.

Property Config:

Required Permission:

Constant Value: 287313730 (0x11200f42)

EV_CHARGE_TIME_REMAINING

public static final int EV_CHARGE_TIME_REMAINING

Estimated charge time remaining in seconds.

Returns 0 if the vehicle is not charging.

Property Config:

Required Permission:

Constant Value: 289410883 (0x11400f43)

EV_CURRENT_BATTERY_CAPACITY

public static final int EV_CURRENT_BATTERY_CAPACITY

Current usable battery capacity for EV or hybrid vehicle.

Returns the actual value of battery capacity in VehicleUnit.WATT_HOUR, if EV or hybrid. This property captures the real-time usable battery capacity taking into account factors such as battery aging and temperature dependency. Therefore, this value might be different from INFO_EV_BATTERY_CAPACITY because INFO_EV_BATTERY_CAPACITY returns the nominal battery capacity from when the vehicle was new.

Property Config:

Required Permission:


Requires Car.PERMISSION_ENERGY

Constant Value: 291504909 (0x1160030d)

EV_REGENERATIVE_BRAKING_STATE

public static final int EV_REGENERATIVE_BRAKING_STATE

Regenerative braking or one-pedal drive setting on the car.

Returns the current state associated with the regenerative braking setting in the car. See EvRegenerativeBrakingState for possible values for EV_REGENERATIVE_BRAKING_STATE.

If the EV_BRAKE_REGENERATION_LEVEL property has been implemented, it is likely that the OEM supports a more granular set of regeneration levels than those provided by this property through EvRegenerativeBrakingState.

Property Config:

Required Permission:

Constant Value: 289410884 (0x11400f44)

EV_STOPPING_MODE

public static final int EV_STOPPING_MODE

Represents property for the current stopping mode of the vehicle.

For the global area ID, the AreaIdConfig.getSupportedEnumValues() obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which enum values from EvStoppingMode are supported. EvStoppingMode may be extended to include more states in the future.

Property Config:

Required Permissions:

Constant Value: 289408013 (0x1140040d)

FOG_LIGHTS_STATE

public static final int FOG_LIGHTS_STATE

Fog light state.

If the car has both front and rear fog lights:

  • If front and rear fog lights can only be controlled together: FOG_LIGHTS_STATE provides the state of fog lights.
  • If front and rear fog lights can only be controlled independently: FRONT_FOG_LIGHTS_STATE and REAR_FOG_LIGHTS_STATE provide the state of front, rear fog lights respectively.

If the car has only front fog lights:

  • Only one of FOG_LIGHTS_STATE or FRONT_FOG_LIGHTS_STATE will be implemented in the car. The implemented property provides the state of the front fog lights.

If the car has only rear fog lights:

  • Only one of FOG_LIGHTS_STATE or REAR_FOG_LIGHTS_STATE will be implemented in the car. The implemented property provides the state of the rear fog lights.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410562 (0x11400e02)

FOG_LIGHTS_SWITCH

public static final int FOG_LIGHTS_SWITCH

Fog light switch.

If the car has both front and rear fog lights:

  • If front and rear fog lights can only be controlled together: FOG_LIGHTS_SWITCH should be used to change the fog lights state.
  • If front and rear fog lights can only be controlled independently: FRONT_FOG_LIGHTS_SWITCH and REAR_FOG_LIGHTS_SWITCH should be used to change the front and rear fog lights state respectively.

If the car has only front fog lights:

  • Only one of FOG_LIGHTS_SWITCH or FRONT_FOG_LIGHTS_SWITCH will be implemented in the car. The implemented property should be used to change the front fog lights state.

If the car has only rear fog lights:

  • Only one of FOG_LIGHTS_SWITCH or REAR_FOG_LIGHTS_SWITCH will be implemented in the car. The implemented property should be used to change the rear fog lights state.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410578 (0x11400e12)

FORWARD_COLLISION_WARNING_ENABLED

public static final int FORWARD_COLLISION_WARNING_ENABLED

Enable or disable Forward Collision Warning (FCW).

Returns true if FCW is enabled and false if FCW is disabled. When FCW is enabled, the ADAS system in the vehicle should be turned on and monitoring for potential collisions.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313922 (0x11201002)

FORWARD_COLLISION_WARNING_STATE

public static final int FORWARD_COLLISION_WARNING_STATE

Forward Collision Warning State (FCW) state.

Returns the current state of FCW. This property will always return a valid state defined in ERROR(/android.car.hardware.property.ForwardCollisionWarningState) or ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.ForwardCollisionWarningState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411075 (0x11401003)

FRONT_FOG_LIGHTS_STATE

public static final int FRONT_FOG_LIGHTS_STATE

Front fog lights state.

Please refer to the documentation on FOG_LIGHTS_STATE for more information.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410875 (0x11400f3b)

FRONT_FOG_LIGHTS_SWITCH

public static final int FRONT_FOG_LIGHTS_SWITCH

Front fog lights switch.

Please refer to the documentation on FOG_LIGHTS_SWITCH for more information.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410876 (0x11400f3c)

FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

public static final int FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME

Fuel consumption units for display.

Indicates type of units the car is using to display fuel consumption information to user.

true indicates units are distance over volume such as MPG.

false indicates units are volume over distance such as L/100KM.

Property Config:

Required Permissions:

Constant Value: 287311364 (0x11200604)

FUEL_DOOR_OPEN

public static final int FUEL_DOOR_OPEN

Fuel door open.

This property communicates whether the fuel door on the vehicle is open or not. This property will not be implemented for electric vehicles. That is, if INFO_FUEL_TYPE only contains FuelType.ELECTRIC, this property will not be implemented. For EVs, see EV_CHARGE_PORT_OPEN.

Property Config:

Required Permissions:

Constant Value: 287310600 (0x11200308)

FUEL_LEVEL

public static final int FUEL_LEVEL

Fuel level in milliliters.

This property communicates the current amount of fuel remaining in the vehicle in milliliters. This property will not be implemented for electric vehicles. That is, if INFO_FUEL_TYPE only contains FuelType.ELECTRIC, this property will not be implemented. For EVs, see EV_BATTERY_LEVEL.

This property's value will not exceed INFO_FUEL_CAPACITY.

Property Config:

Required Permission:


Requires Car.PERMISSION_ENERGY

Constant Value: 291504903 (0x11600307)

FUEL_LEVEL_LOW

public static final int FUEL_LEVEL_LOW

Warning for fuel low level.

FUEL_LEVEL_LOW corresponds to the low fuel warning on the dashboard. Once FUEL_LEVEL_LOW is set, it should not be cleared until more fuel is added to the vehicle. This property may take into account all fuel sources for a vehicle - for example:

  • For a gas powered vehicle, this property is based solely on gas level.
  • For a battery powered vehicle, this property is based solely on battery level.
  • For a hybrid vehicle, this property may be based on the combination of gas and battery levels, at the OEM's discretion.

Property Config:

Required Permission:


Requires Car.PERMISSION_ENERGY

Constant Value: 287310853 (0x11200405)

FUEL_VOLUME_DISPLAY_UNITS

public static final int FUEL_VOLUME_DISPLAY_UNITS

Fuel volume units for display.

Indicates which units the car is using to display fuel volume to the user.

configArray represents the list of supported units for FUEL_VOLUME_DISPLAY_UNITS. Here is an example configArray:

Property Config:

Required Permissions:

Constant Value: 289408513 (0x11400601)

GEAR_SELECTION

public static final int GEAR_SELECTION

Currently selected gear by user.

See VehicleGear for gear value enum.

configArray represents the list of supported gears for the vehicle. For example, configArray for an EV vehicle is set as follows:

Example automatic transmission configArray:

Example manual transmission configArray:

Property Config:

Required Permission:


Requires Car.PERMISSION_POWERTRAIN

Constant Value: 289408000 (0x11400400)

GENERAL_SAFETY_REGULATION_COMPLIANCE

public static final int GENERAL_SAFETY_REGULATION_COMPLIANCE

EU's General security regulation compliance requirement.

Returns whether general security regulation compliance is required, if so, what type of requirement. See GsrComplianceType for possible enums.

Property Config:

Required Permission:

Constant Value: 289410887 (0x11400f47)

GLOVE_BOX_DOOR_POS

public static final int GLOVE_BOX_DOOR_POS

Property that represents the current position of the glove box door.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the glove box's position when closed. This value will be 0.

AreaIdConfig.getMaxValue() indicates the glove box's position when fully open.

All integers between the min and max values are supported and indicate a transition state between the closed and fully open positions.

The supported area IDs match the seat(s) by which the glove box is intended to be used (e.g.) if the front right dashboard has a glove box embedded in it, then the area ID should be VehicleAreaSeat.SEAT_ROW_1_RIGHT).

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_GLOVE_BOX

Constant Value: 356518896 (0x15400bf0)

GLOVE_BOX_LOCKED

public static final int GLOVE_BOX_LOCKED

Lock or unlock the glove box.

If true, the glove box is locked. If false, the glove box is unlocked.

The supported area IDs match the seat(s) by which the glove box is intended to be used (e.g. if the front right dashboard has a glove box embedded in it, then the area ID will be VehicleAreaSeat.SEAT_ROW_1_RIGHT).

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_GLOVE_BOX

Constant Value: 354421745 (0x15200bf1)

HANDS_ON_DETECTION_DRIVER_STATE

public static final int HANDS_ON_DETECTION_DRIVER_STATE

Hands On Detection (HOD) driver state.

Returns whether the driver's hands are on the steering wheel. Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.HandsOnDetectionDriverState) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through ERROR(/android.car.hardware.property.ErrorState).

If the vehicle is sending a warning to the user because the driver's hands have been off the steering wheel for too long, the warning should be surfaced through HANDS_ON_DETECTION_WARNING.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.HandsOnDetectionDriverState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411095 (0x11401017)

HANDS_ON_DETECTION_ENABLED

public static final int HANDS_ON_DETECTION_ENABLED

Enable or disable Hands On Detection (HOD).

Return true if HOD is enabled and false if HOD is disabled. When HOD is enabled, a system inside the vehicle should be monitoring the presence of the driver's hands on the steering wheel and send a warning if it detects that the driver's hands are no longer on the steering wheel.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313942 (0x11201016)

HANDS_ON_DETECTION_WARNING

public static final int HANDS_ON_DETECTION_WARNING

Hands On Detection (HOD) warning.

Returns whether a warning is being sent to the driver for having their hands off the wheel for too long a duration.

Generally, this property should return a valid state defined in the ERROR(/android.car.hardware.property.HandsOnDetectionWarning) or ERROR(/android.car.hardware.property.ErrorState). For example, if the feature is not available due to some temporary state, that information should be conveyed through an ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.HandsOnDetectionWarning) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411096 (0x11401018)

HAZARD_LIGHTS_STATE

public static final int HAZARD_LIGHTS_STATE

Hazard light status.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410563 (0x11400e03)

HAZARD_LIGHTS_SWITCH

public static final int HAZARD_LIGHTS_SWITCH

Hazard light switch.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410579 (0x11400e13)

HEADLIGHTS_STATE

public static final int HEADLIGHTS_STATE

Headlights State.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410560 (0x11400e00)

HEADLIGHTS_SWITCH

public static final int HEADLIGHTS_SWITCH

Headlight switch.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410576 (0x11400e10)

HEAD_UP_DISPLAY_ENABLED

public static final int HEAD_UP_DISPLAY_ENABLED

Head up display (HUD) enabled

This property allows the user to turn on/off the HUD for their seat.

Each HUD in the vehicle will be assigned to the seat that is intended to use it. For example, if there is a single HUD in the vehicle that is used by the driver so that they no longer need to continuously look at the instrument cluster, then this property will be defined with a single area ID that is equal to the driver's seat area ID.

Property Config:

Required Permissions:

Constant Value: 354421254 (0x15200a06)

HIGH_BEAM_LIGHTS_STATE

public static final int HIGH_BEAM_LIGHTS_STATE

High beam lights state.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410561 (0x11400e01)

HIGH_BEAM_LIGHTS_SWITCH

public static final int HIGH_BEAM_LIGHTS_SWITCH

High beam light switch.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410577 (0x11400e11)

HVAC_ACTUAL_FAN_SPEED_RPM

public static final int HVAC_ACTUAL_FAN_SPEED_RPM

Actual fan speed.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517135 (0x1540050f)

HVAC_AC_ON

public static final int HVAC_AC_ON

On/off AC for designated areaId.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419973 (0x15200505)

HVAC_AUTO_ON

public static final int HVAC_AUTO_ON

On/off automatic mode.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419978 (0x1520050a)

HVAC_AUTO_RECIRC_ON

public static final int HVAC_AUTO_RECIRC_ON

Automatic recirculation on/off.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419986 (0x15200512)

HVAC_DEFROSTER

public static final int HVAC_DEFROSTER

On/off defrost for designated window.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 320865540 (0x13200504)

HVAC_DUAL_ON

public static final int HVAC_DUAL_ON

Enable temperature coupling between areas.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419977 (0x15200509)

HVAC_ELECTRIC_DEFROSTER_ON

public static final int HVAC_ELECTRIC_DEFROSTER_ON

ELECTRIC DEFROSTER.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 320865556 (0x13200514)

HVAC_FAN_DIRECTION

public static final int HVAC_FAN_DIRECTION

The current ERROR(CarHvacFanDirection/android.car.hardware.CarHvacFanDirection CarHvacFanDirection) setting.

The supported values for this property is exposed via HVAC_FAN_DIRECTION_AVAILABLE. Caller should not call ERROR(/CarPropertyManager#getSupportedValuesList) or ERROR(/CarPropertyManager#getMinMaxSupportedValue) or ERROR(/AreaIdConfig#getSupportedEnumValues).

This property will be supported if HVAC_FAN_DIRECTION_AVAILABLE is supported on the vehicle, and vice versa.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517121 (0x15400501)

HVAC_FAN_DIRECTION_AVAILABLE

public static final int HVAC_FAN_DIRECTION_AVAILABLE

List of supported ERROR(CarHvacFanDirection/android.car.hardware.CarHvacFanDirection CarHvacFanDirection) values for the vehicle.

For each supported area ID, this property provides a list of supported HVAC fan positions for the HVAC_FAN_DIRECTION property (e.g. ERROR(CarHvacFanDirection.DEFROST_AND_FLOOR/android.car.hardware.CarHvacFanDirection#DEFROST_AND_FLOOR CarHvacFanDirection.DEFROST_AND_FLOOR)).

This property will be supported if HVAC_FAN_DIRECTION is supported on the vehicle, and vice versa.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356582673 (0x15410511)

HVAC_FAN_SPEED

public static final int HVAC_FAN_SPEED

Fan speed setting.

This property is not in any particular unit but in a specified range of relative speeds. 0 means the fan is off. The value must be non-negative, larger values mean faster fan speed.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

For each areaId, the result for getMinMaxSupportedValue indicates the range of possible fan speed.

If 0 is included in the range, then you can use this property to turn off the fan. Otherwise, you cannot use this property to turn off the fan, use ERROR(/HVAC_POWER_ON) instead.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517120 (0x15400500)

HVAC_MAX_AC_ON

public static final int HVAC_MAX_AC_ON

On/off max AC.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419974 (0x15200506)

HVAC_MAX_DEFROST_ON

public static final int HVAC_MAX_DEFROST_ON

On/off max defrost.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419975 (0x15200507)

HVAC_POWER_ON

public static final int HVAC_POWER_ON

Represents global power state for HVAC.

Setting this property to false MAY mark some properties that control individual HVAC features/subsystems to UNAVAILABLE state. Setting this property to true MAY mark some properties that control individual HVAC features/subsystems to AVAILABLE state (unless any/all of them are UNAVAILABLE on their own individual merits).

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419984 (0x15200510)

HVAC_RECIRC_ON

public static final int HVAC_RECIRC_ON

Recirculation on/off.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419976 (0x15200508)

HVAC_SEAT_TEMPERATURE

public static final int HVAC_SEAT_TEMPERATURE

Seat heating/cooling.

This property is not in any particular unit, but in a specified range of relative temperature settings. 0 means no heating or cooling. Positive values indicate heating and negative values indicate cooling. Larger absolute values indicate stronger heating or cooling.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is 0, unless the vehicle supports seat cooling as well. In this case, it indicates the maximum seat temperature cooling setting in negative number.

MinMaxSupportedValue.getMaxValue() indicates the maximum seat temperature heating setting.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517131 (0x1540050b)

HVAC_SEAT_VENTILATION

public static final int HVAC_SEAT_VENTILATION

Seat ventilation.

This property is not in any particular unit but in the specified range of ventilation settings. 0 means no ventilation. The value must be non-negative. Larger values indicate stronger ventilation.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is 0.

MinMaxSupportedValue.getMaxValue() indicates the maximum ventilation setting available for the seat.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517139 (0x15400513)

HVAC_SIDE_MIRROR_HEAT

public static final int HVAC_SIDE_MIRROR_HEAT

Side Mirror Heat.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is 0 and indicates no heating.

MinMaxSupportedValue.getMaxValue() indicates the the maximum heating level.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 339739916 (0x1440050c)

HVAC_STEERING_WHEEL_HEAT

public static final int HVAC_STEERING_WHEEL_HEAT

Steering Wheel Heating/Cooling.

This property is not in any particular unit but in a specified range of heating settings. 0 means no heating or cooling. Positive values indicate heating and negative values indicate cooling. Larger absolute values indicate stronger heating or cooling.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is 0, unless the vehicle supports steering wheel cooling as well. In such a case, it indicates the maximum steering wheel cooling setting in negative number.

MinMaxSupportedValue.getMaxValue() indicates the maximum steering wheel heating setting.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 289408269 (0x1140050d)

HVAC_TEMPERATURE_CURRENT

public static final int HVAC_TEMPERATURE_CURRENT

HVAC current temperature in celsius.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 358614274 (0x15600502)

HVAC_TEMPERATURE_DISPLAY_UNITS

public static final int HVAC_TEMPERATURE_DISPLAY_UNITS

Temperature units for display.

Property Config:

Required Permissions:

Constant Value: 289408270 (0x1140050e)

HVAC_TEMPERATURE_SET

public static final int HVAC_TEMPERATURE_SET

HVAC target temperature set in Celsius.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

For each areaId, the result for getMinMaxSupportedValue indicates the range of HVAC temperature in Celsius.

The vehicle may not support setting a continuous range of temperature values in between the min and max values.

Therefore, if the vehicle supports HVAC_TEMPERATURE_VALUE_SUGGESTION, the application should use that property to get a supported value before setting HVAC_TEMPERATURE_SET. The application should also use HVAC_TEMPERATURE_VALUE_SUGGESTION for converting the temperature from Celsius to Fahrenheit and vice versa for this vehicle.

Else if the CarPropertyConfig.getConfigArray() is defined, then it represents the list of valid temperature values that can be set. It also describes a lookup table to convert the temperature from Celsius to Fahrenheit and vice versa for this vehicle.

The configArray is set as follows:

  • configArray[0] is [the lower bound of the supported temperature in Celsius] * 10.
  • configArray[1] is [the upper bound of the supported temperature in Celsius] * 10.
  • configArray[2] is [the increment in Celsius] * 10.
  • configArray[3] is [the lower bound of the supported temperature in Fahrenheit] * 10.
  • configArray[4] is [the upper bound of the supported temperature in Fahrenheit] * 10.
  • configArray[5] is [the increment in Fahrenheit] * 10.

For example, if the vehicle supports temperature values as: 

 [16.0, 16.5, 17.0 ,..., 28.0] in Celsius
 [60.5, 61.5, 62.5 ,..., 84.5] in Fahrenheit

The configArray should be: 

 configArray = {160, 280, 5, 605, 845, 10}

If the configArray is defined, applications should not use any other method for converting temperature values besides HVAC_TEMPERATURE_VALUE_SUGGESTION, such as the standard unit conversion formula of F = (9/5) * C + 32. Any value set that is not contained within the list of valid values is considered undefined behavior and may result in inconsistencies in the value set by the application and the value set in the VHAL.

For converting the temperature from Celsius to Fahrenheit use the following: 

 // Given tempC and configArray
 float minTempC = configArray.get(0) / 10f;
 float temperatureIncrementCelsius = configArray.get(2) / 10f;
 float minTempF = configArray.get(3) / 10f;
 float temperatureIncrementFahrenheit = configArray.get(5) / 10f;
 // Round to the closest increment
 int numIncrements = Math.round((tempC - minTempC) / temperatureIncrementCelsius);
 float tempF = temperatureIncrementFahrenheit * numIncrements + minTempF;

For converting the temperature from Fahrenheit to Celsius, use the same method as above except changing the Celsius values to the relevant Fahrenheit values.

Othwerise, if neither HVAC_TEMPERATURE_VALUE_SUGGESTION nor the configArray are defined, the application should use the standard unit conversion formula of F = (9/5) * C + 32.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 358614275 (0x15600503)

HVAC_TEMPERATURE_VALUE_SUGGESTION

public static final int HVAC_TEMPERATURE_VALUE_SUGGESTION

Suggested values for setting HVAC temperature.

Implement the property to help applications understand the closest supported temperature value in Celsius or Fahrenheit.

  • floatValues[0] is the requested value that an application wants to set a temperature to.
  • floatValues[1] is the unit for floatValues[0]. It should be one of (VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT).
  • floatValues[2] is the value OEMs suggested in CELSIUS. This value is not included in the request.
  • floatValues[3] is the value OEMs suggested in FAHRENHEIT. This value is not included in the request.

An application calls CarPropertyManager.setProperty(Class, int, int, Object) with the requested value and unit for the value. OEMs need to return the suggested values in floatValues[2] and floatValues[3] by CarPropertyManager.CarPropertyEventCallback.

For example, when a user uses the voice assistant to set HVAC temperature to 66.2 in Fahrenheit.

First, an application will set this property with the value [66.2, VehicleUnit.FAHRENHEIT, 0, 0]. If OEMs suggest to set 19.0 in Celsius or 66.5 in Fahrenheit for user's request, then car must generate a callback with property value [66.2, VehicleUnit.FAHRENHEIT, 19.0, 66.5]. After the voice assistant gets the callback, it will inform the user and set HVAC temperature to the suggested value.

Another example, an application receives 21 Celsius as the current temperature value by querying VehiclePropertyIds.HVAC_TEMPERATURE_SET. But the application wants to know what value is displayed on the car's UI in Fahrenheit.

For this, the application sets the property to [21, VehicleUnit.CELSIUS, 0, 0]. If the suggested value by the OEM for 21 Celsius is 70 Fahrenheit, then car must generate a callback with property value [21, VehicleUnit.CELSIUS, 21.0, 70.0]. In this case, the application can know that the value is 70.0 Fahrenheit in the car\u2019s UI.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 291570965 (0x11610515)

HW_KEY_INPUT

public static final int HW_KEY_INPUT

This constant is deprecated.
car service internal use only.

Property to feed H/W input events to android.

Not exposed through CarPropertyManager.

This property is not supported.

Constant Value: 289475088 (0x11410a10)

IGNITION_STATE

public static final int IGNITION_STATE

Vehicle's ignition state.

See VehicleIgnitionState for possible values for IGNITION_STATE.

Property Config:

Required Permission:


Requires Car.PERMISSION_POWERTRAIN

Constant Value: 289408009 (0x11400409)

IMPACT_DETECTED

public static final int IMPACT_DETECTED

Impact detected.

Bit flag property to relay information on whether an impact has occurred on a particular side of the vehicle as described through the ERROR(/android.car.hardware.property.ImpactSensorLocation) enum. As a bit flag property, this property can be set to multiple ORed together values of the enum when necessary.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which bit flags from ERROR(/android.car.hardware.property.ImpactSensorLocation) are supported.

Property Config:

Required Permission:

Constant Value: 289407792 (0x11400330)

INFO_DRIVER_SEAT

public static final int INFO_DRIVER_SEAT

Driver's seat location.

The only area ID listed in CarPropertyConfig.getAreaIds() for INFO_DRIVER_SEAT will be 0.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 356516106 (0x1540010a)

INFO_EV_BATTERY_CAPACITY

public static final int INFO_EV_BATTERY_CAPACITY

Nominal usable battery capacity for EV or hybrid vehicle.

Returns the nominal battery capacity in VehicleUnit.WATT_HOUR, if EV or hybrid. This is the usable battery capacity when the vehicle is new. This value might be different from EV_CURRENT_BATTERY_CAPACITY because EV_CURRENT_BATTERY_CAPACITY returns the real-time usable battery capacity taking into account factors such as battery aging and temperature dependency.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 291504390 (0x11600106)

INFO_EV_CONNECTOR_TYPE

public static final int INFO_EV_CONNECTOR_TYPE

List of EvChargingConnectorTypes this vehicle may use.

If the vehicle has multiple charging ports, this property will return all possible connector types that can be used by at least one charging port on the vehicle.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289472775 (0x11410107)

INFO_EV_PORT_LOCATION

public static final int INFO_EV_PORT_LOCATION

PortLocationType for the EV port location.

This property communicates the location of the charging port on the EV. If there are multiple ports on the vehicle, this will communicate the port that enables the fastest charging on the vehicle. See INFO_MULTI_EV_PORT_LOCATIONS to get information on all port locations.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289407241 (0x11400109)

INFO_EXTERIOR_DIMENSIONS

public static final int INFO_EXTERIOR_DIMENSIONS

Vehicle's exterior dimensions in millimeters.

Exterior dimensions defined in the CarPropertyValue.getValue() Integer[]:

  • Integer[0] = height
  • Integer[1] = length
  • Integer[2] = width
  • Integer[3] = width including mirrors
  • Integer[4] = wheel base
  • Integer[5] = track width front
  • Integer[6] = track width rear
  • Integer[7] = curb to curb turning diameter

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289472779 (0x1141010b)

INFO_FUEL_CAPACITY

public static final int INFO_FUEL_CAPACITY

Fuel capacity of the vehicle in milliliters.

This property communicates the maximum amount of the fuel that can be stored in the vehicle in milliliters. This property will not be implemented for electric vehicles. That is, if INFO_FUEL_TYPE only contains FuelType.ELECTRIC, this property will not be implemented. For EVs, see INFO_EV_BATTERY_CAPACITY.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 291504388 (0x11600104)

INFO_FUEL_DOOR_LOCATION

public static final int INFO_FUEL_DOOR_LOCATION

PortLocationType for the fuel door location.

This property communicates the location of the fuel door on the vehicle. This property will not be implemented for electric vehicles. That is, if INFO_FUEL_TYPE only contains FuelType.ELECTRIC, this property will not be implemented. For EVs, see INFO_EV_PORT_LOCATION or INFO_MULTI_EV_PORT_LOCATIONS.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289407240 (0x11400108)

INFO_FUEL_TYPE

public static final int INFO_FUEL_TYPE

List the FuelTypes the vehicle may use.

FuelType.ELECTRIC will only be included if the vehicle is plug in rechargeable. Note that for this reason, even though FuelType.ELECTRIC is not listed as a fuel type, other EV properties such as INFO_EV_BATTERY_CAPACITY can still be supported on the vehicle.

For example:

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289472773 (0x11410105)

INFO_MAKE

public static final int INFO_MAKE

Manufacturer of vehicle.

This property communicates the vehicle's public brand name.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 286261505 (0x11100101)

INFO_MODEL

public static final int INFO_MODEL

Model of vehicle.

This property communicates the vehicle's public model name.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 286261506 (0x11100102)

INFO_MODEL_TRIM

public static final int INFO_MODEL_TRIM

Public trim name of the vehicle.

This property communicates the vehicle's public trim name.

For example, say an OEM manufactures two different versions of a vehicle model:

  • "makeName modelName" and
  • "makeName modelName Sport"

This property will be empty for the first vehicle (i.e. base model), and set to "Sport" for the second vehicle.

Property Config:

Required Permission:

Constant Value: 286261517 (0x1110010d)

INFO_MODEL_YEAR

public static final int INFO_MODEL_YEAR

Model year of vehicle in YYYY format based on Gregorian calendar.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289407235 (0x11400103)

INFO_MULTI_EV_PORT_LOCATIONS

public static final int INFO_MULTI_EV_PORT_LOCATIONS

List PortLocationTypes for Multiple EV port locations.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_INFO

Constant Value: 289472780 (0x1141010c)

INFO_VEHICLE_SIZE_CLASS

public static final int INFO_VEHICLE_SIZE_CLASS

Vehicle Size Class.

This property communicates the list of size classifications that the vehicle follows according to the multiple standards that are defined in VehicleSizeClass

For example, suppose a vehicle model follows the VehicleSizeClass.EU_A_SEGMENT standard in the EU and the VehicleSizeClass.JPN_KEI standard in Japan. In this scenario this property must return an intArray = [VehicleSizeClass.EU_A_SEGMENT, VehicleSizeClass.JPN_KEI]. If this vehicle only follows the EU VehicleSizeClass.EU_A_SEGMENT standard, then we expect intArray = [VehicleSizeClass.EU_A_SEGMENT].

Property Config:

Required Permission:

Constant Value: 289472782 (0x1141010e)

INFO_VIN

public static final int INFO_VIN

VIN of vehicle

Property Config:

Required Permission:


Requires Car.PERMISSION_IDENTIFICATION

Constant Value: 286261504 (0x11100100)

INSTANTANEOUS_EV_EFFICIENCY

public static final int INSTANTANEOUS_EV_EFFICIENCY

Instantaneous EV efficiency in km/kWh.

This property communicates the instantaneous EV battery efficiency of the vehicle in units of km/kWh. Clients can reference the value of DISTANCE_DISPLAY_UNITS and EV_BATTERY_DISPLAY_UNITS before displaying this property to the user to match the display units used by rest of the system.

For the fuel version of this property, see INSTANTANEOUS_FUEL_ECONOMY.

Property Config:

Required Permission:

Constant Value: 291504658 (0x11600212)

INSTANTANEOUS_FUEL_ECONOMY

public static final int INSTANTANEOUS_FUEL_ECONOMY

Instantaneous Fuel Economy in L/100km.

This property communicates the instantaneous fuel economy of the vehicle in units of L/100km. Clients can reference the value of DISTANCE_DISPLAY_UNITS, FUEL_VOLUME_DISPLAY_UNITS, and FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME before displaying this property to the user to match the display units used by rest of the system.

For the EV version of this property, see INSTANTANEOUS_EV_EFFICIENCY.

Property Config:

Required Permission:

Constant Value: 291504657 (0x11600211)

INVALID

public static final int INVALID

Undefined property.

This property should never be used/will never be supported.

Constant Value: 0 (0x00000000)

LANE_CENTERING_ASSIST_COMMAND

public static final int LANE_CENTERING_ASSIST_COMMAND

Lane Centering Assist (LCA) commands.

Commands to activate and suspend LCA. They are only valid when LANE_CENTERING_ASSIST_ENABLED = true. Otherwise, these commands will throw a PropertyNotAvailableException.

When the command ERROR(/android.car.hardware.property.LaneCenteringAssistCommand#ACTIVATE) is sent, LANE_CENTERING_ASSIST_STATE will be set to ERROR(/android.car.hardware.property.LaneCenteringAssistState#ACTIVATION_REQUESTED). When the command ERROR(/android.car.hardware.property.LaneCenteringAssistCommand#ACTIVATE) succeeds, LANE_CENTERING_ASSIST_STATE will be set to ERROR(/android.car.hardware.property.LaneCenteringAssistState#ACTIVATED). When the command ERROR(/android.car.hardware.property.LaneCenteringAssistCommand#DEACTIVATE) succeeds, LANE_CENTERING_ASSIST_STATE will be set to ERROR(/android.car.hardware.property.LaneCenteringAssistState#ENABLED).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which enum values from ERROR(/android.car.hardware.property.LaneCenteringAssistCommand) are supported.

Property Config:

Required Permission:

Constant Value: 289411083 (0x1140100b)

LANE_CENTERING_ASSIST_ENABLED

public static final int LANE_CENTERING_ASSIST_ENABLED

Enable or disable Lane Centering Assist (LCA).

Returns true if LCA is enabled and false if LCA is disabled. When LCA is enabled, the ADAS system in the vehicle should be turned on and waiting for an activation signal from the driver. Once the feature is activated, the ADAS system should be steering the vehicle to keep it centered in its current lane.

This is different from Lane Keep Assist (LKA) which monitors if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313930 (0x1120100a)

LANE_CENTERING_ASSIST_STATE

public static final int LANE_CENTERING_ASSIST_STATE

Lane Centering Assist (LCA) state.

Returns the current state of LCA. This property will always return a valid state defined in ERROR(/android.car.hardware.property.LaneCenteringAssistState) or ERROR(/android.car.hardware.property.ErrorState).

If LCA includes lane departure warnings, those warnings will be surfaced through the Lane Departure Warning (LDW) properties.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.LaneCenteringAssistState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411084 (0x1140100c)

LANE_DEPARTURE_WARNING_ENABLED

public static final int LANE_DEPARTURE_WARNING_ENABLED

Enable or disable Lane Departure Warning (LDW).

Returns true if LDW is enabled and false if LDW is disabled. When LDW is enabled, the ADAS system in the vehicle should be turned on and monitoring if the vehicle is approaching or crossing lane lines, in which case a warning will be given.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313926 (0x11201006)

LANE_DEPARTURE_WARNING_STATE

public static final int LANE_DEPARTURE_WARNING_STATE

Lane Departure Warning (LDW) state.

Returns the current state of LDW. This property will always return a valid state defined in ERROR(/android.car.hardware.property.LaneDepartureWarningState) or ERROR(/android.car.hardware.property.ErrorState).

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.LaneDepartureWarningState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411079 (0x11401007)

LANE_KEEP_ASSIST_ENABLED

public static final int LANE_KEEP_ASSIST_ENABLED

Enable or disable Lane Keep Assist (LKA).

Returns true if LKA is enabled and false if LKA is disabled. When LKA is enabled, the ADAS system in the vehicle should be turned on and monitoring if the driver unintentionally drifts toward or over the lane marking. If an unintentional lane departure is detected, the system applies steering control to return the vehicle into the current lane.

This is different from Lane Centering Assist (LCA) which, when activated, applies continuous steering control to keep the vehicle centered in the current lane.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313928 (0x11201008)

LANE_KEEP_ASSIST_STATE

public static final int LANE_KEEP_ASSIST_STATE

Lane Keep Assist (LKA) state.

Returns the current state of LKA. This property will always return a valid state defined in ERROR(/android.car.hardware.property.LaneKeepAssistState) or ERROR(/android.car.hardware.property.ErrorState).

If LKA includes lane departure warnings before applying steering corrections, those warnings will be surfaced through LANE_DEPARTURE_WARNING_STATE.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.LaneKeepAssistState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411081 (0x11401009)

LOCATION_CHARACTERIZATION

public static final int LOCATION_CHARACTERIZATION

Characterization of inputs used for computing location.

This property indicates what (if any) data and sensor inputs are considered by the system when computing the vehicle's location that is shared with Android through LocationManager.GPS_PROVIDER.

The value returned is a collection of bit flags. The bit flags are defined in LocationCharacterization. The value will also include exactly one of LocationCharacterization.DEAD_RECKONED or LocationCharacterization.RAW_GNSS_ONLY among its collection of bit flags.

When this property is not supported, it is assumed that no additional sensor inputs are fused into the GNSS updates provided through LocationManager.GPS_PROVIDER. That is unless otherwise specified through other LocationManager APIs.

Property Config:

Required Permission:


Requires Manifest.permission.ACCESS_FINE_LOCATION

Constant Value: 289410064 (0x11400c10)

LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED

public static final int LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED

Enable or disable Low Speed Automatic Emergency Braking.

Returns true if Low Speed Automatic Emergency Braking is enabled or false if Low Speed Automatic Emergency Braking is disabled. When Low Speed Automatic Emergency Braking is enabled, the ADAS system in the vehicle will be turned on and monitoring to avoid potential collisions in low speed conditions. This property is different from the pre-existing AUTOMATIC_EMERGENCY_BRAKING_ENABLED, which should apply to higher speed applications only. If the vehicle doesn't have a separate collision avoidance system for low speed environments, this property will not be implemented.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313957 (0x11201025)

LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE

public static final int LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE

Low Speed Automatic Emergency Braking state.

Returns the current state of Low Speed Automatic Emergency Braking. This property will always return a valid state defined in ERROR(/android.car.hardware.property.LowSpeedAutomaticEmergencyBrakingState) or ERROR(/android.car.hardware.property.ErrorState).

If Low Speed Automatic Emergency Braking includes collision warnings before activating the brakes, those warnings will be surfaced through use of LOW_SPEED_COLLISION_WARNING_ENABLED and LOW_SPEED_COLLISION_WARNING_STATE.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.LowSpeedAutomaticEmergencyBrakingState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411110 (0x11401026)

LOW_SPEED_COLLISION_WARNING_ENABLED

public static final int LOW_SPEED_COLLISION_WARNING_ENABLED

Enable or disable Low Speed Collision Warning.

Returns true if low speed collision warning is enabled and false if low speed collision warning is disabled. When low speed collision warning is enabled, the ADAS system in the vehicle will warn the driver of potential collisions at low speeds. This property is different from the pre-existing VehiclePropertyIds.FORWARD_COLLISION_WARNING_ENABLED, which applies to higher speed applications only. If the vehicle doesn't have a separate collision detection system for low speed environments, this property will not be implemented.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287313953 (0x11201021)

LOW_SPEED_COLLISION_WARNING_STATE

public static final int LOW_SPEED_COLLISION_WARNING_STATE

Low Speed Collision Warning State state.

Returns the current state of Low Speed Collision Warning. This property will always return a valid state defined in ERROR(/android.car.hardware.property.LowSpeedCollisionWarningState) or ERROR(/android.car.hardware.property.ErrorState). This property is different from the pre-existing VehiclePropertyIds.FORWARD_COLLISION_WARNING_ENABLED, which applies to higher speed applications only. If the vehicle doesn't have a separate collision detection system for low speed environments, this property will not be implemented.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.LowSpeedCollisionWarningState) and ERROR(/android.car.hardware.property.ErrorState) are supported.

Property Config:

Required Permission:

Constant Value: 289411106 (0x11401022)

MIRROR_AUTO_FOLD_ENABLED

public static final int MIRROR_AUTO_FOLD_ENABLED

Represents property for the Mirror Auto Fold feature.

This property is true when the feature for automatically folding the vehicle's mirrors (for example, when the mirrors fold inward automatically when one exits and locks the vehicle) is enabled.

Property Config:

Required Permission:

MIRROR_AUTO_TILT_ENABLED

public static final int MIRROR_AUTO_TILT_ENABLED

Represents property for the Mirror Auto Tilt feature.

This property is true when the feature for automatically tilting the vehicle's mirrors (for example, when the mirrors tilt downward automatically when one reverses the vehicle) is enabled.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 337644359 (0x14200b47)

MIRROR_FOLD

public static final int MIRROR_FOLD

Mirror Fold.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 287312709 (0x11200b45)

MIRROR_LOCK

public static final int MIRROR_LOCK

Mirror Lock.

True indicates all mirror positions are locked and not changeable.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 287312708 (0x11200b44)

MIRROR_Y_MOVE

public static final int MIRROR_Y_MOVE

Mirror Y Move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the mirror is tilting to the right and negative values mean the support is tilting to the left. Larger integers, either positive or negative, indicate a faster speed. Once the mirror reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the mirror while tilting left.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the mirror while tilting right.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 339741507 (0x14400b43)

MIRROR_Y_POS

public static final int MIRROR_Y_POS

Mirror Y Position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the mirror is tilted completely to the left. This must be a non-positive value.

MinMaxSupportedValue.getMaxValue() indicates the mirror is tilted completely to the right. This must be a non-negative value.

0 indicates the mirror is not tilted in either direction.

All integers between the min and max values are supported and indicate a transition state between the extreme left and extreme right positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 339741506 (0x14400b42)

MIRROR_Z_MOVE

public static final int MIRROR_Z_MOVE

Mirror Z Move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the mirror is tilting up and negative values mean the mirror is tilting down. Larger integers, either positive or negative, indicate a faster speed. Once the mirror reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the mirror while tilting downwards.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the mirror while tilting upwards.

All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 339741505 (0x14400b41)

MIRROR_Z_POS

public static final int MIRROR_Z_POS

Mirror Z Position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the mirror is tilted completely downwards. This must be a non-positive value.

MinMaxSupportedValue.getMaxValue() indicates the mirror is tilted completely upwards. This must be a non-negative value.

0 indicates the mirror is not tilted in either direction.

All integers between the min and max values are supported and indicate a transition state between the completely downwards and completely upwards positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_MIRRORS

Constant Value: 339741504 (0x14400b40)

NIGHT_MODE

public static final int NIGHT_MODE

Night mode.

True indicates that the night mode sensor has detected that the car cabin environment has low light.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_ENVIRONMENT

Constant Value: 287310855 (0x11200407)

OBD2_FREEZE_FRAME

public static final int OBD2_FREEZE_FRAME

This constant is deprecated.
use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

OBD2 Freeze Frame Sensor Data.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_DIAGNOSTIC_READ_ALL

Constant Value: 299896065 (0x11e00d01)

OBD2_FREEZE_FRAME_CLEAR

public static final int OBD2_FREEZE_FRAME_CLEAR

This constant is deprecated.
use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

OBD2 Freeze Frame Clear.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_DIAGNOSTIC_CLEAR

Constant Value: 299896067 (0x11e00d03)

OBD2_FREEZE_FRAME_INFO

public static final int OBD2_FREEZE_FRAME_INFO

This constant is deprecated.
use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

OBD2 Freeze Frame Information.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_DIAGNOSTIC_READ_ALL

Constant Value: 299896066 (0x11e00d02)

OBD2_LIVE_FRAME

public static final int OBD2_LIVE_FRAME

This constant is deprecated.
use ERROR(/android.car.diagnostic.CarDiagnosticManager) instead.

OBD2 Live Sensor Data.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_DIAGNOSTIC_READ_ALL

Constant Value: 299896064 (0x11e00d00)

PARKING_BRAKE_AUTO_APPLY

public static final int PARKING_BRAKE_AUTO_APPLY

Auto-apply parking brake.

PARKING_BRAKE_AUTO_APPLY is true indicates that the car's automatic parking brake feature is currently enabled. False indicates that the car's automatic parking brake feature is currently disabled.

This property is often confused with PARKING_BRAKE_ON. The difference is that PARKING_BRAKE_ON describes whether the actual parking brake is currently on/off, whereas PARKING_BRAKE_AUTO_APPLY describes whether the feature of automatic parking brake is enabled/disabled, and does not describe the current state of the actual parking brake.

Property Config:

Required Permission:


Requires Car.PERMISSION_POWERTRAIN

Constant Value: 287310851 (0x11200403)

PARKING_BRAKE_ON

public static final int PARKING_BRAKE_ON

Parking brake state.

PARKING_BRAKE_ON is true indicates that the car's parking brake is currently engaged. False implies that the car's parking brake is currently disengaged.

Property Config:

Required Permission:


Requires Car.PERMISSION_POWERTRAIN

Constant Value: 287310850 (0x11200402)

PERF_ODOMETER

public static final int PERF_ODOMETER

Current odometer value of the vehicle in kilometers.

Property Config:

Required Permission:

Constant Value: 291504644 (0x11600204)

PERF_REAR_STEERING_ANGLE

public static final int PERF_REAR_STEERING_ANGLE

Rear bicycle model steering angle for vehicle in degrees.

Left is negative.

This property is independent of the angle of the steering wheel. This property communicates the angle of the rear wheels with respect to the vehicle, not the angle of the steering wheel.

Property Config:

Required Permission:


Requires Car.PERMISSION_READ_STEERING_STATE

Constant Value: 291504656 (0x11600210)

PERF_STEERING_ANGLE

public static final int PERF_STEERING_ANGLE

Front bicycle model steering angle for vehicle in degrees.

Left is negative.

This property is independent of the angle of the steering wheel. This property communicates the angle of the front wheels with respect to the vehicle, not the angle of the steering wheel.

Property Config:

Required Permission:

Constant Value: 291504649 (0x11600209)

PERF_VEHICLE_SPEED

public static final int PERF_VEHICLE_SPEED

Speed of the vehicle in meters per second.

When the vehicle is moving forward, PERF_VEHICLE_SPEED is positive and negative when the vehicle is moving backward. Also, this value is independent of gear value (CURRENT_GEAR or GEAR_SELECTION). For example, if GEAR_SELECTION is VehicleGear.GEAR_NEUTRAL, PERF_VEHICLE_SPEED is positive when the vehicle is moving forward, negative when moving backward, and zero when not moving.

Property Config:

Required Permission:


Requires Car.PERMISSION_SPEED

Constant Value: 291504647 (0x11600207)

PERF_VEHICLE_SPEED_DISPLAY

public static final int PERF_VEHICLE_SPEED_DISPLAY

Speed of the vehicle in meters per second for displays.

Some cars display a slightly slower speed than the actual speed. This is usually displayed on the speedometer.

Property Config:

Required Permission:


Requires Car.PERMISSION_SPEED

Constant Value: 291504648 (0x11600208)

PER_DISPLAY_BRIGHTNESS

public static final int PER_DISPLAY_BRIGHTNESS

This constant is deprecated.
use CarPowerManager instead.

Property to represent brightness of the displays which are controlled separately.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_CAR_POWER

Constant Value: 289475076 (0x11410a04)

RANGE_REMAINING

public static final int RANGE_REMAINING

Range remaining in meters.

Range remaining accounts for all energy sources in a vehicle. For example, a hybrid car's range will be the sum of the ranges based on fuel and battery.

Property Config:

Required Permissions:

Constant Value: 291504904 (0x11600308)

READING_LIGHTS_STATE

public static final int READING_LIGHTS_STATE

Reading lights.

Property Config:

Required Permission:


Requires Car.PERMISSION_READ_INTERIOR_LIGHTS

Constant Value: 356519683 (0x15400f03)

READING_LIGHTS_SWITCH

public static final int READING_LIGHTS_SWITCH

Reading lights switch.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_INTERIOR_LIGHTS

Constant Value: 356519684 (0x15400f04)

REAR_FOG_LIGHTS_STATE

public static final int REAR_FOG_LIGHTS_STATE

Rear fog lights state.

Please refer to the documentation on FOG_LIGHTS_STATE for more information.

Property Config:

Required Permission:


Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410877 (0x11400f3d)

REAR_FOG_LIGHTS_SWITCH

public static final int REAR_FOG_LIGHTS_SWITCH

Rear fog lights switch.

Please refer to the documentation on FOG_LIGHTS_SWITCH for more information.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410878 (0x11400f3e)

SEAT_AIRBAGS_DEPLOYED

public static final int SEAT_AIRBAGS_DEPLOYED

State of deployment for seat airbags.

Bit flag property to relay information on which airbags have been deployed in the vehicle at each seat, vs which ones are currently still armed. When SEAT_AIRBAG_ENABLED is set to false at a particular areaId, this property will be UNAVAILABLE at that areaId.

Enums apply to each seat, not the global vehicle. For example, ERROR(/android.car.hardware.property.VehicleAirbagLocation#CURTAIN) at the driver seat areaId represents whether the driver side curtain airbag has been deployed. Multiple bit flags can be set to indicate that multiple different airbags have been deployed for the seat.

For each seat area ID, the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.VehicleAirbagLocation) are supported.

Property Config:

Required Permission:

Constant Value: 356518821 (0x15400ba5)

SEAT_AIRBAG_ENABLED

public static final int SEAT_AIRBAG_ENABLED

Represents feature to enable/disable a seat's ability to deploy airbag(s) when triggered (e.g. by a crash).

If true, it means the seat's airbags are enabled, and if triggered (e.g. by a crash), they will deploy. If false, it means the seat's airbags are disabled, and they will not deploy under any circumstance. This property does not indicate if the airbags are deployed or not.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_AIRBAGS

Constant Value: 354421662 (0x15200b9e)

SEAT_BACKREST_ANGLE_1_MOVE

public static final int SEAT_BACKREST_ANGLE_1_MOVE

Seat backrest angle 1 move.

This property moves the seat backrest along the axis of rotation defined by the actuator closest to the bottom of the seat. This is the actuator that moves the seat upright/forward or into recline as seen in most conventional vehicles.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the seat is angling forward and negative values mean the seat is reclining backward. Larger integers, either positive or negative, indicate a faster speed. Once the seat reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the seat backrest while reclining.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the seat backrest while angling forward.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518792 (0x15400b88)

SEAT_BACKREST_ANGLE_1_POS

public static final int SEAT_BACKREST_ANGLE_1_POS

Seat backrest angle 1 position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the seat backrest's full recline position w.r.t the actuator at the bottom of the seat (see SEAT_BACKREST_ANGLE_1_MOVE for additional details).

MinMaxSupportedValue.getMaxValue() indicates the seat backrest's most upright/forward position w.r.t the actuator at the bottom of the seat (see SEAT_BACKREST_ANGLE_1_MOVE for additional details).

All integers between the min and max values are supported and indicate a transition state between the forward most and rearward most positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518791 (0x15400b87)

SEAT_BACKREST_ANGLE_2_MOVE

public static final int SEAT_BACKREST_ANGLE_2_MOVE

Seat backrest angle 2 move.

This property will be implemented if there exists an additional actuator in the seat backrest besides the one at the very bottom of the backrest, which is covered by SEAT_BACKREST_ANGLE_1_MOVE. This property will move the backrest along the axis of rotation defined by this additional actuator. It can be assumed that this actuator is closer to the headrest than the one defined by SEAT_BACKREST_ANGLE_1_MOVE.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the seat is angling forward and negative values mean the seat is reclining backward. Larger integers, either positive or negative, indicate a faster speed. Once the seat reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the seat backrest while reclining.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the seat backrest while angling forward.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518794 (0x15400b8a)

SEAT_BACKREST_ANGLE_2_POS

public static final int SEAT_BACKREST_ANGLE_2_POS

Seat backrest angle 2 position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the seat backrest's full recline position w.r.t the next actuator in the backrest from the one at the bottom of the seat (see SEAT_BACKREST_ANGLE_2_MOVE for more details).

MinMaxSupportedValue.getMaxValue() indicates the seat backrest's most upright/forward position w.r.t the next actuator in the backrest from the one at the bottom of the seat (see SEAT_BACKREST_ANGLE_2_MOVE for more details).

All integers between the min and max values are supported and indicate a transition state between the forward most and rearward most positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518793 (0x15400b89)

SEAT_BELT_BUCKLED

public static final int SEAT_BELT_BUCKLED

Seatbelt buckled.

True indicates belt is buckled.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 354421634 (0x15200b82)

SEAT_BELT_HEIGHT_MOVE

public static final int SEAT_BELT_HEIGHT_MOVE

Seatbelt height move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the seat belt's shoulder anchor is moving up and negative values mean the seat belt's shoulder anchor is moving down. Larger integers, either positive or negative, indicate a faster speed. Once the seat belt's shoulder anchor reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the seat belt's shoulder anchor while moving downwards.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the seat belt's shoulder anchor while moving upwards.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518788 (0x15400b84)

SEAT_BELT_HEIGHT_POS

public static final int SEAT_BELT_HEIGHT_POS

Seatbelt height position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the seat belt's shoulder anchor is at its lowest position.

MinMaxSupportedValue.getMaxValue() indicates the seat belt's shoulder anchor is at its highest position.

All integers between the min and max values are supported and indicate a transition state between the lowest and highest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518787 (0x15400b83)

SEAT_BELT_PRETENSIONER_DEPLOYED

public static final int SEAT_BELT_PRETENSIONER_DEPLOYED

Seat belt pretensioner deployed.

Property to relay information on whether the seat belt pretensioner has been deployed for a particular seat due to a collision. This is different from the regular seat belt tightening system that continuously adds tension to the seat belts so that they fit snugly around the person sitting in the seat, nor is it the seat belt retractor system that locks the seat belt in place during sudden brakes or when the user jerks the seat belt.

If this property is dependant on the state of other properties, and if those properties are currently in the state that doesn't support this property, reading this property will throw PropertyNotAvailableException.

Property Config:

Required Permission:

Constant Value: 354421670 (0x15200ba6)

SEAT_CUSHION_SIDE_SUPPORT_MOVE

public static final int SEAT_CUSHION_SIDE_SUPPORT_MOVE

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

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values means the seat cushion side support is growing wider (i.e. less support) and negative values means the seat cushion side support is growing thinner (i.e. more support). Larger integers, either positive or negative, indicate a faster speed. Once the seat cushion side support reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518816 (0x15400ba0)

SEAT_CUSHION_SIDE_SUPPORT_POS

public static final int SEAT_CUSHION_SIDE_SUPPORT_POS

Represents property for seat\u2019s hipside (bottom cushion\u2019s side) support position.

This property is not in any particular unit but in a specified range of relative positions.

The AreaIdConfig.getMinValue() indicates the seat hipside support's thinnest position (i.e. most support).

The AreaIdConfig.getMaxValue() indicates the seat hipside support's widest position (i.e. least support).

All integers between the min and max values are supported and indicate a transition state between the thinnest and widest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518815 (0x15400b9f)

SEAT_DEPTH_MOVE

public static final int SEAT_DEPTH_MOVE

Seat depth move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the distance between the seat's front edge and the back of the seat is increasing, thus making the seat deeper. Negative values mean the distance between the seat's front edge and the back of the seat is decreasing, thus making the seat shallower. Larger integers, either positive or negative, indicate a faster speed. Once the seat depth reaches its limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the seat while getting shallower.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the seat while getting deeper.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518798 (0x15400b8e)

SEAT_DEPTH_POS

public static final int SEAT_DEPTH_POS

Seat depth position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the seat is in its shallowest position (i.e. the position with the smallest distance between the front edge of the seat cushion and the rear end of the seat).

MinMaxSupportedValue.getMaxValue() indicates the seat is in its deepest position (i.e. the position with the largest distance between the front edge of the seat cushion and the rear end of the seat).

All integers between the min and max values are supported and indicate a transition state between the shallowest and deepest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518797 (0x15400b8d)

SEAT_EASY_ACCESS_ENABLED

public static final int SEAT_EASY_ACCESS_ENABLED

Represents property for Seat easy access feature.

If true, the seat will automatically adjust to make it easier for the occupant to enter and exit the vehicle. Each area ID maps to the seat that the user is trying to enter/exit with the help of the easy access feature.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 354421661 (0x15200b9d)

SEAT_FOOTWELL_LIGHTS_STATE

public static final int SEAT_FOOTWELL_LIGHTS_STATE

Represents property for state of the footwell lights.

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 (e.g. SEAT_FOOTWELL_LIGHTS_SWITCH=VehicleLightSwitch#STATE_AUTOMATIC and SEAT_FOOTWELL_LIGHTS_STATE=VehicleLightState#STATE_ON).

This property will 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 AreaIdConfig.getSupportedEnumValues() obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which enum values from VehicleLightState are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_READ_INTERIOR_LIGHTS

Constant Value: 356518811 (0x15400b9b)

SEAT_FOOTWELL_LIGHTS_SWITCH

public static final int SEAT_FOOTWELL_LIGHTS_SWITCH

Represents property for switch of the footwell lights.

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 (e.g. SEAT_FOOTWELL_LIGHTS_SWITCH=VehicleLightSwitch#STATE_AUTOMATIC and SEAT_FOOTWELL_LIGHTS_STATE=VehicleLightState#STATE_ON).

This property will 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 AreaIdConfig.getSupportedEnumValues() obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which enum values from VehicleLightSwitch are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_INTERIOR_LIGHTS

Constant Value: 356518812 (0x15400b9c)

SEAT_FORE_AFT_MOVE

public static final int SEAT_FORE_AFT_MOVE

Seat fore/aft move.

This property moves the entire seat forward/backward in the direction it's facing.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the seat is moving forward and negative values mean the seat is moving backward. Larger integers, either positive or negative, indicate a faster speed. Once the seat reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the seat while moving backward.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the seat while moving forward.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518790 (0x15400b86)

SEAT_FORE_AFT_POS

public static final int SEAT_FORE_AFT_POS

Seat fore/aft position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the seat is at its rearward-most linear position.

MinMaxSupportedValue.getMaxValue() indicates the seat is at its forward-most linear position.

All integers between the min and max values are supported and indicate a transition state between the forward most and rearward most positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518789 (0x15400b85)

SEAT_HEADREST_ANGLE_MOVE

public static final int SEAT_HEADREST_ANGLE_MOVE

Headrest angle move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the headrest is moving upright/forward and negative values mean the headrest is reclining. Larger integers, either positive or negative, indicate a faster speed. Once the headrest reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518808 (0x15400b98)

SEAT_HEADREST_ANGLE_POS

public static final int SEAT_HEADREST_ANGLE_POS

Headrest angle position.

This property is not in any particular unit but in a specified range of relative positions.

The AreaIdConfig.getMinValue() indicates the seat headrest's full recline position.

The AreaIdConfig.getMaxValue() indicates the seat headrest's most upright/forward position.

All integers between the min and max values are supported and indicate a transition state between the forward most and rearward most positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518807 (0x15400b97)

SEAT_HEADREST_FORE_AFT_MOVE

public static final int SEAT_HEADREST_FORE_AFT_MOVE

Headrest fore/aft move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the headrest is moving forward towards the front of the seat and negative values mean the headrest is moving backward away from the front of the seat. Larger integers, either positive or negative, indicate a faster speed. Once the headrest reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518810 (0x15400b9a)

SEAT_HEADREST_FORE_AFT_POS

public static final int SEAT_HEADREST_FORE_AFT_POS

Headrest fore/aft position.

This property is not in any particular unit but in a specified range of relative positions.

The AreaIdConfig.getMinValue() indicates the seat headrest's rearward-most linear position.

The AreaIdConfig.getMaxValue() indicates the seat headrest's forward-most linear position.

All integers between the min and max values are supported and indicate a transition state between the forward most and rearward most positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518809 (0x15400b99)

SEAT_HEADREST_HEIGHT_MOVE

public static final int SEAT_HEADREST_HEIGHT_MOVE

Headrest height move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the headrest is moving up and negative values mean the headrest is moving down. Larger integers, either positive or negative, indicate a faster speed. Once the headrest reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518806 (0x15400b96)

SEAT_HEADREST_HEIGHT_POS

public static final int SEAT_HEADREST_HEIGHT_POS

This constant is deprecated.
because it is defined as type VehicleAreaType.VEHICLE_AREA_TYPE_GLOBAL, which means all seats use the same value. Use SEAT_HEADREST_HEIGHT_POS_V2 instead which fixes this issue by being defined as type VehicleAreaType.VEHICLE_AREA_TYPE_SEAT.

Headrest height position.

Not exposed through CarPropertyManager.

This property is not supported.
Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 289409941 (0x11400b95)

SEAT_HEADREST_HEIGHT_POS_V2

public static final int SEAT_HEADREST_HEIGHT_POS_V2

Headrest height position.

This property is not in any particular unit but in a specified range of relative positions.

The AreaIdConfig.getMinValue() indicates the seat headrest's shortest position.

The AreaIdConfig.getMaxValue() indicates the seat headrest's tallest position.

All integers between the min and max values are supported and indicate a transition state between the shortest and tallest positions.

CarPropertyConfig.getAreaIds() specifies which seats are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518820 (0x15400ba4)

SEAT_HEIGHT_MOVE

public static final int SEAT_HEIGHT_MOVE

Seat height move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the seat is moving up and negative values mean the seat is moving down. Larger integers, either positive or negative, indicate a faster speed. Once the seat reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the seat while moving downward.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the seat while moving upward.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518796 (0x15400b8c)

SEAT_HEIGHT_POS

public static final int SEAT_HEIGHT_POS

Seat height position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() indicates the seat is in its lowest position.

MinMaxSupportedValue.getMaxValue() indicates the seat is in its highest position.

All integers between the min and max values are supported and indicate a transition state between the lowest and highest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518795 (0x15400b8b)

SEAT_LUMBAR_FORE_AFT_MOVE

public static final int SEAT_LUMBAR_FORE_AFT_MOVE

Lumbar fore/aft move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the lumbar support is moving forward towards the front of the seat and negative values mean the lumbar support is moving backward away from the front of the seat. Larger integers, either positive or negative, indicate a faster speed. Once the lumbar support reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518802 (0x15400b92)

SEAT_LUMBAR_FORE_AFT_POS

public static final int SEAT_LUMBAR_FORE_AFT_POS

Lumber fore/aft position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the seat lumbar support's rearward most position (i.e. least supportive position).

AreaIdConfig.getMaxValue() indicates the seat lumbar support's forward most position (i.e. most supportive position).

All integers between the min and max values are supported and indicate a transition state between the forward most and rearward most positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518801 (0x15400b91)

SEAT_LUMBAR_SIDE_SUPPORT_MOVE

public static final int SEAT_LUMBAR_SIDE_SUPPORT_MOVE

Lumbar side support move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the lumbar side support is getting wider (i.e. less support) and negative values mean the lumbar side support is getting thinner (i.e. more support). Larger integers, either positive or negative, indicate a faster speed. Once the lumbar side support reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518804 (0x15400b94)

SEAT_LUMBAR_SIDE_SUPPORT_POS

public static final int SEAT_LUMBAR_SIDE_SUPPORT_POS

Lumbar side support position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the seat lumbar side support's thinnest position (i.e most support).

AreaIdConfig.getMaxValue() indicates the seat lumbar side support's widest position (i.e least support).

All integers between the min and max values are supported and indicate a transition state between the thinnest and widest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518803 (0x15400b93)

SEAT_LUMBAR_VERTICAL_MOVE

public static final int SEAT_LUMBAR_VERTICAL_MOVE

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

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the lumbar support is moving up and negative values mean the lumbar support is moving down. Larger integers, either positive or negative, indicate a faster speed. Once the lumbar support reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518818 (0x15400ba2)

SEAT_LUMBAR_VERTICAL_POS

public static final int SEAT_LUMBAR_VERTICAL_POS

Represents property for seat\u2019s lumbar support vertical position.

This property is not in any particular unit but in a specified range of relative positions.

The AreaIdConfig.getMinValue() indicates the seat lumbar support's lowest position.

The AreaIdConfig.getMaxValue() indicates the seat lumbar support's highest position.

All integers between the min and max values are supported and indicate a transition state between the lowest and highest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518817 (0x15400ba1)

SEAT_MEMORY_SELECT

public static final int SEAT_MEMORY_SELECT

Seat memory select.

This parameter selects the memory preset to use to select the seat position.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is always 0.

MinMaxSupportedValue.getMaxValue() represents the max memory preset that can be chosen. For instance, if the driver's seat has 3 memory presets, the max value will be 2. When the user wants to select a preset, the desired preset number (0, 1, or 2) is set.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518784 (0x15400b80)

SEAT_MEMORY_SET

public static final int SEAT_MEMORY_SET

Seat memory set.

This setting allows the user to save the current seat position settings into the selected preset slot. The AreaIdConfig.getMaxValue() for each seat position must match the AreaIdConfig.getMaxValue() for SEAT_MEMORY_SELECT.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() is always 0.

MinMaxSupportedValue.getMaxValue() represents the max memory preset that can be chosen. For instance, if the driver's seat has 3 memory presets, the max value will be 2. When the user wants to select a preset, the desired preset number (0, 1, or 2) is set.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518785 (0x15400b81)

SEAT_OCCUPANCY

public static final int SEAT_OCCUPANCY

Seat Occupancy.

Property Config:

Required Permission:

Constant Value: 356518832 (0x15400bb0)

SEAT_TILT_MOVE

public static final int SEAT_TILT_MOVE

Seat tilt move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the seat cushion is tilting upward such that the seat cushion's front edge is higher than the rear end of the seat cushion. Negative values mean the seat cushion is tilting downward such that the seat cushion's front edge is lower than the rear end of the seat cushion. Larger integers, either positive or negative, indicate a faster speed. Once the seat cushion reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() represents the maximum movement speed of the front edge of the seat while moving downward.

MinMaxSupportedValue.getMaxValue() represents the maximum movement speed of the front edge of the seat while moving upward.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518800 (0x15400b90)

SEAT_TILT_POS

public static final int SEAT_TILT_POS

Seat tilt position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

MinMaxSupportedValue.getMinValue() 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.

MinMaxSupportedValue.getMaxValue() 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.

All integers between the min and max values are supported and indicate a transition state between the lowest and highest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518799 (0x15400b8f)

SEAT_WALK_IN_POS

public static final int SEAT_WALK_IN_POS

Represents property that indicates the current walk-in position of the seat.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the normal seat position.

AreaIdConfig.getMaxValue() indicates the seat's position in full walk-in mode.

All integers in between the min and max values are supported and indicate a transition state between the normal and walk-in positions. The area IDs match the seats that actually move when the walk-in feature activates.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518819 (0x15400ba3)

STEERING_WHEEL_DEPTH_MOVE

public static final int STEERING_WHEEL_DEPTH_MOVE

Steering wheel depth movement.

Returns the speed and direction, either towards or away from the driver, that the steering wheel is moving in. This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the steering wheel is moving away from the driver and negative values mean the steering wheel is moving towards the driver. Larger integers, either positive or negative, indicate a faster speed. Once the steering wheel reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 289410017 (0x11400be1)

STEERING_WHEEL_DEPTH_POS

public static final int STEERING_WHEEL_DEPTH_POS

Steering wheel depth position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the steering wheel's position when closest to the driver.

AreaIdConfig.getMaxValue() indicates the steering wheel's position when farthest from the driver.

All integers in between the min and max values are supported and indicate a transition state between the closest and farthest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 289410016 (0x11400be0)

STEERING_WHEEL_EASY_ACCESS_ENABLED

public static final int STEERING_WHEEL_EASY_ACCESS_ENABLED

Steering wheel easy access feature enabled.

Returns true if the steering wheel easy access feature is enabled and false if it is disabled. If enabled, the driver\u2019s steering wheel will automatically adjust to make it easier for the driver to enter and exit the vehicle.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 287312870 (0x11200be6)

STEERING_WHEEL_HEIGHT_MOVE

public static final int STEERING_WHEEL_HEIGHT_MOVE

Steering wheel height movement.

Returns the speed and direction, either upwards or downwards, that the steering wheel is moving in. This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean moving upwards and negative values mean moving downwards. Larger integers, either positive or negative, indicate a faster speed. Once the steering wheel reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 289410019 (0x11400be3)

STEERING_WHEEL_HEIGHT_POS

public static final int STEERING_WHEEL_HEIGHT_POS

Steering wheel height position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the steering wheel's lowest position.

AreaIdConfig.getMaxValue() indicates the steering wheel's highest position.

All integers in between the min and max values are supported and indicate a transition state between the lowest and highest positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 289410018 (0x11400be2)

STEERING_WHEEL_LIGHTS_STATE

public static final int STEERING_WHEEL_LIGHTS_STATE

Steering wheel lights state.

Returns 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 (e.g. STEERING_WHEEL_LIGHTS_SWITCH=VehicleLightSwitch#STATE_AUTOMATIC and STEERING_WHEEL_LIGHTS_STATE=VehicleLightState#STATE_ON).

This property will 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 AreaIdConfig.getSupportedEnumValues() obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which enum values from VehicleLightState are supported.

Property Config:

Required Permission:

Constant Value: 289410828 (0x11400f0c)

STEERING_WHEEL_LIGHTS_SWITCH

public static final int STEERING_WHEEL_LIGHTS_SWITCH

Steering wheel lights switch.

Returns the position of the switch controlling the steering wheel lights. This is different from STEERING_WHEEL_LIGHTS_STATE 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 (e.g. STEERING_WHEEL_LIGHTS_SWITCH= VehicleLightSwitch#STATE_AUTOMATIC and STEERING_WHEEL_LIGHTS_STATE=VehicleLightState#STATE_ON).

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

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which enum values from VehicleLightSwitch are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_INTERIOR_LIGHTS

Constant Value: 289410829 (0x11400f0d)

STEERING_WHEEL_LOCKED

public static final int STEERING_WHEEL_LOCKED

Steering wheel locked.

Returns true if the steering wheel is locked. If locked, the steering wheel\u2019s position is not changeable.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 287312869 (0x11200be5)

STEERING_WHEEL_THEFT_LOCK_ENABLED

public static final int STEERING_WHEEL_THEFT_LOCK_ENABLED

Steering wheel theft lock feature enabled.

Returns true if the steering wheel theft lock feature is enabled and false if it is disabled. If enabled, the steering wheel will lock automatically to prevent theft in certain situations.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_STEERING_WHEEL

Constant Value: 287312868 (0x11200be4)

TIRE_PRESSURE

public static final int TIRE_PRESSURE

Tire pressure in kilopascals.

Each areaId represents one tire. The CarPropertyConfig.getAreaIds() for TIRE_PRESSURE will be a list of VehicleAreaWheels.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areaIds.

For each areaId, the result for getMinMaxSupportedValue indicates the OEM recommended tire pressure range for that tire.

Property Config:

Required Permission:

Constant Value: 392168201 (0x17600309)

TIRE_PRESSURE_DISPLAY_UNITS

public static final int TIRE_PRESSURE_DISPLAY_UNITS

Tire pressure units for display.

Indicates which units the car is using to display tire pressure to the user.

configArray represents the list of supported units for TIRE_PRESSURE_DISPLAY_UNITS. Here is an example configArray:

Property Config:

Required Permissions:

Constant Value: 289408514 (0x11400602)

TRACTION_CONTROL_ACTIVE

public static final int TRACTION_CONTROL_ACTIVE

Traction Control is active.

Property Config:

Required Permission:


Requires Car.PERMISSION_CAR_DYNAMICS_STATE

Constant Value: 287310859 (0x1120040b)

TRAILER_PRESENT

public static final int TRAILER_PRESENT

Indicates if there is a trailer present or not.

Returns the trailer state of the car. See TrailerState for possible values for TRAILER_PRESENT.

Property Config:

Required Permission:

Constant Value: 289410885 (0x11400f45)

TURN_SIGNAL_LIGHT_STATE

public static final int TURN_SIGNAL_LIGHT_STATE

Turn signal light state.

This property communicates the actual state of the turn signal lights. It is independent from the actual turn signal switch state or the hazard lights button state.

Examples:

This is different from the function of TURN_SIGNAL_SWITCH, which must communicate the state of the turn signal lever/switch.

Note that this property uses ERROR(VehicleTurnSignal/android.car.hardware.property.VehicleTurnSignal VehicleTurnSignal) as a bit flag, unlike TURN_SIGNAL_SWITCH, which uses it like a regular enum. This means this property supports ORed together values in ERROR(VehicleTurnSignal/android.car.hardware.property.VehicleTurnSignal VehicleTurnSignal).

Property Config:

Required Permission:

Constant Value: 289408016 (0x11400410)

TURN_SIGNAL_STATE

public static final int TURN_SIGNAL_STATE

This constant is deprecated.
because it ambiguously defines the state of the vehicle turn signals without making clear if it means the state of the turn signal lights or the state of the turn signal switch. TURN_SIGNAL_LIGHT_STATE and TURN_SIGNAL_SWITCH rectify this problem.

See VehicleTurnSignal for possible values for TURN_SIGNAL_STATE.

Property Config:

Required Permission:

State of the vehicles turn signals
Requires Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289408008 (0x11400408)

TURN_SIGNAL_SWITCH

public static final int TURN_SIGNAL_SWITCH

Turn signal switch.

This property communicates the state of the turn signal lever/switch. This is different from the function of TURN_SIGNAL_LIGHT_STATE, which must communicate the actual state of the turn signal lights.

Note that this property uses ERROR(VehicleTurnSignal/android.car.hardware.property.VehicleTurnSignal VehicleTurnSignal) as a regular enum, unlike TURN_SIGNAL_LIGHT_STATE, which uses it like a bit flag. This means this property does not support ORed together values in ERROR(VehicleTurnSignal/android.car.hardware.property.VehicleTurnSignal VehicleTurnSignal).

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permission:

Constant Value: 289408017 (0x11400411)

ULTRASONICS_SENSOR_DETECTION_RANGE

public static final int ULTRASONICS_SENSOR_DETECTION_RANGE

Static data for the detection range of each ultrasonic sensor in millimeters.

Each individual sensor is identified by its ERROR(/AreaIdConfig#getAreaId()) and returns the sensor's detection range formatted as [minimum, maximum] where:

  • minimum is the minimum range detectable by the ultrasonic sensor in millimeters.
  • maximum is the maximum range detectable by the ultrasonic sensor in millimeters.

Property Config:

Required Permission:

Constant Value: 406916131 (0x18410c23)

ULTRASONICS_SENSOR_FIELD_OF_VIEW

public static final int ULTRASONICS_SENSOR_FIELD_OF_VIEW

Static data for the field of view of each ultrasonic sensor in degrees.

Each individual sensor is identified by its ERROR(/AreaIdConfig#getAreaId()) and returns the sensor's field of view formatted as [horizontal, vertical] where:

  • horizontal is the horizontal field of view for the specified ultrasonic sensor in degrees.
  • vertical is the vertical field of view for the associated specified ultrasonic sensor in degrees.

This assumes each sensor uses the same axes conventions as Android Automotive.

Property Config:

Required Permission:

Constant Value: 406916130 (0x18410c22)

ULTRASONICS_SENSOR_MEASURED_DISTANCE

public static final int ULTRASONICS_SENSOR_MEASURED_DISTANCE

The distance reading of the nearest detected object per sensor in millimeters.

Each individual sensor is identified by its ERROR(/AreaIdConfig#getAreaId()) and returns the sensor's measured distance formatted as [distance, distance_error] where:

  • distance is the measured distance of the nearest object in millimeters. If only a range is supported, this value must be set to the minimum supported distance in the detected range as specified in ULTRASONICS_SENSOR_SUPPORTED_RANGES.
  • distance_error is the error of the measured distance value in millimeters.

If no object is detected, an empty vector will be returned. If distance_error is not available then an array of only the measured distance will be returned.

Property Config:

Required Permission:

Constant Value: 406916133 (0x18410c25)

ULTRASONICS_SENSOR_ORIENTATION

public static final int ULTRASONICS_SENSOR_ORIENTATION

Static data for the orientation of each ultrasonic sensor installed on the vehicle.

Each individual sensor is identified by its ERROR(/AreaIdConfig#getAreaId()) and returns the sensor's orientation formatted as [qw, qx, qy, qz] where:

  • qw is the quaternion coefficient w within the quaterinion (w + xi + yj + zk) describing the rotation of the sensor relative to the Android Automotive sensor coordinate frame.
  • qx is the quaternion coefficient x within the quaterinion (w + xi + yj + zk) describing the rotation of the sensor relative to the Android Automotive sensor coordinate frame.
  • qy is the quaternion coefficient y within the quaterinion (w + xi + yj + zk) describing the rotation of the sensor relative to the Android Automotive sensor coordinate frame.
  • qz is the quaternion coefficient z within the quaterinion (w + xi + yj + zk) describing the rotation of the sensor relative to the Android Automotive sensor coordinate frame.

This assumes each sensor uses the same axes conventions as Android Automotive.

Property Config:

Required Permission:

Constant Value: 409013281 (0x18610c21)

ULTRASONICS_SENSOR_POSITION

public static final int ULTRASONICS_SENSOR_POSITION

Static data for the position of each ultrasonic sensor installed on the vehicle.

Each individual sensor is identified by its unique ERROR(/AreaIdConfig#getAreaId()) and returns the sensor's position formatated as [x, y, z] where:

  • x is the position of the sensor along the x-axis relative to the origin of the Android Automotive sensor coordinate frame in millimeters.
  • y is the position of the sensor along the y-axis relative to the origin of the Android Automotive sensor coordinate frame in millimeters.
  • z is the position of the sensor along the z-axis relative to the origin of the Android Automotive sensor coordinate frame in millimeters.

Property Config:

Required Permission:

Constant Value: 406916128 (0x18410c20)

ULTRASONICS_SENSOR_SUPPORTED_RANGES

public static final int ULTRASONICS_SENSOR_SUPPORTED_RANGES

Static data for the supported ranges of each ultrasonic sensor in millimeters.

For ultrasonic sensors that only support readings within a specific range. For example, if an ultrasonic sensor detects an object at 700mm, but can only report that an object has been detected between 500mm and 1000mm.

Each individual sensor is identified by its ERROR(/AreaIdConfig#getAreaId()) and returns the sensor's supported ranges formatted as [range_min_1, range_max_1, range_min_2, range_max_2, ...] where:

  • range_min_1 is the minimum of one supported range by the specified sensor in millimeters, inclusive.
  • range_max_1 is the maximum of one supported range by the specified sensor in millimeters, inclusive.
  • range_min_2 is the minimum of another supported range by the specified sensor in millimeters, inclusive.
  • range_max_2 is the maximum of another supported range by the specified sensor in millimeters, inclusive.

For example, if an ultrasonic sensor supports the ranges 150mm to 499mm, 500mm to 999mm, and 1000mm to 1500mm, then the property should be set to:

  • value[0] = 150
  • value[1] = 499
  • value[2] = 500
  • value[3] = 999
  • value[4] = 1000
  • value[5] = 1500

If this property is not defined, all the values within the ULTRASONICS_SENSOR_DETECTION_RANGE for the specified sensor are assumed to be supported.

Property Config:

Required Permission:

Constant Value: 406916132 (0x18410c24)

VALET_MODE_ENABLED

public static final int VALET_MODE_ENABLED

Valet mode enabled

This property allows the user to enable/disable valet mode in their vehicle. Valet mode is a privacy and security setting that prevents an untrusted driver to access more private areas in the vehicle, such as the glove box or the trunk(s).

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 287312389 (0x11200a05)

VEHICLE_CURB_WEIGHT

public static final int VEHICLE_CURB_WEIGHT

Vehicle\u2019s curb weight in kilograms.

Returns the vehicle's curb weight in kilograms. This is the total weight of a vehicle, inclusive of standard equipment and necessary operating fluids such as motor oil, transmission oil and brake fluid, but without passengers or cargo. configArray[0] specifies the vehicle\u2019s gross weight in kilograms. This is the vehicle curb weight plus the maximum payload (passengers + cargo) the vehicle can support.

Property Config:

Required Permission:

Constant Value: 289410886 (0x11400f46)

VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL

public static final int VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL

Current state of vehicle autonomy.

Defines the level of autonomy currently engaged in the vehicle from the J3016_202104 revision of the SAE standard levels 0-5, with 0 representing no autonomy and 5 representing full driving automation.

For the global area ID (0), the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.VehicleAutonomousState) are supported.

Property Config:

Required Permission:

Constant Value: 289410892 (0x11400f4c)

VEHICLE_DRIVING_AUTOMATION_TARGET_LEVEL

public static final int VEHICLE_DRIVING_AUTOMATION_TARGET_LEVEL

Target state of vehicle autonomy.

Defines the level of autonomy being targeted by the vehicle from the J3016_202104 revision of the SAE standard levels 0-5, with 0 representing no autonomy and 5 representing full driving automation.

For example, suppose the vehicle is currently in a Level 3 state of automation and wants to give the driver full manual control (i.e. Level 0) as soon as it's safe to do so. In this scenario, this property will be set to ERROR(/android.car.hardware.property.VehicleAutonomousState#LEVEL_0). Similarly, if the vehicle is currently in Level 1 state of automation and wants to go up to Level 2, this property will be set to ERROR(/android.car.hardware.property.VehicleAutonomousState#LEVEL_2). If the vehicle has already reached and is currently in the target level of autonomy, this property will be equal to the value of VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL.

For the global area ID (0), the CarPropertyManager.getSupportedValuesList(int, int) array specifies which states from ERROR(/android.car.hardware.property.VehicleAutonomousState) are supported. This will always match the value specified by CarPropertyManager.getSupportedValuesList(int, int) for VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL.

For the property that communicates the current state of autonomy, see VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CAR_DRIVING_STATE" to read property.
  • Property is not writable.

Constant Value: 289410895 (0x11400f4f)

VEHICLE_HORN_ENGAGED

public static final int VEHICLE_HORN_ENGAGED

Vehicle horn engaged.

This property communicates if the vehicle's horn is currently engaged or not. If true, the horn is engaged. If false, the horn is disengaged.

Property Config:

Required Permissions:

Constant Value: 287310656 (0x11200340)

VEHICLE_MAP_SERVICE

public static final int VEHICLE_MAP_SERVICE

This constant is deprecated.
use ERROR(/android.car.vms.VmsClientManager) instead.

Vehicle Maps Service (VMS) message.

Not exposed through CarPropertyManager.

This property is not supported.
Requires android.car.Car.PERMISSION_VMS_PUBLISHER or android.car.Car.PERMISSION_VMS_SUBSCRIBER

Constant Value: 299895808 (0x11e00c00)

VEHICLE_PASSIVE_SUSPENSION_HEIGHT

public static final int VEHICLE_PASSIVE_SUSPENSION_HEIGHT

Vehicle Passive Suspension Height in mm.

This property communicates the real-time suspension displacement of the vehicle relative to its neutral position, given in mm. In other words, the displacement of the suspension at any given point in time relative to the suspension's position when the vehicle is on a flat surface with no passengers or cargo. When the suspension is compressed in comparison to the neutral position, the value should be negative. When the suspension is decompressed in comparison to the neutral position, the value should be positive.

Examples for further clarity:

  • 1) Suppose the user is driving on a smooth flat surface, and all wheels are currently compressed by 2 cm in comparison to the default suspension height. In this scenario, this property will be set to -20 for all wheels.
  • 2) Suppose the user drives over a pothole. While the front left wheel is over the pothole, it's decompressed by 3 cm in comparison to the rest of the wheels, or 1 cm in comparison to the default suspension height. All the others are still compressed by 2 cm. In this scenario, this property will be set to -20 for all wheels except for the front left, which will be set to 10.

AreaIdConfig.hasMinSupportedValue() and AreaIdConfig.hasMaxSupportedValue() will be true for all areas.

MinMaxSupportedValue.getMinValue() represents the lower bound of the suspension height for the wheel at the specified area ID.

MinMaxSupportedValue.getMaxValue() represents the upper bound of the suspension height for the wheel at the specified area ID.

Property Config:

Required Permissions:

Constant Value: 390071059 (0x17400313)

VEHICLE_SPEED_DISPLAY_UNITS

public static final int VEHICLE_SPEED_DISPLAY_UNITS

Speed units for display.

Indicates type of units the vehicle is using to display speed to user.

configArray represents the list of supported units for VEHICLE_SPEED_DISPLAY_UNITS. Here is an example configArray:

Property Config:

Required Permissions:

Constant Value: 289408516 (0x11400604)

WHEEL_TICK

public static final int WHEEL_TICK

Reports wheel ticks.

The first element in the array 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: front left, front right, rear right, rear left. All tick counts are cumulative. Tick counts increment when the vehicle moves forward, and decrement when vehicles moves in reverse. The ticks should be reset to 0 when the vehicle is started by the user.

  • Long[0] = reset count
  • Long[1] = front left ticks
  • Long[2] = front right ticks
  • Long[3] = rear right ticks
  • Long[4] = rear left ticks

configArray is used to indicate the micrometers-per-wheel-tick values and which wheels are supported. Each micrometers-per-wheel-tick value is static (i.e. will not update based on wheel's status) and a best approximation. For example, if a vehicle has multiple rim/tire size options, the micrometers-per-wheel-tick values are set to those for the typically expected rim/tire size. configArray is set as follows:

NOTE: If a wheel is not supported, its value is always 0.

Property Config:

Required Permission:


Requires Car.PERMISSION_SPEED

Constant Value: 290521862 (0x11510306)

WINDOW_LOCK

public static final int WINDOW_LOCK

Window Child Lock.

True indicates that the window is child-locked.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_WINDOWS

Constant Value: 320867268 (0x13200bc4)

WINDOW_MOVE

public static final int WINDOW_MOVE

Window Move.

This property is not in any particular unit but in a specified range of relative movement speeds.

Positive values mean the window is either closing from its out of plane position (if such a position is supported by the window), or is opening in plane. Negative values mean the window is closing in plane, or opening in its out of plane position (if the position is supported). Larger integers, either positive or negative, indicate a faster speed. Once the window reaches the positional limit, the value resets to 0. When this property's value is 0, that means there is no movement currently occurring.

See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible speeds. All integers between min and max value are supported.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_WINDOWS

Constant Value: 322964417 (0x13400bc1)

WINDOW_POS

public static final int WINDOW_POS

Window Position.

This property is not in any particular unit but in a specified range of relative positions.

AreaIdConfig.getMinValue() indicates the window's position when closed/fully open out of plane. If the window cannot open out of plane, then AreaIdConfig.getMinValue() is the position of the window when fully closed and must be 0. If the window can open out of plane, AreaIdConfig.getMinValue() indicates the window is fully open in its position out of plane and will be a negative value.

AreaIdConfig.getMaxValue() indicates the window's position when fully open.

All integers in between the min and max values are supported and indicate a transition state between the closed and fully open positions.

Property Config:

Required Permission:


Requires Car.PERMISSION_CONTROL_CAR_WINDOWS

Constant Value: 322964416 (0x13400bc0)

WINDSHIELD_WIPERS_PERIOD

public static final int WINDSHIELD_WIPERS_PERIOD

Windshield wipers period (milliseconds).

Returns the instantaneous time period for 1 full cycle of the windshield wipers in ERROR(/android.car.VehicleUnit#MILLI_SECS). A full cycle is defined as a wiper moving from and returning to its rest position. The AreaIdConfig.getMaxValue() specifies the longest wiper period. The AreaIdConfig.getMinValue() is always 0. When an intermittent wiper setting is selected, this property value will be set to 0 during the "pause" phase of the intermittent wiping.

Property Config:

Required Permission:

Constant Value: 322964421 (0x13400bc5)

WINDSHIELD_WIPERS_STATE

public static final int 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. (e.g. #WINDSHIELD_WIPERS_STATE = ERROR(/android.car.hardware.property.WindshieldWipersState#ON) and WINDSHIELD_WIPERS_SWITCH = ERROR(/android.car.hardware.property.WindshieldWipersSwitch#AUTO)).

If #WINDSHIELD_WIPERS_STATE = ERROR(/android.car.hardware.property.WindshieldWipersState#ON) and WINDSHIELD_WIPERS_PERIOD is implemented, then WINDSHIELD_WIPERS_PERIOD will reflect the time period of 1 full cycle of the wipers.

For each supported area ID, the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which states from ERROR(/android.car.hardware.property.WindshieldWipersState) are supported.

Property Config:

Required Permission:

Constant Value: 322964422 (0x13400bc6)

WINDSHIELD_WIPERS_SWITCH

public static final int 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 (e.g. WINDSHIELD_WIPERS_SWITCH = ERROR(/android.car.hardware.property.WindshieldWipersSwitch#AUTO) and WINDSHIELD_WIPERS_STATE = WindshieldWipersState#ON).

For each supported area ID, the AreaIdConfig.getSupportedEnumValues() array obtained from CarPropertyConfig.getAreaIdConfig(int) specifies which values from ERROR(/android.car.hardware.property.WindshieldWipersSwitch) are supported.

This property is defined as read_write, but OEMs have the option to implement it as read only.

Property Config:

Required Permissions:

Constant Value: 322964423 (0x13400bc7)

Public constructors

VehiclePropertyIds

public VehiclePropertyIds ()

This constructor is deprecated.
to prevent others from instantiating this class

Public methods

toString

public static String toString (int propertyId)

Gets a user-friendly representation of a property.

Parameters
propertyId int

Returns
String