Back to all devices

HOBEIAN ZG-302ZL in Home Assistant

Motion & presence · Zigbee · Motion sensing switch

Zigbee2MQTT Quirk proposed, not merged yet

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

Brand: HOBEIAN
Model: ZG-302ZL
Device type: Motion & presence
Radio: Zigbee
Power: Mains powered
Reports itself as: ZG-302ZL, _TZE200_khzbklyh, _TZE200_df04ghrb, _TZE200_toeldckg, _TZE200_cqtamhh5, _TZE200_xlnzk169, _TZE200_llvwkkde
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

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: Presence Sensitivity Trigger Hold Power-on Behaviour Backlight Auto On Auto Off

Source: zha-device-handlers · pull request #5293 · by @3jam3 · September 1, 2026
Signature: _TZE200_llvwkkde / TS0601

1 more quirk for this device

Quirk proposed, not merged yet _TZE200_llvwkkde / TS0601 zha-device-handlers · pull request #4628 · by @3jam3 · January 7, 2026

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 →

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.

Facts about this device

How the device gets into Home Assistant

ZHA quirks for this device