Xiaomi QBKG20LM
Model | QBKG20LM |
Vendor | Xiaomi |
Description | Aqara smart wall switch T1 (with neutral, double rocker) |
Exposes | switch (state), power, energy, voltage, flip_indicator_light, power_outage_memory, led_disabled_night, device_temperature, action, operation_mode, linkquality |
Picture | ![]() |
OTA updates
This device supports OTA updates, for more information see OTA updates.
Options
How to use device type specific configuration
state_action
: State actions will also be published as 'action' when true (default false). The value must betrue
orfalse
power_calibration
: Calibrates the power value (percentual offset), takes into effect on next report of device. The value must be a number.power_precision
: Number of digits after decimal point for power, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
energy_calibration
: Calibrates the energy value (percentual offset), takes into effect on next report of device. The value must be a number.energy_precision
: Number of digits after decimal point for energy, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
voltage_calibration
: Calibrates the voltage value (percentual offset), takes into effect on next report of device. The value must be a number.voltage_precision
: Number of digits after decimal point for voltage, takes into effect on next report of device. The value must be a number with a minimum value of0
and with a with a maximum value of3
device_temperature_calibration
: Calibrates the device_temperature value (absolute offset), takes into effect on next report of device. The value must be a number.
Exposes
Switch (left endpoint)
The current state of this switch is in the published state under the state_left
property (value is ON
or OFF
). To control this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"state_left": "ON"}
, {"state_left": "OFF"}
or {"state_left": "TOGGLE"}
. To read the current state of this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"state_left": ""}
.
Switch (right endpoint)
The current state of this switch is in the published state under the state_right
property (value is ON
or OFF
). To control this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"state_right": "ON"}
, {"state_right": "OFF"}
or {"state_right": "TOGGLE"}
. To read the current state of this switch publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"state_right": ""}
.
Power (numeric)
Instantaneous measured power. Value can be found in the published state on the power
property. It's not possible to read (/get
) or 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
.
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
.
Flip_indicator_light (binary)
After turn on, the indicator light turns on while switch is off, and vice versa. Value can be found in the published state on the flip_indicator_light
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"flip_indicator_light": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"flip_indicator_light": NEW_VALUE}
. If value equals ON
flip_indicator_light is ON, if OFF
OFF.
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. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"power_outage_memory": ""}
. 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.
Led_disabled_night (binary)
Enable/disable the LED at night. Value can be found in the published state on the led_disabled_night
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"led_disabled_night": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"led_disabled_night": NEW_VALUE}
. If value equals true
led_disabled_night is ON, if false
OFF.
Device_temperature (numeric)
Temperature of the device. Value can be found in the published state on the device_temperature
property. It's not possible to read (/get
) or write (/set
) this value. The unit of this value is °C
.
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: single_left
, double_left
, single_right
, double_right
, single_both
, double_both
.
Operation_mode (enum, left endpoint)
Decoupled mode for left button. Value can be found in the published state on the operation_mode_left
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"operation_mode_left": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"operation_mode_left": NEW_VALUE}
. The possible values are: control_relay
, decoupled
.
Operation_mode (enum, right endpoint)
Decoupled mode for right button. Value can be found in the published state on the operation_mode_right
property. To read (/get
) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get
with payload {"operation_mode_right": ""}
. To write (/set
) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set
with payload {"operation_mode_right": NEW_VALUE}
. The possible values are: control_relay
, decoupled
.
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
.