Eight Sleep docs (home-assistant#2499)

mezz64 · fabaff · commit 54ca6ebc5c24 · 2017-05-02T18:04:41.000+02:00
diff --git a/source/_components/binary_sensor.eight_sleep.markdown b/source/_components/binary_sensor.eight_sleep.markdown
@@ -0,0 +1,18 @@
+---
+layout: page
+title: "Eight Sleep Binary Sensor"
+description: "Instructions how to integrate binary motion sensors for Eight Sleep within Home Assistant."
+date: 2017-04-24 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: eight_sleep.png
+ha_category: Binary Sensor
+ha_release: "0.44"
+---
+
+
+The `eight_sleep` binary sensor platform lets you observe the presence state of a [Eight Sleep](https://eightsleep.com/) cover/mattress through Home Assistant.
+
+Devices will be configured automatically. Please refer to the [component](/components/eight_sleep/) configuration on how to setup.
diff --git a/source/_components/eight_sleep.markdown b/source/_components/eight_sleep.markdown
@@ -0,0 +1,67 @@
+---
+layout: page
+title: "Eight Sleep"
+description: "Interface an Eight Sleep smart cover or mattress to Home Assistant"
+date: 2017-04-24 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: eight_sleep.png
+ha_category: Hub
+ha_release: "0.44"
+---
+
+The `eight_sleep` component allows Home Assistant to fetch data from your [Eight Sleep](https://eightsleep.com/) smart cover or mattress.
+
+It's setup utilizing 'Sensor' components to convey the current state of your bed and results of your sleep sessions and a 'Binary Sensor' component to indicate your presence in the bed.  A service is also provided to set the heating level and duration of the bed.
+
+To get started add the following information to your `configuration.yaml` file:
+
+```yaml
+# Example configuration.yaml entry
+eight_sleep:
+    username: "user@email.com"
+    password: "password"
+```
+
+Configuration variables:
+
+- **username** (*Required*): The email address associated with your Eight Sleep account.
+- **password** (*Required*): The password associated with your Eight Sleep account.
+- **partner** (*Optional*): Default is False. Defines if you'd like to fetch data for both sides of the bed.
+
+### {% linkable_title Supported features %}
+
+Sensors:
+
+- eight_left/right_bed_state
+- eight_left/right_sleep_session
+- eight_left/right_previous_sleep_session
+
+Binary Sensors:
+
+- eight_left/right_bed_presence
+
+### {% linkable_title Service `heat_set` %}
+
+You can use the service eight_sleep/heat_set to adjust the target heating level and heating duration of your bed.
+
+| Service data attribute | Optional | Description |
+| ---------------------- | -------- | ----------- |
+| `entity_id` | no | Entity ID of bed state to adjust.
+| `target` | no | Target heating level from 0-100.
+| `duration` | no | Duration to heat at the target level in seconds.
+
+Script Example:
+
+```yaml
+script:
+  bed_set_heat:
+    sequence:
+      - service: eight_sleep.heat_set
+        data:
+          entity_id: "sensor.eight_left_bed_state"
+          target: 35
+          duration: 3600
+``` 
diff --git a/source/_components/sensor.eight_sleep.markdown b/source/_components/sensor.eight_sleep.markdown
@@ -0,0 +1,18 @@
+---
+layout: page
+title: "Eight Sleep Sensor"
+description: "Instructions how to integrate sensors for Eight Sleep within Home Assistant."
+date: 2017-04-24 00:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: eight_sleep.png
+ha_category: Sensor
+ha_release: "0.44"
+---
+
+
+The `eight_sleep` sensor platform lets you observe states of [Eight Sleep](https://eightsleep.com/) sensors through Home Assistant. This includes bed state and results of the current and previous sleep sessions.
+
+Devices will be configured automatically. Please refer to the [component](/components/eight_sleep/) configuration on how to setup.
diff --git a/source/images/supported_brands/eight_sleep.png b/source/images/supported_brands/eight_sleep.png
