Switcher
The Switcher integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] 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
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. 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==
Configuration
To add the Switcher hub to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Switcher.
-
Follow the instructions on screen to complete the setup.
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 offbuttons 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 offbuttons.
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 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 |
*Currently not supported for Switcher Power Plug
For Switcher Breeze the integration provides the following sensor:
| Sensor Name | Description | Example |
|---|---|---|
Current temperature |
The current temperature in celsius | 25.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.
List of actions
The Switcher integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.
-
Set auto-off (
switcher_kis.set_auto_off) Sets the auto-off time for a Switcher power device. -
Turn on with timer (
switcher_kis.turn_on_with_timer) Turns on a Switcher power device for a set number of minutes.
For an overview of every action across all integrations, see the actions reference.
Data updates
Switcher devices push their state to Home Assistant. Each device broadcasts its current status on the local network every few seconds, and the integration updates the entities as soon as a broadcast is received. There is no polling.
If Home Assistant does not receive a broadcast from a device for 30 seconds, the device’s entities are marked as unavailable. They become available again as soon as the next broadcast is received.
Troubleshooting
Devices are not discovered or become unavailable
The integration discovers devices and receives their state from UDP broadcasts sent by the devices on the local network, and sends commands to the devices over TCP.
- Make sure the device is connected to your network using the Switcher app.
- Make sure the Home Assistant host’s firewall allows incoming traffic on UDP ports 10002, 10003, 20002 & 20003 and outgoing connections to the Switcher device(s) on TCP ports 9957 & 10000.
- Broadcasts do not cross network boundaries. If Home Assistant and the Switcher device(s) are not on the same network (for example, on different VLANs or subnets), you need to forward the broadcast traffic between the two networks.
Unable to control the device
If you completed the integration setup but are still unable to control the device, make sure your device’s firmware is up-to-date.
Home Assistant asks to re-authenticate
When a device that requires a token is discovered and no token is configured, Home Assistant asks you to re-authenticate the integration. Enter your Switcher account username and the local control key token, as described in the prerequisites.
Removing the integration
This integration follows standard integration removal. No extra steps are required.
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- Next to the entry you want to remove, select the three dots
menu. Then, select Delete. - Depending on the integration, the entries are listed under one of the following headings:
- Devices
- Hubs
- Services
- Integration entries
- Depending on the integration, the entries are listed under one of the following headings:
- To confirm, select Delete.
- Home Assistant also deletes the devices and entities of the entry.
- If Home Assistant asks you to restart, restart Home Assistant.
- If Home Assistant asks whether to also delete the application credentials, select Remove or Keep.
- If you keep them, Home Assistant uses them automatically when you add the integration again.
- To delete them later, refer to Deleting application credentials.