Skip to main content

Asynchronous Python client for Salus IT600 devices

Project description

Python: Asynchronous client for Salus iT600 devices

For end users

See https://github.com/jvitkauskas/homeassistant_salus to use this in Home Assistant.

About

This package allows you to control and monitor your Salus iT600 smart home devices locally through Salus UG600 universal gateway. Currently heating thermostats, binary sensors, temperature sensors, covers and switches are supported. You have any other devices and would like to contribute - you are welcome to create an issue or submit a pull request.

Installation

pip install pyit600

Usage

  • Instantiate the IT600Gateway device with local ip address and EUID of your gateway. You can find EUID written down on the bottom of your gateway (eg. 001E5E0D32906128).
  • Status can be polled using the poll_status() command.
  • Callbacks to be notified of state updates can be added with the add_climate_update_callback(method) or add_sensor_update_callback(method) method.

Basic example

async with IT600Gateway(host=args.host, euid=args.euid) as gateway:
	await gateway.connect()
	await gateway.poll_status()

	climate_devices = gateway.get_climate_devices()

	print("All climate devices:")
	print(repr(climate_devices))

	for climate_device_id in climate_devices:
		print(f"Climate device {climate_device_id} status:")
		print(repr(climate_devices.get(climate_device_id)))

		print(f"Setting heating device {climate_device_id} temperature to 21 degrees celsius")
		await gateway.set_climate_device_temperature(climate_device_id, 21)

Useful gateway methods

  • poll_status()
  • get_climate_devices()
  • get_climate_device(device_id)
  • set_climate_device_preset(device_id, preset)
  • set_climate_device_mode(device_id, mode)
  • set_climate_device_temperature(device_id, setpoint_celsius)
  • get_binary_sensor_devices()
  • get_binary_sensor_device(device_id)
  • get_switch_devices()
  • get_switch_device(device_id)
  • turn_on_switch_device(device_id)
  • turn_off_switch_device(device_id)
  • get_cover_devices()
  • get_cover_device(device_id)
  • set_cover_position(device_id, position)
  • open_cover(device_id)
  • close_cover(device_id)
  • get_sensor_devices()
  • get_sensor_device(device_id)

Supported devices

These thermostats have been tested:

  • HTRP-RF(50)
  • TS600
  • VS10WRF/VS10BRF
  • VS20WRF/VS20BRF
  • SQ610RF

These binary sensors have been tested:

  • SW600

These binary sensors have not been tested, but may work:

  • WLS600
  • OS600
  • SD600

These temperature sensors have been tested:

  • PS600

These switch devices have been tested:

  • SPE600
  • RS600

These switch devices have not been tested, but may work:

  • SR600
  • SP600

These cover devices have been tested:

  • RS600

Contributing

If you want to help to get your device supported, open GitHub issue and add your device model number and output of main.py program. Be sure to run this program with --debug option.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyit600-0.2.0.tar.gz (10.5 kB view details)

Uploaded Source

Built Distribution

pyit600-0.2.0-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

Details for the file pyit600-0.2.0.tar.gz.

File metadata

  • Download URL: pyit600-0.2.0.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5

File hashes

Hashes for pyit600-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a67b0b606b57f9bc771831bb31bd2f3508e8fd7a0ffca94642601e714770563c
MD5 60083fca4b789aff5405e23f18cefae0
BLAKE2b-256 865f957777303f507c1bdf86ed852a38ffa84029afc661685f3f627c9e5d65f7

See more details on using hashes here.

File details

Details for the file pyit600-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: pyit600-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.5

File hashes

Hashes for pyit600-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 97feea5d59ce5fbd14a632e9ea8a0339ae094aeb7aac2f9dcec03f3cf4bc8ba9
MD5 92f075770d9e66832f33a4053c3956e9
BLAKE2b-256 d5b0725f9808ceb7136162c3988685be3cb18591a764f0e8d001f2da7b63fff7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page