- From: Max Froumentin via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 23 Feb 2010 13:26:28 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/system-info
In directory hutz:/tmp/cvs-serv28672
Modified Files:
Overview.html
Log Message:
changes following Bryan's feedback:
- battery properties more aligned with DCO
- mapping to DCO through a new appendix
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/system-info/Overview.html,v
retrieving revision 1.79
retrieving revision 1.80
diff -u -d -r1.79 -r1.80
--- Overview.html 18 Feb 2010 10:07:40 -0000 1.79
+++ Overview.html 23 Feb 2010 13:26:26 -0000 1.80
@@ -467,47 +467,41 @@
<h4>The <a>Power</a> Property</h4>
<p>This property reflects the general state of the system's power sources</p>
- <p class="issue">Find the corresponding DCO properties everywhere</p>
-
-
<dl title="[NoInterfaceObject] interface Power : SystemProperty" class="idl">
<dt>readonly attribute float? level</dt>
<dd>
Specifies how much the internal power source remains,
- scaled from 0 to 1. A value of 0 means that the battery
+ scaled from 0 to 100. A value of 0 means that the battery
level is lowest before the system enters shutdown mode,
- and 1 indicates that the system's charge is maximal. Any
+ and 100 indicates that the system's charge is maximal. Any
threshold parameter used in a <a>watch</a> function to
monitor this property applies to this attribute.
</dd>
<dt>readonly attribute unsigned long? timeRemaining</dt>
- <dd>
- Represents the estimated time remaining in seconds
- before the system enters shutdown mode. If
- <a>isExternal</a> is <code>true</code>, this
- value MUST be <code>null</code>, meaning that there is
- essentially infinite time remaining.
- </dd>
-
- <dt>readonly attribute boolean isExternal</dt>
- <dd>
- If <code>true</code> the device is currently powered by an
- external source. If <code>false</code> the device is
- currently powered by an internal source.
- </dd>
- <dt>readonly attribute boolean isCharging</dt>
+ <dd>Represents the estimated time remaining in seconds
+ before the battery will be depleted, based upon current
+ power usage. If <a>batteryBeingCharged</a> is
+ <code>true</code>, then this value represents the
+ estimated time remaining in seconds before the battery is
+ depleted, based upon current power usage, if external
+ power were removed.</dd>
+
+
+ <dt>readonly attribute boolean batteryBeingCharged</dt>
<dd>
Indicates whether the internal power source is currently
- charging. If <a>isExternal</a> is <code>false</code>,
- this value MUST be <code>false</code>, meaning that the
- battery is currently powering the system, and is
- therefore depleting.
+ charging, or is fully charged. If the value is
+ <code>true</code>, then an external power source is
+ currently powering the system. If the value is
+ <code>false</code> then the battery is powering the
+ device, and is consequently depleting.
</dd>
</dl>
+
</section>
</section>
<!--******************** /Power **********************************-->
@@ -714,8 +708,16 @@
<dt>readonly attribute DOMString? operatorName</dt>
<dd>The name of the cellular connection's operator if applicable, <code>null</code> otherwise</dd>
+ <dt>const unsigned short ROAMING_NATIONAL = 5000</dt>
+ <dt>const unsigned short ROAMING_INTERNATIONAL = 5001</dt>
+
<dt>readonly attribute boolean? roaming</dt>
- <dd>Whether the connection is set up while the device is roaming, if applicable. <code>null</code> otherwise</dd>
+ <dd>Indicates if this connection is roaming. If it is
+ roaming nationally, this attribute's value MUST be
+ returned as <a>ROAMING_NATIONAL</a>. If it is roaming
+ internationally, this attribute's value MUST be returned
+ as <a>ROAMING_INTERNATIONAL</a>. If it is not roaming this
+ attribute's value MUST be <code>null</code>.</dd>
</dl>
<p class="issue">Should we gather all of GSM, GPRS, EDGE, CDMA, TETRA, UMTS under a singe "CELL" type? They could be differentiated by maxBandwidth, if needed.</p>
@@ -1268,6 +1270,22 @@
<p class="issue">extensibility of enumerated constants, e.g. connection types</p>
</section>
+
+ <!--************************************* Requirements & Use cases *******************************************-->
+ <section class="informative appendix">
+ <h2>Mapping to the W3C Delivery Context Ontology</h2>
+ <p>The table below indicates the correspondance between this specification's property attributes and [[DCONTOLOGY]] properties</p>
+ <table>
+ <thead><tr><th>System Information</th><th>Delivery Context Ontology</th></tr></thead>
+ <tbody>
+ <tr><td><code>Power.level</code></td><td><code>hard:batteryLevel</code></td></tr>
+ <tr><td><code>Power.timeRemaining</code></td><td><code>hard:batteryTimeRemaining</code></td></tr>
+ <tr><td><code>Power.batteryBeingCharged</code></td><td><code>hard:batteryBeingCharged</code></td></tr>
+ </tbody>
+ </table>
+ </section>
+
+
<!--************************************* Requirements & Use cases *******************************************-->
<section class="informative appendix">
<h2>Requirements & Use cases</h2>
Received on Tuesday, 23 February 2010 13:26:29 UTC