Polling Settings

From MiOS
(Difference between revisions)
Jump to: navigation, search
m
m (Change Log)
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:User Instructions]]
+
== Introduction  ==
[[Category:Incomplete]]
+
Polling is the process where Vera tries to ask a Z-Wave device for its current status, like if it's On or Off, at what temperature, and so on. This is how Vera knows when the status of a device changes, such as when the temperature has changed if it's a thermostat, or if you manually turned a light on or off. Normally Vera attempts to poll one Z-Wave device every 10 seconds, and Vera polls the devices in order until Vera has polled all of them. So the delay between polling nodes depends on how many nodes you have. If you have 6 nodes, each node will be polled once a minute, and if you manually turn a light off, within a minute or so Vera's dashboard will show the light is off. But, if you have 100 Z-Wave devices, it can take 16 minutes before Vera has polled them all. You can change the polling behavior by going to the [[Devices|'Devices']] tab on Vera's setup page and selecting (see [[ZWave_Options|Z-Wave Options]]).
+
  
--todoab: finish
+
Polling is the process where Vera requests information from a Z-Wave device about its current status, such as on/off, dim level, temperature, and so on.<br>
 +
 
 +
Depending on the device, polling may not be necessary, as the device will report any status changes to Vera autonomously. Those devices are not normally polled, but only when Vera starts up. These are devices that support associations, such as a Leviton dimmer.
 +
 
 +
Other devices, such as many battery operated sensors for example, will be in a low-power state most of the time and therefore are not listening to the network and cannot be polled at all. An example would be a portable controller, such as the GE 45601. Another example is a motion sensor, such as the HSM100; it will autonomously report motion to Vera, but cannot be polled for temperature and light level readings until it 'wakes up' and notifies Vera that it is awake. However, frequently listening, but battery operated devices such as a door lock can be polled. <br>
 +
 
 +
The polling mechanism and the parameters that control it are described below.<br>
 +
 
 +
== Settings  ==
 +
 
 +
The highlighted section in this screenshot shows the poll settings for the entire system. They apply to all devices, unless specified differently for a specific device.<br>
 +
 
 +
[[Image:ui5_zwave_settings.png|System-wide poll settings]]
 +
 
 +
*'''Poll nodes''' <sup>1</sup><br>Master switch to enable or disable polling.<br>
 +
*'''Number of seconds to wait to start polling &lt;#&gt;''' <sup>2</sup><br>Number of seconds after Vera / the Luup engine has (re-)started before the polling mechanism begins.<br>
 +
*'''Only poll a node if the Z-Wave network is idle at least &lt;#&gt; seconds''' <sup>3</sup><br>Number of seconds Vera must not have transmitted any non-poll command before the next poll command is sent.<br>
 +
*'''Unless specified otherwise, poll each node at most once every &lt;#&gt; seconds.''' <sup>4</sup><br>Minimum number of seconds between poll commands to the same node.<br>
 +
*'''Poll a node every &lt;#&gt;&nbsp;seconds.''' <sup>5</sup><br>Number of seconds between poll commands.<br><br>
 +
 
 +
 
 +
The highlighted section in the screenshot below shows the poll settings per device.<br>
 +
 
 +
[[Image:ui5_device_settings.png]]
 +
 
 +
*'''Poll this node at most once every &lt;#&gt;&nbsp;seconds''' <sup>6</sup><br>Minimum number of seconds between poll commands to this node.<br>Putting a '0' will disable polling for this node.<br>Leaving the field blank indicates the default value from the system-wide settings will be used. (See 'Unless specified otherwise...' above.)<br><br>
 +
 
 +
== Operation<br>  ==
 +
 
 +
If polling is enabled <sup>1</sup>, Vera will begin polling when the Luup engine has restarted and the specified wait time <sup>2</sup> has elapsed.
 +
 
 +
The nodes are polled in sequence, starting with the lowest device number. The Z-Wave network must have been idle for the specified time <sup>3</sup>, before the node is polled.
 +
 
 +
Once the node has been polled successfully, Vera waits the specified number of seconds <sup>5</sup> before polling the next node.
 +
 
 +
After all the nodes have been polled, the process repeats, taking into account the maximum poll rate <sup>4/6</sup> for each device.
 +
 
 +
<br>
 +
 
 +
Devices that report their status autonomously and battery-operated devices that do no listen are skipped by default during normal operation.
 +
 
 +
<br>
 +
 
 +
