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

Cabin lights.

int CABIN_LIGHTS_SWITCH

Cabin lights switch.

int CRITICALLY_LOW_TIRE_PRESSURE

Critically low tire pressure.

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_LOCK

Door lock.

int DOOR_MOVE

Door move.

int DOOR_POS

Door position.

int ELECTRONIC_TOLL_COLLECTION_CARD_STATUS

Electronic Toll Collection card status.

int ELECTRONIC_TOLL_COLLECTION_CARD_TYPE

Electronic Toll Collection card type.

int ENGINE_COOLANT_TEMP

Temperature of engine coolant in celsius.

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

EV charge current draw limit.

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

Hazard light status.

int HAZARD_LIGHTS_SWITCH

Hazard light switch.

int HEADLIGHTS_STATE

Headlights State.

int HEADLIGHTS_SWITCH

Headlight switch.

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_FAN_DIRECTION

Fan direction setting.

int HVAC_FAN_DIRECTION_AVAILABLE

Fan Positions Available.

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 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_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_VIN

VIN of vehicle

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CAR_IDENTIFICATION" to read property.

int INVALID

Undefined property.

int LOCATION_CHARACTERIZATION

Characterization of inputs used for computing location.

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_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_DEPTH_MOVE

Seat depth move.

int SEAT_DEPTH_POS

Seat depth position.

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_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 STEERING_WHEEL_LIGHTS_STATE

Steering wheel lights state.

int STEERING_WHEEL_LIGHTS_SWITCH

Steering wheel lights switch.

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_STATE

State of the vehicles turn signals

See VehicleTurnSignal for possible values for TURN_SIGNAL_STATE.

int VEHICLE_CURB_WEIGHT

Vehicle\u2019s curb weight in kilograms.

int VEHICLE_MAP_SERVICE

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

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.

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:

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

Requires android.car.Car.PERMISSION_CAR_DYNAMICS_STATE

Constant Value: 287310858 (0x1120040a)

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)

CABIN_LIGHTS_STATE

public static final int CABIN_LIGHTS_STATE

Cabin lights.

Property Config:

Required Permission:

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

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_INTERIOR_LIGHTS" to read and write property.

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:

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

Requires android.car.Car.PERMISSION_TIRES

Constant Value: 392168202 (0x1760030a)

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_LOCK

public static final int DOOR_LOCK

Door lock.

True indicates that the door is locked.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_DOORS" to read and write property.

Requires android.car.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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_DOORS" to read and write property.

Requires android.car.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.getMinValue() indicates the door's position when closed. This value will be 0

AreaIdConfig.getMaxValue() indicates the door'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.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_DOORS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_DOORS

Constant Value: 373295872 (0x16400b00)

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)

ENGINE_COOLANT_TEMP

public static final int ENGINE_COOLANT_TEMP

Temperature of engine coolant in celsius.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_CAR_ENGINE_DETAILED

Constant Value: 291504897 (0x11600301)

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:

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

Constant Value: 289407747 (0x11400303)

ENGINE_OIL_TEMP

public static final int ENGINE_OIL_TEMP

Temperature of engine oil in celsius.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_CAR_ENGINE_DETAILED

Constant Value: 291504900 (0x11600304)

ENGINE_RPM

public static final int ENGINE_RPM

Engine rpm.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_CAR_ENGINE_DETAILED

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:

  • Property is not readable.
  • Signature|Privileged permission "android.car.permission.CAR_EPOCH_TIME" to write property.

Requires android.car.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. See AreaIdConfig.getMaxValue() and AreaIdConfig.getMinValue() for the range of possible values.

Property Config:

Required Permissions:

  • Normal permission Car#PERMISSION_POWERTRAIN or Signature|Privileged permission "android.car.permission.CONTROL_CAR_POWERTRAIN" to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_POWERTRAIN" to write property.

Constant Value: 289408012 (0x1140040c)

EV_CHARGE_CURRENT_DRAW_LIMIT

public static final int EV_CHARGE_CURRENT_DRAW_LIMIT

EV charge current draw limit.

Indicates the maximum current draw threshold for charging set by the user. configArray[0] contains the max current draw allowed by the vehicle in Amperes.

Property Config:

