[Systeminfo] Updating API reference and guide

PS3: Guide change reviewed

Change-Id: I09fec48f9100db0d23a8975d712f27e18cbf93ab
Signed-off-by: Szymon Jastrzebski <s.jastrzebsk@partner.samsung.com>

diff --git a/org.tizen.guides/html/web/device/system_information_w.htm b/org.tizen.guides/html/web/device/system_information_w.htm
index ae41f00..2347bfd 100644 (file)
--- a/org.tizen.guides/html/web/device/system_information_w.htm
+++ b/org.tizen.guides/html/web/device/system_information_w.htm
@@ -173,7 +173,7 @@ function successCallback(properties)
    console.log("The number of the returned system properties is " + properties.length);
    for (var i = 0; i properties.length; i++)
    {
-      console.log("[" + (i+1) + "] SIM's state is " + properties[i].state);
+      console.log("[" + (i + 1) + "] SIM's state is " + properties[i].state);
    }
 }
 
@@ -287,7 +287,7 @@ function successCallback(properties)
 {
    for (var i = 0; i properties.length; i++)
    {
-      console.log("[" + (i+1) + "] SIM's state is " + properties[i].state);
+      console.log("[" + (i + 1) + "] SIM's state is " + properties[i].state);
    }
    removePropertyValueChangeListener(id);
 }