To limit the amount of polling in a given time interval, the mechanism only allows to specify a maximum poll rate for each device, but not the actual poll rate for each device.
 +
 
 +
The actual poll rate per device depends on the size of the network and the type of devices in it.
 +
 
 +
== Example  ==
 +
 
 +
Typically, with the default settings and more than 2 'pollable' devices, a poll command will be sent every 30 seconds. For 3 'pollable' devices:<br>
 +
<pre>00:00 - Poll device #1
 +
 
 +
00:30 - Poll device #2
 +
 
 +
01:00 - Poll device #3
 +
 
 +
01:30 - Poll device #1
 +
 
 +
...
 +
</pre>
 +
 
 +
== Change Log  ==
 +
 
 +
2011/07/13 - oTi - Replace old info with updated UI4 description.&nbsp;Reformat page. Reviewed by mcvflorin and JOD. [1.1.1245 / 3.20]
 +
 +
2012/02/16 - mcvflorin - Replaced UI4 images with UI5 images. Removed the bug information. [1.5.302 / 3.20]
 +
 
 +
[[Category:User_Instructions]]

Latest revision as of 12:41, 16 February 2012

Contents

[edit] Introduction

Polling is the process where Vera requests information from a Z-Wave device about its current status, such as on/off, dim level, temperature, and so on.

Depending on the device, polling may not be necessary, as the device will report any status changes to Vera autonomously. Those devices are not normally polled, but only when Vera starts up. These are devices that support associations, such as a Leviton dimmer.

Other devices, such as many battery operated sensors for example, will be in a low-power state most of the time and therefore are not listening to the network and cannot be polled at all. An example would be a portable controller, such as the GE 45601. Another example is a motion sensor, such as the HSM100; it will autonomously report motion to Vera, but cannot be polled for temperature and light level readings until it 'wakes up' and notifies Vera that it is awake. However, frequently listening, but battery operated devices such as a door lock can be polled.

The polling mechanism and the parameters that control it are described below.

[edit] Settings

The highlighted section in this screenshot shows the poll settings for the entire system. They apply to all devices, unless specified differently for a specific device.

System-wide poll settings

  • Poll nodes 1
    Master switch to enable or disable polling.
  • Number of seconds to wait to start polling <#> 2
    Number of seconds after Vera / the Luup engine has (re-)started before the polling mechanism begins.
  • Only poll a node if the Z-Wave network is idle at least <#> seconds 3
    Number of seconds Vera must not have transmitted any non-poll command before the next poll command is sent.
  • Unless specified otherwise, poll each node at most once every <#> seconds. 4
    Minimum number of seconds between poll commands to the same node.
  • Poll a node every <#> seconds. 5
    Number of seconds between poll commands.


The highlighted section in the screenshot below shows the poll settings per device.

Ui5 device settings.png

  • Poll this node at most once every <#> seconds 6
    Minimum number of seconds between poll commands to this node.
    Putting a '0' will disable polling for this node.
    Leaving the field blank indicates the default value from the system-wide settings will be used. (See 'Unless specified otherwise...' above.)

[edit] Operation

If polling is enabled 1, Vera will begin polling when the Luup engine has restarted and the specified wait time 2 has elapsed.

The nodes are polled in sequence, starting with the lowest device number. The Z-Wave network must have been idle for the specified time 3, before the node is polled.

Once the node has been polled successfully, Vera waits the specified number of seconds 5 before polling the next node.

After all the nodes have been polled, the process repeats, taking into account the maximum poll rate 4/6 for each device.


Devices that report their status autonomously and battery-operated devices that do no listen are skipped by default during normal operation.


To limit the amount of polling in a given time interval, the mechanism only allows to specify a maximum poll rate for each device, but not the actual poll rate for each device.

The actual poll rate per device depends on the size of the network and the type of devices in it.

[edit] Example

Typically, with the default settings and more than 2 'pollable' devices, a poll command will be sent every 30 seconds. For 3 'pollable' devices:

00:00 - Poll device #1

00:30 - Poll device #2

01:00 - Poll device #3

01:30 - Poll device #1

...

[edit] Change Log

2011/07/13 - oTi - Replace old info with updated UI4 description. Reformat page. Reviewed by mcvflorin and JOD. [1.1.1245 / 3.20]

2012/02/16 - mcvflorin - Replaced UI4 images with UI5 images. Removed the bug information. [1.5.302 / 3.20]

Personal tools