Site updated at 2016-03-29 05:05:10 UTC

components/zwave/index.html

@@ -170,7 +170,7 @@ Instead of <code>make install</code>, you can alternatively build your own pytho
 <span class="key">zwave</span>:
   <span class="key">usb_path</span>: <span class="string"><span class="content">/dev/ttyUSB0</span></span>
   <span class="key">config_path</span>: <span class="string"><span class="content">/usr/local/share/python-openzwave/config</span></span>
-  <span class="key">polling_interval</span>: <span class="string"><span class="content">10000</span></span>
+  <span class="key">polling_interval</span>: <span class="string"><span class="content">60000</span></span>
   <span class="key">customize</span>:
     <span class="key">sensor.greenwave_powernode_6_port_energy_10</span>:
         <span class="key">polling_intensity</span>: <span class="string"><span class="content">1</span></span>
@@ -183,7 +183,7 @@ Instead of <code>make install</code>, you can alternatively build your own pytho
 <ul>
   <li><strong>usb_path</strong> (<em>Required</em>): The port where your device is connected to your Home Assistant host.</li>
   <li><strong>config_path</strong> (<em>Optional</em>): The path to the Python Open Z-Wave configuration files.</li>
-  <li><strong>polling_interval</strong> (<em>Optional</em>): The time period in milliseconds between polls of a nodes value.</li>
+  <li><strong>polling_interval</strong> (<em>Optional</em>): The time period in milliseconds between polls of a nodes value. Be careful about using polling values below 30000 (30 seconds) as polling can flood the zwave network and cause problems.</li>
   <li><strong>customize</strong> (<em>Optional</em>): This attribute contains node-specific override values:
     <ul>
       <li><strong>polling_intensity</strong> (<em>Optional</em>): Enables polling of a value and sets the frequency of polling (0=none, 1=every time through the list, 2-every other time, etc)</li>
@@ -233,7 +233,7 @@ Depending on what’s plugged into your USB ports, the name found above may chan
 
 <h4><a class="title-link" name="services" href="#services"></a> Services</h4>
 
-<p>The Z-Wave component exposes two services to help maintain the network.</p>
+<p>The Z-Wave component exposes four services to help maintain the network.</p>
 
 <table>
   <thead>
@@ -245,23 +245,46 @@ Depending on what’s plugged into your USB ports, the name found above may chan
   <tbody>
     <tr>
       <td>add_node</td>
-      <td> </td>
+      <td>Put the zwave controller in inclusion mode. Allows one to add a new device to the zwave network.</td>
     </tr>
     <tr>
       <td>remove_node</td>
-      <td> </td>
+      <td>Put the zwave controller in exclusion mode. Allows one to remove a device from the zwave network.</td>
     </tr>
     <tr>
       <td>heal_network</td>
-      <td> </td>
+      <td>Tells the controller to “heal” the network. Bascially asks the nodes to tell the controller all of their neighbors so the controller can refigure out optimal routing.</td>
     </tr>
     <tr>
       <td>soft_reset</td>
-      <td> </td>
+      <td>Tells the controller to do a “soft reset”. This is not supposed to lose any data, but different controllers can behave differently to a “soft reset” command.</td>
     </tr>
   </tbody>
 </table>
 
+<p>The soft_reset and heal_network commands can be used as part of an automation script<br />
+to help keep a zwave network running relliably. For example:</p>
+
+<div class="highlighter-coderay"><div class="CodeRay">
+  <div class="code"><pre><span class="comment"># Example configuration.yaml automation entry</span>
+<span class="key">automation</span>:
+  - <span class="string"><span class="content">alias: soft reset at 2:30am</span></span>
+    <span class="key">trigger</span>:
+      <span class="key">platform</span>: <span class="string"><span class="content">time</span></span>
+      <span class="key">after</span>: <span class="string"><span class="content">'2:30:00'</span></span>
+    <span class="key">action</span>:
+      <span class="key">service</span>: <span class="string"><span class="content">zwave.soft_reset</span></span>
+
+  - <span class="string"><span class="content">alias: heal at 2:31am</span></span>
+    <span class="key">trigger</span>:
+      <span class="key">platform</span>: <span class="string"><span class="content">time</span></span>
+      <span class="key">after</span>: <span class="string"><span class="content">'2:31:00'</span></span>
+    <span class="key">action</span>:
+      <span class="key">service</span>: <span class="string"><span class="content">zwave.heal_network</span></span>
+</pre></div>
+</div>
+</div>
+
 
 </article>