home-assistant.io/source/_integrations/switcher_kis.markdown
2021-06-27 18:22:19 +02:00

3.8 KiB

title, description, ha_category, ha_release, ha_iot_class, ha_codeowners, ha_domain, ha_platforms
title description ha_category ha_release ha_iot_class ha_codeowners ha_domain ha_platforms
Switcher Integrate Switcher devices.
Switch
0.93 Local Push
@tomerfi
@thecode
switcher_kis
sensor
switch

This Switcher integration allows you to control your Switcher Devices.

Supported devices:

  • Switcher Power Plug
  • Switcher Touch (from firmware 1.51)
  • Switcher V2 (Espressif chipset - from firmware 3.21)
  • Switcher V2 (Qualcomm chipset - from firmware 72.32)
  • Switcher V4

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

Sensors

Sensor Name Description Example
Auto Shutdown The auto shutdown time limit configured on the device 01:30:00
Remaining Time Time remaining to shutdown (auto or timer) 01:29:41
Electric Current The electric current in amps 12.5 A
Power Consumption The power consumption in watts 2756 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"

Service: switcher_kis.turn_on_with_timer

You can use the switcher_kis.turn_on_with_timer service to turn on the switcher device with timer.

Meaning the device will turn itself off when timer ends. Note: This does not affect the auto off timer.

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
timer_minutes Yes Integer containing timer minutes (valid range 1 to 150) 90