Back to all devices

Aqara ZNCLDJ12LM in Home Assistant

Covers & blinds · Zigbee · Curtain controller B1

Zigbee2MQTT Quirk proposed, not merged yet 1 open report

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

We have a detailed page on this device with compatibility ratings and prices. Details and compatibility

Brand: Aqara
Model: ZNCLDJ12LM
Device type: Covers & blinds
Radio: Zigbee
Power: Battery
Reports itself as: lumi.curtain.hagl04
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
official Aqara hub – paired with an Aqara hub that works as a Matter bridge (such as the M3 or M2), which shares supported devices with Home Assistant. 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 Aqara curtain motor (lumi.curtain.hagl04) cannot be controlled via Home Assistant as it lacks position tracking and commands do not work. Adding the correct quirk would enable proper control of the curtain motor. since October 23, 2026 · zha-device-handlers #5518

Changes proposed for ZHA

pull request The Aqara curtain motor (lumi.curtain.hagl04) is not recognized by ZHA. The proposed change would add support to control the curtain motor through Home Assistant. since October 23, 2026 · zha-device-handlers #5519

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: Speed Charging Calibrated

Source: zha-device-handlers · pull request #5519 · by @Aulos · October 23, 2026
Signature: LUMI / lumi.curtain.hagl04

1 more quirk for this device

Custom quirk shared in an issue LUMI / lumi.curtain.hagl04 zha-device-handlers · issue #5518 · by @Aulos · October 23, 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 →

Alternatives

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

Moes MS-108ZR Covers & blinds · Zigbee · Zigbee + RF curtain switch module Zigbee2MQTT 2 open reports Review
NodOn SIN-4-RS-20 Covers & blinds · Zigbee · Roller shutter relay switch Zigbee2MQTT ZHA quirk 1 open report Review
Legrand 067776 Covers & blinds · Zigbee · Netatmo wired shutter switch Zigbee2MQTT Review
LoraTap SC500ZB Covers & blinds · Zigbee · Smart curtain/shutter switch 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.