To contribute to this page, edit the following file

Xiaomi WXCJKG12LM #

Model	WXCJKG12LM
Vendor	Xiaomi
Description	Aqara Opple switch 2 bands
Exposes	battery, action, operation_mode, 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 to false 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.

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.

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"
    value_template: "{{ value_json.battery }}"
    unit_of_measurement: "%"
    device_class: "battery"
    state_class: "measurement"

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"
    value_template: "{{ value_json.operation_mode }}"

sensor:
  - platform: "mqtt"
    state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
    availability_topic: "zigbee2mqtt/bridge/state"
    value_template: "{{ value_json.linkquality }}"
    unit_of_measurement: "lqi"
    enabled_by_default: false
    icon: "mdi:signal"
    state_class: "measurement"