Back to all devices

AOYAN AY-302Z in Home Assistant

Climate sensors · Zigbee · Soil moisture sensor

Zigbee2MQTT Quirk proposed, not merged yet 2 open reports

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

Brand: AOYAN
Model: AY-302Z
Device type: Climate sensors
Radio: Zigbee
Power: Battery
Reports itself as: AOYAN
Same device as: COOLO CS-201Z
Also sold as: AOYAN AY-303Z
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年6月23日 · zha-device-handlers #4144
support requested Someone asked ZHA to support this device or one of its functions. since 2025年6月11日 · zha-device-handlers #4122

Changes proposed for ZHA

pull request A change to ZHA for this device has been proposed and is waiting for review. since 2026年1月30日 · zha-device-handlers #4706
pull request A change to ZHA for this device has been proposed and is waiting for review. since 2025年11月29日 · zha-device-handlers #4536
pull request A change to ZHA for this device has been proposed and is waiting for review. since 2025年7月2日 · zha-device-handlers #4160

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: Temperature report interval Humidity report interval Display unit Temperature alarm Alarm temperature max Alarm temperature min Temperature sensitivity Humidity alarm Alarm humidity max Alarm humidity min +8

Source: zha-device-handlers · pull request #4160 · by @makuser · 2025年7月2日 · 8 approvals
Signature: _TZE200_npj9bug3 / TS0601

8 more quirks for this device

Quirk proposed, not merged yet _TZE200_npj9bug3 / TS0601 zha-device-handlers · pull request #4941 · by @delneet · 2026年4月22日
Quirk proposed, not merged yet _TZE200_wrmhp6b3 / TS0601 zha-device-handlers · pull request #4941 · by @delneet · 2026年4月22日
Quirk proposed, not merged yet _TZE200_npj9bug3 / TS0601 zha-device-handlers · pull request #4706 · by @gcosta74 · 2026年1月30日
Quirk proposed, not merged yet _TZE200_npj9bug3 / TS0601 zha-device-handlers · pull request #4536 · by @nschimme · 2025年11月29日 · 4 approvals
Quirk proposed, not merged yet AOYAN / AY-303Z zha-device-handlers · pull request #4536 · by @nschimme · 2025年11月29日 · 4 approvals
Custom quirk shared in an issue _TZE200_npj9bug3 / TS0601 zha-device-handlers · issue #4122 · by @JustReit · 2025年11月7日 · 1 approval
Custom quirk shared in an issue _TZE200_npj9bug3 / TS0601 zha-device-handlers · issue #4122 · by @makuser · 2025年7月22日
Custom quirk shared in an issue _TZE200_npj9bug3 / TS0601 zha-device-handlers · issue #4122 · by @GWRon · 2025年6月18日 · 1 approval

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 →