Switcher

    The 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
    • Switcher Mini
    • Switcher Breeze
    • Switcher Runner
    • Switcher Runner S11
    • Switcher Runner S12
    • Switcher Light SL01
    • Switcher Light SL01 Mini
    • Switcher Light SL02
    • Switcher Light SL02 Mini
    • Switcher Light SL03
    • Switcher Heater

    Devices that require a token:

    • Switcher Runner S11
    • Switcher Runner S12
    • Switcher Light SL01
    • Switcher Light SL01 Mini
    • Switcher Light SL02
    • Switcher Light SL02 Mini
    • Switcher Light SL03
    • Switcher Heater

    If you completed the integration setup but are still unable to control the device, please make sure your device's firmware is up-to-date.

    Prerequisites

    Before the integration can find a device, you need to connect it to your network using the Switcher app.

    To enhance security, certain Switcher devices require a token for operation. In order to integrate your token-based Switcher devices with Home Assistant, you'll need the following information:

    • The username of your Switcher Account: To find the username, open the Switcher app.

    • Local control key token: To find the local control key token, browse to the Switcher GetKey API, enter your Switcher account username (which is an email address), and press Send Me The Code.

      The token will be sent to you by email. It will look something like this: zvVvd7JxtN7CgvkD1Psujw==

    配置

    此集成可通过 UI 配置。前往 设置 > 设备与服务 添加。

    Buttons

    For Switcher Breeze the integration provides the following buttons:

    • For devices that are also controlled in other ways or often go out of sync with Switcher Breeze, there are Assume on & Assume off buttons which you can use to can tell Switcher Breeze if your device is currently running or not without sending a new command to the device.

    • For devices which do not support swing status for the vertical swing, the integration provides separate Vertical swing on & Vertical swing off buttons.

    Covers

    For Switcher cover control devices (Switcher Runner, Switcher Runner S11, Switcher Runner S12) the integration allows you to control its covers open/close state, set specific covers position and get information about the cover direction (UP/DOWN/STOP).

    Lights

    For Switcher light control devices (Switcher Runner S11, Switcher Runner S12, and Switcher Lights), the integration allows you to control its lights on/off state.

    Sensors

    For Switcher power control devices (Switcher Power Plug, Switcher Touch, Switcher V2/V4, Switcher Heater) the integration provides the following sensors:

    Sensor NameDescriptionExample
    Auto Shutdown*The auto shutdown time limit configured on the device01:30:00
    Remaining Time*Time remaining to shutdown (auto or timer)01:29:41
    Electric CurrentThe electric current in amps12.5 A
    Power ConsumptionThe power consumption in watts2756 W

    *Currently not supported for Switcher Power Plug

    For Switcher Breeze the integration provides the following sensor:

    Sensor NameDescriptionExample
    Current temperatureThe current temperature in celsius25.0 °C

    Switches

    For Switcher cover control devices (Switcher Runner, Switcher Runner S11, Switcher Runner S12), the integration allows you to control its child lock state; ON means locked, and OFF means unlocked.

    Actions

    For Switcher power control devices (Switcher Touch, Switcher V2/V4) the integration provides the following sensors:

    Action: Set auto off

    The switcher_kis.set_auto_off action sets the auto-off configuration setting for the device.

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

    Data attributeMandatoryDescriptionExample
    entity_idYesName of the entity id associated with the integration, used for permission validationswitch.switcher_kis_boiler
    auto_offYesTime period string containing hours and minutes"02:30"

    Action: Turn on with timer

    The switcher_kis.turn_on_with_timer action turns on the switcher device with a timer.

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

    Data attributeMandatoryDescriptionExample
    entity_idYesName of the entity id associated with the integration, used for permission validationswitch.switcher_kis_boiler
    timer_minutesYesInteger containing timer minutes (valid range 1 to 150)90

    Notes

    Make sure that Home Assistant host's firewall allows incoming traffic on UDP ports 10002, 10003, 20002 & 20003 and outgoing connections to Switcher device(s) on TCP ports 9957 & 10000. If Home Assistant and the Switcher device(s) are not on the same network, you will also need to have their traffic properly forwarded between the two networks.

    Removing the integration

    This integration follows standard integration removal. No extra steps are required.

    To remove an integration instance from Home Assistant

    1. Go to Settings > Devices & services and select the integration card.
    2. From the list of devices, select the integration instance you want to remove.
    3. Next to the entry, select the three-dot menu. Then, select Delete.