[systeminfo, notification] modify doc
authorHyunjin Park <hj.na.park@samsung.com>
Fri, 21 Aug 2015 02:01:32 +0000 (11:01 +0900)
committerHyunjin Park <hj.na.park@samsung.com>
Tue, 15 Sep 2015 08:51:38 +0000 (17:51 +0900)
- doc from http://168.219.209.56/gerrit/#/c/64885/

Change-Id: I861998ea9deefe861c87fbde3c3927e4a9b24a8e
Signed-off-by: Annie park <hj.na.park@samsung.com>
org.tizen.web.apireference/html/device_api/mobile/tizen/notification.html
org.tizen.web.apireference/html/device_api/mobile/tizen/systeminfo.html

index 3feff76..96883ff 100644 (file)
@@ -32,6 +32,8 @@ For more information on the Notification features, see <a href="../../../../../o
 </li>
 <li>1.4. <a href="#NotificationProgressType">NotificationProgressType</a>
 </li>
+<li>1.5. <a href="#LEDCustomFlags">LEDCustomFlags</a>
+</li>
 </ul>
 </li>
 <li>2. <a href="#interfaces-section">Interfaces</a><ul class="toc">
@@ -49,7 +51,9 @@ For more information on the Notification features, see <a href="../../../../../o
 </li>
 </ul>
 </li>
-<li>3. <a href="#full-webidl">Full WebIDL</a>
+<li>3. <a href="#api-features">Related Feature</a>
+</li>
+<li>4. <a href="#full-webidl">Full WebIDL</a>
 </li>
 </ul>
 <hr>
@@ -71,7 +75,9 @@ For more information on the Notification features, see <a href="../../../../../o
     void <a href="#NotificationManager::remove">remove</a> (<a href="#NotificationId">NotificationId</a> id)<br>
     void <a href="#NotificationManager::removeAll">removeAll</a> ()<br>
     <a href="#Notification">Notification</a> <a href="#NotificationManager::get">get</a> (<a href="#NotificationId">NotificationId</a> id)<br>
-    <a href="#Notification">Notification</a>[] <a href="#NotificationManager::getAll">getAll</a> ()</td>
+    <a href="#Notification">Notification</a>[] <a href="#NotificationManager::getAll">getAll</a> ()<br>
+    void <a href="#NotificationManager::playLEDCustomEffect">playLEDCustomEffect</a> (long timeOn, long timeOff, DOMString color, <a href="#LEDCustomFlags">LEDCustomFlags</a>[] flags)<br>
+    void <a href="#NotificationManager::stopLEDCustomEffect">stopLEDCustomEffect</a> ()</td>
 </tr>
 <tr>
 <td><a href="#Notification">Notification</a></td>
@@ -175,6 +181,26 @@ The following notification progress types are supported:
           </ul>
          </div>
 </div>
+<div class="enum" id="LEDCustomFlags">
+<a class="backward-compatibility-anchor" name="::Notification::LEDCustomFlags"></a><h3>1.5. LEDCustomFlags</h3>
+<div class="brief">
+ Specifies custom LED flags.
+The following values are supported in this release :
+          </div>
+<pre class="webidl prettyprint">    enum LEDCustomFlags {"LED_CUSTOM_DUTY_ON", "LED_CUSTOM_DEFAULT"};</pre>
+<p><span class="version">
+            Since: </span>
+ 2.4
+          </p>
+<div class="description">
+          <ul>
+            <li>
+LED_CUSTOM_DUTY_ON, blink LED            </li>
+            <li>
+LED_CUSTOM_DEFAULT, default flag            </li>
+          </ul>
+         </div>
+</div>
 </div>
 <div class="interfaces" id="interfaces-section">
 <h2>2. Interfaces</h2>
@@ -217,6 +243,9 @@ Notification API.
 
     <a href="#Notification">Notification</a>[] getAll() raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
 
+        void playLEDCustomEffect(long timeOn, long timeOff, DOMString color, <a href="#LEDCustomFlags">LEDCustomFlags</a>[] flags) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
+
+        void stopLEDCustomEffect() raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
     };</pre>
 <p><span class="version">
             Since: </span>
