diff --git a/source/_components/binary_sensor.nest.markdown b/source/_components/binary_sensor.nest.markdown index f9d8e0af181..fd6a92396c6 100644 --- a/source/_components/binary_sensor.nest.markdown +++ b/source/_components/binary_sensor.nest.markdown @@ -13,13 +13,13 @@ ha_release: pre 0.7 --- -The `nest` binary sensor platform let you monitor various states of a thermostat from [Nest](https://nest.com). +The `nest` binary sensor platform lets you monitor various states of your [Nest](https://nest.com) devices.

-You must have the [Nest component](/components/nest/) configured to use these sensors. A nest thermostat can provide any of the below sensors. A nest protect can only report the 'online' condition. +You must have the [Nest component](/components/nest/) configured to use these sensors. The `nest` binary sensor will automatically be setup when you do.

-To set it up, add the following information to your `configuration.yaml` file: +To customize which binary sensors are enabled, you can add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -27,20 +27,35 @@ binary_sensor: - platform: nest monitored_conditions: - 'fan' - - 'hvac_ac_state' + - 'is_using_emergency_heat' ``` +If you leave `monitored_conditions` blank, all sensors that are available for your devices will be used. + Configuration variables: -- **monitored_conditions** array (*Required*): States to monitor. - - 'fan' - - 'hvac_ac_state' - - 'hvac_aux_heater_state' - - 'hvac_heat_x2_state' - - 'hvac_heat_x3_state' - - 'hvac_alt_heat_state' - - 'hvac_alt_heat_x2_state' - - 'hvac_emer_heat_state' - - 'online' -- **scan_interval** (*Optional*): Interval in seconds to scan. +- **monitored_conditions** array (*Optional*): States to monitor. + - online + - fan + - is\_using\_emergency\_heat + - is\_locked + - has\_leaf + - motion\_detected + - person\_detected + - sound\_detected +The following conditions are available by device: + +- Nest Thermostat: + - online + - fan + - is\_using\_emergency\_heat + - is\_locked + - has\_leaf +- Nest Protect: + - online +- Nest Camera: + - online + - motion\_detected + - person\_detected + - sound\_detected diff --git a/source/_components/camera.nest.markdown b/source/_components/camera.nest.markdown index ccccb5780d9..efb79e67175 100644 --- a/source/_components/camera.nest.markdown +++ b/source/_components/camera.nest.markdown @@ -15,13 +15,5 @@ ha_release: 0.34 The `nest` platform allows you to watch the live stream of your [Nest](https://nest.com/camera/meet-nest-cam/) camera in Home Assistant.

-You must have the [Nest component](/components/nest/) configured to use those thermostats. +You must have the [Nest component](/components/nest/) configured to use this camera. The `nest` camera will automatically be setup when you do.

- -To set it up, add the following information to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -camera: - - platform: nest -``` diff --git a/source/_components/climate.nest.markdown b/source/_components/climate.nest.markdown index 8c3e2f08190..ded09ffbe4b 100644 --- a/source/_components/climate.nest.markdown +++ b/source/_components/climate.nest.markdown @@ -15,17 +15,9 @@ ha_category: Climate The `nest` climate platform let you control a thermostat from [Nest](https://nest.com).

-You must have the [Nest component](/components/nest/) configured to use those thermostats. +You must have the [Nest component](/components/nest/) configured to use these sensors. The `nest` climate component will automatically be setup when you do.

-To set it up, add the following information to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -climate: - - platform: nest -``` -

diff --git a/source/_components/nest.markdown b/source/_components/nest.markdown index 5327e21b96e..482e42013eb 100644 --- a/source/_components/nest.markdown +++ b/source/_components/nest.markdown @@ -16,21 +16,21 @@ The Nest component is the main component to integrate all [Nest](https://nest.co ### {% linkable_title Setting up developer account %} -1. Log into [https://developers.nest.com/](https://developers.nest.com/) -2. Fill in account details - - The compnay details can be any made up information. +1. Visit [Nest Developers](https://developers.nest.com/), and sign in. Create an account if you don't have one already. +2. Fill in account details: + - The "Company Information" can be anything. We recommend using your name. 3. Submit changes -4. Click "[Products](https://developers.nest.com/products)" at top of page -5. Click "[Create New Product](https://developers.nest.com/products/new)" to start a new api client -6. Fill in details - - Product name must be unique. I recommend [email] - Home Assistant. - - The description, users, urls can all be anything you want +4. Click "[Products](https://developers.nest.com/products)" at top of page. +5. Click "[Create New Product](https://developers.nest.com/products/new)" +6. Fill in details: + - Product name must be unique. We recommend [email] - Home Assistant. + - The description, users, urls can all be anything you want. 7. For permissions check every box and if it's an option select the read/write option. - The description requires a specific format to be accepted. - Use "[Home Assistant] [Edit] [For Home Automation]" as the description as it is not super important. 8. Click "Create Product" -9. Once the new product page opens the "Product ID" and "Product Secret" are located on the right side. -10. After these configs are updated and Home Assistant is started a configurator will pop up asking you to log in and copy a authorization code into Home Assistant. +9. Once the new product page opens the "Product ID" and "Product Secret" are located on the right side. These will be used as `client_id` and `client_secret` below. +10. Once Home Assistant is started, a configurator will pop up asking you to log into your Nest account and copy a PIN code into Home Assistant. ### {% linkable_title Configuration %} diff --git a/source/_components/sensor.nest.markdown b/source/_components/sensor.nest.markdown index 99bd387a450..8cebddbd5d6 100644 --- a/source/_components/sensor.nest.markdown +++ b/source/_components/sensor.nest.markdown @@ -13,13 +13,13 @@ ha_release: pre 0.7 --- -The `nest` sensor platform let you monitor sensors connected to your [Nest](https://nest.com) thermostat and/or your Nest Protect Smoke Alarm. +The `nest` sensor platform lets you monitor sensors connected to your [Nest](https://nest.com) devices.

-You must have the [Nest component](/components/nest/) configured to use those sensors. +You must have the [Nest component](/components/nest/) configured to use these sensors. The `nest` binary sensor will automatically be setup when you do.

-To set it up, add the following information to your `configuration.yaml` file: +To customize which sensors are enabled, you can add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry @@ -30,29 +30,21 @@ sensor: - 'target' ``` +If you leave `monitored_conditions` blank, all sensors that are available for your devices will be included. + Configuration variables: -- **monitored_conditions** array (*Required*): States to monitor. +- **monitored_conditions** array (*Optional*): States to monitor. -The following conditions can be monitored with a Nest Thermostat or Protect. - - 'battery_level' +The following conditions are available by device: -The following conditions can be monitored with a Nest Thermostat only. - - - 'temperature' - - 'target' - - 'humidity' - - 'operation_mode' - - 'last_ip' - - 'local_ip' - - 'last_connection' - - 'weather_condition' - - 'weather_temperature' - - 'weather_humidity' - - 'wind_speed' - - 'wind_direction' - -The following conditions can be monitored with a Nest Protect only. - - 'co_status' - - 'smoke_status' +- Nest Thermostat: + - humidity + - operation\_mode + - temperature + - target +- Nest Protect: + - co\_status + - smoke\_status +- Nest Camera: none