MECHSCRIPT.NL • TECHNISCHE PRAKTIJKGIDS • OKTOBER 2026

Van tweedraads communicatiebus naar Home Assistant. Begrijp het protocol, kies de juiste adapter, lees storingen en temperaturen uit en bouw betrouwbare automatiseringen — met Brink Renovent, Brink Elan en Vaillant als praktijkvoorbeelden.

Veel verwarmings- en ventilatietoestellen communiceren intern met meer informatie dan hun eigen display laat zien. eBUSd kan die berichten interpreteren en via MQTT toegankelijk maken. Dat biedt inzicht in temperaturen, bedrijfsstatus, foutcodes en — als het toestel en de definities het ondersteunen — ook instelmogelijkheden. Het is geen universele afstandsbediening: de mogelijkheden hangen af van protocol, toestelfirmware én beschikbare berichtdefinities.

  • 2 draden — fysieke eBUS-aansluiting
  • USB / netwerk — adapter naar host
  • MQTT — koppeling met Home Assistant

Dit artikel gaat over het eBUS-protocol. Niet iedere bus met twee draden is eBUS. Een OpenTherm-, Modbus-, EMS-, RS485- of fabrikantconnector is niet zonder meer uitwisselbaar. Sluit nooit op basis van connectorvorm of draadkleur aan.

Inhoud

  1. Wat is eBUS en wat is eBUSd?
  2. Wat kun je met eBUSd?
  3. Merken en apparaten
  4. Geschiktheid controleren
  5. Hardware kiezen
  6. Veilig aansluiten
  7. Installatie en configuratie
  8. CSV en berichtdefinities
  9. Brink Renovent: praktijk
  10. Brink Elan en samenwerking
  11. Home Assistant en MQTT
  12. Automatiseringen
  13. Python en AppDaemon
  14. Storingen onderzoeken
  15. Veiligheid en fail-safe
  16. Kosten en afweging
  17. Naslagwerk en bronnen

01. Wat is eBUS en wat is eBUSd?

Een communicatiebus, geen thermostaatcontact

eBUS is een seriële communicatiebus die onder meer bij warmteopwekkers, regelaars en bepaalde ventilatietoestellen wordt gebruikt. Via twee geleiders kunnen meerdere busdeelnemers telegrammen uitwisselen. De installatie heeft normaal gesproken een eigen busvoeding en een protocol voor adressering en het voorkomen van gelijktijdige transmissie (arbitration). De bus is dus iets heel anders dan een simpel relaiscontact dat alleen open of dicht staat.

eBUSd is de open-source daemon die telegrammen kan ontvangen, interpreteren en — indien geconfigureerd — verzenden. Een eBUS-adapter vormt de elektrische interface tussen de bus en USB of netwerk. De drie onderdelen hebben elk een andere taak:

Schema: eBUS-apparaat, eBUS-adapter, eBUSd, MQTT en Home Assistant
Gegevensketen: het aangesloten toestel praat niet rechtstreeks MQTT. Dat doet eBUSd na decodering van de eBUS-berichten.

Bij eBUS kan een waarde als een buitentemperatuur bijvoorbeeld als bytes op de bus staan. Pas met de juiste definitie weet eBUSd welk bericht het is, hoe de bytes moeten worden omgerekend, welke eenheid erbij hoort en op welk apparaat de waarde betrekking heeft.

eBUS, OpenTherm en Modbus: waarom het onderscheid telt

Protocol Typisch gebruik Belangrijk verschil
eBUS Verwarmingsregelaars, ketels, ventilatie Fabrikant- en toestelgebonden berichtdefinities
OpenTherm Ketel ↔ thermostaat Gestandaardiseerde thermostaatcommunicatie; andere elektrische interface
Modbus / RS485 Warmtepompen, energiemeters, techniek Registers met adres- en functiemodel; niet compatibel met eBUS
EMS / EMS-ESP Specifieke Bosch/Buderus-systemen Eigen busfamilie, eigen interface en tooling
Relais / 0–10 V / RJ12 Standenschakelaars en in-/uitgangen Contact, spanning of fysieke connector; zegt op zichzelf niets over eBUS

Een connector met vier of zes contacten is dus niet automatisch een eBUS-aansluiting. Controleer de elektrische documentatie per toestel.

02. Wat kun je met eBUSd?

Van meetgegevens tot regelinformatie

De mogelijkheden vallen grofweg in drie niveaus uiteen. Passief luisteren betekent dat eBUSd bestaande buscommunicatie volgt. Actief uitlezen houdt in dat eBUSd zelf een toegestane read-opdracht verstuurt. Schrijven betekent dat eBUSd een register of parameter probeert aan te passen. Het laatste vereist niet alleen een geldige w-definitie, maar ook dat het apparaat deze opdracht accepteert.

Doel Voorbeelden Praktisch nut
Monitoren Buiten- en binnentemperatuur, druk, toerental, bypass Dashboard en historie
Diagnose Foutcode, waarschuwing, busstatus, sensortoestand Sneller oorzaken herkennen
Prestaties Aanvoer-/retourtemperatuur, ventilatoractiviteit, bedrijfsuren Trendanalyse en afstelling
Automatiseren Condities op basis van CO₂, vocht of weersverwachting Slimmer inschakelen of waarschuwen
Actief regelen Ondersteund setpoint of bedrijfsmodus schrijven Alleen na verificatie en met begrenzing

