Configurations for the eBUS-binding [3.4.0, 4.0.0]

The purpose of this topic is to exchange special configurations which are not part of the ebus binding and cannot be retrieved 1:1 through ebusd configurations provided by John30 on Github.

Hello Veit (@Veitk ),

in the meantime i have extended the features in order to control my Vaillant heat pump VML105/6. The ebus binding already contains the standard configurations (VRC700/720) for the following 4 things:

  1. Vaillant VRC 720 General (polling 100 secs)

  2. Vaillant VRC 720 Heating Circuit 1 (polling 90 secs)

  3. Vaillant VRC 720 Hot Water Circuit 1 (polling 130 secs)

  4. Vaillant VRC 720 Zone 1 (polling 110 secs)

Beyond this basic setup i use 2 custom configuration files for another two things:

  1. Vaillant Circulation Pump (no polling),
    Circulation_Pump_config.json (805 Bytes)
    Use the pump ON/OFF state together with the following hardware feature in order to save energy. Installed a Homematic switch configured as push button. The switch contact (closer) is connected to the HMU board connector X41 (terminals FB and 0). Thus, a push button cycle activates the circulation pump for 5 minutes (Vaillant default time). By this way, the hot water circulation can be demanded by an Alexa command “water on”. This is rather comfortable and my wife likes it. Measured that the hot water storage temperature degradation changed by factor 8 if i compare “circualtion on” versus “circulation off”. In practice, demanding “water on” for a couple of times per day, this factor is still 4-5.

  2. Vaillant HMU Main Board (polling 60 secs),
    hmu08_config.json (24.3 KB)
    This file contains many expert level parameters which provide a better insight into the function of the heatpump outdoor unit.

I also want to underline here that it was Cor (@Chiuaua79) who taught me a lot to understand the ebus telegrams.

Use different polling times for the various things in order to minimize the “send queue is full” error. Have not been able to eliminate this error completely but it doesn’t longer worry me as initially. Assume that it is difficult to get rid of this error with overall roughly 80 different ebus items configured for my heat pump.

The ebus hex codes have been retrieved using ebusd and commands “ebusctl grab” and “ebusctl grab result decode”. This has not been that difficult. Thus, live monitoring data, statistical data as well as expert level data of the Vaillant heat pump can be accessed.

For production i still use the ESERA LAN ebus coupler which is much better than its image if configured right. Of utmost importance is to set the “data packing condition” timer to 2ms (default is 0ms).

Best regards,
Willi

Beside standard sitemap functionality, i have setup 2 openHAB “pages” as “floor plan” with “markers”. The “markers” can be configured to show the bare item state as well as an icon at the side. See the following examples:

  • Vaillant VML105/6 outdoor unit (within this example currently running for hot water storage loading)

All parameters, except the heat power to the building (here 11.4 kW) and the COP, are provided by hmu08_config.json and related items. The residual heat power (sum of electrical energy of the compressor and power gained out of the air) is calculated by this rule:

rule "Heizleistung der Wärmepumpe aus HMU08 Statistik"
    when
	    Item VaillantHMUMainBoard_AktuelleStromaufnahme received update
	then
		Heizleistung_Waermepumpe.postUpdate((VaillantHMUMainBoard_AktuelleStromaufnahme.state as Number + VaillantHMUMainBoard_AktuelleLeistungausderLuft.state as Number)/1000)
end

The current coefficient of performance (COP) is calculated by the following rule:

rule "COP der Wärmepumpe aus HMU08 Statistik"
    when
	    Item VaillantHMUMainBoard_AktuelleLeistungausderLuft received update
	then
		COP_VaillantWaermepumpe.postUpdate((VaillantHMUMainBoard_AktuelleStromaufnahme.state as Number + VaillantHMUMainBoard_AktuelleLeistungausderLuft.state as Number + 0.001) / (VaillantHMUMainBoard_AktuelleStromaufnahme.state as Number + 0.001))
end
  • Vaillant VIH QW 190/6 E indoor unit (uniTower)

