Aqara KD-R01D in Home Assistant
Wall switches · Zigbee · Dimmer switch H2 EU
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.
- 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.
- add-on Zigbee2MQTT – Zigbee2MQTT runs as an add-on and passes the device on to Home Assistant over MQTT.
Known problems and fixes
Requests for ZHA support
- support requested Someone asked ZHA to support this device or one of its functions.
Changes proposed for ZHA
- pull request A change to ZHA for this device has been proposed and is waiting for review.
- pull request A change to ZHA for this device has been proposed and is waiting for review.
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
-
Quirk proposed, not merged yet
Aqara/lumi.switch.agl011zha-device-handlers · pull request #5346 · by @exi · September 16, 2026 -
Quirk proposed, not merged yet
Aqara/lumi.switch.agl011zha-device-handlers · pull request #5162 · by @DidntRead · July 9, 2026
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.