Geen garantie op een compleet toestelprofiel. Twee identieke merken kunnen verschillende controllers, generaties of CSV-definities hebben. Het aantal aanwezige berichten is ook niet gelijk aan het aantal daadwerkelijk bruikbare Home Assistant-entiteiten.

Waarom meerdere apparaten op één bus kunnen hangen

Een eBUS-installatie kan uit meerdere deelnemers bestaan: een warmteopwekker, kamerregelaar, uitbreidingsmodule en soms een ventilatie- of zonneboilerregeling. eBUSd verschijnt technisch gezien zelf ook als deelnemer wanneer het actief communiceert. Daarom zie je in de diagnostiek mogelijk meerdere master- en slave-adressen. Dat is op zichzelf normaal: het aantal adressen is niet gelijk aan het aantal afzonderlijke apparaten in de meterkast.

Het is bovendien nuttig om fabrikantnamen van technische platforms te onderscheiden. Een product kan onder een nieuwe handelsnaam op de markt verschijnen terwijl dezelfde OEM-regeling wordt gebruikt. Andersom kan een merk binnen één productfamilie verschillende generaties met verschillende communicatiebussen verkopen. Daarom is een foto van het logo nooit voldoende om compatibiliteit vast te stellen.

03. Welke merken en apparaten?

Illustratieve warmteterugwinunit met luchtkanalen
Balansventilatie / WTW — illustratieve foto
Illustratieve PCB van communicatieadapter
Communicatiehardware — illustratieve foto

Het eBUS-ecosysteem is vooral bekend uit verwarmings- en regelsystemen, maar omvat ook installaties met ventilatie, zonnecollectoren en warmtepompen. Hieronder staan voorbeeldfamilies, geen universele compatibiliteitsgaranties.

Merk / familie Bekende toepassing Hoe zeker is eBUSd-ondersteuning?
Vaillant ecoTEC-ketels, bepaalde regelingen en aroTHERM-systemen Grote community; exacte controller en berichtdefinities bepalen de mogelijkheden
Saunier Duval / Glow-worm / Protherm Verwarming en regelapparatuur van Vaillant Group Komt voor; per model en regio controleren
Brink / ENCON Onder meer Renovent Excellent en bepaalde gekoppelde Elan-systemen Community-CSV's beschikbaar; type en adressering kritisch
Wolf Bepaalde warmte- en ventilatieregelingen Definities bestaan; niet alle Wolf-apparaten gebruiken dezelfde bus
Weishaupt Specifieke verwarmingstoestellen/regelaars Komt voor in de eBUS-configuratieomgeving
Overige OEM / rebrands Apparaten met gedeelde regelprint of fabrikantplatform Soms bruikbaar; naamplaatje alleen is onvoldoende bewijs

Sommige ventilatieproducten verschijnen ook onder merknamen als Ubbink, VisionAIR of andere OEM-labels. Dat betekent niet dat hun firmware identiek is. Ook kan één installatie meer dan één communicatieprotocol gebruiken.

Concreet: waar kijk je per fabrikant naar?

Bij Vaillant is een typische eerste vraag of je ketel of warmtepomp daadwerkelijk op een eBUS-regelaar is aangesloten. Bij sommige ecoTEC-combinaties zijn bijvoorbeeld aanvoertemperatuur, warmwatervraag, branderstatus en storingsinformatie als berichten terug te vinden. Voor een aroTHERM-warmtepomp verschilt het interessante pakket: daar kijk je eerder naar verwarmingsvraag, aanvoer en retour, buitenlucht, bedrijfstoestand en eventueel compressor- of ontdooistatus. Welke velden een specifieke installatie prijsgeeft, moet je altijd aan de hand van de eigen CSV's bevestigen.

Bij Saunier Duval, Glow-worm en Protherm heeft gedeelde fabrikantachtergrond voordelen: sommige protocollen en logica lijken op die van Vaillant. Daaruit mag je alleen geen identieke schrijfcommando's afleiden. Onder Wolf kom je zowel verwarmings- als ventilatietoepassingen tegen. Voor Weishaupt zijn apparaatidentificaties bekend in de eBUS-scansystematiek. Ook bij deze merken zijn productversie en firmware doorslaggevend.

Met andere woorden: vraag niet alleen "spreekt mijn merk eBUS?", maar vooral "welk apparaatadres, welke definitie en welke registers werken voor mijn exacte uitvoering?"

Wat betekent "ondersteund" precies?

Een apparaat kan fysiek eBUS spreken, terwijl eBUSd nog geen bruikbare CSV heeft. Omgekeerd betekent een beschikbare CSV niet dat elk schrijfcommando voor iedere firmware veilig of geldig is. Verifieer per combinatie van hardware, software, toestel en functiewens. De officiële configuratierepository en community-issues geven een beginpunt; de servicehandleiding van het toestel blijft doorslaggevend voor aansluiting en veiligheid. Bronnen 1–5