Required Permissions:

  • Dangerous permission Car#PERMISSION_ENERGY or Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY" to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY" to write property.

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:

  • Dangerous permission Car#PERMISSION_ENERGY or Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY" to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY" to write property.

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:

  • Normal permission Car#PERMISSION_ENERGY_PORTS or Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY_PORTS"to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY_PORTS" to write property.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY" or dangerous permission Car#PERMISSION_ENERGY to read.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY" to write property.

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:

  • Normal permission Car#PERMISSION_POWERTRAIN or Signature|Privileged permission "android.car.permission.CONTROL_CAR_POWERTRAIN" to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_POWERTRAIN" to write property.

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:

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

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_EXTERIOR_LIGHTS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410578 (0x11400e12)

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:

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

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_EXTERIOR_LIGHTS" to read and write property.

Requires android.car.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:

  • Normal permission Car#PERMISSION_ENERGY_PORTS or Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY_PORTS"to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_ENERGY_PORTS" to write property.

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)

HAZARD_LIGHTS_STATE

public static final int HAZARD_LIGHTS_STATE

Hazard light status.

Property Config:

Required Permission:

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

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_EXTERIOR_LIGHTS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410579 (0x11400e13)

HEADLIGHTS_STATE

public static final int HEADLIGHTS_STATE

Headlights State.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289410560 (0x11400e00)

HEADLIGHTS_SWITCH

public static final int HEADLIGHTS_SWITCH

Headlight switch.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_EXTERIOR_LIGHTS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410576 (0x11400e10)

HIGH_BEAM_LIGHTS_STATE

public static final int HIGH_BEAM_LIGHTS_STATE

High beam lights state.

Property Config:

Required Permission:

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

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_EXTERIOR_LIGHTS" to read and write property.

Requires android.car.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:

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

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419977 (0x15200509)

HVAC_FAN_DIRECTION

public static final int HVAC_FAN_DIRECTION

Fan direction setting.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517121 (0x15400501)

HVAC_FAN_DIRECTION_AVAILABLE

public static final int HVAC_FAN_DIRECTION_AVAILABLE

Fan Positions Available.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356582673 (0x15410511)

HVAC_FAN_SPEED

public static final int HVAC_FAN_SPEED

Fan speed setting.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 354419976 (0x15200508)

HVAC_SEAT_TEMPERATURE

public static final int HVAC_SEAT_TEMPERATURE

Seat heating/cooling.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517131 (0x1540050b)

HVAC_SEAT_VENTILATION

public static final int HVAC_SEAT_VENTILATION

Seat ventilation.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_CLIMATE

Constant Value: 356517139 (0x15400513)

HVAC_SIDE_MIRROR_HEAT

public static final int HVAC_SIDE_MIRROR_HEAT

Side Mirror Heat.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

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

Requires android.car.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:

  • Normal permission Car#PERMISSION_READ_DISPLAY_UNITS or Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read property.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to write property.

Constant Value: 289408270 (0x1140050e)

HVAC_TEMPERATURE_SET

public static final int HVAC_TEMPERATURE_SET

HVAC target temperature set in Celsius.

AreaIdConfig.getMinValue() indicates the minimum temperature setting in Celsius.

AreaIdConfig.getMaxValue() indicates the maximum temperature setting 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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_CLIMATE" to read and write property.

Requires android.car.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)

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_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_VIN

public static final int INFO_VIN

VIN of vehicle

Property Config:

Required Permission:

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

Requires Car.PERMISSION_IDENTIFICATION

Constant Value: 286261504 (0x11100100)

INVALID

public static final int INVALID

Undefined property.

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

Constant Value: 0 (0x00000000)

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)

MIRROR_FOLD

public static final int MIRROR_FOLD

Mirror Fold.

Property Config:

Required Permission:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_MIRRORS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_MIRRORS" to read and write property.

Requires android.car.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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_MIRRORS" to read and write property.

Requires android.car.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.getMinValue() indicates the mirror's position when tilted completely to the left.

AreaIdConfig.getMaxValue() indicates the mirror's position when tilted completely to the right.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_MIRRORS" to read and write property.

Requires android.car.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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_MIRRORS" to read and write property.

Requires android.car.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.getMinValue() indicates the mirror's position when tilted completely downwards.

AreaIdConfig.getMaxValue() indicates the mirror's position when tilted completely upwards.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_MIRRORS" to read and write property.

Requires android.car.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:

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

Requires android.car.Car.PERMISSION_MILEAGE

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:

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

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:

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

Requires Car.PERMISSION_READ_STEERING_STATE

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:

  • Dangerous permission Car#PERMISSION_ENERGY or Signature|Privileged permission "android.car.permission.ADJUST_RANGE_REMAINING" to read property.
  • Signature|Privileged permission "android.car.permission.ADJUST_RANGE_REMAINING" to write property.

Constant Value: 291504904 (0x11600308)

READING_LIGHTS_STATE

public static final int READING_LIGHTS_STATE

Reading lights.

Property Config:

Required Permission:

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

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_INTERIOR_LIGHTS" to read and write property.

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:

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

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_EXTERIOR_LIGHTS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_EXTERIOR_LIGHTS

Constant Value: 289410878 (0x11400f3e)

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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.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).

AreaIdConfig.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.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).

AreaIdConfig.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.getMinValue() indicates the seat belt shoulder anchor's lowest position.

AreaIdConfig.getMaxValue() indicates the seat belt shoulder anchor'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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518787 (0x15400b83)

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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.getMinValue() indicates the seat's shallowest position. This corresponds to the smallest distance between the front edge of the seat and the seat backrest.

AreaIdConfig.getMaxValue() indicates the seat's deepest position. This corresponds to the largest distance between the front edge of the seat and the seat backrest.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518797 (0x15400b8d)

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:

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

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_INTERIOR_LIGHTS" to read and write property.

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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.getMinValue() indicates the seat's rearward-most linear position.

AreaIdConfig.getMaxValue() indicates the seat'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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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 android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.getMinValue() indicates the seat's lowest position.

AreaIdConfig.getMaxValue() indicates the seat'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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518803 (0x15400b93)

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. The AreaIdConfig.getMinValue() is always 0, and the AreaIdConfig.getMaxValue() determines the number of seat positions available (i.e. numSeatPresets - 1).

Property Config:

Required Permission:

  • Property is not readable.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to write property.

Requires android.car.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.

Property Config:

Required Permission:

  • Property is not readable.
  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518785 (0x15400b81)

SEAT_OCCUPANCY

public static final int SEAT_OCCUPANCY

Seat Occupancy.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_CONTROL_CAR_SEATS

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.

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.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.getMinValue() indicates the seat bottom's lowest angular position. This corresponds to the seat's front edge at its lowest possible position relative to the rear end of the seat.

AreaIdConfig.getMaxValue() indicates the seat bottom's 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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_SEATS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_SEATS

Constant Value: 356518799 (0x15400b8f)

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:

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

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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_INTERIOR_LIGHTS" to read and write property.

Requires Car.PERMISSION_CONTROL_INTERIOR_LIGHTS

Constant Value: 289410829 (0x11400f0d)

TIRE_PRESSURE

public static final int TIRE_PRESSURE

Tire pressure in kilopascals.

For each area ID listed in CarPropertyConfig.getAreaIds(), the corresponding AreaIdConfig.getMinValue() and AreaIdConfig.getMaxValue() indicates the OEM recommended tire pressure range for that tire.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_TIRES

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:

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

Requires android.car.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:

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

Constant Value: 289410885 (0x11400f45)

TURN_SIGNAL_STATE

public static final int TURN_SIGNAL_STATE

State of the vehicles turn signals

See VehicleTurnSignal for possible values for TURN_SIGNAL_STATE.

Property Config:

Required Permission:

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

Requires android.car.Car.PERMISSION_EXTERIOR_LIGHTS

Constant Value: 289408008 (0x11400408)

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:

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

Constant Value: 289410886 (0x11400f46)

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_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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_WINDOWS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_WINDOWS" to read and write property.

Requires android.car.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:

  • Signature|Privileged permission "android.car.permission.CONTROL_CAR_WINDOWS" to read and write property.

Requires android.car.Car.PERMISSION_CONTROL_CAR_WINDOWS

Constant Value: 322964416 (0x13400bc0)

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