mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-02 17:18:58 +00:00

As somebody pointed out on the forum, using different examples adds confusion. Updated both styles to use the same contents, so it's clearer what's going on.
2.7 KiB
2.7 KiB
layout, title, description, date, sidebar, comments, sharing, footer, redirect_from
layout | title | description | date | sidebar | comments | sharing | footer | redirect_from |
---|---|---|---|---|---|---|---|---|
page | Adding devices to Home Assistant | Steps to help you get your devices in Home Assistant. | 2015-09-19 09:40 | true | false | true | true | /getting-started/devices/ |
Home Assistant will be able to automatically discover many devices and services available on your network if you have the discovery component enabled (the default setting).
See the components overview page to find installation instructions for your devices and services. If you can't find support for your favorite device or service, consider adding support.
Classification for the available integrations:
- IoT class: Classifier for the device's behavior.
- Quality scale: Representation of the integration's quality.
Usually every entity needs its own entry in the configuration.yaml
file. There are two styles for multiple entries:
{% linkable_title Style 1: Collect every entity under the "parent" %}
sensor:
- platform: mqtt
state_topic: "home/bedroom/temperature"
name: "MQTT Sensor 1"
- platform: mqtt
state_topic: "home/kitchen/temperature"
name: "MQTT Sensor 2"
- platform: rest
resource: http://IP_ADDRESS/ENDPOINT
name: "Weather"
switch:
- platform: vera
- platform: tplink
host: IP_ADDRESS
{% linkable_title Style 2: List each device separately %}
You need to append numbers or strings to differentiate the entries, as in the example below. The appended number or string must be unique.
sensor bedroom:
platform: mqtt
state_topic: "home/bedroom/temperature"
name: "MQTT Sensor 1"
sensor kitchen:
platform: mqtt
state_topic: "home/kitchen/temperature"
name: "MQTT Sensor 2"
sensor weather:
platform: rest
resource: http://IP_ADDRESS/ENDPOINT
name: "Weather"
switch 1:
platform: vera
switch 2:
platform: tplink
host: IP_ADDRESS```
## {% linkable_title Grouping devices %}
Once you have several devices set up, it is time to organize them into groups.
Each group consists of a name and a list of entity IDs. Entity IDs can be retrieved from the web interface by using the Set State page in the Developer Tools (<img src='/images/screenshots/developer-tool-states-icon.png' alt='service developer tool icon' class="no-shadow" height="38" />).
```yaml
# Example configuration.yaml entry showing two styles
group:
living_room:
entities: light.table_lamp, switch.ac
bedroom:
entities:
- light.bedroom
- media_player.nexus_player
For more details please check the Group page.