Als je via de webinterface een update uitvoert naar firmware 3.8.4 vanuit een oudere versie, zal dat mislukken. Wat nog lastiger is, is dat je voor de update naar 3.9.0 het toestel naar de fabrieksinstellingen moet terugzetten. Dit kun je NIET op afstand doen!
Gateways die zijn bijgewerkt naar versie 3.9.0 KRIJGEN EEN NIEUW MAC-ADRES! Je DHCP-reservering werkt daardoor niet meer en het IP-adres verandert ook.
Handleiding bijwerken
Hieronder vind je een handleiding voor het upgraden. Het plan van de EMS-ESP-ontwikkelaars is dat iedereen uiteindelijk op de hoofdversie komt, die door de ontwikkelingsbranch wordt aangestuurd, zodat ze kunnen blijven innoveren terwijl Espressif (de ESP-microcontroller) nieuwe kernbibliotheken en hardwarevarianten blijft uitbrengen.
EMS Gateway E32 V2 en V2.2
Deze apparaten gebruiken firmware-bin-bestanden die eindigen op ESP32-16MB+
Een directe update van de versies 3.8.2, 3.8.3 en 3.8.3-dev.x naar een willekeurige versie uit de v3.9.x-reeks of nieuwer lukt niet. Oplossing 1: Download de nieuwe firmware rechtstreeks uit de GitHub-repository en voer de update uit via het drag-and-drop-veld in de webinterface. Oplossing 2: Update eerst naar 3.8.4 en daarna naar 3.9.x.
Deze apparaten gebruiken firmware-bin-bestanden die eindigen op ESP32S3-16MB+.
Een directe update van de versies 3.8.2, 3.8.3 en 3.8.3-dev.x naar een willekeurige versie 3.9.x of nieuwer lukt niet. Oplossing 1: Download de nieuwe firmware rechtstreeks uit de GitHub-repository en werk bij via het drag-and-drop-veld in de webinterface. Oplossing 2: Werk eerst bij naar 3.8.4 en daarna naar 3.9.x.
Deze apparaten gebruiken firmware-bin-bestanden die eindigen op ESP32-4MB of ESP32-16MB.
Het updaten van versie 3.8.2 naar alle andere versies lukt niet; dit geldt ook voor v3.8.2-dev23, v3.8.3-dev0, v3.8.3-dev1 en v3.8.3-dev2. Oplossing 1: schakel instellingen/app/ontwikkelaarsopties in, installeer op de versiepagina de opgeslagen versie en werk vervolgens bij naar de gewenste versie. Oplossing 2: flash de nieuwe versie via USB en de EMS-ESP-flashtool.
De laatste revisie V2.2 van de EMS Gateway E32 V2 printplaat werd geïntroduceerd in de zomer van 2025. De V2.2 printplaat heeft een paar extra sensoren die worden weergegeven in de Sensors tab van EMS-ESP en beschikbaar zijn via MQTT en de andere API’s. Omdat we de laatste tijd een paar vragen kregen over deze sensoren geven we hier wat meer details.
Tabblad sensoren EMS Gateway V2.2
Temperatuursensor
De eerste sensor is ‘gateway_temperature’ en is een SMD type DS18B20U temperatuursensor die direct op de printplaat is gemonteerd. De DS18B20-sensor is verbonden met GPIO14, dezelfde pin die wordt gebruikt voor het aansluiten van externe DS18B20-sensoren via de JST-connector. De sensor is in het midden van de printplaat geplaatst, uit de buurt van hete componenten. Deze sensor meet de interne temperatuur van de Gateway. Het gaat dus niet om de interne temperatuur van de ESP32 chip zelf, maar om de temperatuur in de behuizing. Als je de Gateway bijvoorbeeld in of op de ketel monteert, waar het warm of heet kan worden (niet aanbevolen), kun je de temperatuur in de gaten houden. Of stel een temperatuuralarm in via de planner.
Spanningssensoren
Er zijn twee spanningsmonitoren op de printplaat. De eerste is ‘core_voltage’ die de 3,3V uitgang van de interne spanningsregelaar van de printplaat monitort. Deze spanning wordt gebruikt om de hele printplaat van stroom te voorzien. Deze spanningsmonitor is verbonden met GPIO39.
De tweede heet ‘supply_voltage’ en wordt verbonden met GPIO36. Deze bewaakt de externe voedingsspanning van de Gateway. Deze kan afkomstig zijn van de USB-C poort (5V DC), de EMS service aansluiting (8,5V of 12VDC) of de externe DC ingang (12V DC). Als er meerdere voedingsingangen tegelijkertijd worden gebruikt, zal deze monitor de hoogste spanning weergeven.
Blauwe LED
In de sectie Analoge sensoren kun je ook de entiteit ‘led’ vinden. Dit is geen sensor, maar een blauwe LED die is aangesloten op GPIO2. Dit is de LED die was gemonteerd op alle oudere E32 V2 printplaten en hij is nog steeds gemonteerd op de nieuwste V2.2 printplaten, zelfs als er ook een RGB LED naast zit. De blauwe LED is gehandhaafd om redenen van achterwaartse compatibiliteit. Als je b.v. firmware 3.7.2 of ouder laadt, is er geen ondersteuning voor het E32 V2.2 bordprofiel en werkt de RGB LED niet. Maar onder normale omstandigheden wordt de blauwe LED niet gebruikt als de RGB LED beschikbaar is. Je kunt hem echter nog steeds in- of uitschakelen via deze sensorentiteit.
Het Duitse computertijdschrift c’t van de grote Duitse uitgever Heise.de publiceerde een artikel over het open source project EMS-ESP, dat de basis vormt van onze producten. Er werd ook aandacht besteed aan ons EMS Interface bordje en de EMS Gateways.
Vertaling naar het Nederlands: Thermische monitor Zonder de cloud: bewaken en regelen van verwarmingssystemen van Bosch, Buderus en Junkers
Volgens Bosch heb je een verbinding met de cloud van de fabrikant nodig om verwarmingssystemen te evalueren en te regelen. Het open-source project EMS-ESP neemt een kortere weg en verbindt het verwarmingssysteem met het lokale netwerk en open regelcentra zoals Home Assistant en OpenHAB via het EMS-protocol. Zo kun je de kloof overbruggen en je verwarmingssysteem automatiseren.
Waar te lezen/krijgen
Het artikel is te lezen op hun heise+ pagina en natuurlijk in het c’t magazine zelf dat vanaf 9 januari 2026 in de winkels en online verkrijgbaar is.
Als je wilt updaten via USB of je moet een specifieke firmware versie laden op je BBQKees Gateway, dan moet je het juiste bin bestand uploaden naar je Gateway, anders kan hij vastlopen.
Voor het uploaden van een nieuwe firmware naar je Gateway via USB moet je de EMS-ESP flash tool gebruiken. Zie de wiki hier voor meer instructies. In sommige gevallen kun je de firmware handmatig downloaden en uploaden via de webinterface van de Gateway.
Op de EMS-ESP Github repository kun je de firmware bin bestanden downloaden. De naamgevingsconventie sinds firmware 3.6.5 is gestructureerd op basis van het chiptype (chipset) en functies, en heeft niet de naam van een Gateway-product in zich.
Het is als volgt opgebouwd:
EMS-ESP-<version>-<chipset>-<flashsize>[+].bin
waarbij <chipset> is ESP32 of ESP32S3 en <flashsize> ofwel 4MB of 16MB. De + geeft aan dat de firmware is gebouwd om eventueel extra RAM (PSRAM genoemd) te gebruiken als dat beschikbaar is.
Als je een specifieke firmware versie 3.7.2 wilt uploaden naar bijvoorbeeld een nieuwe E32 V2 Gateway, moet je eerst opzoeken welke ESP32 chip wordt gebruikt. De E32 V2 heeft een ESP32 chipset met 16MB Flash en 8MB PSRAM. De bestandsnaam van het bin-bestand is dan EMS-ESP-3_7_2-ESP32-16MB+.bin.
Hieronder een handige lijst over welk Gateway model welke functies heeft en dus welk firmware bin bestand nodig heeft.
Als je een EMS-interfacekaart hebt gekocht, heb je een ESP32-ontwikkelbord nodig. Omdat er ongeveer 100 verschillende verkrijgbaar zijn, moet u zorgvuldig controleren welke ESP32-processor deze heeft. Controleer vervolgens de grootte van het Flash-geheugen en of het PSRAM heeft.
Momenteel is het populairste bord de Lilygo T7 S3. Het heeft een ESP32-S3 chipset, 16MB Flash en 8MB PSRAM. Voor deze heb je het bin-bestand nodig: EMS-ESP-3_7_2-ESP32S3-16MB+.bin. Een ander populair goedkoop bord is de MH-ET Live D1 Mini (of kloon) module met de ESP32 chipset, 4MB Flash en geen PSRAM. Voor dit bord heb je het bin-bestand nodig: EMS-ESP-3_7_2-ESP32-4MB.bin
Als je een bin-bestand zonder de ‘+’ op het einde (wat betekent dat het voor borden zonder PSRAM is) laadt op een ESP-module die wel PSRAM aan boord heeft, zal EMS-ESP werken. De PSRAM wordt echter niet gezien en niet geactiveerd.
Als je een ‘+’ bin-bestand laadt op een bord zonder PSRAM, kan het zijn dat het niet opstart.
Als je een Gateway van eender welk type hebt en een Fritzbox mesh netwerk (sommige andere mesh netwerken geven ook problemen) kan de Gateway om de paar uur bevriezen.
We werken hard aan een oplossing. Blijf indien mogelijk op firmware 3.5.1 of ouder.
Als u dit probleem ondervindt, plaats dan een opmerking in de Github-repository:
Firmware EMS-ESP 3.5.0 is al geruime tijd beschikbaar als beta en werd al sinds oktober 2022 op nieuwe Gateways geladen, de release versie van 3.5.0 (stabile) is nu ook beschikbaar. Dankzij het vele werk van Proddy en MichaelDvP en de hulp van een aantal andere medewerkers is dit een van de meest uitgebreide updates tot nu toe.
— Vergeet niet dat de firmware volledig open source is…
De meest opvallende nieuwe functie zal de toevoeging van lokalisatie zijn. Dit betekent dat u nu de taal kunt veranderen van Engels naar andere talen. De release van 3.5.0 zal Engels, Duits, Nederlands, Pools, Frans, Zweeds en Noors bevatten.
Zweedse interfaceDuitse interface
Deze lokalisatie zit in alle belangrijke onderdelen van EMS-ESP: de webinterface en MQTT.
Er zijn echter enkele veranderingen. De belangrijkste is dat er nu ondersteuning is voor meerdere Gateways op een enkele MQTT broker. Indien ingeschakeld, wat nu de standaard is, zullen alle MQTT Discovery Entity ID’s de MQTT-basisnaam en de korte naam van de EMS-ESP-apparaatentiteit bevatten. Bijvoorbeeld wat voorheen sensor.boiler_actual_boiler_temperature was, wordt nu sensor.ems_esp_boiler_boiltemp. Dit betekent dat deze entiteiten binnen HA moeten worden vervangen. Zie hieronder. Wil je toch het oude formaat gebruiken en de geschiedenis en scriptcompatibiliteit in Home Assistant behouden, stel dit dan weer in op het oude formaat.
Nieuwe functies en updates
Samenvatting van nieuwe dingen:
Lokalisatie: toevoeging van Duitse, Nederlandse, Poolse, Zweedse, Franse en Noorse taalopties.
Ondersteuning voor meerdere gateways op dezelfde broker (voor hybride systemen en voor meerdere ketels/cascade)
100+ bugfixes en nieuwe functies
Eerste ondersteuning toegevoegd voor ESP32 C3- en S2-architecturen.
Verschillende nieuwe bestuursprofielen
Verbeteringen in HA-detectie en MQTT-afhandeling
Toevoeging van nieuwe EMS-ketels, thermostaten en andere toestellen (Greenstar 30, GBH192iT, FW500, BC30)
toevoeging van extra parameters van bekende EMS-apparaten (bv. RC30 interne temperatuur, 20+ warmtepompparameters)
Verbeterde behandeling van logica/telegrammen van sommige EMS-apparaten
Instellen van de 4 multifunctionele relais/ingangen van warmtepompen (via API)
Het updaten naar de release versie van 3.5.0 hangt af van welke firmware u nu gebruikt en wanneer u een Gateway product heeft gekocht. In de meeste gevallen moet u een update eerst uitproberen via de webinterface. Als het lukt, zit u op 3.5.0. Als het niet lukt, moet u de Gateway flashen via de interne USB-verbinding op het bord van de Gateway.
Lees de onderstaande instructies voor de juiste updateprocedure voor uw situatie.
Als u momenteel een versie 3.3 of ouder gebruikt, moet u hoe dan ook de USB-methode gebruiken. Als u momenteel een versie 3.4 of 3.5 gebruikt, probeer dan eerst de update via de webinterface en als dat niet lukt, update dan via de USB-poort.
Het uploaden duurt ongeveer een minuut. Als de Gateway de firmware heeft geïnstalleerd en zichzelf opnieuw heeft opgestart, zou u na enige tijd het inlogscherm weer moeten zien. Druk op F5 om de cache van de browser te wissen. Log dan in. Instellingen moeten worden aangehouden.
Als u tijdens het uploaden een error 500 krijgt, moet u overgaan naar methode twee hieronder.
Als u een E32-gateway hebt en deze na de update onbereikbaar werd, kan het zijn dat het boardprofiel is teruggezet naar S32 of Custom. Log in op het ems-esp toegangspunt, zet het bordprofiel terug op E32, sla op en start opnieuw op. Ethernet wordt weer geactiveerd.
Methode twee: Update via de USB-poort
In veel gevallen moet u deze firmware uploaden via de USB-poort aan de binnenkant van de Gateway. Het is de enige keer dat dit nodig is, als 3.5.0 eenmaal is geïnstalleerd, kunnen alle toekomstige updates worden gedaan via de webinterface.
U moet de Gateway openen, de USB op een computer aansluiten en de firmware laden via de EMS-ESP flashtool. Gebruik GEEN ander flashgereedschap, want dat werkt niet. Alle instellingen gaan verloren na deze update, dus noteer alle belangrijke instellingen. (U kunt ook een back-up maken van uw instellingen en aanpassingen vóór de update en deze weer uploaden zodra de update klaar is).
Als je vragen hebt over de update kun je me een e-mail sturen via het contactformulier.
Brekende verandering: MQTT entiteit ID’s
Voor een aantal entiteiten in Home Assistant is de unieke ID veranderd in de autodetectieconfiguratie. Dit betekent dat deze entiteiten binnen HA moeten worden vervangen. Dit komt omdat er nu ondersteuning is voor meerdere Gateways op een enkele MQTT broker. Indien ingeschakeld, wat nu de standaard is, zullen alle MQTT Discovery Entity ID’s de MQTT-basisnaam en de korte naam van de EMS-ESP-apparaatentiteit bevatten. Bijvoorbeeld wat voorheen sensor.boiler_actual_boiler_temperature was, wordt nu sensor.ems_esp_boiler_boiltemp. Dit betekent dat deze entiteiten binnen HA moeten worden vervangen. Zie hieronder. Wil je toch het oude formaat gebruiken en de geschiedenis en scriptcompatibiliteit in Home Assistant behouden, stel dit dan weer in op het oude formaat. Er is een nieuw selectievakje in de instellingen om de ID te behouden zoals in firmware 3.4 voor degenen die nu niet willen overschakelen.
Na de update naar 3.5.0 is het mogelijk dat u tijdens het laden of bekijken van de webinterface soms een Error 507 krijgt. Dit komt omdat de nieuwe webinterface een vrij groot stuk geheugen nodig heeft, dat niet altijd beschikbaar is. Dan krijg je deze error 507. Alle andere diensten op de Gateway blijven werken. Zie: https://github.com/emsesp/EMS-ESP32/issues/823
Bosch heeft internet gateways voor geselecteerde EMS-ketels en warmtepompen. Het gaat om een reeks modellen zoals de KM50, KM100, KM200 en MBLAN 2. Afhankelijk van het merk zijn er kleine variaties. Nefit noemt het gewoon ‘internetmodule’. Er is een extern model voor bestaande ketels en een interne module voor warmtepompen. Met deze gateway en een app op je telefoon kun je (deels) zien wat je ketel doet.
De BBQKees EMS Gateways geven ook inzicht in ketelparameters.
Ik krijg vaak vragen over het verschil tussen de EMS Gateway en de Bosch KM200 Internet Gateway. In dit artikel leg ik het nader uit.
Hoe werkt de KM200?
De KM200 (en de andere Bosch internet gateways) maken verbinding met de CAN- of EMS-bus van de ketel of warmtepomp en uw thuisnetwerk. De gegevens die het van de bus opvangt, worden vervolgens naar de cloud gestuurd. Je moet een app op je telefoon installeren om de gegevens te zien. De app doet dit door verbinding te maken met de cloud en uw ketelgegevens uit de cloud op te halen. Dus al uw ketelgegevens worden in de cloud opgeslagen. Het zorgt voor een koppeling tussen uw ketel en een app via de cloud.
Hoe werkt de EMS Gateway
De EMS Gateways maken ook verbinding met de EMS-bus van uw ketel of warmtepomp en uw thuisnetwerk. De gegevens die het opvangt, worden vervolgens naar uw domotica gestuurd, zoals Home Assistant of Domoticz. Het hangt ervan af hoe u uw domotica heeft geconfigureerd, hoe u toegang heeft tot de gegevens. Waarschijnlijk via een webinterface op je pc maar waarschijnlijk ook via een app. De EMS Gateway zorgt voor een verbinding tussen uw ketel en uw domotica uitsluitend via uw thuisnetwerk. U hebt dus geen externe clouddienst nodig. Alle ketelgegevens worden lokaal opgeslagen in uw domoticasysteem.
Aantal beschikbare datapunten
Bestaande bezitters van een KM200 zijn vaak verrast door de hoeveelheid datapunten/entiteiten die de EMS Gateway biedt ten opzichte van de KM200. Met de EMS Gateway krijg je meestal 60 entiteiten van alleen de ketel. Bij sommige ketels en warmtepompen kan dit oplopen tot veel meer (100+). Voor thermostaten en mengmodules hangt het af van het specifieke model, maar er komen altijd interessante waarden uit.
De EMS Gateways draaien op uw lokale netwerk en werken zonder cloud service. Dit is zo ontworpen en het is een mooie functie op zich, omdat u niet afhankelijk hoeft te zijn van een externe internetdienst om uw eigen domotica perfect te laten werken.
Een cloudverbinding biedt echter één voordeel dat het draaien van iets op uw lokale netwerk niet heeft: gemakkelijke toegang op afstand. Als je iets in de cloud zet, zijn de gegevens overal beschikbaar. Als u het alleen in uw thuisnetwerk plaatst, is het niet altijd gemakkelijk om er toegang toe te krijgen als u niet thuis bent. Maar er zijn verschillende manieren om het eruit te krijgen.
Maak een VPN-verbinding (beveiligd)
Bijna alle fatsoenlijke routers ondersteunen een VPN-dienst. Door een VPN-server op uw router in te stellen, kunt u op afstand een veilige verbinding maken met uw thuisnetwerk. Zodra u verbinding maakt met het VPN, denkt uw toestel dat het zich in het thuisnetwerk bevindt. Daarom kunt u ook via het interne IP-adres toegang krijgen tot de gateway of uw huisautomatisering.
Let op: dit is anders dan een VPN-dienst waarvoor je een abonnement kunt kopen, zoals NordVPN. Dat is een VPN-client en is bedoeld voor veilig surfen op het web. Dit is andersom.
Het voordeel van een VPN-verbinding met je thuisnetwerk is dat je een zeer veilige verbinding hebt en dat niemand anders er (gemakkelijk) bij kan. Het nadeel is dat u elke keer de VPN-verbinding moet openen voordat u op afstand verbinding wilt maken, maar dat is een kleine prijs voor de veiligheid.
Kijk in de handleiding van je router hoe je een VPN-server instelt. Dit kan ook een Remote access VPN worden genoemd. Nadat de VPN-server draait, moet u de VPN-clients op uw mobiele telefoon of laptop instellen om toegang te krijgen tot het netwerk. Voor Android kun je een VPN-client instellen in de instelling of een externe app gebruiken zoals StrongSwan of Wifiman.
Gebruik de Home Assistant app of cloud service
Als je de Gateway hebt aangesloten op je domotica zoals Home Assistant, heb je waarschijnlijk geen specifieke toegang nodig tot de Gateway zelf. Alles wordt geladen en gevisualiseerd binnen Home Assistant. In dit geval kunt u de bestaande manieren gebruiken om op afstand verbinding te maken met Home Assistant om toegang te krijgen tot de belangrijkste functies van de Gateway. Je gebruikt waarschijnlijk al de Home Assistant-app op Android of iOS.
Als je Home Assistant op afstand wil benaderen, moet dit goed geconfigureerd worden. Er staat een goede beschrijving op de website van Home Assistant.
Een port forward toevoegen (onveilig)
Een derde manier om op afstand verbinding te maken met de Gateway is door een port forward op te zetten vanaf poort 80 van de Gateway. Op die manier krijgt u op afstand toegang tot de webinterface van de Gateway door het externe IP-adres van uw huis in te voeren, gevolgd door een poortnummer dat u in de router hebt ingesteld. Met toegang tot de webinterface van de Gateway kunt u een overzicht krijgen van alle ketelparameters en kunt u indien nodig ook de waarden van de ketel/thermostaat wijzigen.
Een voordeel van deze methode is dat u gemakkelijk op afstand verbinding kunt maken met de Gateway, maar als nadeel kunnen anderen er ook vrij gemakkelijk bij. Hoewel de webinterface van de Gateway beveiligd is met een wachtwoord, is deze nooit ontworpen om alle denkbare hackaanvallen te weerstaan.
Dus hoewel deze methode gemakkelijk op te zetten is, wordt ze niet aanbevolen. De bovenstaande VPN-methode biedt een veel betere beveiliging.
Bij sommige ketels van Bosch/Junkers/Buderus/Worcester werkt het wijzigen van een temperatuur alleen als de draaiknoppen op AUT staan. In-/uitschakelen is niet mogelijk, ook niet instellen met de knoppen. Bij andere ketelregelaars is het mogelijk om temperaturen te verzenden die lager zijn dan de instelling van de regelaar, maar niet hoger. Met sommige volledig elektronisch instelbare regelaars kunnen alle waarden worden gewijzigd. Een nieuw idee uit een recente discussie en test: device-ID 0x12 is normaal gesproken een alarmmodule waarmee de flowtemp kan worden ingesteld via een analoge ingang. Probeer ems-esp in te stellen op id 0x12 in de Instellingen en probeer dan selflowtemp en selburnpow te veranderen.
Firmware 3.4.2 en 3.4.3 hebben mogelijk een kleine bug. Als ze op een nieuwe Gateway of andere ESP32 worden geflasht, worden de instellingen niet opgeslagen. Dit betekent dat wanneer u het apparaat instelt, het na het opnieuw opstarten alle instellingen verliest. Als u vanuit een vorige versie via de webinterface een update uitvoert, doet dit probleem zich niet voor. Gateways met dit probleem die in de afgelopen weken zijn verzonden, kunnen via de webinterface worden bijgewerkt naar versie 3.5.0 en dan werkt het wel.
Als u een error 500/serverfout krijgt wanneer u de 3.5.0 firmware via de webinterface laadt, moet u de USB-verbinding in de gateway gebruiken om firmware 3.5.0 te flashen.
Het bestand is een bin-bestand met de naam EMS-ESP-3_5_0b7-ESP32.bin .
Maak vervolgens verbinding met het ems-esp wifi-netwerk van uw nieuwe gateway en ga naar instellingen->upload. Kies het bestand dat je net hebt gedownload.
De Gateway wordt nu bijgewerkt en na een minuut moet u de pagina verversen. (Misschien moet je opnieuw verbinding maken met het ems-esp wifi-netwerk).
Op de Instellingen pagina staat dan de firmware versie. Er zou nu 3.5.0 moeten staan.
Het Duitse 
