DRIVER_DROWSINESS_ATTENTION_WARNING_ENABLED
What it is
Enable or disable driver drowsiness and attention warnings.
Set true to enable driver drowsiness and attention warnings and false to disable driver drowsiness and attention warnings.
When driver drowsiness and attention warnings are enabled, the driver drowsiness and attention monitoring system inside the vehicle should warn the driver when it detects the driver is drowsy or not attentive.
In general, DRIVER_DROWSINESS_ATTENTION_WARNING_ENABLED should always return true or false. If the feature is not available due to some temporary state, that information must be conveyed through the ErrorState values in the DRIVER_DROWSINESS_ATTENTION_WARNING property.
This property is defined as VehiclePropertyAccess.READ_WRITE, but OEMs have the option to implement it as VehiclePropertyAccess.READ only.
How the ID is built
A property ID is a 32-bit value packing four fields. Reading 0x1120101b apart:
| Field | Mask | Value | Means |
|---|---|---|---|
| Group | 0xf0000000 | 0x10000000 | SYSTEM |
| Area | 0x0f000000 | 0x01000000 | GLOBAL |
| Type | 0x00ff0000 | 0x00200000 | BOOLEAN |
| Ordinal | 0x0000ffff | 0x0000101b | 0x101b |
Reading it from an app
CarPropertyManager mgr = (CarPropertyManager)
car.getCarManager(Car.PROPERTY_SERVICE);
boolean value =
mgr.getBooleanProperty(VehiclePropertyIds.DRIVER_DROWSINESS_ATTENTION_WARNING_ENABLED, 0);This property can be read and written, though an OEM may implement it as read-only. It fires a callback whenever the value changes.