From f629672e636231e9432c73fde8f7fd3a5bb2b5c9 Mon Sep 17 00:00:00 2001 From: "Christopher N. Hesse" Date: Mon, 16 Jan 2017 22:47:11 +0100 Subject: [PATCH] power: Remove outdated comments Always redirect to power.h for updated documentation. Change-Id: I066f3b6f83483bdf3a0db315c1381c670df47b12 --- power/power.c | 70 +++++---------------------------------------------- 1 file changed, 6 insertions(+), 64 deletions(-) diff --git a/power/power.c b/power/power.c index 6a24a8eb..09a36d8c 100644 --- a/power/power.c +++ b/power/power.c @@ -292,11 +292,6 @@ static void init_touch_input_power_path(struct samsung_power_module *samsung_pwr } } -/* - * The init function performs power management setup actions at runtime - * startup, such as to set default cpufreq parameters. This is called only by - * the Power HAL instance loaded by PowerManagerService. - */ static void samsung_power_init(struct power_module *module) { struct samsung_power_module *samsung_pwr = (struct samsung_power_module *) module; @@ -305,29 +300,12 @@ static void samsung_power_init(struct power_module *module) init_touch_input_power_path(samsung_pwr); } -/* - * The setInteractive function 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 is usually 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. - * - * on is non-zero when the system is transitioning to an interactive / awake - * state, and zero when transitioning to a non-interactive / asleep state. - * - * This function is 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. - */ +/********************************************************** + *** API FUNCTIONS + *** + *** Refer to power.h for documentation. + **********************************************************/ + static void samsung_power_set_interactive(struct power_module *module, int on) { struct samsung_power_module *samsung_pwr = (struct samsung_power_module *) module; @@ -379,42 +357,6 @@ out: ALOGV("power_set_interactive: %d done\n", on); } -/* - * The powerHint function is called to pass hints on power requirements, which - * may result in adjustment of power/performance parameters of the cpufreq - * governor and other controls. - * - * The possible hints are: - * - * POWER_HINT_VSYNC - * - * Foreground app has started or stopped requesting a VSYNC pulse - * from SurfaceFlinger. If the app has started requesting VSYNC - * then CPU and GPU load is expected soon, and it may be appropriate - * to raise speeds of CPU, memory bus, etc. The data parameter is - * non-zero to indicate VSYNC pulse is now requested, or zero for - * VSYNC pulse no longer requested. - * - * POWER_HINT_INTERACTION - * - * User is interacting with the device, for example, touchscreen - * events are incoming. CPU and GPU load may be expected soon, - * and it may be appropriate to raise speeds of CPU, memory bus, - * etc. The data parameter is unused. - * - * POWER_HINT_LOW_POWER - * - * Low power mode is activated or deactivated. Low power mode - * is intended to save battery at the cost of performance. The data - * parameter is non-zero when low power mode is activated, and zero - * when deactivated. - * - * POWER_HINT_CPU_BOOST - * - * An operation is happening where it would be ideal for the CPU to - * be boosted for a specific duration. The data parameter is an - * integer value of the boost duration in microseconds. - */ static void samsung_power_hint(struct power_module *module, power_hint_t hint, void *data)