Driver Details

Vera Smart Home Control

By: RTI
Updated: Nov. 2, 2016
Version: 1.1

Description:

This driver is for the Vera3/VeraLite Smart Home Control system used for interfacing with Z-Wave Dimmers, Switches, Thermostats, Door Locks, Sensors, and Power Meters from various manufacturers.

Version History:

Version 1.01 fixes initial feedback issue when using Toggle Lock State command.

Version 1.02 fixes initial feedback issue with locks when they fail to operate, adds Lock Fault events, and adjustments to code for allowing command execution within system macros.

Version 1.03 fixes visibility issue with scene driver commands.

Version 1.04 fixes issue where user interfaces do not always initialize properly with driver and adds 45, 50, 55, and 60 second refresh rate selections.

Version 1.05 fixes an issue where the driver would stop sending requests if disconnected while using Static IP setting.

Version 1.06 fixes issue if security sensors do not provide complete tripped information.

Version 1.1 Fixes issue with Window Covering feedback and control.

Vera Control, Ltd - Vera Smart Home Control

This driver is for the Vera3/VeraLite Smart Home Control system. This driver was developed using a VeraLite with firmware version 1.6.641.

Release History

1.0 Initial release of the driver

1.01 Fixed initial feedback issue for Toggle Lock State Command.

1.02 Fixed initial feedback issue with locks when they fail to operate.

Added "Lock Fault" events to driver.

Adjusted code in driver to allow command execution within system macros.

1.03 Fixed Scene driver command visibility issue where only visible when Security Sensor Count was configured above 0.

1.04 Fixed issue where user interfaces do not always initialize properly with driver.

Added 45, 50, 55, and 60 second refresh rate selections.

1.05 Fixed issue where the driver would stop sending requests if disconnected while using Static IP setting.

1.06 Fixed issue if security sensors do not provide ArmedTripped information.

1.1 Fixed issue with Window Covering feedback and control.

Adjusted Window Covering Open/Closed variables and events for proper state.

Connection

Connection Type - UPnP

Friendly Name - enter the friendly name given the Vera control processor. There are many utilities which can acquire UPnP device information on the network, one being the XPDiagnostics driver, but in general the Vera friendly name is likely to be "MiOS (serial number of Vera)". Example friendly name would be "MiOS 12345678".

TCP Port - by default the Vera uses port 3480, but if need be the driver can be configured to use a different port.

Connection Type - Network (TCP)

TCP Address - enter the TCP address assigned to the Vera control processor. By default the Vera uses DHCP and it is recommended the UPnP setting is used, but if the Vera is set to a static IP via Vera setup or a MAC address reservation in the router, TCP address setting can be used.

TCP Port - by default the Vera uses port 3480, but if need be the driver can be configured to use a different port.

Vera Configuration

Refresh Rate - Select the rate in which the driver should to acquire data. Lower Refresh Rate settings can provide the most accurate device readings, but may also use more processing resources. The default is set to 5 seconds. Adjust as needed.

Use Driver Configuration Names - Enable to use names from the driver configuration for variable text fields (Vera IDs must be configured while using this setting). Disable to use names programmed in the Vera system for variable text fields (Device configuration names must match exactly what is programmed in the Vera control processor, IDs are acquired upon driver initialization for the device fields that are configured correctly).

Dimmer Count - Enter the number of Dimmers configured in the system. Up to 70 Dimmers are supported.

Switch Count - Enter the number of Switches configured in the system. Up to 70 Switches are supported.

Lock Count - Enter the number of Locks configured in the system. Up to 70 Locks are supported.

Thermostat Count - Enter the number of Thermostats configured in the system. Up to 70 Thermostats are supported.

Security Sensor Count - Enter the number of Security Sensors configured in the system. Up to 70 Security Sensors are supported.

Window Covering Count - Enter the number of Window Covering Devices configured in the system. Up to 70 Window Covering Devices are supported.

Humidity Sensor Count - Enter the number of Humidity Sensors configured in the system. Up to 70 Humidity Sensors are supported.

Temperature Sensor Count - Enter the number of Temperature Sensors configured in the system. Up to 70 Temperature Sensors are supported.

Light Sensor Count - Enter the number of Light Sensors configured in the system. Up to 70 Light Sensors are supported.

Power Meter Count - Enter the number of Power Meters configured in the system. Up to 70 Power Meters are supported.

Scene Count - Enter the number of Scenes configured in the system. Up to 100 Scenes are supported.

Note about device counts - The device count limitation is based off of the maximum number of devices available for control with a VeraLite Control Processor - which is 70 devices. Any combination of configured devices is supported as long as the sum of all configured devices does not exceed the Vera Control Processor. VeraLite limit = 70 devices, Vera3 limit = 200 devices.

Dimmer Configuration (1-70)

Dimmer (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the dimmer can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Dimmer (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Switch Configuration (1-70)

Switch (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the switch can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Switch (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Lock Configuration (1-70)

Lock (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the lock can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Lock (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Thermostat Configuration (1-70)

Thermostat (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the thermostat can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Thermostat (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Security Sensor Configuration (1-70)

Security Sensor (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the security sensor can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Security Sensor (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Window Covering Configuration (1-70)

Window Covering (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the window covering can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Window Covering (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Humidity Sensor Configuration (1-70)

Humidity Sensor (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the humidity sensor can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Humidity Sensor (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Temperature Sensor Configuration (1-70)

Temperature Sensor (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the temperature sensor can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Temperature Sensor (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Light Sensor Configuration (1-70)

Light Sensor (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the light sensor can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Light Sensor (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Power Meter Configuration (1-70)

Power Meter (1-70) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the power meter can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Power Meter (1-70) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Scene Configuration (1-100)

Scene (1-100) Name - Enter the name for the dimmer. If "Use Driver Configuration Names" is enabled, the scene can be named however preferred, but if "Use Driver Configuration Names" is disabled, the name must match exactly what is programmed in the Vera Control Processor.

Scene (1-100) ID - Only available when "Use Driver Configuration Names" is enabled. When available, enter the ID given the device in the Vera Control Processor setup process.

Driver Notes

- This driver does not use the traditional heartbeat mechanism used in other drivers, but instead bases its connectivity status on whether a data request is properly responded to. If a data request is missed more than a couple of times and UPnP is the selected connection type, the driver will rescan the network for the friendly name assigned to the Vera Control Processor.

- Initial feedback for all control is acquired at the time of control and refreshed when the data request response is received. When a proper control command is verified by the driver and the command stack queue is empty a data request is sent whether the refresh rate time has expired or not.

- This driver uses a command stack queue which prioritizes lock control over lighting, thermostats, etc.

- Thermostat adjustments and feedback are based on what is available via the Vera web interface. Some features available in the web interface may not be available on the actual thermostat and vice versa.

- Thermostat setpoint adjustments for Fahrenheit are between 35 and 99 degrees. Whether the thermostat supports this range is dependent on the thermostat.

- Thermostat setpoint adjustments for Celsius are between 2 and 38 degrees. Whether the thermostat supports this range is dependent on the thermostat. During development it was noticed that the Vera only sent whole number integers to the thermostat while being adjusted, therefore fractional setpoint adjustments are not currently supported.

- All 'Set Level' driver commands adjust the corresponding variable as the level is adjusted, but the actual control is executed when the button is released. This is also true for the 'Ramp Setpoint' commands for thermostats. 'Ramp Dimmer Level' commands however are adjusted as the button is held down at the sustain delay rate for the command.