# ValloxMV Binding
This binding connects to the web interface of the Vallox MV series of ventilation units. It has been tested so far with Vallox 350 MV and 510 MV.
# Supported Things
There is one Thing type (valloxmv) supporting the connection via the web interface of the Vallox MV.
There is no support for earlier Modbus-connected devices.
# Discovery
This binding does not support discovery; you must provide the IP address.
# Thing Configuration
The Thing needs the IP/hostname of the web interface and how often values should be updated. The minimum update interval is 15 seconds to avoid polling again before results have been evaluated.
| Config | Description | Type | Default |
|---|---|---|---|
| ip | IP/hostname of the web interface | string | n/a |
| updateinterval | Poll interval in seconds (min. 15) | int | 60 |
# Channels
Overview of provided channels
| Channel ID | Vallox Name | Description | Read/Write | Values |
|---|---|---|---|---|
| onoff | A_CYC_MODE | On/off switch | rw | On/Off |
| state | several | Current state of ventilation unit | rw | 1=FIREPLACE, 2=AWAY, 3=ATHOME, 4=BOOST |
| fanspeed | A_CYC_FAN_SPEED | Fan speed | r | 0 - 100 (%) |
| fanspeedextract | A_CYC_EXTR_FAN_SPEED | Fan speed of extracting fan | r | 1/min |
| fanspeedsupply | A_CYC_SUPP_FAN_SPEED | Fan speed of supplying fan | r | 1/min |
| tempinside | A_CYC_TEMP_EXTRACT_AIR | Extracted air temp | r | Number (°C) |
| tempoutside | A_CYC_TEMP_OUTDOOR_AIR | Outside air temp | r | Number (°C) |
| tempexhaust | A_CYC_TEMP_EXHAUST_AIR | Exhausted air temp | r | Number (°C) |
| tempincomingbeforeheating | A_CYC_TEMP_SUPPLY_CELL_AIR | Incoming air temp (pre heating) | r | Number (°C) |
| tempincoming | A_CYC_TEMP_SUPPLY_AIR | Incoming air temp | r | Number (°C) |
| humidity | A_CYC_RH_VALUE | Extracted air humidity | r | 0 - 100 (%) |
| cellstate | A_CYC_CELL_STATE | Current cell state | r | 0=heat recovery, 1=cool recovery, 2=bypass, 3=defrosting |
| uptimeyears | A_CYC_TOTAL_UP_TIME_YEARS | Total uptime years | r | Y |
| uptimehours | A_CYC_TOTAL_UP_TIME_HOURS | Total uptime hours | r | h |
| uptimehourscurrent | A_CYC_CURRENT_UP_TIME_HOURS | Current uptime in hours | r | h |
| filterchangeddate | A_CYC_FILTER_CHANGED_DAY/MONTH/YEAR | Last filter change | r | date |
| remainingfilterdays | A_CYC_CURRENT_UP_TIME_HOURS | Days until filter change | r | d |
| extrfanbalancebase | A_CYC_EXTR_FAN_BALANCE_BASE | Extract fan base speed | rw | 0 - 100 (%) |
| suppfanbalancebase | A_CYC_SUPP_FAN_BALANCE_BASE | Supply fan base speed | rw | 0 - 100 (%) |
| homespeedsetting | A_CYC_HOME_SPEED_SETTING | Home fan speed | rw | 0 - 100 (%) |
| awayspeedsetting | A_CYC_AWAY_SPEED_SETTING | Away fan speed | rw | 0 - 100 (%) |
| boostspeedsetting | A_CYC_BOOST_SPEED_SETTING | Boost fan speed | rw | 0 - 100 (%) |
| homeairtemptarget | A_CYC_HOME_AIR_TEMP_TARGET | Target temperature in home state | rw | Number (°C) |
| awayairtemptarget | A_CYC_AWAY_AIR_TEMP_TARGET | Target temperature in away state | rw | Number (°C) |
| boostairtemptarget | A_CYC_BOOST_AIR_TEMP_TARGET | Target temperature in boost state | rw | Number (°C) |
| boosttime | A_CYC_BOOST_TIME | Timer value in boost profile | rw | 1 - 65535 (min) |
| boosttimerenabled | A_CYC_BOOST_TIMER_ENABLED | Timer enabled setting in boost profile | rw | On/Off |
| fireplaceextrfan | A_CYC_FIREPLACE_EXTR_FAN | Fireplace profile extract fan speed | rw | 0 - 100 (%) |
| fireplacesuppfan | A_CYC_FIREPLACE_SUPP_FAN | Fireplace profile supply fan speed | rw | 0 - 100 (%) |
| fireplacetime | A_CYC_FIREPLACE_TIME | Timer value in fireplace profile | rw | 1 - 65535 (min) |
| fireplacetimerenabled | A_CYC_FIREPLACE_TIMER_ENABLED | Timer enabled setting in fireplace profile | rw | On/Off |
| extraairtemptarget | A_CYC_EXTRA_AIR_TEMP_TARGET | Target temperature in extra profile | rw | Number (°C) |
| extraextrfan | A_CYC_EXTRA_EXTR_FAN | Extra profile extract fan speed | rw | 0 - 100 (%) |
| extrasuppfan | A_CYC_EXTRA_EXTR_FAN | Extra profile supply fan speed | rw | 0 - 100 (%) |
| extratime | A_CYC_EXTRA_TIME | Timer value in extra profile | rw | 1 - 65535 (min) |
| extratimerenabled | A_CYC_EXTRA_TIMER_ENABLED | Timer enabled setting in extra profile | rw | On/Off |
| weeklytimerenabled | A_CYC_WEEKLY_TIMER_ENABLED | Weekly timer enabled setting | rw | On/Off |
Note: If your unit is equipped with a CO₂ sensor, an additional read-only channel co2 (Number:Dimensionless, in ppm) is available.
# Example
# Things file
Thing valloxmv:valloxmv:lueftung [ip="192.168.1.3", updateinterval=60]
# Items file
Number State "Current state: [%d]" {channel="valloxmv:valloxmv:lueftung:state"}
Number FanSpeed "Fanspeed [%d %%]" {channel="valloxmv:valloxmv:lueftung:fanspeed"}
Number Temp_TempInside "Temp inside [%.1f °C]" <temperature> {channel="valloxmv:valloxmv:lueftung:tempinside"}
Number Temp_TempOutside "Temp outside [%.1f °C]" <temperature> {channel="valloxmv:valloxmv:lueftung:tempoutside"}
Number Temp_TempExhaust "Temp outgoing [%.1f °C]" <temperature> {channel="valloxmv:valloxmv:lueftung:tempexhaust"}
Number Temp_TempIncoming "Temp incoming [%.1f °C]" <temperature> {channel="valloxmv:valloxmv:lueftung:tempincoming"}
Number Humidity "Humidity [%d %%]" {channel="valloxmv:valloxmv:lueftung:humidity"}
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)
← UPnP Control Vektiva →