Property IDs are used with the {@link android.car.hardware.property.CarPropertyManager} APIs * (e.g. {@link android.car.hardware.property.CarPropertyManager#getProperty(int, int)} or {@link * android.car.hardware.property.CarPropertyManager#setProperty(Class, int, int, Object)}). */ public final class VehiclePropertyIds { /** * Undefined property. * *
This property should never be used/will never be supported. */ public static final int INVALID = 0; /** * VIN of vehicle * *
Property Config: *
Required Permission: *
This property communicates the vehicle's public brand name. * *
Property Config: *
Required Permission: *
This property communicates the vehicle's public model name. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
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 {@link #INFO_FUEL_TYPE} only contains {@link FuelType#ELECTRIC}, this property will not be * implemented. For EVs, see {@link #INFO_EV_BATTERY_CAPACITY}. * *
Property Config: *
Required Permission: *
{@link FuelType#ELECTRIC} will only be included if the vehicle is plug in rechargeable. * Note that for this reason, even though {@link FuelType#ELECTRIC} is not listed as a fuel * type, other EV properties such as {@link #INFO_EV_BATTERY_CAPACITY} can still be supported on * the vehicle. * *
For example: *
Property Config: *
Required Permission: *
Returns the nominal battery capacity in {@link android.car.VehicleUnit#WATT_HOUR}, if EV * or hybrid. This is the usable battery capacity when the vehicle is new. This value might be * different from {@link #EV_CURRENT_BATTERY_CAPACITY} because {@link * #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: *
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: *
This property communicates the location of the fuel door on the vehicle. This property * will not be implemented for electric vehicles. That is, if {@link #INFO_FUEL_TYPE} only * contains {@link FuelType#ELECTRIC}, this property will not be implemented. For EVs, see * {@link #INFO_EV_PORT_LOCATION} or {@link #INFO_MULTI_EV_PORT_LOCATIONS}. * *
Property Config: *
Required Permission: *
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 {@link #INFO_MULTI_EV_PORT_LOCATIONS} to get information on all * port locations. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
The only area ID listed in {@link android.car.hardware.CarPropertyConfig#getAreaIds} for * {@code INFO_DRIVER_SEAT} will be {@code 0}. * *
Property Config: *
Required Permission: *
Exterior dimensions defined in the {@link CarPropertyValue#getValue()} {@code Integer[]}: *
Property Config: *
Required Permission: *
This property communicates the vehicle's public trim name. * *
For example, say an OEM manufactures two different versions of a vehicle model: *
This property will be empty for the first vehicle (i.e. base model), and set to "Sport" * for the second vehicle. * *
Property Config: *
Required Permission: *
This property communicates the list of size classifications that the vehicle follows * according to the multiple standards that are defined in {@link * android.car.hardware.property.VehicleSizeClass} * *
For example, suppose a vehicle model follows the {@link * android.car.hardware.property.VehicleSizeClass#EU_A_SEGMENT} standard in the EU and the * {@link android.car.hardware.property.VehicleSizeClass#JPN_KEI} standard in Japan. In this * scenario this property must return an intArray = [{@link * android.car.hardware.property.VehicleSizeClass#EU_A_SEGMENT}, {@link * android.car.hardware.property.VehicleSizeClass#JPN_KEI}]. If this vehicle only follows * the EU {@link android.car.hardware.property.VehicleSizeClass#EU_A_SEGMENT} standard, then we * expect intArray = [{@link android.car.hardware.property.VehicleSizeClass#EU_A_SEGMENT}]. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
When the vehicle is moving forward, {@code PERF_VEHICLE_SPEED} is positive and negative * when the vehicle is moving backward. Also, this value is independent of gear value ({@link * #CURRENT_GEAR} or {@link #GEAR_SELECTION}). For example, if {@link #GEAR_SELECTION} is * {@link VehicleGear#GEAR_NEUTRAL}, {@code PERF_VEHICLE_SPEED} is positive when the vehicle is * moving forward, negative when moving backward, and zero when not moving. * *
Property Config: *
Required Permission: *
Some cars display a slightly slower speed than the actual speed. This is * usually displayed on the speedometer. * *
Property Config: *
Required Permission: *
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: *
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: *
This property communicates the instantaneous fuel economy of the vehicle in units of * L/100km. Clients can reference the value of {@link #DISTANCE_DISPLAY_UNITS}, {@link * #FUEL_VOLUME_DISPLAY_UNITS}, and {@link #FUEL_CONSUMPTION_UNITS_DISTANCE_OVER_VOLUME} before * displaying this property to the user to match the display units used by rest of the system. * *
For the EV version of this property, see {@link #INSTANTANEOUS_EV_EFFICIENCY}. * *
Property Config: *
Required Permission: *
This property communicates the instantaneous EV battery efficiency of the vehicle in units * of km/kWh. Clients can reference the value of {@link #DISTANCE_DISPLAY_UNITS} and {@link * #EV_BATTERY_DISPLAY_UNITS} before displaying this property to the user to match the display * units used by rest of the system. * *
For the fuel version of this property, see {@link * #INSTANTANEOUS_FUEL_ECONOMY}. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Returns the status of the oil level for the vehicle. It will be one of * {@link android.car.VehicleOilLevel}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
If true, the vehicle may automatically shut off the engine when it is not needed and then * automatically restart it when needed. * *
Property Config: *
Required Permission: *
Bit flag property to relay information on whether an impact has occurred on a particular * side of the vehicle as described through the {@link * android.car.hardware.property.ImpactSensorLocation} enum. As a bit flag property, this * property can be set to multiple ORed together values of the enum when necessary, e.g. * {@code ImpactSensorLocation.FRONT_LEFT_DOOR_SIDE | ImpactSensorLocation.REAR_LEFT_DOOR_SIDE} * indicates an impact is detected at both front left and rear left door side. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values. * *
Property Config: *
Required Permission: *
This property communicates if the vehicle's horn is currently engaged or not. If true, the * horn is engaged. If false, the horn is disengaged. * *
Property Config: *
Required Permissions: *
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. Conversely, tick measurements must be comparable if their corresponding reset * count is the same. This value is a monotonically increasing value where each time a reset * happens, the value increases by 1. * *
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. * *
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: *
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 {@link * #INFO_FUEL_TYPE} only contains {@link FuelType#ELECTRIC}, this property will not be * implemented. For EVs, see {@link #EV_BATTERY_LEVEL}. * *
This property's value will not exceed {@link #INFO_FUEL_CAPACITY}. * *
Property Config: *
Required Permission: *
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 {@link #INFO_FUEL_TYPE} * only contains {@link FuelType#ELECTRIC}, this property will not be implemented. For EVs, see * {@link #EV_CHARGE_PORT_OPEN}. * *
Property Config: *
Required Permissions: *
Returns the current battery level in {@link android.car.VehicleUnit#WATT_HOUR}, if EV or * hybrid. This value will not exceed {@link #EV_CURRENT_BATTERY_CAPACITY}. To calculate the * battery percentage, use: * ({@link #EV_BATTERY_LEVEL}/{@link #EV_CURRENT_BATTERY_CAPACITY})*100. * *
Property Config: *
Required Permission: *
Returns the actual value of battery capacity in {@link android.car.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 {@link #INFO_EV_BATTERY_CAPACITY} because {@link #INFO_EV_BATTERY_CAPACITY} * returns the nominal battery capacity from when the vehicle was new. * *
Property Config: *
Required Permission: *
If the vehicle has multiple charging ports, this property will return true if any of the * charge ports are open. * *
Property Config: *
Required Permissions: *
If the vehicle has multiple charging ports, this property will return true if any of the * charge ports are connected. * *
Property Config: *
Required Permission: *
Positive rate indicates battery is being charged, and Negative rate indicates battery * being discharged. * *
Property Config: *
Required Permission: *
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: *
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: *
Each areaId represents one tire. The * {@link android.car.hardware.CarPropertyConfig#getAreaIds} for {@code TIRE_PRESSURE} will be a * list of {@link VehicleAreaWheel}s. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
For each areaId, the result for {@code getMinMaxSupportedValue} indicates the OEM * recommended tire pressure range for that tire. * *
Property Config: *
Required Permission: *
For each area ID listed in {@link android.car.hardware.CarPropertyConfig#getAreaIds}, the * corresponding {@code CRITICALLY_LOW_TIRE_PRESSURE} will be less than or equal the {@link * android.car.hardware.property.AreaIdConfig#getMinValue()} of {@link #TIRE_PRESSURE} for the * same area ID. * *
Property Config: *
Required Permission: *
This property communicates the percentage that the physical accelerator * pedal in the vehicle is compressed. This property returns a float value from * 0 to 100. * *
0 indicates the pedal's uncompressed position. *
100 indicates the pedal's maximally compressed position. * *
Property Config: *
Required Permissions: *
This property communicates the percentage that the physical brake pedal * in the vehicle is compressed. This property returns a float value from 0 to * 100. * *
0 indicates the pedal's uncompressed position. *
100 indicates the pedal's maximally compressed position. * *
Property Config: *
Required Permissions: *
This property communicates the amount of brake pad wear accumulated by * the vehicle as a percentage. This property returns a float value from 0 * to 100. * *
0 indicates the brake pad has no wear. *
100 indicates the brake pad is maximally worn. * *
Property Config: *
Required Permissions: *
This property communicates that the brake fluid level in the vehicle is low according to * the OEM. This value will match the vehicle's brake fluid level status as displayed on the * instrument cluster. If the brake fluid level is low, this property will be set to {@code * true}. If not, it will be set to {@code false}. * *
Property Config: *
Required Permissions: *
This property communicates the real-time suspension displacement of the vehicle relative * to its neutral position, given in mm. In other words, the displacement of the suspension at * any given point in time relative to the suspension's position when the vehicle is on a flat * surface with no passengers or cargo. When the suspension is compressed in comparison to the * neutral position, the value should be negative. When the suspension is decompressed in * comparison to the neutral position, the value should be positive. * *
Examples for further clarity: *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areas. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * lower bound of the suspension height for the wheel at the specified area ID. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * upper bound of the suspension height for the wheel at the specified area ID. * *
Property Config: *
Required Permissions: *
See {@link VehicleGear} for gear value enum. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values. * *
For example, supported values for an EV vehicle is set as follows: * *
Example automatic transmission supported values: * *
Example manual transmission supported values: * *
Property Config: *
Required Permission: *
{@code CURRENT_GEAR}'s value may not match that of {@link * VehiclePropertyIds#GEAR_SELECTION}. For example, if the {@link * VehiclePropertyIds#GEAR_SELECTION} is {@link VehicleGear#GEAR_DRIVE} in a vehicle with an * automatic transmission, the {@code CURRENT_GEAR} will be one of {@link * VehicleGear#GEAR_FIRST}, {@link VehicleGear#GEAR_SECOND}, etc, which reflects the actual gear * the transmission is currently running in. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values. * *
For example, the supported values for an EV vehicle is set as follows: * *
Example automatic transmission supported values: * *
Example manual transmission supported values: * *
Property Config: *
Required Permission: *
{@code 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: *
{@code 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 {@link #PARKING_BRAKE_ON}. The difference is that * {@link #PARKING_BRAKE_ON} describes whether the actual parking brake is currently on/off, * whereas {@code 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: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * the global areaId. * *
the result for {@code getMinMaxSupportedValue} indicates the range of possible values. * *
Property Config: *
Required Permissions: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code EvStoppingMode} are supported. * *
Property Config: *
Required Permissions: *
{@code FUEL_LEVEL_LOW} corresponds to the low fuel warning on the dashboard. Once {@code * 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: *
Property Config: *
Required Permission: *
True indicates that the night mode sensor has detected that the car cabin environment has * low light. * *
Property Config: *
Required Permission: *
See {@code VehicleTurnSignal} for possible values for {@code TURN_SIGNAL_STATE}. * *
Property Config: *
Required Permission: *
Will be one of {@link android.car.VehicleIgnitionState}s. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Returns true if ESC is enabled and false if ESC is disabled. When ESC is enabled, a system * in the vehicle should be controlling the tires during instances with high risk of skidding to * actively prevent the same from happening. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of ESC. This property will always return a valid state defined * in {@link android.car.hardware.property.ElectronicStabilityControlState} or {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values. * *
Property Config: *
Required Permission: *
This property communicates the actual state of the turn signal lights. It is independent * from the actual turn signal switch state or the hazard lights button state. * *
Examples: *
This is different from the function of {@link #TURN_SIGNAL_SWITCH}, which must communicate * the state of the turn signal lever/switch. * *
Note that this property uses {@link VehicleTurnSignal} as a bit flag, unlike {@link * #TURN_SIGNAL_SWITCH}, which uses it like a regular enum. This means this property supports * ORed together values in {@link VehicleTurnSignal}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns all supported combinations of {@link VehicleTurnSignal}. * *
Property Config: *
Required Permission: *
This property communicates the state of the turn signal lever/switch. This is different * from the function of {@link #TURN_SIGNAL_LIGHT_STATE}, which must communicate the actual * state of the turn signal lights. * *
Note that this property uses {@link VehicleTurnSignal} as a regular enum, unlike {@link * #TURN_SIGNAL_LIGHT_STATE}, which uses it like a bit flag. This means this property does not * support ORed together values in {@link VehicleTurnSignal}. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported {@link VehicleTurnSignal}s. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative speeds. * 0 means the fan is off. The value must be non-negative, larger values mean faster fan speed. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
For each areaId, the result for {@code getMinMaxSupportedValue} indicates the range * of possible fan speed. * *
If 0 is included in the range, then you can use this property to turn off the fan. * Otherwise, you cannot use this property to turn off the fan, use {@link HVAC_POWER_ON} * instead. * *
Property Config: *
Required Permission: *
The supported values for this property is exposed via * {@link #HVAC_FAN_DIRECTION_AVAILABLE}. Caller should not call * {@link CarPropertyManager#getSupportedValuesList} or * {@link CarPropertyManager#getMinMaxSupportedValue} or * {@link AreaIdConfig#getSupportedEnumValues}. * *
This property will be supported if {@link #HVAC_FAN_DIRECTION_AVAILABLE} is supported * on the vehicle, and vice versa. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
For each areaId, the result for {@code getMinMaxSupportedValue} indicates the range of * HVAC temperature in Celsius. * *
The vehicle may not support setting a continuous range of temperature values in between * the min and max values. * *
Therefore, if the vehicle supports {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION}, the * application should use that property to get a supported value before setting {@code * HVAC_TEMPERATURE_SET}. The application should also use {@link * #HVAC_TEMPERATURE_VALUE_SUGGESTION} for converting the temperature from Celsius to Fahrenheit * and vice versa for this vehicle. * *
If {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} is * {@code true}, {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies the supported temperatures that the user may set in Celsius, e.g., * [16.0, 16.5, 17, ...]. If {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION}, the supported * temperatures match the result returned by {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION}. * *
If the {@link android.car.hardware.CarPropertyConfig#getConfigArray()} is defined, * it describes a lookup table to convert the temperature from Celsius to Fahrenheit and * vice versa for this vehicle. If {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION}, the config array * matches the result returned by {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION}. * *
The {@code configArray} is set as follows: *
The {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} must * be consistent with the config array. * *
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 {@code configArray} should be: *
* {@code configArray = {160, 280, 5, 605, 845, 10}}
*
*
* The supported values list should be: [16, 16.5, 17, 17.5, ..., 27.5, 28] * *
If the {@code configArray} is defined, applications should not use any other method for * converting temperature values besides {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION}, such as the * standard unit conversion formula of {@code 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: *
* {@code
* // 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 {@link #HVAC_TEMPERATURE_VALUE_SUGGESTION} nor the {@code * configArray} are defined, the application should use the standard unit conversion formula of * {@code F = (9/5) * C + 32}. * *
Property Config: *
Required Permission: *
Implement the property to help applications understand the closest supported temperature * value in Celsius or Fahrenheit. *
An application calls * {@link android.car.hardware.property.CarPropertyManager#setProperty(Class, int, int, Object)} * with the requested value and unit for the value. OEMs need to return the suggested values * in {@code floatValues[2]} and {@code floatValues[3]} by * {@link android.car.hardware.property.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, {@link 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, {@link 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 {@link 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, {@link 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, {@link VehicleUnit#CELSIUS}, 21.0, 70.0]. In this case, the application can know * that the value is 70.0 Fahrenheit in the car’s UI. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
This property is not in any particular unit, but in a specified range of relative * temperature settings. 0 means no heating or cooling. Positive values indicate heating and * negative values indicate cooling. Larger absolute values indicate stronger heating or * cooling. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is 0, unless * the vehicle supports seat cooling as well. In this case, it indicates the maximum seat * temperature cooling setting in negative number. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * maximum seat temperature heating setting. * *
Property Config: *
Required Permission: *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is 0 and * indicates no heating. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * the maximum heating level. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of heating settings. * 0 means no heating or cooling. Positive values indicate heating and negative values indicate * cooling. Larger absolute values indicate stronger heating or cooling. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is 0, unless the * vehicle supports steering wheel cooling as well. In such a case, it indicates the maximum * steering wheel cooling setting in negative number. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * maximum steering wheel heating setting. * *
Property Config: *
Required Permission: *
Will be one of {@link VehicleUnit#CELSIUS} or {@link VehicleUnit#FAHRENHEIT} or * {@link VehicleUnit#KELVIN}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values, e.g. [VehicleUnit.CELSIUS, VehicleUnit.FAHRENHEIT] * *
Property Config: *
Required Permissions: *
Property Config: *
Required Permission: *
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: *
For each supported area ID, this property provides a list of supported HVAC fan * positions for the {@link #HVAC_FAN_DIRECTION} property (e.g. * {@link CarHvacFanDirection#DEFROST_AND_FLOOR}). * *
This property will be supported if {@link #HVAC_FAN_DIRECTION} is supported on the * vehicle, and vice versa. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
This property is not in any particular unit but in the specified range of ventilation * settings. 0 means no ventilation. The value must be non-negative. Larger values indicate * stronger ventilation. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is 0. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * maximum ventilation setting available for the seat. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
Indicates which units the car is using to display distances to the user. * *
Will be one of {@link VehicleUnit#MILLIMETER} or {@link VehicleUnit#METER} or * {@link VehicleUnit#KILOMETER} or {@link VehicleUnit#MILE}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values, e.g. * [VehicleUnit.METER, VehicleUnit.KILOMETER, VehicleUnit.MILE]. * *
Property Config: *
Required Permissions: *
Indicates which units the car is using to display fuel volume to the user. * *
Will be one of {@link VehicleUnit#MILLILITER} or {@link VehicleUnit#LITER} * or {@link VehicleUnit#US_GALLON} or {@link VehicleUnit#IMPERIAL_GALLON}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values, e.g. [VehicleUnit.LITER, VehicleUnit.US_GALLON]. * *
Property Config: *
Required Permissions: *
Indicates which units the car is using to display tire pressure to the user. * *
Will be one of {@link VehicleUnit#KILOPASCAL} or {@link VehicleUnit#PSI} * or {@link VehicleUnit#BAR}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values, e.g. [VehicleUnit.KILOPASCAL, VehicleUnit.PSI]. * *
Property Config: *
Required Permissions: *
Indicates which units the vehicle is using to display EV battery information to the user. * *
Will be one of {@link VehicleUnit#WATT_HOUR} or {@link VehicleUnit#AMPERE_HOURS} * or {@link VehicleUnit#KILOWATT_HOUR}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values, e.g. [VehicleUnit.WATT_HOUR, VehicleUnit.KILOWATT_HOUR]. * *
Property Config: *
Required Permissions: *
Indicates type of units the vehicle is using to display speed to user. * *
Will be one of {@link VehicleUnit#METER_PER_SEC} or {@link VehicleUnit#MILES_PER_HOUR} or * {@link VehicleUnit#KILOMETERS_PER_HOUR} * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * returns the supported values, e.g. * [VehicleUnit.MILES_PER_HOUR, VehicleUnit.KILOMETERS_PER_HOUR]. * *
Property Config: *
Required Permissions: *
Indicates type of units the car is using to display fuel consumption information to user. * *
{@code true} indicates units are distance over volume such as MPG. * *
{@code false} indicates units are volume over distance such as L/100KM. * *
Property Config: *
Required Permissions: *
Property Config: *
Required Permission: *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@link android.car.hardware.power.CarPowerManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_POWER) public static final int AP_POWER_STATE_REQ = 289475072; /** * Property to report power state of application processor. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@link android.car.hardware.power.CarPowerManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_POWER) public static final int AP_POWER_STATE_REPORT = 289475073; /** * Property to report bootup reason for the current power on. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@link android.car.hardware.power.CarPowerManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_POWER) public static final int AP_POWER_BOOTUP_REASON = 289409538; /** * Property to represent brightness of the display. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@link android.car.hardware.power.CarPowerManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_POWER) public static final int DISPLAY_BRIGHTNESS = 289409539; /** * Property to represent brightness of the displays which are controlled separately. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@link android.car.hardware.power.CarPowerManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_POWER) public static final int PER_DISPLAY_BRIGHTNESS = 289475076; /** * Valet mode enabled * *
This property allows the user to enable/disable valet mode in their vehicle. Valet mode is * a privacy and security setting that prevents an untrusted driver to access more private areas * in the vehicle, such as the glove box or the trunk(s). * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
This property allows the user to turn on/off the HUD for their seat. * *
Each HUD in the vehicle will be assigned to the seat that is intended to use it. For * example, if there is a single HUD in the vehicle that is used by the driver so that they no * longer need to continuously look at the instrument cluster, then this property will be * defined with a single area ID that is equal to the driver's seat area ID. * *
Property Config: *
Required Permissions: *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated car service internal use only. */ @Deprecated public static final int HW_KEY_INPUT = 289475088; /** * Door position. * *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is 0. It * indicates the door is closed. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * door is fully open. * *
All integers between the min and max values are supported and indicate a transition state * between the closed and fully open positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * maximum movement speed of the door while closing. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * maximum movement speed of the door while opening. * *
Property Config: *
Required Permission: *
True indicates that the door is locked. * *
Property Config: *
Required Permission: *
Returns true if the door child lock feature is enabled and false if it is disabled. * If enabled, the door is unable to be opened from the inside. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * mirror is tilted completely downwards. This must be a non-positive value. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * mirror is tilted completely upwards. This must be a non-negative value. * *
0 indicates the mirror is not tilted in either direction. * *
All integers between the min and max values are supported and indicate a transition state * between the completely downwards and completely upwards positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the mirror while tilting downwards. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the mirror while tilting upwards. * *
All integers between min and max value are supported. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * mirror is tilted completely to the left. This must be a non-positive value. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * mirror is tilted completely to the right. This must be a non-negative value. * *
0 indicates the mirror is not tilted in either direction. * *
All integers between the min and max values are supported and indicate a transition state * between the extreme left and extreme right positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the mirror while tilting left. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the mirror while tilting right. * *
Property Config: *
Required Permission: *
True indicates all mirror positions are locked and not changeable. * *
Property Config: *
Required Permission: *
Property Config: *
Required Permission: *
This property is true when the feature for automatically folding the vehicle's mirrors * (for example, when the mirrors fold inward automatically when one exits and locks the * vehicle) is enabled. * *
Property Config: *
Required Permission: *
This property is true when the feature for automatically tilting the vehicle's mirrors * (for example, when the mirrors tilt downward automatically when one reverses the vehicle) is * enabled. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates that * the glove box door is closed. The minInt32Value must be 0. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates that * the glove box door is in the fully open position. * *
All integers between the min and max values are supported and indicate a transition state * between the closed and fully open positions. * *
The supported area IDs match the seat(s) by which the glove box is intended to be used * (e.g.) if the front right dashboard has a glove box embedded in it, then the area ID should * be {@link VehicleAreaSeat#SEAT_ROW_1_RIGHT}). * *
Property Config: *
Required Permission: *
If {@code true}, the glove box is locked. If {@code false}, the glove box is unlocked. * *
The supported area IDs match the seat(s) by which the glove box is intended to be used * (e.g. if the front right dashboard has a glove box embedded in it, then the area ID will be * {@link android.car.VehicleAreaSeat#SEAT_ROW_1_RIGHT}). * *
Property Config: *
Required Permission: *
This parameter selects the memory preset to use to select the seat position. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is always 0. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * max memory preset that can be chosen. For instance, if the driver's seat has 3 memory * presets, the max value will be 2. When the user wants to select a preset, the desired preset * number (0, 1, or 2) is set. * *
Property Config: *
Required Permission: *
This setting allows the user to save the current seat position settings into the selected * preset slot. The {@link android.car.hardware.property.AreaIdConfig#getMaxValue()} for each * seat position must match the {@link android.car.hardware.property.AreaIdConfig#getMaxValue()} * for {@link #SEAT_MEMORY_SELECT}. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} is always 0. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * max memory preset that can be chosen. For instance, if the driver's seat has 3 memory * presets, the max value will be 2. When the user wants to select a preset, the desired preset * number (0, 1, or 2) is set. * *
Property Config: *
Required Permission: *
True indicates belt is buckled. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat belt's shoulder anchor is at its lowest position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat belt's shoulder anchor is at its highest position. * *
All integers between the min and max values are supported and indicate a transition state * between the lowest and highest positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat belt's shoulder anchor while moving downwards. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat belt's shoulder anchor while moving upwards. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat is at its rearward-most linear position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat is at its forward-most linear position. * *
All integers between the min and max values are supported and indicate a transition state * between the forward most and rearward most positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat while moving backward. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat while moving forward. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat backrest's full recline position w.r.t the actuator at the bottom of the seat (see * {@link #SEAT_BACKREST_ANGLE_1_MOVE} for additional details). * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat backrest's most upright/forward position w.r.t the actuator at the bottom of the seat * (see {@link #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: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat backrest while reclining. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat backrest while angling forward. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat backrest's full recline position w.r.t the next actuator in the backrest from the one at * the bottom of the seat (see {@link #SEAT_BACKREST_ANGLE_2_MOVE} for more details). * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat backrest's most upright/forward position w.r.t the next actuator in the backrest from * the one at the bottom of the seat (see {@link #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: *
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 {@link * #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 {@link #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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat backrest while reclining. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat backrest while angling forward. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat is in its lowest position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat is in its highest position. * *
All integers between the min and max values are supported and indicate a transition state * between the lowest and highest positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat while moving downward. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat while moving upward. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat is in its shallowest position (i.e. the position with the smallest distance between the * front edge of the seat cushion and the rear end of the seat). * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat is in its deepest position (i.e. the position with the largest distance between the * front edge of the seat cushion and the rear end of the seat). * *
All integers between the min and max values are supported and indicate a transition state * between the shallowest and deepest positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat while getting shallower. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat while getting deeper. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat bottom is angled at its lowest angular position. This corresponds to the seat's front * edge at its lowest possible position relative to the rear end of the seat. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat bottom is angled at its highest angular position. This corresponds to the seat's front * edge at its highest possible position relative to the rear end of the seat. * *
All integers between the min and max values are supported and indicate a transition state * between the lowest and highest positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the front edge of the seat while moving downward. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the front edge of the seat while moving upward. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat lumbar support's rearward most position (i.e. least supportive position). * *
{@link android.car.hardware.property.MinMaxSupportedValue#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: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat's lumbar support while moving backward. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * represents the maximum movement speed of the seat's lumbar support while moving forward. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * lumbar side support is in its thinnest position (i.e. most support). * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * lumbar side support is in its 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: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat's lumbar side support while getting thinner. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat's lumbar side support while getting wider. * *
Property Config: *
Required Permission: *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated because it is defined as type {@link VehicleAreaType#VEHICLE_AREA_TYPE_GLOBAL}, * which means all seats use the same value. Use {@link #SEAT_HEADREST_HEIGHT_POS_V2} instead * which fixes this issue by being defined as type * {@link VehicleAreaType#VEHICLE_AREA_TYPE_SEAT}. */ @Deprecated @RequiresPermission(Car.PERMISSION_CONTROL_CAR_SEATS) public static final int SEAT_HEADREST_HEIGHT_POS = 289409941; /** * Headrest height position. * *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * headrest is in its lowest position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * headrest is in its highest position. * *
All integers between the min and max values are supported and indicate a transition state * between the shortest and tallest positions. * *
{@link android.car.hardware.CarPropertyConfig#getAreaIds()} specifies which seats are * supported. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat's headrest while moving down. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat's headrest while moving up. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * headrest is in its full recline position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * headrest is in its 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: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat's headrest while reclining. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat's headrest while moving into an upright/forward * position. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * headrest is in its rearward-most linear position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * headrest is in its forward-most linear position. * *
All integers between the min and max values are supported and indicate a transition state * between the forward most and rearward most positions. * *
Property Config: *
Required Permission: *
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. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat's headrest while moving backward. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat's headrest while moving forward. * *
Property Config: *
Required Permission: *
{@code SEAT_FOOTWELL_LIGHTS_STATE} reflects the current state of the lights at any point * in time. This is different from the function of {@link #SEAT_FOOTWELL_LIGHTS_SWITCH} which * represents the position of the switch controlling the lights. Therefore, {@code * SEAT_FOOTWELL_LIGHTS_STATE} may not match the value of {@link #SEAT_FOOTWELL_LIGHTS_SWITCH} * (e.g. {@link #SEAT_FOOTWELL_LIGHTS_SWITCH}={@code VehicleLightSwitch#STATE_AUTOMATIC} and * {@code SEAT_FOOTWELL_LIGHTS_STATE}={@code VehicleLightState#STATE_ON}). * *
This property will only be implemented if {@code SEAT_FOOTWELL_LIGHTS_STATE}'s value may * be different from that of {@link #CABIN_LIGHTS_STATE}. * *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
{@code SEAT_FOOTWELL_LIGHTS_SWITCH} represents the position of the switch controlling the * lights. This is different from the function of {@link #SEAT_FOOTWELL_LIGHTS_STATE} which * reflects the current state of the lights at any point in time. Therefore, {@code * SEAT_FOOTWELL_LIGHTS_SWITCH} may not match the value of {@link #SEAT_FOOTWELL_LIGHTS_STATE} * (e.g. {@code SEAT_FOOTWELL_LIGHTS_SWITCH}={@code VehicleLightSwitch#STATE_AUTOMATIC} and * {@link #SEAT_FOOTWELL_LIGHTS_STATE}={@code VehicleLightState#STATE_ON}). * *
This property will only be implemented if {@code SEAT_FOOTWELL_LIGHTS_SWITCH}'s value may * be different from that of {@link #CABIN_LIGHTS_SWITCH}. * *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
If true, the seat will automatically adjust to make it easier for the occupant to enter * and exit the vehicle. Each area ID maps to the seat that the user is trying to enter/exit * with the help of the easy access feature. * *
Property Config: *
Required Permission: *
If true, it means the seat's airbags are enabled, and if triggered (e.g. by a crash), they * will deploy. If false, it means the seat's airbags are disabled, and they will not deploy * under any circumstance. This property does not indicate if the airbags are deployed or not. * *
Property Config: *
Required Permission: *
Bit flag property to relay information on which airbags have been deployed in the vehicle * at each seat, vs which ones are currently still armed. When SEAT_AIRBAG_ENABLED is set to * false at a particular areaId, this property will be UNAVAILABLE at that areaId. * *
Enums apply to each seat, not the global vehicle. For example, * {@link android.car.hardware.property.VehicleAirbagLocation#CURTAIN} at the driver seat areaId * represents whether the driver side curtain airbag has been deployed. Multiple bit flags can * be set to indicate that multiple different airbags have been deployed for the seat. * *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from {@link android.car.hardware.property.VehicleAirbagLocation} are * supported. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * seat cushion side support is in its thinnest position (i.e. most support). * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat cushion side support is in its 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: *
This property is not in any particular unit but in a specified range of relative movement * speeds. * *
Positive values means the seat cushion side support is growing wider (i.e. less support) * and negative values means the seat cushion side support is growing thinner (i.e. more * support). Larger integers, either positive or negative, indicate a faster speed. Once the * seat cushion side support reaches the positional limit, the value resets to 0. When this * property's value is 0, that means there is no movement currently occurring. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * maximum movement speed of the seat cushion side support when growing thinner (i.e. support * is increasing). * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum movement speed of the seat cushion side support when growing wider (i.e. support is * decreasing). * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * lumbar support's lowest position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * lumbar support's highest position. * *
All integers between the min and max values are supported and indicate a transition state * between the lowest and highest positions. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative movement * speeds. * *
Positive values mean the lumbar support is moving up and negative values mean the lumbar * support is moving down. Larger integers, either positive or negative, indicate a faster * speed. Once the lumbar support reaches the positional limit, the value resets to 0. When this * property's value is 0, that means there is no movement currently occurring. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * lumbar support is moving at the fastest downward speed. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * lumbar support is moving at the fastest upward speed. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * normal seat position. The minInt32Value must be 0, meaning the seat is in the normal * position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * seat is in the full walk-in position. * *
All integers in between the min and max values are supported and indicate a transition * state between the normal and walk-in positions. The area IDs match the seats that actually * move when the walk-in feature activates. * *
Property Config: *
Required Permission: *
Property to relay information on whether the seat belt pretensioner has been deployed for * a particular seat due to a collision. This is different from the regular seat belt tightening * system that continuously adds tension to the seat belts so that they fit snugly around the * person sitting in the seat, nor is it the seat belt retractor system that locks the seat belt * in place during sudden brakes or when the user jerks the seat belt. * *
If this property is dependant on the state of other properties, and if those properties * are currently in the state that doesn't support this property, reading this property will * throw {@link android.car.hardware.property.PropertyNotAvailableException}. * *
Property Config: *
Required Permission: *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleSeatOccupancyState} are supported. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * window is closed/fully open out of plane. If the window cannot open out of plane, then * minInt32Value is the position of the window when fully closed and must be 0. If the window * can open out of plane, the minInt32Value indicates the window is fully open in its position * out of plane and will be a negative value. See the example below for a more detailed * explanation. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * window is 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. * *
For example, this is how the property should work for a window that can move out of plane: * For a window that may open out of plane (i.e. vent mode of sunroof) this * parameter will work with negative values as follows: * Max = sunroof completely open * 0 = sunroof closed. * Min = sunroof vent completely vented * * Note that in all modes, 0 indicates the window is closed. * *
Property Config: *
Required Permission: *
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. * *
For a window that may open out of plane (i.e. vent mode of sunroof) this * parameter will work as follows: * *
If sunroof is open: * Max = open the sunroof further, automatically stop when fully open. * Min = close the sunroof, automatically stop when sunroof is closed. * *
If vent is open: * Max = close the vent, automatically stop when vent is closed. * Min = open the vent further, automatically stop when vent is fully open. * *
If sunroof is in the closed position: * Max = open the sunroof, automatically stop when sunroof is fully open. * Min = open the vent, automatically stop when vent is fully open. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * window is closing in plane/opening in the out of plane direction at the fastest speed. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * window is opening in plane/closing in the out of plane direction at the fastest speed. * *
Property Config: *
Required Permission: *
True indicates that the window is child-locked. * *
Property Config: *
Required Permission: *
Returns the instantaneous time period for 1 full cycle of the windshield wipers in {@link * android.car.VehicleUnit#MILLI_SECS}. A full cycle is defined as a wiper moving from and * returning to its rest position. * *
When an intermittent wiper setting is selected, this property value will be set to 0 * during the "pause" phase of the intermittent wiping. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} must be set to 0 * for each area ID. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} must specify the * longest wiper period. * *
Property Config: *
Required Permission: *
Returns the current state of the windshield wipers. The value of {@code * WINDSHIELD_WIPERS_STATE} may not match the value of {@link #WINDSHIELD_WIPERS_SWITCH}. (e.g. * {@code #WINDSHIELD_WIPERS_STATE} = {@link * android.car.hardware.property.WindshieldWipersState#ON} and {@link * #WINDSHIELD_WIPERS_SWITCH} = {@link * android.car.hardware.property.WindshieldWipersSwitch#AUTO}). * *
If {@code #WINDSHIELD_WIPERS_STATE} = {@link * android.car.hardware.property.WindshieldWipersState#ON} and {@link #WINDSHIELD_WIPERS_PERIOD} * is implemented, then {@link #WINDSHIELD_WIPERS_PERIOD} will reflect the time period of 1 * full cycle of the wipers. * *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from {@link android.car.hardware.property.WindshieldWipersState} are * supported. * *
Property Config: *
Required Permission: *
Represents the position of the switch controlling the windshield wipers. The value of * {@code WINDSHIELD_WIPERS_SWITCH} may not match the value of {@link #WINDSHIELD_WIPERS_STATE} * (e.g. {@code WINDSHIELD_WIPERS_SWITCH} = {@link * android.car.hardware.property.WindshieldWipersSwitch#AUTO} and {@link * #WINDSHIELD_WIPERS_STATE} = WindshieldWipersState#ON). * *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which values from {@link android.car.hardware.property.WindshieldWipersSwitch} are * supported. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * steering wheel position closest to the driver. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * steering wheel position furthest from the driver. * *
All integers in between the min and max values are supported and indicate a transition * state between the closest and farthest positions. * *
Property Config: *
Required Permission: *
Returns the speed and direction, either towards or away from the driver, that the * steering wheel is moving in. This property is not in any particular unit but in a specified * range of relative movement speeds. * *
Positive values mean the steering wheel is moving away from the driver and negative values * mean the steering wheel is moving towards the driver. Larger integers, either positive or * negative, indicate a faster speed. Once the steering wheel reaches the positional limit, the * value resets to 0. When this property's value is 0, that means there is no movement currently * occurring. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * maximum speed at which the steering wheel is moving towards the driver. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * maximum speed at which the steering wheel moving away from the driver. * *
Property Config: *
Required Permission: *
This property is not in any particular unit but in a specified range of relative * positions. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * steering wheel being in the lowest position. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * steering wheel being in the highest position. * *
All integers in between the min and max values are supported and indicate a transition * state between the lowest and highest positions. * *
Property Config: *
Required Permission: *
Returns the speed and direction, either upwards or downwards, that the steering wheel is * moving in. This property is not in any particular unit but in a specified range of relative * movement speeds. * *
Positive values mean moving upwards and negative values mean moving downwards. Larger * integers, either positive or negative, indicate a faster speed. Once the steering wheel * reaches the positional limit, the value resets to 0. When this property's value is 0, that * means there is no movement currently occurring. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} indicates the * maximum speed at which the steering wheel is moving downwards. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} indicates the * maximum speed at which the steering wheel is moving upwards. * *
Property Config: *
Required Permission: *
Returns true if the steering wheel theft lock feature is enabled and false if it is * disabled. If enabled, the steering wheel will lock automatically to prevent theft in * certain situations. * *
Property Config: *
Required Permission: *
Returns true if the steering wheel is locked. If locked, the steering wheel’s position is * not changeable. * *
Property Config: *
Required Permission: *
Returns true if the steering wheel easy access feature is enabled and false if it is * disabled. If enabled, the driver’s steering wheel will automatically adjust to make it easier * for the driver to enter and exit the vehicle. * *
Property Config: *
Required Permission: *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@code android.car.vms.VmsClientManager} instead. */ @Deprecated @RequiresPermission(anyOf = {Car.PERMISSION_VMS_PUBLISHER, Car.PERMISSION_VMS_SUBSCRIBER}) public static final int VEHICLE_MAP_SERVICE = 299895808; /** * 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 {@link * android.location.LocationManager#GPS_PROVIDER}. * *
The value returned is a collection of bit flags. The bit flags are defined in {@link * LocationCharacterization}. The value will also include exactly * one of {@link LocationCharacterization#DEAD_RECKONED} or {@link * 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 {@link * android.location.LocationManager#GPS_PROVIDER}. That is unless otherwise specified through * other {@link android.location.LocationManager} APIs. * *
Property Config: *
Required Permission: *
Each individual sensor is identified by its unique {@link AreaIdConfig#getAreaId()} and * returns the sensor's position formatated as [x, y, z] where: * *
Property Config: *
Required Permission: *
Each individual sensor is identified by its {@link AreaIdConfig#getAreaId()} and returns * the sensor's orientation formatted as [qw, qx, qy, qz] where: * *
This assumes each sensor uses the same axes conventions as Android Automotive. * *
Property Config: *
Required Permission: *
Each individual sensor is identified by its {@link AreaIdConfig#getAreaId()} and returns * the sensor's field of view formatted as [horizontal, vertical] where: * *
This assumes each sensor uses the same axes conventions as Android Automotive. * *
Property Config: *
Required Permission: *
Each individual sensor is identified by its {@link AreaIdConfig#getAreaId()} and returns * the sensor's detection range formatted as [minimum, maximum] where: * *
Property Config: *
Required Permission: *
For ultrasonic sensors that only support readings within a specific range. For example, if * an ultrasonic sensor detects an object at 700mm, but can only report that an object has been * detected between 500mm and 1000mm. * *
Each individual sensor is identified by its {@link AreaIdConfig#getAreaId()} and returns * the sensor's supported ranges formatted as [range_min_1, range_max_1, range_min_2, * range_max_2, ...] where: * *
For example, if an ultrasonic sensor supports the ranges 150mm to 499mm, 500mm to 999mm, * and 1000mm to 1500mm, then the property should be set to: *
If this property is not defined, all the values within the * {@link #ULTRASONICS_SENSOR_DETECTION_RANGE} for the specified sensor are assumed to be * supported. * *
Property Config: *
Required Permission: *
Each individual sensor is identified by its {@link AreaIdConfig#getAreaId()} and returns * the sensor's measured distance formatted as [distance, distance_error] where: * *
If no object is detected, an empty vector will be returned. If distance_error is not * available then an array of only the measured distance will be returned. * *
Property Config: *
Required Permission: *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@code android.car.diagnostic.CarDiagnosticManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_DIAGNOSTIC_READ_ALL) public static final int OBD2_LIVE_FRAME = 299896064; /** * OBD2 Freeze Frame Sensor Data. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@code android.car.diagnostic.CarDiagnosticManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_DIAGNOSTIC_READ_ALL) public static final int OBD2_FREEZE_FRAME = 299896065; /** * OBD2 Freeze Frame Information. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@code android.car.diagnostic.CarDiagnosticManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_DIAGNOSTIC_READ_ALL) public static final int OBD2_FREEZE_FRAME_INFO = 299896066; /** * OBD2 Freeze Frame Clear. * *
Not exposed through {@link android.car.hardware.property.CarPropertyManager}. * *
This property is not supported. * * @deprecated use {@code android.car.diagnostic.CarDiagnosticManager} instead. */ @Deprecated @RequiresPermission(Car.PERMISSION_CAR_DIAGNOSTIC_CLEAR) public static final int OBD2_FREEZE_FRAME_CLEAR = 299896067; /** * Headlights State. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
If the car has both front and rear fog lights: *
If the car has only front fog lights: *
If the car has only rear fog lights: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
If the car has both front and rear fog lights: *
If the car has only front fog lights: *
If the car has only rear fog lights: *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
Returns the current state of the steering wheel lights. This is different from {@link * #STEERING_WHEEL_LIGHTS_SWITCH} which represents the position of the switch controlling * the lights. Therefore, {@code STEERING_WHEEL_LIGHTS_STATE} may not match the value of * {@link #STEERING_WHEEL_LIGHTS_SWITCH} (e.g. {@link #STEERING_WHEEL_LIGHTS_SWITCH}={@code * VehicleLightSwitch#STATE_AUTOMATIC} and {@code STEERING_WHEEL_LIGHTS_STATE}={@code * VehicleLightState#STATE_ON}). * *
This property will only be implemented if {@code STEERING_WHEEL_LIGHTS_STATE}'s value may * be different from that of {@link #CABIN_LIGHTS_STATE}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
Returns the position of the switch controlling the steering wheel lights. This is * different from {@link #STEERING_WHEEL_LIGHTS_STATE} which represents the current state of the * steering wheel lights. Therefore, {@code STEERING_WHEEL_LIGHTS_SWITCH} may not match the * value of {@link #STEERING_WHEEL_LIGHTS_STATE} (e.g. {@code STEERING_WHEEL_LIGHTS_SWITCH}= * {@code VehicleLightSwitch#STATE_AUTOMATIC} and {@link #STEERING_WHEEL_LIGHTS_STATE}={@code * VehicleLightState#STATE_ON}). * *
This property will only be implemented if {@code STEERING_WHEEL_LIGHTS_SWITCH}'s value may * be different from that of {@link #CABIN_LIGHTS_SWITCH}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
Doesn't require permission because it's not exposed through * {@link android.car.hardware.property.CarPropertyManager}. * *
Property Config: *
This value denotes the number of milliseconds that have elapsed since 1/1/1970 UTC. * *
Property Config: *
Required Permission: *
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 {@link VehicleElectronicTollCollectionCardType}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleElectronicTollCollectionCardType} are * supported. * *
Property Config: *
Required Permission: *
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 {@link VehicleElectronicTollCollectionCardStatus}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleElectronicTollCollectionCardStatus} are * supported. * *
Property Config: *
Required Permission: *
Please refer to the documentation on {@link #FOG_LIGHTS_STATE} for more information. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
Please refer to the documentation on {@link #FOG_LIGHTS_SWITCH} for more information. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
Please refer to the documentation on {@link #FOG_LIGHTS_STATE} for more information. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightState} are supported. * *
Property Config: *
Required Permission: *
Please refer to the documentation on {@link #FOG_LIGHTS_SWITCH} for more information. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code VehicleLightSwitch} are supported. * *
Property Config: *
Required Permission: *
This may or may not match the vehicle's maximum possible draw limit. This maximum draw * limit in Amperes is listed in the first entry in its * {@link CarPropertyConfig#getConfigArray()}. * *
If property is writable, the user may adjust this value. * *
Property Config: *
Required Permissions: *
Indicates the maximum charge percent threshold set by the user. Returns a float value * from 0 to 100. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} might be * {@code true}. If it is {@code false}, then all values from 0 to 100 are supported. If it is * {@code true}, {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies the valid carge percent limit options for the vehicle, e.g. [20, 40, 60, 80]. * *
Property Config: *
Required Permissions: *
Returns the current charging state of the car. See {@link * android.car.hardware.property.EvChargeState} for possible values for {@code EV_CHARGE_STATE}. * *
If the vehicle has a target charge percentage other than 100, this property will return * {@link EvChargeState#STATE_FULLY_CHARGED} when the battery charge level has reached the * target level. See {@link #EV_CHARGE_PERCENT_LIMIT} for more context. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code EvChargeState} are supported. * *
Property Config: *
Required Permission: *
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: *
Returns 0 if the vehicle is not charging. * *
Property Config: *
Required Permission: *
Returns the current state associated with the regenerative braking * setting in the car. See {@link android.car.hardware.property.EvRegenerativeBrakingState} for * possible values for {@code EV_REGENERATIVE_BRAKING_STATE}. * *
If the {@link #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 {@link EvRegenerativeBrakingState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code EvRegenerativeBrakingState} are supported. * *
Property Config: *
Required Permission: *
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’s gross weight in kilograms. This is the vehicle curb weight plus the maximum * payload (passengers + cargo) the vehicle can support. * *
Property Config: *
Required Permission: *
Returns the trailer state of the car. See {@code TrailerState} for possible values for * {@code TRAILER_PRESENT}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@code TrailerState} are supported. * *
Property Config: *
Required Permission: *
Returns whether general security regulation compliance is required, if * so, what type of requirement. See {@link GsrComplianceType} for possible enums. * *
Property Config: *
Required Permission: *
Defines the level of autonomy currently engaged in the vehicle from the J3016_202104 * revision of the SAE standard levels 0-5, with 0 representing no autonomy and 5 representing * full driving automation. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which enum values from {@link android.car.hardware.property.VehicleAutonomousState} * are supported. * *
Property Config: *
Required Permission: *
Defines the level of autonomy being targeted by the vehicle from the J3016_202104 revision * of the SAE standard levels 0-5, with 0 representing no autonomy and 5 representing full * driving automation. * *
For example, suppose the vehicle is currently in a Level 3 state of automation and wants * to give the driver full manual control (i.e. Level 0) as soon as it's safe to do so. In this * scenario, this property will be set to {@link * android.car.hardware.property.VehicleAutonomousState#LEVEL_0}. Similarly, if the vehicle is * currently in Level 1 state of automation and wants to go up to Level 2, this property will be * set to {@link android.car.hardware.property.VehicleAutonomousState#LEVEL_2}. If the vehicle * has already reached and is currently in the target level of autonomy, this property will be * equal to the value of {@link #VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL}. * *
For the global area ID (0), the {@link * android.car.hardware.property.CarPropertyManager#getSupportedValuesList(int, int)} array * specifies which states from {@link android.car.hardware.property.VehicleAutonomousState} are * supported. This will always match the value specified by {@link * android.car.hardware.property.CarPropertyManager#getSupportedValuesList(int, int)} for * {@link #VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL}. * *
For the property that communicates the current state of autonomy, see * {@link #VEHICLE_DRIVING_AUTOMATION_CURRENT_LEVEL}. * *
Property Config: *
Required Permission: *
Returns true if AEB is enabled and false if AEB is disabled. When AEB is enabled, the ADAS * system in the vehicle should be turned on and monitoring to avoid potential collisions. This * property applies for higher speed applications only. For enabling low speed automatic * emergency braking, {@link LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_ENABLED} will be used. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of AEB. This property will always return a valid state defined * in {@link android.car.hardware.property.AutomaticEmergencyBrakingState} or {@link * android.car.hardware.property.ErrorState}. This property should apply for higher speed * applications only. For representing the state of the low speed automatic emergency braking * system, {@link LOW_SPEED_AUTOMATIC_EMERGENCY_BRAKING_STATE} should be used. * *
If AEB includes forward collision warnings before activating the brakes, those warnings * will be surfaced through the Forward Collision Warning (FCW) properties. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.AutomaticEmergencyBrakingState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if FCW is enabled and false if FCW is disabled. When FCW is enabled, the ADAS * system in the vehicle should be turned on and monitoring for potential collisions. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of FCW. This property will always return a valid state defined * in {@link android.car.hardware.property.ForwardCollisionWarningState} or {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.ForwardCollisionWarningState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if BSW is enabled and false if BSW is disabled. When BSW is enabled, the ADAS * system in the vehicle should be turned on and monitoring for objects in the vehicle’s blind * spots. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of BSW. This property will always return a valid state defined * in {@link android.car.hardware.property.BlindSpotWarningState} or {@link * android.car.hardware.property.ErrorState}. * *
For each supported area ID, * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.BlindSpotWarningState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if LDW is enabled and false if LDW is disabled. When LDW is enabled, the ADAS * system in the vehicle should be turned on and monitoring if the vehicle is approaching or * crossing lane lines, in which case a warning will be given. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of LDW. This property will always return a valid state defined * in {@link android.car.hardware.property.LaneDepartureWarningState} or {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.LaneDepartureWarningState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if LKA is enabled and false if LKA is disabled. When LKA is enabled, the ADAS * system in the vehicle should be turned on and monitoring if the driver unintentionally drifts * toward or over the lane marking. If an unintentional lane departure is detected, the system * applies steering control to return the vehicle into the current lane. * *
This is different from Lane Centering Assist (LCA) which, when activated, applies * continuous steering control to keep the vehicle centered in the current lane. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of LKA. This property will always return a valid state defined * in {@link android.car.hardware.property.LaneKeepAssistState} or {@link * android.car.hardware.property.ErrorState}. * *
If LKA includes lane departure warnings before applying steering corrections, those * warnings will be surfaced through {@link #LANE_DEPARTURE_WARNING_STATE}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.LaneKeepAssistState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if LCA is enabled and false if LCA is disabled. When LCA is enabled, the ADAS * system in the vehicle should be turned on and waiting for an activation signal from the * driver. Once the feature is activated, the ADAS system should be steering the vehicle to keep * it centered in its current lane. * *
This is different from Lane Keep Assist (LKA) which monitors if the driver unintentionally * drifts toward or over the lane marking. If an unintentional lane departure is detected, the * system applies steering control to return the vehicle into the current lane. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Commands to activate and suspend LCA. They are only valid when {@link * #LANE_CENTERING_ASSIST_ENABLED} = {@code true}. Otherwise, these commands will throw a {@link * android.car.hardware.property.PropertyNotAvailableException}. * *
When the command {@link android.car.hardware.property.LaneCenteringAssistCommand#ACTIVATE} * is sent, {@link #LANE_CENTERING_ASSIST_STATE} will be set to {@link * android.car.hardware.property.LaneCenteringAssistState#ACTIVATION_REQUESTED}. When the * command {@link android.car.hardware.property.LaneCenteringAssistCommand#ACTIVATE} succeeds, * {@link #LANE_CENTERING_ASSIST_STATE} will be set to {@link * android.car.hardware.property.LaneCenteringAssistState#ACTIVATED}. When the command {@link * android.car.hardware.property.LaneCenteringAssistCommand#DEACTIVATE} succeeds, {@link * #LANE_CENTERING_ASSIST_STATE} will be set to {@link * android.car.hardware.property.LaneCenteringAssistState#ENABLED}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.LaneCenteringAssistCommand} are supported. * *
Property Config: *
Required Permission: *
Returns the current state of LCA. This property will always return a valid state defined * in {@link android.car.hardware.property.LaneCenteringAssistState} or {@link * android.car.hardware.property.ErrorState}. * *
If LCA includes lane departure warnings, those warnings will be surfaced through the Lane * Departure Warning (LDW) properties. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.LaneCenteringAssistState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Return true if ELKA is enabled and false if ELKA is disabled. When ELKA is enabled, the * ADAS system in the vehicle should be on and monitoring for unsafe lane changes by the driver. * When an unsafe maneuver is detected, ELKA alerts the driver and applies steering corrections * to keep the vehicle in its original lane. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of ELKA. Generally, this property should return a valid state * defined in the {@link android.car.hardware.property.EmergencyLaneKeepAssistState} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.EmergencyLaneKeepAssistState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Return true if CC is enabled and false if CC is disabled. This property is shared by all * forms of {@link android.car.hardware.property.CruiseControlType}). * *
When CC is enabled, the ADAS system in the vehicle should be turned on and responding to * commands. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
When {@link #CRUISE_CONTROL_ENABLED} is true, this property returns the type of CC that is * currently enabled (for example, standard CC, adaptive CC, etc.). Generally, this property * should return a valid state defined in the {@link * android.car.hardware.property.CruiseControlType} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.CruiseControlType} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Trying to write {@link android.car.hardware.property.CruiseControlType#OTHER} or an * {@link android.car.hardware.property.ErrorState} to this property will throw an {@code * IllegalArgumentException}. * *
Property Config: *
Required Permissions: *
This property returns the state of CC. Generally, this property should return a valid * state defined in the {@link android.car.hardware.property.CruiseControlState} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.CruiseControlState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
See {@link android.car.hardware.property.CruiseControlCommand} for the details about * each supported command. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.CruiseControlCommand} are supported. * *
When this property is unavailable (for example when {@link #CRUISE_CONTROL_ENABLED} is * false), writing this property will throw a {@link * android.car.hardware.property.PropertyNotAvailableException}. * *
Property Config: *
Required Permission: *
This value is non-negative. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} represents the * lower bound of the target speed, must be non-negative. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * upper bound of the target speed. * *
When this property is unavailable (for example when {@link #CRUISE_CONTROL_ENABLED} is * false), reading this property will throw a {@link * android.car.hardware.property.PropertyNotAvailableException}. * *
Property Config: *
Required Permission: *
This property should specify the target time gap to a leading vehicle. This gap is defined * as the time to travel the distance between the leading vehicle's rear-most point to the ACC * vehicle's front-most point. The actual time gap from a leading vehicle can be above or below * this value. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies the supported target time gap in ascending order. * *
All values must be positive. If the property is writable, all values must be writable. * *
When this property is unavailable (for example when {@link #CRUISE_CONTROL_ENABLED} is * false), reading or writing this property will throw a {@link * android.car.hardware.property.PropertyNotAvailableException}. * *
Property Config: *
Required Permissions: *
Returns the measured distance in meters from the lead vehicle for ACC between the * rear-most point of the leading vehicle and the front-most point of the ACC vehicle. * *
This value must be non-negative. * *
{@link android.car.hardware.property.AreaIdConfig#hasMinSupportedValue()} and {@link * android.car.hardware.property.AreaIdConfig#hasMaxSupportedValue()} will be {@code true} for * all areaIds. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMinValue()} must be 0, * indicating no distance. * *
{@link android.car.hardware.property.MinMaxSupportedValue#getMaxValue()} represents the * maximum range the distance sensor can support. * *
When no lead vehicle is detected (that is, when there is no leading vehicle or the leading * vehicle is too far away for the sensor to detect), this property will throw a {@link * android.car.hardware.property.PropertyNotAvailableException}. * *
When this property is unavailable (for example when {@link #CRUISE_CONTROL_ENABLED} is * false), reading this property will throw a {@link * android.car.hardware.property.PropertyNotAvailableException}. * *
Property Config: *
Required Permission: *
Return true if HOD is enabled and false if HOD is disabled. When HOD is enabled, a system * inside the vehicle should be monitoring the presence of the driver's hands on the steering * wheel and send a warning if it detects that the driver's hands are no longer on the steering * wheel. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns whether the driver's hands are on the steering wheel. Generally, this property * should return a valid state defined in the {@link * android.car.hardware.property.HandsOnDetectionDriverState} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through {@link * android.car.hardware.property.ErrorState}. * *
If the vehicle is sending a warning to the user because the driver's hands have been off * the steering wheel for too long, the warning should be surfaced through * {@link #HANDS_ON_DETECTION_WARNING}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from {@link android.car.hardware.property.HandsOnDetectionDriverState} * and {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns whether a warning is being sent to the driver for having their hands off the wheel * for too long a duration. * *
Generally, this property should return a valid state defined in the {@link * android.car.hardware.property.HandsOnDetectionWarning} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through an {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from {@link android.car.hardware.property.HandsOnDetectionWarning} * and {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Set true to enable driver drowsiness and attention monitoring and false to disable driver * drowsiness and attention monitoring. When driver drowsiness and attention monitoring is * enabled, a system inside the vehicle will monitor the drowsiness and attention level of the * driver and warn the driver if needed. * *
Property Config: *
Required Permissions: *
Returns the current detected state of driver drowiness and attention level based on the * Karolinska Sleepiness Scale (KSS). * *
Generally, this property should return a valid state defined in the {@link * android.car.hardware.property.DriverDrowsinessAttentionState} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through {@link * android.car.hardware.property.ErrorState}. * *
If the vehicle is sending a warning to the user because the driver is too drowsy, the * warning should be surfaced through {@link #DRIVER_DROWSINESS_ATTENTION_WARNING}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.DriverDrowsinessAttentionState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Set true to enable driver drowsiness and attention warnings and false to disable driver * drowsiness and attention warnings. When driver drowsiness and attention warnings are enabled, * the driver drowsiness and attention monitoring system inside the vehicle should warn the * driver when it detects the driver is drowsy or not attentive. * *
Property Config: *
Required Permissions: *
Returns whether a warning is being sent to the driver for being drowsy or not attentive. * *
Generally, this property should return a valid state defined in the {@link * android.car.hardware.property.DriverDrowsinessAttentionWarning} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through an {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.DriverDrowsinessAttentionWarning} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Set true to enable driver distraction monitoring and false to disable driver distraction * monitoring. When driver distraction monitoring is enabled, a system inside the vehicle should * be monitoring the distraction level of the driver and warn the driver if needed. * *
Property Config: *
Required Permissions: *
Returns the current detected driver distraction state. * *
Generally, this property should return a valid state defined in the {@link * android.car.hardware.property.DriverDistractionState} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through {@link * android.car.hardware.property.ErrorState}. * *
If the vehicle is sending a warning to the user because the driver is too distracted, the * warning should be surfaced through {@link #DRIVER_DISTRACTION_WARNING}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.DriverDistractionState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Set true to enable driver distraction warnings and false to disable driver distraction * warnings. When driver distraction warnings are enabled, the driver distraction monitoring * system inside the vehicle should warn the driver when it detects the driver is distracted. * *
Property Config: *
Required Permissions: *
Returns whether a warning is being sent to the driver for being distracted. * *
Generally, this property should return a valid state defined in the {@link * android.car.hardware.property.DriverDistractionWarning} or {@link * android.car.hardware.property.ErrorState}. For example, if the feature is not available due * to some temporary state, that information should be conveyed through an {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.DriverDistractionWarning} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if low speed collision warning is enabled and false if low speed collision * warning is disabled. When low speed collision warning is enabled, the ADAS system in the * vehicle will warn the driver of potential collisions at low speeds. This property is * different from the pre-existing {@link VehiclePropertyIds#FORWARD_COLLISION_WARNING_ENABLED}, * which applies to higher speed applications only. If the vehicle doesn't have a separate * collision detection system for low speed environments, this property will not be implemented. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of Low Speed Collision Warning. This property will always return * a valid state defined in {@link android.car.hardware.property.LowSpeedCollisionWarningState} * or {@link android.car.hardware.property.ErrorState}. This property is different from the * pre-existing {@link VehiclePropertyIds#FORWARD_COLLISION_WARNING_ENABLED}, which applies to * higher speed applications only. If the vehicle doesn't have a separate collision detection * system for low speed environments, this property will not be implemented. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.LowSpeedCollisionWarningState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if Cross Traffic Monitoring is enabled and false if Cross Traffic Monitoring * is disabled. When Cross Traffic Monitoring is enabled, the ADAS system in the vehicle should * be turned on and monitoring for potential sideways collisions. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of Cross Traffic Monitoring Warning. This property will always * return a valid state defined in {@link * android.car.hardware.property.CrossTrafficMonitoringWarningState} or {@link * android.car.hardware.property.ErrorState}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.CrossTrafficMonitoringWarningState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *
Returns true if Low Speed Automatic Emergency Braking is enabled or false if Low Speed * Automatic Emergency Braking is disabled. When Low Speed Automatic Emergency Braking is * enabled, the ADAS system in the vehicle will be turned on and monitoring to avoid potential * collisions in low speed conditions. This property is different from the pre-existing * AUTOMATIC_EMERGENCY_BRAKING_ENABLED, which should apply to higher speed applications only. If * the vehicle doesn't have a separate collision avoidance system for low speed environments, * this property will not be implemented. * *
This property is defined as read_write, but OEMs have the option to implement it as read * only. * *
Property Config: *
Required Permissions: *
Returns the current state of Low Speed Automatic Emergency Braking. This property will * always return a valid state defined in {@link * android.car.hardware.property.LowSpeedAutomaticEmergencyBrakingState} or {@link * android.car.hardware.property.ErrorState}. * *
If Low Speed Automatic Emergency Braking includes collision warnings before activating the * brakes, those warnings will be surfaced through use of {@link * android.car.VehiclePropertyIds#LOW_SPEED_COLLISION_WARNING_ENABLED} and {@link * android.car.VehiclePropertyIds#LOW_SPEED_COLLISION_WARNING_STATE}. * *
For the global area ID(0), * {@link android.car.hardware.property.AreaIdConfig#hasSupportedValuesList()} will be * {@code true}. {@link android.car.hardware.property.CarPropertyManager#getSupportedValuesList} * specifies which states from * {@link android.car.hardware.property.LowSpeedAutomaticEmergencyBrakingState} and * {@link android.car.hardware.property.ErrorState} are supported. * *
Property Config: *
Required Permission: *