Vehicle properties
Fuel & energy
FUEL_LEVEL
What it is
Fuel level in milliliters
This property must communicate the current amount of fuel remaining in the vehicle in milliliters. This property does not apply to electric vehicles. That is, if INFO_FUEL_TYPE only contains FuelType::FUEL_TYPE_ELECTRIC, this property must not be implemented. For EVs, implement EV_BATTERY_LEVEL.
Value may not exceed INFO_FUEL_CAPACITY.
How the ID is built
A property ID is a 32-bit value packing four fields. Reading 0x11600307 apart:
| Field | Mask | Value | Means |
|---|---|---|---|
| Group | 0xf0000000 | 0x10000000 | SYSTEM |
| Area | 0x0f000000 | 0x01000000 | GLOBAL |
| Type | 0x00ff0000 | 0x00600000 | FLOAT |
| Ordinal | 0x0000ffff | 0x00000307 | 0x307 |
Reading it from an app
CarPropertyManager mgr = (CarPropertyManager)
car.getCarManager(Car.PROPERTY_SERVICE);
mgr.registerCallback(callback,
VehiclePropertyIds.FUEL_LEVEL,
CarPropertyManager.SENSOR_RATE_ONCHANGE);This property is read-only — writes are rejected. It changes continuously, so subscribe at a sample rate rather than polling.