Homebridge Systemair Ventilator Plugin

This is a Homebridge plugin for controlling a Systemair Ventilator through its web interface and exposing it to Apple HomeKit.
You must have a SAVEConnect WIFI module connected for this to work.

You will need the IP address of the SAVEConnect device and include it in the plugin settings.

Installation

If Homebridge is not already installed, use the following command to install it globally:

1. Install Homebridge

npm install -g homebridge
2. Install the plugin
bash
Copy code
npm install -g homebridge-systemair-ventilator
3. Configure the plugin
Edit the Homebridge config.json file and add the following under "accessories":

json
Copy code
{
  "accessories": [
    {
      "accessory": "SystemairVentilator",
      "name": "Living Room Ventilator",
      "ip": "x.x.x.x"
    }
  ]
}
Replace x.x.x.x with the IP address of your Systemair SAVEConnect device.

4. Restart Homebridge
bash
Copy code
sudo systemctl restart homebridge
✨ What’s New / Recently Updated
🔥 Temperature control via HomeKit (NEW)
A Thermostat service is now exposed in HomeKit

View and change the target temperature directly from the Apple Home app

A temperature dial is shown in HomeKit

Temperature range: 10°C – 30°C (0.5°C steps)

❌ Fixed: Temperature resetting to 18°C
Previously, using the Refresh function forced the temperature back to 18°C

This behavior has been fixed

Refresh now preserves the user-selected temperature

🧠 Improved HomeKit stability
Safe fallbacks ensure HomeKit always receives valid temperature values

Prevents HomeKit from hiding the thermostat UI due to missing or invalid data

🔄 Improved Refresh behavior
Refresh mode no longer overrides temperature settings

Fan speed and temperature are automatically restored after refresh completes

Features
Turn ventilation On / Off

Control fan speeds: Low, Normal, High

Adjust target temperature from HomeKit

Refresh / boost ventilation mode

Timer status exposed as a battery-style indicator

Compatible with HomeKit scenes and automations

Fan speed mapping
ini
Copy code
speed === 1 → 0%   (Off)
speed === 2 → 16%  (Low)
speed === 3 → 50%  (Normal)
speed === 4 → 83%  (High)
Troubleshooting
If the ventilator does not respond:

Ensure the IP address in the configuration is correct

Verify that the SAVEConnect WIFI module is online

Restart Homebridge after installing or updating the plugin

Check Homebridge logs for error messages

Temperature dial not visible?
HomeKit caches accessory layouts aggressively.

If you updated from an older version:

Remove the accessory from the Apple Home app

Restart Homebridge

Re-add the accessory

Notes
This plugin communicates locally with the Systemair SAVEConnect web interface

No cloud services are required

Removing and re-adding the accessory is required when new services (like temperature control) are added