jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-23 11:26:48 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_integrations/switch.markdown
Franck Nijhof 2602651bdc
Rename Services to Actions in integrations: S (#33827) 
* Rename Services to Actions in integrations: S

* Update source/_integrations/scene.markdown

* Update source/_integrations/scene.markdown

* tweaks

---------

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
2024-07-17 07:40:05 +02:00

1.9 KiB
Raw Blame History

title, description, ha_category, ha_release, ha_quality_scale, ha_domain, ha_platforms, ha_codeowners, ha_integration_type, related
title description ha_category ha_release ha_quality_scale ha_domain ha_platforms ha_codeowners ha_integration_type related
Switch Instructions on how to set up your switches with Home Assistant.
Switch
0.7 internal switch
light
@home-assistant/core
entity
docs title
/docs/configuration/customizing-devices/ Customizing devices
docs title
/dashboards/ Dashboard

Keeps track which switches are in your environment, their state and allows you to control them.

  • Maintains a state per switch and a combined state all_switches.
  • Registers actions switch.turn_on, switch.turn_off, and switch.toggle to control switches.

{% include integrations/building_block_integration.md %}

Device class

{% include integrations/device_class_intro.md %}

The following device classes are supported for switches:

  • None: Generic switch. This is the default and doesn't need to be set.
  • outlet: A switch for a power outlet.
  • switch: A generic switch.

Using the actions

In the frontend open Settings. Select Developer tools, click Actions. From the Action dropdown menu choose switch.turn_on or switch.turn_off from the list of available actions. In the Entity dropdown menu choose or enter the entity ID you want to work with. This will enter something like the sample below into the data field. Now select Perform action.

{"entity_id":"switch.livingroom_pin2"}
Data attribute Optional Description
entity_id no String or list of strings that point at entity_ids of switches. To target all switches, set entity_id to all.