Aqara WSDCGQ12LM

Model	WSDCGQ12LM
Vendor	Aqara
Description	Temperature and humidity sensor T1
Exposes	device_temperature, power_outage_count, temperature, humidity, pressure, battery, voltage
Picture
White-label	Aqara TH-S02D, Yandex YNDX-00523

Notes

Adapter firmware

In order for this device to work (fully), at least the following firmware is required on your adapter:

• CC2530/CC2531: 20211115
• CC1352/CC2652: 20211114
• CC2538: 20211222
• Conbee II: 0x26720700

Note that if you have already paired the device you will need to repair it after upgrading your adapter firmware.

Pairing

Press and hold the reset button on the device for +- 5 seconds (until the blue light starts blinking). After this the device will automatically join. If this doesn't work, try with a single short button press.

Note: When you fail to pair a device, try replacing the battery, this could solve the problem.

Troubleshooting: device stops sending messages/disconnects from network

Since Xiaomi devices do not fully comply to the Zigbee standard, it sometimes happens that they disconnect from the network. Most of the times this happens because of the following reasons:

• Device has a weak signal, you can see the signal quality in the published messages as linkquality. A linkquality < 20 is considered weak.
• Low battery voltage, this can even happen when the battery still appears full. Try a different battery.
• The device is connected through a router which cannot deal with Xiaomi devices. This is known to happen devices from: Centralite, General Electric, Iris, Ledvance, Legrand, OSRAM, Sylvania, SmartThings, Securifi. A possible solution is to connect the device directly to the central coordinator by pushing the reset button while being physically close to it.

More detailed information about this can be found here.

OTA updates

This device supports OTA updates, for more information see OTA updates.

Options

How to use device type specific configuration

• device_temperature_calibration: Calibrates the device_temperature value (absolute offset), takes into effect on next report of device. The value must be a number.

• temperature_calibration: Calibrates the temperature value (absolute offset), takes into effect on next report of device. The value must be a number.

• temperature_precision: Number of digits after decimal point for temperature, takes into effect on next report of device. This option can only decrease the precision, not increase it. The value must be a number with a minimum value of 0 and with a maximum value of 3

• humidity_calibration: Calibrates the humidity value (absolute offset), takes into effect on next report of device. The value must be a number.

• humidity_precision: Number of digits after decimal point for humidity, takes into effect on next report of device. This option can only decrease the precision, not increase it. The value must be a number with a minimum value of 0 and with a maximum value of 3

• pressure_calibration: Calibrates the pressure value (absolute offset), takes into effect on next report of device. The value must be a number.

• pressure_precision: Number of digits after decimal point for pressure, takes into effect on next report of device. This option can only decrease the precision, not increase it. The value must be a number with a minimum value of 0 and with a maximum value of 3

Exposes

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.

Power outage count (numeric)

Number of power outages. Value can be found in the published state on the power_outage_count property. It's not possible to read (/get) or write (/set) this value.

Temperature (numeric)

Measured temperature value. Value can be found in the published state on the temperature property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"temperature": ""}. It's not possible to write (/set) this value. The unit of this value is °C.

Humidity (numeric)

Measured relative humidity. Value can be found in the published state on the humidity property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"humidity": ""}. It's not possible to write (/set) this value. The unit of this value is %.

Pressure (numeric)

The measured atmospheric pressure. Value can be found in the published state on the pressure property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"pressure": ""}. It's not possible to write (/set) this value. The unit of this value is hPa.

Battery (numeric)

Remaining battery in %. Value can be found in the published state on the battery property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"battery": ""}. It's not possible to write (/set) this value. The minimal value is 0 and the maximum value is 100. The unit of this value is %.

Voltage (numeric)

Reported battery voltage in millivolts. Value can be found in the published state on the voltage property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"voltage": ""}. It's not possible to write (/set) this value. The unit of this value is mV.