Geplaatst op

Grote firmware update nu beschikbaar: EMS-ESP 3.5.0

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.

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)

Volledige release notes zie: https://emsesp.github.io/docs/#/Release-notes

Hoe bijwerken naar 3.5.0

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.

Methode 1: Bijwerken via de webinterface

Download het 3.5.0 bin-bestand uit het archief. Open vervolgens de webinterface van de Gateway, ga naar Systeem->Upload en selecteer het zojuist gedownloade bin-bestand.
Zie: https://bbqkees-electronics.nl/wiki/gateway/firmware-update-and-downgrade.html#updating-firmware-via-the-web-interface

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).

Kijk hier voor de gedetailleerde updateprocedure: https://bbqkees-electronics.nl/wiki/gateway/firmware-update-and-downgrade.html#uploading-the-firmware-via-ems-esp-flasher-flashtool

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.


Een andere manier is de entiteit-ID’s in de HA-database te hernoemen met een script. Zie: https://github.com/emsesp/EMS-ESP32/issues/804

Mogelijke bugs

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