04. Hoe controleer je de geschiktheid van jouw toestel?

  1. Noteer het exacte typenummer, serienummerreeks, bouwjaar en waar mogelijk controller-/printversie.
  2. Zoek de installatiehandleiding en let op expliciete termen als eBUS, X1 eBUS, bus- of regelaarconnector.
  3. Controleer de stekker en functie. RJ12 kan bijvoorbeeld een standenschakelaar zijn; een tweeaderige klem kan ook OpenTherm zijn.
  4. Zoek definities voor de betreffende fabrikant en het product. Bekijk ook issues en forks, niet alleen de projectnaam.
  5. Start alleen met uitlezen. Controleer de signalstatus, gevonden deelnemers en enkele plausibele waarden voordat je ooit schrijft.

Typische vergissing: een warmtepomp, cv-ketel en ventilatiebox uit dezelfde catalogus hoeven niet hetzelfde protocol of dezelfde telegrammen te gebruiken. Zelfs de pinbezetting van twee qua uiterlijk gelijke connectoren kan afwijken.

Waarom een simpele ESP32 niet genoeg is

Een ESP32, D1 mini of Raspberry Pi beschikt niet vanzelf over de juiste fysieke eBUS-interface. De bus gebruikt een specifieke elektrische signaalvorm en timing, en meerdere deelnemers mogen niet willekeurig tegelijk zenden. Geschikte adapterhardware bevat daarvoor eigen schakelingen en logica. Zelf direct twee draden van een toestel op GPIO aansluiten is onveilig en kan zowel de microcontroller als het apparaat beschadigen.

Kijk bij de adapterkeuze ook naar de behuizing en de plek in huis. Een losse PCB naast een warm toestel met metalen leidingen is geen ideale permanente montage. Een USB-adapter naast je NUC is eenvoudiger te beheren, terwijl WiFi praktisch is als de technische ruimte een verdieping verder ligt. Bij WiFi maakt een vaste DHCP-reservering het beheer makkelijker, maar lost die geen zwakke radiodekking op. Een adapter die eenmaal per uur zijn verbinding verliest, levert meer problemen op dan een iets oudere firmware die maanden stabiel blijft.

05. Welke hardware heb je nodig?

Een basisinstallatie bestaat uit een geschikte eBUS-interface, een host waarop eBUSd draait, en optioneel een MQTT-broker en Home Assistant. De adapter is nodig omdat een gewone USB-naar-serieel-omzetter de elektrische laag en arbitration van eBUS niet zelfstandig implementeert.

Overzicht van benodigdheden voor eBUSd: eBUS-adapter, USB of WiFi, host en MQTT
Basisopstelling: toestelaansluiting → eBUS-adapter → host → optioneel Home Assistant. Een geschikte voeding en afgeschermde montage zijn belangrijk.

Welk adaptertype past bij jouw situatie?

Keuze Sterke punten Aandachtspunten
USB eBUS-adapter Eenvoudig, weinig netwerkafhankelijkheden Host moet fysiek binnen kabelafstand staan
WiFi eBUS-adapter Vrije plaatsing bij toestel; host elders Betrouwbare 2,4GHz-wifi en stabiele voeding gewenst
Ethernet-adapter Voorspelbare verbinding Minder gangbaar, soms extra module/voeding nodig
Raspberry Pi/GPIO-shield Compacte geïntegreerde opstelling Pincompatibiliteit en voeding zorgvuldig controleren

De officiële eBUSd-hardwaredocumentatie noemt onder meer eBUS Adapter Shield v5 en C6, plus oudere v3.x-adapters. Er bestaat ook nieuwere C5-hardware bij leveranciers. Controleer steeds de actuele revisie en vereiste firmware. Een adaptatie die rechtstreeks aan UART is gekoppeld zonder geschikte eBUS-interface is geen vervanging. Bron 2

Wat kost het?

Als globale budgetindicatie: een adapter met voeding en behuizing kost doorgaans enkele tientjes tot ruim honderd euro, afhankelijk van uitvoering en leverancier. Heb je al een Home Assistant-host en MQTT-broker, dan zijn de extra softwarekosten doorgaans nul. Dit zijn bewust geen actuele winkelprijzen; kijk voor een concrete bestelling naar de leverancier en zijn revisie.

06. Veilig aansluiten op een eBUS-installatie

De eBUS-aansluiting is een laagspanningsinterface, maar het toestel waarin hij zit kan 230 V of gevaarlijke interne spanningen bevatten. Schakel volgens de fabrikant spanningsvrij voordat een afdekking of bedieningspaneel wordt geopend. Werk niet aan een verwarmings- of ventilatietoestel als je de elektrische scheiding en de connectorfunctie niet zeker weet.

Schematisch bedradingsvoorbeeld met gescheiden eBUS-klem en RJ12 standenschakelaar
Functioneel schema — geen productspecifieke pinout. De polariteit van de fabrikantklem kan van belang zijn.

