Back to all devices

AOYAN AY204T in Home Assistant

Motion & presence · Zigbee · Millimeter wave motion detection

Zigbee2MQTT Quirk proposed, not merged yet 2 open reports

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

Brand: AOYAN
Model: AY204T
Device type: Motion & presence
Radio: Zigbee
Power: Battery
Reports itself as: AOYAN
Same device as: HOBEIAN ZG-204ZV
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.
add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT. Source

Known problems and fixes

Requests for ZHA support

support requested Someone asked ZHA to support this device or one of its functions. since 2025年11月23日 · zha-device-handlers #4517
support requested Someone asked ZHA to support this device or one of its functions. since 2025年8月15日 · zha-device-handlers #4268

Changes proposed for ZHA

pull request A change to ZHA for this device has been proposed and is waiting for review. since 2025年11月1日 · zha-device-handlers #4457

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

Source: zha-device-handlers · pull request #4457 · by @zimme · 2025年11月1日 · 3 approvals
Signature: HOBEIAN / ZG-204ZV

27 more quirks for this device

Quirk proposed, not merged yet _TZE200_uli8wasj / TS0601 zha-device-handlers · pull request #4457 · by @zimme · 2025年11月1日 · 3 approvals
Quirk proposed, not merged yet _TZE200_grgol3xp / TS0601 zha-device-handlers · pull request #4457 · by @zimme · 2025年11月1日 · 3 approvals
Quirk proposed, not merged yet _TZE200_rhgsbacq / TS0601 zha-device-handlers · pull request #4457 · by @zimme · 2025年11月1日 · 3 approvals
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4517 · by @pansono · 2026年3月24日
Custom quirk shared in an issue _TZE200_uli8wasj / TS0601 zha-device-handlers · issue #4517 · by @pansono · 2026年3月24日
Custom quirk shared in an issue _TZE200_grgol3xp / TS0601 zha-device-handlers · issue #4517 · by @pansono · 2026年3月24日
Custom quirk shared in an issue _TZE200_rhgsbacq / TS0601 zha-device-handlers · issue #4517 · by @pansono · 2026年3月24日
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4268 · by @bobvanderlinden · 2026年1月18日 · 1 approval
Custom quirk shared in an issue _TZE200_uli8wasj / TS0601 zha-device-handlers · issue #4268 · by @bobvanderlinden · 2026年1月18日 · 1 approval
Custom quirk shared in an issue _TZE200_grgol3xp / TS0601 zha-device-handlers · issue #4268 · by @bobvanderlinden · 2026年1月18日 · 1 approval
Custom quirk shared in an issue _TZE200_rhgsbacq / TS0601 zha-device-handlers · issue #4268 · by @bobvanderlinden · 2026年1月18日 · 1 approval
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4268 · by @mawarnes · 2026年1月3日 · 3 approvals
Custom quirk shared in an issue _TZE200_uli8wasj / TS0601 zha-device-handlers · issue #4268 · by @mawarnes · 2026年1月3日 · 3 approvals
Custom quirk shared in an issue _TZE200_grgol3xp / TS0601 zha-device-handlers · issue #4268 · by @mawarnes · 2026年1月3日 · 3 approvals
Custom quirk shared in an issue _TZE200_rhgsbacq / TS0601 zha-device-handlers · issue #4268 · by @mawarnes · 2026年1月3日 · 3 approvals
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4268 · by @Dajitos · 2025年12月11日 · 4 approvals
Custom quirk shared in an issue _TZE200_uli8wasj / TS0601 zha-device-handlers · issue #4268 · by @Dajitos · 2025年12月11日 · 4 approvals
Custom quirk shared in an issue _TZE200_grgol3xp / TS0601 zha-device-handlers · issue #4268 · by @Dajitos · 2025年12月11日 · 4 approvals
Custom quirk shared in an issue _TZE200_rhgsbacq / TS0601 zha-device-handlers · issue #4268 · by @Dajitos · 2025年12月11日 · 4 approvals
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4268 · by @zimme · 2025年11月1日 · 1 approval
Custom quirk shared in an issue _TZE200_uli8wasj / TS0601 zha-device-handlers · issue #4268 · by @zimme · 2025年11月1日 · 1 approval
Custom quirk shared in an issue _TZE200_grgol3xp / TS0601 zha-device-handlers · issue #4268 · by @zimme · 2025年11月1日 · 1 approval
Custom quirk shared in an issue _TZE200_rhgsbacq / TS0601 zha-device-handlers · issue #4268 · by @zimme · 2025年11月1日 · 1 approval
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4268 · by @zimme · 2025年10月31日
Custom quirk shared in an issue _TZE200_uli8wasj / TS0601 zha-device-handlers · issue #4268 · by @zimme · 2025年10月31日
Custom quirk shared in an issue _TZE200_grgol3xp / TS0601 zha-device-handlers · issue #4268 · by @zimme · 2025年10月31日
Custom quirk shared in an issue HOBEIAN / ZG-204ZV zha-device-handlers · issue #4268 · by @thib5 · 2025年8月15日 · 3 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 →