1page.title=Viewing Battery Use Data 2@jd:body 3 4<!-- 5 Copyright 2015 The Android Open Source Project 6 7 Licensed under the Apache License, Version 2.0 (the "License"); 8 you may not use this file except in compliance with the License. 9 You may obtain a copy of the License at 10 11 http://www.apache.org/licenses/LICENSE-2.0 12 13 Unless required by applicable law or agreed to in writing, software 14 distributed under the License is distributed on an "AS IS" BASIS, 15 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 16 See the License for the specific language governing permissions and 17 limitations under the License. 18--> 19<div id="qv-wrapper"> 20 <div id="qv"> 21 <h2>In this document</h2> 22 <ol id="auto-toc"> 23 </ol> 24 </div> 25</div> 26 27 <p>The <code>dumpsys batterystats</code> command generates interesting 28 statistical data about battery usage on a device, organized by unique user 29 ID (UID). The statistics include the following:</p> 30 31 <ul> 32 <li>History of battery-related events</li> 33 34 <li>Global statistics for the device</li> 35 36 <li>Approximate power use per UID and system component</li> 37 38 <li>Per-app mobile milliseconds per packet</li> 39 40 <li>System UID aggregated statistics</li> 41 42 <li>App UID aggregated statistics</li> 43 </ul> 44 45 <p>Use the <a href="https://github.com/google/battery-historian">Battery 46 Historian</a> tool on the output of the dumpsys command to generate an HTML 47 visualization of power-related events from the logs. This information makes it 48 easier to understand and diagnose battery-related issues.</p> 49 50 <h2 id="command-line_options">Command input</h2> 51 <p>The basic <code>batterystats</code> command is:</p> 52 <pre class="prettyprint"> 53$ adb shell dumpsys batterystats</pre> 54 <p>Supported options:</p> 55 <ul> 56 <li><code>--help</code> displays additional options for tailoring the output. 57 </li> 58 <li><code>--checkin</code> exports results in machine-readable csv format. 59 </li> 60 </ul> 61 <p>For example, to print battery usage statistics in csv format for all apps 62 since the device was last charged, run the command:</p> 63 <pre class="prettyprint"> 64$ adb shell dumpsys batterystats --charged --checkin</pre> 65 <p>You can also specify a package name to get statistics for a single app. For 66 example, to print battery usage statistics for a given app package 67 since the device was last charged, run the command:</p> 68 <pre class="prettyprint"> 69$ adb shell dumpsys batterystats --charged <package-name></pre> 70 71 <h2 id="output">Command output</h2> 72 73 <p>The <code>batterystats</code> command generates aggregated observations 74 about battery use on the device since it was last charged. Observations may be 75 per-UID or system-level; data is selected for inclusion based on its 76 usefulness in analyzing battery performance. Output includes one (1) entry 77 per observation, and each entry consists of a comma-separated list of values 78 in the format: 79 <em>int</em>,<em>uid</em>,<em>mode</em>,<em>section</em>,<em>fields</em> 80 (one or more).</p> 81 82 <p>The first four values correspond to the following:</p> 83 84 <ul> 85 <li>Dummy integer</li> 86 87 <li>UID</li> 88 89 <li>Aggregation mode 90 91 <ul> 92 <li>"i" for information not tied to charged/uncharged status.</li> 93 <li>"l" for --charged (usage since last charge).</li> 94 <li>"u" for --unplugged (usage since last unplugged). Deprecated in 95 Android 5.1.1.</li> 96 </ul> 97 </li> 98 99 <li><a href="#interpreting_the_output">Section identifier</a>, which 100 determines how to interpret subsequent values in the line.</li> 101 </ul> 102 103<p>Sample output:</p> 104 105 <pre class="no-pretty-print"> 106 9,0,i,vers,11,116,K,L 9,0,i,uid,1000,android 107 9,0,i,uid,1000,com.android.providers.settings 108 9,0,i,uid,1000,com.android.inputdevices 109 9,0,i,uid,1000,com.android.server.telecom 110 9,0,i,uid,1000,com.android.keychain 9,0,i,uid,1000,com.android.settings 111 9,0,i,uid,1000,com.android.location.fused 112 9,0,i,uid,1001,com.android.providers.telephony 113 9,0,i,uid,1001,com.android.mms.service 9,0,i,uid,1001,com.android.stk 114 9,0,i,uid,1001,com.android.phone 9,0,i,uid,1027,com.android.nfc 115 9,0,i,uid,2000,com.android.shell 116 9,0,i,uid,10002,com.android.providers.calendar 117 9,0,i,uid,10003,com.android.cellbroadcastreceiver 118 9,0,i,uid,10004,com.android.providers.userdictionary 119 9,0,i,uid,10004,com.android.providers.contacts 120 9,0,i,uid,10005,com.google.android.apps.enterprise.dmagent 121 9,0,i,uid,10006,com.android.defcontainer 122 9,0,i,uid,10007,com.android.providers.media 123 9,0,i,uid,10007,com.android.providers.downloads 124 9,0,i,uid,10007,com.android.providers.downloads.ui 125 9,0,i,uid,10008,com.android.externalstorage 126 9,0,i,uid,10009,com.google.android.syncadapters.contacts 127 9,0,i,uid,10009,com.google.android.gms 128 9,0,i,uid,10009,com.google.android.gsf 129 9,0,i,uid,10009,com.google.android.gsf.login 130 9,0,i,uid,10009,com.google.android.backuptransport 131 9,0,i,uid,10011,com.google.android.dialer 132 9,0,i,uid,10013,com.google.android.onetimeinitializer 133 9,0,i,uid,10014,com.google.android.partnersetup 134 9,0,i,uid,10015,com.android.launcher 135 9,0,i,uid,10016,com.android.managedprovisioning 136 9,0,i,uid,10017,com.android.mms 9,0,i,uid,10018,com.android.musicfx 137 9,0,i,uid,10019,com.android.vending 138 9,0,i,uid,10022,com.android.sharedstoragebackup 139 9,0,i,uid,10023,com.android.systemui 140 9,0,i,uid,10025,com.google.android.googlequicksearchbox 141 9,0,i,uid,10027,com.google.android.apps.walletnfcrel 142 9,0,i,uid,10029,com.google.android.marvin.talkback 143 9,0,i,uid,10031,com.google.android.apps.books 144 9,0,i,uid,10034,com.google.android.calendar 145 9,0,i,uid,10037,com.android.chrome 146 9,0,i,uid,10039,com.google.android.configupdater 147 9,0,i,uid,10040,com.google.android.deskclock 148 9,0,i,uid,10041,com.android.documentsui 149 9,0,i,uid,10042,com.google.android.apps.docs 150 9,0,i,uid,10047,com.google.android.ears 151 9,0,i,uid,10054,com.google.android.talk 152 9,0,i,uid,10057,com.google.android.inputmethod.latin 153 9,0,i,uid,10061,com.google.android.music 154 9,0,i,uid,10064,com.android.packageinstaller 155 9,0,i,uid,10068,com.google.android.apps.plus 156 9,0,i,uid,10069,com.google.android.gm 157 9,0,i,uid,10070,com.google.android.keep 158 9,0,i,uid,10071,com.google.android.apps.genie.geniewidget 159 9,0,i,uid,10072,com.android.printspooler 160 9,0,i,uid,10076,com.google.android.videos 161 9,0,i,uid,10079,com.google.android.youtube 162 9,0,i,uid,10084,com.google.android.apps.magazines 163 9,0,i,dsd,1820451,97,s-,p- 9,0,i,dsd,3517481,98,s-,p- 164 9,0,l,bt,0,8548446,1000983,8566645,1019182,1418672206045,8541652,994188 165 9,0,l,gn,0,0,666932,495312,0,0,2104,1444 166 9,0,l,m,6794,0,8548446,8548446,0,0,0,666932,495312,0,697728,0,0,0,5797,0,0 167 9,0,l,br,9,0,6785,0,0 9,0,l,sgt,8548446,0,0,0,0 9,0,l,sst,9000 168 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 169 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 170 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 171 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 172 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 173 9,0,l,kwl,msm_ipc_read00000001:00000001,0,0 174 9,0,l,kwl,rpm_regulator_tcxo,0,0 9,0,l,kwl,wlan,25423,32 175 9,0,l,kwl,event4-648,0,0 9,0,l,kwl,qcril,187,2 9,0,l,kwl,ssr(dsps),0,0 176 9,0,l,kwl,bq51051b_wireless_chip,0,0 9,0,l,kwl,qmi0,0,0 177 9,0,l,kwl,event5-648,7755,1231 178 9,0,l,kwl,PowerManagerService.WakeLocks,680435,3908 179 9,0,l,kwl,msm_hsic_host,66258,35 9,0,l,kwl,qcom_sap_wakelock,0,0 180 9,0,l,kwl,sns_async_ev_wakelock,91954,1244 9,0,l,kwl,qmuxd_port_wl_12,0,0 181 9,0,l,kwl,pil-wcnss,0,0 9,0,l,kwl,event0-648,11364,1212 182 9,0,l,kwl,dofstrim,0,0 9,0,l,kwl,ssr(lpass),0,0 183 9,0,l,kwl,qmuxd_port_wl_11,0,0 9,0,l,kwl,event2-648,0,0 184 9,0,l,kwl,pil-vidc,0,0 9,0,l,kwl,mmc0,0,0 185 9,0,l,kwl,tabla_gpio_irq_resend,0,0 9,0,l,kwl,pil-q6,0,0 186 9,0,l,kwl,radio-interface,0,0 9,0,l,kwl,msm_ipc_read00000001:00000002,0,0 187 9,0,l,kwl,event3-648,8143,1231 9,0,l,kwl,ssr(wcnss),0,0 188 9,0,l,kwl,ssr(gss),0,0 9,0,l,kwl,KeyEvents,98,1263 189 9,0,l,kwl,unknown_wakeups,0,0 9,0,l,kwl,qmuxd_port_wl_10,0,0 190 9,0,l,kwl,pil-gss,0,0 9,0,l,kwl,qcom_rx_wakelock,161828,3205 191 9,0,l,kwl,ssr(external_modem),0,0 9,0,l,kwl,power-supply,228,23 192 9,0,l,kwl,pil-dsps,0,0 9,0,l,kwl,wcnss,0,0 9,0,l,kwl,msm_otg,0,0 193 9,0,l,kwl,pm8921_eoc,0,0 9,0,l,kwl,slimport_wake_lock,0,0 194 9,0,l,kwl,smsm_snapshot,0,0 9,0,l,kwl,suspend_backoff,239760,24 195 9,0,l,kwl,event1-648,9331,1212 9,0,l,kwl,main,429,0 196 9,0,l,kwl,alarm,2892,270 9,0,l,kwl,PowerManagerService.Display,432,1 197 9,0,l,kwl,qmi1,0,0 9,0,l,kwl,kickstart,211,1 198 9,0,l,kwl,qmuxd_port_wl_9,9,102 9,0,l,kwl,ear_hook,0,0 199 9,0,l,kwl,mmc0_detect,52,1232 9,0,l,kwl,deleted_wake_locks,0,0 200 9,0,l,kwl,PowerManagerService.Broadcasts,7331,0 9,0,l,kwl,qmi2,0,0 201 9,0,l,kwl,smd_sns_dsps,456,1340 9,0,l,kwl,alarm_rtc,36084,122 202 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 203 9,0,l,pwi,idle,8.73 9,0,l,pwi,uid,5.46 9,1000,l,pwi,uid,5.11 204 9,0,l,pwi,wifi,3.28 9,10019,l,pwi,uid,0.847 9,10069,l,pwi,uid,0.408 205 9,0,l,pwi,scrn,0.385 9,10034,l,pwi,uid,0.322 9,10025,l,pwi,uid,0.185 206 9,0,l,pwi,blue,0.0273 207 9,0,l,pwi,cell,14.0 208 9,10002,l,pwi,uid,0.180 9,10023,l,pwi,uid,0.168 9,1001,l,pwi,uid,0.0297 209 9,10068,l,pwi,uid,0.0296 9,10057,l,pwi,uid,0.0234 9,1027,l,pwi,uid,0.0157 210 9,10079,l,pwi,uid,0.00905 9,10054,l,pwi,uid,0.00527 211 9,10005,l,pwi,uid,0.00341 9,10004,l,pwi,uid,0.00204 212 9,2000,l,pwi,uid,0.00192 9,10070,l,pwi,uid,0.00144 213 9,10061,l,pwi,uid,0.000860 9,10014,l,pwi,uid,0.000495 214 9,10040,l,pwi,uid,0.000286 9,1014,l,pwi,uid,0.00000157 9,0,l,pwi,over,1.36 215 9,0,l,nt,0,0,127699,11159,0,0,975,163,0,0 216 9,0,l,pr,file-storage,0,140,0,0,0,0 9,0,l,pr,TX_Thread,0,440,0,0,0,0 217 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 218 9,0,l,pr,dhcpcd,0,30,0,0,0,0 9,0,l,pr,kauditd,50,10,0,0,0,0 219 9,0,l,pr,sdcard,20,110,0,0,0,0 9,0,l,pr,flush-0:18,40,100,0,0,0,0 220 9,0,l,pr,zygote,250,90,0,0,0,0 9,0,l,pr,bdi-default,0,610,0,0,0,0 221 9,0,l,pr,ueventd,940,2630,0,0,0,0 9,0,l,pr,kswapd0,0,180,0,0,0,0 222 9,0,l,pr,debuggerd,180,610,0,0,0,0 9,0,l,pr,jbd2/mmcblk0p20,0,50,0,0,0,0 223 9,0,l,pr,jbd2/mmcblk0p21,0,250,0,0,0,0 224 9,0,l,pr,jbd2/mmcblk0p22,0,90,0,0,0,0 225 9,0,l,pr,jbd2/mmcblk0p23,0,1150,0,0,0,0 9,0,l,pr,MC_Thread,0,1270,0,0,0,0 226 9,0,l,pr,adbd,10,40,0,0,0,0 9,0,l,pr,lmkd,360,990,0,0,0,0 227 9,0,l,pr,logd,1550,1670,0,0,0,0 9,0,l,pr,netd,80,330,0,0,0,0 228 9,0,l,pr,rild,160,0,0,0,0,0 9,0,l,pr,vold,50,100,0,0,0,0 229 9,0,l,pr,/init,0,70,0,0,0,0 9,0,l,pr,mpdecision,1400,7820,0,0,0,0 230 9,0,l,pr,khubd,0,10,0,0,0,0 9,0,l,pr,kthreadd,0,600,0,0,0,0 231 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 232 9,0,l,pr,healthd,20,190,0,0,0,0 9,0,l,pr,thermald,60,360,0,0,0,0 233 9,0,l,pr,mmcqd/0,0,8700,0,0,0,0 9,0,l,pr,qseecomd,0,90,0,0,0,0 234 9,0,l,pr,ksoftirqd/0,0,420,0,0,0,0 9,0,l,pr,wpa_supplicant,170,160,0,0,0,0 235 9,0,l,pr,migration/0,0,1630,0,0,0,0 9,0,l,pr,migration/1,20,0,0,0,0,0 236 9,0,l,pr,RX_Thread,0,790,0,0,0,0 9,0,l,pr,netmgrd,40,20,0,0,0,0 237 9,1000,l,nt,0,0,11054,11216,0,0,26,29,0,0 9,1000,l,ua,2,0,0 238 9,1000,l,sr,5,6813,1 9,1000,l,wl,*alarm*,0,f,0,23856,p,151,0,w,0 239 9,1000,l,st,8548446,8548446,8548446 9,1000,l,pr,system,83310,35060,0,0,0,0 240 9,1000,l,pr,surfaceflinger,6620,9330,0,0,0,0 9,1000,l,pr,ks,0,60,0,0,0,0 241 9,1000,l,pr,qcks,0,90,0,0,0,0 9,1000,l,pr,efsks,0,50,0,0,0,0 242 9,1000,l,pr,com.android.server.telecom,110,100,0,0,0,0 243 9,1000,l,pr,servicemanager,40,110,0,0,0,0 244 9,1001,l,st,8548446,8548446,8548446 9,1001,l,pr,qmuxd,0,30,0,0,0,0 245 9,1001,l,pr,com.android.phone,450,300,0,0,0,0 246 9,1014,l,nt,0,0,3410,3370,0,0,10,10,0,0 9,1027,l,st,8548446,8548446,8548446 247 9,1027,l,pr,com.android.nfc,250,160,0,0,0,0 248 9,10002,l,apk,15,com.android.providers.calendar,com.android.providers.calendar.CalendarProviderIntentService,2383,15,15 249 9,10005,l,nt,0,0,1241,2488,0,0,6,10,0,0 250 9,10009,l,nt,0,0,232255,258511,0,0,472,600,0,0 251 9,10009,l,wfl,7689000,9814000,0 252 9,10009,l,jb,com.google.android.gms/.gcm.nts.TaskExecutionService,81,3 253 9,10009,l,sr,0,43643,46 9,10025,l,nt,0,0,152461,42850,0,0,267,243,0,0 254 9,10025,l,wfl,1593000,629000,0 9,10034,l,nt,0,0,77657,40093,0,0,172,170,0,0 255 9,10068,l,nt,0,0,11929,8383,0,0,50,47,0,0 256 9,10069,l,nt,0,0,41553,22886,0,0,85,91,0,0</pre> 257 258 <h2 id="interpreting_the_output">Section identifiers</h2> 259 260 <p>Command output for <code>batterystats</code> supports the following 261 sections:</p> 262 263 <table id="batterystats-section-ids"> 264 265 <tr> 266 <th width="10%">Section Identifier</th> 267 <th width="20%">Description</th> 268 <th width="70%">Remaining Fields</th> 269 </tr> 270 271 <tr> 272 <td><p>vers</p></td> 273 <td><p>Version</p></td> 274 <td><p>checkin version, parcel version, start platform version, end 275 platform version</p></td> 276 </tr> 277 278 <tr> 279 <td><p>uid</p></td> 280 <td><p>UID</p></td> 281 <td><p>uid, package name</p></td> 282 </tr> 283 284 <tr> 285 <td><p>apk</p></td> 286 <td><p>APK</p></td> 287 <td><p>wakeups, APK, service, start time, starts, launches</p></td> 288 </tr> 289 290 <tr> 291 <td><p>pr</p></td> 292 <td><p>Process</p></td> 293 <td><p>process, user, system, foreground, starts</p></td> 294 </tr> 295 296 <tr> 297 <td><p>sr</p></td> 298 <td><p>Sensor</p></td> 299 <td><p>sensor number, time, count</p></td> 300 </tr> 301 302 <tr> 303 <td><p>vib</p></td> 304 <td><p>Vibrator</p></td> 305 <td><p>time, count</p></td> 306 </tr> 307 308 <tr> 309 <td><p>fg</p></td> 310 <td><p>Foreground</p></td> 311 <td><p>time, count</p></td> 312 </tr> 313 314 <tr> 315 <td><p>st</p></td> 316 <td><p>State Time</p></td> 317 <td><p>foreground, active, running</p></td> 318 </tr> 319 320 <tr> 321 <td><p>wl</p></td> 322 <td><p>Wake lock</p></td> 323 <td><p>wake lock, full time, 'f', full count, partial time, 'p', partial 324 count, window time, 'w', window count</p></td> 325 </tr> 326 327 <tr> 328 <td><p>sy</p></td> 329 <td><p>Sync</p></td> 330 <td><p>sync, time, count</p></td> 331 </tr> 332 333 <tr> 334 <td><p>jb</p></td> 335 <td><p>Job</p></td> 336 <td><p>job, time, count</p></td> 337 </tr> 338 339 <tr> 340 <td><p>kwl</p></td> 341 <td><p>Kernel Wake Lock</p></td> 342 <td><p>kernel wake lock, time, count</p></td> 343 </tr> 344 345 <tr> 346 <td><p>wr</p></td> 347 <td><p>Wakeup Reason</p></td> 348 <td><p>wakeup reason, time, count</p></td> 349 </tr> 350 351 <tr> 352 <td><p>nt</p></td> 353 <td><p>Network</p></td> 354 <td><p>mobile bytes RX, mobile bytes TX, Wi-Fi bytes RX, Wi-Fi bytes TX, 355 mobile packets RX, mobile packets TX, Wi-Fi packets RX, Wi-Fi packets 356 TX, mobile active time, mobile active count</p></td> 357 </tr> 358 359 <tr> 360 <td><p>ua</p></td> 361 <td><p>User Activity</p></td> 362 <td><p>other, button, touch</p></td> 363 </tr> 364 365 <tr> 366 <td><p>bt</p></td> 367 <td><p>Battery</p></td> 368 <td><p>start count, battery realtime, battery uptime, total realtime, 369 total uptime, start clock time, battery screen off realtime, battery 370 screen off uptime</p></td> 371 </tr> 372 373 <tr> 374 <td><p>dc</p></td> 375 <td><p>Battery Discharge</p></td> 376 <td><p>low, high, screen on, screen off</p></td> 377 </tr> 378 379 <tr> 380 <td><p>lv</p></td> 381 <td><p>Battery Level</p></td> 382 <td><p>start level, current level</p></td> 383 </tr> 384 385 <tr> 386 <td><p>wfl</p></td> 387 <td><p>Wi-Fi</p></td> 388 <td><p>full Wi-Fi lock on time, Wi-Fi scan time, Wi-Fi running time, Wi-Fi 389 scan count, Wi-Fi idle time, Wi-Fi receive time, Wi-Fi transmit time</p> 390 </td> 391 </tr> 392 393 <tr> 394 <td><p>gwfl</p></td> 395 <td><p>Global Wi-Fi</p></td> 396 <td><p>Wi-Fi on time, Wi-Fi running time, Wi-Fi idle time, Wi-Fi receive 397 time, Wi-Fi transmit time, Wi-Fi power (mAh)</p></td> 398 </tr> 399 400 <tr> 401 <td><p>gble</p></td> 402 <td><p>Global Bluetooth</p></td> 403 <td><p>BT idle time, BT receive time, BT transmit time, BT power (mAh)</p> 404 </td> 405 </tr> 406 407 <tr> 408 <td><p>m</p></td> 409 <td><p>Misc</p></td> 410 <td><p>screen on time, phone on time, full wakelock time total, partial 411 wakelock time total, mobile radio active time, mobile radio active 412 adjusted time, interactive time, power save mode enabled time, 413 connectivity changes, device idle mode enabled time, device idle mode 414 enabled count, device idling time, device idling count, mobile radio 415 active count, mobile radio active unknown time</p></td> 416 </tr> 417 418 <tr> 419 <td><p>gn</p></td> 420 <td><p>Global Network</p></td> 421 <td><p>mobile RX total bytes, mobile TX total bytes, Wi-Fi RX total 422 bytes, Wi-Fi TX total bytes, mobile RX total packets, mobile TX total 423 packets, Wi-Fi RX total packets, Wi-Fi TX total packets</p></td> 424 </tr> 425 426 <tr> 427 <td><p>br</p></td> 428 <td><p>Screen Brightness</p></td> 429 <td><p>dark, dim, medium, light, bright</p></td> 430 </tr> 431 432 <tr> 433 <td><p>sst</p></td> 434 <td><p>Signal Scanning Time</p></td> 435 <td><p>signal scanning time</p></td> 436 </tr> 437 438 <tr> 439 <td><p>sgt</p></td> 440 <td><p>Signal Strength Time</p></td> 441 <td><p>none, poor, moderate, good, great</p></td> 442 </tr> 443 444 <tr> 445 <td><p>sgc</p></td> 446 <td><p>Signal Strength Count</p></td> 447 <td><p>none, poor, moderate, good, great</p></td> 448 </tr> 449 450 <tr> 451 <td><p>dct</p></td> 452 <td><p>Data Connection Time</p></td> 453 <td><p>none, GPRS, EDGE, UMTS, CDMA, EVDO_0, EVDO_A, 1xRTT, HSDPA, HSUPA, 454 HSPA, IDEN, EVDO_B, LTE, EHRPD, HSPAP, other</p></td> 455 </tr> 456 457 <tr> 458 <td><p>dcc</p></td> 459 <td><p>Data Connection Count</p></td> 460 <td><p>none, GPRS, EDGE, UMTS, CDMA, EVDO_0, EVDO_A, 1xRTT, HSDPA, HSUPA, 461 HSPA, IDEN, EVDO_B, LTE, EHRPD, HSPAP, other</p></td> 462 </tr> 463 464 <tr> 465 <td><p>wst</p></td> 466 <td><p>Wi-Fi State Time</p></td> 467 <td><p>off, off scanning, on no networks, on disconnected, on connected 468 STA, on connected P2P, on connected STA P2P, soft AP</p></td> 469 </tr> 470 471 <tr> 472 <td><p>wsc</p></td> 473 <td><p>Wi-Fi State Count</p></td> 474 <td><p>off, off scanning, on no networks, on disconnected, on connected 475 STA, on connected P2P, on connected STA P2P, soft AP</p></td> 476 </tr> 477 478 <tr> 479 <td><p>wsst</p></td> 480 <td><p>Wi-Fi Supplicant State Time</p></td> 481 <td><p>invalid, disconnected, interface disabled, inactive, scanning, 482 authenticating, associating, associated, four-way handshake, group 483 handshake, completed, dormant, uninitialized</p></td> 484 </tr> 485 486 <tr> 487 <td><p>wssc</p></td> 488 <td><p>Wi-Fi Supplicant State Count</p></td> 489 <td><p>invalid, disconnected, interface disabled, inactive, scanning, 490 authenticating, associating, associated, four-way handshake, group 491 handshake, completed, dormant, uninitialized</p></td> 492 </tr> 493 494 <tr> 495 <td><p>wsgt</p></td> 496 <td><p>Wi-Fi Signal Strength Time</p></td> 497 <td><p>none, poor, moderate, good, great</p></td> 498 </tr> 499 500 <tr> 501 <td><p>wsgc</p></td> 502 <td><p>Wi-Fi Signal Strength Count</p></td> 503 <td><p>none, poor, moderate, good, great</p></td> 504 </tr> 505 506 <tr> 507 <td><p>bst</p></td> 508 <td><p>Bluetooth State Time</p></td> 509 <td><p>inactive, low, med, high</p></td> 510 </tr> 511 512 <tr> 513 <td><p>bsc</p></td> 514 <td><p>Bluetooth State Count</p></td> 515 <td><p>inactive, low, med, high</p></td> 516 </tr> 517 518 <tr> 519 <td><p>pws</p></td> 520 <td><p>Power Use Summary</p></td> 521 <td><p>battery capacity, computed power, minimum drained power, maximum 522 drained power</p></td> 523 </tr> 524 525 <tr> 526 <td><p>pwi</p></td> 527 <td><p>Power Use Item</p></td> 528 <td><p>label, mAh</p></td> 529 </tr> 530 531 <tr> 532 <td><p>dsd</p></td> 533 <td><p>Discharge Step</p></td> 534 <td><p>duration, level, screen, power-save</p></td> 535 </tr> 536 537 <tr> 538 <td><p>csd</p></td> 539 <td><p>Charge Step</p></td> 540 <td><p>duration, level, screen, power-save</p></td> 541 </tr> 542 543 <tr> 544 <td><p>dtr</p></td> 545 <td><p>Discharge Time Remaining</p></td> 546 <td><p>battery time remaining</p></td> 547 </tr> 548 549 <tr> 550 <td><p>ctr</p></td> 551 <td><p>Charge Time Remaining</p></td> 552 <td><p>charge time remaining</p></td> 553 </tr> 554 555 </table> 556 557<h2 id="wifi-reqs">Bluetooth, cellular, and Wi-Fi usage</h2> 558 559<p>Support for battery usage data on Bluetooth, cellular, and Wi-Fi data 560requires the device Bluetooth, cellular, and Wif-Fi chipsets implement radio 561support and the chipset firmware passes usage data to the framework. OEMs must 562work with their chipset providers to facilitate in-field firmware updates on 563existing chipsets and compatible firmware on new chipsets.</p> 564 565<p>Additionally, OEMs must continue to configure and submit the power profile 566for their devices. However, when the platform detects that Wi-Fi and Bluetooth 567radio power data is available from the chipset, it uses chipset data instead of 568power profile data (cell radio power data is not yet used). For details, see 569<a href="{@docRoot}devices/tech/power/values.html#chipset-data">Devices with 570Bluetooth and Wi-Fi controllers</a>.</p> 571 572<p class="note"><strong>Note</strong>: Prior to Android 6.0, power use for Wi-Fi 573radio, Bluetooth radio, and cellular radio was tracked in the <em>m</em> (Misc) 574section category. In Android 6.0 and higher, power use for these components is 575tracked in the <em>pwi</em> (Power Use Item) section with individual labels 576(<em>wifi</em>, <em>blue</em>, <em>cell</em>) for each component.</p>