Skip to main content

Controller for Heatzy products

Project description

python-heatzy - Python Heatzy controller

heatzy

Heatzy (https://heatzy.com/) is a provider of heating control solutions (such as Pilot Wire addons to radiators). There is an API available on Google Drive, this software was created to control the Pilot Wire solution from a Python library.

Usage

Python

>>> import heatzy
# First create the handler with your heatzy app login/password
>>> hh = heatzy.HeatzyHandler('bidon@bidon.fr', 'p@ssw0rd')

# Get the devices dictionary (containing object type HeatzyDevice) associated to your account. The key is the device name
>>> deviceDict = hh.getHeatzyDevices()

# Assigns the device named 'Chambre'
>>> device = deviceDict['Chambre']  
# Gets status
>>> device.status() 
'ECO'
### Sets 'confort' mode 
>>> device.confort()
# Gets status
>>> device.status() 
'CONFORT'
>>> device.off()            # Sets mode to 'off'
>>> device.horsgel()        # Anti-freezing mode
>>> device.eco()            # Sets 'ECO' mode
>>> device.setMode('ECO')   # Different way to set 'ECO' mode

CLI

A CLI tool for interacting with the library is included (bin/heatzy-cli)

heatzy-cli
usage: heatzy.py [-h] [-u USERNAME] [-p PASSWORD] [-d DEVICE] [-l]
                 [-m SETMODE]

Controls Heatzy devices throught the CLI

optional arguments:
  -h, --help            show this help message and exit
  -u USERNAME, --username USERNAME
                        Username on the Heatzy (Gizwits) platform
  -p PASSWORD, --password PASSWORD
                        Password of the user
  -d DEVICE, --device DEVICE
                        Name of the Heatzy device you wish to control
  -l, --list            List all devices
  -m SETMODE, --setmode SETMODE
                        Sets the mode of the device
heatzy-cli -u login@heatzy.com -p p@ssw0rd -l                        # Lists the devices
heatzy-cli -u login@heatzy.com -p p@ssw0rd -d Bedroom                # Prints the info of the device
heatzy-cli -u login@heatzy.com -p p@ssw0rd -d Bedroom -m ECO         # Sets the device in the bedroom in ECO mode

HASS Integration

An optional component is available under opt/homeassistant. Put it in your '/custom_components/climate' directory, and edit your configuration.yaml file.

# Heatzy
climate:
  - platform: heatzy
    username: 'bidon@bidon.com'
    password: 'p@ssw0rd'

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

heatzy-0.0.10-py3.7.egg (8.4 kB view details)

Uploaded Source

File details

Details for the file heatzy-0.0.10-py3.7.egg.

File metadata

  • Download URL: heatzy-0.0.10-py3.7.egg
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.20.1 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.3

File hashes

Hashes for heatzy-0.0.10-py3.7.egg
Algorithm Hash digest
SHA256 9933efd4cfe5b6b366c01ae21c8b30de0ee67784ab1e2bd1bde91e9422ba8ec4
MD5 973e84d3bdcbf23ca5201903362cd1ed
BLAKE2b-256 4e95773718cae807aecf7e0890ad97a63284f714b4e5ac7d109b8d4871016dee

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