@@ -310,7 +310,7 @@ var id = tizen.systeminfo.addPropertyValueArrayChangeListener("SIM", successCall
     <tr>
      <td><code>SystemInfoBattery</code> (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html#SystemInfoBattery">mobile</a>, <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo.html#SystemInfoBattery">wearable</a>, and <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/systeminfo.html#SystemInfoBattery">TV</a> applications)</td>
      <td><code>BATTERY</code></td>
-     <td>Provides information about the battery level and charging status. With this property, you can, for example, determine whether the application can be launched or whether the user needs to be warned about the level of power available for the device.</td>
+     <td>Provides information about the battery level and charging status. With this property, you can, for example, determine whether the application can be launched or whether the user needs to be warned about the level of power available for the device. Since Tizen 4.0, you can retrieve values about the estimated charging or discharging time of the battery.</td>
     </tr>
     <tr>
      <td><code>SystemInfoCpu</code> (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html#SystemInfoCpu">mobile</a>, <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo.html#SystemInfoCpu">wearable</a>, and <a href="../../../../org.tizen.web.apireference/html/device_api/tv/tizen/systeminfo.html#SystemInfoCpu">TV</a> applications)</td>

diff --git a/org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html b/org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html
index d585352..d775d14 100644 (file)
--- a/org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html
+++ b/org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html
@@ -2238,6 +2238,10 @@ It is used in asynchronous operations, such as getPropertyValueArray() or addPro
     readonly attribute double level;
 
     readonly attribute boolean isCharging;
+
+    readonly attribute long? timeToDischarge;
+
+    readonly attribute long? timeToFullCharge;
   };</pre>
 <p><span class="version">
             Since: </span>
@@ -2278,6 +2282,40 @@ Any threshold parameter used in a watch operation to monitor this property appli
  1.0
             </p>
 </li>
+<li class="attribute" id="SystemInfoBattery::timeToDischarge">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">long </span><span class="name">timeToDischarge</span><span class="optional"> [nullable]</span></span><div class="brief">
+ Estimated time to discharge, in minutes.
+            </div>
+<div class="description">
+            <p>
+This parameter is mutually exclusive with parameter <em>timeToFullCharge</em>.
+An attribute <em>timeToDischarge</em> becomes <var>null</var> when device is plugged.
+This attribute may equal to <var>-1</var> indicating there is no enough collected data, which means that the device is still learning. This process may take up to few days.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 4.0
+            </p>
+</li>
+<li class="attribute" id="SystemInfoBattery::timeToFullCharge">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">long </span><span class="name">timeToFullCharge</span><span class="optional"> [nullable]</span></span><div class="brief">
+ Estimated time to finish charging battery, in minutes.
+            </div>
+<div class="description">
+            <p>
+This parameter is mutually exclusive with parameter <em>timeToDischarge</em>.
+An attribute <em>timeToFullCharge</em> becomes <var>null</var> when device is unplugged.
+This attribute may equal to <var>-1</var> indicating there is no enough collected data, which means that the device is still learning. This process may take up to few days.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 4.0
+            </p>
+</li>
 </ul>
 </div>
 </div>
@@ -3700,6 +3738,10 @@ To guarantee the running of the application on a device which supports network p
     readonly attribute double level;
 
     readonly attribute boolean isCharging;
+
+    readonly attribute long? timeToDischarge;
+
+    readonly attribute long? timeToFullCharge;
   };
 
   [NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty {

diff --git a/org.tizen.web.apireference/html/device_api/tv/tizen/systeminfo.html b/org.tizen.web.apireference/html/device_api/tv/tizen/systeminfo.html
index b548270..19d0642 100644 (file)
--- a/org.tizen.web.apireference/html/device_api/tv/tizen/systeminfo.html
+++ b/org.tizen.web.apireference/html/device_api/tv/tizen/systeminfo.html
@@ -2387,6 +2387,10 @@ It is used in asynchronous operations, such as getPropertyValueArray() or addPro
     readonly attribute double level;
 
     readonly attribute boolean isCharging;
+
+    readonly attribute long? timeToDischarge;
+
+    readonly attribute long? timeToFullCharge;
   };</pre>
 <p><span class="version">
             Since: </span>
@@ -2427,6 +2431,40 @@ Any threshold parameter used in a watch operation to monitor this property appli
  1.0
             </p>
 </li>
+<li class="attribute" id="SystemInfoBattery::timeToDischarge">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">long </span><span class="name">timeToDischarge</span><span class="optional"> [nullable]</span></span><div class="brief">
+ Estimated time to discharge, in minutes.
+            </div>
+<div class="description">
+            <p>
+This parameter is mutually exclusive with parameter <em>timeToFullCharge</em>.
+An attribute <em>timeToDischarge</em> becomes <var>null</var> when device is plugged.
+This attribute may equal to <var>-1</var> indicating there is no enough collected data, which means that the device is still learning. This process may take up to few days.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 4.0
+            </p>
+</li>
+<li class="attribute" id="SystemInfoBattery::timeToFullCharge">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">long </span><span class="name">timeToFullCharge</span><span class="optional"> [nullable]</span></span><div class="brief">
+ Estimated time to finish charging battery, in minutes.
+            </div>
+<div class="description">
+            <p>
+This parameter is mutually exclusive with parameter <em>timeToDischarge</em>.
+An attribute <em>timeToFullCharge</em> becomes <var>null</var> when device is unplugged.
+This attribute may equal to <var>-1</var> indicating there is no enough collected data, which means that the device is still learning. This process may take up to few days.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 4.0
+            </p>
+</li>
 </ul>
 </div>
 </div>
@@ -4195,6 +4233,10 @@ To guarantee the running of the application on a device which supports network p
     readonly attribute double level;
 
     readonly attribute boolean isCharging;
+
+    readonly attribute long? timeToDischarge;
+
+    readonly attribute long? timeToFullCharge;
   };
 
   [NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty {

diff --git a/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo.html b/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo.html
index 1826af1..02a1a84 100644 (file)
--- a/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo.html
+++ b/org.tizen.web.apireference/html/device_api/wearable/tizen/systeminfo.html
@@ -2238,6 +2238,10 @@ It is used in asynchronous operations, such as getPropertyValueArray() or addPro
     readonly attribute double level;
 
     readonly attribute boolean isCharging;
+
+    readonly attribute long? timeToDischarge;
+
+    readonly attribute long? timeToFullCharge;
   };</pre>
 <p><span class="version">
             Since: </span>
@@ -2278,6 +2282,40 @@ Any threshold parameter used in a watch operation to monitor this property appli
  1.0
             </p>
 </li>
+<li class="attribute" id="SystemInfoBattery::timeToDischarge">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">long </span><span class="name">timeToDischarge</span><span class="optional"> [nullable]</span></span><div class="brief">
+ Estimated time to discharge, in minutes.
+            </div>
+<div class="description">
+            <p>
+This parameter is mutually exclusive with parameter <em>timeToFullCharge</em>.
+An attribute <em>timeToDischarge</em> becomes <var>null</var> when device is plugged.
+This attribute may equal to <var>-1</var> indicating there is no enough collected data, which means that the device is still learning. This process may take up to few days.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 4.0
+            </p>
+</li>
+<li class="attribute" id="SystemInfoBattery::timeToFullCharge">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">long </span><span class="name">timeToFullCharge</span><span class="optional"> [nullable]</span></span><div class="brief">
+ Estimated time to finish charging battery, in minutes.
+            </div>
+<div class="description">
+            <p>
+This parameter is mutually exclusive with parameter <em>timeToDischarge</em>.
+An attribute <em>timeToFullCharge</em> becomes <var>null</var> when device is unplugged.
+This attribute may equal to <var>-1</var> indicating there is no enough collected data, which means that the device is still learning. This process may take up to few days.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 4.0
+            </p>
+</li>
 </ul>
 </div>
 </div>
@@ -3700,6 +3738,10 @@ To guarantee the running of the application on a device which supports network p
     readonly attribute double level;
 
     readonly attribute boolean isCharging;
+
+    readonly attribute long? timeToDischarge;
+
+    readonly attribute long? timeToFullCharge;
   };
 
   [NoInterfaceObject] interface SystemInfoCpu : SystemInfoProperty {