@@ -264,9 +293,6 @@ The NotificationManager interface provides access to the notification object.
 <p><span class="except">Exceptions:</span></p>
           <ul class="exception"><li>WebAPIException<ul>
 <li class="list"><p>
- with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
-                </p></li>
-<li class="list"><p>
  with error type InvalidValuesError, if any of the input
 parameters contain an invalid value.
                 </p></li>
@@ -274,6 +300,9 @@ parameters contain an invalid value.
  with error type SecurityError, if the application does not have the privilege to call this method.
                 </p></li>
 <li class="list"><p>
+ with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
+                </p></li>
+<li class="list"><p>
  with error type UnknownError, if any other error occurs.
                 </p></li>
 </ul>
@@ -337,9 +366,6 @@ parameters contain an invalid value.
 <p><span class="except">Exceptions:</span></p>
           <ul class="exception"><li>WebAPIException<ul>
 <li class="list"><p>
- with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
-                </p></li>
-<li class="list"><p>
  with error type InvalidValuesError, if any of the input
 parameters contain an invalid value.
                 </p></li>
@@ -347,6 +373,9 @@ parameters contain an invalid value.
  with error type SecurityError, if the application does not have the privilege to call this method.
                 </p></li>
 <li class="list"><p>
+ with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
+                </p></li>
+<li class="list"><p>
  with error type UnknownError, if any other error occurs.
                 </p></li>
 </ul>
@@ -397,15 +426,15 @@ parameters contain an invalid value.
 <p><span class="except">Exceptions:</span></p>
           <ul class="exception"><li>WebAPIException<ul>
 <li class="list"><p>
- with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
-                </p></li>
-<li class="list"><p>
  with error type NotFoundError, if NotificationId is not found in the previously posted notification.
                 </p></li>
 <li class="list"><p>
  with error type SecurityError, if the application does not have the privilege to call this method.
                 </p></li>
 <li class="list"><p>
+ with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter.
+                </p></li>
+<li class="list"><p>
  with error type UnknownError, if any other error occurs.
                 </p></li>
 </ul>
@@ -552,6 +581,127 @@ parameters contain an invalid value.
  </pre>
 </div>
 </dd>
