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 · 2017-02-23 11:09:41 +01:00 · 481320128f
commit 481320128f
parent 0677895b5b
138 changed files with 1309 additions and 909 deletions
--- a/source/_docs/configuration/devices.markdown
+++ b/source/_docs/configuration/devices.markdown
@ -0,0 +1,70 @@
+---
+layout: page
+title: "Adding devices to Home Assistant"
+description: "Steps to help you get your devices in Home Assistant."
+date: 2015-09-19 09:40
+sidebar: true
+comments: false
+sharing: true
+footer: true
+redirect_from: /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](/components/discovery/) enabled (the default setting).
+
+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/).
+
+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" %}
+
+```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
+
+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.
+
+```yaml
+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 (![<>](https://cdn.rawgit.com/Templarian/MaterialDesign/master/icons/svg/code-tags.svg)).
+
+```yaml
+# 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](/components/group/) page.
+