Polling Settings
m |
m (→Change Log) |
||
| (12 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | == 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.<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 <#>''' <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> | ||
| + | *'''Unless specified otherwise, poll each node at most once every <#> seconds.''' <sup>4</sup><br>Minimum number of seconds between poll commands to the same node.<br> | ||
| + | *'''Poll a node every <#> 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 <#> 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. 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.
- 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.
- 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]
