Software-update: Zigbee2MQTT 2.5.1

Versie 2.5.0 van Zigbee2MQTT is uitgekomen en er is ook alweer een opvolger met enkele kleine verbeteringen verschenen. Zigbee2MQTT maakt het mogelijk om Zigbee-apparaten aan te sturen zonder gebruik te hoeven maken van de gateway of bridge van de fabrikant. Dit doet het door van MQTT gebruik te maken, waardoor het eenvoudig te integreren is in smarthomesoftware, zoals bijvoorbeeld Home Assistant, Homey of Domoticz. De changelog voor deze uitgave kan hieronder worden gevonden.

Zigbee2MQTT 2.5.1

Fixed

• #27880 Various Windfront frontend improvements
• #26560 Home Assistant: fix brightness only lights

Zigbee2MQTT 2.5.0

Notes

• Based on the feedback in #27564 a lot of improvements have been done to new Windfront frontend. The improved version also adds support for the new health feature
• The deCONZ driver has been completely refactored. It now supports backups and channel changing

Features

• #27164 New health extension & extras in bridge/info

Improvements

• #9568 Sunricher SR-ZG9001K8-DIM: support multi endpoint commands for on/off and level control
• #9564 Saswell SEA801-Zigbee/SEA802-Zigbee: expose anti_scaling
• #9554 Sunricher SR-ZG9032A-MW: support more features
• #9546 Ubisys b0: support cooling
• #9536 Tuya TS0601_cover_6: support illuminance
• #9532 Third Reality 3RSM0147Z: expose soil moisture
• #787 Aqara ZNJLBL01LM: support OTA
• #9407 AwoX 33952: support more actions
• #9489 Bed.box: support more features
• #9455 Add neutral current support
• #9460 Aqara KD-R01D: add hold, double and release actions
• #9463 Aqara KD-R01D: support multi-click
• #9465 Aqara ZNXDD01LM: support on_level
• #9450 Tuya M8Pro: support more features
• #9445 Innr RF 271 T and RF 273 T: enable OTA
• #1434 Support discovery for SONOFF Dongle Plus MG21 and MG24
• #1417 Refactor and improve of Deconz adapter
• #1428 Support for EmberZNet 8.2.0 (EZSP v17 / v2025.6.0)

Fixes

• #27690 Bump Alpine to 3.22
• #27691 Fix devices not immediately marked as offline when timeout expires
• #27702 Generate group ID if empty string given
• #27642 Rename fix typo in backoff settings
• #9560 Improvements for LoraTap SC500ZBv2 and for Nous B4Z (with common reusability)
• #9558 Inovelli VZM32-SN: remove extra mmwave Control Command
• #9537 Adjust the reporting frequency threshold of some Bituo devices
• #9534 Amina S: fix charge limit reading
• #9523 Aqara JY-GZ-01AQ: improve battery % calculation
• #27080 SONOFF TRVZB: fix Exception while calling fromZigbee converter: Expected one of: 0, 1, got: '2'}
• #9519 Efekta high_co2_gas: fix INVALID_DATA_TYPE
• #27758 EWeLink CK-BL702-AL-01_1: fix integration
• #9501 Fix detection of SR-ZG9101SAC-HP-SWITCH-2CH
• #27724 Third Reality 3RSB22BZ: fix power source
• #64 Convert color x/y string to number
• #9482 Candeo C-ZB-SEMO: improve illuminance reading
• #9472 Tuya TS0726: fix scene actions
• #9462 Aqara S04D: fix threshold scale
• #27615 Aqara SRTS-A01: fix Value: '2' not found in: [0, 1]
• #9461 EFEKTA_eTb02z: fix invert type
• #9458 Neo NAS-PS10B2: fix lux_value and motion_sensitivity
• #23946 Tuya BLE-YL01: improve reporting stability
• #9452 Third Reality: update 3R plug gen3/e3/UZ1 and add private cluster
• #27140 SmartThings IM6001-MPP01: fix configure failing
• #1432 DeCONZ: handle race condition between APS confirm/indication timeouts
• #1422 Fix interview failing for HOBEIAN devices
• #1380 Enable serial port locking by default for ZiGate

Frontend

