Systemair Modbus Integration for Home Assistant

This Home Assistant integration allows you to monitor and control Systemair SAVE ventilation units through your local network. It communicates directly with the Systemair IAM (Internet Access Module) or any other ModBus TCP-RTU module via the Modbus TCP protocol.

This integration was tested with SAVE VSR 300 and VSR 500 models but should be compatible with other units that use the IAM module.

Overview

Systemair SAVE units are residential ventilation systems designed for heat recovery. This integration brings your ventilation unit into Home Assistant, allowing you to create advanced automations and gain deep insights into your home's air quality and energy consumption.

Features

• Climate Control: Full control over HVAC modes (Off, Fan Only, Heat, Cool), target temperature, fan speed, and preset modes (Auto, Manual, Away, Holiday, etc.).
• Calculated Power Consumption: Monitor the estimated power usage of the supply fan, extract fan, and the total power consumption of the unit, including the re-heater. Essential for energy tracking in Home Assistant's Energy Dashboard.
• Advanced Configuration Controls: Directly configure key operational parameters from Home Assistant, including:
  • Temperature Control Mode (Supply air, Room air, etc.)
  • Fan Regulation Unit (Manual %, RPM, Pressure, etc.)
  • Defrosting Mode (Soft, Normal, Hard)
  • Allowing/disallowing manual fan stop.
• Enhanced Diagnostic Sensors: Gain deeper insights into the unit's current state with sensors for:
  • Indoor Air Quality (IAQ) Level
  • Active Demand Controller (CO2 or RH)
  • Current Defrosting State
• Greatly Improved Stability: The Modbus communication has been completely overhauled to be more robust and reliable, preventing frequent 'unavailable' states and errors by intelligently handling device responses.
• Sensor Monitoring: Track key environmental data, including outdoor, supply, and extract air temperatures, as well as relative humidity.
• Device Status: Monitor fan RPM, fan speed percentages, and heater output.
• Diagnostics: Keep an eye on filter lifetime and view detailed alarm statuses.

Prerequisites

1. A Systemair SAVE ventilation unit equipped with an IAM (Internet Access Module).
2. The IAM module must be connected to the same local network as your Home Assistant instance.
3. You need to know the IP address of the IAM module. You can typically find this in your router's client list.

Installation

(Installation instructions remain the same - HACS or Manual)

HACS

1. Open HACS and go to "Custom integrations". Enter the URL https://github.com/AN3Orik/systemair, choose type Integration and click Add.
2. Restart Home Assistant.
3. Go to settings and add new integration. You will find Systemair in the list of available integrations.

Manual

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called systemair.
4. Download all files from the custom_components/systemair/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant.

Configuration

Configuration is done entirely through the Home Assistant user interface.

1. Navigate to Settings > Devices & Services.

2. Click the + Add Integration button in the bottom right corner.

3. Search for "Systemair" and select it.

4. A configuration dialog will appear, asking for connection details:

   • Host: The IP address of your Systemair IAM module (e.g., 192.168.1.50).
   • Port: The Modbus TCP port for the IAM module. The default is 502.
   • Slave ID: The ModBus slave ID of the unit. The default is 1.
   • Model: Select your specific SAVE unit model (e.g., VSR 300, VSR 500). This is crucial for accurate power consumption calculations.

5. Click Submit. The integration will test the connection and add the Systemair device and its entities to Home Assistant.

You can change the model later by navigating to the integration's page and clicking Configure.

Entities Provided

This integration creates a single device for your ventilation unit with the following entities:

Climate

The primary entity for controlling the unit.

• HVAC Modes: Off, Fan Only, Heat, Cool, Heat/Cool.
• Fan Modes: Low, Medium, High.
• Preset Modes: Auto, Manual, Crowded, Refresh, Fireplace, Away, Holiday.
• Controls: Target Temperature, Current Temperature, Current Humidity.

Sensors

• Temperatures: Outside Air, Supply Air, Extract Air, Overheat Sensor.
• Humidity: Extract Air Relative Humidity.
• Fan Speeds: Supply & Extract Air Fan RPM, Supply & Extract Air Fan Regulated Speed (%).
• Heater: Heater Output Value (%).
• Power (Calculated): Supply Fan Power, Extract Fan Power, and Total Power Consumption (in Watts).
• Diagnostics: Indoor Air Quality, Active Demand Controller, Defrosting State.
• Filter: Filter Remaining Time (in seconds).
• Alarms: Individual sensors for each possible alarm (e.g., Frost Protection, Filter Alarm) showing its current state.

Binary Sensors

• Heat Exchange Active: on when the heat exchanger is running.
• Heater Active: on when the heating element is active.

Switches

• Eco Mode: A switch to enable or disable the energy-saving Eco mode.
• Free Cooling: A switch to enable or disable the free cooling function.
• Allow Manual Fan Stop: A configuration switch to permit the fans to be turned completely off.

Numbers

• Time Delays: Entities to configure the duration for timed preset modes like Holiday, Away, and Fireplace.

Selects

• Temperature Control Mode: Choose the sensor used for temperature regulation (Supply air, Room air, Extract air).
• Fan Regulation Unit: Select the fan control method (Manual %, RPM, Pressure, etc.).
• Defrosting Mode: Configure the aggressiveness of the defrosting cycle (Soft, Normal, Hard).