For the indoor unit not all parameters are available through ebus because the controller is already sitting in the indoor unit and doesn’t need it. So, for instance parameters of the additional heater can’t be accessed through ebus. Same is for the VUV switching cycles (Schaltspiele VUV) which are calculated by a rule based on hot water storage loading cycles.

rule "Berechnung VUV Schaltvorgänge weil ebus nicht verwendet wird"
    when
	    Item VaillantVRC700hotwatercircuit_HWCflowtemperaturetemperature changed
	then
		if( (VaillantVRC700hotwatercircuit_HWCflowtemperaturetemperature.state as QuantityType<Number>).intValue <= 25 ) {
		VaillantHMUMainBoard_SchaltvorgangeVUVWarmwasser.postUpdate(VaillantHMUMainBoard_SchaltvorgangeVUVWarmwasser.state as Number + 1)
		}
end

The background pictures have been created by Powerpoint and saved as .png files. Here are the .png files.

Can provide the original .pptx file in case a user wants to carry out adaptations (outfit, language etc.) by email on request (can’t be uploaded here).

The background files need to be stored in the folder C:\openHAB\conf\html (i am a Windows10 user).
In the page setup the background picture is referenced as relative path like this: /static/VML105_6_out.png

As a start point for the marker setup, i provide my outdoor unit page as YAML file here:

config:
  backgroundColor: white
  imageHeight: 480
  imageUrl: /static/VML105_6_out.png
  imageWidth: 640
  label: Wärmepumpe VML105/6 Outdoor
  order: "2"
  sidebar: true
  visibleTo:
    - role:administrator
    - role:user
