Android手机的亮灯逻辑由三层结构:
1. framework层控制行为逻辑
2. hardware提供HAL接口
3. 驱动层负责亮灯。
首先在/framework/base/core/res/res/values/config.xml中定义了灯的颜色和亮灯阈值
- <!-- Display low battery warning when battery level dips to this value -->
- 1144 <integer name="config_lowBatteryWarningLevel">20</integer>
- 1145
- 1146 <!-- The default suggested battery % at which we enable battery saver automatically. -->
- 1147 <integer name="config_lowBatteryAutoTriggerDefaultLevel">15</integer>
- 1148
- 1149 <!-- Close low battery warning when battery level reaches the lowBatteryWarningLevel
- 1150 plus this -->
- 1151 <integer name="config_lowBatteryCloseWarningBump">5</integer>
- notification LED. -->
- 1154 <color name="config_defaultNotificationColor">#ffffffff</color>
- 1155
- 1156 <!-- Default LED on time for notification LED in milliseconds. -->
- 1157 <integer name="config_defaultNotificationLedOn">500</integer>
- 1158
- 1159 <!-- Default LED off time for notification LED in milliseconds. -->
- 1160 <integer name="config_defaultNotificationLedOff">2000</integer>
- 1161
- 1162 <!-- Default value for led color when battery is low on charge -->
- 1163 <integer name="config_notificationsBatteryLowARGB">0xFFFF0000</integer>
- 1164
- 1165 <!-- Default value for led color when battery is medium charged -->
- 1166 <integer name="config_notificationsBatteryMediumARGB">0xFF0000FF</integer>
- 1167
- 1168 <!-- Default value for led color when battery is fully charged -->
- 1169 <integer name="config_notificationsBatteryFullARGB">0xFF00FF00</integer>
- 1170
诸如电量15%显示一种灯,电量为FULL时显示一种;而颜色为0xFFFF0000; 其中最高两位的FF表示灯的通透性(景深),而接下来的6位,2位为一种颜色,分别为RGB,RED,GREEN,BLUE;因此0xFFFF0000红色,0xFFFFFF00(橙色,红绿), 0xFF00FF00(绿), 0xFF0000FF(蓝);
这些值在/framework/base/services/core/java/com/android/server/BatteryService.java中被解析,进而进行判断行为
- public void updateLightsLocked() {
- final int level = mHealthInfo.batteryLevel;
- final int status = mHealthInfo.batteryStatus;
- if (level < mLowBatteryWarningLevel) {
- if (status == BatteryManager.BATTERY_STATUS_CHARGING) {
- // Solid red when battery is charging
- mBatteryLight.setColor(mBatteryLowARGB);
- } else {
- // Flash red when battery is low and not charging
- mBatteryLight.setFlashing(mBatteryLowARGB, Light.LIGHT_FLASH_TIMED,
- mBatteryLedOn, mBatteryLedOff);
- }
- } else if (status == BatteryManager.BATTERY_STATUS_CHARGING
- || status == BatteryManager.BATTERY_STATUS_FULL) {
- if (status == BatteryManager.BATTERY_STATUS_FULL || level >= 90) {
- // Solid green when full or charging and nearly full
- mBatteryLight.setColor(mBatteryFullARGB);
- } else {
- // Solid orange when charging and halfway full
- mBatteryLight.setColor(mBatteryMediumARGB);
- }
- } else {
- // No lights if not charging and not low
- mBatteryLight.turnOff();
- }
- }
这段逻辑就是控制底层亮灯行为;大家可以仔细看一下有没有问题,在status为CHARGING或者FULL的时候亮灯。这是一个或逻辑!也就是说或在充电,或满,就显示红灯(惯例),那么有没有可能是FULL而不是CHARGING呢?又或者既不是CHARGING也不是FULL的时候按照这里的逻辑是灭灯,但是手机还连着USB线呢? 这里就涉及到了充电相关的知识。
电量低的时候,不在充电则闪烁,充电则常亮; 而充电时亮两种灯,充满与不充满; 那么你一定会问,可以有不在充电但是满的情况吗? 有的;但是,FULL的时候一定是连接着充电器的,所以一定会亮灯。而不连接充电器的时候也是满的怎么办?不连接充电器的时候一定不是FULL,而是DIS_CHARGING,放电状态,所以关灯。还有一种情况,连接着充电器,又不满 FULL,又不在充电CHARGING,也就是所谓的NOT_CHARGING状态。这种状态亮不亮灯呢? 按照这个逻辑一定是关灯的。NOT_CHARGING在高通平台上通过/sys/class/power_supply/battery/battery_charging_enabled这个节点来实现。也就是插着USB线只做调试不做充电,实测与逻辑一致,是灭灯的。该节点后来移动其他地方去了,又后来隐藏了。
接下来我们看hardware中的接口hardware/qcom/display/liblight/lights.c中定义了各种接口,比如很重要的呼吸灯接口handle_speaker_battery_locked()
如果在充电,又有消息来,那么我们通常的逻辑就是消息优先显示,而充电作为第二优先级;则这里就需要改动,调换g_battery与g_notification的顺序。
- static void
- handle_speaker_battery_locked(struct light_device_t* dev)
- {
- if (is_lit(&g_battery)) {
- set_speaker_light_locked(dev, &g_battery);
- } else {
- set_speaker_light_locked(dev, &g_notification);
- }
- }
这个文件下,通过写sysfs节点的方式与驱动层进行数据交流:
/sys/class/leds/%s/delay_off
通过设置常亮,或者亮灭的时间间隔达到呼吸灯的效果。
再往下就是驱动层的事情了。
由此,我们就清楚了android亮灯的逻辑。