Rephrase the multiple entries part

This commit is contained in:
Fabian Affolter 2015-11-23 15:41:10 +01:00
parent 842fe6a784
commit e005f5b1c4

View File

@ -11,13 +11,47 @@ footer: true
Home Assistant will be able to automatically discover and configure any Google Chromecasts, Netgear routers, Belkin WeMo switches, Philips Hue bridges and Sonos speakers in your network if you have [the discovery component]({{site_root}}/components/discovery/) enabled (which is by default).
See the [components overview page](/components/) to find installation instructions for your devices and services. Many components use the `sensor` platform. Sensors need to be added into the `configuration.yaml` as `sensor:`, `sensor 2:`, `sensor 3:`, etc. There should not be gaps in the sequence or your sensors might not load correctly.
See the [components overview page](/components/) to find installation instructions for your devices and services. If you can't find support for your favorite device or service, [consider adding support](/developers/add_new_platform/).
<p class='note'>
Most components that support multiple entries within the <code>configuration.yaml</code> follow the <code>component:</code>, <code>component 2:</code> format.
</p>
Usually every entity needs its own entry in the `configuration.yaml` file. There are two kind of styles for multiple entries:
If you can't find support for your favorite device or service, [consider adding support](/developers/add_new_platform/)
#### {% linkable_title 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/bedroom/temperature"
name: "MQTT Sensor 2"
- platform: rest
resource: http://IP_ADDRESS/ENDPOINT
switch:
- platform: vera
```
#### {% linkable_title Style 2 %}
If you prefer to place your entries somewhere in the `configuration.yaml` file then you just choose this style. There should not be gaps in the sequence when you use numbers or your entities might not load correctly. Instead of numbers you are free to use strings (like `media_player livingroom:` or `media_player kitchen:`) to differentiate the entries as long as the appended strings are unique.
```yaml
media_player 1:
platform: mpd
server: IP_ADDRESS
media_player 2:
platform: plex
camera:
platform: generic
media_player 3:
platform: sonos
```
### {% linkable_title Grouping devices %}