Vijf elektrische spelregels

  1. Verbind alleen met klemmen die in de juiste toestelhandleiding expliciet als eBUS zijn aangeduid.
  2. Bevestig bij polariteitsgevoelige toestellen de klemrichting; vertrouw niet op algemene uitspraken dat eBUS altijd ongepolariseerd is.
  3. Gebruik een hiervoor bedoelde adapter, bij voorkeur galvanisch gescheiden. Voed die volgens zijn eigen revisiehandleiding.
  4. Leid eBUS-bekabeling niet door elkaar met netspanningsbedrading en plaats het geheel in een geschikte behuizing.
  5. Laat de fabrikantregeling intact; eBUSd moet nooit beveiligingen omzeilen of noodventilatie uitschakelen.

Bij Brink Renovent Excellent noemt de documentatie onder andere de tweepolige X1 als eBUS/OpenTherm-aansluiting, afhankelijk van model en instelling. De RJ12 / X2 is bij verschillende uitvoeringen voor standenschakeling of toerentalregeling en is geen vervangende eBUS-klem. De Elan E-handleiding geeft voor zijn eBUS-aansluiting expliciet een polariteitswaarschuwing. Dit moet vóór aansluiten worden nagelezen. Bronnen 6–7

07. eBUSd installeren en configureren

Home Assistant OS

Op Home Assistant OS installeer je eBUSd als app/add-on vanuit een compatibele repository. Voor MQTT-discovery heb je normaliter de Mosquitto Broker nodig. De app leest bij de standaardbroker de verbindingsgegevens via Supervisor; je hoeft die niet als platte tekst in de YAML te bewaren. Bron 1

Bij eBUSd-app 26.1.x staan veel oude losse velden niet meer direct in de configuratie: parameters horen nu in commandline_options. Hieronder een voorbeeld met gereserveerd documentatie-IP, dus niet klakkeloos overnemen:

network_device: enh:192.0.2.40:3335
seed_mqtt_cfg: true
commandline_options:
  - --configpath=/share/brink
  - --mqtttopic=ebusd
  - --pollinterval=10
  - --latency=10
  - --log=all:info

Wat betekent dit? enh: duidt hier op een ondersteunde netwerkadapter in enhanced mode; het IP en de poort zijn adapterafhankelijk. seed_mqtt_cfg: true laat de app op de eerste start een standaard MQTT-discoverybestand aanmaken en past automatisch --mqttjson en --mqttint toe. --configpath verwijst naar lokale CSV's. Alleen als jouw installatie deze eigen bestanden heeft, heb je zo'n pad nodig. Gebruik voor standaardapparaten eventueel de officiële online definities. Bij lokaal gedefinieerde bestanden en uitgeschakelde scanning worden de CSV's uit de gekozen map geladen.

De bijbehorende bestanden kunnen er zo uitzien:

/share/brink/
└── 3c.Excellent300.csv

Voorkom dubbele CSV-definities. Twee bestanden met dezelfde bericht-ID kunnen een duplicate entry-fout geven. Plaats back-upbestanden daarom buiten de configuratiemap. In een bestaande installatie hoort een eventuele fabrikant-submap alleen aanwezig te zijn wanneer de gekozen scan- en laadstrategie daarom vraagt.

Een eerste test

Open de webterminal van de app en probeer:

ebusctl info
ebusctl scan result
ebusctl find -d -r

Met ebusctl info controleer je versie, busstatus, deelnemers en counters. scan result laat zien wat een scan heeft gevonden; zonder actieve scan kan dat beperkt zijn. find -d -r toont bekende read-definities. Probeer pas daarna een reeds bekende, veilige leesopdracht uit jouw configuratie, bijvoorbeeld:

ebusctl read -f -c Excellent300 BinnenTemperatuur

Deze laatste naam is uitsluitend een praktijkvoorbeeld voor configuraties waarin Excellent300/BinnenTemperatuur daadwerkelijk bestaat. Het veld of de circuitnaam kan bij andere CSV's anders heten. -f forceert een bus-read, dus gebruik dat gericht en niet in een snelle lus.

08. Hoe werken CSV’s, registers en eBUS-berichten?

Een ruwe eBUS-telegram bestaat uit adressen en bytes. eBUSd heeft definities nodig om daar betekenis aan te geven. Historisch gebruikt het project hiervoor CSV-bestanden. Zo’n regel beschrijft onder meer de richting (r of w), circuit, berichtnaam, bron-/doeladres, commandobytes en de velden met datatype, schaal en eenheid. Nieuwe configuratieworkflows ondersteunen daarnaast genereren vanuit TypeSpec-bronnen. Bronnen 3–4

Diagram van telegram via CSV velddefinitie naar temperatuurwaarde
Dezelfde bytes hebben zonder de juiste velddefinitie geen betrouwbare betekenis.

Voorbeeld van de logica, géén kopieerbare CSV-regel: een register heet BuitenTemperatuur, is leesbaar, hoort bij circuit Excellent300, heeft een bekende opdracht-ID en decodeert de ontvangen twee bytes als temperatuur in graden Celsius. eBUSd kan het resultaat tonen als 16.1. Het is belangrijk om die definitie voor precies dit toestel en deze firmware te controleren.

Term Betekenis
r Actief leesbericht volgens definitie
r1 t/m r9 Leesbericht met pollprioriteit
w Schrijfbericht; potentieel risicovol
circuit Logische groep, bijvoorbeeld Excellent300
QQ / ZZ Bron- en doeladres van busdeelnemers
PBSB / ID Identificatie van het bericht
datatype / divider Omrekening naar een leesbare waarde

