The openHAB Documentation Has Moved

The documentation has moved to openhab.org/docs and openhab.org/addons.

Please use the link below to be redirected to the new version of this article, and update your bookmarks.

29990 Remotely Controlled Ventilation

This describes the Z-Wave device 29990, manufactured by Systemair Sverige AS with the thing type UID of systemair_29990_00_000.

The device is in the category of HVAC, defining Air condition devices, Fans.

29990 product image

The 29990 supports routing. This allows the device to communicate using other routing enabled devices as intermediate routers. This device is also able to participate in the routing of data from other devices.

Overview

NB, theese are excerpts from the official manual found here: https://www.systemair.com/globalassets/documentation/64581.pdf

Also note that the adapter works by sitting on top of the Modbus adapter in your ventilation unit. All commands talk to the Modbus adapter, if you are in doubt about a command check out the modbus documentation from Systemair here: http://catalogue2.systemair.com/FileHandler.axd?id=67600

The Systemair Z-Wave Ventilation is a residential heat recovery ventilation system, which consists of the following main modules:

  • Ventilation Unit, which is controlled by a module called PCU-ECx, where ‘x’ is a digit representing the module generation.
  • One or more local User Interface/s called CDx, where ‘x’ is a digit representing the module generation. The CDx is connected to the PCU-ECx. Via CDx the user can control locally the Ventilation Unit.
  • Z-Wave to Systemair HVAC Interface Adapter, which connects the Z-Wave network with the Ventilation Unit.

Application status

Some of the implemented CCs need to be translated to the Ventilation Unit via the Modbus interface. Due to some reasons that communication couldn’t be available, for example – disconnected/damaged communication cable. In order to cover such situations, the Application Status Command Class has been implemented. So, In case of no communication between Z-Wave Adapter and the Ventilation Unit Module, the Device will send “Application Reject Request” for all Z-Wave commands required communication with the Ventilation Unit. If the Modbus communication is up and running, the device is always available to respond in the specified time, i.e. the device will never report “Application Busy” command.

Associations

The Device supports one, the Lifeline Association Group only. Maximum 5 nodes can be added to that group. The device uses the Lifeline group to send the following unsolicited reports:

• Thermostat Mode Report – when thermostat mode changes,
• Thermostat Setpoint Report – when the temperature setpoint changes,
• Thermostat Fan Mode Report – when the fan level changes,
• Notification Report – when an alarm occurs,
• Switch Binary Report – when the device enter/exit the Boost mode,
• Device Reset Locally – at factory reset

Temperature setpoint

The device supports “Thermostat Auto changeover” setpoint type only. The setpoint range varies in depend of the ventilation system type (Table 3) and some other ventilation unit configurations. All of these dependencies must be fixed at inclusion time, so the system will be fully defined. The Host shall retrieve the setpoint range using the Thermostat Setpoint Capabilities Get V3 command. In additional to the reported Min and Max Values, 0°C is supported as well. The device accepts the setpoints in a predefined step in the reported range. It is available via the Configuration CC, parameter 5 (see Table 2: Configuration Parameters).

See documentation link for tables: https://www.systemair.com/globalassets/documentation/64581.pdf

Fan mode

The device will support Fan Auto Mode, if both RH and CO2 senors are present. This must be done at inclusion time. The Z-Wave Systemair Ventilation supports following Thermostat Fan Modes:

See documentation link for tables: https://www.systemair.com/globalassets/documentation/64581.pdf

Boost Mode

The Systemair Z-Wave Ventilation has implemented a Boost Mode. That mode overrides the selected fan speed, setting it to a predefined level (usually high) for a predefined time period. To set the Boost Mode remotely via Z-Wave, the Binary Switch CC is used. But that binary switch is a bit special – Once it is turned ON, it locks itself in ON position for the predefined time period, and it can’t be turned off until that time period expires. The Host can use the Ventilation System Boost mode in case of smoke or fire alarm for example.

Alarms

The implemented Notification CC V3 is used to report the device malfunctions:

• Notification Type 0x09 – “System”
• Event Type 0x03 – “System Hardware Failure with manufacture proprietary code”

The failures are reported in a two bytes value, where each bit represents a certain alarm. If the bit is set (1) the alarm is active, and if the bit is cleared (0) the alarm is not active.

