Save the date! Android Dev Summit is coming to Mountain View, CA on November 7-8, 2018.

CarSensorEvent

public class CarSensorEvent
extends Object implements Parcelable

java.lang.Object
   ↳ android.car.hardware.CarSensorEvent


A CarSensorEvent object corresponds to a single sensor event coming from the car. The sensor data is stored in a sensor-type specific format in the object's float and byte arrays. To aid unmarshalling the object's data arrays, this class provides static nested classes and conversion methods, for example CarSensorEvent.EnvironmentData and ERROR(/#getEnvironmentData). The conversion methods each have an optional data parameter which, if not null, will be used and returned. This parameter should be used to avoid unnecessary object churn whenever possible. Additionally, calling a conversion method on a CarSensorEvent object with an inappropriate type will result in an UnsupportedOperationException being thrown.

Summary

Nested classes

class CarSensorEvent.EnvironmentData

 

Constants

int GEAR_DRIVE

This is for transmission without specific gear number for moving forward like CVT.

int GEAR_EIGHTH

Gear number 8.

int GEAR_FIFTH

Gear number 5.

int GEAR_FIRST

intValues[0] from 1 to 99 represents transmission gear number for moving forward.

int GEAR_FOURTH

Gear number 4.

int GEAR_NEUTRAL

GEAR_* represents meaning of intValues[0] for CarSensorManager.SENSOR_TYPE_GEAR sensor type.

int GEAR_NINTH

Gear number 9.

int GEAR_PARK

Gear in parking state

int GEAR_REVERSE

Gear in reverse

int GEAR_SECOND

Gear number 2.

int GEAR_SEVENTH

Gear number 7.

int GEAR_SIXTH

Gear number 6.

int GEAR_TENTH

Gear number 10.

int GEAR_THIRD

Gear number 3.

int IGNITION_STATE_ACC

Accessory is turned off, but engine is not running yet (for EV car is not ready to move).

int IGNITION_STATE_LOCK

Steering wheel is locked.

int IGNITION_STATE_OFF

Typically engine is off, but steering wheel is unlocked.

int IGNITION_STATE_ON

In this state engine typically is running (for EV, car is ready to move).

int IGNITION_STATE_START

In this state engine is typically starting (cranking).

int IGNITION_STATE_UNDEFINED

Ignition state is unknown.

int INDEX_ENVIRONMENT_TEMPERATURE

Index for CarSensorManager.SENSOR_TYPE_ENV_OUTSIDE_TEMPERATURE in floatValues.

int INDEX_WHEEL_DISTANCE_FRONT_LEFT

int INDEX_WHEEL_DISTANCE_FRONT_RIGHT

int INDEX_WHEEL_DISTANCE_REAR_LEFT

int INDEX_WHEEL_DISTANCE_REAR_RIGHT

int INDEX_WHEEL_DISTANCE_RESET_COUNT

Index for CarSensorManager.SENSOR_TYPE_WHEEL_TICK_DISTANCE in longValues.

Inherited constants

Fields

public static final Creator<CarSensorEvent> CREATOR

public final float[] floatValues

array holding float type of sensor data.

public final int[] intValues

array holding int type of sensor data

public final long[] longValues

array holding long int type of sensor data

public int sensorType

Sensor type for this event like CarSensorManager.SENSOR_TYPE_CAR_SPEED.

public long timestamp

When this data was received from car.

Public methods

int describeContents()
void writeToParcel(Parcel dest, int flags)

Inherited methods

Constants

GEAR_DRIVE

public static final int GEAR_DRIVE

This is for transmission without specific gear number for moving forward like CVT. It tells that car is in a transmission state to move it forward.

Constant Value: 8 (0x00000008)

GEAR_EIGHTH

public static final int GEAR_EIGHTH

Gear number 8.

Constant Value: 2048 (0x00000800)

GEAR_FIFTH

public static final int GEAR_FIFTH

Gear number 5.

Constant Value: 256 (0x00000100)

GEAR_FIRST

public static final int GEAR_FIRST

intValues[0] from 1 to 99 represents transmission gear number for moving forward. GEAR_FIRST is for gear number 1.

Constant Value: 16 (0x00000010)

GEAR_FOURTH

public static final int GEAR_FOURTH

Gear number 4.

Constant Value: 128 (0x00000080)

GEAR_NEUTRAL

public static final int GEAR_NEUTRAL

GEAR_* represents meaning of intValues[0] for CarSensorManager.SENSOR_TYPE_GEAR sensor type. GEAR_NEUTRAL means transmission gear is in neutral state, and the car may be moving.

Constant Value: 1 (0x00000001)

GEAR_NINTH

public static final int GEAR_NINTH

Gear number 9.

Constant Value: 4096 (0x00001000)

GEAR_PARK

public static final int GEAR_PARK

Gear in parking state

Constant Value: 4 (0x00000004)

GEAR_REVERSE

public static final int GEAR_REVERSE

Gear in reverse

Constant Value: 2 (0x00000002)

GEAR_SECOND

public static final int GEAR_SECOND

Gear number 2.

Constant Value: 32 (0x00000020)

GEAR_SEVENTH

public static final int GEAR_SEVENTH

Gear number 7.

Constant Value: 1024 (0x00000400)

GEAR_SIXTH

public static final int GEAR_SIXTH

Gear number 6.

Constant Value: 512 (0x00000200)

GEAR_TENTH

public static final int GEAR_TENTH

Gear number 10.

Constant Value: 8192 (0x00002000)

GEAR_THIRD

public static final int GEAR_THIRD

Gear number 3.

Constant Value: 64 (0x00000040)

IGNITION_STATE_ACC

public static final int IGNITION_STATE_ACC

Accessory is turned off, but engine is not running yet (for EV car is not ready to move).

Constant Value: 3 (0x00000003)

IGNITION_STATE_LOCK

public static final int IGNITION_STATE_LOCK

Steering wheel is locked.

Constant Value: 1 (0x00000001)

IGNITION_STATE_OFF

public static final int IGNITION_STATE_OFF

Typically engine is off, but steering wheel is unlocked.

Constant Value: 2 (0x00000002)

IGNITION_STATE_ON

public static final int IGNITION_STATE_ON

In this state engine typically is running (for EV, car is ready to move).

Constant Value: 4 (0x00000004)

IGNITION_STATE_START

public static final int IGNITION_STATE_START

In this state engine is typically starting (cranking).

Constant Value: 5 (0x00000005)

IGNITION_STATE_UNDEFINED

public static final int IGNITION_STATE_UNDEFINED

Ignition state is unknown. The constants that starts with IGNITION_STATE_ represent values for CarSensorManager.SENSOR_TYPE_IGNITION_STATE sensor.

Constant Value: 0 (0x00000000)

INDEX_ENVIRONMENT_TEMPERATURE

public static final int INDEX_ENVIRONMENT_TEMPERATURE

Index for CarSensorManager.SENSOR_TYPE_ENV_OUTSIDE_TEMPERATURE in floatValues. Temperature in Celsius degrees.

Constant Value: 0 (0x00000000)

INDEX_WHEEL_DISTANCE_FRONT_LEFT

public static final int INDEX_WHEEL_DISTANCE_FRONT_LEFT

Constant Value: 1 (0x00000001)

INDEX_WHEEL_DISTANCE_FRONT_RIGHT

public static final int INDEX_WHEEL_DISTANCE_FRONT_RIGHT

Constant Value: 2 (0x00000002)

INDEX_WHEEL_DISTANCE_REAR_LEFT

public static final int INDEX_WHEEL_DISTANCE_REAR_LEFT

Constant Value: 4 (0x00000004)

INDEX_WHEEL_DISTANCE_REAR_RIGHT

public static final int INDEX_WHEEL_DISTANCE_REAR_RIGHT

Constant Value: 3 (0x00000003)

INDEX_WHEEL_DISTANCE_RESET_COUNT

public static final int INDEX_WHEEL_DISTANCE_RESET_COUNT

Index for CarSensorManager.SENSOR_TYPE_WHEEL_TICK_DISTANCE in longValues. RESET_COUNT is incremented whenever the HAL detects that a sensor reset has occurred. It represents to the upper layer that the WHEEL_DISTANCE values will not be contiguous with other values reported with a different RESET_COUNT.

Constant Value: 0 (0x00000000)

Fields

CREATOR

public static final Creator<CarSensorEvent> CREATOR

floatValues

public final float[] floatValues

array holding float type of sensor data. If the sensor has single value, only floatValues[0] should be used.

intValues

public final int[] intValues

array holding int type of sensor data

longValues

public final long[] longValues

array holding long int type of sensor data

sensorType

public int sensorType

Sensor type for this event like CarSensorManager.SENSOR_TYPE_CAR_SPEED.

timestamp

public long timestamp

When this data was received from car. It is elapsed real-time of data reception from car in nanoseconds since system boot.

Public methods

describeContents

public int describeContents ()

Returns
int

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Parameters
dest Parcel

flags int