Polling versus update: een read kan periodiek opgevraagd worden; een passief waargenomen telegram verschijnt wanneer een apparaat het zelf verstuurt. Meer polling betekent niet automatisch betere data: te agressief uitlezen kan busbelasting veroorzaken. Begin rustig en controleer de foutcounters.

Waarom temperatuurregistratie waardevol is

Een enkele buitentemperatuur zegt weinig over de prestatie van een WTW. Idealiter vergelijk je de buitenlucht, afvoerlucht, toevoerlucht en binnenlucht op hetzelfde tijdstip en houd je rekening met de actuele bypassstand. Het temperatuurverschil over de warmtewisselaar kan in een stabiele winterbedrijfssituatie iets zeggen over warmteterugwinning, maar het is géén gecertificeerde rendementsmeting: debieten, vocht, sensornauwkeurigheid en interne warmte van ventilatoren beïnvloeden de uitkomst.

Een zelfgeschreven algoritme kan bijvoorbeeld elke vijftien minuten een trendwaarde bewaren en pas adviseren om nachtkoeling te gebruiken als het temperatuurverschil gedurende meerdere meetpunten gunstig blijft. Dat voorkomt dat een kortstondige windvlaag of een onnauwkeurige sensor direct tot een andere ventilatiestand leidt. Ook hier geldt: alleen daadwerkelijk ondersteunde bedieningsroutes inzetten, en nooit de fabrikantstrategie voor vorst of condensatie omzeilen.

09. Praktijk: Brink Renovent Excellent

De Renovent Excellent 300/400 is een balansventilatie-unit met warmteterugwinning. Bij relevante uitvoeringen is een eBUS-aansluiting beschikbaar. Community-projecten hebben voor bepaalde modellen registers gedocumenteerd, waaronder temperatuurmetingen, ventilatorwaarden, bypassinformatie en bedrijfsstatussen. De beschikbaarheid verschilt per serie, besturingsprint en gebruikte CSV. Bronnen 5–6

Welke data is interessant?

Gegeven Mogelijke toepassing
Binnen- en buitentemperatuur Nachtkoeling, thermische trends
Aanvoer-/afvoertemperatuur WTW-prestaties begrijpen
Bypassstatus / instellingen Zichtbaar maken waarom de bypass open of dicht staat
Ventilatorstand, toerental, debiet Controle of gevraagde ventilatie daadwerkelijk geleverd wordt
Filter-/storingsstatus Preventief onderhoud en meldingen
CO₂-ingangen Vraaggestuurde ventilatie, mits sensor en register werkelijk werken

Praktijkobservatie: in een werkende Excellent-configuratie werden via eBUSd 26.1.8 onder andere BinnenTemperatuur, BuitenTemperatuur, BypassStatus en BypassTemperatuur succesvol gepolld. Eén installatie rapporteerde 141 geladen berichtdefinities. Dat bewijst dat die configuratie telegrammen kan decoderen, maar niet dat iedere definitie op ieder toestel werkt.

Een effectieve aanpak voor de bypass

Een bypass kan buitenlucht langs de warmtewisselaar leiden, maar open is niet altijd koelen. Als buitenlucht warmer of vochtiger is, kan de uitkomst tegenvallen. Een goed Home Assistant-algoritme combineert bijvoorbeeld temperatuurverschil, seizoenscontext, binnentemperatuurtrend, hysterese en minimale schakeltijd. Laat de fabrieksbeveiligingen en vocht-/vorstlogica van het toestel leidend blijven. Gebruik de eBUS-gegevens om beslissingen te onderbouwen, niet om veiligheidsgrenzen te overschrijven.

10. Brink Elan: wat loopt via eBUS en wat niet?

Bij Brink is het onderscheid tussen modelgeneraties essentieel. De Elan E en Elan 4 zijn niet automatisch op dezelfde manier te bedienen. De documentatie van de Elan E beschrijft een eBUS-aansluiting op X1 en een afzonderlijke RJ12 X2 voor toerentalregeling; ook zijn er aparte contacten voor thermostaatvraag en speciale functies. Bij de Elan 4 beschrijft Brink een koppeling met de Renovent Excellent via eBUS. Bronnen 7–8

Conceptschema: Elan, Renovent, eBUS-adapter en gescheiden thermostaatregeling
Conceptueel schema: warmeluchtverwarming en WTW kunnen samenwerken, maar hun regelfuncties blijven per toestel verschillend.

Cruciaal: dat een Elan E eBUS-connector heeft, betekent niet dat er automatisch een complete publiek beschikbare eBUSd-registerset voor de Elan E bestaat. In een gecombineerde installatie kan eBUSd veel gegevens van de Renovent lezen, terwijl de Elan-verwarming nog via thermostaatcontacten of een eigen regeling wordt bediend. Dat is geen beperking van MQTT, maar een kwestie van gedocumenteerde commando's en toestelontwerp.

Wat is verstandig bij een combinatie?

  • Houd verwarmingsvraag en ventilatievraag als aparte functies in Home Assistant.
  • Gebruik de eBUS-metingen van de WTW voor analyse en context.
  • Regel de Elan alleen via door Brink toegestane ingangen of aantoonbaar ondersteunde buscommando's.
  • Definieer prioriteiten: vorstbeveiliging, storingen en normale ventilatie moeten ook zonder Home Assistant blijven functioneren.

