Back to all devices

HOBEIAN ZG-204ZX in Home Assistant

Motion & presence · Zigbee · 24Ghz millimeter wave and T&H sensor

Zigbee2MQTT Quirk proposed, not merged yet 1 open report

Zigbee device – see the note above on what ZHA needs for it.

Brand: HOBEIAN
Model: ZG-204ZX
Device type: Motion & presence
Radio: Zigbee
Power: Battery
Reports itself as: ZG-204ZX, HS204ZX, _TZE200_w0ap83qu, _TZD200_5ziwcyoe
Also sold as: HYSYIOT HS204ZX
Zigbee2MQTT: Device page on zigbee2mqtt.io

How the device gets into Home Assistant

official ZHA – with a Zigbee coordinator and the ZHA integration; for all its functions it needs a custom quirk, see above. Integration
add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Integration · Source

Known problems and fixes

Requests for ZHA support

support requested A request to add support for the HOBEIAN ZG-204ZX device, enabling Home Assistant to recognize and use it. since May 16, 2026 · zha-device-handlers #5006

Changes proposed for ZHA

pull request The HOBEIAN ZG-204ZX 24GHz presence sensor is not supported, so ZHA cannot detect motion. Adding its quirk would enable presence detection for automation purposes. since September 11, 2026 · zha-device-handlers #5321

ZHA quirks for this device

Quirk proposed, not merged yet Recommended quirk

Proposed to ZHA and waiting for review – the maintainers check it before it becomes part of Home Assistant.

Adds: Motion sensitivity Minimum range Maximum range Target distance Distance tracking Presence sensitivity Fading time Self test result LED indicator Detection delay +37

Source: zha-device-handlers · pull request #5321 · by @alisander · September 11, 2026
Signature: _TZE200_w0ap83qu / ZG-204ZX

The quirk is not part of ZHA yet. You can use it as a custom quirk until it is:

Tell ZHA where custom quirks are kept – in configuration.yaml:
```
zha:
  custom_quirks_path: /config/custom_zha_quirks/
```
Create that folder and save the quirk as a .py file in it.
Restart Home Assistant. If the device was paired before, reconfigure it or remove and pair it again so the quirk is applied.
Check it worked: the device page shows the quirk under Zigbee info.

A custom quirk has not been reviewed by the ZHA maintainers. Delete the file once the quirk is part of a Home Assistant release – otherwise the old copy takes precedence.

All quirks in the ZHA quirk database →

Alternatives

The same job from other makers – devices of the same type and radio that work with Home Assistant too.

SONOFF SNZB-06P Motion & presence · Zigbee · Zigbee occupancy sensor Zigbee2MQTT ZHA quirk 4 open reports Review · from 17.90 €
Aqara RTCZCGQ11LM Motion & presence · Zigbee · Presence sensor FP1 Zigbee2MQTT ZHA quirk 1 open report Review
Philips 9290030675 Motion & presence · Zigbee · Hue motion sensor Zigbee2MQTT ZHA quirk 1 open report Review · from 40.16 €
EGLO 99106 Motion & presence · Zigbee · Connect-Z motion (PIR) sensor Zigbee2MQTT Review

Sources: Zigbee2MQTT, ZHA quirks, Z-Wave JS, the Matter certification database, Shelly, ESPHome, Tasmota, Tuya Local and the issue trackers on GitHub. Reports are assigned to a device by the identifiers they contain; the sentences come from the integration pages, where a language model writes them from the titles.