mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-01 07:46:49 +00:00
84 lines
2.1 KiB
Markdown
84 lines
2.1 KiB
Markdown
---
|
|
title: "Adding devices to Home Assistant"
|
|
description: "Steps to help you get your devices in Home Assistant."
|
|
---
|
|
|
|
Home Assistant will be able to automatically discover many devices and services
|
|
available on your network.
|
|
|
|
See the [integrations overview page](/integrations/) to find installation
|
|
instructions for your devices and services. Most integration can be
|
|
fully configured via the user interface these days; however, some older or
|
|
more complex integrations may need to be configured manually using YAML.
|
|
|
|
For some of these integrations, every entity needs its own entry in the
|
|
`configuration.yaml` file. There are two styles for multiple entity entries:
|
|
|
|
## Style 1: Collect every entity under the "parent"
|
|
|
|
```yaml
|
|
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
|
|
```
|
|
|
|
## Style 2: List each entity 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.
|
|
|
|
```yaml
|
|
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: vera
|
|
```
|
|
|
|
## Grouping entities
|
|
|
|
Once you have several entities 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
|
|
{% my developer_states title="States page in the Developer Tools" %}.
|
|
|
|
```yaml
|
|
# Example configuration.yaml entry
|
|
group:
|
|
living_room:
|
|
entities:
|
|
- light.table_lamp
|
|
- switch.ac
|
|
bedroom:
|
|
entities:
|
|
- light.bedroom
|
|
- media_player.nexus_player
|
|
```
|
|
|
|
For more details please check the [Group](/integrations/group/) page.
|