+<dt class="method" id="NotificationManager::playLEDCustomEffect">
+<a class="backward-compatibility-anchor" name="::Notification::NotificationManager::playLEDCustomEffect"></a><code><b><span class="methodName">playLEDCustomEffect</span></b></code>
+</dt>
+<dd>
+<div class="brief">
+ Plays the custom effect of the service LED that is located to the front of a device.
+            </div>
+<div class="synopsis"><pre class="signature prettyprint">void playLEDCustomEffect(long timeOn, long timeOff, DOMString color, <a href="#LEDCustomFlags">LEDCustomFlags</a>[] flags);
+             </pre></div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+<div class="description">
+            <p>
+Given parameters consist of timeOn and timeOff in miliseconds, RGBA color and LEDCustomFlags combination.
+For the color first three bytes are RGB values. The last byte is opacity. For example "#FFFF0080". There is also another possibility when the last byte
+is not given (in this case alpha is assumed to have value 0xff). In this case only RGB values are given. For example: "#ff0000" that is equivalent of "#ff0000ff".
+            </p>
+           </div>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/led
+            </p>
+<div class="parameters">
+<p><span class="param">Parameters:</span></p>
+<ul>
+          <li class="param">
+<span class="name">timeOn</span>:
+ Turn on time in milliseconds
+                </li>
+          <li class="param">
+<span class="name">timeOff</span>:
+ Turn off time in milliseconds
+                </li>
+          <li class="param">
+<span class="name">color</span>:
+ The RGBA color value. The first three bytes are RGB values. The last byte is opacity. Exemplary string "#FFFF0080".
+                </li>
+          <li class="param">
+<span class="name">flags</span>:
+ The combination of enum LEDCustomFlags
+                </li>
+        </ul>
+</div>
+<div class="exceptionlist">
+<p><span class="except">Exceptions:</span></p>
+          <ul class="exception"><li>WebAPIException<ul>
+<li class="list"><p>
+ with error type InvalidValuesError, if any of the input parameters contain an invalid value.
+                </p></li>
+<li class="list"><p>
+ with error type SecurityError, if the application does not have the privilege to call this method or if the author signature does not match that of the designated application.
+                </p></li>
+<li class="list"><p>
+ with error type TypeMismatchError, if any input parameter is not compatible with the expected type for that parameter
+                </p></li>
+<li class="list"><p>
+ with error type UnknownError, if the method cannot be completed because of an unknown error.
+                </p></li>
+</ul>
+</li></ul>
+        </div>
+<div class="example">
+<span class="example"><p>Code example:</p></span><pre name="code" class="examplecode prettyprint"> try {
+     tizen.notification.playLEDCustomEffect(1000, 1000, "#FFFF0080", ["LED_CUSTOM_DUTY_ON", "LED_CUSTOM_DEFAULT"]);
+ } catch(e) {
+     console.log("Error Exception, error name : " + e.name + ", error message : " + e.message);
+ }
+ </pre>
+</div>
+</dd>
+<dt class="method" id="NotificationManager::stopLEDCustomEffect">
+<a class="backward-compatibility-anchor" name="::Notification::NotificationManager::stopLEDCustomEffect"></a><code><b><span class="methodName">stopLEDCustomEffect</span></b></code>
+</dt>
+<dd>
+<div class="brief">
+ Stops the custom effect of the service LED that is located to the front of a device.
+            </div>
+<div class="synopsis"><pre class="signature prettyprint">void stopLEDCustomEffect();
+             </pre></div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/led
+            </p>
+<div class="exceptionlist">
+<p><span class="except">Exceptions:</span></p>
+          <ul class="exception"><li>WebAPIException<ul>
+<li class="list"><p>
+ with error type SecurityError,  if the application does not have the privilege to call this method.
+                </p></li>
+<li class="list"><p>
+ with error type UnknownError, if the method cannot be completed because of an unknown error.
+                </p></li>
+</ul>
+</li></ul>
+        </div>
+<div class="example">
+<span class="example"><p>Code example:</p></span><pre name="code" class="examplecode prettyprint"> try {
+     tizen.notification.playLEDCustomEffect(1000, 1000, "#FFFF0080", ["LED_CUSTOM_DUTY_ON", "LED_CUSTOM_DEFAULT"]);
+     setTimeout(function () {
+         tizen.notification.stopLEDCustomEffect();
+     }, 5000);
+ } catch(e) {
+     console.log("Error Exception, error name : " + e.name + ", error message : " + e.message);
+ }
+ </pre>
+</div>
+</dd>
 </dl>
 </div>
 </div>
@@ -1025,7 +1175,21 @@ By default, this attribute is set to <var>null</var>.
 </div>
 </div>
 </div>
