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.
Deze handleiding laat zien hoe je eenvoudig enkele DS18B20 temperatuursensoren kunt toevoegen aan je BBQKees EMS Gateway. Je hebt hiervoor geen soldeervaardigheden nodig.
Je kunt DS18B20-sensoren toevoegen aan alle BBQKees Gateways die ooit zijn gemaakt door gebruik te maken van de kleine 3-draads JST-kabel die bij elke Gateway wordt geleverd.
Het makkelijkst te gebruiken zijn waterdichte DS18B20 sensoren met een kabel. Deze zijn goedkoop en handig in gebruik. We verkopen deze sensoren niet, ze zijn op veel plaatsen online verkrijgbaar.
U kunt een aantal van deze sensoren parallel aansluiten op een Gateway. Het specifieke aantal hangt af van de lengte van de kabel en het type DS18B20-sensor dat gebruikt wordt. Maar over het algemeen is 10 sensoren geen probleem.
Zorg ervoor dat alle sensoren van hetzelfde DS18B20 subtype zijn en dat de bedrading van de parasitaire modus en de normale modus niet gemengd worden.
Vereisten en onderdelen
BBQKees EMS Gateway
3-aderige JST ZH-kabel
DS18B20 waterdichte sensoren met kabel
3 Wago 221 lasstekker met hendels of bijv. een ‘lusterklemme’.
Draadstripper
Stap 1: Strip de draden van de JST-kabel
Je moet de draden van de JST-kabel ongeveer 10 mm strippen. Als de draadeinden gesoldeerd zijn, is het beter om ze af te knippen op het punt van de draadisolatie voordat je gaat strippen. Dit maakt het strippen van de draden gemakkelijker.
Stap 2: Strip de draden van de DS18B20-sensoren
Strip ze 10 mm, of minstens even lang als je de JST-kabel hebt gestript.
Stap 3: Bind de draadeinden samen
Bind de draadeinden samen. Bind elke kleur apart. Dus alle gele draden samen, alle zwarte draden samen en alle rode draden samen. Als er te veel kabels zijn, kun je ook telkens 2 of 3 kabels doen.
Stap 4: Doe elke draadkleur in een aparte Wago klem
In deze stap kun je de meeste fouten maken, dus wees voorzichtig.
Je moet elke kabelbundel van zijn eigen kleur in een aparte Wago klem steken. Zet GEEN andere draadkleur in dezelfde klem, want dat veroorzaakt kortsluiting.
Stap 5: Steek de JST-stekker in de EMS Gateway
Steek de JST-stekker in de JST-connector in de gateway. Je moet het platte deel van de stekker aan de bovenkant houden. Zorg ervoor dat de stekker er helemaal in zit. Zie de afbeelding hieronder voor de juiste oriëntatie.
Je kunt het beste de Gateway uitzetten voordat je dit doet. Als de Gateway daarna niet opstart, heb je een kortere weg genomen in de bedrading.
Stap 6: Controleer de EMS-ESP webinterface en hernoem de sensoren
Als alles goed is gegaan, zie je de sensoren verschijnen op het tabblad Sensoren in de webinterface.
Elke DS18B20-sensor heeft zijn eigen unieke adresidentificatie. Deze identifiers worden weergegeven. Je kunt op een sensor klikken om hem te hernoemen. Nadat je een sensor hernoemd hebt, wordt hij ook hernoemd in MQTT en Home Assistant enz.
Als je een heleboel sensoren tegelijkertijd hebt toegevoegd, kan het moeilijk zijn om ze van elkaar te onderscheiden. Je kunt elke sensor afzonderlijk verwarmen met bijvoorbeeld een föhn of warmtepistool en kijken welke heter wordt.
Naarmate de tijd verstrijkt, neemt ook de omvang en features van de EMS-ESP firmware toe. We zijn inmiddels op een punt aangekomen waar EMS-ESP zou profiteren van wat meer RAM-geheugen.
Daarom introduceert BBQKees Electronics de nieuwe EMS Gateway S3 modellen. Eén met de standaard ingebouwde antenne en een identiek Gateway-model met een externe antenne met hogere gain voor lokaties met een lage WiFi-ontvangst. Dit is de vervanging voor de zeer populaire S32 Gateway.
Hardwarewijzigingen
De S3-modellen zien er identiek uit en voelen hetzelfde aan als de EMS Gateway S32 V2.0 die ze vervangen, maar ze worden nu geleverd met een ESP32-S3 module met 16MB Flash en een forse 8MB PSRAM (naast de on-chip 512KB RAM), wat ze geschikter maakt voor grote EMS-systemen met een warmtepomp of meerdere zones/verwarmingscircuits.
De nieuwe hardware maakt verder gebruik van het bestaande derde generatie BBQKees EMS-detectie- en verzendcircuit zoals in de S32 Gateway en de EMS-interfacekaart V3’s, die in de loop der jaren uiterst betrouwbaar en robuust is gebleken voor alle EMS-types van alle Bosch-merken.
Naast de krachtigere chip heeft dit model nu ook een externe USB-C connector voor handmatige firmware-updates (mocht dat ooit nodig zijn). De USB-C verbinding maakt gebruik van de interne USB OTG controller van de ES32-S3, zodat we de CH340 chip en driver niet meer nodig hebben.
Wat ongewijzigd is gebleven zijn de posities en pin-out van de externe connectoren, zodat de S3 een directe vervanging is voor S32 setups. Alleen de LED-lichtgeleider is een beetje veranderd.
De voedingsopties via de servicejack of 12 V gelijkstroomvoeding zijn ook hetzelfde gebleven.
Firmware
De S3-modellen worden geladen met firmware EMS-ESP32 v3.6. Dit is exact dezelfde firmware met exact dezelfde functies als voor de S32, alleen gebouwd voor de andere chiparchitectuur van de S3. De 3.6 firmware bevat een aantal nieuwe functies ten opzichte van 3.5.1, met name geheugenoptimalisaties.
Upgrade korting
Als je al een S32 Gateway hebt is het waarschijnlijk niet echt de moeite waard om te upgraden naar de nieuwe S3, maar als je dat wel wilt of als je nog een oude ESP8266 Gateway hebt zoals de Premium II kun je 15% korting krijgen op een nieuwe S3 Gateway naar keuze. Gebruik het contactformulier om contact met me op te nemen met je vorige bestelnummer en ik geef je een kortingscode.
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