markers:
  - component: oh-plan-marker
    config:
      coords: 379.1924793102342,44.321198880416986
      iconUseState: false
      item: Vaillant_HMU_Main_Board_Luft_Einlass_Temperatur
      name: Lufteinlasstemperatur
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 414.89566729723674,550.93712497185
      item: Vaillant_HMU_Main_Board_Vorlauf_Temperatur
      name: Vorlauftemperatur Heizkreis
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 439.51855556413506,193.9052451018243
      item: Vaillant_HMU_Main_Board_Schaltzustand_4WegeVentil
      name: Schaltstellung 4-Wege Inverter Ventil
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 306.5549589228841,581.1001630988004
      item: Vaillant_HMU_Main_Board_Leistung_Gebaudepumpe
      name: Leistung WILO-Gebäudepumpe
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 317.6352586429884,218.52813336872262
      item: Vaillant_HMU_Main_Board_Kompressor_Einlass_Temperatur
      name: Kompressor Einlasstemperatur
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 303.4770978895218,216.68141674870526
      item: Vaillant_HMU_Main_Board_Niederdruck_Kaltekreis
      name: Niederdruck Kältekreis (Kompressor Einlass)
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 220.99042219541246,379.80805151690663
      item: Vaillant_HMU_Main_Board_Kompressor_Auslass_Temperatur
      name: Kompressor Auslasstemperatur
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 206.83226144194592,372.42118503683713
      item: Vaillant_HMU_Main_Board_Hochdruck_Kaltekreis
      name: Hochdruck Kältekreis
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 233.91743853553407,224.06828322877476
      item: VaillantHMUMainBoard_KompressorModulation
      name: Kompressor Modulation
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 219.14370557539507,219.75927778206753
      item: Vaillant_HMU_Main_Board_Kompressor_Drehzahl
      name: Kompressor Drehzahl
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 181.59380096837515,289.9345093427278
      item: VaillantHMUMainBoard_AktuelleStromaufnahme
      name: Aktuelle Stromaufnahme Kompressor
      tooltipColor: red
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 181.59380096837515,31.39418254029536
      item: VaillantHMUMainBoard_AktuelleLeistungausderLuft
      name: Umweltgewinn
      tooltipColor: green
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 243.15102163562094,142.8127519480103
      item: Vaillant_HMU_Main_Board_VerdampfungsTemperatur
      name: Verdampfungstemperatur
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 243.15102163562094,460.44801059099865
      item: Vaillant_HMU_Main_Board_KondensationsTemperatur
      name: Kondensationstemperatur
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 80.02438686741955,580.484590892128
      item: VaillantHMUMainBoard_HeizwasserDurchflussrate
      name: DurchfluĂźrate Heizkreis
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 29.54746592027799,145.2750407747001
      item: Vaillant_HMU_Main_Board_EEV_Auslass_Temperatur
      name: EEV Auslasstemperatur
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 28.93189371360553,305.3238145095392
      item: Vaillant_HMU_Main_Board_Position_Expansionsventil
      name: EEV Position
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 29.54746592027799,449.98328307756685
      item: Vaillant_HMU_Main_Board_Kondensator_Auslass_Temperatur
      name: Kondensator Auslasstemperatur
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 347.7982967699388,-20
      icon: oh:fan
      item: Vaillant_HMU_Main_Board_Leistung_Lufter_1
      name: Leistung LĂĽfter 1
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 146.50618518804504,-20
      icon: oh:fan
      item: Vaillant_HMU_Main_Board_Leistung_Lufter_2
      name: Leistung LĂĽfter 2
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 307.7861033362291,-20
      icon: oh:time
      item: VaillantHMUMainBoard_BetriebsstundenLufter1
      name: Betriebsstunden LĂĽfter 1
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 269.0050543158642,-20
      icon: classic:start
      item: VaillantHMUMainBoard_StartsLufter1
      name: Starts LĂĽfter 1
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 108.34070837435263,-20
      icon: oh:time
      item: VaillantHMUMainBoard_BetriebsstundenLufter2
      name: Betriebsstunden LĂĽfter 2
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 68.9440871473153,-20
      icon: classic:start
      item: VaillantHMUMainBoard_StartsLufter2
      name: Starts LĂĽfter 2
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 139.11931870797554,290.5500815494002
      icon: oh:time
      item: VaillantHMUMainBoard_BetriebsstundenKompressor
      name: Kompressor Betriebsstunden
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 137.8881742946306,365.6498907634401
      icon: classic:start
      item: VaillantHMUMainBoard_KompressorStarts
      name: Kompressor Starts
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 180.97822876170267,576.1755854454208
      item: Heizleistung_Waermepumpe
      name: Heizleistung Wärmepumpe
      tooltipColor: darkred
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 229.60843308882687,643.8885281793912
      name: COP
      tooltip: "COP:"
      tooltipColor: blue
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 229.60843308882687,676.5138551330315
      item: COP_VaillantWaermepumpe
      name: Effizienz
      tooltipColor: blue
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 226.53057205546457,547.8592639384877
      item: Vaillant_HMU_Main_Board_Rucklauf_Temperatur
      name: RĂĽcklauftemperatur Heizkreis
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 346.5671523565939,669.7425608596344
      icon: oh:pressure
      iconRotation: 0
      item: VaillantVRC700general_Waterpressure
      name: New Marker
      tooltipColor: magenta
      tooltipDirection: top
      tooltipFontSize: 20px
      tooltipOffsetY: -15
      tooltipPermanent: true
      useTooltipAsLabel: false
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 267.7739099025193,538.6256808384009
      name: Warmwasser
      tooltip: 100% = Warmwasser
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 136.6570298812857,216.68141674870526
      name: Kompressor
      tooltip: "Kompressor:"
      tooltipFontSize: 20px
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 291.7812259627451,356.4163076633532
      item: Vaillant_HMU_Main_Board_Kompressor_Heizwendel
      name: Heizwendel Kompressor
      tooltipColor: magenta
      tooltipDirection: bottom
      tooltipFontSize: 20px
      tooltipOffsetY: 15
      tooltipPermanent: false
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 425.975967017341,8.618010893414413
      icon: oh:line
      item: VaillantHMUMainBoard_EnergieIntegral
      name: Enerie Integral
      tooltipColor: magenta
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 448.75213866422195,9.849155306759329
      name: Energie Integral Text
      tooltip: "Energie Integral:"
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 291.1656537560727,571.8665799987135
      item: VaillantHMUMainBoard_BetriebsstundenGebaudepumpe
      name: Betriebsstunden Gebäudepumpe
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 422.8981059839787,177.9003677283404
      item: VaillantHMUMainBoard_Schaltvorgange4WegeVentil
      name: Schaltspiele 4-Wege Inverter Ventil
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 422.8981059839787,202.5232559952387
      name: Schaltspiele VUV Label
      tooltip: Schaltsp.
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 90.48911438085133,374.883473863527
      item: Vaillant_HMU_Main_Board_Kondensatwannen_Heizung
      name: Heizung Kondensatwanne
      tooltipColor: magenta
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 304.7082423028668,650.6598224527883
      icon: classic:start
      item: VaillantHMUMainBoard_GebaudepumpeStarts
      name: Starts Gebäudepumpe
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 15
      tooltipPermanent: true
    slots:
      default: []

