Polling Settings
(Initial version) |
m (Extra text based on feedback; some typos.) |
||
| Line 3: | Line 3: | ||
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> | 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. | + | 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. | + | 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> |
| − | + | ||
| − | <br> | + | |
The polling mechanism and the parameters that control it are described below.<br> | The polling mechanism and the parameters that control it are described below.<br> | ||
| Line 17: | Line 15: | ||
[[Image:UI4-1.1.1245-Polling1.jpg|System-wide poll settings]] | [[Image:UI4-1.1.1245-Polling1.jpg|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 <#>''' <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 <#> 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> |
| − | *''' | + | *'''Poll a node every <#> seconds.''' <sup>4</sup><br>Number of seconds between poll commands.<br> |
| − | *''' | + | *'''Unless specified otherwise, poll each node at most once every <#> seconds.''' <sup>5</sup><br>Minimum number of seconds between poll commands to the same node.<br><br> |
The highlighted section in the screenshot below shows the poll settings per device.<br> | The highlighted section in the screenshot below shows the poll settings per device.<br> | ||
| Line 27: | Line 25: | ||
[[Image:UI4-1.1.1245-Polling2.jpg]] | [[Image:UI4-1.1.1245-Polling2.jpg]] | ||
| − | *''' | + | *'''Poll this node at most once every <#> 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> == | == Operation<br> == | ||
| − | If polling is enabled | + | 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 | + | 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 | + | Once the node has been polled successfully, Vera waits the specified number of seconds <sup>4</sup> before polling the next node. |
| − | After all the nodes have been polled, the process repeats, taking into account the maximum poll rate | + | After all the nodes have been polled, the process repeats, taking into account the maximum poll rate <sup>5/6</sup> for each device. |
<br> | <br> | ||
| Line 45: | Line 43: | ||
== Example == | == Example == | ||
| − | Typically, with the default settings and more than 2 'pollable' devices, a poll command will be sent every 30 seconds. | + | 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 | <pre>00:00 - Poll device #1 | ||
| Line 61: | Line 59: | ||
*The default value for '''Poll a node every # seconds.''' is 30; change this number to change the poll interval. | *The default value for '''Poll a node every # seconds.''' is 30; change this number to change the poll interval. | ||
| − | *The default value for '''Unless specified otherwise, poll each node at most once every <#> seconds.''' is 60; | + | *The default value for '''Unless specified otherwise, poll each node at most once every <#> seconds.''' is 60; change this number to limit the poll rate of a single node. |
*Bug# 1526. | *Bug# 1526. | ||
Revision as of 19:57, 13 July 2011
Contents |
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.
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.
- 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.
- Poll a node every <#> seconds. 4
Number of seconds between poll commands.
- Unless specified otherwise, poll each node at most once every <#> seconds. 5
Minimum number of seconds between poll commands to the same node.
The highlighted section in the screenshot below shows the poll settings per device.
- 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.)
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 4 before polling the next node.
After all the nodes have been polled, the process repeats, taking into account the maximum poll rate 5/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.
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 ...
Bug
Currently (1.1.1245) the labels Poll a node every <#> seconds. and Unless specified otherwise, poll each node at most once every <#> seconds. are reversed. So:
- The default value for Poll a node every # seconds. is 30; change this number to change the poll interval.
- The default value for Unless specified otherwise, poll each node at most once every <#> seconds. is 60; change this number to limit the poll rate of a single node.
- Bug# 1526.
Change Log
2011/07/13 - oTi - Replace old info with updated UI4 description. Reformat page. [1.1.1245 / 3.20]