Een dashboard dat werkelijk iets uitlegt

De bruikbaarste weergave is vaak niet de pagina met de meeste sensoren. Maak drie overzichtelijke groepen. Gezondheid: adapter online, signaalstatus, actieve storingen en laatste succesvolle update. Ventilatie: gevraagde stand, gemeten toerental/debiet, bypassstatus en filterinformatie. Comfort: binnen- en buitentemperatuur, CO₂, luchtvochtigheid en temperatuurtrend. Zo zie je in één oogopslag of een opvallende kamerwaarde een meetfout, veranderde buitenlucht of een echte toestelactie is.

Let speciaal op de last_changed– en updatecontext van entiteiten. Een sensor die urenlang op 22,2 °C blijft staan kan echt stabiel zijn, maar ook een oude MQTT-waarde tonen. Controleer daarom ten minste één sensor waarvan de waarde redelijkerwijs in de tijd beweegt en vergelijk die met het actuele eBUSd-log. Een groen MQTT-icoon bewijst slechts dat de brokerverbinding bestaat, niet dat ieder register nog goed uitgelezen wordt.

11. eBUSd, MQTT en Home Assistant

MQTT is de transportlaag tussen eBUSd en Home Assistant. Een geschikte integratieconfiguratie vertaalt beschikbare lezingen naar MQTT-topics en publiceert discovery-berichten. Home Assistant creëert daarmee sensoren en eventueel bedieningselementen, afhankelijk van de definitie. MQTT Discovery is geen garantie dat elk bekend eBUS-bericht als entiteit verschijnt.

Voorbeeld van een technisch Home Assistant dashboard met ventilatiedata
Voorbeeldweergave; echte entity-ID’s, waardes en attributen zijn installatieafhankelijk.

Beheer de entity-ID's zorgvuldig. Verander bij een migratie niet tegelijk de MQTT-topicprefix, discoveryconfiguratie, CSV en apparaatnaam. Een gewijzigd uniek ID kan nieuwe entiteiten veroorzaken en bestaande dashboards of automatiseringen breken. Controleer dus vóór en na een update: aantallen entiteiten, laatste update-tijden, beschikbaarheid en werkende historische metingen.

MQTT in de praktijk

Bij een standaard Home Assistant-installatie zorgt de Mosquitto-app voor het MQTT-netwerk. eBUSd publiceert de gedecodeerde waarden naar het ingestelde onderwerp, bijvoorbeeld onder prefix ebusd. De exacte berichtstructuur hangt af van mqtt-hassio.cfg, --mqttjson en de eBUSd-versie. Gebruik voor bediening niet blind een online gevonden topic of payload; verifieer de actieve MQTT-integratiedefinitie en de schrijfbeveiligingen. Bron 1

12. Zeven nuttige automatiseringen

  1. Filter- of storingsmelding: stuur een bericht bij een nieuwe, werkelijk ondersteunde foutstatus.
  2. Ventilatie bij CO₂: verhoog via een geautoriseerde regeling de ventilatie wanneer een betrouwbare CO₂-sensor langere tijd boven de grens staat.
  3. Vochtgestuurde badkamer: combineer relatieve vochtigheid met snelheid van stijging; voorkom nodeloos schakelen.
  4. Zomernachtanalyse: detecteer of buitenlucht potentieel koeler is dan binnenlucht en controleer de bypassstatus.
  5. Ventilatorbewaking: waarschuw als een gevraagde stand niet overeenkomt met gemeten toerental, voor zover beschikbaar.
  6. Onderhoud en bedrijfsuren: vergelijk runtime met filterschema en echte storingsmeldingen.
  7. Comfortdashboard: laat temperaturen, bypassstatus en luchtkwaliteit naast elkaar zien.

Voorbeeld: temperatuuralarm in Home Assistant

Het onderstaande voorbeeld doet geen schrijfactie op de bus. Vervang de voorbeeldentity door de werkelijk aanwezige entiteit uit jouw installatie.

alias: WTW - onverwacht hoge inblaastemperatuur
triggers:
  - trigger: numeric_state
    entity_id: sensor.wtw_inblaastemperatuur
    above: 30
    for: "00:10:00"
conditions: []
actions:
  - action: notify.mobile_app_mijn_telefoon
    data:
      title: "WTW: temperatuurwaarschuwing"
      message: >-
        Inblaastemperatuur is gedurende 10 minuten
        hoger dan 30 °C. Controleer de WTW.
mode: single

De grens van 30 °C is slechts een voorbeeldwaarde. Bij gebruik moet hij aansluiten bij de eigen installatie en meetlocatie. Voor veiligheidskritische signalen is een Home Assistant-notificatie nooit een vervanging van een door de fabrikant vereiste alarm- of beveiligingsketen.

13. Verder met Python en AppDaemon

Met Python kun je patronen herkennen die met één eenvoudige automatisering lastig zijn. Denk aan een buitentemperatuur die langzaam daalt, een binnenruimte die nog opwarmt, of een bypass die wel open staat maar onvoldoende koeleffect heeft. Een AppDaemon-app kan bestaande Home Assistant-entiteiten uitlezen en een advieswaarde publiceren zonder direct de Brink aan te sturen.

