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
- Wat is eBUS en wat is eBUSd?
- Wat kun je met eBUSd?
- Merken en apparaten
- Geschiktheid controleren
- Hardware kiezen
- Veilig aansluiten
- Installatie en configuratie
- CSV en berichtdefinities
- Brink Renovent: praktijk
- Brink Elan en samenwerking
- Home Assistant en MQTT
- Automatiseringen
- Python en AppDaemon
- Storingen onderzoeken
- Veiligheid en fail-safe
- Kosten en afweging
- 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:

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?


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?
- Noteer het exacte typenummer, serienummerreeks, bouwjaar en waar mogelijk controller-/printversie.
- Zoek de installatiehandleiding en let op expliciete termen als
eBUS,X1 eBUS, bus- of regelaarconnector. - Controleer de stekker en functie. RJ12 kan bijvoorbeeld een standenschakelaar zijn; een tweeaderige klem kan ook OpenTherm zijn.
- Zoek definities voor de betreffende fabrikant en het product. Bekijk ook issues en forks, niet alleen de projectnaam.
- 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.

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.

Vijf elektrische spelregels
- Verbind alleen met klemmen die in de juiste toestelhandleiding expliciet als eBUS zijn aangeduid.
- Bevestig bij polariteitsgevoelige toestellen de klemrichting; vertrouw niet op algemene uitspraken dat eBUS altijd ongepolariseerd is.
- Gebruik een hiervoor bedoelde adapter, bij voorkeur galvanisch gescheiden. Voed die volgens zijn eigen revisiehandleiding.
- Leid eBUS-bekabeling niet door elkaar met netspanningsbedrading en plaats het geheel in een geschikte behuizing.
- 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

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

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.

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
- Filter- of storingsmelding: stuur een bericht bij een nieuwe, werkelijk ondersteunde foutstatus.
- Ventilatie bij CO₂: verhoog via een geautoriseerde regeling de ventilatie wanneer een betrouwbare CO₂-sensor langere tijd boven de grens staat.
- Vochtgestuurde badkamer: combineer relatieve vochtigheid met snelheid van stijging; voorkom nodeloos schakelen.
- Zomernachtanalyse: detecteer of buitenlucht potentieel koeler is dan binnenlucht en controleer de bypassstatus.
- Ventilatorbewaking: waarschuw als een gevraagde stand niet overeenkomt met gemeten toerental, voor zover beschikbaar.
- Onderhoud en bedrijfsuren: vergelijk runtime met filterschema en echte storingsmeldingen.
- 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 infotoont 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.
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.
