# Zigbee2MQTT 2.12.0

- Product: Zigbee2MQTT (https://whatsnew.fyi/product/zigbee2mqtt)
- Vendor: Koen Kanters
- Date: 2026-06-09
- Version: 2.12.0
- Original notes: https://github.com/Koenkk/zigbee2mqtt/releases/tag/2.12.0
- Permalink: https://whatsnew.fyi/product/zigbee2mqtt/releases/2.12.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **fixed** — Fix MALFORMED_COMMAND error when updating Philips Hue devices
- **added** — Add ability to abort running OTA
- **changed** — Aqara FP1: expose configured regions
- **changed** — Plugwise 170-01: add OpenTherm controls, battery type, and product variant
- **changed** — Third Reality 3RVS01031Z: support more features
- **added** — Support for Frient install codes
- **changed** — Enable APS layer encryption for Zigbee Direct cluster operations
- **fixed** — Aqara FP300 (PS-S04D): configure reporting for presence and PIR
- **fixed** — EGLO 901463: mark as whitelabel of EBF_RGB_Zm
- **fixed** — IKEA VINDSTYRKA: allow reading VOC index
- **fixed** — IOTPerfect PF-PM02D-TYZ: expose fault
- **fixed** — Moes SYT-ZB01: fix rotation events
- **fixed** — Moes ZS-SR-EUC: fix incorrect position
- **fixed** — Moes ZWV-YC: fix device not controllable
- **fixed** — Schneider Electric WDE002386: fix configure failing
- **fixed** — Sonoff SNZB-04PR2: fix battery voltage reporting
- **fixed** — Use coord address when gppNwkAddr not present in GP frame for tempMaster
- **fixed** — Ember: skip backup devices without a link key in FORM_BACKUP
- **fixed** — Zoh: only close port (if needed) on init port failure
- **fixed** — DefaultRsp matching for OTA

#### Notes
- This hotfix release fixes the `MALFORMED_COMMAND` error when updating Philips Hue devices (https://github.com/Koenkk/zigbee2mqtt/issues/32168)

#### Features
- [#32022](https://github.com/Koenkk/zigbee2mqtt/issues/32022) Add ability to abort running OTA (@Nerivec)

#### Improvements
- [#12378](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12378) Aqara FP1: expose configured regions (@mayongze)
- [#12404](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12404) Plugwise 170-01: OpenTherm controls, battery type, product variant (@SaiPraveen22)
- [#12400](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12400) Third Reality 3RVS01031Z: support more features (@3reality-support)
- [#1778](https://github.com/Koenkk/zigbee-herdsman/issues/1778) Support for Frient install codes (@burmistrzak)
- [#1759](https://github.com/Koenkk/zigbee-herdsman/issues/1759) Add ability to abort running OTA (@Nerivec)
- [#1762](https://github.com/Koenkk/zigbee-herdsman/issues/1762) Enable APS layer encryption for Zigbee Direct cluster operations (@burmistrzak)

#### Fixes
- [#12383](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12383) Aqara FP300 (PS-S04D): configure reporting for presence and PIR (@drauziooppenheimer)
- [#12391](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12391) EGLO 901463: mark as whitelabel of EBF_RGB_Zm (@panther7)
- [#12392](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12392) IKEA VINDSTYRKA: Allow reading VOC index (@andrei-lazarov)
- [#12397](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12397) IOTPerfect PF-PM02D-TYZ: expose fault (@andrei-lazarov)
- [#12402](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12402) Moes SYT-ZB01: fix rotation events (@andrei-lazarov)
- [#12379](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12379) Moes ZS-SR-EUC: fix incorrect position (@javivarguitas)
- [#12396](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12396) Moes ZWV-YC: fix device not controllable (@FranzFelberer)
- [#12381](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12381) Move various device specific converters from fromZigbee.ts and toZigbee.ts (@svhelge)
- [#12398](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12398) Schneider Electric WDE002386: fix configure failing (@svhelge)
- [#12377](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12377) Sonoff SNZB-04PR2: fix battery voltage reporting (@N3rdix)
- [#12387](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12387) Tuya TS0601_vibration_alarm_sensor: improve UX and clean code (@andrei-lazarov)
- [#12395](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12395) Use coord address when `gppNwkAddr` not present in GP frame for `tempMaster` (@Nerivec)
- [#12368](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12368) Add Tuya _TZE2841000000_0ints6wl and _TZE2841000000_hdml1aav (@iotRobot)
- [#12367](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12367) Develco SPLZB-132: set powerOnBehaviour to false (@svhelge)
- [#12346](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12346) GIEX GX06: add soil sensor brightness level (@Giexperience)
- [#12372](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12372) Move various device specific converters from fromZigbee.ts and toZigbee.ts (@svhelge)
- [#12365](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12365) Efekta: correction of measurement units (@smartboxchannel)
- [#12362](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12362) Heiman HS1RM-EF: add private cluster (@Leo2442926161)
- [#12360](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12360) Move various device specific converters from fromZigbee.ts and toZigbee.ts (@svhelge)
- [#12363](https://github.com/Koenkk/zigbee-herdsman-converters/issues/12363) Third Reality: r

_[Truncated at 4000 characters — full notes: https://github.com/Koenkk/zigbee2mqtt/releases/tag/2.12.0]_