home-assistant.io/source/_components/switcher_kis.markdown
Franck Nijhof c464056402
Making our website faster, cleaner and prettier (#9853)
* 🔥 Removes octopress.js

* 🔥 Removes use of root_url var

* 🔥 Removes Octopress generator reference from feed

* 🔥 Removes delicious support

* 🔥 Removes support for Pinboard

* 🔥 Removes support for Disqus

* 🔥 Removes support for Google Plus

* ↩️ Migrate custom after_footer to default template

* ↩️ Migrate custom footer to default template

* ↩️ Migrate custom header to default template

* 🔥 Removes unused template files

* 🚀 Places time to read directly in post template

* 🚀 Removes unneeded capture from archive_post.html template

* 🔥 🚀 Removes unused, but heaving sorting call in component page

* 🚀 Merged javascripts into a single file

* 🔥 Removes more uses of root_url

* 🚀 Removal of unneeded captures from head

* 🔥 🚀 Removal of expensive liquid HTML compressor

* 🔥 Removes unneeded templates

* 🚀 Replaces kramdown with GitHub's CommonMark 🚀

* 💄 Adds Prism code syntax highlighting

*  Adds support for redirect in Netlify

* ↩️ 🔥 Let Netlify handle all developer doc redirects

* ✏️ Fixes typo in redirects file: Netify -> Netlify

* 🔥 Removes unused .themes folder

* 🔥 Removes unused aside.html template

* 🔥 Removes Disqus config leftover

* 🔥 Removes rouge highlighter config

* 🔥 Removes Octopress 🎉

* 💄 Adjust code block font size and adds soft wraps

* 💄 Adds styling for inline code blocks

* 💄 Improve styling of note/warning/info boxes + div support

* 🔨 Rewrites all note/warning/info boxes
2019-07-15 22:17:54 +02:00

3.5 KiB

title description logo ha_category redirect_from ha_release ha_iot_class
Switcher Controlling your Switcher V2 Water Heater. switcher_boiler.png
Switch
/components/switch.switcher_kis
0.93 Local Push

This Switcher integration 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 integration is based on that script, please do not upgrade to version 3.0 until this issue is resolved. You can follow the issue here.

```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 %}

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.

Services

Service: switcher_kis.set_auto_off

You can use the switcher_kis.set_auto_off service to set the auto-off configuration setting for the device.

Meaning the device will turn itself off when reaching the auto-off configuration limit.

Service Field Mandatory Description Example
entity_id Yes Name of the entity id associated with the integration, used for permission validation. switch.switcher_kis_boiler
auto_off Yes Time period string containing hours and minutes. "02:30"