Support for Aqara Shutter Switch H2 EU Model: DS-K02E

[smonsi]

Hello,
I've bought a Aqara Shutter Switch H2 EU Model : DS-K02E which isn't supported yet.
I've generated this external definition.

import * as m from 'zigbee-herdsman-converters/lib/modernExtend';

export default {
    zigbeeModel: ['lumi.switch.aeu003'],
    model: 'lumi.switch.aeu003',
    vendor: 'Aqara',
    description: 'Automatically generated definition',
    extend: [m.deviceEndpoints({"endpoints":{"1":1,"2":2,"3":3,"4":4,"21":21}}), m.windowCovering({"controls":["lift","tilt"]}), m.electricityMeter()],
    meta: {"multiEndpoint":true},
};

Thank you and tell me if Info is needed
Horst

[Koenkk]

Could you make a PR by clicking here?

[smonsi]

Sorry, I don’t really know enough about that.

[Koenkk]

Do all features work either way this code?

[smonsi]

No, unfortunately not. I can raise, lower, and stop the shutters, but the status just shows up as ‘unknown’ on the dashboard. The two extra buttons don’t get recognized either.

[smonsi]

[alexhk]

I bought this Aqara Shutter Switch (DS-K02E) for a trial, without realizing it's not supported yet.

This got me curious how support for new devices is added in zigbee2mqtt.

Do people who add new devices usually sniff traffic between the official hubs and the device ("reverse engineer") and then just integrate function for function in zigbee2mqtt? Or is there another way?

Sorry if this is slightly off topic, feel free to ignore.

[neo170]

I created an external converter file which works for me with following code:

import * as m from 'zigbee-herdsman-converters/lib/modernExtend';
import * as exposes from 'zigbee-herdsman-converters/lib/exposes';
const ea = exposes.access;


const customLiftFromEndpoint21 = {
    cluster: 'closuresWindowCovering',
    type: ['attributeReport', 'readResponse'],
    endpoint: 21,
    convert: (model, msg, publish, options, meta) => {
        const result = {};
        if (msg.data && msg.data.hasOwnProperty('currentPositionLiftPercentage')) {
            const raw = msg.data['currentPositionLiftPercentage'];
            result.position = raw;
            result.state = raw === 0 ? 'CLOSE' : 'OPEN';
        }
        return result;
    },
};

const fromMultistateInput = {
    cluster: 'genMultistateInput',
    type: ['attributeReport'],
    convert: (model, msg, publish, options, meta) => {
        const endpoint = msg.endpoint.ID;
        const value = msg.data.presentValue;
        const buttonMap = {
            3: 'button_3',
            4: 'button_4',
        };
        if (buttonMap[endpoint] !== undefined && value === 1) {
            return { action: `${buttonMap[endpoint]}_single` };
        }
        return null;
    },
};

export default {
    zigbeeModel: ['lumi.switch.aeu003'],
    model: 'lumi.switch.aeu003',
    vendor: 'Aqara',
    description: 'Aqara H2 EU Shutter Switch',
    fromZigbee: [customLiftFromEndpoint21,
                 fromMultistateInput],
    extend: [
        m.deviceEndpoints({endpoints: {'1': 1, '2': 2, '3': 3, '4': 4, '21': 21}}),
        m.windowCovering({controls: ['lift']}),
    ],
    exposes: [
	exposes.enum('action', ea.STATE, [
	    'button_3_single',
	    'button_4_single' ]).withDescription('Single press actions from right buttons'),

    ],
    meta: {multiEndpoint: true},
};

Put this code in a file with the name lumi_switch_aeu003.js under /config/zigbee2mqtt/external_converters
(Create the folder external_converters if it does not exist).
Restart zigbee2mqtt. Afterwards set in zigbee2mqtt settings of the device "Invert Cover" to true.

This code is patching the position field of the Shutter, because it's not proper submitted with the default solution.
The code is created with AI and maybe this is not the absolut proper way to do it. But it works for me.

[Tragl1968]

I will stop my efforts for the moment due to some confusions.

In zigbee2mqtt version 1.40.1:

1. In configuration.yaml the external converter file must be listed explicit:

external_converters:
  - lumi_switch_aeu003.js

--> so I did it but...

2. it seems that the default path for the extensions is "/opt/zigbee2mqtt/data/", because of following log entry

[2025-11-23 16:44:48] info: 	z2m: Logging to console, file (filename: log.log)
[2025-11-23 16:44:48] error: 	z2m: Failed to load external converter file 'lumi_switch_aeu003.js' (ENOENT: no such file or directory, open '/opt/zigbee2mqtt/data/lumi_switch_aeu003.js')

--> so I did it but...

3. the code seems not compatible with version 1.40.1, because of following log entry
   [2025-11-23 16:50:57] error: z2m: Failed to load external converter file 'lumi_switch_aeu003.js' (Cannot use import statement outside a module)
   [2025-11-23 16:50:57] error: z2m: Probably there is a syntax error in the file or the external converter is not compatible with the current Zigbee2MQTT version
   --> so I give up ... but it was a nice learning day

Did I something wrong with the code?

• open plain text file (notepad++)
• copy the code into it (no additional characters, no Brackets, etc.)
• save it with filename lumi_switch_aeu003.js

[Tragl1968]

In configuration.yaml the external converter file must be listed explicit:

Thank you, we were active both on it at the same time :-)

[neo170]

make sure the file is in linux format with line endings LF and not in Windows format with CR+LF

[Tragl1968]

Finally I ...
...had to change "import" in "require" like:

const m = require('zigbee-herdsman-converters/lib/modernExtend');
const exposes = require('zigbee-herdsman-converters/lib/exposes');

... had to adapt the export function from:

export default {
    // definition
};

to:

const definition = {
    // definition
};
module.exports = definition;

The external converter file "lumi_switch_aeu003.js" for zigbee2mqtt version 1.40.1 is:

const m = require('zigbee-herdsman-converters/lib/modernExtend');
const exposes = require('zigbee-herdsman-converters/lib/exposes');

const ea = exposes.access;

const fromMultistateInput = {
    cluster: 'genMultistateInput',
    type: ['attributeReport'],
    convert: (model, msg, publish, options, meta) => {
        const endpoint = msg.endpoint.ID;
        const value = msg.data.presentValue;
        const buttonMap = {
            3: 'button_top_right',
            4: 'button_bottom_right',
        };
        if (buttonMap[endpoint] !== undefined && value === 1) {
            return { action: `${buttonMap[endpoint]}_single` };
        }
        return null;
    },
};

const definition = {
    zigbeeModel: ['lumi.switch.aeu003'],
    model: 'DS-K02D/DS-K02E',
    vendor: 'Aqara',
    description: 'Aqara H2 EU Shutter Switch',
    fromZigbee: [
                 fromMultistateInput],
    extend: [
        m.windowCovering({controls: ['lift']}),
    ],
    exposes: [
	exposes.enum('action', ea.STATE, [
	    'button_top_right_single',
	    'button_bottom_right_single' ]).withDescription('Single press actions from right buttons'),

    ],
    meta: {coverInverted: true},
};
module.exports = definition;

LOG:

[2025-11-23 20:19:51] info: 	z2m: Logging to console, file (filename: log.log)
[2025-11-23 20:19:51] info: 	z2m: Loaded external converter 'lumi_switch_aeu003.js'

Thanks a lot to neo170 and the whole team koenkk for maintaining

[neo170]

congrats, good work!

[ThiemoSt]

Is there a possibility that the device will be included in the “standard” in the near future, given the preliminary work that has already been done here?

[Stromberg1984]

It would be great if the device could be included. I get in opened and closed, but Switch number 3 and 4 are not available. But this was a main reason to buy it.

[simecky]

When this divece will be supported in standard release of zitgbee2mqtt ?

[olivercjung]

Is there any update? Many thanks!

[GrayJackal]

Second this, seems like the support should be ready to be integrated in standard release

[cristi001]

https://www.zigbee2mqtt.io/devices/DS-K02D_DS-K02E.html