Plugwise 170-01


Model	170-01
Vendor	Plugwise
Description	Emma Wired Pro / Emma Wireless
Exposes	application_fault_status, oem_fault_code, temperature, climate (local_temperature, local_temperature_calibration, occupied_cooling_setpoint, occupied_heating_setpoint, system_mode, running_state), humidity, min_cool_setpoint_limit, max_cool_setpoint_limit, min_heat_setpoint_limit, max_heat_setpoint_limit, outdoor_temperature, dhw_temperature, return_water_temperature, boiler_water_temperature, boiler_setpoint, battery, keypad_lockout
Picture

Options

How to use device type specific configuration

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
thermostat_unit: Controls the temperature unit of the thermostat (default celsius). The value must be one of celsius, fahrenheit

Exposes

Application fault status (numeric)

OpenTherm application fault status.. Value can be found in the published state on the application_fault_status property. It's not possible to read (/get) or write (/set) this value.

OpenTherm OEM-specific fault code.. Value can be found in the published state on the oem_fault_code property. It's not possible to read (/get) or write (/set) this value. The minimal value is 0 and the maximum value is 255.

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.

Climate

This climate device supports the following features: local_temperature, local_temperature_calibration, occupied_cooling_setpoint, occupied_heating_setpoint, system_mode, running_state.

occupied_cooling_setpoint: Temperature setpoint. To control publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"occupied_cooling_setpoint": VALUE} where VALUE is the °C between 0 and 30. To read send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"occupied_cooling_setpoint": ""}.
occupied_heating_setpoint: Temperature setpoint. To control publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"occupied_heating_setpoint": VALUE} where VALUE is the °C between 5 and 30. To read send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"occupied_heating_setpoint": ""}.
local_temperature: Current temperature measured on the device (in °C). To read send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"local_temperature": ""}.
system_mode: Mode of this device. To control publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"system_mode": VALUE} where VALUE is one of: off, heat, cool, auto. To read send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"system_mode": ""}.
running_state: The current running state. Possible values are: idle, heat, cool. To read send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"running_state": ""}.
local_temperature_calibration: Offset to add/subtract to the local temperature. To control publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"local_temperature_calibration": VALUE}.To read send a message to zigbee2mqtt/FRIENDLY_NAME/get with payload {"local_temperature": ""}.The minimal value is -12.5 and the maximum value is 12.5 with a step size of 0.1.

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 %.

Min cool setpoint limit (numeric)

Minimum allowed cooling setpoint. Value can be found in the published state on the min_cool_setpoint_limit property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"min_cool_setpoint_limit": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"min_cool_setpoint_limit": NEW_VALUE}. The minimal value is 0 and the maximum value is 30. The unit of this value is °C.

Max cool setpoint limit (numeric)

Maximum allowed cooling setpoint. Value can be found in the published state on the max_cool_setpoint_limit property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"max_cool_setpoint_limit": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"max_cool_setpoint_limit": NEW_VALUE}. The minimal value is 0 and the maximum value is 30. The unit of this value is °C.

Min heat setpoint limit (numeric)

Minimum allowed heating setpoint. Value can be found in the published state on the min_heat_setpoint_limit property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"min_heat_setpoint_limit": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"min_heat_setpoint_limit": NEW_VALUE}. The minimal value is 0 and the maximum value is 30. The unit of this value is °C.

Max heat setpoint limit (numeric)

Maximum allowed heating setpoint. Value can be found in the published state on the max_heat_setpoint_limit property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"max_heat_setpoint_limit": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"max_heat_setpoint_limit": NEW_VALUE}. The minimal value is 0 and the maximum value is 30. The unit of this value is °C.

Outdoor temperature (numeric)

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

Dhw temperature (numeric)

Domestic hot water temperature reported by OpenTherm.. Value can be found in the published state on the dhw_temperature property. It's not possible to read (/get) or write (/set) this value. The unit of this value is °C.

Return water temperature (numeric)

Boiler return water temperature reported by OpenTherm.. Value can be found in the published state on the return_water_temperature property. It's not possible to read (/get) or write (/set) this value. The unit of this value is °C.

Boiler water temperature (numeric)

Boiler supply water temperature reported by OpenTherm.. Value can be found in the published state on the boiler_water_temperature property. It's not possible to read (/get) or write (/set) this value. The unit of this value is °C.

Boiler setpoint (numeric)

Intended boiler water temperature. Value can be found in the published state on the boiler_setpoint property. It's not possible to read (/get) or write (/set) this value. The unit of this value is °C.

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 %.

Keypad lockout (enum)

Keaypad lockout. No lockout — all buttons active. Level 1 — normal operation, menu blocked; setpoint change via slider still allowed. Level 2 — all buttons and slider blocked; only the hardware unlock sequence is accepted.. Value can be found in the published state on the keypad_lockout property. To read (/get) the value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/get with payload {"keypad_lockout": ""}. To write (/set) a value publish a message to topic zigbee2mqtt/FRIENDLY_NAME/set with payload {"keypad_lockout": NEW_VALUE}. The possible values are: no_lockout, level_1, level_2.