diff options
Diffstat (limited to 'core/java/android/os/Power.java')
-rw-r--r-- | core/java/android/os/Power.java | 130 |
1 files changed, 130 insertions, 0 deletions
diff --git a/core/java/android/os/Power.java b/core/java/android/os/Power.java new file mode 100644 index 0000000..b53e227 --- /dev/null +++ b/core/java/android/os/Power.java @@ -0,0 +1,130 @@ +/* + * Copyright (C) 2007 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package android.os; + +import java.io.IOException; + +/** + * Class that provides access to some of the power management functions. + * + * {@hide} + */ +public class Power +{ + // can't instantiate this class + private Power() + { + } + + /** + * Wake lock that ensures that the CPU is running. The screen might + * not be on. + */ + public static final int PARTIAL_WAKE_LOCK = 1; + + /** + * Wake lock that ensures that the screen is on. + */ + public static final int FULL_WAKE_LOCK = 2; + + public static native void acquireWakeLock(int lock, String id); + public static native void releaseWakeLock(String id); + + /** + * Flag to turn on and off the keyboard light. + */ + public static final int KEYBOARD_LIGHT = 0x00000001; + + /** + * Flag to turn on and off the screen backlight. + */ + public static final int SCREEN_LIGHT = 0x00000002; + + /** + * Flag to turn on and off the button backlight. + */ + public static final int BUTTON_LIGHT = 0x00000004; + + /** + * Flags to turn on and off all the backlights. + */ + public static final int ALL_LIGHTS = (KEYBOARD_LIGHT|SCREEN_LIGHT|BUTTON_LIGHT); + + /** + * Brightness value for fully off + */ + public static final int BRIGHTNESS_OFF = 0; + + /** + * Brightness value for dim backlight + */ + public static final int BRIGHTNESS_DIM = 20; + + /** + * Brightness value for fully on + */ + public static final int BRIGHTNESS_ON = 255; + + /** + * Brightness value to use when battery is low + */ + public static final int BRIGHTNESS_LOW_BATTERY = 10; + + /** + * Threshold for BRIGHTNESS_LOW_BATTERY (percentage) + * Screen will stay dim if battery level is <= LOW_BATTERY_THRESHOLD + */ + public static final int LOW_BATTERY_THRESHOLD = 10; + + /** + * Set the brightness for one or more lights + * + * @param mask flags indicating which lights to change brightness + * @param brightness new brightness value (0 = off, 255 = fully bright) + */ + public static native int setLightBrightness(int mask, int brightness); + + /** + * Turn the screen on or off + * + * @param on Whether you want the screen on or off + */ + public static native int setScreenState(boolean on); + + public static native int setLastUserActivityTimeout(long ms); + + /** + * Turn the device off. + * + * This method is considered deprecated in favor of + * {@link android.policy.ShutdownThread.shutdownAfterDisablingRadio()}. + * + * @deprecated + * @hide + */ + @Deprecated + public static native void shutdown(); + + /** + * Reboot the device. + * @param reason code to pass to the kernel (e.g. "recovery"), or null. + * + * @throws IOException if reboot fails for some reason (eg, lack of + * permission) + */ + public static native void reboot(String reason) throws IOException; +} |