-<h2 id="full-webidl">3. Full WebIDL</h2>
+<h2 id="api-features">3. Related Feature</h2>
+<div id="def-api-features" class="def-api-features">
+        You can check if this API is supported with <em>tizen.systeminfo.getCapability()</em> and decide enable/disable codes that need this API.
+                    <div class="def-api-feature">
+<p><div class="description">
+            <p>
+If an application uses playLEDCustomEffect() or stopLEDCustomEffect(), declare the following feature requirements in the config file to guarantee the running of this application on a device which has a led:
+            </p>
+           </div></p>
+<li class="feature">http://tizen.org/feature/led</li>
+</div>
+<p></p>
+                    For more information, see <a href="../../../../../org.tizen.gettingstarted/html/web/details/app_filtering_w.htm">Application Filtering.</a>
+</div>
+<h2 id="full-webidl">4. Full WebIDL</h2>
 <pre class="webidl prettyprint">module Notification {
 
     typedef DOMString NotificationId;
@@ -1036,6 +1200,7 @@ By default, this attribute is set to <var>null</var>.
 
     enum NotificationProgressType { "PERCENTAGE",  "BYTE" };
 
+    enum LEDCustomFlags {"LED_CUSTOM_DUTY_ON", "LED_CUSTOM_DEFAULT"};
 
     [NoInterfaceObject] interface NotificationObject {
         readonly attribute <a href="#NotificationManager">NotificationManager</a> notification;
@@ -1056,6 +1221,9 @@ By default, this attribute is set to <var>null</var>.
 
     <a href="#Notification">Notification</a>[] getAll() raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
 
+        void playLEDCustomEffect(long timeOn, long timeOff, DOMString color, <a href="#LEDCustomFlags">LEDCustomFlags</a>[] flags) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
+
+        void stopLEDCustomEffect() raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
     };
 
 
index e2f197b..14fcf32 100644 (file)
 This API also provides interfaces and methods that can retrieve statuses of hardware devices, get the value of selected properties, and subscribe to asynchronous notifications of changes for selected values.
         </p>
         <p>
-The following provides an overview of the tree data structure:
+Web applications can use this API to access the following system properties:
         </p>
         <ul>
           <li>
 BATTERY          </li>
           <li>
+BUILD          </li>
+          <li>
+CAMERA_FLASH (<b>Since</b>: 2.4)          </li>
+          <li>
+CELLULAR_NETWORK          </li>
+          <li>
 CPU          </li>
           <li>
-STORAGE          </li>
+DEVICE_ORIENTATION          </li>
           <li>
 DISPLAY          </li>
           <li>
-DEVICE_ORIENTATION          </li>
+ETHERNET_NETWORK (<b>Since</b>: 2.4)          </li>
           <li>
-BUILD          </li>
+LOCALE (<b>Since</b>: 2.1)          </li>
           <li>
-LOCALE          </li>
+MEMORY (<b>Since</b>: 2.3)          </li>
           <li>
 NETWORK          </li>
           <li>
-WIFI_NETWORK          </li>
-          <li>
-CELLULAR_NETWORK          </li>
+PERIPHERAL (<b>Since</b>: 2.1)          </li>
           <li>
 SIM          </li>
           <li>
-PERIPHERAL          </li>
-          <li>
-MEMORY          </li>
+STORAGE          </li>
           <li>
-CAMERA_FLASH          </li>
+WIFI_NETWORK          </li>
         </ul>
         <p>
 Not all above properties may be available on every Tizen device. For instance, a device may not support the telephony feature. In that case, <var>CELLULAR_NETWORK</var> and <var>SIM</var> are not available.<br><br>To check the available <var>SystemInfoPropertyId</var>, <em>tizen.systeminfo.getCapability()</em> can be used.
@@ -56,13 +58,17 @@ Not all above properties may be available on every Tizen device. For instance, a
           <li>
  BATTERY          - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/battery"</em>)          </li>
           <li>
- DISPLAY          - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/screen"</em>)          </li>
-          <li>
- WIFI_NETWORK     - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/network.wifi"</em>)          </li>
+ CAMERA_FLASH     - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/camera.back.flash"</em>)          </li>
           <li>
  CELLULAR_NETWORK - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/network.telephony"</em>)          </li>
           <li>
+ DISPLAY          - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/screen"</em>)          </li>
+          <li>
+ ETHERNET_NETWORK - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/network.ethernet"</em>)          </li>
+          <li>
  SIM              - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/network.telephony"</em>)          </li>
+          <li>
+ WIFI_NETWORK     - tizen.systeminfo.getCapability(<em>"http://tizen.org/feature/network.wifi"</em>)          </li>
         </ul>
         <p>
 For more information on the SystemInfo features, see <a href="../../../../../org.tizen.guides/html/web/tizen/system/system_info_w.htm">System Information Guide</a>.
@@ -124,15 +130,17 @@ For more information on the SystemInfo features, see <a href="../../../../../org
 </li>
 <li>2.17. <a href="#SystemInfoWifiNetwork">SystemInfoWifiNetwork</a>
 </li>
-<li>2.18. <a href="#SystemInfoCellularNetwork">SystemInfoCellularNetwork</a>
+<li>2.18. <a href="#SystemInfoEthernetNetwork">SystemInfoEthernetNetwork</a>
 </li>
-<li>2.19. <a href="#SystemInfoSIM">SystemInfoSIM</a>
+<li>2.19. <a href="#SystemInfoCellularNetwork">SystemInfoCellularNetwork</a>
 </li>
-<li>2.20. <a href="#SystemInfoPeripheral">SystemInfoPeripheral</a>
+<li>2.20. <a href="#SystemInfoSIM">SystemInfoSIM</a>
 </li>
-<li>2.21. <a href="#SystemInfoMemory">SystemInfoMemory</a>
+<li>2.21. <a href="#SystemInfoPeripheral">SystemInfoPeripheral</a>
 </li>
-<li>2.22. <a href="#SystemInfoCameraFlash">SystemInfoCameraFlash</a>
+<li>2.22. <a href="#SystemInfoMemory">SystemInfoMemory</a>
+</li>
+<li>2.23. <a href="#SystemInfoCameraFlash">SystemInfoCameraFlash</a>
 </li>
 </ul>
 </li>
@@ -227,6 +235,10 @@ For more information on the SystemInfo features, see <a href="../../../../../org
 <td></td>
 </tr>
 <tr>
+<td><a href="#SystemInfoEthernetNetwork">SystemInfoEthernetNetwork</a></td>
+<td></td>
+</tr>
+<tr>
 <td><a href="#SystemInfoCellularNetwork">SystemInfoCellularNetwork</a></td>
 <td></td>
 </tr>
@@ -255,19 +267,22 @@ For more information on the SystemInfo features, see <a href="../../../../../org
 <div class="brief">
  The device property identifier.
           </div>
-<pre class="webidl prettyprint">  enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK", "CELLULAR_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "CAMERA_FLASH" };</pre>
+<pre class="webidl prettyprint">  enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK", "ETHERNET_NETWORK", "CELLULAR_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "CAMERA_FLASH" };</pre>
 <p><span class="version">
             Since: </span>
  2.0
           </p>
 <p><span class="remark"> Remark : </span>
