Switch Component¶
The switch
domain includes all platforms that should show up like a
switch and can only be turned ON or OFF.
Base Switch Configuration¶
switch:
- platform: ...
name: "Switch Name"
icon: "mdi:restart"
Configuration variables:
name (Required, string): The name of the switch.
icon (Optional, icon): Manually set the icon to use for the sensor in the frontend.
inverted (Optional, boolean): Whether to invert the binary state, i.e. report ON states as OFF and vice versa. Defaults to
false
.internal (Optional, boolean): Mark this component as internal. Internal components will not be exposed to the frontend (like Home Assistant). Only specifying an
id
without aname
will implicitly set this to true.on_turn_on (Optional, Action): An automation to perform when the switch is turned on. See switch.on_turn_on / switch.on_turn_off Trigger.
on_turn_off (Optional, Action): An automation to perform when the switch is turned off. See switch.on_turn_on / switch.on_turn_off Trigger.
disabled_by_default (Optional, boolean): If true, then this entity should not be added to any client’s frontend, (usually Home Assistant) without the user manually enabling it (via the Home Assistant UI). Requires Home Assistant 2021.9 or newer. Defaults to
false
.entity_category (Optional, string): The category of the entity. See https://developers.home-assistant.io/docs/core/entity/#generic-properties for a list of available options. Requires Home Assistant 2021.11 or newer. Set to
""
to remove the default entity category.device_class (Optional, string): The device class for the switch. See https://developers.home-assistant.io/docs/core/entity/switch/#available-device-classes for a list of available options. Requires Home Assistant 2022.3 or newer.
If MQTT enabled, All other options from MQTT Component.
switch.toggle
Action¶
This action toggles a switch with the given ID when executed.
on_...:
then:
- switch.toggle: relay_1
switch.turn_on
Action¶
This action turns a switch with the given ID on when executed.
on_...:
then:
- switch.turn_on: relay_1
switch.turn_off
Action¶
This action turns a switch with the given ID off when executed.
on_...:
then:
- switch.turn_off: relay_1
switch.is_on
/ switch.is_off
Condition¶
This Condition checks if the given switch is ON (or OFF).
# In some trigger:
on_...:
if:
condition:
# Same syntax for is_off
switch.is_on: my_switch
lambda calls¶
From lambdas, you can call several methods on all switches to do some advanced stuff (see the full API Reference for more info).
publish_state()
: Manually cause the switch to publish a new state and store it internally. If it’s different from the last internal state, it’s additionally published to the frontend.// Within lambda, make the switch report a specific state id(my_switch).publish_state(false); id(my_switch).publish_state(true);
state
: Retrieve the current state of the switch.// Within lambda, get the switch state and conditionally do something if (id(my_switch).state) { // Switch is ON, do something here } else { // Switch is OFF, do something else here }
turn_off()
/turn_on()
: Manually turn the switch ON/OFF from code. Similar to theswitch.turn_on
andswitch.turn_off
actions, but can be used in complex lambda expressions.id(my_switch).turn_off(); id(my_switch).turn_on(); // Toggle the switch id(my_switch).toggle();
switch.on_turn_on
/ switch.on_turn_off
Trigger¶
This trigger is activated each time the switch is turned on. It becomes active right after the switch component has acknowledged the state (e.g. after it switched ON/OFF itself).
switch:
- platform: gpio # or any other platform
# ...
on_turn_on:
- logger.log: "Switch Turned On!"
on_turn_off:
- logger.log: "Switch Turned Off!"