| layout | title |
|---|---|
documentation |
29990 - ZWave |
{% include base.html %}
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.
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 between other devices in the mesh network.
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 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.
Fan mode
The device will support Fan Auto Mode, if both RH and CO2 sensors are present. This must be done at inclusion time. The Z-Wave Systemair Ventilation supports following Thermostat Fan Modes:
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.
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.
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.
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:Temperature |
| Fan speed setting | thermostat_fanmode | ||
| Alarm (system) | alarm_system | Switch |
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.
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 |
Sets the thermostat setpoint.
The thermostat_setpoint channel supports the Number:Temperature item and is in the Temperature category.
Channel type information on this channel is not found.
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 |
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. |
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.
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.
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.
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.
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 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.
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.
| 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.