From cf82b1bb9ce1cc0a899084368e570a0a88a689d0 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 8 Oct 2016 21:15:50 +0200 Subject: [PATCH 01/84] Details about the web server (#1149) --- source/_cookbook/webserver_details.markdown | 39 +++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 source/_cookbook/webserver_details.markdown diff --git a/source/_cookbook/webserver_details.markdown b/source/_cookbook/webserver_details.markdown new file mode 100644 index 00000000000..1a928f881f8 --- /dev/null +++ b/source/_cookbook/webserver_details.markdown @@ -0,0 +1,39 @@ +--- +layout: page +title: "Details about the web server" +description: "Use nmap to scan your Home Assistant instance" +date: 2016-10-06 08:00 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: Infrastructure +--- + +It was only a matter of time till the first queries for tools like [https://www.shodan.io](https://www.shodan.io/search?query=Home+Assistant) to search for Home Assistant instances showed up. + +To get an idea about how your Home Assistant instance looks like for network scanner, you can use `nmap`. The `nmap` tool is already available if you are using the [nmap device tracker](/components/device_tracker/). + +```yaml +$ nmap -sV -p 8123 --script=http-title,http-headers 192.168.1.3 + +Starting Nmap 7.12 ( https://nmap.org ) at 2016-10-06 10:01 CEST +Nmap scan report for 192.168.1.3 (192.168.1.3) +Host is up (0.00011s latency). +PORT STATE SERVICE VERSION +8123/tcp open http CherryPy wsgiserver +| http-headers: +| Content-Type: text/html; charset=utf-8 +| Content-Length: 4309 +| Connection: close +| Date: Thu, 06 Oct 2016 08:01:31 GMT +| Server: Home Assistant +| +|_ (Request type: GET) +|_http-server-header: Home Assistant +|_http-title: Home Assistant + +Service detection performed. Please report any incorrect results at https://nmap.org/submit/ . +Nmap done: 1 IP address (1 host up) scanned in 6.70 seconds +``` + From 974ae8e03139d2600a16e7048e33190e4a84daab Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 8 Oct 2016 21:15:57 +0200 Subject: [PATCH 02/84] Add initial doc to work with a self-signed cert (#1150) --- .../tls_self_signed_certificate.markdown | 34 +++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 source/_cookbook/tls_self_signed_certificate.markdown diff --git a/source/_cookbook/tls_self_signed_certificate.markdown b/source/_cookbook/tls_self_signed_certificate.markdown new file mode 100644 index 00000000000..cd2748a702d --- /dev/null +++ b/source/_cookbook/tls_self_signed_certificate.markdown @@ -0,0 +1,34 @@ +--- +layout: page +title: "Self-signed certificate for SSL/TLS" +description: "Configure a self-signed certificate to use with Home Assistant" +date: 2016-10-06 08:00 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: Infrastructure +--- + +If your Home Assistant instance is only accessible from your local network you can still protect the communication between your browsers and the frontend with SSL/TLS. [Let's encrypt](blog/2015/12/13/setup-encryption-using-lets-encrypt/) will only work if you have a DNS entry and remote access is allowed. The solution is to use a self-signed certificate. As you most likely don't have a certification authority (CA) your browser will conplain about the security. If you have a CA then this will not be an issue. + +To create locally a certificate you need the [OpenSSL](https://www.openssl.org/) command-line tool. + +Change to your Home Assistant [configuration directory](/getting-started/configuration/) like `~/.homeassistant`. This will make it easier to backup your certificate and the key. Run the command shown below. + +```bash +$ openssl req -new -x509 -sha256 -newkey rsa:4096 -nodes -keyout privkey.pem -days 730 -out fullchain.pem +``` + +For details about the parameters, please check the OpenSSL documentation. Provide the requested information during the generation process. At the end you will have two files called `privkey.pem` and `fullchain.pem`. The key and the certificate. + +Update the `http:` entry in your `configuration.yaml` file and let it point to your created files. + +```yaml +http: + api_password: YOUR_SECRET_PASSWORD + ssl_certificate: /home/fab/.homeassistant/fullchain.pem + ssl_key: /home/fab/.homeassistant/privkey.pem +``` + +A tutorial "[Working with SSL Certificates, Private Keys and CSRs](https://www.digitalocean.com/community/tutorials/openssl-essentials-working-with-ssl-certificates-private-keys-and-csrs)" could give you some insight about special cases. From 59568972ab826db5c925f5a54e6acc53d9413ae0 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 8 Oct 2016 21:20:53 +0200 Subject: [PATCH 03/84] Check points for securing Home Assistant installations (#1151) * Add check points * Add check points * Fix link * Grammar and style fixes --- .../asides/getting_started_navigation.html | 1 + source/getting-started/securing.markdown | 28 +++++++++++++++++++ 2 files changed, 29 insertions(+) create mode 100644 source/getting-started/securing.markdown diff --git a/source/_includes/asides/getting_started_navigation.html b/source/_includes/asides/getting_started_navigation.html index dedfbe4d3ba..672f5816d56 100644 --- a/source/_includes/asides/getting_started_navigation.html +++ b/source/_includes/asides/getting_started_navigation.html @@ -27,6 +27,7 @@
  • {% active_link /getting-started/customizing-devices/ Customizing devices and services %}
  • {% active_link /getting-started/presence-detection/ Presence Detection %}
  • {% active_link /getting-started/troubleshooting-configuration/ Troubleshooting %}
    • +
  • {% active_link /getting-started/securing/ Security Check Points %}
  • diff --git a/source/getting-started/securing.markdown b/source/getting-started/securing.markdown new file mode 100644 index 00000000000..6ada6bca125 --- /dev/null +++ b/source/getting-started/securing.markdown @@ -0,0 +1,28 @@ +--- +layout: page +title: "Securing" +description: "Instructions how to secure your Home Assistant installation." +date: 2016-10-06 06:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + +One of the reasons to use Home Assistant is that it's not depending on cloud services. Even if you are only using Home Assistant in your local network, you should consider to secure your instance. + +### {% linkable_title Checklist %} + +- [Protect your web interface with a password](https://home-assistant.io/getting-started/basic/#password-protecting-the-web-interface) +- Secure your host. Sources could be [Red Hat Enterprise Linux 7 Security Guide](https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/pdf/Security_Guide/Red_Hat_Enterprise_Linux-7-Security_Guide-en-US.pdf), [CIS Red Hat Enterprise Linux 7 Benchmark](https://benchmarks.cisecurity.org/tools2/linux/CIS_Red_Hat_Enterprise_Linux_7_Benchmark_v1.0.0.pdf), or the [Securing Debian Manual](https://www.debian.org/doc/manuals/securing-debian-howto/index.en.html). +- Restrict network access to your device. Set `PermitRootLogin no` in your sshd config (usually `/etc/ssh/sshd_config`) and to use keys for authentication instead of passwords. +- Don't run Home Assistant as root. +- Keep your [secrets](/topics/secrets/) safe. + +Additional points if you want to allow remote access: + +- Protect your communication with [TLS](blog/2015/12/13/setup-encryption-using-lets-encrypt/) +- Protect your communication with [Tor](/cookbook/tor_configuration/) +- Use a [proxy](/cookbook/apache_configuration/) + + From 9cd416de0a619bcb6e720aa85069573fa2bd43c3 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 8 Oct 2016 21:54:40 +0200 Subject: [PATCH 04/84] Add name which is an optional variable --- source/_components/sensor.darksky.markdown | 57 ++++++++++--------- .../sensor.openweathermap.markdown | 1 + source/_components/sensor.yweather.markdown | 2 +- 3 files changed, 31 insertions(+), 29 deletions(-) diff --git a/source/_components/sensor.darksky.markdown b/source/_components/sensor.darksky.markdown index bfd2d19811b..e347c56df71 100644 --- a/source/_components/sensor.darksky.markdown +++ b/source/_components/sensor.darksky.markdown @@ -26,39 +26,40 @@ To add Dark Sky to your installation, add the following to your `configuration.y ```yaml # Example configuration.yaml entry sensor: - platform: darksky - api_key: YOUR_APP_KEY - monitored_conditions: - - summary - - icon - - nearest_storm_distance - - nearest_storm_bearing - - precip_type - - precip_intensity - - precip_probability - - temperature - - apparent_temperature - - dew_point - - wind_speed - - wind_bearing - - cloud_cover - - humidity - - pressure - - visibility - - ozone - - minutely_summary - - hourly_summary - - daily_summary - - temperature_max - - temperature_min - - apparent_temperature_max - - apparent_temperature_min - - precip_intensity_max + - platform: darksky + api_key: YOUR_APP_KEY + monitored_conditions: + - summary + - icon + - nearest_storm_distance + - nearest_storm_bearing + - precip_type + - precip_intensity + - precip_probability + - temperature + - apparent_temperature + - dew_point + - wind_speed + - wind_bearing + - cloud_cover + - humidity + - pressure + - visibility + - ozone + - minutely_summary + - hourly_summary + - daily_summary + - temperature_max + - temperature_min + - apparent_temperature_max + - apparent_temperature_min + - precip_intensity_max ``` Configuration variables: - **api_key** (*Required*): Your API key. +- **name** (*Optional*): Additional name for the sensors. Default to platform name. - **monitored_conditions** array (*Required*): Conditions to display in the frontend. - **summary**: A human-readable text summary of the current conditions. - **precip_type**: The type of precipitation occurring. diff --git a/source/_components/sensor.openweathermap.markdown b/source/_components/sensor.openweathermap.markdown index 32bf1871d84..fca55b2237c 100644 --- a/source/_components/sensor.openweathermap.markdown +++ b/source/_components/sensor.openweathermap.markdown @@ -38,6 +38,7 @@ sensor: Configuration variables: - **api_key** (*Required*): Your API key for http://openweathermap.org/. +- **name** (*Optional*): Additional name for the sensors. Default to platform name. - **forecast** (*Optional*): Enables the forecast. The default is to display the current conditions. - **monitored_conditions** array (*Required*): Conditions to display in the frontend. - **weather**: A human-readable text summary. diff --git a/source/_components/sensor.yweather.markdown b/source/_components/sensor.yweather.markdown index c78ac5d06f3..aaf6fd83bc8 100644 --- a/source/_components/sensor.yweather.markdown +++ b/source/_components/sensor.yweather.markdown @@ -43,7 +43,7 @@ Configuration variables: - **woeid** (*Optional*): See above. - **forecast** (*Optional*): Day of forecast. The default is the current day to display conditions. -- **name** (*Optional*): The name of the sensor. To easily recognize each sensor when adding more than one Yahoo weather sensor, it is recommended to use the name option. +- **name** (*Optional*): The name of the sensor. To easily recognize each sensor when adding more than one Yahoo weather sensor, it is recommended to use the name option. Defaults to `Yweather`. - **monitored_conditions** array (*Required*): Conditions to display in the frontend. - **weather**: A human-readable text summary with picture from yahoo. - **weather_current**: A human-readable text summary with picture from yahoo from current conditon. From 0d9177e4b5eb3b5274e950d53f4bccd61629e16c Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 8 Oct 2016 23:21:22 +0200 Subject: [PATCH 05/84] Add screenshot --- source/_components/sensor.statistics.markdown | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/_components/sensor.statistics.markdown b/source/_components/sensor.statistics.markdown index d2cc7e2a206..1a45e4d5777 100644 --- a/source/_components/sensor.statistics.markdown +++ b/source/_components/sensor.statistics.markdown @@ -33,3 +33,6 @@ Configuration variables: - **name** (*Optional*): Name of the sensor to use in the frontend. - **sampling_size** (*Optional*): Size of the sampling. If the limit is reached then the values are rotated. Defaults to `20`. +

    + +

    From 7ff6083afc7644807fd4fd69b49df3ea9cc4e5ec Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 8 Oct 2016 14:46:44 -0700 Subject: [PATCH 06/84] Version 0.30.1 --- .../2016-10-08-hassbian-rest-digital-ocean.markdown | 8 ++++++++ source/index.html | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown b/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown index fafabbf4401..3f6532079e6 100644 --- a/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown +++ b/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown @@ -97,6 +97,12 @@ sensor - Device Tracker: The `known_device.yaml` file is now validated ([@kellerza]) - Minor features and bug fixes by [@tchellomello], [@pavoni], [@fabaff], [@pvizeli], [@lwis], [@turbokongen], [@Danielhiversen], [@persandstrom], [@balloob], [@robbiet480], [@sam-io], [@bbangert], and you if you are missing here. +### {% linkable_title Release 0.30.1 - October 8 %} + + - Device Tracker `known_devices.yaml` validation is now more accepting ([@kellerza]) + - Handle X10 light numbers greater than 9 ([@mtl010957]) + - Fix command line covers without a template ([@roidayan]) + ### {% linkable_title Breaking changes %} - All deprecated condition options from `automation` have been removed (deprecated since May and have printed warnings to your console): @@ -136,6 +142,8 @@ sensor [@tchellomello]: https://github.com/tchellomello [@turbokongen]: https://github.com/turbokongen [@w1ll1am23]: https://github.com/w1ll1am23 +[@mtl010957]: https://github.com/mtl010957 +[@roidayan]: https://github.com/roidayan [arest]: https://arest.io/ [arest-sensor]: /components/sensor.arest/ diff --git a/source/index.html b/source/index.html index 52bd20bdb7d..f336c57690a 100644 --- a/source/index.html +++ b/source/index.html @@ -15,7 +15,7 @@ hide_github_edit: true
    -

    Current Version: 0.30

    +

    Current Version: 0.30.1

    Released: October 8, 2016
    From 070f466257b055f877f576d88b42ba4c3d29ba36 Mon Sep 17 00:00:00 2001 From: mertenats Date: Sat, 8 Oct 2016 23:52:03 +0200 Subject: [PATCH 07/84] Create configuration_yaml_by_mertenats.markdown (#1183) --- source/configuration_yaml_by_mertenats.markdown | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 source/configuration_yaml_by_mertenats.markdown diff --git a/source/configuration_yaml_by_mertenats.markdown b/source/configuration_yaml_by_mertenats.markdown new file mode 100644 index 00000000000..47b1bbb38eb --- /dev/null +++ b/source/configuration_yaml_by_mertenats.markdown @@ -0,0 +1,12 @@ +--- +layout: page +title: "Configuration.yaml by mertenats" +description: "" +date: 2016-10-08 19:00 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: Example configuration.yaml +ha_external_link: https://github.com/mertenats/open-home-automation/tree/master/openhome +--- From 93cc290f163970fcd6e8579a0914ff649057a3ac Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 8 Oct 2016 23:57:39 +0200 Subject: [PATCH 08/84] Mention default --- source/_components/sensor.statistics.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/sensor.statistics.markdown b/source/_components/sensor.statistics.markdown index 1a45e4d5777..779a2c7a9c9 100644 --- a/source/_components/sensor.statistics.markdown +++ b/source/_components/sensor.statistics.markdown @@ -29,8 +29,8 @@ sensor: Configuration variables: -- **entity_id** (*Required*): The entity to monitor. -- **name** (*Optional*): Name of the sensor to use in the frontend. +- **entity_id** (*Required*): The entity to monitor. Only [sensors](/components/sensor/) and [binary sensor](/components/binary_sensor/). +- **name** (*Optional*): Name of the sensor to use in the frontend. Defaults to `Stats`. - **sampling_size** (*Optional*): Size of the sampling. If the limit is reached then the values are rotated. Defaults to `20`.

    From 750bb9bbf49b0d81f884d7102a0ebe57da3e5528 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Sun, 9 Oct 2016 00:09:45 +0200 Subject: [PATCH 09/84] Add new consider_home known_devices override (#1185) --- source/_components/device_tracker.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_components/device_tracker.markdown b/source/_components/device_tracker.markdown index 7844c76506c..03f57ca9abd 100644 --- a/source/_components/device_tracker.markdown +++ b/source/_components/device_tracker.markdown @@ -32,7 +32,7 @@ The following optional parameters can be used with any platform. However device |---------------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `track_new_devices` | True | If new discovered devices are tracked by default | | `interval_seconds` | 12 | Seconds between each scan for new devices | -| `consider_home` | 180 | Seconds to wait till marking someone as not home after not being seen. This parameter is most useful for households with Apple iOS devices that go into sleep mode while still at home to conserve battery life. iPhones will occasionally drop off the network and then re-appear. `consider_home` helps prevent false alarms in presence detection when using IP scanners such as Nmap. | +| `consider_home` | 180 | Seconds to wait till marking someone as not home after not being seen. This parameter is most useful for households with Apple iOS devices that go into sleep mode while still at home to conserve battery life. iPhones will occasionally drop off the network and then re-appear. `consider_home` helps prevent false alarms in presence detection when using IP scanners such as Nmap. `consider_home` accepts various time representations, (E.g. the following all represents 3 minutes: `180`, `0:03`, `0:03:00`) | The extended example from above would look like the following sample: @@ -73,3 +73,4 @@ devicename: | `gravatar` | None | An email address for the device's owner. If provided, it will override `picture` | | `track` | False | If `yes`/`on`/`true` then the device will be tracked. Otherwise its location and state will not update | | `hide_if_away` | False | If `yes`/`on`/`true` then the device will be hidden if it is not at home | +| `consider_home` | [uses platform setting] | Allows you to override the global `consider_home` setting from the platform configuration on a per device level | From 52d4fdbf7f743965c8062e1063a9e2981ebf6336 Mon Sep 17 00:00:00 2001 From: Karen Goode Date: Sat, 8 Oct 2016 23:53:12 -0700 Subject: [PATCH 10/84] Update URL for nmap (#1192) [scan the network using nmap][nmap] Incorrect URL https://home-assistant.io/components/device_tracker.nmap_scanner/ Correct URL https://home-assistant.io/components/device_tracker.nmap_tracker/ --- source/getting-started/presence-detection.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/presence-detection.markdown b/source/getting-started/presence-detection.markdown index 6d6bc252c3e..192168d45d1 100644 --- a/source/getting-started/presence-detection.markdown +++ b/source/getting-started/presence-detection.markdown @@ -44,7 +44,7 @@ Home Assistant will know the location of your device if you are using OwnTracks. ### [Next step: Setting up automation »](/getting-started/automation/) [routers]: /components/#presence-detection -[nmap]: /components/device_tracker.nmap_scanner/ +[nmap]: /components/device_tracker.nmap_tracker/ [ha-owntracks]: /components/device_tracker.owntracks/ [ha-locative]: /components/device_tracker.locative/ [mqtt-self]: /components/mqtt/#run-your-own From 459262ad8da6cbf2fd6e903e0cc2f2b5c55d538b Mon Sep 17 00:00:00 2001 From: garrettbeachy Date: Sun, 9 Oct 2016 02:57:24 -0500 Subject: [PATCH 11/84] Update sensor.darksky.markdown (#1187) --- source/_components/sensor.darksky.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.darksky.markdown b/source/_components/sensor.darksky.markdown index e347c56df71..4e7b672a75e 100644 --- a/source/_components/sensor.darksky.markdown +++ b/source/_components/sensor.darksky.markdown @@ -15,7 +15,7 @@ ha_release: 0.30 The `darksky` platform uses the [Dark Sky](https://darksky.net/) web service as a source for meteorological data for your location. The location is based on the `longitude` and `latitude` coordinates configured in your `configuration.yaml` file. The coordinates are auto-detected but to take advantage of the hyper-local weather reported by Dark Sky, you can refine them down to your exact home address. GPS coordinates can be found by using [Google Maps](https://www.google.com/maps) and clicking on your home or [Openstreetmap](http://www.openstreetmap.org/). -You need an API key which is free but requires [registration](hhttps://darksky.net/dev/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds. +You need an API key which is free but requires [registration](https://darksky.net/dev/register). You can make up to 1000 calls per day for free which means that you could make one approximately every 86 seconds.

    [Dark Sky](https://darksky.net/) will charge you $0.0001 per API call if you enter your credit card details and create more than 1000 calls per day. From fe55a42c182ee186ff8051c270d37506a67e8447 Mon Sep 17 00:00:00 2001 From: Phil Hawthorne Date: Sun, 9 Oct 2016 19:22:11 +1100 Subject: [PATCH 12/84] Display template tags in Pushbullet Home Assistant release example (#1195) The template example introduced in #1100 needs some tags around the template tags so that Jekyll doesn't try to interpret the code. --- source/_cookbook/notify_if__new_ha_release.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_cookbook/notify_if__new_ha_release.markdown b/source/_cookbook/notify_if__new_ha_release.markdown index 62e92ac57af..301021d02f9 100644 --- a/source/_cookbook/notify_if__new_ha_release.markdown +++ b/source/_cookbook/notify_if__new_ha_release.markdown @@ -49,6 +49,6 @@ automation: data: title: 'New Home Assistant Release' target: 'YOUR_TARGET_HERE' #See Pushbullet component for usage - message: "Home Assistant {{ states.updater.updater.state }} is now available." + message: "Home Assistant {% raw %} {{ states.updater.updater.state }} {% raw %} is now available." ``` From 80ef2275f7f818301e8e2504353affa81b5436ac Mon Sep 17 00:00:00 2001 From: Phil Hawthorne Date: Sun, 9 Oct 2016 19:32:57 +1100 Subject: [PATCH 13/84] Document Climate Services (#1194) * Document Climate Services Adds documentation for all the services exposed by the new Climate platform. Based on the cover platform documentation. * Update climate.markdown Fixed some formatting and spelling. --- source/_components/climate.markdown | 173 ++++++++++++++++++++++++++++ 1 file changed, 173 insertions(+) diff --git a/source/_components/climate.markdown b/source/_components/climate.markdown index 4b2f5396fbf..24caf95194e 100644 --- a/source/_components/climate.markdown +++ b/source/_components/climate.markdown @@ -20,3 +20,176 @@ climate: platform: demo ``` +## {% linkable_title Services %} + +### {% linkable_title Climate control services %} +Available services: `climate.set_aux_heat`, `climate.set_away_mode`, `climate.set_temperature`, `climate.set_humidity`, `climate.set_fan_mode`, `climate.set_operation_mode`, `climate.set_swing_mode` + +

    +Not all climate services may be available for your platform. Be sure to check the available services Home Assistant has enabled by checking service developer tool icon **Services**. +

    + +### {% linkable_title Service `climate.set_aux_heat` %} + +Turn auxiliary heater on/off for climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `aux_heat` | no | New value of auxiliary heater. + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_aux_heat + data: + entity_id: climate.kitchen + aux_heat: true +``` + +### {% linkable_title Service `climate.set_away_mode` %} + +Turn away mode on/off for climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `away_mode` | no | New value of away mode. + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_away_mode + data: + entity_id: climate.kitchen + away_mode: true +``` + +### {% linkable_title Service `climate.set_temperature` %} + +Set target temperature of climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `temperature` | no | New target temperature for hvac +| `target_temp_high` | yes | New target high temperature for hvac +| `target_temp_low` | yes | New target low temperature for hvac +| `operation_mode` | yes | Operation mode to set temperature to. This defaults to current_operation mode if not set, or set incorrectly. + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_temperature + data: + entity_id: climate.kitchen + temperature: 24 + operation_mode: Heat +``` + +### {% linkable_title Service `climate.set_humidity` %} + +Set target humidity of climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `humidity` | no | New target humidity for climate device + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_humidity + data: + entity_id: climate.kitchen + humidity: 60 +``` + +### {% linkable_title Service `climate.set_fan_mode` %} + +Set fan operation for climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `fan_mode` | no | New value of fan mode + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_fan_mode + data: + entity_id: climate.kitchen + fan_mode: 'On Low' +``` + +### {% linkable_title Service `climate.set_operation_mode` %} + +Set operation mode for climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `operation_mode` | no | New value of operation mode + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_operation_mode + data: + entity_id: climate.kitchen + operation_mode: Heat +``` + +### {% linkable_title Service `climate.set_swing_mode` %} + +Set operation mode for climate device + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all. +| `swing_mode` | no | New value of swing mode + +#### {% linkable_title Automation example %} + +```yaml +automation: + trigger: + platform: time + after: "07:15:00" + action: + - service: climate.set_swing_mode + data: + entity_id: climate.kitchen + swing_mode: 1 +``` From e559cddbc8d988fcf176693e59395e924c1f207a Mon Sep 17 00:00:00 2001 From: Phil Hawthorne Date: Sun, 9 Oct 2016 19:55:33 +1100 Subject: [PATCH 14/84] Improve Z-wave climate documentation (#1196) * Change link to Z-wave Getting Started Page Changes the link from the Z-wave component page, to the Z-wave getting started page. The component page directs users to the getting started page, and does not have any information for the user. This should save users a link click. * Add more information about Z-Wave climate control Add examples to the Z-wave climate page to show users how they can automate their Z-wave climate control. --- source/_components/climate.zwave.markdown | 66 ++++++++++++++++++++++- 1 file changed, 64 insertions(+), 2 deletions(-) diff --git a/source/_components/climate.zwave.markdown b/source/_components/climate.zwave.markdown index 6d20fdc01e3..c751b170941 100644 --- a/source/_components/climate.zwave.markdown +++ b/source/_components/climate.zwave.markdown @@ -13,10 +13,72 @@ ha_release: 0.17 --- -To get your Z-Wave thermostat or HVAC unit working with Home Assistant, follow the instructions for the general [Z-Wave component](/components/zwave/). +To get your Z-Wave thermostat or HVAC unit working with Home Assistant, follow the instructions for the general [Z-Wave component](/getting-started/z-wave/).

    Thermostats with support for fan modes or different operating modes, will be handled like a HVAC device and will also be detected as one. -If the thermostat support different operationg modes, you will get one thermostat entity for each mode. These can be hidden with settings using the customize setting in the `configuration.yaml` file. +If the thermostat support different operating modes, you will get one thermostat entity for each mode. These can be hidden with settings using the customize setting in the `configuration.yaml` file.

    + +To enable the climate component for your Z-Wave network, add the following to your `configuration.yaml` file. + +```yaml +climate: + platform: zwave +``` + +Once enabled, any Z-Wave climate devices will be available to Home Assistant. Multiple entities may be created. The following entities are created for a Remotec ZXT-120. + +- **climate.remotec_zxt120_heating_1_id** Allows you to control the connected device. See below for examples. +- **sensor.remotec_zxt120_temperature_38** A sensor which returns the current temperature set on the attached device. + +### {% linkable_title Automating Z-Wave Climate Devices %} + +The following examples will instruct a Remotec ZXT-120 to turn the attached device mode to Heating, and set the temperature at 24 degrees after 8pm. Add it to `automation.yaml`. + +```yaml +automation: + - alias: Turn on Heater at 8pm + trigger: + - platform: time + after: "20:00:00" + action: + - service: climate.set_operation_mode + entity_id: climate.remotec_zxt120_heating_1_id + data: + operation_mode: Heat + - service: climate.set_temperature + entity_id: climate.remotec_zxt120_heating_1_39 + data: + temperature: 24 +``` + +Generally in Home Assistant you can use the `homeassistant/turn_off` service to turn devices off. For the Remotec ZXT-120, you must instead make a service call like the following. + +```yaml +automation: + - alias: Turn off Heater at 9pm + trigger: + - platform: time + after: "21:00:00" + action: + - service: climate.set_operation_mode + entity_id: climate.remotec_zxt120_heating_1_id + data: + operation_mode: 'Off' +``` + +**Note:** In the example above, the word `Off` is encased in single quotes to be valid YAML. + +### {% linkable_title Test if it works %} + +A simple way to test if your Z-Wave climate device is working is to use service developer tool icon **Services** from the **Developer Tools**. Choose the applicable Climate service from the list of **Available services:** and enter something like the sample below into the **Service Data** field and then press **CALL SERVICE**. + +```json +{ + "entity_id": "climate.remotec_zxt120_heating_1_id", + "operation_mode": "Heat" +} +``` + From 8e17c5cccc85cb18eca706baf19935939af0e4f6 Mon Sep 17 00:00:00 2001 From: Phil Hawthorne Date: Sun, 9 Oct 2016 20:42:28 +1100 Subject: [PATCH 15/84] Close raw tag on Pushbullet notify example (#1198) Forgot the correct closing tag for the raw tag on the cookbook example --- source/_cookbook/notify_if__new_ha_release.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_cookbook/notify_if__new_ha_release.markdown b/source/_cookbook/notify_if__new_ha_release.markdown index 301021d02f9..df8c38f9dbb 100644 --- a/source/_cookbook/notify_if__new_ha_release.markdown +++ b/source/_cookbook/notify_if__new_ha_release.markdown @@ -49,6 +49,6 @@ automation: data: title: 'New Home Assistant Release' target: 'YOUR_TARGET_HERE' #See Pushbullet component for usage - message: "Home Assistant {% raw %} {{ states.updater.updater.state }} {% raw %} is now available." + message: "Home Assistant {% raw %} {{ states.updater.updater.state }} {% endraw %} is now available." ``` From d1d1a96e5c248beca006955ffa394647d0134cc3 Mon Sep 17 00:00:00 2001 From: Fredrik Lindqvist Date: Sun, 9 Oct 2016 12:02:37 +0200 Subject: [PATCH 16/84] Update climate.zwave.markdown (#1197) Change title to climate from Thermostat since it now encompasses more devices. --- source/_components/climate.zwave.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/climate.zwave.markdown b/source/_components/climate.zwave.markdown index c751b170941..0f3d4962d9c 100644 --- a/source/_components/climate.zwave.markdown +++ b/source/_components/climate.zwave.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "Z-Wave Thermostat" -description: "Instructions how to setup the Z-Wave thermostat within Home Assistant." +title: "Z-Wave Climate" +description: "Instructions how to setup the Z-Wave thermostat or HVAC within Home Assistant." date: 2016-04-03 9:52 sidebar: true comments: false From 9b03552572b26deab2cc5d65e8100d2f35fa9ca9 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 9 Oct 2016 12:26:51 +0200 Subject: [PATCH 17/84] Update configuration sample --- source/_components/sensor.arest.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/sensor.arest.markdown b/source/_components/sensor.arest.markdown index 40926089f5f..c69b5251c1b 100644 --- a/source/_components/sensor.arest.markdown +++ b/source/_components/sensor.arest.markdown @@ -24,10 +24,10 @@ sensor: resource: http://IP_ADDRESS name: Office monitored_variables: - - name: temperature + temperature: unit_of_measurement: '°C' value_template: '{% raw %}{{ value | round(1) }}{% endraw %}' - - name: humidity + humidity: unit_of_measurement: '%' pins: A0: From 0ca16406577677ca324a74cc004f7e59dacb1170 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 9 Oct 2016 12:47:54 +0200 Subject: [PATCH 18/84] Minimize the configuration sample --- source/_components/sensor.arest.markdown | 25 ++++++++---------------- 1 file changed, 8 insertions(+), 17 deletions(-) diff --git a/source/_components/sensor.arest.markdown b/source/_components/sensor.arest.markdown index c69b5251c1b..70d83a25ee1 100644 --- a/source/_components/sensor.arest.markdown +++ b/source/_components/sensor.arest.markdown @@ -19,23 +19,14 @@ To use your aREST enabled device in your installation, add the following to your ```yaml # Example configuration.yaml entry -sensor: - platform: arest - resource: http://IP_ADDRESS - name: Office - monitored_variables: - temperature: - unit_of_measurement: '°C' - value_template: '{% raw %}{{ value | round(1) }}{% endraw %}' - humidity: - unit_of_measurement: '%' - pins: - A0: - name: Pin 0 analog - unit_of_measurement: "ca" - value_template: '{% raw %}{{ value_json.light }}{% endraw %}' - 3: - name: Pin 3 digital + - platform: arest + resource: http://10.100.0.117 + monitored_variables: + temperature: + name: temperature + pins: + A0: + name: Pin 0 analog ``` Configuration variables: From e0922437fcad253d35911a2c0714ed42679c3719 Mon Sep 17 00:00:00 2001 From: Ardetus Date: Sun, 9 Oct 2016 21:47:23 +0300 Subject: [PATCH 19/84] Update description of onewire bus parameter (#1200) --- source/_components/sensor.onewire.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_components/sensor.onewire.markdown b/source/_components/sensor.onewire.markdown index b69a7051494..5595f7a3607 100644 --- a/source/_components/sensor.onewire.markdown +++ b/source/_components/sensor.onewire.markdown @@ -17,12 +17,12 @@ The `onewire` platform supports sensors which are using the One wire (1-wire) bu Supported devices: - [DS18B20](https://datasheets.maximintegrated.com/en/ds/DS18B20.pdf) -- DS18S20 -- DS1822 -- DS1825 -- DS28EA00 temperature sensors +- [DS18S20](https://www.maximintegrated.com/en/products/analog/sensors-and-sensor-interface/DS18S20.html) +- [DS1822](https://datasheets.maximintegrated.com/en/ds/DS1822.pdf) +- [DS1825](https://datasheets.maximintegrated.com/en/ds/DS1825.pdf) +- [DS28EA00](https://datasheets.maximintegrated.com/en/ds/DS28EA00.pdf) temperature sensors -There is also support for bus masters which use fuse to mount device tree. +The 1-Wire bus can be connected directly to the IO pins of Raspberry Pi or using dedicated interface adapter (e.g [DS9490R](https://datasheets.maximintegrated.com/en/ds/DS9490-DS9490R.pdf)). When an interface adapter is used, sensors can be accessed on Linux hosts via [owfs 1-Wire file system](http://owfs.org/). When using an interface adapter and the owfs, the 'mount_dir' option must be configured to correspond a directory, where owfs device tree has been mounted. If you are using Raspberry Pi and IO pin connected bus setup, don't use the 'mount_dir' option. To enable One wire sensors in your installation, add the following to your `configuration.yaml` file: From 217c0e0f1e45e9f4dd0976969f3d70f1d4c1bf79 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 10 Oct 2016 09:06:59 +0200 Subject: [PATCH 20/84] Move to switch category --- source/_components/switch.digital_ocean.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.digital_ocean.markdown b/source/_components/switch.digital_ocean.markdown index a7a77af1f54..7eb640197d1 100644 --- a/source/_components/switch.digital_ocean.markdown +++ b/source/_components/switch.digital_ocean.markdown @@ -8,7 +8,7 @@ comments: false sharing: true footer: true logo: digital_ocean.png -ha_category: System Monitor +ha_category: Switch ha_release: "0.30" ha_iot_class: "Local Polling" --- From fb1fdc76ac34b3e3c6789373e16ec79f44bb85e6 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 10 Oct 2016 09:07:20 +0200 Subject: [PATCH 21/84] Add details about delay --- source/_components/sensor.statistics.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_components/sensor.statistics.markdown b/source/_components/sensor.statistics.markdown index 779a2c7a9c9..eea0405e190 100644 --- a/source/_components/sensor.statistics.markdown +++ b/source/_components/sensor.statistics.markdown @@ -16,6 +16,8 @@ ha_release: "0.30" The `statistics` sensor platform is consuming the state from other sensors. Beside the maximal and the minimal value also the total, the mean, the median, the variance, and the standard deviation are as attributes available. If it's a binary sensor then only the state changes are counted. +It can take time till the sensor starts to work because a couple of atrributes need more than one value to do the calculation. + To enable the statistics sensor, add the following lines to your `configuration.yaml`: ```yaml From d6ed281e4f5462b7c137fdf6dbea7f4cc4ebc3b2 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 10 Oct 2016 17:07:05 +0200 Subject: [PATCH 22/84] Move webserver docs to topics (#1206) --- source/{_cookbook => _topics}/webserver_details.markdown | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename source/{_cookbook => _topics}/webserver_details.markdown (100%) diff --git a/source/_cookbook/webserver_details.markdown b/source/_topics/webserver_details.markdown similarity index 100% rename from source/_cookbook/webserver_details.markdown rename to source/_topics/webserver_details.markdown From 671e1105984f82a365ff40d67c9bb8411659d30a Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 10 Oct 2016 17:15:51 +0200 Subject: [PATCH 23/84] No sidebar in adv. topics --- source/_topics/platform_options.markdown | 2 +- source/_topics/webserver_details.markdown | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_topics/platform_options.markdown b/source/_topics/platform_options.markdown index eb8f1300c22..f8cd217c687 100644 --- a/source/_topics/platform_options.markdown +++ b/source/_topics/platform_options.markdown @@ -3,7 +3,7 @@ layout: page title: "Entity component platform options" description: "Shows how to customize polling interval for any component via configuration.yaml." date: 2016-02-12 23:17 -0800 -sidebar: true +sidebar: false comments: false sharing: true footer: true diff --git a/source/_topics/webserver_details.markdown b/source/_topics/webserver_details.markdown index 1a928f881f8..18ba4a3c152 100644 --- a/source/_topics/webserver_details.markdown +++ b/source/_topics/webserver_details.markdown @@ -1,9 +1,9 @@ --- layout: page title: "Details about the web server" -description: "Use nmap to scan your Home Assistant instance" +description: "Use nmap to scan your Home Assistant instance." date: 2016-10-06 08:00 -sidebar: true +sidebar: false comments: false sharing: true footer: true From 6bc796451ffffb848e5c889ed5aaffc199364300 Mon Sep 17 00:00:00 2001 From: Carlo Costanzo Date: Mon, 10 Oct 2016 12:33:36 -0400 Subject: [PATCH 24/84] Added Hue Color Chart reference. (#1207) Added RGB Color Chart matrix Decoder ring link. --- source/_components/light.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.markdown b/source/_components/light.markdown index 028e89175d1..abbdb8edee2 100644 --- a/source/_components/light.markdown +++ b/source/_components/light.markdown @@ -36,7 +36,7 @@ Turns one light on or multiple lights on using [groups]({{site_root}}/components | `transition` | yes | Integer that represents the time the light should take to transition to the new state in seconds. *not supported by Wink | `profile` | yes | String with the name of one of the built-in profiles (relax, energize, concentrate, reading) or one of the custom profiles defined in `light_profiles.csv` in the current working directory. Light profiles define a xy color and a brightness. If a profile is given and a brightness or xy color then the profile values will be overwritten. | `xy_color` | yes | A list containing two floats representing the xy color you want the light to be. Two comma seperated floats that represent the color in XY. -| `rgb_color` | yes | A list containing three integers representing the rgb color you want the light to be. Three comma seperated integers that represent the color in RGB +| `rgb_color` | yes | A list containing three integers representing the rgb color you want the light to be. Three comma seperated integers that represent the color in RGB. You can find a great chart here: [Hue Color Chart](http://www.developers.meethue.com/documentation/hue-xy-values) | `color_temp` | yes | An INT in mireds representing the color temperature you want the light to be. | `color_name` | yes | A human readable string of a color name, such as `blue` or `goldenrod` or [`chucknorris`](http://stackoverflow.com/questions/8318911/why-does-html-think-chucknorris-is-a-color). If your browser can display it, so can Home Assistant. | `brightness` | yes | Integer between 0 and 255 for how bright the color should be. From bd1985f2ad9db0eec5ebaa96dad08f12d2ea100e Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 10 Oct 2016 18:38:54 +0200 Subject: [PATCH 25/84] Add ha_release --- source/_components/media_player.denon.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/media_player.denon.markdown b/source/_components/media_player.denon.markdown index 59f65696d31..48bfc5a5489 100644 --- a/source/_components/media_player.denon.markdown +++ b/source/_components/media_player.denon.markdown @@ -10,6 +10,7 @@ footer: true logo: denon.png ha_category: Media Player ha_iot_class: "Local Polling" +ha_release: 0.7.2 --- From b43a263a479a5cb3166da1387909bbbe55df07f8 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 10 Oct 2016 21:22:59 +0200 Subject: [PATCH 26/84] Fix templates --- source/_components/sensor.mqtt.markdown | 34 ++++++++++++------------- 1 file changed, 16 insertions(+), 18 deletions(-) diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index 8c8ffe7d804..518d3444f09 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -50,11 +50,11 @@ Thus the trick is extract the battery level from the payload. ```yaml # Example configuration.yml entry sensor: - platform: mqtt - state_topic: "owntracks/tablet/tablet" - name: "Battery Tablet" - unit_of_measurement: "%" - value_template: {% raw %}'{{ value_json.batt }}'{% endraw %} + - platform: mqtt + state_topic: "owntracks/tablet/tablet" + name: "Battery Tablet" + unit_of_measurement: "%" + value_template: {% raw %}'{{ value_json.batt }}'{% endraw %} ``` ### {% linkable_title Get temperature and humidity %} @@ -73,17 +73,15 @@ Then use this configuration example to extract the data from the payload: ```yaml # Example configuration.yml entry -sensor 1: - platform: mqtt - state_topic: 'office/sensor1' - name: 'Temperature' - unit_of_measurement: '°C' - value_template: '{{ value_json.temperature }}' - -sensor 2: - platform: mqtt - state_topic: 'office/sensor1' - name: 'Humidity' - unit_of_measurement: '%' - value_template: '{{ value_json.humidity }}' +sensor: + - platform: mqtt + state_topic: 'office/sensor1' + name: 'Temperature' + unit_of_measurement: '°C' + value_template: {% raw %}'{{ value_json.temperature }}'{% endraw %} + - platform: mqtt + state_topic: 'office/sensor1' + name: 'Humidity' + unit_of_measurement: '%' + value_template: {% raw %}'{{ value_json.humidity }}'{% endraw %} ``` From a8b1546361034a2446c5d3b53bf077851280700c Mon Sep 17 00:00:00 2001 From: jumpkick Date: Mon, 10 Oct 2016 17:29:54 -0400 Subject: [PATCH 27/84] Update sensor.neurio_energy.markdown (#1208) API_KEY and API_SECRET are labeled as "Client ID" and "Client Secret" respectively on the Neurio Register App page --- source/_components/sensor.neurio_energy.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/sensor.neurio_energy.markdown b/source/_components/sensor.neurio_energy.markdown index 5fea433c7e6..ddf96919a3f 100644 --- a/source/_components/sensor.neurio_energy.markdown +++ b/source/_components/sensor.neurio_energy.markdown @@ -22,8 +22,8 @@ To enable this sensor in your installation, add the following to your `configura # Example configuration.yaml entry sensor: platform: neurio_energy - api_key: API_KEY - api_secret: API_SECRET + api_key: CLIENT_ID + api_secret: CLIENT_SECRET ``` Configuration variables: From 3d8fc2c531eff0ddacb3de5047787113cae0f186 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 10:02:52 +0200 Subject: [PATCH 28/84] Fix sample --- source/developers/development_validation.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/developers/development_validation.markdown b/source/developers/development_validation.markdown index 93a1438f283..51fef2d39b1 100644 --- a/source/developers/development_validation.markdown +++ b/source/developers/development_validation.markdown @@ -82,5 +82,5 @@ SENSOR_TYPES = { PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ ... vol.Optional(CONF_MONITORED_VARIABLES, default=[]): - vol.All(ensure_list, [vol.In(SENSOR_TYPES)]), + vol.All(cv.ensure_list, [vol.In(SENSOR_TYPES)]), ``` From 7c70ea93f9bfe4855f6a6ab68b923aecc28640ea Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 11:51:43 +0200 Subject: [PATCH 29/84] Add link --- source/getting-started/automation-templating.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/automation-templating.markdown b/source/getting-started/automation-templating.markdown index 940a3887665..b9b3ca2a627 100644 --- a/source/getting-started/automation-templating.markdown +++ b/source/getting-started/automation-templating.markdown @@ -11,7 +11,7 @@ footer: true In Home Assistant 0.19 we introduced a new powerful feature: variables in scripts and automations. This makes it possible to adjust your condition and action based on the information of the trigger. -The trigger data made is available during template rendering as the `trigger` variable. +The trigger data made is available during [template](/topics/templating/) rendering as the `trigger` variable. ```yaml # Example configuration.yaml entries From 103baf2104d16602d208032bbe63b934cbd8d7dc Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 11:54:03 +0200 Subject: [PATCH 30/84] Add template section --- source/developers/website.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/developers/website.markdown b/source/developers/website.markdown index e5e636763e0..e2068dc5f49 100644 --- a/source/developers/website.markdown +++ b/source/developers/website.markdown @@ -78,6 +78,12 @@ Note that you can replace `yaml` next to \`\`\` with the language that is within When you're writing code that is to be executed on the terminal, prefix it with `$`. +### {% linkable_title Templates %} + +For the [configuration templating](/topics/templating/) is [Jinja](http://jinja.pocoo.org/) used. + +You need to embed all templates with `{% raw %}...{% endraw %}` otherwise they will be rendered and this result in an empty output. + ### {% linkable_title HTML %} The direct usage of HTML is supported but not recommended. The note boxes are an exception. From 614ceaf735a870dc359dd945e680af1d00d95381 Mon Sep 17 00:00:00 2001 From: Teemu Mikkonen Date: Tue, 11 Oct 2016 13:21:38 +0300 Subject: [PATCH 31/84] Add example of tag usage inside yaml (#1210) * Add example of tag usage inside yaml This helps users to see how extra information passed to notification shuld be placed under data->data. In this case it's data->data->tag. * Added raw/endraw to message template. --- source/_components/notify.html5.markdown | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/source/_components/notify.html5.markdown b/source/_components/notify.html5.markdown index 3f35924e1e1..6fa51e4417d 100644 --- a/source/_components/notify.html5.markdown +++ b/source/_components/notify.html5.markdown @@ -111,6 +111,22 @@ By default, every notification sent has a randomly generated UUID (v4) set as it } ``` +Example of adding a tag to your configuration. This won't create new notification if there already exists one with the same tag. + +```yaml + - alias: Push/update notification of sensor state with tag + trigger: + - platform: state + entity_id: sensor.sensor + action: + service: notify.html5 + data_template: + message: "Last known sensor state is {% raw %}{{ states('sensor.sensor') }}{% endraw %}." + data: + data: + tag: 'notification-about-sensor' +``` + #### {% linkable_title Targets %} If you do not provide a `target` parameter in the notify payload a notification will be sent to all registered targets as listed in `html5_push_registrations.conf`. You can provide a `target` parameter like so: From 6e087007fa237b1d475b399d3f637ec67012a2ef Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 12:24:13 +0200 Subject: [PATCH 32/84] Move content --- source/developers/website.markdown | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/source/developers/website.markdown b/source/developers/website.markdown index e2068dc5f49..72fa0035568 100644 --- a/source/developers/website.markdown +++ b/source/developers/website.markdown @@ -72,8 +72,6 @@ You can use the default markdown syntax to generate syntax highlighted code. For ```{% endraw %} ``` -If you are using templates then those parts needs to be [escaped](http://stackoverflow.com/a/24102537). Otherwise they will be rendered and appear blank on the website. - Note that you can replace `yaml` next to \`\`\` with the language that is within the block. When you're writing code that is to be executed on the terminal, prefix it with `$`. @@ -82,7 +80,7 @@ When you're writing code that is to be executed on the terminal, prefix it with For the [configuration templating](/topics/templating/) is [Jinja](http://jinja.pocoo.org/) used. -You need to embed all templates with `{% raw %}...{% endraw %}` otherwise they will be rendered and this result in an empty output. +If you are using templates then those parts needs to be [escaped](http://stackoverflow.com/a/24102537). Otherwise they will be rendered and appear blank on the website. ### {% linkable_title HTML %} From 3bb17aa23fb834b58cd2d63c50a5244ffb8900fd Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 14:23:14 +0200 Subject: [PATCH 33/84] Minimize configuration sample, add missing description, and example --- source/_components/switch.pilight.markdown | 92 ++++++++++++++-------- 1 file changed, 59 insertions(+), 33 deletions(-) diff --git a/source/_components/switch.pilight.markdown b/source/_components/switch.pilight.markdown index 648348cc1ac..9cef19c95cd 100644 --- a/source/_components/switch.pilight.markdown +++ b/source/_components/switch.pilight.markdown @@ -14,51 +14,77 @@ ha_iot_class: "Local Polling" --- -A switch platform that issues 433 MHz commands using [pilight](https://www.pilight.org/) to turn a 433 MHz device on or off. The pilight HA hub has to be set up. +The `pilight` switch platform is issuing 433 MHz commands using [pilight](https://www.pilight.org/) to turn a 433 MHz device on or off. The Pilight Home Assistant hub has to be set up. -Additionally RF commands can be defined that trigger this switch to turn on and off. This allows you to also use the remote shipped with your 433 MHz switch without mixing up the HA states. You can even define several on/off commands, thus several RF remotes to toggle this switch. +Additionally RF commands can be defined that trigger this switch to turn on and off. This allows you to also use the remote shipped with your 433 MHz switch without mixing up the Home Assistant states. You can even define several on/off commands, thus several RF remotes to toggle this switch. -To be really sure that HA knows the actual state of your device it is recommended to use the RF remote with codes unknown to any of your 433 MHz devices. Thus you use the remote to trigger this switch to send the correct RF code to the device. +To be really sure that Home Assistant knows the actual state of your device it is recommended to use the RF remote with codes unknown to any of your 433 MHz devices. Thus you use the remote to trigger this switch to send the correct RF code to the device. -To define a pilight switch, add the following lines to your `configuration.yaml`: +To define a Pilight switch, add the following lines to your `configuration.yaml`: ```yaml # Example configuration.yaml entry switch: - platform: pilight - switches: - Bed light: - on_code: - protocol: intertechno_old # protocol has to be defined - unit: 3 # these entries are protocol specific and can differ - id: 4 # these entries are protocol specific and can differ - 'on': 1 # on has to be in apostrophes to be parsed correctly - off_code: - protocol: intertechno_old # protocol has to be defined - unit: 3 # these entries are protocol specific and can differ - id: 4 # these entries are protocol specific and can differ - 'off': 1 # off has to be in apostrophes to be parsed correctly - on_code_receive: # optional - protocol: daycom # protocol has to be defined - systemcode: 14462 # these entries are protocol specific and can differ - unit: 6 # these entries are protocol specific and can differ - id: 34 # these entries are protocol specific and can differ - state: 'on' # off has to be in apostrophes to be parsed correctly - off_code_receive: # optional - protocol: daycom # protocol has to be defined - systemcode: 14462 # these entries are protocol specific and can differ - unit: 6 # these entries are protocol specific and can differ - id: 34 # these entries are protocol specific and can differ - state: 'off' # on has to be in apostrophes to be parsed correctly + - platform: pilight + switches: + Bed light: + on_code: + protocol: intertechno_old + 'on': 1 + off_code: + protocol: intertechno_old + 'off': 1 ``` Configuration variables: -- **switches** (*Required*): The array that contains all command switches. - - **entry** (*Required*): Name of the command switch. Multiple entries are possible. +- **switches** array (*Required*): The list that contains all command switches. + - **[entry]** (*Required*): Name of the command switch. Multiple entries are possible. - **on_code** (*Required*): The code to turn the device on. - **off_code** (*Required*): The code to turn the device off. - - **on_code_receive** (*Optional*): If given, this command will turn the switch on if it is received by pilight. - - **off_code_receive** (*Optional*): If given, this command will turn the switch off if it is received by pilight. + - **on_code_receive** (*Optional*): If given, this command will turn the switch on if it is received by Pilight. + - **off_code_receive** (*Optional*): If given, this command will turn the switch off if it is received by Pilight. + +Variables for the different codes: + +- **protocol** (*Optional*): Protocol to use, eg. `intertechno_old` or `daycom`. +- **systemcode** (*Optional*): The systemcode of the device. +- **unit** (*Optional*): The unit to use. +- **id** (*Optional*): ID of the device +- **state** (*Optional*): `'on'` or `'off'` has to be in apostrophes to be parsed correctly. +- **'off'** (*Optional*): `1` or `0` +- **'on'** (*Optional*): `1` or `0` For possible code entries look at the [pilight API](https://www.pilight.org/development/api/). All commands allowed by [pilight-send](https://wiki.pilight.org/doku.php/psend) can be used. + + +## {% linkable_title Examples %} + +```yaml +switch: + - platform: pilight + switches: + Bed light: + on_code: + protocol: intertechno_old + unit: 3 + id: 4 + 'on': 1 + off_code: + protocol: intertechno_old + unit: 3 + id: 4 + 'off': 1 + on_code_receive: + protocol: daycom + systemcode: 14462 + unit: 6 + id: 34 + state: 'on' + off_code_receive: + protocol: daycom + systemcode: 14462 + unit: 6 + id: 34 + state: 'off' +``` From 96b6fa7ca2957e00039f142ffe3b2b889909cc1c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20H=C3=B8yer=20Iversen?= Date: Tue, 11 Oct 2016 14:25:09 +0200 Subject: [PATCH 34/84] Update automation-create-first.markdown (#1211) --- source/getting-started/automation-create-first.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/getting-started/automation-create-first.markdown b/source/getting-started/automation-create-first.markdown index b39693ab6b2..22a6bc38cea 100644 --- a/source/getting-started/automation-create-first.markdown +++ b/source/getting-started/automation-create-first.markdown @@ -17,6 +17,7 @@ In this example, we are defining a trigger to track the sunset and tell it to fi # Example configuration.yaml entry automation: alias: Turn on light when sun sets + initial_state: True hide_entity: False trigger: platform: sun @@ -25,7 +26,7 @@ automation: service: light.turn_on ``` -Starting with 0.28 automation rules can be reloaded from the [frontend](/components/automation/) and are shown by default. With [`hide_entity:`](/components/automation/) you can control this behaviour. It's is very handy if you are working on your rules but when a rule is finished and you don't want to see that rule in your frontend, you can set `hide_entity:` to `True`. +Starting with 0.28 automation rules can be reloaded from the [frontend](/components/automation/) and are shown by default. With [`hide_entity:`](/components/automation/) you can control this behaviour. It's is very handy if you are working on your rules but when a rule is finished and you don't want to see that rule in your frontend, you can set `hide_entity:` to `True`. To set an automation to be disabled when HASS starts set `initial_state:` to `False`. After a few days of running this automation rule you come to realize that this automation rule is not good enough. It was already dark when the lights went on and the one day you weren't home, the lights turned on anyway. Time for some tweaking. Let's add an offset to the sunset trigger and a condition to only turn on the lights if anyone is home. From ca56632cc6c504dd80643f7173b5643644cb3e3a Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 15:49:00 +0200 Subject: [PATCH 35/84] Details about the HA DB (#1202) * Add database documentation * Add titles --- source/_topics/database.markdown | 125 +++++++++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 source/_topics/database.markdown diff --git a/source/_topics/database.markdown b/source/_topics/database.markdown new file mode 100644 index 00000000000..eed1326201d --- /dev/null +++ b/source/_topics/database.markdown @@ -0,0 +1,125 @@ +--- +layout: page +title: "Home Assistant Database" +description: "Details about the database which Home Assistant is using." +date: 2016-10-10 10:00 +sidebar: true +comments: false +sharing: true +footer: true +--- + +The default database that is used for Home Assistant is [SQLite](https://www.sqlite.org/) and is stored in your [configuration directory](/getting-started/configuration/), eg. `/.homeassistant/home-assistant_v2.db`. You will need an installation of `sqlite3`, the command-line for SQLite database, or [DB Browser for SQLite](http://sqlitebrowser.org/) which provide an editor for executing SQL commands. +First load your database with `sqlite3`. + +```bash +$ sqlite3 home-assistant_v2.db +SQLite version 3.13.0 2016-05-18 10:57:30 +Enter ".help" for usage hints. +sqlite> +``` + +It helps to set some options to make the output better readable. + +```bash +sqlite> .header on +sqlite> .mode column +``` + +You could also start `sqlite3` and attach the database later. Not sure what database you are working with? Check it, especially if you are going to delete data. + +```bash +sqlite> .databases +seq name file +--- --------------- ---------------------------------------------------------- +0 main /home/fab/.homeassistant/home-assistant_v2.db +``` + +### {% linkable_title Schema %} + +Get all available tables from your current Home Assistant database. + +```bash +sqlite> SELECT sql FROM sqlite_master; + +------------------------------------------------------------------------------------- +CREATE TABLE events ( + event_id INTEGER NOT NULL, + event_type VARCHAR(32), + event_data TEXT, + origin VARCHAR(32), + time_fired DATETIME, + created DATETIME, + PRIMARY KEY (event_id) +) +CREATE INDEX ix_events_event_type ON events (event_type) +CREATE TABLE recorder_runs ( + run_id INTEGER NOT NULL, + start DATETIME, + "end" DATETIME, + closed_incorrect BOOLEAN, + created DATETIME, + PRIMARY KEY (run_id), + CHECK (closed_incorrect IN (0, 1)) +) +CREATE TABLE states ( + state_id INTEGER NOT NULL, + domain VARCHAR(64), + entity_id VARCHAR(64), + state VARCHAR(255), + attributes TEXT, + event_id INTEGER, + last_changed DATETIME, + last_updated DATETIME, + created DATETIME, + PRIMARY KEY (state_id), + FOREIGN KEY(event_id) REFERENCES events (event_id) +) +CREATE INDEX states__significant_changes ON states (domain, last_updated, entity_id) +CREATE INDEX states__state_changes ON states (last_changed, last_updated, entity_id) +CREATE TABLE sqlite_stat1(tbl,idx,stat) +``` + +To only show the details about the `states` table as we are using that one in the next examples. + +```bash +sqlite> SELECT sql FROM sqlite_master WHERE type = 'table' AND tbl_name = 'states'; +``` + +### {% linkable_title Query %} + +The identification of the available columns in the table is done and we are now able to create a query. Let's list of your Top 10 entities. + +```bash +sqlite> .width 30, 10, +sqlite> SELECT entity_id, COUNT(*) as count FROM states GROUP BY entity_id ORDER BY count DESC LIMIT 10; +entity_id count +------------------------------ ---------- +sensor.cpu 28874 +sun.sun 21238 +sensor.time 18415 +sensor.new_york 18393 +cover.kitchen_cover 17811 +switch.mystrom_switch 14101 +sensor.internet_time 12963 +sensor.solar_angle1 11397 +sensor.solar_angle 10440 +group.all_switches 8018 +``` + +### {% linkable_title Delete %} + +If you don't want to keep certain entities, you can delete them permanently. + +```bash +sqlite> DELETE FROM states WHERE entity_id="sensor.cpu"; +``` + +The `VACUUM` command cleans the your database. + +```bash +sqlite> VACUUM; +``` + +For a more interactive way to work with the database or the create statistics, checkout our [Jupyther notebooks](http://nbviewer.jupyter.org/github/home-assistant/home-assistant-notebooks/blob/master/). + From d17ae91247e10bf1b63e176b38b808c93bd1dc77 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 11 Oct 2016 22:29:57 -0700 Subject: [PATCH 36/84] Release 0.30.2 --- .../2016-10-08-hassbian-rest-digital-ocean.markdown | 13 +++++++++++++ source/index.html | 4 ++-- 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown b/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown index 3f6532079e6..89627e40bfd 100644 --- a/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown +++ b/source/_posts/2016-10-08-hassbian-rest-digital-ocean.markdown @@ -103,6 +103,16 @@ sensor - Handle X10 light numbers greater than 9 ([@mtl010957]) - Fix command line covers without a template ([@roidayan]) +### {% linkable_title Release 0.30.2 - October 12 %} + +- Handle Volvo's with dashes in their name ([@molobrakos]) +- Fix some html5 push notification configuration options were discarded after first use ([@T3m3z]) +- Fix Homematic device name with autodiscovery ([@pvizeli]) +- Make 'pin' optional for zigbee device config ([@flyte]) +- Fix when sending a notification to a service with target attached (i.e. `notify.html5_unnamed_device_2`) the target was not submitted to the platform as a list causing iteration over every character in the string. ([@robbiet480]) +- Fix for Slack targets ([@fabaff]) +- Fix for Pushover targets ([@Nixon506E]) + ### {% linkable_title Breaking changes %} - All deprecated condition options from `automation` have been removed (deprecated since May and have printed warnings to your console): @@ -144,6 +154,9 @@ sensor [@w1ll1am23]: https://github.com/w1ll1am23 [@mtl010957]: https://github.com/mtl010957 [@roidayan]: https://github.com/roidayan +[@T3m3z]: https://github.com/T3m3z +[@flyte]: https://github.com/flyte +[@Nixon506E]: https://github.com/Nixon506E [arest]: https://arest.io/ [arest-sensor]: /components/sensor.arest/ diff --git a/source/index.html b/source/index.html index f336c57690a..e060e7cca43 100644 --- a/source/index.html +++ b/source/index.html @@ -15,8 +15,8 @@ hide_github_edit: true
    -

    Current Version: 0.30.1

    - Released: October 8, 2016 +

    Current Version: 0.30.2

    + Released: October 12, 2016
    Release notes From 5b73d3dbccb60798c37cce84c905408bdf4ca9fc Mon Sep 17 00:00:00 2001 From: Carlo Costanzo Date: Wed, 12 Oct 2016 02:02:32 -0400 Subject: [PATCH 37/84] Updated link (#1214) Updated the link from my Gist to a full Repo. Prepping for breaking apart the YAML files. --- .../_cookbook/configuration_yaml_by_carlo_costanzo.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_cookbook/configuration_yaml_by_carlo_costanzo.markdown b/source/_cookbook/configuration_yaml_by_carlo_costanzo.markdown index e60659cb24d..3109710311b 100644 --- a/source/_cookbook/configuration_yaml_by_carlo_costanzo.markdown +++ b/source/_cookbook/configuration_yaml_by_carlo_costanzo.markdown @@ -2,12 +2,12 @@ layout: page title: "Configuration.yaml by Carlo Costanzo" description: "" -date: 2016-02-07 11:45 +date: 2016-10-11 11:45 sidebar: true comments: false sharing: true footer: true ha_category: Example configuration.yaml -ha_external_link: https://gist.github.com/CCOSTAN/9934de973a293b809868 +ha_external_link: https://github.com/CCOSTAN/Home-AssistantConfig --- From d439b1cfaa62883431274ce625f8f3010aaafb16 Mon Sep 17 00:00:00 2001 From: Zen Tormey Date: Wed, 12 Oct 2016 10:50:11 -0500 Subject: [PATCH 38/84] Update emulated_hue.markdown (#1218) Added a warning about going over the 49 device limit. --- source/_components/emulated_hue.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/emulated_hue.markdown b/source/_components/emulated_hue.markdown index c434c64aef2..0d965681ff0 100644 --- a/source/_components/emulated_hue.markdown +++ b/source/_components/emulated_hue.markdown @@ -41,7 +41,7 @@ Configuration variables: - `script` - `scene` -- **expose_by_default** (*Optional*): Whether or not entities should be exposed via the bridge by default instead of explicitly (see the 'emulated_hue' customization below). If not specified, this defaults to true. +- **expose_by_default** (*Optional*): Whether or not entities should be exposed via the bridge by default instead of explicitly (see the 'emulated_hue' customization below). If not specified, this defaults to true. Warning: If you have a lot of devices (more than 49 total across all exposed domains), you should be careful with this opton. Exposing more devices than Alexa supports can result in it not seeing any of them. If you are having trouble getting any devices to show up, try disabling this, and explicitly exposing just a few devices at a time to see if that fixes it. - **exposed_domains** (*Optional*): The domains that are exposed by default if `expose_by_default` is set to true. If not specified, this defaults to the following list: - `switch` From f7543302b348f68ca46ebfe087e40d418b7162cd Mon Sep 17 00:00:00 2001 From: Rowan Date: Wed, 12 Oct 2016 20:17:13 +0100 Subject: [PATCH 39/84] Added an icon for Swiss Hydrological Data (#1224) --- .../sensor.swiss_hydrological_data.markdown | 1 + .../supported_brands/swiss-hydrological-data.png | Bin 0 -> 5159 bytes 2 files changed, 1 insertion(+) create mode 100644 source/images/supported_brands/swiss-hydrological-data.png diff --git a/source/_components/sensor.swiss_hydrological_data.markdown b/source/_components/sensor.swiss_hydrological_data.markdown index 5c499b9d2da..96d50ac55ce 100644 --- a/source/_components/sensor.swiss_hydrological_data.markdown +++ b/source/_components/sensor.swiss_hydrological_data.markdown @@ -7,6 +7,7 @@ sidebar: true comments: false sharing: true footer: true +logo: swiss-hydrological-data.png ha_category: Weather ha_iot_class: "Cloud Polling" ha_release: 0.22 diff --git a/source/images/supported_brands/swiss-hydrological-data.png b/source/images/supported_brands/swiss-hydrological-data.png new file mode 100644 index 0000000000000000000000000000000000000000..d7b1784945c38fbda9fa463d6b4cac825f08180d GIT binary patch literal 5159 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 H;o1KI!V(=4 literal 0 HcmV?d00001 From 6d4e6fd9af73f15625fbc08c78519165cabff9c2 Mon Sep 17 00:00:00 2001 From: Rowan Date: Wed, 12 Oct 2016 20:18:26 +0100 Subject: [PATCH 40/84] Updated Google Maps logo (#1223) The updated logo contains the "new" Google G icon --- .../images/supported_brands/google_maps.png | Bin 38871 -> 34359 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/source/images/supported_brands/google_maps.png b/source/images/supported_brands/google_maps.png index e44773b80dce1924e57c6b3cb1fdd2033ce6ec40..924b442b046031178a2304fdb27043091d76383c 100644 GIT binary patch literal 34359 zcmY(q1yEf&A003D=T3i(XfcPgu0N`Q&b^0z9mjBUQRi#7$b+d%0 z{}cpgX&qMp;0wlo8U!FG5BDEH$3|V-OV&*Z&FYUx3X2 zdBe=g#KQc)zW)ss_>YxO$;HOvAM=0w3$Y6P7xMqH{SS`-^MAAdLz>gG#J)1mLKk4AMd~) z$5$7#+dZC7+y0(~1&7=Vz5Je&+3Z%wdAzPaH=9&WnMU>rza7INj_il{6|-!wL0Mwa2`Ov|xiWemup?i$kPe372xg&cDg=~UUso{%74k+ z7+Rfd)oB0w%>IFtZv$;PRahpBhDjTu*5NiuQG{A&lGvA(CRnmlEm%D|)4~R|re%w|MS|Hpd-9zyZV&`?V!Z zf3{Po4pPn!K=!t2DS39&wDQ>JE+bAk#ck{5Wn*m2%l;SF?E6<|p`9%V$=RQaDKaL) zbLKyiW@O1SLkpCZr;Qj68GkXjmQN7VhEf4w1B+P-&;WbV>VvoKuOk~9RNE^|-{2EP zDcOjle+i;TO9Z6JmwQ+(oEp%BU#d~ht908z%*Od5CdMnu2V8G?W&LqK0nhZ5BUpLwQSZ5~X|?5w=sWZqpWF|&j;lJpA*YqByax<=+}m?+@^ zzRsE@rZ$$voG^%ApNAT)SuveZr8fTja8<+!$Y%@jmY~JoN>88PD)zgzI!)VbJ#yN;?`N`E>q`Y06i(Jf{OOZ;LoLh#CiJyR@k}^PCuXb2%lp{@1R*w~v4xdv$i= zq%#G>4119VgLlGWX!j9K!z*qL*HO-3J9u3XF-XZ7r|0aCg{{7A4@81mm zyYg$joH=SRC3P|mc5`-m^6-xzqhpkr()|&crKUtpxWsYwUdy8m_(`{UDFBvTZ9`j} z8x{8P6W&1Dh@s!6HKpteD;pFevrGshrf;e*gNcaYH$W!v+nivP$l7_;klt+`7NEB1 zjA6Q;wn)++_eqrMcn1vJ_E7OdPOuVO~EJF(=WjAQk*rZHETOY?H~a8 zkdp+hQL z#(2xWfx`7`s`>vk8y8cW-u8@`ep1MNe##k{RTYKz*8pgL2Rwea{8q&OH~{pU+LUhp z2yOJcN+dTcB|0cq#A*g9(8B)IW_H9rBNz%@p??6FW7%Mb-NJzzM7i1Ax=G#0hu>e76uT@WhP~ zzTGvPLB-N&5Kc9oS_Ym_Bdd>5fq&<1Db+Dd2PKJ8VcNhLB$LY zrc7Z)q6(^56A<*Yiyhj*?SOu*s`{k7ET-7$RjQ-{>SKrvwzjAz8;s>DtFVIM1Ep73IlTCAPHB6|q=38nyHA z1PZJY2Y%r~^8Z3r`E!&+Dct82huH3v4DZck!t|vC{0g+=BR2q}#swajlQD{6P_Shy zREDFvVb5C8PS_eCM3kgLpe{2Gak1;D_Z#_ke-LF?@de>s?=q{ck}0M;g>@m4{Vb;c zEnY?srO8?sXq$p}w9cNstNHgJMRQ<@Xue?7FVd)taj({TO7wyMg9;h~rC8#$f9E5) zWK#eexhK%Gcj)wh<#DNY<#lbCn3R=~xFj3MG;);S=%zbz@ ziMhy+dOUfod#N&-gF%k$fgku8dmwNWH|Lp`5_7-$Va}izjI$X z#@Ni|YzKj&-|*%Id7|O{`h!fzYd4E>;ecn*%qk$nJ$!OJ2DA!6_k#c2y|BYxz%YkX zM|@tttDC;(R%EsP?(ArMGhoi}ewJSN`5w^II4QgLnVGYG-;Vy(@G~`02+rX>+(gE4 z)AL<90J1cIf5o?PY>^$*hG;_aKwo&6(x2%PBrkbPBNmw5Re60j=>&{@zqIt4d5G2zq^5=!P z_zFqCOz*^ER1~@S3XF8H@>j9HHGL+xmS>tC-q~NzY z&IAdwy}u_`0k~-PopHmrQUBVJk_;1O*ZUi7UDbAye==q=hsP* zBL6wp0|p&qnFk<3aI5S7!B_ui+i4dBA8&lxo_evqjP8l1ND+Yu-{}Wqdna=VN-Wz+ zf^Cnh&z~Yi4V0Bmq*GWEfHW0)qA$K1D#;*}cxm#)qh9BE|5aOI>B#rz-~_zSi&GwHbBrBr-~->nit5@k%@3`iDiTTFcvkU}ag!WMS;l*P{lc?V*-}&jVi){V7f-G8M3!As6SCx`eCEC98K=N+%} zkL(~X5OVx?H1IznB_lG+*($45qr*Bo8+E++3j3}uXj%(f@N=`l_ByqMfYgcQ6$h_v zUd$9w0e-r@(9GMjl~D046%y<8e$(%H=sKB1d3k+2lI(Xu%|y9S>tA#_n@t%5n?{Tx zKboUsXjCJ@O_Jd0% zPb_HRvl@~6>+L>jQ6eAC0Y<~z;jG1MgYpz%d;UV7=vdgS*c)jtXU4Wz6m zW*RRU!g&6JEE(vYx#Om`pjiOb`wLT}UVi(pR=UY(pYWGmoTM=tu3xC}J@J17%=ILg z+N1&M6{ZgF)&)a3CZDpW+kRG;ce!n6-f~B&D)L3P_mM~71$l8zk|7`Pp}5Tz5T?iy zg7MzY((3DGfn-E~F~=CmftwN+i1j+oUAeaybTaf#>Eq&ZUgr?l?YzO2*TSq(Rt8!0 z(Jd7Bp^)&|-=K5+#Q8e6mXYf?yjJ$Xe;i{rJso6Y$ZD7tt_)Vg{jhpX0PfF_-~nh< z8bx7H35V|fdhs?$QyVD*{Twh&R+c&Prd5S21j_EG*;9#Dpa-)V>>(--BOXho>ebr! zsV#*%IPFF|Eb;m(W1j5=ffIAQB8SS}ekppA*2m1^<_8mTZi$MMUJT?WTT!p;>IW^< z7%JpLsmZQh+5MgpN>)uSh_KCzr!{dFt|`!<<_~R)3;lGDHFh5}6+HV`nLq(*{~J%q zAz8HDKlq%}HkU=5+8afDE#Zt3FX{Z(&FxP9MM>AVGL!|eQT2i5Zyqovf1m+!YEvRP zvM5;2@N`;()nm+yFES+10fy&a#rc5l%^aeEoRogscdlrg_tY16hOiGn19`D@$+kPV zNh9}MOgj8BTqe><(=cH2{0mLglsV<~nV_v;5FSY1ZO|O+YsSmdL(C$IXJjug`dDi!T1h0LkEbN3pWjiir z%I7cuOF)%jQ9OB~WB91{o8n&m5L7qRKr}JIe9pB_{($ZLnWcq}yxm95S3teR2^|j7`;mC=zYkH3cuNWkbbn;^U?tg&b zZBJe%8JH)pA-@G%YT-`5AuDV+XyO|$YP{*|qwgU_W1*o{UUP93a*QWmnhRvpfX9AqWI%dG}5?S1=y{o@k2ISZL3IiHty-vwu9^peJ&n2Cfsh} zRR_!-A!Mi0*}UX+`-TFiXAbzX?OK0xd)<$hykz5dYR#QsP!+$rBCB zLFGjFgXn>jICT)6W`A)RLi%_37fv!AO)ejE+?vWYwf*ORAMyZDl^ zv*n*{7+=C+g0asyQOd^>|7-vASB=1@5vf@Oh+S2KRpTu$B4bruPmyDZXUt(u}eJOW;47529-iZVKmR)fgu^Tj;jNp6y9B*|f4W zae>bnVnoJ^Bog=EU)5Pph-f4aZzs~+obA{KJ5Ve;En&YN)8HbaBjWijh!aB+Su?l0 zG)Q%ps;uE#Yh~djc+v7p(6v&gGck;vuQLL2Y&f{I2@e906rPMNk(?x6@(Ye!j{0ra zyN%=R{~A$mHF|J{s4X|+*Wa)DRA^qO666oixG*hxqeXbJVZDmpvkClpmxa_$0biOBH_(g%p$mtQ{K5&45p{G4^;TxapMxB*&D{h*@LQDYoBkc|mUtK4_`|qcF!g;uz~* zl;u1$l(+NGf16pJ-*0M`0XZfCP3%%1`R4EMVcjM-s^07SQ|1RD%PyaJ5CaynvJ|_s z5}!-75XUR`D@t2gXFBNUnAir5DBj23=N40goOdz94ewWtf_FnhPm`HSSN(1!VoV9{ zVg$Rh@W>NJna18TM>R%@Wf2dHteWLi^zndVs=q37k*sil#u!`(P6td%lz6NDM)jf+ zhL5MjxTyhj5L`sOTn~KVLpfSe|7mdY&0Vmgg%MckxXV0aB zfmJ?Wo@k!=*3{U~&t28yr_!XHkJgl4h7o=4Kt*iVFUnCM5WFJeBIq`^8=|5t7D`qtEeZiX8TRSxh{TAA+04OkTn0Pd zNx#)mt?@Rlk6t9njl~MFBkAZr?H_K33#Kqskg@Wb)sT_(#0@gG(=i zZ`1N*Em+YHc=AM7h&nWl6?vCozX^-D0p5_K#ONo#*Qfg;O{k0?iAF!p&akTjtRqfb z=@eN5J;WXV8juzC>{EMxHcidbs;~sevI=lXDZq4>cUK{?AciAP1$^F3nZIFOCu=uy6(>jBN|slA972;ib}C}w zPzmW{&?nlx8rWl~8x94_ABbJ7duaE@%}pE^Z26!l-`|Z+=G=ZHw{vm6?Ge^U0n>;w z+Ge`MKlhv3CjSI~q0F2!J%B~2;uv^F*Ipy)e{(`nHwe_guoeYBzzHGU2hg=pki^LHax80!gC_*&dhu-q5WVYfpFXhWGAmb?b8-& zu%XWiEU@?swMSr5yoM{h=IPwbhEM;G6+1d*?KZP4oWw%hWaN4nMMPF9;;12{pQ5zN zB)Q)ZJ-ZM26a)9RuMM1emmt;4)RU~(dLgZ5LeX7irvt8Sq^&yqR}rL4-5mwpL$c_> zt*l1_&$smjF_$lPbA7B{q6twh`>91FL1%uygXJ%WSUKBZ3qu%#%2D7B*8Gks0_SCd z6HAb82kV`3poQm`E5gSRTg}3@({t14`LM^~m;ze$0dj%pJB3#11nzLMcD8U|?e~Tw zWq)hST-@-JDJ2l4CQqo~O}IqjXd)>q!)19p`Xx+XUZhhAf-HXLiL}B6#m#<;h>&35 z1i7BF~mR0(p*5OZQ-iRg|CDs_5MlD(C61da&_^=c4Mc=9;ZoViKWqk zWBN{xKP0dWHz2-eFEyox2SG!QvLs1On$>QQRSm&er`Th=xDxh^IPX^!W=Q6?%}W8W zRw?W!%+>P+yIoFMeC)y~zfHV9NKs3`x2R$w$w08A6eRg32$Fk}Y*2NLp-iEsj5XvY z>V?a6BEG0U#mpw3w9RG4`eILMoET7MGV3#cIBdn7rjrWeEKz{_#4ZDOdYvY#wEIF* z1|N4v|DBn*nN~+?G^@d`c?PX~zi4Dm9nsQ4Vq#@oWK0F5-io4LLFRo+7^HbeQOf-6dl=s*(?cy8wcw@-tQ{&?^?$K z$aV^N!isYxb1Q1%TI8hs3h07D@Yx1kZpv8-`xw8gJLU>d7V`Cq87}vzZ+D)-xEz(l z8V4tsU?L9Srl-|ken$H_gWHY1=tR$mZgP$j=^?mLN>JkPtni32_L~OrAVmyB2y8Z`fI>e3qJUHa}E3e2Gwi zkZCkr*we5M8Q{!a+b226F$?#@dZKzNCNKF(6ViV7bqYdl{ zz)B;+n0l+<+;Wz@NK#Va;M8RydXM`&TP+$5-B0 zl2Mnfhc(Tv0ORl+GgqvBhbt$C(den-=+wKmL_e*BA5!KN$2U1I3Tuu5+{bO@GzTC_ z(v`fBfkcoD<8raU&=bNYFE0lzCQmd8j4&@U-*UDygT}#p{D#l6B>|B#99g}C4qTX7 znty*uehZYZ6rXeQ-+PtuYyhA7?;6_jauL985xi_I&0mhv%)$ioS`>4M_A6i>?>9Xh zeY#kmnvOmK5QYclnKzYGiGK<=5=s~4^g`!*>Lbw%5e3U zYK4K-PQ^VGm42yWVV(G$+m$bXoCS^Szdq)$k%dqN$e~d@tAAi9p8tG)SxPtX^JH&o zTw$&F>{231djh_&>m-y3Iu6@7ghCHGy4&nkhXv8evDjWk`ClDeVgfq#{#DY5$=hfr z>huXBd+)PcBW`N6EDbe;N$qgPDpCZm*5=2%;rOG2#mWDOH6V|S8xoK|SUf&@Y_IUM z;iiC(oLyC)n0(z~W{`GweLU{~`KO`wdd7s03#?EhiVJy3_O8-Lkj*DN>PQAm9Nx*H z)+sWsAL{0dJ?#GJ@lqs^6oBr424I1Ig}#Jc;q4|SFC%0qG(%nnQ{`XUqDDm8&mO_x z$`%h#iD3U4TkZ+YLupCVBzCrXv1hF@wwObtC{oK`T29b@-3a?4(0W@>Y(jwsh>R#q zQ6lV-Vv2gI*7M(Lf${Y=5AdL#Z1Rw&5a8wTo1wxZW@{o`3FQitJb{)kK7?pl=IlE@83n6lVOK-IiwErpBk zg{6IbF|qM{T}nVEiuP7dGHAf{)ziNGF^!l|M65u~_k43oq^%Mza2h_2UewTK6Ygp( zhLS-Dj$b(ia`mX$jGJ$#^CI%&*00ji>W{WEXL=7GaEfA{6Xt@rt0_#Iob zRwV5ses)lza=i&1GH8cn9Dq05L!ZE0J5Z`B*{ak^M2Yb?ZQ${xFfSc4s1yi1plsKy zCV_LY-lQnyi~mdM1U+jMuxTgHri|y;l;nPt*ArN!7d1{&@3H~f2-brWqES+th1 zBZN)^jG43>DbD?LyMeZHrMl0Bk=IGet?souaJyuF9v=j;niW6(a>7bD+=2G?Q2FWV zzZ2h%bn@2|QqNUsU)r&6D$2H`GJ6NfERlwR7zYJ(NNSI0@(T4C4oIZI@GV}4XF`%O zJ1e;$f@Mp1#=G@!qL&N|z;Fh@5Cu64&MOroevbkMv*DG+X<1QP@ZU<`kS1&!Zm%L2 z8+}wV_1%NwAaAI|RF+SuNVSme$2Zs9j9_ii1|e?Ij%S4xoC}92oQP)<^V0EyR3BLB z9{1)IX@vF%R2C zDs2-l%oeKPKWeN|E4kUsYYP?+;H_z$|m%#ewQCXxE^XVTv!BJB;LFU7+km zDD{)3x#P`zwQgFc6e1}uCoS#fA|#)uV=R`7;CI%G7YPaD`QvZ(;K9PqX(QQTm-TT> zy0gMZxYw4Pu+>P$_?8K@vkA6VP)NDrR5|$G(h&zZPp0r7+h5SjC1XsxHzBO0As@WJ z_!pA9-&i%StkJ0^MC2yN+qDssP}A-%u3EW8q?j1p)=Oskg}-RPfIYCTW?-{WE@*h* zt9Ys62B6lmM2C_S!&<8JR6aOTgSOAAKn)qLWx9Mc#bkyzzxfyMJ4^JkBfh3<7RRK7 zA5V<)zr;FG7VmwxvZ)1e23=pU^Kzu}Zb*=&P89%s1Zj-+i-Qx3jXb>n!B~EFYN8^i zuC-@CGnh}q)bJBNmgNNM@!`wsO~(xi=Uwwf#EruUZ|};$0BesP=@OW$M$#BO<=>~c zi~glOLkU6}dY?p{D5?eKi$IN1!7yTlV<_73C>VEc5nS;m#E#IpsD#6l2Jn6r+r18NM>jZgI`LF;UO0gT;^v%)WlV& zkV=kdIkC-i63bkr#tK(17PK;!Q_ zob%MHW5QP5YAo^-#WNvpRU`mXywr{FHhFr%Dn86%04KELyeujgA89PSQ?zcvgzJ5TOd(q@z4-1KHlUZwc??RHfo#x6eqwyIY|ls zJGL<3VoK>>epMJKI@EaP_>r&&;y;!JJ|YVwEQWpvVUZ|kA|f;KE+|{o3bd#H)zmX& z+@?)z{gX5pDgLRZy*O+;DCQPEKBXjh;Sqt1u;RNQrUWMkFzEs z0Nt0#W8!imVL}^m#fo7aAB#$78wnZF|f5p7@=;lf0Yv8osxkXYZU$b^(6KI z9%)^b6l>cl;OB<{NY9n_Lp}u34jd6ZsRh|%Zm-Y1ebi_7DGK@CJ0AYRj}5aq%qpyg zgN%Jo))(ysujT(mYD|Hhr)^6(;d3+eX|%Bcy=$~bq7{IcQ}jI5XXo|~Ds-va5D}191YzHdv(%bDW zW2ypyk|1x~^;!+$QC1k9^0Z(-#UUEdO`Y^5hroy7lg(juE>pks-!Yhr4CI5!`&1gX zmmReGz@30D+s-Z>+J~nrFjSWdP%{ zC7Dm>Tmg;%>4;P_HXIU&iG8~3st6MWxrDQ){Q{V~tMJSTu>Xaxi^`aHI}$WET-WhD z@2zD{+oTbdqhT=4M7ptr@-0xlohWAVGwLQXt)Eenk1LLr7>e#$VTY zj-$e7hlX0S&_%<0n3htvT0z^hs@oDoc34AHl}=Ii!m$+13I*Mid7#{0eW4Mts2Pp= zOD)v7`TC~B8D>5g_PVUvGsx8((;77n7;b6%uvFsnWE#p;2O28SIkey-rXYn50Wi8@W(zn=8^?I_-3L` zu)J`%1GpTlC?@AVV`Fv?I>>8@s~|! zjk74@i8N84NQtSSfH1=-?lSV%?@C3%6&b^b1I=p}NVr6`55ko6(6jVpsj_3yCZge= zMQ?N0!~S2AjJ%#SB8oNAzPN*)0T&cDl^i6zetQ>Cb$UG?;nmgnDb|s{{jOZW_w!o1!AOp< zs=km&Rgl6x364K%&Z$72CY3H$KGNGfVA&3rTgg`aXc%!0VMe)Td1AYtq#ORP2->;E z3Xv?zKDt{eKff)+H%Q**QM;3FdCuihM8e*7WH30eNrw0s0^`(C6V&wSP59Gs#IxXh zv|_$1A}xr0piWuWH9U3Eq#9Yi?sJtrX0Xf00vfW~Lh4fMa|Wt+@)p?RJRupPJ;pCf z-;Rn?6N3jHPBNz+swXF7MO5b@XUA|t!H4?<=4xYp>(OPy|8^izb`tpK8GLYVJn>MK z2)tH8pZ{g7`CeXt2G@6Im+2v!>Dy?smqd&wIR>tZD~9_);0!#&b!!VtMMpxf-5qh5sg?g$yvME>|LBZG60Wg{buBleOlaLyw9C73|_6Z}BpdASeAWCN(E zDspu~BIL}_nOS;lvy4^$VxEk${<*ZpmPV){Wpj?`ha@B5&=%m_;b#fTJ%U{O>LH5p zH_Z4)V_jA0oA_i^nX&CxmDO~b#t`uGLw$zaaeW5Tq#FUU4s~sdz9AorpLPK2EAGwU zJ4yWNIOouNyz$DgmOEZGmE8hq(3%GeWW38sjAHf$oS?UgG{rZ~wgLDC?^V^;=Yb8S zKgZR2vj{0TrSqhbuHheJYNt*tA*H~fsp#EoYKZv?xGdTiP^ye(aCD#dt4hcDxLB2k zzO1X6x#^%{@|fm^6@xy#QO~=9i^Hm^H;+H!*Y-FuJE&zh+bGP+$yRg4Zypv6BHz@L z>h<5Lz1L&tv63e?6{~;{%}(Mbb6Mlmhk8o;Z((Q>nD82mBVit^EWv`I4_Dl|WlqW{MM_pA5+?PdqFGemT-=JrC*y zg8GGyQ5>o-RTn7%KebEw+_lmzt_Ov{eOq7*UV-njtZEJ#^upGtq+)mW;0zeM!|S?s znNP2Y)+Qhj;yBy@z_1Zc#iReGq9xj-q-MAK1no=4lcK%tOY1IQcW%hAvva5DJrb@( z0klWe4px@4!or*s+E=o)djFt#oIFvwOe;gPw)NEEO%H{`+X~AQJ99ys0v)MGs4|5{ ze`{$e#a@A9+JQOls}W=_G~gxId&O92L!f83`(8&jP$ss2zAG<`@|#m6LD*K66K|e; zml5(@Q-;NzxXm~+()GniFmJ*y`}D#!FyAu=I_S5n+XRG=ch8fqJk*s8VXEHK2Vr@4 zlPvs_8hG3}ZtljmaT|2_k?WM^l9!7NM%K8`1dzrwL+J0q{% z=+28a*IS>`HWR^{);K7`AYv#{pTSM5=b=JASC~64nmMGi7eUW`$N3Du<9wLHW#dMu zga12pE{YchO9r9bA{1MtF~(PBs`xhKalKdWi3bqZI6ebw-Gxz%p3Q;n9PsqVRME~= z6oFJAN+Qtzz3t9P4At!Z+Ohp{XCc9XT<1#9eCsY&ws^<+dp7<{oADudvr47o2Qvae ztUDI>^89D(SG+E2nrNea$joq);02gQ9hcrLcyG62KClj`rp$<5nZ|ow?u*I=HGlr> z`%T+Kqf=v^=ha$r*F;&r4LYFKfj1>n%j3y3`kF=Z5a@rHdq<_c)p0Ep?9jRrNk6$& z7lCQMz;KP#f89MBpwr~nYp>s;X&C?Tto9sVHu}AMHw(#Z4nm>YfCs0cs7K3ZqjRb3 z2S{bb_(Y#DBvzU&Hv{^L*sb|d3k#)b_%`|uPU#{O_40*Dx1MM!?b#0xI+Nhn3|rp` zw(-Ef4`nIvyq~g1`VD^RQ|`~5%M?BfSU;~34#bY~NRy(rKM(m@h?Q#gWL1U?2UEP6 zwl}oOcGA&nf#i31le`3Z%`b*W4S? zDFfiaBC^MQV+3CIKv29eZGM0oBYVG*_>W$Hdngd?PcN0V{+pb$gMumlW&BXkbuJTY ztw+ii;^g+#4R>+WIU{IHxYZ<4D?x!)4)|oiU7&O8Ckj{h!53oD7r6c5&zpsp+}aM6 zG{xmOU0)NfkW`y}rKL2lyiqccINir&n8aL11u~lnr2y_@ewK;y?myKAVc)!W%fIW1 z_-L)Q1W}(Y(#FztX3KIz3J~4S9LzL+8_uPZLJW7>yqWUtgHkT`nVvi2xT;)KIR#8A z6Jf{kAxLfkBwy!>r4H3lx9JiSNya|kxHxy}xl3#?D^gN}JKVE;Vc9xr_(rSa{EdCK zMaJ#YW25HC6Bglqnsu=jV#DJXEUJ+x;tv?W8m&Kwz1-dI&>fcps>j}Eo{(u6HiyoB z%iz6_zw79C#V3Q$&m|Ahr(c@G7sj2`0YB86sq#uw1{mAFSwRVX6N<1wZ3*&$9R13^ zlm3)H(5QVPOw!;_>CRMbSOJq4C}X?njmwuZBlLaFYj0@!AvuMi4sP#a1<-%v@!ABY zVv#ahU14q`>{Dub!a54g{WUq+3o^-)H3_4e={i?|`A&F*5PPE&(+RHo$wH63=>0ux zC}9VMV1PE`y|?MS?+`5bLZK6%7=Kg4HNZdUQc<3Hmo=KuRPM)=J^l{W@CZbL+OgD! zxes?QZK`ArA5y?xiP=lm0_xy#Vg;S;w8FyoKRRzosKyifa=ht5pk)e+esjF#s@YiDR>f? zKeiX0C@KPfKar^uUFoq4pE3iks!GvtP%c!k#~QXWNQIM2Qg8ZtcO#Z~$m`-h}} zx`Sd3)MJ>+%e&Z4D%gA1w~39bND+VG>{_zSvP+r$1+xGpy~weo_JiK!5vP+76+ ze~#UsBp)ZPcR)HXx4}jSy4HS;^AmqiOD82o^xfRb zU)@jm9nZnEz1xS%_t)?JRpP0|0oa>LL{ZyGGvvB4Bulm;-*&7Ou`|^B>^9#eq6X*@ z6Yz$Fim_UZt34suLM)l{KH6V|aS%3b3v5Y^Dh)O~AA~-QlWc-`U*1alLT-@?IiyB4 zS^9`bl&&p7&f`qHuy%If5!=Jaf%<=2=mi=3r^gS25xL?-W$^)f@~zlLn==U(MAJyp zW=)sBdF;=XbZi(m6e8&dIf2%MRp3g$z0~@SgHL|kR})m1<;jF}`%7M}!VBZn285as zVhG*4Ho;FbKT5ayZts!SyUjAaC8EIg8ALj|s~|Cfk)LO2&tl6v)f9`(I$5C+;^zgT z=UgRH-#f1fd;^(CfUkB`m@92_YCNa+iWbi#6LiY(tM#r6VbWhX?}m2UU}5{1#V$|s z`ht>obah)@mQTJ&NH0^7#flV_O!oi zHTSiP8p_n9vMD+9a57=3u~J z9#G%S=)Pwr!zw?1UsPB%wmpJP*}$QrV>NfC6$q|97Rw&oas0UUb)o_7Xj=^>5)>#A zKolVe-~DFlk40Y@?Od+wlDawC1#W-^zsjT5o$?vgT^KOw9W$j0S;Ji3qTnKLER~f^ zi;W?R*x0|z?B6ADNWQA`k@-?5jQ2dhKckKkXC`ARVw>LjqMcy8HqZob@#`#5pSin% z^RQgdp}Hw8Q9#m0GXzVr&>(I=Tp$v5 zTXXKR8Y;=x>p?{MjA&S~7S0^kj=i6ou5HV;lEC(v+Bo%@24LD}SlL3vtbd&=A9-1} z!HT8B3PvD>nok9tmfSNS$U#;^QW#B63G)xL0+Mzx3F&RN`tV8WPZ^E*v<&8FBz~!C z2eJJvwH=yEmOrj{e7`0_O;%StdG8?)R741>d(UVA6YQYy%s~xd!Y}lc-mz)-O~f+}9;U zBM*zV;Oyovl1fluDG{y64)Zu-6nGJ;1#gg{9jmzB?deWB*TjaGqsHl`q-iTZFbhAB zOj`E7RqtJ##E0ZaqBHtE@~`yTAhxR;dHTqa8qX$r1GUgoo^L1YCV1oLkIwFyc5OqG z8&kTtIyJ~Vj>`v7xjidG1#=sEo>q{DTuw=cjV5-r21?b{^duNd3xD?ggvBKm^_SVS8MN4oNg9S zgkQi3HM*YsQ2i*EuKJgfAN_n%pkRkOJ-TOKY?*ax#kMO6oXHpwv8bAMGFfDR)f7r- zfihl*Y@D4_^EVpg17^N*fKtCR9zSU1SbAls2AibI?Cad#?*e^D;{z{oUru@$=t{p` z#D(3c3>K%2T${~ZzN)8r<~Qt7GOj4 z&(1QLdr(|*7xKk#s8I;^D8>5&%1TT%%a>anQ7oG~6e7rwsy!Yu!X zrmJvkvj6&{yO9p*R9fkQN=QqCbayC7k1io_}+w)%6`w#4n z-6uYA&ezbO*|iIEq4ORTC*jh)DN{|VRJGwN(`V3qri*qWLM2ROEwTCRKc zHFo6+I#G!A{&xS-sQ{CTT42oYFs(=LquG}LuU?Vc3R<8tVktJ<;>pfaI4i~pZ1<#B z4-K}JnSxkPPMvifdS-jpH1hJBGMcd^(LetGE`YdLE317RQklEOicA9}O=%{Wa)<~` zjTx_?Z$i~zY&w^|*mwO_cx9Ob#_p!y*GkT3Xh=Hoa41X%Jkz2(5TE7g$#ohf`4}{; zY10&ZtK@Sb`A7g-2*?3SId=K0r2^{rf@I!Jy5!oyx1`>G&TGl0)9L-gUw{n^s&psH zMAA!7Y3?7`GTBDW*}?_p$;n3y{!~Ur<>NbysGvLWg!FhEM#NL+b47~?WT;`Q*7K#S zLI=To)@;M`%I2wH!g2*BaM5pb(avvFrYZJ_;d-GRFInVFjnC=*=&NtXlDSaGN0Y7_ z6b;fj*T$4x6PNR_bQ(`jJ7pt#pqucv?2SZIpfHdK)H&o#@#Q`UgAG{{t_xTF{4`WP zS3FH<_RP{6#8@T4~0PlQp$wudMfc{r?l1HhHRDYsS0F_+Jkjd`ni(b zD%ZVub?3y&A%tcY-(V~m{r8oc=TZXT$5v+hBj%TJ3zBX3@!7n#K~%3lr<@3ZpV4H+ zzkYVFbNoxOtaxRrMAmFQh~+iRBYIQLwn9_L_Sw%#j>Xa@-2gs5$YJ1v<4_Kk$Nlhj z#U)ETLf{+Qaz+@eqkb|^0o&_60|}w`8yac2B&})vyT({gTS{FHnp?bkFLlx<+9jhSsA+Vn zi>6h5>v)X{2;_ZB0rT0G-_ysm-YFo&fLiOZ^Z=ov*Xm!VQiz3J5YGpk8N9j@Mcq{f zn-;uj@LU-3QSci}PU_`PNXcc2!KfkKYO*Ji746Vp&)S2kORPL(MGy-uGp1E_=ejBw z(FD(5DsrNpE4N~s7sUe<87z@H%sWTU^Nmk8Hja3pC1MgiD6czlv*@bGi?3|?d|)_$ z^&<3~g4LTuU;gHdqkolnQ{Vnk+>2oxX(f?6lnY+M*dHzlE%B^FCmwny_{Mi#A*J*D zpRmxUN=^linw&b%pvq5@J0@vA9|pO61^yCHk5E#))f~NiHkG~xF;59%(kr2APe-rY zI?K>b%QXv{C)|9vjxqSg)*Ysld4sv7=8XKxUHzy9e?7Z3Tp~-^H`BJ_$G^-`5LKq= zfl*J)6)xf&F;3Eg^nm&ZUi)n8+R?RLTB8k&HWGYq0nqfcQPQ+uJJFg43As@+eKC2a zl{GcOoFobfp=XJ#-$|xrPM>uaNF5){;h5W?O}C#TUBeK)c#mQXFhAlstJT^0UFZ=% z=P>3QAuFI!Z{f@88)=5t4dw<*5rT4lcV#SqD0MAW)Cq!142+xPyRT!MDv*|Rh#rKd zty|BJij);|x-GTd5C5htd8dKgumiB#(CSLbx6&Rt8PVg~sUe=q#&pjbeDC0^yl!Id zcMTemYQ`E$yFX&>fz0U(+I|LdAbh%+DC zC%G55jFWO_0$%bomp#pceWjOw3#%}3BQZk5j`}lPl4HkeGv;`3Lvg?09TSRa-eqPN z6AC7OQL`Yp$=gWZ^yMg}bXbnHq&4e$-$*aeYs*|nB%oNh+R*R+>(G4+OD^s*pQ`@r z(aaKpx|sm|=csfOZfUlw!Q>${06UuI z^PIgXD*N}Ot_B!{!@#4-1)rb(MoZ?wKQv{EA5^^zAD>F9`V??M@K0-h{wu6T0yqz< z()PDG$g%T)~qJr`-7)nv(Ncr=!fjBaPGcX*zeW?Da6aL7UW4T zWKrzCK}Fs|Ta_-ZVcD~H?-QkJkN`Twx}q-RtaELnYRHYRz|O5Z3&i*9RRTWGdtwd% zH*TAr?>6hG^j(RtkOWE-t2GK4ciA!fR~JrsA}r)*tXSaPMM<3-J)2oPd(-jR98gcT zw1h}1W4bB}pYvYX47lRxoFLSN&(E*7by|Z)SIn7U$=w42id0s@&s^yK>FvtWTs>EO z%HVDR#xa7v?7t@E6#?5hi6nwvFgWe-07M~XUa@MjyUQtblB{I4_@ZxS&0-4fLP97M zYAtLun3I!L>sQ@xB~_)#yJtMAeP}w+ea36i?;T52jAivvcE8Lbst%T{KH>r_ zUvatw75iW)J~3A_r`bC=16dPfb$QbzN_Xh~8Q@Fe%VO^br!_+DEzS&Z0^*Z52joOr zX%)f5b(a3o;w|cJRjT*~yXeWi3Jbc=cRZybW8jCSK*KgaKRFw+z-&G-P$mv0~zKN6`OFZ8jULg+KixL-PL$rI+mu=7w|ylC*+Fe*cx=#$1Au;{Uj%wiFFYw(;``=_h)lr*MBJ0Gc&;rtkM*4s#MV z`az=W+G^~0>d^R}gU9}#47?2BuasI@tyiHKtiE4+{rZo1!d2x3jww^fic%1jr7>LM zI+z|CJhqP&P~6(iTiKzHqu14t6gC=%!@dZW9ECoHdff?RIEY6lRp@ef*?3LN?Wcku zd0JkXyQwrG%WqNi0Pwkl8rIONWQn09pH_mxQBC?XL#jH@w0O4_FGW}rL4wvVJ zCD|v{8oZAkSZK>Sl$77c61sgiXYOdWmv9axoK6HiZp0LL_Jd{fgISbJ_pKQ^}L z;q4RTjMQy#{$4PibTLZ#MYZ0r9-l4(ywvaK=zAvWn?|OhTuPbeYpmXrN|wwlJek%*1yI;1>84U5Sg!2BY0O1e zs*&mygz_940)DH#?mn0v4(i-(+8$Y1UngP-@e$|3ZjHWLKfT%Spw$4wYVoIoX_OQb z21|UG(}cS%vMB3SNsmKoYUt+GG5BS2EI}Ep4msTHmiIYe!;~C>*5fx5G;Oax*>_=2 zmxqZ+ zEb(LoKKE(y?$w%_nn{F&q6?U!Z=FkhtUl#M(KvuL3~n_70EA&bdi_#@CLuP$sbLKX z?K-i&*_L)xbRledei_t2M&Or0G3@~%^WJBNU&>C3`eC&Rg_70JrXCiu^}mbvTRQ1G z4G`;8L|Gvu^HOY45hYB6=*DkB3h#b4oySlj&3qNs>lS8KoyqJ3RC-co&LsSToAb|< z0L=;gbRe*-$;U%vT&>^B&KP1EeNtcP10ZawCZf0fG+{St75>etP|}N&II*@uy5*bU z=M|pDqB0w=$A2lNzv*<}am(^Wt1Q@wW3V)#7ryg)MHO7*l|WNq``M*FlX-It1A>&Q zJqKYEffAj9Noih(^(IzkA&G2TfS4_tlZXNH#SfY|BgLHIA_+&L6gieRtNk#ysQJze zeXKY4`2eCYyiN%Ho}o@tc>XV+Nb8pZsif$;_e-%}x8ih92Z}T6xx~{FUl+(XqGeqo;gnVq>-RW(@~m%ez4aD=C{8N!EvLTPx1Kk zvS+3s;F)m$unmn54Q0J~?@@7q(d&e8;+#Bmhp(9TbA)vTXklM4OO)OXE3-{ELO-_N zy&TR(Iy);`p7~fk6$-i!P}zWt;XYxoO_v134<_fyx`PGmr!S}#0;Y!N!jU28YtS30 zPo4&lRulXr(Ova{`2cfel>_YA#15xcAzO6G5_0ncS9rNj;O_D8*RVjwg{Lv`YlDhM`S~6K z2AS&%0Av$$9~tDlC!l{}T%|;ldc=)+`U)+;Or#5X!Zn)>5~(8=07^XTvHUTzQ0e#cyI(oHeQEU*gA;g7HHv72kK{|KD} zIWT@IELI>Z`1P-F$j6|~fn4NQx|V{9Fb}h>`jekUR25J#{Q^iBSp9%y45wYp6>&wM zkS|{VsO?u=eLiPMQr-Tko?_@7N$G1vI&RPkMN4?9rXTBz!o2;EO6k$_o?{ZNs?v3* z`kJP>WmwOa@V>;D9g9%f!GrzBs=#3*q7O25A7L(ZA8B#PSE(+WVZeAg({dY^p!0A{ zeE1#Rl)Cr+8C2!v(-1jC>LWZ4(h;2^o8W?OH@pavZ83klXersbpJxn!E=7Bezq*aD zVi%F9b}p4ydpvrhf&CdAOqb!GXx^#tb&a9K4OW4xnb69J_ZPPaG;ah5$S&M0Qve*g zNzdC)r;(tWiNsHRk~nx>^N8$Km(^PUWiaj2JF4F*(k{!-FwSW+XM*8pQ7g=9uUTqt zyh4s&Y@SG@Hi*q;YBFllNSeS=3!SzkLQ76c#D#{$Bo21ywzhLeCBEl?zGfB2-%Vst zy1_mqUaBJ8cPdyiEeqc(Xdhy}2*jRkeDTghF-$T1)!2P?(yRNkAzLQup|97jF4unh zfwNl%1wx&(1AGin31c`jA1%TS)g|Ot|Qif72=J%hQ%Asa7-{@n1&I2YSC|gfU;WZgdE^Gq`8 zRc&MKE{e{*31Q5$EVa&D&l>L)7fFDglw}!A3^%ZT>rw9u`+UDusnT4trt*%_T&z+L zPY-73z4eG$q37IyL2CPhkgL;6QDpMwZ~oeSGt`GSEge5kV3LbN@B>gxh-8w^G*zPA98se0|lY z;f9a)l1$POozo#zNDZuE9W`VA#3E0_=22c}EqbuJ4^7@D>k$Zk)>OCCzZTs`XT+zMUswwJMbSicF7rT-=QpDL zYQVZx;$f?l&3e4mtl#|6^uCXz-DG}v1k}mw)V1FRu=v;`ibhdJg{!~b3*yJ^*;D?W zcI_1pWvzo{UtIw(v8#CzfbXpws&BqHD{Dc1w0Po^I9PNF?i$bESrVbYoy31Wh!DM3 zfQ}Y%ZSph!hS)7bi)5E?-zi=`a~q@>0+@_0y(t(ay-g%{rp(+x2(8&roh>?w7V*8X z=zTM4^1wfuFN^{1+F@-+pv{=ohP4_E=dMllEMXNGzDEe{I>r0@wWa*5j z-9zEyK|Www`oqu9&-zzmm_>!ueRbh}-l&YiNEX-_1bIo;4WM!JrHsn|^03dz&g4A!oQ^HOq!MuA$)qt6hD+ib+$OHJCtlx=mM0 zym;|-X^m-ZnP=IXdYhY~6jM6oWKfJ%gr1zR!0{q|Ksf%1k&*P0^idImg2WU^Wi&MQ zBQQa#$m@|Y1&hiHHISsfbWM@)@#%E}q5H3xdAOuaZ8rScmLIS5 zZQ^>O{n$hH4D{$$R}@^`d62n`4#@j4zVs4wq30T;(#Vmu*$9oc5&Crp%5y>nzP!a6 zL_8gT$cHFF|D5l-r-IwzjGq=S3#%P8-_wP$U_?;wR_S&`Dac->9+9DQzFl%IT3vmQ zD_Aq>EF8xe1*@e=Kr=}lUIT{J{9eAL=a5R&jDIbR{VJu&#%fLadt^vfn}^u>yZ#~O z#3v6r&D$^_J_$#p6ILee@J+khLxpAY&hjTTxgTSpOAlgp4(n)hP0z&K(A1z5Pd6h- z?zyK8&|lZ-8a;4D~CfW>7%cp!rl@@>&$V|9o2&v z28L%aO3_dy;z;%lR`s4q8Yo@E?1`wqq(xMgnmqW4ED@SBC5#}4uq0DnMsA-T^C<{^ zs!DkC?_E?hyZauuZvAiWo+GTAU`x)m+@*sR385EC4fI7 z=cGs8;FW`~T}^XK!3lz(q5mR!X+!EZd6U1F8TxF0lM9aGajML_J~A=Te}}C8weXFD ziM@M)NoDci4|uah0mL6gi7o}i4nqt7+GUnu-p2T$-QBWjy3tv%%muH9Jk1XCF35S0 zAB3aJ2}1+V>isu07auC-)wj-@6>0lT!f0c`KU!Nm&ob~Pu5UXSLo|x6=B^}7z^&Iu zT5x?TA87vqzax|k)yYdDzy95Ls#0?f_GZ47!!-RGT}=F5oHX)#OK_dE|7pT?hR-@X zN&G|_$5pe9o{1~x&&){9!U(|R1VSvLr(YAB3o|#fl`2jJH%soo^DibZPhM7npEsz~ z_ECK0v%4&KAg9A4%|#`_sahm&)Bc>7xj4DSFIP6}`4IcT zJP&&hE>Vo;iyBPP_&1cI3wJy_&@PZWL-JNXPF4RN@7J6#)P`szAkaU95X8#_&Pa3Q z10xL#$A(7{Bn%$JKfnB3KK;f4-ANLV)58|+kwsL?#g_D4)Z}jbr4T1uJG&<#C&gi> znJC)CJ35-piTZ1)gCo_9_x@KZJex=YA%#VXeIAN1twWb_dFI zG82`8o|XGMdaXRqSDXk3_?-7x00o0J#H^+7pr7}^04JoW;Jp~|`s8n}$~Bc;#bYz{ zBE4%^_Ibg>t<*oJ@<&xlNRxR*_dIFl0w%Oa@SYYo)KpWn4$lGG&9M9h8sw;R<)RcX zbNmf(cD4V{77t}P*7#W};r`iilo?&+p$f@K$;{?Y%KF>azn{o?ERHnKL;xl4Z z7n0-WuXnw(m-%|toPI6UEo%blpACC8Ls8VS1hDR^y^_Znyhwgxt(ygTdj?GOe(KnK z31*=EK96F}%qKs4Ti_9fOGUrEzGD6?3HZG;D_Bn3CcEF#01eD$$^7f;9pY&x`FKt< zr0lZ6BL}cq?Wh--eoWEfY>|qg=6EOE=FQ#Zg4G-x_%r@ExpxaH&B=6=bD>t%f0Js7 z8imvTp`g)}2YTR%`cGHVD1StvwV0n>LR#h))kY@`^)rzlXb@(61zJwPOfZ|#FR0Xk z7cqyOmkDDVKs6%CvY@A|5KsDn(vFHLG9)kdMT`zyH4`DBj-wXU2v;v<#a5x-QGC8O zmvcVY{U|yq=R23EOEl6$N>||*#~vMoJYEuDd7i5QY%vErOW$=KX>K@tu)=G%)w@6(qko8&X%OoKraq=2>r#jD0;~z5!$U?e3M&@78}Vn$rT7 zEQ92fQdlqNRp3o?)-%7^szb(AVI+u!RtSSfpVO&MNE_oWiJ>vp&c62F`5edECL`Vi zW##cWd8y=)l-Ra69L3(U&&u;-=Fi|Hi|j=yeJ0`&_9zcB>8gXZ>VZ?0dYz=z?4;pVPP zt>65YW;o?o>fOh)iBH2UN$s7NHmmN31Ss0K`#dHDp`wI~{~TC)LEAt%5Sv+96YxEka3B??vVfT#BZ9~Ek;BV0JxepAssJipCe84e_czBc z{IY-oUCzf0E`p2hNV66Cw?bC*GYz$GEp1gbgl%%ehu2iyx`YJ_!VdXdAwY@zeJXWD z<#OHd>keftDA0@A!^cigVUJ2+FuG&Ms!u?*3+_mPtHJ!LgI$8=+Omi7Y$tAc83__Q zCB<0<=Cq(;q@fY~f-Xxyb@lh0{f#n-0=Z6IVm2VM2lbOuJsf>pD%k+TGAu;hv@q=; zp5_b8Q)cEF*v)Ldfe_!fmpeIFzyDQThVH&gAZ-3SToh$ zpokxWxop6$C`I;BbAjfg&UjoC9Hw`|UcfL@Xi`x4-zr5J?juM86j)Xjcs&)N33yn? zw2P8}(b`4j_+YOf)2}7xX+Kn#OROgdvL$^8eL8#Be!^r z;qHAE-F}VaszLtl!4j&BBtOJXmeP+;0s1&l%h+#K81O{#Tt+$j{Fh2m2by)n-(uBR zwnlVqUL`KvJ1C)j42N_<=H;30l48T0swoJgmK8FTiQ%|?5th1t`J?~M3aKHzwDTsJ zYG+TpnyLWV-undHavo)_IV0jBiJ{8 z;|wgrWctuh=%;p?5^rlOR~UK58elGM4Ei9pmz~Yvf~!cdqpU$Mu3Jc zJbU8v$bUnm>~^Gr=PB_`&1_c%wVBTO6Xj}*KnlYoSH#sn^U}qC&b|*7{kJ;N&X=4T zZlJthdQ*-w0OQEOs;v|lN<@=FV5hY(s|Kl@E#~p!zH*9?8LR)(fK6c{@@zf!tg9}3 zB{=nz<|KpQ&uRdDZ{u^UFmJ3EEiIX^Lc0uE5$vxBt^gl$t1t$nzxB~As+LWwDV8oW zGh1fzU{=niE83Z@#m2osiCL;>uOAkeh%0s9&GY4?oNl47mBbLe8~;d7(;k?8r;O~v-Ifd)1gQ_N7 zqIxmvSA)NQ>0tW*vO7q)>aqa2UF0P>cb@koZ#Y-ZJ?SsRn^tG{S4#l-lf`1e%6@prWPgKwis08W7QSoV09U zXpYA^0wot|fVNE28R*;-)cNu?ozdi~YM(NqH9x{v8@e*E!S?W#?L`-ec$4Gc*6?b8 zdD#LCl|Q&nWZW*q+TEIB^sdDKLrkjuTlh4C%nW^Afb5?0vcCLQA_J63OC)PZt%CM_ z^pTGau3-Fym*j?juM{!Hvv&WI`oJPw*&|m+wD~lBo$$S4n*)J##FjKJ#u}d%Il7qO zv#meOd6R)oV2wc^M!N^^z^Z)IKtf@bDNyW#!~v?eV~R(RY3+gQTQ@hMW<;YWsd=i% z-0OM~09iaDiNrNc(;|Aa%kTh9`uRz5;mKbsPoGpEInUMAtmIRkb*b74pwo~q=J^BWOJ#v?4A(xb$%q3WYLBaK<84jDi6 z(;t}Yk$2k*nF?9g^IR&xe~LzI<;qqo&gUn2R11*M^@y^XeLV09+v2JgQZfps{DpGj zj&-NjMYkZkK9N*Eu5D+?LmNSdS}uh$Wq1|?39mvSf{aTa?F=(n8ZPnRi%0h(ug3ey=Rs`&s4#OTBLKuT?iEcQZ~qn zMegv;uA=b9YL_#g!%U8mgdYYOdUvj0dzvjTKk$=%lDyl55F|j_N^=4;UP8Fy zE`Ur^9@b>7^zr6Esv|Fl+gT=idl$GA-qGR@iTMps9E{*vr~I*Z5;o!Q-;3gsP`9_& zQ{iI~aM7{1D0)Btd;D$27FK(iC>k0&O|2GxpVt=IDb3!mZKZ~HOJC>FG;f8;C2EPa zYOTBkwrtEBaH8Z)Zf)Igt%7`4-N~Y(u9u#w2J5Z-F@8a_)oLDjU2VS`y!XzPDag_v zZaJ19q61*bmDoELz-<2AYuHDf2=Z~Zfg_wJU{@7xr)NkB#is+zpU|A8fZ;`9#2c*M z`E|JFlk7g?_2^U-mDQxX>AGulv1&uK=8?>Es~n5D5>`_5yZq*KTxQ2!g(AB=^(f&- zwSFHbG_mZEul=J^g5q~j>PtU?_j>NQ+EAKWfY+Cg*m5tCLdh&UQ(Z0Vw0Hp&^$xNd(m#WfuoQ`RRt&fdaQ4L2yv01 zWkFm3CH}Fhyo@0pjkM<1BRpKfa4|!*mmDw&8SQ~l`4+usTdD8v_6~5Vt9eUKSwex| zpGr)2yxZmS6<=V4zAg&Yt$zI8yf6~%J*yg|W3LnktMPu~iZXk_jGPbH%TJDM3|jzM z2VBglesW9?0W4zlZ>X^p%E}5yTo5C;`Qb?|8mOFW{h*HTpdJz>ZzfUux0lq=#aTxR zfteFjX;Km9XY!#oUcokK-fF+H*_TBcVxP2lA(?Pyx{hDnZ~Pdzf(vlH+(oUX?`lN} zCW~Sv(8ZJUjhr#zsF@WoNlu^{7jxH1*R?YZqOEHYMdxFnsS>PV>0m{sQzHy1=&+}T zy+X{NKP-_nNEV8r4Pe>QxV+;UJX9_&pu{xB6?8{alx-PMicl+7c|z|-yiJS0{eTmy zLKhOHM6y>@n;oX(8t&ZaOYZUb{sy zM1e#yb+ei@ICykiW73Abv;izqos$iCd51f=TDZSkEixZW!Gv&0Mb`(ky;sgqFyxdj zyPgot+ZZph6k_b3lBW-OA9i%t^l^G?cucyzVG>C|gQ)dngk_<&*-+W5o(-$ZHsJj0 z8O_<71$P^P#5%Q%P;zEdQOm%Q6BZzlx9~e>ND#V|=Jp>?7pfJC>En=5-O|mPcD16} zWW0cSvhv_3>G7+B^epohEG54d%oxoOYXU*6kgiBIL$`m+{oYKFQPCbOc_{hm@9+R1 z%0%`>cWf&f!(0mvZvCR>dX1MR0GT#50*13yQxsq4qCB=wsqTHy4WCiXsL9kc#+8-L zuqcvxC;8Bw4^|tm5cJi=rcPQ9USPu$F8E3hJTkdMW5VY$E5ovtTbaj(PF5yfL+d_m!Z*B z4RZ#v^GbT()MbNe`w&T1dB}M!_-14>^TLzH$?7StB7f?OEfSuY)c}MwF1Lq|_fql>Q*s=wSwmI_pYb0h%iLSLJ*i zw>I5xP|6p7bjm#lu3M{_dm`lDqmigg#eq;^4yOy^p?|jvG?iG$f@4xyOI`}<4PWSpWP-9`apGIE-GL>01rRF})Mq4G=nDrqxvqTJU?4%*u)7rRc~S zpZ5zx*E<5tU&2ZW!zs}P2|=gezH21`?msJo3Zr%}Tzj_?R>r;GjOex}Wr7$>n}idA zl8HCTP-3H-_Sb)e0?&LtT`=(@cN?cm#!AkNrb4~?gjqDv!m=v4KztBErMtdfxyI6QIVSnr+ zQ4>^NN|A4DOW|050tKA=wA>x$22B38zf)=JD5{dNXWj(CrQksw2dl%LwE)g~N}3a1 zu3i-C}?O=AJ7M9D<_M#f9;Pcsx8VTtr_@gzw{X%|y| zPtDPO5u=J52R-~LOz5u3)m#YeR}EXrA!S66_+A`$hDDV^Q74}PDvtWSQ1tTM!(HFY zSAl2tSFWv94YO~Z92}H`ba^X;%W!!R^4JspnM_BS8ko`}+VotO!ouGIE$PV5{{WrM z(3UJ5&+MmwIB=MGk2JCptM<$7ydQ%NCh&1`>N9*5TE)h7u9tN2TeWKrOuF!N!v&k; z;fSgHo|gI28a-v=OceX5B8Ge^dO5VrfTOu)k@J~ zR@C~PhqA6ZOP}i;!i+EJ4betS zBfMC*wx#1m`o~Yo#iJqvf}>{Uxr?8VEF(*~Llo)WuF!p6GJgh|i|Tkdbvdo*N8_`3 ziZ9mN7GUbJWNIx}y8D!mME6dU9mOG$?V~-g#t7#8{B`g`9$fa_1g}`QJE!?NTifettv>G0cOO zyST{?^SQ+m)YdilwZZ+5gWwI@DFJfrGP1_dKQrq}j%S-e1uJ^A(4@lz8Tq2I`0(#} z64sxvor~p1qC&`75;1RR!rsC*_lgvC(IA`_iw(a!icRYBJ7_Yj_OJO6za z*Qim=zfrS7t{m}6#g4T+Y$4b=L8hcOuE6NW&sUR3R)3IlKPVY>=D?V`;Bz^1EN3Jd z|HWhJ%H^N+W82(quCV}$MkOUx*i6Ikw>2%Iq>b`p)i3RF(me*B6Nc0Oz;vJ}BrhB* za!~6{b-uzlPDS=_cV={9bS6@`>5OE(JbrDYqIb!GI~p!czV+ArD|)>t8ZrDpz6x^z zRPxF?d5T%|VN#%G@V)p&duNVF%^MiFxSis-(K;$<@2FOtZ=eJVc4fY)!0cHO6FD57^#)1`2pMyG{N zg$ZU?5$ zwWsn7Bl3YoE#~(>E_(3%a*ADXSzr~zIn@-tw{K4wx3F1Z_qZ!^ZGmJz+ay&wQJ0L+ zI9E5{8L(%ln@A3ch!t?`m)-5x_#4rmESPgp4AjH4ML6#f{^aIQ$2)ztaOII zwN)O&hySoi*w7~e)kB$gKp_6><*%uMwLRAxWa(K$dt9Ajf8Ko!%ub^``pY@f)y?tK zab%j)gNHD@Lqh7(rQt!cM?<6<^XIV~3qeP@U}-G5G9HDwLtfJ08%TZJHw`l!_LsTo z+uQY*T@uEmlC_Vhk6)BTqT(mzQ{e$gL@+%StlC)1XggZ@F~;Z{OqDg84WxZfQfdA8 z+IlINnh-=V_ivuWTf@~$Y!I(NEcA=J31zb4*55f+0{3^?Q^XcuFR2Y*ji*KuZ=X(< zr$%z?I_71);*YmuIC|fCuZ^vQZpmS>pLVk?NcQE2^-!F!P(OQ~>*jCt!mWMp)CG`M z-+S4q-8h*=NM0~QKobw*sKC!m-wT8<{{s-Gd$O8&43Bzvs)f%_er*9B9iCT)HTJ!i zCd1Ekwb!|Cx*k&E55Q?Nbm$jZw!?XsIgrFxaP`6Q=f>^(aK{QjB^QAnZuAjqfXWU= zZueli4f`Y@p11bicG2D&VUcI$Is%0$FEJGNU>w1|%1tn>AlJ zUtEasF}3HhLwm-QFy%Jw2dcs)T1HZYoY> zjccqCIg`=@XlK1|<6zI5nt7{te>Djv>eCG0^uhzu8ybCt`&9W@ zoCUi~tvliPKaI3Jvc}#pN^vP1wU<&?it3FMDU|%wMW?p>vPG2tYFq?+Q^yHf9U@uq zq3A5ZTQE|LKlg(tx#DIZBdIaD02{8zS|HIkFUx`>)As-J9FsKUG7lWR8*B(~wM?GM z;6^Y&AuI=ee~6ybbwaFNQQQ0$%@121r*aLeUoI?w1p7I4Ss(v>A9Q&h| zccXvLPSzhwzBFGpN0HWr@i4phAjJNfm`pT9w5|kKg#TzI{y;gT4#Vri8v(~bd&%F# za9z^cJUF>wZ+wfzl%{hqiNXDL(pUg&lG*ueN*U;UUD->*1!IsMwM3d$5;()__Gi|Y zrs^VP`DPf7YH)Sm!FqAISXq^{l-=lyDBngjVT=h$U8)FtA+!1-2PWZPcRU<;T}M{>8Y9b7vY{wg{R2Q~N}y52>T*^F z81-msxF?c#fk^EO)_U}}c+tJ|IcX)-y7T4k%z7;`B<9`F)fVg6+ppVGgq#w5>?fo@ zXgt3ZVxa!_dW|i-CCtPdjY;B61iNW8)_-AN`#x@QU$bwZj9kza{U>IhAG^tQvS{7W zWHy=aE61WCoT~8PR|KJGRF?cMNh9gjAIVmV5Qr)dGq#ZCchbY zs_}FPNnS=FgcM3hG>jZ&(PX4hTGB~9ULf-5&nbW~ytGH9_rGv1E)wv(=?9ABnW*~H zK8&3JE?}v?KU_EHMJKz-LUe2MfjkJ`Vwwz>rr*E7X1&Rt(%9KAP__P7km0tENYvw9 zIdZVJ+qUTi^FEmoh%{3h`&g@-0&BzQglK#Yn~4J3FbNOwd~*02RMx?ZDg$} z{MXG@#vbZJ6alTi{T^rRCiIl($Fl;&UD# zEu<5!G;J-Gy`Re);;cnPMQXqXMd+c7n+4&$0v#>p#u~XKeLQ)u?yoFDcjQrV<|hz= zT&5tHztEGN8{IBe=VDkbrd3e&e=Kj4w)C756HzCKP$SP}Z0nSiB3;6~m$Z0`SMO%| zBkf^`2jl3r0&{<=pbny%xhHfaTx&F0fo{RUy*CG_{tlz>mq|J&CIs2u64pEtOhft` znL^%@{zVvuFmfsRFay0QB9LY+k9(}QQoaWy#E^QOC?hs0%H4`K^1$>Fe?w0y+{pJ@ z>N|MnQ?Z-a~$@l;IR04j|9K?iRgIj-(;AqezNu++fPVg`z_rp-wTyI^|lZ2f#Uc`qRfLuXE>RJOdo2^06huBFfKvn zZi}XFupXMBi-*snabI#3TgNxM7hE9O%O#6B9yX>LH5O(2Wy`agLi|R)J}vWXN*CQG zEsQ&iw^}tbVwM`Cke2I;lTjq!@18*PS5~}kxg`?QEV$Z1+PKJC$t$AntwZ_T`Tahw;ijHctE?vfH=axIi(5+~rLMz^mlx0ADtD$}`Gh9MMz z{zELVdZ^EKUhssMF}yeF7u4DnHDpI(?TUnm_fMH@4@cQOWnYmVr?JR%KSPV*Q9h=p zSU0R!`1$JCjaL(uK?aj|0|ce&x3hj8Z!60sGSumO)Uh~WpZ&mkYIHr)Xi5HUMqXRO zZ#R!OBv`+$>XA*J?Bh$zDPV$55S=cl{Bx^hsn2ciRX%VU^vv7BIvQNYJ?3HeW9Vr@!5o$C_A@@MbG!SQ;idj;3sS{3MFo1Fi` z8~h7+w0&}~QZyUL8e-Dn6_z+J%umr0DKBG*LZ=jLfJx#JN|vFjSQR<{dqtt|h@V>T z@OlJLb?6LJ>dUD^bBr#G7o$MeQHN`%pDpJ2M`&MSl}4-gxYCHDlSDU32`5FW;K$kW zmlv*Q`WIWDO_Qws-0e3bkBw;%+RW>W{jmvK{zP-wL8*$b_QrGZ7OC)7S<|QtRxn?N zt8W>d($Wl{_B_7cLG3mkbGlJ0#7tSK!mWSKF7q3erNnD!hn_ zjktp{w{)f5w19M9cA5L6=YB5n=%i|E;GDT$7&M( zidYxh?0zpGJ3ZAVZ8ZzA?R!Wzv=FYjY~ucfdVCX!*WyNpc)9#um~3HfT^R3AKg8^U z-urQw*`cqjt`e-TuWQg(=wMy$(+~f#SNvG0iq~8-%qPeJPhEJb>s>)ER#uVpgSvhd zAjAh-(j|0FF=bVEt2t60CmRD7ge_p6E3AvS-7a|kUjR|Prb`MVBq>aTr*cwX$bKEN z^vv<}8VjDT$6gnbbEm0H{@;~4T0viay0;->Hh@-f!HJJ`v29kb*qW4iqbnhj1QlZUypX%7m(a)|SR;^OOG? zEwjik`_o5KhASl~CC70||6dsg62I4;*spe-3S2{7^Y2kIoP(=DRPOlou zt|cY|HnI1NG)qJ!-i**utC-6k6f?>Nla zTvl3A|4`evAZ*sMv;NHCl0f77Xh<43dD*YKndF~QE|3d(f86qT>zguU_i+2SBQZ7V zq}sL~T|1`ak0FQskDXg(6w<>YezqL89GdVk&KU0yf{Clz6(2)#cipMEy9A%T2Fl9T zDk>?xt}|@-Nn$DZmNIuVp@}R6M6}eb;R7#|Wm?rg28!TvOn=4a=*d70VT+zFJ6`hj ztOO&9Q0J5d*ZqP9%WK|}A-qU>ik{Dg^Z2qtl zE?eE40>1aSF^EkPy;Ev%aM1snEN2tSgU)l~Y?q;^smP?6%&nxKv{>_g(ye4UiraJ$y75OA_4h zAYk9xj2O$6n3nn%>uHF2!`DYytBrj~;yt-iv2lX@+;Ww6TdA6UcPyNv-SR!RRC6B@ zn^P^$JO0WDKiJGZG~$&tqioHbw;|8{RyJM>;S(2|ywsQoc@L>yXG=@V5>QZ3*o60S zyJRd~hNwht4BV0^Obk3=3sLE%Lr$69?ts&W{vZVtxh>v>8nIeNg!AM{}7LHq6if16Wg z9L?E!JdU0$w0L4CtbCp#Q;W0ca|f9aOXT7-WU~x(-%EZAKOmlpX?dJ6(Ik3C+srGd z6IVf${Kolh&6*JxQP`{c2Kj!Qh^XGG1{Ysv6d2>2CfyzN`vU-An!kT1uj}#h;Q+1h z6gI3{R7ApW-i?U1%eFIl?VZcOEzKMLzm;zGd-Hnt`mGUvepf!wjwY!BC{i~<#LOq&K=fF>AiM|8xKXZ z2(oQm{Mx4FdZYd$(+AcDJaH;*jxK6@_yRs$>?>3ddr@O!@#El$6DRJ+-MRQtUVulp zKZNJWe#vz!xf(=;R1duVSG#)M;nnB9M{&K{_4)at@Z%-vl}y_hv)n=t+;S9V-_*tE zTxjq2X=kMErq|XtF71wp?KA$9v4nF9^U7z%IvWE6eDW6WIN@yF6;~3`(S0GeWZssA zE^d64;#1BrEjr|L%kiIr%es}HTiFgh2~uCRbEUwfnvW&SRe>+h*gVYk)VF)I)n*dA z@|hFY*iBKcKcjY%}u=RSDZ*$#-F!Ja`MN8TWDN>K=UryaY&2Mnhe|p-~FBw)mIE$SD7zk7`Ff8oxlS(mx_ftbs41lu(Uir zY2LPcnR#mlUzDbTmyc2F{FRm`61D%yO0@|^#DsmncR=&dCadOUr!B00y*O3C@KVS0 z%gGf|a#F8!{d?X@=})h}v$5o5|3Zc@QT5;coqhAuv{>}tlU*zArZR9ZscoqHdE)Bl zd-gjEM9*>TFH5TVw&|nOYt!dq?B}yvby-#~Hmv?J@s;c@C)=;TwqJdAkFRv;(|Pl4 zOdfqH2%Wc0AffkAVox{s^qR`QBE4q*f|G4a<+Or7XYnj&GZ#6OSeiGT)!pWKux3I;mZ#vPMf^B>+$bn>ZjT--YJjWxhHw{2MgK5b(*v5 zLX1rx&y8;vbqq+@xgqyA^YxfZbr1Gfu2p3@8&;f_9~#a7$Dua)w{F(mNs6UhuRC{q zDZe%M+WpJtT!SSff~O|WogH**`RWOkH@x=zobL7aLI0Gf;Uy}i9yv!GU$a{6MabN&$-A}+YcE-q`0tRiL9u|t<&fD*QqN~cT>L)aFt4pK zJLCCI_XElg1V3<8u-GukG4?kM2kwLaf=vI}n_m5vTXtdACI%qzboFyt=akR{0Gl;_ ALI3~& literal 38871 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

    cqCAWosO|yA|~U+dD7VdY^6FnzR{R#9`!iz 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 aq1>I2mZM&`OgwSm Date: Wed, 12 Oct 2016 20:19:09 +0100 Subject: [PATCH 41/84] Updated Speedtest logo (#1222) --- source/images/supported_brands/speedtest.png | Bin 78313 -> 3426 bytes 1 file changed, 0 insertions(+), 0 deletions(-) diff --git a/source/images/supported_brands/speedtest.png b/source/images/supported_brands/speedtest.png index adc57126b7d835c7f4f297a553339de58309bfd2..ceb4712a9703d51690473b30673ad61001e9c241 100644 GIT binary patch literal 3426 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 VEQfk8=HF=o80Z?qYqTAs{{!ROf4Tqw literal 78313 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 From 28ce65b1c1bbdb2cb810ae50b2d81f555fcbe9fc Mon Sep 17 00:00:00 2001 From: Zen Tormey Date: Wed, 12 Oct 2016 14:20:41 -0500 Subject: [PATCH 42/84] sensor name vs platform name (#1219) * sensor name vs platform name Added note about difference between platform name and sensor name. * added p tag to make warning more noticable --- source/_components/sensor.darksky.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/sensor.darksky.markdown b/source/_components/sensor.darksky.markdown index 4e7b672a75e..5f3b643bebd 100644 --- a/source/_components/sensor.darksky.markdown +++ b/source/_components/sensor.darksky.markdown @@ -86,4 +86,8 @@ Configuration variables: - **units** (*Optional*): Specify the unit system. Default to `si` or `us` based on the temperature preference in Home Assistant. Other options are `auto`, `us`, `si`, `ca`, and `uk2`. `auto` will let forecast.io decide the unit system based on location. +

    +Note: While the platform is called "darksky" the sensors will show up in Home Assistant as "dark_sky" (eg: sensor.dark_sky_summary). +

    + Details about the API are available in the [Dark Sky documentation](https://darksky.net/dev/docs). From 1fb9476b322c0556759515eebe42e8b66ffb63be Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Wed, 12 Oct 2016 16:17:09 -0400 Subject: [PATCH 43/84] Update digital_ocean.markdown (#1226) --- source/_components/digital_ocean.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/digital_ocean.markdown b/source/_components/digital_ocean.markdown index 7e20f8dc5d2..b82d7c412de 100644 --- a/source/_components/digital_ocean.markdown +++ b/source/_components/digital_ocean.markdown @@ -19,7 +19,7 @@ The `digital_ocean` component allows you to access the information about your [D Obtain your API key from your [Digital Ocean dashboard](https://cloud.digitalocean.com/settings/api/tokens). -To integrate your Digital Ocena droplets with Home Assistant, add the following section to your `configuration.yaml` file: +To integrate your Digital Ocean droplets with Home Assistant, add the following section to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry From 57cfb4a8ab4270bf0a82d8437b241b8efb17f19e Mon Sep 17 00:00:00 2001 From: Marc Plano-Lesay Date: Wed, 12 Oct 2016 22:18:07 +0200 Subject: [PATCH 44/84] Minor improvements on the light.hue component (#1225) --- source/_components/light.hue.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_components/light.hue.markdown b/source/_components/light.hue.markdown index 538ab564064..e53c4c0c76c 100644 --- a/source/_components/light.hue.markdown +++ b/source/_components/light.hue.markdown @@ -13,13 +13,13 @@ ha_iot_class: "Local Polling" featured: true --- -Philips Hue support is integrated into Home Assistant as a light platform. The preferred way to setup the Philips Hue platform is by enabling the [the discovery component](/components/discovery/). +Philips Hue support is integrated into Home Assistant as a light platform. The preferred way to setup the Philips Hue platform is by enabling the [discovery component](/components/discovery/). -Once discovered, locate "configurator.philips_hue" in the entities list ( < > ) and add it to configuration.yaml. Restart home assistant so that it is visible in the home assistant dashboard. Once home assistant is restarted, locate and click on configurator.philips_hue to bring up the initiation dialog. This will prompt you to press the Hue button to register the Hue hub in home assistant. Once complete, the configurator entity can be removed from configuration.yaml. +Once discovered, if you have a custom default view, locate `configurator.philips_hue` in the entities list ( < > ) and add it to a group in `configuration.yaml`. Restart Home Assistant so that the configurator is visible in the Home Assistant dashboard. Once Home Assistant is restarted, locate and click on `configurator.philips_hue` to bring up the initiation dialog. This will prompt you to press the Hue button to register the Hue hub in home assistant. Once complete, the configurator entity isn't needed anymore and can be removed from any visible group in `configuration.yaml`. -Restarting home assistant once more should result in the Hue lights listed as "light" entities. Add these light entities to configuration.yaml and restart home assistant once more to complete the installation. +Restarting Home Assistant once more should result in the Hue lights listed as "light" entities. Add these light entities to configuration.yaml and restart home assistant once more to complete the installation. -If you want to enable the light component directly, add the following lines to your `configuration.yaml`: +If you want to enable the component without relying on the [discovery component](/components/discovery/), add the following lines to your `configuration.yaml`: ```yaml # Example configuration.yaml entry From 88a0c90ab02da068e2faf83eedb66c0c94478a5b Mon Sep 17 00:00:00 2001 From: Marc Plano-Lesay Date: Thu, 13 Oct 2016 15:39:30 +0200 Subject: [PATCH 45/84] Update media_player.yamaha documentation (#1229) * Update media_player.yamaha documentation The documentation wasn't up to date: - `source_ignore` and `source_names` were not documented - source selection has been around for a while. * Rework media_player.yamaha documentation Remove optional attributes from the main sample, add a second, more complete sample. --- source/_components/media_player.yamaha.markdown | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/source/_components/media_player.yamaha.markdown b/source/_components/media_player.yamaha.markdown index 85e9cc2b508..d9eb6138fa1 100644 --- a/source/_components/media_player.yamaha.markdown +++ b/source/_components/media_player.yamaha.markdown @@ -34,11 +34,26 @@ Configuration variables: - **name** (*Optional*): Name of the device - **host** (*Optional*): IP address or hostname of the device +- **source_ignore** (*Optional*): List of sources to hide in the front-end +- **source_names** (*Optional*): Mapping of internal AVR source names to custom ones, allowing to rename e.g. `HDMI1` to `ChromeCast` A few notes: - Not specifying the host variable will result in automatically searching your network for Yamaha Receivers. It will add a media player device for each one. - In some cases, autodiscovery fails due to a known bug in the receiver's firmware. It is possible to manually specify the reveiver's IP address or via it's hostname (if it is discoverably by your DNS) then. - Please note: If adding the IP address or hostname manually, you **must** enable network standby on your receiver, or else startup of Home Assistant will hang if you have your receiver switched off. -- Currently the only controls that are available is Power On/Off, Mute, and Volume control. Other functions such as source select are in progress of being developed. +- Currently, this component supports powering on/off, mute, volume control and source selection. +A full configuration example will look like the sample below: +```yaml +# Example configuration.yaml entry +media_player: + - platform: yamaha + host: 192.168.0.10 + source_ignore: + - "AUX" + - "HDMI6" + source_names: + - HDMI1: "ChromeCast" + - AV4: "Vinyl" +``` From ab79ec28bc8be5d8f9cd829e4d7de976850404e2 Mon Sep 17 00:00:00 2001 From: John Lindley Date: Thu, 13 Oct 2016 09:40:37 -0400 Subject: [PATCH 46/84] Fix missing hyphen (#1231) --- source/_components/binary_sensor.nest.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/binary_sensor.nest.markdown b/source/_components/binary_sensor.nest.markdown index 88aee1f9790..fdb8f187f48 100644 --- a/source/_components/binary_sensor.nest.markdown +++ b/source/_components/binary_sensor.nest.markdown @@ -27,7 +27,7 @@ binary_sensor: monitored_conditions: - 'fan' - 'hvac_ac_state' - 'hvac_heater_state' + - 'hvac_heater_state' - 'hvac_aux_heater_state' - 'hvac_heat_x2_state' - 'hvac_heat_x3_state' From 05ac937ac004ba66510019771029f3636a852d3c Mon Sep 17 00:00:00 2001 From: Magnus Ihse Bursie Date: Thu, 13 Oct 2016 15:42:00 +0200 Subject: [PATCH 47/84] Fix typo in example (APP_KEY -> API_KEY) (#1230) --- source/_components/sensor.darksky.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.darksky.markdown b/source/_components/sensor.darksky.markdown index 5f3b643bebd..dfefbd20770 100644 --- a/source/_components/sensor.darksky.markdown +++ b/source/_components/sensor.darksky.markdown @@ -27,7 +27,7 @@ To add Dark Sky to your installation, add the following to your `configuration.y # Example configuration.yaml entry sensor: - platform: darksky - api_key: YOUR_APP_KEY + api_key: YOUR_API_KEY monitored_conditions: - summary - icon From 53330f33407066fa0f7ddb98917c8acef572fd31 Mon Sep 17 00:00:00 2001 From: Marc Plano-Lesay Date: Thu, 13 Oct 2016 15:43:39 +0200 Subject: [PATCH 48/84] Better device_tracker.owntracks formatting (#1228) Improved formatting (e.g. italic instead of inline code where needed), minor typos --- source/_components/device_tracker.owntracks.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_components/device_tracker.owntracks.markdown b/source/_components/device_tracker.owntracks.markdown index 78eb5a7d5c1..7d9717ad18a 100644 --- a/source/_components/device_tracker.owntracks.markdown +++ b/source/_components/device_tracker.owntracks.markdown @@ -49,16 +49,16 @@ device_tracker: Owntracks can also be used with other device trackers, such as [Nmap](/components/device_tracker.nmap_scanner/) or [Netgear](/components/device_tracker.netgear/). To do this, fill in the `mac` field to the Owntracks entry in `known_devices.yaml` with the MAC address of the device you want to track. This way the state of the device will be determined by the source that reported last. The naming convention for known device list is `_` and could be set in app configuration. More details about this config can found in [device tracker](/components/device_tracker/). ### {% linkable_title Using Owntracks regions %} -Owntracks can track regions, and send region entry and exit information to Home Assistant(HA). You set up a region in the Owntracks app which you should name the same as your HA Zone, and then make sure to turn on the `share` option for the region in the owntracks app. Please see the [owntracks documentation](http://owntracks.org/booklet/guide/waypoints/) +Owntracks can track regions, and send region entry and exit information to Home Assistant (HA). You set up a region in the Owntracks app which you should name the same as your HA Zone, and then make sure to turn on the `share` option for the region in the owntracks app. Please see the [owntracks documentation](http://owntracks.org/booklet/guide/waypoints/). Home Assistant will use the enter and leave messages to set your zone location. Your location will be set to the center of zone when you enter. Location updates from OwnTracks will be ignored while you are inside a zone. When you exit a zone, Home Assistant will start using location updates to track you again. To make sure that Home Assistant correctly exits a zone (which it calculates based on your GPS co-ordinates), you may want to set your Zone radius in HA to be slightly smaller that the Owntracks region radius. ### {% linkable_title Using Owntracks regions - forcing Owntracks to update using %}iBeacons -When run in the usual `significant changes mode` (which is kind to your phone battery), Owntracks sometimes doesn't update your location as quickly as you'd like when you arrive at a zone. This can be annoying if you want to trigger an automation when you get home. You can improve the situation using iBeacons. +When run in the usual *significant changes mode* (which is kind to your phone battery), Owntracks sometimes doesn't update your location as quickly as you'd like when you arrive at a zone. This can be annoying if you want to trigger an automation when you get home. You can improve the situation using iBeacons. -iBeacons are simple bluetooth devices that send out an "I'm here" message. They are supported by IOS and some Android devices. Owntracks explain more [here](http://owntracks.org/booklet/guide/beacons/) +iBeacons are simple bluetooth devices that send out an "I'm here" message. They are supported by IOS and some Android devices. Owntracks explain more [here](http://owntracks.org/booklet/guide/beacons/). When you enter an iBeacon region, Owntracks will send a `region enter` message to HA as described above. So if you want to have an event triggered when you arrive home, you can put an iBeacon outside your front door. If you set up an OwnTracks iBeacon region called `home` then getting close to the beacon will trigger an update to HA that will set your zone to be `home`. @@ -73,13 +73,13 @@ When your phone sees a mobile iBeacon that it knows about, it will tell HA the l To use mobile iBeacons with HA, you just set up a region that doesn't match your Zone names. If HA sees an entry event for a iBeacon region that doesn't match a Zone name (say `keys`) - it will start tracking it, calling the device `device_tracker.beacon_keys`). -This allows you to write zone automations for devices that can't track themselves (for example `alert me if I leave the house and my keys are still at home`). Another example would be `open the gates if my car arrives home`. +This allows you to write zone automations for devices that can't track themselves (for example *alert me if I leave the house and my keys are still at home*). Another example would be *open the gates if my car arrives home*. ### {% linkable_title Using mobile and fixed iBeacons together %} You can use iBeacons of both types together, so if you have a Zone `drive` with an iBeacon region called `-drive` and you arrive home with a mobile iBeacon called `-car`, then `device_tracker.beacon_car` will be set to a state of `drive`. ### {% linkable_title Importing Owntracks waypoints as zones %} -By default, any Owntracks user connected to Home Assistant can export their waypoint definitions (from the `Export - Export to Endpoint` menu item) which will then be translated to zone definitions in Home Assistant. The zones will be named `- - `. This functionality can be controlled in 2 ways: +By default, any Owntracks user connected to Home Assistant can export their waypoint definitions (from the *Export - Export to Endpoint* menu item) which will then be translated to zone definitions in Home Assistant. The zones will be named `- - `. This functionality can be controlled in 2 ways: 1. The configuration variable `waypoints` can be set to `False` which will disable importing waypoints for all users. 2. The configuration variable `waypoint_whitelist` can contain a list of users who are allowed to import waypoints. From a89456fb43084bf5259a4a22a7f7e6d5822ec95d Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 14:31:20 +0200 Subject: [PATCH 49/84] Improve readability --- .../_topics/splitting_configuration.markdown | 33 ++----------------- 1 file changed, 3 insertions(+), 30 deletions(-) diff --git a/source/_topics/splitting_configuration.markdown b/source/_topics/splitting_configuration.markdown index d0031fa20f9..8f1851e14ef 100644 --- a/source/_topics/splitting_configuration.markdown +++ b/source/_topics/splitting_configuration.markdown @@ -58,10 +58,6 @@ zwave: config_path: /usr/local/share/python-openzwave/config polling_interval: 10000 -#zigbee: -# device: /dev/ttyUSB1 -# baud: 115200 - mqtt: broker: 127.0.0.1 ``` @@ -115,10 +111,7 @@ This (large) sensor configuration gives us another example: ```yaml ### sensors.yaml -############################################################## -### METEOBRIDGE #### -############################################################## - +### METEOBRIDGE ############################################# - platform: tcp name: 'Outdoor Temp (Meteobridge)' host: 192.168.2.82 @@ -134,27 +127,14 @@ This (large) sensor configuration gives us another example: payload: "Content-type: text/xml; charset=UTF-8\n\n" value_template: "{% raw %}{{value.split (' ')[3]}}{% endraw %}" unit: Percent -- platform: tcp - name: 'Outdoor Dewpoint (Meteobridge)' - host: 192.168.2.82 - port: 5556 - timeout: 6 - payload: "Content-type: text/xml; charset=UTF-8\n\n" - value_template: "{% raw %}{{value.split (' ')[4] }}{% endraw %}" - unit: C -################################### -#### STEAM FRIENDS #### -################################## +#### STEAM FRIENDS ################################## - platform: steam_online api_key: [not telling] accounts: - 76561198012067051 -################################## -#### TIME/DATE #### -################################## - +#### TIME/DATE ################################## - platform: time_date display_options: - 'time' @@ -165,12 +145,6 @@ This (large) sensor configuration gives us another example: - platform: worldclock time_zone: America/New_York name: 'Ann Arbor' -- platform: worldclock - time_zone: Europe/Vienna - name: 'Innsbruck' -- platform: worldclock - time_zone: America/New_York - name: 'Ann Arbor' ``` You'll notice that this example includes a secondary parameter section (under the steam section) as well as a better example of the way comments can be used to break down files into sections. @@ -196,7 +170,6 @@ We offer four advanced options to include whole directories at once. - `!include_dir_merge_list` will return the content of a directory as a list by merging all files (which should contain a list) into 1 big list. - `!include_dir_merge_named` will return the content of a directory as a dictionary by loading each file and merging it into 1 big dictionary. - #### {% linkable_title Example: `!include_dir_list` %} `configuration.yaml` From 3e9e98f1def3b3fb65365479074db67b7b596e7f Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 11 Oct 2016 15:09:29 +0200 Subject: [PATCH 50/84] Acc. to the component code platform is required --- source/_components/switch.pilight.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.pilight.markdown b/source/_components/switch.pilight.markdown index 9cef19c95cd..c8a28e1e9c6 100644 --- a/source/_components/switch.pilight.markdown +++ b/source/_components/switch.pilight.markdown @@ -47,7 +47,7 @@ Configuration variables: Variables for the different codes: -- **protocol** (*Optional*): Protocol to use, eg. `intertechno_old` or `daycom`. +- **protocol** (*Required*): Protocol to use, eg. `intertechno_old` or `daycom`. - **systemcode** (*Optional*): The systemcode of the device. - **unit** (*Optional*): The unit to use. - **id** (*Optional*): ID of the device From a6158ce0e539c08bbf9727b4c5ebe6bd3f9280e1 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 13 Oct 2016 22:32:12 +0200 Subject: [PATCH 51/84] Add `send_test_msg` description --- source/_components/notify.pushetta.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/notify.pushetta.markdown b/source/_components/notify.pushetta.markdown index f417fce68be..d458c0eb51f 100644 --- a/source/_components/notify.pushetta.markdown +++ b/source/_components/notify.pushetta.markdown @@ -33,6 +33,7 @@ Configuration variables: - **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`. - **api_key** (*Required*): Your API key for Pushetta. - **channel_name** (*Required*): The name of your channel. +- **send_test_msg** (*Optional*): Disable/enable the test message send on Home Asssitant's startup to test the API key and the existance of the channel. Default to `False`. It's easy to test your Pushetta setup outside of Home Assistant. Assuming you have a channel *home-assistant*, just fire a request and check the channel page in the dashboard for a new message. From 8901eaee0df2f14703045b790aec860cf7fa8ad3 Mon Sep 17 00:00:00 2001 From: Keyasha Brothern Date: Fri, 14 Oct 2016 00:52:47 -0500 Subject: [PATCH 52/84] Slight edit to sentence structure line 12 (#1235) --- source/getting-started/securing.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/securing.markdown b/source/getting-started/securing.markdown index 6ada6bca125..690d8a210a0 100644 --- a/source/getting-started/securing.markdown +++ b/source/getting-started/securing.markdown @@ -9,7 +9,7 @@ sharing: true footer: true --- -One of the reasons to use Home Assistant is that it's not depending on cloud services. Even if you are only using Home Assistant in your local network, you should consider to secure your instance. +One of the reasons to use Home Assistant is that it's not depending on cloud services. Even if you are only using Home Assistant in your local network, you should consider securing your instance. ### {% linkable_title Checklist %} From 627ed3bf9af30892ac2fb8fd5dd527060b5be904 Mon Sep 17 00:00:00 2001 From: Saumya Balodi Date: Fri, 14 Oct 2016 17:02:33 +0530 Subject: [PATCH 53/84] Fixed a few grammatical errors (#1240) --- source/getting-started/index.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index 93310a612af..454ec2f8152 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -9,7 +9,7 @@ sharing: true footer: true --- -Below you can find the standard instructions. See the sidebar for installation instructions for specific platforms. If you're running a Linux-based platform, we suggest to follow the [VirtualEnv Linux instructions] to avoid having to use root. +Below you can find the standard instructions. See the sidebar for installation instructions for specific platforms. If you're running a Linux-based platform, we suggest you to follow the [VirtualEnv Linux instructions] to avoid using root. [Virtualenv Linux instructions]: /getting-started/installation-virtualenv/ From 67c7620845292075c5f050443aa3e4361067d075 Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Fri, 14 Oct 2016 12:30:55 -0400 Subject: [PATCH 54/84] Updated link (#1243) --- source/_components/notify.telegram.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/notify.telegram.markdown b/source/_components/notify.telegram.markdown index 54124b855da..530439dac71 100644 --- a/source/_components/notify.telegram.markdown +++ b/source/_components/notify.telegram.markdown @@ -17,7 +17,7 @@ The `telegram` platform uses [Telegram](https://web.telegram.org) to delivery no The requirements are: -- You need a [Telegram bot](https://core.telegram.org/bots). Please follow those [instructions](https://core.telegram.org/bots#botfather) to create one and get the token for your bot. Keep in mind that bots are not allowed to contact users. You need to make the first contact with your user. Meaning that you need to send a message to the bot from your user. +- You need a [Telegram bot](https://core.telegram.org/bots). Please follow those [instructions](https://core.telegram.org/bots#6-botfather) to create one and get the token for your bot. Keep in mind that bots are not allowed to contact users. You need to make the first contact with your user. Meaning that you need to send a message to the bot from your user. - The `chat_id` of an user. The quickest way to retrieve your `chat_id` is visiting [https://api.telegram.org/botYOUR_API_TOKEN/getUpdates](https://api.telegram.org/botYOUR_API_TOKEN/getUpdates) or to use `$ curl -X GET https://api.telegram.org/botYOUR_API_TOKEN/getUpdates`. Replace `YOUR_API_TOKEN` with your actual token. @@ -55,7 +55,7 @@ Configuration variables: - **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`. - **api_key** (*Required*): The API token of your bot. -- **chat_id** (*Required*: The chat ID of your user. +- **chat_id** (*Required*): The chat ID of your user. To use notifications, please see the [getting started with automation page](/getting-started/automation/). From 8d30a599bbba4db1d92284e2ead4de1adc6863f1 Mon Sep 17 00:00:00 2001 From: Dylan Barlett Date: Fri, 14 Oct 2016 16:46:02 -0400 Subject: [PATCH 55/84] Fix typos (#1245) --- source/_cookbook/apache_configuration.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_cookbook/apache_configuration.markdown b/source/_cookbook/apache_configuration.markdown index 5921f85214b..626538d33c5 100644 --- a/source/_cookbook/apache_configuration.markdown +++ b/source/_cookbook/apache_configuration.markdown @@ -35,7 +35,7 @@ To be able to access to your home assistant instance by using https://home.examp ``` -and make sure that this file is read by apache's main configiuration file `/etc/httpd/conf/httpd.conf` +and make sure that this file is read by Apache's main configuration file `/etc/httpd/conf/httpd.conf` ```text ... From 1e1c1ebf9b29fb45870179653c191c2553b8de0e Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Fri, 14 Oct 2016 16:51:20 -0400 Subject: [PATCH 56/84] Removed reference to use_trigger_values (#1201) --- source/getting-started/automation-condition.markdown | 7 ------- 1 file changed, 7 deletions(-) diff --git a/source/getting-started/automation-condition.markdown b/source/getting-started/automation-condition.markdown index 165c5172af8..8c54c6861aa 100644 --- a/source/getting-started/automation-condition.markdown +++ b/source/getting-started/automation-condition.markdown @@ -11,13 +11,6 @@ footer: true Conditions are an optional part of an automation rule and be used to prevent an action from happening when triggered. Conditions look very similar to triggers but are very different. A trigger will look at events happening in the system while a condition only looks at how the system looks right now. A trigger can observe that a switch is being turned on. A condition can only see if a switch is currently on or off. -If your triggers and conditions are exactly the same, you can use a shortcut to specify conditions. In this case, triggers that are not valid conditions will be ignored. - -```yaml -automation: - condition: use_trigger_values -``` - The available conditions for an automation are the same as for the script syntax. So see that page for a [full list of available conditions][script-condition]. Example of using condition: From d4691f1594ed5730bba238d76b412d3e32f97754 Mon Sep 17 00:00:00 2001 From: Shawna Date: Sat, 15 Oct 2016 02:03:23 -0400 Subject: [PATCH 57/84] Fixed wording to be more clear, removed a typo (#1248) --- source/getting-started/z-wave-settings.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/getting-started/z-wave-settings.markdown b/source/getting-started/z-wave-settings.markdown index ce0caf178c5..64102acd8f6 100644 --- a/source/getting-started/z-wave-settings.markdown +++ b/source/getting-started/z-wave-settings.markdown @@ -9,13 +9,13 @@ sharing: true footer: true --- -You may wish to modify the Z-Wave settings in your `ozw*.xml` file stored in the `.homeassistant` configuration directory, or certain situations/devices may require it (i.e. Aeon Multisensor 6). To do this, utilize [Open-Zwave Control Panel](https://github.com/OpenZWave/open-zwave-control-panel). Alternatively, use [Domoticz](https://www.domoticz.com/), which incorporates the Open-Zwave Control Panel project into an easy to use Raspberry Pi image. +You may wish to modify the Z-Wave settings in your `ozw*.xml` file (stored in the `.homeassistant` configuration directory), or certain situations/devices may require it (i.e. Aeon Multisensor 6). To do this, utilize [Open-Zwave Control Panel](https://github.com/OpenZWave/open-zwave-control-panel). Alternatively, use [Domoticz](https://www.domoticz.com/), which incorporates the Open-Zwave Control Panel project into an easy to use Raspberry Pi image. The reasoning for using these tools is that your Z-Wave controller stores the values and data that are used to control the network. The XML file in the `.homeassistant` configuration directory acts as a settings/values cache for the Z-Wave network, so modifying it directly won't change the network values. The [Open-Zwave Control Panel](https://github.com/OpenZWave/open-zwave-control-panel) writes values directly to the network and will provide you with an updated `.xml` file to overwrite in your `.homeassistant` configuration directory. This is the most foolproof way to make modifications to your Z-Wave devices. -Although totally normal for your Z-Wave stick (Aeon Aeotec Z-Stick Gen5 for example) to cycle through its LEDs (Yellow, Blue and Red) while plugged into your system. If you don like this behaviour then you could turn it off. +It's totally normal for your Z-Wave stick (Aeon Aeotec Z-Stick Gen5 for example) to cycle through its LEDs (Yellow, Blue and Red) while plugged into your system. If you don't like this behaviour it can be turned off. -Use the following commands from a terminal session on your Pi where your Z-Wave stick is connected as an example. +Use the following example commands from a terminal session on your Pi where your Z-Wave stick is connected. Turn off "Disco lights": From 8d23174919a77d420cd7ccf99a9153c83cc9848f Mon Sep 17 00:00:00 2001 From: Shawna Date: Sat, 15 Oct 2016 02:04:04 -0400 Subject: [PATCH 58/84] fixed a grammar error (#1247) --- source/getting-started/z-wave-device-specific.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/z-wave-device-specific.markdown b/source/getting-started/z-wave-device-specific.markdown index 6c1b10ef605..f59cfb74462 100644 --- a/source/getting-started/z-wave-device-specific.markdown +++ b/source/getting-started/z-wave-device-specific.markdown @@ -11,7 +11,7 @@ footer: true ##### {% linkable_title Motion or alarm sensors %} -In order for Home Assistant to recognize well the sensor, you will need to change its configuration from `Basic Set (default)` to `Binary Sensor report` or `Alarm report`. +In order for Home Assistant to recognize the sensor properly, you will need to change its configuration from `Basic Set (default)` to `Binary Sensor report` or `Alarm report`. These devices will either show as a binary sensor or a sensor called `Alarm xxxx` and will report a numeric value. Test to see what value is what. Sometimes this is noted in the device manual. As of version 0.30 you can set the settings of a Z-Wave device through the dev_service page of Home Assistant with the service: `zwave/set_config_parameter`. From d62fed49dd3a9600ad998651679cce29e3da32eb Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 15 Oct 2016 13:16:59 +0200 Subject: [PATCH 59/84] Use same style for template as in ha --- .github/PULL_REQUEST_TEMPLATE.md | 10 ++-------- 1 file changed, 2 insertions(+), 8 deletions(-) diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 98b1d287d55..7e57b113669 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,11 +1,5 @@ ---- +**Description:** -***DELETE EVERYTHING BEFORE SUBMITTING YOUR PULL REQUEST!*** -If you are submitting docs that depend on a pull request to be merged in Home Assistant please reference the PR like so: +**Pull request in [home-assistant](https://github.com/home-assistant/home-assistant) (if applicable):** home-assistant/home-assistant# -`home-assistant/home-assistant#` - -Thanks for submitting! - ---- From b2f59aebfa9c0f839c0440185a29117d90c82076 Mon Sep 17 00:00:00 2001 From: Kumar Gaurav Pandey Date: Sat, 15 Oct 2016 19:11:55 +0530 Subject: [PATCH 60/84] Fix typo in getting-started/z-wave (#1251) --- source/getting-started/z-wave.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/getting-started/z-wave.markdown b/source/getting-started/z-wave.markdown index a02dd34e850..0b26b56cd41 100644 --- a/source/getting-started/z-wave.markdown +++ b/source/getting-started/z-wave.markdown @@ -130,7 +130,7 @@ cat /dev/urandom | tr -dc '0-9A-F' | fold -w 32 | head -n 1 | sed -e 's/\(..\)/0 #### {% linkable_title zwave.network_complete %} -Home Assistant will trigger a event when the Z-Wave network is complete. Meaning all of the nodes on the network have been queried. This can take quite som time, depending on wakeup intervals on the battery powered devices on the network. +Home Assistant will trigger a event when the Z-Wave network is complete. Meaning all of the nodes on the network have been queried. This can take quite some time, depending on wakeup intervals on the battery powered devices on the network. ```yaml - alias: Z-Wave network is complete @@ -218,7 +218,7 @@ The `zwave` component exposes ten services to help maintain the network. | add_node | Put the Z-Wave controller in inclusion mode. Allows one to add a new device to the Z-Wave network.| | add_node_secure | Put the Z-Wave controller in secure inclusion mode. Allows one to add a new device with secure communications to the Z-Wave network. | | cancel_command | Cancels a running Z-Wave command. If you have started a add_node or remove_node command, and decides you are not going to do it, then this must be used to stop the inclusion/exclusion command. | -| heal_network | Tells the controller to "heal" the Z-Wave network. Bascially asks the nodes to tell the controller all of their neighbors so the controller can refigure out optimal routing. | +| heal_network | Tells the controller to "heal" the Z-Wave network. Basically asks the nodes to tell the controller all of their neighbors so the controller can refigure out optimal routing. | | remove_node | Put the Z-Wave controller in exclusion mode. Allows one to remove a device from the Z-Wave network.| | set_config_parameter | Let's the user set a config parameter to a node. | soft_reset | Tells the controller to do a "soft reset". This is not supposed to lose any data, but different controllers can behave differently to a "soft reset" command.| From 6d8079ca7757e8ee1521c53f1868230c057a02fe Mon Sep 17 00:00:00 2001 From: Greg Stevenson Date: Sun, 16 Oct 2016 16:58:11 +0100 Subject: [PATCH 61/84] Typo and grammatical updates on keyboard component (#1253) --- source/_components/keyboard_remote.markdown | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/source/_components/keyboard_remote.markdown b/source/_components/keyboard_remote.markdown index 21e41b58cb9..f5fdf73b1e0 100644 --- a/source/_components/keyboard_remote.markdown +++ b/source/_components/keyboard_remote.markdown @@ -15,11 +15,9 @@ ha_iot_class: "Local Push" Receive signals from a keyboard and use it as a remote control. -This component allows to use a keyboard as remote control. It will fire `keyboard_remote_command_received` events witch can then be used -in automation rules. +This component allows you to use a keyboard as remote control. It will fire `keyboard_remote_command_received` events which can then be used in automation rules. -The `evdev` package is used to interface with the keyboard and thus this is Linux only. It also means you can't use your normal keyboard for this, -because `evdev` will block it. +The `evdev` package is used to interface with the keyboard and thus this is Linux only. It also means you can't use your normal keyboard for this because `evdev` will block it. ```yaml @@ -34,11 +32,11 @@ Configuration variables: - **device_descriptor** (*Required*): List of URLS for your feeds. - **key_value** (*Required*): Possible values are `key_up`, `key_down`, and `key_hold`. Be careful, `key_hold` will fire a lot of events. -And an automation rule to bring breath live into it. +And an automation rule to breathe life into it: ```yaml automation: - alias: Keyboard All light on + alias: Keyboard all lights on trigger: platform: event event_type: keyboard_remote_command_received From a39b33de8abbe59f1fea42213b1eb91188e33f10 Mon Sep 17 00:00:00 2001 From: jack Date: Mon, 17 Oct 2016 12:22:48 -0400 Subject: [PATCH 62/84] Update python_api (grammar, clarity) (#1256) Small edits for more legible docs. --- source/developers/python_api.markdown | 34 ++++++++++++++------------- 1 file changed, 18 insertions(+), 16 deletions(-) diff --git a/source/developers/python_api.markdown b/source/developers/python_api.markdown index 0cda0a22496..c6cac2a041e 100644 --- a/source/developers/python_api.markdown +++ b/source/developers/python_api.markdown @@ -11,9 +11,11 @@ footer: true In the package [`homeassistant.remote`](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/remote.py) a Python API on top of the [HTTP API](/developers/api/) can be found. -This page is not a full documentation it's more a collection of some example. A simple way to get all current entities is to visit the "Set State" page in the "Developer Tools". For the examples below just choose one from the available entries. Here the sensor `sensor.office_temperature` and the switch `switch.livingroom_pin_2` are used. +Note: This page is not full documentation for this API, but a collection of examples showing its use. -First import the module and setup the basics. +A simple way to get all current entities is to visit the "Set State" page in the "Developer Tools". For the examples below just choose one from the available entries. Here the sensor `sensor.office_temperature` and the switch `switch.livingroom_pin_2` are used. + +First import the module and setup the basics: ```python import homeassistant.remote as remote @@ -22,7 +24,7 @@ api = remote.API('127.0.0.1', 'password') print(remote.validate_api(api)) ``` -This snippets shows how to use the `homeassistant.remote` package in another way. +Here's another way to use the `homeassistant.remote` package: ```python import homeassistant.remote as remote @@ -35,7 +37,7 @@ living_room = hass.states.get('group.living_room') ### {% linkable_title Get configuration %} -Get the current configuration of a Home Asssitant instance. +Get the current configuration of a Home Assistant instance: ```python import homeassistant.remote as remote @@ -47,7 +49,7 @@ print(remote.get_config(api)) ### {% linkable_title Get details about services, events, and entitites %} -Similar to the output in the "Developer Tools" of the frontend. +The output from this is similar to the output you'd find via the frontend, using the DevTools console. ```python import homeassistant.remote as remote @@ -72,7 +74,7 @@ for entity in entities: ### {% linkable_title Get the state of an entity %} -To get the details of a single entity the `get_state` method is used. +To get the details of a single entity, use `get_state`: ```python import homeassistant.remote as remote @@ -86,13 +88,13 @@ print('{} is {} {}.'.format(office_temperature.attributes['friendly_name'], ) ``` -The output is composed out of the details which are stored for this entity. +This outputs the details which are stored for this entity, ie: ```bash Office Temperature is 19 °C. ``` -The exact same thing is working for a switch. The difference is that both entities have different attributes. +Switches work the same way. The only difference is that both entities have different attributes. ```python import homeassistant.remote as remote @@ -107,7 +109,7 @@ print('{} is {}.'.format(switch_livingroom.attributes['friendly_name'], ### {% linkable_title Set the state of an entity %} -Of course, it's possible to set the state. +Of course, it's possible to set the state as well: ```python import homeassistant.remote as remote @@ -118,11 +120,11 @@ remote.set_state(api, 'sensor.office_temperature', new_state=123) remote.set_state(api, 'switch.livingroom_pin_2', new_state=STATE_ON) ``` -The state will be set to those value until the next update occurs. +The state will be set to the new values until the next update occurs. ### {% linkable_title Blinking all entites of a domain %} -If you want to turn on all entities of a domain, just use a service which was retrieved by `get_services`. +If you want to turn on all entities of a domain, retrieve the service via `get_services` and act on that: ```python @@ -139,7 +141,7 @@ remote.call_service(api, domain, 'turn_off') ### {% linkable_title Control a single entity %} -To turn on or off a single switch. The ID of the entity is needed as attribute. +To turn on or off a single switch, pass the ID of the entity: ```python import time @@ -156,9 +158,9 @@ remote.call_service(api, domain, 'turn_off', {'entity_id': '{}'.format(switch_na ### {% linkable_title Specify a timeout %} -The default timeout for an API call with `call_service` is 5 seconds. Service +The default timeout for an API call with `call_service` is 5 seconds. Services taking longer than this to return will raise -`homeassistant.exceptions.HomeAssistantError: Timeout` unless provided with a +`homeassistant.exceptions.HomeAssistantError: Timeout`, unless provided with a longer timeout. ```python @@ -180,7 +182,7 @@ remote.call_service(api, domain, 'turn_on', {'entity_id': switch_name}, ### {% linkable_title Send a notification %} -The example uses the jabber notification platform to send a single message to the given recipient in the `configuration.yaml` file. +The example uses the Jabber notification platform to send a single message to the given recipient in the `configuration.yaml` file: ```python import homeassistant.remote as remote @@ -192,4 +194,4 @@ data = {"title":"Test", "message":"A simple test message from HA."} remote.call_service(api, domain, 'jabber', data) ``` -For more details please check the source of [homeassistant.remote](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/remote.py). +For more details, please check the source of [homeassistant.remote](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/remote.py). From 7586adf82876bd7d243d83b4e8e9306ea291a4cd Mon Sep 17 00:00:00 2001 From: jack Date: Mon, 17 Oct 2016 12:23:51 -0400 Subject: [PATCH 63/84] Update rest_api.markdown (#1257) #1052 - grammar fixes for docs --- source/developers/rest_api.markdown | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/source/developers/rest_api.markdown b/source/developers/rest_api.markdown index f6947f38f37..f52f9b5e913 100644 --- a/source/developers/rest_api.markdown +++ b/source/developers/rest_api.markdown @@ -54,7 +54,7 @@ Successful calls will return status code 200 or 201. Other status codes that can The API supports the following actions: #### {% linkable_title GET /api/ %} -Returns message if API is up and running. +Returns a message if the API is up and running. ```json { @@ -142,7 +142,7 @@ $ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ ``` #### {% linkable_title GET /api/events %} -Returns an array of event objects. Each event object contain event name and listener count. +Returns an array of event objects. Each event object contains event name and listener count. ```json [ @@ -193,7 +193,7 @@ $ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ ``` #### {% linkable_title GET /api/history %} -Returns an array of state changes in the past. Each object contains further detail for the entities. +Returns an array of state changes in the past. Each object contains further details for the entities. ```json [ @@ -377,7 +377,7 @@ Returns a message if successful. ``` #### {% linkable_title POST /api/services/<domain>/<service> %} -Calls a service within a specific domain. Will return when the service has been executed or 10 seconds has past, whichever comes first. +Calls a service within a specific domain. Will return when the service has been executed or after 10 seconds, whichever comes first. You can pass an optional JSON object to be used as `service_data`. @@ -416,7 +416,7 @@ $ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \ ```

    -The result will include any changed states that changed while the service was being executed, even if their change was the result of something else happening in the system. +The result will include any states that changed while the service was being executed, even if their change was the result of something else happening in the system.

    #### {% linkable_title POST /api/template %} @@ -443,7 +443,7 @@ $ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \ ``` #### {% linkable_title POST /api/event_forwarding %} -Setup event forwarding to another Home Assistant instance. +Set up event forwarding to another Home Assistant instance. Requires a JSON object that represents the API to forward to. @@ -455,7 +455,7 @@ Requires a JSON object that represents the API to forward to. } ``` -It will return a message if event forwarding was setup successful. +It will return a message if event forwarding was set up successfully. ```json { @@ -476,7 +476,7 @@ Requires a JSON object that represents the API to cancel forwarding to. } ``` -It will return a message if event forwarding was cancelled successful. +It will return a message if event forwarding was cancelled successfully. ```json { From 4f7481e2d0a4dc5cf3621ce31307a0ed13b739d7 Mon Sep 17 00:00:00 2001 From: jack Date: Mon, 17 Oct 2016 12:24:41 -0400 Subject: [PATCH 64/84] Grammar fixes, server_sent_events.md (#1255) Reworded a few sentences for clarity, fixed some grammar, added a link to httpie, and put more detail into some of the running instructions. --- source/developers/server_sent_events.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/developers/server_sent_events.markdown b/source/developers/server_sent_events.markdown index 76716100ed6..502642e2edc 100644 --- a/source/developers/server_sent_events.markdown +++ b/source/developers/server_sent_events.markdown @@ -22,7 +22,7 @@ $ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ -H "Content-Type: application/json" http://localhost:8123/api/stream ``` -For more comfort put the HTML snippet below in a file `sse.html` in your `www` folder of your Home Assistant configuration directory (`.homeassistant`) +You can create a convenient view for this by creating an HTML file (`sse.html`) in the `www` folder of your Home Assistant configuration directory (`.homeassistant`). Paste this snippet into the file: ```html @@ -44,7 +44,7 @@ Visit [http://localhost:8123/local/sse.html](http://localhost:8123/local/sse.htm ## {% linkable_title Examples %} -A simplest way to consume server-sent events is `httpie`. +A simple way to consume server-sent events is to use a command-line http client like [httpie][https://httpie.org/]. Installation info is on the site (if you use Homebrew, it's `brew install httpie`). Once installed, run this snippet from your terminal: ```bash $ http --stream http://localhost:8123/api/stream x-ha-access:YOUR_PASSWORD content-type:application/json @@ -52,17 +52,17 @@ $ http --stream http://localhost:8123/api/stream x-ha-access:YOUR_PASSWORD conte ### {% linkable_title Website %} -The [home-assistant-sse](https://github.com/fabaff/home-assistant-sse) repository contains an more advanced example. +The [home-assistant-sse](https://github.com/fabaff/home-assistant-sse) repository contains a more advanced example. ### {% linkable_title Python %} -If you want test the server-sent events without creating a website then the Python module [`sseclient` ](https://pypi.python.org/pypi/sseclient/) can help. Install it first: +If you want to test the server-sent events without creating a website, the Python module [`sseclient` ](https://pypi.python.org/pypi/sseclient/) can help. To install (assuming Python and pip3 are already installed): ```bash $ pip3 install sseclient ``` -The simplest script to consume the SSE looks like the following snipplet. +The simplest script to consume the SSE in Python looks like this: ```python from sseclient import SSEClient From a324cfc3aa688e7f029d78b4451a17b52dfd4a7b Mon Sep 17 00:00:00 2001 From: Georgi Kirichkov Date: Mon, 17 Oct 2016 22:33:13 +0300 Subject: [PATCH 65/84] Updates the influxdb documentation with minimal setup instructions (#1242) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Updates the influxdb documentation with minimal setup instructions - Adds instructions on creating the default database, which were previously located in the blog post - Clarifies that the default influxdb configuration doesn’t require authentication * Removes detailed instructions for Influx database creation Replaces the detailed instructions with a link to the official InfluxDB v 1.0 documentation for creating a database --- source/_components/influxdb.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_components/influxdb.markdown b/source/_components/influxdb.markdown index 266e783c1d4..d8e28d95833 100644 --- a/source/_components/influxdb.markdown +++ b/source/_components/influxdb.markdown @@ -14,13 +14,15 @@ ha_release: 0.9 The `influxdb` component makes it possible to transfer all state changes to an external [InfluxDB](https://influxdb.com/) database. For more details, [see the blog post on InfluxDB](/blog/2015/12/07/influxdb-and-grafana/). -To use the `influxdb` component in your installation, add the following to your `configuration.yaml` file: +The default InfluxDB configuration doesn't enforce authentication. If you have installed InfluxDB on the same host where Home Assistant is running and haven't made any configuration changes, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry influxdb: ``` +You will still need to create a database named `home_assistant` via InfluxDB's web interface or command line. For instructions how to create a database check the [InfluxDB documentation](https://docs.influxdata.com/influxdb/v1.0/introduction/getting_started/#creating-a-database) relevant to the version you have installed. + Configuration variables: - **host** (*Optional*): IP address of your database host, eg. http://192.168.1.10. Defaults to `localhost`. @@ -37,7 +39,6 @@ Configuration variables: ## {% linkable_title Examples %} -In this section you find some real life examples of how to use this component. ### {% linkable_title Full configuration %} From 7cad0dd2fa44328ba485b6cfbec33136caae843c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 17 Oct 2016 22:29:06 -0700 Subject: [PATCH 66/84] Add async docs --- .../asides/developers_navigation.html | 11 +- source/developers/asyncio.markdown | 27 +++++ .../asyncio_categorizing_functions.markdown | 79 ++++++++++++ source/developers/asyncio_misc.markdown | 22 ++++ .../asyncio_working_with_async.markdown | 113 ++++++++++++++++++ 5 files changed, 250 insertions(+), 2 deletions(-) create mode 100644 source/developers/asyncio.markdown create mode 100644 source/developers/asyncio_categorizing_functions.markdown create mode 100644 source/developers/asyncio_misc.markdown create mode 100644 source/developers/asyncio_working_with_async.markdown diff --git a/source/_includes/asides/developers_navigation.html b/source/_includes/asides/developers_navigation.html index 240deeafee8..154e405eac2 100644 --- a/source/_includes/asides/developers_navigation.html +++ b/source/_includes/asides/developers_navigation.html @@ -43,9 +43,16 @@
  • - Frontend Development + {% active_link /developers/asyncio/ Asynchronous Programming %} +
      +
    • {% active_link /developers/asyncio_categorizing_functions/ Categorizing Functions %}
      • +
    • {% active_link /developers/asyncio_working_with_async/ Working with Async %}
      • +
    • {% active_link /developers/asyncio_misc/ Miscellaneous %}
      • +
    +
    • +
  • + {% active_link /developers/frontend/ Frontend Development %}
      -
    • {% active_link /developers/frontend/ Setup Frontend Environment %}
    • {% active_link /developers/frontend_add_card/ Add State Card %}
    • {% active_link /developers/frontend_add_more_info/ Add More Info Dialog %}
    • {% active_link /developers/frontend_creating_custom_panels/ Add Custom Panels %}
      • diff --git a/source/developers/asyncio.markdown b/source/developers/asyncio.markdown new file mode 100644 index 00000000000..f663b8d36e9 --- /dev/null +++ b/source/developers/asyncio.markdown @@ -0,0 +1,27 @@ +--- +layout: page +title: "Asynchronous Programming" +description: "Introduction to the asynchronous core of Home Assistant." +date: 2016-10-17 21:49 +sidebar: true +comments: false +sharing: true +footer: true +--- + +On September 29, 2016 we released [Home Assistant 0.29][0.29] as part of our bi-weekly release schedule. This release introduced a complete overhaul of the core spearheaded by [Ben Bangert][ben]. + +The old core was set up like a “traditional” threaded application. Each resource that was not thread safe (ie. the state of entities) would be protected by a lock. This caused a lot of waiting and potential inconsistency because a task could now end up waiting halfway through it’s job until some resource got freed. + +Our new core is based on an Python’s built-in asyncio module. Instead of having all threads have access to the core API objects, access is now limited to a special thread called the event loop. All components will now schedule themselves as a task to be executed by the event loop. This gives us the guarantee that only one task is executed at once, meaning we no longer need any locks. + +The only problem with running everything inside the event loop is when a task is doing blocking I/O, what most third-party Python libraries are doing. For example while requesting new information from a device, the core will stop running until we get a response from the device. To handle this, a task is able to suspend itself until the response is available after which it will be enqueued for the event loop to process the result. + +For a task to be able to suspend itself, all code that it calls has to have this capability added. This means in practice that each device integration will need a full rewrite of the library that offers the integration! As this is not something that can be achieved, ever, a 100% backwards compatible API has been added so that no platform will require updating. + +The backwards compatible API works by scheduling a task from a different thread and blocking that thread until the task has been processed by the event loop. + +### [Next step: Categorizing Functions »](/developers/asyncio_categorizing_functions/) + +[0.29]: https://home-assistant.io/blog/2016/09/29/async-sleepiq-emoncms-stocks/ +[ben]: https://github.com/bbangert/ diff --git a/source/developers/asyncio_categorizing_functions.markdown b/source/developers/asyncio_categorizing_functions.markdown new file mode 100644 index 00000000000..bd3ff859b8b --- /dev/null +++ b/source/developers/asyncio_categorizing_functions.markdown @@ -0,0 +1,79 @@ +--- +layout: page +title: "Categorizing Functions" +description: "A categorization of functions to work with the asynchronous core of Home Assistant." +date: 2016-10-17 21:49 +sidebar: true +comments: false +sharing: true +footer: true +--- + +A piece of work within Home Assistant is represented by a function that will be invoked. It will either run inside our event loop or inside our thread pool, depending on if it is async safe. + +Home Assistant uses the convention that all functions that must be run from within the event loop are prefixed with `async_`. + +## {% linkable_title The coroutine function %} + +Coroutines are special functions based on Python’s generators syntax which allows them to suspend execution while waiting on a result. + +Invoking a coroutine function will return a Generator object back, but will not actually begin execution. This object will execute the task when it is either yielded from (from within another coroutine) or it is scheduled on the event loop. + +To declare a function a coroutine, import the coroutine annotation from the asyncio package and annotate your function. + +```python +import asyncio + +@asyncio.coroutine +def async_look_my_coroutine(target): + result = yield from entity.async_turn_on() + if result: + print("hello {}".format(target)) + +hass.loop.create_task(async_look_my_coroutine("world") +``` + +In this example, we schedule the coroutine by calling `hass.loop.create_task`. This will add the coroutine to the queue of tasks to be run. When the event loop is running `async_look_my_coroutine` it will suspend the task when `yield from entity.async_turn_on()` is called. At that point a new task will be scheduled to execute `entity.async_turn_on()`. When that job has been executed, `async_look_my_coroutine` will resume. + +## {% linkable_title The callback function %} + +This is a normal function that is considered safe to be run from within the event loop. A callback is unable to suspend itself and thus cannot do any I/O or call a coroutine. A callback is capable of scheduling a new task but it will not be able to wait for the results. + +To declare a function as a callback, import the callback annotation from the core package and annotate your function. + +A common use case for a callback in Home Assistant is as a listener for an event or a service call. It can process the incoming information and then schedule the right calls to be made. Example from the automation component. + +```python +from homeassistant.core import callback + +@callback +def async_trigger_service_handler(service_call): + """Handle automation trigger service calls.""" + vars = service_call.data.get(ATTR_VARIABLES) + for entity in component.async_extract_from_service(service_call): + hass.loop.create_task(entity.async_trigger(vars, True)) +``` + +In this example, `entity.async_trigger` is a coroutine function. Invoking the coroutine function will return a coroutine task. The passed in parameters will be used when the task gets executed. + +To execute the task we have to schedule it for execution on the event loop. This is done by calling `hass.loop.create_task`. + +### {% linkable_title Why even have callbacks? %} + +You might wonder, if a coroutine can do everything a callback can do, why even have a callback. The reason is performance and better state consistency of the core API objects. + +When coroutine A waits for coroutine B, it will suspend itself and schedule a new task to run B. This means that the event loop is now running A, B and then A again. If B is a callback, A will never have to suspend itself and thus the event loop is just running A. The consistency implication is that other events queued to run on the event loop continue to wait until callbacks complete, but will be interleaved when yielding to another coroutine. + +## {% linkable_title Event loop and thread safe %} + +These are functions that are safe to run both in a thread and inside the event loop. These functions are usually performing a computation or transform data in memory. Anything that does I/O does not fall under this category. Many standard library functions fall in this category. For example generating the sum of a set of numbers using sum or merging two dictionaries. + +There is no special annotation to mark functions as part of this category and care should be taken when using these functions from inside the event loop. When in doubt, look at their implementation. + +## {% linkable_title Other functions %} + +These are all the functions that did not fit in the previous categories. These functions are either thread-safe or not considered safe to be run within the event loop. These are functions that use sleep, or perform I/O. + +There is no special annotation necessary to be considered part of this category. + +### [Next step: Working with Async »](/developers/asyncio_working_with_async/) diff --git a/source/developers/asyncio_misc.markdown b/source/developers/asyncio_misc.markdown new file mode 100644 index 00000000000..695b26e3e0b --- /dev/null +++ b/source/developers/asyncio_misc.markdown @@ -0,0 +1,22 @@ +--- +layout: page +title: "Miscellaneous Async" +description: "A collection of miscellaneous topics about async that didn't fit on the other pages." +date: 2016-10-17 21:49 +sidebar: true +comments: false +sharing: true +footer: true +--- + +## {% linkable_title What about ‘async’ and ‘await’ syntax? %} +Python 3.5 introduced new syntax to formalize the asynchronous pattern. This is however not compatible with Python 3.4. The minimum required Python version for Home Assistant is based on the Python version shipped with Debian stable, which is currently 3.4.2. + +For more information, Brett Cannon wrote [an excellent breakdown][brett] on 'async' and 'await' syntax and how asynchronous programming works. + +## {% linkable_title Acknowledgements %} + +Huge thanks to [Ben Bangert][ben] for starting the conversion of the core to async, guiding other contributors while taking their first steps with async programming and peer reviewing this documentation. + +[brett]: http://www.snarky.ca/how-the-heck-does-async-await-work-in-python-3-5 +[ben]: https://github.com/bbangert/ diff --git a/source/developers/asyncio_working_with_async.markdown b/source/developers/asyncio_working_with_async.markdown new file mode 100644 index 00000000000..48839b4648e --- /dev/null +++ b/source/developers/asyncio_working_with_async.markdown @@ -0,0 +1,113 @@ +--- +layout: page +title: "Working with Async" +description: "A breakdown of all the different ways to work with the asynchronous core of Home Assistant." +date: 2016-10-17 21:49 +sidebar: true +comments: false +sharing: true +footer: true +--- + +Although we have a backwards compatible API, using the async core directly will be a lot faster. Most core components have already been rewritten to leverage the async core. This includes the EntityComponent helper (foundation of light, switch, etc), scripts, groups and automation. + +## {% linkable_title Interacting with the core %} + +[All methods in the Home Assistant core][dev-docs] are implemented in two flavors: an async version and a version to be called from other threads. The versions for other are merely wrappers that call the async version in a threadsafe manner using [the available async utilities][dev-docs-async]. + +So if you are making calls to the core (the hass object) from within a callback or coroutine, use the methods that start with async_. If you need to call an async_ function that is a coroutine, your task must also be a coroutine. + +## {% linkable_title Implementing an async component %} + +We currently do not support async setup for components. We do however support using async functions as service handlers. Just define your handlers as a callback or coroutine and register them as usual. + +## {% linkable_title Implementing an async platform %} + +For platforms we support async setup. Instead of setup_platform you need to have a coroutine async_setup_platform. + +```python +setup_platform(hass, config, add_entities, discovery_info=None): + # Setup your platform outside of the event loop. +``` + +Will turn into: + +```python +import asyncio + +@asyncio.coroutine +def async_setup_platform(hass, config, async_add_entities, + discovery_info=None): + # Setup your platform inside of the event loop +``` + +The only difference with the original parameters is that the add_entities function has been replaced by the coroutine `async_add_entities`. + +## {% linkable_title Implementing an async entity %} + +You can make your entity async friendly by converting your update method to be async. This requires the dependency of your entities to also be async friendly! + +```python +class MyEntity(Entity): + def update(self): + """Retrieve latest state.""" + self._state = fetch_state() +``` + +Will turn into: + +```python +import asyncio + +class MyEntity(Entity): + @asyncio.coroutine + def async_update(self): + """Retrieve latest state.""" + self._state = yield from async_fetch_state() +``` + +Make sure that all properties defined on your entity do not result in I/O being done. All data has to be fetched inside the update method and cached on the entity. This is because these properties are read from within the event loop and thus doing I/O will result in the core of Home Assistant waiting until your I/O is done. + +## {% linkable_title Calling async functions from threads %} + +Sometimes it will happen that you’re in a thread and you want to call a function that is only available as async. Home Assistant includes a few async helper utilities to help with this. + +In the following example, `say_hello` will schedule `async_say_hello` and block till the function has run and get the result back. + +```python +from homeassistant.util.async import run_callback_threadsafe + +def say_hello(hass, target): + return run_callback_threadsafe( + hass.loop, async_say_hello, target).result() + +def async_say_hello(hass, target): + return "Hello {}!".format(target) +``` + +## {% linkable_title Dealing with passed in functions %} + +If your code takes in functions from other code, you will not know which category the function belongs to and how they should be invoked. This usually only occurs if your code supplies an event helper like `mqtt.async_subscribe` or `track_state_change_listener`. + +To help with this, there are two helper methods on the hass object that you can call from inside the event loop: + +#### {% linkable_title hass.async_run_job %} + +Use this method if the function should be called as soon as possible. This will call callbacks immediately, schedule coroutines for execution on the event loop and schedule other functions to be run inside the thread pool. + +| Callback | Call immediately. +| Coroutine | Schedule for execution on the event loop. +| Other functions | Schedule for execution in the thread pool. + +#### {% linkable_title hass.async_add_job %} + +Use this method if the function should be called but not get priority over already scheduled calls. + +| Callback | Schedule for execution on the event loop. +| Coroutine | Schedule for execution on the event loop. +| Other functions | Schedule for execution in the thread pool. + +### [Next step: Miscellaneous »](/developers/asyncio_misc/) + +[dev-docs]: https://dev-docs.home-assistant.io/en/master/api/core.html +[dev-docs-async]: https://dev-docs.home-assistant.io/en/dev/api/util.html#module-homeassistant.util.async From 5b773cede86e64455ba5d3c76f32c67da787ae27 Mon Sep 17 00:00:00 2001 From: hexa- Date: Tue, 18 Oct 2016 08:56:02 +0200 Subject: [PATCH 67/84] switch.anel_pwrctrl: correct ha_release type (#1259) --- source/_components/switch.anel_pwrctrl.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.anel_pwrctrl.markdown b/source/_components/switch.anel_pwrctrl.markdown index de4c47d7f6f..5e2801fb137 100644 --- a/source/_components/switch.anel_pwrctrl.markdown +++ b/source/_components/switch.anel_pwrctrl.markdown @@ -10,7 +10,7 @@ footer: true logo: anel.png ha_category: Switch ha_iot_class: "Local Polling" -ha_release: 0.30 +ha_release: "0.30" --- The `anel_pwrctrl` switch platform allows you to control [ANEL PwrCtrl](http://anel-elektronik.de/SITE/produkte/produkte.htm) devices. From 4b09c4bbc18f0f555f8fcbe263cab5cd93ebaf79 Mon Sep 17 00:00:00 2001 From: Marc Plano-Lesay Date: Tue, 18 Oct 2016 08:56:33 +0200 Subject: [PATCH 68/84] Fix missing parenthesis to device_tracker.netgear (#1260) --- source/_components/device_tracker.netgear.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.netgear.markdown b/source/_components/device_tracker.netgear.markdown index 780fc170d11..4a5a94f638a 100644 --- a/source/_components/device_tracker.netgear.markdown +++ b/source/_components/device_tracker.netgear.markdown @@ -30,7 +30,7 @@ device_tracker: Configuration variables: - **host** (*Required*): The IP address of your router, e.g. `192.168.1.1`. -- **username** (*Required*: The username of an user with administrative privileges, usually `admin`. +- **username** (*Required*): The username of an user with administrative privileges, usually `admin`. - **password** (*Required*): The password for your given admin account. - **port** (*Optional*): The port your router communicates with (defaults to 5000, but 80 is also known to be used on some models) From 6b7ad4e20f8169ef8495e298aeb547d88681b5fa Mon Sep 17 00:00:00 2001 From: AlucardZero Date: Wed, 19 Oct 2016 01:18:16 -0400 Subject: [PATCH 69/84] Fix incorrect word in thermostat.markdown (#1264) --- source/_components/thermostat.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/thermostat.markdown b/source/_components/thermostat.markdown index 38199bb965a..5a2e618b00f 100644 --- a/source/_components/thermostat.markdown +++ b/source/_components/thermostat.markdown @@ -10,7 +10,7 @@ footer: true ---

      -**This component has been deprecated in favor of the "[climate](/components/climate/)" component and will be removed in the future. Please use cover.** +**This component has been deprecated in favor of the "[climate](/components/climate/)" component and will be removed in the future. Please use climate.**

      Thermostats offer Home Assistant a peek into the current and target temperature in a house. Some thermostats will also offer an away mode that will lower use of heating/cooling. From 602ca9f214f5543a8a36cc676eb24882fd640b21 Mon Sep 17 00:00:00 2001 From: Madhan Sundaram Date: Wed, 19 Oct 2016 01:22:31 -0400 Subject: [PATCH 70/84] Update cover.mqtt.markdown (#1267) Retain flag was used twice. --- source/_components/cover.mqtt.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_components/cover.mqtt.markdown b/source/_components/cover.mqtt.markdown index 62d55d7d8a3..d70dc6ed88e 100644 --- a/source/_components/cover.mqtt.markdown +++ b/source/_components/cover.mqtt.markdown @@ -70,7 +70,6 @@ cover: state_open: "OPEN" state_closed: "STATE" optimistic: false - retain: false value_template: '{% raw %}{{ value.x }}{% endraw %}' ``` From 51d7e21661440091ba9bad32ac0a74ab1becbf56 Mon Sep 17 00:00:00 2001 From: hexa- Date: Wed, 19 Oct 2016 17:39:46 +0200 Subject: [PATCH 71/84] switch.tplink: add iot_class and release version (#1269) --- source/_components/switch.tplink.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_components/switch.tplink.markdown b/source/_components/switch.tplink.markdown index 750c0cc8689..cf2cab03b8c 100644 --- a/source/_components/switch.tplink.markdown +++ b/source/_components/switch.tplink.markdown @@ -9,6 +9,8 @@ sharing: true footer: true logo: tp-link.png ha_category: Switch +ha_iot_class: "Local Polling" +ha_release: "0.24" --- From 27c8cf3e78dfb1c8f313636f7d03b6cb19b5ebff Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 20 Oct 2016 22:57:06 +0200 Subject: [PATCH 72/84] Minor changes --- source/_components/sensor.emoncms.markdown | 68 +++++++++------------- 1 file changed, 29 insertions(+), 39 deletions(-) diff --git a/source/_components/sensor.emoncms.markdown b/source/_components/sensor.emoncms.markdown index 35a8bb7b01d..ed60592a2c5 100644 --- a/source/_components/sensor.emoncms.markdown +++ b/source/_components/sensor.emoncms.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Emoncms Sensor" -description: "Instructions on how to integrate emoncms feeds as sensors into Home Assistant." +description: "Instructions on how to integrate Emoncms feeds as sensors into Home Assistant." date: 2016-09-08 00:15 logo: emoncms.png sidebar: true @@ -14,102 +14,96 @@ ha_iot_class: "Local Polling" --- -The `emoncms` sensor platform creates sensors for the feeds available in your local or cloud based version of [emoncms](https://emoncms.org). +The `emoncms` sensor platform creates sensors for the feeds available in your local or cloud based version of [Emoncms](https://emoncms.org). To enable this sensor, add the following lines to your `configuration.yaml`, it will list all feeds as a sensor: ```yaml -# Example configuration.yaml entry using cloud based emoncms +# Example configuration.yaml entry using cloud based Emoncms sensor: platform: emoncms - api_key: put your emoncms read api key here + api_key: API_KEY url: https://emoncms.org id: 1 ``` ## {% linkable_title Configuration variables %} -- **api_key** (*Required*): The read api key for your emoncms user. -- **url** (*Required*): The base url of emoncms, use "https://emoncms.org" for the cloud based version. -- **id** (*Required*): Positive Integer identifier for the sensor. Must be unique if you specify multiple emoncms sensors. -- **include_only_feed_id** (*optional*): Positive integer list of emoncms feed id's. Only the feeds with feed id's specified here will be displayed. Can not be specified if `exclude_feed_id` is specified. -- **exclude_feed_id** (*optional*): Positive integer list of emoncms feed id's. All the feeds will be displayed as sensors except the ones listed here. Can not be specified if `include_only_feed_id` is specified. -- **sensor_names** (*optional*): Dictionary of names for the sensors created that are created based on feedid. The dictionary consists of feedid:name pairs. Sensors for feeds with their feedid mentioned here will get the chosen name instead of the default name +- **api_key** (*Required*): The read API key for your Emoncms user. +- **url** (*Required*): The base URL of Emoncms, use "https://emoncms.org" for the cloud based version. +- **id** (*Required*): Positive integer identifier for the sensor. Must be unique if you specify multiple Emoncms sensors. +- **include_only_feed_id** (*Optional*): Positive integer list of Emoncms feed IDs. Only the feeds with feed IDs specified here will be displayed. Can not be specified if `exclude_feed_id` is specified. +- **exclude_feed_id** (*Optional*): Positive integer list of Emoncms feed IDs. All the feeds will be displayed as sensors except the ones listed here. Can not be specified if `include_only_feed_id` is specified. +- **sensor_names** (*Optional*): Dictionary of names for the sensors created that are created based on feed ID. The dictionary consists of `feedid: name` pairs. Sensors for feeds with their feed ID mentioned here will get the chosen name instead of the default name - **value_template** (*Optional*): Defines a [template](/topics/templating/) to alter the feed value. - **scan_interval** (*Optional*): Defines the update interval of the sensor in seconds. - **unit_of_measurement** (*Optional*): Defines the unit of measurement of for all the sensors. default is "W". ## {% linkable_title Default naming scheme %} -The names of the sensors created by this component, will be a combination of static text, `id` from the config and `feedid` from the emoncms feed, unless `sensor_names` is used. -An example name would be "emoncms1_feedid_10" +The names of the sensors created by this component, will be a combination of static text, `id` from the config and `feedid` from the Emoncms feed, unless `sensor_names` is used. An example name would be `emoncms1_feedid_10`. -## {% linkable_title Examples %} +### {% linkable_title Examples %} In this section you find some more examples of how this sensor can be used. +Display only feeds with their feed IDs specified in `include_only_feed_id`. + ```yaml -# Display only feeds with their feed id's specified in "include_only_feed_id" +# Example configuration.yaml entry sensor: - platform: emoncms - api_key: put your emoncms read api key here + api_key: API_KEY url: https://emoncms.org id: 1 unit_of_measurement: "W" include_only_feed_id: - 107 - - 106 - 105 ``` +Display all feeds except feeds with their feed id specified in `exclude_feed_id`. ```yaml -# Display all feeds except feeds with their feed id specified in "exclude_feed_id" +# Example configuration.yaml entry sensor: - platform: emoncms - api_key: put your emoncms read api key here + api_key: API_KEY url: https://emoncms.org id: 1 unit_of_measurement: "KWH" exclude_feed_id: - 107 - - 106 - 105 ``` +Display only feeds with their feed id's specified in `include_only_feed_id` and give the feed sensors a name using "sensor_names". You don't have to specify all feeds names in "sensor_names", the remaining sensor names will be chosen based on "id" and the Emoncms `feedid`. ```yaml -# Display only feeds with their feed id's specified in "include_only_feed_id" and give the feed sensors a name using "sensor_names". You don't have to specify all feeds names in "sensor_names", the remaining sensor names will be chosen based on "id" and the emoncms feedid +# Example configuration.yaml entry sensor: - platform: emoncms - api_key: put your emoncms read api key here - url: https://emoncms.org + api_key: API_KEY + url: https://emoncms.org id: 1 unit_of_measurement: "KW" include_only_feed_id: - 5 - - 18 - - 29 - - 48 - - 61 - - 110 - - 116 - 120 sensor_names: 5: "feed 1" - 18: "feed 2" - 29: "feed 3" 48: "kwh feed" 61: "amp feed" 110: "watt feed" ``` +Use a `value_template` to add 1500 to the feed value for all specified feed IDs in `include_feed_id`. ```yaml -# Use a "value_template" to add 1500 to the feed value for all specified feed id's in "include_feed_id" +# Example configuration.yaml entry sensor: - platform: emoncms - api_key: put your emoncms read api key here + api_key: API_KEY url: https://emoncms.org scan_interval: 15 id: 1 @@ -117,16 +111,15 @@ sensor: include_only_feed_id: - 107 - 106 - - 105 - - 61 ``` +Display feeds from the same Emoncms instance with 2 groups of feeds, diffrent `scan_interval` and a diffrent `unit_of_measurement`. ```yaml -# Display feeds from the same emoncms instance with 2 groups of feeds, diffrent scan_interval and a diffrent unit_of_measurement +# Example configuration.yaml entry sensor: - platform: emoncms - api_key: put your emoncms read api key here + api_key: API_KEY url: https://emoncms.org scan_interval: 30 id: 1 @@ -134,7 +127,6 @@ sensor: include_only_feed_id: - 107 - 106 - - 105 - platform: emoncms api_key: put your emoncms read api key here url: https://emoncms.org @@ -143,7 +135,5 @@ sensor: unit_of_measurement: "A" include_only_feed_id: - 108 - - 109 - - 110 - 61 ``` From d9e6b061d627c68e00eedc113066b40708a4c0d0 Mon Sep 17 00:00:00 2001 From: ianj001 Date: Thu, 20 Oct 2016 17:34:33 -0400 Subject: [PATCH 73/84] Update light.enocean.markdown (#1279) --- source/_components/light.enocean.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.enocean.markdown b/source/_components/light.enocean.markdown index 30ecc16614f..ba8e54cfe54 100644 --- a/source/_components/light.enocean.markdown +++ b/source/_components/light.enocean.markdown @@ -12,7 +12,7 @@ ha_category: Light ha_release: 0.21 --- -An EnOcean light can take many formes. Currently only one type has been tested: Eltako FUD61 dimmer. +An EnOcean light can take many forms. Currently only one type has been tested: Eltako FUD61 dimmer. To use your EnOcean device, you first have to set up your [EnOcean hub](/components/enocean/) and then add the following to your `configuration.yaml` file: From cf46d83ddbd7d64e5969d9a0d2ba938b0739fea1 Mon Sep 17 00:00:00 2001 From: ianj001 Date: Thu, 20 Oct 2016 17:35:04 -0400 Subject: [PATCH 74/84] Update light.flux_led.markdown (#1281) --- source/_components/light.flux_led.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.flux_led.markdown b/source/_components/light.flux_led.markdown index d9f5b2c8db0..44300a716f1 100644 --- a/source/_components/light.flux_led.markdown +++ b/source/_components/light.flux_led.markdown @@ -23,7 +23,7 @@ Example of bulbs: - [Flux WiFi Smart LED Light Bulb4](http://smile.amazon.com/Flux-WiFi-Smart-Light-Bulb/dp/B01A6GHHTE) - [WIFI smart LED light Bulb1](http://smile.amazon.com/gp/product/B01CS1EZYK) -The chances are high that you bulb or controller (eg. WiFi LED CONTROLLER) will work if you can control the device with the MagicHome app. +The chances are high that your bulb or controller (eg. WiFi LED CONTROLLER) will work if you can control the device with the MagicHome app. To enable those lights, add the following lines to your `configuration.yaml` file: From 8ad4d0b5e7f25568920c658c878c9df078a880bc Mon Sep 17 00:00:00 2001 From: ianj001 Date: Thu, 20 Oct 2016 17:35:34 -0400 Subject: [PATCH 75/84] Update light.blinksticklight.markdown (#1280) --- source/_components/light.blinksticklight.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.blinksticklight.markdown b/source/_components/light.blinksticklight.markdown index 5040ee6fe99..2225a7cf469 100644 --- a/source/_components/light.blinksticklight.markdown +++ b/source/_components/light.blinksticklight.markdown @@ -13,7 +13,7 @@ ha_release: 0.7.5 --- -The `blinkstick` platform let you can control your [Blinkstick](https://www.blinkstick.com/) lights from within Home Assistant. +The `blinkstick` platform lets you control your [Blinkstick](https://www.blinkstick.com/) lights from within Home Assistant. To add blinkstick to your installation, add the following to your `configuration.yaml` file: From 7a4ed88ab1daa34119a69f43a7d8f5c3dcfd9ccf Mon Sep 17 00:00:00 2001 From: Spencer Owen Date: Fri, 21 Oct 2016 00:55:35 -0600 Subject: [PATCH 76/84] fix missing space (#1287) --- source/getting-started/automation.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/automation.markdown b/source/getting-started/automation.markdown index 27d026a43f8..dea2435fd7e 100644 --- a/source/getting-started/automation.markdown +++ b/source/getting-started/automation.markdown @@ -31,7 +31,7 @@ The first line is the trigger of the automation rule. Triggers describe events t The second line is the condition part of the automation rule. Conditions are optional tests that can limit an automation rule to only work in your specific use cases. A condition will test against the current state of the system. This includes the current time, devices, people and other things like the sun. In this case we only want to act when the sun has set. -The third part is the action which will be performed when a rule is triggered and all conditions are met.For example, it can turn a light on, set the temperature on your thermostat or activate a scene. +The third part is the action which will be performed when a rule is triggered and all conditions are met. For example, it can turn a light on, set the temperature on your thermostat or activate a scene.

      The difference between a condition and a trigger can be confusing as they are very similar. Triggers look at the actions, while conditions look at the results: turning a light on vs a light being on. From 5a46258eaf9895e7cb1b2e0304e42b5394e1bc9b Mon Sep 17 00:00:00 2001 From: ianj001 Date: Fri, 21 Oct 2016 02:56:20 -0400 Subject: [PATCH 77/84] Update light.mqtt_json.markdown (#1282) --- source/_components/light.mqtt_json.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/light.mqtt_json.markdown b/source/_components/light.mqtt_json.markdown index 3f722ff64bc..c2eed64ddb7 100644 --- a/source/_components/light.mqtt_json.markdown +++ b/source/_components/light.mqtt_json.markdown @@ -14,7 +14,7 @@ ha_release: 0.26 --- -The `mqtt_json` light platform let you control a MQTT-enabled light that can receive [JSON](https://en.wikipedia.org/wiki/JSON) messages. +The `mqtt_json` light platform lets you control a MQTT-enabled light that can receive [JSON](https://en.wikipedia.org/wiki/JSON) messages. This platform supports on/off, brightness, RGB colors, transitions, and short/long flashing. The messages sent to/from the lights look similar to this, omitting fields when they aren't needed: @@ -32,9 +32,9 @@ This platform supports on/off, brightness, RGB colors, transitions, and short/lo ``` -In an ideal scenario, the MQTT device will have a state topic to publish state changes. If these messages are published with the RETAIN flag, the MQTT light will receive an instant state update after subscription and will start with correct state. Otherwise, the initial state of the light will be off. +In an ideal scenario, the MQTT device will have a state topic to publish state changes. If these messages are published with the RETAIN flag, the MQTT light will receive an instant state update after subscription and will start with the correct state. Otherwise, the initial state of the light will be off. -When a state topic is not available, the light will work in optimistic mode. In this mode, the light will immediately change state after every command. Otherwise, the light will wait for state confirmation from device (message from `state_topic`). +When a state topic is not available, the light will work in optimistic mode. In this mode, the light will immediately change state after every command. Otherwise, the light will wait for state confirmation from the device (message from `state_topic`). Optimistic mode can be forced, even if state topic is available. Try enabling it if the light is operating incorrectly. From 1ebcbefbc34055b108adcf61e05117677da906f9 Mon Sep 17 00:00:00 2001 From: ianj001 Date: Fri, 21 Oct 2016 02:57:03 -0400 Subject: [PATCH 78/84] Update light.zigbee.markdown (#1283) --- source/_components/light.zigbee.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.zigbee.markdown b/source/_components/light.zigbee.markdown index 8ce3a9c4e33..b0462064724 100644 --- a/source/_components/light.zigbee.markdown +++ b/source/_components/light.zigbee.markdown @@ -26,7 +26,7 @@ light: Configuration variables: -- **name** (*Required*): The name you' would like to give the light in Home Assistant. +- **name** (*Required*): The name you would like to give the light in Home Assistant. - **pin** (*Required*): The number identifying which pin to use. - **address** (*Optional*): The long 64 bit address of the remote ZigBee device whose digital output pin you wouldd like to switch. Do not include this variable if you want to switch the local ZigBee device's pins. - **on_state** (*Optional*): Either `high` (default) or `low`, depicting whether the digital output pin is pulled `high` or `low` when the light is turned on. From 867f734d89297474e4db66a55f8cf0acab46dff9 Mon Sep 17 00:00:00 2001 From: ianj001 Date: Fri, 21 Oct 2016 02:57:32 -0400 Subject: [PATCH 79/84] Update automation_sun.markdown (#1284) --- source/_cookbook/automation_sun.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_cookbook/automation_sun.markdown b/source/_cookbook/automation_sun.markdown index 25edee45576..fff78fb29ab 100644 --- a/source/_cookbook/automation_sun.markdown +++ b/source/_cookbook/automation_sun.markdown @@ -10,7 +10,7 @@ footer: true ha_category: Automation Examples --- -#### {% linkable_title Turn on the living room lights 45 minutes before sunset if anyone home %} +#### {% linkable_title Turn on the living room lights 45 minutes before sunset if anyone is at home %} ```yaml automation: From fb50a2c50f2706f2837ae52596b6dfcd0339dbcc Mon Sep 17 00:00:00 2001 From: ianj001 Date: Fri, 21 Oct 2016 02:58:01 -0400 Subject: [PATCH 80/84] Update apache_configuration.markdown (#1285) --- source/_cookbook/apache_configuration.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_cookbook/apache_configuration.markdown b/source/_cookbook/apache_configuration.markdown index 626538d33c5..2855837a3b5 100644 --- a/source/_cookbook/apache_configuration.markdown +++ b/source/_cookbook/apache_configuration.markdown @@ -10,7 +10,7 @@ footer: true ha_category: Infrastructure --- -This is an example about how you can configure Apache to act as a proxy for home assistant. +This example demonstrates how you can configure Apache to act as a proxy for home assistant. This is useful if you want to have: From 485cc65c634a2ed16f822d033240536cd940b831 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 21 Oct 2016 10:15:38 +0200 Subject: [PATCH 81/84] No sidebar --- source/help/talking-points.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/help/talking-points.markdown b/source/help/talking-points.markdown index 4c22a225cd1..51ee75e564e 100644 --- a/source/help/talking-points.markdown +++ b/source/help/talking-points.markdown @@ -3,7 +3,7 @@ layout: page title: "Talking points" description: "Talking points for your Home Assistant talk or presentation." date: 2016-10-06 06:00 -sidebar: true +sidebar: false comments: false sharing: true footer: true From 5a09bd504d97058924044760d851b50ba1127409 Mon Sep 17 00:00:00 2001 From: MaKin211 Date: Fri, 21 Oct 2016 23:00:09 +0200 Subject: [PATCH 82/84] Setting proper variables for specific protocols. (#1290) For some PiLight protocols there are different parameters used and therefore the variables have to be replaced in order to have the pilight_switch component working with HASS. --- source/_components/switch.pilight.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.pilight.markdown b/source/_components/switch.pilight.markdown index c8a28e1e9c6..db1e8bd5845 100644 --- a/source/_components/switch.pilight.markdown +++ b/source/_components/switch.pilight.markdown @@ -55,7 +55,7 @@ Variables for the different codes: - **'off'** (*Optional*): `1` or `0` - **'on'** (*Optional*): `1` or `0` -For possible code entries look at the [pilight API](https://www.pilight.org/development/api/). All commands allowed by [pilight-send](https://wiki.pilight.org/doku.php/psend) can be used. +For possible code entries look at the [pilight API](https://www.pilight.org/development/api/). All commands allowed by [pilight-send](https://wiki.pilight.org/doku.php/psend) can be used. Which means that if for a certain protocol there are different parameters used, you should be able to replace the variables above by the proper ones required by the specific protocol. When using the `elro_800_switch` or `mumbi` protocol for example, you will have to replace the variable `unit` with `unitcode` or there will be errors occuring. ## {% linkable_title Examples %} From 600942982a3feac0667b106afd3e6598fcabd4c3 Mon Sep 17 00:00:00 2001 From: ricmik Date: Fri, 21 Oct 2016 23:09:15 +0200 Subject: [PATCH 83/84] Update media_player.yamaha.markdown (#1288) Fixed source_names example --- source/_components/media_player.yamaha.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/media_player.yamaha.markdown b/source/_components/media_player.yamaha.markdown index d9eb6138fa1..8ee77c42dc7 100644 --- a/source/_components/media_player.yamaha.markdown +++ b/source/_components/media_player.yamaha.markdown @@ -54,6 +54,6 @@ media_player: - "AUX" - "HDMI6" source_names: - - HDMI1: "ChromeCast" - - AV4: "Vinyl" + HDMI1: "ChromeCast" + AV4: "Vinyl" ``` From f7255cad8679e4546035e1ddb902bb7ce421b326 Mon Sep 17 00:00:00 2001 From: Fredrik Lindqvist Date: Sat, 22 Oct 2016 06:06:03 +0200 Subject: [PATCH 84/84] Add more instructions to HASSbian docs. (#1262) * Add more instructions to HASSbian docs. * Update installation-raspberry-pi-image.markdown - Add viewing of log trough journalctl - Add information about status command for Home Assistant service - Fix formatting --- .../installation-raspberry-pi-image.markdown | 114 +++++++++++++++--- source/getting-started/updating.markdown | 2 +- 2 files changed, 101 insertions(+), 15 deletions(-) diff --git a/source/getting-started/installation-raspberry-pi-image.markdown b/source/getting-started/installation-raspberry-pi-image.markdown index bddb055e69d..7ba140cec80 100644 --- a/source/getting-started/installation-raspberry-pi-image.markdown +++ b/source/getting-started/installation-raspberry-pi-image.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "Hassbian image for Raspberry Pi" -description: "Instructions to flash the Home Assistant Hassbian image on a Raspberry Pi." +title: "HASSbian image for Raspberry Pi" +description: "Instructions to flash the Home Assistant HASSbian image on a Raspberry Pi." date: 2016-09-26 21:00 sidebar: true comments: false @@ -9,15 +9,15 @@ sharing: true footer: true --- -The easiest way to install Home Assistant on your Raspberry Pi is by using Hassbian: a Raspberry Pi image with Home Assistant built-in. The image will install the latest version of Home Assistant on initial boot (~5 minutes). +The easiest way to install Home Assistant on your Raspberry Pi is by using HASSbian: a Raspberry Pi image with Home Assistant built-in. The image will install the latest version of Home Assistant on initial boot (~5 minutes). 1. [Download the latest image][image-download] 2. Flash the image to an SD card: - [Windows][flash-windows] - [Linux][flash-linux] - - [Mac][flash-macos] + - [Mac OS][flash-macos] 3. Ensure your Raspberry Pi has access to the internet. - 4. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take 5 minutes. + 4. Insert SD card to Raspberry Pi and turn it on. Initial installation of Home Assistant will take about 5 minutes. These instructions are also available as a [video](https://www.youtube.com/watch?v=iIz6XqDwHEk). @@ -36,21 +36,104 @@ Some extra tips: ### {% linkable_title Technical Details %} - - Home Assistant is installed in a virtual Python environment at `src/homeassistant` + - Home Assistant is installed in a virtual Python environment at `/src/homeassistant/` - Home Assistant will be started as a service run by the user `homeassistant` + - The configuration is located at `/home/homeassistant/.homeassistant` -{% comment %} +### {% linkable_title Managing your HASSbian installation %} +#### {% linkable_title Login to HASSbian on the Raspberry Pi %} +To login to your Raspberry Pi running HASSbian your going to be using a ssh client. Depending on your platform there are several alternatives for doing this. Linux and Max OS generally have a ssh client installed. Windows users are recommended to download and install the ssh client [Putty][ssh-putty]. - TODO: +Connect to the Raspberry Pi over ssh. Default user name is `pi` and password is `raspberry`. +Linux and Mac OS users execute the following command in a terminal. +```bash +$ ssh pi@ip-address-of-pi +``` +Windows users start [Putty][ssh-putty], enter the IP address of the Raspberry Pi in the *Host name* field and port 22 in the *Port* field. Then click *Open* and a terminal window will open. Enter the credentials. Default user name is `pi` and password is `raspberry`. - Add instructions: +#### {% linkable_title Start/Stop/Restart Home Assistant on HaSSbian %} +Log in as the `pi` account account and execute the following commands: +```bash +sudo systemctl stop home-assistant@homeassistant.service +``` +Replace `stop` with `start` or `restart` to get the desired functionality. +To get the current state of the `homeassistant.service` replace `stop` with `status`. - - How to login via shell (?) or at least mention how to work with a Pi - - How to restart HASS - - How to see the logs for config validation - - How to update the config +#### {% linkable_title Update Home Assistant on HASSbian %} +Log in as the `pi` account and execute the following commands: +```bash +sudo systemctl stop home-assistant@homeassistant.service +sudo su -s /bin/bash homeassistant +source /srv/homeassistant/bin/activate +pip3 install --upgrade homeassistant +exit +sudo systemctl start home-assistant@homeassistant.service +``` +This will in order do the following: +- Stop the Home Assistant service running on HASSbian +- Open a shell as the `homeassistant` user running the Homeassistant service and that has ownership over the Home Assistant installation. +- Change into the virtual Python environment at `/src/homeassistant/` containing the Home Assistant installation. +- Upgrade the Home Assistant installation to the latest release. +- Exit the shell and return to the `pi` user. +- Restart the Home Assistant service. -{% endcomment %} +#### {% linkable_title Manually launch Home Assistant on HASSbian %} +Log in as the `pi` account and execute the following commands: +```bash +sudo su -s /bin/bash homeassistant +source /srv/homeassistant/bin/activate +hass +``` +This will start Home Assistant in your shell and output anything that ends up in the log and more into the console. This will fail if the Home Assistant service is already running so don't forget to [stop][stop-homeassistant] it first. + +#### {% linkable_title Check your configuration on HASSbian %} +Log in as the `pi` account and execute the following commands: +```bash +sudo su -s /bin/bash homeassistant +source /srv/homeassistant/bin/activate +hass --script check_config +``` +This will output any errors in your configuration files to console. + +#### {% linkable_title Read the Home Assistant log file on HASSbian %} +Log in as the `pi` account and execute the following commands: +```bash +sudo su -s /bin/bash homeassistant +cd /home/homeassistant/.homeassistant +nano homeassistant.log +``` +This will in order do the following: +- Open a shell as the `homeassistant` user. +- Change directory to the Home Assistant configuration directory. +- Open the log file in the nano editor. + +Optionaly, you can also view the log with `journalctl`. +Log in as the `pi` account and execute the following commands: +```bash +sudo journalctl -fu home-assistant@homeassistant.service +``` + +#### {% linkable_title Edit the Home Assistant configuration on HASSbian %} +Log in as the `pi` account and execute the following commands: +```bash +sudo su -s /bin/bash homeassistant +cd /home/homeassistant/.homeassistant +nano configuration.yaml +``` +This will in order do the following: +- Open a shell as the `homeassistant` user. +- Change directory to the Home Assistant configuration directory. +- Open the configuration file in the nano editor. +It's generally recommended that you read the [Getting started][configuring-homeassistant] guide for how to configure Home Assistant. + +#### {% linkable_title Upgrade and update HASSbian %} +HASSbian is based on Raspbian and uses the same repositories. Any changes to Raspbian will be reflected in HASSbian. To update and upgrade system packages and installed software (excluding Home Assistant) do the following. +Log in as the `pi` account and execute the following commands: +```bash +sudo apt-get update +sudo apt-get upgrade +``` +Press `Y` to confirm that you would like to continue. ### {% linkable_title Troubleshooting %} @@ -69,3 +152,6 @@ In addition to this site, check out these sources for additional help: [flash-macos]: https://www.raspberrypi.org/documentation/installation/installing-images/mac.md [flash-windows]: https://www.raspberrypi.org/documentation/installation/installing-images/windows.md [pi-components]: /getting-started/installation-raspberry-pi/#raspberry-pi-hardware-specific-components +[ssh-putty]: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html +[stop-homeassistant]: /getting-started/installation-raspberry-pi-image/#startstoprestart-home-assistant-on-hassbian +[configuring-homeassistant]: /getting-started/configuration/ diff --git a/source/getting-started/updating.markdown b/source/getting-started/updating.markdown index 56e1a52f032..0da8ad75536 100644 --- a/source/getting-started/updating.markdown +++ b/source/getting-started/updating.markdown @@ -16,7 +16,7 @@ The default way to update Home Assistant to the latest release, when available, $ pip3 install --upgrade homeassistant ``` -Different installation methods as [Raspberry Pi All-In-One Installer](/getting-started/installation-raspberry-pi-all-in-one/#upgrading), [Vagrant](/getting-started/installation-vagrant/), or [Virtualenv](/getting-started/installation-virtualenv/#upgrading-home-assistant) may have an alternative way for updating Home Assistant. +Different installation methods as [HASSbian](/getting-started/installation-raspberry-pi-image/#update-home-assistant-on-hassbian), [Raspberry Pi All-In-One Installer](/getting-started/installation-raspberry-pi-all-in-one/#upgrading), [Vagrant](/getting-started/installation-vagrant/), or [Virtualenv](/getting-started/installation-virtualenv/#upgrading-home-assistant) may have an alternative way for updating Home Assistant. After updating, restart Home Assistant for the changes to take effect. This means that you have to restart `hass` itself or the [autostarting](/getting-started/autostart/) daemon if you use any.