- From: Max Froumentin via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 02 Mar 2010 16:40:02 +0000
- To: public-dap-commits@w3.org
Update of /sources/public/2009/dap/system-info
In directory hutz:/tmp/cvs-serv17134
Modified Files:
Overview.html
Log Message:
-simplified network types
-added MCC and MNC
Index: Overview.html
===================================================================
RCS file: /sources/public/2009/dap/system-info/Overview.html,v
retrieving revision 1.85
retrieving revision 1.86
diff -u -d -r1.85 -r1.86
--- Overview.html 1 Mar 2010 16:08:19 -0000 1.85
+++ Overview.html 2 Mar 2010 16:39:59 -0000 1.86
@@ -606,63 +606,26 @@
<section>
<h4>The <a>Network</a> Property</h4>
- <p>This property provides information on the system's connection to the network</p>
+ <p>This Property describes a network connection.</p>
<dl title='[NoInterfaceObject] interface Network : SystemProperty' class='idl'>
<dt>const unsigned short TYPE_UNKNOWN = 0</dt>
<dd>The API is unable to determine the network technology.</dd>
- <dt>const unsigned short TYPE_ETHERNET = 1</dt>
- <dd>Indicates that the network technology is IEEE802.3, otherwise known as ethernet.</dd>
-
- <dt>const unsigned short TYPE_IEEE802_11 = 2</dt>
- <dd>Indicates that the network technology is IEEE802.11.</dd>
-
- <dt>const unsigned short TYPE_GSM = 3</dt>
- <dd>Global System for Mobile communications.</dd>
-
- <dt>const unsigned short TYPE_GPRS = 4</dt>
- <dd>General Packet Radio Service.</dd>
+ <dt>const unsigned short TYPE_WIRED = 1</dt>
+ <dd>Indicates that this connection is wired (e.g. ethernet).</dd>
- <dt>const unsigned short TYPE_EDGE = 5</dt>
- <dd>Enhanced Data Rates for GSM Evolution.</dd>
+ <dt>const unsigned short TYPE_WIFI = 2</dt>
+ <dd>Indicates that this connection is through a WiFi network (e.g. IEEE802.11)</dd>
- <dt>const unsigned short TYPE_CDMA = 6</dt>
- <dd>Code Division Multiple Access.</dd>
+ <dt>const unsigned short TYPE_PLM = 3</dt>
+ <dd>Indicates that this connection is through a <em>Public
+ Land Mobile</em> network (e.g. GSM)</dd>
- <dt>const unsigned short TYPE_WiMAX = 7</dt>
- <dd>
- Worldwide Interoperability for Microwave Access.
- </dd>
- <dt>const unsigned short TYPE_iDEN = 8</dt>
- <dd>
- Integrated Digital Enhanced Connection.
- </dd>
- <dt>const unsigned short TYPE_TETRA = 9</dt>
- <dd>
- Terrestrial Trunked Radio.
- <p>The associated <a>Connection</a> object is a <a>CellularConnection</a> object.</p>
- </dd>
- <dt>const unsigned short TYPE_UMTS = 10</dt>
- <dd>
- Universal Mobile Telecommunications System. Otherwise known as 3G.
- <p>The associated <a>Connection</a> object is a <a>CellularConnection</a> object.</p>
- </dd>
- <dt>const unsigned short TYPE_BLUETOOTH = 11</dt>
- <dd>
- BlueTooth
- </dd>
- <dt>const unsigned short TYPE_IRDA = 12</dt>
- <dd>
- Infrared
- </dd>
- <dt>const unsigned short TYPE_USB = 13</dt>
- <dd>
- USB
- </dd>
<dt>readonly attribute unsigned short type</dt>
- <dd>This attribute indicates the network technology in use on a network.</dd>
-
+ <dd>Indicates the network technology in use. The value
+ MUST be one of the constants defined in this
+ interface.</dd>
<dt>readonly attribute unsigned long currentDownloadBandwidth</dt>
<dd>
@@ -675,13 +638,14 @@
</dd>
<dt>readonly attribute unsigned long maxDownloadBandwidth</dt>
- <dd>This property represents the maximum download bandwidth offered by this network connection, measured in Kbits/s.</dd>
+ <dd>This property represents the maximum download
+ bandwidth offered by this network connection, measured in
+ Kbits/s.</dd>
<dt>readonly attribute unsigned long maxUploadBandwidth</dt>
- <dd>This property represents the maximum upload bandwidth offered by this network connection, measured in Kbits/s.</dd>
-
- <dt>readonly attribute float? currentSignalStrength</dt>
- <dd>This connection's signal strength, as a normalized value between 0 (no signal detected) and 1 (the level is at its maximum value). . This value MUST be <code>null</code> if this connection is wired.</dd>
+ <dd>This property represents the maximum upload bandwidth
+ offered by this network connection, measured in
+ Kbits/s.</dd>
<dt>readonly attribute DOMString macAddress</dt>
<dd>The <abbr title="Media Access Control">MAC</abbr>
@@ -691,30 +655,52 @@
e.g. 01:23:45:67:89:ab [[!IEEE802-3]]</dd>
<dt>readonly attribute DOMString ipAddress</dt>
- <dd>
- The IP Address assigned to the device by the network bearer. An implementation
- MUST support both IPv4 and IPv6.
- </dd>
+ <dd>The IP Address assigned to the device by the network
+ bearer. A user agent MUST be able to report both IPv4 and
+ IPv6 addresses.</dd>
+
+ <dt>readonly attribute float? currentSignalStrength</dt>
+ <dd>This connection's signal strength, as a normalized
+ value between 0 (no signal detected) and 1 (the level is
+ at its maximum value). A value of <code>null</code>
+ indicates that this property is not applicable to this
+ connection type.</dd>
<dt>readonly attribute DOMString? ESSID</dt>
- <dd>The Extended Service Set Identifier (ESSID) if the
- <a>type</a> attribute is TYPE_IEE802.11, <code>null</code>
- otherwise.</dd>
+ <dd>The Extended Service Set Identifier (ESSID) of this
+ connection. A value of <code>null</code> indicates that
+ this property is not applicable to this connection
+ type.</dd>
<dt>readonly attribute DOMString? apn</dt>
- <dd>The Access Point Name associated to a network bearer, if applicable. <code>null</code> otherwise.</dd>
+ <dd>The Access Point Name associated to a network bearer,
+ if applicable. A value of <code>null</code>
+ indicates that this property is not applicable to this
+ connection type.</dd>
<dt>readonly attribute DOMString? operatorName</dt>
- <dd>The name of the cellular connection's operator if applicable, <code>null</code> otherwise</dd>
+ <dd>The name of the cellular connection's operator. A
+ value of <code>null</code> indicates that this property is
+ not applicable to this connection type.</dd>
- <dt>readonly attribute boolean roaming</dt>
+ <dt>readonly attribute boolean? roaming</dt>
<dd>Indicates if this connection is roaming. A value of
<code>true</code> indicates that the connection is
roaming, while <code>false</code> indicates that it
- isn't.</dd>
- </dl>
+ isn't. A value of <code>null</code> indicates that this
+ property is not applicable to this connection type.</dd>
- <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>
+ <dt>readonly attribute unsigned short? mcc</dt>
+ <dd>This connection's <em>mobile country code</em>, as
+ defined by [[!ITUMCC]]. A value of <code>null</code>
+ indicates that this property is not applicable to this
+ connection type.</dd>
+ <dt>readonly attribute unsigned short? mnc</dt>
+ <dd>This connection's <em>mobile network code</em>, as
+ defined by [[!ITUMNC]]. A value of <code>null</code>
+ indicates that this property is not applicable to this
+ connection type.</dd>
+ </dl>
</section>
</section>
<!--******************** /Network **********************************-->
@@ -1265,20 +1251,23 @@
<p class="issue">extensibility of enumerated constants, e.g. connection types</p>
</section>
- <!--************************************* Requirements & Use cases *******************************************-->
+ <!--************************************* DCO Mapping *******************************************-->
<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>
+ <p>The table below indicates the correspondance between this
+ specification's property and attributes, and [[DCONTOLOGY]]
+ classes and properties</p>
+ <table border="1">
<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>
+ <tr><td><code>Network</code></td><td><code>net:Network</code></td></tr>
</tbody>
</table>
</section>
-
+
<!--************************************* Requirements & Use cases *******************************************-->
<section class="informative appendix">
Received on Tuesday, 2 March 2010 16:40:03 UTC