Skip to content

Vpowgh/VVMachine

Repository files navigation

VVMachine

Vallox ventilation machine plug-in for Vera home automation system. Compatible with Vallox MV series ventilation units.

Features

Displays main temperatures (Indoor, Exhaust, Extract, Outdoor), fan speed, current humidity and heat exchanger operating state in easily readable user interface. Buttons for selecting active profile (Home, Away, Boost, Fireplace, Extra).

Installation

  • Install from Vera (Apps -> Install apps)

or

  • Download files from github to your computer, upload to your Vera (Apps -> Develop apps -> Luup files). Then select Create device and give D_VVMachine1.xml as Upnp Device Filename. The device can be renamed afterwards. Then reload Luup by going to Apps -> Develop apps -> Test Luup code, enter and run code: luup.reload() Then hard refresh your browser (usually Ctrl+F5).

Configuration

Go to device control page and navigate to Advanced -> Variables. Set variable ValloxIP to your Vallox MV unit IP addess, for example 192.168.1.15. The IP depends on your network setup and must be static i.e. not to change over time. Input IP in x.x.x.x format, no any extra characters or port numbers. VVMachine uses port 80 always.

Device configuration:

alt text

Usage

The user interface shows current values of following signals:

  • indoor temperature
  • exhaust temperature
  • extract temperature
  • outdoor temperature
  • fan speed (% of the maximum)
  • humidity (relative humidity %)
  • heat exchanger operating state (heat recovery, cool recovery, bypass, defrost)

Next to display are five control buttons for selecting active profile: Home, Away, Boost,Fireplace and Extra. The buttons also reflect the state of the Vallox unit, if profile is changed from other control location the buttons status will change accordingly. Note that changing profile is not instantenous, it will take some time that command is processed and status is relayed back to plugin.

If plugin cannot connect to Vallox unit, then display will not show any values, buttons do not show any profile and plugin logo is gray color. If plugin is connected normally values and profile are shown and plugin logo is blue. Note that logos are stored in external server, if your Vera is not connected to internet the logos are not shown.

Connected and not connected device view:

alt text
alt text

The plugin itself does not support standard device services e.g. temperature or humidity or others. If this functionality is needed it can be achieved by using another plugin, for example https://github.com/toggledbits/VirtualSensor which can be used to create wanted sensor types and setup to pull data from VVMachine plugin.

The plugin provides basic events (like temperature goes below or above) to be used in Vera scenes and notifications. If more complex automation is needed it can be again achieved by using another plugin, for example https://github.com/toggledbits/Reactor which provides great selection of rules for any task.

Following actions are provided by the plugin to control ventilation unit:

  • SetProfileHome()
  • SetProfileAway()
  • SetProfileBoost()
  • SetProfileFireplace()
  • SetProfileExtra()

Each of these actions set the operating profile for ventilation unit. Actions do not take any parameters.

  • SetOnOff(OnOff)

Sets the ventilation unit on or off. Parameter is boolean type (1=turn unit on, 0=turn unit off).

  • SetVariable(Address, Value)

Sets one or multiple variable(s) in the ventilation unit. Address and value parameters are string type. When setting multiple values addresses and corresponding values must be comma separated. Example to set one variable: SetVariable(Address="4614", Value="0") Example to set multiple variables: SetVariable(Address="20493,20494,20495,4614", Value="29015,40,45,65535")

Links

Vallox ventilation units

Vallox Modbus manual

Python implementation of Vallox websocket interface

About

Vallox ventilation machine plug-in for Vera

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages