home-assistant.github.io/source/_docs/configuration/devices.markdown
Fabian Affolter 481320128f Re-organisation Documentation and Getting started (#2055)
* Split MQTT documentation

* Add more details

* Move content to /docs

* Enable sidebar

* Move content to /docs

* Enable sidebar

* Move content

* Update links

* Remove wizard stuff

* Enable sidebar

* Minor changes

* Move MQTT parts to /docs

* update links

* Update links and sync content

* Fix link

* Enable sidebar

* Remove navigation

* Remove navigation and other minor updates

* Update links

* Add overview page

* Make title linkable

* Update

* Plit content

* Update links

* Rearrange content

* New getting-started section

* Add icons for docs

* Update for new structure

* Update for new structure

* Add docs navigation

* Add docs overview page

* Remove ecosystem navigation

* Add docs and remove other collections

* Move ecosystem to docs

* Remove duplicate files

* Re-add ecosystem overview

* Move to ecosystem

* Fix permission

* Update navigation

* Remove collection

* Move overview to right folder

* Move mqtt to upper level

* Move notebook to ecosystem

* Remove un-used files

* Add one more rectangle for iOS

* Move two parts back from docs and rename Run step

* Remove colon

* update getting-started section

* Add redirect

* Update

* Update navigation
2017-02-23 11:09:41 +01:00

2.1 KiB

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.

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

switch:
  - platform: vera

{% 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.

media_player livingroom:
  platform: mpd
  server: IP_ADDRESS

media_player kitchen:
  platform: plex

camera 1:
  platform: generic

camera 2:
  platform: mjpeg

{% 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 (<>).

# Example configuration.yaml entry showing two styles
group:
  living_room: light.table_lamp, switch.ac
  bedroom:
    - light.bedroom
    - media_player.nexus_player

For more details please check the Group page.