PySwitcherV2

Control your Switcher V2 water heater using Python.

Getting Started

These instructions will get you a copy of the project up and running on your local machine so you can control your Switcher water heater using Python on your local network.

Prerequisites

The script was tested on Python 2.7 and up or Python 3.5. Feel free to inform if you find a non compatible version. You local machine and Switcher must be on the same network.

Installing

Using pip

$ pip install pyswitcherv2

Downloading

Find the latest release at releases/ page

Cloning

Use the 'clone' button from the repository main page

Running

Configuration

The script requires 4 parameters:

Device ID
Phone ID
Device pass
Switcher local IP address

If you already know these values, edit credentials.json accordingly.

Otherwise, you can use the pcap parsing mode to get these parameters

Parse pcap file to get credentials:

In order to parse pcap files you will need to install pypcapfile package

$ pip install pypcapfile

Then:

$ python switcher.py -m parse_pcap_file -f file.pcap

This will create credentials.json file with most of the required information.
You will still need to update the file with Switcher local IP address (LAN)

If you need assistance in creating pcap file or finding Switcher local ip address, use the Wiki page tutorial

Actions

Turn Switcher on/off:

$ python switcher.py -m on

It is possible to use -t arg with operation time in minutes (otherwise Switcher will be on for as maximum time as defined in the device settings)

$ python switcher.py -m on -t 45

This will turn on Switcher for 45 minutes

Get Switcher state:

$ python switcher.py -m get_state

Prints the Switcher state and returns 1 if Switcher is ON and 0 otherwise

Other

Help:

$ python switcher.py -h

Debug:

In case you are experiencing any issue, please use debug mode to get more information before submitting a ticket. Debug flag can be used with any other mode

$ python switcher.py -m off -d
$ python switcher.py -m get_state -d

Using as objects

As of version 1.2.9, if you installed via PyPi (pip install..) you should be able to control Switcher as an object within your scripts
Here is an example use:

import time
from pyswitcherv2 import switcher

phone_id = "xxxx"
dev_id = "xxxxxx"
dev_pass = "xxxxxxxx"
switcher_local_ip = "192.168.x.x"

credentials = switcher.Credentials(phone_id, dev_id, dev_pass, switcher_local_ip)
credentials.validate()
is_debug = True
switcher = switcher.Switcher(credentials, is_debug)
time_minutes = 30
switcher.turn_on(time_minutes)
time.sleep(3)
switcher.get_state()
time.sleep(3)
switcher.turn_off()

Wiki

The Wiki section contains more information about using the library with HomeAssistant and Homebridge.

Ardeth / pyswitcherv2