<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License
"Eclipse Public License v1.0" which accompanies this distribution,
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
Nokia Corporation - initial contribution.
Contributors:
-->
<!DOCTYPE concept
PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-1E55DD3C-D699-5062-88C1-C826F06CD48C" xml:lang="en"><title>Power
API </title><shortdesc>Power API is a library API and provides the ability to request
the detailed information of the following: </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<ul>
<li id="GUID-E59636F9-45A9-5423-A2F6-5610EF320C28"><p><xref href="GUID-1E55DD3C-D699-5062-88C1-C826F06CD48C.dita#GUID-1E55DD3C-D699-5062-88C1-C826F06CD48C/GUID-EB45C8E3-2DFB-58CB-9C5A-231F1BD09393">Battery information</xref></p></li>
<li id="GUID-66BB4E68-B07D-595F-92F2-EE0BE03C41BB"><p><xref href="GUID-1E55DD3C-D699-5062-88C1-C826F06CD48C.dita#GUID-1E55DD3C-D699-5062-88C1-C826F06CD48C/GUID-49E784AB-D439-54A3-8DF5-A88FFB9B58E5">Battery voltage and current consumption</xref> </p> </li>
</ul>
<section id="GUID-EB45C8E3-2DFB-58CB-9C5A-231F1BD09393"><title>Battery information</title> <p>The
following are the battery information and is obtained from the battery driver: </p> <ul>
<li id="GUID-52148B48-BF74-5D79-848F-A66DD4B1BCEC"><p>Nominal battery capacity
- Maximum battery capacity and it decreases with time from usage and numbers
of recharges. </p> </li>
<li id="GUID-BC63C6AC-37C3-568A-B2A9-B456BD582431"><p>Remaining battery capacity
- Present battery capacity. </p> </li>
<li id="GUID-89308E1D-6DB3-5A2D-873D-88C4939597A3"><p>Remaining battery percentage </p> </li>
</ul> </section>
<section id="GUID-49E784AB-D439-54A3-8DF5-A88FFB9B58E5"><title>Battery voltage
and current consumption</title> <p>Power API simultaneously provides the following
battery voltage and current consumption information: </p> <ul>
<li id="GUID-3804FD0C-409E-50CD-BA55-8A11BBB9250F"><p>Average battery voltage
- the API returns the average battery voltage over a specified time interval. </p> </li>
<li id="GUID-0A7504A4-55D5-557B-9266-AC56AA980E35"><p>Minimum battery voltage
- minimum voltage on a battery that is required to drive the circuit. </p> </li>
<li id="GUID-4632964E-9827-5595-AA22-3F01B0F81ADD"><p>Maximum battery voltage
- maximum voltage that a battery can have. </p> </li>
<li id="GUID-CE6C4CA4-281A-5E6C-B352-FAC4E3F8247F"><p>Battery current consumption
- average current consumed between specified start and end times. </p> </li>
</ul> </section>
</conbody><related-links>
<link href="GUID-C3B6E5F6-74DC-5C0E-94C8-B4822F4A2EB6.dita"><linktext>Power API
Tutorial</linktext></link>
</related-links></concept>