To contribute to this page, edit the following file
Xiaomi QBCZ11LM #
Model | QBCZ11LM |
Vendor | Xiaomi |
Description | Aqara socket Zigbee |
Exposes | switch (state), power, energy, temperature, voltage, power_outage_memory, linkquality |
Picture | ![]() |
Notes #
Device type specific configuration #
How to use device type specific configuration
temperature_precision
: Controls the precision oftemperature
values, e.g.0
,1
or2
; default2
. To control the precision based on the temperature value set it to e.g.{30: 0, 10: 1}
, when temperature >= 30 precision will be 0, when temperature >= 10 precision will be 1.temperature_calibration
: Allows to manually calibrate temperature values, e.g.1
would add 1 degree to the temperature reported by the device; default0
.
Power outage memory #
This option allows the device to restore the last on/off state when it’s reconnected to power.
To set this option publish to zigbee2mqtt/FRIENDLY_NAME/set
payload {"power_outage_memory": true}
(or false
).
Now toggle the plug/switch once with the button on it, from now on it will restore its state when reconnecting to power.
Exposes #
Switch #
The current state of this switch is in the published state under the state
property (value is ON
or OFF
).
To control this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"state": "ON"}
, {"state": "OFF"}
or {"state": "TOGGLE"}
.
To read the current state of this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"state": ""}
.
Power (numeric) #
Instantaneous measured power.
Value can be found in the published state on the power
property.
To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"power": ""}
.
It’s not possible to write (/set
) this value.
The unit of this value is W
.
Energy (numeric) #
Sum of consumed energy.
Value can be found in the published state on the energy
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is kWh
.
Temperature (numeric) #
Measured temperature value.
Value can be found in the published state on the temperature
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is °C
.
Voltage (numeric) #
Measured electrical potential value.
Value can be found in the published state on the voltage
property.
It’s not possible to read (/get
) or write (/set
) this value.
The unit of this value is V
.
Power_outage_memory (binary) #
Enable/disable the power outage memory, this recovers the on/off mode after power failure.
Value can be found in the published state on the power_outage_memory
property.
It’s not possible to read (/get
) this value.
To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"power_outage_memory": NEW_VALUE}
.
If value equals true
power_outage_memory is ON, if false
OFF.
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:
switch:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
payload_off: "OFF"
payload_on: "ON"
value_template: "{{ value_json.state }}"
command_topic: "zigbee2mqtt/<FRIENDLY_NAME>/set"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.power }}"
unit_of_measurement: "W"
device_class: "power"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.energy }}"
unit_of_measurement: "kWh"
device_class: "energy"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.temperature }}"
unit_of_measurement: "°C"
device_class: "temperature"
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.voltage }}"
unit_of_measurement: "V"
device_class: "voltage"
binary_sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.power_outage_memory }}"
payload_on: true
payload_off: false
sensor:
- platform: "mqtt"
state_topic: "zigbee2mqtt/<FRIENDLY_NAME>"
availability_topic: "zigbee2mqtt/bridge/state"
value_template: "{{ value_json.linkquality }}"
unit_of_measurement: "lqi"
icon: "mdi:signal"