prefixkit Ask an engineerAsk Support RU

Zigbee devices Thermostats and radiator valves

Aqara TH-S04D

Climate Sensor W100. Works with Zigbee2MQTT with no vendor hub or cloud: it pairs with a Zigbee stick and shows up in Home Assistant.

Vendor
Aqara
Model
TH-S04D
Type
Thermostats and radiator valves
Power
battery: an end device, does not extend the mesh
Firmware updates (OTA)
yes, through Zigbee2MQTT

Find it in shops: AliExpress

Links open a search in the shop; some are affiliate links: buying through them costs you nothing extra and supports this site. We do not sell devices or get them from manufacturers.

What it exposes

FeaturePropertyValuesControl
Thermostat modethermostat_mode—settable
Climatesystem_mode, fan_mode, occupied_heating_setpoint, local_temperaturemode, fan_mode, heating setpoint, room temperaturesettable
PMTSD from W100 DataPMTSD_from_W100_Data—read only
Batterybattery% · 0…100read only
Temperaturetemperature°Cread only
Humidityhumidity%read only
Sensorsensorinternal, externalsettable
External temperatureexternal_temperature°C · -100…100settable
External humidityexternal_humidity% · 0…100settable
Auto hide middle lineauto_hide_middle_line—settable
High temperaturehigh_temperature°C · 26…60settable
Low temperaturelow_temperature°C · -20…20settable
High humidityhigh_humidity% · 65…100settable
Low humiditylow_humidity% · 0…30settable
Samplingsamplinglow, standard, high, customsettable
Periodperiodsec · 0.5…600settable
Temp report modetemp_report_modeno, threshold, period, threshold_periodsettable
Temp periodtemp_periodsec · 1…600settable
Temp thresholdtemp_threshold°C · 0.2…3settable
Humi report modehumi_report_modeno, threshold, period, threshold_periodsettable
Humi periodhumi_periodsec · 1…600settable
Humi thresholdhumi_threshold% · 2…10settable
Identifyidentifyidentifysettable
Action (button press)actionW100_PMTSD_request, hold_plus, hold_center, hold_minus, single_plus, single_center, single_minus, double_plus …read only

MQTT: state and commands

Zigbee2MQTT publishes the device state to zigbee2mqtt/my_device (my_device is the name you give the device). An example message:

{
  "thermostat_mode": false,
  "occupied_heating_setpoint": 21,
  "local_temperature": 20.5,
  "system_mode": "heat",
  "battery": 87,
  "temperature": 21.6,
  "humidity": 46.2,
  "sensor": "internal",
  "external_temperature": 0,
  "external_humidity": 50,
  "auto_hide_middle_line": false,
  "high_temperature": 43,
  "low_temperature": 0,
  "high_humidity": 83,
  "linkquality": 120
}

Send commands to zigbee2mqtt/my_device/set:

mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"occupied_heating_setpoint":21.5}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"system_mode":"heat"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"thermostat_mode":true}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"sensor":"external"}'
mosquitto_pub -t zigbee2mqtt/my_device/set -m '{"auto_hide_middle_line":true}'

Watch the topics live from the browser: MQTT client.

Home Assistant automation example

Zigbee2MQTT creates Home Assistant entities from the device name. If it is called my_device, an automation in automations.yaml can look like this:

- alias: "Cooler at night"
  mode: single
  triggers:
    - trigger: time
      at: "23:00:00"
  actions:
    - action: climate.set_temperature
      target:
        entity_id: climate.my_device
      data:
        temperature: 18

Check the YAML: YAML checker.

How to pair it

  1. In Zigbee2MQTT click Permit join.
  2. Put the device in pairing mode: usually a long press of the reset button (5–10 s) until the LED blinks; bulbs: switch the power off and on 5–6 times.
  3. Keep the device close to the coordinator or a router while pairing.
  4. Give it a clear name: MQTT topics and Home Assistant entities are built from it.

Exact procedure and model notes: the device page in the Zigbee2MQTT docs. No coordinator yet: coordinator picker.

Similar devices

Idea?