• 9c2ee5e add missing button label (#2505)
• bf56810 various fixes (#2503)
• bea922e when OTA file version is negative number return N/A (#2499)

New supported devices

This release adds support for 44 devices:

• #9565 C-ZB-SR5BR Candeo Zigbee scene switch remote - 5 button rotary
• #9552 L14 Nous Smart water valve
• #9563 ZBM5-1C-80/86 SONOFF Zigbee Smart one-channel wall switch (type 80/86).
• #9563 ZBM5-2C-80/86 SONOFF Zigbee Smart two-channel wall switch (type 80/86).
• #9563 ZBM5-3C-80/86 SONOFF Zigbee Smart three-channel wall switch (type 80/86).
• #9551 R3 Smart Switch Tuya Circuit Breaker/Switch
• #9555 ZG-807Z HOBEIAN USB signal repeater
• #9555 ZG-101ZS HOBEIAN Star Ring 4 Gang Scene Switch
• #9555 ZG-305Z HOBEIAN undefined
• #9548 _TZE284_debczeci iHseno Human presence sensor
• #9553 A7Z Nous Smart ZigBee Socket
• #9556 E9 Nous Zigbee gas sensor
• #9557 TS0201-z-SlD Slacky-DIY Tuya temperature and humidity sensor with custom Firmware
• #9557 ZG-222ZA-z-SlD Slacky-DIY Tuya water leak sensor with custom firmware
• #27677 ZC-LS02 Moes Roller blind motor
• #9540 SR-ZG2819S-DIM Sunricher ZigBee dim remote
• #9525 SZLMR10 Lincukoo Human Motion & Presence Sensor
• #9525 CZF02 Lincukoo Finger Robot
• #9525 SZT06 Lincukoo Smart mini temperature and humidity sensor
• #9528 MB60L-ZG-ZT-TY Manhot Smart blinds motor
• #9524 RB-ElectricityDsp-061-3 Silicon Labs Electricity meter
• #9521 HS2FD-EF1-3.0 HEIMAN Fall Detection Sensor
• #9515 VZM32-SN Inovelli mmWave Zigbee Dimmer
• #9516 C-ZB-DM201-2G Candeo Zigbee 2 gang dimmer module
• #9502 ECB62-ZB ENGO Control box for underfloor heating system
• #9506 TS0601_knob_dimmer_switch Tuya Dimmer knob with two lights
• #9488 FDS315 OWON Fall Detection Sensor
• #9510 HSSA18-Z-MID iLightsIn Zhaga module
• #9491 MG-GPO01 MakeGood Double Zigbee power point
• #9507 SR-ZG2836D5-G4 Sunricher Zigbee smart remote
• #9499 SZ-ESW02N-CZ3 Sercomm Telstra smart plug
• #9503 ZBSM20WT Nedis Nedis motion sensor
• #9508 ZG-102ZA HOBEIAN undefined
• #9480 SNT858Z Soanalarm Soil moisture sensor
• #9471 9028412A SOMFY Glydea Curtain motor Zigbee module
• #9484 CoZB_dha Eurotronic Comet Zero Zigbee Zigbee wireless heater thermostat
• #9473 SR-ZG9032A-MW Sunricher Zigbee compatible fixture with integrated occupancy sensor
• #9473 SR-ZG9098A-Win Sunricher Zigbee curtain control module
• #9473 SR-ZG9098A-Light Sunricher Zigbee 2ch smart relay
• #9466 HY368 Moes undefined
• #9456 JR-ZPM01 Girier Smart Plug
• #9453 SM-PW801EZ Coswall 2 gang switch with USB
• #9457 ZWOT12 AVATTO 2 gang 2 usb wall outlet 4x2
• #9444 ZSS-S01-GWM-C-MS Moes Door/window alarm sensor

Fixed device detections

• #9566 Detect _TZ3000_5af5r192 as Moes ZWV-YC
• #26009 Detect _TZB210_ue01a0s2 as MiBoxer FUT035Z+
• #9549 Detect _TZ3002_phu8ygaw as Tuya TS0726_multi_4_gang
• #9550 Detect _TZE284_awepdiwi as Tuya TS0601_soil_2
• #9542 Detect _TZE200_u6x1zyv2 as HOBEIAN ZG-223Z
• #9527 Detect NimlyPRO24 as Nimly
• #27715 Detect _TZ3000_g8n1n7lg as Tuya ZG-001
• #27716 Detect _TZE204_mexisfik as Tuya MG-ZG04W
• #9498 Detect 3P power consumption module as Legrand 412175
• #9481 Detect _TZ3210_dwzfzfjc as Moes ZB-LZD10-RCW
• #9483 Detect _TZE608_xkr8gep3 as Tuya TS0603
• #27643 Detect _TZE284_libht6ua as Tuya TS0601_cover_6
• #9459 Detect _TZ1800_akzvkzqq as Lidl HG06668
• #9469 Detect _TZE284_utkemkbs as Tuya SZTH02
• #9448 Detect _TZ3000_bguser20 as Tuya WSD500A
• #27305 Detect _TZE284_wwaeqnrf as Zemismart ZMS-206US-4
• #27286 Detect _TZE204_3ctwoaip as Zemismart ZMS-206EU-2

Versienummer	2.5.1
Releasestatus	Final
Website	Zigbee2MQTT
Download	https://github.com/Koenkk/zigbee2mqtt/releases/tag/2.5.1
Licentietype	GPL

Reacties (34)

[Koenkk]

Bedankt voor de positieve berichten! 😁

[wildekek]

Koenkk, held!

[Airw0lf]

Mij ontgaat het praktisch nut even (met een Homey Pro in gedachten):

Als ik het goed begrijp brengt dit stukje software de status updates van Zigbee apparaatjes naar Homey in de vorm van MQTT berichten. Maar dan gaat er aan de kant van Homey nog steeds iets gemaakt moeten worden om die berichten om te zetten in acties? Of hoe gaat zoiets in zijn werk?

En stel een van die Zigbee apparaatjes is een camera, hoe zou die audio en beeld info verpakt kunnen zijn in MQTT berichten? Wordt dat dan geen enorm volume aan berichten?

[Jewest]

Het zal wel geen streaming video zijn, maar home automation heeft een MQTT Camera intergratie.
https://www.home-assistant.io/integrations/camera.mqtt/

[Indy81]

Zigbee heeft een bandbreedte van 20 tot 40kb/s. Het is bedoeld voor tekstberichten, niet meer.

Zodoende bestaan er ook geen Zigbee camera's, en hoeft dit dus ook niet over MQTT te gaan.

[Geim]

Mij ontgaat het praktisch nut even (met een Homey Pro in gedachten):

Als ik het goed begrijp brengt dit stukje software de status updates van Zigbee apparaatjes naar Homey in de vorm van MQTT berichten. Maar dan gaat er aan de kant van Homey nog steeds iets gemaakt moeten worden om die berichten om te zetten in acties? Of hoe gaat zoiets in zijn werk?

Daar heb je, zoals met alles in Homey, een app voor nodig: https://homey.app/nl-nl/app/com.gruijter.zigbee2mqtt/Zigbee2MQTT/

Ik gebruik het nu een half jaar in Homey en het grote voordeel is dat ik in Homey minder apps nodig heb. Geen aparte app voor Ikea, Tuya, Sonoff etc. Nadeel is dat je extra hardware nodig hebt, Z2M en mqtt ergems moet draaien. En Z2M updaten moet je handmatig doen.

[Airw0lf]

Ah - ok dus ergens is er een MQTT-broker. Met daarnaast deze Zigbee2MQTT. Dat zouden ergens twee Docker containers kunnen zijn.

In Homey draait dan een MQTT client die deze berichten oppakt. Dat zou de Zigbee2mqtt (client?) kunnen zijn. Maar ook deze?

In Homey Pro zit een Zigbee module. Ik heb eventueel ook nog een losse Zigbee bridge liggen. Beiden beschikken over een bekabelde ethernet verbinding. Zou ik die dan kunnen aanspreken als remote adapter? Heeft iemand daar een voorbeeld van?

[Reactie gewijzigd door Airw0lf op 2 juli 2025 10:48]

[NLkaiser]

De homey MQTT Client support geen specifieke devices dus je kan eigenlijk alleen payloads verzenden/ontvangen.

Ik zou de z2m homey app gebruiken, maar het nadeel van deze client is dat er voor ieder device specifiek support moet worden gebouwd of specifieke icons of capabilities toegevoegd worden voorbeeld. Ik heb zelf al genoeg pr's hiervoor ingediend, ik heb bv de group support voor de z2m homey app gebouwd

[Reactie gewijzigd door NLkaiser op 2 juli 2025 11:43]

[Geim]

Ah - ok dus ergens is er een MQTT-broker. Met daarnaast deze Zigbee2MQTT. Dat zouden ergens twee Docker containers kunnen zijn.

Klopt, zo heb ik het ook geconfigureerd

In Homey draait dan een MQTT client die deze berichten oppakt. Dat zou de Zigbee2mqtt (client?) kunnen zijn. Maar ook deze?

Dat doet de Zigbee2MQTT app zelf, op het moment dat je een bridge aanmaakt in Homey

https://community.homey.app/t/app-pro-zigbee2mqtt/83214 --> How to setup punt 3.

In Homey Pro zit een Zigbee module. Ik heb eventueel ook nog een losse Zigbee bridge liggen. Beiden beschikken over een bekabelde ethernet verbinding. Zou ik die dan kunnen aanspreken als remote adapter? Heeft iemand daar een voorbeeld van?

Kan ik je niet mee helpen, ik heb meteen de SLZB-06 aangeschaft (met POE)

[NLkaiser]

ik ben toevallig vorige week afgestapt van homey+z2m naar alleen homey, het grote voordeel nu is dat ik gewoon kan pielen in mijn homelab/docker zonder dat mijn vrouw gaat klagen dat de lampen niet meer aan gaan. Daarnaast werkt homey local zolder internet dus bv gisteren toen ik mijn switch eruit trok om deze te upgraden bleven de lampen gewoon werken. Ik moet wel toegeven dat de zigbee stack op homey een stuk instabieler is

[yorroy]

Wellicht niet helemaal de goede plek voor deze vraag; maar wat is op dit moment dé Zigbee stick om mee te starten voor HA?

Wil toch eens kijken of ik mijn Tradfri en Hue hub kan vervangen

[C-dude]

Gebruikte vroeger een Conbee 2, maar recent overgeschakeld naar een SLZB-06
Voor mij was het voordeel dat deze met Poe aangesloten kan worden en dus op een betere locatie geplaatst kan worden.

Krijgt ook genoeg en tijdig updates.

[Geim]

Hier ook de SLZB-06, met POE. prikken en klaar

[mgiebels]

Wat was jullie ervaring met de SLZB-06 toen je overstapte moest je alles opnieuw connecten?

Of was het instellen op zelfde kanaal en verder gaan.

moet anders 75 apparaten opnieuw connecten maar tot op heden werkt de conbee2 perfect eigenlijk en sinds deze update weer betere ondersteuning.

[Reactie gewijzigd door mgiebels op 2 juli 2025 14:53]

[cmegens]

Hier was het instellen, alle apparaten van de stroom af, pairing aan zetten, stroom aan, en binnen 10 minuten was alles gepaired. Inclusief correcte namen en IDs

[Reactie gewijzigd door cmegens op 2 juli 2025 14:55]

[C-dude]

Had nog niet zoveel apparaten (max 20 ofzo), ineens opnieuw begonnen.

[BushWhacker]

@Koenkk is een held.

Echt fantastisch hoe het werkt. Je installeert het en hoeft er eigenlijk nooit naar om te kijken. Het werkt gewoon altijd.

Ik gebruik het al heel veel jaren, eerst op de CC2531 en sinds een paar jaar op de Zig-a-zag-ah (de naam is weg op de site).

Ook Zigbee2mqtt. NPM is een gedrocht, maar sinds Docker geen enkel probleem meer.

En ja, ik heb gedoneerd en zal het binnenkort weer doen.

[meowmofo]

Ik heb hem zonder docker gewoon native draaien, werkt ook als zonnetje. Bij een update gewoon even ./update.sh uitvoeren, en klaar is Kees.

[kiang]

Qua performance is docker gewoon native, fyi

[Punkbuster]

Precies dit, @Koenkk is een superheld zonder cape 👍

[Sa1]

Ik heb een aantal projecten waar ik per maand 1 of 2 dollar aan doneer. Frigate is daar een van, maar ook Z2M. Wordt dagelijks gebruikt in mijn huishouden, als het er uit ligt is het echt heel vervelend, dus heb der inderdaad best wel 'iets' voor over. Als nu iedereen dat zou doen, denk dat de ontwikkelaar daar geen nee op zeggen ;-)

[iAR]

[quote]Je installeert het en hoeft er eigenlijk nooit naar om te kijken.[/quote]

Als de installatie lukt. Ik ben er een hele dag mee bezig geweest maar krijg het mijn SkyConnect niet aan het werk. Ik zit nu al diep in ZHA en durf nu eigenlijk niet meer te proberen.

[edwin2021]

Nog niet echt gezocht, maar wat is de weg om de Docker te updaten?

[Thomg]

Kijk ook naar iets als watchtower

[mbosma]

Watchtower is inderdaad geweldig, keek vanochtend op z2m en draaide al op 2.5.0.
Tip voor Tweakers die geïnteresseerd zijn in automatisch updaten middels watchtower, stel hem in op een geschikt tijdstip dmv cron in plaats van elk half uur om te voorkomen dat je overdag ineens je z2m kwijt bent .

Update naar 2.5.0 ging vlekkeloos, props naar Koen voor het goede werk!

[Technoid]

Durf jij dat? Wauw.

Je hebt grote kans dat je wakker wordt en ineens dingen zijn omgevallen waar je geen weet van hebt.

Voor niet essentiële dingen, prima.

[Sa1]

docker compose pull

docker compose up -d

[kiang]

Container weggooien en opnieuw aanmaken en starten met docker run.

Als je dat eng vindt kan je je huidige container gewoon stoppen, een nieuwe maken en kijken of alles werkt, en daarna je oude container verwijderen.

Je state hoort in je volumes te zitten, dus je kan niet echt iets kwijtraken als je alles goed hebt draaien.

[Reactie gewijzigd door kiang op 1 juli 2025 23:13]

[smesjz]

DeConz conbee 2 adapter was in april nog veranderd naar unmaintained met opmerking dat je beter andere adapter kan kopen. En dat bepaalde fw voor instabiliteit zorgde.

Dit is nu (weer) veranderd maar niet benoemd in de release notes.

Zie https://github.com/Koenkk/zigbee2mqtt.io/commit/cd3ad3884b98e0bf269e083e9df6c5f126e6ae63

[_Richie_]

Daar ben ik het nog steeds mee eens, dat je beter een andere kunt kopen…

[Patrick_Wolf]

Bij mij liep alles in de soep, dus heb een ander gehaald en het loopt nu weer prima. Wel alles opnieuw instellen

[mgiebels]

Hier ook nog steeds alles met de Conbee 2 adapter ondertussen 75 devices erop en werkt fijnloos.

De opmerking dat je beter was anders kon kopen hebben ze nooit zo genoemd want ze zeiden al op Github dat ze bezig waren met verbeteringen.

[Reactie gewijzigd door mgiebels op 2 juli 2025 14:50]

[smesjz]

Hier ook nog steeds alles met de Conbee 2 adapter ondertussen 75 devices erop en werkt fijnloos.

De opmerking dat je beter was anders kon kopen hebben ze nooit zo genoemd want ze zeiden al op Github dat ze bezig waren met verbeteringen.

Er stond letterlijk: “The implementation of this adapter is not maintained anymore.

Consider buying one of the recommended adapters instead.”

zie die commit. Nergens in de officiële documentatie stond dat ze bezig waren met verbeteringen.

[MadEgg]

Ik heb Home Assistant draaien met een SkyConnect Zigbee USB-adapter, daarmee kan ik IKEA Tradfri en Philips Hue lampen bedienen. Wat voegt in een dergelijke setup Zigbee2MQTT dan toe? Ik moet alles re-pairen en verder doet het grofweg hetzelfde? Wat is het voordeel om MQTT er tussen te zetten?