- <em>LOCALE</em> and <em>PERIPHERAL</em> are supported since Tizen 2.1
+ <em>CAMERA_FLASH</em> is supported since Tizen 2.4
           </p>
 <p><span class="remark"> Remark : </span>
- <em>MEMORY</em> is supported since Tizen 2.3
+ <em>ETHERNET_NETWORK</em> is supported since Tizen 2.4
           </p>
 <p><span class="remark"> Remark : </span>
- <em>CAMERA_FLASH</em> is supported since Tizen 2.4
+ <em>LOCALE</em> and <em>PERIPHERAL</em> are supported since Tizen 2.1
+          </p>
+<p><span class="remark"> Remark : </span>
+ <em>MEMORY</em> is supported since Tizen 2.3
           </p>
 </div>
 <div class="enum" id="SystemInfoNetworkType">
@@ -669,12 +684,23 @@ The <em>ErrorCallback</em> method can be launched with these error types:
 NotSupportedError - If the given <var>property</var> is not supported. (since Tizen 2.3)              </li>
             </ul>
            </div>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/telephony
+            </p>
 <p><span class="remark"> Remark : </span>
  If the given <var>property</var> is not supported, <em>NotSupportedError</em> would be passed through a <em>ErrorCallback()</em> since Tizen 2.3.
             </p>
 <p><span class="remark"> Remark : </span>
  If system provides more than one value for the system property, the primary(first) system property is returned through SystemInfoSuccessCallback.
             </p>
+<p><span class="remark"> Remark : </span>
+ <b>http://tizen.org/privilege/telephony</b> has been required only for <a href="#SystemInfoPropertyId">CELLULAR_NETWORK</a> property since Tizen 2.4.
+            </p>
 <div class="parameters">
 <p><span class="param">Parameters:</span></p>
 <ul>