Any bit’s transition from 0 to 1 will trigger an unsolicited Notification Report. The system maintains a repeat timeout counter for each alarm, which is hard coded to 24 hours. So, an alarm occurrence runs its counter. When the repeat time expires and the alarm still exists (its bit is set) a new unsolicited Notification Report will be send. A bit’s transition from 1 to 0 clears its repeat counter. The alarms are generated in the Ventilation Unit.

See documentation link for alarm details: https://www.systemair.com/globalassets/documentation/64581.pdf

Inclusion Information

When the device is not added to a Z-Wave network, then triple short clicks of the inclusion button will start the inclusion. The device begins a classic inclusion. If after 3 attempts the inclusion doesn’t succeed, then the Network Wide Inclusion will be started.

Exclusion Information

When the device is already included in a Z-Wave network, then triple short clicks of the inclusion button will exclude it from that Z-Wave network.

Channels

The following table summarises the channels available for the 29990 -:

Channel Channel Id Category Item Type
Boost mode switch_binary Switch Switch
Thermostat mode thermostat_mode Temperature Number
Thermostat Setpoint thermostat_setpoint Temperature Number
Fan speed setting thermostat_fanmode    
Alarm (system) alarm_system   Switch

Boost mode

The Systemair Z-Wave Ventilation has implemented a Boost Mode. That mode overrides the selected fan speed, setting it to a predefined level (usually high) for a predefined time period. To set the Boost Mode remotely via Z-Wave, the Binary Switch CC is used. But that binary switch is a bit special – Once it is turned ON, it locks itself in ON position for the predefined time period, and it can’t be turned off until that time period expires. The Host can use the Ventilation System Boost mode in case of smoke or fire alarm for example

Switch the power on and off.

The switch_binary channel supports the Switch item and is in the Switch category.

Thermostat mode

Sets the thermostat.

The thermostat_mode channel 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
15 Full Power
31 Manufacturer Specific

Thermostat Setpoint

Sets the thermostate setpoint.

The thermostat_setpoint channel supports the Number item and is in the Temperature category.

Fan speed setting

Channel type information on this channel is not found.

Alarm (system)

Indicates if a system alarm is triggered.

The alarm_system channel supports the Switch item. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
OFF Ok
ON Alarm

Device Configuration

The following table provides a summary of the 5 configuration parameters available in the 29990. Detailed information on each parameter can be found in the sections below.

Param Name Description
1 System Type (read-only) Ventilation System Type.
2 Filter - Period (read-only) In step of 30 days; 6=180days.
3 Filter - Days How many days has been used since the last change
4 Boost Mode Remaining Time How many seconds are left for Boost mode.
5 Temperature Setpoint Step (read-only) The min change available in degree Celsius x 10; 25 = 2.5 C.

Parameter 1: System Type (read-only)

Ventilation System Type.

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

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

Parameter 2: Filter - Period (read-only)

In step of 30 days; 6=180days.

Values in the range 0 to 12 may be set.

The manufacturer defined default value is 12.

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

Parameter 3: Filter - Days

How many days has been used since the last change

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

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

Parameter 4: Boost Mode Remaining Time

How many seconds are left for Boost mode.

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

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

Parameter 5: Temperature Setpoint Step (read-only)

The min change available in degree Celsius x 10; 25 = 2.5 C.

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_5_2 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 29990 supports 1 association group.

Group 1: Lifeline

This group supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_NO_OPERATION_V1  
COMMAND_CLASS_BASIC_V1  
COMMAND_CLASS_APPLICATION_STATUS_V1  
COMMAND_CLASS_SWITCH_BINARY_V1  
COMMAND_CLASS_THERMOSTAT_MODE_V1  
COMMAND_CLASS_THERMOSTAT_SETPOINT_V1  
COMMAND_CLASS_THERMOSTAT_FAN_MODE_V1  
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1  
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1  
COMMAND_CLASS_ZWAVEPLUS_INFO_V1  
COMMAND_CLASS_CONFIGURATION_V1  
COMMAND_CLASS_ALARM_V3  
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1  
COMMAND_CLASS_POWERLEVEL_V1  
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1  
COMMAND_CLASS_ASSOCIATION_V2  
COMMAND_CLASS_VERSION_V2  

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