home-assistant.io/source/_components/switcher_kis.markdown
Tomer Figenblat 80735a1b6a Added Switcher Water Heater component named switcher_kis (#8480)
* Added Switcher Water Heater component named switcher_kis

* Update source/_components/switcher_kis.markdown

Co-Authored-By: TomerFi <tomer.figenblat@gmail.com>

* Update source/_components/switcher_kis.markdown

Co-Authored-By: TomerFi <tomer.figenblat@gmail.com>

* ✏️ Tweak

* ✏️ Tweak spaces

* Fixed typo and canceled the friendly_name configuration value.

* Deleted turn_on and turn_off services, added update_schedules service.

* Trimmed the component for initial acceptence.

* Modifications based on recent updates to the homeassistant PR.

* Clarifay friendly_name value.

* Update source/_components/switcher_kis.markdown

Co-Authored-By: TomerFi <tomer.figenblat@gmail.com>

* Update source/_components/switcher_kis.markdown

Co-Authored-By: TomerFi <tomer.figenblat@gmail.com>

* Update ha_release

* ✏️ Tweak
2019-04-20 00:16:08 +02:00

2.5 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, redirect_from, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category redirect_from ha_release ha_iot_class
page Switcher Controlling your Switcher V2 Water Heater. 2018-04-10 17:30 true false true true switcher_boiler.png
Switch
/components/switch.switcher_kis
0.93 Local Push

This Switcher component allows you to control the Switcher V2 Water Heater.

To enable it, add an entry to your configuration.yaml according to the following configuration instructions.

To retrieve your device's details, please follow the instructions here.

Please note, the Switcher-V2-Python script is written in python 2.7 syntax, it won't run with python 3.x.

Please note, for the Switcher-V2-Python script to run successfully, you need to configure your device to work locally.

Please note, on the original script repository, users recently reported difficulties controling the device after upgrading the firmware to the new 3.0 version.As this component is based on that script, please do not upgrade to version 3.0 until this issue is resolved. You can follow the issue [here](https://github.com/NightRang3r/Switcher-V2-Python/issues/3).

```yaml switcher_kis: phone_id: 'REPLACE_WITH_PHONE_ID' device_id: 'REPLACE_WITH_DEVICE_ID' device_password: 'REPLACE_WITH_DEVICE_PASSWORD' ```

{% configuration %} phone_id: description: The device's phone id. required: true type: string device_id: description: The device's id. required: true type: string device_password: description: The device's password. required: true type: string {% endconfiguration %}

{% linkable_title Switch State Attributes %}

Attribute Type Description Example
friendly_name string Defaults to the device's configured name. "Switcher Boiler"
auto_off_set string The auto shutdown time limit configured on the device. "01:30:00"
remaining_time string Time remaining to shutdown (auto or timer). "01:29:41"
electric_current float The electric current in amps. 12.5
current_power_w integer The current power used in watts. 2756

Please note, the following attributes are not eligible when the device is off and therefore will not appear as state attributes: `remaining_time`, `electric_current`, `current_power_w`.