homebridge-systemair-ventilator/backup/README.md

A Homebridge plugin for controlling Systemair Ventilators.

# Homebridge Systemair Ventilator Plugin
This is a Homebridge plugin for controlling a Systemair Ventilator through its web interface then into 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:
   ```bash
   npm install -g homebridge
   
2. Install the Plugin
   ```bash
   npm install -g homebridge-systemair-ventilator
Run the following command to install the Homebridge Systemair Ventilator plugin:

3. Configure the Plugin
Edit the Homebridge config.json file to include the plugin. Add the following under "accessories":
   ```yaml
   {
     "accessories": [
       {
         "accessory": "SystemairVentilator",
         "name": "Living Room Ventilator",
         "ip": "x.x.x.x"
       }
     ]
   }
Replace add your Systemair IP with the actual IP address of your Systemair SAVEConnect device.

4. Restart Homebridge
Restart Homebridge for the changes to take effect:
   ```bash
   sudo systemctl restart homebridge 

# Features:
Control fan speeds with three settings: Low, Medium, and High.
Adjust the target temperature directly from HomeKit.
Automatically handles fan activation and speed synchronization.
Create scenes for Low, Normal, and High with the following mappings:

speed === 1 maps to 0% (Off)
speed === 2 maps to 16% (Low)
speed === 3 maps to 50% (Normal)
speed === 4 maps to 83% (High)

# Troubleshooting:
If the ventilator doesn't respond, check the following:

Ensure the IP address in the configuration is correct.
Verify that the SAVEConnect WIFI module is online.
Check Homebridge logs for error messages.