Package: android.hardware.power@1.0

IPower

interface IPower

Constructor for the interface performs power management setup actions at runtime startup, such as to set default cpufreq parameters.

Methods

setInteractive

setInteractive (bool interactive)

setInteractive() performs power management actions upon the system entering interactive state(that is, the system is awake and ready for interaction, often with UI devices such as display and touchscreen enabled)or non-interactive state(the system appears asleep, display usually turned off). The non-interactive state may be entered after a period of inactivity in order to conserve battery power during such inactive periods.

Typical actions are to turn on or off devices and adjust cpufreq parameters.This function may also call the appropriate interfaces to allow the kernel to suspend the system to low-power sleep state when entering non-interactive state, and to disallow low-power suspend when the system is in interactive state.When low-power suspend state is allowed, the kernel may suspend the system whenever no wakelocks are held.

For example, This function can be called to enter non-interactive state after turning off the screen(if present)and called to enter interactive state prior to turning on the screen.

Details
Parameters
interactive
is true when the system is transitioning to an interactive state and false when transitioning to a non-interactive state.

powerHint

powerHint (PowerHint hint, int32_t data)

powerHint() is called to pass hints on power requirements which may result in adjustment of power/performance parameters of the cpufreq governor and other controls.

A particular platform may choose to ignore any hint.

Details
Parameters
hint
PowerHint which is passed
data
contains additional information about the hint and is described along with the comments for each of the hints.

setFeature

setFeature (Feature feature, bool activate)

setFeature() is called to turn on or off a particular feature depending on the state parameter.

Details
Parameters
feature
Feature which needs to be set
activate
true/false to enable/disable the feature

getPlatformLowPowerStats

getPlatformLowPowerStats ()
generates (vec<PowerStatePlatformSleepState> states, Status retval)

Platform-level sleep state stats:Report cumulative info on the statistics on platform-level sleep states since boot.

Higher the index in the returned<states>vector deeper the state is i.e.lesser steady-state power is consumed by the platform to be resident in that state.

Details
Generates
states
of power states the device supports
retval
SUCCESS on success or FILESYSTEM_ERROR on filesystem nodes access error.