Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ikubicki committed Dec 26, 2024
1 parent 541a7d0 commit b4d65db
Showing 1 changed file with 26 additions and 10 deletions.
36 changes: 26 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,34 +1,50 @@
# Salus IT600 thermostats integration

Virtual device that allow to control Salus IT600 thermostats. It creates three child devices that show current temperature, humidity and heating status in form of binary switch.
Virtual device that allow to control Salus IT600 thermostats. It creates three child devices that show current temperature and humidity. The previous binary switch was removed and replaced with operating status on main device.

Due to discontinuation of the cloud access, it is necessary to switch to a local mode in Salus Gateway and use a proxy solution.

There's ability to use aeslib library to communicate with gateway directly, however running aes encryption every few seconds, may affect the performance of HC unit. I decided to go with a JS based proxy. Which you can find [here](https://registry.hub.docker.com/r/irekk/salus-proxy) and [here](https://github.com/ikubicki/salus-proxy).

## Configuration

`Username` - Velux username
`User` - Salus prpxy user

`Password` - Salus proxy password

`Password` - Velux password
`Host` - IP or hostname of the docker proxy

### Optional properties

`Port` - Port of the docker proxy. Defaults to 80

`DeviceID` - ID of the device

`Interval` - Update interval expressed in seconds (30s by default)
`Interval` - Update interval expressed in seconds (5s by default)


## Installation

Follow regular installation process. After virtual device will be added to your Home Center unit, click on Variables and provide `Username` and `Password`.
Then, click on `Search devices` button which will pull all information from your Salus account that includes Gateways and associated Devices.
Follow regular installation process. After virtual device will be added to your Home Center unit, click on Variables and provide following variables:
* `User` Proxy user name - not salus username (previous `Username` variable was replaced due to review all the whole configuration)
* `Password` Proxy user password - not salus user password
* `Host` Proxy IP address or hostname (without protocol and path).

If you're installing another device, your Username and Password will be automatically populated from previous device.
Once saved, the device should automatically pull list of device and present in the select field, where you can choose the device.

To access pulled information, go to logs of the device, review detected devices and use proper IDs as variables of the QuickApp.
This should improve the UX of the device.

To change update interval add Interval property or replace existing one (if there's no edit botton).
If you're installing another device, your User, Password Host and Port variables will be automatically populated from previous device.

## Notes

Salus API is locking account for 30 minutes after few invalid login attempts. If you'll change your password, virtual devices may lock your account.

## Changes
## Change

### v.2.0.0
- Uses local mode
- UX iprovements

### v.1.3.0
- UI improvements
Expand Down

0 comments on commit b4d65db

Please sign in to comment.