openhab-addons/bundles/org.openhab.binding.valloxmv

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"}