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.

FHEM users might be interested in https://github.com/dominikkarall/fhempy which provides subset of functionality.

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)

Supported devices

Thermostats:

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

Binary sensors:

  • SW600
  • WLS600
  • OS600
  • SD600 (sometimes gateway may not expose required information for these devices to be detected, reason is unknown)
  • TRV10RFM (only heating state on/off)
  • RX10RF (only heating state on/off)

Temperature sensors:

  • PS600

Switch devices:

  • SPE600
  • RS600
  • SR600

Cover devices:

  • RS600

Unsupported devices

Buttons perform actions only in Salus Smart Home app:

  • SB600
  • CSB600

Untested devices

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

  • SP600

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

  • MS600

Troubleshooting

If you can't connect using EUID written down on the bottom of your gateway (which looks something like 001E5E0D32906128), try using 0000000000000000 as EUID.

Also check if you have "Local Wifi Mode" enabled:

  • Open Smart Home app on your phone
  • Sign in
  • Double tap your Gateway to open info screen
  • Press gear icon to enter configuration
  • Scroll down a bit and check if "Disable Local WiFi Mode" is set to "No"
  • Scroll all the way down and save settings
  • Restart Gateway by unplugging/plugging USB power

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.5.1.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

pyit600-0.5.1-py3-none-any.whl (13.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pyit600-0.5.1.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for pyit600-0.5.1.tar.gz
Algorithm Hash digest
SHA256 383c46a4cb44f32cf75d60bd4d7b4f380c0ce4b8698590f33714554d15c4750b
MD5 1cc2e88d51d3018b0e1dfd2161f03f4d
BLAKE2b-256 f96ebe6fd8051026cc104b53ffa54e938318610ed3d55d24f99812e4dfe22ee7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: pyit600-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 13.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.10.6

File hashes

Hashes for pyit600-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5798c4021a5218c0132c193140592fd6524a4deb61226145fb6e0cb2775ddde9
MD5 48861237084651f73b65763c31101c03
BLAKE2b-256 6754777a6562421565e57d89ac0612e0a33a6d0e283b1d55a80278b150df9a48

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