Skip to content
Vehicle properties
ADAS & driver assistance

DRIVER_DROWSINESS_ATTENTION_SYSTEM_ENABLED

What it is

Enable or disable driver drowsiness and attention monitoring.

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 should be monitoring the drowsiness and attention level of the driver and warn the driver if needed.

In general, DRIVER_DROWSINESS_ATTENTION_SYSTEM_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_STATE 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 0x11201019 apart:

FieldMaskValueMeans
Group0xf00000000x10000000SYSTEM
Area0x0f0000000x01000000GLOBAL
Type0x00ff00000x00200000BOOLEAN
Ordinal0x0000ffff0x000010190x1019

Reading it from an app

CarPropertyManager mgr = (CarPropertyManager)
        car.getCarManager(Car.PROPERTY_SERVICE);

boolean value =
        mgr.getBooleanProperty(VehiclePropertyIds.DRIVER_DROWSINESS_ATTENTION_SYSTEM_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.