README.rst

eQ-3/ELV MAX! Cube Python API

A python api to control the Max! Cube thermostats:

• get basic info about the cube itself
• get info about the max thermostats connected to the cube (mode, temperatures ...)

Basic usage:

from maxcube.cube import MaxCube

cube = MaxCube('192.168.0.20')

for device in cube.devices:
    print(device.name)
    print(device.actual_temperature)

This api was build for the integration of the Max! thermostats into Home Assistant and mostly only covers the functions needed for the integration.

It does also include functions needed to save and restore thermostat programmes. For example:

# dump programmes (and other data) to a JSON file
python3 prog.py dump --host=192.168.0.11 > backup.json

# load programmes (not other data!) from a JSON file
python3 prog.py load --host=192.168.0.11 < backup.json

Running tests

python3 -m unittest discover tests/

Acknowledgements

Thanks to:

• https://github.com/Bouni/max-cube-protocol
• https://github.com/ercpe/pymax
• https://github.com/aleszoulek/maxcube
• openhab integration