Back to all devices

Aqara KD-R01D in Home Assistant

Wall switches · Zigbee · Dimmer switch H2 EU

Zigbee2MQTT Quirk included in ZHA 1 open report

This device is known to both Zigbee integrations: Zigbee2MQTT has a definition for it, and ZHA has a quirk that adapts it.

Facts about this device

Brand
Aqara
Model
KD-R01D
Device type
Wall switches
Radio
Zigbee
Power
Mains powered
Reports itself as
lumi.switch.agl011
Zigbee2MQTT
Device page on zigbee2mqtt.io

How the device gets into Home Assistant

  • official ZHA – with a Zigbee coordinator and the ZHA integration; the quirk the device needs is part of ZHA. 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 Dimmer Switch H2 EU (decoupled mode) is not supported in ZHA. This request aims to add support for using the dimmer in this specific mode. since May 27, 2026 · zha-device-handlers #5038

Changes proposed for ZHA

  • pull request The Aqara Dimmer Switch H2 EU lacks knob event handling and voltage accuracy. This change would improve dimming responsiveness and power measurement reliability. since September 16, 2026 · zha-device-handlers #5346
  • pull request The Aqara Dimmer Switch H2 EU would gain support for multi-click actions and button press events, allowing more detailed control through Home Assistant. since July 9, 2026 · zha-device-handlers #5162

ZHA quirks for this device

Quirk included in ZHA Recommended quirk

Part of ZHA – Home Assistant uses it on its own, nothing to install.

Adds: Flip indicator light LED indicator Maximum brightness Minimum brightness Mode switch Operation mode Phase Power on state Reporting interval Sensitivity

Source: zha-device-handlers · since zha-quirks 2.2.2
Signature: Aqara / lumi.switch.agl011

2 more quirks for this device

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.

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.

Scroll to Top