And the setup for the indoor unit page /static/VML105_6_in.png as YAML file here:

config:
  backgroundColor: white
  imageHeight: 480
  imageUrl: /static/VML105_6_in.png
  imageWidth: 640
  label: Wärmepumpe VML105/6 Indoor
  order: "1"
  sidebar: true
  visibleTo:
    - role:administrator
    - role:user
markers:
  - component: oh-plan-marker
    config:
      coords: 281.9320706559858,531.8543865650038
      item: VaillantCirculationPump_StatusHWCCirculationPump
      name: Zirkulationspumpe
      tooltipColor: magenta
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 445.0587054241872,322.559836296368
      item: Vaillant_HMU_Main_Board_Vorlauf_Temperatur
      name: Vorlauftemperatur Heizkreis
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 288.7033649293829,338.5647136698519
      item: VaillantVRC700hotwatercircuit_HWCstoragetemptemperature
      name: New Marker
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 230.83957750217178,471.5283103111029
      item: VaillantVRC700hotwatercircuit_HWCflowtemperaturetemperature
      name: Zustand Vorrang-Umschalt-Ventil
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 140.9660353279929,482.60861003120715
      item: VaillantHMUMainBoard_SchaltvorgangeVUVWarmwasser
      name: Schaltspiele VUV
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 125.57673016118144,347.7982967699388
      icon: oh:pressure
      item: VaillantVRC700general_Waterpressure
      name: Wasserdruck Heizkreis
      tooltipColor: magenta
      tooltipDirection: bottom
      tooltipFontSize: 20px
      tooltipOffsetY: 15
      tooltipPermanent: true
      useTooltipAsLabel: false
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 416.74238391725413,674.667138513014
      icon: oh:radiator
      iconSize: 120
      name: Heizkörper
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 320.0975474696782,677.1294273397039
      icon: classic:shower
      iconSize: 100
      name: Dusche
      tooltipPermanent: true
      useTooltipAsLabel: false
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 96,441.5
      icon: oh:water
      item: VaillantHMUMainBoard_BetriebsstundenWarmwasser
      name: Betriebsstunden Warmwasser
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 16
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 61.55722066724581,439.51855556413506
      icon: oh:radiator
      item: VaillantHMUMainBoard_BetriebsstundenHeizkreis
      name: Betriebsstunden Wärmepumpe Total
      tooltipColor: magenta
      tooltipDirection: right
      tooltipFontSize: 20px
      tooltipOffsetX: 19
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 91.72025879419625,527.5453811182966
      name: Betriebsstunden WW text
      tooltip: Betriebsstunden Warmwasser
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 58.47935963388352,527.5453811182966
      name: Betriebsstunden Heizen Text
      tooltip: Betriebsstunden Heizen
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 362.5720297300778,465.98816045105076
      icon: classic:level
      name: Pumpenregler
      tooltipPermanent: true
    slots:
      default: []
  - component: oh-plan-marker
    config:
      coords: 179.1315121416853,56.632643013866144
      item: Vaillant_HMU_Main_Board_Rucklauf_Temperatur
      name: RĂĽcklauf Temperatur Indoor
      tooltipFontSize: 20px
      useTooltipAsLabel: true
    slots:
      default: []

The YAML code can be copied into the appropriate pages.

I apologize that many items are in German but at the time i have created them, i didn’t imagine to publish them here. Please regard this as a bit of German language training :wink:.

1 Like