Python Library for Roth Touchline (Extended)

This is an extended version of the original pytouchline library, a simple helper library for controlling a Roth Touchline heat pump controller. This fork introduces additional features and improvements over the original version.

Installation

You can install the extended version of pytouchline from PyPI:

pip install pytouchline_extended

Usage

Here's a basic example of how to use pytouchline_extended:

from pytouchline_extended import PyTouchline

URL = "http://192.168.1.254"

py_touchline = PyTouchline(url=URL)

numberOfDevices = py_touchline.get_number_of_devices()
devices: list[PyTouchline] = []
# for each device, get information
for x in range(0, numberOfDevices):
	devices.append(PyTouchline(id=x, url=URL))
	devices[x].update()
	print(x)
	print(devices[x].get_name())
	print(devices[x].get_current_temperature())
	print(devices[x].get_target_temperature())
	print(devices[x].get_target_temperature_high())
	print(devices[x].get_target_temperature_low())
	print(devices[x].get_week_program())
	print(devices[x].get_operation_mode())
	print(devices[x].get_device_id())
	print(devices[x].get_controller_id())
	print(devices[x].get_hostname())
	print("-------------------------------------")

# set some values
print(devices[0].set_name("Hovedsoverom"))
print(devices[0].set_target_temperature(22.5))
print(devices[0].set_target_temperature_high(30))
print(devices[0].set_target_temperature_low(5))
print(devices[0].set_week_program(0))
print(devices[0].set_operation_mode(0))

Asynchronous Example

from pytouchline_extended import PyTouchline
import asyncio

async def main():
	URL = "http://192.168.1.254"

	py_touchline = PyTouchline(url=URL)

	numberOfDevices = await py_touchline.get_number_of_devices_async()
	devices: list[PyTouchline] = []
	# for each device, get information
	for x in range(0, numberOfDevices):
		devices.append(PyTouchline(id=x, url=URL))
		await devices[x].update_async()
		print(x)
		print(devices[x].get_name())
		print(devices[x].get_current_temperature())
		print(devices[x].get_target_temperature())
		print(devices[x].get_target_temperature_high())
		print(devices[x].get_target_temperature_low())
		print(devices[x].get_week_program())
		print(devices[x].get_operation_mode())
		print(devices[x].get_device_id())
		print(devices[x].get_controller_id())
		print("-------------------------------------")
	
	if len(devices) > 0:
		print(f"Hostname: {await devices[0].get_hostname_async()}")

		print(await devices[0].set_name_async("Hovedsoverom"))
		print(await devices[0].set_target_temperature_async(22.5))
		print(await devices[0].set_target_temperature_high_async(30))
		print(await devices[0].set_target_temperature_low_async(5))
		print(await devices[0].set_week_program_async(0))
		print(await devices[0].set_operation_mode_async(0))

if __name__ == "__main__":
	asyncio.run(main())

Contributing

Contributions to pytouchline_extended are welcome! You are welcome to create issues or pull requests.

License

pytouchline_extended is licensed under the MIT License. See LICENSE for more information.