# Schematisch voorbeeld: analyse, geen buscommando
inside = float(self.get_state("sensor.woonkamer_temperatuur"))
outside = float(self.get_state("sensor.wtw_buitentemperatuur"))
margin = 1.5  # voorbeeld: vereiste temperatuurmarge

cooling_opportunity = outside < inside - margin
self.set_state(
    "sensor.wtw_koeladvies",
    state="gunstig" if cooling_opportunity else "ongunstig",
    attributes={"friendly_name": "WTW koeladvies"},
)

Dit fragment is illustratief: het vereist een correcte AppDaemon-appklasse, geldige sensoren, initialisatie en afhandeling van unknown/unavailable voordat je het productiegeschikt kunt inzetten. Een degelijk algoritme legt beslissingen uit, gebruikt hysterese en minimale runtijden, logt wijzigingen en kent altijd een veilige terugvalmodus.

Praktische uitbreidingen: afgeleide temperaturen in °C/uur, trendanalyse van bypassactivering, herleidbare filters voor slechte meetpunten, MQTT-logging, InfluxDB-historie en afwijkingsdetectie. Machine learning heeft pas zin wanneer je voldoende betrouwbare trainingsdata hebt en gewone regels aantoonbaar tekortschieten.

Diagnostiek van onder naar boven

Gebruik bij een storing de volgorde fysiek → adapter → protocol → definitie → MQTT → dashboard. Begin met voeding, signaal, stekkers en WiFi of USB. Controleer vervolgens ebusctl info: start eBUSd wel, wordt het signaal verkregen en blijven reconnects beperkt? Lees daarna één bekende waarde met een veilige read-opdracht. Pas wanneer dat lukt, ga je MQTT en de Home Assistant-entiteit controleren.

Op die manier onderscheid je ook drie vormen van "geen data". Een offline adapter kan helemaal geen telegrammen ontvangen. Een ontbrekende of verkeerde CSV kan wel bytes zien maar ze niet als temperatuur tonen. En een fout in MQTT-discovery kan correcte eBUSd-metingen hebben zonder dat er ooit een Home Assistant-sensor verschijnt. Deze drie problemen hebben totaal verschillende oplossingen.

14. Veelvoorkomende problemen oplossen

Logregel of verschijnsel Waarschijnlijke betekenis Eerste actie
signal lost Geen bruikbaar busniveau of signaal Bekabeling, voeding en adaptersignaal nakijken
transport closed Adaptertransport onderbroken WiFi/USB, voeding en herverbinding controleren
connection opened 127.0.0.1 gevolgd door closed Lokale client opent/sluit sessie Normaal bij periodieke statuscontroles, zolang bus blijft werken
duplicate entry Twee definities gebruiken hetzelfde bericht-ID CSV’s vergelijken; kopieën buiten laadmap plaatsen
mqtt connection established, maar geen entiteiten Broker werkt, discovery/definities mogelijk niet mqtt-hassio.cfg, scan en topics controleren
NotInitialized bij CO₂ Apparatenstatus van de sensor Controleren of sensor echt geplaatst/geconfigureerd is
found messages: N N bekende definities Niet verwarren met N werkende Home Assistant-sensoren
Ongeloofwaardige temperatuur Verkeerde scaling, bytevolgorde of sensor CSV en echte referentiemeting vergelijken

Een goede diagnose begint bij de laag waarop de fout ontstaat. Werkt de adapterpagina? Is het eBUS-signaal aanwezig? Wordt de juiste CSV geladen? Kan ebusctl een waarde lezen? Publiceert MQTT? Verschijnt die waarde in Home Assistant? Door die stappen afzonderlijk te testen, voorkom je dat een probleem met één CSV ten onrechte aan WiFi wordt toegeschreven.

15. Veiligheid, betrouwbaarheid en fail-safe

eBUSd kan actieve berichten versturen. Dat maakt onjuist gebruik risicovoller dan passief monitoren. Stel geen ketelbeveiligingen buiten werking, schrijf niet naar onbekende registers en ga bij een warmtepomp niet experimenteren met compressorbeveiliging, ontdooilogica of veiligheidssetpoints. Fabrikantspecifieke servicemenu’s bestaan niet zonder reden.

Ontwerpprincipes voor betrouwbare regelingen

  • Begin read-only: verzamel eerst historie en verifieer sensorwaarden.
  • Maak een back-up: van CSV's, firmwareversie, appconfiguratie en MQTT-instellingen.
  • Begrens schrijfacties: whitelists, minimum/maximumbereiken, minimale schakeltijd en noodstop.
  • Gebruik één beslisser: voorkom dat twee automatiseringen elkaar continu tegenwerken.
  • Definieer uitvalgedrag: wat gebeurt er bij weggevallen wifi, HA of eBUSd? De oorspronkelijke toestelregeling moet blijven werken.
  • Beperk blootstelling: adapter- en eBUSd-beheerinterfaces alleen op vertrouwd LAN/VPN; geen open TCP-poort naar internet.
  • Controleer fysieke veiligheid: netspanning scheiden, polariteit volgens handleiding, deugdelijke kabelroute en geen vrije ongeïsoleerde PCB in installatiekast.

