diff --git a/atom.xml b/atom.xml index 7e765f7826..1ec43173b5 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-12-20T22:29:18+00:00 + 2017-12-20T22:40:20+00:00 https://home-assistant.io/ @@ -122,6 +122,16 @@
  • Refactor hue to split bridge support from light platform (@andreacampi - #10691) (hue docs) (light.hue docs) (breaking change) (new-platform)
  • +

    If you need help…

    + +

    …don’t hesitate to use our very active forums or join us for a little chat. The release notes have comments enabled but it’s preferred if you use the former communication channels. Thanks.

    + +

    Reporting Issues

    + +

    Experiencing issues introduced by this release? Please report them in our issue tracker. Make sure to fill in all fields of the issue template.

    + + +

    Breaking Changes

    -

    If you need help…

    - -

    …don’t hesitate to use our very active forums or join us for a little chat. The release notes have comments enabled but it’s preferred if you use the former communication channels. Thanks.

    - -

    Reporting Issues

    - -

    Experiencing issues introduced by this release? Please report them in our issue tracker. Make sure to fill in all fields of the issue template.

    -

    All changes

    +

    If you need help…

    +

    …don’t hesitate to use our very active forums or join us for a little chat. The release notes have comments enabled but it’s preferred if you use the former communication channels. Thanks.

    +

    Reporting Issues

    +

    Experiencing issues introduced by this release? Please report them in our issue tracker. Make sure to fill in all fields of the issue template.

    +

    Breaking Changes

    -

    If you need help…

    -

    …don’t hesitate to use our very active forums or join us for a little chat. The release notes have comments enabled but it’s preferred if you use the former communication channels. Thanks.

    -

    Reporting Issues

    -

    Experiencing issues introduced by this release? Please report them in our issue tracker. Make sure to fill in all fields of the issue template.

    All changes

    -

    Breaking Changes

    -

    If you need help…

    …don’t hesitate to use our very active forums or join us for a little chat. The release notes have comments enabled but it’s preferred if you use the former communication channels. Thanks.

    Reporting Issues

    Experiencing issues introduced by this release? Please report them in our issue tracker. Make sure to fill in all fields of the issue template.

    -

    All changes

    - + Read on →
    diff --git a/components/alarm_control_panel.egardia/index.html b/components/alarm_control_panel.egardia/index.html index c794ee9a6a..f978cde0ad 100644 --- a/components/alarm_control_panel.egardia/index.html +++ b/components/alarm_control_panel.egardia/index.html @@ -76,7 +76,7 @@

    The egardia platform enables the ability to control an Egardia/Woonveilig control panel. These alarm panels are known under different brand names across the world, including Woonveilig in the Netherlands. This was tested on a Gate01 version of the Egardia/Woonveilig platform.

    You will need to know the IP of your alarm panel on your local network. Test if you can login to the panel by browsing to the IP address and log in using your Egardia/Woonveilig account.

    -

    To enable this, add the following lines to your configuration.yaml:

    +

    To enable this, add the following lines to your configuration.yaml file:

    # Example configuration.yaml entry
     alarm_control_panel:
       - platform: egardia
    diff --git a/components/alarm_control_panel.ialarm/index.html b/components/alarm_control_panel.ialarm/index.html
    index 74e5cc9e07..93ad7e203f 100644
    --- a/components/alarm_control_panel.ialarm/index.html
    +++ b/components/alarm_control_panel.ialarm/index.html
    @@ -76,7 +76,7 @@
       

    The ialarm platform provides connectivity with the Antifurto365 iAlarm alarm systems.

    This platform supports the following services: alarm_arm_away, alarm_arm_home and alarm_disarm.

    -

    To enable this, add the following lines to your configuration.yaml:

    +

    To enable this, add the following lines to your configuration.yaml file:

    # Example configuration.yaml entry
     alarm_control_panel:
       - platform: ialarm
    diff --git a/components/google_assistant/index.html b/components/google_assistant/index.html
    index 915709db64..fe5e3031d9 100644
    --- a/components/google_assistant/index.html
    +++ b/components/google_assistant/index.html
    @@ -74,15 +74,12 @@
         
       
       
    -

    -This is to provide you with voice control via Google Assistant (on your mobile or tablet) or a Google Home device. -

    -

    Google Assistant Docs

    +

    The google_assistant component allows you to control things via Google Assistant (on your mobile or tablet) or a Google Home device.

    The Google Assistant component requires a bit more setup than most due to the way Google requires Assistant Apps to be set up.

    To use Google Assistant your Home Assistant configuration has to be externally accessible, with a hostname and SSL certificate. If you haven’t already configured that you should do so before continuing.

    -

    Configuration

    +

    To enable this, add the following lines to your configuration.yaml file:

    # Example configuration.yaml entry
     google_assistant:
       project_id: someproject-2d0b8
    @@ -96,18 +93,15 @@ To use Google Assistant your Home Assistant configuration has to be externally a
         - group
     
    -

    Note: It’s very important that you use very long strings for client_id and access_token. Those are essentially the credentials to your Home Assistant instance. You can generate them with the following command:

    -

    cat /dev/urandom|fold -w 120|head -n 1|base64 -w 0|tr -dc '0-9A-Za-z'|cut -c -80

    -

    If you’re not using Linux, you can use sites such as this one to generate a random string (containing mixed case letters and numbers) of up to 80 characters.

    -

    Configuration Variables:

    +

    Configuration variables:

      -
    • expose_by_default (Optional): Expose devices in all supported domains by default.
    • -
    • project_id (Required): Project ID from the Google Developer console (looks like words-2ab12)
    • -
    • client_id (Required): A long random URL safe string (no spaces or special characters) that will be used for Implicit OAuth.
    • -
    • access_token (Required): Another different long random URL safe string.
    • -
    • agent_user_id (Optional): A string to identify the user, e.g., email address. If not provided, the component will generate one.
    • -
    • api_key (Optional): An API Key generated for the project from Google Console which allows you to update devices without unlinking and relinking an account (see setup below). If not provided then the request_sync service is not exposed.
    • -
    • exposed_domains (Optional): An array of Home Assistant domains to expose to Google Assistant. Options include: +
    • expose_by_default (Optional): Expose devices in all supported domains by default.
    • +
    • project_id (Required): Project ID from the Google Developer console (looks like words-2ab12)
    • +
    • client_id (Required): A long random URL safe string (no spaces or special characters) that will be used for Implicit OAuth.
    • +
    • access_token (Required): Another different long random URL safe string.
    • +
    • agent_user_id (Optional): A string to identify the user, e.g., email address. If not provided, the component will generate one.
    • +
    • api_key (Optional): An API Key generated for the project from Google Console which allows you to update devices without unlinking and relinking an account (see setup below). If not provided then the request_sync service is not exposed.
    • +
    • exposed_domains (Optional): An array of Home Assistant domains to expose to Google Assistant. Options include:
      • switch
      • light
      • @@ -121,6 +115,11 @@ To use Google Assistant your Home Assistant configuration has to be externally a
    +

    It’s very important that you use very long strings for client_id and access_token. Those are essentially the credentials to your Home Assistant instance. You can generate them with the following command:

    +
    $ cat /dev/urandom | fold -w 120 | head -n 1 | base64 -w 0 | tr -dc '0-9A-Za-z' | cut -c -80`
    +
    +
    +

    If you’re not using Linux, you can use sites such as this one to generate a random string (containing mixed case letters and numbers) of up to 80 characters.

    You can also customize your devices similar to other components by adding keys to entities:

    homeassistant:
       customize:
    @@ -136,12 +135,12 @@ To use Google Assistant your Home Assistant configuration has to be externally a
           google_assistant_type: light
     
    -

    Entity Customization Keys:

    +

    Entity Customization Keys:

      -
    • google_assistant: True exposes entity, false will hide it
    • -
    • google_assistant_name: Can be used to override the primary name of an entity. By default the friendly_name of an entity is used.
    • -
    • google_assistant_type: Can be used to override the domain/type of an entity. For example a switch can be treated as a light
    • -
    • aliases: Provides “nicknames” to Google Assistant. These function as alternate names for an entity that Assistant will understand when spoken.
    • +
    • google_assistant: True exposes entity, false will hide it.
    • +
    • google_assistant_name: Can be used to override the primary name of an entity. By default the friendly_name of an entity is used.
    • +
    • google_assistant_type: Can be used to override the domain/type of an entity. For example a switch can be treated as a light
    • +
    • aliases: Provides “nicknames” to Google Assistant. These function as alternate names for an entity that Assistant will understand when spoken.

    Setup

      diff --git a/sitemap.xml b/sitemap.xml index 755658d48b..4a937e5f3b 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -3826,7 +3826,7 @@ https://home-assistant.io/components/switch.hook/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/cookbook/automation_for_rainy_days/ @@ -4502,99 +4502,99 @@ https://home-assistant.io/docs/autostart/init.d/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/api/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/configuration/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/example_apps/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/installation/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/operation/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/reboot/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/running/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/tutorial/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/updating/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/windows/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/certificates/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/hadashboard/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/hass-configurator/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/ios/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/nginx/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/notebooks/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/scenegen/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/ecosystem/synology/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/tools/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/tools/dev-tools/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/tools/hass/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/docs/tools/scripts/ -2017-12-20T22:29:18+00:00 +2017-12-20T22:40:20+00:00 https://home-assistant.io/faq/after-upgrading/ @@ -5726,62 +5726,62 @@ https://home-assistant.io/demo/frontend.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/index.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00 https://home-assistant.io/static/mdi-demo.html -2017-12-20T22:28:34+00:00 +2017-12-20T22:39:41+00:00