Back to all devices

AOYAN AY-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: AOYAN
Model: AY-204ZX
Device type: Motion & presence
Radio: Zigbee
Power: Battery
Reports itself as: AOYAN
Same device as: HOBEIAN ZG-204ZK
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 The HOBEIAN ZG-204ZK device is not supported, making it impossible to use with Home Assistant via Zigbee. since March 19, 2026 · zha-device-handlers #4837

Changes proposed for ZHA

pull request The HOBEIAN presence sensor is not recognized properly. Adding support would allow Home Assistant to detect motion accurately. since June 25, 2026 · zha-device-handlers #5123

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 +38

Source: zha-device-handlers · pull request #5123 · by @gilsonmandalogo · June 25, 2026 · 1 approval
Signature: _TZE200_ka8l86iu / TS0601

3 more quirks for this device

Quirk proposed, not merged yet _TZE200_zbfmvj13 / TS0601 zha-device-handlers · pull request #5123 · by @gilsonmandalogo · June 25, 2026 · 1 approval
Quirk proposed, not merged yet HOBEIAN / ZG-204ZK zha-device-handlers · pull request #5123 · by @gilsonmandalogo · June 25, 2026 · 1 approval
Custom quirk shared in an issue HOBEIAN / ZG-204ZK zha-device-handlers · issue #4837 · by @Classical-Gas · March 19, 2026 · 7 approvals

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 20.45 €
Aqara RTCZCGQ11LM Motion & presence · Zigbee · Presence sensor FP1 Zigbee2MQTT ZHA quirk 1 open report Review
HOBEIAN ZG-204ZL Motion & presence · Zigbee · Luminance motion sensor 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 €

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.