@@ -701,6 +727,9 @@ NotSupportedError - If the given <var>property</var> is not supported. (since Ti
 <li class="list"><p>
  with error type UnknownError in any other error case.
                 </p></li>
+<li class="list"><p>
+ with error type SecurityError, this error is only thrown for <em>CELLULAR_NETWORK</em> property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
+                </p></li>
 </ul>
 </li></ul>
         </div>
@@ -765,9 +794,20 @@ The <em>ErrorCallback</em> method can be launched with these error types:
 NotSupportedError - If the given <var>property</var> is not supported.              </li>
             </ul>
            </div>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/telephony
+            </p>
 <p><span class="remark"> Remark : </span>
  see getCount().
             </p>
+<p><span class="remark"> Remark : </span>
+ <b>http://tizen.org/privilege/telephony</b> has been required only for <a href="#SystemInfoPropertyId">CELLULAR_NETWORK</a> property since Tizen 2.4.
+            </p>
 <div class="parameters">
 <p><span class="param">Parameters:</span></p>
 <ul>
@@ -787,9 +827,14 @@ NotSupportedError - If the given <var>property</var> is not supported.
 </div>
 <div class="exceptionlist">
 <p><span class="except">Exceptions:</span></p>
-          <ul class="exception"><li>WebAPIException<ul><li class="list"><p>
+          <ul class="exception"><li>WebAPIException<ul>
+<li class="list"><p>
  with error type TypeMismatchError, if the input parameter is not compatible with the expected type.
-                </p></li></ul>
+                </p></li>
+<li class="list"><p>
+ with error type SecurityError, this error is only thrown for <em>CELLULAR_NETWORK</em> property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
+                </p></li>
+</ul>
 </li></ul>
         </div>
 <div class="example">
@@ -858,9 +903,20 @@ NotSupportedError - If the given <var>property</var> is not supported. (since Ti
               </li>
             </ul>
            </div>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/telephony
+            </p>
 <p><span class="remark"> Remark : </span>
  The <em>errorCallback()</em> is newly added as an optional parameter since Tizen 2.3.
             </p>
+<p><span class="remark"> Remark : </span>
+ <b>http://tizen.org/privilege/telephony</b> has been required only for <a href="#SystemInfoPropertyId">CELLULAR_NETWORK</a> property since Tizen 2.4.
+            </p>
 <div class="parameters">
 <p><span class="param">Parameters:</span></p>
 <ul>
@@ -898,6 +954,9 @@ NotSupportedError - If the given <var>property</var> is not supported. (since Ti
 <li class="list"><p>
  with error type UnknownError in any other error case.
                 </p></li>
+<li class="list"><p>
+ with error type SecurityError, this error is only thrown for <em>CELLULAR_NETWORK</em> property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
+                </p></li>
 </ul>
 </li></ul>
         </div>
@@ -938,6 +997,17 @@ There are device properties which never change (for example "BUILD") and propert
 any identifier of these properties, but the listener added for them will not be invoked.
             </p>
            </div>
+<p><span class="privilegelevel">
+            Privilege level: </span>
+ public
+            </p>
+<p><span class="privilege">
+            Privilege: </span>
+ http://tizen.org/privilege/telephony
+            </p>
+<p><span class="remark"> Remark : </span>
+ <b>http://tizen.org/privilege/telephony</b> has been required only for <a href="#SystemInfoPropertyId">CELLULAR_NETWORK</a> property since Tizen 2.4.
+            </p>
 <div class="parameters">
 <p><span class="param">Parameters:</span></p>
 <ul>
@@ -975,6 +1045,9 @@ any identifier of these properties, but the listener added for them will not be
 <li class="list"><p>
  with error type UnknownError in any other error case.
                 </p></li>
+<li class="list"><p>
+ with error type SecurityError, this error is only thrown for <em>CELLULAR_NETWORK</em> property when an application does not declare http://tizen.org/privilege/telephony privilege in config.xml.
+                </p></li>
 </ul>
 </li></ul>
         </div>
@@ -2686,8 +2759,90 @@ It is written in MM:MM:MM:SS:SS:SS format.
 </ul>
 </div>
 </div>
+<div class="interface" id="SystemInfoEthernetNetwork">
+<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoEthernetNetwork"></a><h3>2.18. SystemInfoEthernetNetwork</h3>
+<div class="brief">
+ This property reflects the information of the Ethernet network in this system.
+          </div>
+<pre class="webidl prettyprint">   [NoInterfaceObject] interface SystemInfoEthernetNetwork : <a href="#SystemInfoProperty">SystemInfoProperty</a> {
+    readonly attribute DOMString cable;
+
+    readonly attribute DOMString status;
+
+    readonly attribute DOMString ipAddress;
+
+    readonly attribute DOMString ipv6Address;
+
+    readonly attribute DOMString macAddress;
+  };</pre>
+<p><span class="version">
+            Since: </span>
+ 2.4
+          </p>
+        
+      <div class="attributes">
+<h4>Attributes</h4>
+<ul>
+<li class="attribute" id="SystemInfoEthernetNetwork::cable">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">DOMString </span><span class="name">cable</span></span><div class="brief">
+ Represents the cable status (ATTACHED or DETACHED) of the ethernet interface.
+            </div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+</li>
+<li class="attribute" id="SystemInfoEthernetNetwork::status">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">DOMString </span><span class="name">status</span></span><div class="brief">
+ Represents the status (DEACTIVATED, DISCONNECTED or CONNECTED) of the ethernet interface.
+            </div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+</li>
+<li class="attribute" id="SystemInfoEthernetNetwork::ipAddress">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">DOMString </span><span class="name">ipAddress</span></span><div class="brief">
+ Represents the IPv4 address of the ethernet network.
+            </div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+</li>
+<li class="attribute" id="SystemInfoEthernetNetwork::ipv6Address">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">DOMString </span><span class="name">ipv6Address</span></span><div class="brief">
+ Represents the IPv6 address of the ethernet network.
+            </div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+</li>
+<li class="attribute" id="SystemInfoEthernetNetwork::macAddress">
+<span class="attrName"><span class="readonly">                readonly
+</span><span class="type">DOMString </span><span class="name">macAddress</span></span><div class="brief">
+ Represents the MAC address of the ethernet interface.
+            </div>
+<div class="description">
+            <p>
+It is written in MM:MM:MM:SS:SS:SS format.
+            </p>
+           </div>
+<p><span class="version">
+            Since: </span>
+ 2.4
+            </p>
+</li>
+</ul>
+</div>
+</div>
 <div class="interface" id="SystemInfoCellularNetwork">
-<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoCellularNetwork"></a><h3>2.18. SystemInfoCellularNetwork</h3>
+<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoCellularNetwork"></a><h3>2.19. SystemInfoCellularNetwork</h3>
 <div class="brief">
  This property reflects the information of the Cellular network in this system.
           </div>
@@ -2841,7 +2996,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
             Privilege: </span>
  http://tizen.org/privilege/telephony
             </p>
-<p><span class="remark"> Remark : </span>
+<p class="warning"><b>Warning:</b>
  <em>http://tizen.org/privilege/systemmanager</em> <em>(partner level)</em> has been deprecated since 2.3.1. Instead, use <em>http://tizen.org/privilege/telephony</em>.
             </p>
 <div class="exceptionlist">
@@ -2856,7 +3011,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
 </div>
 </div>
 <div class="interface" id="SystemInfoSIM">
-<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoSIM"></a><h3>2.19. SystemInfoSIM</h3>
+<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoSIM"></a><h3>2.20. SystemInfoSIM</h3>
 <div class="brief">
  This property reflects the information of the SIM card information.
           </div>
@@ -2952,7 +3107,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
             Privilege: </span>
  http://tizen.org/privilege/telephony
             </p>
-<p><span class="remark"> Remark : </span>
+<p class="warning"><b>Warning:</b>
  <em>http://tizen.org/privilege/systemmanager</em> <em>(partner level)</em> has been deprecated since 2.3.1. Instead, use <em>http://tizen.org/privilege/telephony</em>.
             </p>
 <div class="exceptionlist">
@@ -3055,7 +3210,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
             Privilege: </span>
  http://tizen.org/privilege/telephony
             </p>
-<p><span class="remark"> Remark : </span>
+<p class="warning"><b>Warning:</b>
  <em>http://tizen.org/privilege/systemmanager</em> <em>(partner level)</em> has been deprecated since 2.3.1. Instead, use <em>http://tizen.org/privilege/telephony</em>.
             </p>
 <div class="exceptionlist">
@@ -3095,7 +3250,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
 </div>
 </div>
 <div class="interface" id="SystemInfoPeripheral">
-<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoPeripheral"></a><h3>2.20. SystemInfoPeripheral</h3>
+<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoPeripheral"></a><h3>2.21. SystemInfoPeripheral</h3>
 <div class="brief">
  This property reflects the peripheral information of the current device.
           </div>
@@ -3122,7 +3277,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
 </div>
 </div>
 <div class="interface" id="SystemInfoMemory">
-<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoMemory"></a><h3>2.21. SystemInfoMemory</h3>
+<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoMemory"></a><h3>2.22. SystemInfoMemory</h3>
 <div class="brief">
  This property represents information about the memory state on the device system.
           </div>
@@ -3150,7 +3305,7 @@ identify a mobile phone operator/carrier using the GSM, CDMA, iDEN, TETRA and UM
 </div>
 </div>
 <div class="interface" id="SystemInfoCameraFlash">
-<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoCameraFlash"></a><h3>2.22. SystemInfoCameraFlash</h3>
+<a class="backward-compatibility-anchor" name="::SystemInfo::SystemInfoCameraFlash"></a><h3>2.23. SystemInfoCameraFlash</h3>
 <div class="brief">
  The SystemInfoCameraFlash provides the way to control the attached the camera flash.
           </div>
@@ -3273,6 +3428,11 @@ The <em>getPropertyValue()</em> method retrieves the <var>SystemInfoCameraFlash<
             Since: </span>
  2.4
             </p>
+<div class="description">
+            <p>
+If the specified brightness value is not supported by the device, the brightness is rounded down to the nearest supported brightness value.
+            </p>
+           </div>
 <p><span class="privilegelevel">
             Privilege level: </span>
  public
@@ -3331,26 +3491,34 @@ The <em>getPropertyValue()</em> method retrieves the <var>SystemInfoCameraFlash<
                     <div class="def-api-feature">
 <p><div class="description">
             <p>
-To guarantee the running of this application on a device which supports Wi-Fi, declare the following feature requirements in the config file:
+To guarantee the running of the application on a device which has camera back flash and control it, declare the following feature requirements in the config file:
             </p>
            </div></p>
-<li class="feature">http://tizen.org/feature/network.wifi</li>
+<li class="feature">http://tizen.org/feature/camera.back.flash</li>
 </div>
 <div class="def-api-feature">
 <p><div class="description">
             <p>
-To guarantee the running of this application on a device which supports telephony feature, declare the following feature requirements in the config file:
+To guarantee the running of the application on a device which supports telephony feature, declare the following feature requirements in the config file:
             </p>
            </div></p>
 <li class="feature">http://tizen.org/feature/network.telephony</li>
 </div>
+<div class="def-api-feature">
+<p><div class="description">
+            <p>
+To guarantee the running of the application on a device which supports Wi-Fi, declare the following feature requirements in the config file:
+            </p>
+           </div></p>
+<li class="feature">http://tizen.org/feature/network.wifi</li>
+</div>
 <p></p>
-                    For more information, see <a href="../../../../../org.tizen.gettingstarted/html/details/app_filtering.htm#web">Application Filtering</a>.
+                    For more information, see <a href="../../../../../org.tizen.gettingstarted/html/web/details/app_filtering_w.htm">Application Filtering</a>.
 </div>
 <h2 id="full-webidl">4. Full WebIDL</h2>
 <pre class="webidl prettyprint">module SystemInfo {
 
-  enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK", "CELLULAR_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "CAMERA_FLASH" };
+  enum SystemInfoPropertyId { "BATTERY", "CPU", "STORAGE", "DISPLAY", "DEVICE_ORIENTATION", "BUILD", "LOCALE", "NETWORK", "WIFI_NETWORK", "ETHERNET_NETWORK", "CELLULAR_NETWORK", "SIM", "PERIPHERAL", "MEMORY", "CAMERA_FLASH" };
 
   enum SystemInfoNetworkType { "NONE", "2G", "2.5G", "3G", "4G", "WIFI", "ETHERNET", "UNKNOWN" };
 
@@ -3636,6 +3804,18 @@ To guarantee the running of this application on a device which supports telephon
     readonly attribute double signalStrength;
   };
 
+   [NoInterfaceObject] interface SystemInfoEthernetNetwork : <a href="#SystemInfoProperty">SystemInfoProperty</a> {
+    readonly attribute DOMString cable;
+
+    readonly attribute DOMString status;
+
+    readonly attribute DOMString ipAddress;
+
+    readonly attribute DOMString ipv6Address;
+
+    readonly attribute DOMString macAddress;
+  };
+
   [NoInterfaceObject] interface SystemInfoCellularNetwork : <a href="#SystemInfoProperty">SystemInfoProperty</a> {
 
     readonly attribute DOMString status;