Google Git
Sign in
android / platform / docs / source.android.com / 90dd9129329995537d4097cdd3263e9982997578 / . / en / devices / tech / power / batterystats.html
blob: 9a56d25048ceb9900f74f3716d6db7ba128dd6d8 [file] [log] [blame]
page.title=Viewing Battery Use Data
@jd:body
<!--
Copyright 2015 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.
-->
<div id="qv-wrapper">
<div id="qv">
<h2>In this document</h2>
<ol id="auto-toc">
</ol>
</div>
</div>
<p>The <code>dumpsys batterystats</code> command generates interesting
statistical data about battery usage on a device, organized by unique user
ID (UID). The statistics include the following:</p>
<ul>
<li>History of battery-related events</li>
<li>Global statistics for the device</li>
<li>Approximate power use per UID and system component</li>
<li>Per-app mobile milliseconds per packet</li>
<li>System UID aggregated statistics</li>
<li>App UID aggregated statistics</li>
</ul>
<p>Use the <a href="https://github.com/google/battery-historian">Battery
Historian</a> tool on the output of the dumpsys command to generate an HTML
visualization of power-related events from the logs. This information makes it
easier to understand and diagnose battery-related issues.</p>
<h2 id="command-line_options">Command input</h2>
<p>The basic <code>batterystats</code> command is:</p>
<pre class="prettyprint">
$ adb shell dumpsys batterystats</pre>
<p>Supported options:</p>
<ul>
<li><code>--help</code> displays additional options for tailoring the output.
</li>
<li><code>--checkin</code> exports results in machine-readable csv format.
</li>
</ul>
<p>For example, to print battery usage statistics in csv format for all apps
since the device was last charged, run the command:</p>
<pre class="prettyprint">
$ adb shell dumpsys batterystats --charged --checkin</pre>
<p>You can also specify a package name to get statistics for a single app. For
example, to print battery usage statistics for a given app package
since the device was last charged, run the command:</p>
<pre class="prettyprint">
$ adb shell dumpsys batterystats --charged &lt;package-name&gt;</pre>
<h2 id="output">Command output</h2>
<p>The <code>batterystats</code> command generates aggregated observations
about battery use on the device since it was last charged. Observations may be
per-UID or system-level; data is selected for inclusion based on its
usefulness in analyzing battery performance. Output includes one (1) entry
per observation, and each entry consists of a comma-separated list of values
in the format:
<em>int</em>,<em>uid</em>,<em>mode</em>,<em>section</em>,<em>fields</em>
(one or more).</p>
<p>The first four values correspond to the following:</p>
<ul>
<li>Dummy integer</li>
<li>UID</li>
<li>Aggregation mode
<ul>
<li>"i" for information not tied to charged/uncharged status.</li>
<li>"l" for --charged (usage since last charge).</li>
<li>"u" for --unplugged (usage since last unplugged). Deprecated in
Android 5.1.1.</li>
</ul>
</li>
<li><a href="#interpreting_the_output">Section identifier</a>, which
determines how to interpret subsequent values in the line.</li>
</ul>
<p>Sample output:</p>
<pre class="no-pretty-print">
9,0,i,vers,11,116,K,L 9,0,i,uid,1000,android
9,0,i,uid,1000,com.android.providers.settings
9,0,i,uid,1000,com.android.inputdevices
9,0,i,uid,1000,com.android.server.telecom
9,0,i,uid,1000,com.android.keychain 9,0,i,uid,1000,com.android.settings
9,0,i,uid,1000,com.android.location.fused
9,0,i,uid,1001,com.android.providers.telephony
9,0,i,uid,1001,com.android.mms.service 9,0,i,uid,1001,com.android.stk
9,0,i,uid,1001,com.android.phone 9,0,i,uid,1027,com.android.nfc
9,0,i,uid,2000,com.android.shell
9,0,i,uid,10002,com.android.providers.calendar
9,0,i,uid,10003,com.android.cellbroadcastreceiver
9,0,i,uid,10004,com.android.providers.userdictionary
9,0,i,uid,10004,com.android.providers.contacts
9,0,i,uid,10005,com.google.android.apps.enterprise.dmagent
9,0,i,uid,10006,com.android.defcontainer
9,0,i,uid,10007,com.android.providers.media
9,0,i,uid,10007,com.android.providers.downloads
9,0,i,uid,10007,com.android.providers.downloads.ui
9,0,i,uid,10008,com.android.externalstorage
9,0,i,uid,10009,com.google.android.syncadapters.contacts
9,0,i,uid,10009,com.google.android.gms
9,0,i,uid,10009,com.google.android.gsf
9,0,i,uid,10009,com.google.android.gsf.login
9,0,i,uid,10009,com.google.android.backuptransport
9,0,i,uid,10011,com.google.android.dialer
9,0,i,uid,10013,com.google.android.onetimeinitializer
9,0,i,uid,10014,com.google.android.partnersetup
9,0,i,uid,10015,com.android.launcher
9,0,i,uid,10016,com.android.managedprovisioning
9,0,i,uid,10017,com.android.mms 9,0,i,uid,10018,com.android.musicfx
9,0,i,uid,10019,com.android.vending
9,0,i,uid,10022,com.android.sharedstoragebackup
9,0,i,uid,10023,com.android.systemui
9,0,i,uid,10025,com.google.android.googlequicksearchbox
9,0,i,uid,10027,com.google.android.apps.walletnfcrel
9,0,i,uid,10029,com.google.android.marvin.talkback
9,0,i,uid,10031,com.google.android.apps.books
9,0,i,uid,10034,com.google.android.calendar
9,0,i,uid,10037,com.android.chrome
9,0,i,uid,10039,com.google.android.configupdater
9,0,i,uid,10040,com.google.android.deskclock
9,0,i,uid,10041,com.android.documentsui
9,0,i,uid,10042,com.google.android.apps.docs
9,0,i,uid,10047,com.google.android.ears
9,0,i,uid,10054,com.google.android.talk
9,0,i,uid,10057,com.google.android.inputmethod.latin
9,0,i,uid,10061,com.google.android.music
9,0,i,uid,10064,com.android.packageinstaller
9,0,i,uid,10068,com.google.android.apps.plus
9,0,i,uid,10069,com.google.android.gm
9,0,i,uid,10070,com.google.android.keep
9,0,i,uid,10071,com.google.android.apps.genie.geniewidget
9,0,i,uid,10072,com.android.printspooler
9,0,i,uid,10076,com.google.android.videos
9,0,i,uid,10079,com.google.android.youtube
9,0,i,uid,10084,com.google.android.apps.magazines
9,0,i,dsd,1820451,97,s-,p- 9,0,i,dsd,3517481,98,s-,p-
9,0,l,bt,0,8548446,1000983,8566645,1019182,1418672206045,8541652,994188
9,0,l,gn,0,0,666932,495312,0,0,2104,1444
9,0,l,m,6794,0,8548446,8548446,0,0,0,666932,495312,0,697728,0,0,0,5797,0,0
9,0,l,br,9,0,6785,0,0 9,0,l,sgt,8548446,0,0,0,0 9,0,l,sst,9000
9,0,l,sgc,0,0,0,0,0 9,0,l,dct,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0
9,0,l,dcc,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0 9,0,l,wst,0,0,0,0,0,0,0,0
9,0,l,wsc,0,0,0,0,0,0,0,0 9,0,l,wsst,0,0,0,0,0,0,0,52,0,0,8548394,0,0
9,0,l,wssc,0,0,0,0,0,0,0,2,0,0,2,0,0 9,0,l,wsgt,0,0,0,3016,8545430
9,0,l,wsgc,0,0,0,2,1 9,0,l,bst,0,0,0,0 9,0,l,bsc,0,0,0,0 9,0,l,dc,2,3,0,3
9,0,l,kwl,msm_ipc_read00000001:00000001,0,0
9,0,l,kwl,rpm_regulator_tcxo,0,0 9,0,l,kwl,wlan,25423,32
9,0,l,kwl,event4-648,0,0 9,0,l,kwl,qcril,187,2 9,0,l,kwl,ssr(dsps),0,0
9,0,l,kwl,bq51051b_wireless_chip,0,0 9,0,l,kwl,qmi0,0,0
9,0,l,kwl,event5-648,7755,1231
9,0,l,kwl,PowerManagerService.WakeLocks,680435,3908
9,0,l,kwl,msm_hsic_host,66258,35 9,0,l,kwl,qcom_sap_wakelock,0,0
9,0,l,kwl,sns_async_ev_wakelock,91954,1244 9,0,l,kwl,qmuxd_port_wl_12,0,0
9,0,l,kwl,pil-wcnss,0,0 9,0,l,kwl,event0-648,11364,1212
9,0,l,kwl,dofstrim,0,0 9,0,l,kwl,ssr(lpass),0,0
9,0,l,kwl,qmuxd_port_wl_11,0,0 9,0,l,kwl,event2-648,0,0
9,0,l,kwl,pil-vidc,0,0 9,0,l,kwl,mmc0,0,0
9,0,l,kwl,tabla_gpio_irq_resend,0,0 9,0,l,kwl,pil-q6,0,0
9,0,l,kwl,radio-interface,0,0 9,0,l,kwl,msm_ipc_read00000001:00000002,0,0
9,0,l,kwl,event3-648,8143,1231 9,0,l,kwl,ssr(wcnss),0,0
9,0,l,kwl,ssr(gss),0,0 9,0,l,kwl,KeyEvents,98,1263
9,0,l,kwl,unknown_wakeups,0,0 9,0,l,kwl,qmuxd_port_wl_10,0,0
9,0,l,kwl,pil-gss,0,0 9,0,l,kwl,qcom_rx_wakelock,161828,3205
9,0,l,kwl,ssr(external_modem),0,0 9,0,l,kwl,power-supply,228,23
9,0,l,kwl,pil-dsps,0,0 9,0,l,kwl,wcnss,0,0 9,0,l,kwl,msm_otg,0,0
9,0,l,kwl,pm8921_eoc,0,0 9,0,l,kwl,slimport_wake_lock,0,0
9,0,l,kwl,smsm_snapshot,0,0 9,0,l,kwl,suspend_backoff,239760,24
9,0,l,kwl,event1-648,9331,1212 9,0,l,kwl,main,429,0
9,0,l,kwl,alarm,2892,270 9,0,l,kwl,PowerManagerService.Display,432,1
9,0,l,kwl,qmi1,0,0 9,0,l,kwl,kickstart,211,1
9,0,l,kwl,qmuxd_port_wl_9,9,102 9,0,l,kwl,ear_hook,0,0
9,0,l,kwl,mmc0_detect,52,1232 9,0,l,kwl,deleted_wake_locks,0,0
9,0,l,kwl,PowerManagerService.Broadcasts,7331,0 9,0,l,kwl,qmi2,0,0
9,0,l,kwl,smd_sns_dsps,456,1340 9,0,l,kwl,alarm_rtc,36084,122
9,0,l,pws,2100,64.4,42.0,63.0 9,10009,l,pwi,uid,20.6 9,0,l,pwi,cell,18.5
9,0,l,pwi,idle,8.73 9,0,l,pwi,uid,5.46 9,1000,l,pwi,uid,5.11
9,0,l,pwi,wifi,3.28 9,10019,l,pwi,uid,0.847 9,10069,l,pwi,uid,0.408
9,0,l,pwi,scrn,0.385 9,10034,l,pwi,uid,0.322 9,10025,l,pwi,uid,0.185
9,0,l,pwi,blue,0.0273
9,0,l,pwi,cell,14.0
9,10002,l,pwi,uid,0.180 9,10023,l,pwi,uid,0.168 9,1001,l,pwi,uid,0.0297
9,10068,l,pwi,uid,0.0296 9,10057,l,pwi,uid,0.0234 9,1027,l,pwi,uid,0.0157
9,10079,l,pwi,uid,0.00905 9,10054,l,pwi,uid,0.00527
9,10005,l,pwi,uid,0.00341 9,10004,l,pwi,uid,0.00204
9,2000,l,pwi,uid,0.00192 9,10070,l,pwi,uid,0.00144
9,10061,l,pwi,uid,0.000860 9,10014,l,pwi,uid,0.000495
9,10040,l,pwi,uid,0.000286 9,1014,l,pwi,uid,0.00000157 9,0,l,pwi,over,1.36
9,0,l,nt,0,0,127699,11159,0,0,975,163,0,0
9,0,l,pr,file-storage,0,140,0,0,0,0 9,0,l,pr,TX_Thread,0,440,0,0,0,0
9,0,l,pr,flush-179:0,0,850,0,0,0,0 9,0,l,pr,sync_supers,10,0,0,0,0,0
9,0,l,pr,dhcpcd,0,30,0,0,0,0 9,0,l,pr,kauditd,50,10,0,0,0,0
9,0,l,pr,sdcard,20,110,0,0,0,0 9,0,l,pr,flush-0:18,40,100,0,0,0,0
9,0,l,pr,zygote,250,90,0,0,0,0 9,0,l,pr,bdi-default,0,610,0,0,0,0
9,0,l,pr,ueventd,940,2630,0,0,0,0 9,0,l,pr,kswapd0,0,180,0,0,0,0
9,0,l,pr,debuggerd,180,610,0,0,0,0 9,0,l,pr,jbd2/mmcblk0p20,0,50,0,0,0,0
9,0,l,pr,jbd2/mmcblk0p21,0,250,0,0,0,0
9,0,l,pr,jbd2/mmcblk0p22,0,90,0,0,0,0
9,0,l,pr,jbd2/mmcblk0p23,0,1150,0,0,0,0 9,0,l,pr,MC_Thread,0,1270,0,0,0,0
9,0,l,pr,adbd,10,40,0,0,0,0 9,0,l,pr,lmkd,360,990,0,0,0,0
9,0,l,pr,logd,1550,1670,0,0,0,0 9,0,l,pr,netd,80,330,0,0,0,0
9,0,l,pr,rild,160,0,0,0,0,0 9,0,l,pr,vold,50,100,0,0,0,0
9,0,l,pr,/init,0,70,0,0,0,0 9,0,l,pr,mpdecision,1400,7820,0,0,0,0
9,0,l,pr,khubd,0,10,0,0,0,0 9,0,l,pr,kthreadd,0,600,0,0,0,0
9,0,l,pr,kworker/0:0,0,3520,0,0,0,0 9,0,l,pr,sensors.qcom,380,720,0,0,0,0
9,0,l,pr,healthd,20,190,0,0,0,0 9,0,l,pr,thermald,60,360,0,0,0,0
9,0,l,pr,mmcqd/0,0,8700,0,0,0,0 9,0,l,pr,qseecomd,0,90,0,0,0,0
9,0,l,pr,ksoftirqd/0,0,420,0,0,0,0 9,0,l,pr,wpa_supplicant,170,160,0,0,0,0
9,0,l,pr,migration/0,0,1630,0,0,0,0 9,0,l,pr,migration/1,20,0,0,0,0,0
9,0,l,pr,RX_Thread,0,790,0,0,0,0 9,0,l,pr,netmgrd,40,20,0,0,0,0
9,1000,l,nt,0,0,11054,11216,0,0,26,29,0,0 9,1000,l,ua,2,0,0
9,1000,l,sr,5,6813,1 9,1000,l,wl,*alarm*,0,f,0,23856,p,151,0,w,0
9,1000,l,st,8548446,8548446,8548446 9,1000,l,pr,system,83310,35060,0,0,0,0
9,1000,l,pr,surfaceflinger,6620,9330,0,0,0,0 9,1000,l,pr,ks,0,60,0,0,0,0
9,1000,l,pr,qcks,0,90,0,0,0,0 9,1000,l,pr,efsks,0,50,0,0,0,0
9,1000,l,pr,com.android.server.telecom,110,100,0,0,0,0
9,1000,l,pr,servicemanager,40,110,0,0,0,0
9,1001,l,st,8548446,8548446,8548446 9,1001,l,pr,qmuxd,0,30,0,0,0,0
9,1001,l,pr,com.android.phone,450,300,0,0,0,0
9,1014,l,nt,0,0,3410,3370,0,0,10,10,0,0 9,1027,l,st,8548446,8548446,8548446
9,1027,l,pr,com.android.nfc,250,160,0,0,0,0
9,10002,l,apk,15,com.android.providers.calendar,com.android.providers.calendar.CalendarProviderIntentService,2383,15,15
9,10005,l,nt,0,0,1241,2488,0,0,6,10,0,0
9,10009,l,nt,0,0,232255,258511,0,0,472,600,0,0
9,10009,l,wfl,7689000,9814000,0
9,10009,l,jb,com.google.android.gms/.gcm.nts.TaskExecutionService,81,3
9,10009,l,sr,0,43643,46 9,10025,l,nt,0,0,152461,42850,0,0,267,243,0,0
9,10025,l,wfl,1593000,629000,0 9,10034,l,nt,0,0,77657,40093,0,0,172,170,0,0
9,10068,l,nt,0,0,11929,8383,0,0,50,47,0,0
9,10069,l,nt,0,0,41553,22886,0,0,85,91,0,0</pre>
<h2 id="interpreting_the_output">Section identifiers</h2>
<p>Command output for <code>batterystats</code> supports the following
sections:</p>
<table id="batterystats-section-ids">
<tr>
<th width="10%">Section Identifier</th>
<th width="20%">Description</th>
<th width="70%">Remaining Fields</th>
</tr>
<tr>
<td><p>vers</p></td>
<td><p>Version</p></td>
<td><p>checkin version, parcel version, start platform version, end
platform version</p></td>
</tr>
<tr>
<td><p>uid</p></td>
<td><p>UID</p></td>
<td><p>uid, package name</p></td>
</tr>
<tr>
<td><p>apk</p></td>
<td><p>APK</p></td>
<td><p>wakeups, APK, service, start time, starts, launches</p></td>
</tr>
<tr>
<td><p>pr</p></td>
<td><p>Process</p></td>
<td><p>process, user, system, foreground, starts</p></td>
</tr>
<tr>
<td><p>sr</p></td>
<td><p>Sensor</p></td>
<td><p>sensor number, time, count</p></td>
</tr>
<tr>
<td><p>vib</p></td>
<td><p>Vibrator</p></td>
<td><p>time, count</p></td>
</tr>
<tr>
<td><p>fg</p></td>
<td><p>Foreground</p></td>
<td><p>time, count</p></td>
</tr>
<tr>
<td><p>st</p></td>
<td><p>State Time</p></td>
<td><p>foreground, active, running</p></td>
</tr>
<tr>
<td><p>wl</p></td>
<td><p>Wake lock</p></td>
<td><p>wake lock, full time, 'f', full count, partial time, 'p', partial
count, window time, 'w', window count</p></td>
</tr>
<tr>
<td><p>sy</p></td>
<td><p>Sync</p></td>
<td><p>sync, time, count</p></td>
</tr>
<tr>
<td><p>jb</p></td>
<td><p>Job</p></td>
<td><p>job, time, count</p></td>
</tr>
<tr>
<td><p>kwl</p></td>
<td><p>Kernel Wake Lock</p></td>
<td><p>kernel wake lock, time, count</p></td>
</tr>
<tr>
<td><p>wr</p></td>
<td><p>Wakeup Reason</p></td>
<td><p>wakeup reason, time, count</p></td>
</tr>
<tr>
<td><p>nt</p></td>
<td><p>Network</p></td>
<td><p>mobile bytes RX, mobile bytes TX, Wi-Fi bytes RX, Wi-Fi bytes TX,
mobile packets RX, mobile packets TX, Wi-Fi packets RX, Wi-Fi packets
TX, mobile active time, mobile active count</p></td>
</tr>
<tr>
<td><p>ua</p></td>
<td><p>User Activity</p></td>
<td><p>other, button, touch</p></td>
</tr>
<tr>
<td><p>bt</p></td>
<td><p>Battery</p></td>
<td><p>start count, battery realtime, battery uptime, total realtime,
total uptime, start clock time, battery screen off realtime, battery
screen off uptime</p></td>
</tr>
<tr>
<td><p>dc</p></td>
<td><p>Battery Discharge</p></td>
<td><p>low, high, screen on, screen off</p></td>
</tr>
<tr>
<td><p>lv</p></td>
<td><p>Battery Level</p></td>
<td><p>start level, current level</p></td>
</tr>
<tr>
<td><p>wfl</p></td>
<td><p>Wi-Fi</p></td>
<td><p>full Wi-Fi lock on time, Wi-Fi scan time, Wi-Fi running time, Wi-Fi
scan count, Wi-Fi idle time, Wi-Fi receive time, Wi-Fi transmit time</p>
</td>
</tr>
<tr>
<td><p>gwfl</p></td>
<td><p>Global Wi-Fi</p></td>
<td><p>Wi-Fi on time, Wi-Fi running time, Wi-Fi idle time, Wi-Fi receive
time, Wi-Fi transmit time, Wi-Fi power (mAh)</p></td>
</tr>
<tr>
<td><p>gble</p></td>
<td><p>Global Bluetooth</p></td>
<td><p>BT idle time, BT receive time, BT transmit time, BT power (mAh)</p>
</td>
</tr>
<tr>
<td><p>m</p></td>
<td><p>Misc</p></td>
<td><p>screen on time, phone on time, full wakelock time total, partial
wakelock time total, mobile radio active time, mobile radio active
adjusted time, interactive time, power save mode enabled time,
connectivity changes, device idle mode enabled time, device idle mode
enabled count, device idling time, device idling count, mobile radio
active count, mobile radio active unknown time</p></td>
</tr>
<tr>
<td><p>gn</p></td>
<td><p>Global Network</p></td>
<td><p>mobile RX total bytes, mobile TX total bytes, Wi-Fi RX total
bytes, Wi-Fi TX total bytes, mobile RX total packets, mobile TX total
packets, Wi-Fi RX total packets, Wi-Fi TX total packets</p></td>
</tr>
<tr>
<td><p>br</p></td>
<td><p>Screen Brightness</p></td>
<td><p>dark, dim, medium, light, bright</p></td>
</tr>
<tr>
<td><p>sst</p></td>
<td><p>Signal Scanning Time</p></td>
<td><p>signal scanning time</p></td>
</tr>
<tr>
<td><p>sgt</p></td>
<td><p>Signal Strength Time</p></td>
<td><p>none, poor, moderate, good, great</p></td>
</tr>
<tr>
<td><p>sgc</p></td>
<td><p>Signal Strength Count</p></td>
<td><p>none, poor, moderate, good, great</p></td>
</tr>
<tr>
<td><p>dct</p></td>
<td><p>Data Connection Time</p></td>
<td><p>none, GPRS, EDGE, UMTS, CDMA, EVDO_0, EVDO_A, 1xRTT, HSDPA, HSUPA,
HSPA, IDEN, EVDO_B, LTE, EHRPD, HSPAP, other</p></td>
</tr>
<tr>
<td><p>dcc</p></td>
<td><p>Data Connection Count</p></td>
<td><p>none, GPRS, EDGE, UMTS, CDMA, EVDO_0, EVDO_A, 1xRTT, HSDPA, HSUPA,
HSPA, IDEN, EVDO_B, LTE, EHRPD, HSPAP, other</p></td>
</tr>
<tr>
<td><p>wst</p></td>
<td><p>Wi-Fi State Time</p></td>
<td><p>off, off scanning, on no networks, on disconnected, on connected
STA, on connected P2P, on connected STA P2P, soft AP</p></td>
</tr>
<tr>
<td><p>wsc</p></td>
<td><p>Wi-Fi State Count</p></td>
<td><p>off, off scanning, on no networks, on disconnected, on connected
STA, on connected P2P, on connected STA P2P, soft AP</p></td>
</tr>
<tr>
<td><p>wsst</p></td>
<td><p>Wi-Fi Supplicant State Time</p></td>
<td><p>invalid, disconnected, interface disabled, inactive, scanning,
authenticating, associating, associated, four-way handshake, group
handshake, completed, dormant, uninitialized</p></td>
</tr>
<tr>
<td><p>wssc</p></td>
<td><p>Wi-Fi Supplicant State Count</p></td>
<td><p>invalid, disconnected, interface disabled, inactive, scanning,
authenticating, associating, associated, four-way handshake, group
handshake, completed, dormant, uninitialized</p></td>
</tr>
<tr>
<td><p>wsgt</p></td>
<td><p>Wi-Fi Signal Strength Time</p></td>
<td><p>none, poor, moderate, good, great</p></td>
</tr>
<tr>
<td><p>wsgc</p></td>
<td><p>Wi-Fi Signal Strength Count</p></td>
<td><p>none, poor, moderate, good, great</p></td>
</tr>
<tr>
<td><p>bst</p></td>
<td><p>Bluetooth State Time</p></td>
<td><p>inactive, low, med, high</p></td>
</tr>
<tr>
<td><p>bsc</p></td>
<td><p>Bluetooth State Count</p></td>
<td><p>inactive, low, med, high</p></td>
</tr>
<tr>
<td><p>pws</p></td>
<td><p>Power Use Summary</p></td>
<td><p>battery capacity, computed power, minimum drained power, maximum
drained power</p></td>
</tr>
<tr>
<td><p>pwi</p></td>
<td><p>Power Use Item</p></td>
<td><p>label, mAh</p></td>
</tr>
<tr>
<td><p>dsd</p></td>
<td><p>Discharge Step</p></td>
<td><p>duration, level, screen, power-save</p></td>
</tr>
<tr>
<td><p>csd</p></td>
<td><p>Charge Step</p></td>
<td><p>duration, level, screen, power-save</p></td>
</tr>
<tr>
<td><p>dtr</p></td>
<td><p>Discharge Time Remaining</p></td>
<td><p>battery time remaining</p></td>
</tr>
<tr>
<td><p>ctr</p></td>
<td><p>Charge Time Remaining</p></td>
<td><p>charge time remaining</p></td>
</tr>
</table>
<h2 id="wifi-reqs">Bluetooth, cellular, and Wi-Fi usage</h2>
<p>Support for battery usage data on Bluetooth, cellular, and Wi-Fi data
requires the device Bluetooth, cellular, and Wif-Fi chipsets implement radio
support and the chipset firmware passes usage data to the framework. OEMs must
work with their chipset providers to facilitate in-field firmware updates on
existing chipsets and compatible firmware on new chipsets.</p>
<p>Additionally, OEMs must continue to configure and submit the power profile
for their devices. However, when the platform detects that Bluetooth, cellular
(as of Android 7.0), or Wi-Fi radio power data is available from the chipset, it
uses chipset data instead of power profile data. For details, see
<a href="{@docRoot}devices/tech/power/values.html#values">Power values</a>.</p>
<p class="note"><strong>Note</strong>: Prior to Android 6.0, power use for
Bluetooth radio, cellular radio, and Wi-Fi was tracked in the <em>m</em> (Misc)
section category. In Android 6.0 and higher, power use for these components is
tracked in the <em>pwi</em> (Power Use Item) section with individual labels
(<em>wifi</em>, <em>blue</em>, <em>cell</em>) for each component.</p>