mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-31 07:16:47 +00:00
23b0b57c08
* Rename frontmatter ha_qa_scale to ha_quality_scale to match codebase * Update all integrations quality scales (done by sync)
27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
---
|
|
title: Switch
|
|
description: Instructions on how to set up your switches with Home Assistant.
|
|
logo: home-assistant.png
|
|
ha_category:
|
|
- Switch
|
|
ha_release: 0.7
|
|
ha_quality_scale: internal
|
|
---
|
|
|
|
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 services `switch.turn_on`, `switch.turn_off`, and `switch.toggle` to control switches.
|
|
|
|
## Use the services
|
|
|
|
In the frontend open the sidebar. At the bottom, under **Developer Tools**, click **Services**. From the Service dropdown menu choose `switch.turn_on` or `switch.turn_off` from the list of available services. 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 **Service Data** field. Now hit **CALL SERVICE**.
|
|
|
|
```json
|
|
{"entity_id":"switch.livingroom_pin2"}
|
|
```
|
|
|
|
| Service data attribute | Optional | Description |
|
|
| ---------------------- | -------- | ----------- |
|
|
| `entity_id` | no | The entity ID of the switch to control. To target all switches, set the entity ID to `all`|
|