Zigbee2MQTT

Xiaomi WXCJKG12LM

ModelWXCJKG12LM
VendorXiaomi
DescriptionAqara Opple switch 2 bands
Exposesbattery, action, operation_mode, linkquality
PictureXiaomi WXCJKG12LM

Notes

Pairing Instructions

Press and hold the button on the backside of the device until the blue light starts blinking, release it and the pairing should begin.

Binding

By default the switch is bound to the coordinator but this device can also be used to directly control other lights and switches in the network.

First unbind it from the coordinator, then you can bind it to any other device or group. (see ../guide/usage/binding.md )

Now change the operation mode of the device, by default it is in event mode, but when binding we need to change it to command mode. To do this send to zigbee2mqtt/FRIENDLY_NAME/set payload {"operation_mode": "command"}, right before doing this make sure to wakeup the device.

As the device is sleeping by default, you need to wake it up after sending the bind/unbind command by pressing the reset button once.

Note that the WXCJKG12LM can only be bound to one device at a time.

When bound to a lamp, the behavior is as follows (for WXCJKG12LM Aqara Opple switch 2 band).

  • up left click: turn off
  • up right click: turn on
  • down left click: light dim down (by steps of 33%)
  • down right click: light dim up (by steps of 33%)
  • down left double click: warm white
  • down right double click: cold white

Exposes

Battery (numeric)

Remaining battery in %. Value can be found in the published state on the battery property. It's not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Action (enum)

Triggered action (e.g. a button click). Value can be found in the published state on the action property. It's not possible to read (/get) or write (/set) this value. The possible values are: button_1_hold, button_1_release, button_1_single, button_1_double, button_1_triple, button_2_hold, button_2_release, button_2_single, button_2_double, button_2_triple, button_3_hold, button_3_release, button_3_single, button_3_double, button_3_triple, button_4_hold, button_4_release, button_4_single, button_4_double, button_4_triple.

Operation_mode (enum)

Operation mode, select "command" to enable bindings (wake up the device before changing modes!). Value can be found in the published state on the operation_mode property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"operation_mode": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"operation_mode": NEW_VALUE}. The possible values are: command, event.

Linkquality (numeric)

Link quality (signal strength). Value can be found in the published state on the linkquality property. It's not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 255. The unit of this value is lqi.