openhab-docs/_addons_bindings/zwave/doc/mcohome/ir2900_0_0.md

16 KiB

layout title
documentation IR Thermostat IR2900-ZW - ZWave

{% include base.html %}

IR Thermostat IR2900-ZW IR Thermostat

This describes the Z-Wave device IR Thermostat IR2900-ZW, manufactured by McoHome Technology Co., Ltd with the thing type UID of mcohome_ir2900_00_000.

The device is in the category of Battery, defining Batteries, Energy Storages.

IR Thermostat IR2900-ZW product image

The IR Thermostat IR2900-ZW supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is unable to participate in the routing of data from other devices.

Overview

The MCO Home IR Thermostat IR2900-ZW is a Z-Wave enabled device that allows you to control your air conditioning or heating system through infrared signals. It features a built-in temperature sensor and an LCD display that shows the current temperature and humidity levels. The device can be used as a thermostat to regulate the temperature of your home, and it can also be used to set schedules for your air conditioning or heating system.

Inclusion Information

In the home page, long press UP and DOWN synchronously for 3 sec to enter into Z-Wave interface, Product ID will be displayed on the interface.

If Product ID is 0, press POWER to include the device into Z-Wave network, if the inclusion is successful, it will not show 000 on the interface.

Exclusion Information

In the home page, long press UP and DOWN synchronously for 3 sec to enter into Z-Wave interface, Product ID will be displayed on the interface.

If Product ID is not 0, press to exclude the device from Z-Wave network POWER, if the Exclusion is successful, it will show 000 on the interface.

General Usage Information

Channels

The following table summarises the channels available for the IR Thermostat IR2900-ZW -:

Channel Name Channel ID Channel Type Category Item Type
Sensor (temperature) sensor_temperature sensor_temperature Temperature Number:Temperature
Sensor (relative humidity) sensor_relhumidity sensor_relhumidity Humidity Number
Thermostat mode thermostat_mode thermostat_mode Temperature Number
Operating State thermostat_state thermostat_state Temperature Number
Setpoint (heating) thermostat_setpoint thermostat_setpoint Heating Number:Temperature
Setpoint (cooling) thermostat_setpoint thermostat_setpoint Heating Number:Temperature
Thermostat fan mode thermostat_fanmode thermostat_fanmode

Sensor (temperature)

Indicates the current temperature.

The sensor_temperature channel is of type sensor_temperature and supports the Number:Temperature item and is in the Temperature category.

Sensor (relative humidity)

Indicates the current relative humidity.

The sensor_relhumidity channel is of type sensor_relhumidity and supports the Number item and is in the Humidity category. This is a read only channel so will only be updated following state changes from the device.

Thermostat mode

Sets the thermostat.

The thermostat_mode channel is of type thermostat_mode and supports the Number item and is in the Temperature category. The following state translation is provided for this channel to the Number item type -:

Value Label
0 Off
1 Heat
2 Cool
3 Auto
4 Aux Heat
5 Resume
6 Fan Only
7 Furnace
8 Dry Air
9 Moist Air
10 Auto Changeover
11 Heat Economy
12 Cool Economy
13 Away

Operating State

Sets the thermostat operating state.

The thermostat_state channel is of type thermostat_state and supports the Number item and is in the Temperature category. The following state translation is provided for this channel to the Number item type -:

Value Label
0 Idle
1 Heating
2 Cooling
3 Fan Only
4 Pending Heat
5 Pending Cool
6 Vent / Economiser

Setpoint (heating)

Sets the thermostat setpoint.

The thermostat_setpoint channel is of type thermostat_setpoint and supports the Number:Temperature item and is in the Heating category.

Setpoint (cooling)

Sets the thermostat setpoint.

The thermostat_setpoint channel is of type thermostat_setpoint and supports the Number:Temperature item and is in the Heating category.

Thermostat fan mode

Channel type information on this channel is not found.

Device Configuration

The following table provides a summary of the 24 configuration parameters available in the IR Thermostat IR2900-ZW. Detailed information on each parameter can be found in the sections below.