Wanneer juist niet beginnen?

Een eBUSd-project vraagt tijd. Als je niet bij de juiste connector kunt, geen servicehandleiding hebt en je apparaat alleen via een onbekende print bereikbaar is, is wachten of een officiële integratie zoeken verstandiger. Hetzelfde geldt als je vooral een veiligheidskritische functie wilt beïnvloeden, bijvoorbeeld brander-, vorst- of compressorbeveiliging. Die functies horen in de oorspronkelijke regelkring te blijven. Je slimme huis mag ondersteunend zijn, niet de enige beveiligingslaag.

16. Is eBUSd de moeite waard?

Ja, wanneer je technisch inzicht zoekt en je toestel een aantoonbaar geschikte eBUS-implementatie heeft. Je haalt dan meer uit apparatuur die anders vooral een zwart kastje blijft. Voor wie alleen een thermostaat een graad hoger wil zetten, kan een officiële fabrikantgateway of eenvoudige thermostaatintegratie praktischer zijn.

Oplossing Pluspunten Minpunten
eBUSd Diepe data, lokaal, open-source, flexibele MQTT-integratie CSV's en compatibiliteit vragen onderzoek
Officiële fabrikantmodule Geteste functies, vaak ondersteuning Prijs, cloudafhankelijkheid, beperktere data
Modbus Goed gedocumenteerde registers als fabrikant meewerkt Alleen bij daadwerkelijk Modbus-apparaat
ESPHome via relais/sensoren Eenvoudig voor contacten, losse sensoren en eigen hardware Ziet niet automatisch de interne eBUS-gegevens
OpenTherm-interface Sterk bij compatibele ketel/thermostaat Geen oplossing voor een eBUS-bus

Een stabiel systeem dat precies doet wat nodig is, is meer waard dan een experimentele installatie die ieder weekend aandacht vraagt. Het grootste praktische voordeel van eBUSd is daarom vaak inzicht en betrouwbare diagnose, niet voortdurend actief schrijven.

17. Naslagwerk en officiële bronnen

Handige commando’s

# Status van eBUSd en bus controleren
ebusctl info

# Resultaat van eventuele apparaatdetectie
ebusctl scan result

# Definities met extra informatie bekijken
ebusctl find -d -r

# Geforceerd één bekende Brink-waarde lezen
# Alleen als jouw CSV deze circuitnaam en berichtnaam bevat:
ebusctl read -f -c Excellent300 BinnenTemperatuur

Controlelijst vóór eerste ingebruikname

  • Exact apparaat en officiële aansluittekening geïdentificeerd.
  • eBUS-adapterhardware en firmware geschikt voor de bus.
  • Aansluitklem, polariteit en voeding geverifieerd.
  • ebusctl info toont stabiel signaal en normale counters.
  • CSV's zijn uniek en laden zonder conflicten.
  • Eerst drie echte sensoren tegen een referentie gecontroleerd.
  • MQTT-discovery en entity-ID's vastgelegd.
  • Terugvalgedrag en back-up getest vóór eventuele schrijfacties.

Bronnen en verdere documentatie

[1] LukasGrebe — eBUSd Home Assistant-app, documentatie en migratie 26.1.x. Configuratieopties, MQTT-discovery, lokale bestanden en terminal.

[2] john30 — eBUSd Wiki: Hardware. Ondersteunde interfacefamilies en hardwareversies.

[3] john30 — eBUSd Wiki: Message definition. CSV, veldtypen en berichtidentificatie.

[4] john30 — eBUSd-configuratiebestanden. Community-definities en waarschuwingen.

[5] dstrigl — CSV's voor Brink Renovent Excellent 300. Communityproject, geen officiële firmwareondersteuning van Brink.

[6] Brink — Renovent Excellent 300/400, technische documentatie. eBUS/OpenTherm, klemmen en aansluitwaarschuwingen.

[7] Brink — Elan E installatievoorschriften. X1/X2 en veiligheid.

[8] Brink — Elan 4 installatievoorschriften. Voorbeeld van eBUS-koppeling met Renovent.

[9] eBUSd Wiki: Integrations. MQTT, TCP en andere koppelvlakken.

[10] Daniel Kucera — ESP eBUS-adapterfirmware. Firmware en hardware-afhankelijkheden.

DE KERN

Begin met begrijpen. Ga pas daarna regelen.

eBUSd maakt systeeminformatie inzichtelijk, maar het toestel bepaalt wat mogelijk en veilig is. Met correcte hardware, betrouwbare definities, MQTT en verstandige automatiseringen haal je meer informatie uit je verwarmings- en ventilatietechniek zonder de oorspronkelijke regeling uit het oog te verliezen.

Redactie: MechScript.nl • editie oktober 2026. Technische illustraties en sfeervolle fotografie zijn voor dit artikel gemaakt en tonen conceptuele visualisaties, geen gecertificeerde product- of aansluitfoto’s. De daadwerkelijke connectoren, klemnummers en bedrading moeten altijd met de fabrikantdocumentatie worden vergeleken.