To contribute to this page, edit the following file
Xiaomi WXCJKG12LM #
Model | WXCJKG12LM |
Vendor | Xiaomi |
Description | Aqara Opple switch 2 bands |
Exposes | battery, action, linkquality |
Picture | ![]() |
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 https://www.zigbee2mqtt.io/information/binding.html )
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
Device type specific configuration #
How to use device type specific configuration
legacy
: Set tofalse
to disable the legacy integration (highly recommended!) (default: true)
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
.
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
.
Manual Home Assistant configuration #
Although Home Assistant integration through MQTT discovery is preferred, manual integration is possible with the following configuration:
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "%"
value_template: "{{ value_json.battery }}"
device_class: "battery"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.action }}"
icon: "mdi:gesture-double-tap"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
unit_of_measurement: "lqi"
value_template: "{{ value_json.linkquality }}"
icon: "mdi:signal"