Param Name Description
0
1 Temp. Unit Temperature Units
2 Temp. Difference Reporting Automatiaclly report the temp to the Gateway when temp. variation is greater than tis value
3 Humidity Difference Reporting Automatiaclly report the humidity to the Gateway when humidity variation is greater than tis value
4 IR Command Feature In Heat Mode Whether to send IR command or not when the device is in the heating mode
5 IR Command Feature In Cool Mode Whether to send IR command or not when the device is in the cooling mode
6 Number Of Resending Command In AG2 Number of resending attempts to send a command to the device in associated group 2
7 Number Of Resending Command In AG3 Number of resending attempts to send a command to the device in associated group 3
10 Panel Lock Panel Lock
11 Beep Set Beep Set
12 Temp. Hysteresis Using IR For Control Temp. hysteresis (Unit C)
13 Temp. Offset Temp. Offset
14 Screen OFF Screen OFF
15 Backlight Brightness Backlight Brightness
16 Temp. Hysteresis Using AG For Control Temp. hysteresis when using association group for controlling
17 Support Cooling Mode When Air Conditioner does not have cooling mode, Set this parameter after the device download the IR code from the library
18 Support Heating Mode When Air Conditioner does not have heating mode, Set this parameter after the device download the IR code from the library
19 Temp. Upper Limit Setting In Cooling Mode Temp. Upper Limit Setting In Cooling Mode
20 Temp. Lower Limit Setting In Cooling Mode Temp. Lower Limit Setting In Cooling Mode
21 Temp. Upper Limit Setting In Heating Mode Temp. Upper Limit Setting In Heating Mode
22 Temp. Lower Limit Setting In Heating Mode Temp. Lower Limit Setting In Heating Mode
23 Local Temp. Setpoint Step Set In Cool Mode Local Temp. Setpoint Step Set In Cool Mode
24 Local Temp. Setpoint Step Set In Heat Mode Local Temp. Setpoint Step Set In Heat Mode
255 Factory Restore Factory Restore

Parameter 0:

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_0_0 and is of type INTEGER.

Parameter 1: Temp. Unit

Temperature Units 0: Celcius, 1:Fahrenheit Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_1_1 and is of type INTEGER.

Parameter 2: Temp. Difference Reporting

Automatiaclly report the temp to the Gateway when temp. variation is greater than tis value Unit 0.1C, 0:Disabled, 3-255: n*0.1C  Values in the range 0 to 255 may be set.

The manufacturer defined default value is 5.

This parameter has the configuration ID config_2_2 and is of type INTEGER.

Parameter 3: Humidity Difference Reporting

Automatiaclly report the humidity to the Gateway when humidity variation is greater than tis value 0:Disabled Values in the range 0 to 99 may be set.

The manufacturer defined default value is 6.

This parameter has the configuration ID config_3_1 and is of type INTEGER.

Parameter 4: IR Command Feature In Heat Mode

Whether to send IR command or not when the device is in the heating mode 0: Disabled, 1:Send Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_4_1 and is of type INTEGER.

Parameter 5: IR Command Feature In Cool Mode

Whether to send IR command or not when the device is in the cooling mode 0: Disabled, 1:Send Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_5_1 and is of type INTEGER.

Parameter 6: Number Of Resending Command In AG2

Number of resending attempts to send a command to the device in associated group 2 0: Disabled, 1-10:The number of times to resend Values in the range 0 to 10 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_6_1 and is of type INTEGER.

Parameter 7: Number Of Resending Command In AG3

Number of resending attempts to send a command to the device in associated group 3 0: Disabled, 1-10:The number of times to resend Values in the range 0 to 10 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_7_1 and is of type INTEGER.

Parameter 10: Panel Lock

Panel Lock 0: All buttons are valid; 1: Temp. "Up" & "Down" and "Mode" & "time" invalid, other buttons valid; 2: Power button valid, other buttons invalid; 3: All buttons are invalid. Values in the range 0 to 3 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_10_1 and is of type INTEGER.

Parameter 11: Beep Set

Beep Set 0: Off, 1:On Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_11_1 and is of type INTEGER.

Parameter 12: Temp. Hysteresis Using IR For Control

Temp. hysteresis (Unit C) 0: Remote control mode: the setpoint on IR2900-ZW is the same as the Air Conditioner; 1-3: Thermostat control mode: the setpoint on IR2900-ZW is NOT the same as Air Conditioner, there is temp, hysteresis and the setting range is 1-3 C Values in the range 0 to 3 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_12_1 and is of type INTEGER.

Parameter 13: Temp. Offset

Temp. Offset Accuracy 0.1 (n*0.1) C Values in the range -100 to 100 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_13_1 and is of type INTEGER.

Parameter 14: Screen OFF

