Python library for controlling Saleryd HRV system
Project description
pysaleryd
Python library for controlling Saleryd HRV system
Python library for controlling Saleryd HRV system using the built in websocket server used by Saleryd HRV Homeassistant integration https://github.com/bj00rn/ha-saleryd-ftx
Supported devices
LOKE1/Loke Basic/LS-01 using control system 4.1.1
Usage with asyncio as library
Read data
import asyncio
from pysaleryd.client import Client
async with Client(WEBSOCKET_URL, WEBSOCKET_PORT) as hrv_client:
await asyncio.sleep(2) # wait a bit for some data
print(client.data)
Read data using callback
import asyncio
from pysaleryd.client import Client
def handle_messge(raw_message: str):
print(msg)
async with Client(WEBSOCKET_URL, WEBSOCKET_PORT) as hrv_client:
hrv_client.add_handler(handle_message)
await asyncio.sleep(3) # wait around a bit for data
Send control command
Command syntax can be found by dissecting websocket messages in the built in web ui
import asyncio
from pysaleryd.client import Client
async with Client(WEBSOCKET_URL, WEBSOCKET_PORT) as hrv_client:
await hrv_client.send_command("MF", 0) # send command to set fan mode
CLI usage
List command line usage
$ pysaleryd -h
Connect to system and capture websocket data to stdout
$ pysaleryd --host WEBSOCKET_URL --port WEBSOCKET_PORT [-t TIMEOUT]
Send command to system
$ pysaleryd --host 192.168.1.151 --port 3001 --send --key MF --data 0
Troubleshooting
Confirm system is connected and UI is reachable on the local network. Follow steps in the manual.
Confirm websocket port by connecting to the UI using a browser and take note of websocket port using debug console in browser. 3001 is probably default
The system HRV system can only handle a few connected clients. Shut down any additional clients/browsers and try again
Disclaimer
Use at own risk.
This project is in no way affiliated with the manufacturer.
All product names, logos, and brands are property of their respective owners. All company, product and service names used are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.
Note
This project has been set up using PyScaffold 4.4. For details and usage information on PyScaffold see https://pyscaffold.org/.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pysaleryd-3.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 47c7ffc1c9864348a59e68dd5a9dd134e2cc5e995ddac2088c44a1b37cfc3194 |
|
MD5 | 3db8ab0e3184b974fb493461ec4692cb |
|
BLAKE2b-256 | 9c5daf51bdfb601cec39adbbcfb3e95332f19597669820b3387055962985b233 |