| /* |
| * Copyright (C) 2008 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 android.os.BatteryProperty; |
| import android.os.IBatteryPropertiesRegistrar; |
| import android.os.RemoteException; |
| import android.os.ServiceManager; |
| |
| /** |
| * The BatteryManager class contains strings and constants used for values |
| * in the {@link android.content.Intent#ACTION_BATTERY_CHANGED} Intent, and |
| * provides a method for querying battery and charging properties. |
| */ |
| public class BatteryManager { |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer containing the current status constant. |
| */ |
| public static final String EXTRA_STATUS = "status"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer containing the current health constant. |
| */ |
| public static final String EXTRA_HEALTH = "health"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * boolean indicating whether a battery is present. |
| */ |
| public static final String EXTRA_PRESENT = "present"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer field containing the current battery level, from 0 to |
| * {@link #EXTRA_SCALE}. |
| */ |
| public static final String EXTRA_LEVEL = "level"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer containing the maximum battery level. |
| */ |
| public static final String EXTRA_SCALE = "scale"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer containing the resource ID of a small status bar icon |
| * indicating the current battery state. |
| */ |
| public static final String EXTRA_ICON_SMALL = "icon-small"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer indicating whether the device is plugged in to a power |
| * source; 0 means it is on battery, other constants are different |
| * types of power sources. |
| */ |
| public static final String EXTRA_PLUGGED = "plugged"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer containing the current battery voltage level. |
| */ |
| public static final String EXTRA_VOLTAGE = "voltage"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * integer containing the current battery temperature. |
| */ |
| public static final String EXTRA_TEMPERATURE = "temperature"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * String describing the technology of the current battery. |
| */ |
| public static final String EXTRA_TECHNOLOGY = "technology"; |
| |
| /** |
| * Extra for {@link android.content.Intent#ACTION_BATTERY_CHANGED}: |
| * Int value set to nonzero if an unsupported charger is attached |
| * to the device. |
| * {@hide} |
| */ |
| public static final String EXTRA_INVALID_CHARGER = "invalid_charger"; |
| |
| // values for "status" field in the ACTION_BATTERY_CHANGED Intent |
| public static final int BATTERY_STATUS_UNKNOWN = 1; |
| public static final int BATTERY_STATUS_CHARGING = 2; |
| public static final int BATTERY_STATUS_DISCHARGING = 3; |
| public static final int BATTERY_STATUS_NOT_CHARGING = 4; |
| public static final int BATTERY_STATUS_FULL = 5; |
| |
| // values for "health" field in the ACTION_BATTERY_CHANGED Intent |
| public static final int BATTERY_HEALTH_UNKNOWN = 1; |
| public static final int BATTERY_HEALTH_GOOD = 2; |
| public static final int BATTERY_HEALTH_OVERHEAT = 3; |
| public static final int BATTERY_HEALTH_DEAD = 4; |
| public static final int BATTERY_HEALTH_OVER_VOLTAGE = 5; |
| public static final int BATTERY_HEALTH_UNSPECIFIED_FAILURE = 6; |
| public static final int BATTERY_HEALTH_COLD = 7; |
| |
| // values of the "plugged" field in the ACTION_BATTERY_CHANGED intent. |
| // These must be powers of 2. |
| /** Power source is an AC charger. */ |
| public static final int BATTERY_PLUGGED_AC = 1; |
| /** Power source is a USB port. */ |
| public static final int BATTERY_PLUGGED_USB = 2; |
| /** Power source is wireless. */ |
| public static final int BATTERY_PLUGGED_WIRELESS = 4; |
| |
| /** @hide */ |
| public static final int BATTERY_PLUGGED_ANY = |
| BATTERY_PLUGGED_AC | BATTERY_PLUGGED_USB | BATTERY_PLUGGED_WIRELESS; |
| |
| private IBatteryPropertiesRegistrar mBatteryPropertiesRegistrar; |
| |
| /** |
| * Return the requested battery property. |
| * |
| * @param id identifier from {@link BatteryProperty} of the requested property |
| * @return a {@link BatteryProperty} object that returns the property value, or null on error |
| */ |
| public BatteryProperty getProperty(int id) throws RemoteException { |
| if (mBatteryPropertiesRegistrar == null) { |
| IBinder b = ServiceManager.getService("batteryproperties"); |
| mBatteryPropertiesRegistrar = |
| IBatteryPropertiesRegistrar.Stub.asInterface(b); |
| |
| if (mBatteryPropertiesRegistrar == null) |
| return null; |
| } |
| |
| BatteryProperty prop = new BatteryProperty(); |
| if ((mBatteryPropertiesRegistrar.getProperty(id, prop) == 0) && |
| (prop.getLong() != Long.MIN_VALUE)) |
| return prop; |
| else |
| return null; |
| } |
| } |