Screen OFF 3-255: After n*1sec the screen will be turned off automatically; 0-2: After 8sec the screnn will be turned off automatically. Values in the range 0 to 255 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_14_1 and is of type INTEGER.

Parameter 15: Backlight Brightness

Backlight Brightness 1-8: 8 level backlight brightness, 1 is the dimmest, 8 is the brightest Values in the range 1 to 8 may be set.

The manufacturer defined default value is 8.

This parameter has the configuration ID config_15_1 and is of type INTEGER.

Parameter 16: Temp. Hysteresis Using AG For Control

Temp. hysteresis when using association group for controlling n*0.1C (Unit C) Values in the range 5 to 30 may be set.

The manufacturer defined default value is 10.

This parameter has the configuration ID config_16_1 and is of type INTEGER.

Parameter 17: Support Cooling Mode

When Air Conditioner does not have cooling mode, Set this parameter after the device download the IR code from the library 0: Not support, 1:Support Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_17_1 and is of type INTEGER.

Parameter 18: Support Heating Mode

When Air Conditioner does not have heating mode, Set this parameter after the device download the IR code from the library 0: Not support, 1: Support Values in the range 0 to 1 may be set.

The manufacturer defined default value is 1.

This parameter has the configuration ID config_18_1 and is of type INTEGER.

Parameter 19: Temp. Upper Limit Setting In Cooling Mode

Temp. Upper Limit Setting In Cooling Mode 1-99, n*1 C Values in the range 1 to 99 may be set.

The manufacturer defined default value is 37.

This parameter has the configuration ID config_19_1 and is of type INTEGER.

Parameter 20: Temp. Lower Limit Setting In Cooling Mode

Temp. Lower Limit Setting In Cooling Mode 0-98, n*1 C Values in the range 0 to 98 may be set.

The manufacturer defined default value is 5.

This parameter has the configuration ID config_20_1 and is of type INTEGER.

Parameter 21: Temp. Upper Limit Setting In Heating Mode

Temp. Upper Limit Setting In Heating Mode 1-99, n*1 C Values in the range 1 to 99 may be set.

The manufacturer defined default value is 37.

This parameter has the configuration ID config_21_1 and is of type INTEGER.

Parameter 22: Temp. Lower Limit Setting In Heating Mode

Temp. Lower Limit Setting In Heating Mode 0-98, n*1 C Values in the range 0 to 98 may be set.

The manufacturer defined default value is 5.

This parameter has the configuration ID config_22_1 and is of type INTEGER.

Parameter 23: Local Temp. Setpoint Step Set In Cool Mode

Local Temp. Setpoint Step Set In Cool Mode 1:0.5C; 0: 1C
Note: If there is ID in AG3, then this parameter will be set to 1 automatically, if not, then this parameter will be set to 0 automatically Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_23_1 and is of type INTEGER.

Parameter 24: Local Temp. Setpoint Step Set In Heat Mode

Local Temp. Setpoint Step Set In Heat Mode 1:0.5C; 0: 1C

Note: If there is ID in AG2, then this parameter will be set to 1 automatically, if not, then this parameter will be set to 0 automatically Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_24_1 and is of type INTEGER.

Parameter 255: Factory Restore

Factory Restore 1: Restore factory setting; 0:invalid Values in the range 0 to 1 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_255_1 and is of type INTEGER.

Association Groups

Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.

The IR Thermostat IR2900-ZW supports 3 association groups.

Group 1: Lifeline

The Lifeline association group reports device status to a hub and is not designed to control other devices directly. When using the Lineline group with a hub, in most cases, only the lifeline group will need to be configured and normally the hub will perform this automatically during the device initialisation.

Association group 1 supports 5 nodes.

Group 2: Basic Set Commands Sw1

Basic Set: Variation of working status of the device in the heating mode

Association group 2 supports 5 nodes.

Group 3: Basic Set Commands Sw2

Basic Set: Variation of working status of the device in the cooling mode

Association group 3 supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1
COMMAND_CLASS_BASIC_V1
COMMAND_CLASS_SENSOR_MULTILEVEL_V5
COMMAND_CLASS_THERMOSTAT_MODE_V1
COMMAND_CLASS_THERMOSTAT_OPERATING_STATE_V1
COMMAND_CLASS_THERMOSTAT_SETPOINT_V1
COMMAND_CLASS_THERMOSTAT_FAN_MODE_V1

Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.