From 0ead042087ebacdd3ec1e61c918a9c17e9afa21d Mon Sep 17 00:00:00 2001 From: Thomas Svedberg <36861881+ThomasSvedberg@users.noreply.github.com> Date: Fri, 23 Mar 2018 22:54:17 +0100 Subject: [PATCH 001/241] Update sensor.vasttrafik.markdown (#4986) * Update sensor.vasttrafik.markdown Add new config option "lines" and extend full example. * :pencil2: Tweaks --- source/_components/sensor.vasttrafik.markdown | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/source/_components/sensor.vasttrafik.markdown b/source/_components/sensor.vasttrafik.markdown index 0217a91c6a..8f3862fdd8 100644 --- a/source/_components/sensor.vasttrafik.markdown +++ b/source/_components/sensor.vasttrafik.markdown @@ -13,7 +13,6 @@ ha_iot_class: "Cloud Polling" ha_release: "0.30" --- - The `vasttrafik` sensor will provide you traveling details for the larger Göteborg area in Sweden from the [Västtrafik](https://vasttrafik.se/) public transportation service. You must create an application [here](https://developer.vasttrafik.se/portal/#/applications) to obtain a `key` and a `secret`. @@ -34,10 +33,11 @@ Configuration variables: - **key** (*Required*): The API key to access your Västtrafik account. - **secret** (*Required*): The API secret to access your Västtrafik account. -- **departures** array (*Required*): List of traveling routes. +- **departures** array (*Required*): List of travel routes. - **name** (*Optional*): Name of the route. - **from** (*Required*): The start station. - **heading** (*Optional*): Direction of the traveling. + - **lines** (*Optional*): Only consider these lines. - **delay** (*Optional*): Delay in minutes. Defaults to 0. The data are coming from [Västtrafik](https://vasttrafik.se/). @@ -54,5 +54,8 @@ sensor: - name: Mot järntorget from: Musikvägen heading: Järntorget + lines: + - 7 + - GRÖN delay: 10 ``` From 63746ddee5cf5c7c4befe8df1c8113259916399c Mon Sep 17 00:00:00 2001 From: Ettienne Gous Date: Sat, 24 Mar 2018 19:39:13 +1100 Subject: [PATCH 002/241] Update default Pilight port number (#4976) * Update default Pilight port number Based on the Pilight docs targeted the default port is 5001, As started here https://manual.pilight.org/development/api.html and in the original Home Assistant doc I think they did a big refactor late last year to the code base and docs. * :ambulance: Host and port variables are optional * :rocket: Trigger rebuild * Remove optional configuration variables * :rocket: Trigger rebuild --- source/_components/pilight.markdown | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/source/_components/pilight.markdown b/source/_components/pilight.markdown index ab841bbe83..2e7e1b0150 100644 --- a/source/_components/pilight.markdown +++ b/source/_components/pilight.markdown @@ -24,14 +24,12 @@ To integrate pilight into Home Assistant, add the following section to your `con ```yaml # Example configuration.yaml entry pilight: - host: 127.0.0.1 - port: 5000 ``` Configuration variables: -- **host** (*Required*): The IP address of the computer running the pilight-daemon, e.g., 192.168.1.32. -- **port** (*Required*): The network port to connect to. The usual port is [5000](https://manual.pilight.org/development/api.html). +- **host** (*Optional*): The IP address of the computer running the pilight-daemon, e.g., 192.168.1.32. +- **port** (*Optional*): The network port to connect to. The usual port is [5001](https://manual.pilight.org/development/api.html). - **send_delay** (*Optional*): You can define a send delay as a fraction of seconds if you experience transmission problems when you try to switch multiple switches at once. This can happen when you use a [pilight USB Nano](https://github.com/pilight/pilight-usb-nano) as hardware and switches a whole group of multiple switches on or off. Tested values are between 0.3 and 0.8 seconds depending on the hardware. - **whitelist** (*Optional*): You can define a whitelist to prevent that too many unwanted RF codes (e.g., the neighbors weather station) are put on your HA event bus. All defined subsections have to be matched. A subsection is matched if one of the items are true. From 491c79598dc40e2bee6bfd1993ddeb4979cc24be Mon Sep 17 00:00:00 2001 From: ChristianKuehnel Date: Sat, 24 Mar 2018 13:50:17 +0100 Subject: [PATCH 003/241] bmw connected drive (#4947) * bmw connected drive * breaking change * replaced country with region after API change * fixed brackets --- source/_components/bmw_connected_drive.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/bmw_connected_drive.markdown b/source/_components/bmw_connected_drive.markdown index 21e7e04ecf..398a922db6 100644 --- a/source/_components/bmw_connected_drive.markdown +++ b/source/_components/bmw_connected_drive.markdown @@ -25,7 +25,7 @@ bmw_connected_drive: name: username: USERNAME_BMW_CONNECTED_DRIVE password: PASSWORD_BMW_CONNECTED_DRIVE - country: COUNTRY_BMW_CONNECTED_DRIVE + region: one of "north_america", "china" , "rest_of_world" ``` {% configuration %} @@ -46,8 +46,8 @@ bmw_connected_drive: description: Your BMW Connected Drive password. required: true type: string - country: - description: "The country of your Connected Drive account. Please use the exact names for the country as listed on the [Connected Drive website](https://www.bmw-connecteddrive.com/)." + region: + description: "The region of your Connected Drive account. Please use of these values: `north_america`, `china`, `rest_of_world`" required: true type: string {% endconfiguration %} From 786949d0a27fc145135c78fcb1afc54b222ed533 Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Sat, 24 Mar 2018 23:05:31 +0100 Subject: [PATCH 004/241] Xiaomi MiIO Fan: Xiaomi Air Humidifier integration (#4829) * Xiaomi Air Humidifier integration. * List of supported features improved * Device independent service descriptions, missing model added to config schema, structure * :pencil2: Corrected brand namings --- source/_components/fan.xiaomi_miio.markdown | 266 ++++++++++++++++++-- 1 file changed, 239 insertions(+), 27 deletions(-) diff --git a/source/_components/fan.xiaomi_miio.markdown b/source/_components/fan.xiaomi_miio.markdown index 82e95feddf..8fc9da3211 100644 --- a/source/_components/fan.xiaomi_miio.markdown +++ b/source/_components/fan.xiaomi_miio.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Xiaomi Air Purifier" -description: "Instructions on how to integrate your Xiaomi Air Purifier within Home Assistant." +description: "Instructions on how to integrate your Xiaomi Air Purifier and Xiaomi Air Humidifier within Home Assistant." date: 2017-10-13 12:35 sidebar: true comments: false @@ -13,35 +13,161 @@ ha_version: 0.57 ha_iot_class: "Local Polling" --- -The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier 2, Air Purifier 2S and Air Purifier Pro. +The `xiaomi_miio` fan platform allows you to control the Xiaomi Air Purifier and Xiaomi Air Humidifier. -Currently, the supported features are: +## Features -* On, Off +### Air Purifier 2 et al. + +* Power (on, off) * Operation modes (auto, silent, favorite, idle) * Buzzer (on, off) * Child lock (on, off) * LED (on, off), LED brightness (bright, dim, off) * Favorite Level (0...16) * Attributes - - power - - aqi - - average_aqi - - humidity + - model - temperature + - humidity + - aqi - mode + - filter_hours_used + - filter_life_remaining - favorite_level + - child_lock - led + - motor_speed + - average_aqi + - purify_volume + - learn_mode + - sleep_time + - sleep_mode_learn_count + - extra_features + - turbo_mode_supported + - auto_detect + - use_time + - button_pressed + - buzzer - led_brightness + - sleep_mode + +### Air Purifier Pro (zhimi.airpurifier.v6) + +* Power (on, off) +* Operation modes (auto, silent, favorite) +* Child lock (on, off) +* LED (on, off) +* Favorite Level (0...16) +* Attributes + - model + - temperature + - humidity + - aqi + - mode + - filter_hours_used + - filter_life_remaining + - favorite_level + - child_lock + - led + - motor_speed + - average_aqi + - purify_volume + - learn_mode + - sleep_time + - sleep_mode_learn_count + - extra_features + - turbo_mode_supported + - auto_detect + - use_time + - button_pressed + - filter_rfid_product_id + - filter_rfid_tag + - filter_type + - illuminance + - motor2_speed + - volume + +### Air Purifier V3 (zhimi.airpurifier.v3) + +* Power (on, off) +* Operation modes (auto, silent, favorite, idle, medium, high, strong) +* Child lock (on, off) +* LED (on, off) +* Attributes + - model + - aqi + - mode + - led - buzzer - child_lock - - purify_volume - - filter_life_remaining + - illuminance - filter_hours_used + - filter_life_remaining - motor_speed + - average_aqi + - volume + - motor2_speed + - filter_rfid_product_id + - filter_rfid_tag + - filter_type + - purify_volume + - learn_mode + - sleep_time + - sleep_mode_learn_count + - extra_features + - auto_detect + - use_time + - button_pressed +### Air Humidifier (zhimi.humidifier.v1) -Please follow the instructions on [Retrieving the Access Token](/components/vacuum.xiaomi_miio/#retrieving-the-access-token) to get the API token. +* On, Off +* Operation modes (silent, medium, high) +* Buzzer (on, off) +* Child lock (on, off) +* LED brightness (bright, dim, off) +* Target humidity (30, 40, 50, 60, 70, 80) +* Attributes + - model + - temperature + - humidity + - mode + - buzzer + - child_lock + - trans_level + - target_humidity + - led_brightness + - button_pressed + - use_time + - hardware_version + +### Air Humidifier CA (zhimi.humidifier.ca1) + +* On, Off +* Operation modes (silent, medium, high, auto) +* Buzzer (on, off) +* Child lock (on, off) +* LED brightness (bright, dim, off) +* Target humidity (30, 40, 50, 60, 70, 80) +* Dry mode (on, off) +* Attributes + - model + - temperature + - humidity + - mode + - buzzer + - child_lock + - trans_level + - target_humidity + - led_brightness + - button_pressed + - use_time + - hardware_version + - speed + - depth + - dry + +Please follow the instructions on [Retrieving the Access Token](/components/vacuum.xiaomi_miio/#retrieving-the-access-token) to get the API token to use in the `configuration.yaml` file. To add a Xiaomi Air Purifier to your installation, add the following to your `configuration.yaml` file: @@ -67,6 +193,10 @@ name: required: false type: string default: Xiaomi Air Purifier +model: + description: The model of your device. + required: false + type: string {% endconfiguration %} ## {% linkable_title Platform Services %} @@ -80,37 +210,37 @@ Set the fan speed/operation mode. | `entity_id` | yes | Only act on a specific air purifier. Else targets all. | | `speed` | no | Fan speed. Valid values are 'Auto', 'Silent', 'Favorite' and 'Idle' | -### {% linkable_title Service `fan.xiaomi_miio_set_buzzer_on` %} +### {% linkable_title Service `fan.xiaomi_miio_set_buzzer_on` %} (Air Purifier Pro excluded) Turn the buzzer on. -| Service data attribute | Optional | Description | -|---------------------------|----------|-------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | -### {% linkable_title Service `fan.xiaomi_miio_set_buzzer_off` %} +### {% linkable_title Service `fan.xiaomi_miio_set_buzzer_off` %} (Air Purifier Pro excluded) Turn the buzzer off. | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | -### {% linkable_title Service `fan.xiaomi_miio_set_led_on` %} +### {% linkable_title Service `fan.xiaomi_miio_set_led_on` %} (Air Purifier only) Turn the led on. | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | -### {% linkable_title Service `fan.xiaomi_miio_set_led_off` %} +### {% linkable_title Service `fan.xiaomi_miio_set_led_off` %} (Air Purifier only) Turn the led off. | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | ### {% linkable_title Service `fan.xiaomi_miio_set_child_lock_on` %} @@ -118,7 +248,7 @@ Turn the child lock on. | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | ### {% linkable_title Service `fan.xiaomi_miio_set_child_lock_off` %} @@ -126,23 +256,105 @@ Turn the child lock off. | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | -### {% linkable_title Service `fan.xiaomi_miio_set_led_brightness` %} +### {% linkable_title Service `fan.xiaomi_miio_set_led_brightness` %} (Air Purifier Pro excluded) Set the led brightness. Supported values are 0 (Bright), 1 (Dim), 2 (Off). | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | | `brightness` | no | Brightness, between 0 and 2. | -### {% linkable_title Service `fan.xiaomi_miio_set_favorite_level` %} +### {% linkable_title Service `fan.xiaomi_miio_set_favorite_level` %} (Air Purifier only) Set the favorite level of the operation mode "favorite". | Service data attribute | Optional | Description | |---------------------------|----------|---------------------------------------------------------| -| `entity_id` | yes | Only act on a specific air purifier. Else targets all. | +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | | `level` | no | Level, between 0 and 16. | +### {% linkable_title Service `fan.xiaomi_miio_set_auto_detect_on` %} (Air Purifier Pro only) + +Turn the auto detect on. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | + +### {% linkable_title Service `fan.xiaomi_miio_set_auto_detect_off` %} (Air Purifier Pro only) + +Turn the auto detect off. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | + +### {% linkable_title Service `fan.xiaomi_miio_set_learn_mode_on` %} (Air Purifier 2 only) + +Turn the learn mode on. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | + +### {% linkable_title Service `fan.xiaomi_miio_set_learn_mode_off` %} (Air Purifier 2 only) + +Turn the learn mode off. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | + +### {% linkable_title Service `fan.xiaomi_miio_set_volume` %} (Air Purifier Pro only) + +Set the sound volume. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | +| `volume` | no | Volume, between 0 and 100. | + +### {% linkable_title Service `fan.xiaomi_miio_reset_filter` %} (Air Purifier 2 only) + +Reset the filter lifetime and usage. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | + +### {% linkable_title Service `fan.xiaomi_miio_set_extra_features` %} (Air Purifier only) + +Set the extra features. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | +| `features` | no | Integer, known values are 0 and 1. | + +### {% linkable_title Service `fan.xiaomi_miio_set_target_humidity` %} (Air Humidifier only) + +Set the target humidity. + +| Service data attribute | Optional | Description | +|---------------------------|----------|-----------------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | +| `humidity` | no | Target humidity. Allowed values are 30, 40, 50, 60, 70 and 80 | + +### {% linkable_title Service `fan.xiaomi_miio_set_dry_on` %} (Air Humidifier CA only) + +Turn the dry mode on. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | + +### {% linkable_title Service `fan.xiaomi_miio_set_dry_off` %} (Air Humidifier CA only) + +Turn the dry mode off. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------| +| `entity_id` | yes | Only act on a specific Xiaomi miIO fan entity. Else targets all. | From 4bb87848f9befa992ff4b171a9c47e64897a3858 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 24 Mar 2018 22:25:22 -0700 Subject: [PATCH 005/241] clarify MQTT dev tool text --- source/_docs/tools/dev-tools.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_docs/tools/dev-tools.markdown b/source/_docs/tools/dev-tools.markdown index c9cc6a4c28..99ce3e7cf7 100644 --- a/source/_docs/tools/dev-tools.markdown +++ b/source/_docs/tools/dev-tools.markdown @@ -94,7 +94,8 @@ For more information about jinja2, visit [jinja2 documentation](http://jinja.poc {% linkable_title mqtt %} -This section is only visible if the MQTT is configured. To configure MQTT, add `mqtt:` to the `configuration.yaml` file. For more information, refer to [mqtt](/components/mqtt/) +This section is only visible if the MQTT component is configured. To configure MQTT, add `mqtt:` to the `configuration.yaml` file. For more information, refer to the [mqtt](/components/mqtt/) component. + Even though MQTT in general provides deeper functionality, the developer tools section of MQTT is limited to publishing messages to a given topic. It supports templates for the payload. To publish a message, simply specify the topic name and the payload and click “PUBLISH” button. {% linkable_title Info %} From 330808127df8a577e1886d4105ab29df5e5c6f18 Mon Sep 17 00:00:00 2001 From: Patrick Hofmann Date: Sun, 25 Mar 2018 22:22:17 +0200 Subject: [PATCH 006/241] Documentation of new HomeMatic lock section. (#4537) * Documentation of new HomeMatic lock section. * :pencil2: Minor updates --- source/_components/lock.homematic.markdown | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 source/_components/lock.homematic.markdown diff --git a/source/_components/lock.homematic.markdown b/source/_components/lock.homematic.markdown new file mode 100644 index 0000000000..d536312e2e --- /dev/null +++ b/source/_components/lock.homematic.markdown @@ -0,0 +1,18 @@ +--- +layout: page +title: "Homematic Lock (KeyMatic)" +description: "Instructions how to integrate Homematic locks (KeyMatic) within Home Assistant." +date: 2018-01-28 03:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: homematic.png +ha_category: Lock +ha_release: 0.66 +ha_iot_class: "Local Push" +--- + +The `homematic` lock platform lets you observe and control the state of the HomeMatic [Homematic](http://www.homematic.com/) KeyMatic lock through Home Assistant. + +Devices will be configured automatically. Please refer to the [component](/components/homematic/) configuration on how to setup Homematic. From 45617ed8680f0acb1f4203d9f0952c4c001d5683 Mon Sep 17 00:00:00 2001 From: Sacha Telgenhof Date: Tue, 27 Mar 2018 00:53:00 +0900 Subject: [PATCH 007/241] Added another implementation of MQTT JSON Lights: AiLight (#5024) * Added AiLight implementation of a MQTT JSON Light * Removed empty lines. --- source/_components/light.mqtt_json.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_components/light.mqtt_json.markdown b/source/_components/light.mqtt_json.markdown index 6313b71e3d..9455777285 100644 --- a/source/_components/light.mqtt_json.markdown +++ b/source/_components/light.mqtt_json.markdown @@ -228,3 +228,5 @@ Home Assistant will then convert its 8bit value in the message to and from the d - [MQTT JSON Light](https://github.com/mertenats/Open-Home-Automation/tree/master/ha_mqtt_rgbw_light_with_discovery) is another implementation for ESP8266 including [MQTT discovery](/docs/mqtt/discovery/). - [esphomelib](https://github.com/OttoWinter/esphomelib) is a library for ESP8266 and ESP32 boards that has many of Home Assistant's MQTT features (like [discovery](/docs/mqtt/discovery/)) pre-implemented and provides high-level abstractions for components such as lights or sensors. + +- [AiLight](https://github.com/stelgenhof/AiLight) is a custom firmware for the Ai-Thinker (and equivalent) RGBW WiFi light bulbs that has an ESP8266 onboard and controlled by the MY9291 LED driver. It implements the [MQTT JSON light](/components/light.mqtt_json/) platform and supports ON/OFF, RGBW colours, brightness, colour temperature, flashing and transitions. Also it includes [MQTT Auto Discovery](/docs/mqtt/discovery/)) and the MQTT Last Will and Testament is enabled as well. \ No newline at end of file From e54751230761acc544b1cdce2e8251a62fa1fe2d Mon Sep 17 00:00:00 2001 From: Dan Nixon Date: Mon, 26 Mar 2018 17:24:00 +0100 Subject: [PATCH 008/241] Update optionality of Telnet Switch config (#5007) State command and value template are optional parameters. --- source/_components/switch.telnet.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/switch.telnet.markdown b/source/_components/switch.telnet.markdown index 858a0b21b6..ef1345cd5b 100644 --- a/source/_components/switch.telnet.markdown +++ b/source/_components/switch.telnet.markdown @@ -39,6 +39,6 @@ Configuration variables: - **port** (*Optional*): Port to connect to. Default is 23 if not defined. - **command_on** (*Required*): Command to turn device on. - **command_off** (*Required*): Command to turn device off. - - **command_state** (*Required*): Command to determine the state of the switch. If not defined the switch will assume successful state changes. - - **value_template** (*Required*): The template evaluating to `true` will indicate that the switch is on. + - **command_state** (*Optional*): Command to determine the state of the switch. If not defined the switch will assume successful state changes. + - **value_template** (*Optional*): The template evaluating to `true` will indicate that the switch is on. - **name** (*Optional*): The name used to display the switch in the frontend. From 50b20f06da39c44ef71fad232633b20efa9197d7 Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Tue, 27 Mar 2018 20:30:16 +0200 Subject: [PATCH 009/241] yeelight: Operation mode service added (#4964) --- source/_components/light.yeelight.markdown | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/_components/light.yeelight.markdown b/source/_components/light.yeelight.markdown index e3fc28821f..b9808e7760 100644 --- a/source/_components/light.yeelight.markdown +++ b/source/_components/light.yeelight.markdown @@ -63,3 +63,14 @@ This component is tested to work with the following models. If you have a differ - **YLDD02YL**: Lightstrip (Color) - **MJCTD01YL**: Xiaomi Mijia Bedside Lamp - WIFI Version! - **MJTD01YL**: Xiaomi Mijia Smart LED Desk Lamp (autodiscovery isn't possible because the device doesn't support mDNS due to the small amount of RAM) + +## {% linkable_title Platform Services %} + +### {% linkable_title Service `light.yeelight_set_mode` %} + +Set a operation mode. + +| Service data attribute | Optional | Description | +|---------------------------|----------|---------------------------------------------------------------------------------------------| +| `entity_id` | yes | Only act on a specific yeelight. Else targets all. | +| `mode` | no | Operation mode. Valid values are 'last', 'normal', 'rgb', 'hsv', 'color_flow', 'moonlight'. | From 88c8cc2ff102f0ddc7823bde8a34016fd633786d Mon Sep 17 00:00:00 2001 From: Mikael Svensson Date: Wed, 28 Mar 2018 09:04:48 +0200 Subject: [PATCH 010/241] Template function state_attr to get attribute from a state (#4981) * Adds docs for https://github.com/home-assistant/home-assistant/pull/13378 * :ambulance: Fixes build error --- source/_docs/configuration/templating.markdown | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index d00a879b7b..5bd5d45789 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -68,6 +68,7 @@ Home Assistant adds extensions to allow templates to access all of the current s - `states.sensor.temperature` returns the state object for `sensor.temperature`. - `states('device_tracker.paulus')` will return the state string (not the object) of the given entity or `unknown` if it doesn't exist. - `is_state('device_tracker.paulus', 'home')` will test if the given entity is specified state. +- `state_attr('device_tracker.paulus', 'battery')` will return the value of the attribute or None if it doesn't exist. - `is_state_attr('device_tracker.paulus', 'battery', 40)` will test if the given entity is specified state. - `now()` will be rendered as current time in your time zone. - For specific values: `now().second`, `now().minute`, `now().hour`, `now().day`, `now().month`, `now().year`, `now().weekday()` and `now().isoweekday()` @@ -114,7 +115,7 @@ The next two statements result in same value if state exists. The second one wil ### {% linkable_title Attributes %} -Print an attribute if state is defined +Print an attribute if state is defined. Both will return the same thing but the last one you can specify entity_id from a variable. ```text {% raw %}{% if states.device_tracker.paulus %} @@ -124,6 +125,18 @@ Print an attribute if state is defined {% endif %}{% endraw %} ``` +With strings + +```text +{% raw %}{% set tracker_name = "paulus"%} + +{% if states("device_tracker." + tracker_name) != "unknown" %} + {{ state_attr("device_tracker." + tracker_name, "battery")}} +{% else %} + ?? +{% endif %}{% endraw %} +``` + ### {% linkable_title Sensor states %} Print out a list of all the sensor states. From 9cc2bce7614cb67c999f5372f1172b7d67d9ab21 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Wed, 28 Mar 2018 00:18:38 -0700 Subject: [PATCH 011/241] Make edit links GitHub aware (#5038) * Make edit links GitHub aware * Fix repo url * don't mutate existing string * Move comment * Fix url --- plugins/environment_variables.rb | 17 +++++++++++++++++ source/_includes/edit_github.html | 2 +- 2 files changed, 18 insertions(+), 1 deletion(-) create mode 100644 plugins/environment_variables.rb diff --git a/plugins/environment_variables.rb b/plugins/environment_variables.rb new file mode 100644 index 0000000000..7d9203f164 --- /dev/null +++ b/plugins/environment_variables.rb @@ -0,0 +1,17 @@ +module Jekyll + class EnvironmentVariablesGenerator < Generator + def generate(site) + # https://www.netlify.com/docs/continuous-deployment/#build-environment-variables + repo_url = ENV['REPOSITORY_URL'] || 'https://github.com/home-assistant/home-assistant.github.io' + + # Rewrite urls if repo url is the ssh format. + if repo_url.start_with? 'git@github.com:' + repo_url = repo_url.sub 'git@github.com:', 'https://github.com/' + end + + # These values will be available as {{ site.NLY_REPOSITORY_URL }} + site.config['NLY_REPOSITORY_URL'] = repo_url + site.config['NLY_HEAD'] = ENV['HEAD'] || 'current' + end + end +end diff --git a/source/_includes/edit_github.html b/source/_includes/edit_github.html index f599869c81..b5fa2329b8 100644 --- a/source/_includes/edit_github.html +++ b/source/_includes/edit_github.html @@ -1,4 +1,4 @@ {% assign url_parts = page.url | split: '/' %} {% if page.hide_github_edit != true %} -
Edit this page on GitHub
+
Edit this page on GitHub
{% endif %} From f0bff4278eb37274e654fa150278412c98fc304b Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Thu, 29 Mar 2018 09:05:42 +0200 Subject: [PATCH 012/241] Yeelight Smart LED Ceiling Light added to the list of supported devices (#5029) --- source/_components/light.yeelight.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_components/light.yeelight.markdown b/source/_components/light.yeelight.markdown index b9808e7760..002e20ff1f 100644 --- a/source/_components/light.yeelight.markdown +++ b/source/_components/light.yeelight.markdown @@ -35,7 +35,7 @@ light: Configuration variables: -- **ip** (*Required*): IP(s) of your wifi bulbs +- **ip** (*Required*): IP(s) of your Wifi bulbs - **name** (*Optional*): A friendly name for the device. - **transition** (*Optional*, default 350): Smooth transitions over time (in ms). - **use_music_mode** (*Optional*, default False): Enable music mode. @@ -63,6 +63,8 @@ This component is tested to work with the following models. If you have a differ - **YLDD02YL**: Lightstrip (Color) - **MJCTD01YL**: Xiaomi Mijia Bedside Lamp - WIFI Version! - **MJTD01YL**: Xiaomi Mijia Smart LED Desk Lamp (autodiscovery isn't possible because the device doesn't support mDNS due to the small amount of RAM) +- **YLXD01YL**: Yeelight Smart LED Ceiling Light - Youth Version + ## {% linkable_title Platform Services %} From cb0398bee5f34b13a3e376c661e292b891dab745 Mon Sep 17 00:00:00 2001 From: Diogo Gomes Date: Thu, 29 Mar 2018 08:06:18 +0100 Subject: [PATCH 013/241] clarify default db_url (#5021) * clarify default db_url * Update format --- source/_components/sensor.sql.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.sql.md b/source/_components/sensor.sql.md index 28ec379788..e676ca9d43 100644 --- a/source/_components/sensor.sql.md +++ b/source/_components/sensor.sql.md @@ -37,7 +37,7 @@ sensor: db_url: description: The URL which points to your database. See [supported engines](/components/recorder/#custom-database-engines). required: false - default: Defaults to the recorder db_url. + default: "Defaults to the default recorder `db_url` (not the current `db_url` of recorder)." type: string queries: description: List of your queries. From 0724d9f456b90313e5ddcf07404ce98c57c21cb3 Mon Sep 17 00:00:00 2001 From: Andy Castille Date: Thu, 29 Mar 2018 22:00:54 -0500 Subject: [PATCH 014/241] Add new Doorbird config option (#5047) --- source/_components/doorbird.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/doorbird.markdown b/source/_components/doorbird.markdown index 4ce686ec64..31b42ef729 100644 --- a/source/_components/doorbird.markdown +++ b/source/_components/doorbird.markdown @@ -31,6 +31,7 @@ Configuration variables: - **username** (*Required*): The username of a non-administrator user account on the device. - **password** (*Required*): The password for the user specified. - **doorbell_events** (*Optional*): Setting this to `true` this will register a callback URL with the device so that events can be published to the event bus when the doorbell rings. +- **hass_url_override** (*Optional*): If your DoorBird cannot connect to the machine running Home Assistant because you are using dynamic DNS or some other HTTP configuration, specify the LAN IP of the machine here to force a LAN connection.

Enabling `doorbell_events` will delete all other registered push notification services with the device every time Home Assistant starts. This will not affect notifications delivered by the DoorBird mobile app. From 1987571074bf544ca0ee47388fdbc23068aad6fb Mon Sep 17 00:00:00 2001 From: Beat <508289+bdurrer@users.noreply.github.com> Date: Sat, 31 Mar 2018 13:07:31 +0200 Subject: [PATCH 015/241] Add FreeDNS component (#5046) * Add FreeDNS component * Move the instructions up --- source/_components/freedns.markdown | 49 +++++++++++++++++++ .../development_guidelines.markdown | 2 +- 2 files changed, 50 insertions(+), 1 deletion(-) create mode 100644 source/_components/freedns.markdown diff --git a/source/_components/freedns.markdown b/source/_components/freedns.markdown new file mode 100644 index 0000000000..960d1411d9 --- /dev/null +++ b/source/_components/freedns.markdown @@ -0,0 +1,49 @@ +--- +layout: page +title: "freedns.afraid.org" +description: "Keep your DNS record up to date with FreeDNS." +date: 2018-03-27 21:30 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: Utility +ha_release: 0.67 +--- + +With the `freedns` component you can keep your [FreeDNS](https://freedns.afraid.org) record up to date. + +## {% linkable_title Configuration %} + +You need to determine your update URL or your access token. + +1. Head over to the [FreeDNS](https://freedns.afraid.org) website and login to your account. +2. Select the menu "Dynamic DNS" +3. You should now see your update candiates in a table at the bottom of the page. +4. Copy the link target of the "Direct URL". +5. The access token is the part at the end of the link: `https://freedns.afraid.org/dynamic/update.php?YOUR_UPDATE_TOKEN` +6. Either put the token as `access_token` _or_ the whole URL into the `url` attribute. + +To use the component in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +freedns: + access_token: YOUR_TOKEN +``` + +{% configuration %} + access_token: + description: Your access token. This is exclusive to `url`. + required: false + type: string + url: + description: The full update URL. This is exclusive to `access_token`. + required: false + type: string + update_interval: + description: How often to call the update service. + required: false + type: time period + default: 10 minutes +{% endconfiguration %} diff --git a/source/developers/development_guidelines.markdown b/source/developers/development_guidelines.markdown index edfabb9b26..7e4088249c 100644 --- a/source/developers/development_guidelines.markdown +++ b/source/developers/development_guidelines.markdown @@ -78,4 +78,4 @@ _LOGGER.error("No route to device: %s", self._resource) ``` Don't print out wrong API keys, tokens, usernames, or passwords. - +Also note that `_LOGGER.info` is reserved for the core, use `_LOGGER.debug` in anything else. From 308fe9eea19bea8a2e49eca9963c94ea88ed1f1c Mon Sep 17 00:00:00 2001 From: Jonas Pedersen Date: Sat, 31 Mar 2018 13:10:00 +0200 Subject: [PATCH 016/241] Minor syntax correction. (#5066) --- source/_docs/ecosystem/appdaemon/api.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/ecosystem/appdaemon/api.markdown b/source/_docs/ecosystem/appdaemon/api.markdown index 2f8e38c162..923505b262 100755 --- a/source/_docs/ecosystem/appdaemon/api.markdown +++ b/source/_docs/ecosystem/appdaemon/api.markdown @@ -1422,7 +1422,7 @@ Name of the event to subscribe to. Can be a standard Home Assistant event such a One or more keyword value pairs representing App specific parameters to supply to the callback. If the keywords match values within the event data, they will act as filters, meaning that if they don't match the values, the callback will not fire. -As an example of this, a Minimote controller when activated will generate an event called `zwave.scene_activated`, along with 2 pieces of data that are specific to the event - `entity_id` and `scene`. If you include keyword values for either of those, the values supplied to the `listen_event()1 call must match the values in the event or it will not fire. If the keywords do not match any of the data in the event they are simply ignored. +As an example of this, a Minimote controller when activated will generate an event called `zwave.scene_activated`, along with 2 pieces of data that are specific to the event - `entity_id` and `scene`. If you include keyword values for either of those, the values supplied to the `listen_event()` call must match the values in the event or it will not fire. If the keywords do not match any of the data in the event they are simply ignored. Filtering will work with any event type, but it will be necessary to figure out the data associated with the event to understand what values can be filtered on. This can be achieved by examining Home Assistant's logfiles when the event fires. From 69f0361c999591f21f84fa4af189d64d75cebae4 Mon Sep 17 00:00:00 2001 From: Rene Nulsch <33263735+ReneNulschDE@users.noreply.github.com> Date: Sat, 31 Mar 2018 15:23:13 +0200 Subject: [PATCH 017/241] Add removal note (#5053) --- source/_components/mercedesme.markdown | 26 +------------------------- 1 file changed, 1 insertion(+), 25 deletions(-) diff --git a/source/_components/mercedesme.markdown b/source/_components/mercedesme.markdown index 82f8679f45..db5774c518 100644 --- a/source/_components/mercedesme.markdown +++ b/source/_components/mercedesme.markdown @@ -23,29 +23,5 @@ This component provides the following platforms: - Device tracker: To track location of your car.

- The component can integrate cars from European and African markets only. -

- -To use Mercedes me in your installation, add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -mercedesme: - username: YOUR_E_MAIL_ADDRESS - password: YOUR_PASSWORD -``` - -{% configuration %} -username: - description: The email address associated with your Mercedes me account. - required: true - type: string -password: - description: The password for your given Mercedes me account. - required: true - type: string -{% endconfiguration %} - -

-The requirement `lxml` has to be [installed](http://lxml.de/installation.html) manually `pip install lxml` on some devices. + The component was removed. The vendor disabled the API endpoint and a new API is not available currently.

From e0540d27dc45a2bff7b64238d32353a0d51c42cc Mon Sep 17 00:00:00 2001 From: Myrddyn Date: Sat, 31 Mar 2018 17:01:15 -0400 Subject: [PATCH 018/241] Added "Waze travel time" sensor documentation (#4498) * Added Waze Travel Time documentation * Added Waze Travel Time documentation * Added Waze Travel Time documentation Fixed commit remarks from frenck * * Added Waze Travel Time documentation Fixed commit remarks from frenck * :pencil2: Tweaks * Multiple fixes * Update --- .../sensor.waze_travel_time.markdown | 51 ++++++++++++++++++ source/images/supported_brands/waze.png | Bin 0 -> 21843 bytes 2 files changed, 51 insertions(+) create mode 100644 source/_components/sensor.waze_travel_time.markdown create mode 100755 source/images/supported_brands/waze.png diff --git a/source/_components/sensor.waze_travel_time.markdown b/source/_components/sensor.waze_travel_time.markdown new file mode 100644 index 0000000000..2440930b9f --- /dev/null +++ b/source/_components/sensor.waze_travel_time.markdown @@ -0,0 +1,51 @@ +--- +layout: page +title: "Waze Travel Time" +description: "Instructions on how to add Waze travel time to Home Assistant." +date: 2018-01-23 00:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: waze.png +ha_category: Transport +ha_iot_class: "Cloud Polling" +ha_release: 0.67 +--- + +The `waze_travel_time` sensor provides travel time from the [Waze](https://www.waze.com/). + +Unit system is set to metric system. + +## {% linkable_title Configuration %} + +To use this sensor in your installation, add the following `abode` section to your `configuration.yaml` file: + +```yaml +# Example entry for configuration.yaml +sensor: + - platform: waze_travel_time + origin: Montréal, QC + destination: Québec, QC + region: 'US' +``` + +{% configuration %} +origin: + description: Enter the starting address or the GPS coordinates of the location (GPS coordinates has to be separated by a comma). + required: true + type: string +destination: + description: Enter the destination address or the GPS coordinates of the location (GPS coordinates has to be separated by a comma). + required: true + type: string +region: + description: Choose one of the available regions from 'EU', 'US', 'NA' (equivalent to 'US') or 'IL'. + required: true + type: string +name: + description: A name to display on the sensor. + required: false + default: "Waze Travel Time" + type: string +{% endconfiguration %} diff --git a/source/images/supported_brands/waze.png b/source/images/supported_brands/waze.png new file mode 100755 index 0000000000000000000000000000000000000000..927614e0c880fb95f819095acb379d531e1e7879 GIT binary patch literal 21843 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 Geg8jp{X)?I literal 0 HcmV?d00001 From ce94c3bc6d8f4b554c004c5fb57e3f90f299d687 Mon Sep 17 00:00:00 2001 From: Andrew Date: Sat, 31 Mar 2018 23:15:32 +0200 Subject: [PATCH 019/241] Updated Amcrest component documentation to include support for switches (#4862) * Updated Amcrest component documentation to include support for switches * :pencil2: Tweaks * Update release --- source/_components/amcrest.markdown | 6 ++++++ source/_components/switch.amcrest.markdown | 18 ++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 source/_components/switch.amcrest.markdown diff --git a/source/_components/amcrest.markdown b/source/_components/amcrest.markdown index fc62783afa..74c76e70dd 100644 --- a/source/_components/amcrest.markdown +++ b/source/_components/amcrest.markdown @@ -28,6 +28,9 @@ amcrest: sensors: - motion_detector - sdcard + switches: + - motion_detection + - motion_recording - host: IP_ADDRESS_CAMERA_2 username: YOUR_USERNAME @@ -54,6 +57,9 @@ Configuration variables: - **motion_detector**: Return True/False when a motion is detected - **sdcard**: Return the SD card usage by reporting the total and used space - **ptz_preset**: Return the number of PTZ preset positions configured for the given camera +- **switches** array (*Optional*): Switches to display in the frontend. By default, *none* of the switches are shown. The following switches can be monitored. + - **motion_detection**: Enable/disable motion detection setting + - **motion_recording**: Enable/disable recording on motion detection setting **Note:** Amcrest cameras with newer firmware no longer have the ability to stream `high` definition video with MJPEG encoding. You may need to use `low` resolution stream or the `snapshot` stream source instead. If the quality seems too poor, lower the `Frame Rate (FPS)` and max out the `Bit Rate` settings in your camera's configuration manager. If you defined the *stream_source* to **mjpeg**, make sure your camera supports *Basic* HTTP authentication. Newer Amcrest firmware may not work, then **rtsp** is recommended instead. diff --git a/source/_components/switch.amcrest.markdown b/source/_components/switch.amcrest.markdown new file mode 100644 index 0000000000..d9ed4564b2 --- /dev/null +++ b/source/_components/switch.amcrest.markdown @@ -0,0 +1,18 @@ +--- +layout: page +title: "Amcrest IP Camera Settings" +description: "Instructions on how to integrate settings for Amcrest IP Camera as switches within Home Assistant." +date: 2018-03-08 00:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: amcrest.png +ha_category: Switch +ha_release: 0.67 +ha_iot_class: "Local Polling" +--- + +The `amcrest` switch platform lets you control settings of [Amcrest IP Camera](https://home-assistant.io/components/camera.amcrest/) through Home Assistant. + +Switches will be configured automatically. Please refer to the [component](/components/amcrest/) configuration on how to setup. From 9caa6eb53f9ca646e0545bfe9d575b5e2de50535 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 31 Mar 2018 23:21:15 +0200 Subject: [PATCH 020/241] Add mastodon docs (#5010) --- source/_components/notify.mastodon.markdown | 52 ++++++++++++++++++++ source/images/supported_brands/mastodon.png | Bin 0 -> 7492 bytes 2 files changed, 52 insertions(+) create mode 100644 source/_components/notify.mastodon.markdown create mode 100644 source/images/supported_brands/mastodon.png diff --git a/source/_components/notify.mastodon.markdown b/source/_components/notify.mastodon.markdown new file mode 100644 index 0000000000..2e8327f4c2 --- /dev/null +++ b/source/_components/notify.mastodon.markdown @@ -0,0 +1,52 @@ +--- +layout: page +title: "Mastodon" +description: "Instructions on how to add Instapush notifications to Home Assistant." +date: 2018-03-25 18:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: mastodon.png +ha_category: Notifications +ha_release: 0.67 +--- + + +The `mastodon` platform uses [MAstodon](https://joinmastodon.org/) to delivery notifications from Home Assistant. + +Go to **Preferences** in the Mastodon web interface, then to **Development** and create a new application. + +To add Mastodon to your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +notify: + - name: NOTIFIER_NAME + platform: mastodon + access_token: !secret mastodon_access_token + client_id: !secret mastodon_client_id + client_secret: !secret mastodon_client_secret +``` + +{% configuration %} +access_token: + description: Your Mastodon access token. + required: true + type: string +client_id: + description: Your Mastodon client ID + required: true + type: string +client_secret: + description: Your Mastodon client secret. + required: true + type: string +base_url: + description: URL of the Mastodon instance to use. + required: false + type: string + default: https://mastodon.social +{% endconfiguration %} + +To use notifications, please see the [getting started with automation page](/getting-started/automation/). diff --git a/source/images/supported_brands/mastodon.png b/source/images/supported_brands/mastodon.png new file mode 100644 index 0000000000000000000000000000000000000000..7a156e5b817ac0cf4008accf5d232a73405bbc47 GIT binary patch literal 7492 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 Date: Sat, 31 Mar 2018 23:23:26 +0200 Subject: [PATCH 021/241] Added request_rssi configuration variable to docs (#4684) * Added request_rssi configuration variable to docs * Used configuration tags * Removed extra configuration variable header --- .../_components/device_tracker.bluetooth_tracker.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/device_tracker.bluetooth_tracker.markdown b/source/_components/device_tracker.bluetooth_tracker.markdown index 0a2a2d0632..45bd09eae3 100644 --- a/source/_components/device_tracker.bluetooth_tracker.markdown +++ b/source/_components/device_tracker.bluetooth_tracker.markdown @@ -27,6 +27,14 @@ device_tracker: - platform: bluetooth_tracker ``` +{% configuration %} +request_rssi: + description: Performs a request for the "Received signal strength indication" (RSSI) of each tracked device + required: false + type: boolean + default: False +{% endconfiguration %} + In some cases it can be that your device is not discovered. In that case let your phone scan for Bluetooth devices while you restart Home Assistant. Just hit `Scan` on your phone all the time until Home Assistant is fully restarted and the device should appear in `known_devices.yaml`. For additional configuration variables check the [Device tracker page](/components/device_tracker/). From bc9e59bb967f4d9ec3365451df5b15ce330b3b18 Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Sun, 1 Apr 2018 21:19:45 +0200 Subject: [PATCH 022/241] Duplicate configuration line removed --- source/_components/sensor.xiaomi_miio.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_components/sensor.xiaomi_miio.markdown b/source/_components/sensor.xiaomi_miio.markdown index 3e30131fff..65d1f3780f 100644 --- a/source/_components/sensor.xiaomi_miio.markdown +++ b/source/_components/sensor.xiaomi_miio.markdown @@ -29,7 +29,6 @@ Please follow the instructions on [Retrieving the Access Token](/components/vacu To add a Xiaomi Mi Air Quality Monitor to your installation, add the following to your `configuration.yaml` file: ```yaml -sensor: # Example configuration.yaml entry sensor: - platform: xiaomi_miio From 481fb147c7ae8f83a76646cd7cfc7fc3b622870d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C3=ABl=20Arnauts?= Date: Mon, 2 Apr 2018 16:36:28 +0200 Subject: [PATCH 023/241] New Component: Add docs for Google Maps Location Sharing (#4646) * Add docs for Google Maps Location Sharing * Typo * :pencil2: Small updates * :pencil2: Migrated to configuration tags and ups HA version --- .../device_tracker.google_maps.markdown | 46 +++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 source/_components/device_tracker.google_maps.markdown diff --git a/source/_components/device_tracker.google_maps.markdown b/source/_components/device_tracker.google_maps.markdown new file mode 100644 index 0000000000..6f2175a604 --- /dev/null +++ b/source/_components/device_tracker.google_maps.markdown @@ -0,0 +1,46 @@ +--- +layout: page +title: "Google Maps Location Sharing" +description: "Instructions how to use Google Maps Location Sharing to track devices in Home Assistant." +date: 2017-02-12 10:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: google_maps.png +ha_release: 0.67 +ha_category: Presence Detection +ha_iot_class: "Cloud Polling" +--- + +The `google_maps` platform allows you to detect presence using the unofficial API of [Google Maps Location Sharing](https://myaccount.google.com/locationsharing). + +You first need to create an additional Google account and share your location with that account. This platform will use that account to fetch the location of your device(s). You have to setup sharing through the Google Maps app on your mobile phone. You can find more information [here](https://support.google.com/accounts?p=location_sharing). + +This platform will create a file named `google_maps_location_sharing.conf` where it caches your login session. + +

+Since this platform is using an official API with the help of [locationsharinglib](https://github.com/costastf/locationsharinglib), Google seems to block access to your data the first time you've logged in with this component. +This issue can be fixed by logging in with your new account and approving your login on the [Device Activity](https://myaccount.google.com/device-activity) page. +

+ +To integrate Google Maps Location Sharing in Home Assistant, add the following section to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +device_tracker: + platform: google_maps + username: example@gmail.com + password: password +``` + +{% configuration %} +username: + description: The email address for the Google account that has access to your shared location. + required: true + type: string +password: + description: The password for your given username. + required: true + type: string +{% endconfiguration %} From 7dbed031cba045313aff5756bce6db0b0fa3dc97 Mon Sep 17 00:00:00 2001 From: Robin Date: Mon, 2 Apr 2018 15:37:58 +0100 Subject: [PATCH 024/241] Adds docs for folder_watcher component (#4885) * Create folder_watcher.markdown * Adds posting file * Update folder_watcher.markdown * :pencil2: Markdownlint fixes * :pencil2: Escapes jinja code in example * :pencil2: Build fix part 2 * :ambulance: Fixes build * :arrow_up: Ups ha_release to 0.67 --- source/_components/folder_watcher.markdown | 77 ++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 source/_components/folder_watcher.markdown diff --git a/source/_components/folder_watcher.markdown b/source/_components/folder_watcher.markdown new file mode 100644 index 0000000000..2e842114f7 --- /dev/null +++ b/source/_components/folder_watcher.markdown @@ -0,0 +1,77 @@ +--- +layout: page +title: "folder watcher" +description: "Component for monitoring changes within the filesystem." +date: 2018-03-11 14:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: home-assistant.png +ha_category: System Monitor +ha_iot_class: "Local Polling" +ha_release: 0.67 +--- + +This component adds [Watchdog](https://pythonhosted.org/watchdog/) file system monitoring, publishing events on the Home-Assistant bus on the creation/deletion/modification of files. + +To configure the `folder_watcher` component add to you `configuration.yaml` file: + +```yaml +{% raw %} +folder_watcher: + watchers: + - folder: /config +{% endraw %} +``` + +{% configuration %} +folder: + description: The folder path + required: true + type: string +patterns: + description: Pattern matching to apply + required: false + default: "*" + type: string +{% endconfiguration %} + +## Patterns + +Pattern matching using [fnmatch](https://docs.python.org/3.6/library/fnmatch.html) can be used to limit filesystem monitoring to only files which match the configured patterns. The following example shows the configuration required to only monitor filetypes `.yaml` and `.txt`. + +```yaml +{% raw %} +folder_watcher: + watchers: + - folder: /config + patterns: + - '*.yaml' + - '*.txt' +{% raw %} +``` + +## Automations + +Automations can be triggered on filesystem event data using a data_template. The following automation will send a notification with the name and folder of new files added to that folder: + +```yaml +{% raw %} +- action: + - data_template: + message: 'Created {{trigger.event.data.file}} in {{trigger.event.data.folder}}' + title: New image captured! + data: + file: "{{trigger.event.data.path}}" + service: notify.pushbullet + alias: New file alert + condition: [] + id: '1520092824697' + trigger: + - event_data: {"event_type":"created"} + event_type: folder_watcher + platform: event +{% endraw %} +``` + From 3aa3be14397a3b11de455db4c36151c711ca3b11 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 2 Apr 2018 17:22:12 +0200 Subject: [PATCH 025/241] Minor changes (#5084) --- source/_components/binary_sensor.workday.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/binary_sensor.workday.markdown b/source/_components/binary_sensor.workday.markdown index 0d4782bc12..edc34b5a37 100644 --- a/source/_components/binary_sensor.workday.markdown +++ b/source/_components/binary_sensor.workday.markdown @@ -15,6 +15,10 @@ ha_release: 0.41 The `workday` binary sensor indicates, whether the current day is a workday or not. It allows specifying, which days of the week counts as workdays and also uses the python module [holidays](https://pypi.python.org/pypi/holidays) to incorporate information about region-specific public holidays. +## {% linkable_title Configuration %} + +Check the [country list](https://github.com/dr-prodigy/python-holidays#available-countries) for available province. + To enable the `workday` sensor in your installation, add the following to your `configuration.yaml` file: ```yaml From e2e349c30d10e317d400e37fad4fc1de6a1847a6 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Mon, 2 Apr 2018 17:35:46 +0200 Subject: [PATCH 026/241] Qwikswitch refactor & sensors (#5045) * Qwikswitch refactor & sensors PR: https://github.com/home-assistant/home-assistant/pull/13509 * :pencil2: Some minor tweaks --- source/_components/qwikswitch.markdown | 38 ++++++++++++++++++-------- 1 file changed, 26 insertions(+), 12 deletions(-) diff --git a/source/_components/qwikswitch.markdown b/source/_components/qwikswitch.markdown index cb4d6f3695..516658404a 100644 --- a/source/_components/qwikswitch.markdown +++ b/source/_components/qwikswitch.markdown @@ -13,12 +13,9 @@ featured: false ha_release: "0.20" --- +The `qwikswitch` component is the main component to integrate various [QwikSwitch](http://www.qwikswitch.co.za/) devices with Home Assistant. The integration requires the QSUSB Modem device and connects to the QS Mobile application. -The `qwikswitch` component is the main component to integrate various [QwikSwitch](http://www.qwikswitch.co.za/) devices with Home Assistant. - -Loading the `qwikswitch` component automatically adds all devices from the QS Mobile application. QS Mobile controls the QSUSB Modem device. - -Currently QwikSwitch relays and LED dimmers are supported (tested). QwikSwitch relay devices can be [switches](/components/switch.qwikswitch/) or [lights](/components/light.qwikswitch/) in Home-Assistant. If the device name in the QSUSB app ends with ` Switch` it will be created as a switch, otherwise as a light. +The `qwikswitch` component discovers all devices from QS Mobile. Currently, Relays and LED dimmers are discovered in Home Assistant. Relay devices are [lights](/components/light.qwikswitch/) by default, and can be configured as [switches](/components/switch.qwikswitch/). Example configuration: @@ -31,28 +28,45 @@ qwikswitch: Configuration variables: - **url** (*Required*): The URL including the port of your QwikSwitch hub. -- **dimmer_adjust** (*Optional*): A decimal value to adjust the brightness of the dimmer exponentially. Increasing this value allows dimmers that reaches full brightness with low values in QS Mobile to appear more linear in Home Assistant. Recommended values between 1 and 2 and the default is 1. -- **button_events** (*Optional*): A comma separated list of button types that will generate events. Details below. +- **dimmer_adjust** (*Optional*): A decimal value to adjust the brightness of the dimmer exponentially. Increasing this value allows dimmers that reach full brightness with low values in QS Mobile to appear more linear in Home Assistant. Recommended values between 1 and 2 and the default is 1. +- **button_events** (*Optional*): A comma-separated list of button types that will generate events. See [QwikSwitch Events] for detail. +- **switches** (*Optional*): A list of device QS_id's that should be switches, and not lights (i.e. `['@0dev01', '@0dev02']`) +- **sensors** (*Optional*): A dictionary of sensors. In the format of {entity_id: QS_id}. (i.e. `{door_sensor: '@0dev03'}`) -### {% linkable_title QwikSwitch Buttons %} +### {% linkable_title QwikSwitch Events %} -QwikSwitch devices (i.e. transmitter buttons) will fire events on the Home Assistant bus. These events can then be used as triggers for any `automation` action, as follows: +QwikSwitch devices (i.e., transmitter buttons) will fire events on the Home Assistant bus. These events can then be used as triggers for any `automation` action, as follows: ```yaml automation: - - alias: Action - Respond to button press + - alias: Action - Respond to A button press trigger: platform: event event_type: qwikswitch.button.@12df34 ``` -`event_type` names should be in the format **qwikswitch.button.@__ID__**. where **@__ID__** will be captured in the Home Assistant log when pressing the button. Alternatively, you can also get the device ID from the QS Mobile application or using the listen API call by browsing to `http://127.0.0.1:2020/&listen` and then pressing the button. +`event_type` names should be in the format **qwikswitch.button.@_QS_id_**. where **@_QS_id_** will be captured in the Home Assistant log when pressing the button. Alternatively, you can also get the device ID from the QS Mobile application or by using the listen API call by browsing to `http://127.0.0.1:2020/&listen` and then pressing the button. + +The full packet from the QSUSB API will be passed as `data` By default events will be fired if the value in the command (cmd) field of the listen packet equals: - `TOGGLE` - Normal QwikSwitch Transmitter button - `SCENE EXE` - QwikSwitch Scene Transmitter buttons - `LEVEL` - QwikSwitch OFF Transmitter buttons -The list of recognized commands can be extended for Keyfobs, door sensors, and PIR transmitters with the **button_events** configuration option. **button_events** contain a comma separated list of commands that will fire Home Assistant events. By default it is: TOGGLE,SCENE EXE,LEVEL. +The list of recognized commands can be extended for Keyfobs, door sensors, and PIR transmitters with the **button_events** configuration option. **button_events** can be a list or comma separated list of additional commands that will fire Home Assistant events. By default, it is: TOGGLE,SCENE EXE,LEVEL. On some QS Mobile servers button events are only generated for switches added to the QS Mobile application, so it might be best to test button presses through the `/&listen` API + +### {% linkable_title Qwikswitch Sensors %} + +Some Qwikswith devices might support more than one channel per device (i.e. ipmod). The channel can be specified by appending a number to the QS_id. Example sensors configuration: + +```yaml +qwikswitch: + ... + sensors: + door_sensor: '@0dev01' + door2_sensor: '@0dev02.1' + door3_sensor: '@0dev02.2' +``` From 5869b00342653c30fb29b3a870c275f0608161bd Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Mon, 2 Apr 2018 19:45:36 +0200 Subject: [PATCH 027/241] Xiaomi Mi WiFi Repeater 2 integration as device tracker (#5077) --- .../device_tracker.xiaomi_miio.markdown | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 source/_components/device_tracker.xiaomi_miio.markdown diff --git a/source/_components/device_tracker.xiaomi_miio.markdown b/source/_components/device_tracker.xiaomi_miio.markdown new file mode 100644 index 0000000000..dad5feef5d --- /dev/null +++ b/source/_components/device_tracker.xiaomi_miio.markdown @@ -0,0 +1,38 @@ +--- +layout: page +title: "Xiaomi Mi WiFi Repeater 2" +description: "Instructions how to integrate your Xiaomi Mi WiFi Repeater 2 within Home Assistant." +date: 2018-04-01 21:06 +sidebar: true +comments: false +sharing: true +footer: true +logo: xiaomi.png +ha_category: Sensor +ha_version: 0.67 +ha_iot_class: "Local Polling" +--- + +The `xiaomi_miio` device tracker platform is observing your Xiaomi Mi WiFi Repeater 2 and reporting all associated WiFi clients. + +Please follow the instructions on [Retrieving the Access Token](/components/vacuum.xiaomi_miio/#retrieving-the-access-token) to get the API token. + +To add a Xiaomi Mi Air Quality Monitor to your installation, add the following to your `configuration.yaml` file: + +```yaml +device_tracker: + - platform: xiaomi_miio + host: 192.168.130.73 + token: YOUR_TOKEN +``` + +{% configuration %} +host: + description: The IP address of your miio device. + required: true + type: string +token: + description: The API token of your miio device. + required: true + type: string +{% endconfiguration %} From 66714881d7efdea6edb6279a56196f1890cb280e Mon Sep 17 00:00:00 2001 From: Robin Date: Wed, 4 Apr 2018 18:49:40 +0100 Subject: [PATCH 028/241] Remove ref to watchers (#5108) `watchers` is not required, was in an earlier version --- source/_components/folder_watcher.markdown | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/source/_components/folder_watcher.markdown b/source/_components/folder_watcher.markdown index 2e842114f7..ba97e44c63 100644 --- a/source/_components/folder_watcher.markdown +++ b/source/_components/folder_watcher.markdown @@ -20,8 +20,7 @@ To configure the `folder_watcher` component add to you `configuration.yaml` file ```yaml {% raw %} folder_watcher: - watchers: - - folder: /config + - folder: /config {% endraw %} ``` @@ -44,11 +43,10 @@ Pattern matching using [fnmatch](https://docs.python.org/3.6/library/fnmatch.htm ```yaml {% raw %} folder_watcher: - watchers: - - folder: /config - patterns: - - '*.yaml' - - '*.txt' + - folder: /config + patterns: + - '*.yaml' + - '*.txt' {% raw %} ``` From 4a1255889f73409e821ce886ebbaf3cc9f7e7036 Mon Sep 17 00:00:00 2001 From: mountainsandcode Date: Wed, 4 Apr 2018 20:53:54 +0200 Subject: [PATCH 029/241] Update templating.markdown (#5085) --- source/_docs/configuration/templating.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index 631804b6ae..6b3c34b0a0 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -86,6 +86,10 @@ Home Assistant adds extensions to allow templates to access all of the current s - Filter `timestamp_custom(format_string, local_boolean)` will convert an UNIX timestamp to a custom format, the use of a local timestamp is default, supporting [Python format options](https://docs.python.org/3/library/time.html#time.strftime). - Filter `max` will obtain the largest item in a sequence. - Filter `min` will obtain the smallest item in a sequence. +- Filter `regex_match(string, find, ignorecase=FALSE)` will match the find expression at the beginning of the string using regex. +- Filter `regex_search(string, find, ignorecase=FALSE)` will match the find expression anywhere in the string using regex. +- Filter `regex_replace(string, find='', replace='', ignorecase=False)` will replace the find expression with the replace string using regex. +- Filter `regex_findall_index(string, find='', index=0, ignorecase=False)` will find all regex matches of find in string and return the match at index (findall returns an array of matches). [strp-format]: https://docs.python.org/3.6/library/datetime.html#strftime-and-strptime-behavior From 1c1025546efc991fa2553a9004b2db215516149f Mon Sep 17 00:00:00 2001 From: Oleg Date: Wed, 4 Apr 2018 21:54:33 +0300 Subject: [PATCH 030/241] Added headers configuration variable to notify.rest component (#5103) --- source/_components/notify.rest.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/notify.rest.markdown b/source/_components/notify.rest.markdown index c20e4bc2f5..4d1d83c581 100644 --- a/source/_components/notify.rest.markdown +++ b/source/_components/notify.rest.markdown @@ -30,6 +30,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`. - **resource** (*Required*): The resource or endpoint that will receive the value. - **method** (*Optional*): The method of the request. Default is GET. +- **headers** (*Optional*): The headers for the request. - **message_param_name** (*Optional*): Parameter name for the message. Defaults to `message`. - **title_param_name** (*Optional*): Parameter name for the title. Defaults to none. - **target_param_name** (*Optional*): Parameter name for the target. Defaults to none. From f4220b5c10ebf2989dee704e53272d0cfaada0e5 Mon Sep 17 00:00:00 2001 From: Phil Cole Date: Wed, 4 Apr 2018 21:12:30 +0100 Subject: [PATCH 031/241] Update Debian Stabel python version --- source/developers/asyncio_misc.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/developers/asyncio_misc.markdown b/source/developers/asyncio_misc.markdown index 695b26e3e0..3fbc923c6f 100644 --- a/source/developers/asyncio_misc.markdown +++ b/source/developers/asyncio_misc.markdown @@ -10,7 +10,7 @@ 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. +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.5.3. For more information, Brett Cannon wrote [an excellent breakdown][brett] on 'async' and 'await' syntax and how asynchronous programming works. From a94c49d0ded6eeabe74165e96e5be84d32889e4f Mon Sep 17 00:00:00 2001 From: Leandro Date: Thu, 5 Apr 2018 07:18:46 -0300 Subject: [PATCH 032/241] Update camera.yi.markdown (#5098) * Update camera.yi.markdown Added a session specifying for Hassbian users. * Update camera.yi.markdown * :rocket: Trigger build --- source/_components/camera.yi.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/camera.yi.markdown b/source/_components/camera.yi.markdown index 61576a4772..cb8975a86c 100644 --- a/source/_components/camera.yi.markdown +++ b/source/_components/camera.yi.markdown @@ -34,6 +34,10 @@ Once installed, please ensure that you have enabled FTP and Telnet on your devic Currently, version 0.1.4-beta2 of the custom firmware is the highest supported. Firmwares higher than this version use [Pure-FTPd](https://www.pureftpd.org/project/pure-ftpd), which has a bug that prevents FFmpeg from correctly rendering video files.

+

+Hassbian users: don't forget to install ffmpeg support on your platform, otherwise, you'll not see video. +

+

Some alternative Yi firmwares enable an experimental RTSP server, which will allow you to connect to your camera via other Home Assistant camera platforms. However, this RTSP server disables the ability to use the supremely-useful Yi Home app. In order to maintain both Home Assistant compatibility _and_ the native app, this platform retrieves videos via FTP.

From 4a1cae880641b28040c47acad72033446751d91f Mon Sep 17 00:00:00 2001 From: joshua stein Date: Thu, 5 Apr 2018 11:41:46 -0500 Subject: [PATCH 033/241] Pushover: update webpage with clone URL (#5116) * Pushover: update webpage with clone URL Hi, Pushover developer here. I was notified that your app has a Pushover plugins, so I've listed it on our [apps page](https://pushover.net/apps) and enabled cloning for it. Instead of users having to upload an icon and fill in all the fields, users can be directed to https://pushover.net/apps/clone/home_assistant which pre-fills those fields and copies the icon. I'm not sure if the `date` field in this markdown page needs to be bumped when it's updated, or if it's a creation date. * Add some other minor changes --- source/_components/notify.pushover.markdown | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/source/_components/notify.pushover.markdown b/source/_components/notify.pushover.markdown index df11cea4ea..7e7680db7e 100644 --- a/source/_components/notify.pushover.markdown +++ b/source/_components/notify.pushover.markdown @@ -15,7 +15,9 @@ ha_release: pre 0.7 The [Pushover service](https://pushover.net/) is a platform for the notify component. This allows components to send messages to the user using Pushover. -In order to get an API key you need to go to the [Pushover website](https://pushover.net) and register a new application. From the website you can also retrieve your user key. +## {% linkable_title Configuration %} + +In order to get an API key you need to [register an application](https://pushover.net/apps/clone/home_assistant) on the Pushover website. Your Pushover user key can be found on the [Pushover dashboard](https://pushover.net/dashboard). To use Pushover notifications, add the following to your `configuration.yaml` file: @@ -35,6 +37,7 @@ Configuration variables: - **user_key** (*Required*): Your user key for Pushover. Example Automation: + ```yaml - service: notify.entity_id data: @@ -45,22 +48,16 @@ Example Automation: sound: pianobar priority: 0 ``` + Component specific values in the nested `data` section are optional. -This is a quote from the Pushover website regarding free/open source apps: - -
- If you are creating a client-side library, application, or open source project that will be redistributed and installed by end-users, you may want to require each of your users to register their own application rather than including your own API token with the software. -
- -When setting up the application you can use this [icon](/images/favicon-192x192.png). - To use notifications, please see the [getting started with automation page](/getting-started/automation/). When sending a notification, optional parameters can also be set as per the pushover [API documentation](https://pushover.net/api). Example notification triggered from the Alexa component for an intents is shown below which also uses [Automation Templating](/getting-started/automation-templating/) for the message: +{% raw %} ```yaml # Example configuration.yaml entries alexa: @@ -69,7 +66,7 @@ alexa: action: service: notify.notify data_template: - message: "The location of {% raw %}{{ User }}{% endraw %} has been queried via Alexa." + message: "The location of {{ User }} has been queried via Alexa." data: title: "Home Assistant" data: @@ -77,3 +74,4 @@ alexa: device: pixel url: "https://www.home-assistant.io/" ``` +{% endraw %} From a6ade458c70b8c05aa65e3c5dbf8fe14258735cb Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 5 Apr 2018 18:45:20 +0200 Subject: [PATCH 034/241] Add new configuration variable (#5117) --- .../device_tracker.asuswrt.markdown | 49 +++++++++++++++---- 1 file changed, 40 insertions(+), 9 deletions(-) diff --git a/source/_components/device_tracker.asuswrt.markdown b/source/_components/device_tracker.asuswrt.markdown index 4d809108e9..7889253ce9 100644 --- a/source/_components/device_tracker.asuswrt.markdown +++ b/source/_components/device_tracker.asuswrt.markdown @@ -19,6 +19,8 @@ The `asuswrt` platform offers presence detection by looking at connected devices This platform is **NOT** available for [Microsoft Windows installations](http://pexpect.readthedocs.io/en/stable/overview.html#pexpect-on-windows).

+### {% linkable_title Configuration %} + To use an ASUSWRT router in your installation, add the following to your `configuration.yaml` file: ```yaml @@ -29,15 +31,44 @@ device_tracker: username: YOUR_ADMIN_USERNAME ``` -Configuration variables: - -- **host** (*Required*): The IP address of your router, eg. `192.168.1.1`. -- **username** (*Required*: The username of an user with administrative privileges, usually `admin`. -- **password** (*Optional*): The password for your given admin account (use this if no SSH key is given). -- **protocol** (*Optional*): The protocol (`ssh` or `telnet`) to use. Defaults to `ssh`. -- **port** (*Optional*): SSH port to use. Defaults to `22`. -- **mode** (*Optional*): The operating mode of the router (`router` or `ap`). Defaults to `router`. -- **ssh_key** (*Optional*): The path to your SSH private key file associated with your given admin account (instead of password). +{% configuration %} +host: + description: "The IP address of your router, eg. `192.168.1.1`." + required: true + type: string +username: + description: "The username of an user with administrative privileges, usually `admin`." + required: true + type: string +password: + description: "The password for your given admin account (use this if no SSH key is given)." + required: false + type: string +protocol: + description: "The protocol (`ssh` or `telnet`) to use." + required: false + type: string + default: ssh +port: + description: SSH port to use. + required: false + type: int + default: 22 +mode: + description: "The operating mode of the router (`router` or `ap`)." + required: false + type: string + default: router +ssh_key: + description: The path to your SSH private key file associated with your given admin account (instead of password). + required: false + type: string +require_ip: + description: If the router is in access point mode. + required: false + type: boolean + default: true +{% endconfiguration %}

You need to [enable telnet](https://www.asus.com/support/faq/1005449/) on your router if you choose to use `protocol: telnet`. From a620408dbd1789805bcaad218fda5f6d276280d2 Mon Sep 17 00:00:00 2001 From: cpgifford <37760961+cpgifford@users.noreply.github.com> Date: Thu, 5 Apr 2018 11:46:11 -0500 Subject: [PATCH 035/241] add supporting info for 2nd gen august lock (#5115) * add supporting info for 2nd gen august lock 2nd Gen August Lock needs to have the August Connect Module to be able to talk to home-assistant. If you have Doorbell then you don't need to have Connect. Just trying to help people troubleshoot in case they don't know whats going wrong. * Update syntax --- source/_components/august.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/august.markdown b/source/_components/august.markdown index a4df212e8b..818002e14c 100644 --- a/source/_components/august.markdown +++ b/source/_components/august.markdown @@ -15,6 +15,10 @@ ha_iot_class: "Cloud Polling" The `august` component allows you to integrate your [August](http://august.com) devices in Home Assistant. Currently this component supports August Lock and Doorbell. +

+August Lock 2nd Gen will need either August Connect or Doorbell to connect to Home Assistant. +

+ ## {% linkable_title Configuration %} You will need your August login information (username (either phone# or email), and password) to use this module. From b0e5093b02d45859e1b4f895e5811465774c4736 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 5 Apr 2018 20:39:21 +0200 Subject: [PATCH 036/241] Add Tahoma switches docs (#5118) --- source/_components/switch.tahoma.markdown | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 source/_components/switch.tahoma.markdown diff --git a/source/_components/switch.tahoma.markdown b/source/_components/switch.tahoma.markdown new file mode 100644 index 0000000000..a7c3338fee --- /dev/null +++ b/source/_components/switch.tahoma.markdown @@ -0,0 +1,17 @@ +--- +layout: page +title: "Tahoma Switch" +description: "Instructions on how to integrate Tahoma switches into Home Assistant." +date: 2017-07-18 12:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: tahoma.png +ha_category: Sensor +ha_release: 0.59 +--- + +The `tahoma` switch platform lets you see switches added to your Tahoma Box in Home Assistant. + +Switches will be added automatically. Please refer to the [component](/components/tahoma/) configuration on how to setup Tahoma. From 4eecf3fc877710ebe7020c8c88180ecbd19302ea Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Thu, 5 Apr 2018 22:21:51 +0200 Subject: [PATCH 037/241] Ceiling Light 4 (Jiaoyue 650) added to the list of supported devices (#5119) --- source/_components/light.yeelight.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/light.yeelight.markdown b/source/_components/light.yeelight.markdown index e3fc28821f..b217309753 100644 --- a/source/_components/light.yeelight.markdown +++ b/source/_components/light.yeelight.markdown @@ -63,3 +63,4 @@ This component is tested to work with the following models. If you have a differ - **YLDD02YL**: Lightstrip (Color) - **MJCTD01YL**: Xiaomi Mijia Bedside Lamp - WIFI Version! - **MJTD01YL**: Xiaomi Mijia Smart LED Desk Lamp (autodiscovery isn't possible because the device doesn't support mDNS due to the small amount of RAM) +- **YLXD02YL**: Yeelight Ceiling Light 4 (Jiaoyue 650) From 0814d5c531daf1316dc7848c0b70dc567dcedee9 Mon Sep 17 00:00:00 2001 From: jmtatsch Date: Fri, 6 Apr 2018 06:11:42 +0200 Subject: [PATCH 038/241] Harmonised topic name and mention enabled autodiscovery (#5120) * Harmonised topic name and mention enabled autodiscovery * image shall not be the state of entity --- source/_docs/mqtt/discovery.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_docs/mqtt/discovery.markdown b/source/_docs/mqtt/discovery.markdown index 60974c428b..aaa295dc4b 100644 --- a/source/_docs/mqtt/discovery.markdown +++ b/source/_docs/mqtt/discovery.markdown @@ -15,6 +15,7 @@ The discovery of MQTT devices will enable one to use MQTT devices with only mini Supported by MQTT discovery: - [Binary sensors](/components/binary_sensor.mqtt/) +- [Cameras](/components/camera.mqtt/) - [Covers](/components/cover.mqtt/) - [Fans](/components/fan.mqtt/) - [Lights](/components/light.mqtt/) From 572f001f5bd085d5abe31ae798ce4f9cccc05537 Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Fri, 6 Apr 2018 09:16:35 +0200 Subject: [PATCH 039/241] Added description for markdown in persistent notifications (#5124) * Added markdown description for persistent_notification * Minor change --- .../persistent_notification.markdown | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/source/_components/persistent_notification.markdown b/source/_components/persistent_notification.markdown index 6e84078f3d..9fac3ddc0c 100644 --- a/source/_components/persistent_notification.markdown +++ b/source/_components/persistent_notification.markdown @@ -55,6 +55,26 @@ action: notification_id: "1234" ``` + +### {% linkable_title Markdown support %} + +The message attribute supports the [Markdown formatting syntax](https://daringfireball.net/projects/markdown/syntax). Some examples are: + +| Type | Message | +| ---- | ------- | +| Headline 1 | `# Headline` | +| Headline 2 | `## Headline` | +| Newline | `\n` | +| Bold | `**My bold text**` | +| Cursive | `*My cursive text*` | +| Link | `[Link](https://home-assistant.io/)` | +| Image | `![image](/local/my_image.jpg)` | + +

+ `/local/` in this context refers to the `.homeassistant/www/` folder. +

+ + ### {% linkable_title Create a persistent notification %} Choose service developer tool icon **Services** from the **Developer Tools** to call the `persistent_notification` service. Select `persistent_notification/create` from the list of **Available services:** and enter something like the sample below into the **Service Data** field and hit **CALL SERVICE**. From 6ff1b3be2dcbbd92459ffe82ce80bc54eb80cf7e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ville=20Skytt=C3=A4?= Date: Fri, 6 Apr 2018 11:38:46 +0300 Subject: [PATCH 040/241] getting-started: Soften note about Pi 3 being 2.4GHz WiFi only (#5125) * getting-started: Soften note about Pi 3 being 2.4GHz WiFi only The (currently unsupported) B+ has 5GHz support. * Add space --- source/getting-started/index.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index 6781f28ab5..41382d7f35 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -18,14 +18,14 @@ Follow this guide if you want to easily get started with Home Assistant, or if y We will need a few things to get started with installing Home Assistant. Links below are linking to Amazon US. If you're not in the US, you should be able to find these items in web stores in your country. - [Raspberry Pi 3 model B](http://a.co/gEfMqL4) + [Power Supply](https://www.raspberrypi.org/help/faqs/#powerReqs) (at least 2.5A) -- [Micro SD Card](http://a.co/gslOydD). Get one that is Class 10 as they are more reliable. Size 32GB or bigger recommended. +- [Micro SD Card](http://a.co/gslOydD). Get one that is Class 10 as they are more reliable. Size 32 GB or bigger recommended. - SD Card reader. Part of most laptops, and also available as [standalone USB sticks](http://a.co/5FCyb0N) (the brand doesn't matter, just pick the cheapest) - Ethernet cable (optional, Hass.io can work with WiFi too)

Support for the Raspberry Pi 3 model B+ is available in the alternative installation method [Hassbian](/docs/hassbian/installation/). - The recently released Raspberry Pi 3 model B+ is not yet supported by Hass.io + The recently released Raspberry Pi 3 model B+ is not yet supported by Hass.io.

### {% linkable_title Software requirements %} @@ -41,7 +41,7 @@ We will need a few things to get started with installing Home Assistant. Links b 1. Put the SD card in your SD card reader. 1. Open Etcher, select the Hass.io image and flash it to the SD card. -1. WiFi setup only: open the file `system-connections/resin-sample` (from the `resin-boot` volume on the SD card) with a text editor. Change `ssid` to be your network name and `psk` to be your password. Note that the Raspberry Pi 3 is a 2.4GHz WiFi device, so do not try to connect it to a 5GHz network. +1. WiFi setup only: open the file `system-connections/resin-sample` (from the `resin-boot` volume on the SD card) with a text editor. Change `ssid` to be your network name and `psk` to be your password. Note: When connecting to a 5 GHz-only network, make sure your device supports that. If you don't know what that means, then you probably have nothing to worry about. 1. Unmount the SD card and remove it from your SD card reader. 1. Insert the SD card into your Raspberry Pi 3. If you are going to use an Ethernet cable, connect that too. 1. Connect your Raspberry Pi to the power supply so it turns on. From 6347774428d606d8b35b35902b1319535bd7e9dc Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Fri, 6 Apr 2018 11:02:04 +0200 Subject: [PATCH 041/241] Added additional log settings (#5123) --- source/_components/homekit.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 079849af30..5313a8428a 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -212,6 +212,7 @@ logger: default: warning logs: homeassistant.components.homekit: debug + pyhap: debug ``` 2. Reproduce the bug / problem you have encountered. 3. Stop Home Assistant and copy the log from the log file. That is necessary since some errors only get logged, when Home Assistant is being shutdown. From ccba1ffd3367159a17e92fecc92526c04e468ba5 Mon Sep 17 00:00:00 2001 From: Marco Orovecchia Date: Fri, 6 Apr 2018 15:35:27 +0200 Subject: [PATCH 042/241] Added Nanoleaf Aurora Light documentation (#5018) * Added Nanoleaf Aurora Light documentation * :pencil2: Tweaks --- .../light.nanoleaf_aurora.markdown | 52 ++++++++++++++++++ .../nanoleaf_aurora_light.png | Bin 0 -> 70366 bytes 2 files changed, 52 insertions(+) create mode 100644 source/_components/light.nanoleaf_aurora.markdown create mode 100644 source/images/supported_brands/nanoleaf_aurora_light.png diff --git a/source/_components/light.nanoleaf_aurora.markdown b/source/_components/light.nanoleaf_aurora.markdown new file mode 100644 index 0000000000..074bd1c77f --- /dev/null +++ b/source/_components/light.nanoleaf_aurora.markdown @@ -0,0 +1,52 @@ +--- +layout: page +title: "Nanoleaf Aurora Light Panel" +description: "Instructions how to integrate Nanoleaf Aurora Light Panels into Home Assistant." +date: 2018-01-04 20:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: nanoleaf_aurora_light.png +ha_category: Light +ha_iot_class: "Local Polling" +featured: false +ha_release: 0.67 +--- + +### {% linkable_title Configuration Sample %} + +To enable the Aurora lights, add the following lines to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +light: + - platform: aurora + host: 192.168.1.10 + token: xxxxxxxxxxxxxxxxxxxxx +``` + +{% configuration %} +host: + description: IP address or host-name of the device, e.g., 192.168.1.10. + required: true + type: string +token: + description: The *auth* token that you get via *POST* to */api/v1/new* + required: true + type: string +name: + description: Name of the component, make this unique if you have multiple Light Panels + required: false + type: string + default: Aurora +{% endconfiguration %} + +### {% linkable_title Getting The Auth Token %} + +1. Make sure that your Nanoleaf Aurora Panel is fully patched (as of the time of writing the latest version was 2.2.0) +2. Hold down the *ON* button on the Panel for 5 seconds; the LED will start flashing +3. Issue a *POST* request to the API endpoint, e.g., via `$ curl -i -X POST http://192.168.1.155:16021/api/v1/new` +4. The output should include the auth token like *{"auth_token":"xxxxxxxxxxxxxxxxxxxxx"}*, copy the resulting token into your configuration + +If you get a 403 Forbidden message, you probably did not press the *ON* button long enough. The time-frame to get a valid token is only 30 seconds, so you have to be quick to issue the curl request. diff --git a/source/images/supported_brands/nanoleaf_aurora_light.png b/source/images/supported_brands/nanoleaf_aurora_light.png new file mode 100644 index 0000000000000000000000000000000000000000..fb14d4752f1fe396210b8289f0d113d2f9b28584 GIT binary patch literal 70366 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 literal 0 HcmV?d00001 From 8aaf1547d265cf566d4088ae8c518795c47181b1 Mon Sep 17 00:00:00 2001 From: David Broadfoot Date: Fri, 6 Apr 2018 23:53:31 +1000 Subject: [PATCH 043/241] Added documentation for gogogate2 (#5023) * Add gogogate2 image * Added gogogate2 documentation * PR Feedback * Remove blank line * Add period --- source/_components/cover.gogogate2.markdown | 49 +++++++++++++++++++ source/images/supported_brands/gogogate2.png | Bin 0 -> 11962 bytes 2 files changed, 49 insertions(+) create mode 100644 source/_components/cover.gogogate2.markdown create mode 100644 source/images/supported_brands/gogogate2.png diff --git a/source/_components/cover.gogogate2.markdown b/source/_components/cover.gogogate2.markdown new file mode 100644 index 0000000000..bf6d62d37b --- /dev/null +++ b/source/_components/cover.gogogate2.markdown @@ -0,0 +1,49 @@ +--- +layout: page +title: "Gogogate2 Cover" +description: "Instructions on how to integrate Gogogate2-Enabled garage door covers into Home Assistant." +date: 2018-03-26 20:02 +sidebar: true +comments: false +sharing: true +footer: true +logo: gogogate2.png +ha_category: Cover +ha_release: 0.67 +ha_iot_class: Local Polling +--- + +The `gogogate2` cover platform lets you control Gogogate2-Enabled garage doors through Home Assistant. Device names in Home Assistant are generated based on the names defined in your Gogogate2 mobile app. + +## {% linkable_title Configuration %} + +To use your Gogogate2 cover in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yml entry +cover: + - platform: gogogate2 + username: email@email.com + password: password + ip_address: 192.168.1.200 +``` + +{% configuration %} +username: + description: Your Gogogate2 account username. + required: true + type: string +password: + description: Your Gogogate2 account password. + required: true + type: string +ip_address: + description: The IP Address of your Gogogate2 device. + required: true + type: string +name: + description: Allows you to override the default name. + default: gogogate2 + required: false + type: string +{% endconfiguration %} diff --git a/source/images/supported_brands/gogogate2.png b/source/images/supported_brands/gogogate2.png new file mode 100644 index 0000000000000000000000000000000000000000..551043f64a53cec259a53fb71382fff754c4f348 GIT binary patch literal 11962 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 M07*qoM6N<$f^0pk4FCWD literal 0 HcmV?d00001 From 18881f59c3e7d609e6bf96299687d5f07486c223 Mon Sep 17 00:00:00 2001 From: phithor Date: Fri, 6 Apr 2018 15:54:14 +0200 Subject: [PATCH 044/241] Added max range switch note (#5126) --- source/_components/switch.tesla.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.tesla.markdown b/source/_components/switch.tesla.markdown index a8c63ede4e..2ded4d7d10 100644 --- a/source/_components/switch.tesla.markdown +++ b/source/_components/switch.tesla.markdown @@ -13,7 +13,7 @@ ha_iot_class: "Cloud Push" ha_release: 0.54 --- -The `Tesla` platform allows you to control your [Tesla](https://www.tesla.com/) charger (enable/disable charging) from within Home Assistant. +The `Tesla` platform allows you to control your [Tesla](https://www.tesla.com/) charger (enable/disable charging, max range switch) from within Home Assistant. The switch platform will be automatically configured if Tesla component is configured. From 8255351d694103382705e899f52d2d3ede703f87 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 6 Apr 2018 10:29:01 -0400 Subject: [PATCH 045/241] Bump version to 0.67.0b0 --- _config.yml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/_config.yml b/_config.yml index a7b16a6bf6..401cd89fce 100644 --- a/_config.yml +++ b/_config.yml @@ -139,14 +139,14 @@ social: # Home Assistant release details current_major_version: 0 -current_minor_version: 66 -current_patch_version: 1 -date_released: 2018-04-01 +current_minor_version: 67 +current_patch_version: 0 +date_released: 2018-04-14 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. # Major release: -patch_version_notes: "#release-0661---april-1" +patch_version_notes: "#" # Minor release (Example #release-0431---april-25): # Date we moved to Discourse for comments From 4974ac5990994e0584f1e912c6f3ce4b51fe525b Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 6 Apr 2018 10:33:47 -0400 Subject: [PATCH 046/241] Add blog post for release 67 --- source/_posts/2018-04-14-release-67.markdown | 378 +++++++++++++++++++ 1 file changed, 378 insertions(+) create mode 100644 source/_posts/2018-04-14-release-67.markdown diff --git a/source/_posts/2018-04-14-release-67.markdown b/source/_posts/2018-04-14-release-67.markdown new file mode 100644 index 0000000000..ee6134e9da --- /dev/null +++ b/source/_posts/2018-04-14-release-67.markdown @@ -0,0 +1,378 @@ +--- +layout: post +title: "0.67: TBD - ALSO UPDATE DATE" +description: "TBD" +date: 2018-04-06 00:01:00 +date_formatted: "April 14, 2018" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Release-Notes +og_image: /images/blog/2018-04-0.67/components.png +--- + + + +## {% linkable_title New Platforms %} + +- Qwikswitch async refactor & sensor ([@kellerza] - [#13509]) ([qwikswitch docs]) ([light.qwikswitch docs]) ([sensor.qwikswitch docs]) ([switch.qwikswitch docs]) (new-platform) +- Adds folder_watcher component ([@robmarkcole] - [#12918]) ([watchdog_file_watcher docs]) (new-platform) +- Add FreeDNS component ([@bdurrer] - [#13526]) ([freedns docs]) (new-platform) +- Google Maps location sharing device tracker ([@michaelarnauts] - [#12301]) ([device_tracker.google_maps docs]) (new-platform) +- Added Waze travel time sensor ([@Myrddyn1] - [#12387]) ([sensor.waze_travel_time docs]) (new-platform) +- Added switch component to Amcrest IP Camera. ([@adpriebe] - [#12992]) ([amcrest docs]) ([switch.amcrest docs]) (new-platform) +- Add mastodon ([@fabaff] - [#13441]) ([notify docs]) (new-platform) +- Tahoma switches ([@ikucuze] - [#13636]) ([tahoma docs]) ([switch.tahoma docs]) (new-platform) +- Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.aurora docs]) (new-platform) + +## {% linkable_title If you need help... %} + +...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. + +## {% linkable_title Reporting Issues %} + +Experiencing issues introduced by this release? Please report them in our [issue tracker](https://github.com/home-assistant/home-assistant/issues). Make sure to fill in all fields of the issue template. + + +## {% linkable_title Breaking Changes %} + +- Updates default Pilight port number ([@frenck] - [#13419]) ([pilight docs]) (breaking change) +- Update to new "b2vapi" of BMW ConnectedDrive ([@ChristianKuehnel] - [#13305]) ([bmw_connected_drive docs]) ([binary_sensor.bmw_connected_drive docs]) ([lock.bmw_connected_drive docs]) ([sensor.bmw_connected_drive docs]) (breaking change) +- Remove MercedesME component ([@ReneNulschDE] - [#13538]) ([device_tracker docs]) ([mercedesme docs]) ([binary_sensor.mercedesme docs]) ([sensor.mercedesme docs]) (breaking change) +- Channel up and down for webostv ([@stephanerosi] - [#13624]) ([media_player.webostv docs]) (breaking change) +- Add media type separation for video/movie ([@Tadly] - [#13612]) (breaking change) +- Added ENTITY_ID_FORMAT import and set entity_id in __init__ ([@timmo001] - [#13642]) ([switch.broadlink docs]) (breaking change) + +## {% linkable_title All changes %} + +- Updates default Pilight port number ([@frenck] - [#13419]) ([pilight docs]) (breaking change) +- Upgrade mypy to 0.580 ([@fabaff] - [#13420]) +- Update to new "b2vapi" of BMW ConnectedDrive ([@ChristianKuehnel] - [#13305]) ([bmw_connected_drive docs]) ([binary_sensor.bmw_connected_drive docs]) ([lock.bmw_connected_drive docs]) ([sensor.bmw_connected_drive docs]) (breaking change) +- Add code owner for Manual Alarm with MQTT Control ([@colinodell] - [#13438]) +- QNAP updates ([@colinodell] - [#13435]) ([sensor.qnap docs]) +- Xiaomi MiIO Fan: Xiaomi Air Humidifier integration ([@syssi] - [#12627]) ([fan.xiaomi_miio docs]) +- Bump songpal version, fixes lots of issues mentioned in #13022 ([@rytilahti] - [#13440]) ([media_player.songpal docs]) +- Removed the google home warning from emulated_hue ([@mf-social] - [#13436]) +- Fixing odometer to display km ([@alandtse] - [#13427]) ([sensor.tesla docs]) +- Upgrade keyring to 12.0.0 and keyrings.alt to 3.0 ([@fabaff] - [#13452]) +- Upgrade aiohttp to 3.1.0 ([@fabaff] - [#13451]) +- Qwikswitch async & updates ([@kellerza] - [#12641]) ([qwikswitch docs]) ([light.qwikswitch docs]) ([switch.qwikswitch docs]) +- Make Telnet Switch value template optional ([@DanNixon] - [#13433]) ([switch.telnet docs]) +- Update yeelightsunflower to 0.0.10 ([@lindsaymarkwawrd] - [#13448]) +- Add more info to issue template ([@c727] - [#12955]) +- [RFC] Update issue template ([@amelchio] - [#12989]) +- Update total_connect_client to 0.17 for Honeywell L5100-WiFi Support ([@phileaton] - [#13473]) ([alarm_control_panel.totalconnect docs]) +- Upgrade python-mystrom to 0.4.2 ([@fabaff] - [#13485]) ([light.mystrom docs]) ([switch.mystrom docs]) +- New service added to control the power mode of the yeelight ([@syssi] - [#13267]) ([light.yeelight docs]) +- Upgrade slacker to 0.9.65 ([@fabaff] - [#13496]) ([notify docs]) +- Adds template function state_attr to get attribute from a state ([@Nossnevs] - [#13378]) +- Upgrade aiohttp to 3.1.1 ([@fabaff] - [#13510]) +- Update tradfri v5 ([@lwis] - [#11187]) ([tradfri docs]) ([light.tradfri docs]) ([sensor.tradfri docs]) +- Fix typos and update link (fixes #13520) ([@fabaff] - [#13529]) +- Tradfri - unique_id's and color_temp support for rgb-bulbs ([@NovapaX] - [#13531]) ([light.tradfri docs]) +- Qwikswitch async refactor & sensor ([@kellerza] - [#13509]) ([qwikswitch docs]) ([light.qwikswitch docs]) ([sensor.qwikswitch docs]) ([switch.qwikswitch docs]) (new-platform) +- Adds folder_watcher component ([@robmarkcole] - [#12918]) ([watchdog_file_watcher docs]) (new-platform) +- Update rflink to 0.0.37 ([@olskar] - [#12603]) ([rflink docs]) +- Added file path validity checks to file sensor ([@FrederikBolding] - [#12505]) ([sensor.file docs]) +- Allow for overriding the DoorBird push notification URL in configuration ([@Klikini] - [#13268]) ([doorbird docs]) +- Convert Hue to always use config entries ([@balloob] - [#13034]) ([hue docs]) +- Implement thermostat support for Alexa ([@trisk] - [#13340]) ([alexa docs]) +- deCONZ config entry ([@Kane610] - [#13402]) ([deconz docs]) +- Remove andrey-git from requirements monitoring ([@andrey-git] - [#13547]) +- Fix BMW device tracker toggling state if vehicle tracking is disabled ([@ChristianKuehnel] - [#12999]) ([device_tracker.bmw_connected_drive docs]) +- Xiaomi MiIO Switch: Support for the Xiaomi Chuangmi Plug V3 ([@syssi] - [#13271]) ([switch.xiaomi_miio docs]) +- Add FreeDNS component ([@bdurrer] - [#13526]) ([freedns docs]) (new-platform) +- Update pylint to 1.8.3 ([@scop] - [#13544]) +- Google Maps location sharing device tracker ([@michaelarnauts] - [#12301]) ([device_tracker.google_maps docs]) (new-platform) +- Check_config: Handle numbers correctly when printing config ([@hAmpzter] - [#13377]) +- Add support for Canary Flex ([@snjoetw] - [#13280]) ([canary docs]) ([sensor.canary docs]) +- Fixes #12758. Try other cameras even if one fails to initialize ([@PhracturedBlue] - [#13276]) ([amcrest docs]) +- Added HassOpenCover and HassCloseCover intents ([@tschmidty69] - [#13372]) ([conversation docs]) ([cover docs]) +- rfxtrx lib 0.22.0 ([@danielhiversen] - [#13576]) ([rfxtrx docs]) +- xiaomi lib upgrade ([@danielhiversen] - [#13577]) ([xiaomi_aqara docs]) +- Remove MercedesME component ([@ReneNulschDE] - [#13538]) ([device_tracker docs]) ([mercedesme docs]) ([binary_sensor.mercedesme docs]) ([sensor.mercedesme docs]) (breaking change) +- Added Waze travel time sensor ([@Myrddyn1] - [#12387]) ([sensor.waze_travel_time docs]) (new-platform) +- Added switch component to Amcrest IP Camera. ([@adpriebe] - [#12992]) ([amcrest docs]) ([switch.amcrest docs]) (new-platform) +- Upgrade pyhydroquebec 2.2.1 ([@titilambert] - [#13586]) ([sensor.hydroquebec docs]) +- Add mastodon ([@fabaff] - [#13441]) ([notify docs]) (new-platform) +- Added support for requesting RSSI values from Bluetooth devices ([@FrederikBolding] - [#12458]) ([device_tracker.bluetooth_tracker docs]) +- Fix mysensors update callback ([@MartinHjelmare] - [#13602]) ([mysensors docs]) +- Broadlink ([@danielhiversen] - [#13585]) ([sensor.broadlink docs]) ([switch.broadlink docs]) +- Fix IMAP email message_data ([@zhaokoh] - [#13606]) ([sensor.imap_email_content docs]) +- Re-add group polling as a fallback for observation ([@lwis] - [#13613]) ([light.tradfri docs]) +- Unflake folder watcher test ([@balloob] - [#13569]) +- Make mysensors updates and platform setup async ([@MartinHjelmare] - [#13603]) +- Use 0/1 for raspberry pi cover GPIO writes rather than true/false ([@fezfox] - [#13610]) ([cover.rpi_gpio docs]) +- Fix Hue error logging ([@balloob] - [#13616]) ([hue docs]) +- Bugfix for tradfri to correctly execute Command. ([@lwis] - [#13618]) ([light.tradfri docs]) +- Hue mireds value is actually 153 not 154 ([@Skaronator] - [#13601]) ([light docs]) +- changed PyTado version ([@wmalgadey] - [#13626]) ([tado docs]) +- Upgrade py-cpuinfo to 4.0.0 ([@fabaff] - [#13629]) ([sensor.cpuspeed docs]) +- Add Switzerland ([@fabaff] - [#13630]) ([binary_sensor.workday docs]) +- Xiaomi Mi WiFi Repeater 2 integration as device tracker ([@syssi] - [#13521]) +- Upgrade youtube_dl to 2018.04.03 ([@fabaff] - [#13647]) ([media_extractor docs]) +- Update plex.py ([@chronm] - [#13659]) ([sensor.plex docs]) +- Always enable config entries & remove config_entry_example ([@balloob] - [#13663]) ([config docs]) ([config_entry_example docs]) +- Add missing service docs for hs_color ([@armills] - [#13667]) +- Add regex functions as templating helpers ([@mountainsandcode] - [#13631]) +- Channel up and down for webostv ([@stephanerosi] - [#13624]) ([media_player.webostv docs]) (breaking change) +- Added headers configuration variable to notify.rest component ([@5LICK] - [#13674]) ([notify docs]) +- Spelling fixes ([@scop] - [#13681]) ([device_tracker docs]) ([smappee docs]) ([alarm_control_panel.ifttt docs]) ([climate.nest docs]) ([remote.xiaomi_miio docs]) +- Xiaomi MiIO Light: White Philips Candle Light support ([@syssi] - [#13682]) ([light.xiaomi_miio docs]) +- Bugfixes HomeKit covers, lights ([@cdce8p] - [#13689]) ([homekit docs]) +- Minor style changes, cleanup ([@cdce8p] - [#13654]) ([homekit docs]) +- Bugfix: Zwave Print_node to logfile instead of console ([@turbokongen] - [#13302]) ([zwave docs]) +- Update HAP-python to 1.1.8 ([@cdce8p] - [#13563]) ([homekit docs]) +- Update ha-philips_js to 0.0.3 ([@danielperna84] - [#13702]) ([media_player.philips_js docs]) +- Coverage & Codeowners ([@kellerza] - [#13700]) +- Bump insteonplm to 0.8.6 to fix sensor message handling ([@teharris1] - [#13691]) ([insteon_plm docs]) +- Fix asuswrt ap mode failure ([@shuaiger] - [#13693]) ([device_tracker docs]) +- Support color temperature in Homekit ([@morberg] - [#13658]) ([homekit docs]) +- Remove unused CONF_WATCHERS ([@robmarkcole] - [#13678]) ([folder_watcher docs]) +- Add media type separation for video/movie ([@Tadly] - [#13612]) (breaking change) +- Adding configration to disable ip address as a requirement Fixes: #13399 ([@PlanetJ] - [#13692]) ([device_tracker docs]) +- Tahoma switches ([@ikucuze] - [#13636]) ([tahoma docs]) ([switch.tahoma docs]) (new-platform) +- Send XY color for non-osram hue bulbs ([@armills] - [#13665]) ([light.hue docs]) +- Update AbodePy version to 0.12.3 ([@MisterWil] - [#13709]) ([abode docs]) +- Enable autodiscovery for mqtt cameras ([@jmtatsch] - [#13697]) ([mqtt docs]) ([camera.mqtt docs]) +- Added ENTITY_ID_FORMAT import and set entity_id in __init__ ([@timmo001] - [#13642]) ([switch.broadlink docs]) (breaking change) +- Fix #10175 ([@pschmitt] - [#13713]) ([media_player.liveboxplaytv docs]) +- Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.aurora docs]) (new-platform) +- Added gogogate2 cover ([@dlbroadfoot] - [#13467]) + +[#11187]: https://github.com/home-assistant/home-assistant/pull/11187 +[#12301]: https://github.com/home-assistant/home-assistant/pull/12301 +[#12387]: https://github.com/home-assistant/home-assistant/pull/12387 +[#12458]: https://github.com/home-assistant/home-assistant/pull/12458 +[#12505]: https://github.com/home-assistant/home-assistant/pull/12505 +[#12603]: https://github.com/home-assistant/home-assistant/pull/12603 +[#12627]: https://github.com/home-assistant/home-assistant/pull/12627 +[#12641]: https://github.com/home-assistant/home-assistant/pull/12641 +[#12918]: https://github.com/home-assistant/home-assistant/pull/12918 +[#12955]: https://github.com/home-assistant/home-assistant/pull/12955 +[#12989]: https://github.com/home-assistant/home-assistant/pull/12989 +[#12992]: https://github.com/home-assistant/home-assistant/pull/12992 +[#12999]: https://github.com/home-assistant/home-assistant/pull/12999 +[#13034]: https://github.com/home-assistant/home-assistant/pull/13034 +[#13267]: https://github.com/home-assistant/home-assistant/pull/13267 +[#13268]: https://github.com/home-assistant/home-assistant/pull/13268 +[#13271]: https://github.com/home-assistant/home-assistant/pull/13271 +[#13276]: https://github.com/home-assistant/home-assistant/pull/13276 +[#13280]: https://github.com/home-assistant/home-assistant/pull/13280 +[#13302]: https://github.com/home-assistant/home-assistant/pull/13302 +[#13305]: https://github.com/home-assistant/home-assistant/pull/13305 +[#13340]: https://github.com/home-assistant/home-assistant/pull/13340 +[#13372]: https://github.com/home-assistant/home-assistant/pull/13372 +[#13377]: https://github.com/home-assistant/home-assistant/pull/13377 +[#13378]: https://github.com/home-assistant/home-assistant/pull/13378 +[#13402]: https://github.com/home-assistant/home-assistant/pull/13402 +[#13419]: https://github.com/home-assistant/home-assistant/pull/13419 +[#13420]: https://github.com/home-assistant/home-assistant/pull/13420 +[#13427]: https://github.com/home-assistant/home-assistant/pull/13427 +[#13433]: https://github.com/home-assistant/home-assistant/pull/13433 +[#13435]: https://github.com/home-assistant/home-assistant/pull/13435 +[#13436]: https://github.com/home-assistant/home-assistant/pull/13436 +[#13438]: https://github.com/home-assistant/home-assistant/pull/13438 +[#13440]: https://github.com/home-assistant/home-assistant/pull/13440 +[#13441]: https://github.com/home-assistant/home-assistant/pull/13441 +[#13448]: https://github.com/home-assistant/home-assistant/pull/13448 +[#13451]: https://github.com/home-assistant/home-assistant/pull/13451 +[#13452]: https://github.com/home-assistant/home-assistant/pull/13452 +[#13456]: https://github.com/home-assistant/home-assistant/pull/13456 +[#13467]: https://github.com/home-assistant/home-assistant/pull/13467 +[#13473]: https://github.com/home-assistant/home-assistant/pull/13473 +[#13485]: https://github.com/home-assistant/home-assistant/pull/13485 +[#13496]: https://github.com/home-assistant/home-assistant/pull/13496 +[#13509]: https://github.com/home-assistant/home-assistant/pull/13509 +[#13510]: https://github.com/home-assistant/home-assistant/pull/13510 +[#13521]: https://github.com/home-assistant/home-assistant/pull/13521 +[#13526]: https://github.com/home-assistant/home-assistant/pull/13526 +[#13529]: https://github.com/home-assistant/home-assistant/pull/13529 +[#13531]: https://github.com/home-assistant/home-assistant/pull/13531 +[#13538]: https://github.com/home-assistant/home-assistant/pull/13538 +[#13544]: https://github.com/home-assistant/home-assistant/pull/13544 +[#13547]: https://github.com/home-assistant/home-assistant/pull/13547 +[#13563]: https://github.com/home-assistant/home-assistant/pull/13563 +[#13569]: https://github.com/home-assistant/home-assistant/pull/13569 +[#13576]: https://github.com/home-assistant/home-assistant/pull/13576 +[#13577]: https://github.com/home-assistant/home-assistant/pull/13577 +[#13585]: https://github.com/home-assistant/home-assistant/pull/13585 +[#13586]: https://github.com/home-assistant/home-assistant/pull/13586 +[#13601]: https://github.com/home-assistant/home-assistant/pull/13601 +[#13602]: https://github.com/home-assistant/home-assistant/pull/13602 +[#13603]: https://github.com/home-assistant/home-assistant/pull/13603 +[#13606]: https://github.com/home-assistant/home-assistant/pull/13606 +[#13610]: https://github.com/home-assistant/home-assistant/pull/13610 +[#13612]: https://github.com/home-assistant/home-assistant/pull/13612 +[#13613]: https://github.com/home-assistant/home-assistant/pull/13613 +[#13616]: https://github.com/home-assistant/home-assistant/pull/13616 +[#13618]: https://github.com/home-assistant/home-assistant/pull/13618 +[#13624]: https://github.com/home-assistant/home-assistant/pull/13624 +[#13626]: https://github.com/home-assistant/home-assistant/pull/13626 +[#13629]: https://github.com/home-assistant/home-assistant/pull/13629 +[#13630]: https://github.com/home-assistant/home-assistant/pull/13630 +[#13631]: https://github.com/home-assistant/home-assistant/pull/13631 +[#13636]: https://github.com/home-assistant/home-assistant/pull/13636 +[#13642]: https://github.com/home-assistant/home-assistant/pull/13642 +[#13647]: https://github.com/home-assistant/home-assistant/pull/13647 +[#13654]: https://github.com/home-assistant/home-assistant/pull/13654 +[#13658]: https://github.com/home-assistant/home-assistant/pull/13658 +[#13659]: https://github.com/home-assistant/home-assistant/pull/13659 +[#13663]: https://github.com/home-assistant/home-assistant/pull/13663 +[#13665]: https://github.com/home-assistant/home-assistant/pull/13665 +[#13667]: https://github.com/home-assistant/home-assistant/pull/13667 +[#13674]: https://github.com/home-assistant/home-assistant/pull/13674 +[#13678]: https://github.com/home-assistant/home-assistant/pull/13678 +[#13681]: https://github.com/home-assistant/home-assistant/pull/13681 +[#13682]: https://github.com/home-assistant/home-assistant/pull/13682 +[#13689]: https://github.com/home-assistant/home-assistant/pull/13689 +[#13691]: https://github.com/home-assistant/home-assistant/pull/13691 +[#13692]: https://github.com/home-assistant/home-assistant/pull/13692 +[#13693]: https://github.com/home-assistant/home-assistant/pull/13693 +[#13697]: https://github.com/home-assistant/home-assistant/pull/13697 +[#13700]: https://github.com/home-assistant/home-assistant/pull/13700 +[#13702]: https://github.com/home-assistant/home-assistant/pull/13702 +[#13709]: https://github.com/home-assistant/home-assistant/pull/13709 +[#13713]: https://github.com/home-assistant/home-assistant/pull/13713 +[@5LICK]: https://github.com/5LICK +[@ChristianKuehnel]: https://github.com/ChristianKuehnel +[@DanNixon]: https://github.com/DanNixon +[@FrederikBolding]: https://github.com/FrederikBolding +[@Kane610]: https://github.com/Kane610 +[@Klikini]: https://github.com/Klikini +[@MartinHjelmare]: https://github.com/MartinHjelmare +[@MisterWil]: https://github.com/MisterWil +[@Myrddyn1]: https://github.com/Myrddyn1 +[@Nossnevs]: https://github.com/Nossnevs +[@NovapaX]: https://github.com/NovapaX +[@Oro]: https://github.com/Oro +[@PhracturedBlue]: https://github.com/PhracturedBlue +[@PlanetJ]: https://github.com/PlanetJ +[@ReneNulschDE]: https://github.com/ReneNulschDE +[@Skaronator]: https://github.com/Skaronator +[@Tadly]: https://github.com/Tadly +[@adpriebe]: https://github.com/adpriebe +[@alandtse]: https://github.com/alandtse +[@amelchio]: https://github.com/amelchio +[@andrey-git]: https://github.com/andrey-git +[@armills]: https://github.com/armills +[@balloob]: https://github.com/balloob +[@bdurrer]: https://github.com/bdurrer +[@c727]: https://github.com/c727 +[@cdce8p]: https://github.com/cdce8p +[@chronm]: https://github.com/chronm +[@colinodell]: https://github.com/colinodell +[@danielhiversen]: https://github.com/danielhiversen +[@danielperna84]: https://github.com/danielperna84 +[@dlbroadfoot]: https://github.com/dlbroadfoot +[@fabaff]: https://github.com/fabaff +[@fezfox]: https://github.com/fezfox +[@frenck]: https://github.com/frenck +[@hAmpzter]: https://github.com/hAmpzter +[@ikucuze]: https://github.com/ikucuze +[@jmtatsch]: https://github.com/jmtatsch +[@kellerza]: https://github.com/kellerza +[@lindsaymarkwawrd]: https://github.com/lindsaymarkwawrd +[@lwis]: https://github.com/lwis +[@mf-social]: https://github.com/mf-social +[@michaelarnauts]: https://github.com/michaelarnauts +[@morberg]: https://github.com/morberg +[@mountainsandcode]: https://github.com/mountainsandcode +[@olskar]: https://github.com/olskar +[@phileaton]: https://github.com/phileaton +[@pschmitt]: https://github.com/pschmitt +[@robmarkcole]: https://github.com/robmarkcole +[@rytilahti]: https://github.com/rytilahti +[@scop]: https://github.com/scop +[@shuaiger]: https://github.com/shuaiger +[@snjoetw]: https://github.com/snjoetw +[@stephanerosi]: https://github.com/stephanerosi +[@syssi]: https://github.com/syssi +[@teharris1]: https://github.com/teharris1 +[@timmo001]: https://github.com/timmo001 +[@titilambert]: https://github.com/titilambert +[@trisk]: https://github.com/trisk +[@tschmidty69]: https://github.com/tschmidty69 +[@turbokongen]: https://github.com/turbokongen +[@wmalgadey]: https://github.com/wmalgadey +[@zhaokoh]: https://github.com/zhaokoh +[abode docs]: https://www.home-assistant.io/components/abode/ +[alarm_control_panel.ifttt docs]: https://www.home-assistant.io/components/alarm_control_panel.ifttt/ +[alarm_control_panel.totalconnect docs]: https://www.home-assistant.io/components/alarm_control_panel.totalconnect/ +[alexa docs]: https://www.home-assistant.io/components/alexa/ +[amcrest docs]: https://www.home-assistant.io/components/amcrest/ +[binary_sensor.bmw_connected_drive docs]: https://www.home-assistant.io/components/binary_sensor.bmw_connected_drive/ +[binary_sensor.mercedesme docs]: https://www.home-assistant.io/components/binary_sensor.mercedesme/ +[binary_sensor.workday docs]: https://www.home-assistant.io/components/binary_sensor.workday/ +[bmw_connected_drive docs]: https://www.home-assistant.io/components/bmw_connected_drive/ +[camera.mqtt docs]: https://www.home-assistant.io/components/camera.mqtt/ +[canary docs]: https://www.home-assistant.io/components/canary/ +[climate.nest docs]: https://www.home-assistant.io/components/climate.nest/ +[config docs]: https://www.home-assistant.io/components/config/ +[config_entry_example docs]: https://www.home-assistant.io/components/config_entry_example/ +[conversation docs]: https://www.home-assistant.io/components/conversation/ +[cover docs]: https://www.home-assistant.io/components/cover/ +[cover.rpi_gpio docs]: https://www.home-assistant.io/components/cover.rpi_gpio/ +[deconz docs]: https://www.home-assistant.io/components/deconz/ +[device_tracker docs]: https://www.home-assistant.io/components/device_tracker/ +[device_tracker.bluetooth_tracker docs]: https://www.home-assistant.io/components/device_tracker.bluetooth_tracker/ +[device_tracker.bmw_connected_drive docs]: https://www.home-assistant.io/components/device_tracker.bmw_connected_drive/ +[device_tracker.google_maps docs]: https://www.home-assistant.io/components/device_tracker.google_maps/ +[doorbird docs]: https://www.home-assistant.io/components/doorbird/ +[fan.xiaomi_miio docs]: https://www.home-assistant.io/components/fan.xiaomi_miio/ +[folder_watcher docs]: https://www.home-assistant.io/components/folder_watcher/ +[freedns docs]: https://www.home-assistant.io/components/freedns/ +[homekit docs]: https://www.home-assistant.io/components/homekit/ +[hue docs]: https://www.home-assistant.io/components/hue/ +[insteon_plm docs]: https://www.home-assistant.io/components/insteon_plm/ +[light docs]: https://www.home-assistant.io/components/light/ +[light.aurora docs]: https://www.home-assistant.io/components/light.aurora/ +[light.hue docs]: https://www.home-assistant.io/components/light.hue/ +[light.mystrom docs]: https://www.home-assistant.io/components/light.mystrom/ +[light.qwikswitch docs]: https://www.home-assistant.io/components/light.qwikswitch/ +[light.tradfri docs]: https://www.home-assistant.io/components/light.tradfri/ +[light.xiaomi_miio docs]: https://www.home-assistant.io/components/light.xiaomi_miio/ +[light.yeelight docs]: https://www.home-assistant.io/components/light.yeelight/ +[lock.bmw_connected_drive docs]: https://www.home-assistant.io/components/lock.bmw_connected_drive/ +[media_extractor docs]: https://www.home-assistant.io/components/media_extractor/ +[media_player.liveboxplaytv docs]: https://www.home-assistant.io/components/media_player.liveboxplaytv/ +[media_player.philips_js docs]: https://www.home-assistant.io/components/media_player.philips_js/ +[media_player.songpal docs]: https://www.home-assistant.io/components/media_player.songpal/ +[media_player.webostv docs]: https://www.home-assistant.io/components/media_player.webostv/ +[mercedesme docs]: https://www.home-assistant.io/components/mercedesme/ +[mqtt docs]: https://www.home-assistant.io/components/mqtt/ +[mysensors docs]: https://www.home-assistant.io/components/mysensors/ +[notify docs]: https://www.home-assistant.io/components/notify/ +[pilight docs]: https://www.home-assistant.io/components/pilight/ +[qwikswitch docs]: https://www.home-assistant.io/components/qwikswitch/ +[remote.xiaomi_miio docs]: https://www.home-assistant.io/components/remote.xiaomi_miio/ +[rflink docs]: https://www.home-assistant.io/components/rflink/ +[rfxtrx docs]: https://www.home-assistant.io/components/rfxtrx/ +[sensor.bmw_connected_drive docs]: https://www.home-assistant.io/components/sensor.bmw_connected_drive/ +[sensor.broadlink docs]: https://www.home-assistant.io/components/sensor.broadlink/ +[sensor.canary docs]: https://www.home-assistant.io/components/sensor.canary/ +[sensor.cpuspeed docs]: https://www.home-assistant.io/components/sensor.cpuspeed/ +[sensor.file docs]: https://www.home-assistant.io/components/sensor.file/ +[sensor.hydroquebec docs]: https://www.home-assistant.io/components/sensor.hydroquebec/ +[sensor.imap_email_content docs]: https://www.home-assistant.io/components/sensor.imap_email_content/ +[sensor.mercedesme docs]: https://www.home-assistant.io/components/sensor.mercedesme/ +[sensor.plex docs]: https://www.home-assistant.io/components/sensor.plex/ +[sensor.qnap docs]: https://www.home-assistant.io/components/sensor.qnap/ +[sensor.qwikswitch docs]: https://www.home-assistant.io/components/sensor.qwikswitch/ +[sensor.tesla docs]: https://www.home-assistant.io/components/sensor.tesla/ +[sensor.tradfri docs]: https://www.home-assistant.io/components/sensor.tradfri/ +[sensor.waze_travel_time docs]: https://www.home-assistant.io/components/sensor.waze_travel_time/ +[smappee docs]: https://www.home-assistant.io/components/smappee/ +[switch.amcrest docs]: https://www.home-assistant.io/components/switch.amcrest/ +[switch.broadlink docs]: https://www.home-assistant.io/components/switch.broadlink/ +[switch.mystrom docs]: https://www.home-assistant.io/components/switch.mystrom/ +[switch.qwikswitch docs]: https://www.home-assistant.io/components/switch.qwikswitch/ +[switch.tahoma docs]: https://www.home-assistant.io/components/switch.tahoma/ +[switch.telnet docs]: https://www.home-assistant.io/components/switch.telnet/ +[switch.xiaomi_miio docs]: https://www.home-assistant.io/components/switch.xiaomi_miio/ +[tado docs]: https://www.home-assistant.io/components/tado/ +[tahoma docs]: https://www.home-assistant.io/components/tahoma/ +[tradfri docs]: https://www.home-assistant.io/components/tradfri/ +[watchdog_file_watcher docs]: https://www.home-assistant.io/components/watchdog_file_watcher/ +[xiaomi_aqara docs]: https://www.home-assistant.io/components/xiaomi_aqara/ +[zwave docs]: https://www.home-assistant.io/components/zwave/ From e4deae0cd2262d19d8699281a2e5258b0e44f3ae Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 6 Apr 2018 18:33:27 +0200 Subject: [PATCH 047/241] Fix list --- source/_docs/mqtt/discovery.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_docs/mqtt/discovery.markdown b/source/_docs/mqtt/discovery.markdown index 60974c428b..1e7f28c627 100644 --- a/source/_docs/mqtt/discovery.markdown +++ b/source/_docs/mqtt/discovery.markdown @@ -42,8 +42,8 @@ The discovery topic need to follow a specific format: ``` - ``: One of the supported components, eg. `binary_sensor`. -- ``: (*Optional*) id of the node providing the topic. -- ``: "The ID of the device. This is only to allow for separate topics for each device and is not used for the `entity_id`." +- `` (*Optional*): ID of the node providing the topic. +- ``: The ID of the device. This is only to allow for separate topics for each device and is not used for the `entity_id`. - `<>`: The topic `config` or `state` which defines the current action. The payload will be checked like an entry in your `configuration.yaml` file if a new device is added. This means that missing variables will be filled with the platform's default values. All configuration variables which are *required* must be present in the initial payload send to `/config`. From 38ee7392c490a5ff86d6c55405fbaef5ea8e30ce Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 6 Apr 2018 18:44:40 +0200 Subject: [PATCH 048/241] Add iOS page (fixes #4972) (#5127) --- source/_components/ios.markdown | 17 +++++++++++++++++ source/_docs/ecosystem/ios.markdown | 7 +++---- 2 files changed, 20 insertions(+), 4 deletions(-) create mode 100644 source/_components/ios.markdown diff --git a/source/_components/ios.markdown b/source/_components/ios.markdown new file mode 100644 index 0000000000..3c734ea302 --- /dev/null +++ b/source/_components/ios.markdown @@ -0,0 +1,17 @@ +--- +layout: page +title: "iOS" +description: "Instructions on how to use the iOS companion app with Home Assistant." +date: 2018-04-06 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: apple.png +ha_category: Hub +featured: true +ha_release: 0.31 +ha_iot_class: depends +--- + +The `ios` component is the Home Assistant part for using the iOS companion app. For further details please check the [iOS section](/docs/ecosystem/ios/) in the documentation for further details. diff --git a/source/_docs/ecosystem/ios.markdown b/source/_docs/ecosystem/ios.markdown index 82ba667eec..027fe50323 100644 --- a/source/_docs/ecosystem/ios.markdown +++ b/source/_docs/ecosystem/ios.markdown @@ -8,7 +8,6 @@ comments: false sharing: true footer: true redirect_from: /ecosystem/ios/ -redirect_from: /components/ios/ --- The Home Assistant for iOS app offers a companion app for iOS which is deeply integrated into both Home Assistant and iOS. Its basic features include: @@ -22,7 +21,7 @@ The app is available on the iOS App Store in every country that Apple supports.

-## Basic requirements +## {% linkable_title Basic requirements %} * iOS device running at least iOS 9, but iOS 10 is greatly preferred. * Home Assistant 0.42.4 or higher for push notification support. @@ -34,7 +33,7 @@ Loading the `ios` component will also load the [`device_tracker`][device-tracker ## {% linkable_title Setup %} -### Automated Setup +### {% linkable_title Automated Setup %} The `ios` component will automatically be loaded under the following circumstances: @@ -45,7 +44,7 @@ Automated discovery and component loading only happens at first install of the a After the first automated setup you need to add `ios:` to your configuration so that the component loads by default even after restarting Home Assistant. -### Manual Setup +### {% linkable_title Manual Setup %} You may also manually load the `ios` component by adding the following to your configuration: From d2c7a2fe772c5209cac8b446fc02cdb5d35ed010 Mon Sep 17 00:00:00 2001 From: Alexis Iglauer Date: Fri, 6 Apr 2018 19:50:23 +0200 Subject: [PATCH 049/241] Update sensor.mqtt.markdown to add initial slashes for ESPEasy (#4757) * Update sensor.mqtt.markdown The sensors topic required the initial slashes to function in my installation. * Make it more clear * Remove tab --- source/_components/sensor.mqtt.markdown | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index dc835ac9d7..f84296bd86 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -167,7 +167,12 @@ sensor: ### {% linkable_title Get sensor value from a device with ESPEasy %} -Assuming that you have flashed your ESP8266 unit with [ESPEasy](https://github.com/letscontrolit/ESPEasy). Under "Config" set a name ("Unit Name:") for your device (here it's "bathroom"). A "Controller" for MQTT with the protocol "OpenHAB MQTT" is present and the entries ("Controller Subscribe:" and "Controller Publish:") are adjusted to match your needs. In this example the topics are prefixed with "home". Also, add a sensor in the "Devices" tap with the name "analog" and "brightness" as value. +Assuming that you have flashed your ESP8266 unit with [ESPEasy](https://github.com/letscontrolit/ESPEasy). Under "Config" set a name ("Unit Name:") for your device (here it's "bathroom"). A "Controller" for MQTT with the protocol "OpenHAB MQTT" is present and the entries ("Controller Subscribe:" and "Controller Publish:") are adjusted to match your needs. In this example the topics are prefixed with "home". Please keep in mind that the ESPEasy default topics start with a `/` and only contain the name when writing your entry for the `configuration.yaml` file. + +- **Controller Subscribe**: `home/%sysname%/#` (instead of `/%sysname%/#`) +- **Controller Publish**: `home/%sysname%/%tskname%/%valname%` (instead of `/%sysname%/%tskname%/%valname%`) + +Also, add a sensor in the "Devices" tap with the name "analog" and "brightness" as value. As soon as the unit is online, you will get the state of the sensor. @@ -188,5 +193,3 @@ sensor: name: Brightness ``` {% endraw %} - - From 243f02dc3eb25b58bd329b59cb74a3911dc76c10 Mon Sep 17 00:00:00 2001 From: Jerry Workman Date: Fri, 6 Apr 2018 14:07:52 -0400 Subject: [PATCH 050/241] HA version 0.64.0 voluptuous config check. (#4773) * HA version 0.64.0 voluptuous config check. * Update --- source/developers/development_validation.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/developers/development_validation.markdown b/source/developers/development_validation.markdown index 51fef2d39b..b629dcbe64 100644 --- a/source/developers/development_validation.markdown +++ b/source/developers/development_validation.markdown @@ -28,6 +28,7 @@ Some things to keep in mind: - Use the constants defined in `const.py` - Import `PLATFORM_SCHEMA` from the parent component and extend it - Preferred order is `required` first and `optional` second +- Starting with Home Assistant 0.64 `voluptuous` requires default values for optional configuration keys to be valid values. Don't use a default which is `None` like `vol.Optional(CONF_SOMETHING, default=None): cv.string`, set the default to `default=""` if required. ### {% linkable_title Snippets %} From 086960a502281d2b3ddfe25574adeb610bcd81bd Mon Sep 17 00:00:00 2001 From: cgtobi Date: Fri, 6 Apr 2018 21:49:47 +0200 Subject: [PATCH 051/241] Docs for transparency feature google calendar component (#5101) * Add transparency feature to google calendar component * Set default behaviour to ignore the availability. This reflects the old behaviour and does not break current workflows. --- source/_components/calendar.google.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_components/calendar.google.markdown b/source/_components/calendar.google.markdown index d046396835..5999dc48ac 100644 --- a/source/_components/calendar.google.markdown +++ b/source/_components/calendar.google.markdown @@ -95,7 +95,8 @@ Variables: - **track**: (*Required*): Should we create a sensor `True` or ignore it `False`? - **search**: (*Optional*): If set will only trigger for matched events. - **offset**: (*Optional*): A set of characters that precede a number in the event title for designating a pre-trigger state change on the sensor. (Default: `!!`) - +  - **ignore_availablilty**: (*Optional*): Should we respect `free`/`busy` flags? (Defaults to `true`) +   From this we will end up with the binary sensors `calendar.test_unimportant` and `calendar.test_important` which will toggle themselves on/off based on events on the same calendar that match the search value set for each. You'll also have a sensor `calendar.test_everything` that will not filter events out and always show the next event available. But what if you only wanted it to toggle based on all events? Just leave out the *search* parameter. From 5c47c159a9f0653cf988cf421f0f4c6eed6d4d5a Mon Sep 17 00:00:00 2001 From: Juggels Date: Fri, 6 Apr 2018 22:24:10 +0200 Subject: [PATCH 052/241] Allow TodoistAPI date_string in service call (#4923) * Update docs to reflect changes * Match docs to latest component update * Missed renamed parameters in example --- source/_components/calendar.todoist.markdown | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/source/_components/calendar.todoist.markdown b/source/_components/calendar.todoist.markdown index d3ad45c8c4..c416ddb50d 100644 --- a/source/_components/calendar.todoist.markdown +++ b/source/_components/calendar.todoist.markdown @@ -111,7 +111,7 @@ Home Assistant does its best to determine what task in each project is "most" im Todoist also comes with access to a service, `calendar.todoist_new_task`. This service can be used to create a new Todoist task. You can specify labels and a project, or you can leave them blank, and the task will go to your "Inbox" project. -Here's an example JSON payload: +Here are two example JSON payloads resulting in the same task: ```json { @@ -123,6 +123,17 @@ Here's an example JSON payload: } ``` +```json +{ + "content": "Pick up the mail", + "project": "Errands", + "labels":"Homework,School", + "priority":3, + "due_date_string":"tomorrow at 14:00", + "due_date_lang":"en" +} +``` + - **content** (*Required*): The name of the task you want to create. - **project** (*Optional*): The project to put the task in. @@ -131,6 +142,11 @@ Here's an example JSON payload: - **priority** (*Optional*): The priority of the task, from 1-4. Again, 1 means least important, and 4 means most important. -- **due_date** (*Optional*): When the task should be due, in either YYYY-MM-DD format or YYYY-MM-DD HH:MM format. +- **due_date_string** (*Optional*): When the task should be due, in [natural language](https://support.todoist.com/hc/en-us/articles/205325931-Dates-and-Times). Mutually exclusive with `due_date` + +- **due_date_lang** (*Optional*): When `due_date_string` is set, it is posisble to set the language. + Valid languages are: `en`, `da`, `pl`, `zh`, `ko`, `de`, `pt`, `ja`, `it`, `fr`, `sv`, `ru`, `es`, `nl` + +- **due_date** (*Optional*): When the task should be due, in either YYYY-MM-DD format or YYYY-MM-DD HH:MM format. Mutually exclusive with `due_date_string`. Note that there's (currently) no way to mark tasks as done through Home Assistant; task names do not necessarily have to be unique, so you could find yourself in a situation where you close the wrong task. From 5d0eb6b5a61a2de83b67b0298195f4f01d0209b2 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 6 Apr 2018 23:05:55 +0200 Subject: [PATCH 053/241] Remove periods --- .../_docs/installation/hassbian/integrations.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_docs/installation/hassbian/integrations.markdown b/source/_docs/installation/hassbian/integrations.markdown index 5658ce712e..d6f7a3fd0c 100644 --- a/source/_docs/installation/hassbian/integrations.markdown +++ b/source/_docs/installation/hassbian/integrations.markdown @@ -26,11 +26,11 @@ For more details about the GPIO layout, visit the [documentation](https://www.ra Permission have been given to the `homeassistant` user to use the GPIO pins and all of the following components should require no underlying changes to work. Just follow the component pages for each on how to add them to your Home Assistant installation. - - [DHT Sensor](/components/sensor.dht/). - - [Raspberry Pi Cover](/components/cover.rpi_gpio/). - - [Raspberry Pi GPIO Binary Sensor](/components/binary_sensor.rpi_gpio/). - - [Raspberry Pi GPIO Switch](/components/switch.rpi_gpio/). - - [Raspberry Pi RF Switch](/components/switch.rpi_rf/). + - [DHT Sensor](/components/sensor.dht/) + - [Raspberry Pi Cover](/components/cover.rpi_gpio/) + - [Raspberry Pi GPIO Binary Sensor](/components/binary_sensor.rpi_gpio/) + - [Raspberry Pi GPIO Switch](/components/switch.rpi_gpio/) + - [Raspberry Pi RF Switch](/components/switch.rpi_rf/) ### {% linkable_title Raspberry Pi Camera %} From 690fa13130c8995ad7046c54a28dde6aaa0129a3 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 6 Apr 2018 23:13:40 +0200 Subject: [PATCH 054/241] Update layout --- source/_components/smappee.markdown | 33 +++++++++++++++-------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/source/_components/smappee.markdown b/source/_components/smappee.markdown index 5e35f4866f..ce56987f72 100644 --- a/source/_components/smappee.markdown +++ b/source/_components/smappee.markdown @@ -12,41 +12,42 @@ ha_release: "0.64" ha_category: Hub --- -[Smappee](https://www.smappee.com/) controller for energy monitoring and Comport plug switches. +The `smappee` component adds support for the [Smappee](https://www.smappee.com/) controller for energy monitoring and Comport plug switches. Switches and Sensors are supported - and will be automatically added when you connect to the Smappee controller. -The smappee component gets information from [Smappee API](https://smappee.atlassian.net/wiki/display/DEVAPI/API+Methods) using the [smappy](https://github.com/EnergieID/smappy) pypy module +The smappee component gets information from [Smappee API](https://smappee.atlassian.net/wiki/display/DEVAPI/API+Methods). -

-Info on how to get api access is described in the [smappy wiki](https://github.com/EnergieID/smappy/wiki) -

+## {% linkable_title Configuration %} + +Info on how to get API access is described in the [smappy wiki](https://github.com/EnergieID/smappy/wiki). + +To use the `smappee` component in your installation, add the following to your `configuration.yaml` file: -# Configuration ```yaml # Example configuration.yaml entry smappee: - host: 10.0.0.5 - client_id: YOUR_CLIENT_ID - client_secret: YOUR_CLIENT_SECRET - username: YOUR_MYSMAPPEE_USERNAME - password: YOUR_MYSMAPPEE_PASSWORD + host: 10.0.0.5 + client_id: YOUR_CLIENT_ID + client_secret: YOUR_CLIENT_SECRET + username: YOUR_MYSMAPPEE_USERNAME + password: YOUR_MYSMAPPEE_PASSWORD ``` ```yaml # Minimal example configuration.yaml entry smappee: - host: 10.0.0.5 + host: 10.0.0.5 ``` ```yaml # Cloud only example configuration.yaml entry smappee: - client_id: YOUR_CLIENT_ID - client_secret: YOUR_CLIENT_SECRET - username: YOUR_MYSMAPPEE_USERNAME - password: YOUR_MYSMAPPEE_PASSWORD + client_id: YOUR_CLIENT_ID + client_secret: YOUR_CLIENT_SECRET + username: YOUR_MYSMAPPEE_USERNAME + password: YOUR_MYSMAPPEE_PASSWORD ``` Configuration variables: From 42e0e4f477ffce814f236aad982078076a5edf36 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 7 Apr 2018 10:20:34 +0200 Subject: [PATCH 055/241] Fix link --- source/help/reporting_issues.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/help/reporting_issues.markdown b/source/help/reporting_issues.markdown index f3764c3d08..d2290788c5 100644 --- a/source/help/reporting_issues.markdown +++ b/source/help/reporting_issues.markdown @@ -11,7 +11,7 @@ footer: true If you have an installation, a setup or a configuration issue please use our [Forum](https://community.home-assistant.io/) to get help. We have a big community which will help you if they can. -If you found a bug then please report it in one of our [trackers](help/#bugs-feature-requests-and-alike). To help you and our developers to identify the issue quickly, please fill out the provided template. The "weird" content you will see is there to render your entry in a nice format after submitting. It's just [markddown](https://guides.github.com/features/mastering-markdown/). +If you found a bug then please report it in one of our [trackers](/help/#bugs-feature-requests-and-alike). To help you and our developers to identify the issue quickly, please fill out the provided template. The "weird" content you will see is there to render your entry in a nice format after submitting. It's just [markddown](https://guides.github.com/features/mastering-markdown/). Use the command below to get the Home Assistant release you are running from a command-line. From 0c7780681bdfe73b07184b79bdcd5adf38fd24a7 Mon Sep 17 00:00:00 2001 From: Otto Winter Date: Sun, 8 Apr 2018 04:32:01 +0200 Subject: [PATCH 056/241] MQTT Sensor Unique ID feature (#5131) --- source/_components/sensor.mqtt.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index dc835ac9d7..7076fc9b56 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -80,6 +80,10 @@ json_attributes: description: A list of keys to extract values from a JSON dictionary payload and then set as sensor attributes. reqired: false type: list, string +unique_id: + description: "An id that uniquely identifies this sensor. If 2 sensors have the same unique id, Home Assistant will raise an exception.**" + required: false + type: string {% endconfiguration %} ## {% linkable_title Examples %} From c427325a9ccb90c0d6e0ee0a3163da810ce754b1 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 8 Apr 2018 10:03:01 -0400 Subject: [PATCH 057/241] Remove domain prefix --- source/_posts/2018-04-14-release-67.markdown | 160 +++++++++---------- 1 file changed, 80 insertions(+), 80 deletions(-) diff --git a/source/_posts/2018-04-14-release-67.markdown b/source/_posts/2018-04-14-release-67.markdown index ee6134e9da..f6d3c285a6 100644 --- a/source/_posts/2018-04-14-release-67.markdown +++ b/source/_posts/2018-04-14-release-67.markdown @@ -296,83 +296,83 @@ Experiencing issues introduced by this release? Please report them in our [issue [@turbokongen]: https://github.com/turbokongen [@wmalgadey]: https://github.com/wmalgadey [@zhaokoh]: https://github.com/zhaokoh -[abode docs]: https://www.home-assistant.io/components/abode/ -[alarm_control_panel.ifttt docs]: https://www.home-assistant.io/components/alarm_control_panel.ifttt/ -[alarm_control_panel.totalconnect docs]: https://www.home-assistant.io/components/alarm_control_panel.totalconnect/ -[alexa docs]: https://www.home-assistant.io/components/alexa/ -[amcrest docs]: https://www.home-assistant.io/components/amcrest/ -[binary_sensor.bmw_connected_drive docs]: https://www.home-assistant.io/components/binary_sensor.bmw_connected_drive/ -[binary_sensor.mercedesme docs]: https://www.home-assistant.io/components/binary_sensor.mercedesme/ -[binary_sensor.workday docs]: https://www.home-assistant.io/components/binary_sensor.workday/ -[bmw_connected_drive docs]: https://www.home-assistant.io/components/bmw_connected_drive/ -[camera.mqtt docs]: https://www.home-assistant.io/components/camera.mqtt/ -[canary docs]: https://www.home-assistant.io/components/canary/ -[climate.nest docs]: https://www.home-assistant.io/components/climate.nest/ -[config docs]: https://www.home-assistant.io/components/config/ -[config_entry_example docs]: https://www.home-assistant.io/components/config_entry_example/ -[conversation docs]: https://www.home-assistant.io/components/conversation/ -[cover docs]: https://www.home-assistant.io/components/cover/ -[cover.rpi_gpio docs]: https://www.home-assistant.io/components/cover.rpi_gpio/ -[deconz docs]: https://www.home-assistant.io/components/deconz/ -[device_tracker docs]: https://www.home-assistant.io/components/device_tracker/ -[device_tracker.bluetooth_tracker docs]: https://www.home-assistant.io/components/device_tracker.bluetooth_tracker/ -[device_tracker.bmw_connected_drive docs]: https://www.home-assistant.io/components/device_tracker.bmw_connected_drive/ -[device_tracker.google_maps docs]: https://www.home-assistant.io/components/device_tracker.google_maps/ -[doorbird docs]: https://www.home-assistant.io/components/doorbird/ -[fan.xiaomi_miio docs]: https://www.home-assistant.io/components/fan.xiaomi_miio/ -[folder_watcher docs]: https://www.home-assistant.io/components/folder_watcher/ -[freedns docs]: https://www.home-assistant.io/components/freedns/ -[homekit docs]: https://www.home-assistant.io/components/homekit/ -[hue docs]: https://www.home-assistant.io/components/hue/ -[insteon_plm docs]: https://www.home-assistant.io/components/insteon_plm/ -[light docs]: https://www.home-assistant.io/components/light/ -[light.aurora docs]: https://www.home-assistant.io/components/light.aurora/ -[light.hue docs]: https://www.home-assistant.io/components/light.hue/ -[light.mystrom docs]: https://www.home-assistant.io/components/light.mystrom/ -[light.qwikswitch docs]: https://www.home-assistant.io/components/light.qwikswitch/ -[light.tradfri docs]: https://www.home-assistant.io/components/light.tradfri/ -[light.xiaomi_miio docs]: https://www.home-assistant.io/components/light.xiaomi_miio/ -[light.yeelight docs]: https://www.home-assistant.io/components/light.yeelight/ -[lock.bmw_connected_drive docs]: https://www.home-assistant.io/components/lock.bmw_connected_drive/ -[media_extractor docs]: https://www.home-assistant.io/components/media_extractor/ -[media_player.liveboxplaytv docs]: https://www.home-assistant.io/components/media_player.liveboxplaytv/ -[media_player.philips_js docs]: https://www.home-assistant.io/components/media_player.philips_js/ -[media_player.songpal docs]: https://www.home-assistant.io/components/media_player.songpal/ -[media_player.webostv docs]: https://www.home-assistant.io/components/media_player.webostv/ -[mercedesme docs]: https://www.home-assistant.io/components/mercedesme/ -[mqtt docs]: https://www.home-assistant.io/components/mqtt/ -[mysensors docs]: https://www.home-assistant.io/components/mysensors/ -[notify docs]: https://www.home-assistant.io/components/notify/ -[pilight docs]: https://www.home-assistant.io/components/pilight/ -[qwikswitch docs]: https://www.home-assistant.io/components/qwikswitch/ -[remote.xiaomi_miio docs]: https://www.home-assistant.io/components/remote.xiaomi_miio/ -[rflink docs]: https://www.home-assistant.io/components/rflink/ -[rfxtrx docs]: https://www.home-assistant.io/components/rfxtrx/ -[sensor.bmw_connected_drive docs]: https://www.home-assistant.io/components/sensor.bmw_connected_drive/ -[sensor.broadlink docs]: https://www.home-assistant.io/components/sensor.broadlink/ -[sensor.canary docs]: https://www.home-assistant.io/components/sensor.canary/ -[sensor.cpuspeed docs]: https://www.home-assistant.io/components/sensor.cpuspeed/ -[sensor.file docs]: https://www.home-assistant.io/components/sensor.file/ -[sensor.hydroquebec docs]: https://www.home-assistant.io/components/sensor.hydroquebec/ -[sensor.imap_email_content docs]: https://www.home-assistant.io/components/sensor.imap_email_content/ -[sensor.mercedesme docs]: https://www.home-assistant.io/components/sensor.mercedesme/ -[sensor.plex docs]: https://www.home-assistant.io/components/sensor.plex/ -[sensor.qnap docs]: https://www.home-assistant.io/components/sensor.qnap/ -[sensor.qwikswitch docs]: https://www.home-assistant.io/components/sensor.qwikswitch/ -[sensor.tesla docs]: https://www.home-assistant.io/components/sensor.tesla/ -[sensor.tradfri docs]: https://www.home-assistant.io/components/sensor.tradfri/ -[sensor.waze_travel_time docs]: https://www.home-assistant.io/components/sensor.waze_travel_time/ -[smappee docs]: https://www.home-assistant.io/components/smappee/ -[switch.amcrest docs]: https://www.home-assistant.io/components/switch.amcrest/ -[switch.broadlink docs]: https://www.home-assistant.io/components/switch.broadlink/ -[switch.mystrom docs]: https://www.home-assistant.io/components/switch.mystrom/ -[switch.qwikswitch docs]: https://www.home-assistant.io/components/switch.qwikswitch/ -[switch.tahoma docs]: https://www.home-assistant.io/components/switch.tahoma/ -[switch.telnet docs]: https://www.home-assistant.io/components/switch.telnet/ -[switch.xiaomi_miio docs]: https://www.home-assistant.io/components/switch.xiaomi_miio/ -[tado docs]: https://www.home-assistant.io/components/tado/ -[tahoma docs]: https://www.home-assistant.io/components/tahoma/ -[tradfri docs]: https://www.home-assistant.io/components/tradfri/ -[watchdog_file_watcher docs]: https://www.home-assistant.io/components/watchdog_file_watcher/ -[xiaomi_aqara docs]: https://www.home-assistant.io/components/xiaomi_aqara/ -[zwave docs]: https://www.home-assistant.io/components/zwave/ +[abode docs]: /components/abode/ +[alarm_control_panel.ifttt docs]: /components/alarm_control_panel.ifttt/ +[alarm_control_panel.totalconnect docs]: /components/alarm_control_panel.totalconnect/ +[alexa docs]: /components/alexa/ +[amcrest docs]: /components/amcrest/ +[binary_sensor.bmw_connected_drive docs]: /components/binary_sensor.bmw_connected_drive/ +[binary_sensor.mercedesme docs]: /components/binary_sensor.mercedesme/ +[binary_sensor.workday docs]: /components/binary_sensor.workday/ +[bmw_connected_drive docs]: /components/bmw_connected_drive/ +[camera.mqtt docs]: /components/camera.mqtt/ +[canary docs]: /components/canary/ +[climate.nest docs]: /components/climate.nest/ +[config docs]: /components/config/ +[config_entry_example docs]: /components/config_entry_example/ +[conversation docs]: /components/conversation/ +[cover docs]: /components/cover/ +[cover.rpi_gpio docs]: /components/cover.rpi_gpio/ +[deconz docs]: /components/deconz/ +[device_tracker docs]: /components/device_tracker/ +[device_tracker.bluetooth_tracker docs]: /components/device_tracker.bluetooth_tracker/ +[device_tracker.bmw_connected_drive docs]: /components/device_tracker.bmw_connected_drive/ +[device_tracker.google_maps docs]: /components/device_tracker.google_maps/ +[doorbird docs]: /components/doorbird/ +[fan.xiaomi_miio docs]: /components/fan.xiaomi_miio/ +[folder_watcher docs]: /components/folder_watcher/ +[freedns docs]: /components/freedns/ +[homekit docs]: /components/homekit/ +[hue docs]: /components/hue/ +[insteon_plm docs]: /components/insteon_plm/ +[light docs]: /components/light/ +[light.aurora docs]: /components/light.aurora/ +[light.hue docs]: /components/light.hue/ +[light.mystrom docs]: /components/light.mystrom/ +[light.qwikswitch docs]: /components/light.qwikswitch/ +[light.tradfri docs]: /components/light.tradfri/ +[light.xiaomi_miio docs]: /components/light.xiaomi_miio/ +[light.yeelight docs]: /components/light.yeelight/ +[lock.bmw_connected_drive docs]: /components/lock.bmw_connected_drive/ +[media_extractor docs]: /components/media_extractor/ +[media_player.liveboxplaytv docs]: /components/media_player.liveboxplaytv/ +[media_player.philips_js docs]: /components/media_player.philips_js/ +[media_player.songpal docs]: /components/media_player.songpal/ +[media_player.webostv docs]: /components/media_player.webostv/ +[mercedesme docs]: /components/mercedesme/ +[mqtt docs]: /components/mqtt/ +[mysensors docs]: /components/mysensors/ +[notify docs]: /components/notify/ +[pilight docs]: /components/pilight/ +[qwikswitch docs]: /components/qwikswitch/ +[remote.xiaomi_miio docs]: /components/remote.xiaomi_miio/ +[rflink docs]: /components/rflink/ +[rfxtrx docs]: /components/rfxtrx/ +[sensor.bmw_connected_drive docs]: /components/sensor.bmw_connected_drive/ +[sensor.broadlink docs]: /components/sensor.broadlink/ +[sensor.canary docs]: /components/sensor.canary/ +[sensor.cpuspeed docs]: /components/sensor.cpuspeed/ +[sensor.file docs]: /components/sensor.file/ +[sensor.hydroquebec docs]: /components/sensor.hydroquebec/ +[sensor.imap_email_content docs]: /components/sensor.imap_email_content/ +[sensor.mercedesme docs]: /components/sensor.mercedesme/ +[sensor.plex docs]: /components/sensor.plex/ +[sensor.qnap docs]: /components/sensor.qnap/ +[sensor.qwikswitch docs]: /components/sensor.qwikswitch/ +[sensor.tesla docs]: /components/sensor.tesla/ +[sensor.tradfri docs]: /components/sensor.tradfri/ +[sensor.waze_travel_time docs]: /components/sensor.waze_travel_time/ +[smappee docs]: /components/smappee/ +[switch.amcrest docs]: /components/switch.amcrest/ +[switch.broadlink docs]: /components/switch.broadlink/ +[switch.mystrom docs]: /components/switch.mystrom/ +[switch.qwikswitch docs]: /components/switch.qwikswitch/ +[switch.tahoma docs]: /components/switch.tahoma/ +[switch.telnet docs]: /components/switch.telnet/ +[switch.xiaomi_miio docs]: /components/switch.xiaomi_miio/ +[tado docs]: /components/tado/ +[tahoma docs]: /components/tahoma/ +[tradfri docs]: /components/tradfri/ +[watchdog_file_watcher docs]: /components/watchdog_file_watcher/ +[xiaomi_aqara docs]: /components/xiaomi_aqara/ +[zwave docs]: /components/zwave/ From 2abdd0d46550f05737bd918ef7921fcce7fa55cc Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 8 Apr 2018 10:09:41 -0400 Subject: [PATCH 058/241] remove some absolute urls in favor of relative --- source/_posts/2018-03-30-release-66.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_posts/2018-03-30-release-66.markdown b/source/_posts/2018-03-30-release-66.markdown index 3cb379af26..26aba182be 100644 --- a/source/_posts/2018-03-30-release-66.markdown +++ b/source/_posts/2018-03-30-release-66.markdown @@ -566,6 +566,6 @@ Experiencing issues introduced by this release? Please report them in our [issue [@MartinHjelmare]: https://github.com/MartinHjelmare [@armills]: https://github.com/armills [@cdce8p]: https://github.com/cdce8p -[homekit docs]: https://www.home-assistant.io/components/homekit/ -[light.mqtt_json docs]: https://www.home-assistant.io/components/light.mqtt_json/ -[sensor.mysensors docs]: https://www.home-assistant.io/components/sensor.mysensors/ +[homekit docs]: /components/homekit/ +[light.mqtt_json docs]: /components/light.mqtt_json/ +[sensor.mysensors docs]: /components/sensor.mysensors/ From a151bb7ff22768b241268eb24ae9f37dafbf9c02 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 8 Apr 2018 17:42:40 +0200 Subject: [PATCH 059/241] It's ASL 2.0 and no longer MIT --- source/developers/development.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/developers/development.markdown b/source/developers/development.markdown index f2f79b70c4..8bc614295d 100644 --- a/source/developers/development.markdown +++ b/source/developers/development.markdown @@ -11,7 +11,7 @@ footer: true Home Assistant is built from the ground up to be easily extensible using components. Home Assistant uses [Python 3](https://www.python.org/) for the backend and [Polymer (Web components)](https://www.polymer-project.org/) for the frontend. -Home Assistant is open-source and MIT-licensed. Here are links to the source: +Home Assistant is open-source and licensed under [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0). Here are links to the source: - [home-assistant](https://github.com/home-assistant/home-assistant): Python server backend. - [home-assistant-polymer](https://github.com/home-assistant/home-assistant-polymer): Polymer UI. From 2667e63bab3292e04a411914c815985b725a787e Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 8 Apr 2018 17:44:11 +0200 Subject: [PATCH 060/241] Fix typo --- source/_components/http.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/http.markdown b/source/_components/http.markdown index 458e10794e..8fddcfd5d9 100644 --- a/source/_components/http.markdown +++ b/source/_components/http.markdown @@ -90,7 +90,7 @@ Please note, that sources from `trusted_networks` won't be banned automatically. ## {% linkable_title Hosting files %} -If you want to use Home Assistant to host or serve static files then create a directory called `www` under the configuration path (`/config` on Hass.io, `.homeassistant` elswhere). The static files in `www/` can be accessed by the following URL `http://your.domain:8123/local/`, for example `audio.mp3` would be accessed as `http://your.domain:8123/local/audio.mp3`. +If you want to use Home Assistant to host or serve static files then create a directory called `www` under the configuration path (`/config` on Hass.io, `.homeassistant` elsewhere). The static files in `www/` can be accessed by the following URL `http://your.domain:8123/local/`, for example `audio.mp3` would be accessed as `http://your.domain:8123/local/audio.mp3`.

If you've had to create the `www/` folder for the first time, you'll need to restart Home Assistant. From 3ca5ab88cea13f4c0664ad055132f46be9d46ef1 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 8 Apr 2018 21:31:54 +0200 Subject: [PATCH 061/241] Remove feature --- source/_components/ios.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/ios.markdown b/source/_components/ios.markdown index 3c734ea302..44ac2fa88e 100644 --- a/source/_components/ios.markdown +++ b/source/_components/ios.markdown @@ -9,7 +9,7 @@ sharing: true footer: true logo: apple.png ha_category: Hub -featured: true +featured: false ha_release: 0.31 ha_iot_class: depends --- From 0691f3253d6800cc58907c3121830c1e0ee9f5fd Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Sun, 8 Apr 2018 22:33:52 +0200 Subject: [PATCH 062/241] Added light color_temp HomeKit (#5122) * Added light color_temp support --- source/_components/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 5313a8428a..5ca13b0f2b 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -196,7 +196,7 @@ The following components are currently supported: | alarm_control_panel | SecuritySystem | All security systems. | | climate | Thermostat | All climate devices. | | cover | WindowCovering | All covers that support `set_cover_position`. | -| light | Light | Support for `on / off`, `brightness` and `rgb_color`. | +| light | Light | Support for `on / off`, `brightness`, `color_temp` and `rgb_color`. | | sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement`. | | sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` | | switch / remote / input_boolean / script | Switch | All represented as switches. | From 46f89afa140075da462dabd710bce07cfe4113ea Mon Sep 17 00:00:00 2001 From: Tim Hordern Date: Mon, 9 Apr 2018 17:38:28 +1000 Subject: [PATCH 063/241] Fix markdown link in Docker Installation docs (#5140) --- source/_docs/installation/docker.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index 53ee103784..20ccb53943 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -28,7 +28,7 @@ If you wish to browse directly to `http://localhost:8123` from your macOS host, $ docker run -d --name="home-assistant" -v /path/to/your/config:/config -e "TZ=America/Los_Angeles" -p 8123:8123 homeassistant/home-assistant ``` -Alternatively, `docker-compose` works with any recent release of `docker-ce` on macOS. Note that (further down this page) we provide an example `docker-compose.yml` however it differs from the `docker run` example above. To make the .yml directives match, you would need to make _two_ changes: first add the equivalent `ports:` directive, then _remove_ the `network_mode: host` section. This is because `Port mapping is incompatible with network_mode: host:`. More details can be found at [Docker networking docs] (https://docs.docker.com/engine/userguide/networking/#default-networks). Note also the `/dev/tty*` device name used by your Arduino etc. devices will differ from the Linux example, so the compose `mount:` may require updates. +Alternatively, `docker-compose` works with any recent release of `docker-ce` on macOS. Note that (further down this page) we provide an example `docker-compose.yml` however it differs from the `docker run` example above. To make the .yml directives match, you would need to make _two_ changes: first add the equivalent `ports:` directive, then _remove_ the `network_mode: host` section. This is because `Port mapping is incompatible with network_mode: host:`. More details can be found at [Docker networking docs](https://docs.docker.com/engine/userguide/networking/#default-networks). Note also the `/dev/tty*` device name used by your Arduino etc. devices will differ from the Linux example, so the compose `mount:` may require updates. ### {% linkable_title Windows %} From 17ccbcce243cd901af6e6cd61a0ade1dee8d5300 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 9 Apr 2018 16:04:39 +0200 Subject: [PATCH 064/241] Various fixes --- source/_docs/installation/docker.markdown | 51 ++++++++++------------- 1 file changed, 23 insertions(+), 28 deletions(-) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index 20ccb53943..d8e6ed3ff4 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -10,7 +10,7 @@ footer: true redirect_from: /getting-started/installation-docker/ --- -Installation with Docker is straightforward. Adjust the following command so that `/path/to/your/config/` points at the folder where you want to store your config and run it: +Installation with Docker is straightforward. Adjust the following command so that `/path/to/your/config/` points at the folder where you want to store your configuration and run it: ### {% linkable_title Linux %} @@ -20,7 +20,7 @@ $ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/ ### {% linkable_title macOS %} -When using `docker-ce` (or `boot2docker`) on macOS, you are unable to map the local timezone to your Docker container ([Docker issue](https://github.com/docker/for-mac/issues/44)). Instead of `-v /etc/localtime:/etc/localtime:ro`, just pass in the timezone environment variable when you launch the container, ex: `-e "TZ=America/Los_Angeles"`. Replace "America/Los_Angeles" with [your timezone](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones). +When using `docker-ce` (or `boot2docker`) on macOS, you are unable to map the local timezone to your Docker container ([Docker issue](https://github.com/docker/for-mac/issues/44)). Instead of `-v /etc/localtime:/etc/localtime:ro`, just pass in the timezone environment variable when you launch the container, e.g, `-e "TZ=America/Los_Angeles"`. Replace "America/Los_Angeles" with [your timezone](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If you wish to browse directly to `http://localhost:8123` from your macOS host, meaning forward ports directly to the container, replace the `--net=host` switch with `-p 8123:8123`. More detail can be found in [the docker forums](https://forums.docker.com/t/should-docker-run-net-host-work/14215/10). @@ -84,31 +84,24 @@ As QNAP within QTS now supports Docker (with a neat UI), you can simply install The steps would be: - - Install “Container Station” package on your Qnap NAS - - Launch Container Station and move to “Create Container”-section - - Search image “homeassistant/home-assistant” with - docker hub and click on “Install” + - Install "Container Station" package on your Qnap NAS + - Launch Container Station and move to "Create Container"-section + - Search image "homeassistant/home-assistant" with Docker hub and click on "Install" - Choose "latest" version and click next - - Choose a container-name you want (e.g. - “homeassistant”) - - Click on “Advanced Settings” - - Within “Shared Folders” click on "Volume from host" > "Add" and - choose either an existing folder or add a new folder. The “mount - point” has to be “/config”, so that Home Assistant will use it for - the configs and logs. - - Within “Network” and select Network Mode to “Host” - - To ensure that Home Assistant displays the correct - timezone go to the “Environment” tab and click the plus sign then add - `variable` = `TZ` & `value` = `Europe/London` choosing [your correct timezone](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones) - - Click on “Create” + - Choose a container-name you want (e.g., "homeassistant") + - Click on "Advanced Settings" + - Within "Shared Folders" click on "Volume from host" > "Add" and choose either an existing folder or add a new folder. The "mount point has to be `/config`, so that Home Assistant will use it for the configuration and logs. + - Within "Network" and select Network Mode to "Host" + - To ensure that Home Assistant displays the correct timezone go to the "Environment" tab and click the plus sign then add `variable` = `TZ` & `value` = `Europe/London` choosing [your correct timezone](http://en.wikipedia.org/wiki/List_of_tz_database_time_zones) + - Click on "Create" - Wait for some time until your NAS has created the container - Your Home Assistant within Docker should now run and will serve the web interface from port 8123 on your Docker host (this will be your Qnap NAS IP address - for example `http://192.xxx.xxx.xxx:8123`) -Remark: to update your Home Assistant on your Docker within Qnap NAS, you just remove container and image and do steps again (Don't remove "config" folder) +Remark: To update your Home Assistant on your Docker within Qnap NAS, you just remove container and image and do steps again (Don't remove "config" folder). -If you want to use a USB Bluetooth adapter or Z-Wave USB Stick with Home Assistant on Qnap Docker, Fallow this step: +If you want to use a USB Bluetooth adapter or Z-Wave USB stick with Home Assistant on Qnap Docker, follow those steps: -**Z-wave:** +#### {% linkable_title Z-Wave %} - Connect to your NAS over SSH - Load cdc-acm kernel module(when nas restart need to run this command) @@ -123,16 +116,16 @@ If you want to use a USB Bluetooth adapter or Z-Wave USB Stick with Home Assista `-v` is your config path `-e` is set timezone - - Edit configuration.yaml + - Edit `configuration.yaml` -``` +```yaml zwave: usb_path: /dev/ttyACM0 ``` That will tell Home Assistant where to look for our Z-wave radio. -**Bluetooth:** +#### {% linkable_title Bluetooth %} - Connect to your NAS over SSH - Run Docker command: @@ -141,9 +134,9 @@ That will tell Home Assistant where to look for our Z-wave radio. First `-v` is your config path `-e` is set timezone - - Edit configuration.yaml + - Edit the `configuration.yaml` file -``` +```yaml device_tracker: - platform: bluetooth_tracker ``` @@ -180,10 +173,12 @@ $ docker-compose up -d ### {% linkable_title Exposing Devices %} -In order to use z-wave, zigbee or other components that require access to devices, you need to map the appropriate device into the container. Ensure the user that is running the container has the correct privileges to access the `/dev/tty*` file, then add the device mapping to your docker command: +In order to use Z-Wave, ZigBbee or other components that require access to devices, you need to map the appropriate device into the container. Ensure the user that is running the container has the correct privileges to access the `/dev/tty*` file, then add the device mapping to your docker command: ```bash -$ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --device /dev/ttyUSB0:/dev/ttyUSB0 --net=host homeassistant/home-assistant +$ docker run -d --name="home-assistant" -v /path/to/your/config:/config \ + -v /etc/localtime:/etc/localtime:ro --device /dev/ttyUSB0:/dev/ttyUSB0 \ + --net=host homeassistant/home-assistant ``` or in a `docker-compose.yml` file: From 9f70138ffcc8f077bd70014d746a512d5cf1e897 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 9 Apr 2018 16:04:53 +0200 Subject: [PATCH 065/241] Add container update --- source/_docs/installation/updating.markdown | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/source/_docs/installation/updating.markdown b/source/_docs/installation/updating.markdown index b3c7040b9a..dd5d6dc3ab 100644 --- a/source/_docs/installation/updating.markdown +++ b/source/_docs/installation/updating.markdown @@ -14,7 +14,7 @@ redirect_from: /getting-started/updating/ The upgrade process differs depending on the installation you have, so please review the documentation that is specific to your install [Hass.io](/hassio/), [Hassbian](/docs/installation/hassbian/common-tasks/#update-home-assistant), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv/#upgrading-home-assistant).

-Check what's new in the latest version and potentially impacts your system in [Home Assistant release notes](https://github.com/home-assistant/home-assistant/releases). It is good practice to review these release notes and pay close attention to the **Breaking Changes** that are listed there. If you haven't done an update for a while, you should also check previous release notes as they can also contain relevant **Breaking Changes**. **Breaking Changes** may require configuration updates for your components. If you missed this and Home Assistant refuses to start, check `/home-assistant.log` for details about broken components. +Check what's new in the latest version and potentially impacts your system in [Home Assistant release notes](https://github.com/home-assistant/home-assistant/releases). It is good practice to review these release notes and pay close attention to the **Breaking Changes** that are listed there. If you haven't done an update for a while, you should also check previous release notes as they can also contain relevant **Breaking Changes**. **Breaking Changes** may require configuration updates for your components. If you missed this and Home Assistant refuses to start, check the log file in the [configuration](/docs/configuration/) directory, e.g., `.homeassistant/home-assistant.log`, for details about broken components. The default way to update Home Assistant to the latest release, when available, is: @@ -22,7 +22,13 @@ The default way to update Home Assistant to the latest release, when available, $ pip3 install --upgrade homeassistant ``` -After updating, you must restart Home Assistant for the changes to take effect. This means that you will have to restart `hass` itself or the [autostarting](/docs/autostart/) daemon (if applicable). Startup can take considerable amount of time (i.e. minutes) depending on your device. This is because all requirements are updated as well. +For a Docker container, simply pull the latest one: + +```bash +$ sudo docker pull homeassistant/home-assistant:latest +``` + +After updating, you must start/restart Home Assistant for the changes to take effect. This means that you will have to restart `hass` itself or the [autostarting](/docs/autostart/) daemon (if applicable). Startup can take considerable amount of time (i.e. minutes) depending on your device. This is because all requirements are updated as well.

To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Hass.io](/hassio/), [Hassbian](/docs/hassbian/installation/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv). From 07203297935648138e6b040dbbbdc39d842ee8ee Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Mon, 9 Apr 2018 16:11:20 +0200 Subject: [PATCH 066/241] Added binary_sensor to supported types (#5143) --- source/_components/homekit.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 5313a8428a..90bddcb515 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -194,6 +194,7 @@ The following components are currently supported: | Component | Type Name | Description | | --------- | --------- | ----------- | | alarm_control_panel | SecuritySystem | All security systems. | +| binary_sensor | Sensor | Support for `CO2`, `Gas`, `Moisture`, `Motion`, `Occupancy`, `Opening` and `Smoke` device classes. Defaults to the `Occupancy` device class for everything else. | | climate | Thermostat | All climate devices. | | cover | WindowCovering | All covers that support `set_cover_position`. | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | From 89f64dfbd82617b39545f6c7f12777653f53a300 Mon Sep 17 00:00:00 2001 From: Phil Kates Date: Mon, 9 Apr 2018 07:23:59 -0700 Subject: [PATCH 067/241] homekit/locks: Add locks (#5093) --- source/_components/homekit.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 90bddcb515..d3ee4c773f 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -198,6 +198,7 @@ The following components are currently supported: | climate | Thermostat | All climate devices. | | cover | WindowCovering | All covers that support `set_cover_position`. | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | +| lock | DoorLock | Support for `lock / unlock`. | | sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement`. | | sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` | | switch / remote / input_boolean / script | Switch | All represented as switches. | From bba777df3f6aece9c0e4ef33918de35e38a5c429 Mon Sep 17 00:00:00 2001 From: Elelabs-maintainer <37191432+Elelabs-maintainer@users.noreply.github.com> Date: Mon, 9 Apr 2018 20:37:27 +0300 Subject: [PATCH 068/241] Add 2 new supported hardware platforms (#5135) Raspberry Pi Shield and USB adapter, compatible with Home Assistant and `bellows` python library. Based on Silabs EM35X MCU, compatible with ezsp protocol. --- source/_components/zha.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_components/zha.markdown b/source/_components/zha.markdown index f751532e70..0e769fc6a4 100644 --- a/source/_components/zha.markdown +++ b/source/_components/zha.markdown @@ -26,8 +26,10 @@ There is currently support for the following device types within Home Assistant: Known working ZigBee radios: -- Nortek/GoControl Z-Wave & Zigbee USB Adaptor - Model HUSBZB-1 +- Nortek/GoControl Z-Wave & Zigbee USB Adapter - Model HUSBZB-1 - XBee Series 2C +- [Elelabs ZigBee USB Adapter](https://elelabs.com/products/elelabs_usb_adapter.html) +- [Elelabs ZigBee Raspberry Pi Shield](https://elelabs.com/products/elelabs_zigbee_shield.html) To configure the component, a `zha` section must be present in the `configuration.yaml`, and the path to the serial device for the radio and path to the database which will persist your network data is required. From 85be6ed99c896c16b970c686dc05610a63154151 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Mon, 9 Apr 2018 20:02:21 +0200 Subject: [PATCH 069/241] New Qwikswitch sensors (#5128) New config according to: home-assistant/pull/13622 --- source/_components/qwikswitch.markdown | 27 ++++++++++++++++++++++---- 1 file changed, 23 insertions(+), 4 deletions(-) diff --git a/source/_components/qwikswitch.markdown b/source/_components/qwikswitch.markdown index 516658404a..8889e29fbc 100644 --- a/source/_components/qwikswitch.markdown +++ b/source/_components/qwikswitch.markdown @@ -60,13 +60,32 @@ On some QS Mobile servers button events are only generated for switches added to ### {% linkable_title Qwikswitch Sensors %} -Some Qwikswith devices might support more than one channel per device (i.e. ipmod). The channel can be specified by appending a number to the QS_id. Example sensors configuration: +The sensor configuration is a list of sensors. Each sensor is configured with the following parameters: + +- **name** (*Required*): The sensor name from which the entity_id will be derived. +- **id** (*Required*): A QS_Id +- **type** (*Required*): The Qwikswitch sensor type. These could include: + - imod (up to 6 channels) + - door (single channel) + - qwikcord (Channel1 = CTavg, Channel 2 = CTsum) +- **channel** (*Optional, default=1*): The channel of interest. Refer to type above. + + +Example sensor configuration: ```yaml qwikswitch: ... sensors: - door_sensor: '@0dev01' - door2_sensor: '@0dev02.1' - door3_sensor: '@0dev02.2' + - name: door sensor + id: "@id03" + type: door + - name: Imod 1 sensor + id: "@id02" + channel: 1 + type: imod + - name: Imod 2 sensor + id: "@id02" + channel: 2 + type: imod ``` From e3c6e65f19633b3292d64e1f80c4902fe3ee8d32 Mon Sep 17 00:00:00 2001 From: brkr19 Date: Mon, 9 Apr 2018 13:14:49 -0500 Subject: [PATCH 070/241] Add example file attachment parameters (#5134) --- source/_components/notify.pushover.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_components/notify.pushover.markdown b/source/_components/notify.pushover.markdown index 7e7680db7e..0b4bc520bb 100644 --- a/source/_components/notify.pushover.markdown +++ b/source/_components/notify.pushover.markdown @@ -47,6 +47,11 @@ Example Automation: url: "https://www.home-assistant.io/" sound: pianobar priority: 0 + file: + url: !secret camera_still_image + auth: basic + username: !secret camera_username + password: !secret camera_password ``` Component specific values in the nested `data` section are optional. From 89406e3ea043d6862db0f7222f5f6baf2bb2459c Mon Sep 17 00:00:00 2001 From: DubhAd Date: Mon, 9 Apr 2018 19:15:34 +0100 Subject: [PATCH 071/241] Consistency update (#5136) It was pointed out that everywhere else `entity_id:` is in the `data:` section for `light.turn_on`. Updating the example here to be consistent with that. --- source/_docs/automation/action.markdown | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/source/_docs/automation/action.markdown b/source/_docs/automation/action.markdown index ce9d7c9e05..0df212be7c 100644 --- a/source/_docs/automation/action.markdown +++ b/source/_docs/automation/action.markdown @@ -22,13 +22,12 @@ automation: event: sunset action: service: light.turn_on - entity_id: - - light.kitchen - - light.living_room data: brightness: 150 rgb_color: [255, 0, 0] - + entity_id: + - light.kitchen + - light.living_room automation 2: # Notify me on my mobile phone of an event trigger: From bbb4af9c7b2af3f3deb8a29265f3fb83e477f0e1 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Tue, 10 Apr 2018 20:06:45 +0200 Subject: [PATCH 072/241] Revert "Consistency update (#5136)" This reverts commit 89406e3ea043d6862db0f7222f5f6baf2bb2459c. From a9569af0a42d64329d3eb92f3c236cfca9fb1ab4 Mon Sep 17 00:00:00 2001 From: Franck Nijhof Date: Tue, 10 Apr 2018 20:06:45 +0200 Subject: [PATCH 073/241] Revert "Add example file attachment parameters (#5134)" This reverts commit e3c6e65f19633b3292d64e1f80c4902fe3ee8d32. --- source/_components/notify.pushover.markdown | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/_components/notify.pushover.markdown b/source/_components/notify.pushover.markdown index 0b4bc520bb..7e7680db7e 100644 --- a/source/_components/notify.pushover.markdown +++ b/source/_components/notify.pushover.markdown @@ -47,11 +47,6 @@ Example Automation: url: "https://www.home-assistant.io/" sound: pianobar priority: 0 - file: - url: !secret camera_still_image - auth: basic - username: !secret camera_username - password: !secret camera_password ``` Component specific values in the nested `data` section are optional. From f147350ab457a8405dc4d7b5c5daf6080dacea79 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Tue, 10 Apr 2018 20:56:57 +0200 Subject: [PATCH 074/241] Update addon_config.markdown --- .../developers/hassio/addon_config.markdown | 62 ++++++++++--------- 1 file changed, 32 insertions(+), 30 deletions(-) diff --git a/source/developers/hassio/addon_config.markdown b/source/developers/hassio/addon_config.markdown index cf91e022b4..d249de967e 100644 --- a/source/developers/hassio/addon_config.markdown +++ b/source/developers/hassio/addon_config.markdown @@ -106,37 +106,39 @@ The config for an add-on is stored in `config.json`. } ``` -| Key | Required | Description | -| --- | -------- | ----------- | -| name | yes | Name of the add-on -| version | yes | Version of the add-on -| slug | yes | Slug of the add-on -| description | yes | Description of the add-on -| arch | no | List of supported arch: `armhf`, `aarch64`, `amd64`, `i386`. Default all. -| url | no | Homepage of the addon. Here you can explain the add-ons and options. -| startup | yes | `initialize` will start addon on setup of Hass.io. `system` is for things like databases and not dependent on other things. `services` will start before Home Assistant, while `application` is started afterwards. Finally `once` is for applications that don't run as a daemon. -| webui | no | A URL for web interface of this add-on. Like `http://[HOST]:[PORT:2839]/dashboard`, the port needs the internal port, which will be replaced with the effective port. It is also possible to bind the proto part to a config options with: `[PROTO:option_name]://[HOST]:[PORT:2839]/dashboard` and he lookup if they is True and going to `https`. -| boot | yes | `auto` by system and manual or only `manual` +| Key | Type | Required | Description | +| --- | ---- | -------- | ----------- | +| name | string | yes | Name of the add-on +| version | string | yes | Version of the add-on +| slug | string | yes | Slug of the add-on +| description | string | yes | Description of the add-on +| arch | array | no | List of supported arch: `armhf`, `aarch64`, `amd64`, `i386`. Default all. +| url | url | no | Homepage of the addon. Here you can explain the add-ons and options. +| startup | bool | yes | `initialize` will start addon on setup of Hass.io. `system` is for things like databases and not dependent on other things. `services` will start before Home Assistant, while `application` is started afterwards. Finally `once` is for applications that don't run as a daemon. +| webui | string | no | A URL for web interface of this add-on. Like `http://[HOST]:[PORT:2839]/dashboard`, the port needs the internal port, which will be replaced with the effective port. It is also possible to bind the proto part to a config options with: `[PROTO:option_name]://[HOST]:[PORT:2839]/dashboard` and he lookup if they is True and going to `https`. +| boot | string | yes | `auto` by system and manual or only `manual` | ports | no | Network ports to expose from the container. Format is `"container-port/type": host-port`. -| host_network | no | If that is True, the add-on run on host network. -| host_ipc | no | Default False. Allow to share the IPC namespace with others. -| host_dbus | no | Default False. Map Host dbus service into add-on. -| devices | no | Device list to map into the add-on. Format is: `::`. i.e. `/dev/ttyAMA0:/dev/ttyAMA0:rwm` -| auto_uart | no | Default False. Auto mapping all UART/Serial device from host into add-on. -| hassio_api | no | This add-on can access to Hass.io REST API. It set the host alias `hassio`. -| homeassistant_api | no | This add-on can access to Hass.io Home-Assistant REST API proxy. Use `http://hassio/homeassistant/api`. -| privileged | no | Privilege for access to hardware/system. Available access: `NET_ADMIN`, `SYS_ADMIN`, `SYS_RAWIO`, `SYS_TIME`, `SYS_NICE` -| map | no | List of maps for additional Hass.io folders. Possible values: `config`, `ssl`, `addons`, `backup`, `share`. Defaults to `ro`, which you can change by adding `:rw` to the end of the name. -| environment | no | A dict of environment variable to run add-on. -| audio | no | Boolean. Mark this add-on to use internal an audio system. The available environment variables are `ALSA_INPUT` and `ALSA_OUTPUT` which provide internal information to access alsa. -| gpio | no | Boolean. If this is set to True, `/sys/class/gpio` will map into add-on for access to GPIO interface from kernel. Some library need also `/dev/mem` and `SYS_RAWIO` for read/write access to this device. -| stdin | no | Boolean. If that is enable, you can use the STDIN with Hass.io API. -| legacy | no | Boolean. If the docker image have no hass.io labels, you can enable the legacy mode to use the config data. -| options | yes | Default options value of the add-on -| schema | yes | Schema for options value of the add-on. It can be `False` to disable schema validation and use custom options. -| image | no | For use with Docker Hub. -| timeout | no | Default 10 (second). The timeout to wait until the docker is done or will be killed. -| tmpfs | no | Mount a tmpfs file system in `/tmpfs`. Valide format for this option is : `size=XXXu,uid=N,rw`. Size is mandatory, valid units (`u`) are `k`, `m` and `g` and `XXX` has to be replaced by a number. `uid=N` (with `N` the uid number) and `rw` are optional. +| host_network | bool | no | If that is True, the add-on run on host network. +| host_ipc | bool | no | Default False. Allow to share the IPC namespace with others. +| host_dbus | bool | no | Default False. Map Host dbus service into add-on. +| devices | list | no | Device list to map into the add-on. Format is: `::`. i.e. `/dev/ttyAMA0:/dev/ttyAMA0:rwm` +| auto_uart | bool | no | Default False. Auto mapping all UART/Serial device from host into add-on. +| hassio_api | bool | no | This add-on can access to Hass.io REST API. It set the host alias `hassio`. +| homeassistant_api | bool | no | This add-on can access to Hass.io Home-Assistant REST API proxy. Use `http://hassio/homeassistant/api`. +| privileged | array | no | Privilege for access to hardware/system. Available access: `NET_ADMIN`, `SYS_ADMIN`, `SYS_RAWIO`, `SYS_TIME`, `SYS_NICE` +| apparmor | bool | no | Enable or disable AppArmor support. If it is enable, you can also use custom profiles. +| seccomp | bool | no | Enable or disable Seccomp support. If it is enable, you can also use custom profiles. +| map | list | no | List of maps for additional Hass.io folders. Possible values: `config`, `ssl`, `addons`, `backup`, `share`. Defaults to `ro`, which you can change by adding `:rw` to the end of the name. +| environment | dict | no | A dict of environment variable to run add-on. +| audio | bool | no | Boolean. Mark this add-on to use internal an audio system. The available environment variables are `ALSA_INPUT` and `ALSA_OUTPUT` which provide internal information to access alsa. +| gpio | bool | no | Boolean. If this is set to True, `/sys/class/gpio` will map into add-on for access to GPIO interface from kernel. Some library need also `/dev/mem` and `SYS_RAWIO` for read/write access to this device. +| stdin | bool | no | Boolean. If that is enable, you can use the STDIN with Hass.io API. +| legacy | bool | no | Boolean. If the docker image have no hass.io labels, you can enable the legacy mode to use the config data. +| options | dict | yes | Default options value of the add-on +| schema | dict | yes | Schema for options value of the add-on. It can be `False` to disable schema validation and use custom options. +| image | string | no | For use with Docker Hub. +| timeout | integer | no | Default 10 (second). The timeout to wait until the docker is done or will be killed. +| tmpfs | string | no | Mount a tmpfs file system in `/tmpfs`. Valide format for this option is : `size=XXXu,uid=N,rw`. Size is mandatory, valid units (`u`) are `k`, `m` and `g` and `XXX` has to be replaced by a number. `uid=N` (with `N` the uid number) and `rw` are optional. ### {% linkable_title Options / Schema %} From ffb528dbd64f0f80d03a4044ed44e078aa643d0e Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Tue, 10 Apr 2018 20:57:30 +0200 Subject: [PATCH 075/241] Update addon_config.markdown --- source/developers/hassio/addon_config.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/developers/hassio/addon_config.markdown b/source/developers/hassio/addon_config.markdown index d249de967e..7cf813b63d 100644 --- a/source/developers/hassio/addon_config.markdown +++ b/source/developers/hassio/addon_config.markdown @@ -112,7 +112,7 @@ The config for an add-on is stored in `config.json`. | version | string | yes | Version of the add-on | slug | string | yes | Slug of the add-on | description | string | yes | Description of the add-on -| arch | array | no | List of supported arch: `armhf`, `aarch64`, `amd64`, `i386`. Default all. +| arch | list | no | List of supported arch: `armhf`, `aarch64`, `amd64`, `i386`. Default all. | url | url | no | Homepage of the addon. Here you can explain the add-ons and options. | startup | bool | yes | `initialize` will start addon on setup of Hass.io. `system` is for things like databases and not dependent on other things. `services` will start before Home Assistant, while `application` is started afterwards. Finally `once` is for applications that don't run as a daemon. | webui | string | no | A URL for web interface of this add-on. Like `http://[HOST]:[PORT:2839]/dashboard`, the port needs the internal port, which will be replaced with the effective port. It is also possible to bind the proto part to a config options with: `[PROTO:option_name]://[HOST]:[PORT:2839]/dashboard` and he lookup if they is True and going to `https`. From 061c9bdfa143f67b14eed589d984a5854dbbeebf Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Tue, 10 Apr 2018 20:58:36 +0200 Subject: [PATCH 076/241] Update addon_config.markdown --- source/developers/hassio/addon_config.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/developers/hassio/addon_config.markdown b/source/developers/hassio/addon_config.markdown index 7cf813b63d..47dc50ce43 100644 --- a/source/developers/hassio/addon_config.markdown +++ b/source/developers/hassio/addon_config.markdown @@ -117,7 +117,7 @@ The config for an add-on is stored in `config.json`. | startup | bool | yes | `initialize` will start addon on setup of Hass.io. `system` is for things like databases and not dependent on other things. `services` will start before Home Assistant, while `application` is started afterwards. Finally `once` is for applications that don't run as a daemon. | webui | string | no | A URL for web interface of this add-on. Like `http://[HOST]:[PORT:2839]/dashboard`, the port needs the internal port, which will be replaced with the effective port. It is also possible to bind the proto part to a config options with: `[PROTO:option_name]://[HOST]:[PORT:2839]/dashboard` and he lookup if they is True and going to `https`. | boot | string | yes | `auto` by system and manual or only `manual` -| ports | no | Network ports to expose from the container. Format is `"container-port/type": host-port`. +| ports | dict | no | Network ports to expose from the container. Format is `"container-port/type": host-port`. | host_network | bool | no | If that is True, the add-on run on host network. | host_ipc | bool | no | Default False. Allow to share the IPC namespace with others. | host_dbus | bool | no | Default False. Map Host dbus service into add-on. @@ -125,7 +125,7 @@ The config for an add-on is stored in `config.json`. | auto_uart | bool | no | Default False. Auto mapping all UART/Serial device from host into add-on. | hassio_api | bool | no | This add-on can access to Hass.io REST API. It set the host alias `hassio`. | homeassistant_api | bool | no | This add-on can access to Hass.io Home-Assistant REST API proxy. Use `http://hassio/homeassistant/api`. -| privileged | array | no | Privilege for access to hardware/system. Available access: `NET_ADMIN`, `SYS_ADMIN`, `SYS_RAWIO`, `SYS_TIME`, `SYS_NICE` +| privileged | list | no | Privilege for access to hardware/system. Available access: `NET_ADMIN`, `SYS_ADMIN`, `SYS_RAWIO`, `SYS_TIME`, `SYS_NICE` | apparmor | bool | no | Enable or disable AppArmor support. If it is enable, you can also use custom profiles. | seccomp | bool | no | Enable or disable Seccomp support. If it is enable, you can also use custom profiles. | map | list | no | List of maps for additional Hass.io folders. Possible values: `config`, `ssl`, `addons`, `backup`, `share`. Defaults to `ro`, which you can change by adding `:rw` to the end of the name. From 342b99221d6360e5625dd0018011c2526e06bef0 Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Tue, 10 Apr 2018 21:04:35 +0200 Subject: [PATCH 077/241] Add security infos --- source/developers/hassio/addon_presentation.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/developers/hassio/addon_presentation.markdown b/source/developers/hassio/addon_presentation.markdown index 413dd0489d..e57270040a 100644 --- a/source/developers/hassio/addon_presentation.markdown +++ b/source/developers/hassio/addon_presentation.markdown @@ -47,3 +47,7 @@ A changelog is a file which contains a curated, chronologically ordered list of If you are in need of a guide on keeping a changelog, we would recommend checking the [keep a changelog](http://keepachangelog.com) website. They have developed a standard that is used by many opensource projects around the world. In future versions of Hass.io, the `CHANGELOG.md` file will be displayed in the Home Assistant frontend. + +## {% linkable_title Extended Security %} + +You can use own security profile for you Add-on with Seccomp or AppArmor. Default it is enabled and use the docker default profile. Put `apparmor` or `seccomp.json` file into your Add-on folder and it will load this file as primary profile. From b356bfcc451ff4ed6509da12e1e17ed73cea1a19 Mon Sep 17 00:00:00 2001 From: Matthew Garrett Date: Tue, 10 Apr 2018 19:24:31 -0700 Subject: [PATCH 078/241] Add docs for the Eufy component (#5145) * Add docs for the Eufy component * Update version * Update version * Update version --- source/_components/eufy.markdown | 54 ++++++++++++++++++++++++ source/_components/light.eufy.markdown | 19 +++++++++ source/_components/switch.eufy.markdown | 19 +++++++++ source/images/supported_brands/eufy.png | Bin 0 -> 9536 bytes 4 files changed, 92 insertions(+) create mode 100644 source/_components/eufy.markdown create mode 100644 source/_components/light.eufy.markdown create mode 100644 source/_components/switch.eufy.markdown create mode 100644 source/images/supported_brands/eufy.png diff --git a/source/_components/eufy.markdown b/source/_components/eufy.markdown new file mode 100644 index 0000000000..c11870e401 --- /dev/null +++ b/source/_components/eufy.markdown @@ -0,0 +1,54 @@ +--- +layout: page +title: "Eufy" +description: "Instructions on how to integrate Eufy devices into Home Assistant." +date: 2018-05-09 19:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: eufy.png +ha_category: Hub +ha_release: 0.68 +--- + +The `eufy` component is the main component to integrate various [eufy](http://https://www.eufylife.com/) devices with Home Assistant. + +Supported devices will be discovered after the `eufy` component is configured: + +```yaml +# Example configuration.yaml entry +eufy: + username: testuser@domain + password: p4ssw0rd +``` + +where username and password are the ones configured in the EufyHome app. Alternately, Eufy devices that are not discoverable can be statically configured. + +```yaml +eufy: + devices: + - address: 192.168.1.10 + access_token: 1234567890abcdef + type: T1012 + name: Smart Light + - address: 192.168.1.11 + access_token: abcdef1234567890 + type: T1201 + name: Smart Switch +``` + +access_token can be obtained by running: + +``` +curl -H "Content-Type: application/json" -d '{"client_id":"eufyhome-app", "client_Secret":"GQCpr9dSp3uQpsOMgJ4xQ", "email":"USERNAME", "password":"PASSWORD"}' https://home-api.eufylife.com/v1/user/email/login | jq +``` + +replacing USERNAME and PASSWORD with the Eufy username and password. This will give an access_token. Then run: + +``` +curl -H token:TOKEN -H category:Home https://home-api.eufylife.com/v1/device/list/devices-and-groups | jq +``` + +replacing TOKEN with the access_token from the previous command. This will provide the local_code for each device. + diff --git a/source/_components/light.eufy.markdown b/source/_components/light.eufy.markdown new file mode 100644 index 0000000000..773d99f4aa --- /dev/null +++ b/source/_components/light.eufy.markdown @@ -0,0 +1,19 @@ +--- +layout: page +title: "EufyLights" +description: "Instructions on how to integrate Eufy LED lights into Home Assistant." +date: 2018-05-09 19:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: eufy.png +ha_category: Light +ha_iot_class: "Local Polling" +ha_release: 0.68 +--- + +The `eufy` platform allows you to control your [Eufy](http://www.eufylife.com) lights from within Home Assistant. + +They will be automatically discovered if the [Eufy](/components/eufy/) component is enabled. + diff --git a/source/_components/switch.eufy.markdown b/source/_components/switch.eufy.markdown new file mode 100644 index 0000000000..22e56ae38b --- /dev/null +++ b/source/_components/switch.eufy.markdown @@ -0,0 +1,19 @@ +--- +layout: page +title: "EufySwitch" +description: "Instructions on how to integrate Eufy switches into Home Assistant." +date: 2018-05-09 19:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: eufy.png +ha_category: Switch +ha_iot_class: "Local Polling" +ha_release: 0.68 +--- + +The `eufy` platform allows you to control your [Eufy](http://www.eufylife.com) switches from within Home Assistant. + +They will be automatically discovered if the [Eufy](/components/eufy/) component is enabled. + diff --git a/source/images/supported_brands/eufy.png b/source/images/supported_brands/eufy.png new file mode 100644 index 0000000000000000000000000000000000000000..98d647b056864213ec35a89bd7619d1a7a829805 GIT binary patch literal 9536 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 Date: Wed, 11 Apr 2018 06:06:53 -0400 Subject: [PATCH 079/241] Adds attributes table to VeSync wiki (#5151) --- source/_components/switch.vesync.markdown | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/source/_components/switch.vesync.markdown b/source/_components/switch.vesync.markdown index d3b5971636..83041ca78b 100644 --- a/source/_components/switch.vesync.markdown +++ b/source/_components/switch.vesync.markdown @@ -12,7 +12,9 @@ ha_category: Switch ha_release: 0.66 --- -The `vesync` switch platform enabled integration with Etekcity VeSync smart switches. +The `vesync` switch platform enables integration with Etekcity VeSync smart switches. + +VeSync switches are low-cost wifi smart plugs that offer energy monitoring and work with popular voice assistants. To use your VeSync switches, you must first register your switches with the VeSync app. Once registration is complete you must add the following to your `configuration.yaml` file: @@ -20,8 +22,8 @@ To use your VeSync switches, you must first register your switches with the VeSy # Example configuration.yaml entry switch: - platform: vesync - username: username - password: password + username: YOUR_USERNAME + password: YOUR_PASSWORD ``` {% configuration %} @@ -34,3 +36,16 @@ password: required: true type: string {% endconfiguration %} + +### {% linkable_title Exposed Attributes %} + +VeSync switches will expose the following details. + +| Attribute | Description | Example | +| ------------------- | ------------------------------------------------------------------- | --------------- | +| `current_power_w` | The present power consumption of the switch in watts. | 100 | +| `today_energy_kwh` | The kilowatt hours used by the switch during the previous 24 hours. | 0.12 | +| `connection_status` | The connection status of the switch. | online | +| `connection_type` | The connection type of the switch. | wifi | +| `device_type` | The device type of the switch. | wifi-switch-1.3 | +| `model` | The model of the switch. | wifi-switch | From bc0b6a3f43cc2e2eb6664d9d78fcd9959e5eef1c Mon Sep 17 00:00:00 2001 From: Marco Orovecchia Date: Thu, 12 Apr 2018 09:27:08 +0200 Subject: [PATCH 080/241] Rename light platform from aurora to nanoleaf_aurora (#5158) --- source/_components/light.nanoleaf_aurora.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.nanoleaf_aurora.markdown b/source/_components/light.nanoleaf_aurora.markdown index 074bd1c77f..4f066dc7b2 100644 --- a/source/_components/light.nanoleaf_aurora.markdown +++ b/source/_components/light.nanoleaf_aurora.markdown @@ -21,7 +21,7 @@ To enable the Aurora lights, add the following lines to your `configuration.yaml ```yaml # Example configuration.yaml entry light: - - platform: aurora + - platform: nanoleaf_aurora host: 192.168.1.10 token: xxxxxxxxxxxxxxxxxxxxx ``` From 97525ba3eba6cb08d3478a12792bd346962205ae Mon Sep 17 00:00:00 2001 From: DubhAd Date: Thu, 12 Apr 2018 12:38:03 +0100 Subject: [PATCH 081/241] Moved the Python warning (#5157) Moved the Python version warning to the top of the page, and made it a warning --- source/_docs/installation/synology.markdown | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/source/_docs/installation/synology.markdown b/source/_docs/installation/synology.markdown index 808a4e77de..454dcd8858 100644 --- a/source/_docs/installation/synology.markdown +++ b/source/_docs/installation/synology.markdown @@ -10,6 +10,10 @@ footer: true redirect_from: /getting-started/installation-synology/ --- +

+Synology only provide Python 3.5.1, which is not compatible with Home Assistant 0.65.0 or later. Until Synology offer an updated version of Python, Home Assistant 0.64 is the most recent version that will be able to be installed. You can manually specify the version of Home Assistant to install, for example to install version 0.64.3 you would do `./python3 -m pip install homeassistant==0.64.3` +

+ There are 2 alternatives, when using Home Assistant on Synology NAS: 1. using Docker 2. directly running on DSM @@ -26,7 +30,7 @@ Running these commands will: Using the Synology webadmin: - - Install python3 using the Synology Package Center (be aware, this provides 3.5.1, which is not compatible with Home Assistant 0.65.0 or later) + - Install python3 using the Synology Package Center - Create homeassistant user and add to the "users" group SSH onto your synology & login as admin or root @@ -51,16 +55,12 @@ Install PIP (Python's package management system) # ./python3 -m ensurepip ``` -Use PIP to install Homeassistant package +Use PIP to install Homeassistant package 0.64.3 ```bash -# ./python3 -m pip install homeassistant +# ./python3 -m pip install homeassistant==0.64.3 ``` -

-Until Synology offer an updated version of Python, Home Assistant 0.64 is the most recent version that will be able to be installed. You can manually specify the version of Home Assistant to install, for example to install version 0.64.3 you would do `./python3 -m pip install homeassistant==0.64.3` -

- Create homeassistant config directory & switch to it ```bash From fe1ce5a19b92443c621619e14e6853c6631380d1 Mon Sep 17 00:00:00 2001 From: bvansambeek <35294853+bvansambeek@users.noreply.github.com> Date: Thu, 12 Apr 2018 13:38:42 +0200 Subject: [PATCH 082/241] Tip to use external broker for more stability (#5159) An external broker is more stable, this is something I did not know as a beginner. Especially because the embedded broker has a memory leak. It would have saved me a bunch of time and WAF trust issues if I would have had this piece of knowledge. Issue on memory leak: https://github.com/home-assistant/home-assistant/issues/11594 --- source/_components/mqtt.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/mqtt.markdown b/source/_components/mqtt.markdown index c3f4149342..275cac866e 100644 --- a/source/_components/mqtt.markdown +++ b/source/_components/mqtt.markdown @@ -33,6 +33,10 @@ mqtt: broker: IP_ADDRESS_BROKER ``` +

+The minimal setup uses the embedded MQTT broker, however a separate broker is advised for more stability. +

+ ## {% linkable_title Additional features %} - [Certificate](/docs/mqtt/certificate/) From 15aabd066cbf9e0edf85a8d657361c736aac36be Mon Sep 17 00:00:00 2001 From: Yonsm Date: Thu, 12 Apr 2018 21:02:03 +0800 Subject: [PATCH 083/241] Add CO2/PM2.5/Light sensors in HomeKit (#5146) * Add CO2/PM2.5/Light sensors in HomeKit * Added temperature and humidity device classes --- source/_components/homekit.markdown | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index d3ee4c773f..b752f52622 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -199,8 +199,11 @@ The following components are currently supported: | cover | WindowCovering | All covers that support `set_cover_position`. | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | | lock | DoorLock | Support for `lock / unlock`. | -| sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement`. | -| sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` | +| sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement` or `temperature` as their `device_class`. | +| sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` or `humidity` as their `device_class`. | +| sensor | AirQualitySensor | All sensors that have `pm25` as part of their `entity_id` or `pm25` as their `device_class` | +| sensor | CarbonDioxideSensor | All sensors that have `co2` as part of their `entity_id` or `co2` as their `device_class` | +| sensor | LightSensor | All sensors that have `lm`/`lux` as their `unit_of_measurement` or `light` as their `device_class` | | switch / remote / input_boolean / script | Switch | All represented as switches. | From ee8090a9e178c0cfea1a2ee73468a8ef49c7f070 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 12 Apr 2018 09:53:42 -0400 Subject: [PATCH 084/241] Add blog post about Ubiquiti --- ...04-12-ubiquiti-and-home-assistant.markdown | 37 ++++++++++++++++++ .../paulus.jpg | Bin 0 -> 73854 bytes 2 files changed, 37 insertions(+) create mode 100644 source/_posts/2018-04-12-ubiquiti-and-home-assistant.markdown create mode 100644 source/images/blog/2018-04-ubiquiti-and-home-assistant/paulus.jpg diff --git a/source/_posts/2018-04-12-ubiquiti-and-home-assistant.markdown b/source/_posts/2018-04-12-ubiquiti-and-home-assistant.markdown new file mode 100644 index 0000000000..045f30c196 --- /dev/null +++ b/source/_posts/2018-04-12-ubiquiti-and-home-assistant.markdown @@ -0,0 +1,37 @@ +--- +layout: post +title: "Home Assistant 🤝 Ubiquiti Networks" +description: "Ubiquiti Networks has hired Paulus Schoutsen, the founder of Home Assistant, to support Home Assistant’s goals of making Home Assistant easier to configure for users, improving the integration with device makers and making it easier to create, maintain and evolve integrations." +date: 2018-04-12 00:01:00 +date_formatted: "April 12, 2018" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Announcements +og_image: /images/blog/2018-04-ubiquiti-and-home-assistant/paulus.jpg +--- + +TL;DR: Ubiquiti Networks has hired Paulus Schoutsen, the founder of Home Assistant, to support Home Assistant’s goals of making Home Assistant easier to configure for users, improving the integration with device makers and making it easier to create, maintain and evolve integrations. + +Home Assistant is an open source project that thus far has been run by people in their spare time. In the last four and a half years it has grown from just me building a tiny framework with a handful of integrations to having our own operating system, over a 1000 integrations, superb performance, contributions by over 900 people, and our main Docker image has been pulled over 10 million times! + +Observing this growth and passionate community, Ubiquiti Networks approached us. + +Ubiquiti Networks currently focuses on 3 main technologies: high-capacity distributed Internet access, unified information technology, and next-gen consumer electronics for home and personal use. Their enterprise quality combined with their affordability has made them very popular among our users. They also share another passion of ours: trying to avoid clouds. Take for example their [UniFi Video] IP surveillance solution: it is a completely local hosted solution. + +They recognize great potential in Home Assistant becoming the defacto platform for the home: fast, open source and local. They also want to deepen the integration of Ubiquiti Networks products in Home Assistant and may even support hosting Home Assistant instances on their hardware. + +And so we have agreed that I (Paulus, founder Home Assistant) will join Ubiquiti Networks as a full time employee to focus on growing Home Assistant. I’ll now be able to devote my full energy to making Home Assistant easier to configure for users, improving the integration with device makers and making it easier to create, maintain and evolve integrations. + +Ubiquiti Networks will not acquire any ownership of Home Assistant. We will remain an independent and open source project, just improving faster than ever with the support of Ubiquiti Networks. + +I’m very excited about this opportunity and 2018 will be a really really great year for Home Assistant! + +

+ Photo of Paulus, the founder of Home Assistant, standing in front of a Ubiquiti Networks logo wearing a Home Assistant t-shirt. + Paulus Schoutsen, founder of Home Assistant, at the NYC Ubiquiti office. +

+ +[UniFi Video]: https://www.ubnt.com/unifi-video/unifi-video-camera-g3/#unifi-video-camera-hybrid-technology diff --git a/source/images/blog/2018-04-ubiquiti-and-home-assistant/paulus.jpg b/source/images/blog/2018-04-ubiquiti-and-home-assistant/paulus.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2a4e3d885f8c8cf7b70981ad5ec259f9f34d17a1 GIT binary patch literal 73854 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 Date: Thu, 12 Apr 2018 10:59:10 -0400 Subject: [PATCH 085/241] Updated spelling dedicate to dedicated Spelling mistake. --- source/_components/device_tracker.unifi.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.unifi.markdown b/source/_components/device_tracker.unifi.markdown index 5ef8d4edc7..e941066770 100644 --- a/source/_components/device_tracker.unifi.markdown +++ b/source/_components/device_tracker.unifi.markdown @@ -80,7 +80,7 @@ The Unifi controller allows you to create multiple users on it besides the main The Unifi controller can either be a dedicated hardware device (Unifi's cloud key), or as software any Linux system. If you run the the Unifi controller on the same operating system as Home Assistant there may be conflicts in ports if you have the MQTT component as well. -It is recommended that you run the Unifi controller in a dedicate virtual machine to avoid that situation. +It is recommended that you run the Unifi controller in a dedicated virtual machine to avoid that situation. ### {% linkable_title Troubleshooting and Time Synchronization %} From e4c97ce3226c3d94a924daf5bf7677ddeeb272db Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Thu, 12 Apr 2018 17:01:11 +0200 Subject: [PATCH 086/241] Update addon_config.markdown --- source/developers/hassio/addon_config.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/developers/hassio/addon_config.markdown b/source/developers/hassio/addon_config.markdown index 47dc50ce43..bc4870f862 100644 --- a/source/developers/hassio/addon_config.markdown +++ b/source/developers/hassio/addon_config.markdown @@ -130,7 +130,7 @@ The config for an add-on is stored in `config.json`. | seccomp | bool | no | Enable or disable Seccomp support. If it is enable, you can also use custom profiles. | map | list | no | List of maps for additional Hass.io folders. Possible values: `config`, `ssl`, `addons`, `backup`, `share`. Defaults to `ro`, which you can change by adding `:rw` to the end of the name. | environment | dict | no | A dict of environment variable to run add-on. -| audio | bool | no | Boolean. Mark this add-on to use internal an audio system. The available environment variables are `ALSA_INPUT` and `ALSA_OUTPUT` which provide internal information to access alsa. +| audio | bool | no | Boolean. Mark this add-on to use internal an audio system. The ALSA configuration for this add-on will be mount automatic. | gpio | bool | no | Boolean. If this is set to True, `/sys/class/gpio` will map into add-on for access to GPIO interface from kernel. Some library need also `/dev/mem` and `SYS_RAWIO` for read/write access to this device. | stdin | bool | no | Boolean. If that is enable, you can use the STDIN with Hass.io API. | legacy | bool | no | Boolean. If the docker image have no hass.io labels, you can enable the legacy mode to use the config data. From 3876353d689cff79d1c81d8225272d5d23ade879 Mon Sep 17 00:00:00 2001 From: Matthew Rollings Date: Thu, 12 Apr 2018 17:07:56 +0100 Subject: [PATCH 087/241] Seconds should be milliseconds The documentation said seconds instead of milliseconds --- source/_components/vacuum.xiaomi_miio.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/vacuum.xiaomi_miio.markdown b/source/_components/vacuum.xiaomi_miio.markdown index 51fd5dd9c8..c8f9f7c872 100644 --- a/source/_components/vacuum.xiaomi_miio.markdown +++ b/source/_components/vacuum.xiaomi_miio.markdown @@ -81,7 +81,7 @@ Remote control the robot. Please ensure you first set it in remote control mode | `entity_id` | yes | Only act on specific robot; default targets all | | `velocity` | no | Speed: between -0.29 and 0.29 | | `rotation` | no | Rotation: between -179 degrees and 179 degrees | -| `duration` | no | The number of seconds that the robot should move for | +| `duration` | no | The number of milliseconds that the robot should move for | ### {% linkable_title Service `vacuum.xiaomi_remote_control_move_step` %} @@ -92,7 +92,7 @@ Enter remote control mode, make one move, stop, and exit remote control mode. | `entity_id` | yes | Only act on specific robot; default targets all | | `velocity` | no | Speed: between -0.29 and 0.29. | | `rotation` | no | Rotation: between -179 degrees and 179 degrees. | -| `duration` | no | The number of seconds that the robot should move for | +| `duration` | no | The number of milliseconds that the robot should move for | ## {% linkable_title Attributes %} From 96c997b7e19f1246192d2ad2b8f13a8f7fcaeece Mon Sep 17 00:00:00 2001 From: Mark Coombes Date: Thu, 12 Apr 2018 12:25:35 -0400 Subject: [PATCH 088/241] Add support for Garage Doors in HomeKit (#5155) --- source/_components/homekit.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index b752f52622..42b3180a00 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -196,6 +196,7 @@ The following components are currently supported: | alarm_control_panel | SecuritySystem | All security systems. | | binary_sensor | Sensor | Support for `CO2`, `Gas`, `Moisture`, `Motion`, `Occupancy`, `Opening` and `Smoke` device classes. Defaults to the `Occupancy` device class for everything else. | | climate | Thermostat | All climate devices. | +| cover | GarageDoorOpener | All covers that support `open` and `close` and have `garage` as their `device_class`. | | cover | WindowCovering | All covers that support `set_cover_position`. | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | | lock | DoorLock | Support for `lock / unlock`. | From b8870424cd425799e9c6c0a34754f982324cd2a0 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 12 Apr 2018 20:20:23 +0200 Subject: [PATCH 089/241] Update titles --- source/_components/vacuum.markdown | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/source/_components/vacuum.markdown b/source/_components/vacuum.markdown index 8ec0a442ac..c626a39934 100644 --- a/source/_components/vacuum.markdown +++ b/source/_components/vacuum.markdown @@ -27,7 +27,7 @@ Available services: `turn_on`, `turn_off`, `start_pause`, `stop`, `return_to_hom Before calling one of these services, make sure your botvac platform supports it. -#### {% linkable_title Service `vacuum/turn_on` %} +#### {% linkable_title Service `vacuum.turn_on` %} Start a new cleaning task. @@ -35,7 +35,7 @@ Start a new cleaning task. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/turn_off` %} +#### {% linkable_title Service `vacuum.turn_off` %} Stop the current cleaning task and return to the dock. @@ -43,7 +43,7 @@ Stop the current cleaning task and return to the dock. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/start_pause` %} +#### {% linkable_title Service `vacuum.start_pause` %} Start, pause or resume a cleaning task. @@ -51,7 +51,7 @@ Start, pause or resume a cleaning task. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/stop` %} +#### {% linkable_title Service `vacuum.stop` %} Stop the current activity of the botvac. @@ -59,7 +59,7 @@ Stop the current activity of the botvac. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/return_to_home` %} +#### {% linkable_title Service `vacuum.return_to_home` %} Tell the botvac to return home. @@ -67,7 +67,7 @@ Tell the botvac to return home. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/locate` %} +#### {% linkable_title Service `vacuum.locate` %} Locate the vacuum cleaner robot. @@ -75,7 +75,7 @@ Locate the vacuum cleaner robot. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/clean_spot` %} +#### {% linkable_title Service `vacuum.clean_spot` %} Tell the vacuum cleaner to do a spot clean-up. @@ -83,7 +83,7 @@ Tell the vacuum cleaner to do a spot clean-up. |---------------------------|----------|-------------------------------------------------------| | `entity_id` | yes | Only act on specific botvac. Else targets all. | -#### {% linkable_title Service `vacuum/set_fanspeed` %} +#### {% linkable_title Service `vacuum.set_fanspeed` %} Set the fan speed of the botvac. The `fanspeed` can be a label, as `balanced` or `turbo`, or be a number; it depends on the `vacuum` platform. @@ -92,7 +92,7 @@ Set the fan speed of the botvac. The `fanspeed` can be a label, as `balanced` or | `entity_id` | yes | Only act on specific botvac. Else targets all. | | `fanspeed` | no | Platform dependent vacuum cleaner fan speed, with speed steps, like 'medium', or by percentage, between 0 and 100. | -#### {% linkable_title Service `vacuum/send_command` %} +#### {% linkable_title Service `vacuum.send_command` %} Send a platform-specific command to the vacuum cleaner. From c962dee84d80da22715abaf2e9367e7ab2ff5fe1 Mon Sep 17 00:00:00 2001 From: DubhAd Date: Thu, 12 Apr 2018 21:06:56 +0100 Subject: [PATCH 090/241] Added further notes about dialout group (#5163) Added note about checking the account is in the dialout group, and how to add it if not Added note about the device path being an example --- source/_docs/z-wave/installation.markdown | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/source/_docs/z-wave/installation.markdown b/source/_docs/z-wave/installation.markdown index b637ba981f..b3fc38d817 100644 --- a/source/_docs/z-wave/installation.markdown +++ b/source/_docs/z-wave/installation.markdown @@ -205,7 +205,7 @@ The first run after adding a device is when the `zwave` component will take time ### {% linkable_title Component could not be set up %} -Sometimes the device may not be accessible and you'll get an error message upon startup about not being able to set up Z-Wave. Run the following command for your device path: +Sometimes the device may not be accessible and you'll get an error message upon startup about not being able to set up Z-Wave. Run the following command for your device path (here we're using `/dev/ttyAMA0` for our Razberry board): ```bash $ ls -l /dev/ttyAMA0 @@ -224,6 +224,18 @@ $ sudo chgrp dialout /dev/ttyAMA0 $ sudo chmod g+rw /dev/ttyAMA0 ``` +Check too that the account you're running Home Assistant as is in the `dialout` group. For instance, if you're using `homeassistant`: + +```bash +$ groups homeassistant +``` + +That should include `dialout`, if it doesn't then: + +```bash +$ sudo usermod -G dialout homeassistant +``` + ### {% linkable_title Device path changes %} If your device path changes when you restart, see [this guide](http://hintshop.ludvig.co.nz/show/persistent-names-usb-serial-devices/) on fixing it. From 34a0ade3f7f2ef9014dc4d7d6fdb58c3381b509c Mon Sep 17 00:00:00 2001 From: Mark Coombes Date: Fri, 13 Apr 2018 03:02:59 -0400 Subject: [PATCH 091/241] Add deCONZ daylight sensor (#5028) * Add deCONZ daylight sensor * :pencil2: Minor changes * :ambulance: Fixes build issue * :ambulance: Fixes incorrect tag --- source/_components/sensor.deconz.markdown | 25 +++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/source/_components/sensor.deconz.markdown b/source/_components/sensor.deconz.markdown index 6844c88d83..46dad20c0e 100644 --- a/source/_components/sensor.deconz.markdown +++ b/source/_components/sensor.deconz.markdown @@ -43,3 +43,28 @@ Entity ids will be sensor.device_name, where device_name is defined in deCONZ. S - Xiaomi Smart Home Wireless Switch - Temperature Sensor - Xiaomi Temperature/Humidity Sensor + +#### {% linkable_title deCONZ Daylight Sensor %} + +The deCONZ Daylight sensor is a special sensor built into the deCONZ software since version 2.05.12. It is represented in Home Assistant as a sensor called sensor.daylight. The sensor's state value is a string corresponding to the phase of daylight (descriptions below taken from https://github.com/mourner/suncalc, on which the deCONZ implementation is based): + +| Sensor State | Description | +|--------------|-------------| +| sunrise_start | sunrise (top edge of the sun appears on the horizon) | +| sunrise_end | sunrise ends (bottom edge of the sun touches the horizon) | +| golden_hour_1 | morning golden hour (soft light, the best time for photography) | +| solar_noon | solar noon (sun is in the highest position) | +| golden_hour_2 | evening golden hour | +| sunset_start | sunset starts (bottom edge of the sun touches the horizon) | +| sunset_end | sunset (sun disappears below the horizon, evening civil twilight starts) | +| dusk | dusk (evening nautical twilight starts) | +| nautical_dusk | nautical dusk (evening astronomical twilight starts) | +| night_start | night starts (dark enough for astronomical observations) | +| nadir | nadir (darkest moment of the night, the sun is in the lowest position) | +| night_end | night ends (morning astronomical twilight starts) | +| nautical_dawn | nautical dawn (morning nautical twilight starts) | +| dawn | dawn (morning nautical twilight ends, morning civil twilight starts) | + +The sensor also has an attribute called "daylight" that has the value `true` when the sensor's state is `golden_hour_1`, `solar_noon`, or `golden_hour_2`, and `false` otherwise. + +These states can be used in automations as a trigger (e.g., trigger when a certain phase of daylight starts or ends) or condition (e.g., trigger only if in a certain phase of daylight). From ed630d4b84f7cdc8df4f0733c04dcaf928cfe2fd Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 13 Apr 2018 17:58:21 -0400 Subject: [PATCH 092/241] Release blog post for 0.67 --- source/_components/folder_watcher.markdown | 4 +- source/_components/sensor.qwikswitch.markdown | 18 +++++ source/_components/sensor.tradfri.markdown | 16 +++++ source/_posts/2018-04-14-release-67.markdown | 63 ++++++++++++------ .../images/blog/2018-04-0.67/components.png | Bin 0 -> 37575 bytes 5 files changed, 77 insertions(+), 24 deletions(-) create mode 100644 source/_components/sensor.qwikswitch.markdown create mode 100644 source/_components/sensor.tradfri.markdown create mode 100644 source/images/blog/2018-04-0.67/components.png diff --git a/source/_components/folder_watcher.markdown b/source/_components/folder_watcher.markdown index ba97e44c63..e7489514e8 100644 --- a/source/_components/folder_watcher.markdown +++ b/source/_components/folder_watcher.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "folder watcher" +title: "Folder Watcher" description: "Component for monitoring changes within the filesystem." date: 2018-03-11 14:00 sidebar: true @@ -32,7 +32,7 @@ folder: patterns: description: Pattern matching to apply required: false - default: "*" + default: "*" type: string {% endconfiguration %} diff --git a/source/_components/sensor.qwikswitch.markdown b/source/_components/sensor.qwikswitch.markdown new file mode 100644 index 0000000000..b2574cdb1d --- /dev/null +++ b/source/_components/sensor.qwikswitch.markdown @@ -0,0 +1,18 @@ +--- +layout: page +title: "QwikSwitch Sensor" +description: "Instructions on how to integrate Qwikswitch dimmers and relays as sensors into Home Assistant." +date: 2016-05-04 00:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: qwikswitch.png +ha_category: Sensor +ha_iot_class: "Local Push" +ha_release: "0.67" +--- + +The `qwikswitch` sensor platform allows you to control your [QwikSwitch](http://www.qwikswitch.co.za/) relays and dimmers as sensors from within Home Assistant. + +The platform is configured through the [QwikSwitch component](/components/qwikswitch/). diff --git a/source/_components/sensor.tradfri.markdown b/source/_components/sensor.tradfri.markdown new file mode 100644 index 0000000000..fb78480fb1 --- /dev/null +++ b/source/_components/sensor.tradfri.markdown @@ -0,0 +1,16 @@ +--- +layout: page +title: "IKEA Trådfri sensors" +description: "Access and control your ZigBee-based IKEA Trådfri (Tradfri) Sensors." +date: 2017-04-12 22.04 +sidebar: true +comments: false +sharing: true +footer: true +logo: ikea.svg +ha_category: Sensor +ha_iot_class: "Local Polling" +ha_release: 0.67 +--- + +For installation instructions, see [the Trådfri component](/components/tradfri/). diff --git a/source/_posts/2018-04-14-release-67.markdown b/source/_posts/2018-04-14-release-67.markdown index f6d3c285a6..ec16c1d115 100644 --- a/source/_posts/2018-04-14-release-67.markdown +++ b/source/_posts/2018-04-14-release-67.markdown @@ -1,9 +1,9 @@ --- layout: post -title: "0.67: TBD - ALSO UPDATE DATE" -description: "TBD" -date: 2018-04-06 00:01:00 -date_formatted: "April 14, 2018" +title: "0.67: Mastodon, Tahoma switches, Nanoleaf Aurora Light Panels" +description: "Security fixes and performance improvements 😅" +date: 2018-04-13 00:01:00 +date_formatted: "April 13, 2018" author: Paulus Schoutsen author_twitter: balloob comments: true @@ -11,19 +11,22 @@ categories: Release-Notes og_image: /images/blog/2018-04-0.67/components.png --- - + + +Release 0.67 is here! In case you missed [the announcement from yesterday][ann-ubiquiti], Ubiquiti is paying me to write these release notes. Ooooooh yeah. With more time on my hands I'm going to be focusing on major improvements that we have been postponing for a while, first up will be a user system. + +This release includes a security fix. The error log was accessible via the API without requiring authentication in previous releases. Although not a leak on it's own, combined with a faulty component that would log sensitive information to the error log could lead to that being exposed (we don't know of any component that does this). Thanks to [Matt Hamilton](https://github.com/Eriner) for disclosing this issue to us. ## {% linkable_title New Platforms %} -- Qwikswitch async refactor & sensor ([@kellerza] - [#13509]) ([qwikswitch docs]) ([light.qwikswitch docs]) ([sensor.qwikswitch docs]) ([switch.qwikswitch docs]) (new-platform) -- Adds folder_watcher component ([@robmarkcole] - [#12918]) ([watchdog_file_watcher docs]) (new-platform) +- Adds folder_watcher component ([@robmarkcole] - [#12918]) ([folder_watcher docs]) (new-platform) - Add FreeDNS component ([@bdurrer] - [#13526]) ([freedns docs]) (new-platform) - Google Maps location sharing device tracker ([@michaelarnauts] - [#12301]) ([device_tracker.google_maps docs]) (new-platform) - Added Waze travel time sensor ([@Myrddyn1] - [#12387]) ([sensor.waze_travel_time docs]) (new-platform) - Added switch component to Amcrest IP Camera. ([@adpriebe] - [#12992]) ([amcrest docs]) ([switch.amcrest docs]) (new-platform) - Add mastodon ([@fabaff] - [#13441]) ([notify docs]) (new-platform) - Tahoma switches ([@ikucuze] - [#13636]) ([tahoma docs]) ([switch.tahoma docs]) (new-platform) -- Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.aurora docs]) (new-platform) +- Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.nanoleaf_aurora docs]) (new-platform) ## {% linkable_title If you need help... %} @@ -40,7 +43,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Update to new "b2vapi" of BMW ConnectedDrive ([@ChristianKuehnel] - [#13305]) ([bmw_connected_drive docs]) ([binary_sensor.bmw_connected_drive docs]) ([lock.bmw_connected_drive docs]) ([sensor.bmw_connected_drive docs]) (breaking change) - Remove MercedesME component ([@ReneNulschDE] - [#13538]) ([device_tracker docs]) ([mercedesme docs]) ([binary_sensor.mercedesme docs]) ([sensor.mercedesme docs]) (breaking change) - Channel up and down for webostv ([@stephanerosi] - [#13624]) ([media_player.webostv docs]) (breaking change) -- Add media type separation for video/movie ([@Tadly] - [#13612]) (breaking change) +- Add media type separation for video/movie ([@tadly] - [#13612]) (breaking change) - Added ENTITY_ID_FORMAT import and set entity_id in __init__ ([@timmo001] - [#13642]) ([switch.broadlink docs]) (breaking change) ## {% linkable_title All changes %} @@ -58,7 +61,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Upgrade aiohttp to 3.1.0 ([@fabaff] - [#13451]) - Qwikswitch async & updates ([@kellerza] - [#12641]) ([qwikswitch docs]) ([light.qwikswitch docs]) ([switch.qwikswitch docs]) - Make Telnet Switch value template optional ([@DanNixon] - [#13433]) ([switch.telnet docs]) -- Update yeelightsunflower to 0.0.10 ([@lindsaymarkwawrd] - [#13448]) +- Update yeelightsunflower to 0.0.10 ([@lindsaymarkward] - [#13448]) - Add more info to issue template ([@c727] - [#12955]) - [RFC] Update issue template ([@amelchio] - [#12989]) - Update total_connect_client to 0.17 for Honeywell L5100-WiFi Support ([@phileaton] - [#13473]) ([alarm_control_panel.totalconnect docs]) @@ -71,7 +74,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Fix typos and update link (fixes #13520) ([@fabaff] - [#13529]) - Tradfri - unique_id's and color_temp support for rgb-bulbs ([@NovapaX] - [#13531]) ([light.tradfri docs]) - Qwikswitch async refactor & sensor ([@kellerza] - [#13509]) ([qwikswitch docs]) ([light.qwikswitch docs]) ([sensor.qwikswitch docs]) ([switch.qwikswitch docs]) (new-platform) -- Adds folder_watcher component ([@robmarkcole] - [#12918]) ([watchdog_file_watcher docs]) (new-platform) +- Adds folder_watcher component ([@robmarkcole] - [#12918]) ([folder_watcher docs]) (new-platform) - Update rflink to 0.0.37 ([@olskar] - [#12603]) ([rflink docs]) - Added file path validity checks to file sensor ([@FrederikBolding] - [#12505]) ([sensor.file docs]) - Allow for overriding the DoorBird push notification URL in configuration ([@Klikini] - [#13268]) ([doorbird docs]) @@ -88,8 +91,8 @@ Experiencing issues introduced by this release? Please report them in our [issue - Add support for Canary Flex ([@snjoetw] - [#13280]) ([canary docs]) ([sensor.canary docs]) - Fixes #12758. Try other cameras even if one fails to initialize ([@PhracturedBlue] - [#13276]) ([amcrest docs]) - Added HassOpenCover and HassCloseCover intents ([@tschmidty69] - [#13372]) ([conversation docs]) ([cover docs]) -- rfxtrx lib 0.22.0 ([@danielhiversen] - [#13576]) ([rfxtrx docs]) -- xiaomi lib upgrade ([@danielhiversen] - [#13577]) ([xiaomi_aqara docs]) +- rfxtrx lib 0.22.0 ([@Danielhiversen] - [#13576]) ([rfxtrx docs]) +- xiaomi lib upgrade ([@Danielhiversen] - [#13577]) ([xiaomi_aqara docs]) - Remove MercedesME component ([@ReneNulschDE] - [#13538]) ([device_tracker docs]) ([mercedesme docs]) ([binary_sensor.mercedesme docs]) ([sensor.mercedesme docs]) (breaking change) - Added Waze travel time sensor ([@Myrddyn1] - [#12387]) ([sensor.waze_travel_time docs]) (new-platform) - Added switch component to Amcrest IP Camera. ([@adpriebe] - [#12992]) ([amcrest docs]) ([switch.amcrest docs]) (new-platform) @@ -97,7 +100,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Add mastodon ([@fabaff] - [#13441]) ([notify docs]) (new-platform) - Added support for requesting RSSI values from Bluetooth devices ([@FrederikBolding] - [#12458]) ([device_tracker.bluetooth_tracker docs]) - Fix mysensors update callback ([@MartinHjelmare] - [#13602]) ([mysensors docs]) -- Broadlink ([@danielhiversen] - [#13585]) ([sensor.broadlink docs]) ([switch.broadlink docs]) +- Broadlink ([@Danielhiversen] - [#13585]) ([sensor.broadlink docs]) ([switch.broadlink docs]) - Fix IMAP email message_data ([@zhaokoh] - [#13606]) ([sensor.imap_email_content docs]) - Re-add group polling as a fallback for observation ([@lwis] - [#13613]) ([light.tradfri docs]) - Unflake folder watcher test ([@balloob] - [#13569]) @@ -112,7 +115,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Xiaomi Mi WiFi Repeater 2 integration as device tracker ([@syssi] - [#13521]) - Upgrade youtube_dl to 2018.04.03 ([@fabaff] - [#13647]) ([media_extractor docs]) - Update plex.py ([@chronm] - [#13659]) ([sensor.plex docs]) -- Always enable config entries & remove config_entry_example ([@balloob] - [#13663]) ([config docs]) ([config_entry_example docs]) +- Always enable config entries & remove config_entry_example ([@balloob] - [#13663]) ([config docs]) - Add missing service docs for hs_color ([@armills] - [#13667]) - Add regex functions as templating helpers ([@mountainsandcode] - [#13631]) - Channel up and down for webostv ([@stephanerosi] - [#13624]) ([media_player.webostv docs]) (breaking change) @@ -129,7 +132,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Fix asuswrt ap mode failure ([@shuaiger] - [#13693]) ([device_tracker docs]) - Support color temperature in Homekit ([@morberg] - [#13658]) ([homekit docs]) - Remove unused CONF_WATCHERS ([@robmarkcole] - [#13678]) ([folder_watcher docs]) -- Add media type separation for video/movie ([@Tadly] - [#13612]) (breaking change) +- Add media type separation for video/movie ([@tadly] - [#13612]) (breaking change) - Adding configration to disable ip address as a requirement Fixes: #13399 ([@PlanetJ] - [#13692]) ([device_tracker docs]) - Tahoma switches ([@ikucuze] - [#13636]) ([tahoma docs]) ([switch.tahoma docs]) (new-platform) - Send XY color for non-osram hue bulbs ([@armills] - [#13665]) ([light.hue docs]) @@ -137,8 +140,14 @@ Experiencing issues introduced by this release? Please report them in our [issue - Enable autodiscovery for mqtt cameras ([@jmtatsch] - [#13697]) ([mqtt docs]) ([camera.mqtt docs]) - Added ENTITY_ID_FORMAT import and set entity_id in __init__ ([@timmo001] - [#13642]) ([switch.broadlink docs]) (breaking change) - Fix #10175 ([@pschmitt] - [#13713]) ([media_player.liveboxplaytv docs]) -- Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.aurora docs]) (new-platform) +- Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.nanoleaf_aurora docs]) (new-platform) - Added gogogate2 cover ([@dlbroadfoot] - [#13467]) +- Remove vendor lookup for mac addresses ([@balloob] - [#13788]) ([device_tracker docs]) +- iglo hs color fix ([@armills] - [#13808]) ([light.iglo docs]) +- Fix too green color conversion ([@amelchio] - [#13828]) +- Rename from aurora light to nanoleaf_aurora ([@Oro] - [#13831]) ([light.nanoleaf_aurora docs]) +- Channel up/down for LiveTV and next/previous for other apps ([@stephanerosi] - [#13829]) ([media_player.webostv docs]) +- Add authentication to error log endpoint ([@balloob] - [#13836]) ([api docs]) [#11187]: https://github.com/home-assistant/home-assistant/pull/11187 [#12301]: https://github.com/home-assistant/home-assistant/pull/12301 @@ -234,9 +243,16 @@ Experiencing issues introduced by this release? Please report them in our [issue [#13702]: https://github.com/home-assistant/home-assistant/pull/13702 [#13709]: https://github.com/home-assistant/home-assistant/pull/13709 [#13713]: https://github.com/home-assistant/home-assistant/pull/13713 +[#13788]: https://github.com/home-assistant/home-assistant/pull/13788 +[#13808]: https://github.com/home-assistant/home-assistant/pull/13808 +[#13828]: https://github.com/home-assistant/home-assistant/pull/13828 +[#13829]: https://github.com/home-assistant/home-assistant/pull/13829 +[#13831]: https://github.com/home-assistant/home-assistant/pull/13831 +[#13836]: https://github.com/home-assistant/home-assistant/pull/13836 [@5LICK]: https://github.com/5LICK [@ChristianKuehnel]: https://github.com/ChristianKuehnel [@DanNixon]: https://github.com/DanNixon +[@Danielhiversen]: https://github.com/Danielhiversen [@FrederikBolding]: https://github.com/FrederikBolding [@Kane610]: https://github.com/Kane610 [@Klikini]: https://github.com/Klikini @@ -250,7 +266,6 @@ Experiencing issues introduced by this release? Please report them in our [issue [@PlanetJ]: https://github.com/PlanetJ [@ReneNulschDE]: https://github.com/ReneNulschDE [@Skaronator]: https://github.com/Skaronator -[@Tadly]: https://github.com/Tadly [@adpriebe]: https://github.com/adpriebe [@alandtse]: https://github.com/alandtse [@amelchio]: https://github.com/amelchio @@ -262,7 +277,6 @@ Experiencing issues introduced by this release? Please report them in our [issue [@cdce8p]: https://github.com/cdce8p [@chronm]: https://github.com/chronm [@colinodell]: https://github.com/colinodell -[@danielhiversen]: https://github.com/danielhiversen [@danielperna84]: https://github.com/danielperna84 [@dlbroadfoot]: https://github.com/dlbroadfoot [@fabaff]: https://github.com/fabaff @@ -272,7 +286,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [@ikucuze]: https://github.com/ikucuze [@jmtatsch]: https://github.com/jmtatsch [@kellerza]: https://github.com/kellerza -[@lindsaymarkwawrd]: https://github.com/lindsaymarkwawrd +[@lindsaymarkward]: https://github.com/lindsaymarkward [@lwis]: https://github.com/lwis [@mf-social]: https://github.com/mf-social [@michaelarnauts]: https://github.com/michaelarnauts @@ -288,6 +302,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [@snjoetw]: https://github.com/snjoetw [@stephanerosi]: https://github.com/stephanerosi [@syssi]: https://github.com/syssi +[@tadly]: https://github.com/tadly [@teharris1]: https://github.com/teharris1 [@timmo001]: https://github.com/timmo001 [@titilambert]: https://github.com/titilambert @@ -301,6 +316,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [alarm_control_panel.totalconnect docs]: /components/alarm_control_panel.totalconnect/ [alexa docs]: /components/alexa/ [amcrest docs]: /components/amcrest/ +[api docs]: /components/api/ [binary_sensor.bmw_connected_drive docs]: /components/binary_sensor.bmw_connected_drive/ [binary_sensor.mercedesme docs]: /components/binary_sensor.mercedesme/ [binary_sensor.workday docs]: /components/binary_sensor.workday/ @@ -326,9 +342,11 @@ Experiencing issues introduced by this release? Please report them in our [issue [hue docs]: /components/hue/ [insteon_plm docs]: /components/insteon_plm/ [light docs]: /components/light/ -[light.aurora docs]: /components/light.aurora/ +[light.nanoleaf_aurora docs]: /components/light.nanoleaf_aurora/ [light.hue docs]: /components/light.hue/ +[light.iglo docs]: /components/light.iglo/ [light.mystrom docs]: /components/light.mystrom/ +[light.nanoleaf_aurora docs]: /components/light.nanoleaf_aurora/ [light.qwikswitch docs]: /components/light.qwikswitch/ [light.tradfri docs]: /components/light.tradfri/ [light.xiaomi_miio docs]: /components/light.xiaomi_miio/ @@ -373,6 +391,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [tado docs]: /components/tado/ [tahoma docs]: /components/tahoma/ [tradfri docs]: /components/tradfri/ -[watchdog_file_watcher docs]: /components/watchdog_file_watcher/ +[folder_watcher docs]: /components/folder_watcher/ [xiaomi_aqara docs]: /components/xiaomi_aqara/ [zwave docs]: /components/zwave/ +[ann-ubiquiti]: /blog/2018/04/12/ubiquiti-and-home-assistant/ diff --git a/source/images/blog/2018-04-0.67/components.png b/source/images/blog/2018-04-0.67/components.png new file mode 100644 index 0000000000000000000000000000000000000000..798602b5c1c6536026f88526e17ba566c2ab6ce5 GIT binary patch literal 37575 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 Date: Fri, 13 Apr 2018 17:58:38 -0400 Subject: [PATCH 093/241] Fix release date --- _config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index 401cd89fce..38d26c045e 100644 --- a/_config.yml +++ b/_config.yml @@ -141,7 +141,7 @@ social: current_major_version: 0 current_minor_version: 67 current_patch_version: 0 -date_released: 2018-04-14 +date_released: 2018-04-13 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. From 4a9bd5e72020b3dc8efabada9b199622669315ac Mon Sep 17 00:00:00 2001 From: Mohamad Tarbin Date: Fri, 13 Apr 2018 22:03:57 -0400 Subject: [PATCH 094/241] Adding markdown and imagie for USCIS sensor (#5138) * Adding markdown and imagie for USCIS sensor * Update the markdown * Update sensor.uscis.markdown * Update sensor.uscis.markdown * Update sensor.uscis.markdown * Minor changes --- source/_components/sensor.uscis.markdown | 39 +++++++++++++++++++++++ source/images/supported_brands/uscis.png | Bin 0 -> 7836 bytes 2 files changed, 39 insertions(+) create mode 100644 source/_components/sensor.uscis.markdown create mode 100644 source/images/supported_brands/uscis.png diff --git a/source/_components/sensor.uscis.markdown b/source/_components/sensor.uscis.markdown new file mode 100644 index 0000000000..49d55b0416 --- /dev/null +++ b/source/_components/sensor.uscis.markdown @@ -0,0 +1,39 @@ +--- +layout: page +title: USCIS Sensor +description: "Instructions on how to set up USCIS within Home Assistant." +date: 2018-03-21 08:00 +sidebar: false +comments: false +sharing: true +footer: true +logo: uscis.jpg +ha_category: Sensor +ha_release: 0.68 +ha_iot_class: "Cloud Polling" +--- + +The `uscis` sensor component allows you get updates on your USCIS case using your case/receipt number. The sensor gets the case information from [USCIS Website]( https://egov.uscis.gov/casestatus/landing.do) + +## Example for `configuration.yaml` : + +```yaml +sensor: + - platform: uscis + case_id: YOUR_CASE_NUMBER + name: OPTIONAL_NAME +``` + +{% configuration %} +friendly_name: + description: Name of the sensor in Home Assistant. + required: false + default: USCIS + type: string +case_id: + description: Case/receipt number used to get the case details from USCIS web client. + required: true + type: string +{% endconfiguration %} + +All the data will be fetch from [USCIS](https://egov.uscis.gov/casestatus/mycasestatus.do). diff --git a/source/images/supported_brands/uscis.png b/source/images/supported_brands/uscis.png new file mode 100644 index 0000000000000000000000000000000000000000..2268fb48b11951cd12e73c43eba00c1981484bc2 GIT binary patch literal 7836 zcmb7}MOPdOl!P01*Wff7Jh;2NJHa(TV6?gV#lT!RxJNJC>mLy+J;Z{{CNom2H~ zYjIb%V%1gUFi=TQ0RRAog1ofmf9(IyU}U)el0?U}`ahJZD{IUA$B+M~0D4IPll0Te zdxwmH`e6u-TLrE|QEbiZ^3LC(#Y3g=7Jy}Le#bJuf1O|PxKTnEz$!PscD7+;i`Ko; zIH4=GaX~A({pS9;yl*Y6VruX7#xk`}CZx$DfAr7w<2>Zg%=#&{YkA-7e(MCZbsS28 zIrP76u{|_ZwE!Vk*d@DWR2+*#;_A&QE`-Tm@+fZJ*6qgHyu;4)lsc{Uq3| z%g5OlvBRJ&tZ@i}A!FZcaaw?iaGI=T?pG5Mwdn1O>+4Xbmf!&JM!)D=@AGi?pug`{ zoA>n<*uQt++0|!Lq*cq+-~A!H_Ug}FZectmdvq0R=xrv2U!sN)O}Frhi@Bp&tR;Bh zMGRP0ztf5`KV7kRiR?G0*o?yW(F7ZD!LJ^oCu5d>7A4K6*9 zxD^XbeO~rpeSReo;>UKEli3>ISm3-t#!t)%W5*3Nz#J271a6|`tUKN@3F6D#KY{bU zc4qI@8h>N4Jp_2bpfyP25jnwf`0~?YzV7gG;@Q30>0rPLanVhx!?0%(Wer$;hW7Um{`6kzc$Jzi3GRx`My2C5i(s3H1O zH~$Qp_rrmu&+I26P5I!8X&P=LZ8U{yg}y$e6#mb449Yw=kt}i}Bh!)5v!Px7Dx57W z&O^mMXEBzr=j3D`F>NGDO^7aHt0_1{Ugh#x*q?-2sctSe>%u-{}7RhwK z`v)RwQ(WW;CwxOIGdM=KLZGFnbWnnfLX%Piv$QtB`ZX0E8CA)%`ZvHm>}?aJLn9nu zAP;-mVY7m|P= zA_n0VBJ(65Hxf*ZHrMvCr(-pGHFl!PNg8FE>J!rBey=m0*rmy#J*cl6dJ$(>nkS4T zJg05E(|MML#u%z@sD!ffJdHon(TuGQ`R{%P0h>`wkiEHo^nB@X*aH1x)8Hx8xUX<3oqkcAP(fYu=Ol{s>^r^-BWY#~qhlvDZEU=8C zeO6Hg>6Wn{inz-NC_3{RUi%_11)&sE`S476kRtq^-lj>A6mjBfGikp^z`}iQO$0OFi5LDBEK8Qlje@23n23+ z+Md9jzZp!5!wvNjyE&NC0tyA6W*IJue>c4x2+}wI1)O%{xE2fmNfz$x%P47D%4qCk z>WL!c1gHAPw?BW@GfADUr-JUWpRRl*B1~GYukBkEDQ5G7Fv}j5r|2$*;hKWxT{cMh z5!W~=qSfy}Osi8)*38OHy?8ksG^&~JDwk>th|&$N6{IMi4rzoG$e^JDoK?OQm*)ZW1G~(dh6%p)t50RCas= zq##KnNMz2X{oBPbyqJE#BLCx`mjoKCKpYPFi1+EG>QbVE99P(;%Yi5-?9+QJRdF#h z=~idqX*y)ZV5vI=E%g6A0+C&ydOxh zS?{C5lYQFpdC%xkEK7ZXQ+Sp$ZYpl6gdXwN6^Ah(@dU$*GFweX$uKC8kV2RJS&}K zO<5k6M2KnpWPB%E0RxnS;f^m|WgCX=hFmHR4gHSx>D1IV*Y?QV(d#Fqu%CF6pu1an znJX??aJs^ZDSyT|9Ng5QG|xJXsfyL1{ebPa$uqm^vC@8DyLWSu2rfwWo6se#Ye9gw znHl$kLzPM(v)=VKsNI{^o0Him{jE)`*;Ah8RyJ+Wa|+ksqaOYR2clxk{g0*To&N~e znMS=tW z7&r?Fm3-w1?yGCm8U+t7b-=}-*p4lWs8wZ?D`$g(lsN2xV-EqR-zuC&tjqJKUN;+P3z; z14=nx&hj}2gHmTJ{4k3U@13sN+f9SAO5N3-U{sqC#720SdTa_o$ZkxIc7%F@Uu}rN zg~3!jiZ*cp`B~F<%sO z#P?|)m;UK6|CkzF5HwA$k^wk^rq}}mX6zd!el4e2M0@mwlhIW@Qn<%yx`*5?dZj(?0CFy z5weX;Sy%`+p5IDG9Gyd;n(QaB`snsZ$Q6jfc)vvhGXyDE& z9iO?GIbtuf&`De>Jw^NjCuV?r$AG{=VWlv;GEQ)&udaD6eqqULr&iL%<1Soj#}6m8 z0h}c%7HDLOfDJW6WhD5!LCnh?V(^fhndxH34^bVdpD`IfsT@N+IF>D_IKE_jQFgC4 z`@1joBq)+O@uD(iuLQy5$WH!e)Z-n>^k7(zatFGK@0cU|mV1~xOk)FC@Y&vP$ju^t z&WW+lpNjD$LETdNd|iPjNr-9~-`Qp~^J=_wXe}3<^*za&_B!{xLLodbl}K7ZIjfK` z<}tC5bQ*BGKY#yt_{6jgB7L6y^z$qv2q*TsM>Ey~`E4D|uvWX^m%ZbrTk2Nz5wb2~)P6QUo}I>IS-yDw)75RkZ`ShFxD>9Pu}+}# zjoea&((Cpk8QCW*(B4v_=G<$AYKw^QJ|##kyZtLT;vDVpOlb!PoDyXEmYqxdw&^qU z?B=ZI@R7~Q>&&2sVB&hEtk@*lCQLBJLE>7MN6!kskMKrIj(mK6Zd2-|Ijkl0v+bDh z8;FVX_oYl+`_Z{rM`ORtV!vW41rqewIh&FXarZK<3nar25iY7~%j;CGdo?L0YN0M9 zyyzGgGJbTw?UgOotyRsi0ZFToOG+*zhqZaKXg^*LmOfm)T6bSY9O0>9+ZBmEvmN_A zvL8Ft4LW{0=6E!f9Q0VEnK(}%AQ6tWda^xP{mi@*o&PDI=2(TYA9&jt4;@kad?*;P z=Xa6u`6d3OfzKo8;Y;hQ)T9Ko`7i#AzozFR9<+({`IYRAWw6byQps(Fqr0RVm9g2X zFAx$qHw#su0)NyEZx;RP-rfMj20Lkri0n+Y)*qzX(4pJfGe{&hCYJf%!o)r>z8sOl zEjbQC2ye55QZNzx@%rg*i#jH_lls!Z(diu2 zk6^Yl7_XYSYv1vxvLazia8zOH@b^bTH9ze4oUXcazd*GMir4#aRn=0};<&1w^jdS^ zN_xPxfyRQJp-}|^o27cSXZ@7pF&UVj03}fM^8GGKx65}}B)cNGdv20`y{<`XP5dmJhb5zW$s zn9PowqpW@_(n}2|{YMGk)FRkWI5Oar%98ILSHyM&@QS$7C1s1-?ETLyi3-t$S{M`+ z`0;reml$uNsBHW(=J`pm&O-IH&s36bgtmW*-@#^xpjtw~ z@rM%=n@{9N_!Tk8QDtzkfNF%Xku7aS_8T0rzl>egTwWd54?VJ_rA7}x!xsMVo9Jkv zDvln=iM&MQ&M|%v173!7jr#9O5c+@uT3Z(o^yep9zQ7n5c9Q)wMJ|4i7*a*%DfM9Bb z%v*-?F>=i<#r}++=F1zrZXirRi=0ZPN>m%ro z{LO{|%`B`1%{HDh;qM|t0~Tof>!{z7m=W`%*e-i=_K-dab$DeiZPQg@N`Zhz0ZkAq zKNsgCvI9CIa^xU|QD(i*(Kp$T=8U?5@@R(^)BJ+ew7Dvxw{Ty9n|RM-tn^k##AB;W zlj)=t-kl%iwC*1&^q*5Om}I)@xmDhiC-pp(#vb&J_jCYA0?HjLaw<0ZOGKXbIw3$I)9 zXXozh?XM|6;}gAqRD=}*F-+_G=`+9e7f?DsEx|pt*60}}YpO*dWjClefs?Z2+(vb%`9F2Z5CO#sS;V|Lg(azwbJCi?#yoT5C zUs}Zpu5|gwYU)ptNjneut(0$r@>$hnZy*#~&VtX;&xzulf$h;x4D{Pvt(wD!f(y?oT;o+#O691>{io?ddSH3+io{^M)?40^vYi9l z@M<~4M7TflPnP}xFP#xNy2IFu(r_%{7^_>moI8woC^bdjzZKlrF^M^>HEx^1&|KeUUc56qDZ;$|MLl3}B zsdIYNLGxm%{bLu4;LaDDhq7c3oT%aSaeGqR0h+MZ%6>H+Vhb%~;xH_nMq7e$DdW?vOF``{r=S0oj&oy8uW7*%AwiJ)ukL)n`X)m^PgrXtW{ zUHFS)7>OHP>42?rw;pxx6W$?<&c`qg;zpsr`=ZO;!Q3u;EMKMyo#JBqX%d3`IsmV1WLO0Ztu1HYqJo_pVjg0NMQ=l{q&-ec9L zRU}1ClB3^)sgc7tO3;skTlJD zu^0i(u_Yraa1a0OlLRy8>zs-se`jk@nrn-V4xBbcJJwY^y91nMN`)ccqSr1}iR2IkZYYlr6bQ0Kslfei%*J#tIW5n~&_y{-Sq@rWd z)F7Q+rwD&PbkNlY2ovtYaXI4$Bk^Iv8cS_l-u$kp^}-%HzABXRTN@RWh2k9XRa;XC zk00k6-{>#2Ni;~Ql1QMeHPe3zqs$%G;rC`X@HM^uJvFkX&M%FBo~DR*4PC8*HBCX7 z{;I5w@l{3kiXuFSys2TBw@_4Q^FYy`7$~_ko_b_m4yQ5V96B7qFGCZL4B&h-eD{1_ za}sEqa6A6GjQ6RA%|!qS+DwZ&*G`thyo+Y(awRr8`ra<}$TZ5QsI@glS1XN1E@F5$ z;4&f(BC%*0o<*i9f}l^|`^L#!{aKYt>SOW&+UD&ag@;fb7|w|Cny_Yv=Bz`o(Uf_Q znYZ@kqc#u& z-Xy2wt1omJ9#GoN;yf+~xzoG?pe7TEf!Q_+bOQJoDzbl4rMF|mJga)}SbY{i@M>2) z7jGB^Q8+%BC#!KDSX*ckcbw&2j}|@ed+_gwk10KVSW0c$4c2lKW+ihzJooTQ;#jqU zj60dA=A>A=AU#IKZX#`w^g?)%{RPVq4HDQa?OqOLMBGvRJAo9+S( z)TIaYQ$E2b)d!Bdxbf6nz3>a0P26ue;oVk-56ba9q8ab`W2^7&9tAOle_-1r?|mqK zuWJhtvCI(}Wc>DgaR~~KlgAxV7Q@|ZYGEv^BuOlW$dm!)9@KzRbXeimaV-?%&Q;MH zH%wBQo-sK$;&I*St{(IBsDYIq42y@Tdpr<#r1uD>+1sroGWJ7mT09a3;u;w3;RRaK z>|RJ^&!%lQW-809G2L@ePSUSLwk2=ydCX0BF7Q3Jr78ES8^JuoF(6lRxz9w+U=EO&1Q{j!*p(E zL?MDJ-{;kXnx78Hr~$v!)K0g8!}TZ_dztazzzh;H*nB;H6qSFEC_1b014_2&~A zWOow2TKc3sZ7~R!Ci_N923=YrC5bs-SgIXI1~d==m@&XVKk+DAf_QV!x#WJUb7ViO zqpe>+c^}%ck;ZnA<+5=Fwb(sMA`}{!XJaC*c+4*`A9Rv;q#k!;^qz-<@Y_<**7ErH zPV`fLX4U-`gkA8)cXp<0Yw$Il7^BN=_}u#(Rg)aejyFgD>f~zEd~s&6V&@VJ4P^Bi zQ5%`m-y2|@{LTWjrSD;%P<=G@?%=8+#I@2M$o#5?dj|ZgUI_C-wE2Fmt@p!EH@~Ri zNk+#NLY|ZlYB@0PVvI&7x<$Y1=8xbPx!~KeO&;vs3^`t8QHPr}cfx8?%LjG7p(Tl1 z!cvC(QUy)UEi@n8Z#A?;j~0hKY21U~?p!eb-TXP|nw&w>xP9#uDHaXs7ozNB7o#(L m7r Date: Sat, 14 Apr 2018 08:31:40 +0100 Subject: [PATCH 095/241] Moved the note up (#5166) It's easy for people to fail to notice the note, since it comes after the default upgrade instructions. Moved it up to make it harder to miss --- source/_docs/installation/updating.markdown | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/_docs/installation/updating.markdown b/source/_docs/installation/updating.markdown index dd5d6dc3ab..a9884322b6 100644 --- a/source/_docs/installation/updating.markdown +++ b/source/_docs/installation/updating.markdown @@ -16,6 +16,10 @@ The upgrade process differs depending on the installation you have, so please re Check what's new in the latest version and potentially impacts your system in [Home Assistant release notes](https://github.com/home-assistant/home-assistant/releases). It is good practice to review these release notes and pay close attention to the **Breaking Changes** that are listed there. If you haven't done an update for a while, you should also check previous release notes as they can also contain relevant **Breaking Changes**. **Breaking Changes** may require configuration updates for your components. If you missed this and Home Assistant refuses to start, check the log file in the [configuration](/docs/configuration/) directory, e.g., `.homeassistant/home-assistant.log`, for details about broken components. +

+To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Hass.io](/hassio/), [Hassbian](/docs/hassbian/installation/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv). +

+ The default way to update Home Assistant to the latest release, when available, is: ```bash @@ -30,10 +34,6 @@ $ sudo docker pull homeassistant/home-assistant:latest After updating, you must start/restart Home Assistant for the changes to take effect. This means that you will have to restart `hass` itself or the [autostarting](/docs/autostart/) daemon (if applicable). Startup can take considerable amount of time (i.e. minutes) depending on your device. This is because all requirements are updated as well. -

-To avoid permission errors, the upgrade must be run as the same user as the installation was completed, again review the documentation specific to your install [Hass.io](/hassio/), [Hassbian](/docs/hassbian/installation/), [Vagrant](/docs/installation/vagrant/), or [Virtualenv](/docs/installation/virtualenv). -

- [BRUH automation](http://www.bruhautomation.com) has created [a tutorial video](https://www.youtube.com/watch?v=tuG2rs1Cl2Y) explaining how to upgrade Home Assistant. #### {% linkable_title Run a specific version %} From d6b1ac22628e368d65c449466aa2909da77fcd6a Mon Sep 17 00:00:00 2001 From: DubhAd Date: Sat, 14 Apr 2018 08:38:26 +0100 Subject: [PATCH 096/241] Added dialout group (#5162) * Added dialout group Membership of the dialout group is required for Z-Wave and Zigbee sticks * Minor change --- source/_docs/installation/raspberry-pi.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_docs/installation/raspberry-pi.markdown b/source/_docs/installation/raspberry-pi.markdown index b0cb1b8a4a..c272e97dbf 100644 --- a/source/_docs/installation/raspberry-pi.markdown +++ b/source/_docs/installation/raspberry-pi.markdown @@ -49,10 +49,10 @@ $ sudo apt-get install python3 python3-venv python3-pip ``` Add an account for Home Assistant called `homeassistant`. -Since this account is only for running Home Assistant the extra arguments of `-rm` is added to create a system account and create a home directory. +Since this account is only for running Home Assistant the extra arguments of `-rm` is added to create a system account and create a home directory. The arguments `-G dialout` adds the user to the `dialout` group. This is required for using Z-Wave and Zigbee controllers. ```bash -$ sudo useradd -rm homeassistant +$ sudo useradd -rm homeassistant -G dialout ``` Next we will create a directory for the installation of Home Assistant and change the owner to the `homeassistant` account. From 3f43547c0e464ca004ebf9805d6ea663e2689ec7 Mon Sep 17 00:00:00 2001 From: Robin Date: Sat, 14 Apr 2018 08:52:36 +0100 Subject: [PATCH 097/241] Correct errors in folder_watcher doc (#5168) * Correct errors Corrects errors identified by @dale3h in https://github.com/home-assistant/home-assistant.github.io/pull/4885 * Adds event_type info * Add info on recursive monitoring --- source/_components/folder_watcher.markdown | 41 +++++++++++++--------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/source/_components/folder_watcher.markdown b/source/_components/folder_watcher.markdown index e7489514e8..ccd934c1ad 100644 --- a/source/_components/folder_watcher.markdown +++ b/source/_components/folder_watcher.markdown @@ -13,16 +13,23 @@ ha_iot_class: "Local Polling" ha_release: 0.67 --- -This component adds [Watchdog](https://pythonhosted.org/watchdog/) file system monitoring, publishing events on the Home-Assistant bus on the creation/deletion/modification of files. +This component adds [Watchdog](https://pythonhosted.org/watchdog/) file system monitoring, publishing events on the Home Assistant bus on the creation/deletion/modification of files. The monitored `event_type` are: +* `created` +* `deleted` +* `modified` +* `moved` -To configure the `folder_watcher` component add to you `configuration.yaml` file: +Note that by default folder monitoring is recursive, meaning that the contents of sub-folders are also monitored. + +To enable the Folder Watcher component in your installation, add the following to your `configuration.yaml` file: -```yaml {% raw %} +```yaml folder_watcher: - - folder: /config -{% endraw %} + watchers: + - folder: /config ``` +{% endraw %} {% configuration %} folder: @@ -40,28 +47,29 @@ patterns: Pattern matching using [fnmatch](https://docs.python.org/3.6/library/fnmatch.html) can be used to limit filesystem monitoring to only files which match the configured patterns. The following example shows the configuration required to only monitor filetypes `.yaml` and `.txt`. +{% raw %} ```yaml -{% raw %} folder_watcher: - - folder: /config - patterns: - - '*.yaml' - - '*.txt' -{% raw %} + watchers: + - folder: /config + patterns: + - '*.yaml' + - '*.txt' ``` +{% endraw %} ## Automations -Automations can be triggered on filesystem event data using a data_template. The following automation will send a notification with the name and folder of new files added to that folder: +Automations can be triggered on filesystem event data using a `data_template`. The following automation will send a notification with the name and folder of new files added to that folder: -```yaml {% raw %} +```yaml - action: - data_template: - message: 'Created {{trigger.event.data.file}} in {{trigger.event.data.folder}}' + message: 'Created {{ trigger.event.data.file }} in {{ trigger.event.data.folder }}' title: New image captured! data: - file: "{{trigger.event.data.path}}" + file: " {{ trigger.event.data.path }} " service: notify.pushbullet alias: New file alert condition: [] @@ -70,6 +78,5 @@ Automations can be triggered on filesystem event data using a data_template. The - event_data: {"event_type":"created"} event_type: folder_watcher platform: event -{% endraw %} ``` - +{% endraw %} From c396e08e500ffc3241b3594300b252e0fce48bb1 Mon Sep 17 00:00:00 2001 From: xTCx Date: Sat, 14 Apr 2018 11:05:32 +0300 Subject: [PATCH 098/241] Clicksend multiple recipients (#5149) Updated doc to reflect new multiple-recipients feature. --- source/_components/notify.clicksend.markdown | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/source/_components/notify.clicksend.markdown b/source/_components/notify.clicksend.markdown index f334009e9a..a5f9d587fd 100644 --- a/source/_components/notify.clicksend.markdown +++ b/source/_components/notify.clicksend.markdown @@ -28,6 +28,14 @@ notify: username: CLICKSEND_USERNAME api_key: CLICKSEND_API_KEY recipient: PHONE_NO + +# Multiple recipients +notify: + - platform: clicksend + name: ClickSend + username: CLICKSEND_USERNAME + api_key: CLICKSEND_API_KEY + recipient: [PHONE_NO1, PHONE_NO2] ``` {% configuration %} @@ -44,9 +52,9 @@ api_key: required: true type: string recipient: - description: "Your phone number. This is where you want to send your notification SMS messages, e.g., `09171234567`." + description: "A single or multiple phone numbers. This is where you want to send your SMS notification messages, e.g., `09171234567` or `[09171234567, 09177654321]`." required: true - type: string + type: string or list sender: description: The name or number of the sender. required: false From 0d603c0a6ef4bc0000f39a64c0f3fdda5f0432f8 Mon Sep 17 00:00:00 2001 From: DubhAd Date: Sat, 14 Apr 2018 09:08:43 +0100 Subject: [PATCH 099/241] More words (#5164) * More words Added an explanation of what's going on, and that devices will function normally. * :pencil2: Language tweaks --- source/_docs/z-wave/query-stage.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/_docs/z-wave/query-stage.markdown b/source/_docs/z-wave/query-stage.markdown index 2037963e45..7112cd055b 100644 --- a/source/_docs/z-wave/query-stage.markdown +++ b/source/_docs/z-wave/query-stage.markdown @@ -9,6 +9,10 @@ sharing: true footer: true --- +When the Z-Wave mesh is first started, the controller will go through all the following stages for every device on the mesh. This is a slow process, and to complete requires that the devices be awake. While devices that are mains or USB powered are always awake, battery-powered devices spend most of their time asleep. Because of this, you can expect that after startup your battery powered devices will spend time in `Initializing (CacheLoad)` - how long depends on the device. + +Your devices will still function normally while marked as `Initializing`. + | Stage | Description | |------------------------|--------------------------------------------------------------------| | None | Query process hasn't started for this node | @@ -17,7 +21,7 @@ footer: true | WakeUp | Start wake up process if a sleeping node | | ManufacturerSpecific1 | Retrieve manufacturer name and product ids if ProtocolInfo lets us | | NodeInfo | Retrieve info about supported, controlled command classes | -| NodePlusInfo | Retrieve ZWave+ info and update device classes | +| NodePlusInfo | Retrieve Z-Wave+ info and update device classes | | SecurityReport | Retrieve a list of Command Classes that require Security | | ManufacturerSpecific2 | Retrieve manufacturer name and product ids | | Versions | Retrieve version information | From f3ad3f8ea28ba01df6f71f769ca6818894500ca8 Mon Sep 17 00:00:00 2001 From: Matthew Garrett Date: Sat, 14 Apr 2018 02:43:18 -0700 Subject: [PATCH 100/241] Add documentation for homekit controller component (#4966) * Add documentation for homekit controller component * Update docs to match the implementation * :arrow_up: ha_release * :pencil2: Language tweak * :arrow_up: ha_release * :arrow_up: ha_release --- source/_components/discovery.markdown | 9 ++++++ .../_components/homekit_controller.markdown | 31 +++++++++++++++++++ .../light.homekit_controller.markdown | 16 ++++++++++ .../switch.homekit_controller.markdown | 16 ++++++++++ 4 files changed, 72 insertions(+) create mode 100644 source/_components/homekit_controller.markdown create mode 100644 source/_components/light.homekit_controller.markdown create mode 100644 source/_components/switch.homekit_controller.markdown diff --git a/source/_components/discovery.markdown b/source/_components/discovery.markdown index 61ea8046b9..f369ce67c1 100644 --- a/source/_components/discovery.markdown +++ b/source/_components/discovery.markdown @@ -23,6 +23,7 @@ Home Assistant can discover and automatically configure [zeroconf](https://en.wi * [DirecTV receivers](/components/media_player.directv/) * [Frontier Silicon internet radios](/components/media_player.frontier_silicon/) * [Google Cast](/components/media_player.cast/) + * [HomeKit](/components/homekit_controller/) * [IKEA Trådfri (Tradfri)](/components/tradfri/) * [Linn / Openhome](/components/media_player.openhome/) * [Logitech Harmony Hub](/components/remote.harmony/) @@ -50,6 +51,8 @@ discovery: ignore: - sonos - samsung_tv + enable: + - homekit ``` Configuration variables: @@ -85,6 +88,12 @@ Valid values for ignore are: * `yamaha`: Yamaha media player * `yeelight`: Yeelight Sunflower bulb +- **enable** (*Optional*): A list of platforms not enabled by default that `discovery` should discover. + +Valid values for enable are: + + * `homekit`: HomeKit accessories +

Home Assistant must be on the same network as the devices for uPnP discovery to work. If running Home Assistant in a [Docker container](/docs/installation/docker/) use switch `--net=host` to put it on the host's network. diff --git a/source/_components/homekit_controller.markdown b/source/_components/homekit_controller.markdown new file mode 100644 index 0000000000..319f505ef1 --- /dev/null +++ b/source/_components/homekit_controller.markdown @@ -0,0 +1,31 @@ +--- +layout: page +title: "HomeKit controller support" +description: "Instructions how to integrate your HomeKit devices within Home Assistant." +date: 2018-03-19 21:04 +sidebar: true +comments: false +sharing: true +footer: true +logo: apple-homekit.png +ha_category: Hub +ha_release: 0.68 +ha_iot_class: "Local Polling" +--- + +[HomeKit](https://developer.apple.com/homekit/) controller integration for Home Assistant allows you to connect HomeKit accessories to Home Assistant. This component should not be confused with the [HomeKit](homekit) component, which allows you to control Home Assistant devices via HomeKit. + +There is currently support for the following device types within Home Assistant: + +- [Light](../light.homekit_controller) +- [Switch](../switch.homekit_controller) + +The component will be automatically configured if the [`discovery:`](components/discovery/) component is enabled and an enable entry added for HomeKit: + +```yaml +discovery: + enable: + - homekit +``` + +For each detected HomeKit accessory, a configuration prompt will appear in the web front end. Use this to provide the HomeKit PIN. diff --git a/source/_components/light.homekit_controller.markdown b/source/_components/light.homekit_controller.markdown new file mode 100644 index 0000000000..f3f7243a10 --- /dev/null +++ b/source/_components/light.homekit_controller.markdown @@ -0,0 +1,16 @@ +--- +layout: page +title: "HomeKit Light" +description: "Instructions how to setup HomeKit lights within Home Assistant." +date: 2017-03-19 21:08 +sidebar: true +comments: false +sharing: true +footer: true +logo: apple-homekit.png +ha_category: Light +ha_iot_class: "Local Polling" +ha_release: 0.68 +--- + +To get your HomeKit lights working with Home Assistant, follow the instructions for the general [HomeKit controller component](/components/homekit_controller/). diff --git a/source/_components/switch.homekit_controller.markdown b/source/_components/switch.homekit_controller.markdown new file mode 100644 index 0000000000..205316bdf2 --- /dev/null +++ b/source/_components/switch.homekit_controller.markdown @@ -0,0 +1,16 @@ +--- +layout: page +title: "HomeKit Light" +description: "Instructions how to setup HomeKit switches within Home Assistant." +date: 2017-03-19 21:08 +sidebar: true +comments: false +sharing: true +footer: true +logo: apple-homekit.png +ha_category: Light +ha_iot_class: "Local Polling" +ha_release: 0.68 +--- + +To get your HomeKit switches working with Home Assistant, follow the instructions for the general [HomeKit controller component](/components/homekit_controller/). From 17285ba293166cc09add20cf6471ace14ce8191e Mon Sep 17 00:00:00 2001 From: Robin Date: Sat, 14 Apr 2018 19:37:06 +0100 Subject: [PATCH 101/241] Remove refs to watcher (#5169) I accidentally reintroduced an old reference to `watchers`, removed in this PR --- source/_components/folder_watcher.markdown | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/source/_components/folder_watcher.markdown b/source/_components/folder_watcher.markdown index ccd934c1ad..88b19937e0 100644 --- a/source/_components/folder_watcher.markdown +++ b/source/_components/folder_watcher.markdown @@ -26,8 +26,7 @@ To enable the Folder Watcher component in your installation, add the following t {% raw %} ```yaml folder_watcher: - watchers: - - folder: /config + - folder: /config ``` {% endraw %} @@ -50,11 +49,10 @@ Pattern matching using [fnmatch](https://docs.python.org/3.6/library/fnmatch.htm {% raw %} ```yaml folder_watcher: - watchers: - - folder: /config - patterns: - - '*.yaml' - - '*.txt' + - folder: /config + patterns: + - '*.yaml' + - '*.txt' ``` {% endraw %} From 36a385b5b7b980e5fe20abd895b17926873a7029 Mon Sep 17 00:00:00 2001 From: Sebastian Date: Sun, 15 Apr 2018 13:09:30 +0200 Subject: [PATCH 102/241] Added screenshot for binary_sensor device classes icons (#5182) * added screenshot Screenshot of binary_sensors device classes icons added * Added screenshot to docs Screenshot showing icons for binary_sensor device classes added. --- source/_components/binary_sensor.markdown | 5 +++++ .../screenshots/binary_sensor_classes_icons.png | Bin 0 -> 75176 bytes 2 files changed, 5 insertions(+) create mode 100644 source/images/screenshots/binary_sensor_classes_icons.png diff --git a/source/_components/binary_sensor.markdown b/source/_components/binary_sensor.markdown index 588b4df27f..5826f9c147 100644 --- a/source/_components/binary_sensor.markdown +++ b/source/_components/binary_sensor.markdown @@ -39,3 +39,8 @@ The way these sensors are displayed in the frontend can be modified in the [cust - **window**: `On` means open, `Off` means closed For analog sensors please check the [component overview](/components/#sensor). + +

+ +Example of various device classes icons in `On` and `Off` state. +

diff --git a/source/images/screenshots/binary_sensor_classes_icons.png b/source/images/screenshots/binary_sensor_classes_icons.png new file mode 100644 index 0000000000000000000000000000000000000000..53363bcb9906877803ee5ce4afe0cb47cd13aaf6 GIT binary patch literal 75176 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

iwe5xt{z@R*ltliv%V5X>(b;U7h~q5n0is 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 X4=(s1w3=AF4gM)yRh7-WY~uTWr3_w2 literal 0 HcmV?d00001 From fdef560c1ad994a87c5b84c3697b40daeddd57a0 Mon Sep 17 00:00:00 2001 From: ionred Date: Sun, 15 Apr 2018 06:17:29 -0500 Subject: [PATCH 103/241] config example update (#5179) The configuration didn't work as listed. Required addition of platform and switches lines, along with indent fixes. --- source/_components/switch.rainbird.markdown | 22 +++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/source/_components/switch.rainbird.markdown b/source/_components/switch.rainbird.markdown index eee1d471b9..6fba9a2f99 100644 --- a/source/_components/switch.rainbird.markdown +++ b/source/_components/switch.rainbird.markdown @@ -19,16 +19,18 @@ Once you have enabled the [Rain Bird component](/components/rainbird), add the f ```yaml switch: - sprinkler_1: - zone: 1 - friendly_name: "Front sprinklers" - trigger_time: 20 - scan_interval: 10 - sprinkler_2: - friendly_name: "Back sprinklers" - zone: 2 - trigger_time: 20 - scan_interval: 10 + - platform: rainbird + switches: + sprinkler_1: + zone: 1 + friendly_name: "Front sprinklers" + trigger_time: 10 + scan_interval: 10 + sprinkler_2: + friendly_name: "Back sprinklers" + zone: 2 + trigger_time: 20 + scan_interval: 10 ``` Configuration variables: From e2e44aeb337f5dbe62b265817f0eef9bcffb4f3a Mon Sep 17 00:00:00 2001 From: Gerard Date: Sun, 15 Apr 2018 13:18:12 +0200 Subject: [PATCH 104/241] Clarify titles of BMW Connected Drive components (#5178) * Update binary_sensor.bmw_connected_drive.markdown * Update bmw_connected_drive.markdown * Update device_tracker.bmw_connected_drive.markdown * Update lock.bmw_connected_drive.markdown * Update sensor.bmw_connected_drive.markdown * Update binary_sensor.bmw_connected_drive.markdown * Update bmw_connected_drive.markdown * Update device_tracker.bmw_connected_drive.markdown * Update lock.bmw_connected_drive.markdown * Update sensor.bmw_connected_drive.markdown * Update binary_sensor.bmw_connected_drive.markdown * Update lock.bmw_connected_drive.markdown --- .../binary_sensor.bmw_connected_drive.markdown | 8 ++++---- source/_components/bmw_connected_drive.markdown | 4 ++-- .../device_tracker.bmw_connected_drive.markdown | 4 ++-- source/_components/lock.bmw_connected_drive.markdown | 8 ++++---- source/_components/sensor.bmw_connected_drive.markdown | 4 ++-- 5 files changed, 14 insertions(+), 14 deletions(-) diff --git a/source/_components/binary_sensor.bmw_connected_drive.markdown b/source/_components/binary_sensor.bmw_connected_drive.markdown index 6c38dc813e..74330ec563 100755 --- a/source/_components/binary_sensor.bmw_connected_drive.markdown +++ b/source/_components/binary_sensor.bmw_connected_drive.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "BMW connected drive" -description: "Instructions on how to setup your BMW connected drive account with Home Assistant." +title: "BMW Connected Drive Binary Sensor" +description: "Instructions on how to setup your BMW Connected Drive account with Home Assistant." date: 2018-02-22 23:00 sidebar: true comments: false @@ -15,6 +15,6 @@ ha_release: 0.66 The `bmw_connected_drive` platform allows you to import data on your BMW into Home Assistant. -The binary sensors will be automatically configured if 'bmw_connected_drive' component is configured. +The binary sensors will be automatically configured if `bmw_connected_drive` component is configured. -For more configuration information see the [bmw_connected_drive component](/components/bmw_connected_drive/) documentation. +For more configuration information see the [`bmw_connected_drive` component](/components/bmw_connected_drive/) documentation. diff --git a/source/_components/bmw_connected_drive.markdown b/source/_components/bmw_connected_drive.markdown index fe8cabc71a..52d223a9c2 100644 --- a/source/_components/bmw_connected_drive.markdown +++ b/source/_components/bmw_connected_drive.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "BMW connected drive" -description: "Instructions on how to setup your BMW connected drive account with Home Assistant." +title: "BMW Connected Drive" +description: "Instructions on how to setup your BMW Connected Drive account with Home Assistant." date: 2018-01-10 23:00 sidebar: true comments: false diff --git a/source/_components/device_tracker.bmw_connected_drive.markdown b/source/_components/device_tracker.bmw_connected_drive.markdown index d00d588b35..4f390c5fa3 100644 --- a/source/_components/device_tracker.bmw_connected_drive.markdown +++ b/source/_components/device_tracker.bmw_connected_drive.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "BMW connected drive" -description: "Instructions on how to setup your BMW connected drive account with Home Assistant." +title: "BMW Connected Drive Device Tracker" +description: "Instructions on how to setup your BMW Connected Drive account with Home Assistant." date: 2018-01-10 23:00 sidebar: true comments: false diff --git a/source/_components/lock.bmw_connected_drive.markdown b/source/_components/lock.bmw_connected_drive.markdown index 2a7f670812..4c6c7a2edc 100755 --- a/source/_components/lock.bmw_connected_drive.markdown +++ b/source/_components/lock.bmw_connected_drive.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "BMW connected drive" -description: "Instructions on how to setup your BMW connected drive account with Home Assistant." +title: "BMW Connected Drive Lock" +description: "Instructions on how to setup your BMW Connected Drive account with Home Assistant." date: 2018-02-22 23:00 sidebar: true comments: false @@ -15,6 +15,6 @@ ha_release: 0.66 The `bmw_connected_drive` platform allows you to import data on your BMW into Home Assistant. -The lock will be automatically configured if 'bmw_connected_drive' component is configured. +The lock will be automatically configured if `bmw_connected_drive` component is configured. -For more configuration information see the [bmw_connected_drive component](/components/bmw_connected_drive/) documentation. +For more configuration information see the [`bmw_connected_drive` component](/components/bmw_connected_drive/) documentation. diff --git a/source/_components/sensor.bmw_connected_drive.markdown b/source/_components/sensor.bmw_connected_drive.markdown index 394fd2c31e..083e5124a6 100644 --- a/source/_components/sensor.bmw_connected_drive.markdown +++ b/source/_components/sensor.bmw_connected_drive.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "BMW connected drive" -description: "Instructions on how to setup your BMW connected drive account with Home Assistant." +title: "BMW Connected Drive Sensor" +description: "Instructions on how to setup your BMW Connected Drive account with Home Assistant." date: 2018-01-10 23:00 sidebar: true comments: false From d0268f1e053fe456a31f88a2b0361b924f842ddd Mon Sep 17 00:00:00 2001 From: Norien Date: Sun, 15 Apr 2018 07:20:16 -0400 Subject: [PATCH 105/241] Update light.nanoleaf_aurora.markdown (#5175) in current build `- platform: aurora` is not found however `- platform: nanoleaf_aurora` works ok! --- source/_components/light.nanoleaf_aurora.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.nanoleaf_aurora.markdown b/source/_components/light.nanoleaf_aurora.markdown index 074bd1c77f..4f066dc7b2 100644 --- a/source/_components/light.nanoleaf_aurora.markdown +++ b/source/_components/light.nanoleaf_aurora.markdown @@ -21,7 +21,7 @@ To enable the Aurora lights, add the following lines to your `configuration.yaml ```yaml # Example configuration.yaml entry light: - - platform: aurora + - platform: nanoleaf_aurora host: 192.168.1.10 token: xxxxxxxxxxxxxxxxxxxxx ``` From 75520f8d642fa7342fd3aa2dd3b41d8b2d413ba1 Mon Sep 17 00:00:00 2001 From: stephanerosi Date: Sun, 15 Apr 2018 14:06:27 +0200 Subject: [PATCH 106/241] Media player webostv next/previous buttons (#5183) * Media player webostv next/previous buttons Description of the change visibles in https://github.com/home-assistant/home-assistant/pull/13829 * Fix formatting --- .../_components/media_player.webostv.markdown | 23 +++++++++++++------ 1 file changed, 16 insertions(+), 7 deletions(-) diff --git a/source/_components/media_player.webostv.markdown b/source/_components/media_player.webostv.markdown index 707ef55a90..cb4fe0c757 100644 --- a/source/_components/media_player.webostv.markdown +++ b/source/_components/media_player.webostv.markdown @@ -19,7 +19,7 @@ The `webostv` platform allows you to control a [LG](http://www.lg.com/) webOS Sm To begin with enable *LG Connect Apps* feature in *Network* settings of the TV [instructions](http://www.lg.com/uk/support/product-help/CT00008334-1437131798537-others). -Once basic configuration is added to your `configuration.yaml` *Configuration* card should prompt on your HA's States. Follow the instructions and accept pairing request on your TV. +Once basic configuration is added to your `configuration.yaml` *Configuration* card should prompt on your Home Assistants's states. Follow the instructions and accept pairing request on your TV. Pairing information will be saved to the `filename:` provided in configuration; this process is IP sensitive, in case the IP address of your TV would change in future. @@ -42,10 +42,12 @@ Configuration variables: - **timeout** (*Optional*): The timeout for connections to the TV in seconds. - **filename** (*Optional*): The filename where the pairing key with the TV should be stored. This path is relative to Home Assistant's config directory. It defaults to `webostv.conf`. - **customize** array (*Optional*): List of options to customize. - - ***sources** array (*Optional*): List of hardware and webOS App inputs. + - **sources** array (*Optional*): List of hardware and webOS App inputs. If you do not specify `host:`, all LG webOS Smart TVs within your network will be auto-discovered. +### {% linkable_title Example %} + A full configuration example will look like the sample below: ```yaml @@ -67,15 +69,15 @@ media_player: - makotv - netflix ``` -** avoid using `[ ]` in the `name:` of your device. +Avoid using `[ ]` in the `name:` of your device. -*Turn On Action* +### {% linkable_title Turn on action %} Home Assistant is able to turn on a LG webOS Smart TV if you specify an action, like HDMI-CEC or WakeOnLan. Common for webOS 3.0 and higher would be to use WakeOnLan feature. -To use this feature your TV should be connected to your network via Ethernet rather than Wireless and you should enable *LG Connect Apps* feature in *Network* settings of the TV [instructions](http://www.lg.com/uk/support/product-help/CT00008334-1437131798537-others) (or *Mobile App* in *General* settings for older models) (*may vary by version). +To use this feature your TV should be connected to your network via Ethernet rather than Wireless and you should enable *LG Connect Apps* feature in *Network* settings of the TV [instructions](http://www.lg.com/uk/support/product-help/CT00008334-1437131798537-others) (or *Mobile App* in *General* settings for older models). ```yaml # Example configuration.yaml entry @@ -90,9 +92,16 @@ media_player: data: mac: B4:E6:2A:1E:11:0F ``` + Any other [actions](/docs/automation/action/) to power on the device can be configured. - -*Sources* +### {% linkable_title Sources %} To obtain complete list of available sources currently configured on the TV, once the webOS TV is configured and linked, while its powered on head to the **Developer Tools** > **States**, find your `media_player.` and use the sources listed in `source_list:` remembering to split them per line into your `sources:` configuration. + +### {% linkable_title Next/Previous buttons %} + +The behaviour of the next and previsous buttons is different depending on the active source: + + - if the source is 'LiveTV' (television): next/previous buttons act as channel up/down + - otherwise: next/previsous buttons act as next/previous track From 26c45c852b22c7e9ad3d9f5dab4f493fc2a19952 Mon Sep 17 00:00:00 2001 From: Darren Reynolds Date: Sun, 15 Apr 2018 22:06:40 +1000 Subject: [PATCH 107/241] Add Doorbell ring examples (#5180) * Add Doorbell ring examples Add Doorbell ring examples for SONOS media players and hass_url_override option explanation. * Fix typos --- source/_components/doorbird.markdown | 74 +++++++++++++++++++++++++++- 1 file changed, 72 insertions(+), 2 deletions(-) diff --git a/source/_components/doorbird.markdown b/source/_components/doorbird.markdown index 30cd891c00..9db3c71d86 100644 --- a/source/_components/doorbird.markdown +++ b/source/_components/doorbird.markdown @@ -20,9 +20,10 @@ To connect your device, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry doorbird: - host: IP_OR_HOSTNAME + host: DOORBIRD_IP_OR_HOSTNAME username: YOUR_USERNAME password: YOUR_PASSWORD + hass_url_override: HASS_IP ``` Configuration variables: @@ -31,8 +32,77 @@ Configuration variables: - **username** (*Required*): The username of a non-administrator user account on the device. - **password** (*Required*): The password for the user specified. - **doorbell_events** (*Optional*): Setting this to `true` this will register a callback URL with the device so that events can be published to the event bus when the doorbell rings. -- **hass_url_override** (*Optional*): If your DoorBird cannot connect to the machine running Home Assistant because you are using dynamic DNS or some other HTTP configuration, specify the LAN IP of the machine here to force a LAN connection. +- **hass_url_override** (*Optional*): If your DoorBird cannot connect to the machine running Home Assistant because you are using dynamic DNS or some other HTTP configuration (such as HTTPS), specify the LAN IP of the machine here to force a LAN connection.

Enabling `doorbell_events` will delete all other registered push notification services with the device every time Home Assistant starts. This will not affect notifications delivered by the DoorBird mobile app.

+ +### Doorbell Sound Examples + +You can create an automation that triggers on event `doorbird_doorbell` to play a doorbell sound when the Doorbird button is pressed. This should work with any media player. + +#### Example using SONOS + +[`SONOS`](http://www.sonos.com) players have features allowing for "snapshotting" the current state of some or all players so those state(s) can be "restored" at a later time. This feature is perfect for implementing a doorbell sound (from Doorbird or any other Doorbell setup for that matter). The [`media_player.sonos`](/components/media_player.sonos/) platform includes the [`SONOS_SNAPSHOT`](/components/media_player.sonos/#service-sonos_snapshot) and [`SONOS_RESTORE`](/components/media_player.sonos/#service-sonos_restore) features. The result of not using these features is any currently playing songs or media will not continue playing after the doorbell sound has played and you will be left with the doorbell sound queued as the last played song. This setup allows for seamless ringing of the doorbell and all SONOS devices continuing nicely on as if nothing had happened. + +The example script below takes a snapshot of three SONOS players that are not currently grouped together, joins the three players in a group (so the sound plays at the same time on all players), plays the doorbell MP3 sound, unjoins the players from the group and finally restores the players to their original state. When the players are grouped they are controlled by refering to the `master`. + +Automation file: + +```yaml +- alias: Doorbird ring + trigger: + platform: event + event_type: doorbird_doorbell + action: + service: script.turn_on + entity_id: script.doorbell +``` + +Script file: + +```yaml +doorbell: + alias: Ring Doorbell + sequence: + - service: media_player.sonos_snapshot + data: + entity_id: + - media_player.kitchen + - media_player.master_bedroom + - media_player.study + - service: media_player.sonos_join + data: + master: media_player.study + entity_id: + - media_player.kitchen + - media_player.master_bedroom + - media_player.study + - service: media_player.play_media + data: + entity_id: media_player.study # the group master + media_content_id: http://10.1.1.10/sounds/doorbell.mp3 # this is on a NAS but could be HASS local + media_content_type: music + - service: media_player.volume_set + data: + entity_id: # can still control the volume of grouped players indivdually + - media_player.study + - media_player.kitchen + - media_player.master_bedrom + volume_level: 0.50 + - delay: + seconds: 4 # wait while the sound plays + - service: media_player.sonos_unjoin + data: + entity_id: + - media_player.kitchen + - media_player.master_bedroom + - media_player.study + - service: media_player.sonos_restore + data: + entity_id: + - media_player.kitchen + - media_player.master_bedroom + - media_player.study +``` From 8bacd6162f7ef4c16ad8bfe53f9fbbd99571c699 Mon Sep 17 00:00:00 2001 From: Colin Frei Date: Sun, 15 Apr 2018 15:17:54 +0200 Subject: [PATCH 108/241] Link to correct holidays version (#5184) --- source/_components/binary_sensor.workday.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/binary_sensor.workday.markdown b/source/_components/binary_sensor.workday.markdown index edc34b5a37..b63d8f778d 100644 --- a/source/_components/binary_sensor.workday.markdown +++ b/source/_components/binary_sensor.workday.markdown @@ -32,8 +32,8 @@ binary_sensor: Configuration variables: - **name** (*Optional*): A name for this sensor. Defaults to *Workday Sensor* -- **country** (*Required*): Country code according to [holidays](https://pypi.python.org/pypi/holidays/0.9.3) notation. -- **province** (*Optional*): Province code according to [holidays](https://pypi.python.org/pypi/holidays/0.9.3) notation. Defaults to None. +- **country** (*Required*): Country code according to [holidays](https://pypi.python.org/pypi/holidays/0.9.4) notation. +- **province** (*Optional*): Province code according to [holidays](https://pypi.python.org/pypi/holidays/0.9.4) notation. Defaults to None. - **workdays** (*Optional*): List of workdays. Defaults to `mon`, `tue`, `wed`, `thu`, `fri`. - **excludes** (*Optional*): List of workday excludes. Defaults to `sat`, `sun`, `holiday`. - **days_offset** (*Optional*): Set days offset. Defaults to `0`. From 9d71a518737ed8744d2588413cee60d233d804c4 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 15 Apr 2018 17:16:18 +0200 Subject: [PATCH 109/241] Add details about conditions --- source/_components/weather.markdown | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/source/_components/weather.markdown b/source/_components/weather.markdown index 7babb6f8e9..dd9d634990 100644 --- a/source/_components/weather.markdown +++ b/source/_components/weather.markdown @@ -13,4 +13,22 @@ The `weather` platforms are gathering meteorological information from web servic Home Assistant currently supports free web services and such which require a registration. Please check the sidebar for a full list of supported `weather` platforms. +## {% linkable_title Condition mapping %} + +The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://materialdesignicons.com/) available. + +- 'cloudy' +- 'fog' +- 'hail' +- 'lightning' +- 'lightning-rainy' +- 'partlycloudy' +- 'pouring' +- 'rainy' +- 'snowy' +- 'snowy-rainy' +- 'sunny' +- 'windy' +- 'windy-variant' +- 'exceptional': From a6795e584c0e1baa31972113140c250100fee69f Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 15 Apr 2018 17:24:14 +0200 Subject: [PATCH 110/241] Add link --- source/_components/weather.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/weather.markdown b/source/_components/weather.markdown index dd9d634990..c256cae2a8 100644 --- a/source/_components/weather.markdown +++ b/source/_components/weather.markdown @@ -15,7 +15,7 @@ Home Assistant currently supports free web services and such which require a reg ## {% linkable_title Condition mapping %} -The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://materialdesignicons.com/) available. +The `weather` platform only knows the below listed conditions. The reason for this is that for these conditions is an icon from [Material Design Icons](https://materialdesignicons.com/) available and mapped in the [frontend](https://github.com/home-assistant/home-assistant-polymer/blob/master/src/cards/ha-weather-card.html#L77). - 'cloudy' - 'fog' From 424dc3013c3c74a76208b2349446fb86eb503d2e Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 15 Apr 2018 17:28:56 +0200 Subject: [PATCH 111/241] Minor updates --- source/_components/weather.bom.markdown | 3 +++ source/_components/weather.buienradar.markdown | 5 ++++- source/_components/weather.darksky.markdown | 13 +++++-------- source/_components/weather.metoffice.markdown | 3 +++ source/_components/weather.openweathermap.markdown | 2 ++ source/_components/weather.yweather.markdown | 2 ++ source/_components/weather.zamg.markdown | 2 ++ 7 files changed, 21 insertions(+), 9 deletions(-) diff --git a/source/_components/weather.bom.markdown b/source/_components/weather.bom.markdown index 3a9d64c81a..fe26c58337 100644 --- a/source/_components/weather.bom.markdown +++ b/source/_components/weather.bom.markdown @@ -15,9 +15,12 @@ ha_iot_class: "Cloud Polling" The `bom` weather platform uses the [Australian Bureau of Meteorology (BOM)](http://www.bom.gov.au) as a source for current (half-hourly) meteorological data. +## {% linkable_title Configuration %} + To add the BOM weather platform to your installation, add the following to your `configuration.yaml` file: ```yaml +# Example configuration.yaml entry weather: - platform: bom ``` diff --git a/source/_components/weather.buienradar.markdown b/source/_components/weather.buienradar.markdown index b2a42e7661..0b4ef3f0db 100644 --- a/source/_components/weather.buienradar.markdown +++ b/source/_components/weather.buienradar.markdown @@ -14,8 +14,11 @@ ha_iot_class: "Cloud Polling" --- The `buienradar` platform uses [buienradar.nl](http://buienradar.nl/) as a source for current meteorological data for your location. The weather forecast is delivered by Buienradar, who provides a web service that provides detailed weather information for users in The Netherlands. + The relevant weather station used will be automatically selected based on the location specified in the Home Assistant configuration (or in the Buienradar weather/sensor component). A map of all available weather stations can be found [here](https://www.google.com/maps/d/embed?mid=1NivHkTGQUOs0dwQTnTMZi8Uatj0). +## {% linkable_title Configuration %} + To add the Buienradar weather to your installation, add the following to your `configuration.yaml` file: ```yaml @@ -26,7 +29,7 @@ weather: Configuration variables: -- **name** (*Optional*): You can specify a name of the component, but do not have to. If you specify a name, the weather component will get an entity name of 'weather.[name]'; if no name is specified, it will try to set its name to 'weather.BR_[stationname]'. However at the moment in time, the entity is created, no data has been retrieved yet, so the entity will get named 'weather.BR_unknown_station'. Later the station name will be known and get updated, but the entity name remains. +- **name** (*Optional*): You can specify a name of the component, but do not have to. If you specify a name, the weather component will get an entity name of `weather.[name]`; if no name is specified, it will try to set its name to `weather.BR_[stationname]`. However at the moment in time, the entity is created, no data has been retrieved yet, so the entity will get named `weather.BR_unknown_station`. Later the station name will be known and get updated, but the entity name remains. - **latitude** (*Optional*): Latitude to use for selection of data source location. Longitude and latitude will be taken from Home Assistant configuration but can be overridden/changed in this component to select a different location for Buienradar. - **longitude**(*Optional*): Longitude to use for selection of data source location. Longitude and latitude will be taken from Home Assistant configuration but can be overridden/changed in this component to select a different location for Buienradar. - **forecast** (*Optional*): 'True' to add a temperature forecast, 'False' to suppress it. diff --git a/source/_components/weather.darksky.markdown b/source/_components/weather.darksky.markdown index 1d7c843b35..6a3b1ad138 100644 --- a/source/_components/weather.darksky.markdown +++ b/source/_components/weather.darksky.markdown @@ -14,17 +14,14 @@ ha_release: 0.61 ha_iot_class: "Cloud Polling" --- -The `darksky` platform uses the [Dark Sky](https://darksky.net/) web service as -a source for meteorological data for your location. +The `darksky` platform uses the [Dark Sky](https://darksky.net/) web service as a source for meteorological data for your location. -You need an API key which is free but requires -[registration](https://darksky.net/dev/register). The free tier allows up to -1000 calls per day, this platform updates at most every 3 minutes, using up to -480 of those calls. +## {% linkable_title Configuration %} + +You need an API key which is free but requires [registration](https://darksky.net/dev/register). The free tier allows up to 1000 calls per day, this platform updates at most every 3 minutes, using up to 480 of those calls.

-[Dark Sky](https://darksky.net/dev/) will charge you $0.0001 per API call if you -enter your credit card details and create more than 1000 calls per day. +[Dark Sky](https://darksky.net/dev/) will charge you $0.0001 per API call if you enter your credit card details and create more than 1000 calls per day.

To add Dark Sky to your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/weather.metoffice.markdown b/source/_components/weather.metoffice.markdown index 5875121806..df624d2a9c 100644 --- a/source/_components/weather.metoffice.markdown +++ b/source/_components/weather.metoffice.markdown @@ -15,9 +15,12 @@ ha_iot_class: "Cloud Polling" The `metoffice` weather platform uses the Met Office's [DataPoint API][datapoint] for weather data. +## {% linkable_title Configuration %} + To add the Met Office weather platform to your installation, you'll need to register for a free API key at the link above and then add the following to your `configuration.yaml` file: ```yaml +# Example configuration.yaml entry weather: - platform: metoffice api_key: YOUR_API_KEY diff --git a/source/_components/weather.openweathermap.markdown b/source/_components/weather.openweathermap.markdown index 0bb8d2bf9e..53f7e9a348 100644 --- a/source/_components/weather.openweathermap.markdown +++ b/source/_components/weather.openweathermap.markdown @@ -15,6 +15,8 @@ ha_iot_class: "Cloud Polling" The `openweathermap` weather platform uses [OpenWeatherMap](http://openweathermap.org/) as a source for current meteorological data for your location. +## {% linkable_title Configuration %} + You need an API key which is free but requires a [registration](http://home.openweathermap.org/users/sign_up). To add OpenWeatherMap to your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/weather.yweather.markdown b/source/_components/weather.yweather.markdown index af311a0030..27bbda8214 100644 --- a/source/_components/weather.yweather.markdown +++ b/source/_components/weather.yweather.markdown @@ -19,6 +19,8 @@ The `yweather` platform uses [Yahoo Weather](https://www.yahoo.com/news/weather/ Use of the Yahoo Weather API should not exceed reasonable request volume. Access is limited to 2000 signed calls per day.

+## {% linkable_title Configuration %} + The `woeid` (Where On Earth ID) for your location, as shown in the example below. You can find your WOEID by copying the numeric digits at the end of the URL for your location at [Yahoo Weather](https://www.yahoo.com/news/weather/). If you don't add a WOEID, it will be generated from Home Assistant's latitude and longitude. To add Yahoo Weather to your installation, add the following to your `configuration.yaml` file: diff --git a/source/_components/weather.zamg.markdown b/source/_components/weather.zamg.markdown index cf805fd3a4..b3112d97ea 100644 --- a/source/_components/weather.zamg.markdown +++ b/source/_components/weather.zamg.markdown @@ -17,6 +17,8 @@ The `zamg` platform uses meteorological details published by the Austrian weathe Only observations for capital cities are publicly available. You can check the list of stations in [CSV format](http://www.zamg.ac.at/ogd). +## {% linkable_title Configuration %} + To add ZAMG to your installation, add the following to your `configuration.yaml` file: ```yaml From 429040954a30d017d86efc47bb6329994da6d62a Mon Sep 17 00:00:00 2001 From: apastuszak Date: Sun, 15 Apr 2018 12:48:05 -0400 Subject: [PATCH 112/241] Change order or ProxyPass in first example (#5185) I was not able to login to Home Assistant till I change he Home Assistant config to place the Websocket reverse proxy info BEFORE the web UI info. In the other order it loads, but never lets me log in. If I reverse them, then I login just fine. --- source/_docs/ecosystem/apache.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_docs/ecosystem/apache.markdown b/source/_docs/ecosystem/apache.markdown index ae0c192511..92c27eb51a 100644 --- a/source/_docs/ecosystem/apache.markdown +++ b/source/_docs/ecosystem/apache.markdown @@ -35,10 +35,10 @@ To be able to access to your Home Assistant instance by using https://home.examp ServerName home.example.org ProxyPreserveHost On ProxyRequests off - ProxyPass / http://localhost:8123/ - ProxyPassReverse / http://localhost:8123/ ProxyPass /api/websocket ws://localhost:8123/api/websocket ProxyPassReverse /api/websocket ws://localhost:8123/api/websocket + ProxyPass / http://localhost:8123/ + ProxyPassReverse / http://localhost:8123/ RewriteEngine on RewriteCond %{HTTP:Upgrade} =websocket [NC] From ce53c0e9f0e02d02ec827e3e83c1b9c03a3fe372 Mon Sep 17 00:00:00 2001 From: Benedict Aas Date: Sun, 15 Apr 2018 17:52:21 +0100 Subject: [PATCH 113/241] Add more math functions to templates (#5186) Document usage of `sin`, `cos`, `tan`, and `sqrt`, and the `e`, `pi`, and `tau` constants. --- source/_docs/configuration/templating.markdown | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index 6b3c34b0a0..9eafdece87 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -80,6 +80,13 @@ Home Assistant adds extensions to allow templates to access all of the current s - `float` will format the output as float. - `strptime(string, format)` will parse a string to a datetime based on a [format][strp-format]. - `log(value, base)` will take the logarithm of the input. When the base is omitted, it defaults to `e` - the natural logarithm. Can also be used as a filter. +- `sin(value)` will return the sine of the input. Can be used as a filter. +- `cos(value)` will return the cosine of the input. Can be used as a filter. +- `tan(value)` will return the tangent of the input. Can be used as a filter. +- `sqrt(value)` will return the square root of the input. Can be used as a filter. +- `e` mathematical constant, approximately 2.71828. +- `pi` mathematical constant, approximately 3.14159. +- `tau` mathematical constant, approximately 6.28318. - Filter `round(x)` will convert the input to a number and round it to `x` decimals. - Filter `timestamp_local` will convert an UNIX timestamp to local time/data. - Filter `timestamp_utc` will convert an UNIX timestamp to UTC time/data. @@ -274,6 +281,10 @@ The following overview contains a couple of options to get the needed values: {% raw %}{{ float(value_json) * (2**10) }}{% endraw %} {% raw %}{{ value_json | log }}{% endraw %} {% raw %}{{ log(1000, 10) }}{% endraw %} +{% raw %}{{ sin(pi / 2) }}{% endraw %} +{% raw %}{{ cos(tau) }}{% endraw %} +{% raw %}{{ tan(pi) }}{% endraw %} +{% raw %}{{ sqrt(e) }}{% endraw %} # Timestamps {% raw %}{{ value_json.tst | timestamp_local }}{% endraw %} From 0b5ee4d0c404e3f1f1d60fc945d878669eb88f18 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 15 Apr 2018 19:02:38 +0200 Subject: [PATCH 114/241] Move raw --- source/_components/light.mqtt.markdown | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/source/_components/light.mqtt.markdown b/source/_components/light.mqtt.markdown index eae91d0553..13e1cd9f86 100644 --- a/source/_components/light.mqtt.markdown +++ b/source/_components/light.mqtt.markdown @@ -204,6 +204,7 @@ In this section you will find some real life examples of how to use this sensor. To enable a light with brightness and RGB support in your installation, add the following to your `configuration.yaml` file: +{% raw %} ```yaml # Example configuration.yml entry light: @@ -215,14 +216,15 @@ light: brightness_command_topic: "office/rgb1/brightness/set" rgb_state_topic: "office/rgb1/rgb/status" rgb_command_topic: "office/rgb1/rgb/set" - state_value_template: "{% raw %}{{ value_json.state }}{% endraw %}" - brightness_value_template: "{% raw %}{{ value_json.brightness }}{% endraw %}" - rgb_value_template: "{% raw %}{{ value_json.rgb | join(',') }}{% endraw %}" + state_value_template: "{{ value_json.state }}" + brightness_value_template: "{{ value_json.brightness }}" + rgb_value_template: "{{ value_json.rgb | join(',') }}" qos: 0 payload_on: "ON" payload_off: "OFF" optimistic: false ``` +{% endraw %} ### {% linkable_title Brightness and no RGB support %} @@ -260,7 +262,6 @@ light: on_command_type: 'brightness' ``` - ### {% linkable_title Implementations %} - A [basic example](https://github.com/mertenats/open-home-automation/tree/master/ha_mqtt_light) using a nodeMCU board (ESP8266) to control its built-in LED (on/off). From 124a41c3bb84440ef7bb830211e6c6abe9861427 Mon Sep 17 00:00:00 2001 From: GaryOkie <37629938+GaryOkie@users.noreply.github.com> Date: Sun, 15 Apr 2018 13:34:29 -0500 Subject: [PATCH 115/241] Update cover.wink.markdown (#5187) * Update cover.wink.markdown I made a suggestion to W1ll1am to improving the doc to mention availability of the MyQ Cover. He said good call - go for it and edit it. * Remove whitespaces and empty lines --- source/_components/cover.wink.markdown | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/source/_components/cover.wink.markdown b/source/_components/cover.wink.markdown index 8e81d8ac79..8c82634187 100644 --- a/source/_components/cover.wink.markdown +++ b/source/_components/cover.wink.markdown @@ -13,24 +13,20 @@ ha_release: 0.13 ha_iot_class: "Cloud Polling" --- -Wink cover/garage door functionality depends on the product you're using. With GoControl/Linear Home Assistant can open, close, and view state. Chamberlain is currently limited to view only. Meaning Home Assistant will only show the current state of the door and control has been disabled (by Chamberlain). If you have a Chamberlain garage door, and would like to control it via Home Assistant, please contact Chamberlain and request that they re-enabled third-party control. +Wink Cover garage door functionality varies on the product. Home Assistant can open, close, and view state of GoControl/Linear openers. For Chamberlain MyQ-enabled openers, Home Assistant is limited to show current state (open or closed) only using this Wink cover. This restriction was imposed by Chamberlain for third party control. Wink suggests that MyQ customers should contact Chamberlain directly to inquire about expanding permissions. -The following quote is from Wink. - -> As part of our agreement with Chamberlain, third-party access to control Chamberlain garage doors has been restricted. Please contact Chamberlain directly to inquire about permissions. +The [MyQ Cover](/components/cover.myq/) does provide full functionality for opening and closing Chamberlain MyQ-enabled garage doors. If installed along with the Wink Component, a duplicate garage door entity may exist. In that case, the semi-functional Wink garage door entity can be hidden via customize.yaml. The requirement is that you have setup [Wink](/components/wink/). - ### {% linkable_title Supported cover devices %} - Bali window treatments - Lutron shades - Pella motorized blinds and shades - GoControl garage door opener -- Chamberlain (Limited functionality) (No Wink hub required) +- Chamberlain MyQ (Limited functionality) (No Wink hub required)

The above devices are confirmed to work, but others may work as well.

- From 9465ec0c1a9c50cc2651ca93df960a1c7da18d77 Mon Sep 17 00:00:00 2001 From: DubhAd Date: Mon, 16 Apr 2018 07:39:23 +0100 Subject: [PATCH 116/241] Adding list of supported components (#5191) Only the blog post says what components are supported, making it confusing for people. Adding that information to the docs. --- source/_docs/configuration/entity-registry.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_docs/configuration/entity-registry.markdown b/source/_docs/configuration/entity-registry.markdown index e31e014c32..6c75ad8dfe 100644 --- a/source/_docs/configuration/entity-registry.markdown +++ b/source/_docs/configuration/entity-registry.markdown @@ -52,3 +52,7 @@ value to each entry. cause integrations to fail and might be removed in the future. _Added in Home Assistant 0.64._ + +{% linkable_title Supported Components %} + +At the moment, only the following components are supported: Z-Wave, Hue, Nest, LIFX, Sonos, Apple TV From 65d8d892e6e3f9e50e9256ff1b35c2e08d3eee3e Mon Sep 17 00:00:00 2001 From: shred86 <32663154+shred86@users.noreply.github.com> Date: Mon, 16 Apr 2018 01:40:23 -0500 Subject: [PATCH 117/241] Update to lights (#5190) You cannot currently change the light color with this component. The dimmer functionality is currently in the dev branch and will hopefully be in the next HA update, so I left that in for now. --- source/_components/abode.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/abode.markdown b/source/_components/abode.markdown index 34ceaada84..87b689230b 100644 --- a/source/_components/abode.markdown +++ b/source/_components/abode.markdown @@ -24,7 +24,7 @@ There is currently support for the following device types within Home Assistant: - [Camera](/components/camera.abode/): Reports on `Camera` devices and will download and show the latest captured still image. - [Cover](/components/cover.abode/): Reports on `Secure Barriers` and can be used to open and close the cover. - [Lock](/components/cover.abode/): Reports on `Door Locks` and can be used to lock and unlock the door. -- [Light](/components/light.abode/): Reports on `Dimmer` lights and can be used to dim, change color, or turn the light on and off. +- [Light](/components/light.abode/): Reports on `Dimmer` lights and can be used to dim or turn the light on and off. - [Switch](/components/switch.abode/): Reports on `Power Switch` devices and can be used to turn the power switch on and off. Also reports on `Automations` set up in the Abode system and allows you to activate or deactivate them. - [Sensor](/components/sensor.abode/): Reports on `Temperature`, `Humidity`, and `Light` sensors. From 64df5f785a76db9eaa952c8eac252801a9dd2171 Mon Sep 17 00:00:00 2001 From: Robin Date: Mon, 16 Apr 2018 08:50:03 +0100 Subject: [PATCH 118/241] Propose edits to DuckDNS docs (#5181) * Propose reorder of config variables I've found this docs horribly confusing. `lets_encrypt.accept_terms` should appear at the top of the list as it's the first entered variable. Also this should become `required` as typically `optional` config variables are not displayed in the example config, but it is here. * Update duckdns.markdown * Minor changes --- source/_addons/duckdns.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/_addons/duckdns.markdown b/source/_addons/duckdns.markdown index 9c9049a066..13c8991667 100644 --- a/source/_addons/duckdns.markdown +++ b/source/_addons/duckdns.markdown @@ -26,10 +26,10 @@ featured: true Configuration variables: +- **lets_encrypt.accept_terms** (*Optional*): If you accept the [Let's Encrypt Subscriber Agreement][le], it will generate and update Let's Enrypt certificates for your DuckDNS domain. - **token** (*Required*): Your Duck DNS API key. - **domains** (*Required*): A list of domains to update DNS. -- **seconds** (*Optional*): Seconds between updates to Duck DNS. -- **lets_encrypt.accept_terms** (*Optional*): If you accept the [Let's Encrypt Subscriber Agreement][le], it will generate & update Let's Enrypt certificates for your DuckDNS domain. +- **seconds** (*Required*): Seconds between updates to Duck DNS. [le]: https://letsencrypt.org/repository/ @@ -51,3 +51,5 @@ If you use a port other than `8123` or an SSL proxy, change the port number acco You'll need to forward the port you listed in your configuration (8123 in the example above) on your router to your Home Assistant system. You can find guides on how to do this on [Port Forward](https://portforward.com/) - noting that you'll only need to forward the TCP port. Ensure that you allocate the Home Assistant system a fixed IP on your network before you configure port forwarding. You can do this either on the computer itself (see the [install guide](/hassio/installation/) or via a static lease on your router. + +Restart Home Assistant for the configured changes to take effect. When you access the Home Assistant frontend you will now need to use `https`, even when accessing local instances, for example at `https://192.168.0.1:8123`. From e607d1bf398628643c56dc0dc6c549a7d039b352 Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Mon, 16 Apr 2018 09:50:43 +0200 Subject: [PATCH 119/241] HA category updated (#5194) --- source/_components/device_tracker.xiaomi_miio.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.xiaomi_miio.markdown b/source/_components/device_tracker.xiaomi_miio.markdown index dad5feef5d..ae60404393 100644 --- a/source/_components/device_tracker.xiaomi_miio.markdown +++ b/source/_components/device_tracker.xiaomi_miio.markdown @@ -8,7 +8,7 @@ comments: false sharing: true footer: true logo: xiaomi.png -ha_category: Sensor +ha_category: Presence Detection ha_version: 0.67 ha_iot_class: "Local Polling" --- From 8fc39cb9db9dfbd67a8fd677c9640b376b79e297 Mon Sep 17 00:00:00 2001 From: Flavio Barisi Date: Mon, 16 Apr 2018 09:51:27 +0200 Subject: [PATCH 120/241] Update device_tracker.owntracks_http.markdown (#5172) * Update device_tracker.owntracks_http.markdown Show battery value reported by owntracks * Update device_tracker.owntracks_http.markdown Fix * Fix configuration sample --- .../device_tracker.owntracks_http.markdown | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/source/_components/device_tracker.owntracks_http.markdown b/source/_components/device_tracker.owntracks_http.markdown index a4aa847712..cadf1f4589 100644 --- a/source/_components/device_tracker.owntracks_http.markdown +++ b/source/_components/device_tracker.owntracks_http.markdown @@ -34,3 +34,30 @@ Open OwnTracks and go to Connection preferences: - Identification: Turn **Authentication** on, username `homeassistant` and password is your API password that you use to login to Home Assistant. Host example: If I host my Home Assistant at `https://example.duckdns.org`, my name is Paulus and my phone is a Pixel I would set the host to be `https://example.duckdns.org/api/owntracks/paulus/pixel`. This will result in an entity with an ID of `device_tracker.paulus_pixel`. You can pick any name for the user and the device. + +Since the battery data is available as an attribute of the device tracker entity, it can be tracked with a [`template` sensor](/components/sensor.template/). + +{% raw %} +```yaml +# Example configuration.yaml entry +sensor: + - platform: template + sensors: + pixel_battery: + friendly_name: Pixel of Paulus + unit_of_measurement: "%" + value_template: '{{ states.device_tracker.paulus_pixel.attributes.battery|int }}' + icon_template: >- + {% set battery_level = states.device_tracker.paulus_pixel.attributes.battery|default(0)|int %} + {% set battery_round = (battery_level / 10) |int * 10 %} + {% if battery_round >= 100 %} + mdi:battery + {% elif battery_round > 0 %} + mdi:battery-{{ battery_round }} + {% else %} + mdi:battery-alert + {% endif %} + entity_id: + - device_tracker.paulus_pixel +``` +{% endraw %} From cae7305fda3fb3db1d7a0b23a102061873276dfa Mon Sep 17 00:00:00 2001 From: Robin Date: Mon, 16 Apr 2018 14:27:36 +0100 Subject: [PATCH 121/241] Add info on whitelisting (#5197) Needs to be added as causing issues for users https://community.home-assistant.io/t/0-67-whitelisted-dir-issues/50305/5 --- source/_components/sensor.file.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.file.markdown b/source/_components/sensor.file.markdown index 2b541830ad..8ae7216a7d 100644 --- a/source/_components/sensor.file.markdown +++ b/source/_components/sensor.file.markdown @@ -14,7 +14,7 @@ ha_release: 0.45 --- -The `file` sensor platform reads the entries from a plain-text file and shows the found value. Only the last line of the file is used. This is similar to do `$ tail -n 1 sensor.txt` on the command-line. +The `file` sensor platform reads the entries from a plain-text file and shows the found value. Only the last line of the file is used. This is similar to do `$ tail -n 1 sensor.txt` on the command-line. Note that file paths must be added to [whitelist_external_dirs](/docs/configuration/basic/). To enable the `file` sensor, add the following lines to your `configuration.yaml`: From 6f7e6f5cdeb4f99ea4b5951a52e5f4397ed491b2 Mon Sep 17 00:00:00 2001 From: Kyle Niewiada Date: Mon, 16 Apr 2018 13:41:07 -0400 Subject: [PATCH 122/241] correct possible typo (#5176) --- source/_components/device_tracker.google_maps.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.google_maps.markdown b/source/_components/device_tracker.google_maps.markdown index 6f2175a604..5b16f3c785 100644 --- a/source/_components/device_tracker.google_maps.markdown +++ b/source/_components/device_tracker.google_maps.markdown @@ -20,7 +20,7 @@ You first need to create an additional Google account and share your location wi This platform will create a file named `google_maps_location_sharing.conf` where it caches your login session.

-Since this platform is using an official API with the help of [locationsharinglib](https://github.com/costastf/locationsharinglib), Google seems to block access to your data the first time you've logged in with this component. +Since this platform is using an unofficial API with the help of [locationsharinglib](https://github.com/costastf/locationsharinglib), Google seems to block access to your data the first time you've logged in with this component. This issue can be fixed by logging in with your new account and approving your login on the [Device Activity](https://myaccount.google.com/device-activity) page.

From 70af38b086588e2b4e1309de0241be3b2401ea34 Mon Sep 17 00:00:00 2001 From: Lincoln Kirchoff Date: Mon, 16 Apr 2018 13:34:50 -0500 Subject: [PATCH 123/241] Add climate.modbus module documentation (#4593) * Added climate.modbus module documentation * Update climate.modbus.markdown Updated IOT class Local Push to Local Polling. * Reviewed comments for changes Added configuration tags, removed optional configuration values, and set the correct release version. * Fixed formatting with the configuration settings * :arrow_up: ha_release -> 0.68 --- source/_components/climate.modbus.markdown | 70 ++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 source/_components/climate.modbus.markdown diff --git a/source/_components/climate.modbus.markdown b/source/_components/climate.modbus.markdown new file mode 100644 index 0000000000..f489d27a4b --- /dev/null +++ b/source/_components/climate.modbus.markdown @@ -0,0 +1,70 @@ +--- +layout: page +title: "Modbus" +description: "Instructions how to integrate a Modbus thermostat within Home Assistant." +date: 2018-01-29 9:35 +sidebar: true +comments: false +sharing: true +footer: true +logo: modbus.png +ha_category: Thermostat +ha_release: 0.68 +ha_iot_class: "Local Polling" +--- + + +The `modbus` thermostat allows you to use a sensor value (current temperature) +and target value (target temperature) from [Modbus](http://www.modbus.org/) +registers. + +To use your Modbus thermostat in your installation, add the following to your `configuration.yaml` file: + +```yaml +climate: + - platform: modbus + name: Watlow F4T + slave: 1 + target_temp_register: 2782 + current_temp_register: 27586 + +``` + +{% configuration %} +name: + description: Name of the device + required: true + type: string +slave: + description: The number of the slave (Optional for tcp and upd Modbus, use 1). + required: true + type: int +target_temp_register: + description: Register number for target temperature (Setpoint). + required: true + type: int +current_temp_register: + description: Register number for current temperature (Process value). + required: true + type: int +data_type: + description: Response representation (int, uint, float, custom). If float selected, value will converted to IEEE 754 floating point format. + Default float. + required: false + type: string +count: + description: Number of registers to read. + required: false + type: int +precision: + description: Number of valid decimals, default 0. + required: false + type: int +{% endconfiguration %} + + +### {% linkable_title Services %} + +| Service | Description | +| ------- | ----------- | +| set_temperature | Set Temperature. Requires `value` to be passed in, which is the desired target temperature. `value` should be in the same type as `data_type` | From 560108c659bbc1d89c28892ab1180c38917a947b Mon Sep 17 00:00:00 2001 From: Khole Date: Mon, 16 Apr 2018 20:01:43 +0100 Subject: [PATCH 124/241] Hive R3 update (#4974) * R3-Dev * R3 - Sensor Update --- source/_components/binary_sensor.hive.markdown | 2 +- source/_components/sensor.hive.markdown | 5 ++++- 2 files changed, 5 insertions(+), 2 deletions(-) diff --git a/source/_components/binary_sensor.hive.markdown b/source/_components/binary_sensor.hive.markdown index ef695f4601..ffba6e29d1 100644 --- a/source/_components/binary_sensor.hive.markdown +++ b/source/_components/binary_sensor.hive.markdown @@ -16,7 +16,7 @@ ha_iot_class: "Cloud Polling" The 'hive' binary sensor component integrates your Hive sensors into Home Assistant. -The Hive sensor component supports the following Hive products: +The Hive binary sensor component supports the following Hive products: - **Hive Window or Door Sensor** - **Hive Motion Sensor** diff --git a/source/_components/sensor.hive.markdown b/source/_components/sensor.hive.markdown index 3e7350e147..4fa0221f31 100644 --- a/source/_components/sensor.hive.markdown +++ b/source/_components/sensor.hive.markdown @@ -14,8 +14,11 @@ ha_iot_class: "Cloud Polling" --- -The 'hive' sensor component can expose as a sensor the current online status of your Hive Hub. +The 'hive' sensor component exposes hive data as a sensor. +The Hive sensor component exposes the following sensors: +- **Hive Hub Online Status** +- **Hive Outside Temperature**

Full configuration details can be found on the main [Hive component](/components/hive/) page. From d434247c54ea96678b3cc63a05bec5ed9b626121 Mon Sep 17 00:00:00 2001 From: Jonathan Weinberg Date: Mon, 16 Apr 2018 16:33:49 -0400 Subject: [PATCH 125/241] Spelling fix (#5198) `c` was missing. --- source/_addons/duckdns.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_addons/duckdns.markdown b/source/_addons/duckdns.markdown index 13c8991667..123e975e97 100644 --- a/source/_addons/duckdns.markdown +++ b/source/_addons/duckdns.markdown @@ -26,7 +26,7 @@ featured: true Configuration variables: -- **lets_encrypt.accept_terms** (*Optional*): If you accept the [Let's Encrypt Subscriber Agreement][le], it will generate and update Let's Enrypt certificates for your DuckDNS domain. +- **lets_encrypt.accept_terms** (*Optional*): If you accept the [Let's Encrypt Subscriber Agreement][le], it will generate and update Let's Encrypt certificates for your DuckDNS domain. - **token** (*Required*): Your Duck DNS API key. - **domains** (*Required*): A list of domains to update DNS. - **seconds** (*Required*): Seconds between updates to Duck DNS. From 078167bb033d76addaf27b8f406474604c07af6f Mon Sep 17 00:00:00 2001 From: Heiko Thiery Date: Tue, 17 Apr 2018 19:06:39 +0200 Subject: [PATCH 126/241] Add documentation for AVM fritzbox smarthome component (#4076) * Add documentation for fritzhome Signed-off-by: Heiko Thiery * change component name and configuration Signed-off-by: Heiko Thiery * followed review comments Signed-off-by: Heiko Thiery * another rename Signed-off-by: Heiko Thiery * remove default from host Signed-off-by: Heiko Thiery * add documentation for device attributes Signed-off-by: Heiko Thiery * bump to ha_release 0.65 Signed-off-by: Heiko Thiery * :pencil2: Some spelling and grammar fixes * :pencil2: Grammar and spelling updates * :pencil2: Small grammar & spelling changes * :arrow_up: ha_release -> 0.68 --- source/_components/climate.fritzbox.markdown | 28 ++++++++++ source/_components/fritzbox.markdown | 54 ++++++++++++++++++++ source/_components/switch.fritzbox.markdown | 31 +++++++++++ 3 files changed, 113 insertions(+) create mode 100644 source/_components/climate.fritzbox.markdown create mode 100644 source/_components/fritzbox.markdown create mode 100644 source/_components/switch.fritzbox.markdown diff --git a/source/_components/climate.fritzbox.markdown b/source/_components/climate.fritzbox.markdown new file mode 100644 index 0000000000..65975ca77c --- /dev/null +++ b/source/_components/climate.fritzbox.markdown @@ -0,0 +1,28 @@ +--- +layout: page +title: "Fritzbox Thermostat" +description: "Instructions on how to integrate the AVM Fritzbox thermostat." +date: 2017-11-12 17:10 +sidebar: true +comments: false +sharing: true +footer: true +logo: avm.png +ha_category: Climate +ha_release: 0.68 +ha_iot_class: "Local Polling" +--- + +

+To get AVM fritzbox thermostat follow the instructions for the general [Fritzbox](/components/fritzbox/). +

+ +### {% linkable_title Attributes %} + +The are several attributes that can be useful for automations and templates. + +| Attribute | Description | +| --------- | ----------- | +| `device_locked` | The state of the key lock at the device. +| `locked` | The state of the lock for configuring the device via the app or the Fritzbox web interface. +| `low_battery` | The low battery state indication. diff --git a/source/_components/fritzbox.markdown b/source/_components/fritzbox.markdown new file mode 100644 index 0000000000..8d601368eb --- /dev/null +++ b/source/_components/fritzbox.markdown @@ -0,0 +1,54 @@ +--- +layout: page +title: "Fritzbox" +description: "Instructions on how to integrate the AVM Fritzbox Smart Home components." +date: 2018-02-18 17:10 +sidebar: true +comments: false +sharing: true +footer: true +logo: avm.png +ha_category: Hub +ha_release: 0.68 +ha_iot_class: "Local Polling" +--- + +The [AVM](www.avm.de) Fritzbox component for Home Assistant allows you to integrate the switch and climate devices. + +#### {% linkable_title Tested Devices %} + +- [FRITZ!Box 6490 Cable](https://avm.de/produkte/fritzbox/fritzbox-6490-cable/) +- [FRITZ!DECT 200](https://avm.de/produkte/fritzdect/fritzdect-200/) +- [Eurotronic Comet DECT](https://www.eurotronic.org/produkte/comet-dect.html) + + +## {% linkable_title Setup %} + +```yaml +# Example configuration.yaml entry +fritzbox: + devices: + - host: fritz.box + username: YOUR_USERNAME + password: YOUR_PASSWORD +``` + +{% configuration %} + devices: + description: A list of Fritzbox devices. + required: true + type: map + keys: + host: + description: The hostname or IP address of the Fritzbox. + required: true + type: optional + username: + description: The username for Smart Home access. + required: true + type: string + password: + description: The password of the user. + required: true + type: string +{% endconfiguration %} diff --git a/source/_components/switch.fritzbox.markdown b/source/_components/switch.fritzbox.markdown new file mode 100644 index 0000000000..83657be0c8 --- /dev/null +++ b/source/_components/switch.fritzbox.markdown @@ -0,0 +1,31 @@ +--- +layout: page +title: "Fritzbox Switch" +description: "Instructions on how to integrate the AVM Fritzbox switch." +date: 2017-11-12 17:10 +sidebar: true +comments: false +sharing: true +footer: true +logo: avm.png +ha_category: Switch +ha_release: 0.68 +ha_iot_class: "Local Polling" +--- + +

+To get AVM Fritzbox switch follow the instructions for the general [Fritzbox](/components/fritzbox/). +

+ +### {% linkable_title Attributes %} + +The are several attributes that can be useful for automations and templates. + +| Attribute | Description | +| --------- | ----------- | +| `device_locked` | The state of the key lock at the device. +| `locked` | The state of the lock for configuring the device via the app or the Fritzbox web interface. +| `temperature_unit` | The unit of the temperature sensor (only available if the device support temperature sensor). +| `temperature` | The current temperature sensor reading (only available if the device supports temperature sensor). +| `total_consumption` | The total power consumption since the beginning of operation (only available if the device supports power meter function). +| `total_consumption_unit` | The unit of the total_consumption (only available if the device supports power meter function). From e1747451fce0a1fe71a49dc7200677087c6be2d8 Mon Sep 17 00:00:00 2001 From: ChristianKuehnel Date: Tue, 17 Apr 2018 19:10:16 +0200 Subject: [PATCH 127/241] bmw_connected_drive: added documentation for new services (#5055) * added documentation for the newly implemented services * added documentation for update_state service * improved documentation * :pencil2: Several improvements. --- .../_components/bmw_connected_drive.markdown | 34 ++++++++++++++++++- 1 file changed, 33 insertions(+), 1 deletion(-) diff --git a/source/_components/bmw_connected_drive.markdown b/source/_components/bmw_connected_drive.markdown index fe8cabc71a..fe2d698b94 100644 --- a/source/_components/bmw_connected_drive.markdown +++ b/source/_components/bmw_connected_drive.markdown @@ -12,7 +12,7 @@ ha_category: Hub ha_release: 0.64 --- -This component lets you retrieve data on your BMW vehicle from the BMW Connected Drive portal. You need to have a working BMW Connected Drive account and a Connected Drive enabled vehicle for this to work. +This component lets you retrieve data on your BMW vehicle from the BMW Connected Drive portal. You need to have a working BMW Connected Drive account, and a Connected Drive enabled vehicle for this to work. For compatibility with your BMW vehicle check the [bimmer_connected page](https://github.com/m1n3rva/bimmer_connected) on github. @@ -52,6 +52,38 @@ bmw_connected_drive: type: string {% endconfiguration %} +## {% linkable_title Services %} + +The `bmw_connected_drive` component offers several services. In case you need to provide the vehicle identification number (VIN) as a parameter, you can see the VIN in the attributes of the device tracker for the vehicle. The VIN is a 17 digit alphanumeric string, e.g., `WBANXXXXXX1234567`. + +Using these services will impact the state of your vehicle. So use these services with care! + +### {% linkable_title Locking and unlocking %} + +The vehicle can be locked and unlocked via the lock component that is created automatically for each vehicle. Before invoking these services, make sure it's safe to lock/unlock the vehicle in the current situation. + +### {% linkable_title Air condition %} + +The air condition of the vehicle can be activated with the service `bmw_connected_drive.activate_air_conditioning`. + +What exactly is started here depends on the type of vehicle. It might range from just ventilation over auxiliary heating to real air conditioning. If your vehicle is equipped with auxiliary heating, only trigger this service if the vehicle is parked in a location where it is safe to use it (e.g., not in an underground parking or closed garage). + +The vehicle is identified via the parameter `vin`. + +### {% linkable_title Sound the horn %} + +The service `bmw_connected_drive.sound_horn` sounds the horn of the vehicle. Use this feature responsibly, as it might annoy your neighbors. The vehicle is identified via the parameter `vin`. + +### {% linkable_title Flash the lights %} + +The service `bmw_connected_drive.light_flash' flashes the lights of the vehicle. The vehicle is identified via the parameter `vin`. + +### {% linkable_title Update the state %} + +The service `bmw_connected_drive.update_state`fetches the last state of the vehicles of all your accounts from the BMW server. This does *not* trigger an update from the vehicle; it gets the data from the BMW servers. So this service does *not* interact with your vehicles. + +This service does not require any attributes. + ## {% linkable_title Disclaimer %} This software is not affiliated with or endorsed by BMW Group. From 04560310f95a80d0d060192120ba914bf56902ea Mon Sep 17 00:00:00 2001 From: Robin Date: Tue, 17 Apr 2018 18:11:44 +0100 Subject: [PATCH 128/241] Adds Sigfox sensor docs (#5130) * Create sensor.sigfox.markdown * Adds name * Address reviewer comments * Update logo * Add files via upload * :pencil2: Markdown tweak --- source/_components/sensor.sigfox.markdown | 47 ++++++++++++++++++++++ source/images/supported_brands/sigfox.png | Bin 0 -> 334112 bytes 2 files changed, 47 insertions(+) create mode 100644 source/_components/sensor.sigfox.markdown create mode 100644 source/images/supported_brands/sigfox.png diff --git a/source/_components/sensor.sigfox.markdown b/source/_components/sensor.sigfox.markdown new file mode 100644 index 0000000000..f3f0bbb0ea --- /dev/null +++ b/source/_components/sensor.sigfox.markdown @@ -0,0 +1,47 @@ +--- +layout: page +title: "Sigfox Sensor" +description: "Display messages from Sigfox devices in Home Assistant." +date: 2018-04-07 12:10 +sidebar: true +comments: false +sharing: true +footer: true +logo: sigfox.png +ha_category: Sensor +ha_iot_class: "Local Polling" +ha_release: 0.68 +--- + +[SigFox](https://www.sigfox.com/en) component adding a sensor for each Sigfox device registered with your account. The default name of sensors is `sigfox_{DEVICE_ID}` where `DEVICE_ID` is the devices Sigfox ID. The state of an added Sigfox sensor is the payload of the last message published by that device. Additionally, there are attributes for the latitude and longitude coordinates of the device, as well as the signal-to-noise ratio ( [snr](https://en.wikipedia.org/wiki/Signal-to-noise_ratio)). + +```yaml +# Example configuration.yaml entry +sensor: + - platform: sigfox + api_login: your_api_login + api_password: your_api_password +``` + +{% configuration %} +api_login: + description: Your Sigfox API login. + required: true + type: string +api_password: + description: Your Sigfox API password. + required: true + type: string +name: + description: The name to prepend to the device ID. + required: false + default: "sigfox" + type: string +{% endconfiguration %} + +Note that `your_api_login` and `your_api_password` are your **API access credentials** which can be accessed by following: + +1. Log into [Sigfox backend](https://backend.sigfox.com) +1. Select `GROUP` +1. Select `API ACCESS` +1. Click on `new` and create new access entry diff --git a/source/images/supported_brands/sigfox.png b/source/images/supported_brands/sigfox.png new file mode 100644 index 0000000000000000000000000000000000000000..fdc7200ec810d5e80b21bfe53a70846eeb8b97f3 GIT binary patch literal 334112 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≷!sBkgW~`dmOAH#o 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 Z1LL6VkX_UjMC_$|MN;;+ Date: Wed, 18 Apr 2018 01:21:57 +0800 Subject: [PATCH 129/241] Enable broadcast of Facebook bot messages (#4688) * enable broadcast of FB bot messages this should go together with PR https://github.com/home-assistant/home-assistant/pull/12459 it enables FB messenger broadcast ability to send messages to all people who interacted with the bot previously and have the chat open. * fixes as per request from reviewer. fixes as per request from reviewer. FB -> Facebook fixed indents. (not sure what 2x for each level was), but I fixed it as per sample above. * Update notify.facebook.markdown * :pencil2: Tiny fixes * Update notify.facebook.markdown * Update notify.facebook.markdown * :rocket: Trigger rebuild --- source/_components/notify.facebook.markdown | 24 ++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/source/_components/notify.facebook.markdown b/source/_components/notify.facebook.markdown index beb539c559..5b4e497947 100644 --- a/source/_components/notify.facebook.markdown +++ b/source/_components/notify.facebook.markdown @@ -50,7 +50,7 @@ automation: - '+919784516314' ``` -You can also send messages to users that do not have stored their phone number with Facebook, but this requires a bit more work. The Messenger platform uses page specific user IDs instead of a global user ID. You will need to enable a webhook for the "messages" event in Facebook's developer console. Once a user writes a message to a page, that webhook will then receive the user's page specific ID as part of the webhook's payload. Below is a simple PHP script that reacts to the message "get my id" and sends a reply containing the user's ID: +You can also send messages to users that do not have stored their phone number on Facebook, but this requires a bit more work. The Messenger platform uses page-specific user IDs instead of a global user ID. You will need to enable a webhook for the "messages" event in Facebook's developer console. Once a user writes a message to a page, that webhook will then receive the user's page specific ID as part of the webhook's payload. Below is a simple PHP script that reacts to the message "get my id" and sends a reply containing the user's ID: ```php Date: Tue, 17 Apr 2018 19:39:59 +0200 Subject: [PATCH 130/241] Adds documentation for Kodi discovery (#5144) * describe discovery * :pencil2: Language tweaks --- source/_components/media_player.kodi.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_components/media_player.kodi.markdown b/source/_components/media_player.kodi.markdown index a59d19fe34..83689d4c1a 100644 --- a/source/_components/media_player.kodi.markdown +++ b/source/_components/media_player.kodi.markdown @@ -17,7 +17,9 @@ ha_iot_class: "Local Push" The `kodi` platform allows you to control a [Kodi](http://kodi.tv/) multimedia system from Home Assistant. -To add Kodi to your installation, add the following to your `configuration.yaml` file: +The preferred way to set up the Kodi platform is by enabling the [discovery component](https://www.home-assistant.io/components/discovery/) which requires enabled [web interface](https://kodi.wiki/view/Web_interface) on your Kodi installation. + +In case the discovery does not work, or you need specific configuration variables, you can add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry From 56f0a1a3c367fb955c271c679b68f1a026efbc97 Mon Sep 17 00:00:00 2001 From: Tod Schmidt Date: Tue, 17 Apr 2018 13:40:16 -0400 Subject: [PATCH 131/241] Added REST API for tts_get_url (#5173) * Added REST API for tts_get_url * :pencil2: Language tweaks --- source/_components/tts.markdown | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/source/_components/tts.markdown b/source/_components/tts.markdown index b1d1899135..5fc0d8de47 100644 --- a/source/_components/tts.markdown +++ b/source/_components/tts.markdown @@ -88,3 +88,33 @@ data_template: ## {% linkable_title Cache %} The component has two caches. Both caches can be controlled with the `cache` option in the platform configuration or the service call `say`. A long time cache will be located on the file system. The in-memory cache for fast responses to media players will be auto-cleaned after a short period. + +## {% linkable_title REST Api %} + +#### {% linkable_title POST /api/tts_get_url %} + +Returns an URL to the generated TTS file. Platform and message are required. + +```json +{ + "plaform": "amazon_polly", + "message": "I am speaking now" +} +``` + +The return code is 200 if the file is generated. The message body will contain a JSON object with the URL. + +```json +{ + "url": "http://127.0.0.1:8123/api/tts_proxy/265944c108cbb00b2a621be5930513e03a0bb2cd_en_-_demo.mp3" +} +``` + +Sample `curl` command: + +```bash +$ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \ + -H "Content-Type: application/json" \ + -d '{"message": "I am speaking now", "platform": "amazon_polly"}' \ + http://localhost:8123/api/tts_get_url +``` From b794665e79cf7b9fb2d03ca879743ef39b899047 Mon Sep 17 00:00:00 2001 From: Jaydev Shiroya Date: Tue, 17 Apr 2018 23:10:53 +0530 Subject: [PATCH 132/241] Update development_validation.markdown (#5201) Spelling Mistake --- 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 b629dcbe64..30b3dc77a8 100644 --- a/source/developers/development_validation.markdown +++ b/source/developers/development_validation.markdown @@ -21,7 +21,7 @@ Besides [voluptuous](https://pypi.python.org/pypi/voluptuous) default types, man - Time: `time`, `time_zone` - Misc: `template`, `slug`, `temperature_unit`, `latitude`, `longitude`, `isfile`, `sun_event`, `ensure_list`, `port`, `url`, and `icon` -To validate plaforms using [MQTT](/components/mqtt/), `valid_subscribe_topic` and `valid_publish_topic` are available. +To validate platforms using [MQTT](/components/mqtt/), `valid_subscribe_topic` and `valid_publish_topic` are available. Some things to keep in mind: From 26a9b298544e0d6c9398c2d40cfdaef0d806667c Mon Sep 17 00:00:00 2001 From: jcrowegitHu8 Date: Tue, 17 Apr 2018 12:54:29 -0500 Subject: [PATCH 133/241] Update media_player.samsungtv.markdown (#5202) --- source/_components/media_player.samsungtv.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/media_player.samsungtv.markdown b/source/_components/media_player.samsungtv.markdown index 53954f6693..d944b2b3a7 100644 --- a/source/_components/media_player.samsungtv.markdown +++ b/source/_components/media_player.samsungtv.markdown @@ -50,6 +50,7 @@ Currently known supported models: - EH5600 - F6400AF - F6400 +- F8000BF - D6505 - D6300SF - U6000 (port must be set to 8001) From 8f52412ebe00d25b3d024d6e69dc43d37b573f12 Mon Sep 17 00:00:00 2001 From: stephanerosi Date: Tue, 17 Apr 2018 19:55:51 +0200 Subject: [PATCH 134/241] Add examples on changing channel through play_media service (#5200) * Add examples on changing channel service As per following merge request https://github.com/home-assistant/home-assistant/pull/13934 * :pencil2: Language tweak --- .../_components/media_player.webostv.markdown | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/source/_components/media_player.webostv.markdown b/source/_components/media_player.webostv.markdown index 707ef55a90..0b1823db00 100644 --- a/source/_components/media_player.webostv.markdown +++ b/source/_components/media_player.webostv.markdown @@ -96,3 +96,27 @@ Any other [actions](/docs/automation/action/) to power on the device can be conf *Sources* To obtain complete list of available sources currently configured on the TV, once the webOS TV is configured and linked, while its powered on head to the **Developer Tools** > **States**, find your `media_player.` and use the sources listed in `source_list:` remembering to split them per line into your `sources:` configuration. + +### {% linkable_title Change channel through play_media service %} + +The `play_media` service can be used in a script to switch to the specified tv channel. +It selects the best matching cannel according to the `media_content_id` parameter: + 1. Channel number *(i.e. '1' or '6')* + 2. Exact channel name *(i.e. 'France 2' or 'CNN')* + 3. Substring in channel name *(i.e. 'BFM' in 'BFM TV')* + +```yaml +# Example action entry in script to switch to channel number 1 +service: media_player.play_media +data: + entity_id: media_player.lg_webos_smart_tv + media_content_id: 1 + media_content_type: "channel" + +# Example action entry in script to switch to channel including 'TF1' in its name +service: media_player.play_media +data: + entity_id: media_player.lg_webos_smart_tv + media_content_id: "TF1" + media_content_type: "channel" +``` From b2104a977069fa1368b9af289571109252b909e8 Mon Sep 17 00:00:00 2001 From: Nick Whyte Date: Wed, 18 Apr 2018 22:40:53 +1000 Subject: [PATCH 135/241] Doc for covers that only support `open_cover` and `close_cover` HomeKit (#5203) * Documentation for covers that only support `open_cover` and `close_cover` --- source/_components/homekit.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 3b9fb899d5..0d04e5cb23 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -198,6 +198,8 @@ The following components are currently supported: | climate | Thermostat | All climate devices. | | cover | GarageDoorOpener | All covers that support `open` and `close` and have `garage` as their `device_class`. | | cover | WindowCovering | All covers that support `set_cover_position`. | +| cover | WindowCovering | All covers that support `open_cover` and `close_cover` through value mapping. (`open` -> `>=50`; `close` -> `<50`) | +| cover | WindowCovering | All covers that support `open_cover`, `stop_cover` and `close_cover` through value mapping. (`open` -> `>70`; `close` -> `<30`; `stop` -> every value in between) | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | | lock | DoorLock | Support for `lock / unlock`. | | sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement` or `temperature` as their `device_class`. | From 444030d09fa7d505fbc2057868c070e2b5234df5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maximilian=20Fr=C3=BCh?= Date: Wed, 18 Apr 2018 19:35:03 +0200 Subject: [PATCH 136/241] Document the `headers` configuration parameter of the RESTful switch (#5196) * Document the `headers` configuration parameter of the RESTful switch * Fix indent --- source/_components/switch.rest.markdown | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/source/_components/switch.rest.markdown b/source/_components/switch.rest.markdown index db7b6e6e98..79388ff24b 100644 --- a/source/_components/switch.rest.markdown +++ b/source/_components/switch.rest.markdown @@ -66,6 +66,10 @@ password: description: The password for accessing the REST endpoint. required: false type: string +headers: + description: The headers for the request. + required: false + type: list, string {% endconfiguration %}

@@ -82,13 +86,17 @@ This example shows a switch that uses a [template](/topics/templating/) to allow {"is_active": "true"} ``` +{% raw %} ```yaml switch: - platform: rest resource: http://IP_ADDRESS/led_endpoint body_on: '{"active": "true"}' body_off: '{"active": "false"}' - is_on_template: '{% raw %}{{value_json.is_active}}{% endraw %}' + is_on_template: '{{value_json.is_active}}' + headers: + Content-Type: application/json ``` +{% endraw %} `body_on` and `body_off` can also depend on the state of the system. For example, to enable a remote temperature sensor tracking on a radio thermostat, one has to send the current value of the remote temperature sensor. This can be achieved by using the template `{% raw %}'{"rem_temp":{{states.sensor.bedroom_temp.state}}}'{% endraw %}`. From 12906f47afdb7954f82c2700330d6ab5522cc505 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Wed, 18 Apr 2018 22:30:17 -0400 Subject: [PATCH 137/241] Set published:true for Google Assistant docs --- source/cloud/google_assistant.markdown | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/cloud/google_assistant.markdown b/source/cloud/google_assistant.markdown index 155b2356a7..2e8661479c 100644 --- a/source/cloud/google_assistant.markdown +++ b/source/cloud/google_assistant.markdown @@ -7,7 +7,6 @@ sidebar: true comments: false sharing: true footer: true -published: false --- The Google Assistant integration allows users to control the entities via the Home Assistant Smart Home skill for Google Assistant. This means that you can say things like "Ok Google, turn on the kitchen light" to control your local Home Assistant. @@ -86,9 +85,5 @@ google_actions: description: Aliases that can also be used to refer to this entity required: false type: list - type: - description: Override the type of the entity in Google Assistant. [List of available types](https://developers.google.com/actions/smarthome/guides/) - required: false - type: string {% endconfiguration %} From 557867f26e44fdadc94f2eab92bedec465827f28 Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Thu, 19 Apr 2018 09:11:52 +0200 Subject: [PATCH 138/241] Support for multiple MAX!Cube LAN gateways (#5078) --- source/_components/maxcube.markdown | 32 +++++++++++++++++++++++++---- 1 file changed, 28 insertions(+), 4 deletions(-) diff --git a/source/_components/maxcube.markdown b/source/_components/maxcube.markdown index c9645e9fc5..69713a6469 100644 --- a/source/_components/maxcube.markdown +++ b/source/_components/maxcube.markdown @@ -25,13 +25,37 @@ Supported Devices: - MAX! Window Sensor (tested) - MAX! Wall Thermostat (tested) +### {% linkable_title One Gateway %} + A `maxcube` section must be present in the `configuration.yaml` file and contain the following options as required: ```yaml # Example configuration.yaml entry maxcube: - host: 192.168.0.20 + gateways: + - host: 192.168.0.20 ``` -Configuration variables: -- **host** (*Required*): The IP address of the eQ-3 MAX! Cube to use. -- **port** (*Optional*): The UDP port number. Defaults to `62910`. + +### {% linkable_title Multiple Gateways %} + +```yaml +# Example configuration.yaml entry +maxcube: + gateways: + - host: 192.168.0.20 + port: 62910 + - host: 192.168.0.21 + port: 62910 +``` + +{% configuration %} + host: + description: The IP address of the eQ-3 MAX! Cube to use. + required: true + type: string + port: + description: The UDP port number. + required: false + type: int + default: 62910 +{% endconfiguration %} From 7fd2f7da460ab5d3380c2e9b9393d44f3474de0f Mon Sep 17 00:00:00 2001 From: koolsb <14332595+koolsb@users.noreply.github.com> Date: Thu, 19 Apr 2018 04:32:07 -0500 Subject: [PATCH 139/241] Update onkyo media player (#5058) --- .../_components/media_player.onkyo.markdown | 23 +++++++++++++++---- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/source/_components/media_player.onkyo.markdown b/source/_components/media_player.onkyo.markdown index ca277f7706..0c6dc4d2d3 100644 --- a/source/_components/media_player.onkyo.markdown +++ b/source/_components/media_player.onkyo.markdown @@ -28,11 +28,24 @@ media_player: pc: 'HTPC' ``` -Configuration variables: - -- **host** (*Optional*): IP address of the device. Example:`192.168.1.2`. If not specified, the platform will load any discovered receivers. -- **name** (*Required if host is specified*): Name of the device. -- **sources** (*Optional*): A list of mappings from source to source name. Valid sources can be found below. A default list will be used if no source mapping is specified. +{% configuration %} +host: + description: IP address of the device. Example:`192.168.1.2`. If not specified, the platform will load any discovered receivers. + required: false + type: string +name: + description: Name of the device. (*Required if host is specified*) + required: false + type: string +sources: + description: A list of mappings from source to source name. Valid sources can be found below. A default list will be used if no source mapping is specified. + required: false + type: list +zone2: + description: Enables control for the receiver's second zone. + required: false + type: bool +{% endconfiguration %} List of source names: From 574e2213ba439fa360163d60c777a6d7a1c520d9 Mon Sep 17 00:00:00 2001 From: koolsb <14332595+koolsb@users.noreply.github.com> Date: Thu, 19 Apr 2018 04:35:48 -0500 Subject: [PATCH 140/241] Add blackbird media player component (#5056) --- .../media_player.blackbird.markdown | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 source/_components/media_player.blackbird.markdown diff --git a/source/_components/media_player.blackbird.markdown b/source/_components/media_player.blackbird.markdown new file mode 100644 index 0000000000..99873f1cc0 --- /dev/null +++ b/source/_components/media_player.blackbird.markdown @@ -0,0 +1,70 @@ +--- +layout: page +title: "Blackbird 8x8 HDMI Matrix Switch" +description: "Instructions on how to integrate Monoprice Blackbird 4k 8x8 HDBaseT Matrix Switch into Home Assistant." +date: 2018-03-29 16:35 +sidebar: true +comments: false +sharing: true +footer: true +logo: monoprice.svg +ha_category: Media Player +ha_release: 0.68 +ha_iot_class: "Local Polling" +--- + +The `blackbird` platform allows you to control [Monoprice Blackbird Matrix Switch](https://www.monoprice.com/product?p_id=21819) using a serial connection. + +To add a Blackbird device to your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +media_player: + - platform: blackbird + type: serial + port: /dev/ttyUSB0 + zones: + 1: + name: Living Room + sources: + 3: + name: BluRay +``` + +{% configuration %} +type: + description: The type of device connection - serial or socket + required: true + type: string +port: + description: The serial port to which Blackbird matrix switch is connected. Either port or host must be defined. + required: optional + type: string +host: + description: The IP address of the Blackbird matrix switch. Either port or host must be defined. + required: optional + type: string +zones: + description: This is the list of zones available. Valid zones are 1,2,3,4,5,6,7,8. Each zone must have a name assigned to it. + required: true + type: int + keys: + name: + description: The name of the zone. +sources: + description: The list of sources available. Valid source numbers are 1,2,3,4,5,6,7,8. Each source number corresponds to the input number on the Blackbird matrix switch. Similar to zones, each source must have a name assigned to it. + required: true + type: int + keys: + name: + description: The name of the source. +{% endconfiguration%} + +### {% linkable_title Service `BLACKBIRD_SETALLZONES` %} + +Set all zones to the same input source. This service allows you to immediately synchronize all the TVs in your home. Regardless of `entity_id` provided, all zones will be updated. + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `entity_id` | yes | String that points at an `entity_id` of a zone. +| `source` | no | String of source name to activate. From 945fb9b69e0336d39cd5fe97771a2bee7ef958e3 Mon Sep 17 00:00:00 2001 From: Viorel Stirbu Date: Thu, 19 Apr 2018 12:38:02 +0300 Subject: [PATCH 141/241] Add docs for Sensirion SHT31 sensor (#4848) --- source/_components/sensor.sht31.markdown | 52 +++++++++++++++++++ source/images/supported_brands/sensirion.png | Bin 0 -> 6578 bytes 2 files changed, 52 insertions(+) create mode 100644 source/_components/sensor.sht31.markdown create mode 100644 source/images/supported_brands/sensirion.png diff --git a/source/_components/sensor.sht31.markdown b/source/_components/sensor.sht31.markdown new file mode 100644 index 0000000000..73660bbbdc --- /dev/null +++ b/source/_components/sensor.sht31.markdown @@ -0,0 +1,52 @@ +--- +layout: page +title: "Sensirion SHT31 Sensor" +description: "Instructions on how to integrate SHT31 sensors within Home Assistant." +date: 2018-03-06 19:15 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: DIY +ha_release: 0.68 +logo: sensirion.png +ha_iot_class: "Local Polling" +--- + +The `sht31` sensor platform allows you to get the current temperature and humidity from a Sensirion SHT31 device. + +To use your SHT31 sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + platform: sht31 + name: Bedroom + i2c_address: 0x44 + monitored_conditions: + - temperature + - humidity +``` + +{% configuration %} + name: + description: The name of the sensor. Temperature and Humidity will be added to the name for the sensor name. + required: false + default: SHT31 + type: string + i2c_address: + description: I2C address of the sensor. + required: false + default: "`0x44`" + type: int + monitored_conditions: + description: Conditions to monitor. + required: false + default: All conditions + type: list + keys: + temperature: + description: The current temperature of the SHT31. + humidity: + description: The current humidity of the SHT31. +{% endconfiguration %} diff --git a/source/images/supported_brands/sensirion.png b/source/images/supported_brands/sensirion.png new file mode 100644 index 0000000000000000000000000000000000000000..4c0576cacdaad8b024683c2433ee5216762a8908 GIT binary patch literal 6578 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 Date: Thu, 19 Apr 2018 10:00:24 -0700 Subject: [PATCH 142/241] Update hass.markdown (#5193) --- source/_docs/tools/hass.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_docs/tools/hass.markdown b/source/_docs/tools/hass.markdown index 3ba0896f35..73e0bd68cd 100644 --- a/source/_docs/tools/hass.markdown +++ b/source/_docs/tools/hass.markdown @@ -39,6 +39,7 @@ optional arguments: specified days --log-file LOG_FILE Log file to write to. If not set, CONFIG/home- assistant.log is used + --log-no-color Disable color logs --runner On restart exit with code 100 --script ... Run one of the embedded scripts --daemon Run Home Assistant as daemon From b8627d6285213f43ab45498319721407432947bc Mon Sep 17 00:00:00 2001 From: Mark Perdue Date: Fri, 20 Apr 2018 08:16:37 -0400 Subject: [PATCH 143/241] Update attributes table to reflect closed PR (#5206) The PR https://github.com/home-assistant/home-assistant/pull/13816 has been withdrawn since it exposed static attributes which are not supported. Updating wiki to reflect current state --- source/_components/switch.vesync.markdown | 4 ---- 1 file changed, 4 deletions(-) diff --git a/source/_components/switch.vesync.markdown b/source/_components/switch.vesync.markdown index 83041ca78b..b02f476e93 100644 --- a/source/_components/switch.vesync.markdown +++ b/source/_components/switch.vesync.markdown @@ -45,7 +45,3 @@ VeSync switches will expose the following details. | ------------------- | ------------------------------------------------------------------- | --------------- | | `current_power_w` | The present power consumption of the switch in watts. | 100 | | `today_energy_kwh` | The kilowatt hours used by the switch during the previous 24 hours. | 0.12 | -| `connection_status` | The connection status of the switch. | online | -| `connection_type` | The connection type of the switch. | wifi | -| `device_type` | The device type of the switch. | wifi-switch-1.3 | -| `model` | The model of the switch. | wifi-switch | From 952aaf8aa0389e5bbfa540dd0f86a27484695c19 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 20 Apr 2018 14:36:47 -0400 Subject: [PATCH 144/241] Add release blog post --- source/_posts/2018-04-27-release-68.markdown | 489 +++++++++++++++++++ 1 file changed, 489 insertions(+) create mode 100644 source/_posts/2018-04-27-release-68.markdown diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown new file mode 100644 index 0000000000..788e068c7e --- /dev/null +++ b/source/_posts/2018-04-27-release-68.markdown @@ -0,0 +1,489 @@ +--- +layout: post +title: "0.68: UPDATE DATE" +description: "UPDATE DATE" +date: 2018-04-20 00:01:00 +date_formatted: "April 27, 2018" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Release-Notes +og_image: /images/blog/2018-04-0.68/components.png +--- + + + +Highlights: + +- Ability to _control_ HomeKit +- Eufy bulbs + +## New Platforms + +- Add support for Eufy bulbs and switches ([@mjg59] - [#13773]) ([eufy docs]) ([light.eufy docs]) ([switch.eufy docs]) (new-platform) +- Add support for controlling homekit lights and switches ([@mjg59] - [#13346]) ([homekit_controller docs]) ([light.homekit_controller docs]) (new-platform) +- Adding USCIS component ([@meauxt] - [#13764]) ([sensor.uscis docs]) (new-platform) +- Add support for new platform: climate.modbus ([@Kirchoff] - [#12224]) ([climate.modbus docs]) (new-platform) +- Add AVM fritzbox smarthome component ([@hthiery] - [#10688]) ([fritzbox docs]) ([climate.fritzbox docs]) ([switch.fritzbox docs]) (new-platform) +- Adds SigFox sensor ([@robmarkcole] - [#13731]) ([sensor.sigfox docs]) (new-platform) +- Add blackbird media player component ([@koolsb] - [#13549]) ([media_player.blackbird docs]) (new-platform) +- Add support for Sensirion SHT31 temperature/humidity sensor ([@viorels] - [#12952]) ([sensor.sht31 docs]) (new-platform) +- Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.lmsensor docs]) ([sensor.miflora docs]) (new-platform) + +## New Features + +- Support binary_sensor and device_tracker in HomeKit ([@Yonsm] - [#13735]) ([homekit docs]) (new-feature) +- Add Homekit locks support ([@philk] - [#13625]) ([homekit docs]) (new-feature) +- Support CO2/PM2.5/Light sensors in HomeKit ([@Yonsm] - [#13804]) ([homekit docs]) (new-feature) +- Support Garage Doors in HomeKit ([@marthoc] - [#13796]) ([homekit docs]) (new-feature) +- Support basic covers with open/close/stop services HomeKit ([@nickw444] - [#13819]) ([homekit docs]) (new-feature) + +## {% linkable_title If you need help... %} + +...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. + +## {% linkable_title Reporting Issues %} + +Experiencing issues introduced by this release? Please report them in our [issue tracker](https://github.com/home-assistant/home-assistant/issues). Make sure to fill in all fields of the issue template. + + +## Breaking Changes + +- Support for multiple MAX!Cube LAN gateways added ([@syssi] - [#13517]) ([maxcube docs]) ([binary_sensor.maxcube docs]) ([climate.maxcube docs]) (breaking change) +- Disable ebox requirement ([@balloob] - [#14003]) ([sensor.ebox docs]) (breaking change) + +## Beta Fixes + +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) + +## All changes + +- Update Homekit to 1.1.9 ([@cdce8p] - [#13716]) ([homekit docs]) +- Update docstrings ([@fabaff] - [#13720]) ([ihc docs]) ([cover.opengarage docs]) ([cover.tahoma docs]) ([light.aurora docs]) ([sensor.trafikverket_weatherstation docs]) +- Add option to ignore availability in google calendar events ([@cgtobi] - [#13714]) ([google docs]) ([calendar.google docs]) +- Allow use of date_string in service call ([@Juggels] - [#13256]) ([calendar.todoist docs]) +- Add timeout / debounce (for brightness and others) ([@cdce8p] - [#13534]) ([homekit docs]) +- added support for smappee water sensors ([@hmn] - [#12831]) ([smappee docs]) ([sensor.smappee docs]) +- Initialise filter_sensor with historical values ([@dgomes] - [#13075]) ([sensor.filter docs]) +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Bluesound bugfix status 595 and await ([@thrawnarn] - [#13727]) ([media_player.bluesound docs]) +- Upgrade aiohttp to 3.1.2 ([@fabaff] - [#13732]) +- Upgrade sqlalchemy to 1.2.6 ([@fabaff] - [#13733]) ([sensor.sql docs]) +- Brightness conversion for Abode dimmers ([@shred86] - [#13711]) ([light.abode docs]) +- Update CODEOWNERS (sensor.filter, sensor.upnp) ([@dgomes] - [#13736]) +- Reset permission ([@fabaff] - [#13743]) ([light.abode docs]) +- Throw an error when invalid device_mode is given ([@dangyuluo] - [#13739]) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Upgrade netdisco to 1.3.1 ([@fabaff] - [#13744]) +- Add MQTT Sensor unique_id ([@OttoWinter] - [#13318]) ([sensor.mqtt docs]) +- Prepare entity component for config entries ([@balloob] - [#13730]) +- Check valid file on get_size ([@robmarkcole] - [#13756]) ([sensor.folder docs]) +- Qwikswitch sensors ([@kellerza] - [#13622]) ([sensor.qwikswitch docs]) +- Device type mapping introduced to avoid breaking change ([@syssi] - [#13765]) ([light.yeelight docs]) +- Only flag media position as updated when it really has ([@molobrakos] - [#13737]) ([media_player.squeezebox docs]) +- Support binary_sensor and device_tracker in HomeKit ([@Yonsm] - [#13735]) ([homekit docs]) (new-feature) +- Use config entry to setup platforms ([@balloob] - [#13752]) ([hue docs]) ([light docs]) ([light.hue docs]) +- Add Homekit locks support ([@philk] - [#13625]) ([homekit docs]) (new-feature) +- Snips sounds ([@tschmidty69] - [#13746]) ([snips docs]) +- Add missing DISCHRG state ([@swilson] - [#13787]) ([sensor.nut docs]) +- Improved upgradeability HomeKit security_systems ([@cdce8p] - [#13783]) ([homekit docs]) +- Qwikswitch Entity Register ([@kellerza] - [#13791]) ([qwikswitch docs]) ([sensor.qwikswitch docs]) +- Updated beacontools to 1.2.3 ([@citruz] - [#13792]) ([sensor.eddystone_temperature docs]) +- script/lazytox: Ensure Flake8 passes for tests/ ([@kellerza] - [#13794]) +- Fix bad metrics format for short metrics. ([@michaelkuty] - [#13778]) ([prometheus docs]) +- Update bellows to 0.5.2 ([@rcloran] - [#13800]) ([zha docs]) +- device_tracker.ubus: Handle devices not running DHCP ([@tobygray] - [#13579]) ([device_tracker docs]) +- Update yweather.py ([@wiuwiu] - [#13802]) ([weather.yweather docs]) +- Tibber lib update ([@Danielhiversen] - [#13811]) ([sensor.tibber docs]) +- Update pyhomematic to 0.1.41 ([@danielperna84] - [#13814]) ([homematic docs]) +- Add support for Eufy bulbs and switches ([@mjg59] - [#13773]) ([eufy docs]) ([light.eufy docs]) ([switch.eufy docs]) (new-platform) +- Homekit refactor ([@cdce8p] - [#13707]) ([homekit docs]) +- HomeKit type_cover fix ([@cdce8p] - [#13832]) ([homekit docs]) +- Allow platform unloading ([@balloob] - [#13784]) ([hue docs]) ([light docs]) +- Support CO2/PM2.5/Light sensors in HomeKit ([@Yonsm] - [#13804]) ([homekit docs]) (new-feature) +- Clicksend: Added support for multiple recipients ([@xTCx] - [#13812]) ([notify docs]) +- Support Garage Doors in HomeKit ([@marthoc] - [#13796]) ([homekit docs]) (new-feature) +- Abode better events ([@MisterWil] - [#13809]) ([abode docs]) +- UPnP async ([@dgomes] - [#13666]) ([upnp docs]) ([sensor.upnp docs]) +- Update example (fixes #13834) ([@fabaff] - [#13839]) +- Add support for deCONZ daylight sensor ([@marthoc] - [#13479]) ([deconz docs]) ([sensor.deconz docs]) +- initialize queue before filtering ([@dgomes] - [#13842]) ([sensor.filter docs]) +- Extract config flow to own module ([@balloob] - [#13840]) ([config docs]) ([deconz docs]) ([hue docs]) +- Add support for controlling homekit lights and switches ([@mjg59] - [#13346]) ([homekit_controller docs]) ([light.homekit_controller docs]) (new-platform) +- bump python-ecobee-api version to 0.0.18 ([@geekofweek] - [#13854]) ([ecobee docs]) +- Adding USCIS component ([@meauxt] - [#13764]) ([sensor.uscis docs]) (new-platform) +- Avoid unnecessary cast state updates ([@dersger] - [#13770]) ([media_player.cast docs]) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Update yweather.py ([@TheCellMC] - [#13851]) ([weather.yweather docs]) +- add support for Kodi discovery ([@escoand] - [#13790]) ([media_player.kodi docs]) +- Further untangle data entry flow ([@balloob] - [#13855]) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Added snips service descriptions ([@tschmidty69] - [#13883]) +- Add unique_id for BMW ConnectedDrive ([@gerard33] - [#13888]) ([binary_sensor.bmw_connected_drive docs]) ([lock.bmw_connected_drive docs]) ([sensor.bmw_connected_drive docs]) +- Revert "Update yweather.py" ([@pvizeli] - [#13900]) ([weather.yweather docs]) +- Eufy colour bulb updates ([@mjg59] - [#13895]) ([eufy docs]) ([light.eufy docs]) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Fritzbox netmonitor name ([@escoand] - [#13903]) ([sensor.fritzbox_netmonitor docs]) +- Restore typeerror check for units sans energy tracking ([@andersonshatch] - [#13824]) ([switch.edimax docs]) +- Add more math functions to templates ([@Shou] - [#13915]) +- Upgrade pyqwikswitch to 0.71 ([@kellerza] - [#13920]) ([qwikswitch docs]) +- Add extra attributes for device scanner, Nmap and Unifi (IP, SSID, etc.) ([@stephanerosi] - [#13673]) ([device_tracker docs]) +- Fixed Capsman data not being used ([@Marco98] - [#13917]) ([device_tracker docs]) +- Broadlink Sensor - switch to connection-less mode ([@Paxy] - [#13761]) ([sensor.broadlink docs]) +- Add support for new platform: climate.modbus ([@Kirchoff] - [#12224]) ([climate.modbus docs]) (new-platform) +- Hive R3 update ([@KJonline] - [#13357]) ([hive docs]) ([binary_sensor.hive docs]) ([climate.hive docs]) ([light.hive docs]) ([sensor.hive docs]) ([switch.hive docs]) +- Updated foobot_async package version ([@reefab] - [#13942]) ([sensor.foobot docs]) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) +- Upgrade alpha_vantage to 2.0.0 ([@fabaff] - [#13943]) ([sensor.alpha_vantage docs]) +- Cleanup on exit ([@dgomes] - [#13918]) ([media_player.mediaroom docs]) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Add data entry flow helper ([@balloob] - [#13935]) ([config docs]) +- Xiaomi MiIO Device Tracker: Unused variable removed ([@syssi] - [#13948]) ([device_tracker docs]) +- Implement play media to set a channel based on (by priority): ([@stephanerosi] - [#13934]) ([media_player.webostv docs]) +- Update of python-mpd2 ([@karlkar] - [#13921]) ([media_player.mpd docs]) +- Add AVM fritzbox smarthome component ([@hthiery] - [#10688]) ([fritzbox docs]) ([climate.fritzbox docs]) ([switch.fritzbox docs]) (new-platform) +- Adds SigFox sensor ([@robmarkcole] - [#13731]) ([sensor.sigfox docs]) (new-platform) +- Upgrade aiohttp to 3.1.3 ([@fabaff] - [#13938]) +- Upgrade youtube_dl to 2018.04.16 ([@fabaff] - [#13937]) ([media_extractor docs]) +- Added FB messenger broadcast api to notify.facebook component ([@B1tMaster] - [#12459]) ([notify.facebook docs]) +- Added web view for TTS to get url ([@tschmidty69] - [#13882]) ([tts docs]) +- Add services for bmw_connected_drive ([@ChristianKuehnel] - [#13497]) ([bmw_connected_drive docs]) ([device_tracker docs]) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Bump deCONZ requirement to v36 ([@Kane610] - [#13960]) ([deconz docs]) +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Upgrade pyqwikswitch to 0.71 ([@kellerza] - [#13920]) ([qwikswitch docs]) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) +- Revert "Upgrade pyqwikswitch to 0.71 ([@balloob] - [#13920]) ([qwikswitch docs]) +- Bump skybellpy version to 0.1.2 ([@MisterWil] - [#13974]) ([skybell docs]) +- Fix typo an coding style ([@stephanerosi] - [#13970]) ([device_tracker docs]) +- Params of the send command can be a list now ([@syssi] - [#13905]) ([vacuum docs]) +- Support basic covers with open/close/stop services HomeKit ([@nickw444] - [#13819]) ([homekit docs]) (new-feature) +- Colorlog windows fix ([@veleek] - [#13929]) ([notify docs]) +- deCONZ migrate setup fully to config entry ([@Kane610] - [#13679]) ([deconz docs]) +- Alexa thermostat fails to properly parse 'value' field for climate ([@no2chem] - [#13958]) ([alexa docs]) +- renaming icons ([@NovapaX] - [#13982]) ([hdmi_cec docs]) ([vacuum docs]) ([vacuum.dyson docs]) ([vacuum.neato docs]) ([vacuum.roomba docs]) ([vacuum.xiaomi_miio docs]) +- Fix for Lokalise backend misinterpretation of keys ([@armills] - [#13986]) +- Bump locationsharinglib to 1.2.1 ([@thelittlefireman] - [#13980]) ([device_tracker docs]) +- Support for multiple MAX!Cube LAN gateways added ([@syssi] - [#13517]) ([maxcube docs]) ([binary_sensor.maxcube docs]) ([climate.maxcube docs]) (breaking change) +- Add additional receiver for Onkyo zone 2 ([@koolsb] - [#13551]) ([media_player.onkyo docs]) +- Add blackbird media player component ([@koolsb] - [#13549]) ([media_player.blackbird docs]) (new-platform) +- Add support for Sensirion SHT31 temperature/humidity sensor ([@viorels] - [#12952]) ([sensor.sht31 docs]) (new-platform) +- Useless code removed ([@syssi] - [#13996]) ([maxcube docs]) +- Add Homematic HmIP-SWO-PR weather sensor support ([@pascalhahn] - [#13904]) ([homematic docs]) +- Disable ebox requirement ([@balloob] - [#14003]) ([sensor.ebox docs]) (breaking change) +- Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.lmsensor docs]) ([sensor.miflora docs]) (new-platform) +- Log an error instead of raising an exception ([@syssi] - [#14006]) ([sensor.sht31 docs]) +- Tibber available ([@Danielhiversen] - [#13865]) ([sensor.tibber docs]) +- Upgrade pylutron-caseta to 0.5.0 to reestablish connections ([@rohankapoorcom] - [#14013]) ([lutron_caseta docs]) +- Add sensor device classes ([@balloob] - [#14010]) ([sensor docs]) ([sensor.ecobee docs]) ([sensor.linux_battery docs]) ([sensor.nest docs]) + +[#10688]: https://github.com/home-assistant/home-assistant/pull/10688 +[#12224]: https://github.com/home-assistant/home-assistant/pull/12224 +[#12459]: https://github.com/home-assistant/home-assistant/pull/12459 +[#12831]: https://github.com/home-assistant/home-assistant/pull/12831 +[#12952]: https://github.com/home-assistant/home-assistant/pull/12952 +[#13075]: https://github.com/home-assistant/home-assistant/pull/13075 +[#13256]: https://github.com/home-assistant/home-assistant/pull/13256 +[#13318]: https://github.com/home-assistant/home-assistant/pull/13318 +[#13346]: https://github.com/home-assistant/home-assistant/pull/13346 +[#13357]: https://github.com/home-assistant/home-assistant/pull/13357 +[#13479]: https://github.com/home-assistant/home-assistant/pull/13479 +[#13497]: https://github.com/home-assistant/home-assistant/pull/13497 +[#13517]: https://github.com/home-assistant/home-assistant/pull/13517 +[#13534]: https://github.com/home-assistant/home-assistant/pull/13534 +[#13549]: https://github.com/home-assistant/home-assistant/pull/13549 +[#13551]: https://github.com/home-assistant/home-assistant/pull/13551 +[#13579]: https://github.com/home-assistant/home-assistant/pull/13579 +[#13622]: https://github.com/home-assistant/home-assistant/pull/13622 +[#13625]: https://github.com/home-assistant/home-assistant/pull/13625 +[#13666]: https://github.com/home-assistant/home-assistant/pull/13666 +[#13673]: https://github.com/home-assistant/home-assistant/pull/13673 +[#13679]: https://github.com/home-assistant/home-assistant/pull/13679 +[#13707]: https://github.com/home-assistant/home-assistant/pull/13707 +[#13711]: https://github.com/home-assistant/home-assistant/pull/13711 +[#13714]: https://github.com/home-assistant/home-assistant/pull/13714 +[#13716]: https://github.com/home-assistant/home-assistant/pull/13716 +[#13720]: https://github.com/home-assistant/home-assistant/pull/13720 +[#13727]: https://github.com/home-assistant/home-assistant/pull/13727 +[#13728]: https://github.com/home-assistant/home-assistant/pull/13728 +[#13730]: https://github.com/home-assistant/home-assistant/pull/13730 +[#13731]: https://github.com/home-assistant/home-assistant/pull/13731 +[#13732]: https://github.com/home-assistant/home-assistant/pull/13732 +[#13733]: https://github.com/home-assistant/home-assistant/pull/13733 +[#13735]: https://github.com/home-assistant/home-assistant/pull/13735 +[#13736]: https://github.com/home-assistant/home-assistant/pull/13736 +[#13737]: https://github.com/home-assistant/home-assistant/pull/13737 +[#13739]: https://github.com/home-assistant/home-assistant/pull/13739 +[#13741]: https://github.com/home-assistant/home-assistant/pull/13741 +[#13743]: https://github.com/home-assistant/home-assistant/pull/13743 +[#13744]: https://github.com/home-assistant/home-assistant/pull/13744 +[#13746]: https://github.com/home-assistant/home-assistant/pull/13746 +[#13752]: https://github.com/home-assistant/home-assistant/pull/13752 +[#13756]: https://github.com/home-assistant/home-assistant/pull/13756 +[#13761]: https://github.com/home-assistant/home-assistant/pull/13761 +[#13764]: https://github.com/home-assistant/home-assistant/pull/13764 +[#13765]: https://github.com/home-assistant/home-assistant/pull/13765 +[#13770]: https://github.com/home-assistant/home-assistant/pull/13770 +[#13773]: https://github.com/home-assistant/home-assistant/pull/13773 +[#13778]: https://github.com/home-assistant/home-assistant/pull/13778 +[#13783]: https://github.com/home-assistant/home-assistant/pull/13783 +[#13784]: https://github.com/home-assistant/home-assistant/pull/13784 +[#13787]: https://github.com/home-assistant/home-assistant/pull/13787 +[#13790]: https://github.com/home-assistant/home-assistant/pull/13790 +[#13791]: https://github.com/home-assistant/home-assistant/pull/13791 +[#13792]: https://github.com/home-assistant/home-assistant/pull/13792 +[#13794]: https://github.com/home-assistant/home-assistant/pull/13794 +[#13796]: https://github.com/home-assistant/home-assistant/pull/13796 +[#13800]: https://github.com/home-assistant/home-assistant/pull/13800 +[#13802]: https://github.com/home-assistant/home-assistant/pull/13802 +[#13804]: https://github.com/home-assistant/home-assistant/pull/13804 +[#13809]: https://github.com/home-assistant/home-assistant/pull/13809 +[#13811]: https://github.com/home-assistant/home-assistant/pull/13811 +[#13812]: https://github.com/home-assistant/home-assistant/pull/13812 +[#13814]: https://github.com/home-assistant/home-assistant/pull/13814 +[#13819]: https://github.com/home-assistant/home-assistant/pull/13819 +[#13824]: https://github.com/home-assistant/home-assistant/pull/13824 +[#13832]: https://github.com/home-assistant/home-assistant/pull/13832 +[#13839]: https://github.com/home-assistant/home-assistant/pull/13839 +[#13840]: https://github.com/home-assistant/home-assistant/pull/13840 +[#13842]: https://github.com/home-assistant/home-assistant/pull/13842 +[#13851]: https://github.com/home-assistant/home-assistant/pull/13851 +[#13854]: https://github.com/home-assistant/home-assistant/pull/13854 +[#13855]: https://github.com/home-assistant/home-assistant/pull/13855 +[#13862]: https://github.com/home-assistant/home-assistant/pull/13862 +[#13865]: https://github.com/home-assistant/home-assistant/pull/13865 +[#13882]: https://github.com/home-assistant/home-assistant/pull/13882 +[#13883]: https://github.com/home-assistant/home-assistant/pull/13883 +[#13884]: https://github.com/home-assistant/home-assistant/pull/13884 +[#13887]: https://github.com/home-assistant/home-assistant/pull/13887 +[#13888]: https://github.com/home-assistant/home-assistant/pull/13888 +[#13889]: https://github.com/home-assistant/home-assistant/pull/13889 +[#13895]: https://github.com/home-assistant/home-assistant/pull/13895 +[#13900]: https://github.com/home-assistant/home-assistant/pull/13900 +[#13903]: https://github.com/home-assistant/home-assistant/pull/13903 +[#13904]: https://github.com/home-assistant/home-assistant/pull/13904 +[#13905]: https://github.com/home-assistant/home-assistant/pull/13905 +[#13906]: https://github.com/home-assistant/home-assistant/pull/13906 +[#13908]: https://github.com/home-assistant/home-assistant/pull/13908 +[#13915]: https://github.com/home-assistant/home-assistant/pull/13915 +[#13917]: https://github.com/home-assistant/home-assistant/pull/13917 +[#13918]: https://github.com/home-assistant/home-assistant/pull/13918 +[#13920]: https://github.com/home-assistant/home-assistant/pull/13920 +[#13921]: https://github.com/home-assistant/home-assistant/pull/13921 +[#13929]: https://github.com/home-assistant/home-assistant/pull/13929 +[#13934]: https://github.com/home-assistant/home-assistant/pull/13934 +[#13935]: https://github.com/home-assistant/home-assistant/pull/13935 +[#13937]: https://github.com/home-assistant/home-assistant/pull/13937 +[#13938]: https://github.com/home-assistant/home-assistant/pull/13938 +[#13940]: https://github.com/home-assistant/home-assistant/pull/13940 +[#13942]: https://github.com/home-assistant/home-assistant/pull/13942 +[#13943]: https://github.com/home-assistant/home-assistant/pull/13943 +[#13946]: https://github.com/home-assistant/home-assistant/pull/13946 +[#13948]: https://github.com/home-assistant/home-assistant/pull/13948 +[#13958]: https://github.com/home-assistant/home-assistant/pull/13958 +[#13960]: https://github.com/home-assistant/home-assistant/pull/13960 +[#13970]: https://github.com/home-assistant/home-assistant/pull/13970 +[#13974]: https://github.com/home-assistant/home-assistant/pull/13974 +[#13980]: https://github.com/home-assistant/home-assistant/pull/13980 +[#13982]: https://github.com/home-assistant/home-assistant/pull/13982 +[#13986]: https://github.com/home-assistant/home-assistant/pull/13986 +[#13996]: https://github.com/home-assistant/home-assistant/pull/13996 +[#14003]: https://github.com/home-assistant/home-assistant/pull/14003 +[#14005]: https://github.com/home-assistant/home-assistant/pull/14005 +[#14006]: https://github.com/home-assistant/home-assistant/pull/14006 +[#14010]: https://github.com/home-assistant/home-assistant/pull/14010 +[#14013]: https://github.com/home-assistant/home-assistant/pull/14013 +[@B1tMaster]: https://github.com/B1tMaster +[@ChristianKuehnel]: https://github.com/ChristianKuehnel +[@Danielhiversen]: https://github.com/Danielhiversen +[@Juggels]: https://github.com/Juggels +[@KJonline]: https://github.com/KJonline +[@Kane610]: https://github.com/Kane610 +[@Kirchoff]: https://github.com/Kirchoff +[@Marco98]: https://github.com/Marco98 +[@MisterWil]: https://github.com/MisterWil +[@NovapaX]: https://github.com/NovapaX +[@OttoWinter]: https://github.com/OttoWinter +[@Paxy]: https://github.com/Paxy +[@Shou]: https://github.com/Shou +[@TheCellMC]: https://github.com/TheCellMC +[@Yonsm]: https://github.com/Yonsm +[@aav7fl]: https://github.com/aav7fl +[@andersonshatch]: https://github.com/andersonshatch +[@armills]: https://github.com/armills +[@balloob]: https://github.com/balloob +[@cdce8p]: https://github.com/cdce8p +[@cgtobi]: https://github.com/cgtobi +[@citruz]: https://github.com/citruz +[@dangyuluo]: https://github.com/dangyuluo +[@danielperna84]: https://github.com/danielperna84 +[@dersger]: https://github.com/dersger +[@dgomes]: https://github.com/dgomes +[@dlbroadfoot]: https://github.com/dlbroadfoot +[@escoand]: https://github.com/escoand +[@fabaff]: https://github.com/fabaff +[@geekofweek]: https://github.com/geekofweek +[@gerard33]: https://github.com/gerard33 +[@hmn]: https://github.com/hmn +[@hthiery]: https://github.com/hthiery +[@karlkar]: https://github.com/karlkar +[@kellerza]: https://github.com/kellerza +[@koolsb]: https://github.com/koolsb +[@marthoc]: https://github.com/marthoc +[@meauxt]: https://github.com/meauxt +[@michaelkuty]: https://github.com/michaelkuty +[@mjg59]: https://github.com/mjg59 +[@molobrakos]: https://github.com/molobrakos +[@nickw444]: https://github.com/nickw444 +[@no2chem]: https://github.com/no2chem +[@pascalhahn]: https://github.com/pascalhahn +[@philk]: https://github.com/philk +[@pvizeli]: https://github.com/pvizeli +[@rcloran]: https://github.com/rcloran +[@reefab]: https://github.com/reefab +[@robmarkcole]: https://github.com/robmarkcole +[@rohankapoorcom]: https://github.com/rohankapoorcom +[@shred86]: https://github.com/shred86 +[@stephanerosi]: https://github.com/stephanerosi +[@swilson]: https://github.com/swilson +[@syssi]: https://github.com/syssi +[@thelittlefireman]: https://github.com/thelittlefireman +[@thrawnarn]: https://github.com/thrawnarn +[@titilambert]: https://github.com/titilambert +[@tobygray]: https://github.com/tobygray +[@tschmidty69]: https://github.com/tschmidty69 +[@veleek]: https://github.com/veleek +[@viorels]: https://github.com/viorels +[@wiuwiu]: https://github.com/wiuwiu +[@xTCx]: https://github.com/xTCx +[abode docs]: /components/abode/ +[alexa docs]: /components/alexa/ +[binary_sensor.bmw_connected_drive docs]: /components/binary_sensor.bmw_connected_drive/ +[binary_sensor.hive docs]: /components/binary_sensor.hive/ +[binary_sensor.maxcube docs]: /components/binary_sensor.maxcube/ +[bmw_connected_drive docs]: /components/bmw_connected_drive/ +[calendar.google docs]: /components/calendar.google/ +[calendar.todoist docs]: /components/calendar.todoist/ +[climate.fritzbox docs]: /components/climate.fritzbox/ +[climate.hive docs]: /components/climate.hive/ +[climate.honeywell docs]: /components/climate.honeywell/ +[climate.maxcube docs]: /components/climate.maxcube/ +[climate.modbus docs]: /components/climate.modbus/ +[config docs]: /components/config/ +[cover.opengarage docs]: /components/cover.opengarage/ +[cover.tahoma docs]: /components/cover.tahoma/ +[deconz docs]: /components/deconz/ +[device_tracker docs]: /components/device_tracker/ +[ecobee docs]: /components/ecobee/ +[eufy docs]: /components/eufy/ +[fan.xiaomi_miio docs]: /components/fan.xiaomi_miio/ +[fritzbox docs]: /components/fritzbox/ +[google docs]: /components/google/ +[hdmi_cec docs]: /components/hdmi_cec/ +[hive docs]: /components/hive/ +[homekit docs]: /components/homekit/ +[homekit_controller docs]: /components/homekit_controller/ +[homematic docs]: /components/homematic/ +[hue docs]: /components/hue/ +[ihc docs]: /components/ihc/ +[light docs]: /components/light/ +[light.abode docs]: /components/light.abode/ +[light.aurora docs]: /components/light.aurora/ +[light.eufy docs]: /components/light.eufy/ +[light.hive docs]: /components/light.hive/ +[light.homekit_controller docs]: /components/light.homekit_controller/ +[light.hue docs]: /components/light.hue/ +[light.yeelight docs]: /components/light.yeelight/ +[lock.bmw_connected_drive docs]: /components/lock.bmw_connected_drive/ +[lutron_caseta docs]: /components/lutron_caseta/ +[maxcube docs]: /components/maxcube/ +[media_extractor docs]: /components/media_extractor/ +[media_player.blackbird docs]: /components/media_player.blackbird/ +[media_player.bluesound docs]: /components/media_player.bluesound/ +[media_player.cast docs]: /components/media_player.cast/ +[media_player.kodi docs]: /components/media_player.kodi/ +[media_player.mediaroom docs]: /components/media_player.mediaroom/ +[media_player.mpd docs]: /components/media_player.mpd/ +[media_player.onkyo docs]: /components/media_player.onkyo/ +[media_player.squeezebox docs]: /components/media_player.squeezebox/ +[media_player.webostv docs]: /components/media_player.webostv/ +[notify docs]: /components/notify/ +[notify.facebook docs]: /components/notify.facebook/ +[prometheus docs]: /components/prometheus/ +[qwikswitch docs]: /components/qwikswitch/ +[sensor docs]: /components/sensor/ +[sensor.alpha_vantage docs]: /components/sensor.alpha_vantage/ +[sensor.bmw_connected_drive docs]: /components/sensor.bmw_connected_drive/ +[sensor.broadlink docs]: /components/sensor.broadlink/ +[sensor.deconz docs]: /components/sensor.deconz/ +[sensor.ebox docs]: /components/sensor.ebox/ +[sensor.ecobee docs]: /components/sensor.ecobee/ +[sensor.eddystone_temperature docs]: /components/sensor.eddystone_temperature/ +[sensor.filter docs]: /components/sensor.filter/ +[sensor.folder docs]: /components/sensor.folder/ +[sensor.foobot docs]: /components/sensor.foobot/ +[sensor.fritzbox_netmonitor docs]: /components/sensor.fritzbox_netmonitor/ +[sensor.hive docs]: /components/sensor.hive/ +[sensor.hydroquebec docs]: /components/sensor.hydroquebec/ +[sensor.linux_battery docs]: /components/sensor.linux_battery/ +[sensor.lmsensor docs]: /components/sensor.lmsensor/ +[sensor.miflora docs]: /components/sensor.miflora/ +[sensor.mqtt docs]: /components/sensor.mqtt/ +[sensor.nest docs]: /components/sensor.nest/ +[sensor.nut docs]: /components/sensor.nut/ +[sensor.qwikswitch docs]: /components/sensor.qwikswitch/ +[sensor.sht31 docs]: /components/sensor.sht31/ +[sensor.sigfox docs]: /components/sensor.sigfox/ +[sensor.smappee docs]: /components/sensor.smappee/ +[sensor.sql docs]: /components/sensor.sql/ +[sensor.tibber docs]: /components/sensor.tibber/ +[sensor.trafikverket_weatherstation docs]: /components/sensor.trafikverket_weatherstation/ +[sensor.upnp docs]: /components/sensor.upnp/ +[sensor.uscis docs]: /components/sensor.uscis/ +[skybell docs]: /components/skybell/ +[smappee docs]: /components/smappee/ +[snips docs]: /components/snips/ +[switch.broadlink docs]: /components/switch.broadlink/ +[switch.edimax docs]: /components/switch.edimax/ +[switch.eufy docs]: /components/switch.eufy/ +[switch.fritzbox docs]: /components/switch.fritzbox/ +[switch.hive docs]: /components/switch.hive/ +[switch.vesync docs]: /components/switch.vesync/ +[tts docs]: /components/tts/ +[upnp docs]: /components/upnp/ +[vacuum docs]: /components/vacuum/ +[vacuum.dyson docs]: /components/vacuum.dyson/ +[vacuum.neato docs]: /components/vacuum.neato/ +[vacuum.roomba docs]: /components/vacuum.roomba/ +[vacuum.xiaomi_miio docs]: /components/vacuum.xiaomi_miio/ +[weather.yweather docs]: /components/weather.yweather/ +[zha docs]: /components/zha/ From 329393788f24ece40c83a027653fb3d488fd4392 Mon Sep 17 00:00:00 2001 From: Rob Cranfill Date: Fri, 20 Apr 2018 14:28:16 -0700 Subject: [PATCH 145/241] Fix typo homekit.markdown (#5209) Fixed very minor typo ("if the are supported"' -> "if they are supported"). --- source/_components/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 5ca13b0f2b..fe0ff4c05e 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -87,7 +87,7 @@ To enable the `HomeKit` component in Home Assistant, add the following to your c homekit: ``` -After Home Assistant has started, the entities specified by the filter are exposed to `HomeKit` if the are [supported](#supported-components). To add them: +After Home Assistant has started, the entities specified by the filter are exposed to `HomeKit` if they are [supported](#supported-components). To add them: 1. Open the Home Assistant frontend. A new card will display the `pin code`. 1. Open the `Home` app. 2. Choose `Add Accessory`, than select `Don't Have a Code or Can't Scan?` and enter the `pin code`. From 6c90dedce57b873c4387a3c5613af1b98cd01047 Mon Sep 17 00:00:00 2001 From: Rob Cranfill Date: Fri, 20 Apr 2018 14:30:06 -0700 Subject: [PATCH 146/241] Update homekit.markdown (#5207) Minor grammar fixes. (Thanks for a great product!) --- source/_components/homekit.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index fe0ff4c05e..68ac4cb460 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -12,7 +12,7 @@ ha_release: 0.64 logo: apple-homekit.png --- -The `HomeKit` component allows you to forward entities from Home Assistant to Apple `HomeKit`, so they could be controlled from Apple `Home` app and `Siri`. Please make sure that you have read the [considerations](#considerations) listed below to save you some trouble later. +The `HomeKit` component allows you to forward entities from Home Assistant to Apple `HomeKit`, so they can be controlled from Apple's `Home` app and `Siri`. Please make sure that you have read the [considerations](#considerations) listed below to save you some trouble later.

It might be necessary to install an additional package: @@ -107,7 +107,7 @@ Currently this component uses the `entity_id` to generate a unique `accessory id ### {% linkable_title Persistence Storage %} -Unfortunately `HomeKit` doesn't support any kind of persistence storage, only the configuration for accessories that are added to the `Home Assistant Bridge` are kept. To avoid problems it is recommended to use an automation to always start `HomeKit` with at least the same entities setup. If for some reason some entities are not setup, their config will be deleted. (State unknown or similar will not cause any issues.) +Unfortunately `HomeKit` doesn't support any kind of persistent storage - only the configuration for accessories that are added to the `Home Assistant Bridge` are kept. To avoid problems it is recommended to use an automation to always start `HomeKit` with at least the same entities setup. If for some reason some entities are not setup, their config will be deleted. (State unknown or similar will not cause any issues.) A common situation might be if you decide to disable parts of the configuration for testing. Please make sure to disable `auto start` and `turn off` the `Start HomeKit` automation (if you have one). From 21ed92fb92b7b298c08a139842771032b133d46c Mon Sep 17 00:00:00 2001 From: Brian Hanifin Date: Sat, 21 Apr 2018 17:06:31 -0700 Subject: [PATCH 147/241] Change Page Title to "Homekit Switch" (#5222) * Change Page Title to "Homekit Switch" It was left titled "Homekit Light" when first published. * Minor cleanup --- source/_components/switch.homekit_controller.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/switch.homekit_controller.markdown b/source/_components/switch.homekit_controller.markdown index 205316bdf2..43bf3be57b 100644 --- a/source/_components/switch.homekit_controller.markdown +++ b/source/_components/switch.homekit_controller.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "HomeKit Light" -description: "Instructions how to setup HomeKit switches within Home Assistant." +title: "HomeKit Switch" +description: "Instructions on how to setup HomeKit switches within Home Assistant." date: 2017-03-19 21:08 sidebar: true comments: false From 8eae78cb349ee3a71a739f73f242ff3c07baf6fc Mon Sep 17 00:00:00 2001 From: Ben Lebherz Date: Sun, 22 Apr 2018 21:42:21 +0200 Subject: [PATCH 148/241] fix link to the TTN sensor page (#5218) --- source/_components/thethingsnetwork.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/thethingsnetwork.markdown b/source/_components/thethingsnetwork.markdown index 65211c241d..328022f6cc 100644 --- a/source/_components/thethingsnetwork.markdown +++ b/source/_components/thethingsnetwork.markdown @@ -20,7 +20,7 @@ The Things network support various integrations to make the data available: | The Things Network Integration | Home Assistant platform | |---|---| | [MQTT](https://www.thethingsnetwork.org/docs/applications/mqtt/) | | -| [Storage](https://www.thethingsnetwork.org/docs/applications/storage/) | [`thethingsnetwork`](/component/sensor.thethingsnetwork/) | +| [Storage](https://www.thethingsnetwork.org/docs/applications/storage/) | [`thethingsnetwork`](/components/sensor.thethingsnetwork/) | | [HTTP](https://www.thethingsnetwork.org/docs/applications/http/) | | ### {% linkable_title Setup %} From 00d950773e8a8c5ba365f9f7c599df5c21e9e9f2 Mon Sep 17 00:00:00 2001 From: Marcelo Moreira de Mello Date: Sun, 22 Apr 2018 15:49:27 -0400 Subject: [PATCH 149/241] Updated watering_minutes with the allowed values (#5225) --- source/_components/switch.raincloud.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.raincloud.markdown b/source/_components/switch.raincloud.markdown index e5cbc2d070..2e2af72de8 100644 --- a/source/_components/switch.raincloud.markdown +++ b/source/_components/switch.raincloud.markdown @@ -25,7 +25,7 @@ switch: Configuration variables: -- **watering_minutes** (*Optional*): Value in minutes to watering your garden via frontend. Defaults to 15. +- **watering_minutes** (*Optional*): Value in minutes to watering your garden via frontend. Defaults to 15. The values allowed are: 5, 10, 15, 30, 45, 60. - **monitored_conditions** array (*Optional*): Conditions to display in the frontend. If not specified, all conditions below will be enabled by default. The following conditions can be monitored. - **auto_watering**: Toggle the watering scheduled per zone. - **manual_watering**: Toggle manually the watering per zone. It will inherent the value in minutes specified on the RainCloud hub component. From 10db3b3f9e7348af37776d67ff4f8ce9c9a0b84e Mon Sep 17 00:00:00 2001 From: Pascal Vizeli Date: Sun, 22 Apr 2018 22:26:58 +0200 Subject: [PATCH 150/241] Blogpost Hass.io 2018 (#5233) * Create 2018-04-22-hassio-2018.markdown * Update 2018-04-22-hassio-2018.markdown * Update 2018-04-22-hassio-2018.markdown * Create test * Add files via upload * Delete test * Update 2018-04-22-hassio-2018.markdown * Delete blogpost.png * Create test * Add files via upload * Delete test * Update 2018-04-22-hassio-2018.markdown * Update 2018-04-22-hassio-2018.markdown * Update 2018-04-22-hassio-2018.markdown * Update 2018-04-22-hassio-2018.markdown * Update 2018-04-22-hassio-2018.markdown --- source/_posts/2018-04-22-hassio-2018.markdown | 64 ++++++++++++++++++ .../blog/2018-04-hassio-2018/blogpost.png | Bin 0 -> 42047 bytes 2 files changed, 64 insertions(+) create mode 100644 source/_posts/2018-04-22-hassio-2018.markdown create mode 100644 source/images/blog/2018-04-hassio-2018/blogpost.png diff --git a/source/_posts/2018-04-22-hassio-2018.markdown b/source/_posts/2018-04-22-hassio-2018.markdown new file mode 100644 index 0000000000..2562d41772 --- /dev/null +++ b/source/_posts/2018-04-22-hassio-2018.markdown @@ -0,0 +1,64 @@ +--- +layout: post +title: "Hass.io 2018" +description: "We want to clarify how Hass.io relates to Home Assistant and talk about the roadmap for Hass.io in 2018." +date: 2018-04-22 00:00:00 +date_formatted: "April 22, 2018" +author: Pascal Vizeli +author_twitter: pvizeli +comments: true +categories: Announcements +og_image: /images/blog/2018-04-hassio-2018/blogpost.png +--- + +We noticed that there is some confusion in the community about how Hass.io relates to Home Assistant and what impact the upcoming Hass.io changes will have. We will try to clarify it all in this blog post. + +## {% linkable_title What is Hass.io %} +Hass.io is a complete solution to run Home Assistant, by the authors of Home Assistant. The goal of Hass.io is to provide an easy to use and secure system, entirely managed from within the Home Assistant user interface. + +Hass.io is a complete solution, which means that it comes with its own highly secure and optimized operating system, a supervisor application to maintain and configure that system, and of course Home Assistant itself. + +When using Hass.io, you'll see a new Hass.io panel inside the Home Assistant UI. From here users can configure the system and install Home Assistant updates with a simple click of a button. Users are also able to make snapshots of their system, making it easy to migrate all their configuration to a new system or restore their system to a previous state. + +We wanted to be able to provide the convenience of seamless updates and configuration via the UI to other applications too, and so we introduced Hass.io add-ons. Any application can be packaged up as a Hass.io add-on, allowing any user to install and manage it easily. Since the introduction, we’ve seen an amazing growth in users sharing their add-ons with the community. It’s now possible to install an adblocker for your network, an MQTT broker or Tor with a single click. + +## {% linkable_title Upcoming changes to Hass.io %} +We’ve introduced Hass.io [last July]. Since then, we’ve noticed some room for improvements in making Hass.io easier to use, lighter to maintain and easier to integrate with other host systems. + +Note that the descriptions of upcoming improvements can get quite technical. Feel free to jump to [the conclusion]. + +### {% linkable_title Automatic add-on configuration %} +Home Assistant has recently introduced configuration entries. We’re going to hook into this new functionality and allow add-ons to configure their related integration in Home Assistant automatically. For example, if a user installs the MQTT broker add-on, we will automatically set up Home Assistant to connect to it. + +### {% linkable_title Host management %} +To control the host system, we currently use a custom service called HostControl. This allows the user to manage here host and restart/shutdown the computer from within Home Assistant. Instead of relying on our own system, we’re going to change to use D-Bus. D-Bus is a standardized mechanism for services and applications to communicate. Using a defined standard means that all parts of the host can now be remotely configured: sound, network, etc, etc. We will be extending the Hass.io panel in Home Assistant with controls to configure various parts of the host. + +### {% linkable_title Hass.io OS %} +Hass.io is currently using a forked version of ResinOS as our operating system. ResinOS has been designed to run a minimal environment for Docker, simple over the air updates and connect to the ResinIO cloud. Our fork removed the ResinIO logic. Over time, ResinOS has been evolving but not in a direction that is aligned with our goals, resulting in the maintenance of our fork to take up a lot of time. + +The ResinOS build system is based on the Yocto Project. This is a very powerful system, but also requires specific support for each hardware platform need to be specifically added and maintained (like each version of Raspberry Pi), which caused long build and development times for Hass.io. + +All these factors made us decide to build our own, custom, operating system. We’re obviously not starting from scratch, but instead, are basing it off [Buildroot] as the foundation and use [RAUC] for over the air updates. + +Some things that the new operating system will be able to do: +- Adding support for new hardware will be easy. Creating new builds for, e.g., a new Raspberry Pi model should be a matter of days, not months. +- Updating will be atomic and has a Fail-safe. If a system fails to boot after an OS upgrade, it will fallback, by booting the previous working version. +- Updates are required to be securely signed by the Home Assistant team, adding a whole new level of security. +- Compressing the root file system, making it faster on SD cards and slow IO-Interfaces. +- Compressing parts of the memory so that we can store more information. + +## {% linkable_title What Hass.io users should do to prepare for these updates %} +At this moment: Nothing. + +The new Hass.io supervisor still supports the old ResinOS builds (our official downloads for Raspberry Pi and Intel NUC) and generic Linux installations. If you’re using a generic Linux installation on SUSE Linux or Ubuntu, you have to update your local AppArmor profile if you want to use the new functionality (instructions will be provided upon release). + +Once our new installation images with HassioOS are released, you have to reflash your device once. You can do this without losing any configuration by using our Snapshot feature: +- Create a snapshot of your current installation and download it to your PC. +- Flash the SD card with the new Hass.io OS image. +- Restore your snapshot. +- Enjoy a new and improved Hass.io + +[last July]: https://www.home-assistant.io/blog/2017/07/25/introducing-hassio/ +[the conclusion]: #what-hassio-users-should-do-to-prepare-for-these-updates +[Buildroot]: https://buildroot.org/ +[RAUC]: https://www.rauc.io/ diff --git a/source/images/blog/2018-04-hassio-2018/blogpost.png b/source/images/blog/2018-04-hassio-2018/blogpost.png new file mode 100644 index 0000000000000000000000000000000000000000..443fb8a540b6d7572ef2a63e4177cd5224b842ac GIT binary patch literal 42047 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°A%*{k7-z zKa5ogVASG&ZqSP<+;5?x?z|-=*$=fXDYki4fdMW#q>K+GbE8?1K-1;TCHQ5`|9#3} z6*Q@h;g~9)uorB9*?u+N)Wp!|MrNb6Po2_Q!c$IIV#!R2Xz={RL+B|hrgT9~Z)k(b zf%LB5-T`dakh<6|qy7(pWe@)rHo+o0Jj65Q$KY{(ORxno`JQ)LJZDLA%GtC#!hOtL@~OwVox0Qg`<<6^r!KQI(Yb7q?_hIPsRa(6`haYwxA`- zl#DB+Mbq@NCO+P9_BO+|deC6}oxB-_tuH=bp3HFid8Ym%*4eQt?~UOCXH&!&NaGV) z6V7h#`<-!_)8+7l_y6t&f$>9?{AxlSQzxyirJT$pOU^t{ipssd*BK_P8(P=sH~y?F za&LlZunwF+iZXbk*uq2}FBO3`)w}pP$1*OG(kP6&giUC8ew$#!Yv8v{&;g$}eK2;$ z|6VxGhgNcv^a=g(I+THCE3oEoDbJDB{gArkb+yyy?Ax!k?t;gU^1h&ZT$vl~oS+t; z*202ng&)TiP_OQHPOslIXul<;Lyg1&T!Jo%+m}iaqJTbnI^0K>>>%{-|KK9_``{vIfw8wcZH#2}WJ%N9;$T1(s=(|4XRppH&6lzA5^*N!mHIDep#Jl}#Tn zI)iQM5wDOcq>7`dqpuQeTNF1fo3T`)k%_-p-%pGo78ksph^PK&7m^S=cigd?%HPKSI~si5u|%Bc^6}C>KPoTQ$4|^Ly;4#3 zamE`uJhD+xrr|HHM2$**Zr&Q}mW-)?SRfzBSg!qaxlPxN@#7~N{HxU&XquCGx7XcT z4mA6Rii_1hF7;!bg+d);8^jdV;IbfbavT4|WL^t9t{y<^y9O#A zmm+gi5EZgv6g}q5>19!+WPGmXRL9NucC_zV0eF(1;8^W>RRn#pQa6BUfyXet2@_Jp z+p}HkqPf!GaC#=Np;T-o7sKxQZY``0qJHHu9PKN&5B5(xal!HFeDnyaF`#8nr7q2ul)fBd* ziv5+i2N+60v!L?5*Y+NqF5&s}kC)ED5vWlv+>;hG9zl#$FZ-_#Xun5)Pg!Cg(gkK5 zB95LB?548I`JF-#>s?+o%HxC~UjrI{tT}B8^-0Dgub(g6lk5ErsR^vAg~5K}Rvv{{ zD{(hyu=Bp)BkPv`^LXbh9AiRe$vgR~vud+HiE#$aDZ2Z3jSa4XZUTSLl1$X-hyD!R zzhC&oQpqbW2v@uCu|-Sa^XC z{l2(5YgNVLJ3l4h?}aRMO1@8pc3!&VY^37L84-;ZJI8p z{P7B8zxo=*ivH$g=@gcD&B8<;0qZ}3Q+)3iYeOvOtY0jYlQc)BM!(5@n!!L$FmSu3 zl!8o2OOg91X7L&L_p2pIKAW7ukdcF5MH%)_8v26<4cE|yGl`Fr;aGJiPyT+KuJ7dI zF+{2Pq&kGfd+FTi|10X+@Avh-uI+VS>AIYY zPlGlUK$D+h|K3IUoKzvrT^Ua4Fx~3O&o-sayPoc^rhQ}pX zZ<)sPH`u2@to_T7_=i4#k(#=i^5HDz+2ku5)c|RyuQwX{O&bnUYFrFa4PR{+gK%1S z?OE85=S*LdSdeVa*>r|QvP6ih(rlaV*YkC4ZJ1|p9emJcK6gEf<@!ol`vPzT!)2ZuIL0kYv4z^0D?i(2 zta81_%5=8NR1SeIc6@T!hk^v;AnE7pp5y}~m911eACkX|?8@kXtHKbE-ZByGOjChr zw_!4*urChXf&eh_J8U{ehTa=xJ1V~H zmFbtnzM-51E%k6Yy_-^_2)$()wtC4b$goxE*OjS%e|5q`#PwyeJ6mg<8aGgcbDMJo zr12-r_75i~=_cU9g&v2!D1DVCWw_sIp92QelJsezS3U4wvS(#l5Q8`if>2QhzH|e% zZ~Uj;$DLTMg4{Xc9IzWxUQx&2dpE?_{>vFwldzPWd2R%^aG@_Qt0Jx`w*1K^Y`|Lz z*NYF7C!^cs{sebx(+=YA4ZK&q*C}@`6d2xCeTw7dBSuPk$G*z+B)i-I25|O<6^lG7ES?##=ZC9f|=7^2|eO^V+rs_$)O+?2NMy_O5To3+%X6>K^ zIFrVHjH%P#;C|5=8GP+JjPWVg3X%8{fV{6NcqnffyXKC@AP97}-5~kKVz;fg_LyV=IjPNOI^xz zN@i~wXn>o=o;kvgY<{5)S;;_~54YZ-D5ORQL3|Vti-$<9<~fhV9gdhgZPw4RkNFNH z+#Lbe4D~wfLFpH60DpYEvLc1t>cPB=Tx>EYlpQ%sdqM~t$f|K!E%K$Mc5y<0S-X!3 zr&0oU)?J?5O)0lbIjFepX#k~`_(|XRhf*c~HYHpNRT#qvY`4mJu=2JdeIt|tpb^*9 z1g`p0qa@=jHTmj-xck~`z%#wvi9;GJv)u45Y^e*k>cI+Qm&Imq^JAf@jHs*g^e~ngrUB? zpxa>jX<*mAeCA)B5C7<(ezV@3rekTTm9Kl1dhxSqp#&pONzO&2qF@&|gE_J*|3)Nh zIY5!)WThzlX$rM!MS7|JGTJ}!GU*8`=S??qeBohtdyfG-xRrS(1qjQ>Yu4anF}(JX z&x_=U&cBijC*8C`9%P_p5sb!ub|>H*b0!=Bcz_9;O3sQ`MErQ3vulTeHBt@~FR+LR zxNQoGJzejf$~t6L$X$HS>^_#Az$$W%s=caXPnD91BgDJ5hJe1Ef>Np-wtCbsQC zf%?gNN#T=DKfUi5auYXGc1V{~2G!b{bsTSw>4pt^8nx|X9Kjra){BJ=e|A`@%vfKi zMg*QSQT=%SH0VpL^Y+}YI1jW=w;-{>znz@`Xe*Lc`xEb~ihTh&Bo+Bl>y^#-%+R92 zFA^k7FYRa02o(}7Q2(G8t_U}b3cqj{Jm0EZQ)_3a*9)DYY3KR<)Z6m^k1YIbE((Cw zojxXf3_#BDwUA$ft)0sQ$D#7WMhD)pBHV&T-= zcdQgS7ZE;Vb%n*(8^!qhykK6hy65`YHuE{w&(A?*ysNDCZyG*Qwt14%i_?_apL>KR*L>GU}@2NJq_h-57iAPEPlKM14mA+4F zZNUyM1IK!Vu1q4V=c5=-w$LrT;)B7wDfWC0ZC;(8ZneWoKFkP7{i*qX{nL`rahcns zn_3jl^3ko3)h6(QLFT(GZU;vl)BkwbNDW&7kA%q^ea8?INbXTHD0V|B;aGZ7<; zhuRI^heMN*O@8(I<*y3_?zp?=Iz2)(a0}mCEwoNkqOR#o7=pX|0jUIzi-Iu%YwNJF zv=6ak${ji3!25GR1S`oh9e5<7!FFsq|1MNN zU6*E_nWc%>R@S8(lrv7;Nk?I3mjlPs70VwkkKo`~f#7=@Bwf&nk$tEDqtRrEvt~+~ zj2w?($TAIxB-B9w8Zg8qF%luw_Q_f`ARRLLG29mIOQaZ8XdVQ}?pFkW@8t43Hi$}tEW0hXmq6^YB>&1^ zII^CV!b<${hFgvZi8VO@#mW7lqTJ*x z2fkF5C&m2~x=YQAuc?|S8iE^-T7-j_v~x;-G$Ec<9zwHV!+Ca$XOjTorawdTyBB*K z){jbhIP;!2UHylv%lY-#JH-Y7)23Ed4?)zbWKM8IBhwZaL5@20aeLM5SBuTy{%lSB zgT&2yAy2G~#{cGz&{WAQ$w&J6ps$V^1z5ZA0-3H}YZJ*@B0j<|o1O}k*Dj<_9~O5m z|LJE&957ZJ&A#>+oW5V8b8xSpYW>L|NE4O>T788dtp9FU5mGBUjZZG6zOe1b*ma4!d%K_ zea?eiR=(NDs>auJhfi>0_}9M2ed{@y0QK?7@#Yppt>bdMg|9XY(|zcx85pm`Ip)4H%Gg$gjc$jlq)~$FiI=BJ(@jzZlnpsB)nse)q9aK{<48lJs?)q%i-8!`{Xs9fcg#$O`1qC)zJR~?{ z@DWQEB-^7yhNJqd)QCS(g;6bGiy@t!Dw=w61d*{8ie>ZaK@HNXy)O=!x*{X~hpbNz zenGt7u;0RNo_Dk2`O`9Q>!hVy~wwxJ{lOOt&ubQ0sAhLlIx!?q4QyDNJl2;(}e+i zk?rI(9FUzMsHM?;)1M;1Qr2;zkZZ0@Ufrc`C?FxK~fRc;^GT)t8+H%6=Jw(pz?nCFK4T&43ro$Mrj=QC@& z?v`DSuec5a3Wa32Sca|phJq+r&v;|8HA8S`!15O%{?ucI(JdnG+c~rkpEUgiKQ&da ze4W$s*_I^+X*)#ZcmqX?o{RVAYcnLq-2w>Vb}%cT9I0VXhF`2yMk}-t`8hjb5BYUPyzb3;R%WTLiwijF$+mf(TOx|{5F~0$U=hrs#&K{)*M;G=8Nlfbqm)6yQ zDvuBIo}b5fO8F)yxI`8`4>Fa4ykD6qdKa)84R&T)HqL~f${Lj?%hfzB{ooXrR}XIJ z@X{{QoxoLBI*s^tWkljG+MTr&Ts0lalh(35c%aOdO;I^;GZ_vvQas$Y%?^mZN2nE2 zc_A4o+Hr~wG<|X_JE#NG_idbe1cP6`zXwqT$@9Wh}<2Kn1RTCG3OPfS{A>HQgrbj6r$53 zWCSNSiuaG@ za|b`q)~0OSvkRB8&$Si+-8LNmw3`yHLH0D1(GKxOOkC2$2Ee67xKLJzK(<`C@x$ z)jtvF_aFpQ&fMYX`Z6wWzH!_-GFy3n%QX+Ilq3CH`FpRXaMJ z{AGd`6-eyU^{kb6Qb;sH@u;501f>8Egd^dnOT=ow&>T96! zQ_rf6JveIwNW_Id(O?2EidSQ6jAa57JkhhjPYUYFP|T!_g$+}LD2IdskmOuKoD{IT z)2avLf719nc1DFx(wSg`lyEsUiVSbJ+hJ1;zZPHWj>TU{>oGb&*_+0#hKw%f5>iPB zROhHOfs38z>IJ%f?O>a!VgN?Z!z>*8U`pX8BEf=^j$13)gPQan`T;bI0;Gx80`dAZ zbW+82wEN&`F=Y;(f-p6N7EPLQ=y_kwge`;&mUeLkHO9x!;zd=Y75nGy~MPt{aPAER$Xj7#8Qp zrYl07zG+_01(?o2#nU)FwEtJgiNYw`pTqUZt!hWIr@wx!Jtis&#~4i}XItMj@Wp;- z(9*B!)H%M?x{{mJ19T`%_x}m*CGcw3Tx!gJ7gJby#QzLmDdKeS3oP=z2jdz2?8$yd za@+iQ!nu(CGXOvTf@mny(sX6aGq0JXm~ALfL%jrG=1xNRiF>fd|8jiWlt-`4X}%3c z>2_qkj{6s6K}(Tc6tDCvs(Y#HrJ?c>wgbk7a%9Kun(F){k@tv8eZX6@g^8^y)MSZ@ nu3#~JnK-EnqP!!b8*KdYIUyCky!SPZ_Z@x_aiPe>`N97HxK$ZQ literal 0 HcmV?d00001 From e6adf8ca0b4c380e785210dbe157ccf66864ba2e Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 22 Apr 2018 18:08:03 -0400 Subject: [PATCH 151/241] remove confusion about build times to support new hardware --- source/_posts/2018-04-22-hassio-2018.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_posts/2018-04-22-hassio-2018.markdown b/source/_posts/2018-04-22-hassio-2018.markdown index 2562d41772..9050605355 100644 --- a/source/_posts/2018-04-22-hassio-2018.markdown +++ b/source/_posts/2018-04-22-hassio-2018.markdown @@ -14,7 +14,7 @@ og_image: /images/blog/2018-04-hassio-2018/blogpost.png We noticed that there is some confusion in the community about how Hass.io relates to Home Assistant and what impact the upcoming Hass.io changes will have. We will try to clarify it all in this blog post. ## {% linkable_title What is Hass.io %} -Hass.io is a complete solution to run Home Assistant, by the authors of Home Assistant. The goal of Hass.io is to provide an easy to use and secure system, entirely managed from within the Home Assistant user interface. +Hass.io is a complete solution to run Home Assistant, by the authors of Home Assistant. The goal of Hass.io is to provide an easy to use and secure system, entirely managed from within the Home Assistant user interface. Hass.io is a complete solution, which means that it comes with its own highly secure and optimized operating system, a supervisor application to maintain and configure that system, and of course Home Assistant itself. @@ -34,14 +34,14 @@ Home Assistant has recently introduced configuration entries. We’re going to h To control the host system, we currently use a custom service called HostControl. This allows the user to manage here host and restart/shutdown the computer from within Home Assistant. Instead of relying on our own system, we’re going to change to use D-Bus. D-Bus is a standardized mechanism for services and applications to communicate. Using a defined standard means that all parts of the host can now be remotely configured: sound, network, etc, etc. We will be extending the Hass.io panel in Home Assistant with controls to configure various parts of the host. ### {% linkable_title Hass.io OS %} -Hass.io is currently using a forked version of ResinOS as our operating system. ResinOS has been designed to run a minimal environment for Docker, simple over the air updates and connect to the ResinIO cloud. Our fork removed the ResinIO logic. Over time, ResinOS has been evolving but not in a direction that is aligned with our goals, resulting in the maintenance of our fork to take up a lot of time. +Hass.io is currently using a forked version of ResinOS as our operating system. ResinOS has been designed to run a minimal environment for Docker, simple over the air updates and connect to the ResinIO cloud. Our fork removed the ResinIO logic. Over time, ResinOS has been evolving but not in a direction that is aligned with our goals, resulting in the maintenance of our fork to take up a lot of time. The ResinOS build system is based on the Yocto Project. This is a very powerful system, but also requires specific support for each hardware platform need to be specifically added and maintained (like each version of Raspberry Pi), which caused long build and development times for Hass.io. All these factors made us decide to build our own, custom, operating system. We’re obviously not starting from scratch, but instead, are basing it off [Buildroot] as the foundation and use [RAUC] for over the air updates. Some things that the new operating system will be able to do: -- Adding support for new hardware will be easy. Creating new builds for, e.g., a new Raspberry Pi model should be a matter of days, not months. +- Easier to add support for new hardware. - Updating will be atomic and has a Fail-safe. If a system fails to boot after an OS upgrade, it will fallback, by booting the previous working version. - Updates are required to be securely signed by the Home Assistant team, adding a whole new level of security. - Compressing the root file system, making it faster on SD cards and slow IO-Interfaces. From c66272aa851b6e10cde38dd5514b1a677c3f9100 Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Mon, 23 Apr 2018 17:34:20 +0200 Subject: [PATCH 152/241] Fix release notes 0.68.0b0 (#5212) --- source/_posts/2018-04-27-release-68.markdown | 53 ++------------------ 1 file changed, 4 insertions(+), 49 deletions(-) diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown index 788e068c7e..167a264a2a 100644 --- a/source/_posts/2018-04-27-release-68.markdown +++ b/source/_posts/2018-04-27-release-68.markdown @@ -18,7 +18,7 @@ Highlights: - Ability to _control_ HomeKit - Eufy bulbs -## New Platforms +## {% linkable_title New Platforms %} - Add support for Eufy bulbs and switches ([@mjg59] - [#13773]) ([eufy docs]) ([light.eufy docs]) ([switch.eufy docs]) (new-platform) - Add support for controlling homekit lights and switches ([@mjg59] - [#13346]) ([homekit_controller docs]) ([light.homekit_controller docs]) (new-platform) @@ -30,7 +30,7 @@ Highlights: - Add support for Sensirion SHT31 temperature/humidity sensor ([@viorels] - [#12952]) ([sensor.sht31 docs]) (new-platform) - Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.lmsensor docs]) ([sensor.miflora docs]) (new-platform) -## New Features +## {% linkable_title New Features %} - Support binary_sensor and device_tracker in HomeKit ([@Yonsm] - [#13735]) ([homekit docs]) (new-feature) - Add Homekit locks support ([@philk] - [#13625]) ([homekit docs]) (new-feature) @@ -47,35 +47,12 @@ Highlights: Experiencing issues introduced by this release? Please report them in our [issue tracker](https://github.com/home-assistant/home-assistant/issues). Make sure to fill in all fields of the issue template. -## Breaking Changes +## {% linkable_title Breaking Changes %} - Support for multiple MAX!Cube LAN gateways added ([@syssi] - [#13517]) ([maxcube docs]) ([binary_sensor.maxcube docs]) ([climate.maxcube docs]) (breaking change) - Disable ebox requirement ([@balloob] - [#14003]) ([sensor.ebox docs]) (breaking change) -## Beta Fixes - -- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) -- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) -- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) -- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) -- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) -- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) -- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) -- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) -- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) -- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) -- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) -- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) -- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) -- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) -- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) -- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) -- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) -- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) -- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) -- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) - -## All changes +## {% linkable_title All changes %} - Update Homekit to 1.1.9 ([@cdce8p] - [#13716]) ([homekit docs]) - Update docstrings ([@fabaff] - [#13720]) ([ihc docs]) ([cover.opengarage docs]) ([cover.tahoma docs]) ([light.aurora docs]) ([sensor.trafikverket_weatherstation docs]) @@ -84,7 +61,6 @@ Experiencing issues introduced by this release? Please report them in our [issue - Add timeout / debounce (for brightness and others) ([@cdce8p] - [#13534]) ([homekit docs]) - added support for smappee water sensors ([@hmn] - [#12831]) ([smappee docs]) ([sensor.smappee docs]) - Initialise filter_sensor with historical values ([@dgomes] - [#13075]) ([sensor.filter docs]) -- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) - Bluesound bugfix status 595 and await ([@thrawnarn] - [#13727]) ([media_player.bluesound docs]) - Upgrade aiohttp to 3.1.2 ([@fabaff] - [#13732]) - Upgrade sqlalchemy to 1.2.6 ([@fabaff] - [#13733]) ([sensor.sql docs]) @@ -92,7 +68,6 @@ Experiencing issues introduced by this release? Please report them in our [issue - Update CODEOWNERS (sensor.filter, sensor.upnp) ([@dgomes] - [#13736]) - Reset permission ([@fabaff] - [#13743]) ([light.abode docs]) - Throw an error when invalid device_mode is given ([@dangyuluo] - [#13739]) -- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) - Upgrade netdisco to 1.3.1 ([@fabaff] - [#13744]) - Add MQTT Sensor unique_id ([@OttoWinter] - [#13318]) ([sensor.mqtt docs]) - Prepare entity component for config entries ([@balloob] - [#13730]) @@ -132,18 +107,13 @@ Experiencing issues introduced by this release? Please report them in our [issue - bump python-ecobee-api version to 0.0.18 ([@geekofweek] - [#13854]) ([ecobee docs]) - Adding USCIS component ([@meauxt] - [#13764]) ([sensor.uscis docs]) (new-platform) - Avoid unnecessary cast state updates ([@dersger] - [#13770]) ([media_player.cast docs]) -- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) - Update yweather.py ([@TheCellMC] - [#13851]) ([weather.yweather docs]) - add support for Kodi discovery ([@escoand] - [#13790]) ([media_player.kodi docs]) - Further untangle data entry flow ([@balloob] - [#13855]) -- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) -- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) - Added snips service descriptions ([@tschmidty69] - [#13883]) - Add unique_id for BMW ConnectedDrive ([@gerard33] - [#13888]) ([binary_sensor.bmw_connected_drive docs]) ([lock.bmw_connected_drive docs]) ([sensor.bmw_connected_drive docs]) - Revert "Update yweather.py" ([@pvizeli] - [#13900]) ([weather.yweather docs]) - Eufy colour bulb updates ([@mjg59] - [#13895]) ([eufy docs]) ([light.eufy docs]) -- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) -- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) - Fritzbox netmonitor name ([@escoand] - [#13903]) ([sensor.fritzbox_netmonitor docs]) - Restore typeerror check for units sans energy tracking ([@andersonshatch] - [#13824]) ([switch.edimax docs]) - Add more math functions to templates ([@Shou] - [#13915]) @@ -154,10 +124,8 @@ Experiencing issues introduced by this release? Please report them in our [issue - Add support for new platform: climate.modbus ([@Kirchoff] - [#12224]) ([climate.modbus docs]) (new-platform) - Hive R3 update ([@KJonline] - [#13357]) ([hive docs]) ([binary_sensor.hive docs]) ([climate.hive docs]) ([light.hive docs]) ([sensor.hive docs]) ([switch.hive docs]) - Updated foobot_async package version ([@reefab] - [#13942]) ([sensor.foobot docs]) -- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) - Upgrade alpha_vantage to 2.0.0 ([@fabaff] - [#13943]) ([sensor.alpha_vantage docs]) - Cleanup on exit ([@dgomes] - [#13918]) ([media_player.mediaroom docs]) -- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) - Add data entry flow helper ([@balloob] - [#13935]) ([config docs]) - Xiaomi MiIO Device Tracker: Unused variable removed ([@syssi] - [#13948]) ([device_tracker docs]) - Implement play media to set a channel based on (by priority): ([@stephanerosi] - [#13934]) ([media_player.webostv docs]) @@ -169,20 +137,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Added FB messenger broadcast api to notify.facebook component ([@B1tMaster] - [#12459]) ([notify.facebook docs]) - Added web view for TTS to get url ([@tschmidty69] - [#13882]) ([tts docs]) - Add services for bmw_connected_drive ([@ChristianKuehnel] - [#13497]) ([bmw_connected_drive docs]) ([device_tracker docs]) -- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) - Bump deCONZ requirement to v36 ([@Kane610] - [#13960]) ([deconz docs]) -- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) -- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) -- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) -- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) -- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) -- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) -- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) -- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) -- Upgrade pyqwikswitch to 0.71 ([@kellerza] - [#13920]) ([qwikswitch docs]) -- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) -- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) -- Revert "Upgrade pyqwikswitch to 0.71 ([@balloob] - [#13920]) ([qwikswitch docs]) - Bump skybellpy version to 0.1.2 ([@MisterWil] - [#13974]) ([skybell docs]) - Fix typo an coding style ([@stephanerosi] - [#13970]) ([device_tracker docs]) - Params of the send command can be a list now ([@syssi] - [#13905]) ([vacuum docs]) From 0cfcbf254b4a741ea9d140e3cf29f73fcc433326 Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Mon, 23 Apr 2018 17:58:46 +0200 Subject: [PATCH 153/241] Added release notes for 0.67.1 (#5211) * Added notes for 0.67.1 * Updated _config.yml --- _config.yml | 4 +- source/_posts/2018-04-14-release-67.markdown | 49 ++++++++++++++++++++ 2 files changed, 51 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index 38d26c045e..292d32752f 100644 --- a/_config.yml +++ b/_config.yml @@ -140,8 +140,8 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 67 -current_patch_version: 0 -date_released: 2018-04-13 +current_patch_version: 1 +date_released: 2018-04-17 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. diff --git a/source/_posts/2018-04-14-release-67.markdown b/source/_posts/2018-04-14-release-67.markdown index ec16c1d115..843cce88e6 100644 --- a/source/_posts/2018-04-14-release-67.markdown +++ b/source/_posts/2018-04-14-release-67.markdown @@ -28,6 +28,23 @@ This release includes a security fix. The error log was accessible via the API w - Tahoma switches ([@ikucuze] - [#13636]) ([tahoma docs]) ([switch.tahoma docs]) (new-platform) - Add support for Nanoleaf Aurora Light Panels ([@Oro] - [#13456]) ([light.nanoleaf_aurora docs]) (new-platform) +## {% linkable_title Release 0.67.1 - April 17 %} + +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) +- Upgrade pyqwikswitch to 0.71 ([@kellerza] - [#13920]) ([qwikswitch docs]) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) +- Update pyfido to 2.1.1 ([@titilambert] - [#13947]) ([sensor.fido docs]) +- Bumped pypollencom to 1.1.2 ([@bachya] - [#13959]) ([sensor.pollen docs]) +- Revert "Upgrade pyqwikswitch to 0.71 ([@balloob] - [#13920]) ([qwikswitch docs]) + ## {% linkable_title If you need help... %} ...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. @@ -395,3 +412,35 @@ Experiencing issues introduced by this release? Please report them in our [issue [xiaomi_aqara docs]: /components/xiaomi_aqara/ [zwave docs]: /components/zwave/ [ann-ubiquiti]: /blog/2018/04/12/ubiquiti-and-home-assistant/ +[#13728]: https://github.com/home-assistant/home-assistant/pull/13728 +[#13741]: https://github.com/home-assistant/home-assistant/pull/13741 +[#13862]: https://github.com/home-assistant/home-assistant/pull/13862 +[#13884]: https://github.com/home-assistant/home-assistant/pull/13884 +[#13887]: https://github.com/home-assistant/home-assistant/pull/13887 +[#13889]: https://github.com/home-assistant/home-assistant/pull/13889 +[#13906]: https://github.com/home-assistant/home-assistant/pull/13906 +[#13908]: https://github.com/home-assistant/home-assistant/pull/13908 +[#13920]: https://github.com/home-assistant/home-assistant/pull/13920 +[#13940]: https://github.com/home-assistant/home-assistant/pull/13940 +[#13946]: https://github.com/home-assistant/home-assistant/pull/13946 +[#13947]: https://github.com/home-assistant/home-assistant/pull/13947 +[#13959]: https://github.com/home-assistant/home-assistant/pull/13959 +[@Danielhiversen]: https://github.com/Danielhiversen +[@Kane610]: https://github.com/Kane610 +[@aav7fl]: https://github.com/aav7fl +[@bachya]: https://github.com/bachya +[@balloob]: https://github.com/balloob +[@dlbroadfoot]: https://github.com/dlbroadfoot +[@kellerza]: https://github.com/kellerza +[@syssi]: https://github.com/syssi +[@titilambert]: https://github.com/titilambert +[climate.honeywell docs]: /components/climate.honeywell/ +[config docs]: /components/config/ +[device_tracker docs]: /components/device_tracker/ +[fan.xiaomi_miio docs]: /components/fan.xiaomi_miio/ +[qwikswitch docs]: /components/qwikswitch/ +[sensor.fido docs]: /components/sensor.fido/ +[sensor.hydroquebec docs]: /components/sensor.hydroquebec/ +[sensor.pollen docs]: /components/sensor.pollen/ +[switch.broadlink docs]: /components/switch.broadlink/ +[switch.vesync docs]: /components/switch.vesync/ From b455d059c8aa664d3e7164d683cfc545becd240e Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 23 Apr 2018 13:42:55 -0400 Subject: [PATCH 154/241] Update 2018-04-27-release-68.markdown --- source/_posts/2018-04-27-release-68.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown index 167a264a2a..e8934b6296 100644 --- a/source/_posts/2018-04-27-release-68.markdown +++ b/source/_posts/2018-04-27-release-68.markdown @@ -17,6 +17,7 @@ Highlights: - Ability to _control_ HomeKit - Eufy bulbs +- Breaking MDI icons? ## {% linkable_title New Platforms %} From 033028b8819940641163f65fa7223cf903ef7866 Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Mon, 23 Apr 2018 23:39:04 +0200 Subject: [PATCH 155/241] Fix release version (#5236) --- _config.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/_config.yml b/_config.yml index 38d26c045e..36d6b34978 100644 --- a/_config.yml +++ b/_config.yml @@ -139,9 +139,9 @@ social: # Home Assistant release details current_major_version: 0 -current_minor_version: 67 +current_minor_version: 68 current_patch_version: 0 -date_released: 2018-04-13 +date_released: 2018-04-27 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. From 193ae8a0d01b7f00b74ea83a3d9ea7a300a09ccb Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Mon, 23 Apr 2018 23:39:18 +0200 Subject: [PATCH 156/241] Fix release not anchor link (#5235) --- _config.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_config.yml b/_config.yml index 292d32752f..b707c0d52d 100644 --- a/_config.yml +++ b/_config.yml @@ -146,7 +146,7 @@ date_released: 2018-04-17 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. # Major release: -patch_version_notes: "#" +patch_version_notes: "#release-0671---april-17" # Minor release (Example #release-0431---april-25): # Date we moved to Discourse for comments From b03e6e0ba4aa15d260b8fb769b4401685baad05d Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 24 Apr 2018 13:35:25 -0400 Subject: [PATCH 157/241] =?UTF-8?q?Google=20Assistant=20=F0=9F=8E=89=20(#5?= =?UTF-8?q?244)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Add blog post * Add video * Update link --- source/_components/google_assistant.markdown | 6 ++- ...4-launch-google-assistant-support.markdown | 44 ++++++++++++++++++ source/cloud/google_assistant.markdown | 1 - source/cloud/index.markdown | 9 ++-- .../google-assistant-home-assistant.png | Bin 0 -> 132675 bytes source/index.html | 8 ++++ 6 files changed, 60 insertions(+), 8 deletions(-) create mode 100644 source/_posts/2018-04-24-launch-google-assistant-support.markdown create mode 100644 source/images/blog/2018-04-google-assistant/google-assistant-home-assistant.png diff --git a/source/_components/google_assistant.markdown b/source/_components/google_assistant.markdown index d1096fd88c..40b0417758 100644 --- a/source/_components/google_assistant.markdown +++ b/source/_components/google_assistant.markdown @@ -13,6 +13,10 @@ featured: true ha_release: 0.56 --- +

+ Use [Home Assistant Cloud](/components/cloud/) to integrate with Google Assistant without any effort. +

+ The `google_assistant` component allows you to control things via Google Assistant (on your mobile or tablet) or a Google Home device. The Google Assistant component requires a bit more setup than most due to the way Google requires Assistant Apps to be set up. @@ -134,7 +138,7 @@ If you're not using Linux, you can use sites such as [this one](https://www.brow 1. Create a new project in the [developer console](https://console.actions.google.com/). a. Add/Import project b. Click on `BUILD` on the `Smart home` card - c. Type in your home assistant url: `https://[YOUR HOME ASSISTANT URL:PORT]/api/google_assistant`, replace the `[YOUR HOME ASSISTANT URL:PORT]` with the domain / ip address and the port under which your Home Assistant is reachable. + c. Type in your home assistant url: `https://[YOUR HOME ASSISTANT URL:PORT]/api/google_assistant`, replace the `[YOUR HOME ASSISTANT URL:PORT]` with the domain / ip address and the port under which your Home Assistant is reachable. d. Click `Done`. Then click on `Overview`, which will lead you to the app details screen. 2. You'll need to fill out most of the information on that page, but none of it really matters since you won't be addressing the App directly, only through the Smart Home functionality built into Google Assistant. 3. The final item on that page `Account linking` is required for your app to interact with Home Assistant. diff --git a/source/_posts/2018-04-24-launch-google-assistant-support.markdown b/source/_posts/2018-04-24-launch-google-assistant-support.markdown new file mode 100644 index 0000000000..edf50f2d09 --- /dev/null +++ b/source/_posts/2018-04-24-launch-google-assistant-support.markdown @@ -0,0 +1,44 @@ +--- +layout: post +title: "Our Google Assistant skill is live!" +description: "The Google Assistant integration for Home Assistant Cloud is now available to all." +date: 2018-04-24 00:01:00 +date_formatted: "April 24, 2018" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Announcement +og_image: /images/blog/2018-04-google-assistant/google-assistant-home-assistant.png +--- + +

+ Home Assistant logo and the Works with the Google Assistant badge +

+ +Guess what? Yep, our Google Assistant Smart Home skill is live! It's a mouthful but it means that you can now control your Home Assistant devices via any Google Assistant enabled device by simply saying things like "Ok Google, turn on the lights". + +To get started: + + - [Enable Home Assistant Cloud](/cloud/#enabling-the-cloud) + - Install our skill for Google Assistant. As of this writing, the link is not live yet: you can find it by opening the Google Home app -> Home Control, tap on the blue + at the bottom right and find Hass.io in the list. + - Optional: [Tweak the devices](/cloud/google_assistant/) that are getting exposed to Google Assistant. + +Things to note: + + - The skill is called Hass.io, but will work with normal Home Assistant too. The name was necessary to avoid confusion between Home Assistant, Google Assistant and Google Home. + - Works with Home Assistant 0.65 or later. + - All message handling is done local and is [open source](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/google_assistant/trait.py). + - If you have an Android device with Google Assistant, you can control your devices too. + - Home Assistant 0.68 will introduce a button to the Cloud config panel to trigger a sync of available devices. + +Home Assistant Cloud is still in open beta and free to use. Open beta period has been extended to June 1. Many thanks to [Quadflight] for providing the Raspberry Pis that Google used for physical testing and thanks to [Arsaboo] for helping with testing. + +
+ +
+ +[Quadflight]: https://github.com/quadflight +[Arsaboo]: https://github.com/arsaboo diff --git a/source/cloud/google_assistant.markdown b/source/cloud/google_assistant.markdown index 155b2356a7..b438e8482c 100644 --- a/source/cloud/google_assistant.markdown +++ b/source/cloud/google_assistant.markdown @@ -7,7 +7,6 @@ sidebar: true comments: false sharing: true footer: true -published: false --- The Google Assistant integration allows users to control the entities via the Home Assistant Smart Home skill for Google Assistant. This means that you can say things like "Ok Google, turn on the kitchen light" to control your local Home Assistant. diff --git a/source/cloud/index.markdown b/source/cloud/index.markdown index 449294d890..24f5cf76aa 100644 --- a/source/cloud/index.markdown +++ b/source/cloud/index.markdown @@ -15,19 +15,16 @@ ha_iot_class: "Cloud Push"

The Home Assistant Cloud is currently free and will become part of the upcoming Community Support Package. [Learn more](/blog/2017/12/17/introducing-home-assistant-cloud/)

-The Home Assistant Cloud allows you to quickly integrate your local Home Assistant with various cloud services like Amazon Alexa. - -The following integrations are currently available: +The Home Assistant Cloud allows you to quickly integrate your local Home Assistant with various cloud services. The following integrations are currently available: - [Amazon Alexa (Amazon Echo)](/cloud/alexa/) - - + - [Google Assistant (Google Home)](/cloud/google_assistant/) ### {% linkable_title How does it work? %} The Home Assistant Cloud has been designed with security in mind. When you activate the Cloud component, your instance will create a secure connection to the Home Assistant Cloud. There is no need for any further configuration or to expose your instance to the internet. -Integrations like Alexa will deliver messages to our cloud which we will forward to your local instance for processing. We just forward the response back to Alexa. This means that we do not have to store the state of your house in our cloud, we’re just the messenger! +Integrations like Alexa or Google will deliver messages to our cloud which we will forward to your local instance for processing. We just forward the response back. This means that we do not have to store the state of your house in our cloud, we’re just the messenger! You can find a list of frequently asked questions (and their answers) in [this blog post](/blog/2017/12/17/introducing-home-assistant-cloud/#faq). diff --git a/source/images/blog/2018-04-google-assistant/google-assistant-home-assistant.png b/source/images/blog/2018-04-google-assistant/google-assistant-home-assistant.png new file mode 100644 index 0000000000000000000000000000000000000000..a7ec721fbccef043d8040ad7f55e167f67715a5a GIT binary patch literal 132675 zcmeFYXH-*L+b9}k3%C_fQF<>Ty-9B(0@9^-klu^*nt+IaRH-5zM5Ol~2-15MB3*h3 z5a}e4G-40ca3NQpV5S!ph0Ui^0;y&cRiR3E2u`VsNmQV$v5<<5P2& zv$1!08Q@`~9iXmb72sqgX3Zoc%^>L~4j^!`@v>m>b8&X{6!(*2`h!;-_I#y!>KfV%InX1h|12 z+@AifUKW1buAa>QVt8TWY31SI?&aX-%5aU*!qUy#ONt5L^dAvi-2aQ#)$>1U0u;vU zXW`Dv&%<{u(!Uec)c(Jxy14vzwx^et&Hv)}{}r*Pj=#GNua=Fco41D*U^rXmYf|pw zavnAoUTz*bZf?&1YVno5o0prXy_-9OoVE~ynuV2v>-F=W`D$w7O0J$>7Oqw{N-w0C z01P}14%XsgPZeYZMTLX}pUd*|^UI4q7Z!OguOK8VCn_eQpdc#yFYF69D{mJYSFe9z zt^XIS@c#&V?FugL0Oc1p9u7V>)(ReOE)0J}7I*lcc@g{{@%;zZ`hVu->Hi4J3oyfb zZP@?K(Eknr-gEu+zitaW{MYeqTmf(Q0Nk3wWGxqT^Jb&c3t1h%xxKdA9o&kBMYtKm zc8qJY$oXRtiP`g>cihfQt9%T(gdeCm^80zBx#9$|eVXp>`U~T4e#p`=5k7fwue0jK zg9i))teo%mE*If$`)FTpUvGW=b3@oh_SBaD^Qqu5c##IKrL?qkDPXxVdB*5ZEMEV? ze-wV>&c9Fily?pO{mwW3y5r`59zsI#@yPytarY?&kQM&hW;`Cf6>|%{ZX`#)e9zlN z?&Q$BP^9>?kv?g@F-DWmCQKkuNP{E=Pef-=UEx{yP}howT2qjOi7Qc>KaXb4i1A&6 z#p4Ev)70u_l%496)0n9D;5k2T=LLt^m;5(DA-nbWtdS96tw`JiCd^40eRE%*J`vXvqgamI5?tPcXG!l@n zpDzUtbenSeJKr^M>WuE(*nbdc3Z$Bji5@>2%(**?A}wEz8bFloyDW)ICQ`#xM70F) zFX;i)T+G|Q?lx4QlfQ%S{!Z-QOH7@8 zW(|&taRPx}sl|jkmGKDNcUAq7qBWGE98ns%Cp)0q_aA26{li~(5AxUGm-+5} zk_tA~4(4zU%Q0QLn5pqK8_JXK!~pX=kPGhV#OArweaWgn2A5$gh~v>dvXeW@kd^Mm zHX3TYnGY5*`t-Nc=+}V)6m*x>*0vLQCk@g3P>I^>A&~)cq5Aj9T5qa!UftX(ZiJ%3 zXRIghEiiMOj?~C+*sqyUg|qE=0)M3DQt}na<&An(Fxf$Y}vgZS~K}@ z|LNoxB=*it{e zJ#V@;ZIZiz?V_jz7}TRWb`?Sz99PtT@~!eG&+rw{x1aXQdkqDUe`B&eYSxcM%TwIO zo9XSniddM%kLPmm=W{mT73c>_f+~(rzGeRK&%PBs(C86~^wL^KmlofD1Rt93wDI^s zEs?SbcTK-MjQR}iz+S%knGe1oL{(f9rarC^LN3USMt<~X%kUM{x9e#ZFv%XV0p5M% zDvB6VQ9#|)nG3P$d>BUwhq>Wg6hhTTIb-yJ_fBE{Tc3R^5m7cvBkvwmh*qvY07iAP zKW4{PP2!h%pQ4sEja-E0ACnMd|Ct|u+Fc`7J={7AEoc_t>{V^Lvf}|9_t^%JFf;i| zRymzI0?tQ{HPRivgCIAwrDD@r3!oJFOuO~=dZ7bbT;78_qYv=DZC$9@i=?(cV*@c#J&ikT#)FL zWByrh5D?LP2HWejE__Jm;{yPHv;z-7wWFW!5l>o7{_jD`s>jv`DMmxx&bb@Em{_TS zGs)(lp4;#1a*%>s zonC$-Mc{SYzIvMt)U0(fW;?M7aK_hF{MW(>BVCV)w>|*Og1l}qzUvzOxo{<@`uu0x zv7b4>(p|g>35g(IMdY8&;P(5|f+sCn_+_^Xv#Y<<(=eSs`jeZMW;YjImR3xN04yOD zgbJEo^>+=3Fi(>nlHoXkp_LA3?MUl9w5yrwn$Y+MWy-2vCy%A?^267v>w4$!o8c>} z53maY8EI1D%>?>vyU6B>&@uW;TobTZTHK^{UE26V0Q96l0Ke>3n;)?t2>@}I?VnfI z`u^t?f1yUUDO1orKt>9Fr28??mh$zxXOt=YuZ2>i!NR}ZU&AqP(wf~_-Z1$uAQ$Uy zlmBxOn6&W=`^>q#Yw;dc!j-~S&Y0GJ9>%pAbPZyvxuK_P!@Ww9KD+Wr7a z_7GpOYcQRJ-FNpsIC@9`SpCv~-~c^4{g!Y;g=#_lTA%XKKbnDr^dBB9O4Ag00g8OE zL7_0sKf~(bwv1mUfTZv*8!x>js~*x_OYk2~Kj`$~agGbQvH?R#k87ZBbSVx`c6qR0 z+xE@k7x&NWM`sSsJnGA*Q3dpvZABUM1mx)n@0!-NpwD`W*IyPbhv+4i>(<2YuJ|4J zwxGfB=G#AhAy3aI;=w1^F!XxY3kV2gqx0CXL_)kw2U?z~P^+~ME6qe+(!c1Nn&tPp zAbEt9Lmbg2dlIrcz%F6%ouE6HfqlqRzds}aOeFbW=RdogSHXCxqaq=?t?#QA#T-KB zdz+Mrb9Ij}WZdqp<}EO(UPq%X8d)%fVqRG2KMW{B9-Uk(52P~^lH&9_5V0CrsZ70C zPW3CxBS>@~H%c3+&OApePGiITBOLQD+m)Zd*DxWwlvUjWIV(MU51;cu@tc0`>s?+F z?R}ABbnOpwBwd}bc+vWV1s5hhJ5vG;vlyfOM@jM6JUCER0JeGVo!G<{>rq(al0l)O z($K&>>tosg@h6d;XVL^xeCJ`Us znd92z^`Uh^IG68(_s@K#qsb1gUz?z>jQ~>qrbB2^dVe(zkU=52=e_>Vgy=7)%Z`7w zP7SO0JZ+gK^jzMmTozGVG_l;U5c z$pm_(_pRqY&I~~I#o^7!2C9z-nRSL=YZMGZT>Mks}2W2s+X8kB5d(Zwg=Mh>tW@K!Yoj0`2q`*%V?1#&zHXA zLvN>(0?7VJQI>l3?cCBL^U|w2H$D3Q6HPCkN*bnX2=;Mv{T^Fr`SLFw>J^@=5L`GJ z(Qh6IEJ3iFXka_Y4?r|>(q~30kciffzdr~l3Rd!uOoQKI2vQxV+j*QUTa}#TKQNEd zZZeLswm;gc)!Uj`!`@oURQg1{LGwldS}(X73kX$%?Vo4*h3(79;OlbN)lP;0$Wu=L z@uks_4RvPMBErVl_2&c(vwG@Ua|?B=tiAl@#w2%r#lehG74&a4YhZ)k6go%g^A?(; z$gQz!y|81%(_PB4th&D~LH2_}j{xVc%>2jK9I2~3h<2}xx<^0hWP27oWmQySZr6>- zn>vhUo?EI@S;Dq`eI_e|)|Z1U6t81_XUrSOHvpVSeVJ=dcveVcu&x5H&SBXVQ03=@?g%SK&Zt4>6~o%y+n45+4xf0^Xuir8hKQ>8-TtuS8^A>W>TSj#RkDn^sAG&1G&Uewh!E*8p2y%Gugbp`cK` zgSGFV*lN7NWgpVGM^O@ivlpE;5Df_4s<~l zly2wQHheb6$*Ahs9r0_3M+fhU zcJG(B5i7SWTH-36tB%KGc}|_2phoN%+xf5KT9_SpGyQ=&L|DZ*{(O0t1R7WsbLm!D ztX!{&1(aX$ALp43VVw*PYvzmf6<94ds{egw>Y2aTOK~qzap7&_9sBh4mUXYE0L!i5 z(m?qWf|j5B2kziG5v>%H2-j1m#)zCd=~|1+xEj^Tp(fnK8>bJ~UUXjakA8u2i-&r+ zA@4x=r*5mB=K!G}BXg9iV8=eiZDonOHgdbJfzl}cjcrXA#X5keQFOstvPpFIsncRT zRx50l0|7S*WYjcWz?rke+)y|&{XJ!O*KbJ&dOPUF^83YhkVlx1yP1721| zfxHC58s>%LIU$&M)A|Ex+iup2X*A>gLrvlzYSPmKp{(h4^1^ovW`unRzPOluPQ7Gv zfo!}tv1eOnQWDL;wI?xm=jbmCB^pbD&kTKn*oxwPJa%3V5H>Yl`-(cO37%(;k-Y~o zub*){W0we9IIK6jg%KB{-wIMWfY^>tYL(Vc(RZU$xDeQR@juFJ{7?FJz|;F~_`Ff6 zc_mi)lJQ>8z1#CQe5m$Tz3+K2K15mA?9&v~DNgX)MZr7Hi5^e^v8WE45qCS?SA^uw z?>5$673-nPeP2efAWz+!-L>U-=5*4gYNa6mma1YA**8m`KjV3H zvVNktqAXll&(VgHy@y<*YW*9XWFqq?^$`7M8Ji9%R0&pHfRWYsylkAclo&(nEWj2k zQDU+mroJ}1{W30Zagy3rgnf|PPc1MJ{3nVqpS!O%@H6tkS(o}jKBV5PGQPdx~WwF@S+8T;T`^t>+!2^h6OyXOx)hq3&(9#pElak!uf$g{*dUo8lA|(BvApSsI z31u%12R27Yv zg|v8-*BO}21E@4XAaU(HLqc7I;YacGcCQAX#(9ih!@*VbLEVOp_9x#r??>lEKw7s`%>7+c++UZ%mv96M8v|*PZ$%C~=tImxF3>S*q zKW^AVf^gfyW9o?Go${_+AmFFRmsc|v*1q%!FUaGm-%L$J> zMSDKBDf{|iD{VODlYh#Ned_m2aQU6{Wq9UghUc&u67nmHTlSR|GtDgD8hBGJG@QQ<+SY%5`?F_QvCK^??w zzP59Ccg|8%9icsoz8DTgaJHaYCwsQ1WCf@#&2k`Z#sOCKhXx2QoN2reurMf^{&y{O z71($lG3D|lI!Bg;@^cFMb}+Zq+o9+ja5W9JODMy42UqMO+t z%hE3Caa{jZ@VB}fDq=+2O{BZwciE=}RLXO@XB0^4sqzkfFji%)xq806Ai}CMuOGNQ zLDG!N%%Q_xIE|qTtjJFZl(N5Og3rZS>`G|m5)LbrPmSX_x5Q(@>qm`8b5f^frr}>) zMSZR0mi(4tp0XU{5BXdBD=n0Rof1^)=N3!{>||?_mmp)>rSq4S^tw9x|NRdhIaSF`+Peg10zLdkkHEV{i%?pw{f9 z1Ve^jec9UEoX{HZ@7@y3_A`@mFtt)c;9GSE$X&Erof=ttC3cIZ?Z#JVifG?RSh~QR zWK^&fS+IGREa8J%;!wY=cQtF5QJIUx?>SW(Nh`-?2GRA~*b^ty67yDk_H!ea90Fwz z#&=?vIN9L<$4@S6{-nTjQ9OZQ98y#C5JW| zW}x&JV=8AgE%Nz`?XND9YWH|UpU&_@Ckdy|q-X0q#f^8-idv8>tKe;3mB9lahH~)y zgzA_KgjNd^8kZ`%pl(N}zS2@0bLglrY69_c+1zq-97K#}MR{7zCUmf<3iwvjOa`*X zDSpnF;+$}MnzjTfzih!B1Q%TuKz{tQkX+~hHFf5Fr^fFz^@T~qje0hwf3Z_CojF?# z+?Yb9#k@i+5Z151uk+@4RoVnoKZA4s)nq}>8ll0IGA{E0T^~r?w#}Pasl4}^wU$sE z?QO|Litx6E%sU&K${wxB29+tOt;cSu4H;777qm2YP*jg*e3TK&HjwqmuI~o18cw24 zus<);w)N8k4WU0AcQ7%yiVx?@+%i%NkXrNDqj;?56bWdY;48a_yZX>5#^{W0rsgss z6|a`*lDOy5@XBvDg00oy4DXLb+Hb-I1sMf|Dy+3HkZM!F0vZjsBC22quFA@$zsSD~ zi-Zd!?=fj^gC5SEmwYMQADvr|c*Vk~tVK7e8MD)$lcPqO1va;d#ZF=-WFDZWh%GA7 zq*h6l%U_+9PZ55?(xt5Tc>8o))WyFQ7p1CeunU`w^ovnv;OXj`G!?VMyhiJ;c3cRo z2j1a}GloQ|L_L`p#SB$I^n{bw1AaA^mMb5?l3V+|nsA{QwreNOrw8TYMXNByBjHE; zifQWyeRYy`Yzdb>jAXnU#z=1i&c^RCHS!dbW4dRi93%~GhU{ucT672Sg49-Z5fcsHN?_?+2L_}EJA;0|#9=ksnzo}%jgbcpv_ znd^L+w##SVLb=iM`DI$_6DeO&y(YQ0SY-tKz^-kZ#4B0`afO`Cd+GE^d5n7~Ocj%^*F?ae?<`C)hN~tiglIZ|w&V zG_@pdyRr&=*8sRg<%-{*I!cj9TSuI84K&i-&9CYRXXPFVSbAMQN0KIFPZ`hCW&IN> zcKY+P3D`(2`;DI5s8rr#wdce)KzP7evaA0-kz$=A|7d;|LvH=HyO-lHa%?vKlX{B0 zGmXlr^9gf9O#8$)CyaW3UZAv%SmnZ%$_~n)Al2&EWN1=2+u%o1+&s%mk!*c(Izi#5 zr;66yEo-@4ln$=MrPddEHtC3HI{iUZoM>&oA)bD@9u!xhs2{&!4qZFGDu6kn`CnUf zyq)M>FG0^OhMIWJ=La1xvCjJQVS}L6!uX}Gd}<7&z4kE%m+MDci_vVP3&iy1$^yOflooze36vZrdAwb|T zOw+%cH;haerR5ayOpk+6zr&^1^P9C{ue?1b?on29Ek9K#n?F;@h2E3Rpzc@8-)G5h zIEOt}Pb3=aQWm2#-NBR;w+}&f4*jqb=JzoW@GX305z2!K-oI*x|Ki=hw|y1a!ZA@|Ohd={!NRd z?qVrjhFUI%REJU&HNTHhmV~0&ajyC)Tl4@85>P=8Uh7TN7Io~3Bm3W!PX+&qBhe)3 z`Qbl-dO!5h|6{3}VWN|(apI7A@xV~dWI|DvyffoxLgXnp5dnquDokkW)8UR|^T? z-Lo5r2|IP)GMBW=GO6)*{^s;?sG(b-Oa_JtN$M6yBq(MZ3Y9K5OADop-gSsI*l~Vu zHaoD0TL|83yRzGe1f+O0NdjX2UJzIxwBB+HH5?~D>-{R95>(U|VXU3`TdIPfvQ;91 z8kv?NXDk0ffo`UOiXslY-;7ufY>3hSY6(4z5<^8x5cm2c zQ#?8g_V(V+a)mj(%$s7=ZzgW$Sb%k6^e25$zDO}3Kb7X@-0N&-cz5spduC4~X`i)x z6K_nuWQ|C|0Kd?0i?_itpXP=WpJ-J^OCt7Kpu6d6Vu%Z>aNv&Q=5xXb%q>QB!th85 zrZNu*xkG(7|Kvpf73>hYYYgET91hU% zH(EUQ6;BwvttCKztC*i_Nv7)1eFc@i-E1yeWYo*qwb2)+=qTe?q_mgKQr@_c%U7D= ziAh#Qs->=SxVe15>K!8?59@#0p~ljzvLPoVtzghM9(Zt|Cidt~w8y-hZ1S?>*VQve z?MAi7bcVoP)O#e)0EzihLQYc+JK}NmG#)6X>;@-XX-`xo5e^~Gs8lE-+S{vLM`CZx zKm94O!Ei`@A} zsXW?3wwUo*U>4pb#w7C9z##@UKXH`06^-RU#M=?j_oQ*ov0t!RI1F#k?c9gg^p4a=qCPJS~Aaq z!Dmms4`8W4s@iPsJdVd&0Otp~t8>6IaS9RSq{pExA99FJ&@4JxoQ%CwD++(8s#&hLSVTF)zhjZ5CH(#Yajh~+?pKz=xCC)= z0gMAJ$oozjI2Ot^FTyV$?i$3JJs#Vc{QHq zA2sF_myt#S@#c5TkNFJOl~C;r@KnPxLWL#h?yi^fQY0O#vxty^p0Sl^Yl~|V82U=w z@gI~_8&qgo#D@%&nH_usPM_*zewDKrr;XiDr9bqMd*WPRzE$*Q5C?YEp~2`*xOEPq zXLwt3Wg)%WK=JvC8+xY^pT8xHf26-x4fRU$_s(A2}tdo${h`SykQ zt;2BLnJ(_MA;mQ3l9P7wLCC!mQ>=>s_&Ov?!5|7S-7IOpgp4F7#Q&J zGaQ$#KG=gVZR*tLM$r4-)94HA`J(5!1Yx;4Jw~ovCQ>p0{i70dS7>kmmb^{U{pRPB z45Tzdv=6-pu4a3GC|VMpQ7Im%P$B7R$-+5QM5$5so9b$s_EP?>5f7W*`o~B9wyfC( zD6WHIUsEGJ8Upe_oKs0E3|DNYiriRUzFLYZTcB4ic&YOs9);HrYi2fo%h6obFW;z|Z^jSKz=u>H zuf(b-vXvSs1YPv;N&(s`$2#M;N}seUd|U^G+KmqiBp?=|zA#G97}zie{JmAeyf&?o zBg8yLqq(N**ga?aptUj$2Y8g|fcJXTqb~|&qJgbWPlx;TA9=(XYET*5CJ!#-Sbo&z z9MOMSc?VQZ^a2gGrQB9bn(BtIcQ*dT|+!yBZKI+A!?XcxCloa*?9C6Y+qudRX^qw!WpO zC2Q~-ghgR3B_rk==Q)~_?OlnjRCDIh=hQH>AxMoNuu4QI$pBZ2xN~4l>#!rwSIkcM zE*&7iF-m$i>&87$0r-%NnKVz|@GG{Ppe7v-<6NH_ur(qm%rr`Zy=ipg&i%>)`x#Av zIcsAHwco=OuZE8_RVni)z5Vs>@v=oGHNId|%A2YeTuUmY#&i{#x880GoTjfE^-tM_ z&rKi$%x)dp`QW-EAG_Z4---dR4paJ%o+&x15RfXM1Rt~MeMSuKkK5rt+n}hdI~!`7 zg83dm5?IE^79pOMXf9m7(6tDvfC$u(6vXYjD%--QPh5^n@cCE@RM#fT=H1k zn5DEu)NI0@;}Uk_V-oQ<;ouscs zw!V#|pn&B_q?6%GqPGJN*zDm-T0U9B2T$aWL$#%K1nyX`U@w=vrII0y&_iIO`uh~G zgYOUqYhs|k>U^vEbd68c;0E(d(~DYCD(2LIXy6Y0k>KlQqHT4e6H7dCnfyJl9`^i- zuzCKkF<)MtomE?k!`irH3>d6qx}`8NBz|w3-WfAvRm6*#2^^e2ZbCgs#W{IjJ`v8g z&Kl?-p|68w4CkL)6=@8eXN7F(vH?Vh9*aL2%}pKM{j@OeWlGkuv6r(z5C{=p#JLVZ z0&u``CG#772Ck6-f(rMibW>grzQq}Fn+#tq#o1+XgA9bYR|vUR#{r>EeO=<1A?@PwoSZ0@On*2Yu(D)Uk@ zKnr8kN?A6U)1bhv^qges-iv+5lRj937NwtnpxA6&wD0WBCsMUg4G9c@|Kxg_YBT@N*znyKk?;`OSoMTvtsE#J={* zw;vlYAW{99d(!Xj-vQ-5w_HN}O4FR< zxW?pEwg%rCL*Fi7G(3}2Xn<^yvjn+L-c>;IcCKi5(3Jj-eC+&c#lL<|p^TqZWRbq# z4IHGtN%oBy*huLKJ=upM$fB3a!{uiiI8`mkZ=mve?`!WWq1)2V~AxzK00+@1KC z2bkTl@JyxMo+JsgUsO$*k}66+KiTsVBqc=;5K#xsItU)UP2w{QNCl_xQuq)Z z@eHy%0-RlT8*J?QRw~U=>Yy@}4e2M&K^{bw>K8zd+iwT$qs}CLGwulFqV#>!Y25LC z*qcp88)V?7L*i2Fdi%yu%~a?)*7ZSWkziN(GZZgP7+_(%Z-9lP70>KZ37dvE&< z!VuM|sv40&tB7ciNq%MU)!<|Dzd#C!%CQ-BgT)iPKpJ1R5S*X6Vv0M{otI; zq=<9-7=6VX+H#)}*fev41VnpV_pKYCy9RRR)yBxbCU)i)U8iq6@wr#yZ5WY14$@Do zXr;b7NWlBjM;r>lZqwhzaE~=pV_a+8kVc{sso5~4J-R@LznZUvITqoE+k|Opnd02M z(zn*8l`U=Et`7ASxX#V9+4S_&he$Oq9~ z6W`xC^W0)W;(kCS8{*LqfXyTkH_9-kra2>7BwpJP4_fsT#+o&}V5cq`;qsgF&CKY- zO>S6@a}kzo)Xt_4uC$dueK;=Thu$AH58feX-)_VwG4)ugP946Z$hu^FDBk>7Tri_) zNrqS4U*M?yZOWEEo9bYEmNc#D7DJo4Y!D=jAq)(tdjEJT%J$=)1wwdlX|>PPOh@ z^o+Hj186ExB`jD5kqhc0{t6q}VjSSJ}h8pNLE5or*nc!n& zCfF^GAHirrAHALl-0&xQvYWtubu0Pb&enIb?GETk`r1}CK740%;WL9FXXP-$8ox{L zTt?_~%f_-laR4`NGYB|ifYbp?&g;YPPMaG`rZ@a6@r&n~dr4IWaM;PW3zsiC{&-}U z!N*2NhAk+SGS$_Aoegt$I1S@cr1y&7B+o|qLxs#mPc8}ba}m#i6|HQKzc7lxU7$A( zJ)c?WA<2A%j_wsa7ZtyKr&i3d&gqpH?O193x=hwnb{WT51J^>E18>XZ8jGM+3Zk0J zoD>L4u|KsRKRFzaY`2l}PG0*+irq&knLQR2S13!PX4d=Vr?ayz&3ayX zkH$z~$l41>s=;nd940_QTeNU)ge@BzT8F2Za-GVsByEwyV*38H5SHmt#V}*AIrzv+eHTqb@CMS)URFAKWHA z8WiL+qgBHmD`-b_#L2oU=ANkY3c>S{lYe0|4mx>+Ce%AX^-+cc#yK55jr zg-l|w)FVsgjpw@ym2}zf6+;RMZEKI@0*)u3u^kyGu$ z@r3H}9XfH;WsbB67zGE8GT;aP*Zjr;VL!3;Q7ZKM@P*RN@*bsEFE!J$zv__8atJvY zNGE64?{#t61oGmkHIaXo(B5Kk#~L`)Q6{)iBtOfWM)wY$5%`@EE3AA$T4~3(R{h(9 zX&Bu}WfZu)P@bUX4rUJXVURL!ui1D__G@2u9M5*t%no)`dSyAgmUeAA_b@-HD1ZLA zI*^zx+aQi{lEq8EUbH$e`B>SKmxDUH@aX-BJTpOEp5pOmGBZiea0y_h9 z;F90{qD>U)~j>_B|bbfLIdm9wQ)%G0H!dZG;X zF1D*Lb*^FUUNbCP6mzG}hf*{Til|(UnF_^JGQ9^-7k$1$O}8_RV+~rV#$m$ff+{HZ z6u9V-i99l@pXA-~);Midf|XaxiEUBSAr1TDhpx9bPi^qy=_UP@!P`IB*&0(&ye|hW zf4xK65I=3c%n8z9-&la?a#a?~YM+~8JvY*TC@d|b2gUJ_>=UmGHgXNJEa}V174RJW z1as5F-h@Wq08LjQOPF5Ne-auHa;>MD<&JqK5oJHMwms8#469^;ogH%&wM}|)!eFq) zkw`H#Tpe~Av!eo`T1|mFw((4kdC-v_B4?`v;IA#ZJXe=TBT$lv3nf%~Ex#F&0I#$S z2gd_?7}DM3L2}al{-IEtF5Tme5q87?7F(OZiDPY!YvIPtBs|ANV5fooykc5B*hSWd z_F;PVFQdDpj~9-$MYso4c;S8)H=fxP1MOZ7k+tfV$Av_jHNBn|-G;4E|t_)*Giv{vYb@5gK4+1r_nsq^y`xDK_uK+Q(O-A7S7`}W(G6VY*^Ky zl=oRgd>+a!ffNY z^WV%12ZvCH{0~Xbi%&$9AsRY75G{)b#l*}DMr?VOEmxP@z)_;Z>I(Q|OZ;OxR@KP^ z+gz2)0B5f=6P{CXEXe=s*Nms)`c7Z$Q0bUiU(AVIw~9tq+`$&xfdmaDqm!n3DML9t zhH)?`HMPh{FK)j!VG$|7%UOBVDjZ3dgWGmfSLfQ5IjO7zgG2*>ZEoSuOUFzn{+O6> zsn#*Dlad)$XC&qwDCCAy)r3P>`_zl|9{d2M2a6{C;c2(@q3)51EX}Lo&g*O`M-nVO z%R`c`ELm@Oa)el>>|)8c&809ipT^U``zY;o@uEbM`^R7n3C4(YyRa-2-%D@BoNx$u zx8V)SKSp29vHNpk;cq(JP_SYm-?Wh)HdZ8sl;iUw?plj8!EF8dva2n6cu=Ii5w<6N zq@rJjp3NTK|;{h=!JU)DgANNLFaLWptNwb7`?rdngTQkVtMa`Rgsvnf(pu zFAyGrdPov~P~rcJncib1j^PsZVv^niGM-gf%+j6z>8Z$N?BqQX$c)$gtn*=bCwALh z6BAC^5-@?JBsS4_mzmiyokYtr?Iw4p{39pfkqjAj1junspzm&fG{O5;nUi$d z=(lp5Af1o9(ENq_CaqaLEPjU8nEM-7k>1ssS@idLSL6M*;&Z%dYBBrY{CzLCDSKPo6VMp7uL{{2~=sweJ75i2J{b% z;tNi=74JZ3VPXPL<&|+kS`_c_AVg2E=J$`!=b&3}R4wVpAer-O-*DrwPV|jm_P>!5 zsebsJA^gt{nq(4M>29y@?F;b`Ua!u+qKS)cwGeMMuk{ zb+Uj`vA{}VbUg0LEwV`7FA5~Icn1=?&r?T*5@Z{D`_^mbL}X#|{#X63{;zS&HJ(0h z;MjNEtC%hyEN=)O+6rTqpXeYPUGQ6)@hp&^g`)M>JXxrCoFJ5xs z0;NPQbfZ@CO(R%k-kOP;sGVVSldxE z0amUecs;{oEHuK}=Z!kq+a9lw7DK0gzhKq49C1A!u`_3X?7&z8n_KIvU7-goJJ!bI`3XYCe+##KfI;ox(Hj&h5FX~Mv~@4Vp&4^GZ2Wr(A9wIK&a z>vpa~n4niD-y#Xzj+(6}$Fmr6UM*c=3p1#X(8q8$gOJ|TGGwpF3z;Dv+q|9 zeof0CEEjK_MWn8;YV&1tr6CUjUtxC}O4pA`OxP|rNt6p_B4czn(aWu;!7~cIh;6CNnGf9PMY(k`hCdEcn96sfRs8$ zf8Z3%=oBY^5R)gQ{)yNGyV?OwyrC^%9)gPCAi z>@xU?PhBch;5!!^zx-Ha|BC)dP9q@uYS5-KwRn?-{1FH*bzQ+-LL`@U-`R%99`bIs zG$s=tVi?_?rpXC;(K>}nb>Ei!Q?M`A~Ye<(rL(%4Ii$3+`N0wkB(nKn*l;U ztxUaCwU_*`0S*aip4JzKg0}erzYVRrYkC?XZ?|}f%^D@Zv?1cVs(}OYFfGgsL+b8?KkcRr+^;YZgV!g=IL~WlURBKKCJv$P zE&ce^Qf=s1Ju|XXi5UsCeh~6ahc(A0`_&BSGw-qCfzP5TN&_5$<~5v0WR~qe$G~d- zh=#&GOU?gIR3V>YKO=ttHW^|Lyvd^w|H=2V(j3=!bnXilIBF4Cc{}v|Zb-SC`p{`S zGNCbOC-~@M#ni+)L{sGT26cyFfdN}o^;G?tG^f*V2}I3Z#sfkRL-0M{zm{pscw~%} zShvcC&KjAg%OybDNO>6bD!dlVU5FO6(#A!TFR1?*IS1&QVO5A3aN>9zt%+bESmn@6YEI7<5@5)IH1DAz3woA_%S7-47WU~MT zZ-v`li|G=E9>%LkX4gCpDsb+2VD}DAd&=#WuthGxmUhjnY<_%%u;$AOl}#XG z!7UZj4#Celu|GL4H#d$4+V}(UL+bF-M_+&1E5}oWWM;6v^gOXf1>A%;-LpCP_=6g; z5KH8L9F8cAI{ce?CcQUOD4jx0GAy(K-w@uh`}oHBFtZtoB(vr-C+_2+iZ;%>Sf*Vh z{d)o$CIaMNAIT<(gov}h{CxE9S@{~?ty?&}hhJuPvCF)i3~SlX$v4q0y+6}lA;xMB zUPl~#cQftj!KVQ3GQKFqU=k?q^YWL?G-Hm<@KFkoSwhbhyG3GaeOkhgN9?0g@e$Ie zxv*A@T0WxvRANcH0{ir8Opu|;v&|tZLx2mHo@y=rJSBTsjC%KIh`b_=KSn>{x3=AA zzh`4#wt=RYQjDslRO#D}L%w0CYmGor?UuPp#Z|Pn?VSyoa=~x7mT9D!>n_d}*c%#I zJRc?=OQ&>cCe!Wq+g}bP(1TM{ep`m^AgvhUmM^&};(Hd2Qmu?>#&r8A5P%l}eqVWly18 zm;}aWv%LM}k`|1Rech&Cw#ndrLNIEyK<9F1SVzoMK4G_l&IDWy5f0=}+0YzmPGL*- z>Zp0$&#*5pk&ft?mwMQ&t+4=deD!8tNu2C2$x+VVSBibaiFVIwywk&3MsSaim5CVb z<4Dr?8OHdz*eP-Mid&};C%{^^_+@>m))q>n?Z%qB78=NjHX~vh3-?^=iuQAr8Y{S| z!1O1BjZ3XGygLyaNH^SH zw+``*ZUnlcmZ!FnN|1y*I|xmf6p04R=lM<6tYR)mn-S&18pxK6gj2BGlA~m0zsik5 zAv5Rh0H5_J*7WZK)tnCSj^yOaT$V3FYLojZxNlrO0a#CkLV?S7TZh^WWj)6^6wtcb zhOvDkIHZM*w?MNJcjL8CGo&b0d_M;Gy#UZdcGSTGtrD-M06PC6=f_(5r$Q*HBpU1; zl3=y=R^$yH>5eB{m!` zF2b;6TLz-O@S#B}!i7wI*~H_)0Q;R`!67=t@F|i1ygb4tQ-RgXPXOFYQ5{D=79)6H z)@WNTJw7MJkF2d}FU5cS<>u{;WJtN`*!RC@AQk$BGfsNA!ZDdsNIbq2$bg+J^~J%m zJhoKX_oTDryrV3&@63~1{0)5Ra{WwdIi(u?^Yc~qZOsKin0fovIK24+RAAqsRpK26 zwd#Mtxc+@aTSwBYTJG1p@Z1=)u4In0X||3?PS+Pc2A;n$rrTo;m*dM!;i}Gr?k9nQ z4JjMY!EiqDEgOlHqRP^tdEPk&Qi{r473P_->^Al6;45o!YBSrXzm*F<|FngrR4 zS4!Hr2h}F#rujHWC4G-*I)R#Q`Fjt+_C|B@hkGKE@)8PfJ*?6=*5AH?W6v=di5wL- z*zyRHy%H}k)1=Xd8dDB24-|6`nB>(efo=P5Y*Hp>MuaX8O^FXltOqbkI+&U+g&zKm z2Ckc4nBsV)gI;{G?R%V=DX)}X5e^Z=r?Qzbf^IPc3NtaQTU!6l(RVmhJwad1+jT>* zVcq?rT1+~n( zm*Y$>6$tgz)C#yVquvQ84y|c+7+;PB!;Ytuu-3x7=CJwiXJE6{VuB=$uE*66M9=Am z0pBK|cUqrk=}8iixcj*IqYF>Fkr%x&yfWe$R5?c^R{sx4*BKA@^K}z~h#-k*(OdN1 zqHYibK}7W4d+%*GB8cd9brD3jdS|0|8=|+>h1Eq_wmkd$KQFx9kD2exz31L@&K*;K z9DA(w{7Gru^przgKtdoak-MWQ0|sRxw7+m_3hoXjr8C*T6%6)Q=4kuH-c7YS0~*0x z8CTh&=Z}r!g3;vnDjk1G7u&hBOr}1V9avc#y0ZCoFf$jp{=3M{Vbv@zL^rjMMAi0W z)1}C>64+MN1vHJ?s-a&TlbQsPxf~8qP4PWlm{!h;|ywZgN69yA@U(F z)&ByIYguUpkfjR`QkA)ThtU^5H(bIUEI*9U zKU$py>9=^Kxf@~kQLaI}X62!W-XSx_ZG;_oWn?z1Z%ljC|UWIB>HukrAd^f;8d8{kxrwgA6z$jS4Beb+-mh z*o6%NetnB1PS2&g^|_5;{%ZjhI1!?HY%S%H@(lK@T6e4B*-+7#uw$OI892ba{{9wa zRpwKK_+C}4`c~5*1+U1*eOLcioVo9VVBuOXbdf`vQskvJLMe9g*z)jE(sDl~Pp}b| zKno52qJ)cfX3Of;sXfCG3;pjH-5IQ+e88tB8@ScGLAEJ@hu}zMexD7Isp4uWN5`pm z_IN_y2&-1UdQ8KoN1d=T#0?sB>uukPZ?fP@zA_IY30rN=@0C!|g8CQt-+%ijuV}u& zgl;Pql0#@K6@Ig;`fa6|kmEP%_Y=-IO1*D@4`|<9=MVG0a(TM-jq=^0!dyWGJ z*`A(MMQ3G=M7v;XHmb&U74_yg57P^wD`u3OP3MwWcQ`H*c>m{q`^!j&vdg1}T2-SZ zl{(-Tn6h1)Gx; z6YjP`J4P!rIqcc}3&QfZE{hjTzBO25j%p7F z%Y%=CAFu&4xHGftN_a2%WHGoquH1gPF_m|sclw8H5Q4xo^b=!Q#{IF0;7asC=^Y`+ zDuo^NB2bMpITq{Q^}PL1=sBm=xip`D$Jo=G=_)AOPYc04Ob8?WRZjU(AJYsgy$GGj8>-XM$j4@zSiEfuZ{>}6=dCiTiMNy4y2%AFN)d_B zmroAK!WhPCIS{&R!qJsM?v{SLC%OH9s-Ov94jj~v71m=oy^7punC3zjUwa`LeCQf zF>%^Qs$~Nv0SEW=%&_&xP#;$VP|cmgKO$uDfYZ?AqNL`xqe*GU4&(;bt)OD8LvWE9 z2TOZ&M6A26IxnBCv}-(*9zCiw)5(AN{d}uGn*=>h4aAl-EINwgGnk1}|e4#9EC2+{qna z*Kp3t*W!kzX^|!Y!>D-(IMQQ{t0&@mZ2H)YwPEDlh*M}0(^=BQRrQ=lT%2*d&tz)d zSOM$ASWVKc*RsJsvC{0+b9_z7ungxN9#dDJhd%KPY8%RJv zn3;LVRhlb(Z9PC=w?1r?&*r>yYiQeoF*j9v1pubWZE#7(fkh%6!OH@1pe{B5C+N5r zRj@v#YI~Ip8%2p1BoA~z`EO5IlI?Xrc0CpFOU}wVCYJ!vg}ANyw2Ygf)ymx#c_uUj z!7x-M~)d_?dybCCWEjaE7rrZ8tS3v$UD2d5L3BZsah=Pz$*Ine&?HQhLQ z8RrR2xjv#f=^#M18*iSZw+(21Q?$4yZJv5<`t9ry;n>&9a1UCxxzI_=XRr@ki)o&d z7an7sE~X>-8b`9&x~ah`L8+hI9*xc1HmuAM*|^;+rsDB7oay7#60FrcGF-5X$8IMD?UKr zfzNh`b}$bCq2)(XLkT7|Bm6F1{Ej~lTUVP&5$3A7=%eXe*6Ej=Um<=3D!-!5aKh7l zBj_@>&lOCz0+nlE9zBhGmvYjkR;CN9O{%64N6uo03zUo zul6vg34lYCAox;q^2zobsO`!2@d0${;eTOXLJaYFB=CXI?8O^hTj$Vpkb}Q|g6SoT z)Oj+w+G)Sdk3r5imz#F8y5!9)Jf?B2kshmjBr@(PyPS}e{Q~3wSEr{GYB&qPJTDjA zfI@^>q+QzZf-nuSKHf|16x&B&3|}P0cXFOTl?imeB}5cU5P_pUc{OgF{AM9iv7sLH zM>}snm=9<9%X+3T9~a-Rsh_%Gq}y@-mKr!U*?t(Rq5)lYIxqq~o7=;Qj^Ec{RxUF# z7)|S@#$G_q)lyqD=XT`4uKj@o_%8jyeMrPkh(zL$Rk-oAx1bY}Jms8;u6%RlK%w3J z8U;O^QOhbLFA(00)?x&Y1oHg4FNHRZWXEM08$2oD8 zCkIeSl2cl2NY^9dQLC?DH;>a9T5yFdOw*6L)C;(-TXdG^V`Tn#R6farV5j#0=GH~j zmsoEcra5TvQdcXg5u#7T(O1Ey$|_Z}>!;CJE!?90>H`t{bwhevTn}z&l;*ZSruAJ6 z!?8_=A%9$K&t%}o*hLx(K`3@SU_`gsoQr6ey!vh6-NwM;-_{e*pv?BSErDW7ytwxJ zV{S>*s-GJCD|iD}E1HKL!*u3;p|Z-j7BM5i<=d_&0Etkzs$Z6$6D zx)sUM7P_$%gfWXyTbI?SJKLSfGEQR;Gn8^slAEXlhhThe^KP{frf3JbmPeNbWM$Y6 zoU_5DXE*CrV_a#?Ql?jCHNpUsS4Ga0fq#Pb@cv5`4!!2Q1adCYdtEnseDe$Sx@E+5%}KpW#}` z289PAiT79Q@0+=v?$NCrmxU}o^zA7s?R)4mLMwwvdBDnmk$rT#O6CW~_p(%L^Z?5Ia1;SmG<%D-c>WN#?4M2?Tbhail?k-> z%yC9|&(lwb*rt}T!y(8sadG|+OjV7eySbmcLTs@hG-VcghVxcFVI=&LPCKNb6T9yL zZjj7n#kC`g>_!^NjXN90_Y`j4(?)=a6;^~K_&wUTOSdE7*L2>;!lk;*_cN9~%F|vr z%oU@mR5||eNXa~>+ZoMCFG;f3ejo;I>|0xQf=(3p9f-F2rf=i8o*VW8nHiX7<)l!lf2_hI`7pK?ZV zmtr2$)kvfXEggTv(vmk*H9Vs_0O-;6+%nyp`<&&)!Rh+(y#Kyg-BUMDmy^1vl%pK| zK~ZBSDOMs3^m-W8WI^w^r8oD-?HixKph}gB(o5iaWEhiky%Y<;cko(uOo@mobvXde z4`00gbeOd)NVG>j5@_=-ffmkOS|uZY-Y9K{CbsJM#z}%B8x7K%v{cI*uKa=hOAN0K zj5!LL{xahvAofn)02dcipE({UbO*zOoi5k&Ki~FO9ijg>`hesO9EaBk-ZXl@?ilvcvtt0 zkHD)QgWHW=3?pg_o{SW<5TzfiY;0Nn>g~&bT7{?Go-LQ)9BX6p#b;$AV;5Z3_gu96 z>{)z$f?v7pgz0A#u}LR`-`@v3}}Em3vS#Y!>$n8619*U!)O z=YyH13)@s9O5ZfQ83Ms4!+=yimz|T@s}EIZyk&(0`)IAHrj9 zB70a~v0q&;y8$j{bxKK00Ku0N6R=J8{kqY!m*RqlM;QCX69Y}qiWNc^npge%57R3` z9)w&9_w-_N>VI(j;a%`$N|7{&8Y@f1qVvUDHdO zvA8y)PPB>lUqKAlB(HdJ+oRe3FMO*3iS($VYZ6R1?iLabdg{%+K3Q3Z&F$C>9$|Uo zGGz+d@?!KE;CXS^4^nZ$H> zC*8JPxk8$*G9PitdQL-P1eudvPMreHj2@`*S*8pGI}(3m%qGy*^g5s$p&jw@%bOdx z6(p7`#$5l$L3r(Yi7yJp+^=jWJCRSc~3b#XwPXFn;Y1ogh`(CtS9~oxb-l+Y{~ZT z=0zK;Uk(LTtkCP%g!6Gl@h!<3PD*PC(0jndHggR)CoDTZABgJfo?mGsCX*!4YRf@P z$*ZRA{>DEs8ul{2bL5u%sv#)#9hX3-a0zrMikqXmFdu|N976dpjtKgZeM`+ky$JPW76CR7Pl* zZ%>X1WSGEg*qeYKgG0PCWwfa!M8~9lXt~G-II?+4!YX}lh0FKeN`I4`luRcTNLnM$ zEveGgY;D6c-ubMq9{K&-p27J26qv$hFuvL}i~4*Uce%=Yko27aB3Beh#3%l-jnNqA zLI=IdbBE2OcOo|9y+?5^A)(;7=p8Hr*geBXawy(V)G1G2xk!8cO9ClcW}uuTZM&TIJZTtwuiKwZJx1(1~Wcue-B zDg3|Ur1*y?(Y~#D3FjB-WNfp2B>>O!U;m1s${M_IHD8bhef6gAYnv0nym5)l$k&UL z`Cmu=U?w#rhRbOnmi_UDQ15+vDTggX*+#kt`P9YzFkOyA1Lu%q;)gq2 zuTq&xa&gKV>1;Hq%#Yk^4b`$$mBuFj?KqamptEyQZ;r)w-xQ9MJK$qgE9{SitKd$Y z@)%8I05Y0Pt-<*me6b5fI1}(*AxF8pTVL*HW+~Hk(`fdGTxX$~6)r)019UrLaRzJv z>9N1QIO=Ne+BMlnB0imti^nUzJ~ybDOpSC!3tg&lU;`pkfMWg_>D)iYe z_sg=_Mpizuzv|J{RTq$H0^!f0s4-@rRV(+x(#0JI?T)iyZ#^vmxVrOe*~dgvBiM^n z#M|;l7Spfirz&+aM;PGeW5_^j}&C&aUv*J$Prt0 zC?_HqyWvOcF=KaOtE;sr#zF0B!l^B@PqQc@r!R$8x$q-D%rIe+VJ82w+(8Z-Q(R!B zcbT#M^F~)|?G*>kt<9+|=alMd0T2#WsTyk;y>kyVJzkLk%O)yVzez4^`Df(8n;xiV z1YjwG=rm@kz45M9r?Yve1|+;ur|;} z$F#tY#{AvQx~?{4>@4TDGiM{j<;urE<3_RaQ2ayuPd+(MD4%ISbsPvw!X<_a<#U}c zcxdX|-G1LOd~)qrCR6NIu!uV!W`Z~d^1g6dInshk#@#ki%+03)9hPSyK2IfiRs}I8 zNx&ihV&Ct764FW88uuKp3#wd#hLi^bXX&#Z^_UJqRys7~gAr`ruzV%0#c4HFgh-x*UTXc+Ch9 z6HH{tO{HU8VFTSw5N&tbIBZiEVl?^?LOky>b3F~{c~8(wTi!$YZQE^?Dnmor?KW)s zn$vH#Yr5iPJYpKT2d%pasO3U$+$Mryp-FYyOu6b+!8WQpBC=@`_Hf7!#C-4RKcP7GCBy%PFiHsDZ;1<`ZpWG+83W!Dh!evI{_n?gchOOv4Y0ws&rmg79&Mt;-ufn(+*f;`9H?i9P;k}hdN!KBQZzx~2c;uco3zv3y zLU(lw&ADc}S0(oc=Sz^S6u|B+5jaT%K8dEKkPlo@;n0?;#5OPVO1eJ@vxJsqWvN^6 z&bp3ny2-FFG?+N&Bov1G}hiroZVU;$W(~DI$R^m@1->TJfrB_NHq9vU= z0Rh((8(!TUr{=!Q~cbts2zwr8oG(BK^A-WR?22UyDgM8wg1X1|llz3kcO{dcL}K&z5J!v(V8F?;!iQA*5D!o|^#R6k^UUJPtcwxNd7Y^v~d3|Vw_ zD=X*8fUu|ZO=*7>s4Cv8CEo`|yoP!yc*HlpU(v2KN1S(1k){uO5XzBlw)&U>B`LDg z;AAzNG2F*YEH?ir8r{Z)<%10gTCE=K6R zo?`)XlAp=Lwv6as0X|Zn1H7uJujN`v!ip%qefHpHX)scVWoeHTR|9nl3&UpeJzS*F@TAQTU(PTkuv4FH{2K^#VJVR`8m6{IP(ctJR(Q z7{}{}e$oNNf_M(ZAs2IMwoLSYRe>k&%;I#RYI$m$fbg?DphA4~Yi2x`mr=}c>n|*? zf(3ul8$G#x+tf{*;3YFW_<3!mP$D2xGtwen?O6+c%>g?H_XFZbANj{11r|}L?sJ<_ zkL6}y_m89)CgA}^4Q-;$zvDf#Vh6btlYMl_`$jK2gV#~E@FV;*8%wj|!`8}<(*qCuSn3^`O3Rr{ zRP*?`K@DmeuQ$np2ON&7_&nmKx$m=c#n0L={8fiyC9y5Tl-6PP3Nw+{>PeMsu$QMd ziJy3=ytYe#fPYNVjEyhr-A9MHvnLXDLtE^NSmJlwLT^JtghZ^^COLRwn1yzAM zxH=wBlEs<@8hRkIW#UYrnkDrvii;7 zD$2i9_>xRT8BXw*j}FUQfPMI&_Z>?Pp?e#9e2i?ma+g9Y&>c}%Yjd>ymGf?!_+Ep9 zXm|U00kBAZ=VD3WF)y}l=W-Rkw1LcCwk)GlyOuaE;H?4s%ZI@R7#3#a zI)*DFy7~egPxc+rLxiisA2r9Ylh$jzKQU&{h5^`ueAzhSj%F&wE;fprbDtsnO@7P! z<5w2nP`&-~uZ)wgP$dotg$2#^2p=sSi{l#`mn{pSIj*hPjASAA$GIF^*y8^k>Y`SE zn-|pl9K2QS+4U%^n@gGLREgZt0vXYcL2F)u5YON7Xl3Rn&P=4Vd4ef~^wZ9q!z49= zX+=SOv4X`$g>+PH7``M6W9~G5P;VHU42qb0L9S#RylBwdKkGVht}bt}^jX8)Eh{I_ zj{%F755Y4Xl;HY+&7p4IqC`+zZhe+$w4Zi2tsF|c+5i;DCD@>gfLX>dP=Kgd0u#M# zw2S_nR`90Bp?pkTXqx9&u354<-A#e!9b&SuVlD6no+2#i#DOgqI8 zh)md)!Z^U3I)k@Zv%L<86*APE3fcL;X4deZez}4Sl1-UvUY=Df@$|a>?~`v&ZSuvg zc`CoS#ta$0B7Eljg7s>)gqQ!Y)$+U|40!a&jFd)+Yz|;wkfB@E*Hx z%C}AmHWN=6jdR&;<~!0DPJakcRix_>%S<1L4#+`+y0S6=&n_xHBEt=lZYA`Md#T#h z{pHDD(q%_2N34>pPK@~A=gtx-2CTcY*JSy;#@KPG?#q;&n+3t@KD)8q@BBIbm3B1^ z^eyp3!=yNGGH~0SObgJC*+;~6b}#gRU9T$ zL0SS^DP9GB^3VaKc|*JUUu@G$K;eSvrk!|v9H^U8-xt+TbP2H)&ehxk>HY68Y(3F8 z1Xnc*DO!aeD59Tk2(9^Q4#tOz?;}VbTk20`SRd2U-j9kd7k>Kijiu(rdTQ+_vU-*K zFWQnD*NMIloC!B@Wx);pRgH>Lo1Cg1L+CYPbVTyb!OuUnJVx4m+FZwAPBQnYicAgA z)eN?z4ft8QpF5XkVyYXGI-f0s*+1#qLOP;NGQeIcX%L^#qn{js$XkM#`KRG0aGxC> z)6QC@L=TETf*{}z7zvdH{wq1LC^q0><#+zdBRCj)J9}|D=r;BY?72C!oOc4*-=Di> zisg>Q-;4Hg&pc0=hlT!t?mS{~PXMjdmZ>vR1ob6iXS4si^y6%)cx$0%gqluP16n&e zV>I;m?wzk9k19WWq)E-odHBCjMrarPs@~GzYvKng)U-Fdm#Q)Hos1;QL|{sQg{QDGLJe) zF>8YorXsN;yx}%zw)PSw_J?A9>Ada9{8MCMJGu7%e4G9XdyHQlhWfi&Hon{jtN|)a zT4@A6Z8o{7aZ2Z?n+*Hzh%9X8GI@oIeEz`1L{Cs?o+N}p!ab=Rl5J=1_+DU3Z82<5 z9*T#znCA4<3y|16|K0V{ub_@NVY$Zpz|sBkqqK__c<%+kgjr(BWck<9Qn}85=XK)O z+sP7*_w{2D znEI$rG~~?2dA%Me&k7yRE*mT0)y7X`FpZam_` zE`>1K11MEos3r1Qrd{(7BMbtlkrnz2$qsrUv!9#$8Ts)?S6wA6QYOCtLOUXbXf+iT z=fMkqSha5;T|A)a8D}CCK{WI`n^S7{YlystJk%7N^oiGU@Q%Ih9rZJ%p7#Y#?K_eM z<$TBTpjx;Nn$!5iR=7y?u_ao#)qtb zOTGmQ_{xXt@%mGKW6*q}s_B8uj2hM96*?yR1cvFoev8N0lxR9tyATu;Go2mUT zo7$^v2vLvk;#rubf$NK^!=g47++um?qoN~kjZl|a?!wkpH?i`t=OZ3#9ehZ1o@^Ii zD{x}HtFiNZ&BsZ&I3MyLgyYJoH*Zq$I^)@%zAB1XzgKwFx{w~ zsm%VP-OsC@QzDZsC3Lw=rl#nsVoKoDUY0RZ$*uwqNt)%xNNAM!+Rshb#+)FWBj|LE ztwzy6@vNZ*;xRC({Kh=XaCx<29%^;Qe5f9*dVT{gO{DJ9U)#Mw3?<$`8&K4i?OeMe zR2jZADrQy3?lFD{n^8br12VFJk$XQFw3RE#Vhur_yBrmaobR}|Q5*!hbIW2v`cg$O z+%_NB;<0}uuumU;$?m(-HoL{60JW=GX@ zOP&*(^p~fv@Lb$UmLg?LzB8+)ztbtgUaqL2h8j4ZLD={jF{e}bfyd*_uWXFbq6NQG zn!5aSqUmC*sDxUiBJ!mso}R0_U?+=!*!O~%+fvod5j`T-??)E0K$=9xJC1#vn!Hz2)s-|Al+l=_zEmmh(mk?)Op` zax5QTs!g_@j@Yxg_$=WoRx%|cz0pnsbeiX$_Y>ihDG$B)o<4RJY(`E%SPhjL@JVmB zrI(Z<8@V25-opp$c;%PGfi}M8$YM-JZ(z>esDjD=?V&)w;aPr8!>cuyE!B_t_)SYer2R>vAoi!}N z?lVvjup3HO5(U|IEB2-#gpY#XA^C2*fK#m(mkg(YPKuG=U-fXL@06!nEGG#X02$dD z%3TJI+Z&jRsJ1rbL9fe@+vzVT5EBSvuhnO)kZ&6}6uyoK(ITR9ab^fHy6L@L^|OE2 z!6;WI_PsWYaL>C4L#e2`z*c=+Q9aY|(w>8R%0?(sXQ_N#C9u}xIp}ta?G|}oZQ$P( zIUH~f-o zk=Q_E#Xj#PE<28Vfaa-xMcXXX>cg+6`D#oh<%qpRa$4A$Y-tZ|CT}@YomP4om{hMu z^FG<>D6u^`co0w7FUS4Y^;E9$S`B`|Z2nMkjq?pXcZwc&%I?ZdDG&R>UGa$~IQEA^ z04FzeB53E_hcOvW3alE1wXs^P3e%(r z-ZgeNecAgw*)|;5uqfGUh zi|ibeUo&>augOlEs4BHU#+RF?ySg-432lt~j!R zn}uNU9cezRzy0|TRWX5YJ(lVh{0L+@_4DJn1>SzsFcq;O7_i0veE|0spnev=xkaHw z(TZ3OIg3FU*Z>jZc3TwNvti^%1HW3U4UL5}uY?ODX*K?0^%uy(kR>EPPCRyib@i3B zE$)Uw)kVxl5jb0fdw){Oi89)xVyr;>Hfp<+5ub-WFY|-y?v2M)%MuON!TrDOyZn?N zL?wS&DHZzHLdEm+aR7hA!&wf9N-oEehk5EC#6ldc|Gq89JRw;So#TKv_lZh9)b@d< zfmy6CjK|safudaX6di}%B^?vP?uW&=cGKqxZ8{PbwxNK1#1NO(j;Zz_Z+SDSL>_c_ zX#<40x&O64dz9HJx%JgFam)?46YOC;{|!9(B!~kq2;=|~#Q4l}(<7LaEGvIeexBIP zjx`>&UZ`uNfWR9c%H@e_w4*m??j55i&EI(rMEg`b&vO)ywj4O4Pe+&vJo*2vG+QGdq%jSf0$;9m z*iv1XYH?)kyc9~Biv?n>tRl{=`w3`y3ZIs^hkP(4i>MPXl+&8M0i<5Q;U~jS$xXrq zRFq$5av#drZS`SA)YCHxX~KI*;8Kv=OT0>R;;NyjpxRFopMO)C2vM^o{iuB7L)0dVSMm2VbVXeZVnBd& zb2ktGsJ@X;f0FtLbkoIPA1)g99#4{CHAoo~w!Eaj(iv)>b|JT?a$1_mG=RD2Te=|l zqQd++4MwJJ7@Fbz-25p$x|u&VS#x4#at>z+*a}xAZ?~nld0b+|OzDB$m@g#c9d)vD zp^yin51csau5uX$yWp!4;dP-^?}UiIsNX?7gcow{Td%WcTRqJ$sY3yP#YF7IKVjLR zPQh_x*)v9AG{`J~*WBlf_0Uiv`seL4;wr$+nOb6%x0$BW=C_WObX8*l+YFR>KK=>) zTg6x-!i|XafEs1$hD}kdlV+Oc@(tk61)MrSj3OMDGYi+=R;5ZD-_GkC%1lftvd2!CK%+JszfV4QHi;1-G=paJ0lpB4K^+rjpXIxgV)C_Eeir`mG!eY^l6aT8tok zDkBCaqcYaN8Dud}GEU3YHzj-)koZ)QK!_s3hp`<#kmq4;VfK4SE|Dsb{pCY7cG6q+ zotCiqvTxgaUxy(Wt!L63mu~T=zwsXCT%T8eX$7I0#Q8;4%)?yZL7{&O!vuot+A*HX z0;bq*RM6hdjv41^4|Xx~k0=e(LB)=b=k=tXZNDGX%r!L&v2W0tMIrXKD-FPNY}&DoJk%oK6x z?p=u2UQ7N^>d+m2FZ(c~(RVBWL%`ZW-o8Pk$B9rHNibVK$%O7@&+Lnl6bKyfV6!tBpCgQ`qg zpIyNd`B=c+zVN#RQ?_EBYHXK7wC9kdLx$l(cPm3d*a*QwXYDFT4AVsH{eaGn^Z{WGCuw7R!Hka1oEg4GH+>c^y`*%y0x@>FU;z@gt=Fmv8#WN9-fHliR_12LGMvl>qiAW}$ueqW zXt4uCQrSwl6{_IM*KqNOh-7EBLc;V61wYy}f_CJG2;VPfvAqB#>Q~1^G~@|h!QTo! z9Sh1ii5{txF%RT>a6OFld7~!)06#M1IA7L@jLoqtq@*I>HV_Riw|mMX+N}88s}txa z3M_H3=YwBM}AVN585sjc;zKM}1LJ*(a6Yuk6w+BbK@ zN+G8U8y8~uRGB)gTLn4dzw=Yh;2ehzfhb7%|8|vM+Jr{_YUyR?*@4&~=O;UC>USKG6D{G1b5N(eB$g&`apSdr`p$t56!U%*er}D9 zg*!gk#{;Q+Ue93g(>MDvlyB~idzkV(_+9GX9ZG`lipa>EcLV1dI~vIa%PRUj{KHM8 z;xALK!rqPZ&PJX#RT`gG=!x0{`MFv?K0#jrfW{~E@H#lh;( z^@^q8DDPI#bAbF(qJy%&@?O}Oo2oZGUPg+9;jd*w%ML;IFsR5-Twsz z_1p%`NPfOZK(PhUX>ya`x?mYi4s~8YUV(t^f_V{fd(04#%GsL7p|?$d6B-UXewBqO z@Y=rFjz`o2&3Pxj5cV=3=f_sfzpJY4dg#JF769;D22&b48FlM@e7$CPKYTmvWi{G1 zFQ`Cx;6R7N`(K-r^B~q3_lVP5g%#fEv9gB`o1!29sc;y`hu(pROF;kGn@--kk3l0p zp98UWM&nN9QyVbat-E71vkDX`UOU%(%Xb*M#=s>5Ktq$dQ0mU1UsP}-SRgKVh&rp; z2M-7SBnaW@+A34#-nY6;U;F130JkqaYh({cEr6BQ5Itzc}UU(N_janM9W!%Y^WX z2XfHs+or&&6r6lL8dktCh$cVj`~50WtnAY#;bo{U)rCo=s&(XcI-JaA8RQ%OH`$=l z^t|HboRJnw*m@3ZD^gUcS1 z8F*}lB!)^{9>*H_#SK2%oK&i3W2b%>sWlj6y@6C;NMddZ@{IG@e`_qMPMsiRPhnVA z_62OyqvLb(_MsIXK;>f!ENVYlCjr&0&8Wu?*n5gJlLY7ik$+wTw}MzfJX*#pob$Po z(E1-Z)l_AvHfh^-y3v&~0$y*8`^z-PPOB?%d1%v@FUz;qbkJT~G(4&{63uw7YyFqz z2+kd=+ec9&vk{}#PN9D8Y`H>aR^E8U6z{c@Y_OQk3VDDzsnHb(;wW-YpTV-&gw&tyR}jP*)P4^~CjJ&O?D*a504gH(Xp`7VG3ZNE?Qd#-CJmtGq}7wzPXCy+b5~5z z<-7G(-ooOIs*=AD8u;4t-@nI&q)f>1%(Aw}t8W-Tx=uS(}8=y%# zT|P&K05sI&?on2?Tu!wyFZVUn&Mua&F-&FT3-zSRsL336Wi^>PZdpQiO{i;o=*g@&$opSS1^V4uhzlGeX; zMCb}XNind$OKed&tA8@-GP0RE52@llced>vgaSf7Ah5l?s-5b`SWA{dJxkQx$!h6J zpzW8;xzV7wXwUPTMClh;m!SU;e|+T6$9*Oq!|U4aV^+)RBuYgMq7oT#ezQvtP{*;N zH!B|7weDVF<<|SSCl`R&(qBu`vd=2DhAV&4d8jOh$iJzhBK|`78o%vH!YMnGtZ3B7 z;wO*6QDv%1nY%K_!B4?oS+5gYS18-eb-?kg@?X8qD^JEU;LU8X%C>%5VMym)^dr)X z2r3tW=+{XV`6DzRCgG4nrye@{%+6Kqlb64!ii5k8p3#7d#Zp=J6!0nn!Vk~-d<5#)* z{d_0Mpx19IK8Qek^1W%Sil@iZ4)y*{;{{`r9w|)7wG(P!D>@!S0mp&^#5VM(1^Szn zk1|uozJpxxv_v-WvX#)$a1c6@dj;r5D0hJ{`CC^Y8-)pxzt;gF=L1(x=}h_1 zjj!E^_^w=d?Mda7<3D>rx~*t9&nsycZ7`PhJXL&rcr*TO#><3Ln$$>c?=DuS9*!W2 zmsWp>8B*VWleO$0_)Ij^%5ZFbPISVH%WVTYEpAFc#s@Oj!`w1y7KTnEd)rpyyl1O| zkj$X-Q3hHqQdSS2F4;DQWGuf46=#Y89_!@qJQ)KkWe0&IK*Iay$6vH(>IgEvAhcQ= zh^m45@@5+us_Abpy8+@K^JO;NC70Lb0l(YI-&}A7?ZO?*UEFZLLC)~1^dAU*Df|-) zZ?qS{Y}?U!_Eot1iaV_6%4AQsIwR>rcLxxsh#YFVu>64p5M0hPBjcWz?&`=*Tk5<;BXNJ8z+#ZrYJBzmRm$&CAsW9t)nypxIO+Rh( zw#%Cz41aHC3YeP$iEn+m*;f^#3Y(YTAFSw6!GDTt{)kmc&SW$FsSlpNNDnW*Q@zZyMJgp$Ji=7~T~L1h zvQR~JFx*o?$HtxDQ8J^bhUwNWCI3x)Q&Td78>}t)E2_dTJTN9MRM14G<>pI4{pqfo zM$_%}X8__-P-OiwL2D)q-1(ZN&h{`*=)xHHju?WHmI4v@^qI@`BFhSbFdpV2-0Vxb z3aw%CH4$qHVs%6{HK~~s8~Nuk#Oz};?o!Yv^(A?MLnUL$JeFkG+gPfN9R&5?EvC!@ zoKPFmhDxJJ0y97HA9eDAkwlty4L!|=Ip>$^ys8(=ZeUCn zpSt%ZgJ$r{Kzd-ch3m$eNyAO5gKrFE7F@a zKE`mQd?V;|ZK>%AF6_Lqy$8&H4kXJKt+X+698-q1!00v7NXq!V*u zqP{XL%I^Expixn}1f)Ae8bMG%QktQ=yPJ`cPHBY^B&54z=!|Td$7uirM|PW)yFEWy(?=Wa*ZF4FpUL`HsWd zA=$7w$D3Y6!a7;W*OtS#X*!iSuOWA)HSpeJ!plgME~uDl`h^91;_pNA&yzi%r7)54 zbxyCP*xGCDrJJUc5=)oKxBnR6?V`}XSHH#Hyn@ZVzN$i%sS-Hlplb)A3`2uksO(Ek z;~;l%eJ@k9K~)JEw6Ux-UuR}5%{~dL+Kb#B5|LY7ekHCwJ3(0p=Ci79|L{~wkcfU( zrtDZE>QKq54m=YoE1pGl@tJ)pa~$_?KzprbWOc(uI1lkY)uohQDLG>~>Jgmi(C0l> zH6DyVhQ2j&fIueW-V&4sb#6+2fL4F2DZ(re-Q7!(5-d*&sOWBj^+!>o5o1l`Z9m-8 z0BvIM$HMfEy6C(%3J7*#fBY`~AB{tz^vzl=(aMq3LsJBO5GL zB3Nqug8S5}6ndBy>QX5<{HRXMX4rZx2YrRYRvTG~k`f_lYZ zZK8b)wJpv)n_d}@>otQp8&=3T@^^}Qfs{vQ*!4QWT&YV0Q@XvA)spl(8b22RGWWB$ z&vx2gxo7R~CwSWLny~H6?ewm4r?J#ePXr=|*}Agl)9{O&m=sCJapMhGp}+YZqKK%0 zT3C=&A2=C{)f8U7_<)p#<%Um$2*r?#uB${Hkn1Q`Aul?TpoA1>2>1S{7~5ki^VAJi)5hv3i%L>%Jlxs>VW2wI$v(Hytal^eSt9o3-9L0coAoxAqdH1~Ti%{dp7) z?XOZm)U9=xH{yQW^fo4o;!_zlGA74;Klr)2A>skkOy#*7qd2T<8^y4o78mS_g;g9y zp(s%mz<_a7a#O`yPvP$hyEt~>>>5t*WJYp4@kgDXjOK7YEV{X%x1@&VLuwnbJhkOt z#%>Mk|I>0^y;Q;E)c@{c*oku(f#46Q;)-K>vE{r)DYIH3aFVM!JYvFpja|a}#k36a z^*BMZliZGWY~rVR+G6k0U(M9=TBm`ccPV3eFy6GsAw<)~U?N4XMlw^pfTvx+seGCj zQpgAd`fT1Yxj#6-&f|zB&=KK$V>OZ)mrt@9y)@(~VR6Wye)}-maF;f8W*E{=7nxkh zSv53rZ5)@z7U`Ap=r;ZSlMOfEBXxMbY+P&Bg(&u}E15ziK5S-J?Sx4jZ);8u?frg3 z^eUac8r)W{PombZ=c>$5wRtPKeQ8JGL(O9ze(_k;-lSmMoPpq~wkT2R#yRSB!`Ea2 z2M}~k+bV}0K7st@#)|GHAcKf1Vq4clmaS&%+OCm)_G#Q}%{w*Ha;7@y?Mt3=u>i#{ z`thg+LM(%+s=j^d?t9!*a|}HawBlJH)7F*mZ_%YT9e)1zEOodCV^>w*g~+Q^VX9t_ z&E!}h?cc2-$`ms21I-^Rdy@tm|3QE3p#pyNzNcNVTBGgnveQ^R^ z6aln+_FFoU$;cV?pFt{-@I=9)&jE!+WEWu_{{FD!qu|7^nFC-#O z=U6dDp1I*9WbWTu+bJvsWb#<8^qSgCd=oUD*unJkp53aH`mK|LtIl^wVVP-w@1ncK zOPNgm`rOvSy(^5~i`$8bws;zi&(D}QXIoO(vF=148NN!C(Y7ET*tl6Vg4Yu^$zz}P zK8c0ET%SyFR3#l&N^*u&8$G~`5PGbk689*Mo2x#Gxe;YKorjlidWcF-foIsbl~^b>_Oe)PCAYG(JLwHI@{+ow58^r=<3Ip;T0Y zPBWGDxel}g=8H|ljv^&BP4~z}jRUE)$4M3wV!M-Lu-_G*fG9-PP#xX4XUT6|WG6H( znP^}RwG} z`NRxW&37KO%S8-b##FX5l$YsiYi%X#axQa>K3VPriHW_gO}Z)%@FBd>uP(9zV9iXi zO+0;)9<*66=LMn9(ORSW7G9EV7TECQwe3FMrxrj~@7;27oG=O@1v($vIV^^9AT!%^ zf^w%t^{<5=Q@)slNd(QIx8-vtm*hXQkj7_vCUOllb^MPx6hEmdTI-wth;Ov|exH~i z3OnQW0#nNy6~RprHLLq#hmz7k&n zhhAgJ(^ZkbB>e<}L@e9%LEFH79G=K-X5WbIt_fm^_@!>86Wm zliPAbldtBp54OwgCvPH%tbs^A4VGiWx;Y<)aFJ z_tV;`b10GPg{HTVR?DjkY(32`B$r7DhZO^EiC`6TMQoz|t8-$|L_=U`FBnZTZH5w{ zF#qo?7Y!G%G?WEoa_scW{z><)Yn=CgC56&^S-cK3=L~3+aIhBH`G&8|&iHxhiM|?t zw5du|5iRHIiCkq-P3hl{Ody43u#v;QWwpw1?0z;c=O;nFa@s_RQEZTi8!b+|P7(e( zt@nR-)HincT+h!s4D$TG9|8m4gS|GoKY##f;?Jc@Nma>_nHBAgznaZwpGgLF-|dYO zIe2t(Git()4Rf*v*di#j+}HQjf{mLKi7lkb{CrW_+STS!eHkRqK5Bu7DODN(QHhHS zedQ7dllzXn2(?!P-7;@RyFDk^zT2q1wBnDp)pXtjKg%W*N9vNV=fwdi-oq1`R~7oNX|V)^xyrlK0lZE>)BEb zV^WFK7*%jNydEny958mmhb^$!Bf5FhLuO;q6>pcL4x(D{Upj{n-uy{#m^={d@?ps$_7#z&b2VEyMT&{3xEY!?v z!P=OYx>L8ewO3yZu(1R>4OeR_*kMAK2Avl&hrr1xduF`KSrINtPO}8Bfu^}Z`r!HM zZAs#}q5n7Obd(tL;UiEvSnyr$P-WvUuDW*qY*y?_?E*%G?@UCO+aB|m$KiC6aw*V$ zCC@W>MzcbYZMOG&K;S|vb#!cFnZ$FN!<&J-oFN$R2t?IzNAJP9>dst=eEL?R5WLH~ zE_{1U!jU=iG|@Jqwz_Ym-3r59N%d=wH!cbo<~mW>SyR&PFcdfI4?#^X`mVteKHUE7 z%BA&Y^PDzA8&@P8x#`>ikA5!Q#ucK*_+9@$?r2ROzgZ}`RY#eAf}9?gUhpi9eIlYn zxO$@;0@IZ1Z1ZyaA`)4py`l%s)Hj|Ox^|$n;ACMv4Q&PVEEkJ<2@qTJb$uDI-<;S` zeJ{SmNa#}P@X*H1;m?-D1~X@o0N;CjvSpz*JFGCyY<+{NhaGwQVw@Y z8N=)-5o-7rEGRilgFcgrC5DW!_2q`4Z`FXsU0p9`sM{O$Wm&TlcA&xE z0pql>q4iBaTf`4d&-IU5B~I0gNvc4QUPU7N%e2tvmpW%*0%Z&WoanYYTTaIp*WK6U z8{4)`Y43-q4k;{r>1$>kr{2nu(ZiY$+aVafU6# zBqO#gjmW&7X!gDu*Sm84nn$Q95qXWJ+B@=|>l#wr1k$VKgi0Hw7mzmNn8On-^42$- zl@h0b!z!BakI7qH*q zk(PBO0n-)V-suLR0~d&`$l(E}>(bRQyWB>T0X{<+`)(t?U@9i0@MgA?mdG!Qo7pkV zL2txYBL`m56)!)C*YfP!AOilO$wt+a>vJ;@0Z~!Lu*9s^H;MMP&_2oJ_bfO^j=Xl@ zKG;`&cXb#3#nsTB-PW;_soXF|=Ec>9e6y12P2+mv0aWOF=M~%TT8jH+#a||d0~I7o z`CQts>1>;ldawqz10hU<-FabP*Fi6eOU(a?;i_wI!qVG2@wj8afb4I_t>?^zkk{fh z!`>jD(vyWkM?l!TtFZ+$>3o&Ka9Q&}r#Zq?a~Q-ue{Pti+i`0s^I!Y?Uk)E1M@uF=VW-vwnn15sAaaj9Cz=9{*;vI>5-g)52>$1>$K>EVv?P-k6JGFW&KJif4W+DZ1tOm~{y zN7-aUY8TJ-n;bb{&u}iabjx+h5^crt?V=YD{_$T*9B(Im|5(iLk>Am;OQc}KrNEKO zX)^Vrx0fy2Z>G>^YaX#TKkL8x%2)nKl|wz?0anF?+%h;a$Y)ZLKHkd{^ zc$>3^JL6crL2p>Pw3IVe($;*Y-;;EA6JM31{f}G%nTwhMFx7bR1W;Q8<9D*Z`yp<~ zg))m4;3ChV;vVXI@JSLN(fnWl_TSHNX!%G_W%UwPP>kT6_sq177|yw{X3wihS6yJt zrr&*mtI7RMk}gL1;?}VatP5(c?ivv%0Z=V{Oaoyf}8<{km zjh8F6>~mJw34jhYD}=N}%Go*=>P1%b3cq4M!1~mt4O!f?@SvwXM09@C-I&G(qD-UH z3}Ro@xoJtbq5MymeWK&?&(EIhy4vq9LPh0QoaeT7^_;!2x9jtUAbx(#^O)(!Vn3ei zzQH^?Gm~{X|M0_wtErMVRHV+0wrh}%aIkidJ8qk`W;?(zQgUqOoqog>wNk&0_Pa=U zGCq#%E~Z3|zdSVey8OFA3>~=g?hEFuuqw{@yv-e4PM2HJ@Kasc z2!12*Xz4Od99f;%3*=tovB+efLu3CJglQf|3}XnA{OCJ?9e`|Z->Y=$3xk!YH%+67 zj^bVJc7%-v;+;HJf`?r$GFHsS7`Zxrt6k$WdaYYH{9ib5?@kp5tKk4tX!a*XdkW%3iMN3FF8+UHPf!P|vtBfN`*U-ys;47eW0KpS zX5KS4uEn7}R!O1*hrJg}ITL*&pG+g7l@(Y#7)x!6Ugv^m9b?3%iG8t>*fO~GQCB3s zR!&W`IQx;-<=u>rm<6+K#MSDr3oQT!vOb0yZ*#dINTb9@BL7TmLnQ6?Y&t3U-PR$V znXV(5OXvD2o{`pKA;b5EACzU4!g({#^5#6d{{6f z%>Q5c(#?0K(nyY1YAZuAY1}(HzU#wtMxF-P#k*Y<#4SG$LQotbD25?+WAaU$vvS=ABpN|C|d&jQ{T>3dmYM}!nI1*YAS0&&c#V@w1tih#nd(*q~w7g{-nwZ;N71Y znr_IXcC6eu8*Sw7l3ST`+w(j}Pe{hUQD}6oyZF-j1jb~5z5)==;5}g9(nF`-4a1nK zA$9)`+FPkrYj{DyA;hxE95m6FBU8pM5(xy;G&HeqO7OG2d-5`4o zp%dHXCWzE&Bn1d5c_Yx*ly?3Fx>``OikYAW8s8H8nDXP9yf~Ob z=MqCMdTjWqAKZ@l&z<-{fN&@+s+AR9FT==^LPqGugLmxLeq)MmM4DTiMX*Eq<+{XR zhG|}K;lKCdhr^Yd>e^_MPqPDmhJ2(B`K+K#XH{BumTjeTMq@9`7VjC64Er;l?AR-b zuGnVDe(iSi+LXup7o1chAO6-r$OhE)C(2-|8`?ndFtWzs_nKJ_&p4*!AEn&#MlX@q|-18cS*=3Ee8?C>jlmlBV&QJKnBg$ zQEY`c_?T05-PSow^=$BL$E;zT0BG=xMq0-Cy zDGR~WNy|IyyrjB22BHL1OCOEgb#Xi!9fCzGhX=89^z6|^_O*+MJ{F`Ah0&Kz-_^6T zsdK~r4MOjaUIw_-;6VlXLc09BP@G_2h+49u^*0!YcFEqb@l+7MUTqGpe&fH~?Q%^- z>Jrkn1X)mySj2g}v756g>H)V^fEAPjt95Mzb(cTNPpGk~uv|uQqJc?X&KeBdf#Q(o z#JI_|K)>JCd)?L%@FzV~A1e8tTWhl)dS?6=ljSGGrwF95+^r*pOfH~j>Pw9pu1oG zCOBMCk$7sqD5zq=@XvxqN;{Dr^%7%k18XIHJ6s{O7|px3^yx^U>@br#YwmZAuWTy) zY>|OI8r!iwvrso%Rib5=5! zG-dCY>BfA0Fg2h>WA0s9U_;f$H+v?w1@U93Sm!e4Kx!1pKQNZ$6h+amjdhEqZi^O1i#zx2;0-j@RG&*Z6!BTu!s(7yYvfx!U#(tfy(856d);iBA?5 zVpC*CwemZys5bSIio9D*h^dn6n=4j0*cy?FB%L-x;0jMP2ykwEB+N@Vyex4~f|dbU zpR@x!vNkKbT5q#2o2-xZTFe(!w^U~YqL^#jUe>6vH6o&*#|wXepx}POI^g#F3mGwK zz6=t7C_C#OIHuS&TC#Rr6&2k(!3^h_xoEA|mmDI>v<^wRP2?r^8D-h@^>Xy$Y;C*B zPa}9@GW%yvRgbZ&@!Jd>j#|%nxL25@BEb;_U?TW%z0J6J1zPxDkO%bz^!7Q;DyHrH z;vc1l<71Ig%WBzS$6hf*T7{MD&%x1<(Mu`iB1!aST)mWD2|EI#EhbG52Hjk!4ue*^ z!}xGHs2bQZc&cgynN_nd2V#>^JE^lCHTebLPFAh;cN{+xSG35x3e28lDZ3m(rIWv~S2o74`0Kc!T`?$H?Ft(=;c`jW|&YRlJjV!K7nV?|C!hBZiWM^sm5f zM#BvEA-X%+ZLfa5rt*x4v5U-RV_JIq!)d)mQ?Ih*sXU{0fb5mytiD^z+5I^xe7s!* zw;kE8UU%J(UR=M}oL(dCy`Z#?GL2PxF(l%uBvi9@VXhC-&(<(hyaMmGIW{*8)ynvv zohhTVVopr6PnruMMC5?Ci9{RmhVk@bLVYoCe*5W@-#@d9=_?&!;d z8f6+plxTn@ktOknZrYdO?HTJ6eBNOTZojZR^1gf2#E{Z;+~Wt+_BGmBMS;P%OG?UE zIXF5B!}uIKB=VXr=#P6$vK|}j5hvrWy?v4DTO>ot?kJ0r8CA5Xp7N%r@j1&C!P-=D zBVF{vHwY^RPe^*-@&;4dnwOh>EY63cY%@-E4E6(mqW)d2L-95Q?p!CHSOW#5A>et6 z=T?4=*v4}G^j{&l`+9%$rPxGDHGSaAPttbidtY)CJN8l+_)S2GQp+vR#l`+xKSc>J zqKIqO-AP9KWNzMQZaLZLX=o~7>r|cA06YyGR|WgXUXxJ?3m^HSRbj1nr`H5<R)3 zs6@K0c2NDY(Du3FOEtv$M=UB`;xe)A~ zrtIIB06xhynnyRnb;uTGdRj`YWUxsykAL;=NDIsxE+kw~vtjm}F?>a(8l)rjdCU_LZOS#RWtI z@7tR3Aie{_Zf2$XrC{r;S1P|YO|KQq5fJJTk!|0<40)1e*&)bNJuOhxvZv3>RF0GO zQ@tv*<&piO8n8vQyX+<;x>YmgT3pn4vmER}h<74F(L`x0W-aaJ07as8RNpMU6uWAD z|F@y|H5B?AQ(nZyeHmD-tR&dN;P!l`f8hcfR zSj5tMw%H3vUP2B&8sJ_Uc6YK_Jg~i}O=eS*8{dvE0X_9CHiUURbi;$(=fgh|9CUDI zy;(Hgp|-Os$fe?qE+Jv3AEVM_n;8E5{GcbgWU^a~lSRGyiSusr3D!{P`%9n@A{)iR z@;zy$Hb{B9zR}_pVS+g0;;#S|BkQPb9RutQNmg&?tti%yLS%zmupR?vv~W?)3(@U> za@Lm66D=ErmM+p2WlnH}hj*XC&HnA9@pl`bljEowWiWJohq;Sde|V=aJE&xiI29I& z_Vh=1!}pw4bMJt-*sJv$Xf5Vg7FCfP!gbG7fBoF?;uzR#7hJg%=UVIVNA2Gd%Xji1 zTDhP!mEHH2O4pmq0D_(By<6Gny?EcL{Xr)YuB+4zF4Zv*FkB3R5$4D+_~XO?dBb2L z%$@QJcmcjq=z|CcHEw1<`Uu7j*c%(YVqp?f%^PIW5SEpxH*#M zV%BTPBdnQ#?z!cYzd;Opj~jR3ONH@s)}Qg;ZXEkrOq$ltWwFTqU2PiUQ-P{yo$6HG z)$=Q!@);aU&81IYlWFox@LZXh8$Zci7}KhPGfac|qH%|JVLzB+e}mm53vF>Nf{osq z>x3QymVNi<%TIR;YLQR#bZgJTeFJ`Ts9(aegoVPJsTbld9bhT*00)~YfbxE5xLJSd zHQ9J#b|`KQ4}V?GIKT4ZU(81E>PoO_@a8!^5n*R0&y}$seiW=L)$`=ciwffB#YMFM zE-Sl-l4`8B7UHJj;zxz)5vkv}yTf-U&c!LASCwLKkwY8rN;5(Gmk@rf;dVHQ{8v3-? z;TM0flE~|f2G{v<3CyOSvxj;#2*u5i*a7oiw}BTe9%m~fP7F}X^$B+hvkWi=@izOM zy>h(PcUrgnsCssj1QouZqQ5Yy1E?H4`5Q{#a)$WWI&n=s_3KGg?At{s`v4dYbDoQ` z&Oa0%r7>eY0E||d#bEss(TZEelfZf(6@}~F1{2t+pCPn}?}UgFV4O#WhOQ#;s6Rkm z)fY9Ddl|LMUa^Y~I^LEQ(PFIaQZ0uu#oo-h1ND0N#ZOZ?tt5@^%x0mE_S-3sHzS8K zDWTpQx6~1-ma$ANEwDHWV&f@30DVk%@IO8{Bt7_jB>WPJsqoJyMJ^`Vjr{r?i~_2s zg)0xGIX}JoQKDyfly&>g6Md9|Tifpw@lh!DpK#pBXM&Ihy3&4{0NeY)@^i1ZU8G5b z$I8iaYL8VpO1E~G)XM13Ynl6;R_k84S%78;dtEpf8GVuJ1gsGkB!9ptQfdH5Ubcic z2(s7QVlM<5FrifJn^~E~XJhpS(Ol2~UgXUXSGR~^%`;qG-kwEhFhRgh>wXc~%8!!m z+DoGp{3--K75BQ+X{D?L2$l-xs|DhOQxU_aGTb|c(8;?Se(BN*q&dYOO&YshVF+RZ zRmaH$dWnB8SI4JgiCuoNh$J%NMn+hAAh$D}cjKt$!!GGIQF%>m^!)t~;Yxpl?;Y$1 zWpRnsCI;i3Y3D&QeL(L103|S#1~fEf^FF_XXd2`_=xR{a;?))&lIzShPWZd75Ao+i z`;EW8Cuq_y)V2v8{3lLtzi+u@pWOA9rbeA>v)&NY2jOMP;+Hutu1n#wyEK%Yhsi8n zCsR=!5PS=I4 zkONJoMON2=VgNBk=e~-HD_xtTD-*w`x#$q68fh;=dDB=5QrH0 zPl|bMdsUq%89=yrt~GljvBYu}+Ufd4>x3>@v`n0*)VpHc$T zB<~8GPE+{Z%zxvY<`(CNOG)vdSLub;rFH6@+$1L!hGV1W;^TZz1{!(0NHfEu3cG5q z0b2@^jr^JAh>N_?jaE~1)b{T4h1PBOm@51ImP$OCU(NZEt^%0=z~rT6=KcBL0yt+V{Vh@geBv_5blQSQwfsUy=>vk_ zqNQJrLQ{!SJ~E3$fr!zUd%S^6gr&Y@`N}=|F_@? z5`29)E9!WjYuD~VbI;3@{zpGe;iYz?OtPb=_U9SASW&J=B*r($5c0=?%9~bc6A>gj z1iXfE%Kc9*FrsEw`bu(Rt{OeW>B<|`>vBzAUkWz8c*-%<;3=f57)&MR*!@~LQT35} zGhW%zQuD=Pq!jVZX!7Ij-KaDzU7d+#bux(d@bePT!d;GonN%C(ysiM$y@%uVIJOw) z0_x=PH;RaJfqd8J{$|K0z!jss%_-pAdr=5cU&qmV-&R}j3txykt8W6y!)`yO4>j;E-*@OJFZmJ0fvYnypCo;{7eaB1kZ&FnzTzdc z#}recxd%X5n}?$agX#bWsbffAjLaXU$M0Qo@e026cAYDVK^>)fgT~m|9fsC44tI_3 zb3EJx3U~w^Hq+IDZ!gN!yzaKXzHNJZyHD?jAB#DL+}>5%$V}xdUqzl$hu&Oa3V5Qd z6tCCQFE@GYGtf=BpH96$`=r1TRX7!4>2I|klC_f&ZpAq2vIG6RSU3q!RhL24^#77Y zAglyn`P&Cfj0p=4(Uc5ceyqUr!$&-_d3?UT>VJd+x!OllJ0 z)t{8P{#dZ8Cq;xyw$DVXW`C$#SKZMmYQGn)=&x$s{kgi8pyism8Etv~Bl}+C80Pia z?lVaPeQ>Z%KiJQSU0oSH+X&S#LS4MW_E&|d$}qvRHnTWF}CXV81+X(?(#&CI&*fty4=?&guu7bWFH}4 zWfRr?YyBHfbDQTG<&n<`fKwF<^0eD;$5@Z!2rp`=)QuNq_oFuBtl=XN_E-84$ey%D zGzMmT!#@v;E9Q*b9tE2Pq0|9byiZUJ-4lW?tG^||J@ImZ5G1P?@O_%}fjrH}9N-aA z2rWN*(gae7H<5jA-^0r4!7G9vEH$5rS3>Y_by0RJ+2j3~J$DY8!~l9eyiCM${iM`B zO{@FDrYM*-^>9P&2x&3CX2RnXL?QbTrPv8&o5k;JSIf-=BD=jiJiT1 zA-l=|^QiC*M?G>Ro5mVmoQuG{>3~3}JPt)D57Rmey;44sa9DNuavDYwCPHqA4tLi1 zC`gzYr9>;bHsl~=ffP6PGqKutCcJ796I!2bm>=VJ`zH~))O#9ysy5Jwj2H~%f%X`27yN2Qj| z-wK-Lb5C$!Y7io#TcO`4ly7Gt>#Iqv3Hf@GXkqY)uG}xZx%!!>qeBmzQPbn)*1nRi zVTo8Ix<02s@3h%gIfk)D5!^aqU}Q|#G6npz*?{Gu@BO!QDNa-EDIGv1>ScZnn7HA$ z#&6`!bu4{K9^8Lcduh4N+gSDjy1#+mFRgH{y>&`5`aD&9HW`FWt^w!}rljZCs=Y~f z{0GQVT@rM66|C~bhDXaIWbdz&0j?w7VfW^eU8E!Jt~w&D-pxqSSI!X_yh7Q0vBrMI zS%B8qsG3goETbOOQT+q-Ty>#tX(HAxN`RpT_jsu1JWmd9fydHcM%(^sy&6gD5W6yL z|4U{=_)u`vM9-9hz80l)zRs_+%m~U4&~ziBc2(qcCDh{89w-U2$^RJKlE|Z$doh)4 z-e4(DLA=9AeOW|KtldL6=|VJYLm-_uNd3m|Wd=domEm*PA}>1+XHv^bM_Xmp!-g4o z@?7c%WZU~68FhDamsYI)kJL74Q6@wsd#9+)e^-5U`2@qC_2v?|pdjADB*g8S*ZdXU zW`K=FpA{l`4jG51NP5AB7y*CF8m06Ru40%0_iDd1s4U^7S=qo+)qZic0DLclR12Og zO$N@qww`*&*);Gg7WJaU#JS-Yqxg4_BoQEejuqlm_MgNIt@9bH3jfiRA;$9=NnVfH zhEDS1VL(~?L2N!E+Gx&+WLxIptlQg-B*2o14oV!Z>1lH7{;tQvqk_*~-k`90((>tZ zN;A6mjGbb7ke1%?g`VFa!-xFHU+m{LQio8Ti!s{)`g&?=aly$rY=aDV^XM}env&i^ z#Y@`J3Ab5rB~_8mZ-qLf)S2_84r2=2<0JWwi)+TSH15M9hMDnC=xDzrK|R_rM2Xp; zduq}j;js5p3p$P46*;`Adu@!aYtN&%4_kn~-#zkXot&e7t1%ZO#b9h>@pKRzGdJM=#MDxXv- zgC4HEF4IrO+)wA2&sB;f3<~FthOz29_}K?5trsc?W4uC=3|q+ll69Zi=GZUOp}gyn}wS%~&rhwFj-Fyy$zpz1^$E zD^^S#p)r6OYrJJSF!?O@z{PR@uJ{7(!d)3%Y#)XdlfyQ`Yl3PP_(qrn8 zq~zSgb#b*?tVFmlgHJW7x$(FXdbT0ss#xzehb)p$U(sp+)ZtHyGJZpu`8Q789%NlcT*Pe&iCz9RK6~cm=x|3MrMNs zP|nav$wDW|+yK%3<$skozjhWDR`{~UdRY51I`ixDJsm6V13Ak=>Gz6YTF5xip{QV@ zMAm2e^~r8d9J%~?BH<_~^|_)oc3j=?AUzC|EHGTcTloEpcw&+;mW$inaFDF0y+co; z1>1z2@mpft?<2IJW169!69J728DLiT7yJAUe7nj<3x)qQu#Jlx&mw+Q}c&GU;7^O-?^l>W6BqyW3Y;? zbk$KHJYT+$X6HJKnxzogXNU4D+@E4o<-pZ`ajfXR2*@Mamfe~D^=^I$FfVfw_UOEg z+dHBkdg4PH(GM@^*<*7=UiR}E++nDsb4FQ!8M!1MlB9I>&6B5J9&f$>Q`~2w_UAMV zbwwnf=NPLh{;|pS8&h||9Z+$bmhxMI6{%vGC)i)!uKtj#FH$DfK``~STzq7e(Ut*%gp0lZ zUS#WH4cy2t{;055S*)3X%Kf!LOdOSKlmNB*jX4NI6tMC-pkD#cC+5uEcYbHmzfs6< z8X-fAZO;&Dj64t@&0)B%e!B>4%s$JQOp$l(pwAD!@&ja*5<(IDkmj&P_yVK3Ahu=R-gdo2OrUdMx>UUf!w(wBqwt9w$-J647 zsV=}x;9`RoECDu54Q5RTx?4G7Xyi}gr2cP~{_OTF;H;9427^sl=%Qoy4<%Lz`KPDm zZxkZqHxXRiw0~5muYx3SGxdvQTauZSH3Llwq{q^i;X_eE=Ao48B`7m4VBlrqFGsU1K=~qQmMIJ_fey03ot9PD?+7@t>1@ z;IbS2E8bBJ0ST(v=8;G_IaazBjzxbHCA zr3>#hY|9nO-&HgZd9W$4cQ}){CCw$;RrW2B$sSMCFaw`f@}n{~>`GjZJx>2X1Cx@y zF7acdRDF;Jy2rbp6tm`{PM6MLt~NaO@~_PTzFRX}10CtuK6)&VRgZVsG?49in3dOB z>!B!VEf?vy@UYxO8tv9KQJ>sFA#m7#3M;(lCEyoFNu;!l9kwh3iG{5_l18~M~^SKMNF^`~7eYQSoIH#^-m z#uEHiVup<;0LSl$J{dhw+0=@ZMAGx|NFr3tpEkE1W6F=J6OWdYW{_2HggLe3>``Q@ z;-__$Q!dYmr+E0XPF`X`n#l)k{<(EhL?&3 zau=&DJ}&|SY_JGCK!9^9R;lt=MCC7MzZUfWAmu7l_)if zh+3HVUx7$*#J+RI-%vwRv>%wS4fg@Dh=zQ$sPgV0mBE~~TP=xu!|my2+wC5|Ndq#j z#)A(#a8Hy$1}fDMwtZE5ENiQC&%OF;p_=kime84F-DLkABDFkIcMbuaycQR?T+bRQ zz3nFm78J2*Hh-n8k+__2yb95?>j{nLEx%|KuJ|*?I{(HUS?&GVBvlCDskqn`uhk+o z{ml;~ym;vCr=li)t7B9;F>b=c)x?;-F1=-af$|6Ru?+r7^p}S}XSS%h{jGw#SCYiE zcejbW?l{|A)YAB^0nftt#{S=YDdL7Iy4NT9&4Uu{GIs)+IJy(Jpl&J@VqP%(Tom=TS%Tew|Hn|rWVsk*qCpFMJE2^u^?x%N z=$oFyA${;|{}}S74IzSa0v)296R|OipPI+Vah?s(}q$Y8d3ehLBG!sx_$)l z4;vt5)?WIl%CLc7&Y+18pvAt1+&d>IleeBf7U~FMaE7xzEeK;eo1mt`{mgUa?Osjw z3HNi`6-P;0PmN^^8kwh9i?caNN{!`V6YwP;G3IE3>do1jTv9B|hhFNqOZNgHFxr~w z$$2tG~Y+18CsL!k>?&wgL(_kjdYHy6B!oxhlWLm9+8n!4*X zlAOL?T~6$w5a6&2M~bIkL%I7<*I(1kEKR9DV&ui%CYT$qySv+Em4c_XL1@*fc3t5d zZW*9Y&&VM35~W+}e0QMKIT#+VEXbeypo*C#q+{9pMwaxHxxtjuyQ3nPMLImaL}!c6 zV2zRr{V8uyYvfMBR-~MK@83v_DSN@l^0kMsABCLKQvfMkUFR^{ z2o0JFpJ&%mX&`aI`~=YUAk^F71*Fx3td7%8V)_Vu!f2^zAXrd%?5CV|gS)?gnEx`4 z+x8@{CJ@0$eqrqY{0GHcnKVLoR72beW`fd!>m)M}Xz^TSyu1~4iM@1@Eup6B3q(dF zE`m31i3E_z%utj$i0=`a(u+7>V)eiu=@S;}9z2Yk#8G_uyaA_vOn3eFT$f9h6nPJ4 zi_5ywDU~<2-V#LWrXRzX$9Su3nvH%n)+JouI7|G*)3sJih|3zutI)K8U0KBPtcLqx zmB%{pc=(FIvi}L2wIUNG9b>GT$^*tyd~PC%Ak_O>jHX`s+A{qO>+OmHep=1iu3od| z(J8{~Q>55QOnP0_W|`Q z_te`-0KICPvJyY>jY6NtW{A)zgyZT=Htb$V-Ns)wSs7Hz(1I{bZST5;Qsspp%N02U zkk&TLdi$SY(LEM*NP@`}Yi&WH$h0u^ScX!vrAAZij42j~oALQw)B4-Jm=d3OKfc3X zT1)IsmER#(F+0wyzxyhojxF66R}TFkFE_&!mm1JOdZ^O#FM>DX`-vbQI4v24;_Le8 z60(#xP)YT|LZ<1h#GKaF-Kx9>)aq2%6);c(Vo2&732>~i8t)HF@WirVWGXKYE#0_s?2ql{( znD_3*3l|naihPP-{v}c=Bc`x-FsEnEbGs5H9QiMe0y~~=z6v!+)H)PaC1UeaE2UAY zf1<;7A&)PQFA;(9^}-kGk1b!~3wEkGIts}b<^Mg z#A}(lyQbd0`E>_S(l_rzufWEhFQ}V+Sa$d=Hyp=6H308&=%|S_f;VLxNLSnK#6Lv4 zzKYTEhO@Dw&RxjjFI(?z%aUkONKbTSd`}$s6&uv*s@8JK!LF7qwNAhefDB(rUH?VZ z!e4x){QOkCGp6AcilWwCpWgR&$D4{xXw1OkQdj&p%f6su5@Jnj4I&`=n0>`Gq$2d+ z5t|_W-7x$|HrXV&w-YN+!>q$m$11&C)gx)<_2C+?Zk!=LtI*wL_@$k-v&kh*l)4(u z?V8jGXf+{2T_MedsAB&`r@;xrRu*}To8jEI9hLBw-KFL_@J~-y2hw@zP{(8*1%DdQ zFpdo^$kl~k;9)$~RJ$4@Vq?3?v*0m(re**X3s-rqHEnaw=lK4svI6R($J%iMxW?Ay za3qW)wtKrTWJ@Hs%NgS3$$`jzun&FQJrzNU7QrB>FK7?BaEqBA=U?PkBt=G;Dq!ur zGX(VxV54ft##|(>B7LpBP8fGKWXxX;a>YeA59^fcXw2&k~R(W1=V*0027o^=XqUqWD8am3OI1 zz6!^_&e{|C*~rCe;uYV4Cw@mod4Jm~X4u%Ofxhk*e2AUv0ocJ+xWWpUZ;;g>_7il2VdED-fzcW^JoO}A0eq`98CJF!4r zXO}$i`jp`Ks2~`0WD(YSv~9nQ$fvNt;iw!&#dQre)un=MTLQZ!!I64HXX3d zeHqq@)(o7c)#G|7nq2@|L zC8wk7RXwE+3YGH<0242=^!W2;@TeC`)_`ZKKKwk$?>g=THfSl4B2%WMboWW!2^nP? zKbQ`f+*xMB`1buCv;hhP;F))j-evl{w=>UD^gozOJouZrZz@a%HG){ra?$IbMN?=) zDHcZ)?#T{)8nvkW#T=Lw-#pGgu3~H6>)cpxB@vc$v)u1>?IFxH!O@&y8p0#JnK#8-Ij$@gbKT0%)7qjhR-+pZR53QtT(WnmO`D`;h0vG`uQxQ5R9=b zOpk>zI;7@Skb~UiD>$zLAgwoFQ;!4>KS7I5+JuH%JrkuTnfnsn@sguc%JTOP;m_V4 z2kRRJ*0e-NNqijK1)iRf=*S^fzfgp67&Cvddr3=!|i*RZs`u` z9J-MhQc}7>VrT*Bk{CLbl5P}5q`MiqOAwH5P`Y!Nd4_Y&@Be&&`^A05UTg1b?Y+32 z(s(3>XB=OXoc8A`+?Fk{>(3c&mYj6m-W=b2Rx9C>K$>2}*3ic7N z=N`~3M9Cs*-fCt1W1OmHJG5u|0w={t7`9*pqZtCE?7CY1ZHjABM&TdA)0>RyrQ@5K z({5_z!{v?dGk*7Ev+-$U57Ctw7pD}B^!)E3RuN*XOIEUCeIYFe?UCFy&xkx9(=!@q zB`R2ZU&pp+l2U=``3RLl*G+e7#kU_}ANC?TS-V*m z&=12rStBxWU-S`PUeBA_%W;Ku_mytYP#CVj_z*wL0>9ElT?32&HVdO|ee^Xd_9U#w z%Wqex+F#7vt&88gQ74EA{QQ%LT}@GTSeTfCE>5!fp$cp_@9}&SD{%juT~DAx)Wmx0 z$`>|2lgHjUppO zO<+Byq(2XoVvJsRp<2$5ztF%^o#nt=zu&=c75GW{eZ)fIf+N%~3>r8n0bP#mPvt$4 zuLfI%u+^yQjXtn{6jA1N*qw)HpuA8s^-INNeE#*q6Jc+WnyxYVZ&B|t5OT|!l-z$Z z&jh1#7cbA+!wyKgPh{E@Ww>^GL(-+pDXgVZ%T$wI$RA>L`7~t-L~7PD#097Xm^8l1 zS1PXv&-Qz&GZ_>uhhp|-8T*}tcHxMb7!NtHpR=mNLO4e?{kiJ;x!8d9Y4Xu`IvMmO z0TD~<9hgPj#K-592zylmo?3ZgbyHBbOP=zL;-7m1YJZPCyq#C7bpbv+n8{91!V2!oiH6TO}nLF#vB2E22zYjXvSfJdv zQ<5BR{u?F+Si)F}h!1YV8>@<{jUFX$d#MjS@6O&V!Im+_R{|HBV*7~=U6^cStl5wy zAjI8|^wKZ*#(zIurifVPo4a%e(!U}b=n{;bN&AEpx5&@{mPbf^R5Nhz=w(vJW^;)g1vA=>W4j_1UcgSsI z&re~_;`j0osErMR)+3NR07AJh8JR_QMSVpSNbvpCIQM;+hF#d~yr{-MoTc6EWj}qy zkRGmYWJOZwKcys$HRa3#>*|_!2v)JzLx%8w7_= z)i-9Rdw1c3lpexV!ymnTcn9FYMyrp=t*oec0USJbm6$tJmU=X89(lh_8eSJ)??bu=ns zN;iAeULT<_t4PkS8ku~SU1);*?#UJ@__BkMOdS)X*9cYtMV&-`MkP~#`>{3a<4&iI z)C}K$l(<~iwxqn|Vyi~nP6%{;-JHGmy4P1utWM3o0z9}E-w7*YI3IYlJb4(yt2T}y zWJX1p9LO45)@;&*ep+1&YI-+4p+YX+bsYH5kPz!_{Mx8|Y~K?<80t_R6LB4yn7+rv zD95l}Ea@wqf&==(Ff1+;cI};HPSlrwor2^2P2NB>TEiqE?!6Jmf*Nc(|LoY$MK8m+ z3D+bC=5HH9b^^9FH32PN2$hD6|AX7jL{>UH2J*=0UhPk;z=|a|QT^Ov%EHv7`~(c8 zqO~zW_#+{NgB>5H=*%{AYNSU0TONE@ceiK(r#lar+A`&g z0>;lcvi6`yc6US1fLh@w{SFE51ViRJ-<$70U{cVo<`vfMQGM0dt`aOu5b3;{k{+en z=DI;?R#YeFAw zR$Tps(`Y4zQWq_K!0NI+Q$f8#S*vgSr~6@&O+%Qv3-(pl@{*1I-7|3{qY^(Z^& z*w?bgQfUDqiw3)%GleS>+sg2;v9|uFj)L)5N3x5)2<+fRTxGc;_JuLjEl{YHfcQD8 zN(+K0Q8jr_M1G;vfV?TE_HPz)Sa5Bd*uN(>m1l&+kYVWm%f6Fe9_4Z)&RMxt8o8*>kn0{SBVFKq>0-}mIP|_;SN%b@F5&~zeb3qwdgK| z;bLyQtL$1>*$b)$Sb(9%t>>RNOCQ6P292J#Q4Y-zuDP+iPD&(B!P9#b zF~_*k9`f-O+H=L|gPw8rL(T$|8Uww22fI1T4xVocKQ{8_iQ^+FcgbHBADf1yHg#2# zD6Z;`I+ONMuF&I*b+U`*Vx-4Wi0e;+wKg!$13+V_L>0I0BVnpBft2S`Y+Mux74>W5 z@NBsmy$|=Vo4_gOqaP~ZZUi=<)mE}5HDYx~^;V|K6hD~Fcs|!>ls=b;Q<05v=p zp>y%R@xvP*Z%$Owzw2HrzMi5`5S;ol#%B90!N-bxp^L)@4+vc{K6>pZz~qRu4zsuV z+N|w>zzfQ`HKM3u4GnvSor)Oy%q^6CfgF=U@m(9;p2vPZ!8j4?J<23lPBkuNb>-C8 z4%hQ=zk5l8kR09l7aRb%(IjurcIn>qB>{#$V4K z``ZICx#j1;HNna)&#lpaI8Qa3ND%5-J`k-ZW!>>zY=2W1ybVZ{pA7_a0M;B)j1261IztbHkgTAE3HJf%e*{W;6X=#xI;E_&W; z@t}_q|E3}smQPb9p8c6{3Y~wu}<0= zvUabu!=qqa(F|P|hv2#0uk-b|$%HU5Rpb2Te}KP3I$O-#-{dKj#y}XrUjACI90niS zS}KCBjmBOWse+;wv8BZX%F5U_MAaW1h>$wx;R?iuYm#h@lGZVV?JqQycE~=#C-~sA z`!vq&u(%n`a@WfLXwLpn*7N{EE${JT&2f1%j-#x|{%CXDN|vEMvoqH}S7ryuZQM_D zRVbhgzB~$_@l!9X2BF)v;swjlp(G?6kw00 zFdNK!1$%^d383CedlOIc&6%Ylj?>MXgYFYnl?sQc$`*yMFVF)!mmnYI*Ts7djcZyY$`DB(Zta?lp#v#el-Y?dxWo@EyP-o67N z70R?OA+FvkL$BQ!z^t&&>2yII2KfM^h3?s~7rl%{I9L$cK05DbZoVbR563P4!g}wP zeH3B2B#GR}Q6rhKLajtBVNzn3H+BFQ{}hak4t`puCyCa@@ank!07r1lwLmKb54{+% z^oI2bAVB#x8d~U7g-8jk@yOesJmiUNo^YXumP-%62cbsZ!K}|!C5(u_jRPQu)w+)X{SvHts}>>t2S!ts3XUtVTA7|j(48|gVoR#$yJ>C%C@8O zF)WC3RL^#Hf>LO;c!f8f2nxf$y>`A%0D+EkBVkeJ=^!?T*BK9XW8EZTn;EHE^mHs|Qw?tO;@xfn;GHNjHj)HpW9^0sNODur6- zm9K|v*^V8b5`VXUgb26eKyHujGj^XDWt*RTE6I0L4go_3*G@-GlnQ{&6vvjBgOr;w z+`(n_5v~u62vkt#-qAGfm* zHCCoQs**t8eSQ*wUHdo`$;uX4&ck1UW2?zwO@lb=hqJk0bdP%nL$nq6juf<;Ecnc| z9V0ZtQPSC<%ff=U+_1Dhw(|P=;!IMjAbemBiBfFYD05<)d0&ktVd=MSYPukK0ejLW zs@!F+7X91Mg(K>4>CeGDBkZabmLV6k6{3nWg~-+)PI+QOzD`tO^x9?Z0fq1*Q+nQgjN`G7!m$|5JL@wLo=HziiP5FHY&-0RX z2V;KU=!$T#`cR9kD)g`nWT}1-?+ApWnG5K0dTa6CoUb2W#0Xr=1bULm-1G`^V;bVM z^b3+UL#)nO7#4s9wXp0cO)E+7o1@d;2kWx zU};Qt);`78!=6~x4QQI%Xo}-eBaqY?4h#t)UjyIHXY4}kzF@f3t8kYB z0fNFOcOKIYPGB0X0*i1U7$y~TKc4DIHZW)M ze(m-%u8+8cWlTgV`KFC!CsH6A=Ej?aL?xDO(`)!N@!_XTf*$%H*Lk|a`JkJe{0R3s z<4V?hvAQQQ5cI3s4*?xp7)h*cx|f^P-N?5wK6fh3fC-y5ExlP>Ja(9q` zyNzSO5`9uS(;{9nVmbBb5!C%!X2sc?j*Z6Payo)ThY<(wyCBh%$ zKChpS>E4xPMcF0r*94-%j=sHuE+(9x=H|Siy=6JqqEK5#fmW05?8pG#JSy=4xGT3t7+9QeffrKssk@|YKV|8n1R3Hbi+^wL39 ze&1O%U}&R_CzxM**Zl*+p0~g}91^sNl4q&8q`>KcmtwZrxpUU&HI||@bxjhi#Pv5F z*s$^NZJBMus89+M@FHaf9;{~l0Y1fy7QeEd*Z}c%1AX{dw(fBA2<7g$ zbW(WPOYS{nXN;WkblZ6b?$OL|-e2($@A#hZ+sp zBUrF>_*!e}cImJXOFsa{6F*r27Pa210CRYiGadckMn#VD>$^QE`~Y4mFlfR8^a3m1 zPcFWy>o|xREdU~QZBP8Jdd|UV@BogD=d#CM=XLeko7~z3nC~u;SM`$>FB+;)gB{Gg zCBkGY*kKj2&1>ss)XG}|#B{6y#AV`lAN~e~g%2P8=%B*E!D2RybIPd7bW(9Zzn4KqIaFv~y}>Vj9DC8L5% zmbqNrok;~As+6uL8=Gb(laz!7FgIdZO*p2`L&*LB!-3*sdC^n`$`NjfP3Eem<>NuC z-CcS_=|-;_!@Zgo+~HLObJ2NHg*ASGX=rn>2iaPk8_N5vzo-6it=XGT555~YG;^>+ zX;`P2ZY7=lcjG{qSd(%KOGCFijo(lKJ`U?@dN3Lx0;dN9o1d~fVc$N{(HHldnZXeP z*{L!D>8$6*_S+QW2<^^Yo9PWWb@(>;H#Apl|73Kp3~WPIB#NA#3l};&cKdR}LMSTm zfjzc;$V`E=`|sa`cZX$@REDcRO^t-T)C!38`pQ2`vwKrk`#@*Ow*Qx^-R1a>(5yrQoX|ph3$YE1#huUYp zkJV4}sAijWDKeKZ+}~CvPA$pbGXGih;WPjN>u?>K3`WeE$y4LUeWjGa<5@=eoqw|l zXWf~aJsK(&WOQ&t^z$cRvwjTb%j{@}N$%?7j{RIXicTyZ$FjxYJnT>kmj6KgG?oJ| zVI|qtbnqFZFPcCek{Y3HFS`T+1mIr}l}+3#&-vU-;1$x;>_*4EXaN zN{+Ice_Gj@3h}#Ta13TK5;WZqabz{COeXYikF)4SUYn&^Z~@jdO38M7r~Go+s~&MF zGPZrSxH%Y73K@m+0Iwf6B&%qJ$Yk7632sHek9}gU0!ukcqr5_oVFs9xpwuib4$Ev9 zLFkqS+1Qey=$KjgvB}*n-8*>Z{^1z_v(%au3n2|#lfGrx=?%HB6>_(I@ALMd9>i@d zAXwxQSY`BBeS7D(({oABa*1?;>ltD-UYjU*8sm#AydMst!!~O>xZV0<^52<8c2e_= zrxBx-aJnLRT`cW8zSIM1CYC=3K30-zcw!;T2YWKm+1nXE4gP30-C(&6%OLaXSDVN02ZS=N{ zV4?)PVCgWt?5$h)HjR+Z5&I)-r}N^(t^C;S3XXR#`3na4gcNf9ORt6yq2i*3ckO>= zDKMY+w{XdTr?5{cy!CE@Z?{E}3x%B}!Uf57S7)BD+NXQGZoDg7LiuqaxKQ(x1e=Sn z&<>&Q{GCJB3)FVFLiRZXd*MIbsou>fi0)Hu=`#~6Nw|dU*I#evjlU3?y`A%w-~GNG zey|2ae`f8Uo@Z6H&fUp&s${F zFy*pyBMpo)yDtX_Q_hX9Qi>0$Mr|(#`nr4LcEj2TXfc^Em~qp~=Ik1ko8GqK`MzwvDzJA;*sx6Rl9_M#2ysr{{#_cked*Hz z-*k%TzeptD$UNxUy}A9jU2up&=Lm<~4dT(}TJrG2q9DO%cg^PUyUUsThMRmAS;vlW zOsHCJA)0p@gK6`P<^H)F;d$(a$WHp=ZPw!6xkGJ~-HKn!esgmFjLjhJIHlJRSPg!= z=65Kx?AnpL0JIGL@4%G_WKnMseYZ!FA4m7bmrpNhMdqW4P2^|~xhj@f;V4{wK^S+t zK&2N5EmzoFWl6d$IhECicg4)}e2pjU)4x{3n*2W6MaxB3g<1Z2_kB3A{%4ZDu=au1 z^~*tRCPF?<-{{F4sGrefLO_0hzcdG<&g8 z-6fzG1dY(NwW8d;8w3}P;qf%ez-G+7I}@+Ko6Q?SOSF-FeARyAlwldXd|SdOraFw)qc1JY83859w18Sso!)u1faG zHDB?EA&Mf;)d(b1#AB9oeiMtLG+R~9l)1~HpPbKn>6eN)mphDiv?#@xza&ktdh}z* zD~!Gq5E{mBUz%KG1CI;p)m^^1YpK&zX>DRZvFH_2VEydVHtbQP0v&7uE8Kp_d)b0g zw9O|zM=;1#%I|1ov zcGdt{ccU^?Ze_f2o}Xwmt}YW-)_s>ON2aokV7}L@kU%HV_`q+Cu&Z*%!w6)!= zCp>5tVTU5HTIe{_y1uAxwo{UqqV}PLDX~^gsQoZQQf@~1_}jjqTl1ShrN1b%yFWEY zajU_!b6VBxo>BtrpNeZ?0oW=4XQt){2=E1$bnr7Q@D;n^+!>rA`Tk2%aEID3B*Kjd z>$U!I7B0N%@E0pw4i`T{{XH1w_Ncj$2}7$Xb1Q9PApAfpy(|C2&%H6%%$b+ZKHvtw z@jiPB^!ijcFkK9wZdEYw=@mrx|-Rf`R$8i>Ij~$?iwlLnH(e+ zKY1hTx45`TQklhdy9igu6^8}_rYzoTV(tLOstB=f)D^2-b^`9Z+R=YHmuEQZ@jH-B^I_eR1l|$|$?!vbCq3Y>ToXj5Q?xqgGx`&@@a~<=pU=4(k zhI>kp19y#!(!^RAIS22j{E_9x;X2>6$`-A*AnC?%0d%1S^nq9jkOiOqE9NNH29!AS zG|;Yb!T62{^1b6<@9=IkaWriF$m5g2p+>UNI+Y)9{qF;Qd`6FRB1h%t#@Twf7>>s! zmC)m5OLT2b|E9f{k{m$JB4ebye!rlJ$AVL`Sm^#3m$^QBM0}o~W z=5^>^LUkU7z%5IxP$7!IBS-fZBjH#~4nd)h+XaygXY$YzOHEigQ?sln%+!jc`hC~B zf;z@?9eXdT44!pDhS#cE@-*MzpL(M2d7D){wQ@>=BipL-7t?!>mGr7gn1fi2QtQeJ zie#oZV#Tc{L)(t+5@n1rmVP=h{vPEyqrdx%)S9mP1)wb`MC+vtQ8iGxG>>&b7u4$E zehki;akiP7m-`_MHlmPUC7FZ$cmsSmGNJtGdAFw?(_t4QkO*5P+26R6UsaK}H`Xco zBTB|AVmkhQb0Ck*yeKMw*NbfMHN&_AnzfHu-;+jn?LAq`srq+GYpU{0-=%fRWfkj5 zCV|l=I4*_Zi)Oy{yQ*^>=*$bPqvk`RTssw#`ZkMpLw#Vk1#zn}t0fW&X z4)1kN=h_S<{>uL_F0n4Xyr8Y0`FPq9P-{=az32oHW%8Q3^^1OaL#@+SlpRbJ;>vR6 zS9e3??c%w`J<+)z3yJje1?&l5kLS=g;1bO_5GkPNj%=yj)lHsU_`iZ%WguzJcwqG=&T z&^dbv$y|boCvS!4+S>=GXyI%B8sD6A)HaXsOC;BUqZ-hbI9?b(8TS4M)p16CQ21X= z*zl4ni=v)9w^HU#j)5Mz>C6GnPz&~3bY>Xdaag_hWO@?@i3N%*3nZzsZ0Dra@J|+w z^kff(GWQ3PwEAwYFYXySq05~GQuszxN9z)JNwkGY=~`hU%ycB*e@Q_fW*s(g*~vFv zv@35eom1oKOK9-@-rTq%4uVe8j#q%t>Cj!p9w@poPjbS`mCK_*agAK`Fj(tl`C0MM zRL{)2nM@?k&#&PNPeLqP{Bd(Q*3-I=LW-$Na(gv%mWkI|^Vgc(6<=7eVCUfF`4Gy( z?Wj>2w}NJeFZ3^+Z%`%KUKRi~d82pi!43})A4vuzH`B2WnB^qXd%7iX{t(1VOGiUk zNtcRT+gA#Ze@;MB(Mqq)Mo2FO;t$o6lwIE8;r2Go77P8{d7!H?whmxD0sOkkn1l|`U&%s){ zcbZ_`jm$Jm@CgzT|Dj`&Y0H6Nwo*8N*!fjFO=E$LX`9FrS}vaM#M0l;itanU!1Ac- zr|d;odaA(Jx+P02>HX|WOE-R$LkU>rWbumZM3(W*9fCt=oFyCmIu-BVtRODu(f{r( zly=Ge*~?G7P-qpNa%*9Z;mN4)OetgeiDEWfxB$NWCdTJ2g7zfwnC4$61z|nEAUv-O z1!@>88Jg;736ZHT^7Ov57y$%1gCAQ^G5ntXjL~efmqKnQjoWfQpShX%pZpfag`JuX z&Q#C7dQ>!{Jis%0v-S(A1Luxv2cU{f#9Ipqps#CR1)S}lU$P_Wlgp}=)Gl8b3w*L{ z*65Lak)nqOJ+97K`>4Yz#fBcOJ0JAunu-5bk}Vr- z5x*F_GZtQQh4YG|^KL4?B_Q-IqH)+k-NoT)jFndUkeo9Qu*LwLv?BS} zbQcH@pqI*p*0*?UHhC-u%1fwi-V)ZH4ljf4rH;0bbVhVcg*nIAQf!;m5>YshZ?4lo zEV~5Ql`2%AIC*ANY-cKOpYbf-pLj~|2b8aA1`W7;Vr0j4_+6t&5kn^DQ*i{V6jCyS zpYjz%?*5sTf)-S5-xe)d+DD>60?F$u>nd&__UiP|GaqIeUc>j?#3=4#LmSB8-tuVoMov zl`$fmzUm4-n#u0zJEHyBZFZZe0FLsBf{J}KvLP-XP2W2>gf~Ii$q(F56-qb8L7fds zZ?bRvgt*$sUmp*HpE6{G05nY{sx{PDcTWyeWL)suLP-KZnEN2a<2Gmit(f7l?BjL- zpDe!hhxc*P*bz@ntyYjyd9h(b}>qBl^anF(_F4N`` za)26()wG8Zo7AVWk7Ml&mQI(PVrX%rhS@mE#v4qfoUn$Ec64U&j%`T)L(J!dhI-il0|RMI zE9@)T#6-a+jKo^xqC`9*5hq>>-vBFV+vUe!9>lNK@ta_Zhg%v0vP4UMs+h-(Le|Br zUaenwLm9`ivyO=4Sdk{(Ig&x&$a2JM+$vl~7$Dz!S;tU!Qdug*&Fw&2-UvYcaq7%V z7fsLwVmB9BGy3@?@W6!x9};0cJ6UG8Dj99l4N(QXn1>1!udMeEktBTLkhFG;Yy5uf zM#vyTlQe(MGa+jK+7snW*RRmu34iTjK=16|S6ufGWyoWnkiO?$fWP10nnB!gU?*oC zM%K-Tk38)dlA`hinVY2TX{#$TRmy zTBF-kAi0v!HS^ZyIQZBnkD`RNPvv8M>m5fdk3PT)pB}r%rBw+FH6e* zP7q0K>^q$;MCo1u~&Z>IgAq+@&^UNs46`Dk69z=oTiW_ z0((F6)^a$dEx?zh!S#vY=oR?UUFb}>TIxObB13X6W7gSL2AQGMtd}(K>qP_lXSPf< zRD%%c3!_6MhPt@&u9!osO7O?~1)!nt6YA6hCe@+k{QY>A)<{J1|L(Xu5uveZj}JDR zHIasY;h$hdioZt5U;4*f^io%P6q8coa0VoLh~A}@#}R4{(*9hS7H!i;WLY1*aS=A%!FJj0*~?!B8s_|^)J@{ zR6H)y+sY0xA2IKb}H9P-5@^It-T%`{hw#duQPVw`i243c`E8pz|T{DYnqjGziro zkU@UN{jJXm^XH~L4kQT&j^7M=im5EMl*1F~E6QjGhp~SIL5|ky=8406DJ`rI3qX2g z7d|`xbdr%JPzBh;mf_^m-&JG6<>zsC(Do;nn*Sq)6zE~;@2qzhH_4(u#8gn?$paEN zY%t=O`G48GLoaxDv13i&x?Vg5TE=0sfEA-p7#urWahRg54qz1z*B|3R@Wk82UBcglA;V97^ z^gL>~O*1jOce~JQmWkUAYAIkEA$Ic8^F(3sA$n)-@ueii&`Xlue0b!vSAq1DcM&|3 zwMF#!&Ve(s%=2D-5XIqjvR@-r_xRL{3vAXtek{&(7lolesXL@v4<%OLqsSB>2FF!f zF2y1`1CxRaK=*l|WAKyEiNejR7i9~~IL{K_=f&GlKDA}!CbAhwEV99@^%?EUFhqG= z3jpo;)2~QRlHuvf%vMDrz1pbOS3#@O{5Aj9kuTSTXg-DbE2u4$s(&?>rKFkIbID8@C zwe|(JUI*1^d!t@%s*3hcxHjj9pkTw7DQyNHGF04Tr5vJDoXfhTv&vhBH`){Jvc{uX)7d7|naDdazgIEVQ~zAQU^!$QB1h%c`)7Pw zG?{NWz0fYR$^>?dBTF%EjEBHW@nls&`Kom!zKS8y*o#Mue||!jF~p%WFl@@7=SSy! zkKi6kb%lw?TlK(Z#ogvvm~}T4^Q9!_e#SvudWnh1R~KeLVG+#IG(^}>NLY*Ql9@j# zJ>6O-Dg=|(#NI=Czuarup?kVjT&vIlwvX2c^pwEu3RTwLeC4O{e>2Q@Z0~T z3TW~KB*tuvwlc}Mq!em@PP8_r!fk^r4H@MjUaNWy&R=uCjfR}IwOBb7{7 z5)*Tcau2k60^?MWU0p1zVc3pp2nyok%ES(vHNyxi@r=Ta=$Fx~%#+S9#$*eW{z4L8eNA0Blu%UDF9-)!amN^EJ=B#D)o zb1MxVN;+dlWRkN-f~8T@8k6IP5XA4Kle*J6ToW^p{PhwE#E$>HL{^=rJi+z@yzKbMHZ9#v;Xv8fHSzct*Z4hIV)!g-$9`fZLN@W~0jz#8beWUmHP?}CEEg~g z@OgQM3PHtzy@YN12D@ZnPSk(U3(v0F619%TUf)qWr|xUFeG>X7)(UGpAlCRlE`Z|f zMQmhsl0gx?!AnCjrrmwC9y%!%Rh>i@!W^9*TluwwxKBcCRC^cIYX=peklt_-KdO*n z9NlZffncO^JLej#< z@gsX0E28^#6>bN2?$YED-GK28uo$XeY)i+GlivaMHH?HVcf1tpkp>&)1-Ok zKxZnCCXZ3wPs8H=-dal>H^9%MUP-y1Ng*;yNpgVbVkK6>o?DDF-df<0VGF24{s}^I zQGTzZ$1h)WPvkx?FA?L__^Uf*tc=P6F?Hm#N8jg9s5UU=%g*;;F$IREi_~2K_G!r$ zG}bJ^oq_&QI=IB4+xy2~UR3|%>BS4!+^q=-B%Y;2x;F_XkQkORJ=1Xl2W3vYK#K7DcUl=L>VKA~JK zgw>C@`|Sk!1Y{TbZMggw*EQT1VWwiTE(Z$u_Fb1&NIRA9BVTOFy zosJMwiK&nH$o=Evh4u=mHRrCW^)zqfO_i9jos(TGU{|%3m?=~KxCqo*$x+T-wWdCX z&{ z49c~2Vyppk#`LRU%X4EZ>nMv+%gUO>25^?^S#Z+ZSng`t1akJv`~vvvceHC>Rye*% z`aj^!Uec-@CYRt9@+BXwN%*;+>bRV$%OZJ$KMb=$j`2%Sl|_O=-;yUvrag>(7q-(rpYr%&cNv`jyuk=wQiTSXy5 z1;h~Yp3>qr4;mvM;981za3enet6pHpcN2*t(8@h)Lf zHx}K20|&?9)jV!S;aJ*PEqa)7jPG$tZ#&hakJt#k9XlRR?ZeOeC(9IMLKDy`e3*)z z&5$iAbWr}?^uA9U8A=M075a8Gewz#;cy3c{xTLyje*&K+uMnD9Mp0G?`Y(j3+65>* zL8NO~<_$=tQ?>)>$M0V)>UZ;czhjnrFOD<{iVYd+9(8eYRqQ{WBrRicFGS@hj-=c% zx{#E5nI4s4*VF#}kUoQzC!yF&?#ut6!d#q{W9Q_M)6Zj-oT%XnJxH5_QA6*C~smgvjspRH zHE}d(4vc${jog?gj&@y)I^RB8B*WXzsXM&jXn5*=z1+QW_SG&hKdy1jyJ4p+3zwZy zJ`(&t+hf?K4z~B^%=bja8+35a67|KKp&hdNC5!x+U4pGHe%;-(0?E>i(dR3GKb+K_ z>6@U}IrAe)uEDhSTO?Hr&r4j-lR+vcpWW>M+6EU-P2Xq)I0gq5BNIgK%z5_V;qi`KP0!$r71j**6)$h(f368^K}5;V7v;ua zPu|8<%fIOT?zcjF+V>`}=Z%^1Ga4L~$lrz{q(37A-oOpds-Z)Av3V4i0b|D}FYZW_ zGMJ_JlR8gf!Px(B6-!#n3OnUx{itE=HHQBvdEFCgP4MybFFhoDTL9S$?=}?~5=RHi zQ|;W^(k(;5w;5@YI8Au5AxXYFQ8DAG@#G82gKu`_p2!XU3|sxR!AD*iy)c+(DycwO ztr{3Hb&yydzlg~&zFm>Qj+l!l@;0R-i87=64Dh*o;ju;Gt6Xr zyvrvH%ci0!(|DxMtyUJOo>aXZWr!e@jf6U;_XM6~MFL*`{0*1n2Jb=nDvhXcE>4bq zu$ZBzx^Fp#>>7@9E+(C$3}n<0Cl${oau`wlIg+!BjS|>!eyldtBsM6<7wB=f7oF z#KzxZbE|+E{OZ{lQ!%Bb$}tZ*_Pus3DBuZj5>v?_g72SKMFd6J72y#agy{ zm~QYR@GZ=F=;zraDha>wrhRu_8pA6@*Rci8Mp%Ty#<*v)uU&%24Pg2ghq?3p>>wCK z%$cQ1orZ7$LjZ!-cz0`hblFjvG6Ktboy;u2$*f6lHO%HH)kPI@CQjU?w8nE-y`c9Cmt4j zf?f0LU%tn$W7Jx=DQ6pS z&%%Zf%@F$;H1Efyn3wY<7Cz03cRVIy|B=>3v`s{Nez;da+A-x3Bc!b3R||)X!3vWl zbIyL}LGXJg3By?Gmpp}UJ%!nG<(7}Hrx-fV9x#(TVIFJQ*VX-Zx3?7WVb6nzo=N6k z4-~+FIaUpB9@`IDx~Qe7=qozV7zl70Sn2;zO@GL|VzwTuxTRa)jT2VEr|X^)-sjGy z(5OHUp4zQKbahQKsaN=KOV@&QF4*^xJvq@>3a#Zb{_1}*$IF$9a;%(kYcFl2>MJ$c zeb(jI@*#*9LpxmP&A28XP7C~3eSE**_Go~4q7>Rx&KTlTr;l*rV=r!&YWXpMU0C#B zrx5J=lzFTiH3zZ%5YY>D5HLqU=h4ea&h9#@UyLtK3~O}P;2KONyc!SrmSHWyW-KUU z`w@Ut4!?}lwwYfFTj@N$<||V^c)+ZvKeRl#)3U6Ndp1`355>Nc3LBs-F*RPqDUvb@ z6vy)U=$EjIFCe7wF%-xW>q_)x^kYR%9_7V5hjkUn#JX1lgE~3Jy=s^W@v&-`1;ZeY zCpCJNu6;ZctAYLV61OU|JF@fDPJ|A=!xznRu(noe&arU)Epu_ zu)DYO?d_pv`*uKwZzZQT@`uL zm2m$v@(4MA_dU3vV+A&qGLVUojbQORJSiM96u{@iClL3+v#j6w-QGjYAcE!o-{VYV z0b9-0=Y~p#5)&8xD?mOK*O~!l@Kr|*adP{1AqREpt#zCax=mY`m5KSt5vV8)38N|i zGgYZIlixKi9nEDy@@AM7-NZ>Ck6fm9d`6M#6x| z1ro=>HV@;kk<@#VsfV+lYVnC6!oxlu@tAh@EJlfs+kz&n?VP*Zl|5%Yz`> zfC0J$fD}SIgQyHKR*PT5eUgD*uuM;r<0)>#bmSa(tGQlkD_M&GeC$o+kBL?yeJ(qv zb2D@7G%5kVCmR>n1qku>`d`GP^8aF?JRga%@n#Ku^0`A7rn}_pn0i##W6EV5xq<{x zMf8p_8h@pG3l2Glm~4kvweQ(C4fC;4GS2Vm-^6X&oBj|Rx1weDPp4T9Y#^ttnSXa` zCQUOW+qh0Fn{}f2)^W=B`X12`RPg*hVqI|l`QmZU`4vm;OG$!KavD`a*OxIvdr~%1 zRn1WQk8N3$d#`Jb8*YG2gx!yYS#ygR$T3GGW!vDOq5$BnYuH%y^WUagGAz7WhqBib z4xVgeBv|a&59i&lzxS%a77i_`#whK>&lT^@+AR}6zBF3gha4eWtMs<-axO%?(R7 zVY@YqG)Q-+3IftfGjvEP-JQ}Q4MT%8(o&+NbT>nT(jeX4-7qu1Z+y-<@AJ){tTk&f zcU-aWz4ukSNPp*NGv*~+Oqs%M53^`Le@thAyqd)>2fyA~qE@y1kD>Cv&2GlTA_PwU&z#&;D+$Ct;qY<}Y6P5Tey<9|15G?dP7 zp0m4nIFVZGpz((wq5q;OLT7X7x5ahJJ&tVi#OYEVIsdsB zzj(@c@zrSonc@!#J0CvpxZBSyGoFF$2NUZbad-618)?NBWQ+c9uC9UX8#PB`#M4Z0 z9Xx;kWM>YNeeutQ>3=c;e{kVYie{VuvshEvGYb55SF*SDnKX8J%2xCiT@t3LJ-!l6 zq{!3bOdq)ky0=C93<5Qo9x7ahL>{mbFpHWE^LO_47xhK#a;Y*7^2%w!?aWo%35MBW z>JG^4bRWNkOMmOhC|qwvHE%hauKcLkt;!BcdEk>LU*C${-PlLyGhyV^$i}&4y~9_Z z?|Uv}?^kRnmpj~%;0rU%E)NQh8p9^_(0L-Iuey6?`E(huwR0i1DPVNVcL?8<2z4Xd zbVOhTC+Q8CdZ7JrJ-N;$@U6@C$30(!rXT%mLF7|k`{Kw6WMKe81Np>eshBm4 z#6Ex&i@MLD32V=H4eGB&9Vuk|9wE_#R$L!*;U(oxB6aWsdxc_;)s~xa5%~Yh6Lhbt zmmO3_)JZ-BSyi9Z5uvf3Jku|fQcL+MLura!_Ps==R2dV3_C@{G`5hZIW#6o7b8~@z z1vf*0j1^>R0Uh^&SgBk$|9O1~2J2Fqx*j#x27{Xc{Mca082Kx zvaC4Vf3!&e|KH8aZ^Gh0@7(iQL#ca;auyE~!N32~prt&|jrk4GO+!o5LdL_|)Sw{w z67~k0NFAkMGkoP5HF{=Pv~BJ^BLU?lA1$W<<4>ltiWkJGIE>{(q1ELQ#Mlf4FVhqR zn>I!EPuL2qhV5k~$JM<-0UmVl;W~2Dx0ssTe&8pJ(i8eta`;WYp7-rBZ~JH91%kz@ z!VK1?y(H-GTZEvApZEFbmWM(BgRR~rpyjBxDeaQFi0hMbGhqw2&rL9k%~poax`2y^ zQI`x+wUL4GXZxo-1E;R;g)2~yvRJeD5&iVpoCAzm z>7N(EzuPBuMy>zGMR2O0bHj;mwSNK9Y( z!S&4)$tpygAA=rth_*uHDN2zLycMB&lS8EPfMbSJ=I zJyflar-t_la=bqDqn9yAco~2Ocdt;$*?rj7qBvv689AW_qy%3k-09#nbvro#;~pJ@t2k}Mk-*RRcgKIn%Pt8(?^`JZqYzMaKi^I9SE?ysCoL-ue^fyN$) z|8B{tAYHy=<10I5na`PEu>1(>fzemVN}<{BO}h z@WqnDKj?Fq9lcC~*3n06kfQr^PH4;BcYGjIyg(7M8A;ya{#}VGJp6TJHC>w?N?G|_ z13;p!iHx48-Q?fHF?^u(-rkFcs++xLf+TO%n5J<(rOGForoSw2Z~TT<;SjL>#6@Eg z1iJqt^!cn1D*5#djx4UU{9WD(d^+Z{_xU=d?x(2AG)VGXn_F0~$X$H5OKR#Fz%T;G zcQD%4(Npdo362^BhOcnF!Q1bmYMY-4vrT1EE{D)w{aRWC*Kn?T zKc_xxqz%}NtO1kXn#hjm8OY@f;0^l!5sLgfTmK5$jFFHR*H85r9?6yyV;+zGuuQ;j zS}IzpQ1W$y?m^?sS^0`RaA%B0|61_9H54)BC+E?3Cn1IYbO>MXlCNC3kUis`Z|ymQ zNK9sy=L!ecnXl&qLg3&9BS0`X&hsGt;@T6kiKP<_Q*g809)KiuE$5Pjr9p}ZjQ=;s5nyuqvOH&;KNas$4;fCi?mKt6 zU0%7=GfY3y^EWJ0cDNm8KV``M7 zMr**FV2OwEY&~#!-15TDI1tRX1Yhj2r!#J|C%9F;ac+ikjm{uglDz&mP;8nU=dR;V zNM;|2=kM^Q6=|fGML&#WB$!3PGE0rf<{}C2=*pjT5TUR$EQtg@l^^touL~l*N=q;*Fg0{gYpiGV}Nn|5bZA|V(S|a6J zEoFLzGhiUVFzYtmF=YWBOUhJU-9wk8(}dSsDBaHf1U#f7(fMEVk5us2Lu(ytmV4Uq zac=Cblf-Lbfm@~1+&mw`5gbD!Q8;BY;WvrF#>-K_w)|@QF5@`*j8JWC2mQjjN{km> z8*vEVn;?{F6k8FfZ>qpA_aN8*qj3FKS?${)4=>+D5|OE%qBPn1VJs@Q#aFV)JR?ol zyIhY9M4EOT|7xNi!^+MfvKuu)_ELezy;dRoeHtdtjm&orT_)MzY8u=kimc@VJr2QU z6TaQvPETt!0Z7JP3j~G&s~9L+WN7t)$Je~jnV7ndyN#mJTm6|<-lxmh%lwl~mAtvO zvsX=dLiBoucHtU96;dMa{jNqWignh%@UfpSDxt5N7=e&s?fy@LFJ^7czgXRXt&=r7 z;gH*_m~pv}L{#e!oHx)gL_1Q^TWw$B*U=2#Dy>7L#7{R7Vf8()a&3)2c)iyr(d$0k zS=PlzzQo60=?{1)B!Z;|s8zOoXr#?~jx z<@jyyRYLy-a)jF_FOS0|W?X|f1ZP(VO_Zl2g&myge&1rivi`=8h3WaPe72a=``d2p z_KjM}`vx7y$R#HGWREh&FXQwkx;hW^VhyNwqWrifibG}QCkafeFTw_F61aNB5)6Zg zV_@^+W3g7cqaGT#S#)DSZ@wELs|VO#SxRTD8`rzGp{ZxMfWrecMm zCtA-6N{-fId~l2*PRiV2=PGeqU>I!-X-(7nlPlDQip$8m1Zvj-x%E=CyX{H*5;e;x zNnBnO)1RJu|4|`NxUSae5)7Y5hAtA@{N!-Y*$2$hTAt|hzSLeIg1QdQ;KF@`J*iHO z&4|B{NtIDr>xkZo<6pr_zsSY{5Ximu)>SHSrXe;rX*WbU_MgbhdGZGuAilALLC8ll}NLzn63 z;umuabDdNH^HOv3>f^Vgj8ZJx6FIQkMbVeP`31 z;QehPWiE`;Fzi>~J@K^Hi=A>pOn_abbv5{Jgi$~hgl5(4NxRwVNaB}ln$QaO{dWEW zCoRyw2Oi1~gJykk-j1iy+LwKY&k5A$k!G$wQAAVc40 zXX7!~(AIki1H%!#6Q95DywMV2WV|mYII9!>eE72m5Jnjbc@VF+#NM*4NQIJXBi|>e z<%P--ajAUovMxPA`(A#dsr}ZPef=WKeHb|q*77j)En07@PT?u?#cWyQUH2NT(d{ib zRi-Zd=|d50^y)@e4JVFw0QAUI3LkMpx)T+z8mOFx26GP!SaW=^m=QM_x1&oNJ!Mx- z(=@xFC1WNJOo{z$wvsnzD2xMYutEN1m`>XYUTq2B_6^u96uRGc-(w2V9HYEAYkAfE z?S6C8=e{P3C0P0{7Hs1vxfhm&wBc7-{^t@45rlFY_<^ixw4;{)M(Xq6yB{Co`!T-% zOr8~W?L|s!m3C|^nP0PzQV62ur*&(}zWT#OEnPr-DgFGCyh5!F+jilW%TElN_2Apf z4(bHW({ez>pB-b558h2qgUG1u*#Y`MM|92?+V8BNuFPR;@>SgK9HM@mczGf=lBQSYIDQ@9jSG;wu{7TxLJ^7YlMW)IDvz0P~Ck)E)l?_Qh086`wx~UM<5ge|ES(&3#38 zA2;sL$?ir@n{h$cHvgMB(Bu`mT2agh)e!!hp|xMgEt8U2b$^I2-L3m&q`02Fw7@}g zdJ46AiDJ)+sAE6hM_N3uxC3)Tu5N+8Kf7QW{h$cj3NgpIuJR0h`x$sfLG3rA4kCPB z{>~eoxJmOwIzFZE4uNviF9JqI;N4V!pd>1{JCyzE?U65A1ZhSJ&7*SeRh1KsQh9gn z9%9<>4XZMq<_)y?@cH}PYH=<@-GkN(6Ki-VT^7)02KzUu_dhL@gQlM%MFd??jZz2> zHx4VB@H{7v=^)w#Nv!B@#?NH3HK9hYnyW*55!4VZo!w-5cH~Cr?5Kb`5|8%v{P=L|PL_1U(;{N0u~QBWw)SO0z_OkjzXT^N_0cEJHPCZFpS{$xb*RtttpGm zke*_jY z1V}f4bR6LUI=J%NTKYa_a{YM=eAohN*DWv=wt7Vf_*9CSX$&FTV1j`w7EQkD)M5D) zK7oYI?b%3(jp(KqOPROmNBzEs9A1rFB%m^1sc%{5~zYRC_P`8u?4DV_JtNd;3Ts=fNfTYK^^u`+?Ge+1;t_ z(vG#B?arS(U74^n!Xf10;>3Au`WMl;sv;)w)wLk|bfl|Pom<~|Ce!i1NSbUkhj9{Z zc=@-fcj7qF;vb&frx^uK*>rNQGpiW|rSBaQ3NgqeF2b8sZYnaN<0iVUE4k%x;YpL= zvo<%uxgRf~w~dAmpvT*^2#?&OK3~_k;%=kD zXdNWe{)HU;!68jS?eReWPIqtkZa#b>DtHA-9yCM;eDH_6FRJU?qe%`x$x9x%j(b&O zt7D&hygf-rD_Wh090E7&OSBJuT~r;i89ryXfva(>kQ_voueHNwm|~;H08wZ7S>b<^ z38L&*vI_}xV;|o^<~3Ip;v_&Ds$a%%9he&DDn;@pC3rGkUms~iQ_6+DG;$MOD?jOP zwv%V1b2ywqC>DEv7N;%W%Fj9TkHgf)N4unp(>89>al1cnz1?>{tS(MR_WoD#k0!}B zS1(IAj;e&yrQRJXq0cG95BlZa19Ni_zdch+GcB17h<`ItzqBxK)3?PcY2@9%Utd+f zuSc~Go_YdD5+>_B=Wb%tEEixu^%=WwiZ>lds)g_|L8wt^$HEq2L!Pe?|8jm*QQnT&#XmSmul8nWrDrOs0p3$Bzbnv{ z&DwAl@CLd38VXtXZ{3n#j8$HXf2|jm)Uf4nMj(Qn66w+-vaL#R_!V3BSGlakk8L*o zBDA!*&1l9Lc9D1$bK$8^%HKr8>m4R`JuSB9_YgV|0#PC&-Pb(!*D!SN!)spA1%Fa! zuysKNb&1=&)$6OA6mTb926n?Qh<1h-uGagN@kD14-n>a53p`R4O}0ocL|YRJ$DgRV z{pTDOIv%#Ig=9_OzDw^kLMjM``cWWPgH84L%^!B=`7rmpI&?h49nC+s;uVd85$}~} zERk!#ACC5?E>un3TNr%Wc|@+SLLrLBD6cD{s*KKphjGEonb*AP4 zvj5Og{onLVcdd$3UQcVJ7E81jKHfdc`sEp>s;m=6$8A4>*}g7^oU-cQWR959c3Rlm z6qCUj#qnP|N>5IZ%hLqfp96}_dG2Cu{@T0|<8cO$rfajoMe%=dFaJ1z5iFFgId!8h z3_1|C9#9?*C0#Dod~#obXE$+Qdw&A<5FY>GlEWulTOx%wbE*wsgoEpgsvj9Tg4V>` zR{YyI#S$eMx*HYGO-MarSNQ@s;O2(``w|o#&e}}Au0;viLVIO*mrvDBquA$`J%d&6 zua@5z5&mNLq`So(AhSfDDm%ykj!Wm zIivS_m_Y}U+oyV2@@9QG$nukBzrFf*1nx$*&I)$EC!OupH7MM_p18#je`?J`B3D($wn+O<|@+(x1f%Xm-m1=%qg6* z%DXMEjKgYHJKfAk;kQG`{wK?Bh9+Z-n8>mYQQI8~<|iF)dqG=F3#420;{eVmP`(YV z;%MaF__J~`9*y`5FUOFt`G510Z$?)ScC5cb(;6SQMHg#2MsT~QI*APWY_G^wqR{@` zr#<0^?0g2{KR-}fpxn$Q?y4i?M~^-?pLg&Rp*-fb0aL|csha=kBdi2*L=hBvKEv{<-ftSg{0(@Ve6VdR#)1>HwUz?-A zk94djVMM|ssUBs-HJ^2CE67Yhzf&-4!pFQ$=??x}RBc<@ayCi%`0QE4?}2yY!Tdno zi;kDl2vTo&@kf)@(g(=Xej#;V3t$+nLaZA<}flMx*aIhJP89P;nWpe~-Do4RcK z8LZxy`yy*2hdK-w&GV)Yd?X{#@h&ps3ddO4m&(s!7Rd>9}iX8s9l2(h>F&=eQ? zjhiBFg0y-I5+z5tVYhvcN>yENz4-JMjd0|4&kz<6_%a9ts?RXc{;4-052?u*LUUE<7ZQt53#6*r(y)2@(WceIv9t{)})b zA>?}mP3w_b9kUY1{s=Or>s_%w+BUd;j^@TCap3989}F@3C|Z^?zg` zhBLe)=|~O#K#BA6ed^HAFPmo544Y~hEOt5)T|kaqu|%KlIh%FyTZCIt7LSwB^Jmf< zZm7zQ^%^_)^-$K(ObH$}~PkQ@t^Bsi^DE8>x>db)KEbzEwk!d*nl7V;y5 z!!>~C@w6a9mDAAB(DPq9oybmYH)(I%c9|1IvBv{;%05&KeEQU39BJUZfbw*Ac2w%; zcfHSZKVkza?s4R&!p->hE$qx2c9e3AK#3x;%GLFX-KG+svrvm&9pm`~a4BWK^P@_^QEJ;&g` zS?D7W!}N+b3k*zNxu5S}^R{nHJ!>{=$2N28L!bb;qB@akG)CbFHh?|r{S#pC^;iEB z*zuWFJU)w}!SfTaw+TS~mH$XQXlsJOf*Ifg7?Pe6G0p)nbWGG^t zlvgjBiLo-{_JYrcZk7oMC4vv>%sv2lZJ$Nm5>DhEUb<4oy!y?K7Z}6pC%(PUC$Ova z2pzw>)*WzE0BxgqOxd-FvBkT6YBpZlqWbnR}C(bjKgS54^*QVwd}& z;fb|1@`{&ye0=9$)ZlM$aB;gE<_tSt&EYNq6H1Xk?FagHu?+(sti-&)>1k=-?rx(N z*9|J>%nCcDju?VnY6x_9PpeMI%n2osv@zWgs5v|4E?(VPuqeV$3N1KdHUx+K_g7=p zz>n&Ib)Cp|f)&cOR;18c$!{W(x|E8~MEB0c_{C_R@M@BzDY%C4kt0cD=glbrlnrz8(0;Qx2AjWg)uTK;CIAV=UHzbam5}@jR^X zdzQzW&^Isy36;R%EV41Az&Q;L(ziHoTpCypNEq)L`D8i zUHW`#gPAa2kb9zPk-;G^@q_V-9dhKBbk*goo79XQ&casp@jIlGsX@FFD%D0BVS_Hb z8-=&cd9+d2HI;XOp!G{x&XuO(m{wTh+J{RF{c@%ZInok&{5hAu;A@$QusddV@n;Nb z@kNT;eM7a5Q-scrARwSQWtMbzmWpFa!$o~ONyRTmXv)zqbKO)hy@fSx-+Z=IZ6l7K z)i)XP!g0C3Rl-=;;Ntod9)p-VOk=n|bOanjPdgp6_FO^)#~kj^i1gn}`!p_7;U>dXsiJ#>|H{W-MRc-NgwfYBKqNpuCg zGW^fOVD*Nst}geiYy*f^fH#=o?Q14N`f7lRHs{C;0o2X;WXW>KCLG!xBa?5Q+&Ib1l8$8(>cdxBKUG*~c!=f|jh&F^+Ub zbnBqp6gU@3KH_|L=V+wj)k97iQ*+SyPJGP<`tZR%lV5yN15^}^apjyssVC_L5VI3+ z_?pjdUGJyK$v4j8IVB0aDa7pqdG;Xp-ouvk&?D->A2^X&l7X_^JRX+X-`R#-CfRub z>TPxXSW$LX?feIDUDf}1QrpJH#raeegnoavwY62ct+nraUl>Uryi;hEswEIh>a$0S zVd~*gZ*w|+ylhBP#g6IWzYgyVY(6>_$r=n^K;jS0iVM4e|$8&iW24rkt)_MUC6;zcmu z4Y2DNMBi#n(CK4iLb48QOtXIwh|2BC1}GvKG7~E4&qB{u#gGv49%r_Px6&wz;JP9| zv}q=#&bcd){1xQbW;qA&$$S7=h#iFgPvc7+ztYAPXk^qOq|idaqkWMFX;8+skbe10@ODlI0#nJ+$Erm!bRMwDH63rv_FkULWaC9&Dp z!6?^tH9f=Fx(%BI@}N9E4T-wOH9cG49|^r;O*q}}h8?Su5qzUZz)G4XaCevRK0g&H zSJWV~%1}34x-O1YZr1-w%Q07AcF=V016n10RS&#WyxF69bEs8lTdl6^>jEm}eQ0ZX zCZPA_ArApoI}iNt8Yf`yof|p(TgV7^+;8Tyk|72WUa&sj7|Rjio14+EKo1BAU`x~U zK7Q*Z{hDRZwP@!%kqkK5;N`!?l&m0_qMuhH7N13Z`StSr0U42-uEdl)Qz+xjG_B=n z!)I=W+1{8>9a`wyhDVD_BPKA2a@_d&I3=bqzA@QkCcdPqeJ{0g*1XDuRe)<8{@3$B z&;EJwrQ}x;lR(OcJJs86NJnZn1gt;U_s0R~Lp~VtxBc?gB2m|B2V(IH+qvy+BXUg0 zH@@V1)W1!~aOXKL=!umy&Z^rqgYs=1UOhO`4PQBiyYSp^8*FFX6`7~9j6Q9cCQ8*( z-@Z5txjlhUJ^{M)kveB3vQ3AQjK-uwn7SwJXQtp?KBEBP0KjpFjR%e5*H^Z5 znG*~WQXhjDNJvYp?B29m>Uhn0=xC{(jjSFYpM1$&Iye;&nGw6YU0q#i({^7ny7F9I zPFPr4qOB2`HZsy@C)29=r9k!;E0FXf@{tbvunA7o4i;EL5<>7>2dfY2x>LAL2;qW=<-l zt*I#3g^k4zI5JO@^ih3N?S$a=6W;$mWt#u^t#`D|JO>;T7;Rg9{d#39b>aN1kzB&A z@+-pdU>4;1$*aRa{(7kFH^qHn*JXhW);U|=*Ol>ED3|BcI6v(5e(lgL5Zek@Ok$Fa zP8mV2b#u@E{#_zON4-EH329b2$~)AtgSIJf*Spu*m54&Z8f};%7KIU7M>}5lK~Tun zGoXE%Ep8Hd75wR0n5JxygY7dbXoMbBp$ij;2 z6Bd%0Zbp3RODo{vE)JFObL1GS9Ro4a0DLvNXq%2+I+ndajTnBXK@P5-j0)g?KM&FH z(}}P+k8$6!Ui`i{j9SC(c0As+t1(u#kPGxX0ht9LeCLQ2z%2I^$n=0EBYq9Z>wmw2 z$toB{*H~c0wEYU4)pQj0GupGYn>?30lrOJ>a$Hh$GZQMLA%h_aWw}iU95`=GSid@9 zh{STMa$uW3jDi$p?9Hszo@{C0RT|RV{HgjNuQbcXnr8TioopO?%|!2MN3ZwC1$$)L`1$XXihI-17S5JelNrIf|*cz(mcc%n}b8_Wv+_FjN*x*kVggCNR*R$0f#wKOacKTO$SGi z0<}G)dpA!a^jwqbnuKjS-v%6`1z*l%GZ;V9`TLvE8dYY|U`D->t{m2I6G=8*MPSUrij>(lnAN*U_ zu$n&S#kc3*EmchhZD|61JyYa}7^70l;XhyoEq0n)e4it(n}i!xZ^swPR^KU6^LMis zlNRaErGG=J3T%Ig&*r8$Fanr20m>6=NKp#N+2#jr9FLRrFK(NV*QxBb+Y#PeciR^cJ+4bjzRSCq<|+mIiu18~wfnf%Vqv3rgv zkI!Dc6$VYQYv0}591hfVTignZ@l;gEH{Ksue26xw+-SFu%kWAn-P{gK8Sv;%KRmW~H?KEqc3%(3z6qQR8i`YQ(6kCQ~KT&RSO@z zyb|6S_t~O=O*AxA_I^Sj^uE58lkPE+P+a8T>1m!L|4)sp z%jIzwQ`7_kOdB~%?nJHu9-lvVmrmPUyR#gB`AE+&>HoXd%7f#b^D3&6RBYK?$Iwif zj+ui)c6|7c6^v!7X0**ZZbJ=nPJZ=EKe(B$;WY76y?MWziP(cH_0;T%o#Tq3lilR* zCK+1J!`m1wMs{|cZZZ|Ms+%(w=|}j))FQTk^R4}nsi4`<)^+^>nAyW6wl2ger}1tk zVzKUD08YCa+jIxY-R=NuRIIb=;u^kpktnE<)c3{EumE&Uf%{i=(fRBq=qrM$!+g#k z!2~y68QB&XaWBWrG>5W^tu{C&Rgn>RY_)V3FT+v3c zjr{tc0k)|knPLq5-O{=^@y+`^D6znk&12nA*@n#GdK7VHhZFG0u%QA_e?OlqUxr&` zFJ1^62g5X|MO;Bz9En=yRXQ}c;LR35y6Xl)PzhEqu>8ibf4(bnCZX*0hd4b?(EsjX zuOyj96OTp|$7U>dnr58CLQIB<@E*4IL|3lcDSD1@r)7EKw`mkk7vtf<%A$JL z)!JbHCa@P_@wGnuQ+{J0F6&E)TcoQb3mxraXXlYiehrp(rS3DYQ#eDbDiPLfzg*2flc<%n0N8?M-oB2<=i6n$zC>Mb-MbO&+!B z%SGW3MoiQE`g+4)uT{Ub3>;824jpddrIg<(F4+8Hn?t$iat9hp&)3#3G zhP@XQdf~j~3)65IMnj8jL6Y0Ym0a%+gxzBG!R!?kF3>V!m+=*^?psF#ja%2-0AD2G zw$@m89*aw@ zW8w)(1Kq4+iN13Eey z;1Nd4Ik2DewS#m_p=9>{$<`Jf6glg}7)|HWa2a72W~GXoxb;DLPU{-G`fyTKCF$%; zFV^H8i0Xdc9EVPk0)2FrKR>(?F!OL2aang|&&tjYI$3J$npP9DL&6udrVnVxN5GDF zgeP^}TOp?1_Rj5CO(!cT_{(6E{Suzoc>@CzdFK9mkMhPwPi#z7$Euw_q>Iixh0lLx zhal_L=+X!a3)}j>z(;z^&#x;%8R+!U+cXqrB08|3n!Tc0Blh%`wxk0e2dB$9@QJO# z1{Lv&u^acSz+oky)*@`a<8C?U+jRL2{pahLF84=c-0v(63FQt{{WrOdPHH*ADobv4 zYUtl<-g;fn>$t!kalLOBoTvWktaWT#gV0!9O@?Q$|6J%{v>VgX=A75QBllW$6+tt$ z;!jIiNI|o3)CS8+=xUy>5OoxYP=xvIIj_cTb??S7ow=uQ3nX_&PI!f`=7YTKBA z*{zhVlO+(A%L|pYji2qp=xJ$oJ~R>wA-cYal%TS#D&f zJxl^GZ$^AlATT6Jr|NK>^vsgkyP-6{8`(JDzZGDJ6P7e(_!EpR$VvRDtE{3j&C^2; z;uL%(Xd^EUAd4?FflA?(6;;J2+QQ0}%Tl&3lld2LvITJlLGW)IIt&op4^a0Q>!1CQ~ zcNO@G7cJ18_7)>ne|wze6n|c=KwHq|oB%DfP$5%AkDE|;)kA!f*kl8%{=P2*^KA1X zUM&%JZ@Da_2hA;65;7)g`P(>M_Uwk7xtc>YVesPD?=M!3&(`ny9EuckHC~42;zkN- z1-v6?ktjFGp${(=6d7293d>uZPuE%St5mYGzo;UtaW~eRmHMX8v=YCkQ7QAJmRMcZ z_>#I0uH=RZt>V9o9?AN@?Z->}=d5TRD5uZ`TWc+X-ht1TfzV38#}84OzeFjltjsOa z&vzgE;pVj5j3?l{8g_Zk$Ys<@qODUIvbnk0x3_3B_f#pZ<3%1D8+$lr$AnFtV;k%3b8;iF z{;=1n@(><^q>D+w*hHkHA{|LR9`})sup$6T9o+ocUPmI(*m&wH1n=Iy3Zkg-(kBr+ z=TrrkdgGutx7t5GNtMDU9JVR>)?-3RNy$!zR&IHt-IN-W#K^JZ{g<8xSIP6En4j{m zSqO@j!;@0kbtLTcUSHd}kEx$(~5jeA}+Kr0NT{5un|h3S6C4mR?N{uQmFCIZZ26v#b&>hMh+!#ezZOeDE_ z_*Tnf<;S|sir8HJ&5X)kEWJIHw#eOS)&Vm6vI9T(dTz}>rs(W)(#Qeam9qM4rYx>r zMHJ&yO>EBB_8Dd)UZMc*xYzN$&f=mTdYjkDS8{Abj>0~0EU02j^# zSI@YoIXgxY%mIxxkndf`7(g)Y&a_VL#F+h9#2Hc_EE$E=cQh5h^?p?-)-N3SEvXc) zDQpXVr=eOddOtkinh{$%1}PTM_D|*C?u+hL8;kGGJ7UmIyeb`l9;GQ{ue=uzdAah) z7c?^ipIP4;Tur(<9Dltx1I_x^uhx}Uwj-K_{eHmM8I?ncA5w)VFpxWP|Yi2wSHRo(e`?2um;Dmz_n+jM0>Z_ z_ZJtot2*Erc`&`Im)71O@3ShGub*bBH5Cg&1&_^jorHzJ>XYE3T2_Cs1!wzTezOo= z4*gyWxXA0Mx7eW7Y>fVe_Y47;1kY>g(_!ObaE_m>w6_W5k5kL2-dagzBTN4YX$Frh zX~~pmL%?X)tJJ0MK1gdz62F(vfUEUK7TNc&u;pABYThD$Y&Y%e%N1)A1IK&>DI{k1 zU(9e9)1lFJ?+(8qk+|6W+WpC8pP%modX55W$DiThSPML`XPEFee-Au457X4P;#~jb zs7)92gZJx6k@O*p->AIrVEDE&&qc`PK4pu5joqE*x_wVb`!;L{Z4@}-!p?ta#F}c? zhNPmec^|z|T4X>OCYbl$ycneEic{S0n6+o_S#5F05WVk$RqpAx)>Cxe?)O$ZEU16W z?N{&kWN*LU@^u4{oFK#+SjhdwN=WrFR3c6%g}Mme{5np7e|$;Z#)f<+hDZ|Mc!JK) z*O%iUR5#ys^xLnAR?~XCJhW){^Zs;`5Mk?%bcwdtibT~iu!+^0AL{~;2b^-Z(&k7{ zh|L|RaD+4Ds`3WTgxb7kInHDzB*#tr0CgX3AaEpPr?-AO5BAB4Ji*5dJNdj|!2MX- z>Wd2f44&earHh7yc&iF*(1$u)~!J!ibqYuHkt83 zm}NRTQDUy+#(ksL3ME~GxbNK!8Vn3vn&B!#LIYv28v! zCox=F31nE0e(*YmwHU6R>|d0B>HV+woQI&aR8PwnkUPI{$F(zmRXh9m@T}0~SRFA{eOIWCvBj#tPuMw^dg*s10Cr*s2PKFdp-H zh*p_ERD)T#B&%c9r2A3|s7Ak79icCET{F@(ck@fVhyv1ful<5`+D+eY@~MGjKU?it z>~$#=FtnR+glum_(iLoP>nRFf$FFOd(6?V69w7h-2b3z$vqeRrs_d~y)py9oILBr| zy|bfPC^_WaVYDKR8WV@%dz~n2Pp8kT1D4*Y5qS$p5+MB?SEl}8YHFHT#NmsjLjU(? z5=CM}Qt-$tV$&W9G?k8mGWI0SKLa5l`NQl|#rVQl$VIAicG-EFl`GAvx&D`~I_J^k zv0c5kwRW62_zz=`zEv8D+_ako__xG2Y7Hx5ZC-65I_(VWVMj4*%Gg6uV@(f=kBmvgTv;^3| z{$2lw_j-1eXwNBvlGkadZcv{O46=Oh_}Lr#ZHngb@U4AG=$~x+Z^HaMlHFJW-4->p zbpF48{|R|)72e9Y+M_Pr`a>UzH252oX+ zk^sFoulH6`D%(4&HZSZ^r?|mRxm)q7ddW++#zQ+vj5Fi#hEp{5S5?*cd?cnIgknKc z!-)1?08xV1j@}LJW1=DPX-&}aOdXuIIpIU8Q4hKMGuP55D*JvQWuPz5%s48R$x=5z zjftRyE-5!UE@79kv&Xrs(+N19Nmd(2lVF*mdAbQjhHs%@yY)JAEf!FnNg4;LrNnvQ zA*VrBobDgSHN_I5J5cNge|BU}&?E1IOlX!h$Mas}iKEp}U9v{Wl5C0r(dJNyy>fV7 zjx@nA40?KtpQiJHfR7SpbVC2P>((SBTgRZIyX-+2h*^Q#Xadb@B=i6F=IP(w6k*E+ zY3k_c{rEZ&OgxS4bFhCLl%LOt;?Z>zm96;sb3@8-WJBTpfr^tolF};kq_7h4j~R^N z;r#!PsIWuQ-kx#=ypF#}ris4TLBc$Sdz-ydDGvcns9KsXU1Nu=NI5w&fQthOzwEFx0+~BPK$vrZ) zY|J3fpSgvw0AHyM0q6(X{l_6A)r0%sqv${)E>2FppW`(j-&N{yueW(9c_Bz#v%h}L zyM(3Xbr$xojQ$P>dZ!>Bi0yni|K#)#M!xkYCs)7Rv`c9226>giD&L_M2pYIH%8fob z8*7A`sO`!`%-s!`#9|<1%rlFdkEU!qLgK+H5I(xv=ON>fIF^OS1F$Gtv?H{Ah;ZO_ zNs_+m6XX7ZEwu6tN4$dJt*2mj*Fwk=$d)%qY$N%E()%O$093mQi#@9Lx&YDM!(Pn; zqf?aAp4xn{axY8YA2z56Xj4nse)*CgPrnn&W~_<9u2=P=)R2^PFC01Y%(PLg`9oj% ziohFz17fOAyFF2di@vc}b3WYo>_WQ!bqgZsWBD^u+GT_6rr5 z*~z=i83hp+e~fbGRsTZ$LriVs#}xWOcj1e3He=fs*}$;rU{N zcQp(9?0r0CzKKnt!8AvwdPr;9lhdC9=_kz}V?Q`3h&*+=6JOo`I*sC5D*sv9#!&J4 z#~zY>)l$<0U%4xwflZ?oSG~oN+`!X+dV8ReJ_yl5QU#)e4q0|05~8qZ zYm#fNv2!=pkt~!<->S`+7C7w_NZ0vg)fR2ortm{+o<^bq)JaDPt+OS1leqMWF6a~- ztbf3~C6`r~&w|y&<{+CYCijf4MB4Le8rUqSgCLr{5Mu+wFoAfv;ibT*a<9kk|7(+o zpO{a9d;fmG8Chku@7=J2(PM*GQuW8B9_59JKZG;V1 z0h^5%GmQ*QW2AJXQ2G)}q6ob$J`O&$t;BwE`)MC$HT+9>O)=aQ^!9c@TU;4i#VW@O zQZRU&@_kM`622UZI&In?w?dS%It zOToTi9=Y40`ZBfbD;Uo=(~%9XnGAzc+-1Mag~cp6BdNRqwC{422jrLT_9bB|G89p% z$O0OJW>8|2pBd1I>WOK7)LQPGsbooczbb=1p7#aaSyCq!Fw14ExDK}8bTL-{8kdq! zpx<%XYp?@p5Zn>bE||vH+uEANAjEOr?zMBe$eYIX)1HItws9APfunnx*;9zpQxdUX z`hHSYh>z&eNC%?!lD@$xxbkHvCQeOF`=Oj0U#cMNB63HVV^+6{)xS|3ICU0&9P|McNuOBhYUr-hQ@;v>T$teh>A6{k06jCVGm z02$67@(PcF9kh)^PRU`+J$|IDcOryf0$)dz0FMbO`kxO4TTK`!-FJRBE^`}&Vt3cW z#GrbN3fd=Zyp*i|qlVfie{eK%cKkIH@pKaA6CVfNCG$!BW>K+1UKm>3W8-VuX_ytz zlP=Q3jL5`cB)G_6;Ah`{fMjo;wIV1$1f>C12MCi*Nww-P$O8Fw^W^tMWob=);Kp_A z=b@OxF>@EhGay8bZfO0KTHO;~z;ep=JABm7viAsFbxUIh2#QL`q%9R$90u^j*dG+Nn)FDZRi&eMN z7|bXP8So1acW3?Fb;dL8*k8GEd}-Hb)}m4)L6PSk#gw25z^9^mHUGBlm(ZNqo!8tV zXCKP&W;ro)o{tJ?g;6uFdY0GP^~NKw-^11L)cm{@OYC zlcN!Dzhm=R5utYJ=<$4c>8IG^RMcs-!~?7#X3=A8OeoKB+&F7Iy6)iTU~u)cLwR#` zLO_J08KvVHRRcW@aYLo(uI8*Gdh0BkUZrd7)9(+?);uF)N2SFuzZTvwUv@)vGgqvC zj*#w%j9N>URSBho5f+vl{mD|`xBkt>O;q&Y!)|83(yufkk?Ep+k5mbZVs3L{)O-@m zLDGv?p)PcTQ))0&bGake8jZL3gIl}ftTxoq689}wQd(@A@9X+lg0?wO?XVeY^5ui5 zm^Ad0`^pC7;jQLKIFMJhPaDuOS*lxA0(cAjfmpNIu(Zx;a!0V;IvU^s|oRfo28qJe24! z$1;tVbTU6)+=7#`ktclyjDnVJpYAomd=D52P$ z*o8Loxt*{UNbkE>{?(}G=!--&bP#*qorSoYBwn*bYU@@7U-;jnX1?>%HGQ2# zH5zGJ73EoJ)ANB}-_iv7Hm(rJWL@&{a4@9)RAk~XIizM%Y{-KjAk3=C z7|8T6TLoYp%irP8BqC&?=DRWdGZo<5_$&uou>_sVOMJ;*>C6oD1>HO9zI6kd0BuvXsUUWK7Qv$cwk+ za5cVlysCJmFh*a2NWQiI{_v^-q9!1$#)j)@>2QdXMG7XISi^kL&;F-*A%Gzr1)c`dO==)x2%7IX*dHDdtK zk{H6gz5Xe#vrO#linAELzR&LB3i){mvYI>y<>l>J$wBWoktHHL@OHck6ev1tz;OR6n zNi)(S zehb?m#LArMX`a_I5w0=_ecaJ-e@6E0vCJEc4`vM;I|(3_RW-#~qKqCxdA%z%R!uVD zz`+uc$Mw8b0c$PyrBLQ2^JratO|x3i*mu)BqVmsDEhM$lShVT%eTdpFczNa%p$dIf zE4Q<&@h60Or_I~z%kTY(Getlv8{by!o2Fs|Ku?%YVL>sJ@5gc)^C68lr zLU0tEIzKx48z-LK&x7INBe(ctW+DgmY*%cwOD(?&>2JarWNfT!&S%452me4KcXm;f zNt1Wn{L&2H9z+ldJ*~cd!)Q+U^$T-pZVDkm?2cs~y>PXv$-~B9!MM3b4enVNO-uU? zXiS|@$bQ~Bxm&%{tfGyrk|H4T9wW$*4kSY4;>F{K>Jwgl^MBr2cJgOnx}^FA<8gKH z6DC9q7q+LOqDm>mzU{x!-u+`9_=&Ng#}J*H#Idrh3=3{7*#01-Cs zo|$u%#};hzTT1u-+dCMFBQmfhZJKw=&;=w3eJ{GA6`k@(iyc1jXijoUXJDif-{3%wY*OzeVxVP8>4zUXaQLGCbdM&?O-J zDg>BI8ML!lvL6PmuZ8YG#fG1hl9IPH8{3j~A1zoNF|ge4Z`9EVsiaV-=w)wv`8le8 zI>*lSS|pAL4JGwi4B*I)<~1}ju?-Pc*~Dux>e(u=qJCZSDPTH#e%@NxG*$GWkL(B2 zNZ?n9W~B4^66$Md!2_5VRlS}{nQ;!Dx6o;RNM8wm7wr;V2O*%Lp=k=z9EZ=76OKLI zUHD-`m+!lseDP;T1G?|Ab;v)Jn8ZFV}ls8 z0TAd!cU(M=k!5tau~_w~o`f`G!J)aSDNQsosjdc<;qveGH79-vcVA6=xg1_RTwfS3 zs-gVsLx?<^-{?1#OBA9<%4XhyUfRY8{j=Xwn?el%_QCX!g-p$TU!1%??Q6o8m7i+_ zoLL1sw!NNmChbK<4>JS1ZC@8}bc!zq_845;jj5AUZ2Xs)g}2bU7Igdc%K zqUGWQ)n%g`O>N==7qAv^-U8vxR2>cp;zu8eApOjRX{bTKpiK=rwZH7~zh|n$Z-HPV zDk%#o>nzyuntrJbB{H)}c@>;bfl5XyzsOTCslcXJU7Y0G@u|uFY?I&2kiH%tKod(} zz8{SxZ_tC+-4wCe)vL!Z)AOw9R{uT!Tj&7OMk@T@QFOS}A{;~pR=?((SLH&O_pQ{5iBwaG9P9}k)!)w3$|9U6qbxpXZ#rl}_12#B&Qw_D?*5;C`zSz}bt*?2yU8R$h&-ump#FK%5x zx4NfU8uRKrFTUv4x-y}rK8QGS53=y3*s0*hCP$sP)7t2b_|Cgu5mmk!ImL+xsupFz zk}ay-KSgjfb+*BH+uSgPAwiA9$<7%DcNoWx8$I)5iXwHxFvA>z+c;s@@Sh21LXlYr)HslXBVR-}$T9 zIncsFchKc11XOjCPH!nHzgMQn!uGB(mwuWhyL(DrB0_#3HltV3V{gy0>Wp?Ia7`w| zZlniW`9i?&0b`HTJP*068rZ(jn8TUHtI-po#?Z06f&VNjLSV>;(s_5b>f}8Vo`;@1 zw>VA|IQaD~b;=HEYXNn@A)*o+9VIiPyPUbF$waOYKIr})Mrr~*EB{c3Gkb$a{luXS z;+|1K*_+kyz%4w`g$Gd{309t@ZAuD#J#As~udm7L;j_ci(v%Tx*ct8){$t-s#!Yg- zlZ+&0s9qB-Tc)DgH?=txYzR~JF`r{dKDREQy%IZ@!U?qG4Str=N5DEeC{(+fCOJrG z^xt-B^zeA7XW&jm<&FXXn8t_=MSsu>q+8G~6bS~x%H3fn?#JtV0Huy#9; zUEZn1_(%-#EkBYEPfSB~gaSp#uf-_u#7MQa8k?e~PQ-Xpw-#W`IXlk&!nqnxlTT0S z&#-JbwK3{P5St-U;;iV2!4NH}wKNqaRd9xKNKlxH2Kl_c(nykM7Ho?;qgIWBBzV)$7?LGpj`j6i;RVLmqIiSjLvDt7_Wny|(I*(h8-=k{_ zT;k@?(7+g_jSMUe6|M<0*3nxfTKh~<8pi5=z-1iBl|YT{{#Kd%bY@>VwvByZpUIL- zcC~~jF7bfn_2NW?TTh58hAW+Q8nb$Bar6on@`B9=Jx@N=q@`Oz%&nYgtRGU&4vwis zy}9v%8%$Zr$3`&&c~ta)IZ=IOU!pZK;fP>ArBfFbe=>n16oM}r`a9jo=7Wu@Dlck} z=+gr+zx%`cM0yz{{a^B#PCaL;^>$t8qqcvA@+a@RAma!SDHSz-bUqG+dN6W!SqR77 z#kMJq>Uu`@_s0^|pO4e*IkhP_Kp@7ONYa7awKC-Byak+z?vqRBB*XfTF!Az7rlBy; z-u{m5GP{mpk36~wL_G87(~HR}wcZ|W;i;!;j>x`lLm&cd>(2aP@}8t0xM6?;^Uk8^(%?^|@|n3VT2@be+^UL-F{FV@ zaRrXtO;JgDD=vavI8*nIjizprAoOYbcj4vni4(=Z=9lO9#bWT0eUtFCG==j%0Xbu(CNw*KAjNACb4U)LT^n>u}2mqpw*T^y!@<3kjwUt>q)$WFs&%fT|ekCZ}x@BT5vL43UDXBN>W&D zb}T|*b~@2NBAQKwT`h7+S@_40hye8nS?wY986kt??vszMlv&PzI^*}2RiX#!aj%lC!>DJ z^X2TU`Mkw=QJVn(1}ojl(7oU6eybAJ1X}$yn%UQ>IXzDv_Wr8|wdMlC&alo)C_2qF z?<@TT5Ff8eC>)*pSy~$YQKuYEXOg(Oxtf0dOybjUP0y!ot;e^1?|q3yb=9$E>~)hA zVI9{YlJcH7u1^YIG*4i&J3o&OnV`O|z>Ks|ix$y`s4hEN2VINmq>qVJhJ8XG@IMjZ8?Gl)WWwfNokIpPQ?0k1=^ zYF!NXrn$;Eh*3R^3M&mn72|d8eNS>cZQV^J0;o|%u9h|+=htps0nU}ePnS|86|ZT) z+y$bwpb_-@p)99qmdTal*KO&v@_ZjfWMVY)KAC&W)n2*8_-}V?n?%?XEPf~X2Yq6V z5jka4^6hTpikMA+onssWoIJlp%`?>TqmY%Xmii|80JjOx$JIW^ zY8-e@f`}n02OuLTta z8^Ac|BjHHe24;_JZ58NkaEyKxYu}3-sNDoew)O8E`pAgErd?^GqBSjjkdj=bSBVK| zG}O~W9`1e`y%TV?$PelE@u-mpe-iTSyS&7J3l12cZSmM+wtMBV-K!?SPNCT3nGKUs zsB=Ao6ywo$s~P5q)#}x7oFZ5@(6a2G3f1X*KSfdu@TXRHLLn1-IkfPC3T+fmzy%7U zO+zOxfQZkSyoUwC#_b88%?C0l9z(e^)VYIzL@H1crFyEh8wT~A9a@h#n_HakO=Yjd zcDd)xT_w?$KFevmA^nc-_CDHUmC*}RJ<4?*-4F=fgf zI90sT;gFMl0ve8YbUuIaZd3KD5(HT9a_=AxoS#!GE{H7#_pA^nfN=l#olvbf@rs>x z*4M}AF6=Vw=!n=OBy24ro>THi;EOtoIjq+im=OFJi{{86k$k@pDzdB-SGVTzTu_giTByRgsi}nCqVG= zod6#z610--uP4@{#+=aC$ei2}q#^{$KJM{#?xMN=T&e2h+S{G~=jD zKKP6e+~T{!z!nfVoB`AX0l3t8KA(4@Q+ppu ztW+z!ZN!5mh?B`~&?fepEa|<(CR7d0F~_DnF7V|Bc_3;o?i-$WKzQ{#?NT{Y2^i$M zgni~7PT>dCz|}9SN;#gQmc+fJ0CWI8ma*-GfZ*wf2g#PWh;nzIcDIx8wFi7cLa7|D zvGHSyo_q(MIS_st%PFM-pg3B3?6JiJR8T43W*!}fcm*&n$#H9+BG)(n#H%vtSQ2(x z6qN<6`%bQF%jt&pqMQ_j=klL_ABYP}3YiSJru=|Pv?$=@ zkObjtT20g8jt701O(Ra;i4faAt^o~bTLzF&8zk+Oi~ZH?RHyoQ5XnE;wDG9?=SSYP zlSgEK$K0!2kleFgZ!gr^3QE}V^!QzaB3F~@Obn;v%WOCcA|m_s{R8EbYew7?lYx3J zafMz+S6lrDyAbICP^U%h)QKfs1;`nI+X|aZgTkFjzS2??WPxP?Zb4qz90@-}O zza!v2aFGKrt={Pmpcx2KX@ca|X7G>=WPpauQhOqt*rg=(Fn)lfTu`FxFmO~2w8Ynm z5Q1WcG+U7+m%A67{$z(NgSH`ORs0Tb>1#OHAFtfAKnS^Eks0jhj~5O4Qte9qGN29!quJWT5Dhs}a?Oa{>MqI~B@8tlNt;5+iZr{;@%VL6I) zWb3i+@5m*A<~uFsVDAgqXvG=qdjMR8w(P^u`)>}_bA5t*3$R&n(ZZEg&?(eG?JcNg%E!709$BNkWe&tEV@t!SM^V+6JNlObw zuKBReO@x2TgR$1w)a1BK)Pk$b*M2e~#F0wSKjzp!ggY0Xc#qXO;2fuXviWAhlW@MA zgg#n8&jv)%I(Rd@v&e`@R)9-~5kvY{--pIEijhH0b!42bsk+CM6R^F<+5A>}K8 zEia}8iM19`Pgxm7n2vg4^|&>Y!@@$4)@~^YYdziP{FI6SSJ=Oq7G^JI@ z&S_ZUsmjl3Y__NOfV_ck#^q(37=t=^fivKt@_nIV8I3d!o zm@2Q;7^)}YdZ#|Gg)wFUBam#nr>geuLj$>fHQD$g-lwDM?)G%+XHn|In&J2CF6s?c zGOn?arxsRTRqO2cT~v;HHo{sFvaKv2V5+%=uWlTK452clB$5&=vU9mMO4Y9wxcz4< zR26XEdHR37=?oedLoOd5*n@{dia4sO;^HG+NH8{zr1?|h- zM(9>Pq2UO^b6ium`|>+@Wh!E=(tIa7VN>lGqjH2w7BslQ9rBFZslgiUyREbaHeF5j z31w62$);;&bH5Rqs3ncpbM&a{6F?{{gqAf!!|??9Wr*;~8LXq$9r@U+YrBR+^q7?R zO5NHf$%nS$P5|;z79_tbt_n$u#mWdU`?c7FdTG);vGYiWpuL=b27006c$?tGA)SY# zFxH3ZA(prS#RESt89*t3)m`wQ+g}^bW>FT}hJ1zSoID-C?hIf}ogrS@uRcFZBS4m` z1!Z@-Sbblta|+7_$+W8|knM%U6p;``^G|)LD?k`^uzFN+_herNCK88hr&nUz6R-9f zVeD@S4Udt!|IJV{bp{72OWbD0(tev@lwhWMte6?MWg7JHAD;w1Y(@}iu*j|WrL3(P z8yb)T;b_U}Ya{iQnnPOdjU0I^PMvSszS`(OzG&uwkFMbu85ekrv`rhtRWtggL=4yN z9EPKDB#Q-7`VcxyNYE^tL3@8O#=>9vLGU5!C(ixj1ps?1!`9IwA?n)cu^QL3jykad zvRX1TZ%ie6N~O1D9XC5AmU{jR!whDd*pwu_OFHRI>H{Gj?1CDEn$XVBng{+iyXh9@ zMisH>^`aUwXUpz6{x13ql&MO7*Yg3m*nROLh4n15zv-+1+ZbJk=Z0%iDz z6WkDjl+xdWh0Cjkuf<%RT3=Od8-I)~B1Nq#W1=VV1Gi|C;wLNvLC(|g&yFu~qgE9S ze5W(qmnOw3i|CG~*2L>*e{@>xEzf72Uxv~xJ(butBOSa#`2-V}tOA)!Lw~M3ZvelCwqSKV z!P-2KWGyz^Ve_Oi)*d33Gf&OSVvMygsqjaJxSICq zLa>b*$EqPU2lvUDOwrFTC)cwgWFhx$#eS1wuh1V#?lSzLpL+4gowyqyF?Z;9hk`mD zlV-S_A3VHV4VmcNca zAJV|1aM0rk;4?+4?>O#&hjjK?{BF?{-4UBl=#<)*c)dJB@?1gGHCXxIkWW4RmN4S9 z<@5V*oTM~R>gchQ2e0~VK|uQdK=q+ znezLITtmtq!Zoh3DQEQ8Oy(`7uXKS9WS`h-SnQPas~F7o_sj@JtQ|RJR>+#fD(iTs|=e!bzv)B95Hi@;)6t z<$*lL1MX;z*8zBr86S#h@!)FS>Acu(&x!$27?%%o>!YpA7Y_xk~g?af1;sbCxjbm(2Tc7rVB0q!+7rA2&5OI}pdF9IauCklGDnO0uROc$&FB>Ongoi(?cL|v=bPbce^8}4V(rU{9K?4RemMuW)+K%10G1dGCHsA%vV(%W1@5va zQ4?&tk1ayT26=BfiQ%Ui7Rlg@t-z>@5Y4#I&2|oRpg~KXgF4|l zYm%?Q)rkN5beIkF8PA7iUAZ?w% z(=FSP{a7c&xF)OU-3r8l^~Lnd#p5OU50*{w+rM=redTcaa&7n4ogcEe+GJ+pyXCg zd?)O&5v>F@b(i{dRldrTi}mLofnKyg&B*Tm=Q!T~*`qCkko1LZxy{rXd)>vC+GlZF zyh3tqBH)g<1Pyw!eSUQ7UR2|^e%h{qI~^(lbDh&jC?8KYL0{*p!Z*jKkWV1l;DHd0 zaHwgqmI2@m4P+glC^lo+z0;p8`Ah{a3vtL2Q|Z!6NA@Nh6oi?^{i%VFg|b<`y`IeO zZU0STqmSfP4Dt`c64RHX<&zZlSDuFQ5S<*T%sRWVt-XX$5AIvT$a?4kp?b9|oA6-PphWRS*;4BoZL6lt4jpU1e`H&E-*%1-~gQgdC!luK8 z$I}#8p1~g>*0zxP8y!;RnvHN$gIYu9QE|(YjV4$06L805+L0iRsf<11xuDDXkV86apX zYq6vitt@S$A{um2slgFC>6S01!d!vwb@Z-hsev6cZ5;ai1|eXYB!rw#+SEXI>QS$C z(7F*szta7hL#EVGI}FzDf)#GD?^7?d*Y{!zO0&6sF64aUmCAOY#dg=NP1#MuyW6KW z8Q*)^Ur(1?(Y|6P870}ZT^+sReg_OKKU)5-cxnaQ79bSjOxiiW=_k3 zFw{OwzSeoD$0cO>jmZs@{1CtDgUg0_X_r}yYq+8ncBgIsnj~0{>&rw~G$7;S1iM)2 z7{jGg^M0>V9P!lqs+9#X@V4zbIP#av@DVUkW;20rzjvrWeg^J_E_9Ecxx55KoGcQV z7j+ZU8qejK8^Fq1U?Eh-SdB2LNC=491RnA79rG1DlLc>V@}Qx62P6{TZ*q})NN4yx&0Z@*+FfW3V?ML4)!hhVnJx8*8S;;T@$NZav_FE zB@RMcwUUkX8}pG((|jO}yC=4g=~G~oqluKR$h8o>vz!RNyYD46NF-;1@3zdQnjU!G zHHcW$*WFc#Jv7yEJ<0M`M?fILWrzpX%dzGflDR>_d%$V8lVn(T3q=H|-Xv(ofhG@8 zx&6Kl+zjP%ILm5G2v}~tSNJ&Xaen~sJ zpiukfK-9My*F7wF5(f4MhcyfX0|Qs*gD8N|S3noP500zrSc$dEnIJgp8#e6az8k%@ zwbeE8zvdlDzn-g#Z>p(IxydNtgsMY-e{#O_YwMOL8}c4$?dB>lV%3MVV>M>D@=TyW z=L>bLxE+%5O={R>=ptzU;G-76POP<%14{=L>!o}A+tfP%GQ&%>z}VB;r3U==DAK~3 zcD9jd+07_Ylw6b2b<=NSa~p&M+l#?55cpggSEja?iv@}z(mKqIHt;yH?ie}Ggi2?N z>vak7rcUH-Hx5I!CQ7x{3N)$w_};F-+37pdg}X|>9-jrl&VC?8Y1iFtcNYs5uzD=G zQiM!_KfM-Mhsw}$M%{jLBSZUbXtW@BAN`D^b`m_Y#8zS5&6Nu7ynwd8Cnco zf9PJi^WCWc1r1F}pw`!~{8N~{jwr252+6 z2{%PTmj$4Qr#MbTc!sz0ufvO3F=o8%$G558SSnXf+fO7N>jJ1$g??c|Rhksm*!*bv zdl&I_7{axh-`zGDIU+y4)ky?xD@IVg9nQ05!TU#EXX<`j$E0O`o^e3cwf!2UgX75| z^_-dYA;Y^KYT!wr{EqEeK-v`5aTsG{Thv)TN#!0YM)Qxo{=o(h`3VV$!0)dNLL8YG zt&{%qgWkYrKvz!>zvE@p{vT}Ba(~`#Q6%lhJ1?YeOSBIb+eSr9FJ{OYo~v{5!p z?9v>Ghz^NEA!UZJRuS>#c&U;XmXYYCPCc0T4z^wo>Bwg?X8V)P_2NGJCsJm)H#t#* zBZt~LKOmi1V47~tsN=K^2kG`?&7e6dkOgg5V9b#qpprFl>CmPR9Hc@$9!I9bvi0rg ziP-ZX_i@8p)+%f-UKVpiQI^Q>*XSiff8y1G;9ls%J-J1cU5IgX8m74OSzUvK3b*5> z9PYAuE^bnwgCu zeG&GCqhK_$>)q(__YMPEXK5G4%g~sfzw0o_Wu5mw{gKJwdv<29Kln6+xI|UUnSK~q z-@HSQB8uUh{J{v#habtnK;tQEQVfPvb!!{~=U8#l-hN_Z79Y+2Ju<@Lcey3U&BK%b zNss8+&bWPJ?Dy}mVQT-BE-ouu$4;#0yNigRAc-f~OtR*~N+Ev#-#yY9uYYj)0>_SC z2k~ytv@`;eknyP%xSQ^P3ZZr(Wjz0HYkqShexH{07HhYgbgD1x6BSzRpVlp9Rx2cS%vJi{aN|DSFIPA%PUxaFZM`ccPmiyKr|qb(k9Z|{_W_L{t@2kLH03W~s_X$?i__zXr4 zMo*H^k)l02{LL=EZ08bIW2aC|dY2v?h6QJGtaogr+J_`jaB(Tg&z6k4U64&c*PImd z3%ons_7^r0dO#3z*Zul|*{@`#nZW-Z>?x-2G2kYAdA}!;@8M;<(OK%tLC0+r0>Pib z6uhe!^C48<*BASF6l$xVGz+{Uer+@IBN&^5In{RJFgQ|ukuFR$MN%=Mw97Ldbrh}z zfn|_S6;Bp|TlhRVHLnC}X=@;}@)feACcEMsUB^XWNPXn1uU#l!q!CFiCR7u3(5Rxe z%>42@KIH1O16Efkc`NkInt}tN?hv%vX)aphqqYl5gS0P`smc*v2kaVP5bz8W{-KYni*`J)`6}M%|exk)-k~O5Wp6RJHO1Un3{A*dc z&YO{u@gonRTh8=`jHu5Eu6?_@G7`3=w5DUL#LcPZMB^CS*cr|tEVQ~En0@{{kgORC z+JJ|YWxoB`pZiIu2obKNAyzDt>U2EfWdL)OXgBsRk=gj!jP^E)+^m{uN4GF1+X zoEB+=sJqD@sX=AyldNXX;Vjy_L;^5PkX?>2Z4m~cx~z!EZEg?92%Q^|Q48N3XdU)Ikb`&2{%h2?7agwlZaJwEq7~!fDs`(cu0_gyeA22h>-TwZhatYM4GQcD zx!=HsKbKy1*6(z2D&)35^0YJ%QEa)H?h3w+QF*R)u?(ZnhUJv0ZBy4e;0c^gWQ$D51?jCO>uA{m>79}3irk1L0 zU$ngTbQgXBNMEf_+F~jpoh=3|T}Qas6hVCi&FF$I7E3QRu@wUK2{`J4(QCESH!ksb zg{)U8g5X_c$aIEy^teNY%+#fAouJq4b~r}L!N_C!6ZXMJ`Gr;ziJ|Z!(9oTml3`hH zg$f5xWgm2sW0@66sjbb zuY08m7Els6U&`fyC+@+gSwnA67A6e3CxAAg#lI2U(6lsXS!H`Wq2B1ceL;ss| zaamfJhuw?{n+Wj}2iiY8Q$nPt`Ykhktu)6%ZgOf(ah4W_d8vA8wOmVNikPX&N6CqD zzBV0-n3GeuU>8T^#b4EZJ>|Aq$fe-$@h`}Qd5B#UApdRNj?_L&ccXhD$6YJ0FYNZqJbU1i( z0Dg|Q50hlo+?Rw0W^FxryjMiM*HKO#^fXLT=aO})n~m~b_zg- z2ijryujp^>6<1ZEQTuHM32^oVUI%Nq;b`{<{DR2DC#1+An0gCI>!RzA{Ze|R?&_AY zF2A^rz*v*!qUVjrjy;(YcRK(C{hkhnuJQk*mR^jl(AVijR9EW4GFu`^ulX?+u(NZ3 zP!f{jQ+o{5LlBIV;h-gRMhJquM9EiBek>nUlIJYm<_$ z)hO|AH&ePHsnwhZpqoYA>joa>PepH%$dZpQ`kT1Af(3`a3@bq@Hx~Ed znNJ;&rcSoR_P*vf(Y4ShJQGXehk6f`(YihOe)Q?aa|sCP;_G>vx>~4{L~b7sKl^*a z`>8>r@Q8@5xuaQv@j9^xnPLCM__G?16EXpHO|mdk%g%*`ax`zD^XUiA{_xwBW?Tu* zCV1vOr(Tu1XvH9hQW{6nX6ireX%vNyR&@MpYk!j<3fuhzeUA2gp$O5rUx$|XgS!Y{ z#K4NElC+B_P~Psp?@}m6N2Z$LF8JfU|BFM+95_gyZC6HQ>>I&w`e^4h=o!%fM}3pQ zktpUM`Jl%Etg4LC4Cw$Qw0hVF2J8Rl(I8d`pjB%#%tSid zIzsURA&$;$IX zY_kU5BZa6*xX`QL3FX4zSxAjKsMi9bI_S$><}$|@75KW$FJ>a*U!?ET{SjGdJPjTy zZ7WfKb`vO%TY3D5ysE-zzp+c=B3G!aR2G_u?Tt|oTQIo4#6rX9$M3jknA`E>Y##v2VLgzJX^Xb zP#*){o^Asr7B8j);PJ&h=T_nuEWBs2?r;6s@C0J#fA5@<&+}8m zqK8uBM>Lbvw3NQ^ILiIT04b?{=be4r7MGnj%Bsq*l^FT>&=nOGZ9;xg|gZE)1--{DB7; z<#!f-s{bDxop&@Feiz13N~`v2jcRGBT~&Le)Tmv1@2b7`Oi{I|)@WMXra z@K0G;W&e6o5p6?E{%+mH+xz|y_t1VQ=kP=1+m+17SUPTpSBThG71gEpmM2x0VKS_s zD*pCx2j*?|M~|ZGPKAH1{VL5NAC8&GoEXfwx5bHfD*I4bm1h@j`Mh=ad9!E48vv;O zm1olYu?6aLO1JA;_PFK1k}^j7kv9WBLzOFKsU|Q~?UDE;7k8aLXAxg-t`GU+f$67IP#;d0pm z441coZF(7$o(Zpp7F_*)oz;`)eB~9oo&H~a8UZ~tO$d1jzANS!+|y^3sE#Gf2}a=J zni(LZjA{gEss`L7_&>qba%OE!b*wBQdFtZgb(I;I5pNgW&C%Mk7PIIiW)iZ9#Czl( z&a?XYPNA5|T89`AwkG+Kf6^-rb=(V^F8!44Yv$fGJe3H*61}$S*68J{GA*qjdaXSP zdgJ9KTvc8XDUc=J`)@woX&T&6$uf~Gd8gV4>d4D#i6_kd3UZ%o@ZM2dY;)nRvTDf) z$4(FDy?-B-GSu(Yf$I*jDPNfMRRaP6*)o32rlvJ-aMfn?FGWGzyVvv#0ueXuriRdcLO1EOe*w|P~#R4EX<%Gs$FT|a~ z9FO<%*Wr76KT>OA;eUiiO7k7&|IN>RjDI_!?g3iBDpg~Ul&!^0DNjn9Fht8(=4#A% z7E37fc)#s#)Z3_KQS)iU^HldX4VQkZuWfTHRpUVNmDVNgpzA=E9$Q-D-}HK7EX-oM zVL8MRHgj>yuABGxNrDDQ17smJ@*C+2vBR5;4&t;)3iH2sW7`QN97~ymMEecg1b*k( zLWL<~mGkKcPiAP{{w`ES;1R<8-=1SXNh}-0hz;xM%?^c;F6;VTG8Y~PJ~*<$BYSl^ zdVCttbi~=7?$oi$?#;`~rYhF=(JA>=k^37rkXClnVU=m*ANP^5v8F_-o$%S4&m{Ms z^*kr6LOmS_u5<&nJ9I70vdw(c#1`?`^2tU$3*m|Eq^4~v=h)b|U-(fQR zW=r>p2~zgy?qw8^K)zLA$v-ON5Ub4!G9thFZ^PT*8xSB_6XN^V`L%;{_a78_(tm#C z*QL#wHPMc*6>@~cNgw1$YCLjrb&h1<%jjPXSi5)N`-Z#f$p&WHZg`^-gufg)`I_oI zR1lOs^oY$faYfPx$zNsB!FbdGuPG`Fq$d84^vD*aS}in9HoF?mAIWG`V;Q~BEQXgR z`D8BEF;gp{Kb2iiF@t4wP~?#+%cp1^u{_`@Nw!4Lx5$Tqf~?#v!U_bG!xx8b=d~_y z%2vF2X@=-k`#5_fgUqKGpGLe-I-x%W#<>S6Nn-mRi(DE^$Xv%?V{+{rQaJ`cmh$}( zY5hp|bFe@h^;;BWH3HzdS zWGtDS-Rl)RFdA?9R(3hp!k-~T7t0d&u7%*hb5A8h1N@n5(>IHWTDulM7_MN(_r91f86`rP4h~Wg>nH zxZblsRS`)wC>-lwj?l85KHxP^w}Ww?9Rsst{%u~3Re%$GIvT~m@{HN8#EW&v9@ z-`YSe^BAP+NG#nka_(YZTVnubI`|bnrgni#Fe8}MA9(ue4%MWd-zPmcp;dV1jR>`R zH2d7(MlmCavhByu31AFeCFVSRBlfXJ8OCI&r_vSQf8y2=6oX{hj|^#hC}}`^NX&On zVeNa=47w}0r_mUo&3^)o7o9KHbR0bjG_^KWSNQ_;L%cn|AN{9W+ex3Q=4XDnXqmJ$ za=FPeaHmP!dh#ge^}i7ceJ@&HYZ!X{j-$)*Cw@eL{KO;&kFkL?@yyE#cm(>mIA8Z+ zTkvItKbFd=;#scrF#MMPK6win@%NX`55%1`qBjvw3nWKB7r{R^f^m$U{|)jLm+461 zH@@sF?2YqpV*rJe7)V|)?fuLm0OH))jDzAU;roYeUk(T)L5lKPRg=k~TJl0-DG#4V z>4?tH&;Oo)&d%Neb>p=aJSX@(Wz*||W5jMCof^eun1 z+=!C@dY6zR9CHT0GKJfMse8O{*py4V&{)#tU)_((@?_p5_b^3{JT$rf3&|_d`B0ND z|617p!MhK@JUJgmx$6^7=W{J|W(7I8fzjaeAJY)qv;nmb#shU>a+v@zr_pt>RI z|6OnRnJJaG_0OmJpE(uay}UkGJ8`pqpG5y+sXkuh-ctTJDR5ZCllyOcuX^}EU@bn$V7AHQS*_%kSVs8v>XlsnibVj-&mq6AEwqhfE%3nY zzC>VzLNc5?&R2k#XDZ154!bS`@t5#(sF71+Jd4#=$gMT_Bw%q8)_ubqiVo;jngz`A z{E!=oVkUc{4>BQDQqNdSwrKa|(L^b(e=4TosFPMcizcjfU+Ywr*Gqi8HS6cae{$=E z$SGd5gI(`EVx`NLP87SvGot$gx-nHrkO#vU1AHjx3v0B_oknZBWF5K2Ft@+olPCw8 zVR*vqeapD>lzb*+^wMLZn1@e?3X&f_NgD3F!jfK`b%voA9@Xisy!FIG`83Vd%kCf} zzz~J+_By#T>&r{?B%nS2_-r41u8byZwsaDoZWykJOYtAveXvw7DzPW)6$ zdjO$bKKmQELge_!U?Box)#UBzWx@`+eDOY=E@oW)34L6B;D&a(uas-NUOSWux@HT> zQ?{KSTF*3kne&yn9>~r2aRSH_X=EBwY+_g+@ZTT{#y;*;UGJfANp2p+a#cmM7bq1W-uie-eu&BE_8OOvdXN6y%(9cKYeA|$nQc&n)I-tp ze=HvO6oIdHMPCT%9qmRxQ6?^{5kdyw}59!DNWz$&CGeYm9{V(OZz))AcxZJ`zcXe zaCKXr#Q7(xaWHh0TR3y>$ssCZbwPg~J7~mS0GV-cy&oJ-L6y94;^|DkG{{ zh+U{Ek36e?b?1HmWlE|InPR=KvDn8|S=p1`820`K*v%KAmx(aD`zLs${@y&Bp017% zG1|GJ(y8uViHa4>Z?A2k@X}{yMq7s4JB&@*|G`n$)ngwwC&URH4(Wni4}3oTPcTM( zvi8y*AK;$pqi7h9qH)i6i!Swzxf^?a)yL@pr2rcj$2TeItC03*oY{mFxnCMde9;DC zP~Ucyp?!;suQVhur>ya6_v-1imkgNe%bl4tS0u3b1gu=MM^R|?8F)%j*4yFoFrjbG zrO4|m{mOb(3}MB&{R=~sbhumy=I#mWL*U|*qwA21miGnG0IwyS z1;c}G+~oKFW)Am0RtawEC-W7ii(<;cMda3RxD%Cq@13FGR=T-N+$Zsp_V0+3o(Un^Cl!FI-N&UOd z$Vhvm=u<;;sNnFZm-4onYzE)z=JTZ5+ZWdmFObREF0V`YeLx73MVgWX1=W_@a8{YN z#g~XYwf;0ARwCi&>(AWNqcIwBC+0<6r=I+$Kjo?~_+NY$xb&OT5t`nOmE0fc|7`bp z>+c=cMM`f2Hfe17!OG|KkJYjog&)ozCJZ{I85kI(qq`U*1@Sbyv4kaR-ok^4KA#+;}jIN z%2`6EYowQUJn18D(d+tVDlvqf!x!|+P!E{;rGI=$U!%N+#n6amIABnAe`aTletTt4 zZ#pQh-EF}-;I}a;@4p3vA5xpk6e7$zL|J;eYL0LY$C^>wtu?Y> zpN2Y7FJ+s)26ZS0+o7Yte@R1R>|**iV#Tdkw;m2J(ru6d zPyVuiOM|qvX^Ts_wDUH*MDyb9us+bctN zPP=>5F9Hcm=>(;fa5iXtsbJHOUe^bCFTS?EesucJN>G|j(b5KM19Z(A)>A@jIh*3_ z{kx^|HJBTH{^8e#qmsBRM?Sul#q*#7j!o@tax$gl^*JmG;IwrMV}}3;CPv(fjIx8~ z#20_see6IjowGwIgAqyMj?U460~5RWRgH3`h{{W@nOdJ~{O#z}F%VZkBXmo~g%yW9 z++=>2z)`MunASi*LpN#MX(zwiZ07MB6#AU&jm1yNO_jazmbF((qt*TVO8m_mC^*o8 z_0rgPK0&Da!@srbJP!`D`YX%uC41ik0db|-ZsY5Xv^IDiFrxeV?7cq0!CiB@f2)@V zh2`lo%H}U|_{!nu(BOv)nAkeAdDVGqv22m?NXqHeW9)lBaTZN5+eZZH0bRG0Rrr}7 z%ef7tw(Ik2*=$RGoF0iM>!e72?X1$XNwibH^^{yzCKDEVL1P*^u{pZcL-q|W@S7cg zO=%1`etiDZXZP=)U9_&Lx4X%9C_FjG_un>;16t(c2Pp7RXI8b&8@=Q|VKxfIIq@;` zNq>g_&9!qi<@m?fl;EWQ^7Zy#cF>>@Pmh zOQs2>1je5+oXYM?wi6Wg0u6IyBm6USy{Xo~Q#eq~qYFdX^^NU{HFaq4ls$C4vV_id zRchVW>T!tHP7{qb@9{R~sNJt*%t_BF#<2avL2E0jgk@h)Xj#8IIr`E=21$mwWzznE zx3H@vk@x#BsUO9ToF7h#CRm1i?it?dcLHV3FOog6)_gb`OP+%!Jr!Gz0Bisw*ys{% zF9Ryv7g^ZIa4c?D#~WBb>y!+T5NYvZh(GJ>N`!`=&95!s2%#{bl!i31BI}(!Zqcji z`G-_3@45uGg~r>ATwrtVFRcWMrCV3d%>4x{pOTieJ&eX}NlzqiFuQ%rfZm2tpu(b8 zQ6iC-=Yf7jMXUNaS~WWIL3!CQt3}=fy5A4x2qXoiSk~$zA_L?!%Ab^um_1R&zz})5 zqntK@xRuk{@YlA;;Yn?3%p^!5GfpZcG>N+hcZ`w)VJbY6xGRpJuysO5X)_;A$ z+>1nDoYlVO?Z9PZ(fa|d7o|~M$mN5JsVFO-wJ|3zRziC9E<4h+91Q8J;Q&+3;m)N7 zho82m=Dt4@vV16>^IV^Hd#2HoYj&TH)6knA2K}3h4Gg$x+$S1_*7#(YEZV`5+yKl^ z)nk@~*M0aM{r4}Dyn|Vs$&?*uqkM@H@0kdj@c}}vkJ$@>*V8FE`ehL^v@!5cnaQ-yAkfIv&H(^`fn1$S#@P?bwg~TosjSo!>l- zMo5pq5XF73qKV>6b6WZb>{6anOL8h!)$QwjYNw+xITa__t6Op|gKq%4B88_atfQ|1 zW_HJCe7}_Bay@dbwDLaCB)M1#$R2ktUllnS16o)0C9pEd)*X&0@8F|orh2%2(`Nc- zX+rNiceR=t57Hp?AOXg7iL>f^a)PY~_N#S#lU7%2KADm#C#ZIbfDc=pVIk^0|B%<8 zCS0|}Un?ua_l%fM{nIJaotP9_ ztxE2_?K}CS|Nhuw)2R`>yMUIM0ja&4+YrzdeC0mz=_NZIsPj_W8*AX+LU}383yBfQ zV>p0Kfa^gGw({L~5$%*nqr~S452Md>7f*F}4h+ic7&l{#aoaL0j0?$j&mnGtmh_Vf zoh%1iR+3I$DC5PtW)Rb`I?s?!D|Y;#^AfbOWo#Dlw*i(1%pre+3``%c1^#W8dy~q4 z@c~}q3Ng=pOVp(5%g1|x8VO9_)I-S$z+uujzI0#st+sRMBu+LMb0^q=8@>XJ zWTB_gY<`SSAKxzD!GFt~ksp$Ga{^Xuh!cNIHM+0fxPn)}UZc8WPJSt;blloA%c3sJ z-k*{XDsEhB-5rN*4@N8}uMMxhl??tm=*Z*fqvlFiP1g2ksV>9}3UN<Pr8GmM7>e;H;@WFgq*qZF1B$>N-NN zc%bF1Zt}|Ggq&25=NNjH3O&Bds(5I$u#rh*(1lSBQLW0)?W z5k;w;IUH>3qN>iw^S=ogR@

{{GybhMtY%MF`DA_&)V*r36tsra|SaF7^!`t!^k< zJwHXYfQ?|NqeXbj(Wctd#4)m{OG#UIU>qCBI?^f z9e57pjjqlwKiB%=KjEV@F=6s8jl<9th%jIDGfDh8NBenm9fSF^cvEK^ zKblgm7EvNWuuWmsidFA@`xrWEf!kd7=rW3n<-sXWJwAvFdWO0^Z?K3u`@u&-Z@_vr zc$+2q{xNQFWe3bhteH+vr0)VYgE}kOr7z8n!*Q=n`6O_Eyu5cCt|oC^{`gwG&j|WR zNqM)A1msn7&^N8Z$&_U}IHqzIE4g?pU1MN3$-?fj{NZz?aZ)}@4Op;@Wp+Rk&R@df z-YOTX_)^DMC3&V~JS!(`qg@7jItYfxl53eAzWx=L(Bw19oFLu(uHUa64?Q}L)i(ny zF^AqwctO59DNgCh&2Q13R%6;wa-j1ttHo86BMWByS*a50(b43cxVQmtEE@*iq+A35 zu1WvHQ`Lt_GaxiZ`ZyrGEIhX+GA-U#5;Gq2gM10@p?)W~Rpwr)oO1PHD>+knV?W+; zK%|cEFbM&VP;kv>S|LZKx|~{HpzubeWPYi6BvJ+UoQ%liQ){+UMODs#UE@h?;co(tY=z3tnjRm`L{e7yBHG9&;pP z`wKz`0G(;kdv)%ZdPM1y2jeihBvGzKStI;U--W!j5_fjv_w@ZHT z8rXodzM1%1%-a7eVzgMk4VE+w|Jsdv_*y@%uQA!MJzO-xQ@cKhgH3%8I$h z=je`NLQ}CuHIs{{>`)+sN#1HMP`pX>M@qq+^2&#j=b1N3Q~f}u;S^bHv?UMhSo!wP zxkKCILL|3sDBbgnR9ZXLK~&#S;ld8eWQWM?CqALYN^L+sRl-Fs7~7(gzjkXd31Dc- zU17Ga7(WLj{W*mt;9Ky2*~bmLIrhY~uzOo&j5Xi;3P#_p6HVi8Ltt#v%%Q2|;vP$z zzS0esA%_c#(^nf1&!Q0qiYE7p^>!(|;L=Pp6dDr*cgUOegIKzRf7JOhI}u8_J6Ard ze7!#5p3}G0=#MaH^n*4(Ir}kqm+>*9kb7~47h&KLKm3?ex+mLtQHxY2uksZXX4WG3 zj+>1_`kdpmd&D1$Qs0jx7bL?D>G-j_UE&i0l?Lvo)LE@V;|rCGOj>IZ?^+&0n>|V~ z=$Pya`Q*s9>rDnXk0{Q)z|}OT&w7r>-C>QKSt5c1mLyE$xx#i+u}@#^95z8zQf@7F# zSBT&Zn*DZa&e9a`Y+9nKk(^i0{+l9eIfky6lnvc}r+zzjoKvEmrR4*k5Jn1E1n0(e zo7P%K__&@0#Yx|7-UyqGPsj-9Oc8OIcs2gC@2>PU5xK@I!m-QpRhF|U!V3~=qwP}{ zK@^nSxjAr>_gK+j71>o@k`xlf?mz7f0RMSN9~@M1?e7O z2EdG=K5@Xc+8?h)6zkHB#Zppbt#%Bhpmd|tuMF7o!#m%m!gcIa<7(p4&yShB{#-p( zO*7(Fm&E@nQ`B=Sjm8*8Cx^9LD1v(nfb%zZn@i=x#v_854RQhvK1T2Nl|z&)xcL~< z*~_v|DO!w@Gld+VF(41#eAQ`tGD{0;6j@WEXpOJQEhZ@GI(=r6UG6)AxXHBGDHsO$ z;jXWo71Pm%ez$zwkyER=)J*oj&lF^6qml7aA2(%wkGA>m0yHh;TVew_y=eXMIrc6^ z&e(LL?-M_9w;p1M#l>+NOEt2z(F0^@^qZe)TNcVOyF^Snwcz;!D~4$&FL{X-`to*^ zcDoNYkKn(eUZ)IW4{sHw)-!foZ1;o4lJNU0s{BiQ309@uM?DDro3 zb*FjuP-3mi!Q=FJwd3lcS#j+wt!2sVAfHjVf+EUOCMcFM$?jc&%ep9fAIu?`$u5vY3 z*0-9}K^FBv;s@U*+0C!Gq8TPs3;O(HYIu>lZ$JZ!9 zjm?j;1y+h+8-I_{EV;=81qR=r-oOPvBsq6eV(j|@$EM2{V+FItQLyDNhEgw1h^qUV5umpt3rEi(tpo(`wd{qXgJ$1lN;OEJf^TWEgU|c0jY*t^S}%wAfU`cCYz zaPs?&7h=iHn->5<@9{_{gGL5i((KKIl#5`sd0nI+IJBue`t|ZV;m5<((B@hCr=KYw zJS$m8QUPxRp;iQo%LZ|W-+nBe{aJA1vW+3nF!DMW7oWw3y)6-8g<8f-cUBW}UVE0R zCbx&6a{>}y{H4(x%M=nRPtcqWZ&~#gp+K;|;%S*J(G+qnNmnp)mZGT7A6&f(M4z7_ zK=>WMB0Pai-<Rx;_6;Hc^SHDBvsfR{~BDTm~A~YX7bBzSh&cn?$^3!iIE4oX{*IGstJ>t8TllG~|< zzl^MrVakm3lpY2oji17z{{Mc*Qr0jv4Xel55hk#~@bdZ8oCCAaBB4z1g)z0o0NP(` zEk{#Nrv2-rNTH_u<_qfPRZUs<`LsGG7k;(cGLFK}fgU9v@+NagRPK~MLp47SGJ4mc z-6<4)>Ysz43UFf4yqK%{*^up6G@Y+G^u{2nGSwnIm=?7sBa16mLG*xMM5>c%Fc z>hj!USDEh9#lnle<8X)j=RRQ~S~&tNMK2t*B=373uNnF-uy}Mj5$|PrboSy8DdGxN zlDzyvZ}C;%s5pLR0dv>ziR`7N?%TE4&w6K=+AA?{wv!vD z@qR*692Q+7NFP9I-myE{&U&lU&(n#!Zph2B`^$8M`T-}C#a>5z$ZuV1ZjWh30{_kN z5EBqriIiFzl&mO%H>xLMV;M`T(RU>e)sJu{(r7rW79DWg3$OHMF<@FXMbE}!oRTm! zS@x-C89&mb*3!IA4x<4)N|6P0KPk>Q_G@`I4$+ssX<6P}BxGzT#wR?oFIdLY-Vv%v zk@8pR3UOp6ut06%uZKKT+Q1Pzvofkj82yv@=T9F4m_BKX_sE zF`b^e@oO#zr8Ego=q9}2i+`?eX}U~MQgm}wI7o)EuBW+FC#TY>R@K?XOT%O735 zSv1~xWhpAANwj1(&8_@08cnJBHms|lrD#@{tI!6nJ_lFGVEwEtaRgP-k|AMW78NA@JN3?YX5gn5o`P zy___;^>aPg(#Rsn{!*4Sl}7fcnnv-1;(e*`jy+K9=yKt zdOKW7M%#ca{Vg(f*<5yg7vNTFCAE%p(EfDaxp5>^$p-lH>8Q^LCy%baze2(UpzRzg zgKGlTbY@m2FUGoQ>%7;Kj$?41gump`)7UYV-cQ$(e&t1O!Fzx0z@oRZ`Vu5VqbPB@ z(;hHL{d^(xsV80oi}!ZI?`;I6Iv8?ZDk)|Nok*2irJ{_IdBwtq!SPi%Llrq8jzlX5 za)_jK=6z5TH&xndr+cm88NH)4rDbb8bv+ynUVR=1|cR#%ShRG+MRP(Emb! zak>7g?&V7$wvz@JUe!=goni;{(5nfZj@GMn&8bQCyjYyBxu;a2Ong>2@IeQuM9wr* zoN1|0*$|`oh>cug^J^BU1+2>BQOP4n zFRHMg81#z(pJ(zX?)E1`NjNJ+M@>?;K8v)X`SHvEug5#pcq zuG9|U3MgdZU{sm*Vj5-fXw8)yciqM;rY6yqQZ>YW0KeYGybm%YN_h@w{kZgpj(Z;p zyHVCBV54C58Y028Wn|M&O2#7=T+Q1g6)iLc<^086uRmFaZBfj&(QE4CUqdgZYTn}( z7BEdStdU8mW%bI}K$jRLNgJN^9Hdrr<$Ca4{|M9}D{xRYfHX>)!oF^nHSlNWzo|(W z-Vw0J&)v&W9~>N|iHKws?PZ+rbkS#M!?9_#TUS6`j)e%TSE0Xd-;cZz3*M z$6X+&phQzCv-QpEI$Moz`qGZ61(T;Jqa+@{k@F1OUvR}*uD@P>C%+ct)PGKdVOiU7 z{e(krWS%IS?1?nH6g@TKHuJzra#9QOhl93CBTHbRy&?BQQcGyf;Hiswu)tkC7o&g+ z&icl)`21Ap#hVFm(|ny(Vk*;9xXL04a;#uaa~RyUWRSbZrTt7k8j=6vJBwE4vtAU4 zpMbpu5L@PZNR`6v%;5Ha{><6b3H*^goyOlr&_&WP z4v1yaaX7mLDFD13pkP(Cl+t$n{!>RtEnY(o0@7ssSga&3o|bnVGG`tUs6 zyMz9`ZZMgboH_bO8iMXvB!J{QdhB>7SiUggfDqM3E?s9nJRS3m;*O@zX1Bb3G~9 z&|f7ETkV?#34d=)yF-^+>5q1$)Mc#vwW=NaNLmlT3sq?~e?yYlq}^v;8gz3dvjbFF z#NA!hd+I%tD)~^UNu(gzWVuZ;_9NDj915xrE}y|K>RrGFD$cx^jp9sAcyEa>pvFsd z(iL~VAxvv$rNhBPU1Pazwg_QD_{SZ{>wz20{EO@`U~(~)JHE9xZiS*za-6oncDquV zM`7|AgU< z*ys-gPpp$JScp%7IF_CKyVWq!8c(&)QHatX^Tit1lbYgtNy4I1o6q%`#s#(<6qBBA zY|_J8U0A~MT@aA?PAUC@k&eU(vNURoSiq}lm0}L1%9BgQaaJJ%)wl{N;e;?utOkwz zqu)CV#yW=dg{^P$i}aYYfDF5elA?8?+=5*1-$hjLxvW~8htru3v%5NAxOuNbe$s4U z`o>iCyD|P4CM4hVYi+z;no+0lg||ov-=W8N3djCQsg`2uOu^R{jR1Yrv5&CQzBf4i z`|b}Fg5^5K0~n9*aW;!>Ov}+sn_%|2C)RK9w(|OBa+0d3f@E&}HnU{=^E1=|Upv-^ z(3}ip(RFVs!t{YEGQw9p%7ulUK z70GTwxV&O&O*25E=Qg(ft-o=-zEX2}Bv>J9Iual*GU*xby4s#(gw6QIv zxca5gL&7hH%>hsm$!4q-X4-kps-kb!YTfPSN!r=B#M;(pyI5tC11Yeri&l!{Ne$LG zZ83Ja? z&#b++@1;1j5cB6UG1~fvBTX)jWlHe7-~xO;^fW`Jh2fky3zgQ#t$}h!Z^Vg|S;MYc z`&P4=N|PI-P1{16#jtrIW=k_mb9?3;F~!>OU;ssnh4fZQCa3mik1 z&br=#Ia~Ic4p_O`Jin*uka0a%U!bJTIoZZCO+O#iY*M8!FOW;(9ZW7D|G~jssxp^X zn`&6%V^eTO8B~4MxRyyjIWakk=BEk67j;bng!{~7;r0)r;7s!3N?#{oSY|Bm50uH^ z^aKfEtZqiO{KL+5!qnY-FFCzJ$$E$OUm7Py2?ST4#qzY|W}I=Vy;C%z2|55c-Lvvv zY0RcN)**Y*o`_A&8bd&$18rvq2W}>TMy%wDgEua0xYU|pqzLWPZ-M7be?{9|`fAYL z7(TO|?piB7R8`kRRK%K&qrBSOr!xpxCR|bRoA)Hi+2<_~(0c(afgSIJZULIH2$V37 zxCa~n1j_;k4l`XAmP@nG<9MY=nis&U*|OlBNPRi@Ge{)wWJvo%VCok&%Q;;yhNerQ zftyS?E}sCsH;G#YA6-K6t6;H**^;xq_Y#VA>hy*uR)q2bzb#Z-!R9CJH`X(?Wej|6 ze5i&E9l$I#9fD+Bi44`vPQJ%AEK73Ts0C*TdY@*}%m%{04m1vXeQgpgc`1IM% z#U%L3q8(2vkfH?{TeAt6wRnizmh(TH09Z8#H^m*YjBlNd3GvOSSHBsc(Pv$q^JVo! z6c25^HVffz#O&wY)~U8^`*A{G4tac*T>wfdq&^@f)>@6=GP3 zXCs6ih&EfoR`KX+nAt5$O|<<8YpG3oRMaCCfOO@o^(O+Sz@_9V_z4IP9^|L#>1BNo zd(ifXMNGHs-xnApX1hg6zAH2K4$VrPivPSNM|)X!(mh#FbBaR`Ji(m22m%dIe9a>I8`=&E0uN|2nK=G}6J)q2@A=2DOguk<21 z&ohXD9eV{kT-6iDzQbC`0}$AzAWq5#U79xoJ?=c1Q>@3oos8yfn;h^fCaca@tsl?p z{w5=RCUG@(+_-s&rTAbg<^|i@+PCNG8iY<`hkxsKZD&el36tQl!xw{@mPdOH_&+`5 zU?HU<$|n8OV0k8%^)%dDja3EhOEkF;!)Ag@x$|!PbUueZ>jZDSb;vVr#qUSujW`k{ z<`>A+*N~F-!b89DlYHT4Fcyc+unb3~Hv=57ok9Qkgrxm{yy!gqA^B|R3+Ig~6vskm zFpovTv-UUxjsnr#8lQDaPfYDoZ`i{x?1FDg0pttr#dbNXBAyjbKtVt@w%g6I=4N3$ zFiRE6#(LN~!N@d^J8W2$=k*tgk|vn~D6KSQdX}uxi!jXjc~J#}HM?Y_Zht*7y{%D; z1|f*%ZB(gYJTDGTVllt(qGeS^oosST2b{8K(@N2Q==lY*^K5aQl)lYn&2^&C48#{h z--slH4}Xuw>CY2M{SrUF}Y zd;sffi|NJ*+yn2zX9efS;M{+7p0|i52VjwUVGcR|M=y5~@e{7@Or6j8FF*;8J>@mo zxPO<~V)*dhBq#2iCVm}6(GOJ9Fa1hstEFOH(sDO!VCmqGGHdryOr<0?t}k-FeM3#Q z4+W7ry9;Cs6fJ9<)p@ER&-Y4!Z$WPhm9i36KHloro&Vlln#4l+D{458{b_~kvPbR5 z)y?CbUrc%22Sqw2?AqjmDyfMlcEnA6 zRfYbP3o~8UI9uMb9nL-)azmJ0Y{nL8t-oN_YS{EGEgVk%`O8p_pTH}PPI_Os^$S(P zyX=`~SKqHvT~slfaix1KDRK%4jG|0Lu&xks+0$*%UxynGN?fwiYb`f#;;M8$$J3<* zM_4yzBET}N#= zKFQ7F3apW=Paf=ZCpUH&&r!$cUc8*PsIN&+N<-sk>S?@(%h=4xn*T3mb`t0`K)3c- zrES#@&ej+oJwPcDctXD19oAvTN3OxwfJ(beQNEvoi)Ub(K9UWI*Vo5ZY0IGo4yDP3 zcOQ-%0(a6Oj(OT(lbG*R{E^Pb2Wv8J)*=;M2B=TFIt%=40QZj(q^CBIe$ynRb1E5@F(Z1flm+3sv@`VVLf{munq@-Qsdf*`8O5FN5~8$oN5> zao=D4KF@MPQ-E-_O_xt5up1R{FS11_`+5-@_~>o&I2+VT zf|>!TGBZvqOsVx+GkR_^4E>SVi$Wrcu4Grm5QWif`hslV2%u1L>V2;Xy@|>3N(0&<}Q@8zp5|Ng*cYB;KK+1nYO-M(O$Ohw*krg-YRC@DHF9 z@KHp;K({idcbfNr%A=nS2hj}Yd7yixc3FwFGzxE^$nQ+@-(%COy0&`Ik~D+p^s0t! z5XKf!(P^e*vSKFbRDX2ucdevq0UO%&nPppUS!jlfGx0F+_VX?|K1-6_s~#$T>An(u^@@*@wkszW_hm zT(@q8lB08Fa998E^-jrlqQV{?n~@!&^_n&T!jeEk`YHwv0SEoU?xKMzlX6$t<(L7= zY>oc93EG4=hi~w^q?n5Ve2HD*#$Z`5o+dNK#fh=z^pf;TKJ!^@!%lAjL?cJj953cw@g1T|)Rp&#p(KbEduTI;1$tA+ zjw=%LON{P>$(-}cqM`7D90n8p_Vq~6R7FC6yB*$YDQ8jdZ19!wW6L=do?B`Kz-ZWy zvP~we4*&igWx)jE7dHpu9ctN+ayYeAwj`IE-9mQIK}Qm9mob3g>@Sp!&P6{jGcmUf zz#B=~%Sx-PHW#L3qD?>3aGrM`Lo)q;@EQ)|U60bK(zhltlx+CDhn|yBGjgFC2)oU- z8gnXOT^&F+vaGg>vWUwyZ?|uFt35eVHs|?M(W{_ zLwL4i1N1R@xDbTE#g8e+)^#T=bbrT4gRS0wJqYezrrWuBd5|!g!E;9sZ=fWLHES`v zZ}~uFyw1%V+;+ZY<^f(^kURT<-OSXUfm_Fr=hd{y#x#_YGuE?ht!8DyIqUz6 zgMgQnDE{_P`k5vyP+aLf%GtZICN@)HW?Fn%O!J*@j`LVJ&F>j+$4*1UV0iPPdO0iH z7T3sMprr+W`G})H$;M4Oe)(A8`AncMvwwes1^rued9zE1`E6PVt(2Eq6U`|H>y9Jw zy&$B~1X!Q_f(#D+cUj?u8DoU@Vxf-oya!V0qLp2-bT~|V+Py!=pH#LNdQaWCm=RPQ z>!X7HQYp2(kOIoX-|v|EtaV5%PE3*96*An^<-1!}ZGP*Gw>igCdNDMbhA(NGdX}ZI zIbYe1KPG=*3pe2T#G`Wojhl+gwzey6uP6y9erJpwFUie7bHl-+kiqfr+Q-qc9J_rB zvgh#O8tCTAI}RfCtY`KuLs?Anjxf-{1WukF`gu>oHy^2(w~^KKUP1(%(_D#379sH9A1^Xf{|g} zDPj&<&|KM&q&rM>p2q9#$GIVn*xR7#N$_F)eBisrL4m}JUT%pf0Qtnugebv~=# zLFW^%%4b=h4h@dCxS|FWgKFO%rwB=ZXI=82Tn#XYS8sv&C#Z&ffSX8-i|HO!x2%074*#_39A}AB_Ep%!@IVz$$jBg@?>*N( zdZoz)L2_UJqeU)DZX;0F=6lw-E1hu)zoBfF!hP%zc?z^!G? zwSab3ChIf1OaTA2Cq0|WLqjEgFU(8#lO8yYbcUhvu2=HYS-0vp{Rf9X@s`bi6@Rm* z@#l5J!^F58coZkBRqj_3*^bXhmIv5wB1U{Q@a>LV{nXWpkI;|0oh{2Xy9*9-CQto; zTyW#%t`HDSmq*8C21kKmGS#O~qSF_ZfulJK^WuxC-;KWam$49kYQGXMCLr-wazC*{ z&%|L4eT!+}o&LCJW_>dA_(+9L0S5sA4i8^TpAkmFOiHgdfWD&gwN_ANPXlD9(sS-@ z9gpXpoemKL$gL4vjkh33;MC}~sDMm)_*<%-ea-f&-mM}V9tJC%A_cPJPSs~>y~I3? zr)d`C>E4Jdws5P(cruv?0!4=CVor38VoS5Jsm*4wG^1$nt(|Uo_jSN#X{$5y&MCnE z{J5eUkq!Q(^rfJNp~=a5>ux`=TDt5+h&?MsQdjpUJXM2?gz2#xL1BJC2-OQ zR)4`@>|_rL$YFsaaLmNxpMD@u59d7FVQ>5&46#1K<_MUMizZ0~D=t_!_&qjh-Pjyk zNw2=2Eb&X)fl~Htq`%~ok8~|r&%S;3;~nXRkFa{UMMpqZT0_R26)A(70@kI{W zl^_;+@^t)UH+J~baO|MWV{WUj!anpgC)cvB!+1=G+d!}XVv|eD_hpCSn@tA3c2nQ1 zmjAW)-A_?9&A*6=2LwgQQ9(gK2};f&Nl79gIfLZPl3@izl7I+EW<_$&IV=(dB!?xh zTlXKhKYdRXRn(cD-kzE6IXyj}>FM1mmryv(;`-R(m}0;wtoT(i z;W@-9r#(Q1ZzhK_tp-+g(UL94fV|JpAT z%F2Pbd_B{k@_Wj@P=hl3nQOMd*)Lw`-aBnXEUdrSY56XTsNJWWbCE#vPj-HpCw`$4 zLGPo!FFuqd_3_5SgSVvSJNC5`{RbAzElyV=SOmEsflS7p!-n%MK^c?!QTtnUvMwWT z=#A2yHsnaIy>{XFfD_!u*6}hoUYK4W6~@Nu`aHqqM`2}`vCL7ui0S!=uC^NY%fio) zcDo#OO$cno>MppwhW`4;kJE`dOZ-0mVN2`$v%eqfjyJSfMT9+dt3ouui@R5p^`|?Q zfjp{wuI!b`dJp=)4|8QEy#VnDqk4S+w1+g1fZZ1QCU>O#zOas%aq`-eVDCO2j?}Na zc6c0!KIY_`OsPORn1C$n{Pr70Hm-zWi=}P1JnyBcb5UG;l8^KLgN@`dbBm7D(M544 z-9XU_&0B_E^JBh_V~~BXGt_8_Xh>ic+bo~!x~3<8Z=%?da3huQeu+=9CO40U@_TY< znu8TCfY?&P{)-L>uU*mwpfbX&WST=0shV`cWvNLD)~9hEJ%+k}po@9|(ufNzE2aL% z#UMO(7b_D|0VeuF<;}r*Ie*=2`J3m?UA_*dclDOz`j1C$vr`h!qSyLQY=*W0Rki(; zrg5Nq2qj2+vIK9ngE&mMBWZ>*^>~u%mXpR#ql<`x$t4=~jNQeSz=u*(d53O~f9Iwp zp4UPMU6EuRkp&9tZ@G5Wi$lW@Ty6VH9RE@jRM<1hP*PgZ%vz=_!Me!Qh zP7tBbwF}kq*Er)c_K$;+l0#OpjX_HwSh`C0>P40S`vP8X=NNK=il1U#)_~YY-r=u{#+gOS8o@s80ht0s2|{PT4;!Ea5t%O$~uxpG96=UB8Ng7 z`Apr{r-wzB-l7c_^Ai=z;zfYvlO>CuM$qP|W%k`=d|$lu3u2n?;ubw)Z?X197n4VI zbM*t5#{EgnVPODTmp$D3&x3>y{n4y#qk#vj$l2Dzc37>J{^Iy)mlKPD;PkaxlM_a77bI@HprmPW3=b(cNy%k3krk6h040Z0=vpHhM&$W z;Z_@>REp7e#71Xw5-X2$85UhWHPF2MCZoXoEZLQ(sQH!RZBasw;(R>2wBoK$GFa76 z$fIuS2TXD>U2=V@{Tmc1@x1T+5#?yqdFuqerZ|T#@lAkuJv^XY4W4-Sr}>?-@(-YS z9J>fkGfLc0&d_}PV2m+_l(S*bkFQtYQK~!k#`K_IpWxC&D^_B$%FQQd> zqM?lr_*M|MQG&31dl)H4kRsDNzbI7!>32nJKvO4 zLS>Jxmc$F*?lZ|s7;gjucBK70o`KNsV!MrtURGM3rEm7$3DvJ$1Yv`DnMM=n_o>Wn zX|jN`b?ch=-&Dj~)x{;v)TN$JMxRL1WGB+I|uDJ(f%GAxD zj{|s3nlTLFcJnh29p7BF@WuB!O*r z_x>~*<+VPb;nkN_O?l?Nw?4Y*|MppzO7#X~yp-k7sP)As9HA~Hlmy?lIA)pmPOl0w zPXdoI6>X~?SK-G{++V?8Kw8co1s(AP&HL=8v-_Ss7Skw$G6T;IYOiw>pEzGheZhd! zgv!YhU7lgv0np6-Z9`<&PCZs+nXkc2n12ITb_@@^pz z1DSSaXh4~MfLS|1`axPBSImiM4aSa5ec0H}w#?T=WAr8gSu3OqqS(F(q(m9m{KhDi zDd|_@A6Ro6W>D*R{gm%I_)HHxP5U_zj3|bdbgabrfZjPTzx6S(bDW2yPD+vLE~491 z^y)iuu@H;7x5yi+bC-jHror_x?*Q&~b=tJ&k{#L~zBMO0k z`cr!j7cD24W!5uEZ<|oZ`J-!}C7IfQ*S30YP$0I+TI;Q}*)|uY@7p@-M0+fYm(x}( zqG1}vFSQh8-pK;WOsb{2eBh|LO~U3DJ+c3~IW9&Zr|2uSnd8)qq1ztoKDIFc+xU_Y z9{G6hymw1DyrLz7Bf+0DnD)Mp7-rJKVjlk&zfPr86@kiWD@}FFraz+zlF@3ftA^A7Bcg858{$ zAwf2{x~$vaSwaIw_Y{9~I>#Kk@*keZ*wnh&w{8h!QZ%Cz%Qq#ha<_an(58o%h>CJ5 z{H&O1vt{_sodK&J$KT$(F1B$O^_hl)Y}ev-IoqHX*W2-%MvB(|$jtg}J*_A)e3Kg@ z6EXQm*y-YjiqHCOWr6IBaxD$3S~md?ntOLyr7az#>-%2dZBkoZG}2UZj9i-MNbc*_ zPc&I^#!FNV1Tnin5c5m^i05ACSw0GlqidIQwymU$279a9h5Ck^m1G(*fH?^~W5QniZ<&z+rN6E02|%wANdNFTO>E*NedYOGP#7MxwY( z>OZI}E1uBDIRzZHgZy@n-L#aebX}hZvshjG+N*xh>Cngdt}#YJWB#n=Vy~8SDBr~u zbphsBI5Rm@U75l_BzAQLU7&+X0U{S0uGplg0$99ma{O-d1BlsFIVI$I z%FYfdAzYH&M(Zv&my9;oIZ`*Ae^=s=UFIoUzoTJ0-iA}d6(_M~1FMDNi`6X3SqMpe zjf10f*}&}qwOi2b%cIL=gK@29v^omC!e!`@ zSC^dlv%{TMTef&NC%*fM_Yblg{E#2k%G}knUPauc--^n58f-T%mXiD0sr*@7)oPN0 zhJ``H9&x%rkP_^CIIkqAElL{emdo|sC0w}GOn5rsJc2#DNguU4o$?_LL8?t=SLa6c zPvHmmmZ|K;e}o}?Em0@7Na-ry>b)*9wMQo{KbNvPO>oO5jd2aGuGGFFanF_8)_3s6 zF<*LbWJfqwbj(i~tirJUgj0xmqe`0PZw#*eFt|`9z{=NH#CdLYs=#u=H^XN+*vKfs zajz5U-9#b{E2z;D+X(*d*~1o_#UA&Uet@YuY*g{AoWyEZ*+vHLk5uoQV9!M8m2D@alX8_NzUnn^ z2l~rny-6D(%!P9;>r>)!ZHD@_I3IY>D3g`jpUp9ytVjD5A9nN>0sdzp? z@&s})``Q(Xi+jzwUhRMt&pI$I8#b6fV=>T}!VTw7KSPmvkSkxktR4MtS3%7IrdTJZNt-`vKU z3p7pZCc*6-D@O~Xjcl^`L-~89c0vWflrq=A`9n9-%aGK?gpT073AwD|jbT)zsy6cj z>$*_76>=mI&h=@#GC%FcG)V;H>eO~WS9rQ>zW;PT=x0HZ>=WxbxAvK!U?WRM&9YAv zaSww&kAj8NZ(AZ>-#l>`%abLoQw-wd8S4X*&fetPLS_X;#nj?2U20@5ZZ!<8T^$=C z(Z5&K$3Vl{WHmj8f3#M|D&-;Q8EupRT8vBYh;o}wucH2}38ruPcJw7#&U)7S0&W!yOubyJo%ZDh*N^$htsx$3)2lMZ_6tV4Xd+&;aqB~ZCb zHLtFbDQO@52Pts5k;Auhx?@qh>Dytjw|Ve&NnE=5*9};?!xGtJ4#ny$tN8xt@NFPD z@FZ0T@Skhk&o#iROIH*kU~-gNLtF)Oehz|;cZg{KoaJM45Q1@Q9In{1a2|8=IjD2j zl$FYc7wfzjELrr`SfQkhBjWa$vwT%2;9 zhzRhq<2!cbi+-!_Jc7ms?bvcRavAn}C?|%|yO>E}^y(T*7Fo~F%9RY}r%81T0>ypX zfjFoY+V3YRIRTPu`3@Yx9lUwT&y{bJQq{)tacA{AOnuD0bSUfj=|0t}_dHEQ$@637 z$A04{Ka@1?3CL++LN3$Am(sxHQ%^VHOVB`BQcQ*^YrR=)2=0w;h0j*454*%y~T?+ ziUGu7QZtK@^}tmhR^E8VR~UAo`up}!ZrFEkwp%tqwA2-Z=ybhbmp(12(T#Q+<+jw> z1n29apOH|h_!51@;OyDYyTF3-iv7|^G}?7C z80w(;cTD*P$9=@dPuqW?@M<$E_w$=kar^O9&Cm8mW4<|-7Ev$V9isR&5@{eX#7Ds; zxo3$7aiu29$Fyd1&SPN};PTwi@uo6xVf7~{^uTaZqfx~n3z7+Pg83UvR+M?>hbHOE zL=Tw|%0c!4QeTwO~^w8WBA3^D4{8fz_2M3`Pb92s`s5WF0!)*{Yjq?{`Pe~u6HO;KSQUI zz>Trdv5LjLA^qU2%&(3GR%ky6e@841J21RK7vuecf?l1OR0VhLjI| zo%iSKW2EO=g!W#fWU25n$tf!Unsu*gy7vN%qpz zZBBA|G#>hb;uRNud)246gUg2%l)Kb2ho42|Z9UV*B~d-~IOo-}i7i#QdFB>^8mDOC>Ri6p>!`G%)3~7DrsN>rD3F$uqPMYFb;N zr5c}QSE4d*?@Gu+8Y-;Ml5=p^$>fZ!P+PI}x7gzv+3c;~XmjuBS>j@Z^n6E_@%9-E z9GN(UW@IHulrVD9AVvr`A6vol2sI!NH^3Zkrn3p_*dfR?2@J|-sW558i~;bKQAKll z(Ox51<(ZbZ`C0YbBtJ~a%jc2c$K1n}Q9>?TgeWiEb)r+|0MtPa9JivFc)}U8>Up~l z009UEA*+?`2fleSHg=ng1tb5|7HFqaRfz@xSCkkO7(FH;`iOtB!@2)vAzJW7{x5{3 zX&(8U9m6rOkqD-Jjz~iIns}WgWuAz&NSR2|jz2_u{z)Ne;B>y)#%BVCFbPiF#h|f;neg$upiNfu2t<5QQybeLU7glvEKNFdUzV21-M!|Nn*nrO6qun5o$&yHk#&>>5 zy8E6l{&j31enE;*UyIMj;jNy*zs_J2+;3Qq#xMe7|jSELfKwtm6Sa>sT2M%aPL z&XUdaYwK1Pq4$y%h9ul*!Cxb~jE~W)$kQ$5 z$Wu<0MTg&+p5muZ!*$T)u4>)zP;(;ZK6Zw(My-8GVes7=B?r4rPyh5x8Xg-<7BXURy;#_> zI?#E7GBZ2S%wdmW;HXEXxZ2f0)i|eCg<9%l&c&lEK9|rjCAe%-;}aAYkQHuz5~4ZE z=$m!zOS+~xPEhWut*ZE7e6Q`>(y*+3YgjV+E~?QUzl5VN#|_=enm0g>1QlCy~o4+g@cekckN`~mD=m> zo~F)M#{1<_HjXz964-p~07$?fnN>SytgUzJwE}@K;5rI zf3HAXf>1iLSNUvEdKXDhXu2}K*NuhA3fbI2xFYkd=qZ(*so?SC zv3j#)(CcVieLZ+xKy`>5#>nZio!@72nkomfXZTwdV-swQNW4%pZQhr`9y^ousQfP0%|-3 zY()7*zd~z1zwF$psm&{JYv;C^G!7?PABA4DQo3^NVm0&5%p@LCsmr~$s4;VF*uc-T z?Vn&Z28-PxPpM@HJiwn`dj|?D6NiMq0>Ejq1kcG>k<=t8T>4y+S;~Kk%3F_;+GP4E zf(g{S6$>EG;ttv|ymz>Xh-5p{&FxH-sNSZ^X-(#FHRVvW%u}Cf&A0tRy?d(jbfsw| za_h$hhIXNif=#k+tulTPznG!T_OoYMp=l|f4W7!gF?FZLd(@erVgN#WkArFVXySL+omy*kQjxjlhGXs8QCfFVd+o*EKmHx&i zx>T9@?iHi~J-U4jz!&kd_Sx^!%Cw49s_38WGc@khPIos@4$X|hg4k%%>D zF@ZwwCO9C@)J3rB6w3V+DzDxsU-;Yb?!GA=*>BAHQDVyKUSu?Gu)-04^!* z*CZj0Ma2ZMCg6fz5ZD{c+8UWLx_O(4wK5<-l{Z2Qtfj@%#W-~JTSu_gZQd8Ad5A5& zosmtr=FomV8bX4AGe(MIsHe+p4Q`mu^EGI-Ez?dZ##VD&t9DrOaR7fSdM!psqL{2b zAC}`f9|<|R&GF1g8vSVo3Jvkzo0YplejM1>GmfQ0IDwQK6F+MKG;t|!!O;84f?s>^ zt2P>>NX@7T=VCaBd9=8ZDxi0lWJ1JIu!RN9ImGGbcI}AT;!V}s?p1I$uhT&XZZPU? zHF%3Ey>3u$%0=P*Q#Zxvz#-f*oBuj~Hu5?2L!t+p*CM=^UAzZ@wEI#*^3``xTb)#Q z5-UP27U#87qCUqEi(?B?F6bQautRO-y>Tn4H5-A(k=d!642zo*qHMt>>KGZfN( zG5s39SlUb5IKOADNAh=WT{(0#RVsyrwHd3$!w0SxF@J9@wXQVOyXhznh7<4&@18ke zL4;e-9YzlVj=jcgR@)xT()V}4_2+{~Zf$RD1EM$Lf?g_53WJpCXHy8oD8{n?0cW6M zsJNAXRF8AN4#UM==xbOA_Hx^g;^qI`BUYw&&t=$eOg`e?KaX*8WFCQ1!}4(A&ZEI4 zk@_bva3wRLy$N3&wgzuBD;}AVK`&@)s6Xuw{^^f-Amo5CT1d@ALUvayfTjR*_rLPL z3o`VUIyp=T+e_1M85;=VIO!0Gry6*oi;M+H&_5Q(R!^`T-ehl(Id8%-$O9{4#eF>u zxQ_{Q_1}LqegX$EeU8hVpI3-u6ulI4aSbd!S+a>L7^6yVcDE#20h%;Ik0(h`D;Aw1 z)MbT=u_f4UNoCE#M=tq3rAGp{xI>a0!NZq&c`YsYu+WoV35fm5@(dk?^PT85s3qQ6 z=(u1_hGRB+2Yq;U2DjE!G?M1Yd*9JviQ`0n)X64n*y>~vV&cl#WeBRr-o`*W91ol- zWysZvn26}oq;tZ*Y4{sk0%Ne*53XFIp9_e$AEQz9m5AM`V-!-|u+Xy(h4h}dg(-h! zdhGYcH^A`y-#W%GAW*48uFd3K9wsb>>Y$D&wo8tW%}ob`G-H>o6C#vY;2j&mxAq%H zyeF0c+54PudZff1nfV~(WeTdW`HGUN=3qqyMSgyDiYe=Cg3Cgs4yZcU`}8?|aIUHd`p^7fq3_Nm zTCZd|xE$ky4*=nYB8AQVzS-T^Y(rPp$4>=v#yqIl9>95{W(bFPx+`Vf%nm-rp_1G+tX7w%U$prRgsWnhJLh6B1(A^ z?#0Wre_8qEf<6Ri*)CiT-k?*DrFGvF3o}c$UDs$)m*_zv4 zVWM+R-i!&I!Ee7I6sSb(6yR1RkRLF`URCujb2W!a2 zLNY$H`P95CZ*_!5e$~=Ycpr-!pE+w`$54l#Ia&VVC>cg;dSDVOhN1g9oHrEqXG}{L zmQ^+hYO|W`CV)dn7k|cD3m?4k!cql6ISgi#|H?6hJ>R`_4ZtH`-(~Al^1vfb&}L5t zW0)Aj&SbPIz&reGRsV`93ntU&R==y8FL*=blw3&uCyQL{tMQ~2$_oNH zV{_+|l_j)D&dRb@yc&{}5t=l6zFjddGq(jc-cO;_eJ~K5zX~Z7+61#L94cSLP6b0J zSLtRUk4ceyaEQr}yCX1X0?(x(V3!xNt?CJF={3V}6_KSQk;T8ag>o2Owu1;_YIAOm zpKl1||1RH=-b6{P2>l{R&9xMri z7V!yMVibdZxYx?S4?8jmrbYy2z%{EeD}Gsn$JGb-?H%T8O5#9&@oq;`^k+|ENE`~LpWuS@&jp{{eEA1#;pu;w*Zh5L=FY#p+_TMj%@KAqu%>m* zaf(8Aox{xM824WP8*w7GS^M_S`AWTC4Wp?zdFvx~{b-11e}NH76NNr(!GUzE0+#T? z=k2q4d?jRn|BLeBPqCd3=32GHzrsXlGUbNs8O9mC{P$OY`!Q~mafK~tGS6!Y77{q@ z>nIeqTjSM!i?fqhl>W;y0>^F?kqVxbNk=~4gr=SLxTlNTu6X~SZx9`h-CRB6(!&2l zzclEa-bn<)`BgSY*oJ(u_dRc zIbr%E08!_SAE4p)TymWZ`o3UT(j%Th`iw4#@LL`Ap02wyNPFK8w=oe``UA@K5d%F}HMfZ&uQP<_+!WjD;B z8rhvIA^5p21OxWczI^7yIn36Hk>P#bMZZF9uZKt_WlM+KT-D8#yDVQgtCZ;oproPQN)!Kk@@I?!KtEm zPAF}~@znF~Gk;vvhr#nZ3JPZKVO-`wxj5flWz?}<)z{utv9;( z{Y~)2#lY!B!tH%%BK=GI%dRJR-);=C0;F{8qRwLqrvDssrwJg6QwV#j5!~=FzBHxo zCv$7b7Mb9bhKF<=TuDUt3#RW` zp1i8-{e08$g_7-`zX4fKD-io=MetKsM zcU{|Vw@pzHuxBO~fLt~rQ`$dLgLzTe|DrA+hyxVZx9Um2q9aDo1`-Q$H{Qc8>`@mS z|BgoLk(*Tu;iEI>&v>RGKs_Tg6?8Qog`0%rPD%1;u@ zUP$h-KHW`b=HL@>ud1a_Y%Z)H$9CtcfA}rXK67i}9{#%2BmlrBR2{cJk5=%%oO)6X zt^F!wGa|`Am$`J@01Vs5;LnH5pW~SeCL<{N!g(C1omh=)P7zrJW*Vm9_nr z|6#iFx9=Ij8714EoB5i@T)>Rbo-I@7ISJ42kC)VMUJAL!Zh6d}CQTv$m}O_)r$gF_ z2mN2%dhb@S8z{c8n$cc#K8jkH4oL{4*ya}b5N~!by5-6YA4CzJ2VnW=Zl%0_ZfMUtLt(j@_T#{a#r{AkGlsuZC zC8OA1JU{##&w{V4Y29iN>Fb40Cl$|Gy+LeQ|2QkV|MM|db}ehu*K$9O>dMG%U^e8Z z5rz5S#R86i8_)%ZvnN*5$SM(DO=p4Wtc9VLd*rkhQv9AMa5ng$3w+kIkEHN&hRTVo zv_J?xs0;0XJ8~@1ZJq!fWI+f}Q8#AZt1>?D_aLZq-X+IrcK63gr!Oh7w~+#kEb6!{ zxE}TrEFH9r1!ESk$C&Q-(L6Gb6(gvlF3f8C!|AT5esG%q+9eFKfQK99>EhBQG)eT` z4}vy_boaQ%1evFK+=hj+-kfc z>H-*RJ^m{%zLS2Xe(#v@j%S$g^mA@(z*`div%s_7S26L25~o{*08`Y_u~j1*_tj88 zZnsgn{oziBsEr#+^TV@rWEgx=-1bmEkQCr-V}ZI@+dH5x5c%k8qUgKB%h3{R zSR5)d$inv_UYqVa#evcz^ZHSf(V*tYIOf)UFO-TV3)JsoJ!+^%V&6|+38-~>NFm3} zlqwwb>VK5)%eEAd#B52Bz5nIx&7Gs8Z+q?)BiT_C z=p>5K*Y(-z-8)Q*J9~Ru#dD?_kFqGNyQRZbJK29;HJi?aesYiDWu^&>X5yRAwWYWn zg<|dWZ{31lnFfQU)dpm}t&*AEUccV@EhJ>=9~n*h#cZ{V%atqN!;=HWK>S|w>r(Dm z*n+I1)-UFsIenHV7Q$G?3%0oLcHUf&G6s8jU++LiLv^t<2DOu0ob5)G99 z_xX_$^6|>t|NHnekX%jr|9yTG{%;}C|8@eP4gcE-|NlB6onZFy8WHR41SFId)^}x! NuN5^ED&);W{|5uRj0*q& literal 0 HcmV?d00001 diff --git a/source/index.html b/source/index.html index 11729ac796..234bf17108 100644 --- a/source/index.html +++ b/source/index.html @@ -41,6 +41,14 @@ description: Open-source home automation platform running on Python 3. Track and LEARN MORE +

+

Ok Google, turn on the AC

+ Use Google Assistant to control Home Assistant. + +
+ LEARN MORE +
+
Read our founder's vision for the perfect home automation From 386307868d5b9b59e92abe993a23b492cf82b65a Mon Sep 17 00:00:00 2001 From: Matthew Rollings Date: Tue, 24 Apr 2018 19:18:25 +0100 Subject: [PATCH 158/241] Dyson instructions unclear about Device ID / Serial Number (#5243) Modified text to explain the device_id needs the serial number for the device, not the name of the device as given in the example. --- source/_components/dyson.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/dyson.markdown b/source/_components/dyson.markdown index c090862421..7c0e1ca2f3 100644 --- a/source/_components/dyson.markdown +++ b/source/_components/dyson.markdown @@ -26,9 +26,9 @@ dyson: password: YOUR_DYSON_PASSWORD language: YOUR_DYSON_ACCOUNT_LANGUGAGE devices: - - device_id: DEVICE_ID_1 # eg: Pure Cool Link device + - device_id: DEVICE_ID_1 # eg. Serial number: XXX-XX-XXXXXXXX device_ip: DEVICE_ID_1 - - device_id: DEVICE_ID_2 # eg: Eye 360 robot vacuum + - device_id: DEVICE_ID_2 device_ip: DEVICE_ID_2 ``` @@ -38,7 +38,7 @@ Configuration variables: - **password** (*Required*): Dyson account password. - **language** (*Required*): Dyson account language country code. Known working codes: `FR`, `NL`, `GB`, `AU`. But others codes should work. - **devices** (*Optional*): List of devices. - - **device_id** (*Required*): Device ID. Available in the mobiles applications (*Settings* page). + - **device_id** (*Required*): Device ID. The Serial Number of the device. Found in the mobiles applications device settings page. - **device_ip** (*Required*): Device IP address. `devices` list is optional but you'll have to provide them if discovery is not working (warnings in the logs and the devices are not available in Home Assistant web interface). From f5cfc55087f52fde54e370aab8fb2ef371dbf34f Mon Sep 17 00:00:00 2001 From: Jeremy Klein Date: Tue, 24 Apr 2018 11:40:44 -0700 Subject: [PATCH 159/241] Update google_assistant.markdown (#5241) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Since RoomHints are now live in the Google Assistant API, I’m removing the “not yet” disclaimer. --- source/_components/google_assistant.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/google_assistant.markdown b/source/_components/google_assistant.markdown index 40b0417758..9c92c77e77 100644 --- a/source/_components/google_assistant.markdown +++ b/source/_components/google_assistant.markdown @@ -106,7 +106,7 @@ entity_config: required: false type: list room: - description: Allows for associating this device to a Room in Google Assistant. This is currently non-functional, but will be enabled in the near future. + description: Allows for associating this device to a Room in Google Assistant. required: false type: string {% endconfiguration %} From e6c69b0a48936e63be87c920ca5ae9a6663aefa1 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 24 Apr 2018 14:52:46 -0400 Subject: [PATCH 160/241] Update google_assistant.markdown --- source/cloud/google_assistant.markdown | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/cloud/google_assistant.markdown b/source/cloud/google_assistant.markdown index b438e8482c..1cdced7984 100644 --- a/source/cloud/google_assistant.markdown +++ b/source/cloud/google_assistant.markdown @@ -37,7 +37,6 @@ cloud: aliases: - bright lights - entry lights - type: 'action.devices.types.LIGHT' ``` {% configuration cloud %} @@ -85,9 +84,5 @@ google_actions: description: Aliases that can also be used to refer to this entity required: false type: list - type: - description: Override the type of the entity in Google Assistant. [List of available types](https://developers.google.com/actions/smarthome/guides/) - required: false - type: string {% endconfiguration %} From ea74a32b400f4c3c5de24e56ffe51e41cb5f1b28 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 24 Apr 2018 14:53:25 -0400 Subject: [PATCH 161/241] Update google_assistant.markdown --- source/_components/google_assistant.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/google_assistant.markdown b/source/_components/google_assistant.markdown index 9c92c77e77..f196288c7a 100644 --- a/source/_components/google_assistant.markdown +++ b/source/_components/google_assistant.markdown @@ -14,7 +14,7 @@ ha_release: 0.56 ---

- Use [Home Assistant Cloud](/components/cloud/) to integrate with Google Assistant without any effort. + Use [Home Assistant Cloud](/cloud/) to integrate with Google Assistant without any effort.

The `google_assistant` component allows you to control things via Google Assistant (on your mobile or tablet) or a Google Home device. From 7bfe31cbac81b23764066ed41a8d988384a78f01 Mon Sep 17 00:00:00 2001 From: Matt Farmer Date: Tue, 24 Apr 2018 12:00:05 -0700 Subject: [PATCH 162/241] Fix typo in sabnzbd documentation (#5230) --- source/_components/sensor.sabnzbd.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.sabnzbd.markdown b/source/_components/sensor.sabnzbd.markdown index 840eb5cd08..27766435fd 100644 --- a/source/_components/sensor.sabnzbd.markdown +++ b/source/_components/sensor.sabnzbd.markdown @@ -68,7 +68,7 @@ Note that this will create the following sensors: - sensor.sabnzbd_left - sensor.sabnzbd_disk - sensor.sabnzbd_disk_free - - sensor.sabnzdb_queue_count + - sensor.sabnzbd_queue_count ``` As always, you can determine the names of sensors by looking at the dev-state page `< >` in the web interface. From 5f7f542f680f5e194b156482a8ca54eaca34d687 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 24 Apr 2018 23:30:23 -0400 Subject: [PATCH 163/241] Eufy update dates --- source/_components/eufy.markdown | 2 +- source/_components/light.eufy.markdown | 2 +- source/_components/switch.eufy.markdown | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/eufy.markdown b/source/_components/eufy.markdown index c11870e401..294dd26902 100644 --- a/source/_components/eufy.markdown +++ b/source/_components/eufy.markdown @@ -2,7 +2,7 @@ layout: page title: "Eufy" description: "Instructions on how to integrate Eufy devices into Home Assistant." -date: 2018-05-09 19:00 +date: 2018-04-09 19:00 sidebar: true comments: false sharing: true diff --git a/source/_components/light.eufy.markdown b/source/_components/light.eufy.markdown index 773d99f4aa..872526e1ed 100644 --- a/source/_components/light.eufy.markdown +++ b/source/_components/light.eufy.markdown @@ -2,7 +2,7 @@ layout: page title: "EufyLights" description: "Instructions on how to integrate Eufy LED lights into Home Assistant." -date: 2018-05-09 19:00 +date: 2018-04-09 19:00 sidebar: true comments: false sharing: true diff --git a/source/_components/switch.eufy.markdown b/source/_components/switch.eufy.markdown index 22e56ae38b..0bfbae81e5 100644 --- a/source/_components/switch.eufy.markdown +++ b/source/_components/switch.eufy.markdown @@ -2,7 +2,7 @@ layout: page title: "EufySwitch" description: "Instructions on how to integrate Eufy switches into Home Assistant." -date: 2018-05-09 19:00 +date: 2018-04-09 19:00 sidebar: true comments: false sharing: true From 0b2a94385de4b4cae7c7ac4ed80506327d0366ba Mon Sep 17 00:00:00 2001 From: Sebastian Muszynski Date: Wed, 25 Apr 2018 07:05:12 +0200 Subject: [PATCH 164/241] Air Conditioning Companion V3 (acpartner.v3) support added (#5083) --- source/_components/xiaomi_aqara.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/_components/xiaomi_aqara.markdown b/source/_components/xiaomi_aqara.markdown index 2bf6fdb5e3..28f40d3f8c 100644 --- a/source/_components/xiaomi_aqara.markdown +++ b/source/_components/xiaomi_aqara.markdown @@ -18,6 +18,8 @@ The `xiaomi_aqara` component allows you to integrate [Xiaomi](http://www.mi.com/ #### {% linkable_title Supported Devices %} +- Xiaomi Aqara Gateway (lumi.gateway.v2, lumi.gateway.v3) +- Aqara Air Conditioning Companion (lumi.acpartner.v3) - Temperature and Humidity Sensor (1st and 2nd generation) - Motion Sensor (1st and 2nd generation) - Door and Window Sensor (1st and 2nd generation) @@ -42,8 +44,8 @@ The `xiaomi_aqara` component allows you to integrate [Xiaomi](http://www.mi.com/ - Gateway Radio - Gateway Button -- Aqara Air Conditioning Companion -- Aqara Intelligent Air Conditioner Controller Hub +- Xiaomi Mi Air Conditioning Companion (lumi.acpartner.v2) +- Aqara Intelligent Air Conditioner Controller Hub (lumi.acpartner.v1) - Decoupled mode of the Aqara Wall Switches (Single & Double) - Additional alarm events of the Gas and Smoke Detector: Analog alarm, battery fault alarm (smoke detector only), sensitivity fault alarm, I2C communication failure From 0b948617b99cde82cabd88611b1c0119e692c6ef Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Wed, 25 Apr 2018 08:48:57 +0200 Subject: [PATCH 165/241] Updated release blog post for 0.68.0b1 (rc) (#5246) --- source/_posts/2018-04-27-release-68.markdown | 35 ++++++++++++++++++++ 1 file changed, 35 insertions(+) diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown index e8934b6296..cc616913a5 100644 --- a/source/_posts/2018-04-27-release-68.markdown +++ b/source/_posts/2018-04-27-release-68.markdown @@ -30,6 +30,7 @@ Highlights: - Add blackbird media player component ([@koolsb] - [#13549]) ([media_player.blackbird docs]) (new-platform) - Add support for Sensirion SHT31 temperature/humidity sensor ([@viorels] - [#12952]) ([sensor.sht31 docs]) (new-platform) - Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.lmsensor docs]) ([sensor.miflora docs]) (new-platform) +- Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) ## {% linkable_title New Features %} @@ -39,6 +40,15 @@ Highlights: - Support Garage Doors in HomeKit ([@marthoc] - [#13796]) ([homekit docs]) (new-feature) - Support basic covers with open/close/stop services HomeKit ([@nickw444] - [#13819]) ([homekit docs]) (new-feature) +## {% linkable_title Beta Fixes %} + +- Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) +- Order the output of the automation editor ([@balloob] - [#14019]) ([config docs]) (beta fix) +- HomeKit Alarm Control Panel Code Exception Fix ([@schmittx] - [#14025]) ([homekit docs]) (beta fix) +- Revert cast platform polling mode ([@OttoWinter] - [#14027]) ([media_player.cast docs]) (beta fix) +- Handle HomeKit configuration failure more cleanly ([@mjg59] - [#14041]) ([homekit_controller docs]) (beta fix) +- Update device classes for contact sensor HomeKit ([@marthoc] - [#14051]) ([homekit docs]) (beta fix) + ## {% linkable_title If you need help... %} ...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. @@ -161,6 +171,12 @@ Experiencing issues introduced by this release? Please report them in our [issue - Tibber available ([@Danielhiversen] - [#13865]) ([sensor.tibber docs]) - Upgrade pylutron-caseta to 0.5.0 to reestablish connections ([@rohankapoorcom] - [#14013]) ([lutron_caseta docs]) - Add sensor device classes ([@balloob] - [#14010]) ([sensor docs]) ([sensor.ecobee docs]) ([sensor.linux_battery docs]) ([sensor.nest docs]) +- Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) +- Order the output of the automation editor ([@balloob] - [#14019]) ([config docs]) (beta fix) +- HomeKit Alarm Control Panel Code Exception Fix ([@schmittx] - [#14025]) ([homekit docs]) (beta fix) +- Revert cast platform polling mode ([@OttoWinter] - [#14027]) ([media_player.cast docs]) (beta fix) +- Handle HomeKit configuration failure more cleanly ([@mjg59] - [#14041]) ([homekit_controller docs]) (beta fix) +- Update device classes for contact sensor HomeKit ([@marthoc] - [#14051]) ([homekit docs]) (beta fix) [#10688]: https://github.com/home-assistant/home-assistant/pull/10688 [#12224]: https://github.com/home-assistant/home-assistant/pull/12224 @@ -443,3 +459,22 @@ Experiencing issues introduced by this release? Please report them in our [issue [vacuum.xiaomi_miio docs]: /components/vacuum.xiaomi_miio/ [weather.yweather docs]: /components/weather.yweather/ [zha docs]: /components/zha/ +[#14008]: https://github.com/home-assistant/home-assistant/pull/14008 +[#14019]: https://github.com/home-assistant/home-assistant/pull/14019 +[#14025]: https://github.com/home-assistant/home-assistant/pull/14025 +[#14027]: https://github.com/home-assistant/home-assistant/pull/14027 +[#14041]: https://github.com/home-assistant/home-assistant/pull/14041 +[#14051]: https://github.com/home-assistant/home-assistant/pull/14051 +[@OttoWinter]: https://github.com/OttoWinter +[@balloob]: https://github.com/balloob +[@kellerza]: https://github.com/kellerza +[@marthoc]: https://github.com/marthoc +[@mjg59]: https://github.com/mjg59 +[@schmittx]: https://github.com/schmittx +[binary_sensor.qwikswitch docs]: /components/binary_sensor.qwikswitch/ +[config docs]: /components/config/ +[homekit docs]: /components/homekit/ +[homekit_controller docs]: /components/homekit_controller/ +[media_player.cast docs]: /components/media_player.cast/ +[qwikswitch docs]: /components/qwikswitch/ +[sensor.qwikswitch docs]: /components/sensor.qwikswitch/ From d771d839f3eec247993ad40ebb4c6296d56e981b Mon Sep 17 00:00:00 2001 From: Mitko Masarliev Date: Wed, 25 Apr 2018 21:03:51 +0300 Subject: [PATCH 166/241] domain expiry (#5242) * domain expiry * config * config --- .../_components/sensor.domain_expiry.markdown | 37 +++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 source/_components/sensor.domain_expiry.markdown diff --git a/source/_components/sensor.domain_expiry.markdown b/source/_components/sensor.domain_expiry.markdown new file mode 100644 index 0000000000..a70306909a --- /dev/null +++ b/source/_components/sensor.domain_expiry.markdown @@ -0,0 +1,37 @@ +--- +layout: page +title: "Domain Expiry" +description: "Instructions on how to set up Domain expiry sensors within Home Assistant." +date: 2018-04-24 14:14 +sidebar: true +comments: false +sharing: true +footer: true +logo: home-assistant.png +ha_category: System Monitor +ha_release: 0.69 +ha_iot_class: "depends" +--- + +The `domain_expiry` sensor gets whois information about domain and displays the expiry in days. + +To add the Domain Expiry sensor to your installation, add these options to `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: domain_expiry + domain: home-assistant.io +``` + +{% configuration %} +domain: + description: Domain name to track + required: true + type: string +name: + description: The friendly name for the certificate. + required: false + type: string + default: Domain Expiry +{% endconfiguration %} \ No newline at end of file From a83fd1d874b57f8ad35ab2453510747bbd52ebc8 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 26 Apr 2018 09:11:56 -0400 Subject: [PATCH 167/241] Update 2018-04-24-launch-google-assistant-support.markdown --- .../_posts/2018-04-24-launch-google-assistant-support.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_posts/2018-04-24-launch-google-assistant-support.markdown b/source/_posts/2018-04-24-launch-google-assistant-support.markdown index edf50f2d09..7a263f9682 100644 --- a/source/_posts/2018-04-24-launch-google-assistant-support.markdown +++ b/source/_posts/2018-04-24-launch-google-assistant-support.markdown @@ -29,7 +29,7 @@ To get started: Things to note: - The skill is called Hass.io, but will work with normal Home Assistant too. The name was necessary to avoid confusion between Home Assistant, Google Assistant and Google Home. - - Works with Home Assistant 0.65 or later. + - Works with Home Assistant 0.65.6 or later. - All message handling is done local and is [open source](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/google_assistant/trait.py). - If you have an Android device with Google Assistant, you can control your devices too. - Home Assistant 0.68 will introduce a button to the Cloud config panel to trigger a sync of available devices. From 80b268cd65cbf6da6defd860f0c4b2ead0d573b9 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 26 Apr 2018 11:14:55 -0400 Subject: [PATCH 168/241] Extract developer site (#5249) * Extract developer site * Fix title in sidebar * Update dev section reference * Update edit in github link on help page --- sass/custom/_paulus.scss | 32 +- .../asides/developers_navigation.html | 142 ----- source/_includes/asides/help_navigation.html | 33 ++ source/_includes/custom/footer.html | 32 +- source/_includes/custom/navigation.html | 1 - source/_includes/site/sidebar.html | 4 +- source/_layouts/page.html | 1 + source/developers/add_new_platform.markdown | 27 +- source/developers/api.markdown | 13 +- source/developers/architecture.markdown | 32 +- .../architecture_components.markdown | 58 +- source/developers/asyncio.markdown | 19 +- source/developers/asyncio_101.markdown | 12 +- .../asyncio_categorizing_functions.markdown | 71 +-- source/developers/asyncio_misc.markdown | 14 +- .../asyncio_working_with_async.markdown | 120 +--- .../developers/code_review_component.markdown | 28 +- .../developers/code_review_platform.markdown | 70 +-- .../component_deps_and_reqs.markdown | 35 +- .../developers/component_discovery.markdown | 52 +- source/developers/component_events.markdown | 4 +- .../component_generic_discovery.markdown | 69 +-- source/developers/component_loading.markdown | 17 +- source/developers/component_states.markdown | 14 +- .../developers/component_visibility.markdown | 13 +- .../developers/creating_components.markdown | 19 +- source/developers/development.markdown | 23 +- source/developers/development_101.markdown | 49 +- .../development_catching_up.markdown | 33 +- .../developers/development_checklist.markdown | 12 +- source/developers/development_config.markdown | 27 +- .../development_environment.markdown | 102 +--- source/developers/development_events.markdown | 54 +- .../development_guidelines.markdown | 73 +-- .../development_hass_object.markdown | 29 +- .../developers/development_services.markdown | 47 +- source/developers/development_states.markdown | 132 +---- .../development_submitting.markdown | 39 +- .../developers/development_testing.markdown | 68 +-- .../development_validation.markdown | 79 +-- source/developers/frontend.markdown | 94 +--- source/developers/frontend_add_card.markdown | 20 +- .../frontend_add_more_info.markdown | 15 +- .../frontend_creating_custom_panels.markdown | 81 +-- .../frontend_creating_custom_ui.markdown | 88 +-- .../hassio/addon_communication.markdown | 32 +- .../developers/hassio/addon_config.markdown | 198 +------ .../hassio/addon_development.markdown | 14 +- .../hassio/addon_presentation.markdown | 45 +- .../hassio/addon_publishing.markdown | 56 +- .../hassio/addon_repository.markdown | 28 +- .../developers/hassio/addon_testing.markdown | 28 +- .../developers/hassio/addon_tutorial.markdown | 199 +------ .../developers/hassio/architecture.markdown | 30 +- source/developers/hassio/debugging.markdown | 46 +- source/developers/helpers.markdown | 18 +- source/developers/index.markdown | 17 +- .../developers/intent/conversation.markdown | 19 +- source/developers/intent/firing.markdown | 51 +- source/developers/intent/handling.markdown | 41 +- source/developers/intent/index.markdown | 29 +- .../backend_localization.markdown | 42 +- .../custom_component_localization.markdown | 11 +- .../internationalization/index.markdown | 10 +- .../internationalization/translation.markdown | 43 +- source/developers/maintenance.markdown | 44 +- source/developers/multiple_instances.markdown | 37 +- .../platform_example_light.markdown | 116 +--- .../platform_example_sensor.markdown | 58 +- source/developers/python_api.markdown | 228 +------- source/developers/releasing.markdown | 66 +-- source/developers/rest_api.markdown | 522 +----------------- source/developers/server_sent_events.markdown | 65 +-- source/developers/websocket_api.markdown | 350 +----------- source/help/index.markdown | 8 +- 75 files changed, 282 insertions(+), 4166 deletions(-) delete mode 100644 source/_includes/asides/developers_navigation.html create mode 100644 source/_includes/asides/help_navigation.html diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index 2a9e1fb4eb..c64bdb7da2 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -4,6 +4,10 @@ $primary-color: #049cdb; .site-header { position: relative; + + .site-title { + font-weight: normal; + } } .search-container { @@ -377,18 +381,26 @@ p.note { } .copyright { - text-align: center; + text-align: left; - i { - font-size: 3em; - margin-right: 8px; - position: relative; - top: -5px; + .company { + .title { + font-size: 1.5em; + } + + img { + vertical-align: middle; + } + + i { + font-size: 2em; + padding: 0 5px; + } } - .credit { - text-align: left; - display: inline-block; - font-size: .8em; + + ul { + margin: 0; + list-style: none; } } diff --git a/source/_includes/asides/developers_navigation.html b/source/_includes/asides/developers_navigation.html deleted file mode 100644 index 2d770cb7a1..0000000000 --- a/source/_includes/asides/developers_navigation.html +++ /dev/null @@ -1,142 +0,0 @@ -
- {% include edit_github.html %} - -
-

Development Guide

-
    -
  • - {% active_link /developers/ Introduction %} -
      -
    • {% active_link /developers/architecture/ Architecture %}
      • -
    • {% active_link /developers/architecture_components/ Components %}
      • -
    -
    • -
  • - {% active_link /developers/development/ Starting with Development %} -
      -
    • {% active_link /developers/development_environment/ Setting up Environment %}
      • -
    • {% active_link /developers/development_submitting/ Submit your Work %}
      • -
    • {% active_link /developers/development_checklist/ Checklist %}
      • -
    • {% active_link /developers/development_guidelines/ Style guidelines %}
      • -
    • {% active_link /developers/development_testing/ Testing %}
      • -
    • {% active_link /developers/development_catching_up/ Catching up with Reality %}
      • -
    • {% active_link /developers/development_validation/ Validation %}
      • -
    -
    • -
  • - {% active_link /developers/development_101/ Development 101 %} -
      -
    • {% active_link /developers/development_hass_object/ Hass object %}
      • -
    • {% active_link /developers/development_events/ Events %}
      • -
    • {% active_link /developers/development_states/ States %}
      • -
    • {% active_link /developers/development_services/ Services %}
      • -
    • {% active_link /developers/development_config/ Config %}
      • -
    -
    • -
  • - {% active_link /developers/add_new_platform/ Creating a new platform (to support a new device) %} -
      -
    • {% active_link /developers/code_review_platform/ Checklist creating a platform %}
      • -
    • {% active_link /developers/platform_example_sensor/ Example sensor platform %}
      • -
    • {% active_link /developers/platform_example_light/ Example light platform %}
      • -
    -
    • -
  • - {% active_link /developers/creating_components/ Adding a new component %} -
      -
    • {% active_link /developers/code_review_component/ Checklist creating a component %}
      • -
    • {% active_link /developers/component_loading/ Loading components %}
      • -
    • {% active_link /developers/component_deps_and_reqs/ Requirements & Dependencies %}
      • -
    • {% active_link /developers/component_events/ Handling events %}
      • -
    • {% active_link /developers/component_states/ States %}
      • -
    • {% active_link /developers/component_visibility/ Visibility %}
      • -
    • {% active_link /developers/component_generic_discovery/ Loading Platforms %}
      • -
    • {% active_link /developers/component_discovery/ Component Discovery %}
      • -
    -
    • -
  • - {% active_link /developers/intent/ Intents (handling voice responses) %} -
      -
    • {% active_link /developers/intent/firing/ Firing intents %}
      • -
    • {% active_link /developers/intent/handling/ Handling intents %}
      • -
    • {% active_link /developers/intent/conversation/ Registering sentences %}
      • -
    -
    • -
  • - {% active_link /developers/asyncio/ Asynchronous Programming %} -
      -
    • {% active_link /developers/asyncio_101/ Introduction to asyncio %}
      • -
    • {% 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_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 %}
      • -
    • {% active_link /developers/frontend_creating_custom_ui/ Add Custom UI %}
      • -
    -
    • -
  • - {% active_link /developers/internationalization/ Internationalization %} -
      -
    • {% active_link /developers/internationalization/backend_localization/ Backend Localization %}
      • -
    • {% active_link /developers/internationalization/custom_component_localization/ Custom Component Localization %}
      • -
    • {% active_link /developers/internationalization/translation/ Translation %}
      • -
    -
    • -
  • - {% active_link /developers/hassio/architecture/ Hass.io architecture %} -
      -
    • {% active_link /developers/hassio/debugging/ Debugging Hass.io %}
      • -
    -
    • -
  • - {% active_link /developers/hassio/addon_development/ Hass.io Add-on Development %} -
      -
    • {% active_link /developers/hassio/addon_tutorial/ Tutorial: Making your first add-on %}
      • -
    • {% active_link /developers/hassio/addon_config/ Configuration %}
      • -
    • {% active_link /developers/hassio/addon_communication/ Communication %}
      • -
    • {% active_link /developers/hassio/addon_testing/ Local Testing %}
      • -
    • {% active_link /developers/hassio/addon_publishing/ Publishing %}
      • -
    • {% active_link /developers/hassio/addon_presentation/ Presentation %}
      • -
    • {% active_link /developers/hassio/addon_repository/ Repositories %}
      • -
    -
    • -
  • - {% active_link /developers/api/ API %} -
      -
    • {% active_link https://dev-docs.home-assistant.io/en/dev/ Python API %}
      • -
    • {% active_link /developers/websocket_api/ Websocket API %}
      • -
    • {% active_link /developers/rest_api/ REST API %}
      • -
    • {% active_link /developers/python_api/ Python REST API %}
      • -
    • {% active_link /developers/server_sent_events/ Server-sent events %}
      • -
    -
    • -
  • - {% active_link /developers/documentation/ Website/Documentation %} -
      -
    • {% active_link /developers/documentation/standards/ Standards %}
      • -
    • {% active_link /developers/documentation/create_page/ Create a new page %}
      • -
    -
    • -
  • {% active_link /developers/helpers/ Online helpers %}
    • -
  • {% active_link /developers/releasing/ Releasing %}
    • -
  • {% active_link /developers/maintenance/ Maintenance %}
    • -
  • - Governance -
      -
    • {% active_link /developers/cla/ Contributor License Agreement %}
      • -
    • {% active_link /privacy/ Privacy Policy %}
      • -
    • {% active_link /tos/ Terms of Service %}
      • -
    • {% active_link /code_of_conduct/ Code of Conduct %}
      • -
    • {% active_link /developers/credits/ Credits %}
      • -
    • {% active_link /developers/license/ License %}
      • -
    -
    • -
-
-
diff --git a/source/_includes/asides/help_navigation.html b/source/_includes/asides/help_navigation.html new file mode 100644 index 0000000000..458a6a9385 --- /dev/null +++ b/source/_includes/asides/help_navigation.html @@ -0,0 +1,33 @@ +
+ {% include edit_github.html %} + +
+

 

+
    +
  • + {% active_link /help/ Help %} +
    • +
  • + Developer documentation +
    • +
  • + {% active_link /developers/documentation/ Website/Documentation %} +
      +
    • {% active_link /developers/documentation/standards/ Standards %}
      • +
    • {% active_link /developers/documentation/create_page/ Create a new page %}
      • +
    +
    • +
  • + Governance +
      +
    • {% active_link /developers/cla/ Contributor License Agreement %}
      • +
    • {% active_link /privacy/ Privacy Policy %}
      • +
    • {% active_link /tos/ Terms of Service %}
      • +
    • {% active_link /code_of_conduct/ Code of Conduct %}
      • +
    • {% active_link /developers/credits/ Credits %}
      • +
    • {% active_link /developers/license/ License %}
      • +
    +
    • +
+
+
diff --git a/source/_includes/custom/footer.html b/source/_includes/custom/footer.html index b07ee5bcf8..1a2e590320 100644 --- a/source/_includes/custom/footer.html +++ b/source/_includes/custom/footer.html @@ -1,13 +1,27 @@ -
- - - - +
+
+
+ Home Assistant +
+
+ + + + +
+
-
- Contact us at hello@home-assistant.io (no support!).
- Website powered by Jekyll and the Oscalite theme.
+
+ +
+ +
+ Website powered by Jekyll and the + Oscalite theme. Hosted by Netlify.
- Creative Commons License
home-assistant.io is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
diff --git a/source/_includes/custom/navigation.html b/source/_includes/custom/navigation.html index 1179c86bef..6af93d4b49 100644 --- a/source/_includes/custom/navigation.html +++ b/source/_includes/custom/navigation.html @@ -13,7 +13,6 @@
  • Components
  • Docs
  • Examples
    • -
  • Developers
  • Blog
  • Need help?
    • diff --git a/source/_includes/site/sidebar.html b/source/_includes/site/sidebar.html index 9e2417d29a..6ee8aaf444 100644 --- a/source/_includes/site/sidebar.html +++ b/source/_includes/site/sidebar.html @@ -4,8 +4,8 @@ {% include asides/component_navigation.html | compact_newlines %} {% elsif url_parts[1] == 'cookbook' %} {% include asides/cookbook_navigation.html | compact_newlines %} - {% elsif url_parts[1] == 'developers' %} - {% include asides/developers_navigation.html | compact_newlines %} + {% elsif url_parts[1] == 'developers' or url_parts[1] == 'help' %} + {% include asides/help_navigation.html | compact_newlines %} {% elsif url_parts[1] == 'getting-started' %} {% include asides/getting_started_navigation.html | compact_newlines %} {% elsif url_parts[1] == 'docs' %} diff --git a/source/_layouts/page.html b/source/_layouts/page.html index 946ab88522..cc6ca95b78 100644 --- a/source/_layouts/page.html +++ b/source/_layouts/page.html @@ -7,6 +7,7 @@ layout: default {% if url_parts[1] != 'components' and url_parts[1] != 'cookbook' and url_parts[1] != 'developers' and + url_parts[1] != 'help' and url_parts[1] != 'getting-started' %} {% include edit_github.html %} {% endif %} diff --git a/source/developers/add_new_platform.markdown b/source/developers/add_new_platform.markdown index e0882296bf..3f4505c577 100644 --- a/source/developers/add_new_platform.markdown +++ b/source/developers/add_new_platform.markdown @@ -9,27 +9,6 @@ sharing: true footer: true --- -Components that interact with devices are called "[Entity Components](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/entity_component.py)." They are structured in core and platform logic, which means different brands can use the same logic to handle a light. - -For example, the built-in `switch` component consists of various platforms in [`homeassistant/components/switch/`](https://github.com/home-assistant/home-assistant/tree/master/homeassistant/components/switch). The file `__init__.py` contains the core logic of all platforms and the `vendor_name.py` files contain only the relevant platform code. - -If you're planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you want to add: - - - [Example sensor platform](/developers/platform_example_sensor): hello world of platforms. - - [Example light platform](/developers/platform_example_light): showing best practices. - -### {% linkable_title Interfacing with devices %} - -One Home Assistant rule is that platform logic should never interface directly with devices. Instead, use a third-party Python 3 library. This way, Home Assistant can share code with the Python community and keep the project maintainable. - -To integrate the third-party library, create an [Entity class](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/entity.py) for your device. Entities are Home Assistant's representations of lights, switches, sensors, etc. and are derived from the [Entity Abstract Class](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py). This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more. - -### {% linkable_title Requirements and dependencies %} - -Platforms can specify dependencies and requirements [the same way as components](/developers/component_deps_and_reqs): - -```python -REQUIREMENTS = ['some-package==2.0.0', 'some-other-package==2.5.0'] -DEPENDENCIES = ['mqtt'] -``` - + \ No newline at end of file diff --git a/source/developers/api.markdown b/source/developers/api.markdown index 999647d038..4e226c4af9 100644 --- a/source/developers/api.markdown +++ b/source/developers/api.markdown @@ -9,13 +9,6 @@ sharing: true footer: true --- -Home Assistant provides various APIs. For detail please refer to [Home Assistant API](https://dev-docs.home-assistant.io/en/dev/) documentation. - - * [Python API](https://dev-docs.home-assistant.io/) - * [WebSocket API](/developers/websocket_api/) - * [REST API](/developers/rest_api/) - * [Python REST API](/developers/python_api/) - * [Server-sent events](/developers/server_sent_events/) - -If you are not using the [`frontend`](/components/frontend/) in your setup then you need to enable the components by adding them to your `configuration.yaml` file. E.g., [`websocket_api:`](/components/websocket_api/) for the WebSocket API or [`api:`](/components/api/) for the [REST API](/developers/rest_api/) and the [Python REST API](/developers/python_api/). - + \ No newline at end of file diff --git a/source/developers/architecture.markdown b/source/developers/architecture.markdown index 191ed65f7b..67aab81c30 100644 --- a/source/developers/architecture.markdown +++ b/source/developers/architecture.markdown @@ -10,32 +10,6 @@ footer: true og_image: /images/architecture/ha_architecture.svg --- -Before we dive into the Home Assistant architecture, let's get a clear overview of the home automation landscape as a whole. This way, we can show how the different parts of Home Assistant fit into the picture. - -For more information about each part in this overview, check out our blog. Here's the tl;dr version of the blog: - - * Home Control is responsible for collecting information and controlling devices. - * Home Automation triggers commands based on user configurations. - * Smart Home triggers commands based on previous behavior. - -

    - - Home Automation landscape - - Overview of the home automation landscape -

    - -The Home Assistant core is responsible for Home Control. Home Assistant contains four parts which make this possible: - - * **Event Bus**: facilitates the firing and listening of events -- the beating heart of Home Assistant. - * **State Machine**: keeps track of the states of things and fires a `state_changed` event when a state has been changed. - * **Service Registry**: listens on the event bus for `call_service` events and allows other code to register services. - * **Timer**: sends a `time_changed` event every 1 second on the event bus. - -

    - - - - Overview of the Home Assistant core architecture -

    + \ No newline at end of file diff --git a/source/developers/architecture_components.markdown b/source/developers/architecture_components.markdown index ac05c93ba0..fcd66a99ec 100644 --- a/source/developers/architecture_components.markdown +++ b/source/developers/architecture_components.markdown @@ -10,58 +10,6 @@ footer: true og_image: /images/architecture/component_interaction.png --- -Home Assistant can be extended with **components**. Each component is responsible for a specific domain within Home Assistant. Components can listen for or trigger events, offer services, and maintain states. Components are written in Python and can do all the goodness that Python has to offer. Out of the box, Home Assistant offers a bunch of [built-in components]({{site_root}}/components/). - -

    -Diagram showing interaction between components and the Home Assistant core. -Diagram showing interaction between components and the Home Assistant core -

    - -There are two types of components within Home Assistant: components that interact with an Internet of Things domain, and components that respond to events that happen within Home Assistant. Read on to learn about each type! - -#### {% linkable_title Components that interact with an Internet-of-Things domain %} - -These components track devices within a specific domain and consist of a core part and platform-specific logic. These components make their information available via the State Machine and the Event Bus. The components also register services in the Service Registry to expose control of the devices. - -For example, the built-in [`switch` component](/components/switch/) is responsible for interaction with different types of switches. A platform provides support for a particular kind or brand of device. For example, a switch could use a WeMo or Orvibo platform and a light component might interact with the Hue or LIFX platform. - -If you want to add support for a new platform, check out the [add new platform section](/developers/add_new_platform/). - -#### {% linkable_title Components that respond to events that happen within Home Assistant %} - -These components provide small pieces of home automation logic or involve services that do common tasks within your house. - -For example, the [`device_sun_light_trigger` component](/components/device_sun_light_trigger/) tracks the state of devices and the sun to make sure that the lights are turned on when it gets dark and people are home. The component uses logic like this: - -```text -In the event that device 'Paulus Nexus 5' changes to the 'Home' state: - If the sun has set and the lights are not on: - Turn on the lights -``` - -```text -In the event that the combined state of all tracked devices changes to 'Not Home': - If the lights are on: - Turn off the lights -``` - -```text -In the event of the sun setting: - If the lights are off and the combined state of all tracked device equals 'Home': - Turn on the lights -``` - -Look [here](/python_component_automation/) for a comprehensive example of a home automation component. - -### {% linkable_title The full picture %} - -When we put all the different pieces of Home Assistant together, it's a close match for the initial home automation overview sketch. The smart home AI has not been implemented yet, so it's not included in this picture. - -

    - - - - Overview of the full Home Assistant architecture with a couple of loaded components and platforms -

    - -The platform logic for components uses third-party Python libraries to communicate with the devices. Through this, we can leverage some of the best libraries in the Python community. + \ No newline at end of file diff --git a/source/developers/asyncio.markdown b/source/developers/asyncio.markdown index 2a456794d6..2cbf497eb6 100644 --- a/source/developers/asyncio.markdown +++ b/source/developers/asyncio.markdown @@ -9,19 +9,6 @@ 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 its 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: asyncio 101 »](/developers/asyncio_101/) - -[0.29]: /blog/2016/09/29/async-sleepiq-emoncms-stocks/ -[ben]: https://github.com/bbangert/ + \ No newline at end of file diff --git a/source/developers/asyncio_101.markdown b/source/developers/asyncio_101.markdown index c88265119f..a43c09893f 100644 --- a/source/developers/asyncio_101.markdown +++ b/source/developers/asyncio_101.markdown @@ -9,12 +9,6 @@ sharing: true footer: true --- -If you are not familiar yet with asyncio, please watch the below video. It's a great introduction by [Robert Smallshire][rob] in how and why asyncio works the way it does. - -
    - -
    - -### [Next step: Categorizing Functions »](/developers/asyncio_categorizing_functions/) - -[rob]: https://github.com/rob-smallshire \ No newline at end of file + \ No newline at end of file diff --git a/source/developers/asyncio_categorizing_functions.markdown b/source/developers/asyncio_categorizing_functions.markdown index 6fe74ad359..8b54b2058c 100644 --- a/source/developers/asyncio_categorizing_functions.markdown +++ b/source/developers/asyncio_categorizing_functions.markdown @@ -9,71 +9,6 @@ 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/) + \ No newline at end of file diff --git a/source/developers/asyncio_misc.markdown b/source/developers/asyncio_misc.markdown index 3fbc923c6f..ee6fd3def8 100644 --- a/source/developers/asyncio_misc.markdown +++ b/source/developers/asyncio_misc.markdown @@ -9,14 +9,6 @@ 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.5.3. - -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/ + \ No newline at end of file diff --git a/source/developers/asyncio_working_with_async.markdown b/source/developers/asyncio_working_with_async.markdown index 40fd82b246..5d66d66594 100644 --- a/source/developers/asyncio_working_with_async.markdown +++ b/source/developers/asyncio_working_with_async.markdown @@ -9,120 +9,6 @@ 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 %} - -To make a component async, implement an async_setup. - -```python -def setup(hass, config): - # Setup your component outside of the event loop. -``` - -Will turn into: - -```python -import asyncio - -@asyncio.coroutine -def async_setup(hass, config): - # Setup your component inside of the event loop. -``` - -## {% 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 async friendly callback `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 + \ No newline at end of file diff --git a/source/developers/code_review_component.markdown b/source/developers/code_review_component.markdown index bebe3dc784..3d2853668d 100644 --- a/source/developers/code_review_component.markdown +++ b/source/developers/code_review_component.markdown @@ -9,28 +9,6 @@ sharing: true footer: true --- -A checklist of things to do when you're adding a new component. - -

    -Not all existing platforms follow the requirements in this checklist. This cannot be used as a reason to not follow them! -

    - -### {% linkable_title 1. Requirements %} - - 1. Requirement version pinned: `REQUIREMENTS = ['phue==0.8.1']` - 2. We no longer want requirements hosted on GitHub. Please upload to PyPi. - 3. Requirements should only be imported inside functions. This is necessary because requirements are installed on the fly. - -### {% linkable_title 2. Configuration %} - - 1. Voluptuous schema present for config validation - 2. Default parameters specified in voluptuous schema, not in `setup(…)` - 3. Schema using as many generic config keys as possible from `homeassistant.const` - 4. If your component has platforms, define a `PLATFORM_SCHEMA` instead of a `CONFIG_SCHEMA`. - 5. If using a `PLATFORM_SCHEMA` to be used with `EntityComponent`, import base from `homeassistant.helpers.config_validation` - 6. Never depend on users adding things to `customize` to configure behavior inside your component. - -### {% linkable_title 3. Component/platform communication %} - - 1. If you need to share global data with platforms, use the dictionary `hass.data`. `hass.data[DATA_XY]` while `XY` is the component is preferred over `hass.data[DOMAIN]`. - 2. If the component fetches data that causes its related platform entities to update, you can notify them using the dispatcher code in `homeassistant.helpers.dispatcher`. + \ No newline at end of file diff --git a/source/developers/code_review_platform.markdown b/source/developers/code_review_platform.markdown index 00ab599c1b..0be7ec0a02 100644 --- a/source/developers/code_review_platform.markdown +++ b/source/developers/code_review_platform.markdown @@ -9,70 +9,6 @@ sharing: true footer: true --- -A checklist of things to do when you're adding a new platform. - -

    -Not all existing platforms follow the requirements in this checklist. This cannot be used as a reason to not follow them! -

    - -### {% linkable_title 1. Requirements %} - - 1. Requirement version should be pinned: `REQUIREMENTS = ['phue==0.8.1']` - 2. We no longer want requirements hosted on GitHub. Please upload to PyPi. - 3. Requirements should only be imported inside functions. This is necessary because requirements are installed on the fly. - -### {% linkable_title 2. Dependencies %} - - 1. If you depend on a component for the connection, add it to your dependencies: `DEPENDENCIES = ['nest']` - -### {% linkable_title 3. Configuration %} - - 1. Voluptuous schema present for config validation - 2. Voluptuous schema extends schema from component
    (e.g., `light.hue.PLATFORM_SCHEMA` extends `light.PLATFORM_SCHEMA`) - 3. Default parameters specified in voluptuous schema, not in `setup_platform(…)` - 4. Your `PLATFORM_SCHEMA` should use as many generic config keys as possible from `homeassistant.const` - ```python - import voluptuous as vol - - from homeassistant.const import CONF_FILENAME, CONF_HOST - from homeassistant.components.light import PLATFORM_SCHEMA - import homeassistant.helpers.config_validation as cv - - CONF_ALLOW_UNREACHABLE = 'allow_unreachable' - DEFAULT_UNREACHABLE = False - - PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - vol.Required(CONF_HOST): cv.string, - vol.Optional(CONF_ALLOW_UNREACHABLE, - default=DEFAULT_UNREACHABLE): cv.boolean, - vol.Optional(CONF_FILENAME): cv.string, - }) - ``` - 5. Never depend on users adding things to `customize` to configure behavior inside your platform. - -### {% linkable_title 4. Setup Platform %} - - 1. Test if passed in info (user/pass/host etc.) works. - 2. Group your calls to `add_devices` if possible. - 3. If platform adds extra services, format should be `._`. - -### {% linkable_title 5. Entity %} - - 1. Extend entity from component, e.g., `class HueLight(Light)` - 2. Do not call `update()` in constructor, use `add_devices(devices, True)` instead. - 3. Do not do any I/O inside properties. Cache values inside `update()` instead. - 4. The state and/or attributes should not contain relative time since something happened. Instead it should store UTC timestamps. - -### {% linkable_title 6. Communication with devices/services %} - - 1. All API specific code has to be part of a third party library hosted on PyPi. Home Assistant should only interact with objects and not make direct calls to the API. - -```python -# bad -status = requests.get(url('/status')) - -# good -from phue import Bridge -bridge = Bridge(…) -status = bridge.status() -``` + \ No newline at end of file diff --git a/source/developers/component_deps_and_reqs.markdown b/source/developers/component_deps_and_reqs.markdown index 2a6ae27d0e..0a9b6758eb 100644 --- a/source/developers/component_deps_and_reqs.markdown +++ b/source/developers/component_deps_and_reqs.markdown @@ -9,35 +9,6 @@ sharing: true footer: true --- -Home Assistant allows components and platforms to specify their dependencies and requirements using the variables `DEPENDENCIES` and `REQUIREMENTS`. Both are lists that contain strings. - -## {% linkable_title Dependencies %} - -Dependencies are other Home Assistant components that should be setup before the platform is loaded. An example is the MQTT sensor component, which requires an active connection to an MQTT broker. If Home Assistant is unable to load and setup the MQTT component, it will not setup the MQTT sensor component. - -```python -DEPENDENCIES = ['mqtt'] -``` - -## {% linkable_title Requirements %} - -Requirements are Python libraries or modules that you would normally install using `pip` for your component. Home Assistant will try to install the requirements into the `deps` subdirectory of the Home Assistant [configuration directory](/docs/configuration/) if you are not using a `venv` or in something like `path/to/venv/lib/python3.6/site-packages` if you running in a virtual environment. This will make sure that all requirements are present at startup. If steps fails like missing packages for the compilation of a module or other install errors, the component will fail to load. - -Requirements is a list of strings. Each entry is a `pip` compatible string. For example, the media player Cast platform depends on the Python package PyChromecast v0.6.12: - -```python -REQUIREMENTS = ['pychromecast==0.6.12'] -``` - -During development of a component, it can be useful to test against different versions of a requirement. This can be done in two steps, using pychromecast as an example: - -* `pip install pychromecast==0.6.13 --target ~/.homeassistant/deps` -* `hass --skip-pip` - -This will use the specified version, and prevent Home Assistant from trying to override it with what is currently in `REQUIREMENTS`. - -If you need to make changes to a requirement to support your component, it's also possible to `pip install` from a checkout of the requirement. - -* `git clone https://github.com/balloob/pychromecast.git` -* `pip install ./pychromecast` -* `hass --skip-pip` + \ No newline at end of file diff --git a/source/developers/component_discovery.markdown b/source/developers/component_discovery.markdown index 2911adaa26..69fb672d5f 100644 --- a/source/developers/component_discovery.markdown +++ b/source/developers/component_discovery.markdown @@ -9,52 +9,6 @@ sharing: true footer: true --- -

    -This option is only available for built-in components. -

    - -Home Assistant has a discovery service running in the background to discover new devices. Whenever a new device is discovered, a `SERVICE_DISCOVERED` event will be fired with the found service and the information. The `discovery` component has some knowledge about which components handle which type of services and will ensure those are loaded and listening before firing the `SERVICE_DISCOVERED` event. - -### {% linkable_title Add discovery instructions %} - -Device discovery for Home Assistant has been extracted into an external library called [NetDisco](https://github.com/home-assistant/netdisco). This library is integrated using [the `discovery` component](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/discovery.py) and scans the network in intervals for uPnP and zeroconf/mDNS services. - -To have your device be discovered, you will have to extend the NetDisco library to be able to find your device. This is done by adding a new discoverable. [See the repository for examples of existing discoverable.](https://github.com/home-assistant/netdisco/tree/master/netdisco/discoverables) - -### {% linkable_title Listening to `SERVICE_DISCOVERED` events %} - -From your component, you will have to set up the listening for specific services. Given below is an example how one would listen for a discovered AwesomeDevice: - -```python -from homeassistant.components.discovery import SERVICE_AWESOMEDEVICE -from homeassistant.helpers import discovery - -DOMAIN = 'awesomedevice' - -DEPENDENCIES = ['http'] - -def setup(hass, config): - cfg = config.get(DOMAIN) - - def device_discovered(service, info): - """ Called when a Awesome device has been discovered. """ - print("Discovered a new Awesome device: {}".format(info)) - - discovery.listen( - hass, SERVICE_AWESOMEDEVICE, device_discovered) - - return True -``` - -### {% linkable_title Auto-loading your component upon discovery %} - -The `discovery` component is capable of setting up your components before firing the `EVENT_PLATFORM_DISCOVERED` event. To do this you will have to update the [`SERVICE_HANDLERS`](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/discovery.py#L40) constant in [the `discovery` component](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/discovery.py): - -```python -SERVICE_AWESOMEDEVICE = 'awesomedevice' - -SERVICE_HANDLERS = { - ... - SERVICE_AWESOMEDEVICE: ('awesomedevice', None), -} -``` + \ No newline at end of file diff --git a/source/developers/component_events.markdown b/source/developers/component_events.markdown index ee2e281b1f..65f729e52d 100644 --- a/source/developers/component_events.markdown +++ b/source/developers/component_events.markdown @@ -9,4 +9,6 @@ sharing: true footer: true --- -Home Assistant has different ways of responding to events that occur in Home Assistant. These have been organized in [helper methods](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/event.py). Examples are `track_state_change`, `track_point_in_time`, `track_time_change`. + \ No newline at end of file diff --git a/source/developers/component_generic_discovery.markdown b/source/developers/component_generic_discovery.markdown index 8eacc22ff4..5fd2881601 100644 --- a/source/developers/component_generic_discovery.markdown +++ b/source/developers/component_generic_discovery.markdown @@ -9,69 +9,6 @@ sharing: true footer: true --- -New controller or hub components often need to add platforms in sub-components (i.e. Lights & Switches) without additional configuration. -This can be achieved using the `load_platform` or `async_load_platform` methods from `homeassistant.helpers.discovery`: - -```python -def load_platform(hass, component, platform, discovered=None, hass_config=None) -``` - -From more info on how this works, refer to the [load_platform](https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/helpers/discovery.py#L136) method. - -### {% linkable_title Example %} - -Say you need to implement your new MyFlashyHub that controls both Switches & Lights, you can follow these steps: - -Configuration required for your new hub component: - -```yaml -myflashyhub: - example: setting -``` - -The source for your component can be located in your configuration directory for now: - -```bash -~/.homeassistant/custom_components/myflashyhub.py -~/.homeassistant/custom_components/light/myflashyhub.py -~/.homeassistant/custom_components/switch/myflashyhub.py -``` - -In the hub component `myflashyhub.py` you can call your light and switch components. To pass any non-serializable information to the platforms in the sub-component, you can use a global variable. - -```python -from homeassistant.helpers.discovery import load_platform -DOMAIN = 'myflashyhub' - -DATA_MFH = 'MFH' - -def setup(hass, config): - """Your controller/hub specific code.""" - hass.data[DATA_MFH] = SomeObjectToInitialiseGlobal() - - #--- snip --- - load_platform(hass, 'light', DOMAIN) - load_platform(hass, 'switch', DOMAIN, {'optional': 'arguments'}) -``` - -Add your custom device specific code to the `setup_platform` method in `light/myflashyhub.py` and `switch/myflashyhub`. - -```python -import custom_components.myflashyhub as myflashyhub - -# 'switch' will receive discovery_info={'optional': 'arguments'} -# as passed in above. 'light' will receive discovery_info=None -def setup_platform(hass, config, add_devices, discovery_info=None): - """Your switch/light specific code.""" - # You can now use hass.data[myflashyhub.DATA_MFH] -``` - - -The `load_platform` method allows the platforms to be loaded without the need for any additional platform entries in your `configuration.yaml` file, which normally would have been: - -```yaml -#light: -# platform: myflashyhub -#switch: -# platform: myflashyhub -``` + \ No newline at end of file diff --git a/source/developers/component_loading.markdown b/source/developers/component_loading.markdown index b817fadf38..f5c6e04e9f 100644 --- a/source/developers/component_loading.markdown +++ b/source/developers/component_loading.markdown @@ -9,17 +9,6 @@ sharing: true footer: true --- -A component will be loaded on start if a section (ie. `light:`) for it exists in the config file. A component can also be loaded if another component is loaded that depends on it. When loading a component Home Assistant will check the following paths: - - * `/custom_components/` - * `homeassistant/components/` (built-in components) - -Once loaded, a component will only be setup if all dependencies can be loaded and are able to setup. Keep an eye on the logs to see if your component could be loaded and initialized. - -

    -You can override a built-in component by having a component with the same name in your config/custom_components folder. If the built-in component is inside a subfolder, take care to place your customization in a folder with the same name in config/custom_components/*folder*. Note that overriding built-in components is not recommended and will probably break things! -

    - -

    -Home Assistant will use the directory that contains your config file as the directory that holds your customizations. By default this is the config folder in your current work directory. You can use a different folder by running Home Assistant with the --config argument: python3 homeassistant --config /YOUR/CONFIG/PATH/. -

    + \ No newline at end of file diff --git a/source/developers/component_states.markdown b/source/developers/component_states.markdown index f89803699a..d94c5b12ba 100644 --- a/source/developers/component_states.markdown +++ b/source/developers/component_states.markdown @@ -9,14 +9,6 @@ sharing: true footer: true --- -It is the responsibility of the component to maintain the states of the devices in your domain. Each device should be a single state and, if possible, a group should be provided that tracks the combined state of the devices. - -A state can have several attributes that will help the frontend in displaying your state: - -- `friendly_name`: this name will be used as the name of the device -- `entity_picture`: this picture will be shown instead of the domain icon -- `unit_of_measurement`: this will be appended to the state in the interface -- `hidden`: This is a suggestion to the frontend on if the state should be hidden - -These attributes are defined in [homeassistant.helpers.entity](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py#L180). - + \ No newline at end of file diff --git a/source/developers/component_visibility.markdown b/source/developers/component_visibility.markdown index 333c627cf5..29a84a747d 100644 --- a/source/developers/component_visibility.markdown +++ b/source/developers/component_visibility.markdown @@ -9,13 +9,6 @@ sharing: true footer: true --- -Generally, when creating a new entity for Home Assistant you will want it to be a class that inherits the [homeassistant.helpers.entity.Entity](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/entity.py) class. If this is done, visibility will be handled for you. -You can set a suggestion for your entity's visibility by setting the `hidden` property by doing something similar to the following. - -```python -self.hidden = True -``` - -This will SUGGEST that the active frontend hides the entity. This requires that the active frontend support hidden cards (the default frontend does) and that the value of hidden be included in your attributes dictionary (see above). The Entity abstract class will take care of this for you. - -Remember: The suggestion set by your component's code will always be overwritten by user settings in the `configuration.yaml` file. This is why you may set hidden to be `False`, but the property may remain `True` (or vice-versa). + \ No newline at end of file diff --git a/source/developers/creating_components.markdown b/source/developers/creating_components.markdown index f52629db8a..678014da4f 100644 --- a/source/developers/creating_components.markdown +++ b/source/developers/creating_components.markdown @@ -9,19 +9,6 @@ sharing: true footer: true --- -Alright, you're ready to make your first component. AWESOME. Don't worry, we've tried hard to keep it as easy as possible. - -### {% linkable_title Example component %} - -Add `hello_state:` to your `configuration.yaml` file and create a file `/custom_components/hello_state.py` with the below code to test it locally. - -```python -DOMAIN = 'hello_state' - -def setup(hass, config): - hass.states.set('hello.world', 'Paulus') - - return True -``` - -For more examples, see the [Custom Python Component Examples](/cookbook/#custom-python-component-examples) on our examples page. + \ No newline at end of file diff --git a/source/developers/development.markdown b/source/developers/development.markdown index 8bc614295d..ea7c7bd480 100644 --- a/source/developers/development.markdown +++ b/source/developers/development.markdown @@ -9,23 +9,6 @@ sharing: true footer: true --- -Home Assistant is built from the ground up to be easily extensible using components. Home Assistant uses [Python 3](https://www.python.org/) for the backend and [Polymer (Web components)](https://www.polymer-project.org/) for the frontend. - -Home Assistant is open-source and licensed under [Apache 2.0](http://www.apache.org/licenses/LICENSE-2.0). Here are links to the source: - - - [home-assistant](https://github.com/home-assistant/home-assistant): Python server backend. - - [home-assistant-polymer](https://github.com/home-assistant/home-assistant-polymer): Polymer UI. - -For those new to contributing to open source software, make sure you are familiar with all of the tools and concepts used in Home Assistant before you start. - -When contributing Home Assistant code: - - [Github](https://guides.github.com/activities/hello-world/) - - [Pip and Virtual Environments](https://www.dabapps.com/blog/introduction-to-pip-and-virtualenv-python/) - - [Python 3](https://www.python.org/) - - [Pylint](https://www.pylint.org) - - [Flake8](http://flake8.pycqa.org/en/latest/) - - [Tox](http://tox.readthedocs.org/en/latest/) - - [TravisCl](https://travis-ci.org/) - -When contributing 3rd Party code to be used by Home Assistant: - - [Publishing your own PyPI package](https://jeffknupp.com/blog/2013/08/16/open-sourcing-a-python-project-the-right-way/) + \ No newline at end of file diff --git a/source/developers/development_101.markdown b/source/developers/development_101.markdown index 5db0cdf128..7e4858e890 100644 --- a/source/developers/development_101.markdown +++ b/source/developers/development_101.markdown @@ -9,49 +9,6 @@ sharing: true footer: true --- -The goal of development 101 is to get you familiar with the basics of developing for Home Assistant. Before we start, please make sure you familiarize yourself with the [architecture]. - -To get our code running inside Home Assistant we're going to create a custom component. The first step is to locate your config folder. You can find the path to your config folder by opening the Home Assistant frontend, click on the service developer tool icon. It's the path after the text "Path to configuration.yaml". - -Inside your configuration directory create a new folder called `custom_components`. It might be that one already exists, that's fine too. This is the folder that Home Assistant will look at when looking for custom code. - -

    -The Home Assistant API has two variants: a synchronous and an asynchronous version (asyncio). This development course will focus on the synchronous version. -

    - -To verify that everything is working correctly, let's create a small Hello World component. To do so, create a file called `hello_world.py` in your custom components folder. Copy paste the following content to it: - -```python -# The domain of your component. Equal to the filename of your component. -DOMAIN = "hello_world" - - -def setup(hass, config): - """Setup the hello_world component.""" - # States are in the format DOMAIN.OBJECT_ID. - hass.states.set('hello_world.Hello_World', 'Works!') - - # Return boolean to indicate that initialization was successfully. - return True -``` - -Last step is to add `hello_world:` entry to your `configuration.yaml` file. - -```yaml -# Hello World component -hello_world: -``` - -After running `hass`, we should see log entries stating that `hello_world` component was loaded. What is more, additional state card shall appear within main panel. - -```log -2018-04-03 21:44:20 INFO (MainThread) [homeassistant.loader] Loaded hello_world from custom_components.hello_world -2018-04-03 21:44:20 INFO (MainThread) [homeassistant.setup] Setting up hello_world -``` - -

    - -State card showing that Hello World component is working as intended. -

    - -[architecture]: /developers/architecture/ + \ No newline at end of file diff --git a/source/developers/development_catching_up.markdown b/source/developers/development_catching_up.markdown index 88f4b73e07..30d098ce99 100644 --- a/source/developers/development_catching_up.markdown +++ b/source/developers/development_catching_up.markdown @@ -9,33 +9,6 @@ sharing: true footer: true --- -If it's taking a while to develop your feature, and you want to catch up with what's in the current Home Assistant `dev` branch, you can use `git rebase`. This will pull the latest Home Assistant changes locally, rewind your commits, bring in the latest changes from Home Assistant, and replay all of your commits on top. - -```bash -# Run this from your feature branch -$ git fetch upstream dev # to pull the latest changes into a local dev branch -$ git rebase upstream/dev # to put those changes into your feature branch before your changes -``` - -If rebase detects conflicts, repeat this process until all changes have been resolved: - -1. `git status` shows you the file with the conflict; edit the file and resolve the lines between `<<<< | >>>>` -3. Add the modified file: `git add ` or `git add .` -4. Continue rebase: `git rebase --continue` -5. Repeat until you've resolved all conflicts - -After rebasing your branch, you will have rewritten history relative to your GitHub fork's branch. When you go to push you will see an error that your history has diverged from the original branch. In order to get your GitHub fork up-to-date with your local branch, you will need to force push, using the following command: - -```bash -# Run this from your feature branch -$ git push origin --force -``` - -Other workflows are covered in detail in the [Github documentation](https://help.github.com/articles/fork-a-repo/). Add an additional `remote` after you clone your fork. - -```bash -$ git remote add upstream https://github.com/home-assistant/home-assistant.git -``` - -Then, `git pull --rebase upstream dev`. - + \ No newline at end of file diff --git a/source/developers/development_checklist.markdown b/source/developers/development_checklist.markdown index 3fe199b8ea..7fb17c4368 100644 --- a/source/developers/development_checklist.markdown +++ b/source/developers/development_checklist.markdown @@ -9,12 +9,6 @@ sharing: true footer: true --- - -Before you commit any changes, check your work against these requirements: - -- All dependencies from [pypi](https://pypi.python.org/pypi) are included via the `REQUIREMENTS` variable in your platform or component and only imported inside functions that use them -- New dependencies are added to `requirements_all.txt` (if applicable), using `script/gen_requirements_all.py` -- The `.coveragerc` file is updated to exclude your platform if there are no tests available or your new code uses a third-party library for communication with the device, service, or sensor -- Documentation is developed for [home-assistant.io](/) - * It's OK to start with adding a docstring with configuration details (for example, sample entry for `configuration.yaml` file) to the file header. Visit the [website documentation](/developers/documentation/) for more information about contributing to [home-assistant.io](https://github.com/home-assistant/home-assistant.github.io). - + \ No newline at end of file diff --git a/source/developers/development_config.markdown b/source/developers/development_config.markdown index 56382ecb61..5d89b5b2b5 100644 --- a/source/developers/development_config.markdown +++ b/source/developers/development_config.markdown @@ -9,27 +9,6 @@ sharing: true footer: true --- -Based on where you are in the code, `config` can mean various things. - -### {% linkable_title On the hass object %} - -On the hass object is an instance of the Config class. The Config class contains the users preferred units, the path to the config directory and which components are loaded. [See available methods.](https://dev-docs.home-assistant.io/en/master/api/core.html#homeassistant.core.Config) - -### {% linkable_title Config passed into component setup %} - -The `config` parameter passed to a component setup is a dictionary containing all of the user supplied configuration. The keys of the dictionary are the component names and the value is another dictionary with the component configuration. - -The object will have already been validated using your `CONFIG_SCHEMA` or `PLATFORM_SCHEMA` if available. If you have defined a `PLATFORM_SCHEMA`, all references to your component (ie `light 2:` etc) will have been changed to be accessible as a list under `config[DOMAIN]`. - -If your configuration file contains the following lines: - -```yaml -example: - host: paulusschoutsen.nl -``` - -Then in the setup method of your component you will be able to refer to `config['example']['host']` to get the value `paulusschoutsen.nl`. - -### {% linkable_title Passed into platform setup %} - -The `config` parameter passed to a platform setup function is only the config for that specific platform. + \ No newline at end of file diff --git a/source/developers/development_environment.markdown b/source/developers/development_environment.markdown index b198bebbbb..4671f6ec64 100644 --- a/source/developers/development_environment.markdown +++ b/source/developers/development_environment.markdown @@ -9,102 +9,6 @@ sharing: true footer: true --- -You'll need to set up a development environment if you want to develop a new feature or component for Home Assistant. Read on to learn how to set up. - -### {% linkable_title Preparing your environment %} - -#### {% linkable_title Developing on Linux %} - -Install the core dependencies. - -```bash -$ sudo apt-get install python3-pip python3-dev python3-venv -``` - -In order to run `script/setup` below you will need some more dependencies. - -```bash -$ sudo apt-get install libssl-dev libxml2-dev libxslt1-dev libjpeg-dev libffi-dev libudev-dev zlib1g-dev -``` - -

    -Different distributions have different package installation mechanisms and sometimes packages names as well. For example Centos would use: `sudo yum install epel-release && sudo yum install python34 python34-devel mysql-devel` -

    - -Additional dependencies exist if you plan to perform Frontend Development, please read the [Frontend](/developers/frontend/) section to learn more. - -#### {% linkable_title Developing on Windows %} - -If you are using Windows as a development platform, make sure that you have the correct Microsoft [Visual C++ build tools](http://landinghub.visualstudio.com/visual-cpp-build-tools) installed. The installation of the most requirements and validation using `tox` will fail if this is not done correctly. Check the [Windows Compilers](https://wiki.python.org/moin/WindowsCompilers) section on the [Python website](https://www.python.org/) for details. - -Due to Home Assistant is mainly designed and developed on Linux distributions it is not recommended to develop on Windows machines. However on Windows 10 machines you should decide to set up a [Linux subsystem](https://docs.microsoft.com/de-de/windows/wsl/install-win10). - -Setup Linux subsystem. - -```bash -$ apt-get update -$ apt-get upgrade -$ echo 'export DISPLAY=:0' >> ~/.bashrc && . ~/.bashrc -$ sudo apt-get install xubuntu-desktop -y -``` - -It is recommended using [PyCharm](https://www.jetbrains.com/pycharm/download/) as debugger. Download and start PyCharm. - -```bash -$ wget https://download.jetbrains.com/python/pycharm-community-20XX.X.tar.gz -$ tar -xzf pycharm-community-20XX.X -$ ./pycharm.sh -``` - -In order to display the PyCharm GUI on Windows you need to run a X-Server like [VcXserv](https://sourceforge.net/projects/vcxsrv/). - -Also, make sure to install or upgrade the `setuptools` Python package. It contains compatibility improvements and adds automatic use of compilers: - -```bash -$ pip install --upgrade setuptools -``` - -#### {% linkable_title Developing on OS X %} - -Install [Homebrew](https://brew.sh/), then use that to install Python 3: - -```bash -$ brew install python3 -``` - -### {% linkable_title Setup Local Repository %} - -Visit the [Home Assistant repository](https://github.com/home-assistant/home-assistant) and click **Fork**. -Once forked, setup your local copy of the source using the commands: - -```bash -$ git clone https://github.com/YOUR_GIT_USERNAME/home-assistant.git -$ cd home-assistant -$ git remote add upstream https://github.com/home-assistant/home-assistant.git -``` - -### {% linkable_title Setting up virtual environment %} - -To isolate your environment from the rest of the system, set up a [`venv`](https://docs.python.org/3/library/venv.html). Within the `home-assistant` directory, create and activate your virtual environment. - -```bash -$ python3 -m venv . -$ source bin/activate -``` -Install the requirements with a provided script named `setup`. - -```bash -$ script/setup -``` - -Invoke your installation. - -```bash -$ hass -``` - -### {% linkable_title Logging %} - -By default logging in home-assistant is tuned for operating in production (set to INFO by default, with some modules set to even less verbose logging levels). - -You can use the [logger](/components/logger/) component to adjust logging to DEBUG to see even more details about what is going on. + \ No newline at end of file diff --git a/source/developers/development_events.markdown b/source/developers/development_events.markdown index e078396fd0..2552fb8e2f 100644 --- a/source/developers/development_events.markdown +++ b/source/developers/development_events.markdown @@ -9,54 +9,6 @@ sharing: true footer: true --- -The core of Home Assistant is driven by events. That means that if you want to respond to something happening, you'll have to respond to events. Most of the times you won't interact directly with the event system but use one of the [event listener helpers][helpers]. - -The event system is very flexible. There are no limitations on the event type, as long as it's a string. Each event can contain data. The data is a dictionary that can contain any data as long as it's JSON serializable. This means that you can use number, string, dictionary and list. - -[List of events that Home Assistant fires.][object] - -### {% linkable_title Firing events %} - -To fire an event, you have to interact with the event bus. The event bus is available on the Home Assistant instance as `hass.bus`. - -Example component that will fire an event when loaded. - -```python -DOMAIN = 'hello_event' - -def setup(hass, config): - """Set up is called when Home Assistant is loading our component.""" - - # Fire event my_cool_event with event data answer=42 - hass.bus.fire('my_cool_event', { - 'answer': 42 - }) -``` - -### {% linkable_title Listening to events %} - -Most of the times you'll not be firing events but instead listen to events. For example, the state change of an entity is broadcasted as an event. - -```python -DOMAIN = 'hello_event' - -def setup(hass, config): - """Set up is called when Home Assistant is loading our component.""" - count = 0 - - # Listener to handle fired events - def handle_event(event): - nonlocal count - count += 1 - print('Total events received:', count) - - # Listen for when my_cool_event is fired - hass.bus.listen('my_cool_event', handle_event) -``` - -#### {% linkable_title Helpers %} - -Home Assistant comes with a lot of bundled helpers to listen to specific types of event. There are helpers to track a point in time, to track a time interval, a state change or the sun set. [See available methods.][helpers] - -[helpers]: https://dev-docs.home-assistant.io/en/master/api/helpers.html#module-homeassistant.helpers.event -[object]: /docs/configuration/events/ + \ No newline at end of file diff --git a/source/developers/development_guidelines.markdown b/source/developers/development_guidelines.markdown index 7e4088249c..e368c75a1e 100644 --- a/source/developers/development_guidelines.markdown +++ b/source/developers/development_guidelines.markdown @@ -9,73 +9,6 @@ sharing: true footer: true --- -Home Assistant enforces strict [PEP8 style](https://www.python.org/dev/peps/pep-0008/) and [PEP 257 (Docstring Conventions)](https://www.python.org/dev/peps/pep-0257/) compliance on all code submitted. We automatically test every pull request as part of the linting process with [Coveralls](https://coveralls.io/github/home-assistant/home-assistant) and [Travis CI](https://travis-ci.org/home-assistant/home-assistant). - -Summary of the most relevant points: - -- Line length is limited to 79 characters (see below). -- Use 4 spaces per indentation level. We don't use tabs. -- Comments should be full sentences and end with a period. -- [Imports](https://www.python.org/dev/peps/pep-0008/#imports) should be ordered. -- Constants and the content of lists and dictionaries should be in alphabetical order. -- Avoid trailing whitespace but surround binary operators with a single space. -- Line separator should be set to `LF`. - -The maximum line length comes directly from the [PEP8 style guide](https://www.python.org/dev/peps/pep-0008/#maximum-line-length), and is also used by the Python standard library. All code must pass these linting checks, and no exceptions will be made. There have already been numerous requests to increase the maximum line length, but after evaluating the options, the Home Assistant maintainers have decided to stay at 79 characters. This decision is final. - -Those points may require that you adjust your IDE or editor settings. - -## {% linkable_title Our recommendations %} - -For some cases [PEPs](https://www.python.org/dev/peps/) don't make a statement. This section covers our recommendations about the code style. Those points were collected from the existing code and based on what contributors and developers were using the most. This is basically a majority decision, thus you may not agree with it. But we would like to encourage you follow those recommendations to keep the code unified. - -### {% linkable_title Quotes %} - -Use single quotes `'` for single word and `"` for multiple words or sentences. - -```python -ATTR_WATERLEVEL = 'level' -CONF_ATTRIBUTION = "Data provided by the WUnderground weather service" -SENSOR_TYPES = { - 'alerts': ['Alerts', None], -} -``` - -### {% linkable_title File headers %} - -The docstring in the file header should contain a link to the documentation to make it easy to find further information, especially about the configuration or details which are not mentioned in the code. - -```python -""" -Support for MQTT lights. - -For more details about this platform, please refer to the documentation at -https://home-assistant.io/components/light.mqtt/ -""" -``` - -### {% linkable_title Requirements %} - -Please place [Platform requirements](/developers/code_review_platform/#1-requirements) right after the imports. - -```python -[...] -from homeassistant.helpers.entity import Entity - -REQUIREMENTS = ['xmltodict==0.11.0'] -``` - -### {% linkable_title Log messages %} - -There is no need to add the platform or component name to the log messages. This will be added automatically. Like `syslog` messages there shouldn't be any period at the end. Try to avoid brackets and additional quotes around the output to make it easier for users to parse the log. A widely style is shown below but you are free to compose the messages as you like. - -```python -_LOGGER.error("No route to device: %s", self._resource) -``` - -```bash -2017-05-01 14:28:07 ERROR [homeassistant.components.sensor.arest] No route to device: 192.168.0.18 -``` - -Don't print out wrong API keys, tokens, usernames, or passwords. -Also note that `_LOGGER.info` is reserved for the core, use `_LOGGER.debug` in anything else. + \ No newline at end of file diff --git a/source/developers/development_hass_object.markdown b/source/developers/development_hass_object.markdown index d4a5926d2e..e4554ecf7b 100644 --- a/source/developers/development_hass_object.markdown +++ b/source/developers/development_hass_object.markdown @@ -10,29 +10,6 @@ footer: true redirect_from: /developers/component_initialization/ --- -While developing Home Assistant you will see a variable that is everywhere: `hass`. This is the Home Assistant instance that will give you access to all the various parts of the system. - -### {% linkable_title The `hass` object %} - -The Home Assistant instance contains four objects to help you interact with the system. - -| Object | Description | -| ------ | ----------- | -| `hass` | This is the instance of Home Assistant. Allows starting, stopping and enqueing new jobs. [See available methods.](https://dev-docs.home-assistant.io/en/master/api/core.html#homeassistant.core.HomeAssistant) -| `hass.config` | This is the core configuration of Home Assistant exposing location, temperature preferences and config directory path. [See available methods.](https://dev-docs.home-assistant.io/en/master/api/core.html#homeassistant.core.Config) -| `hass.states` | This is the StateMachine. It allows you to set states and track when they are changed. [See available methods.](https://dev-docs.home-assistant.io/en/master/api/core.html#homeassistant.core.StateMachine). | -| `hass.bus` | This is the EventBus. It allows you to trigger and listen for events. [See available methods.](https://dev-docs.home-assistant.io/en/master/api/core.html#homeassistant.core.EventBus). | -| `hass.services` | This is the ServiceRegistry. It allows you to register services. [See available methods.](https://dev-docs.home-assistant.io/en/master/api/core.html#homeassistant.core.ServiceRegistry). | - -### {% linkable_title Where to find `hass` %} - -Depending on what you're writing, there are different ways the `hass` object is made available. - -**Component**
    -Passed into `setup(hass, config)` or `async_setup(hass, config)`. - -**Platform**
    -Passed into `setup_platform(hass, config, add_devices, discovery_info=None)` or `async_setup_platform(hass, config, async_add_devices, discovery_info=None)`. - -**Entity**
    -Available as `self.hass` once the entity has been added via the `add_devices` callback inside a platform. + \ No newline at end of file diff --git a/source/developers/development_services.markdown b/source/developers/development_services.markdown index 1aa11397ed..6d5c203374 100644 --- a/source/developers/development_services.markdown +++ b/source/developers/development_services.markdown @@ -9,47 +9,6 @@ sharing: true footer: true --- -This is a simple "hello world" example to show the basics of registering a service. To use this example, create the file `/custom_components/hello_service.py` and copy the below example code. - -Services can be called from automation and from the service "Developer tools" in the frontend. - -```python -# The domain of your component. Should be equal to the name of your component. -DOMAIN = 'hello_service' - -ATTR_NAME = 'name' -DEFAULT_NAME = 'World' - - -def setup(hass, config): - """Set up is called when Home Assistant is loading our component.""" - - def handle_hello(call): - name = call.data.get(ATTR_NAME, DEFAULT_NAME) - - hass.states.set('hello_service.hello', name) - - hass.services.register(DOMAIN, 'hello', handle_hello) - - # Return boolean to indicate that initialization was successfully. - return True -``` - -Load the component by adding the following to your `configuration.yaml`. When your component is loaded, a new service should be available to call. - -```yaml -# configuration.yaml entry -hello_service: -``` - -Open the frontend and in the sidebar, click the first icon in the developer tool section. This will open the Call Service developer tool. On the right, find your service and click on it. This will automatically fill in the correct values. - -Pressing "Call Service" will now call your service without any parameters. This will cause your service to create a state with the default name 'World'. If you want to specify the name, you have to specify parameters. Add the following JSON as Service Data and press "Call Service again". - -```json -{ - "name": "Planet" -} -``` - -The service will now overwrite the previous state with "Planet". + \ No newline at end of file diff --git a/source/developers/development_states.markdown b/source/developers/development_states.markdown index e1161ffcca..cf3db78b4d 100644 --- a/source/developers/development_states.markdown +++ b/source/developers/development_states.markdown @@ -9,132 +9,6 @@ sharing: true footer: true --- -Home Assistant keeps track of the states of entities in a state machine. The state machine has very few requirements: - - - Each state is related to an entity identified by an entity id. This id is made up of a domain and an object id. For example `light.kitchen_ceiling`. You can make up any combination of domain and object id, even overwriting existing states. - - Each state has a primary attribute that describes the state of the entity. In the case of a light this could be for example "on" and "off". You can store anything you want in the state, as long as it's a string (will be converted if it's not). - - You can store more information about an entity by setting attributes. Attributes is a dictionary that can contain any data that you want. The only requirement is that it's JSON serializable, so you're limited to numbers, strings, dictionaries and lists. - -[Description of the state object.](/docs/configuration/state_object/) - -### {% linkable_title Using states in your component %} - -This is a simple tutorial/example on how to create and set states. We will do our work in a component called "hello_state". The purpose of this component is to display a given text in the frontend. - -To get started, create the file `/custom_components/hello_state.py` and copy the below example code. - -```python -""" -Support for showing text in the frontend. - -For more details about this component, please refer to the documentation at -https://home-assistant.io/cookbook/python_component_basic_state/ -""" -import logging - -_LOGGER = logging.getLogger(__name__) - -DOMAIN = 'hello_state' -DEPENDENCIES = [] - -def setup(hass, config): - """Setup the Hello State component. """ - _LOGGER.info("The 'hello state' component is ready!") - - return True -``` - -1. In the file header we decided to add some details: A short description and the link to the documentation. -2. We want to do some logging. This means that we import the Python logging module and create an alias. -3. The component name is equal to the domain name. -4. At the moment this component has no dependencies. For detail check [dependencies](/developers/component_deps_and_reqs/#dependencies) section. -5. The `setup` function will take care of the initialization of our component. - The component will only write a log message. Keep in mind for later that you have several options for the severity: - - - `_LOGGER.info(msg)` - - `_LOGGER.warning(msg)` - - `_LOGGER.error(msg)` - - `_LOGGER.critical(msg)` - - `_LOGGER.exception(msg)` - -7. We return `True` if everything is ok. - -Add the component to your `configuration.yaml` file. - -```yaml -hello_state: -``` - -After a start or a restart of Home Assistant the component will create an entry in the log. - -```bash -16-03-12 14:16:42 INFO (MainThread) [custom_components.hello_state] The 'hello state' component is ready! -``` - -The next step is the introduction of configuration options. A user can pass configuration options to our component via `configuration.yaml`. To use them we'll use the passed in `config` variable to our `setup` method. - -```python -import logging - -_LOGGER = logging.getLogger(__name__) - -DOMAIN = 'hello_state' -DEPENDENCIES = [] - -CONF_TEXT = 'text' -DEFAULT_TEXT = 'No text!' - -def setup(hass, config): - """Set up the Hello State component. """ - # Get the text from the configuration. Use DEFAULT_TEXT if no name is provided. - text = config[DOMAIN].get(CONF_TEXT, DEFAULT_TEXT) - - # States are in the format DOMAIN.OBJECT_ID - hass.states.set('hello_state.Hello_State', text) - - return True -``` - -To use the latest feature of our component, update the entry in your `configuration.yaml` file. - -```yaml -hello_state: - text: 'Hello, World!' -``` - -Thanks to `DEFAULT_TEXT` variable the component will launch even if no `text:` field is used in the `configuration.yaml` file. Quite often there are variables which are required. It's important to check if all mandatory configuration variables are provided. If not, the setup should fail. We will use `voluptuous` as a helper to achieve this. The next listing shows the essential parts. - -```python -import voluptuous as vol - -import homeassistant.helpers.config_validation as cv - -CONFIG_SCHEMA = vol.Schema({ - DOMAIN: vol.Schema({ - vol.Required(CONF_TEXT): cv.string, - }) -}, extra=vol.ALLOW_EXTRA) -``` - -Now, when `text:` is missing from the config, Home Assistant will alert the user and not setup your component. - -After a start or a restart of Home Assistant the component will be visible in the frontend if the `configuration.yaml` file is up-to-date. - -

    - -

    - -In order to expose attributes for a platform, you will need to define a property called `device_state_attributes` on the entity class, which will return a dictionary of attributes: - -``` -@property -def device_state_attributes(self): - """Return device specific state attributes.""" - return self._attributes -``` - -

    -Entities also have a similar property `state_attributes`, which normally doesn't need to be defined by new platforms. This property is used by base components to add standard sets of attributes to a state. Example: The light component uses `state_attributes` to add brightness to the state dictionary. If you are designing a new component, you should define `state_attributes` instead. -

    - -To get your component included in the Home Assistant releases, follow the steps described in the [Submit your work](/developers/development_submitting/) section. Basically you only need to move your component in the `homeassistant/component/` directory of your fork and create a Pull Request. + \ No newline at end of file diff --git a/source/developers/development_submitting.markdown b/source/developers/development_submitting.markdown index b1439e4551..aaeadba89f 100644 --- a/source/developers/development_submitting.markdown +++ b/source/developers/development_submitting.markdown @@ -9,39 +9,6 @@ sharing: true footer: true --- -Submit your improvements, fixes, and new features to Home Assistant one at a time, using GitHub [Pull Requests](https://help.github.com/articles/using-pull-requests). Here are the steps: - - 1. From your fork's dev branch, create a new branch to hold your changes: - - `git checkout -b some-feature` - - 2. Make your changes, create a [new platform](/developers/add_new_platform/), develop a [new component](/developers/creating_components/), or fix [issues](https://github.com/home-assistant/home-assistant/issues). - - 3. [Test your changes](/developers/development_testing/) and check for style violations. - - 4. If everything looks good according to these [musts](/developers/development_checklist/), commit your changes: - - `git add .` - - `git commit -m "Added some-feature"` - - * Write a meaningful commit message and not only `Update` or `Fix`. - * Use a capital letter to start with your commit message. - * Don't prefix your commit message with `[bla.bla]` or `platform:`. - * Consider adding tests to ensure that your code works. - - 5. Push your committed changes back to your fork on GitHub: - - `git push origin HEAD` - - 6. Follow [these steps](https://help.github.com/articles/creating-a-pull-request/) to create your pull request. - - * On GitHub, navigate to the main page of the Home Assistant repository. - * In the "Branch" menu, choose the branch that contains your commits (from your fork). - * To the right of the Branch menu, click **New pull request**. - * Use the base branch dropdown menu to select the branch you'd like to merge your changes into, then use the compare branch drop-down menu to choose the topic branch you made your changes in. Make sure the Home Assistant branch matches with your forked branch (`dev`) else you will propose ALL commits between branches. - * Type a title and complete the provided description for your pull request. - * Click **Create pull request**. - - 7. Check for comments and suggestions on your pull request and keep an eye on the [CI output](https://travis-ci.org/home-assistant/home-assistant/). - + \ No newline at end of file diff --git a/source/developers/development_testing.markdown b/source/developers/development_testing.markdown index a4f462690d..dc24f7bbfe 100644 --- a/source/developers/development_testing.markdown +++ b/source/developers/development_testing.markdown @@ -9,68 +9,6 @@ sharing: true footer: true --- -As states in the [Style guidelines section](/developers/development_guidelines/) all code is checked to verify all unit tests pass and that the code passes the linting tools. Local testing is done using Tox, which has been installed as part of running `script/setup`. To start the tests, simply run it: - -```bash -$ tox -``` -**Important:** Run `tox` before you create your pull request to avoid annoying fixes. - -Running Tox will run unit tests against the locally available Pythons, as well as validate the code and document style using `pycodestyle`, `pydocstyle` and `pylint`. You can run tests on only one tox target -- just use `-e` to select an environment. For example, `tox -e lint` runs the linters only, and `tox -e py36` runs unit tests only on Python 3.6. - -Tox uses virtual environments under the hood to create isolated testing environments. The tox virtual environments will get out-of-date when requirements change, causing test errors. Run `tox -r` to tell Tox to recreate the virtual environments. - -If you are working on tests for a component or platform and you need the dependencies available inside the Tox environment, update the list inside `script/gen_requirements_all.py`. Then run the script and then run `tox -r` to recreate the virtual environments. - -### {% linkable_title Running single tests using Tox %} - -You can pass arguments via Tox to py.test to be able to run single test suites or test files. Replace `py36` with the Python version that you use. - -```bash -# Stop after the first test fails -$ tox -e py36 -- tests/test_core.py -x -# Run test with specified name -$ tox -e py36 -- tests/test_core.py -k test_split_entity_id -# Fail a test after it runs for 2 seconds -$ tox -e py36 -- tests/test_core.py --timeout 2 -# Show the 10 slowest tests -$ tox -e py36 -- tests/test_core.py --duration=10 -``` - -### {% linkable_title Testing outside of Tox %} - -Running tox will invoke the full test suite. Even if you specify which tox target to run, you still run all tests inside that target. That's not very convenient to quickly iterate on your code! To be able to run the specific test suites without Tox, you'll need to install the test dependencies into your Python environment: - -```bash -$ pip3 install -r requirements_test_all.txt -``` - -Now that you have all test dependencies installed, you can run tests on individual files: - -```bash -$ flake8 homeassistant/core.py -$ pylint homeassistant/core.py -$ pydocstyle homeassistant/core.py -$ py.test tests/test_core.py -``` - -You can also run linting tests against all changed files, as reported by `git diff upstream/dev... --diff-filter=d --name-only`, using the `lint` script: - -```bash -$ script/lint -``` - -### {% linkable_title Preventing Linter Errors %} - -Save yourself the hassle of extra commits just to fix style errors by enabling the Flake8 git commit hook. Flake8 will check your code when you try to commit to the repository and block the commit if there are any style errors, which gives you a chance to fix them! - -```bash -$ pip3 install flake8 flake8-docstrings -$ flake8 --install-hook=git -``` - -The `flake8-docstrings` extension will check docstrings according to [PEP257](https://www.python.org/dev/peps/pep-0257/) when running Flake8. - -### {% linkable_title Notes on PyLint and PEP8 validation %} - -If you can't avoid a PyLint warning, add a comment to disable the PyLint check for that line with `# pylint: disable=YOUR-ERROR-NAME`. Example of an unavoidable one is if PyLint incorrectly reports that a certain object doesn't have a certain member. + \ No newline at end of file diff --git a/source/developers/development_validation.markdown b/source/developers/development_validation.markdown index 30b3dc77a8..207b61b7d2 100644 --- a/source/developers/development_validation.markdown +++ b/source/developers/development_validation.markdown @@ -9,79 +9,6 @@ sharing: true footer: true --- -The `configuration.yaml` file contains the configuration options for components and platforms. We use [voluptuous](https://pypi.python.org/pypi/voluptuous) to make sure that the configuration provided by the user is valid. Some entries are optional or could be required to set up a platform or a component. Others must be a defined type or from an already-defined list. - -We test the configuration to ensure that users have a great experience and minimize notifications if something is wrong with a platform or component setup before Home Assistant runs. - -Besides [voluptuous](https://pypi.python.org/pypi/voluptuous) default types, many custom types are available. For an overview, take a look at the [config_validation.py](https://github.com/home-assistant/home-assistant/blob/master/homeassistant/helpers/config_validation.py) helper. - -- Types: `string`, `byte`, and `boolean` -- Entity ID: `entity_id` and `entity_ids` -- Numbers: `small_float` and `positive_int` -- Time: `time`, `time_zone` -- Misc: `template`, `slug`, `temperature_unit`, `latitude`, `longitude`, `isfile`, `sun_event`, `ensure_list`, `port`, `url`, and `icon` - -To validate platforms using [MQTT](/components/mqtt/), `valid_subscribe_topic` and `valid_publish_topic` are available. - -Some things to keep in mind: - -- Use the constants defined in `const.py` -- Import `PLATFORM_SCHEMA` from the parent component and extend it -- Preferred order is `required` first and `optional` second -- Starting with Home Assistant 0.64 `voluptuous` requires default values for optional configuration keys to be valid values. Don't use a default which is `None` like `vol.Optional(CONF_SOMETHING, default=None): cv.string`, set the default to `default=""` if required. - -### {% linkable_title Snippets %} - -This section contains snippets for the validation we use. - -#### {% linkable_title Default name %} - -It's common to set a default for a sensor if the user doesn't provide a name to use. - -```python -DEFAULT_NAME = 'Sensor name' - -PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - ... - vol.Optional(CONF_NAME, default=DEFAULT_NAME): cv.string, -``` - -#### {% linkable_title Limit the values %} - -You might want to limit the user's input to a couple of options. - -```python -DEFAULT_METHOD = 'GET' - -PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - ... - vol.Optional(CONF_METHOD, default=DEFAULT_METHOD): vol.In(['POST', 'GET']), -``` - -#### {% linkable_title Port %} - -All port numbers are from a range of 1 to 65535. - -```python -DEFAULT_PORT = 993 - -PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - ... - vol.Optional(CONF_PORT, default=DEFAULT_PORT): cv.port, -``` - -#### {% linkable_title Lists %} - -If a sensor has a pre-defined list of available options, test to make sure the configuration entry matches the list. - -```python -SENSOR_TYPES = { - 'article_cache': ('Article Cache', 'MB'), - 'average_download_rate': ('Average Speed', 'MB/s'), -} - -PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - ... - vol.Optional(CONF_MONITORED_VARIABLES, default=[]): - vol.All(cv.ensure_list, [vol.In(SENSOR_TYPES)]), -``` + \ No newline at end of file diff --git a/source/developers/frontend.markdown b/source/developers/frontend.markdown index 0fb71208d9..316ca36487 100755 --- a/source/developers/frontend.markdown +++ b/source/developers/frontend.markdown @@ -9,94 +9,6 @@ sharing: true footer: true --- -Home Assistant is built on top of the [Polymer](https://www.polymer-project.org/) webcomponents framework. Polymer allows building encapsulated custom HTML elements. [Home-Assistant-Polymer source code on GitHub.][hass-polymer] - -

    -Do not use development mode in production. Home Assistant uses aggressive caching to improve the mobile experience. This is disabled during development so that you do not have to restart the server in between changes. -

    - -## {% linkable_title Setting up the environment %} - -

    -All commands below need to be run from inside the home-assistant-polymer repository. -

    - -Home Assistant will by default serve the compiled version of the frontend from the hass_frontend Python package. For development you want to work with the unbundled source files which are in the home-assistant-polymer repository. - -First step is to configure Home Assistant to use the development mode for the frontend. Do this by updating the frontend config in your `configuration.yaml` and set the path to the polymer repo: - -```yaml -frontend: - development_repo: -``` - -Next step is to git clone the [home-assistant-polymer repository][hass-polymer]. You can place the repository anywhere on your system but to keep these instructions simple we're cloning the home-assistant-polymer repository as a sibling to the Home Assistant repo. - -```bash -$ git clone https://github.com/home-assistant/home-assistant-polymer.git -$ cd home-assistant-polymer -``` - -After cloning, your folder structure should look like this: - -```text -/home-assistant -/home-assistant-polymer -``` - -Node.js is required to build the frontend. The preferred method of installing node.js is with [nvm](https://github.com/creationix/nvm). Install nvm using the instructions in the [README](https://github.com/creationix/nvm#install-script), and install the correct node.js by running the following command: - -```bash -$ nvm install -``` - -[Yarn](https://yarnpkg.com/en/) is used as the package manager for node modules. [Install yarn using the instructions here.](https://yarnpkg.com/en/docs/install) - -Next, development dependencies need to be installed to bootstrap the frontend development environment. First activate the right Node version and then download all the needed modules and do a first build: - -```bash -$ nvm use -$ script/bootstrap -``` - -This script will use yarn and bower to install all the necessary dependencies necessary for development and do an initial build. - -### {% linkable_title Creating pull requests %} - -If you're planning on issuing a PR back to the Home Assistant codebase you need to fork the polymer project and add your fork as a remote to the Home Assistant Polymer repo. - -```bash -$ git remote add -``` - -When you've made your changes and are ready to push them change to the working directory for the polymer project and then push your changes - -``` bash -$ git add -A -$ git commit -m "Added new feature X" -$ git push -u HEAD -``` - -## {% linkable_title Development %} - -If you are changing `html` files under `/src` or `/panels` - just reload the page in your browser to see changes. -If you are changing javascript files under `/js` you need to have gulp running to watch the source files for changes and build when necessary. - -```bash -$ yarn run dev-watch -``` - -The source code for the frontend can be found in different directories: - - - UI: `/home-assistant-polymer/src/` - - Panels: `/home-assistant-polymer/panels/` - - Javascript code: `/home-assistant-polymer/js/` - -# {% linkable_title Building the Polymer frontend %} - -Building a new version of the frontend is as simple as running `script/build_frontend`. -To use a built version package it: `python setup.py sdist` -Install it: `pip3 install dist/home-assistant-frontend-xxxxxxxx.0.tar.gz --upgrade` -Run Home Assistant without trying to reinstall production package: `hass --skip-pip` - -[hass-polymer]: https://github.com/home-assistant/home-assistant-polymer + \ No newline at end of file diff --git a/source/developers/frontend_add_card.markdown b/source/developers/frontend_add_card.markdown index 2deba80dbc..d10dda464b 100644 --- a/source/developers/frontend_add_card.markdown +++ b/source/developers/frontend_add_card.markdown @@ -9,20 +9,6 @@ sharing: true footer: true --- -The main interface of Home Assistant is a list of the current entities and their states. For each entity in the system, a state card will be rendered. State cards will show an icon, the name of the entity, when the state has last changed and the current state or a control to interact with it. - -![Cards in the frontend](/images/frontend/frontend-cards1.png) - -The different card types can be found [here](https://github.com/home-assistant/home-assistant-polymer/tree/master/src/state-summary). - -Sensors, when not [grouped](/components/group/), are shown as so-called badges on top of the state cards. - -![Badges in the frontend](/images/frontend/frontend-badges.png) - -The different badges are located in the file [`/src/components/entity/ha-state-label-badge.html`](https://github.com/home-assistant/home-assistant-polymer/blob/master/src/components/entity/ha-state-label-badge.html). - -Adding a custom card type can be done with a few simple steps. For this example we will add a new state card for the domain `camera`: - - 1. Add `'camera'` to the array `DOMAINS_WITH_CARD` in the file [/util/hass-util.html](https://github.com/home-assistant/home-assistant-polymer/blob/master/src/util/hass-util.html#L11). - 2. Create the files `state-card-camera.html` in the folder [/state-summary/](https://github.com/home-assistant/home-assistant-polymer/tree/master/src/state-summary). - 4. Add `` to [state-card-content.html](https://github.com/home-assistant/home-assistant-polymer/blob/master/src/state-summary/state-card-content.html). + \ No newline at end of file diff --git a/source/developers/frontend_add_more_info.markdown b/source/developers/frontend_add_more_info.markdown index 2364c5b312..5a6993837f 100644 --- a/source/developers/frontend_add_more_info.markdown +++ b/source/developers/frontend_add_more_info.markdown @@ -9,15 +9,6 @@ sharing: true footer: true --- -Whenever the user taps or clicks on one of the cards, a more info dialog will show. The header of this dialog will be the state card, followed by the history of this entity for the last 24 hours. Below this the more info component is rendered for that entity. The more info component can show more information or allow more ways of control. - -

    - - The more info dialog for a light allows the user to control the color and the brightness. -

    - -The instructions to add a more info dialog are very similar to adding a new card type. This example will add a new more info component for the domain `camera`: - - 1. Add `'camera'` to the array `DOMAINS_WITH_MORE_INFO` in the file [util/hass-util.html](https://github.com/home-assistant/home-assistant-polymer/blob/master/src/util/hass-util.html#L24). - 2. Create the files `more-info-camera.html` in the folder [/more-infos](https://github.com/home-assistant/home-assistant-polymer/tree/master/src/more-infos). - 4. Add `` to [more-info-content.html](https://github.com/home-assistant/home-assistant-polymer/blob/master/src/more-infos/more-info-content.html) + \ No newline at end of file diff --git a/source/developers/frontend_creating_custom_panels.markdown b/source/developers/frontend_creating_custom_panels.markdown index 4066e6062a..670a562cfa 100644 --- a/source/developers/frontend_creating_custom_panels.markdown +++ b/source/developers/frontend_creating_custom_panels.markdown @@ -9,83 +9,6 @@ sharing: true footer: true --- -Panels are pages within Home Assistant that show information within Home Assistant and can allow controlling it. Panels are linked from the sidebar and rendered full screen. The have have real-time access to the Home Assistant object via JavaScript. Examples of panels in the app are map, logbook and history. - -Besides components registering panels, users can also register panels using the `panel_custom` component. This allows users to quickly build their own custom interfaces for Home Assistant. - -### {% linkable_title Before you get started %} - -The Home Assistant user interface is currently served to browsers in modern JavaScript and older JavaScript (ES5). The older version has a wider browser support but that comes at a cost of size, performance and more difficult to get started building panels for authors. - -We therefore advice to set up the frontend to serve the modern version of the frontend so that you won't need any build tools while developing. If you realize that your audience requires both, you can add a transpilation step in the future. To set up your frontend to always serve the latest version, add this to your config: - -``` -frontend: - javascript_version: latest -``` - -### {% linkable_title Building your first panel %} - -Create a file called `hello.html` in your /panels/. - -The `hello.html` contains the needed building blocks to create the elements inside the view. - -```html - - - - -``` - -Create an entry for the new panel in your `configuration.yaml` file: - -```yaml -panel_custom: - - name: hello - sidebar_title: Hello World - sidebar_icon: mdi:hand-pointing-right - url_path: hello -``` - -For more possibilities, see the [Custom panel section](/cookbook/#user-interface) on our Examples page. +window.location = 'https://developers.home-assistant.io/docs/en/frontend_creating_custom_panels.html'; + \ No newline at end of file diff --git a/source/developers/frontend_creating_custom_ui.markdown b/source/developers/frontend_creating_custom_ui.markdown index 3012f43e60..f70c3ce3c1 100644 --- a/source/developers/frontend_creating_custom_ui.markdown +++ b/source/developers/frontend_creating_custom_ui.markdown @@ -10,90 +10,6 @@ footer: true ha_release: 0.38 --- -If you would like to use your own [State card](/developers/frontend_add_card/) without merging your code into [home-assistant-polymer](https://github.com/home-assistant/home-assistant-polymer/) you can create your own implementation. - -Put the element source file and its dependencies in `www/custom_ui/` directory under your Home Assistant [configuration](/docs/configuration/) directory. - -For example if creating a state card for the `light` domain named `state-card-my-custom-light` put `state-card-my-custom-light.html` in `www/custom_ui/`. - -That file should implement `` tag with Polymer. - -In `state-card-my-custom-light.html` you should use `` to import all the dependencies **not** used by Home Assistant's UI. -Do not import any dependencies used by the Home Assistant UI. -Importing those will work in `development: 1` mode, but will fail in production mode. - -1. In the `customize:` section of the `configuration.yaml` file put `custom_ui_state_card: state-card-my-custom-light`. -2. In the `frontend` section use `extra_html_url` to specify the URL to load. - -Example: - -`configuration.yaml`: - -```yaml -homeassistant: - customize: - light.bedroom: - custom_ui_state_card: state-card-my-custom-light - -frontend: - extra_html_url: - - /local/custom_ui/state-card-my-custom-light.html -``` - -`www/custom_ui/state-card-my-custom-light.html`: - -```html - - - - - -``` -

    -Some browsers don't support latest ECMAScript standards, these require a separate ES5 compatible file (`extra_html_url_es5`). -

    - -For more possibilities, see the [Custom UI section](/cookbook/#user-interface) on our Examples page. +window.location = 'https://developers.home-assistant.io/docs/en/frontend_creating_custom_ui.html'; + \ No newline at end of file diff --git a/source/developers/hassio/addon_communication.markdown b/source/developers/hassio/addon_communication.markdown index 3a4f57fb8b..2ade126855 100644 --- a/source/developers/hassio/addon_communication.markdown +++ b/source/developers/hassio/addon_communication.markdown @@ -10,32 +10,6 @@ footer: true redirect_from: /hassio/addon_config/ --- -There are different ways for communication between add-ons inside Hass.io. - -## {% linkable_title Network %} - -We use an internal network that allows to communicate with every add-on, even to/from Home Assistant, by using its name or alias. Only the add-ons which run on the host network are a bit limited. These can talk with all internal add-ons by their name but all other add-on can't address these add-on by name - using an alias works for both! - -Name/alias are used for communication inside Hass.io. -The name is generated using the following format: `{REPO}_{SLUG}`, e.g., `local_xy` or `3283fh_myaddon`. In this example, `{SLUG}` is defined in an add-ons `config.json`. You can use this name also as DNS name but you need replace the `_` with `-` to have a valid hostname. If an add-on is installed locally, `{REPO}` will be `local`. If the add-on is installed from a Github repository, `{REPO}` is a hashed identifier generated from the GitHub repository's URL (ex: https://github.com/xy/my_hassio_addons). See [here](https://github.com/home-assistant/hassio/blob/587047f9d648b8491dc8eef17dc6777f81938bfd/hassio/addons/utils.py#L17) to understand how this identifier is generated. Note that this identifier is required in certain service calls that use the [Hass.io add-on API](hassio-addon-api). You can view the repository identifiers for all currently installed add-ons via a GET request to the hassio API `addons` endpoint. - -Use `hassio` for communication with the internal API. - -## {% linkable_title Home Assistant %} - -An add-on can talk to the [Home Assistant API][hass-api] using the internal proxy. That makes it very easy to communicate with the API without knowing the password, port or any other information of the Home Assistant instance. Use this URL: `http://hassio/homeassistant/api` and internal communication is redirected to the right place. The next stept is to add `homeassistant_api: true` to `config.json` and read the environment variable `HASSIO_TOKEN` and use this as Home-Assistant password. - -There is also a proxy for the [Home Assistant Websocket API][hass-websocket]. It works like the API proxy above and requires `HASSIO_TOKEN` as password. Use this URL: `http://hassio/homeassistant/websocket`. - -It is also possible to talk direct to the Home Assistant instance which is named `homeassistant` over the internal network. But you need to know the configuration that is used by the running instance. - -We have severals services for Hass.io inside Home Assistant to run tasks. To send data over STDIN to an add-on use the `hassio.addon_stdin` service. - -## {% linkable_title Hass.io API %} - -To enables calls to the [Hass.io API][hassio-api], add `hassio_api: true` to `config.json` and read the environment variable `HASSIO_TOKEN`. Now you can use the API over the URL: `http://hassio/`. Use the `HASSIO_TOKEN` with header `X-HASSIO-KEY`. - -[hass-api]: /developers/rest_api/ -[hass-websocket]: /developers/websocket_api/ -[hassio-api]: https://github.com/home-assistant/hassio/blob/master/API.md -[hassio-addon-api]: https://github.com/home-assistant/hassio/blob/dev/API.md#restful-for-api-addons + \ No newline at end of file diff --git a/source/developers/hassio/addon_config.markdown b/source/developers/hassio/addon_config.markdown index bc4870f862..a13c1e7c71 100644 --- a/source/developers/hassio/addon_config.markdown +++ b/source/developers/hassio/addon_config.markdown @@ -10,198 +10,6 @@ footer: true redirect_from: /hassio/addon_config/ --- -Each add-on is stored in a folder. The file structure looks like this: - -```text -addon_name/ - build.json - CHANGELOG.md - config.json - Dockerfile - icon.png - logo.png - README.md - run.sh -``` - -## {% linkable_title Add-on script %} - -As with every Docker container, you will need a script to run when the container is started. A user might run many add-ons, so it is encouraged to try to stick to Bash scripts if you're doing simple things. - -When developing your script: - - - `/data` is a volume for persistent storage. - - `/data/options.json` contains the user configuration. You can use `jq` inside your shell script to parse this data. However, you might have to install `jq` as a separate package in your container (see `Dockerfile` below). - -```bash -CONFIG_PATH=/data/options.json - -TARGET="$(jq --raw-output '.target' $CONFIG_PATH)" -``` - -So if your `options` contain -```json -{ "target": "beer" } -``` -then there will be a variable `TARGET` containing `beer` in the environment of your bash file afterwards. - -## {% linkable_title Add-on Docker file %} - -All add-ons are based on Alpine Linux 3.6. Hass.io will automatically substitute the right base image based on the machine architecture. Add `tzdata` if you need run in a different timezone. `tzdata` Is is already added to our base images. - -``` -ARG BUILD_FROM -FROM $BUILD_FROM - -ENV LANG C.UTF-8 - -# Install requirements for add-on -RUN apk add --no-cache jq - -# Copy data for add-on -COPY run.sh / -RUN chmod a+x /run.sh - -CMD [ "/run.sh" ] -``` - -If you don't use local build on device or our build script, make sure that the Dockerfile have also a set of labels include: -``` -LABEL io.hass.version="VERSION" io.hass.type="addon" io.hass.arch="armhf|aarch64|i386|amd64" -``` - -It is possible to use own base image with `build.json` or if you do not need support for automatic multi-arch building you can also use a simple docker `FROM`. - -### {% linkable_title Build Args %} - -We support the following build arguments by default: - -| ARG | Description | -|-----|-------------| -| BUILD_FROM | Hold image for dynamic builds or buildings over our systems. -| BUILD_VERSION | Add-on version (read from `config.json`). -| BUILD_ARCH | Hold current build arch inside. - -## {% linkable_title Add-on config %} - -The config for an add-on is stored in `config.json`. - -```json -{ - "name": "xy", - "version": "1.2", - "slug": "folder", - "description": "long description", - "arch": ["amd64"], - "url": "website with more information about add-on (ie a forum thread for support)", - "startup": "application", - "boot": "auto", - "ports": { - "123/tcp": 123 - }, - "map": ["config:rw", "ssl"], - "options": {}, - "schema": {}, - "image": "repo/{arch}-my-custom-addon" -} -``` - -| Key | Type | Required | Description | -| --- | ---- | -------- | ----------- | -| name | string | yes | Name of the add-on -| version | string | yes | Version of the add-on -| slug | string | yes | Slug of the add-on -| description | string | yes | Description of the add-on -| arch | list | no | List of supported arch: `armhf`, `aarch64`, `amd64`, `i386`. Default all. -| url | url | no | Homepage of the addon. Here you can explain the add-ons and options. -| startup | bool | yes | `initialize` will start addon on setup of Hass.io. `system` is for things like databases and not dependent on other things. `services` will start before Home Assistant, while `application` is started afterwards. Finally `once` is for applications that don't run as a daemon. -| webui | string | no | A URL for web interface of this add-on. Like `http://[HOST]:[PORT:2839]/dashboard`, the port needs the internal port, which will be replaced with the effective port. It is also possible to bind the proto part to a config options with: `[PROTO:option_name]://[HOST]:[PORT:2839]/dashboard` and he lookup if they is True and going to `https`. -| boot | string | yes | `auto` by system and manual or only `manual` -| ports | dict | no | Network ports to expose from the container. Format is `"container-port/type": host-port`. -| host_network | bool | no | If that is True, the add-on run on host network. -| host_ipc | bool | no | Default False. Allow to share the IPC namespace with others. -| host_dbus | bool | no | Default False. Map Host dbus service into add-on. -| devices | list | no | Device list to map into the add-on. Format is: `::`. i.e. `/dev/ttyAMA0:/dev/ttyAMA0:rwm` -| auto_uart | bool | no | Default False. Auto mapping all UART/Serial device from host into add-on. -| hassio_api | bool | no | This add-on can access to Hass.io REST API. It set the host alias `hassio`. -| homeassistant_api | bool | no | This add-on can access to Hass.io Home-Assistant REST API proxy. Use `http://hassio/homeassistant/api`. -| privileged | list | no | Privilege for access to hardware/system. Available access: `NET_ADMIN`, `SYS_ADMIN`, `SYS_RAWIO`, `SYS_TIME`, `SYS_NICE` -| apparmor | bool | no | Enable or disable AppArmor support. If it is enable, you can also use custom profiles. -| seccomp | bool | no | Enable or disable Seccomp support. If it is enable, you can also use custom profiles. -| map | list | no | List of maps for additional Hass.io folders. Possible values: `config`, `ssl`, `addons`, `backup`, `share`. Defaults to `ro`, which you can change by adding `:rw` to the end of the name. -| environment | dict | no | A dict of environment variable to run add-on. -| audio | bool | no | Boolean. Mark this add-on to use internal an audio system. The ALSA configuration for this add-on will be mount automatic. -| gpio | bool | no | Boolean. If this is set to True, `/sys/class/gpio` will map into add-on for access to GPIO interface from kernel. Some library need also `/dev/mem` and `SYS_RAWIO` for read/write access to this device. -| stdin | bool | no | Boolean. If that is enable, you can use the STDIN with Hass.io API. -| legacy | bool | no | Boolean. If the docker image have no hass.io labels, you can enable the legacy mode to use the config data. -| options | dict | yes | Default options value of the add-on -| schema | dict | yes | Schema for options value of the add-on. It can be `False` to disable schema validation and use custom options. -| image | string | no | For use with Docker Hub. -| timeout | integer | no | Default 10 (second). The timeout to wait until the docker is done or will be killed. -| tmpfs | string | no | Mount a tmpfs file system in `/tmpfs`. Valide format for this option is : `size=XXXu,uid=N,rw`. Size is mandatory, valid units (`u`) are `k`, `m` and `g` and `XXX` has to be replaced by a number. `uid=N` (with `N` the uid number) and `rw` are optional. - -### {% linkable_title Options / Schema %} - -The `options` dictionary contains all available options and their default value. Set the default value to `null` if the value is required to be given by the user before the add-on can start, and it show it inside default values. Only nested arrays and dictionaries are supported with a deep of two size. If you want make an option optional, put `?` to the end of data type, otherwise it will be a required value. - -```json -{ - "message": "custom things", - "logins": [ - { "username": "beer", "password": "123456" }, - { "username": "cheep", "password": "654321" } - ], - "random": ["haha", "hihi", "huhu", "hghg"], - "link": "http://example.com/", - "size": 15, - "count": 1.2 -} -``` - -The `schema` looks like `options` but describes how we should validate the user input. For example: - -```json -{ - "message": "str", - "logins": [ - { "username": "str", "password": "str" } - ], - "random": ["match(^\w*$)"], - "link": "url", - "size": "int(5,20)", - "count": "float", - "not_need": "str?" -} -``` - -We support: -- str -- bool -- int / int(min,) / int(,max) / int(min,max) -- float / float(min,) / float(,max) / float(min,max) -- email -- url -- port -- match(REGEX) - -## {% linkable_title Add-on extended build %} - -Additional build options for an add-on is stored in `build.json`. This file will be read from our build systems. - -```json -{ - "build_from": { - "armhf": "homeassistant/armhf-base:latest" - }, - "squash": false, - "args": { - "my_build_arg": "xy" - } -} -``` - -| Key | Required | Description | -| --- | -------- | ----------- | -| build_from | no | A dictionary with the hardware architecture as the key and the base Docker image as value. -| squash | no | Default `False`. Be carfully with this option, you can not use the image for caching stuff after that! -| args | no | Allow to set additional Docker build arguments as a dictionary. + \ No newline at end of file diff --git a/source/developers/hassio/addon_development.markdown b/source/developers/hassio/addon_development.markdown index ec1f3f9674..1a99e8f384 100644 --- a/source/developers/hassio/addon_development.markdown +++ b/source/developers/hassio/addon_development.markdown @@ -10,14 +10,6 @@ footer: true redirect_from: /hassio/addon_development/ --- -Add-ons for Hass.io allow the user to extend the functionality around Home Assistant. This can be running an application that Home Assistant can integrate with (like an MQTT broker) or to share the configuration via Samba for easy editing from other computers. Add-ons can be configured via the Hass.io panel in Home Assistant. - -Under the hood, add-ons are Docker images published in [Docker Hub](https://hub.docker.com/). Developers can create [GitHub](https://github.com) repositories that contain multiple references to add-ons for easy sharing with the community. - -1. [Tutorial: Making your first add-on](/developers/hassio/addon_tutorial/) -1. [Configuration](/developers/hassio/addon_config/) -1. [Communication](/developers/hassio/addon_communication/) -1. [Local Testing](/developers/hassio/addon_testing/) -1. [Publishing](/developers/hassio/addon_publishing/) -1. [Presentation](/developers/hassio/addon_presentation/) -1. [Repositories](/developers/hassio/addon_repository/) + \ No newline at end of file diff --git a/source/developers/hassio/addon_presentation.markdown b/source/developers/hassio/addon_presentation.markdown index e57270040a..26ee4f20d2 100644 --- a/source/developers/hassio/addon_presentation.markdown +++ b/source/developers/hassio/addon_presentation.markdown @@ -9,45 +9,6 @@ sharing: true footer: true --- -If you decide to share your add-on to the public, paying attention to details is recommended. Of course, your add-on should have a proper name and description, but Hass.io also gives you some other tools to present your add-on even nicer. - -## {% linkable_title Adding documentation %} - -Good documentation helps the consumer of your add-on to understand its usage, explains configuration options, points users in the right direction in the case they have questions or issues, and contains the license under which the add-on was published. - -This file containing the documentation is usually referred to as the "README", which is generally published as the `README.md` file. - -Take a look at other projects for inspiration. For example, see the `README.md` of the [Community Hass.io Add-ons: Homebridge](https://github.com/hassio-addons/addon-homebridge/blob/master/README.md) add-on. - -In future versions of Hass.io, the `README.md` file will be displayed in the Home Assistant frontend. - -## {% linkable_title Add-on icon & logo %} - -A picture is worth a thousand words. Therefore, your add-on can be improved by adding a proper image icon and logo. Those images are used when showing your add-on in the Home Assistant Hass.io panel and which will significantly improve the visual representation of your add-on. - -Requirements for the logo of your add-on: - -- The logo must be in the Portable Network Graphics format (`.png`). -- The filename must be `logo.png`. -- It is recommended to keep the logo size around 250x100px. You may choose to use a different size or aspect ratio as you seem fit for your add-on. - -Requirements for the icon of your add-on: - -- The icon must be in the Portable Network Graphics format (`.png`). -- The filename must be `icon.png`. -- The aspect ratio of the icon must be 1x1 (square). -- It is recommended to use an icon size of 128x128px. - -## {% linkable_title Keeping a changelog %} - -It is likely you are going to release newer versions of your add-on in the future. In case that happens, the users of your add-on would see an upgrade notice and probably want to know what changes were made in the latest version. - -A changelog is a file which contains a curated, chronologically ordered list of notable changes for each version of your add-on and is generally published as the `CHANGELOG.md` file. - -If you are in need of a guide on keeping a changelog, we would recommend checking the [keep a changelog](http://keepachangelog.com) website. They have developed a standard that is used by many opensource projects around the world. - -In future versions of Hass.io, the `CHANGELOG.md` file will be displayed in the Home Assistant frontend. - -## {% linkable_title Extended Security %} - -You can use own security profile for you Add-on with Seccomp or AppArmor. Default it is enabled and use the docker default profile. Put `apparmor` or `seccomp.json` file into your Add-on folder and it will load this file as primary profile. + \ No newline at end of file diff --git a/source/developers/hassio/addon_publishing.markdown b/source/developers/hassio/addon_publishing.markdown index 26020a6616..735dbe7093 100644 --- a/source/developers/hassio/addon_publishing.markdown +++ b/source/developers/hassio/addon_publishing.markdown @@ -10,56 +10,6 @@ footer: true redirect_from: /hassio/addon_publishing/ --- -There are two different ways of publishing add-ons. One is to publish pre-build containers to Docker Hub and the other option is to have users build the containers locally on their Hass.io instance. - -#### {% linkable_title Pre-build containers %} - -With pre-build containers, the developer is responsible for building the images for each architecture on their machine and push the results out to Docker Hub. This has a lot of advantages for the user. As a user it will only have to download the final container and be up and running once the download finishes. This makes the installation process fast and almost no chance of failure. This is the preferred method. - -We have automated the process of building and publishing add-ons. See below for the instructions. - -#### {% linkable_title Locally build containers %} - -Starting Hass.io 0.26, it is possible to distribute add-ons that will be built on the users machine. The advantage is that as a developer it is easy to test an idea and see if people are interested in your add-ons. This method includes installing and potentially compiling code. This means that installing such an add-on is slow and adds more wear and tear to users SD card/hard drive than the above mentioned pre-build solution. It also has a higher chance of failure if one of the dependencies of the container has changed or is no longer available. - -Use this option when you are playing with add-ons and seeing if someone is interested in your work. Once you're an established repository, please migrate to pushing builds to Docker Hub as it greatly improves the user experience. In the future we will mark locally built add-ons in the add-on store to warn users. - -## {% linkable_title Build scripts to publish add-ons to Docker Hub %} - -All add-ons are simple docker containers. Inside your add-on `config.json` you specify the Docker image that will be installed for your add-on: - -```json -{ - ... - - "image": "myhub/image-{arch}-addon-name", - - ... -} -``` - -You can use `{arch}` inside the image name to support multiple architectures with 1 configuration file. It will be replaced with the architecture of the user when we load the image. If you use `Buildargs` you can use the `build.json` to overwrite our default args. - -Hass.io assumes that the `master` branch of your add-on repository matches the latest tag on Docker Hub. When you're building a new version, it's suggested that you use another branch, ie `build` or do it with a PR on GitHub. After you push the add-on to [Docker Hub](https://hub.docker.com/), you can merge this branch to master. - -## {% linkable_title Custom Add-ons %} - -You need a Docker Hub account to make your own add-ons. You can build your docker images with docker `build` command or use our script that make it simple. Pull our [builder docker engine][builder] and run one of the following commands. - -For a git repository: - -```bash -$ docker run --rm --privileged -v ~/.docker:/root/.docker homeassistant/amd64-builder --all -t addon-folder -r https://github.com/xy/addons -b branchname -``` - -For a local repository: - -```bash -$ docker run --rm --privileged -v ~/.docker:/root/.docker -v /my_addon:/data homeassistant/amd64-builder --all -t /data -``` - -

    -If you are developing on macOS and using Docker for Mac, you may encounter an error message similar to the following: error creating aufs mount to /var/lib/docker/aufs/mnt/-init: invalid argument. A proposed workaround is to add the following to the Advanced Daemon JSON configuration via Docker > Preferences > Daemon > Advanced: "storage-driver" : "aufs". -

    - -[builder]: https://github.com/home-assistant/hassio-build/tree/master/builder + \ No newline at end of file diff --git a/source/developers/hassio/addon_repository.markdown b/source/developers/hassio/addon_repository.markdown index 9a8373fa51..5e5797ff9f 100644 --- a/source/developers/hassio/addon_repository.markdown +++ b/source/developers/hassio/addon_repository.markdown @@ -10,28 +10,6 @@ footer: true redirect_from: /hassio/addon_repository/ --- -An add-on repository can contain one or more add-ons. Each add-on is stored in its own unique folder. To be indentified as a repository, the repository must contain a configuration file. - -Check the [Example add-on repository](https://github.com/home-assistant/hassio-addons-example) for further details. - -## {% linkable_title Installing a repository %} - -A user can add a repository by going to the Hass.io panel in Home Assistant, clicking on the store icon in the top right, copy/paste the URL of your repostory into the repository textarea and click on **Save**. - -## {% linkable_title Repository configuration %} - -Each repository is required to contain `repository.json` at the root in the git repository. - -```json -{ - "name": "Name of repository", - "url": "http://www.example/addons", - "maintainer": "HomeAssistant Team " -} -``` - -| Key | Required | Description | -| --- | -------- | ----------- | -| name | yes | Name of the repository -| url | no | Homepage of the repository. Here you can explain the various add-ons. -| maintainer | no | Contact info of the maintainer. + \ No newline at end of file diff --git a/source/developers/hassio/addon_testing.markdown b/source/developers/hassio/addon_testing.markdown index f2f562f443..8c8eaa50cc 100644 --- a/source/developers/hassio/addon_testing.markdown +++ b/source/developers/hassio/addon_testing.markdown @@ -10,28 +10,6 @@ footer: true redirect_from: /hassio/addon_testing/ --- -The fastest way to develop add-ons is by adding them to your local add-on repository. To access your local add-on repository, install either the [Samba add-on] or [SSH add-on]. - -Right now add-ons will work with images that are stored on Docker Hub (using `image` from add-on config). Without `image` inside local add-ons repository it to be built on the device. - -## {% linkable_title Local build %} - -You can build and try the addon on your developer machine also. Move all addon stuff into a temp folder. If you use `FROM $BUILD_FROM` you need set a base image with build args. Normally you can use follow base images: - -- armhf: `homeassistant/armhf-base:latest` -- aarch64: `homeassistant/aarch64-base:latest` -- amd64: `homeassistant/amd64-base:latest` -- i386: `homeassistant/i386-base:latest` - -Use `docker` to build the test addon: `docker build --build-arg BUILD_FROM="homeassistant/amd64-base:latest" -t local/my-test-addon .` - -## {% linkable_title Local run %} - -Create a new folder for data and add a test _options.json_ file. After that you can run your add-on with: `docker run --rm -v /tmp/my_test_data:/data -p PORT_STUFF_IF_NEEDED local/my-test-addon` - -## {% linkable_title Logs %} - -All stdout and stderr are redirected to the Docker logs. The logs can be fetched from the add-on page inside the Hass.io panel in Home Assistant. - -[Samba add-on]: /addons/samba/ -[SSH add-on]: /addons/ssh/ + \ No newline at end of file diff --git a/source/developers/hassio/addon_tutorial.markdown b/source/developers/hassio/addon_tutorial.markdown index 0a30b2a60d..cca2f3a2f7 100644 --- a/source/developers/hassio/addon_tutorial.markdown +++ b/source/developers/hassio/addon_tutorial.markdown @@ -10,199 +10,6 @@ footer: true redirect_from: /hassio/addon_tutorial/ --- -So you've got Home Assistant going and you've been enjoying the built-in add-ons but you're missing this one application. Time to make your own add-on! In Hass.io 0.24 we introduced the option to have local add-ons be build on your device. This is great for developing new add-ons locally. - -To get started with developing add-ons, we first need access to where Hass.io looks for local add-ons. For this you can use the Samba add-on or the SSH add-on. - -For Samba, once you have enabled and started it, your Hass.io instance will show up in your local network tab and share a folder called "addons". This is the folder to store your custom add-ons. - -If you are on macOS and the folder is not showing up automatically, go to Finder and press CMD+K then enter 'smb://hassio.local' - -

    - -With Samba add-on enabled, you can browse to your Hass.io server over the local network. It will contain an addons folder to store your local add-ons. -

    - -For SSH, you will have to install it. Before you can start it, you will have to have a private/public key pair and store your public key in the add-on config ([see docs for more info][ssh]). Once started, you can SSH to Hass.io and store your custom add-ons in "/addons". - -

    - -Once you SSH into your Hass.io box, you have access to your add-ons in "/addons". -

    - -Once you have located your add-on directory, it's time to get started! - -[ssh]: /addons/ssh/ - -## {% linkable_title Step 1: The basics %} - - - Create a new directory called `hello_world` - - Inside that directory create three files. - -`Dockerfile`: -``` -ARG BUILD_FROM -FROM $BUILD_FROM - -ENV LANG C.UTF-8 - -# Copy data for add-on -COPY run.sh / -RUN chmod a+x /run.sh - -CMD [ "/run.sh" ] -``` - -`config.json`: -```json -{ - "name": "Hello world", - "version": "1", - "slug": "hello_world", - "description": "My first real add-on!", - "startup": "before", - "boot": "auto", - "options": {}, - "schema": {} -} -``` - -`run.sh`: -```bash -echo Hello world! -``` - -## {% linkable_title Step 2: Installing and testing your add-on %} - -Now comes the fun part, time to open the Hass.io UI and install and run your add-on. - - - Open the Home Assistant frontend - - Go to the Hass.io panel - - On the top right click the shopping basket to go to the add-on store. - -

    - -From the Hass.io main panel open the add-on store. -

    - - - On the top right click the refresh button - - You should now see a new card called "Local" that lists your add-on! - -

    - -The Hass.io add-on store will list all available local add-ons. -

    - - - Click on your add-on to go to the add-on details page. - - Install your add-on - - Start your add-on - - Refresh the logs of your add-on, you should now see "Hello world!" in your logs. - -

    - -The add-on will print Hello world to the logs and then quit. -

    - -### {% linkable_title I don't see my add-on?! %} - -Oops! You clicked refresh in the store and your add-on didn't show up. Or maybe you just updated an option, clicked refresh and saw your add-on disappear. - -When this happens, it means that your `config.json` is invalid. It's either invalid JSON or one of the specified options is incorrect. To see what went wrong, go to the Hass.io panel and in the supervisor card click on "View logs". This should bring you to a page with the logs of the supervisor. Scroll to the bottom and you should be able to find the validation error. - -Once you fixed the error, go to the add-on store and click refresh again. - -## {% linkable_title Step 3: Hosting a server %} - -Until now we've been able to do some basic stuff, but it's not very useful yet. So let's take it one step further and host a server that we expose on a port. For this we're going to use the built-in HTTP server that comes with Python 3. - -To do this, we will need to update our files as follows: - - - `Dockerfile`: Install Python 3 - - `config.json`: Make the port from the container available on the host - - `run.sh`: Run the Python 3 command to start the HTTP server - -Add to your `Dockerfile` before `RUN`: - -``` -# Install requirements for add-on -RUN apk add --no-cache python3 - -# Python 3 HTTP Server serves the current working dir -# So let's set it to our add-on persistent data directory. -WORKDIR /data -``` - -Add "ports" to `config.json`. This will make TCP on port 8000 inside the container available on the host on port 8000. - -```json -{ - "name": "Hello world", - "version": "0.2", - "slug": "hello_world", - "description": "My first real add-on!", - "startup": "before", - "boot": "auto", - "options": {}, - "schema": {}, - "ports": { - "8000/tcp": 8000 - } -} -``` - -Update `run.sh` to start the Python 3 server: - -``` -python3 -m http.server -``` - -## {% linkable_title Step 4: Installing the update %} - -Since we updated the version number in our `config.json`, Home Assistant will show an update button when looking at the add-on details. You might have to refresh your browser or click the refresh button in the add-on store for it to show up. If you did not update the version number, you can also uninstall and install the add-on again. After installing the add-on again, make sure you start it. - -Now navigate to [http://hassio.local:8000](http://hassio.local:8000) to see our server in action! - -

    - -The Python 3 server will allow you to browse the /data folder. -

    - -## {% linkable_title Bonus: Working with add-on options %} - -In the screenshot you've probably seen that our server only served up 1 file: `options.json`. This file contains the user configuration for this add-on. Because we specified an empty "config" and "schema" in our `config.json`, the file is currently empty. - -Let's see if we can get some data into that file! - -To do this, we need to specify the default options and a schema for the user to change the options. - -Change the options and schema entries in your `config.json` with the following: - -```json -{ - … - - "options": { - "beer": true, - "wine": true, - "liquor": false, - "name": "world", - "year": 2017 - }, - "schema": { - "beer": "bool", - "wine": "bool", - "liquor": "bool", - "name": "str", - "year": "int" - }, - - … -} -``` - -Refresh the add-on store and re-install your add-on. You will now see the options available in the add-on config screen. When you now go back to our Python 3 server and download `options.json`, you'll see the options you set. - - - [Learn more about the available schema options.](/hassio/addon_config/#options--schema) - - [See how options.json can be used inside `run.sh`](https://github.com/home-assistant/hassio-addons/blob/master/mosquitto/run.sh#L4-L6) - -### [Next step: Add-on config reference »](/developers/hassio/addon_config/) + \ No newline at end of file diff --git a/source/developers/hassio/architecture.markdown b/source/developers/hassio/architecture.markdown index 173e3657ae..5b3a12f53c 100644 --- a/source/developers/hassio/architecture.markdown +++ b/source/developers/hassio/architecture.markdown @@ -10,30 +10,6 @@ footer: true redirect_from: /hassio/architecture/ --- -

    - Architecture overview of Hass.io - Architecture overview of Hass.io -

    - -### {% linkable_title Host Control (HC) %} - -This is a daemon running on the host machine that allows the supervisor to control certain aspects of the host OS: - - - Power cycle (restart, turn off) - - Manage network settings - - Local updates - -### {% linkable_title Host %} - -Our pre-build images are based on [ResinOS]. Any Linux machine can be turned into a Hass.io host by running [the installer][linux]. - -### {% linkable_title Supervisor %} - -The supervisor offers an API to manage the host and running the Docker containers. - -### {% linkable_title Configuration panel %} - -The configuration panel lives inside the supervisor but is accessible via the Home Assistant user interface. The configuration panel allows the user to manage the installation. - -[ResinOS]: https://resinos.io/ -[linux]: /hassio/installation/#alternative-install-on-generic-linux-server + \ No newline at end of file diff --git a/source/developers/hassio/debugging.markdown b/source/developers/hassio/debugging.markdown index 8dde1fbaa8..be66c18e37 100644 --- a/source/developers/hassio/debugging.markdown +++ b/source/developers/hassio/debugging.markdown @@ -10,46 +10,6 @@ footer: true redirect_from: /hassio/debugging/ --- -

    -This section is not for users. Use the [SSH add-on] to SSH into Hass.io. This is for developers of Hass.io. Do not ask for support if you are using these options. -

    - -[SSH add-on]: /addons/ssh/ - -The following debug tips and tricks are for people who are running the Hass.io image and are working on the base image. If you use the generic Linux installer script, you should be able to access your host and logs as per your host. - -## {% linkable_title SSH access to the host %} - -Create an `authorized_keys` file containing your public key, and place it in the root of the boot partition of your SD card. Once the device is booted, you can access your device as root over SSH on port 22222. - -Windows instructions how to generate and use private/public keys with Putty are [here][windows-keys]. Instead of the droplet instructions, add the public key as per above instructions. - -Alternative instructions, for Mac, Windows and Linux can be found [here](https://help.github.com/articles/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent/#platform-mac). - -Follow steps 1-4 under 'Generating a new SSH key' (The other sections are not applicable to Hass.io and can be ignored.) - -Step 3 in the link above, shows the path to the private key file `id_rsa` for your chosen operating system. Your public key, `id_rsa.pub`, is saved in the same folder. Next, select all text from text box "Public key for pasting into OpenSSH authorized_keys file" and save it to the root of your SD card as `authorized_keys`. - -

    -Make sure when you are copying the public key to the root of the /resin-boot partition of the SD card that you rename the file correctly to `authorized_keys` with no `.pub` file extension. -

    - -You should then be able to SSH into your Hass.io device. On mac/linux, use: -``` -ssh root@hassio.local -p 22222 -``` - -## {% linkable_title Checking the logs %} - -```bash -# Logs from the supervisor service on the Host OS -journalctl -f -u resin-supervisor.service - -# Hass.io supervisor logs -docker logs resin_supervisor - -# Home Assistant logs -docker logs homeassistant -``` - -[windows-keys]: https://www.digitalocean.com/community/tutorials/how-to-use-ssh-keys-with-putty-on-digitalocean-droplets-windows-users + \ No newline at end of file diff --git a/source/developers/helpers.markdown b/source/developers/helpers.markdown index 4b9e7f59b9..8916b56c68 100644 --- a/source/developers/helpers.markdown +++ b/source/developers/helpers.markdown @@ -9,18 +9,6 @@ sharing: true footer: true --- -There are a bunch of online services which can help you if you are developing for Home Assistant or maintaining components. Some of these are directly connected to Pull Requests and the repositories, while others publish details and updates on our [Discord chat server][discord-devs]. - -- [Coveralls][coveralls] -- [Travis CI][travis-ci] -- [gemnasium][gemnasium] -- [Requires.io][requires-io] -- [Pivotal Tracker][pivotal] - -[coveralls]: https://coveralls.io/github/home-assistant/home-assistant -[travis-ci]: https://travis-ci.org/home-assistant/home-assistant -[gemnasium]: https://gemnasium.com/github.com/home-assistant/home-assistant -[requires-io]: https://requires.io/github/home-assistant/home-assistant/requirements/?branch=dev -[pivotal]: https://www.pivotaltracker.com/n/projects/1250084 - -[discord-devs]: https://discord.gg/8X8DTH4 + \ No newline at end of file diff --git a/source/developers/index.markdown b/source/developers/index.markdown index c801866e6a..3248e7192b 100644 --- a/source/developers/index.markdown +++ b/source/developers/index.markdown @@ -10,17 +10,6 @@ footer: true og_image: /images/architecture/component_interaction.png --- -Welcome to the Home Assistant development documentation. This is the place to learn all about how Home Assistant works and how you can extend it with support for your devices and services! - -

    -Diagram showing interaction between components and the Home Assistant core. -Diagram showing interaction between components and the Home Assistant core. -

    - -The best way to familiarize yourself with Home Assistant is to watch the PyCon 2016 talk about Home Assistant and read through the [Python API docs]. - -
    - -
    - -[Python API docs]: https://dev-docs.home-assistant.io + \ No newline at end of file diff --git a/source/developers/intent/conversation.markdown b/source/developers/intent/conversation.markdown index 38d02fe337..ea4cad2a45 100644 --- a/source/developers/intent/conversation.markdown +++ b/source/developers/intent/conversation.markdown @@ -9,19 +9,6 @@ sharing: true footer: true --- -The conversation component handles incoming commands from the frontend and converts them to intents. It does this based on registered sentences. - -As a component, you can register sentences with the conversation component to allow it to be remote controlled. Refer to named slots by putting the slot name between curly braces: `{item}`. - -Example code: - -```python -@asyncio.coroutine -def async_setup(hass, config): - hass.components.conversation.async_register('MyCoolIntent', [ - 'I think that {object} is very cool', - 'Nothing is cooler than {object}' - ]) -``` - -If a sentence like "I think that beer is very cool" comes in, the conversation component will generate an intent of type `MyCoolIntent` and with 1 slot, named `object` and value `beer`. + \ No newline at end of file diff --git a/source/developers/intent/firing.markdown b/source/developers/intent/firing.markdown index 17e80678b4..b8e10eff20 100644 --- a/source/developers/intent/firing.markdown +++ b/source/developers/intent/firing.markdown @@ -9,51 +9,6 @@ sharing: true footer: true --- -When you fire an intent, you will get a response back or an error will be raised. It is up to the component to return the result to the user. - -Example code to handle an intent in Home Assistant. - -```python -from homeassistant.helpers import intent - -intent_type = 'TurnLightOn' -slots = { - 'entity': { 'value': 'Kitchen' } -} - -try: - intent_response = yield from intent.async_handle( - hass, 'example_component', intent_type, slots - ) - -except intent.UnknownIntent as err: - _LOGGER.warning('Received unknown intent %s', intent_type) - -except intent.InvalidSlotInfo as err: - _LOGGER.error('Received invalid slot data: %s', err) - -except intent.IntentError: - _LOGGER.exception('Error handling request for %s', intent_type) -``` - -The intent response is an instance of `homeassistant.helpers.intent.IntentResponse`. - -| Name | Type | Description | -| ---- | ---- | ----------- | -| `intent` | Intent | Instance of intent that triggered response. | -| `speech` | Dictionary | Speech responses. Each key is a type. Allowed types are `plain` and `ssml`. | -| `card` | Dictionary | Card responses. Each key is a type. | - -Speech dictionary values: - -| Name | Type | Description | -| ---- | ---- | ----------- | -| `speech` | String | The text to say -| `extra_data` | Any | Extra information related to this speech. - -Card dictionary values: - -| Name | Type | Description | -| ---- | ---- | ----------- | -| `title` | String | The title of the card -| `content` | Any | The content of the card + \ No newline at end of file diff --git a/source/developers/intent/handling.markdown b/source/developers/intent/handling.markdown index c341f6ef17..040d2d01dc 100644 --- a/source/developers/intent/handling.markdown +++ b/source/developers/intent/handling.markdown @@ -9,41 +9,6 @@ sharing: true footer: true --- -Any component can register to handle intents. This allows a single component to handle intents fired from multiple voice assistants. - -A component has to register an intent handler for each type that it wants to handle. Intent handlers have to extend `homeassistant.helpers.intent.IntentHandler` - -```python -import asyncio -from homeassistant.helpers import intent - -DATA_KEY = 'example_key' - -@asyncio.coroutine -def async_setup(hass, config): - hass.data[DATA_KEY] = 0 - intent.async_register(hass, CountInvocationIntent()) - - -class CountInvocationIntent(intent.IntentHandler): - """Handle CountInvocationIntent intents.""" - - # Type of intent to handle - intent_type = 'CountInvocationIntent' - - # Optional. A validation schema for slots - # slot_schema = { - # 'item': cv.string - # } - - @asyncio.coroutine - def async_handle(self, intent_obj): - """Handle the intent.""" - intent_obj.hass.data[DATA_KEY] += 1 - - response = intent_obj.create_response() - response.async_set_speech( - "This intent has been invoked {} times".format( - intent_obj.hass.data[DATA_KEY])) - return response -``` + \ No newline at end of file diff --git a/source/developers/intent/index.markdown b/source/developers/intent/index.markdown index a454deecbc..a00395d8a8 100644 --- a/source/developers/intent/index.markdown +++ b/source/developers/intent/index.markdown @@ -9,29 +9,6 @@ sharing: true footer: true --- -An intent is a description of a user's intention. Intents are generated by user actions, like asking Amazon Echo to turn on a light. - -

    - -Architectural overview of intents in Home Assistant -

    - -Intents are fired by components that receive them from external sources/services. Conversation, Alexa, API.ai and Snips are currently sourcing intents. - -Any component can handle intents. This makes it very easy for developers to integrate with all voice assistants at once. - -Intents are implemented using the `homeassistant.helpers.intent.Intent` class. It contains the following properties: - -| Name | Type | Description | -| ---- | ---- | ----------- | -| `hass` | Home Assistant | The Home Assistant instance that fired the intent. -| `platform` | string | The platform that fired the intent -| `intent_type` | string | The type (name) of the intent -| `slots` | dictionary | Contains the slot values keyed by slot name. -| `text_input` | string | Optional. The raw text input that initiated the intent. - -Description of the slots dictionary values. - -| Name | Type | Description | -| ---- | ---- | ----------- | -| Value | anything | Value of the slot. + \ No newline at end of file diff --git a/source/developers/internationalization/backend_localization.markdown b/source/developers/internationalization/backend_localization.markdown index f50d797045..2c2413fc21 100644 --- a/source/developers/internationalization/backend_localization.markdown +++ b/source/developers/internationalization/backend_localization.markdown @@ -10,42 +10,6 @@ footer: true ha_release: 0.64 --- -## {% linkable_title Translation Strings %} -Platform translation strings are stored as JSON in the [home-assistant](https://github.com/home-assistant/home-assistant) repository. These files must be located adjacent to the component/platform they belong to. Components must have their own directory, and the file is simply named `strings.json` in that directory. For platforms, they are named `strings..json` in the platform directory. This file will contain the different strings that will be translatable. - -In order to test changes to translation files, the translation strings must be compiled into Home Assistant’s translation directories by running the following script: - -```bash -$ script/translations_develop -``` - -After the pull request with the strings file is merged into the `dev` branch, the strings will be automatically uploaded to Lokalise, where contributors can submit translations. The translated strings in Lokalise will be periodically pulled in to the home-assistant repository. - -## {% linkable_title States Localization %} -The first step when localizing platform states is to ensure that the states defined in the actual platform code are defined in `snake_case`. The states should not contain capital letters or spaces. Next, the strings file needs to be created. The states should exist under the `state` key, and map the backend state keys to their English translations. [The season sensor localization](https://github.com/home-assistant/home-assistant/pull/12453/commits/bb2f328ce10c3867990e34a88da64e2f8dc7a5c4) is a good example. - -## {% linkable_title Configuration Flow Localization %} -The translation strings for the configuration flow handler are defined under the `config` key. An example strings file below describes the different supported keys: - -```json -{ - "config": { - "title": "This title is shown in the integrations list", - "step": { - "init": { - "title": "The user visible title of the `init` step.", - "description": "Markdown that is shown with the step.", - "data": { - "api_key": "The label for the `api_key` input field" - } - } - }, - "error": { - "invalid_api_key": "This message will be displayed if `invalid_api_key` is returned as a flow error." - }, - "abort": { - "stale_api_key": "This message will be displayed if `stale_api_key` is returned as the abort reason." - } - } -} -``` + \ No newline at end of file diff --git a/source/developers/internationalization/custom_component_localization.markdown b/source/developers/internationalization/custom_component_localization.markdown index b7d12664d4..d0c6ecdc2f 100644 --- a/source/developers/internationalization/custom_component_localization.markdown +++ b/source/developers/internationalization/custom_component_localization.markdown @@ -10,11 +10,6 @@ footer: true ha_release: 0.64 --- -## {% linkable_title Translation Strings %} -Unlike localized strings merged in the home-assistant repository, custom components cannot take advantage of Lokalise for user submitted translations. However, custom component authors can still include translation with their components. These will be read from the `.translations` directory, adjacent to the component source file. They are named `..json`, unless the custom component exists in its own directory, in which case the file is simply named `.json` in the `.translations` directory. - -These files follow the same formatting as [backend translation string files](/developers/internationalization/backend_localization/), but a copy will exist for each translated language. - -The language codes follow the [BCP47](https://tools.ietf.org/html/bcp47) format. The [frontend translation files](https://github.com/home-assistant/home-assistant-polymer/tree/master/translations) can also be referred to if you are unsure of the correct language code to use. - -The frontend will serve these files after Home Assistant is restarted. + \ No newline at end of file diff --git a/source/developers/internationalization/index.markdown b/source/developers/internationalization/index.markdown index 109502fe45..ed93383a94 100644 --- a/source/developers/internationalization/index.markdown +++ b/source/developers/internationalization/index.markdown @@ -10,10 +10,6 @@ footer: true ha_release: 0.64 --- -The Home Assistant internationalization project includes preparing platforms and the frontend for localization, as well as the actual translation of localized strings. - -Some compmonents and platforms will have strings that need to be localized specifically for that platform. These strings are managed in the core [home-assistant](https://github.com/home-assistant/home-assistant) repository. The Home Assistant backend will serve strings to the clients based on the loaded components in the running instance. - -There are also localizable strings that exist only on the frontend. These strings are managed in the [home-assistant-polymer](https://github.com/home-assistant/home-assistant-polymer) repository. These strings are stored with the frontend and don’t depend on the backend configuration. - -Our strings are translated by the community using the online translation tool [Lokalise](https://lokalise.co/). + \ No newline at end of file diff --git a/source/developers/internationalization/translation.markdown b/source/developers/internationalization/translation.markdown index 334a68e6aa..411e5a09cb 100644 --- a/source/developers/internationalization/translation.markdown +++ b/source/developers/internationalization/translation.markdown @@ -11,43 +11,6 @@ ha_release: 0.57 redirect_from: /developers/frontend_translation/ --- -## {% linkable_title How to start %} -Translations for Home Assistant are managed through Lokalise, an online translation management tool. Our translations are split between two projects, a backend project for platform-specific translations, and a frontend project for UI translations. Click the links below to join both projects! Even if your language is completely translated, extra proofreading is a big help! Please feel free to review the existing translations, and vote for alternatives that might be more appropriate. - -- [Join the frontend translation team](https://lokalise.co/signup/3420425759f6d6d241f598.13594006/all/) -- [Join the backend translation team](https://lokalise.co/signup/130246255a974bd3b5e8a1.51616605/all/) - -For more information about the translation workflow, please see the [Lokalise translation workflow documents](https://docs.lokalise.co/category/iOzEuQPS53-for-team-leads-and-translators). - -

    -The translation of the Home Assistant frontend is still a work in progress. More phrases will be available for translation soon. -

    - -## {% linkable_title Translation placeholders %} - -Some translation strings will contain special placeholders that will be replaced later. Placeholders shown in square brackets `[]` are [Lokalise key references](https://docs.lokalise.co/article/KO5SZWLLsy-key-referencing). These are primarily used to link translation strings that will be duplicated. Different languages may not have the same duplicates as English, and are welcome to link duplicate translations that are not linked in English. Placeholders shown in curly brackets `{}` are [translation arguments](https://formatjs.io/guides/message-syntax/) that will be replaced with a live value when Home Assistant is running. Any translation argument placeholders present in the original string must be included in the translated string. These may include special syntax for defining plurals or other replacement rules. The linked format.js guide explains the syntax for adding plural definitions and other rules. - -## {% linkable_title Rules %} -1. Only native speakers should submit translations. -2. Stick to [Material Design guidelines](https://material.io/guidelines/style/writing.html). -3. Don't translate or change proper nouns like `Home Assistant`, `Hass.io` or `Hue`. -4. For a region specific translation, keys that will be the same as the base translation should be filled with `[VOID]`. These will be replaced during our translation build process. -5. Translations under the `state_badge` keys will be used for the notification badge display. These translations should be short enough to fit in the badge label without overflowing. This can be tested in the Home Assistant UI either by editing the label text with your browsers development tools, or by using the States developer tool in the Home Assistant UI. In the UI, enter a new entity ID (`device_tracker.test`), and enter the text you want to test in state. -6. If text will be duplicated across different translation keys, make use of the Lokalise key reference feature where possible. The base translation provides examples of this underneath the `states` translations. Please see the [Lokalise key referencing](https://docs.lokalise.co/article/KO5SZWLLsy-key-referencing) documentation for more details. - -## {% linkable_title Adding a new language %} -If your language is not listed you can request it at [GitHub](https://github.com/home-assistant/home-assistant-polymer/issues/new). Please provide both the English name and the native name for your language. For example: -``` -English Name: German -Native Name: Deutsch -``` - -

    -Region specific translations (`en-US`, `fr-CA`) will only be included if translations for that region need to differ from the base language translation. -

    - -### {% linkable_title Maintainer steps to add a new language %} -1. Language tags have to follow [BCP 47](https://tools.ietf.org/html/bcp47). A list of most language tags can be found here: [IANA sutbtag registry](http://www.iana.org/assignments/language-subtag-registry/language-subtag-registry). Examples: `fr`, `fr-CA`, `zh-Hans`. Only include the country code if country specific overrides are being included, and the base language is already translated. -2. Add the language tag and native name in `src/translations/translationMetadata.json`. Examples: "Français", "Français (CA)" -3. Add the new language in Lokalize. -Note: Sometimes you have to change the tag in Lokalise (Language -> Language settings -> custom ISO code). + \ No newline at end of file diff --git a/source/developers/maintenance.markdown b/source/developers/maintenance.markdown index 4995e7de51..d36bb625a0 100644 --- a/source/developers/maintenance.markdown +++ b/source/developers/maintenance.markdown @@ -9,44 +9,6 @@ sharing: true footer: true --- -This page documents a couple of points for maintaining the Home Assistant code. Most of the tasks don't need to be performed on a regular base thus the steps, used tools, or details are preserved here. - -## {% linkable_title Source code %} - -### {% linkable_title Line separator %} - -People are using various operating systems to develop components and platforms for Home Assistant. This could lead to different line endings on file. We prefer `LN`. Especially Microsoft Windows tools tend to use `CRLF`. - -```bash -$ find homeassistant -name "*.py" -exec file {} \; | grep BOM -$ find homeassistant -name "*.py" -exec file {} \; | grep CRLF -``` - -To fix the line separator, use `dos2unix` or `sed`. - -```bash -$ dos2unix homeassistant/components/notify/kodi.py -``` - -### {% linkable_title File permissions %} - -Most files don't need to the be executable. `0644` is fine. - -### {% linkable_title Dependencies %} - -A lot of components and platforms depends on third-party Python modules. The dependencies which are stored in the `requirements_*.txt` files are tracked by [gemnasium](https://gemnasium.com/github.com/home-assistant/home-assistant) and [Requires.io](https://requires.io/github/home-assistant/home-assistant/requirements/?branch=dev). - -If you update the requirements of a component/platform through the `REQUIREMENTS = ['modules-xyz==0.3']` entry, run the provided script to update the `requirements_*.txt` file(s). - -```bash -$ script/gen_requirements_all.py -``` - -Start a test run of Home Assistant. If that was successful, include all files in a Pull Request. Add a short summary of the changes, a sample configuration entry, details about the tests you performed to ensure the update works, and other useful information to the description. - - -## {% linkable_title Documentation %} - -- Merge `current` into `next` on a regular base. -- Optimize the images. - + \ No newline at end of file diff --git a/source/developers/multiple_instances.markdown b/source/developers/multiple_instances.markdown index f366abe19a..6669c7016d 100644 --- a/source/developers/multiple_instances.markdown +++ b/source/developers/multiple_instances.markdown @@ -9,37 +9,6 @@ sharing: true footer: true --- -# {% linkable_title This has been deprecated and is no longer supported. %} - -Home Assistant supports running multiple synchronized instances using a master-slave model. Whenever `events.fire` or `states.set` is called on the slave it will forward it to the master. The master will replicate all events and changed states to its slaves. - -

    - - - - Overview of the Home Assistant architecture for multiple devices. -

    - -A slave instance can be started with the following code and has the same support for components as a master instance. - -```python -import homeassistant.remote as remote -import homeassistant.bootstrap as bootstrap - -# Location of the Master API: host, password, port. -# Password and port are optional. -remote_api = remote.API("127.0.0.1", "password", 8124) - -# Initialize slave -hass = remote.HomeAssistant(remote_api) - -# To add an interface to the slave on localhost:8123 -bootstrap.setup_component(hass, 'frontend') - -hass.start() -hass.block_till_stopped() -``` - -

    -Because each slave maintains its own Service Registry it is possible to have multiple slaves respond to one service call. -

    + \ No newline at end of file diff --git a/source/developers/platform_example_light.markdown b/source/developers/platform_example_light.markdown index 8a11eec73f..2c067aed37 100644 --- a/source/developers/platform_example_light.markdown +++ b/source/developers/platform_example_light.markdown @@ -9,116 +9,6 @@ sharing: true footer: true --- -This example is for adding support for the imaginary Awesome Lights. It shows the different best practices for developing a platform. - -Similar to Example Sensor Platform, copy the code below, and create it as a file in `/custom_components/light/awesomelights.py`. - -Add the following to your configuration.yaml: - -```yaml -light: - - platform: awesomelights - host: HOST_HERE - username: USERNAME_HERE - password: PASSWORD_HERE_OR_secrets.yaml -``` - -Note the `platform` name matches the filename for the source code. - -```python -import logging - -import voluptuous as vol - -# Import the device class from the component that you want to support -from homeassistant.components.light import ATTR_BRIGHTNESS, Light, PLATFORM_SCHEMA -from homeassistant.const import CONF_HOST, CONF_USERNAME, CONF_PASSWORD -import homeassistant.helpers.config_validation as cv - -# Home Assistant depends on 3rd party packages for API specific code. -REQUIREMENTS = ['awesome_lights==1.2.3'] - -_LOGGER = logging.getLogger(__name__) - -# Validation of the user's configuration -PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({ - vol.Required(CONF_HOST): cv.string, - vol.Optional(CONF_USERNAME, default='admin'): cv.string, - vol.Optional(CONF_PASSWORD): cv.string, -}) - - -def setup_platform(hass, config, add_devices, discovery_info=None): - """Setup the Awesome Light platform.""" - import awesomelights - - # Assign configuration variables. The configuration check takes care they are - # present. - host = config.get(CONF_HOST) - username = config.get(CONF_USERNAME) - password = config.get(CONF_PASSWORD) - - # Setup connection with devices/cloud - hub = awesomelights.Hub(host, username, password) - - # Verify that passed in configuration works - if not hub.is_valid_login(): - _LOGGER.error("Could not connect to AwesomeLight hub") - return False - - # Add devices - add_devices(AwesomeLight(light) for light in hub.lights()) - - - -class AwesomeLight(Light): - """Representation of an Awesome Light.""" - - def __init__(self, light): - """Initialize an AwesomeLight.""" - self._light = light - self._name = light.name - self._state = None - self._brightness = None - - @property - def name(self): - """Return the display name of this light.""" - return self._name - - @property - def brightness(self): - """Return the brightness of the light. - - This method is optional. Removing it indicates to Home Assistant - that brightness is not supported for this light. - """ - return self._brightness - - @property - def is_on(self): - """Return true if light is on.""" - return self._state - - def turn_on(self, **kwargs): - """Instruct the light to turn on. - - You can skip the brightness part if your light does not support - brightness control. - """ - self._light.brightness = kwargs.get(ATTR_BRIGHTNESS, 255) - self._light.turn_on() - - def turn_off(self, **kwargs): - """Instruct the light to turn off.""" - self._light.turn_off() - - def update(self): - """Fetch new state data for this light. - - This is the only method that should fetch new data for Home Assistant. - """ - self._light.update() - self._state = self._light.is_on() - self._brightness = self._light.brightness -``` + \ No newline at end of file diff --git a/source/developers/platform_example_sensor.markdown b/source/developers/platform_example_sensor.markdown index 166b307117..110ab63137 100644 --- a/source/developers/platform_example_sensor.markdown +++ b/source/developers/platform_example_sensor.markdown @@ -9,58 +9,6 @@ sharing: true footer: true --- -This is a minimum implementation of a platform for the sensor component. - -### {% linkable_title Installation %} - -Copy the code below and create it as a file in `/custom_components/sensor/example.py`. - -Add the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -sensor: - platform: example -``` - -### {% linkable_title Code %} - -```python -from homeassistant.const import TEMP_CELSIUS -from homeassistant.helpers.entity import Entity - - -def setup_platform(hass, config, add_devices, discovery_info=None): - """Setup the sensor platform.""" - add_devices([ExampleSensor()]) - - -class ExampleSensor(Entity): - """Representation of a Sensor.""" - - def __init__(self): - """Initialize the sensor.""" - self._state = None - - @property - def name(self): - """Return the name of the sensor.""" - return 'Example Temperature' - - @property - def state(self): - """Return the state of the sensor.""" - return self._state - - @property - def unit_of_measurement(self): - """Return the unit of measurement.""" - return TEMP_CELSIUS - - def update(self): - """Fetch new state data for the sensor. - - This is the only method that should fetch new data for Home Assistant. - """ - self._state = 23 -``` + \ No newline at end of file diff --git a/source/developers/python_api.markdown b/source/developers/python_api.markdown index 818bb8d077..2e3ed1ba29 100644 --- a/source/developers/python_api.markdown +++ b/source/developers/python_api.markdown @@ -9,228 +9,6 @@ sharing: true footer: true --- -See the [developer documentation][devdocs] for a full overview of the documentation. The rest of this page will contain examples on how to use it. - -[devdocs]: https://dev-docs.home-assistant.io/en/master/api/homeassistant.html#module-homeassistant.remote - -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. If you are not using the [`frontend`](/components/frontend/) in your setup then you need to add the [`api` component](/components/api/) to your `configuration.yaml` file to use the Python Remote API. - -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 - -api = remote.API('127.0.0.1', 'password') -print(remote.validate_api(api)) -``` - -### {% linkable_title Get configuration %} - -Get the current configuration of a Home Assistant instance: - -```python -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'password') - -print(remote.get_config(api)) -``` - -### {% linkable_title Get details about services, events, and entitites %} - -The output from this is similar to the output you'd find via the frontend, using the [Developer Tools](/docs/tools/dev-tools/). - -```python -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') - -print('-- Available services:') -services = remote.get_services(api) -for service in services: - print(service['services']) - -print('\n-- Available events:') -events = remote.get_event_listeners(api) -for event in events: - print(event) - -print('\n-- Available entities:') -entities = remote.get_states(api) -for entity in entities: - print(entity) -``` - -### {% linkable_title Get the state of an entity %} - -To get the details of a single entity, use `get_state`: - -```python -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -office_temp = remote.get_state(api, 'sensor.office_temperature') -print('{} is {} {}.'.format( - office_temp.name, office_temp.state, - office_temp.attributes['unit_of_measurement']) -) -``` - -This outputs the details which are stored for this entity, ie: - -```bash -Office Temperature is 19 °C. -``` - -Switches work the same way. The only difference is that both entities have different attributes. - -```python -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -switch_livingroom = remote.get_state(api, 'switch.livingroom_pin_2') -print('{} is {}.'.format( - switch_livingroom.name, switch_livingroom.state) -) -``` - -### {% linkable_title Set the state of an entity %} - -Of course, it's possible to set the state as well: - -```python -import homeassistant.remote as remote -from homeassistant.const import STATE_ON - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -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 the new values until the next update occurs. - -### {% linkable_title Blinking all entities of a domain %} - -If you want to turn on all entities of a domain, retrieve the service via `get_services` and act on that: - - -```python -import time -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -domain = 'switch' - -remote.call_service(api, domain, 'turn_on') -time.sleep(10) -remote.call_service(api, domain, 'turn_off') -``` - -### {% linkable_title Control a single entity %} - -To turn on or off a single switch, pass the ID of the entity: - -```python -import time -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -domain = 'switch' -switch_name = 'switch.livingroom_pin_2' - -remote.call_service(api, domain, 'turn_on', {'entity_id': '{}'.format(switch_name)}) -time.sleep(5) -remote.call_service(api, domain, 'turn_off', {'entity_id': '{}'.format(switch_name)}) -``` - -### {% linkable_title Specify a timeout %} - -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 -longer timeout. - -```python -import homeassistant.remote as remote - -api = remote.API('host', 'password') -domain = 'switch' - -# Assuming switch.timeout_switch takes 10 seconds to return -switch_name = 'switch.timeout_switch' - -# Raises homeassistant.exceptions.HomeAssistantError: Timeout when talking to -remote.call_service(api, domain, 'turn_on', {'entity_id': switch_name}) - -# Runs withous exception -remote.call_service(api, domain, 'turn_on', {'entity_id': switch_name}, - timeout=11) -``` - -### {% 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: - -```python -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -domain = 'notify' -data = {"title":"Test", "message":"A simple test message from HA."} - -remote.call_service(api, domain, 'jabber', data) -``` - -## {% linkable_title Examples %} - -This section contains a couple of sample scripts. - -### {% linkable_title List all sensors and their value %} - -If you want to see, export or list all sensor states then an easy way to do it, is to get all entities and filter for the one you are looking for. - -```python -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') -entities = remote.get_states(api) -for entity in entities: - if entity.entity_id.startswith('sensor'): - data = remote.get_state(api, entity.entity_id) - print('{}: {}'.format(data.attributes['friendly_name'], data.state)) -``` - -### {% linkable_title Show difference between `last_changed` and `last_updated` %} - -The documentation about the [State Objects](/docs/configuration/state_object/) describes the -`last_changed` and `last_updated` fields. This example shows how it works in practice. - -```python -import time - -from prettytable import PrettyTable -import homeassistant.remote as remote - -api = remote.API('127.0.0.1', 'YOUR_PASSWORD') - -ACTIONS = { - 'Create sensor': [21, 'Test'], - 'No new sensor value': [21, 'Test'], - 'New sensor value': [22, 'Test'], - 'Update attribute': [22, 'Test1'], -} - -output = PrettyTable(['Action', 'Last changed', 'Last updated']) - -for key, value in ACTIONS.items(): - remote.set_state(api, 'sensor.test', new_state=value[0], - attributes={'friendly_name': value[1]}) - data = remote.get_state(api, 'sensor.test') - output.add_row([key, data.last_changed, data.last_updated]) - time.sleep(2) - -print(output) -``` - + \ No newline at end of file diff --git a/source/developers/releasing.markdown b/source/developers/releasing.markdown index 5ddce85418..741aa147d6 100644 --- a/source/developers/releasing.markdown +++ b/source/developers/releasing.markdown @@ -9,66 +9,6 @@ sharing: true footer: true --- -This page describes the steps for publishing a new Home Assistant release. Those steps requires that you don't use forks but work with the repositories themself. The [hass-release](https://github.com/home-assistant/hass-release) script is a helper to do a release. - -### {% linkable_title Release preparation (3 days before release) %} - -### {% linkable_title GitHub %} - -1. Merge `master` into `dev` to make the PR mergeable. -1. Cut a release branch from `dev`. Example name `release-0-57`. -1. Create a pull request from the release branch to `master` with the upcoming release number as the title. -1. Update `homeassistant/const.py` with the correct version number (remove the `dev` tag) and push that commit to release branch. - -### {% linkable_title Website %} - -1. Merge `current` into `next` -1. Cut release branch of `next`. For example `release-0-57`. -1. Open a PR from release branch to `current` with the upcoming release number as the title. - -## {% linkable_title Release day %} - -From creating the release branch till it has been merged, we tag bugfixes with the milestone for the release (create if doesn't exist). - -### {% linkable_title GitHub %} - -1. Cherry-pick the milestoned PRs that need to get into the release `python3 -m hassrelease milestone_cherry_pick 0.57` -1. Run `python3 -m hassrelease release_notes 0.56` for the release notes. -1. Once the release notes has been generated, issue `python3 -m hassrelease milestone_close 0.56` -1. Merge pull request (DO NOT SQUASH!). Use `Merge pull request`. -1. Go to [releases](https://github.com/home-assistant/home-assistant/releases), click `Draft a new release` and tag a new release on the `master` branch. "Tag version" and "Release title" are the version number (`O.x` for major version, `0.x.y` for minor and bug fix releases). Release description is the text from PR. Press "Publish release" to finish the process. -1. Merge `master` into `dev`. -1. Update `homeassistant/const.py` with the upcoming version number (including the `dev` tag) and push that commit to the `dev` branch. - -### {% linkable_title Website %} - -1. Create a blog post in the release branch and base it on the text of the PR in the main repository. Add images, additional text, links, etc. if it adds value. Tag each platform/component in a message to documentation. -1. Create missing documentation as stubs. -1. Run `credits_generator`. -1. Update `_config.yml` with a link to the new release blog post and version number (at the bottom of the file). -1. Merge `current` into release branch (`$ git checkout release-0-40 && git merge current`) to make the PR mergeable. -1. Merge pull request (blog post, updated frontpage, and all new documentation) to `current`. DO NOT SQUASH! -1. Merge `current` into `next`. - -### {% linkable_title Docker Hub %} - -Tags on Docker hub are automatically created when a release has been created on GitHub. - -### {% linkable_title Python Package Index %} - -Checkout the `master` branch and run `script/release` to publish the new release on [Python Package Index](https://pypi.python.org). - -### {% linkable_title Social media %} - -1. Use [hootsuite](https://hootsuite.com/dashboard) to publish a link to the release post on social media. - -## {% linkable_title Bugfix Release %} - -1. Checkout `master` and update it. `git checkout master && git pull --rebase` -1. Create a new release branch from `master`. `git checkout -b release-0-56-2` -1. Cherry-pick the PRs which were milestoned. -1. Update `homeassistant/const.py` with the correct version number (increment `PATCH_VERSION`) and push that commit to release branch. -1. Create a pull request from the release branch to `master` with the upcoming release number as the title. -1. Merge pull request (DO NOT SQUASH!). Use `Merge pull request`. -1. Go to [releases](https://github.com/home-assistant/home-assistant/releases), click `Draft a new release` and tag a new release on the `master` branch. "Tag version" and "Release title" are the version number (`O.x` for major version, `0.x.y` for minor and bug fix releases). Release description is the text from PR. Press "Publish release" to finish the process. -1. [Publish](/developers/releasing/#python-package-index) the new release on PyPI. + \ No newline at end of file diff --git a/source/developers/rest_api.markdown b/source/developers/rest_api.markdown index ec232cac97..83ac65d3b4 100644 --- a/source/developers/rest_api.markdown +++ b/source/developers/rest_api.markdown @@ -9,522 +9,6 @@ sharing: true footer: true --- -Home Assistant runs a web server accessible on port 8123. - -* http://IP_ADDRESS:8123/ is an interface to control Home Assistant. -* http://IP_ADDRESS:8123/api/ is a Rest API. - -The API accepts and returns only JSON encoded objects. All API calls have to be accompanied by the header `X-HA-Access: YOUR_PASSWORD` (YOUR_PASSWORD as specified in your `configuration.yaml` file in the [`http:` section](/components/http/)). - -If you are not using the [`frontend`](/components/frontend/) in your setup then you need to add the [`api` component](/components/api/) to your `configuration.yaml` file. - -There are multiple ways to consume the Home Assistant Rest API. One is with `curl`: - -```bash -curl -X GET \ - -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://IP_ADDRESS:8123/ENDPOINT -``` - -Another option is to use Python and the [Requests](http://docs.python-requests.org/en/latest/) module. = - -```python -from requests import get - -url = 'http://localhost:8123/ENDPOINT' -headers = {'x-ha-access': 'YOUR_PASSWORD', - 'content-type': 'application/json'} - -response = get(url, headers=headers) -print(response.text) -``` - -

    -You can append `?api_password=YOUR_PASSWORD` to any URL to log in automatically. -

    - -Successful calls will return status code 200 or 201. Other status codes that can return are: - -- 400 (Bad Request) -- 401 (Unauthorized) -- 404 (Not Found) -- 405 (Method not allowed) - -### {% linkable_title Actions %} - -The API supports the following actions: - -#### {% linkable_title GET /api/ %} - -Returns a message if the API is up and running. - -```json -{ - "message": "API running." -} -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/ -``` - -#### {% linkable_title GET /api/config %} - -Returns the current configuration as JSON. - -```json -{ - "components":[ - "sensor.cpuspeed", - "frontend", - "config.core", - "http", - "map", - "api", - "sun", - "config", - "discovery", - "conversation", - "recorder", - "group", - "sensor", - "websocket_api", - "automation", - "config.automation", - "config.customize" - ], - "config_dir":"/home/ha/.homeassistant", - "elevation":510, - "latitude":45.8781529, - "location_name":"Home", - "longitude":8.458853651, - "time_zone":"Europe/Zurich", - "unit_system":{ - "length":"km", - "mass":"g", - "temperature":"\u00b0C", - "volume":"L" - }, - "version":"0.56.2", - "whitelist_external_dirs":[ - "/home/ha/.homeassistant/www", - "/home/ha/.homeassistant/" - ] -} -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/config -``` - -#### {% linkable_title GET /api/discovery_info %} - -Returns basic information about the Home Assistant instance as JSON. - -```json -{ - "base_url": "http://192.168.0.2:8123", - "location_name": "Home", - "requires_api_password": true, - "version": "0.56.2" -} -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/discovery_info -``` - -#### {% linkable_title GET /api/events %} - -Returns an array of event objects. Each event object contains event name and listener count. - -```json -[ - { - "event": "state_changed", - "listener_count": 5 - }, - { - "event": "time_changed", - "listener_count": 2 - } -] -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/events -``` - -#### {% linkable_title GET /api/services %} - -Returns an array of service objects. Each object contains the domain and which services it contains. - -```json -[ - { - "domain": "browser", - "services": [ - "browse_url" - ] - }, - { - "domain": "keyboard", - "services": [ - "volume_up", - "volume_down" - ] - } -] -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/services -``` - -#### {% linkable_title GET /api/history/period/<timestamp> %} - -Returns an array of state changes in the past. Each object contains further details for the entities. - -The `` (`YYYY-MM-DDThh:mm:ssTZD`) is optional and defaults to 1 day before the time of the request. It determines the beginning of the period. - -You can pass the following optional GET parameters: - -- `filter_entity_id=` to filter on a single entity -- `end_time=` to choose the end of the period in URL encoded format (defaults to 1 day). - -```json -[ - [ - { - "attributes": { - "friendly_name": "Weather Temperature", - "unit_of_measurement": "\u00b0C" - }, - "entity_id": "sensor.weather_temperature", - "last_changed": "2016-02-06T22:15:00+00:00", - "last_updated": "2016-02-06T22:15:00+00:00", - "state": "-3.9" - }, - { - "attributes": { - "friendly_name": "Weather Temperature", - "unit_of_measurement": "\u00b0C" - }, - "entity_id": "sensor.weather_temperature", - "last_changed": "2016-02-06T22:15:00+00:00", - "last_updated": "2016-02-06T22:15:00+00:00", - "state": "-1.9" - }, - ] -] -``` - -Sample `curl` commands: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://localhost:8123/api/history/period/2016-12-29T00:00:00+02:00 -``` - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://localhost:8123/api/history/period/2016-12-29T00:00:00+02:00?filter_entity_id=sensor.temperature -``` - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://localhost:8123/api/history/period/2016-12-29T00:00:00+02:00?end_time=2016-12-31T00%3A00%3A00%2B02%3A00 -``` - -#### {% linkable_title GET /api/states %} - -Returns an array of state objects. Each state has the following attributes: entity_id, state, last_changed and attributes. - -```json -[ - { - "attributes": {}, - "entity_id": "sun.sun", - "last_changed": "2016-05-30T21:43:32.418320+00:00", - "state": "below_horizon" - }, - { - "attributes": {}, - "entity_id": "process.Dropbox", - "last_changed": "22016-05-30T21:43:32.418320+00:00", - "state": "on" - } -] -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/states -``` - -#### {% linkable_title GET /api/states/<entity_id> %} - -Returns a state object for specified entity_id. Returns 404 if not found. - -```json -{ - "attributes":{ - "azimuth":336.34, - "elevation":-17.67, - "friendly_name":"Sun", - "next_rising":"2016-05-31T03:39:14+00:00", - "next_setting":"2016-05-31T19:16:42+00:00" - }, - "entity_id":"sun.sun", - "last_changed":"2016-05-30T21:43:29.204838+00:00", - "last_updated":"2016-05-30T21:50:30.529465+00:00", - "state":"below_horizon" -} -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://localhost:8123/api/states/sensor.kitchen_temperature -``` - -#### {% linkable_title GET /api/error_log %} - -Retrieve all errors logged during the current session of Home Assistant as a plaintext response. - -```text -15-12-20 11:02:50 homeassistant.components.recorder: Found unfinished sessions -15-12-20 11:03:03 netdisco.ssdp: Error fetching description at http://192.168.1.1:8200/rootDesc.xml -15-12-20 11:04:36 homeassistant.components.alexa: Received unknown intent HelpIntent -``` - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://localhost:8123/api/error_log -``` - -#### {% linkable_title GET /api/camera_proxy/camera.<entity_id> %} - -Returns the data (image) from the specified camera entity_id. - -Sample `curl` command: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - http://localhost:8123/api/camera_proxy/camera.my_sample_camera?time=1462653861261 -o image.jpg -``` - -#### {% linkable_title POST /api/states/<entity_id> %} - -Updates or creates the current state of an entity. - -Expects a JSON object that has at least a state attribute: - -```json -{ - "state": "below_horizon", - "attributes": { - "next_rising":"2016-05-31T03:39:14+00:00", - "next_setting":"2016-05-31T19:16:42+00:00" - } -} -``` - -The return code is 200 if the entity existed, 201 if the state of a new entity was set. A location header will be returned with the URL of the new resource. The response body will contain a JSON encoded State object. - -```json -{ - "attributes": { - "next_rising":"2016-05-31T03:39:14+00:00", - "next_setting":"2016-05-31T19:16:42+00:00" - }, - "entity_id": "sun.sun", - "last_changed": "2016-05-30T21:43:29.204838+00:00", - "last_updated": "2016-05-30T21:47:30.533530+00:00", - "state": "below_horizon" -} -``` - -Sample `curl` command: - -```bash -$ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - -d '{"state": "25", "attributes": {"unit_of_measurement": "°C"}}' \ - http://localhost:8123/api/states/sensor.kitchen_temperature -``` - -#### {% linkable_title POST /api/events/<event_type> %} - -Fires an event with event_type - -You can pass an optional JSON object to be used as `event_data`. - -```json -{ - "next_rising":"2016-05-31T03:39:14+00:00", -} -``` - -Returns a message if successful. - -```json -{ - "message": "Event download_file fired." -} -``` - -#### {% linkable_title POST /api/services/<domain>/<service> %} - -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`. - -```json -{ - "entity_id": "light.Ceiling" -} -``` - -Returns a list of states that have changed while the service was being executed. - -```json -[ - { - "attributes": {}, - "entity_id": "sun.sun", - "last_changed": "2016-05-30T21:43:32.418320+00:00", - "state": "below_horizon" - }, - { - "attributes": {}, - "entity_id": "process.Dropbox", - "last_changed": "22016-05-30T21:43:32.418320+00:00", - "state": "on" - } -] -``` - -Sample `curl` commands: - -Turn the light on: - -```bash -$ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - -d '{"entity_id": "switch.christmas_lights"}' \ - http://localhost:8123/api/services/switch/turn_on -``` - -Send a MQTT message: - -```bash -$ curl -X POST \ - -H "Content-Type: application/json" \ - -H "x-ha-access:YOUR_PASSWORD" \ - -d '{"payload": "OFF", "topic": "home/fridge", "retain": "True"}' \ - http://localhost:8123/api/services/mqtt/publish -``` - -

    -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 %} - -Render a Home Assistant template. [See template docs for more information.](/topics/templating/) - -```json -{ - "template": "Paulus is at {% raw %}{{ states('device_tracker.paulus') }}{% endraw %}!" -} -``` - -Returns the rendered template in plain text. - -```text -Paulus is at work! -``` - -Sample `curl` command: - -```bash -$ curl -X POST -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" \ - -d '{"template": "It is {{ now }}!"}' http://localhost:8123/api/template -``` - -#### {% linkable_title POST /api/event_forwarding %} - -Set up event forwarding to another Home Assistant instance. - -Requires a JSON object that represents the API to forward to. - -```javascript -{ - "host": "machine", - "api_password": "my_super_secret_password", - "port": 8880 // optional -} -``` - -It will return a message if event forwarding was set up successfully. - -```json -{ - "message": "Event forwarding setup." -} -``` - -#### {% linkable_title DELETE /api/event_forwarding %} - -Cancel event forwarding to another Home Assistant instance.
    - -Requires a JSON object that represents the API to cancel forwarding to. - -```javascript -{ - "host": "machine", - "api_password": "my_super_secret_password", - "port": 8880 // optional -} -``` - -It will return a message if event forwarding was canceled successfully. - -```json -{ - "message": "Event forwarding cancelled." -} -``` - -

    -If your client does not support DELETE HTTP requests you can add an optional attribute _METHOD and set its value to DELETE. -

    + \ No newline at end of file diff --git a/source/developers/server_sent_events.markdown b/source/developers/server_sent_events.markdown index fc54b168da..62c1d956e6 100644 --- a/source/developers/server_sent_events.markdown +++ b/source/developers/server_sent_events.markdown @@ -9,65 +9,6 @@ sharing: true footer: true --- -The [server-sent events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events) feature is a one-way channel from your Home Assistant server to a client which is acting as a consumer. For bi-directional communication check the [RESTful API](/developers/rest_api/) and [Python API](/developers/python_api/). - -The URI that is generating the data is `/api/stream`. - -A requirement on the client-side is existing support for the [EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource) interface. - -There are various ways to access the stream. If you have not set an `api_password` in the [`http`](/components/http/) section of your `configuration.yaml` file then you use your modern browser to read the messages. A command-line option is `curl`: - -```bash -$ curl -X GET -H "x-ha-access: YOUR_PASSWORD" \ - -H "Content-Type: application/json" http://localhost:8123/api/stream -``` - -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 - - - -

    Getting Home Assistant server events

    -
    - - - -``` - -Visit [http://localhost:8123/local/sse.html](http://localhost:8123/local/sse.html) to see the stream of events. - -## {% linkable_title Examples %} - -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 -``` - -### {% linkable_title Website %} - -The [home-assistant-sse](https://github.com/fabaff/home-assistant-sse) repository contains a more advanced example. - -### {% linkable_title Python %} - -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 -``` - -A simple script to consume SSE in Python looks like this: - -```python -from sseclient import SSEClient - -messages = SSEClient('http://localhost:8123/api/stream?api_password=YOUR_PASSWORD') -for msg in messages: - print(msg) -``` + \ No newline at end of file diff --git a/source/developers/websocket_api.markdown b/source/developers/websocket_api.markdown index 76f7f0b0c7..7e8bf2f9ed 100644 --- a/source/developers/websocket_api.markdown +++ b/source/developers/websocket_api.markdown @@ -9,350 +9,6 @@ sharing: true footer: true --- -Home Assistant contains a WebSocket API. This API can be used to stream information from a Home Assistant instance to any client that implements WebSocket. Implementations in different languages: - -- [JavaScript](https://github.com/home-assistant/home-assistant-js-websocket) - powers the frontend -- [Python](https://raw.githubusercontent.com/home-assistant/home-assistant-dev-helper/master/ha-websocket-client.py) - CLI client using [`asyncws`](https://async-websockets.readthedocs.io/en/latest/) -- [JavaScript/HTML](https://raw.githubusercontent.com/home-assistant/home-assistant-dev-helper/master/ha-websocket.html) - WebSocket connection in your browser - -Connect your websocket implementation to `ws://localhost:8123/api/websocket`. - -If you are not using the [`frontend`](/components/frontend/) in your setup then you need to add the [`websocket_api` component](/components/websocket_api/) to your `configuration.yaml` file to use the WebSocket API. - -## {% linkable_title Server states %} - -1. Client connects. -1. Authentication phase starts. - - If no further authentication necessary for the user: go to 3. - - Server sends `auth_required` message. - - Client sends `auth` message. - - If `auth` message correct: go to 3. - - Server sends `auth_invalid`. Go to 6. -1. Send `auth_ok` message -1. Authentication phase ends. -1. Command phase starts. - 1. Client can send commands. - 1. Server can send results of previous commands. -1. Client or server disconnects session. - -During the command phase, the client attaches a unique identifier to each message. The server will add this identifier to each message so that the client can link each message to its origin. - -## {% linkable_title Message format %} - -Each API message is a JSON serialized object containing a `type` key. After the authentication phase messages also must contain an `id`, an integer that contains the number of interactions. - -Example of an auth message: - -```json -{ - "type": "auth", - "api_password": "supersecret" -} -``` - -```json -{ - "id" 5, - "type":"event", - "event":{ - "data":{}, - "event_type":"test_event", - "time_fired":"2016-11-26T01:37:24.265429+00:00", - "origin":"LOCAL" - } -} -``` - -## {% linkable_title Authentication phase %} - -When a client connects to the server, the server will test if the client is authenticated. Authentication will not be necessary if no api_password is set or if the user fulfills one of the other criteria for authentication (trusted network, password in url/header). - -If no authentication is needed, the authentication phase will complete and the server will send an `auth_ok` message. - -```json -{ - "type": "auth_ok" -} -``` - -If authentication is necessary, the server sends out `auth_required`. - -```json -{ - "type": "auth_required" -} -``` - -This means that the next message from the client should be an auth message: - -```json -{ - "type": "auth", - "api_password": "supersecret" -} -``` - -If the client supplies valid authentication, the authentication phase will complete by the server sending the `auth_ok` message: - -```json -{ - "type": "auth_ok" -} -``` - -If the data is incorrect, the server will reply with `auth_invalid` message and disconnect the session. - -```json -{ - "type": "auth_invalid", - "message": "Invalid password" -} -``` - -## {% linkable_title Command phase %} - -During this phase the client can give commands to the server. The server will respond to each command with a `result` message indicating when the command is done and if it was successful. - -```json -{ - "id": 6. - "type": "result", - "success": true, - // Can contain extra result info - "result": null -} -``` - -## {% linkable_title Subscribe to events %} - -The command `subscribe_events` will subscribe your client to the event bus. You can either listen to all events or to a specific event type. If you want to listen to multiple event types, you will have to send multiple `subscribe_events` commands. - -```json -{ - "id": 18, - "type": "subscribe_events", - // Optional - "event_type": "state_changed" -} -``` - -The server will respond with a result message to indicate that the subscription is active. - -```json -{ - "id": 18, - "type": "result", - "success": true, - "result": null -} -``` - -For each event that matches, the server will send a message of type `event`. The `id` in the message will point at the original `id` of the `listen_event` command. - -```json -{ - "id": 18, - "type":"event", - "event":{ - "data":{ - "entity_id":"light.bed_light", - "new_state":{ - "entity_id":"light.bed_light", - "last_changed":"2016-11-26T01:37:24.265390+00:00", - "state":"on", - "attributes":{ - "rgb_color":[ - 254, - 208, - 0 - ], - "color_temp":380, - "supported_features":147, - "xy_color":[ - 0.5, - 0.5 - ], - "brightness":180, - "white_value":200, - "friendly_name":"Bed Light" - }, - "last_updated":"2016-11-26T01:37:24.265390+00:00" - }, - "old_state":{ - "entity_id":"light.bed_light", - "last_changed":"2016-11-26T01:37:10.466994+00:00", - "state":"off", - "attributes":{ - "supported_features":147, - "friendly_name":"Bed Light" - }, - "last_updated":"2016-11-26T01:37:10.466994+00:00" - } - }, - "event_type":"state_changed", - "time_fired":"2016-11-26T01:37:24.265429+00:00", - "origin":"LOCAL" - } -} -``` - -### {% linkable_title Unsubscribing from events %} - -You can unsubscribe from previously created subscription events. Pass the id of the original subscription command as value to the subscription field. - -```json -{ - "id": 19, - "type": "unsubscribe_events", - "subscription": 18 -} -``` - -The server will respond with a result message to indicate that unsubscribing was successful. - -```json -{ - "id": 19, - "type": "result", - "success": true, - "result": null -} -``` - -### {% linkable_title Calling a service %} - -This will call a service in Home Assistant. Right now there is no return value. The client can listen to `state_changed` events if it is interested in changed entities as a result of a service call. - -```json -{ - "id": 24, - "type": "call_service", - "domain": "light", - "service": "turn_on", - // Optional - "service_data": { - "entity_id": "light.kitchen" - } -} -``` - -The server will indicate with a message indicating that the service is done executing. - -```json -{ - "id": 24, - "type": "result", - "success": true, - "result": null -} -``` - -### {% linkable_title Fetching states %} - -This will get a dump of all the current states in Home Assistant. - -```json -{ - "id": 19, - "type": "get_states" -} -``` - -The server will respond with a result message containing the states. - -```json -{ - "id": 19, - "type": "result", - "success": true, - "result": [ ... ] -} -``` - -### {% linkable_title Fetching config %} - -This will get a dump of the current config in Home Assistant. - -```json -{ - "id": 19, - "type": "get_config" -} -``` - -The server will respond with a result message containing the config. - -```json -{ - "id": 19, - "type": "result", - "success": true, - "result": { ... } -} -``` - -### {% linkable_title Fetching services %} - -This will get a dump of the current services in Home Assistant. - -```json -{ - "id": 19, - "type": "get_services" -} -``` - -The server will respond with a result message containing the services. - -```json -{ - "id": 19, - "type": "result", - "success": true, - "result": { ... } -} -``` - -### {% linkable_title Fetching panels %} - -This will get a dump of the current registered panels in Home Assistant. - -```json -{ - "id": 19, - "type": "get_panels" -} -``` - -The server will respond with a result message containing the current registered panels. - -```json -{ - "id": 19, - "type": "result", - "success": true, - "result": [ ... ] -} -``` - -## {% linkable_title Error handling %} - -If an error occurs, the `success` key in the `result` message will be set to `false`. It will contain an `error` key containing an object with two keys: `code` and `message`. - -| Code | Description | -| ----- | ------------ | -| 1 | A non-increasing identifier has been supplied. -| 2 | Received message is not in expected format (voluptuous validation error). -| 3 | Requested item cannot be found - -```json -{ - "id": 12, - "type":"result", - "success": false, - "error": { - "code": 2, - "message": "Message incorrectly formatted: expected str for dictionary value @ data['event_type']. Got 100" - } -} -``` + \ No newline at end of file diff --git a/source/help/index.markdown b/source/help/index.markdown index 9852420f82..d1573cd86e 100644 --- a/source/help/index.markdown +++ b/source/help/index.markdown @@ -3,7 +3,7 @@ layout: page title: "Help" description: "If you need help or have a question..." date: 2015-06-25 12:30 -sidebar: false +sidebar: true comments: false sharing: true footer: true @@ -17,7 +17,7 @@ There are various ways to get in touch with the Home Assistant community. It doe - [Discord Chat Server][discord] for general Home Assistant discussions and questions. - Follow us on [Twitter][twitter], use [@home_assistant][twitter] - Join the [Google+ community][google-plus] -- Join the [Reddit subreddit][reddit] in [/r/homeassistant][reddit] +- Join the Reddit in [/r/homeassistant][reddit] ### {% linkable_title Bugs, Feature requests, and alike %} @@ -77,10 +77,6 @@ Don't miss the regular [Home Assistant podcasts](https://hasspodcast.io/). - [5 open source home automation tools](https://opensource.com/life/16/3/5-open-source-home-automation-tools) by [opensource.com](https://opensource.com) - March 2016 - [Home Assistant – Open Source Python Home Automation Platform](http://www.automatedhome.co.uk/new-products/home-assistant-open-source-python-home-automation-platform.html) - January 2015 -### {% linkable_title Roadmap %} - -There is no explicit roadmap available, but the public [tracker](https://www.pivotaltracker.com/n/projects/1250084) can give you some insight into what is going on. - [forum]: https://community.home-assistant.io/ [twitter]: https://twitter.com/home_assistant [google-plus]: https://plus.google.com/u/0/b/110560654828510104551/communities/106562234893511202708 From 73d436247a58bab4dc0185e925986d28658940e0 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 26 Apr 2018 12:58:51 -0400 Subject: [PATCH 169/241] Add blog post about dev website --- .../_posts/2018-04-26-developer-site.markdown | 20 ++++++++++++++++++ .../2018-04-developer-website/screenshot.png | Bin 0 -> 67756 bytes 2 files changed, 20 insertions(+) create mode 100644 source/_posts/2018-04-26-developer-site.markdown create mode 100644 source/images/blog/2018-04-developer-website/screenshot.png diff --git a/source/_posts/2018-04-26-developer-site.markdown b/source/_posts/2018-04-26-developer-site.markdown new file mode 100644 index 0000000000..2895a83338 --- /dev/null +++ b/source/_posts/2018-04-26-developer-site.markdown @@ -0,0 +1,20 @@ +--- +layout: post +title: "New developer website" +description: "We have extracted the developer section of our website into its own website." +date: 2018-04-26 00:01:00 +date_formatted: "April 26, 2018" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Announcement +og_image: /images/blog/2018-04-developer-website/screenshot.png +--- + +When we launched the website in December 2014, we've only had a handful of components and usage instructions. Since then the website has grown to over a 1000 pages touching a wide range of topics. The growth, while great, also has put a lot of strain on how the docs are organised. One of the places that was especially suffering under the growth was the developer section. It was living under a single top menu item and had to contain everything in a single sidebar. + +To fix this, we're releasing a new website: [developers.home-assistant.io](https://developers.home-assistant.io). The website is aimed at people that are developing Home Assistant. It will contain resources how to setup your development environment, how to fix bugs, help with translations or improve the frontend. The main website will now solely be focused on Home Assistant users. + +Go check it out and let us know what you think: [developers.home-assistant.io](https://developers.home-assistant.io). + +Screenshot of the developer website diff --git a/source/images/blog/2018-04-developer-website/screenshot.png b/source/images/blog/2018-04-developer-website/screenshot.png new file mode 100644 index 0000000000000000000000000000000000000000..faccecea640946f2dc86eb4019637cde7a56425b GIT binary patch literal 67756 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͗>e|250n8~6;h-Wi#N;?65w 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 WYHv2Awr!XN;(EIJxvX Date: Thu, 26 Apr 2018 22:55:03 +0200 Subject: [PATCH 170/241] Added new device classes to binary_sensor - HomeKit (#5254) --- source/_components/homekit.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 631ddf592c..d84658d945 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -194,7 +194,7 @@ The following components are currently supported: | Component | Type Name | Description | | --------- | --------- | ----------- | | alarm_control_panel | SecuritySystem | All security systems. | -| binary_sensor | Sensor | Support for `CO2`, `Gas`, `Moisture`, `Motion`, `Occupancy`, `Opening` and `Smoke` device classes. Defaults to the `Occupancy` device class for everything else. | +| binary_sensor | Sensor | Support for `co2`, `door`, `garage_door`, `gas`, `moisture`, `motion`, `occupancy`, `opening`, `smoke` and `window` device classes. Defaults to the `occupancy` device class for everything else. | | climate | Thermostat | All climate devices. | | cover | GarageDoorOpener | All covers that support `open` and `close` and have `garage` as their `device_class`. | | cover | WindowCovering | All covers that support `set_cover_position`. | From 546806f1c6bfb194c3d9486bc159180715e5dd22 Mon Sep 17 00:00:00 2001 From: Johann Kellerman Date: Fri, 27 Apr 2018 21:41:00 +0200 Subject: [PATCH 171/241] Update qwikswitch add binary_sensors (#5210) * Update qwikswitch.markdown * bin --- .../binary_sensor.qwikswitch.markdown | 18 ++++++++++++++++++ source/_components/qwikswitch.markdown | 11 +++++++---- source/_components/sensor.qwikswitch.markdown | 2 +- source/images/supported_brands/qwikswitch.png | Bin 20959 -> 5032 bytes 4 files changed, 26 insertions(+), 5 deletions(-) create mode 100644 source/_components/binary_sensor.qwikswitch.markdown diff --git a/source/_components/binary_sensor.qwikswitch.markdown b/source/_components/binary_sensor.qwikswitch.markdown new file mode 100644 index 0000000000..e3fd446a3b --- /dev/null +++ b/source/_components/binary_sensor.qwikswitch.markdown @@ -0,0 +1,18 @@ +--- +layout: page +title: "QwikSwitch Binary Sensor" +description: "Instructions on how to integrate Qwikswitch dimmers and relays as sensors into Home Assistant." +date: 2016-05-04 00:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: qwikswitch.png +ha_category: Sensor +ha_iot_class: "Local Push" +ha_release: "0.68" +--- + +The `qwikswitch` binary_sensor platform allows you to use your [QwikSwitch](http://www.qwikswitch.co.za/) sensors within Home Assistant. + +The platform is configured through the [QwikSwitch component](/components/qwikswitch/). diff --git a/source/_components/qwikswitch.markdown b/source/_components/qwikswitch.markdown index 8889e29fbc..e915be3979 100644 --- a/source/_components/qwikswitch.markdown +++ b/source/_components/qwikswitch.markdown @@ -60,16 +60,19 @@ On some QS Mobile servers button events are only generated for switches added to ### {% linkable_title Qwikswitch Sensors %} -The sensor configuration is a list of sensors. Each sensor is configured with the following parameters: +The sensor configuration is a list of sensors. Depending on the type, it will be a sensor or binary_sensor. Each sensor is configured with the following parameters: - **name** (*Required*): The sensor name from which the entity_id will be derived. - **id** (*Required*): A QS_Id - **type** (*Required*): The Qwikswitch sensor type. These could include: - - imod (up to 6 channels) - - door (single channel) - - qwikcord (Channel1 = CTavg, Channel 2 = CTsum) + - imod (binary_sensor, up to 6 channels) + - door (binary_sensor, single channel) + - qwikcord (Channel 1 = CTavg, Channel 2 = CTsum) - **channel** (*Optional, default=1*): The channel of interest. Refer to type above. +The following parameters are only applicabe to binary_sensors (i.e. door/imod). +- **invert** (*Optional, default=False): Invert the open/close state. +- **class** (*Optional, default=door): The [class](https://www.home-assistant.io/components/binary_sensor) or binary_sensor. Example sensor configuration: diff --git a/source/_components/sensor.qwikswitch.markdown b/source/_components/sensor.qwikswitch.markdown index b2574cdb1d..afc4fc6cb4 100644 --- a/source/_components/sensor.qwikswitch.markdown +++ b/source/_components/sensor.qwikswitch.markdown @@ -13,6 +13,6 @@ ha_iot_class: "Local Push" ha_release: "0.67" --- -The `qwikswitch` sensor platform allows you to control your [QwikSwitch](http://www.qwikswitch.co.za/) relays and dimmers as sensors from within Home Assistant. +The `qwikswitch` sensor platform allows you to use your [QwikSwitch](http://www.qwikswitch.co.za/) sensors in Home Assistant. The platform is configured through the [QwikSwitch component](/components/qwikswitch/). diff --git a/source/images/supported_brands/qwikswitch.png b/source/images/supported_brands/qwikswitch.png index ada6158b54d772df5d1e64ffe38e8a12a014c3c4..0109f03a359ad82fa55a4bdc89c315d63e2244d5 100644 GIT binary patch literal 5032 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 literal 20959 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

    eB5EdIu+eFVCBE~6m@4Z0S z@v&KCZsbpuTFh;Sf3^_T{AXpfx@}l0U@HBub|6hIg)m$qqs`6DYKwgx9VW%2nR%<` zE}$?=7X4oYgl%nY<^Q_vh9N8;fMy?a@Ds^cX4Q$|iYaa~)VG)Y% zT12eH!rlSGB1+w>u#X^1tTdrU^#}Q=UL-&<@Ubq~HCU@xpFD(J+X^F&mvQ#;6~fv} zG_ke9#2~1S^DN2=#iY5u1z~UEf`aAm3Bm+@DhRWlMW6P+9W?fZi*F`H7QjtE*kh!u-6b+*KhA*^Y60_W9;=JQvA*6d+C; zsuJ%Wv=HVxKR>5q2xwbXc`9)dca5Zqj}F2-9R$KI8VGZ0JP3qI@%{0~A9IDzAHqZ~ z3m4M4+jEY$_=WQhXSeuLoq}zyuSYh({_buKVXx{F$pInEqK((2E5Ud~HdQi&q_fqP zRkna2QP-pj5XL^5eNwLqx-Nh{IDcq%g&F~oCkIDOdT@=EvK4UH=Cf9#(2=*Z%NoKu zmqS?CwvJ9q3O8`C4qm;n&BEU%h_l3uP;Ne$1$WSr`SZY_~aDwMQdcCUm+HSOp51*1$}WYyWUsWk@X(Rtjx z`qYVq5hs-vvor!J2&7pRLc!|1LV_DW%G7d-Z!X3)qx>IIkmDflNIIU&h>0iW-t|+< zR11KLGZ12)GTXn*5l$gKKQ&YPK~D3|)>(fDD-{S7RZ6eaR-K!*I3o^MN8#?bteAB@ zep;Cq;xN&hW8FMf0B*cJVu+==g(~Nf>m4fn>0NSgA}7;s+?L3D3S1)|MSa33nGLju zoM@ZM{wSGs{7~y8j;Km+_ix`NQ98##fI(@XX}NzMfklp5^HW`E$bJ6fk3R-sj{e02GpRFXap$g-oP0L4yS$$wlNwDoAlXLv2XwOyZylG-~eTHQVrYL%kBROYa{V=W}-`ndhiqTV-^ZT z6N`widZ>_jWy&iHi*b7XNnRFwC#BfsvbVEi=J?L;U`w}d3(?w1q^(yCA)R2hCU*OL zLJtv`%5);`=SM2Dr6Up4`z6m)pKVba$L%MEepwIQ5#lMz-A;{J9n(-bO*Uzjkt#1@MQvx(7@doYyqjZE0uKH$v%f^;?$Q!vePEt9{0=5zZE)x+Ym%g;N)BX_v0000005Ab^ Wyt}0?f55^30000 Date: Fri, 27 Apr 2018 22:41:31 +0300 Subject: [PATCH 172/241] Add link to supported AWS regions to the Amazon Polly docs (#5247) --- source/_components/tts.amazon_polly.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/tts.amazon_polly.markdown b/source/_components/tts.amazon_polly.markdown index 267d0c52b4..6561bc6d09 100644 --- a/source/_components/tts.amazon_polly.markdown +++ b/source/_components/tts.amazon_polly.markdown @@ -35,7 +35,7 @@ Configuration variables: | `aws_access_key_id` | Required | Your AWS Access Key ID. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_secret_access_key` and must **not** provide a `profile_name` | | `aws_secret_access_key` | Required | Your AWS Secret Access Key. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_access_key_id` and must **not** provide a `profile_name`. | | `profile_name` | Optional | A credentials profile name. For more information, please see the [boto3 Documentation](http://boto3.readthedocs.io/en/latest/guide/configuration.html#shared-credentials-file) for more information. | -| `region_name` | Optional | The region identifier to connect to. The default is `us-east-1`. | +| `region_name` | Optional | The region identifier to connect to. The default is `us-east-1`. See the [AWS Regions and Endpoints Reference](https://docs.aws.amazon.com/general/latest/gr/rande.html#pol_region) for available regions. | | `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`. | | `text_type` | text/ssml | text or ssml: Specify wherever to use text (default) or ssml markup by default. | | `voice` | Optional | Voice name to be used. See the [Amazon Documentation](http://docs.aws.amazon.com/polly/latest/dg/voicelist.html) for available voices. | From cb858f2b1f4fd28f19dad1cf7b409033bc122c70 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Fri, 27 Apr 2018 17:05:37 -0400 Subject: [PATCH 173/241] Add blog post --- source/_components/light.eufy.markdown | 2 +- source/_components/sensor.uscis.markdown | 6 +- source/_components/switch.eufy.markdown | 2 +- source/_posts/2018-04-27-release-68.markdown | 124 ++++++++++++------ .../images/blog/2018-04-0.68/components.png | Bin 0 -> 39722 bytes 5 files changed, 87 insertions(+), 47 deletions(-) create mode 100644 source/images/blog/2018-04-0.68/components.png diff --git a/source/_components/light.eufy.markdown b/source/_components/light.eufy.markdown index 872526e1ed..d8596c0048 100644 --- a/source/_components/light.eufy.markdown +++ b/source/_components/light.eufy.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "EufyLights" +title: "Eufy Lights" description: "Instructions on how to integrate Eufy LED lights into Home Assistant." date: 2018-04-09 19:00 sidebar: true diff --git a/source/_components/sensor.uscis.markdown b/source/_components/sensor.uscis.markdown index 49d55b0416..3d214dc818 100644 --- a/source/_components/sensor.uscis.markdown +++ b/source/_components/sensor.uscis.markdown @@ -7,7 +7,7 @@ sidebar: false comments: false sharing: true footer: true -logo: uscis.jpg +logo: uscis.png ha_category: Sensor ha_release: 0.68 ha_iot_class: "Cloud Polling" @@ -31,9 +31,9 @@ friendly_name: default: USCIS type: string case_id: - description: Case/receipt number used to get the case details from USCIS web client. + description: Case/receipt number used to get the case details from USCIS web client. required: true type: string {% endconfiguration %} -All the data will be fetch from [USCIS](https://egov.uscis.gov/casestatus/mycasestatus.do). +All the data will be fetch from [USCIS](https://egov.uscis.gov/casestatus/mycasestatus.do). diff --git a/source/_components/switch.eufy.markdown b/source/_components/switch.eufy.markdown index 0bfbae81e5..1a79dbd26b 100644 --- a/source/_components/switch.eufy.markdown +++ b/source/_components/switch.eufy.markdown @@ -1,6 +1,6 @@ --- layout: page -title: "EufySwitch" +title: "Eufy Switch" description: "Instructions on how to integrate Eufy switches into Home Assistant." date: 2018-04-09 19:00 sidebar: true diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown index cc616913a5..fc39df1405 100644 --- a/source/_posts/2018-04-27-release-68.markdown +++ b/source/_posts/2018-04-27-release-68.markdown @@ -1,8 +1,8 @@ --- layout: post -title: "0.68: UPDATE DATE" -description: "UPDATE DATE" -date: 2018-04-20 00:01:00 +title: "0.68: HomeKit control, Eufy, FritzBox, SigFox sensors" +description: "Enjoy your weekend with this brand new release of Home Assistant." +date: 2018-04-27 00:01:00 date_formatted: "April 27, 2018" author: Paulus Schoutsen author_twitter: balloob @@ -13,11 +13,11 @@ og_image: /images/blog/2018-04-0.68/components.png -Highlights: +Weekend is around the corner and that means that it's time for the next release of Home Assistant. 0.68 brings a ton of great goodies and bug fixes. -- Ability to _control_ HomeKit -- Eufy bulbs -- Breaking MDI icons? +One of the coolest features this release is by [@mjg59]: you are now able to **control** HomeKit devices. Previously, it was possible to control Home Assistant from iOS devices using the HomeKit protocol. With this release, Home Assistant is able to become the controller and use HomeKit to control lights and switches directly. Since HomeKit is vendor agnostic, it means that any HomeKit light or switch will now be compatible with Home Assistant. Very cool. + +Another cool new platform, also by [@mjg59], is support for Eufy devices. Eufy is the Home Automation brand of Anker and they have been producing reasonably priced devices which can now be controlled by Home Assistant too. Thanks for all your contributions [@mjg59] ❤️. ## {% linkable_title New Platforms %} @@ -29,7 +29,6 @@ Highlights: - Adds SigFox sensor ([@robmarkcole] - [#13731]) ([sensor.sigfox docs]) (new-platform) - Add blackbird media player component ([@koolsb] - [#13549]) ([media_player.blackbird docs]) (new-platform) - Add support for Sensirion SHT31 temperature/humidity sensor ([@viorels] - [#12952]) ([sensor.sht31 docs]) (new-platform) -- Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.lmsensor docs]) ([sensor.miflora docs]) (new-platform) - Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) ## {% linkable_title New Features %} @@ -40,15 +39,6 @@ Highlights: - Support Garage Doors in HomeKit ([@marthoc] - [#13796]) ([homekit docs]) (new-feature) - Support basic covers with open/close/stop services HomeKit ([@nickw444] - [#13819]) ([homekit docs]) (new-feature) -## {% linkable_title Beta Fixes %} - -- Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) -- Order the output of the automation editor ([@balloob] - [#14019]) ([config docs]) (beta fix) -- HomeKit Alarm Control Panel Code Exception Fix ([@schmittx] - [#14025]) ([homekit docs]) (beta fix) -- Revert cast platform polling mode ([@OttoWinter] - [#14027]) ([media_player.cast docs]) (beta fix) -- Handle HomeKit configuration failure more cleanly ([@mjg59] - [#14041]) ([homekit_controller docs]) (beta fix) -- Update device classes for contact sensor HomeKit ([@marthoc] - [#14051]) ([homekit docs]) (beta fix) - ## {% linkable_title If you need help... %} ...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. @@ -60,18 +50,52 @@ Experiencing issues introduced by this release? Please report them in our [issue ## {% linkable_title Breaking Changes %} -- Support for multiple MAX!Cube LAN gateways added ([@syssi] - [#13517]) ([maxcube docs]) ([binary_sensor.maxcube docs]) ([climate.maxcube docs]) (breaking change) -- Disable ebox requirement ([@balloob] - [#14003]) ([sensor.ebox docs]) (breaking change) +- Icons! Material Design Icons has implemented some naming guidelines and this caused 9 icons to change names, 3 of which are home automation icons: `roomba` -> `robot-vacuum`, `nest-protect` -> `smoke-detector`, `nest-thermostat` -> `thermostat` ([see all changes](http://templarian.com/2018/04/18/material-design-icons-v2-3-54/)). +- Support for multiple MAX!Cube LAN gateways caused a slight change to the configuration schema. Make sure to check the docs for the new one. ([@syssi] - [#13517]) ([maxcube docs]) ([binary_sensor.maxcube docs]) ([climate.maxcube docs]) (breaking change) +- Ebox sensor platform has been disabled because the dependency was not compatible with pip 10. ([@balloob] - [#14003]) ([sensor.ebox docs]) (breaking change) + +## {% linkable_title Beta Fixes %} + +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) +- Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) +- Order the output of the automation editor ([@balloob] - [#14019]) ([config docs]) (beta fix) +- HomeKit Alarm Control Panel Code Exception Fix ([@schmittx] - [#14025]) ([homekit docs]) (beta fix) +- Revert cast platform polling mode ([@OttoWinter] - [#14027]) ([media_player.cast docs]) (beta fix) +- Handle HomeKit configuration failure more cleanly ([@mjg59] - [#14041]) ([homekit_controller docs]) (beta fix) +- Update device classes for contact sensor HomeKit ([@marthoc] - [#14051]) ([homekit docs]) (beta fix) +- Upgrade broadlink lib ([@Danielhiversen] - [#14074]) ([sensor.broadlink docs]) ([switch.broadlink docs]) (beta fix) +- Fix timezone issue when calculating min/max values in tibber #14009 ([@Danielhiversen] - [#14080]) ([sensor.tibber docs]) (beta fix) +- Updated list of AWS regions for Amazon Polly ([@GotoCode] - [#14097]) ([tts docs]) (beta fix) ## {% linkable_title All changes %} - Update Homekit to 1.1.9 ([@cdce8p] - [#13716]) ([homekit docs]) -- Update docstrings ([@fabaff] - [#13720]) ([ihc docs]) ([cover.opengarage docs]) ([cover.tahoma docs]) ([light.aurora docs]) ([sensor.trafikverket_weatherstation docs]) -- Add option to ignore availability in google calendar events ([@cgtobi] - [#13714]) ([google docs]) ([calendar.google docs]) +- Update docstrings ([@fabaff] - [#13720]) ([ihc docs]) ([cover.opengarage docs]) ([cover.tahoma docs]) ([sensor.trafikverket_weatherstation docs]) +- Add option to ignore availability in google calendar events ([@cgtobi] - [#13714]) ([calendar.google docs]) - Allow use of date_string in service call ([@Juggels] - [#13256]) ([calendar.todoist docs]) - Add timeout / debounce (for brightness and others) ([@cdce8p] - [#13534]) ([homekit docs]) - added support for smappee water sensors ([@hmn] - [#12831]) ([smappee docs]) ([sensor.smappee docs]) - Initialise filter_sensor with historical values ([@dgomes] - [#13075]) ([sensor.filter docs]) +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) - Bluesound bugfix status 595 and await ([@thrawnarn] - [#13727]) ([media_player.bluesound docs]) - Upgrade aiohttp to 3.1.2 ([@fabaff] - [#13732]) - Upgrade sqlalchemy to 1.2.6 ([@fabaff] - [#13733]) ([sensor.sql docs]) @@ -79,6 +103,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Update CODEOWNERS (sensor.filter, sensor.upnp) ([@dgomes] - [#13736]) - Reset permission ([@fabaff] - [#13743]) ([light.abode docs]) - Throw an error when invalid device_mode is given ([@dangyuluo] - [#13739]) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) - Upgrade netdisco to 1.3.1 ([@fabaff] - [#13744]) - Add MQTT Sensor unique_id ([@OttoWinter] - [#13318]) ([sensor.mqtt docs]) - Prepare entity component for config entries ([@balloob] - [#13730]) @@ -118,13 +143,18 @@ Experiencing issues introduced by this release? Please report them in our [issue - bump python-ecobee-api version to 0.0.18 ([@geekofweek] - [#13854]) ([ecobee docs]) - Adding USCIS component ([@meauxt] - [#13764]) ([sensor.uscis docs]) (new-platform) - Avoid unnecessary cast state updates ([@dersger] - [#13770]) ([media_player.cast docs]) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) - Update yweather.py ([@TheCellMC] - [#13851]) ([weather.yweather docs]) - add support for Kodi discovery ([@escoand] - [#13790]) ([media_player.kodi docs]) - Further untangle data entry flow ([@balloob] - [#13855]) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) - Added snips service descriptions ([@tschmidty69] - [#13883]) - Add unique_id for BMW ConnectedDrive ([@gerard33] - [#13888]) ([binary_sensor.bmw_connected_drive docs]) ([lock.bmw_connected_drive docs]) ([sensor.bmw_connected_drive docs]) - Revert "Update yweather.py" ([@pvizeli] - [#13900]) ([weather.yweather docs]) - Eufy colour bulb updates ([@mjg59] - [#13895]) ([eufy docs]) ([light.eufy docs]) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) - Fritzbox netmonitor name ([@escoand] - [#13903]) ([sensor.fritzbox_netmonitor docs]) - Restore typeerror check for units sans energy tracking ([@andersonshatch] - [#13824]) ([switch.edimax docs]) - Add more math functions to templates ([@Shou] - [#13915]) @@ -135,8 +165,10 @@ Experiencing issues introduced by this release? Please report them in our [issue - Add support for new platform: climate.modbus ([@Kirchoff] - [#12224]) ([climate.modbus docs]) (new-platform) - Hive R3 update ([@KJonline] - [#13357]) ([hive docs]) ([binary_sensor.hive docs]) ([climate.hive docs]) ([light.hive docs]) ([sensor.hive docs]) ([switch.hive docs]) - Updated foobot_async package version ([@reefab] - [#13942]) ([sensor.foobot docs]) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) - Upgrade alpha_vantage to 2.0.0 ([@fabaff] - [#13943]) ([sensor.alpha_vantage docs]) - Cleanup on exit ([@dgomes] - [#13918]) ([media_player.mediaroom docs]) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) - Add data entry flow helper ([@balloob] - [#13935]) ([config docs]) - Xiaomi MiIO Device Tracker: Unused variable removed ([@syssi] - [#13948]) ([device_tracker docs]) - Implement play media to set a channel based on (by priority): ([@stephanerosi] - [#13934]) ([media_player.webostv docs]) @@ -148,7 +180,20 @@ Experiencing issues introduced by this release? Please report them in our [issue - Added FB messenger broadcast api to notify.facebook component ([@B1tMaster] - [#12459]) ([notify.facebook docs]) - Added web view for TTS to get url ([@tschmidty69] - [#13882]) ([tts docs]) - Add services for bmw_connected_drive ([@ChristianKuehnel] - [#13497]) ([bmw_connected_drive docs]) ([device_tracker docs]) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) - Bump deCONZ requirement to v36 ([@Kane610] - [#13960]) ([deconz docs]) +- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) +- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) +- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) +- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) +- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) +- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) +- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) +- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) +- Upgrade pyqwikswitch to 0.71 ([@kellerza] - [#13920]) ([qwikswitch docs]) +- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) +- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) +- Revert "Upgrade pyqwikswitch to 0.71 ([@balloob] - [#13920]) ([qwikswitch docs]) - Bump skybellpy version to 0.1.2 ([@MisterWil] - [#13974]) ([skybell docs]) - Fix typo an coding style ([@stephanerosi] - [#13970]) ([device_tracker docs]) - Params of the send command can be a list now ([@syssi] - [#13905]) ([vacuum docs]) @@ -166,7 +211,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Useless code removed ([@syssi] - [#13996]) ([maxcube docs]) - Add Homematic HmIP-SWO-PR weather sensor support ([@pascalhahn] - [#13904]) ([homematic docs]) - Disable ebox requirement ([@balloob] - [#14003]) ([sensor.ebox docs]) (breaking change) -- Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.lmsensor docs]) ([sensor.miflora docs]) (new-platform) +- Upgraded miflora library to version 0.4.0 ([@ChristianKuehnel] - [#14005]) ([sensor.miflora docs]) - Log an error instead of raising an exception ([@syssi] - [#14006]) ([sensor.sht31 docs]) - Tibber available ([@Danielhiversen] - [#13865]) ([sensor.tibber docs]) - Upgrade pylutron-caseta to 0.5.0 to reestablish connections ([@rohankapoorcom] - [#14013]) ([lutron_caseta docs]) @@ -177,6 +222,9 @@ Experiencing issues introduced by this release? Please report them in our [issue - Revert cast platform polling mode ([@OttoWinter] - [#14027]) ([media_player.cast docs]) (beta fix) - Handle HomeKit configuration failure more cleanly ([@mjg59] - [#14041]) ([homekit_controller docs]) (beta fix) - Update device classes for contact sensor HomeKit ([@marthoc] - [#14051]) ([homekit docs]) (beta fix) +- Upgrade broadlink lib ([@Danielhiversen] - [#14074]) ([sensor.broadlink docs]) ([switch.broadlink docs]) (beta fix) +- Fix timezone issue when calculating min/max values in tibber #14009 ([@Danielhiversen] - [#14080]) ([sensor.tibber docs]) (beta fix) +- Updated list of AWS regions for Amazon Polly ([@GotoCode] - [#14097]) ([tts docs]) (beta fix) [#10688]: https://github.com/home-assistant/home-assistant/pull/10688 [#12224]: https://github.com/home-assistant/home-assistant/pull/12224 @@ -292,11 +340,21 @@ Experiencing issues introduced by this release? Please report them in our [issue [#14003]: https://github.com/home-assistant/home-assistant/pull/14003 [#14005]: https://github.com/home-assistant/home-assistant/pull/14005 [#14006]: https://github.com/home-assistant/home-assistant/pull/14006 +[#14008]: https://github.com/home-assistant/home-assistant/pull/14008 [#14010]: https://github.com/home-assistant/home-assistant/pull/14010 [#14013]: https://github.com/home-assistant/home-assistant/pull/14013 +[#14019]: https://github.com/home-assistant/home-assistant/pull/14019 +[#14025]: https://github.com/home-assistant/home-assistant/pull/14025 +[#14027]: https://github.com/home-assistant/home-assistant/pull/14027 +[#14041]: https://github.com/home-assistant/home-assistant/pull/14041 +[#14051]: https://github.com/home-assistant/home-assistant/pull/14051 +[#14074]: https://github.com/home-assistant/home-assistant/pull/14074 +[#14080]: https://github.com/home-assistant/home-assistant/pull/14080 +[#14097]: https://github.com/home-assistant/home-assistant/pull/14097 [@B1tMaster]: https://github.com/B1tMaster [@ChristianKuehnel]: https://github.com/ChristianKuehnel [@Danielhiversen]: https://github.com/Danielhiversen +[@GotoCode]: https://github.com/GotoCode [@Juggels]: https://github.com/Juggels [@KJonline]: https://github.com/KJonline [@Kane610]: https://github.com/Kane610 @@ -344,6 +402,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [@reefab]: https://github.com/reefab [@robmarkcole]: https://github.com/robmarkcole [@rohankapoorcom]: https://github.com/rohankapoorcom +[@schmittx]: https://github.com/schmittx [@shred86]: https://github.com/shred86 [@stephanerosi]: https://github.com/stephanerosi [@swilson]: https://github.com/swilson @@ -362,6 +421,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [binary_sensor.bmw_connected_drive docs]: /components/binary_sensor.bmw_connected_drive/ [binary_sensor.hive docs]: /components/binary_sensor.hive/ [binary_sensor.maxcube docs]: /components/binary_sensor.maxcube/ +[binary_sensor.qwikswitch docs]: /components/binary_sensor.qwikswitch/ [bmw_connected_drive docs]: /components/bmw_connected_drive/ [calendar.google docs]: /components/calendar.google/ [calendar.todoist docs]: /components/calendar.todoist/ @@ -427,7 +487,6 @@ Experiencing issues introduced by this release? Please report them in our [issue [sensor.hive docs]: /components/sensor.hive/ [sensor.hydroquebec docs]: /components/sensor.hydroquebec/ [sensor.linux_battery docs]: /components/sensor.linux_battery/ -[sensor.lmsensor docs]: /components/sensor.lmsensor/ [sensor.miflora docs]: /components/sensor.miflora/ [sensor.mqtt docs]: /components/sensor.mqtt/ [sensor.nest docs]: /components/sensor.nest/ @@ -459,22 +518,3 @@ Experiencing issues introduced by this release? Please report them in our [issue [vacuum.xiaomi_miio docs]: /components/vacuum.xiaomi_miio/ [weather.yweather docs]: /components/weather.yweather/ [zha docs]: /components/zha/ -[#14008]: https://github.com/home-assistant/home-assistant/pull/14008 -[#14019]: https://github.com/home-assistant/home-assistant/pull/14019 -[#14025]: https://github.com/home-assistant/home-assistant/pull/14025 -[#14027]: https://github.com/home-assistant/home-assistant/pull/14027 -[#14041]: https://github.com/home-assistant/home-assistant/pull/14041 -[#14051]: https://github.com/home-assistant/home-assistant/pull/14051 -[@OttoWinter]: https://github.com/OttoWinter -[@balloob]: https://github.com/balloob -[@kellerza]: https://github.com/kellerza -[@marthoc]: https://github.com/marthoc -[@mjg59]: https://github.com/mjg59 -[@schmittx]: https://github.com/schmittx -[binary_sensor.qwikswitch docs]: /components/binary_sensor.qwikswitch/ -[config docs]: /components/config/ -[homekit docs]: /components/homekit/ -[homekit_controller docs]: /components/homekit_controller/ -[media_player.cast docs]: /components/media_player.cast/ -[qwikswitch docs]: /components/qwikswitch/ -[sensor.qwikswitch docs]: /components/sensor.qwikswitch/ diff --git a/source/images/blog/2018-04-0.68/components.png b/source/images/blog/2018-04-0.68/components.png new file mode 100644 index 0000000000000000000000000000000000000000..57d9fc40b38e933eceb6cad9dfc9f3d0d9cd825b GIT binary patch literal 39722 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 azr?c6h$90 Date: Fri, 27 Apr 2018 17:12:10 -0400 Subject: [PATCH 174/241] Update post --- source/_posts/2018-04-27-release-68.markdown | 21 +------------------- 1 file changed, 1 insertion(+), 20 deletions(-) diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown index fc39df1405..4ac9d1f460 100644 --- a/source/_posts/2018-04-27-release-68.markdown +++ b/source/_posts/2018-04-27-release-68.markdown @@ -56,26 +56,6 @@ Experiencing issues introduced by this release? Please report them in our [issue ## {% linkable_title Beta Fixes %} -- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) -- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) -- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) -- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) -- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) -- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) -- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) -- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) -- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) -- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) -- Fix Gogogate2 'available' attribute ([@dlbroadfoot] - [#13728]) (beta fix) -- Fix so it is possible to ignore discovered config entry handlers ([@Kane610] - [#13741]) (beta fix) -- Prevent vesync doing I/O in event loop ([@balloob] - [#13862]) ([switch.vesync docs]) (beta fix) -- Fix #13846 Double underscore in bluetooth address ([@aav7fl] - [#13884]) ([device_tracker docs]) (beta fix) -- Fix race condition for component loaded before listening ([@balloob] - [#13887]) ([config docs]) (beta fix) -- Missing property decorator added ([@syssi] - [#13889]) ([fan.xiaomi_miio docs]) (beta fix) -- Fix call to parent broadlink switch ([@Danielhiversen] - [#13906]) ([switch.broadlink docs]) (beta fix) -- Import operation modes from air humidifier ([@syssi] - [#13908]) ([fan.xiaomi_miio docs]) (beta fix) -- Upgrade somecomfort to 0.5.2 ([@balloob] - [#13940]) ([climate.honeywell docs]) (beta fix) -- Update pyhydroquebec to 2.2.2 ([@titilambert] - [#13946]) ([sensor.hydroquebec docs]) (beta fix) - Qwikswitch binary sensors ([@kellerza] - [#14008]) ([qwikswitch docs]) ([binary_sensor.qwikswitch docs]) ([sensor.qwikswitch docs]) (beta fix) (new-platform) - Order the output of the automation editor ([@balloob] - [#14019]) ([config docs]) (beta fix) - HomeKit Alarm Control Panel Code Exception Fix ([@schmittx] - [#14025]) ([homekit docs]) (beta fix) @@ -85,6 +65,7 @@ Experiencing issues introduced by this release? Please report them in our [issue - Upgrade broadlink lib ([@Danielhiversen] - [#14074]) ([sensor.broadlink docs]) ([switch.broadlink docs]) (beta fix) - Fix timezone issue when calculating min/max values in tibber #14009 ([@Danielhiversen] - [#14080]) ([sensor.tibber docs]) (beta fix) - Updated list of AWS regions for Amazon Polly ([@GotoCode] - [#14097]) ([tts docs]) (beta fix) +- Change Eufy brightness handling ([@mjg59] - [#14111]) (beta fix) ## {% linkable_title All changes %} From ca71ad7249db982a3d7a0d9e3831908d10466bed Mon Sep 17 00:00:00 2001 From: Kerwin Bryant Date: Sat, 28 Apr 2018 17:39:40 +0800 Subject: [PATCH 175/241] update doc for support aqara door lock (#5258) --- source/_components/xiaomi_aqara.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/xiaomi_aqara.markdown b/source/_components/xiaomi_aqara.markdown index 28f40d3f8c..1fd18f55c2 100644 --- a/source/_components/xiaomi_aqara.markdown +++ b/source/_components/xiaomi_aqara.markdown @@ -20,6 +20,7 @@ The `xiaomi_aqara` component allows you to integrate [Xiaomi](http://www.mi.com/ - Xiaomi Aqara Gateway (lumi.gateway.v2, lumi.gateway.v3) - Aqara Air Conditioning Companion (lumi.acpartner.v3) +- Aqara Intelligent Door Lock (lock.aq1) - Temperature and Humidity Sensor (1st and 2nd generation) - Motion Sensor (1st and 2nd generation) - Door and Window Sensor (1st and 2nd generation) From c6729a2fdd8a684faeb6c7f38fb66b6c5512f2c9 Mon Sep 17 00:00:00 2001 From: Matthew Garrett Date: Sat, 28 Apr 2018 04:03:14 -0700 Subject: [PATCH 176/241] Update HomeKit docs (#5255) * Update HomeKit docs * Fix links --- source/_components/homekit_controller.markdown | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/source/_components/homekit_controller.markdown b/source/_components/homekit_controller.markdown index 319f505ef1..b0f64fb228 100644 --- a/source/_components/homekit_controller.markdown +++ b/source/_components/homekit_controller.markdown @@ -13,14 +13,19 @@ ha_release: 0.68 ha_iot_class: "Local Polling" --- -[HomeKit](https://developer.apple.com/homekit/) controller integration for Home Assistant allows you to connect HomeKit accessories to Home Assistant. This component should not be confused with the [HomeKit](homekit) component, which allows you to control Home Assistant devices via HomeKit. +[HomeKit](https://developer.apple.com/homekit/) controller integration for Home Assistant allows you to connect HomeKit accessories to Home Assistant. This component should not be confused with the [HomeKit](/components/homekit/) component, which allows you to control Home Assistant devices via HomeKit. + +

    + You may need additional packages to support the HomeKit Python module: + `$ sudo apt-get install libgmp-dev libmpfr-dev libmpc-dev` +

    There is currently support for the following device types within Home Assistant: - [Light](../light.homekit_controller) - [Switch](../switch.homekit_controller) -The component will be automatically configured if the [`discovery:`](components/discovery/) component is enabled and an enable entry added for HomeKit: +The component will be automatically configured if the [`discovery:`](/components/discovery/) component is enabled and an enable entry added for HomeKit: ```yaml discovery: @@ -28,4 +33,4 @@ discovery: - homekit ``` -For each detected HomeKit accessory, a configuration prompt will appear in the web front end. Use this to provide the HomeKit PIN. +For each detected HomeKit accessory, a configuration prompt will appear in the web front end. Use this to provide the HomeKit PIN. Note that HomeKit accessories can only be paired to one device at once. If your device is currently paired with Siri, you will need to reset it in order to pair it with Home Assistant. Once Home Assistant is configured to work with the device, you can export it back to Siri with the [`HomeKit`](/components/homekit/) component. From 254b6bbf664265168abd11e1226b2486353e90c5 Mon Sep 17 00:00:00 2001 From: ratcash Date: Sat, 28 Apr 2018 16:34:24 +0200 Subject: [PATCH 177/241] Xiaomi Mijia Bluetooth Wireless Temperature and Humidity Sensor documentation (#5229) --- source/_components/sensor.mitemp_bt.markdown | 93 ++++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 source/_components/sensor.mitemp_bt.markdown diff --git a/source/_components/sensor.mitemp_bt.markdown b/source/_components/sensor.mitemp_bt.markdown new file mode 100644 index 0000000000..0cfaa72542 --- /dev/null +++ b/source/_components/sensor.mitemp_bt.markdown @@ -0,0 +1,93 @@ +--- +layout: page +title: "Xiaomi BLE Temperature and Humidity sensor" +description: "Instructions on how to integrate MiTemp BLE temperature and humidity sensor with Home Assistant." +date: 2018-04-22 12:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: xiaomi.png +ha_category: DIY +ha_release: 0.69 +ha_iot_class: "Local Polling" +--- + +The `mitemp_bt` sensor platform allows one to monitor room temperature and humidity. The [Xiaomi Mijia BLE Temperature and Humidity sensor with LCD](https://www.amazon.com/Temperature-Humidity-Xiaomi-Bluetooth-Screen-Remote/dp/B079L6N6PC) is a small Bluetooth Low Energy device that monitors the room temperature and humidity. As only a single BLE device can be polled at the same time, the library employs locking to make sure this is the case. + +# Installation +Depending on the operating system you're running, you have to configure the proper Bluetooth backend on your system: + +- On [Hass.io](/hassio/installation/): Not yet supported. +- On other Linux systems: + - Preferred solution: Install the `bluepy` and `btlewrap` library (via pip). When using a virtual environment, make sure to use install the library in the right one. +    - Fallback solution: Install `btlewrap` library (via pip) and `gatttool` via your package manager. Depending on the distribution, the package name might be: `bluez`, `bluetooth`, `bluez-deprecated` +- Windows and MacOS are currently not supported by the btlewrap library. + +# Configuration +Start a scan to determine the MAC addresses of the sensor: + +```bash +$ sudo hcitool lescan +LE Scan ... +4C:65:A8:D2:31:7F MJ_HT_V1 +[...] +``` + +Or if your distribution is using bluetoothctl: + +```bash +$ bluetoothctl +[bluetooth]# scan on +Discovery started +[CHG] Controller XX:XX:XX:XX:XX:XX Discovering: yes +[NEW] Device 4C:65:A8:D2:31:7F MJ_HT_V1 + +``` + + +Check for `MJ_HT_V1` or similar entries, those are your sensor. + +To use your Mi Temperature and Humidity sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: mitemp_bt + mac: 'xx:xx:xx:xx:xx:xx' + monitored_conditions: + - temperature +``` + +- **mac** (*Required*): The MAC address of your sensor. +- **monitored_conditions** array (*Optional*): The parameters that should be monitored (defaults to monitoring all parameters). + - **temperature**: Temperature in C at the sensor's location. + - **humidity**: Humidity level in % at the sensor's location. + - **battery**: Battery details (in %). +- **name** (*Optional*): The name displayed in the frontend. +- **force_update** (*Optional*): Sends update events even if the value hasn't changed. +- **median** (*Optional*): Sometimes the sensor measurements show spikes. Using this parameter, the poller will report the median of the last 3 (you can also use larger values) measurements. This filters out single spikes. Median: 5 will also filter double spikes. If you never have problems with spikes, `median: 1` will work fine. +- **timeout** (*Optional*): Define the timeout value in seconds when polling (defaults to 10 if not defined) +- **retries** (*Optional*): Define the number of retries when polling (defaults to 2 if not defined) +- **cache_value** (*Optional*): Define cache expiration value in seconds (defaults to 1200 if not defined) +- **adapter** (*Optional*): Define the Bluetooth adapter to use (defaults to hci0). Run `hciconfig` to get a list of available adapters. + +Note that by default the sensor is only polled once every 5 minutes. This means with the `median: 3` setting will take as least 15 minutes before the sensor will report a value after a Home Assistant restart. Even though the hardware is able to provide new values every second, room temperaturs don't change that quickly. +Reducing polling intervals will have a negative effect on the battery life. + +A full configuration example could look like the one below: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: mitemp_bt + mac: 'xx:xx:xx:xx:xx:xx' + name: Kids Room Temp + force_update: false + median: 3 + monitored_conditions: + - temperature + - humidity + - battery +``` + From 292ef8e8157004f4ba1dd9ee461c293502b2a8fe Mon Sep 17 00:00:00 2001 From: Otto Winter Date: Sun, 29 Apr 2018 00:33:55 +0200 Subject: [PATCH 178/241] Light mqtt_json HS color support (#5214) * Light mqtt_json HS color support * Update other MQTT light docs * Updates --- source/_components/light.mqtt.markdown | 1 + source/_components/light.mqtt_json.markdown | 43 ++++++++++++++++--- .../_components/light.mqtt_template.markdown | 1 + 3 files changed, 40 insertions(+), 5 deletions(-) diff --git a/source/_components/light.mqtt.markdown b/source/_components/light.mqtt.markdown index 13e1cd9f86..7678e5c9b0 100644 --- a/source/_components/light.mqtt.markdown +++ b/source/_components/light.mqtt.markdown @@ -194,6 +194,7 @@ payload_not_available: | RGB Color | ✔ | ✔ | ✔ | | Transitions | ✘ | ✔ | ✔ | | XY Color | ✔ | ✔ | ✘ | +| HS Color | ✘ | ✔ | ✘ | | White Value | ✔ | ✔ | ✔ | ## {% linkable_title Examples %} diff --git a/source/_components/light.mqtt_json.markdown b/source/_components/light.mqtt_json.markdown index 9455777285..6e70c8be89 100644 --- a/source/_components/light.mqtt_json.markdown +++ b/source/_components/light.mqtt_json.markdown @@ -23,10 +23,12 @@ This platform supports on/off, brightness, RGB colors, XY colors, color temperat "color_temp": 155, "color": { "r": 255, - "g": 255, - "b": 255, - "x": 0.123, - "y": 0.123 + "g": 180, + "b": 200, + "x": 0.406, + "y": 0.301, + "h": 344.0, + "s": 29.412 }, "effect": "colorloop", "state": "ON", @@ -126,6 +128,11 @@ xy: required: false type: boolean default: false +hs: + description: Flag that defines if the light supports HS colors. + required: false + type: boolean + default: false availability_topic: description: The MQTT topic subscribed to receive availability (online/offline) updates. required: false @@ -147,7 +154,7 @@ payload_not_available:

    - XY and RGB can not be used at the same time. If both are provided, XY overrides RGB. + RGB, XY and HSV can not be used at the same time in `state_topic` messages. Make sure that only one of the color models is in the "color" section of the state MQTT payload.

    ## {% linkable_title Comparison of light MQTT platforms %} @@ -161,6 +168,7 @@ payload_not_available: | RGB Color | ✔ | ✔ | ✔ | | Transitions | ✘ | ✔ | ✔ | | XY Color | ✔ | ✔ | ✘ | +| HS Color | ✘ | ✔ | ✘ | | White Value | ✔ | ✔ | ✔ | ## {% linkable_title Examples %} @@ -215,7 +223,32 @@ Home Assistant will then convert its 8bit value in the message to and from the d ```json { "brightness": 4095, + "state": "ON" +} +``` + +### {% linkable_title HS Color %} + +To use a light with hue+saturation as the color model, set `hs` to `true` in the platform configuration: + +```yaml +light: + - platform: mqtt_json + name: mqtt_json_hs_light + state_topic: "home/light" + command_topic: "home/light/set" + hs: True +``` + +Home Assistant expects the hue values to be in the range 0 to 360 and the saturation values to be scaled from 0 to 100. For example, the following is a blue color shade: + +```json +{ "state": "ON", + "color": { + "h": 24.0, + "s": 100.0 + } } ``` diff --git a/source/_components/light.mqtt_template.markdown b/source/_components/light.mqtt_template.markdown index d623971099..11b4372672 100644 --- a/source/_components/light.mqtt_template.markdown +++ b/source/_components/light.mqtt_template.markdown @@ -132,6 +132,7 @@ payload_not_available: | RGB Color | ✔ | ✔ | ✔ | | Transitions | ✘ | ✔ | ✔ | | XY Color | ✔ | ✔ | ✘ | +| HS Color | ✘ | ✔ | ✘ | | White Value | ✔ | ✔ | ✔ | ## {% linkable_title Examples %} From 08090346672a4fa8055fdc529d817b25438b9f11 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=85skar=20Andersson?= Date: Sun, 29 Apr 2018 09:56:19 +0200 Subject: [PATCH 179/241] Linkerror fixed (#5263) --- source/_components/eufy.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/eufy.markdown b/source/_components/eufy.markdown index 294dd26902..60ec2a470d 100644 --- a/source/_components/eufy.markdown +++ b/source/_components/eufy.markdown @@ -12,7 +12,7 @@ ha_category: Hub ha_release: 0.68 --- -The `eufy` component is the main component to integrate various [eufy](http://https://www.eufylife.com/) devices with Home Assistant. +The `eufy` component is the main component to integrate various [eufy](https://www.eufylife.com/) devices with Home Assistant. Supported devices will be discovered after the `eufy` component is configured: From 490b5069a2d879342390fef9b56709de1e6af7be Mon Sep 17 00:00:00 2001 From: bonterra Date: Sun, 29 Apr 2018 09:59:54 +0200 Subject: [PATCH 180/241] Update docker.markdown (#5266) A more detailed installation description for Docker on Raspberry Pi 3 with Raspbian. --- source/_docs/installation/docker.markdown | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index d8e6ed3ff4..bc7369f415 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -16,7 +16,16 @@ Installation with Docker is straightforward. Adjust the following command so tha ```bash $ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/home-assistant +```​ + +### {% linkable_title Raspberry Pi 3 (Raspbian) %} + +```bash + +$ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/raspberrypi3-homeassistant:0.XX.x ``` +The Docker container for Raspberry Pi 3 does not have a 'latest' tag so the version number must be specified explicitly, i.e. 0.68.0 or whatever version is desired. This goes for both CLI and Docker Compose. + ### {% linkable_title macOS %} From 53a50b60cfca26621521ddc873fbbc8fcc13c123 Mon Sep 17 00:00:00 2001 From: DubhAd Date: Sun, 29 Apr 2018 09:01:23 +0100 Subject: [PATCH 181/241] Added minimum version note to the docs (#5262) Since many will miss it in the blog post --- source/cloud/google_assistant.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/cloud/google_assistant.markdown b/source/cloud/google_assistant.markdown index 1cdced7984..c3334ca891 100644 --- a/source/cloud/google_assistant.markdown +++ b/source/cloud/google_assistant.markdown @@ -9,6 +9,11 @@ sharing: true footer: true --- + +

    +The minimum supported version of Home Assistant is 0.65.6. +

    + The Google Assistant integration allows users to control the entities via the Home Assistant Smart Home skill for Google Assistant. This means that you can say things like "Ok Google, turn on the kitchen light" to control your local Home Assistant. To use this integration, you need to have: From 02ab1b4eb1bd561d9a0282b20d95841ed458905f Mon Sep 17 00:00:00 2001 From: arg0nik <12636037+arg0nik@users.noreply.github.com> Date: Sun, 29 Apr 2018 02:15:09 -0600 Subject: [PATCH 182/241] Update console log instructions (#5267) * Update console log instructions Some firmware versions have changed the id in the DOM from login-password to pcPassword. * Fix syntax --- source/_components/device_tracker.tplink.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.tplink.markdown b/source/_components/device_tracker.tplink.markdown index 80e957a2ae..29b70a143a 100644 --- a/source/_components/device_tracker.tplink.markdown +++ b/source/_components/device_tracker.tplink.markdown @@ -41,7 +41,7 @@ For Archer C9 models running firmware version 150811 or later please use the enc 2. Type in the password you use to login into the password field. 3. Click somewhere else on the page so that the password field is not selected anymore. 4. Open the JavaScript console of your browser (usually by pressing F12 and then clicking on "Console"). -5. Type ```document.getElementById("login-password").value;```. +5. Type `document.getElementById("login-password").value;` or `document.getElementById("pcPassword").value;`, depending on your firmware version. 6. Copy the returned value to your Home Assistant configuration as password. See the [device tracker component page](/components/device_tracker/) for instructions how to configure the people to be tracked. From 5f97e6e4f21fdbfa2515ff869fe118fa25d6714f Mon Sep 17 00:00:00 2001 From: yeah Date: Sun, 29 Apr 2018 10:22:37 +0200 Subject: [PATCH 183/241] Add hint on auto-renewing certs using automations (#5261) * Add hint on auto-renewing certs using automations * Minor changes --- source/_addons/lets_encrypt.markdown | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/source/_addons/lets_encrypt.markdown b/source/_addons/lets_encrypt.markdown index c0cbf10bbe..0ac8d01994 100644 --- a/source/_addons/lets_encrypt.markdown +++ b/source/_addons/lets_encrypt.markdown @@ -2,7 +2,7 @@ layout: page title: "Let's Encrypt" description: "Automatically manage your SSL certificate using Let's Encrypt." -date: 2017-04-30 13:28 +date: 2018-04-18 10:55 sidebar: true comments: false sharing: true @@ -41,4 +41,24 @@ http: If you use another port such as `8123` or an SSL proxy, change the port number. +## {% linkable_title Enabling auto-renewals %} + +Out of the box, the add-on will not automatically renew your certificate. In fact, it only starts, tries to get/renew your certificte, and then stops. It's up to you to manually start it again whenever your certificate comes close to expiry. + +However, you can automate this process using Home Assistant. + +Use this in your `automations.yaml` to attempt certificate renewal each day at midnight: + +```yaml +- id: letsencrypt-renewal + alias: "Let's Encrypt Renewal" + trigger: + - platform: time + at: '00:00:00' + action: + - service: hassio.addon_restart + data: + addon: core_letsencrypt +``` + [DuckDNS add-on]: /addons/duckdns/ From fa028db9d844a304e16b0a6e5042ca62e199b412 Mon Sep 17 00:00:00 2001 From: Robin Date: Sun, 29 Apr 2018 10:11:51 +0100 Subject: [PATCH 184/241] Adds update file_path service to the local_file camera (#5228) * Update camera.local_file.markdown * Add entity_id info to service * Update camera.local_file.markdown * Update camera.local_file.markdown * Fix table --- source/_components/camera.local_file.markdown | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/source/_components/camera.local_file.markdown b/source/_components/camera.local_file.markdown index 8175ee35db..b2b953041d 100644 --- a/source/_components/camera.local_file.markdown +++ b/source/_components/camera.local_file.markdown @@ -1,7 +1,7 @@ --- layout: page title: "Local File" -description: "Instructions on how to use Local File as a Camera within Home Assistant." +description: "Instructions how to use Local File as a Camera within Home Assistant." date: 2016-06-12 17:00 sidebar: true comments: false @@ -13,9 +13,9 @@ ha_iot_class: "Local Polling" ha_release: 0.22 --- -The `local_file` camera platform allows you to integrate any readable image file from disk into Home Assistant as a camera. If the image is updated on the file system the image displayed in Home Assistant will also be updated. +The `local_file` camera platform allows you to integrate an image file from disk into Home Assistant as a camera. If the image is updated on the file system the image displayed in Home Assistant will also be updated. The service `local_file_update_file_path` can be used to update the image using an automation. -This can for example be used with various camera platforms that save a temporary images locally. It can also be used to display a graph that you render periodically and will then be displayed in Home Assistant. +The `local_file` camera can for example be used with various camera platforms that save a temporary images locally. It can also be used to display a graph that you render periodically and will then be displayed in Home Assistant. To enable this camera in your installation, add the following to your `configuration.yaml` file: @@ -31,7 +31,11 @@ Configuration variables: - **file_path** (*Required*): File to serve as the camera. - **name** (*Optional*): Name of the camera -

    -The given `file_path` must be an existing file because the camera platform setup make a readable check on it. -

    +### {% linkable_title Service `camera.local_file_update_file_path` %} +Use this service to change the file displayed by the camera. + +| Service data attribute | Description | +| -----------------------| ----------- | +| `entity_id` | String of the `entity_id` of the camera to update. | +| `file_path` | The full path to the new image file to be displayed. | From b50c2fbbb005cee8452e3d33ec7a32456b55b99f Mon Sep 17 00:00:00 2001 From: DK Date: Sun, 29 Apr 2018 02:20:35 -0700 Subject: [PATCH 185/241] Add some more documentation around hassio CLI (#5215) * Add some more documentation around hassio CLI This is rather basic, I think it needs it's own page * Minor changes --- source/hassio/index.markdown | 42 ++++++++++++++++++++++++++++++++---- 1 file changed, 38 insertions(+), 4 deletions(-) diff --git a/source/hassio/index.markdown b/source/hassio/index.markdown index 16dca59792..a5f4798c8d 100644 --- a/source/hassio/index.markdown +++ b/source/hassio/index.markdown @@ -59,8 +59,9 @@ Hass.io upgrade process from the SSH command line On the SSH command line you can use the `hassio` command to retrieve logs, check the details of connected hardware, and more. -HomeAssistant: -```shell +Home Assistant: + +```bash $ hassio homeassistant logs $ hassio homeassistant restart $ hassio homeassistant stop @@ -70,7 +71,8 @@ $ hassio homeassistant check ``` Host: -```shell + +```bash $ hassio host hardware $ hassio host reboot $ hassio host shutdown @@ -78,9 +80,41 @@ $ hassio host update ``` Supervisor -```shell + +```bash $ hassio supervisor logs $ hassio supervisor info $ hassio supervisor reload $ hassio supervisor update ``` + +You can get a better description of the CLI capabilities by typing `hassio help`: + +```bash +NAME: + hassio - Commandline tool to allow interation with hass.io + +USAGE: + hassio [global options] command [command options] [arguments...] + +VERSION: + 1.2.1 + +AUTHOR: + Home-Assistant + +COMMANDS: + homeassistant, ha info, logs, check, restart, start, stop, update + supervisor, su info, logs, reload, update + host, ho hardware, reboot, shutdown, update + network, ne info, options + snapshots, sn list, info, reload, new, restore, remove + addons, ad list, info, logo, changelog, logs, stats, + reload, start, stop, install, uninstall, update + help, h Shows a list of commands or help for one command + +GLOBAL OPTIONS: + --debug, -d Prints Debug information + --help, -h show help + --version, -v print the version +``` From 09aa7ac3e979604ab69cf459f5d2f834d6ba0815 Mon Sep 17 00:00:00 2001 From: Niklas Wagner Date: Sun, 29 Apr 2018 16:12:14 +0200 Subject: [PATCH 186/241] Tested on 7590 and use english (instead of german links) (#5270) --- source/_components/fritzbox.markdown | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/source/_components/fritzbox.markdown b/source/_components/fritzbox.markdown index 8d601368eb..9b69d05831 100644 --- a/source/_components/fritzbox.markdown +++ b/source/_components/fritzbox.markdown @@ -17,9 +17,10 @@ The [AVM](www.avm.de) Fritzbox component for Home Assistant allows you to integr #### {% linkable_title Tested Devices %} -- [FRITZ!Box 6490 Cable](https://avm.de/produkte/fritzbox/fritzbox-6490-cable/) -- [FRITZ!DECT 200](https://avm.de/produkte/fritzdect/fritzdect-200/) -- [Eurotronic Comet DECT](https://www.eurotronic.org/produkte/comet-dect.html) +- [FRITZ!Box 6490 Cable](https://en.avm.de/products/fritzbox/fritzbox-6490-cable/) +- [FRITZ!Box 7590](https://en.avm.de/products/fritzbox/fritzbox-7590/) +- [FRITZ!DECT 200](https://en.avm.de/products/fritzdect/fritzdect-200/) +- [Eurotronic Comet DECT](https://www.eurotronic.org/en/products/comet-dect.html) ## {% linkable_title Setup %} From ec6f2fca646c00a7719fe344f59ccf42933c1fdc Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sun, 29 Apr 2018 18:35:42 +0200 Subject: [PATCH 187/241] Update for 0.68 --- source/developers/credits.markdown | 258 +++++++++++++++-------------- 1 file changed, 130 insertions(+), 128 deletions(-) diff --git a/source/developers/credits.markdown b/source/developers/credits.markdown index 0fa372b00f..3e44e31340 100644 --- a/source/developers/credits.markdown +++ b/source/developers/credits.markdown @@ -2,7 +2,7 @@ layout: page title: "Credits" description: "Credits for the developers who contributed to Home Assistant." -date: 2018-03-31 09:09:02 +0000 +date: 2018-04-29 16:35:15 +0000 sidebar: true comments: false sharing: true @@ -13,7 +13,7 @@ This page contains a list of people who have contributed in one way or another t ### {% linkable_title Author %} -- [Paulus Schoutsen (@balloob)](https://github.com/balloob "6522 total commits to the home-assistant organization, 3835 commits to home-assistant, 1426 commits to home-assistant.github.io, 750 commits to home-assistant-polymer, 244 commits to home-assistant-js, 122 commits to netdisco, 46 commits to home-assistant-js-websocket, 31 commits to hass-release, 17 commits to LabelBot, 15 commits to home-assistant-assets, 8 commits to example-custom-config, 7 commits to micropython-home-assistant, 5 commits to hassio, 3 commits to hassio-addons, 2 commits to hassio-addons-example, 2 commits to hassio-build, 2 commits to issue-bot, 2 commits to lambda-home-assistant-github, 2 commits to home-assistant-iOS, 1 commit to architecture, 1 commit to home-assistant-notebooks, 1 commit to warrant") +- [Paulus Schoutsen (@balloob)](https://github.com/balloob "6642 total commits to the home-assistant organization, 3877 commits to home-assistant, 1448 commits to home-assistant.github.io, 768 commits to home-assistant-polymer, 244 commits to home-assistant-js, 123 commits to netdisco, 46 commits to home-assistant-js-websocket, 35 commits to developers.home-assistant, 33 commits to hass-release, 17 commits to LabelBot, 15 commits to home-assistant-assets, 8 commits to example-custom-config, 7 commits to micropython-home-assistant, 5 commits to hassio, 3 commits to hassio-addons, 2 commits to hassio-build, 2 commits to lambda-home-assistant-github, 2 commits to home-assistant-iOS, 2 commits to hassio-addons-example, 2 commits to issue-bot, 1 commit to architecture, 1 commit to home-assistant-notebooks, 1 commit to warrant") ### {% linkable_title Contributors %} @@ -21,14 +21,14 @@ This page contains a list of people who have contributed in one way or another t - [7even (@hwikene)](https://github.com/hwikene "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [a-andre (@a-andre)](https://github.com/a-andre "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Aaron Bach (@bachya)](https://github.com/bachya "49 total commits to the home-assistant organization, 32 commits to home-assistant, 17 commits to home-assistant.github.io") +- [Aaron Bach (@bachya)](https://github.com/bachya "53 total commits to the home-assistant organization, 35 commits to home-assistant, 18 commits to home-assistant.github.io") - [Aaron Linville (@linville)](https://github.com/linville "2 total commits to the home-assistant organization, 2 commits to appdaemon") - [Abílio Costa (@abmantis)](https://github.com/abmantis "22 total commits to the home-assistant organization, 13 commits to home-assistant, 5 commits to home-assistant.github.io, 2 commits to home-assistant-polymer, 1 commit to home-assistant-js-websocket, 1 commit to netdisco") - [Adam (@SilvrrGIT)](https://github.com/SilvrrGIT "9 total commits to the home-assistant organization, 9 commits to home-assistant.github.io") - [Adam Baxter (@voltagex)](https://github.com/voltagex "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Adam Cooper (@GenericStudent)](https://github.com/GenericStudent "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io") - [Adam Dullage (@Dullage)](https://github.com/Dullage "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Adam Mills (@armills)](https://github.com/armills "315 total commits to the home-assistant organization, 164 commits to home-assistant, 90 commits to home-assistant-polymer, 57 commits to home-assistant.github.io, 3 commits to home-assistant-js, 1 commit to homebridge-homeassistant") +- [Adam Mills (@armills)](https://github.com/armills "324 total commits to the home-assistant organization, 171 commits to home-assistant, 92 commits to home-assistant-polymer, 57 commits to home-assistant.github.io, 3 commits to home-assistant-js, 1 commit to homebridge-homeassistant") - [Adrian Popa (@mad-ady)](https://github.com/mad-ady "5 total commits to the home-assistant organization, 4 commits to appdaemon, 1 commit to home-assistant-polymer") - [Adrien Ball (@adrienball)](https://github.com/adrienball "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Adrien Brault (@adrienbrault)](https://github.com/adrienbrault "2 total commits to the home-assistant organization, 2 commits to home-assistant") @@ -37,31 +37,30 @@ This page contains a list of people who have contributed in one way or another t - [akloeckner (@akloeckner)](https://github.com/akloeckner "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Alan Bowman (@alanbowman)](https://github.com/alanbowman "4 total commits to the home-assistant organization, 4 commits to home-assistant") - [Alan Fischer (@alanfischer)](https://github.com/alanfischer "20 total commits to the home-assistant organization, 16 commits to home-assistant, 4 commits to home-assistant.github.io") -- [Alan Tse (@alandtse)](https://github.com/alandtse "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant") +- [Alan Tse (@alandtse)](https://github.com/alandtse "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io") - [Alasdair Nicol (@alasdairnicol)](https://github.com/alasdairnicol "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Albatross (@DyingAlbatross)](https://github.com/DyingAlbatross "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [Albert Lee (@trisk)](https://github.com/trisk "16 total commits to the home-assistant organization, 11 commits to home-assistant, 5 commits to home-assistant.github.io") +- [Albert Lee (@trisk)](https://github.com/trisk "18 total commits to the home-assistant organization, 11 commits to home-assistant, 7 commits to home-assistant.github.io") - [Alberto Arias Maestro (@albertoarias)](https://github.com/albertoarias "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Alessandro Mogavero (@alexmogavero)](https://github.com/alexmogavero "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Alex (@asbach)](https://github.com/asbach "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Alex Barcelo (@alexbarcelo)](https://github.com/alexbarcelo "6 total commits to the home-assistant organization, 3 commits to hassio-addons, 3 commits to home-assistant.github.io") - [Alex Harvey (@infamy)](https://github.com/infamy "29 total commits to the home-assistant organization, 14 commits to home-assistant, 11 commits to home-assistant.github.io, 4 commits to hassio-os") - [Alex Mekkering (@AlexMekkering)](https://github.com/AlexMekkering "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Alex MF (@adsmf)](https://github.com/adsmf "1 total commits to the home-assistant organization, 1 commit to hassio-addons") - [Alex Osadchyy (@aosadchyy)](https://github.com/aosadchyy "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Alex Tzonkov (@attzonko)](https://github.com/attzonko "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [Alexander Bachmeier (@asbach)](https://github.com/asbach "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Alexander Kratzer (@hexxter)](https://github.com/hexxter "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Alexandre Perrin (@kAworu)](https://github.com/kAworu "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Alexis Iglauer (@ax42)](https://github.com/ax42 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [Alexis Iglauer (@ax42)](https://github.com/ax42 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Alfie Day (@Azelphur)](https://github.com/Azelphur "12 total commits to the home-assistant organization, 12 commits to home-assistant") - [Aliaksandr (@minchik)](https://github.com/minchik "7 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to appdaemon, 2 commits to home-assistant") -- [Alok Saboo (@arsaboo)](https://github.com/arsaboo "141 total commits to the home-assistant organization, 82 commits to home-assistant.github.io, 53 commits to home-assistant, 4 commits to home-assistant-polymer, 1 commit to pi-gen, 1 commit to hassio-addons") +- [Alok Saboo (@arsaboo)](https://github.com/arsaboo "141 total commits to the home-assistant organization, 82 commits to home-assistant.github.io, 53 commits to home-assistant, 4 commits to home-assistant-polymer, 1 commit to hassio-addons, 1 commit to pi-gen") - [amorsillo (@AndrewMorsillo)](https://github.com/AndrewMorsillo "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Anders Fogh Eriksen (@Fogh)](https://github.com/Fogh "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [Anders Melchiorsen (@amelchio)](https://github.com/amelchio "208 total commits to the home-assistant organization, 165 commits to home-assistant, 41 commits to home-assistant.github.io, 2 commits to home-assistant-polymer") +- [Anders Melchiorsen (@amelchio)](https://github.com/amelchio "213 total commits to the home-assistant organization, 170 commits to home-assistant, 41 commits to home-assistant.github.io, 2 commits to home-assistant-polymer") - [andig (@andig)](https://github.com/andig "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Andrea Campi (@andreacampi)](https://github.com/andreacampi "8 total commits to the home-assistant organization, 6 commits to home-assistant, 2 commits to home-assistant.github.io") -- [Andrea Falcone (@asfalcone)](https://github.com/asfalcone "5 total commits to the home-assistant organization, 5 commits to issue-bot") - [Andreas Björshammar (@abjorshammar)](https://github.com/abjorshammar "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Andreas Jacobsen (@andreasjacobsen93)](https://github.com/andreasjacobsen93 "8 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 2 commits to hassio-addons") - [Andreas Rammhold (@andir)](https://github.com/andir "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") @@ -71,13 +70,13 @@ This page contains a list of people who have contributed in one way or another t - [Andrej Friesen (@ajfriesen)](https://github.com/ajfriesen "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Andrew (@aneisch)](https://github.com/aneisch "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [Andrew (@aoakeson)](https://github.com/aoakeson "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "802 total commits to the home-assistant organization, 667 commits to appdaemon, 88 commits to hadashboard, 25 commits to scenegen, 22 commits to home-assistant.github.io") +- [Andrew Cockburn (@acockburn)](https://github.com/acockburn "815 total commits to the home-assistant organization, 680 commits to appdaemon, 88 commits to hadashboard, 25 commits to scenegen, 22 commits to home-assistant.github.io") - [Andrew Smith (@andrewmichaelsmith)](https://github.com/andrewmichaelsmith "2 total commits to the home-assistant organization, 2 commits to pi-gen") - [Andrew Stock (@watchforstock)](https://github.com/watchforstock "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Andrew Thigpen (@andythigpen)](https://github.com/andythigpen "33 total commits to the home-assistant organization, 32 commits to home-assistant, 1 commit to home-assistant-js") - [Andrew Wedgbury (@sconemad)](https://github.com/sconemad "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [andrew-curtis (@andrew-curtis)](https://github.com/andrew-curtis "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") -- [Andrey (@andrey-git)](https://github.com/andrey-git "294 total commits to the home-assistant organization, 134 commits to home-assistant-polymer, 122 commits to home-assistant, 37 commits to home-assistant.github.io, 1 commit to home-assistant-js-websocket") +- [Andrey (@andrey-git)](https://github.com/andrey-git "295 total commits to the home-assistant organization, 135 commits to home-assistant-polymer, 122 commits to home-assistant, 37 commits to home-assistant.github.io, 1 commit to home-assistant-js-websocket") - [Andrey Kupreychik (@foxel)](https://github.com/foxel "9 total commits to the home-assistant organization, 6 commits to home-assistant, 3 commits to home-assistant.github.io") - [Andrzej (@andriej)](https://github.com/andriej "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Andréas Lundgren (@adevade)](https://github.com/adevade "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") @@ -85,14 +84,14 @@ This page contains a list of people who have contributed in one way or another t - [anotherthomas (@anotherthomas)](https://github.com/anotherthomas "1 total commits to the home-assistant organization, 1 commit to hassio-addons") - [Anthony Arnaud (@aarnaud)](https://github.com/aarnaud "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Anthony Hughes (@tony2nite)](https://github.com/tony2nite "1 total commits to the home-assistant organization, 1 commit to netdisco") -- [Antoine Bertin (@Diaoul)](https://github.com/Diaoul "5 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant, 1 commit to home-assistant-polymer") +- [Antoine Bertin (@Diaoul)](https://github.com/Diaoul "5 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Anton Glukhov (@toxxin)](https://github.com/toxxin "1 total commits to the home-assistant organization, 1 commit to libcoap") - [Anton Lundin (@glance-)](https://github.com/glance- "8 total commits to the home-assistant organization, 7 commits to home-assistant, 1 commit to netdisco") - [Anton Sarukhanov (@antsar)](https://github.com/antsar "6 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Antoni K (@Antoni-K)](https://github.com/Antoni-K "1 total commits to the home-assistant organization, 1 commit to hassbian-scripts") - [apo-mak (@apo-mak)](https://github.com/apo-mak "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [arcsur (@arcsur)](https://github.com/arcsur "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Ardetus (@Ardetus)](https://github.com/Ardetus "4 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 2 commits to home-assistant") +- [Ardetus (@Ardetus)](https://github.com/Ardetus "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io") - [Ardi Mehist (@omgapuppy)](https://github.com/omgapuppy "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Ari Lotter (@arilotter)](https://github.com/arilotter "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [arjenfvellinga (@arjenfvellinga)](https://github.com/arjenfvellinga "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") @@ -120,15 +119,17 @@ This page contains a list of people who have contributed in one way or another t - [Ben (@unixben)](https://github.com/unixben "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Ben Bangert (@bbangert)](https://github.com/bbangert "4 total commits to the home-assistant organization, 4 commits to home-assistant") - [Ben Doerr (@bendoerr)](https://github.com/bendoerr "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [Ben Lebherz (@benleb)](https://github.com/benleb "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Ben Nuttall (@bennuttall)](https://github.com/bennuttall "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Ben Origas (@borigas)](https://github.com/borigas "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Ben Pirt (@bjpirt)](https://github.com/bjpirt "2 total commits to the home-assistant organization, 2 commits to pi-gen") -- [Ben Randall (@veleek)](https://github.com/veleek "3 total commits to the home-assistant organization, 3 commits to home-assistant") +- [Ben Randall (@veleek)](https://github.com/veleek "4 total commits to the home-assistant organization, 4 commits to home-assistant") - [Ben Thomas (@wazoo)](https://github.com/wazoo "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") +- [Benedict Aas (@Shou)](https://github.com/Shou "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Benjamin Parzella (@bparzella)](https://github.com/bparzella "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Benji (@bbbenji)](https://github.com/bbbenji "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Bertbert (@bertbert72)](https://github.com/bertbert72 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [bestlibre (@bestlibre)](https://github.com/bestlibre "16 total commits to the home-assistant organization, 8 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hassio, 1 commit to hassio-build, 1 commit to home-assistant-polymer") +- [bestlibre (@bestlibre)](https://github.com/bestlibre "16 total commits to the home-assistant organization, 8 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hassio-build, 1 commit to home-assistant-polymer, 1 commit to hassio") - [BigMoby (@bigmoby)](https://github.com/bigmoby "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [BioSehnsucht (@BioSehnsucht)](https://github.com/BioSehnsucht "14 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 4 commits to home-assistant, 2 commits to home-assistant-polymer") - [Bjarni Ivarsson (@bjarniivarsson)](https://github.com/bjarniivarsson "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant-polymer") @@ -138,10 +139,11 @@ This page contains a list of people who have contributed in one way or another t - [Bob Anderson (@rwa)](https://github.com/rwa "11 total commits to the home-assistant organization, 7 commits to home-assistant, 4 commits to home-assistant.github.io") - [Bob Igo (@Human)](https://github.com/Human "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Boced66 (@boced66)](https://github.com/boced66 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") +- [bonanitech (@bonanitech)](https://github.com/bonanitech "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [boojew (@boojew)](https://github.com/boojew "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [Boris K (@bokub)](https://github.com/bokub "12 total commits to the home-assistant organization, 6 commits to home-assistant, 6 commits to home-assistant.github.io") - [bottomquark (@bottomquark)](https://github.com/bottomquark "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Boyi C (@fanthos)](https://github.com/fanthos "18 total commits to the home-assistant organization, 11 commits to home-assistant-polymer, 5 commits to home-assistant, 2 commits to home-assistant.github.io") +- [Boyi C (@fanthos)](https://github.com/fanthos "22 total commits to the home-assistant organization, 15 commits to home-assistant-polymer, 5 commits to home-assistant, 2 commits to home-assistant.github.io") - [bpoirriez (@bpoirriez)](https://github.com/bpoirriez "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Brad Dixon (@rbdixon)](https://github.com/rbdixon "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Brad Johnson (@bradsk88)](https://github.com/bradsk88 "2 total commits to the home-assistant organization, 2 commits to home-assistant") @@ -166,23 +168,23 @@ This page contains a list of people who have contributed in one way or another t - [Bruno Binet (@bbinet)](https://github.com/bbinet "1 total commits to the home-assistant organization, 1 commit to hassio-build") - [Bryce Edwards (@hoopty)](https://github.com/hoopty "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io") - [bvansambeek (@bvansambeek)](https://github.com/bvansambeek "1 total commits to the home-assistant organization, 1 commit to hassio-build") -- [c727 (@c727)](https://github.com/c727 "61 total commits to the home-assistant organization, 41 commits to home-assistant-polymer, 13 commits to home-assistant.github.io, 5 commits to home-assistant, 2 commits to hassio") +- [c727 (@c727)](https://github.com/c727 "71 total commits to the home-assistant organization, 50 commits to home-assistant-polymer, 13 commits to home-assistant.github.io, 6 commits to home-assistant, 2 commits to hassio") - [Caius Cioran (@caiuspb)](https://github.com/caiuspb "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Caleb (@finish06)](https://github.com/finish06 "7 total commits to the home-assistant organization, 7 commits to home-assistant") - [Cameron Bulock (@cbulock)](https://github.com/cbulock "5 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to netdisco") - [Cameron Moore (@moorereason)](https://github.com/moorereason "3 total commits to the home-assistant organization, 3 commits to hassio-cli") -- [Carlo Costanzo (@CCOSTAN)](https://github.com/CCOSTAN "96 total commits to the home-assistant organization, 88 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to fabric-home-assistant, 1 commit to hassbian-scripts, 1 commit to homebridge-homeassistant") +- [Carlo Costanzo (@CCOSTAN)](https://github.com/CCOSTAN "98 total commits to the home-assistant organization, 90 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to fabric-home-assistant, 1 commit to homebridge-homeassistant, 1 commit to hassbian-scripts") - [carlosmgr (@carlosmgr)](https://github.com/carlosmgr "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Carter (@BluGeni)](https://github.com/BluGeni "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [cdce8p (@cdce8p)](https://github.com/cdce8p "69 total commits to the home-assistant organization, 43 commits to home-assistant, 22 commits to home-assistant.github.io, 4 commits to home-assistant-polymer") +- [cdce8p (@cdce8p)](https://github.com/cdce8p "89 total commits to the home-assistant organization, 53 commits to home-assistant, 29 commits to home-assistant.github.io, 4 commits to home-assistant-polymer, 3 commits to hass-release") - [Cecron (@Cecron)](https://github.com/Cecron "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [Cedric Van Goethem (@Zepheus)](https://github.com/Zepheus "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Cenk Gündoğan (@cgundogan)](https://github.com/cgundogan "1 total commits to the home-assistant organization, 1 commit to libcoap") - [Cezar Sá Espinola (@cezarsa)](https://github.com/cezarsa "2 total commits to the home-assistant organization, 2 commits to home-assistant") -- [cgtobi (@cgtobi)](https://github.com/cgtobi "26 total commits to the home-assistant organization, 16 commits to home-assistant, 10 commits to home-assistant.github.io") +- [cgtobi (@cgtobi)](https://github.com/cgtobi "28 total commits to the home-assistant organization, 17 commits to home-assistant, 11 commits to home-assistant.github.io") - [chanders (@chanders)](https://github.com/chanders "2 total commits to the home-assistant organization, 2 commits to hadashboard") - [Charles Blonde (@CharlesBlonde)](https://github.com/CharlesBlonde "19 total commits to the home-assistant organization, 12 commits to home-assistant, 7 commits to home-assistant.github.io") -- [Charles Garwood (@cgarwood)](https://github.com/cgarwood "17 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 6 commits to home-assistant") +- [Charles Garwood (@cgarwood)](https://github.com/cgarwood "22 total commits to the home-assistant organization, 12 commits to home-assistant.github.io, 7 commits to home-assistant, 3 commits to home-assistant-polymer") - [Charles Spirakis (@srcLurker)](https://github.com/srcLurker "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io") - [Chayoung You (@yous)](https://github.com/yous "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Check your git settings\! (@invalid-email-address)](https://github.com/invalid-email-address "1 total commits to the home-assistant organization, 1 commit to libcoap") @@ -191,6 +193,7 @@ This page contains a list of people who have contributed in one way or another t - [Chris Aloi (@ctaloi)](https://github.com/ctaloi "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Chris Crowe (@chriscrowe)](https://github.com/chriscrowe "3 total commits to the home-assistant organization, 3 commits to homebridge-homeassistant") - [Chris Huegle (@chuegle)](https://github.com/chuegle "1 total commits to the home-assistant organization, 1 commit to netdisco") +- [Chris Jones (@fezfox)](https://github.com/fezfox "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Chris Monteiro (@cmonteiro128)](https://github.com/cmonteiro128 "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Chris Mulder (@chrisvis)](https://github.com/chrisvis "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Chris Smolen (@smolz)](https://github.com/smolz "10 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 4 commits to appdaemon") @@ -200,21 +203,21 @@ This page contains a list of people who have contributed in one way or another t - [Christian Brædstrup (@LinuxChristian)](https://github.com/LinuxChristian "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Christian Lasarczyk (@ChrisLasar)](https://github.com/ChrisLasar "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Christian Studer (@cstuder)](https://github.com/cstuder "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") -- [ChristianKuehnel (@ChristianKuehnel)](https://github.com/ChristianKuehnel "33 total commits to the home-assistant organization, 20 commits to home-assistant, 13 commits to home-assistant.github.io") +- [ChristianKuehnel (@ChristianKuehnel)](https://github.com/ChristianKuehnel "37 total commits to the home-assistant organization, 22 commits to home-assistant, 15 commits to home-assistant.github.io") - [Christoffer Kylvåg (@christoe)](https://github.com/christoe "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Christoph Wagner (@Christoph-Wagner)](https://github.com/Christoph-Wagner "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Christopher Vella (@chrisvella)](https://github.com/chrisvella "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Christopher Viel (@Chris-V)](https://github.com/Chris-V "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io") -- [ChristopherLMiller (@ChristopherLMiller)](https://github.com/ChristopherLMiller "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [chrysn (@chrysn)](https://github.com/chrysn "65 total commits to the home-assistant organization, 65 commits to libcoap") - [chz^3 (@chzchzchz)](https://github.com/chzchzchz "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Ciquattro (@CiquattroFPV)](https://github.com/CiquattroFPV "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [citruz (@citruz)](https://github.com/citruz "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [clach04 (@clach04)](https://github.com/clach04 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") +- [citruz (@citruz)](https://github.com/citruz "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [clach04 (@clach04)](https://github.com/clach04 "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to hassbian-scripts") - [Claus F\. Strasburger (@cfstras)](https://github.com/cfstras "5 total commits to the home-assistant organization, 5 commits to pi-gen") - [cogneato (@cogneato)](https://github.com/cogneato "15 total commits to the home-assistant organization, 15 commits to home-assistant.github.io") - [Colin Dunn (@colindunn)](https://github.com/colindunn "2 total commits to the home-assistant organization, 2 commits to home-assistant") -- [Colin O'Dell (@colinodell)](https://github.com/colinodell "26 total commits to the home-assistant organization, 15 commits to home-assistant, 11 commits to home-assistant.github.io") +- [Colin Frei (@colinfrei)](https://github.com/colinfrei "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [Colin O'Dell (@colinodell)](https://github.com/colinodell "27 total commits to the home-assistant organization, 16 commits to home-assistant, 11 commits to home-assistant.github.io") - [Colin Teubner (@netopiax)](https://github.com/netopiax "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Conrad Juhl Andersen (@cnrd)](https://github.com/cnrd "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io") - [Constantine Grantcharov (@conz27)](https://github.com/conz27 "1 total commits to the home-assistant organization, 1 commit to libcoap") @@ -225,8 +228,8 @@ This page contains a list of people who have contributed in one way or another t - [Craig J\. Ward (@wardcraigj)](https://github.com/wardcraigj "27 total commits to the home-assistant organization, 20 commits to home-assistant, 7 commits to home-assistant.github.io") - [CTLS (@CTLS)](https://github.com/CTLS "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [CV (@dagobert)](https://github.com/dagobert "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") -- [cxlwill (@cxlwill)](https://github.com/cxlwill "3 total commits to the home-assistant organization, 2 commits to home-assistant-polymer, 1 commit to hassbian-scripts") -- [Dale Higgs (@dale3h)](https://github.com/dale3h "35 total commits to the home-assistant organization, 23 commits to home-assistant.github.io, 10 commits to home-assistant, 1 commit to hassbot, 1 commit to homebridge-homeassistant") +- [cxlwill (@cxlwill)](https://github.com/cxlwill "4 total commits to the home-assistant organization, 2 commits to home-assistant-polymer, 2 commits to hassbian-scripts") +- [Dale Higgs (@dale3h)](https://github.com/dale3h "36 total commits to the home-assistant organization, 24 commits to home-assistant.github.io, 10 commits to home-assistant, 1 commit to hassbot, 1 commit to homebridge-homeassistant") - [Dan (@danieljkemp)](https://github.com/danieljkemp "23 total commits to the home-assistant organization, 16 commits to home-assistant, 7 commits to home-assistant.github.io") - [Dan Chen (@djchen)](https://github.com/djchen "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Dan Cinnamon (@Cinntax)](https://github.com/Cinntax "17 total commits to the home-assistant organization, 14 commits to home-assistant, 3 commits to home-assistant.github.io") @@ -239,15 +242,15 @@ This page contains a list of people who have contributed in one way or another t - [Dani (@danichispa)](https://github.com/danichispa "9 total commits to the home-assistant organization, 9 commits to home-assistant.github.io") - [Daniel (@delneet)](https://github.com/delneet "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Daniel Escoz (@Darkhogg)](https://github.com/Darkhogg "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Daniel Høyer Iversen (@Danielhiversen)](https://github.com/Danielhiversen "294 total commits to the home-assistant organization, 180 commits to home-assistant, 111 commits to home-assistant.github.io, 3 commits to home-assistant-polymer") -- [Daniel Perna (@danielperna84)](https://github.com/danielperna84 "84 total commits to the home-assistant organization, 39 commits to home-assistant, 39 commits to home-assistant.github.io, 6 commits to hassio-addons") +- [Daniel Høyer Iversen (@Danielhiversen)](https://github.com/Danielhiversen "303 total commits to the home-assistant organization, 189 commits to home-assistant, 111 commits to home-assistant.github.io, 3 commits to home-assistant-polymer") +- [Daniel Perna (@danielperna84)](https://github.com/danielperna84 "88 total commits to the home-assistant organization, 42 commits to home-assistant, 39 commits to home-assistant.github.io, 7 commits to hassio-addons") - [Daniel Peukert (@dpeukert)](https://github.com/dpeukert "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Daniel Schaal (@schaal)](https://github.com/schaal "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Daniel Shokouhi (@dshokouhi)](https://github.com/dshokouhi "12 total commits to the home-assistant organization, 12 commits to home-assistant.github.io") - [Daniel Stone (@daniel-stoneuk)](https://github.com/daniel-stoneuk "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Daniel Trnka (@trnila)](https://github.com/trnila "2 total commits to the home-assistant organization, 2 commits to appdaemon") - [Daniel Watkins (@OddBloke)](https://github.com/OddBloke "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Daniel Welch (@danielwelch)](https://github.com/danielwelch "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant") +- [Daniel Welch (@danielwelch)](https://github.com/danielwelch "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant, 1 commit to hassio-addons") - [DanielXYZ2000 (@DanielXYZ2000)](https://github.com/DanielXYZ2000 "3 total commits to the home-assistant organization, 2 commits to home-assistant.github.io, 1 commit to hassio-addons") - [Daniyar Yeralin (@yeralin)](https://github.com/yeralin "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant") - [dasos (@dasos)](https://github.com/dasos "11 total commits to the home-assistant organization, 7 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to netdisco") @@ -258,6 +261,7 @@ This page contains a list of people who have contributed in one way or another t - [DaveSergeant (@dethpickle)](https://github.com/dethpickle "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [David (@fanaticDavid)](https://github.com/fanaticDavid "16 total commits to the home-assistant organization, 12 commits to home-assistant.github.io, 3 commits to home-assistant, 1 commit to home-assistant-polymer") - [David \(Drew\) Jackson (@David-Jackson)](https://github.com/David-Jackson "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [David Broadfoot (@dlbroadfoot)](https://github.com/dlbroadfoot "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [David De Sloovere (@DavidDeSloovere)](https://github.com/DavidDeSloovere "16 total commits to the home-assistant organization, 16 commits to home-assistant.github.io") - [David Fiel (@dfiel)](https://github.com/dfiel "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [David Grant (@davegravy)](https://github.com/davegravy "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant") @@ -271,70 +275,63 @@ This page contains a list of people who have contributed in one way or another t - [Dean Camera (@abcminiuser)](https://github.com/abcminiuser "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io") - [deisi (@deisi)](https://github.com/deisi "10 total commits to the home-assistant organization, 10 commits to home-assistant") - [Delio Castillo (@jangeador)](https://github.com/jangeador "2 total commits to the home-assistant organization, 2 commits to hassio-addons") -- [Demid Lupin (@lupin-de-mid)](https://github.com/lupin-de-mid "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant") +- [Demid Lupin (@lupin-de-mid)](https://github.com/lupin-de-mid "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Denix (@denics)](https://github.com/denics "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Dennis de Greef (@dennisdegreef)](https://github.com/dennisdegreef "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Dennis Karpienski (@TheRealLink)](https://github.com/TheRealLink "24 total commits to the home-assistant organization, 15 commits to home-assistant-polymer, 6 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to netdisco") - [Dennis Sutch (@sutch)](https://github.com/sutch "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Derek (@itchaboy)](https://github.com/itchaboy "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [Derek Brooks (@broox)](https://github.com/broox "39 total commits to the home-assistant organization, 30 commits to home-assistant, 9 commits to home-assistant.github.io") -- [dersger (@dersger)](https://github.com/dersger "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") +- [dersger (@dersger)](https://github.com/dersger "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer") - [devdelay (@devdelay)](https://github.com/devdelay "16 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 5 commits to home-assistant, 4 commits to homebridge-homeassistant") - [Devon Peet (@dpeet)](https://github.com/dpeet "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") -- [Diogo Gomes (@dgomes)](https://github.com/dgomes "41 total commits to the home-assistant organization, 23 commits to home-assistant, 18 commits to home-assistant.github.io") +- [Diogo Gomes (@dgomes)](https://github.com/dgomes "46 total commits to the home-assistant organization, 28 commits to home-assistant, 18 commits to home-assistant.github.io") - [DoloresHA (@DoloresHA)](https://github.com/DoloresHA "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Domantas (@Dohxis)](https://github.com/Dohxis "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") -- [Dougal Matthews (@d0ugal)](https://github.com/d0ugal "5 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io") +- [Dougal Matthews (@d0ugal)](https://github.com/d0ugal "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [dramamoose (@dramamoose)](https://github.com/dramamoose "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io") - [DrewSK (@dzsquared)](https://github.com/dzsquared "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io") -- [DubhAd (@DubhAd)](https://github.com/DubhAd "217 total commits to the home-assistant organization, 217 commits to home-assistant.github.io") +- [DubhAd (@DubhAd)](https://github.com/DubhAd "240 total commits to the home-assistant organization, 240 commits to home-assistant.github.io") - [Duoxilian (@Duoxilian)](https://github.com/Duoxilian "11 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 5 commits to home-assistant") - [ebpetway (@ebpetway)](https://github.com/ebpetway "55 total commits to the home-assistant organization, 55 commits to warrant") -- [Edwin Smulders (@Dutchy-)](https://github.com/Dutchy- "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io") +- [Edwin Smulders (@Dutchy-)](https://github.com/Dutchy- "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Egor Tsinko (@etsinko)](https://github.com/etsinko "12 total commits to the home-assistant organization, 9 commits to home-assistant, 3 commits to home-assistant.github.io") -- [Eitan Mosenkis (@emosenkis)](https://github.com/emosenkis "6 total commits to the home-assistant organization, 3 commits to home-assistant, 2 commits to home-assistant.github.io, 1 commit to netdisco") +- [Eitan Mosenkis (@emosenkis)](https://github.com/emosenkis "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to netdisco") - [eldanb (@eldanb)](https://github.com/eldanb "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant") -- [Eleftherios Chamakiotis (@lexam79)](https://github.com/lexam79 "4 total commits to the home-assistant organization, 2 commits to home-assistant, 2 commits to home-assistant.github.io") -- [Ellis Percival (@flyte)](https://github.com/flyte "31 total commits to the home-assistant organization, 25 commits to home-assistant, 6 commits to home-assistant.github.io") -- [Emil Horpen Hetty (@emilhetty)](https://github.com/emilhetty "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [Eleftherios Chamakiotis (@lexam79)](https://github.com/lexam79 "2 total commits to the home-assistant organization, 2 commits to home-assistant") +- [Ellis Percival (@flyte)](https://github.com/flyte "29 total commits to the home-assistant organization, 25 commits to home-assistant, 4 commits to home-assistant.github.io") - [endor-force (@endor-force)](https://github.com/endor-force "9 total commits to the home-assistant organization, 4 commits to hassio-addons, 4 commits to home-assistant.github.io, 1 commit to hassio-build") - [engrbm87 (@engrbm87)](https://github.com/engrbm87 "3 total commits to the home-assistant organization, 3 commits to appdaemon") - [Eric Hagan (@ehagan)](https://github.com/ehagan "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer") - [Eric Oosting (@eoosting)](https://github.com/eoosting "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Eric Rolf (@xrolfex)](https://github.com/xrolfex "13 total commits to the home-assistant organization, 13 commits to home-assistant") -- [Eric Thompson (@er0ck)](https://github.com/er0ck "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [Erik Eriksson (@molobrakos)](https://github.com/molobrakos "115 total commits to the home-assistant organization, 99 commits to home-assistant, 13 commits to home-assistant.github.io, 3 commits to netdisco") +- [Erik Eriksson (@molobrakos)](https://github.com/molobrakos "116 total commits to the home-assistant organization, 100 commits to home-assistant, 13 commits to home-assistant.github.io, 3 commits to netdisco") - [Erik\-jan Riemers (@riemers)](https://github.com/riemers "14 total commits to the home-assistant organization, 13 commits to home-assistant.github.io, 1 commit to hassbian-scripts") -- [escoand (@escoand)](https://github.com/escoand "4 total commits to the home-assistant organization, 4 commits to home-assistant") -- [Ettienne Gous (@ettiennegous)](https://github.com/ettiennegous "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") +- [escoand (@escoand)](https://github.com/escoand "8 total commits to the home-assistant organization, 6 commits to home-assistant, 2 commits to netdisco") - [ettisan (@ettisan)](https://github.com/ettisan "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Eu (@covrig)](https://github.com/covrig "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Eugenio Panadero (@azogue)](https://github.com/azogue "76 total commits to the home-assistant organization, 45 commits to home-assistant, 25 commits to home-assistant.github.io, 3 commits to homebridge-homeassistant, 3 commits to home-assistant-polymer") - [Ezra Bowden (@bn0)](https://github.com/bn0 "2 total commits to the home-assistant organization, 2 commits to warrant") -- [Fabian Affolter (@fabaff)](https://github.com/fabaff "4590 total commits to the home-assistant organization, 2938 commits to home-assistant.github.io, 1545 commits to home-assistant, 32 commits to home-assistant-assets, 31 commits to home-assistant-notebooks, 11 commits to hassio-build, 11 commits to home-assistant-polymer, 8 commits to netdisco, 5 commits to hassio-addons, 4 commits to hassio, 3 commits to development-docs, 1 commit to example-custom-config, 1 commit to home-assistant-js-websocket") +- [Fabian Affolter (@fabaff)](https://github.com/fabaff "4643 total commits to the home-assistant organization, 2964 commits to home-assistant.github.io, 1567 commits to home-assistant, 32 commits to home-assistant-assets, 31 commits to home-assistant-notebooks, 11 commits to hassio-build, 11 commits to home-assistant-polymer, 8 commits to netdisco, 5 commits to hassio-addons, 4 commits to hassio, 3 commits to development-docs, 3 commits to hassio-os, 2 commits to home-assistant-iOS, 1 commit to example-custom-config, 1 commit to home-assistant-js-websocket") - [Fabian Heredia Montiel (@fabianhjr)](https://github.com/fabianhjr "4 total commits to the home-assistant organization, 4 commits to home-assistant") -- [Fabien Piuzzi (@reefab)](https://github.com/reefab "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") +- [Fabien Piuzzi (@reefab)](https://github.com/reefab "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to home-assistant-polymer") - [Fabrizio Furnari (@fabfurnari)](https://github.com/fabfurnari "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant") - [fakezeta (@fakezeta)](https://github.com/fakezeta "7 total commits to the home-assistant organization, 7 commits to home-assistant") -- [Fares Rihani (@anchepiece)](https://github.com/anchepiece "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [Federico Zivolo (@FezVrasta)](https://github.com/FezVrasta "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Felix (@xifle)](https://github.com/xifle "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Felix Krause (@KrauseFx)](https://github.com/KrauseFx "27 total commits to the home-assistant organization, 27 commits to issue-bot") - [Ferry van Zeelst (@StaticCube)](https://github.com/StaticCube "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant") -- [Filip Bednárik (@drndos)](https://github.com/drndos "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Finbarr Brady (@fbradyirl)](https://github.com/fbradyirl "8 total commits to the home-assistant organization, 8 commits to home-assistant") -- [Florian Holzapfel (@florianholzapfel)](https://github.com/florianholzapfel "11 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 4 commits to home-assistant, 3 commits to netdisco") +- [Florian Holzapfel (@florianholzapfel)](https://github.com/florianholzapfel "11 total commits to the home-assistant organization, 4 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to netdisco") - [Florian Klien (@flowolf)](https://github.com/flowolf "17 total commits to the home-assistant organization, 14 commits to home-assistant.github.io, 3 commits to home-assistant") - [florianj1 (@florianj1)](https://github.com/florianj1 "1 total commits to the home-assistant organization, 1 commit to hassio") -- [florincosta (@florincosta)](https://github.com/florincosta "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant") +- [florincosta (@florincosta)](https://github.com/florincosta "6 total commits to the home-assistant organization, 3 commits to home-assistant, 3 commits to home-assistant.github.io") - [Fonta (@f0nt4)](https://github.com/f0nt4 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Franck Nijhof (@frenck)](https://github.com/frenck "30 total commits to the home-assistant organization, 21 commits to home-assistant.github.io, 5 commits to hassio, 2 commits to home-assistant-polymer, 1 commit to hassio-cli, 1 commit to appdaemon") - [Frank (@syphernl)](https://github.com/syphernl "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Frantz (@rofrantz)](https://github.com/rofrantz "16 total commits to the home-assistant organization, 9 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to netdisco") - [Frederic Hemberger (@fhemberger)](https://github.com/fhemberger "93 total commits to the home-assistant organization, 93 commits to home-assistant.github.io") -- [Frederik Bolding (@FrederikBolding)](https://github.com/FrederikBolding "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Fredrik Fjeld (@fredrikfjeld)](https://github.com/fredrikfjeld "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") -- [Fredrik Lindqvist (@Landrash)](https://github.com/Landrash "207 total commits to the home-assistant organization, 95 commits to hassbian-scripts, 73 commits to home-assistant.github.io, 34 commits to pi-gen, 4 commits to home-assistant, 1 commit to home-assistant-polymer") +- [Frederik Bolding (@FrederikBolding)](https://github.com/FrederikBolding "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [Fredrik Lindqvist (@Landrash)](https://github.com/Landrash "212 total commits to the home-assistant organization, 100 commits to hassbian-scripts, 73 commits to home-assistant.github.io, 34 commits to pi-gen, 4 commits to home-assistant, 1 commit to home-assistant-polymer") - [freol35241 (@freol35241)](https://github.com/freol35241 "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [fuga2136 (@fuga2136)](https://github.com/fuga2136 "13 total commits to the home-assistant organization, 13 commits to home-assistant.github.io") - [Gabor SZOLLOSI (@szogi)](https://github.com/szogi "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to appdaemon") @@ -344,10 +341,11 @@ This page contains a list of people who have contributed in one way or another t - [Georgi Kirichkov (@kirichkov)](https://github.com/kirichkov "17 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 5 commits to home-assistant, 1 commit to appdaemon") - [Georgi Yanev (@jumpalottahigh)](https://github.com/jumpalottahigh "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant-polymer") - [Georgii Staroselskii (@staroselskii)](https://github.com/staroselskii "1 total commits to the home-assistant organization, 1 commit to pi-gen") -- [Gerard (@gerard33)](https://github.com/gerard33 "7 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 3 commits to home-assistant") +- [Gerard (@gerard33)](https://github.com/gerard33 "9 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 4 commits to home-assistant") - [Gergely Imreh (@imrehg)](https://github.com/imrehg "16 total commits to the home-assistant organization, 11 commits to home-assistant, 5 commits to home-assistant.github.io") - [Gianluca Barbaro (@MrMep)](https://github.com/MrMep "24 total commits to the home-assistant organization, 16 commits to home-assistant, 8 commits to home-assistant.github.io") - [Giel Janssens (@gieljnssns)](https://github.com/gieljnssns "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [GitBook Bot (@gitbook-bot)](https://github.com/gitbook-bot "1 total commits to the home-assistant organization, 1 commit to developers.home-assistant") - [githubbuh (@githubbuh)](https://github.com/githubbuh "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [gitmopp (@gitmopp)](https://github.com/gitmopp "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Giuseppe (@glpatcern)](https://github.com/glpatcern "2 total commits to the home-assistant organization, 2 commits to home-assistant") @@ -366,16 +364,15 @@ This page contains a list of people who have contributed in one way or another t - [gwendalg (@gwendalg)](https://github.com/gwendalg "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [happyleavesaoc (@happyleavesaoc)](https://github.com/happyleavesaoc "114 total commits to the home-assistant organization, 90 commits to home-assistant, 23 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Harald Nagel (@haraldnagel)](https://github.com/haraldnagel "6 total commits to the home-assistant organization, 6 commits to home-assistant") -- [Hari Menon (@floydpink)](https://github.com/floydpink "2 total commits to the home-assistant organization, 2 commits to home-assistant.github.io") - [Harris Borawski (@hborawski)](https://github.com/hborawski "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [hawk259 (@hawk259)](https://github.com/hawk259 "13 total commits to the home-assistant organization, 7 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Heath Paddock (@heathbar)](https://github.com/heathbar "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Heiko Rothe (@mKeRix)](https://github.com/mKeRix "20 total commits to the home-assistant organization, 15 commits to home-assistant, 5 commits to home-assistant.github.io") -- [Heiko Thiery (@hthiery)](https://github.com/hthiery "3 total commits to the home-assistant organization, 3 commits to home-assistant") +- [Heiko Thiery (@hthiery)](https://github.com/hthiery "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io") - [Hellowlol (@Hellowlol)](https://github.com/Hellowlol "4 total commits to the home-assistant organization, 3 commits to netdisco, 1 commit to appdaemon") - [Helmut Januschka (@hjanuschka)](https://github.com/hjanuschka "3 total commits to the home-assistant organization, 3 commits to issue-bot") - [Henning Dickten (@hensing)](https://github.com/hensing "2 total commits to the home-assistant organization, 2 commits to home-assistant") -- [Henrik Nicolaisen (@hmn)](https://github.com/hmn "6 total commits to the home-assistant organization, 6 commits to home-assistant") +- [Henrik Nicolaisen (@hmn)](https://github.com/hmn "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Hernán Rossetto (@hmronline)](https://github.com/hmronline "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [heytcass (@heytcass)](https://github.com/heytcass "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [Hillary Fraley (@hillaryfraley)](https://github.com/hillaryfraley "12 total commits to the home-assistant organization, 12 commits to home-assistant.github.io") @@ -386,7 +383,7 @@ This page contains a list of people who have contributed in one way or another t - [Hydreliox (@HydrelioxGitHub)](https://github.com/HydrelioxGitHub "46 total commits to the home-assistant organization, 34 commits to home-assistant, 12 commits to home-assistant.github.io") - [Ian Copp (@icopp)](https://github.com/icopp "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [ianj001 (@ianj001)](https://github.com/ianj001 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") -- [icovada (@icovada)](https://github.com/icovada "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 3 commits to home-assistant") +- [icovada (@icovada)](https://github.com/icovada "6 total commits to the home-assistant organization, 3 commits to home-assistant, 3 commits to home-assistant.github.io") - [Igor Bernstein (@igorbernstein2)](https://github.com/igorbernstein2 "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Igor Shults (@ishults)](https://github.com/ishults "12 total commits to the home-assistant organization, 6 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Ioan Loosley (@ioangogo)](https://github.com/ioangogo "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io") @@ -436,7 +433,7 @@ This page contains a list of people who have contributed in one way or another t - [jeremysv (@jeremysv)](https://github.com/jeremysv "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Jeroen ter Heerdt (@jeroenterheerdt)](https://github.com/jeroenterheerdt "36 total commits to the home-assistant organization, 20 commits to home-assistant, 16 commits to home-assistant.github.io") - [Jerold Albertson (@jeroldalbertson-wf)](https://github.com/jeroldalbertson-wf "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") -- [Jerry Workman (@JerryWorkman)](https://github.com/JerryWorkman "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") +- [Jerry Workman (@JerryWorkman)](https://github.com/JerryWorkman "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io") - [Jesse Hills (@jesserockz)](https://github.com/jesserockz "9 total commits to the home-assistant organization, 9 commits to home-assistant") - [Jesse Newland (@jnewland)](https://github.com/jnewland "14 total commits to the home-assistant organization, 11 commits to home-assistant, 3 commits to hubot-home-assistant") - [JesseWebDotCom (@JesseWebDotCom)](https://github.com/JesseWebDotCom "16 total commits to the home-assistant organization, 8 commits to home-assistant, 8 commits to home-assistant.github.io") @@ -444,7 +441,7 @@ This page contains a list of people who have contributed in one way or another t - [jiafengwang (@jiafengwang)](https://github.com/jiafengwang "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [jimbob1001 (@jimbob1001)](https://github.com/jimbob1001 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Joakim Nohlgård (@gebart)](https://github.com/gebart "2 total commits to the home-assistant organization, 2 commits to libcoap") -- [Joakim Sørensen (@ludeeus)](https://github.com/ludeeus "103 total commits to the home-assistant organization, 85 commits to hassbian-scripts, 18 commits to home-assistant.github.io") +- [Joakim Sørensen (@ludeeus)](https://github.com/ludeeus "107 total commits to the home-assistant organization, 89 commits to hassbian-scripts, 18 commits to home-assistant.github.io") - [Job (@jmvermeulen)](https://github.com/jmvermeulen "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [jodur (@jodur)](https://github.com/jodur "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Joe Lu (@snjoetw)](https://github.com/snjoetw "24 total commits to the home-assistant organization, 18 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to appdaemon") @@ -454,22 +451,23 @@ This page contains a list of people who have contributed in one way or another t - [Johan Bloemberg (@aequitas)](https://github.com/aequitas "43 total commits to the home-assistant organization, 35 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to netdisco") - [Johan Haals (@jhaals)](https://github.com/jhaals "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [Johan van der Kuijl (@Rubyan)](https://github.com/Rubyan "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to appdaemon") -- [Johann Kellerman (@kellerza)](https://github.com/kellerza "169 total commits to the home-assistant organization, 139 commits to home-assistant, 30 commits to home-assistant.github.io") +- [Johann Kellerman (@kellerza)](https://github.com/kellerza "177 total commits to the home-assistant organization, 145 commits to home-assistant, 32 commits to home-assistant.github.io") - [Johannes K\. (@roadrash2108)](https://github.com/roadrash2108 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [John (@J-C-B)](https://github.com/J-C-B "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [John Allen (@jra3)](https://github.com/jra3 "2 total commits to the home-assistant organization, 2 commits to home-assistant") -- [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "202 total commits to the home-assistant organization, 150 commits to home-assistant, 37 commits to home-assistant.github.io, 15 commits to home-assistant-polymer") +- [John Arild Berentsen (@turbokongen)](https://github.com/turbokongen "204 total commits to the home-assistant organization, 151 commits to home-assistant, 37 commits to home-assistant.github.io, 16 commits to home-assistant-polymer") - [John Lindley (@jwl17330536)](https://github.com/jwl17330536 "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [John McLaughlin (@loghound)](https://github.com/loghound "2 total commits to the home-assistant organization, 2 commits to home-assistant") -- [John Mihalic (@mezz64)](https://github.com/mezz64 "49 total commits to the home-assistant organization, 35 commits to home-assistant, 12 commits to home-assistant.github.io, 1 commit to hadashboard, 1 commit to home-assistant-polymer") +- [John Mihalic (@mezz64)](https://github.com/mezz64 "50 total commits to the home-assistant organization, 36 commits to home-assistant, 12 commits to home-assistant.github.io, 1 commit to hadashboard, 1 commit to home-assistant-polymer") - [Johnny Chadda (@joch)](https://github.com/joch "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Jon (@JonMurphy)](https://github.com/JonMurphy "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Jon Caruana (@joncar)](https://github.com/joncar "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Jon Griffith (@arretx)](https://github.com/arretx "12 total commits to the home-assistant organization, 11 commits to home-assistant.github.io, 1 commit to appdaemon") -- [Jon Maddox (@maddox)](https://github.com/maddox "106 total commits to the home-assistant organization, 81 commits to home-assistant, 16 commits to homebridge-homeassistant, 9 commits to home-assistant.github.io") +- [Jon Maddox (@maddox)](https://github.com/maddox "107 total commits to the home-assistant organization, 82 commits to home-assistant, 16 commits to homebridge-homeassistant, 9 commits to home-assistant.github.io") - [Jonas Pedersen (@JonasPed)](https://github.com/JonasPed "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [Jonatan Castro (@jcastro)](https://github.com/jcastro "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [Jonathan Baginski (@patchedsoul)](https://github.com/patchedsoul "115 total commits to the home-assistant organization, 87 commits to fabric-home-assistant, 28 commits to home-assistant.github.io") +- [Jonathan Weinberg (@jonathanweinberg)](https://github.com/jonathanweinberg "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [joopert (@joopert)](https://github.com/joopert "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Jordi (@hokus15)](https://github.com/hokus15 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Jordy (@jbarrancos)](https://github.com/jbarrancos "40 total commits to the home-assistant organization, 40 commits to home-assistant") @@ -477,12 +475,12 @@ This page contains a list of people who have contributed in one way or another t - [Joseph Carter (@iKarith)](https://github.com/iKarith "9 total commits to the home-assistant organization, 9 commits to pi-gen") - [Joseph Piron (@eagleamon)](https://github.com/eagleamon "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Josh (@karlw00t)](https://github.com/karlw00t "2 total commits to the home-assistant organization, 2 commits to home-assistant") -- [Josh Anderson (@andersonshatch)](https://github.com/andersonshatch "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to homebridge-homeassistant") +- [Josh Anderson (@andersonshatch)](https://github.com/andersonshatch "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to homebridge-homeassistant") - [Josh Nichols (@technicalpickles)](https://github.com/technicalpickles "28 total commits to the home-assistant organization, 15 commits to home-assistant, 13 commits to home-assistant.github.io") - [Josh Wright (@JshWright)](https://github.com/JshWright "28 total commits to the home-assistant organization, 20 commits to home-assistant, 8 commits to home-assistant.github.io") - [jpcomtois (@jpcomtois)](https://github.com/jpcomtois "1 total commits to the home-assistant organization, 1 commit to libcoap") - [JudgeDredd (@JudgeDreddKLC)](https://github.com/JudgeDreddKLC "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io") -- [Juggels (@Juggels)](https://github.com/Juggels "9 total commits to the home-assistant organization, 6 commits to home-assistant, 3 commits to home-assistant.github.io") +- [Juggels (@Juggels)](https://github.com/Juggels "11 total commits to the home-assistant organization, 7 commits to home-assistant, 4 commits to home-assistant.github.io") - [Julian Kaffke (@jaykay)](https://github.com/jaykay "1 total commits to the home-assistant organization, 1 commit to hassio-addons") - [Julian Kahnert (@JulianKahnert)](https://github.com/JulianKahnert "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant") - [Julius Mittenzwei (@Julius2342)](https://github.com/Julius2342 "31 total commits to the home-assistant organization, 24 commits to home-assistant, 7 commits to home-assistant.github.io") @@ -491,9 +489,8 @@ This page contains a list of people who have contributed in one way or another t - [Justin Hayes (@GussyH)](https://github.com/GussyH "8 total commits to the home-assistant organization, 7 commits to hadashboard, 1 commit to appdaemon") - [Justin Weberg (@justweb1)](https://github.com/justweb1 "26 total commits to the home-assistant organization, 13 commits to home-assistant-polymer, 7 commits to hassbot, 4 commits to home-assistant, 1 commit to home-assistant-js, 1 commit to hassio") - [Justyn Shull (@justyns)](https://github.com/justyns "5 total commits to the home-assistant organization, 5 commits to home-assistant") -- [Kane610 (@Kane610)](https://github.com/Kane610 "34 total commits to the home-assistant organization, 18 commits to home-assistant, 14 commits to home-assistant.github.io, 1 commit to netdisco, 1 commit to home-assistant-polymer") - [Karen Goode (@kfgoode)](https://github.com/kfgoode "4 total commits to the home-assistant organization, 4 commits to home-assistant") -- [karlkar (@karlkar)](https://github.com/karlkar "14 total commits to the home-assistant organization, 9 commits to home-assistant, 5 commits to home-assistant.github.io") +- [karlkar (@karlkar)](https://github.com/karlkar "15 total commits to the home-assistant organization, 10 commits to home-assistant, 5 commits to home-assistant.github.io") - [Keaton Taylor (@keatontaylor)](https://github.com/keatontaylor "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io") - [Keith Lamprecht (@Nixon506E)](https://github.com/Nixon506E "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Ken Bannister (@kb2ma)](https://github.com/kb2ma "1 total commits to the home-assistant organization, 1 commit to libcoap") @@ -504,15 +501,18 @@ This page contains a list of people who have contributed in one way or another t - [Kevin Fronczak (@fronzbot)](https://github.com/fronzbot "19 total commits to the home-assistant organization, 11 commits to home-assistant, 8 commits to home-assistant.github.io") - [Kevin Gisi (@gisikw)](https://github.com/gisikw "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [Kevin Gottsman (@gottsman)](https://github.com/gottsman "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io") +- [Kevin Raddatz (@chronm)](https://github.com/chronm "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Kevin Siml (@appzer)](https://github.com/appzer "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Keyasha Brothern (@KMBrothern)](https://github.com/KMBrothern "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [kfcook (@kfcook)](https://github.com/kfcook "3 total commits to the home-assistant organization, 3 commits to home-assistant") +- [Khole (@KJonline)](https://github.com/KJonline "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [kireyeu (@kireyeu)](https://github.com/kireyeu "4 total commits to the home-assistant organization, 4 commits to home-assistant-notebooks") - [Klaas Hoekema (@KlaasH)](https://github.com/KlaasH "12 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 5 commits to home-assistant, 2 commits to home-assistant-polymer") - [Klaus (@k-laus)](https://github.com/k-laus "1 total commits to the home-assistant organization, 1 commit to appdaemon") +- [koolsb (@koolsb)](https://github.com/koolsb "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Kory Prince (@korylprince)](https://github.com/korylprince "4 total commits to the home-assistant organization, 4 commits to home-assistant-polymer") - [Krasimir Chariyski (@Chariyski)](https://github.com/Chariyski "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") -- [Krasimir Zhelev (@zhelev)](https://github.com/zhelev "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to netdisco") +- [Krasimir Zhelev (@zhelev)](https://github.com/zhelev "1 total commits to the home-assistant organization, 1 commit to netdisco") - [kroimon (@kroimon)](https://github.com/kroimon "1 total commits to the home-assistant organization, 1 commit to netdisco") - [Kyle Hendricks (@kylehendricks)](https://github.com/kylehendricks "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [lamiskin (@lamiskin)](https://github.com/lamiskin "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") @@ -527,7 +527,7 @@ This page contains a list of people who have contributed in one way or another t - [linuxlurak (@linuxlurak)](https://github.com/linuxlurak "5 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to hadashboard") - [linvinus (@linvinus)](https://github.com/linvinus "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [lrmate (@lrmate)](https://github.com/lrmate "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Luar Roji (@cyberplant)](https://github.com/cyberplant "6 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 2 commits to home-assistant") +- [Luar Roji (@cyberplant)](https://github.com/cyberplant "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Luc Touraille (@stilllman)](https://github.com/stilllman "1 total commits to the home-assistant organization, 1 commit to netdisco") - [Luca Angemi (@luca-angemi)](https://github.com/luca-angemi "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [LucaSoldi (@LucaSoldi)](https://github.com/LucaSoldi "6 total commits to the home-assistant organization, 6 commits to home-assistant") @@ -541,66 +541,64 @@ This page contains a list of people who have contributed in one way or another t - [Luke Armstrong (@lukearmstrong)](https://github.com/lukearmstrong "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [LvivEchoes (@LvivEchoes)](https://github.com/LvivEchoes "8 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Maarten Groeneweg (@lazytesting)](https://github.com/lazytesting "1 total commits to the home-assistant organization, 1 commit to hassio-addons") -- [Maciej Bieniek (@bieniu)](https://github.com/bieniu "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer") +- [Maciej Bieniek (@bieniu)](https://github.com/bieniu "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to home-assistant-polymer") - [Maciej Sokołowski (@matemaciek)](https://github.com/matemaciek "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to hassio-build") - [Maciej Wasilak (@mwasilak)](https://github.com/mwasilak "1 total commits to the home-assistant organization, 1 commit to libcoap") - [Magnus Ihse Bursie (@magicus)](https://github.com/magicus "16 total commits to the home-assistant organization, 9 commits to home-assistant, 4 commits to netdisco, 3 commits to home-assistant.github.io") - [Magnus Lyckå (@magnus-lycka)](https://github.com/magnus-lycka "1 total commits to the home-assistant organization, 1 commit to netdisco") - [MagnusKnutas (@MagnusKnutas)](https://github.com/MagnusKnutas "29 total commits to the home-assistant organization, 29 commits to home-assistant") - [Mahasri Kalavala (@skalavala)](https://github.com/skalavala "28 total commits to the home-assistant organization, 28 commits to home-assistant.github.io") -- [Maikel Wever (@maikelwever)](https://github.com/maikelwever "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [makemeasandwich (@makemeasandwich)](https://github.com/makemeasandwich "12 total commits to the home-assistant organization, 12 commits to home-assistant") - [Marc Egli (@frog32)](https://github.com/frog32 "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io") - [Marc Forth (@mf-social)](https://github.com/mf-social "25 total commits to the home-assistant organization, 24 commits to home-assistant.github.io, 1 commit to fabric-home-assistant") -- [Marc Khouri (@ubnt-marc-khouri)](https://github.com/ubnt-marc-khouri "2 total commits to the home-assistant organization, 2 commits to home-assistant-polymer") +- [Marc Khouri (@ubnt-marc-khouri)](https://github.com/ubnt-marc-khouri "3 total commits to the home-assistant organization, 2 commits to home-assistant-polymer, 1 commit to hassio-build") - [Marc Pabst (@mxtra)](https://github.com/mxtra "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") -- [Marc Plano\-Lesay (@Kernald)](https://github.com/Kernald "12 total commits to the home-assistant organization, 10 commits to home-assistant.github.io, 2 commits to home-assistant") +- [Marc Plano\-Lesay (@Kernald)](https://github.com/Kernald "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io") - [Marcel030nl (@Marcel030nl)](https://github.com/Marcel030nl "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") -- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "140 total commits to the home-assistant organization, 77 commits to home-assistant, 61 commits to home-assistant.github.io, 1 commit to home-assistant-assets, 1 commit to home-assistant-polymer") +- [Marcelo Moreira de Mello (@tchellomello)](https://github.com/tchellomello "141 total commits to the home-assistant organization, 77 commits to home-assistant, 62 commits to home-assistant.github.io, 1 commit to home-assistant-assets, 1 commit to home-assistant-polymer") +- [Marcin Domański (@kabturek)](https://github.com/kabturek "2 total commits to the home-assistant organization, 2 commits to appdaemon") - [Marcin Jaworski (@yawor)](https://github.com/yawor "12 total commits to the home-assistant organization, 12 commits to appdaemon") - [Marco (@marconett)](https://github.com/marconett "3 total commits to the home-assistant organization, 3 commits to appdaemon") -- [Marcus Schmidt (@mar-schmidt)](https://github.com/mar-schmidt "2 total commits to the home-assistant organization, 2 commits to home-assistant") +- [Marco Orovecchia (@Oro)](https://github.com/Oro "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Marijn Giesen (@marijngiesen)](https://github.com/marijngiesen "5 total commits to the home-assistant organization, 5 commits to hadashboard") - [Marius (@ciotlosm)](https://github.com/ciotlosm "13 total commits to the home-assistant organization, 8 commits to home-assistant-polymer, 5 commits to home-assistant") -- [Mark Coombes (@marthoc)](https://github.com/marthoc "3 total commits to the home-assistant organization, 3 commits to home-assistant") +- [Mark Coombes (@marthoc)](https://github.com/marthoc "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Mark Grosen (@mgsb)](https://github.com/mgsb "1 total commits to the home-assistant organization, 1 commit to netdisco") - [Mark Huson (@mehuman)](https://github.com/mehuman "11 total commits to the home-assistant organization, 11 commits to home-assistant.github.io") +- [Mark Perdue (@markperdue)](https://github.com/markperdue "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [mark9white (@mark9white)](https://github.com/mark9white "1 total commits to the home-assistant organization, 1 commit to hassio") - [markferry (@markferry)](https://github.com/markferry "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Markus (@iMarkus)](https://github.com/iMarkus "3 total commits to the home-assistant organization, 2 commits to home-assistant, 1 commit to hassio") +- [Markus (@iMarkus)](https://github.com/iMarkus "1 total commits to the home-assistant organization, 1 commit to hassio") - [Markus Becker (@markushx)](https://github.com/markushx "6 total commits to the home-assistant organization, 6 commits to libcoap") - [Markus Peter (@bimbar)](https://github.com/bimbar "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Markus Stenberg (@fingon)](https://github.com/fingon "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Martin Berg (@mbrrg)](https://github.com/mbrrg "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io") -- [Martin Donlon (@wickerwaka)](https://github.com/wickerwaka "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Martin Eberhardt (@DarkFox)](https://github.com/DarkFox "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") -- [Martin Hjelmare (@MartinHjelmare)](https://github.com/MartinHjelmare "150 total commits to the home-assistant organization, 121 commits to home-assistant, 29 commits to home-assistant.github.io") +- [Martin Hjelmare (@MartinHjelmare)](https://github.com/MartinHjelmare "154 total commits to the home-assistant organization, 125 commits to home-assistant, 29 commits to home-assistant.github.io") - [Martin Rowan (@shortbloke)](https://github.com/shortbloke "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Martin Vacula (@MatoKafkac)](https://github.com/MatoKafkac "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Martin Weinelt (@mweinelt)](https://github.com/mweinelt "17 total commits to the home-assistant organization, 9 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Martokk (@martokk)](https://github.com/martokk "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Mateusz Drab (@mateuszdrab)](https://github.com/mateuszdrab "2 total commits to the home-assistant organization, 2 commits to home-assistant") - [Mathew Peterson (@mathewpeterson)](https://github.com/mathewpeterson "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant") -- [Matt N\. (@mnoorenberghe)](https://github.com/mnoorenberghe "53 total commits to the home-assistant organization, 25 commits to home-assistant-iOS, 17 commits to home-assistant.github.io, 9 commits to home-assistant, 1 commit to homebridge-homeassistant, 1 commit to home-assistant-polymer") +- [Matt N\. (@mnoorenberghe)](https://github.com/mnoorenberghe "54 total commits to the home-assistant organization, 25 commits to home-assistant-iOS, 17 commits to home-assistant.github.io, 9 commits to home-assistant, 2 commits to home-assistant-polymer, 1 commit to homebridge-homeassistant") - [Matt Rogers (@rogersmj)](https://github.com/rogersmj "20 total commits to the home-assistant organization, 20 commits to hadashboard") -- [Matt Schmitt (@schmittx)](https://github.com/schmittx "66 total commits to the home-assistant organization, 52 commits to homebridge-homeassistant, 7 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to home-assistant-polymer") +- [Matt Schmitt (@schmittx)](https://github.com/schmittx "68 total commits to the home-assistant organization, 52 commits to homebridge-homeassistant, 9 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to home-assistant-polymer") - [Matt White (@mw-white)](https://github.com/mw-white "10 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 5 commits to home-assistant") - [Matteo Lampugnani (@t30)](https://github.com/t30 "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [Matthew Bowen (@mgbowen)](https://github.com/mgbowen "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Matthew Garrett (@mjg59)](https://github.com/mjg59 "10 total commits to the home-assistant organization, 7 commits to home-assistant, 3 commits to home-assistant.github.io") -- [Matthew Schick (@mattsch)](https://github.com/mattsch "2 total commits to the home-assistant organization, 2 commits to home-assistant") +- [Matthew Garrett (@mjg59)](https://github.com/mjg59 "20 total commits to the home-assistant organization, 13 commits to home-assistant, 7 commits to home-assistant.github.io") +- [Matthew Rollings (@stealthcopter)](https://github.com/stealthcopter "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Matthew Treinish (@mtreinish)](https://github.com/mtreinish "20 total commits to the home-assistant organization, 13 commits to home-assistant, 7 commits to home-assistant.github.io") - [Matthias Dötsch (@brainexe)](https://github.com/brainexe "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") -- [Mattias Welponer (@mxworm)](https://github.com/mxworm "2 total commits to the home-assistant organization, 2 commits to home-assistant") +- [Matthias Urlichs (@smurfix)](https://github.com/smurfix "3 total commits to the home-assistant organization, 3 commits to appdaemon") +- [Mattias Welponer (@mxworm)](https://github.com/mxworm "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [mattie47 (@mattie47)](https://github.com/mattie47 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [mauriciobonani (@mauriciobonani)](https://github.com/mauriciobonani "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [Max Prokhorov (@mcspr)](https://github.com/mcspr "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Max Rumpf (@Maxr1998)](https://github.com/Maxr1998 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [maxclaey (@maxclaey)](https://github.com/maxclaey "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io") - [maxlaverse (@maxlaverse)](https://github.com/maxlaverse "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [mboeru (@mboeru)](https://github.com/mboeru "1 total commits to the home-assistant organization, 1 commit to home-assistant-iOS") - [mcfrojd (@mcfrojd)](https://github.com/mcfrojd "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Menno Blom (@b10m)](https://github.com/b10m "6 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 2 commits to home-assistant, 1 commit to netdisco") +- [Menno Blom (@b10m)](https://github.com/b10m "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to netdisco") - [mertenats (@mertenats)](https://github.com/mertenats "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Micha LaQua (@milaq)](https://github.com/milaq "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Michael (@hartmms)](https://github.com/hartmms "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") @@ -608,35 +606,36 @@ This page contains a list of people who have contributed in one way or another t - [Michael Fester (@michaelfester)](https://github.com/michaelfester "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Michael Furtak (@mfurtak)](https://github.com/mfurtak "5 total commits to the home-assistant organization, 5 commits to issue-bot") - [Michael Gilbert (@Zyell)](https://github.com/Zyell "8 total commits to the home-assistant organization, 8 commits to home-assistant") +- [Michael Kutý (@michaelkuty)](https://github.com/michaelkuty "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Michael Luggen (@l00mi)](https://github.com/l00mi "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Michael Requeny (@requenym)](https://github.com/requenym "14 total commits to the home-assistant organization, 14 commits to home-assistant.github.io") - [Michael Shim (@shimeez)](https://github.com/shimeez "1 total commits to the home-assistant organization, 1 commit to fabric-home-assistant") -- [Michaël Arnauts (@michaelarnauts)](https://github.com/michaelarnauts "63 total commits to the home-assistant organization, 33 commits to home-assistant, 26 commits to home-assistant.github.io, 3 commits to home-assistant-polymer, 1 commit to netdisco") +- [Michaël Arnauts (@michaelarnauts)](https://github.com/michaelarnauts "64 total commits to the home-assistant organization, 33 commits to home-assistant, 27 commits to home-assistant.github.io, 3 commits to home-assistant-polymer, 1 commit to netdisco") - [Michel Settembrino (@Michel-Settembrino)](https://github.com/Michel-Settembrino "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [micw (@micw)](https://github.com/micw "8 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io") +- [Mike (@mradziwo)](https://github.com/mradziwo "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [Mike Christianson (@MikeChristianson)](https://github.com/MikeChristianson "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Mike Megally (@cmsimike)](https://github.com/cmsimike "14 total commits to the home-assistant organization, 9 commits to home-assistant, 5 commits to home-assistant.github.io") - [Mike Nestor (@mnestor)](https://github.com/mnestor "6 total commits to the home-assistant organization, 5 commits to home-assistant, 1 commit to home-assistant-polymer") - [Mike O'Driscoll (@mikeodr)](https://github.com/mikeodr "8 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 3 commits to home-assistant") -- [Mike Roberts (@m-roberts)](https://github.com/m-roberts "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Mikkel Høgh (@mikl)](https://github.com/mikl "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Milan V\. (@milanvo)](https://github.com/milanvo "18 total commits to the home-assistant organization, 10 commits to home-assistant, 7 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [miniconfig (@miniconfig)](https://github.com/miniconfig "27 total commits to the home-assistant organization, 20 commits to home-assistant, 7 commits to home-assistant.github.io") - [Minims (@Minims)](https://github.com/Minims "3 total commits to the home-assistant organization, 3 commits to homebridge-homeassistant") -- [Mister Wil (@MisterWil)](https://github.com/MisterWil "17 total commits to the home-assistant organization, 11 commits to home-assistant, 6 commits to home-assistant.github.io") +- [Mister Wil (@MisterWil)](https://github.com/MisterWil "20 total commits to the home-assistant organization, 14 commits to home-assistant, 6 commits to home-assistant.github.io") - [Mitesh Patel (@gurumitts)](https://github.com/gurumitts "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io") -- [Mitko Masarliev (@masarliev)](https://github.com/masarliev "10 total commits to the home-assistant organization, 7 commits to home-assistant, 3 commits to home-assistant.github.io") +- [Mitko Masarliev (@masarliev)](https://github.com/masarliev "12 total commits to the home-assistant organization, 8 commits to home-assistant, 4 commits to home-assistant.github.io") - [mjj4791 (@mjj4791)](https://github.com/mjj4791 "23 total commits to the home-assistant organization, 15 commits to home-assistant.github.io, 8 commits to home-assistant") - [mmmmmtasty (@mmmmmtasty)](https://github.com/mmmmmtasty "8 total commits to the home-assistant organization, 8 commits to appdaemon") - [Molodax (@Molodax)](https://github.com/Molodax "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [moskovskiy82 (@moskovskiy82)](https://github.com/moskovskiy82 "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io") - [motir (@motir)](https://github.com/motir "1 total commits to the home-assistant organization, 1 commit to appdaemon") -- [mradziwo (@mradziwo)](https://github.com/mradziwo "1 total commits to the home-assistant organization, 1 commit to appdaemon") +- [mountainsandcode (@mountainsandcode)](https://github.com/mountainsandcode "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [mukundv (@mukundv)](https://github.com/mukundv "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Mārtiņš Grunskis (@grunskis)](https://github.com/grunskis "1 total commits to the home-assistant organization, 1 commit to netdisco") - [Nash Kaminski (@nkaminski)](https://github.com/nkaminski "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Nathan Flynn (@eperdeme)](https://github.com/eperdeme "1 total commits to the home-assistant organization, 1 commit to hassio-addons") -- [Nathan Henrie (@n8henrie)](https://github.com/n8henrie "19 total commits to the home-assistant organization, 9 commits to home-assistant, 6 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant, 1 commit to appdaemon, 1 commit to home-assistant-polymer") +- [Nathan Henrie (@n8henrie)](https://github.com/n8henrie "19 total commits to the home-assistant organization, 9 commits to home-assistant, 6 commits to home-assistant.github.io, 2 commits to homebridge-homeassistant, 1 commit to home-assistant-polymer, 1 commit to appdaemon") - [Neil Lathwood (@laf)](https://github.com/laf "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Nelis Willers (@NelisW)](https://github.com/NelisW "1 total commits to the home-assistant organization, 1 commit to fabric-home-assistant") - [NeLLyMerC (@NeLLyMerC)](https://github.com/NeLLyMerC "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") @@ -650,11 +649,11 @@ This page contains a list of people who have contributed in one way or another t - [nielstron (@nielstron)](https://github.com/nielstron "2 total commits to the home-assistant organization, 2 commits to netdisco") - [Nigel Rook (@NigelRook)](https://github.com/NigelRook "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Niklas (@niklaswa)](https://github.com/niklaswa "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") -- [Niklas Wagner (@Skaronator)](https://github.com/Skaronator "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") +- [Niklas Wagner (@Skaronator)](https://github.com/Skaronator "7 total commits to the home-assistant organization, 7 commits to home-assistant.github.io") - [Nolan Gilley (@nkgilley)](https://github.com/nkgilley "123 total commits to the home-assistant organization, 95 commits to home-assistant, 28 commits to home-assistant.github.io") - [nordlead2005 (@nordlead2005)](https://github.com/nordlead2005 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [NotoriousBDG (@notoriousbdg)](https://github.com/notoriousbdg "3 total commits to the home-assistant organization, 3 commits to hassio-addons") -- [NovapaX (@NovapaX)](https://github.com/NovapaX "35 total commits to the home-assistant organization, 29 commits to home-assistant-polymer, 5 commits to home-assistant, 1 commit to home-assistant-assets") +- [NovapaX (@NovapaX)](https://github.com/NovapaX "56 total commits to the home-assistant organization, 50 commits to home-assistant-polymer, 5 commits to home-assistant, 1 commit to home-assistant-assets") - [ntalekt (@ntalekt)](https://github.com/ntalekt "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io") - [Nuno Sousa (@nunofgs)](https://github.com/nunofgs "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to homebridge-homeassistant") - [obgm (@obgm)](https://github.com/obgm "480 total commits to the home-assistant organization, 480 commits to libcoap") @@ -665,12 +664,12 @@ This page contains a list of people who have contributed in one way or another t - [Oliver (@scarface-4711)](https://github.com/scarface-4711 "27 total commits to the home-assistant organization, 17 commits to home-assistant, 9 commits to home-assistant.github.io, 1 commit to netdisco") - [Oliver van Porten (@mcdeck)](https://github.com/mcdeck "10 total commits to the home-assistant organization, 10 commits to home-assistant") - [Open Home Automation (@open-homeautomation)](https://github.com/open-homeautomation "41 total commits to the home-assistant organization, 29 commits to home-assistant, 12 commits to home-assistant.github.io") -- [Otto Winter (@OttoWinter)](https://github.com/OttoWinter "47 total commits to the home-assistant organization, 40 commits to home-assistant, 6 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") +- [Otto Winter (@OttoWinter)](https://github.com/OttoWinter "56 total commits to the home-assistant organization, 45 commits to home-assistant, 8 commits to home-assistant.github.io, 3 commits to home-assistant-polymer") - [oznu (@oznu)](https://github.com/oznu "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant") - [Parker Moore (@parkr)](https://github.com/parkr "60 total commits to the home-assistant organization, 60 commits to home-assistant.github.io") - [pascal (@passie)](https://github.com/passie "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer") - [Pascal Bach (@bachp)](https://github.com/bachp "10 total commits to the home-assistant organization, 9 commits to home-assistant, 1 commit to netdisco") -- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "2684 total commits to the home-assistant organization, 1055 commits to hassio, 461 commits to home-assistant, 369 commits to hassio-build, 338 commits to hassio-addons, 312 commits to home-assistant.github.io, 118 commits to hassio-os, 16 commits to hassio-addons-example, 13 commits to hassio-cli, 1 commit to home-assistant-js-websocket, 1 commit to netdisco") +- [Pascal Vizeli (@pvizeli)](https://github.com/pvizeli "3005 total commits to the home-assistant organization, 1174 commits to hassio, 462 commits to home-assistant, 374 commits to hassio-build, 339 commits to hassio-addons, 318 commits to home-assistant.github.io, 307 commits to hassio-os, 16 commits to hassio-addons-example, 13 commits to hassio-cli, 1 commit to home-assistant-js-websocket, 1 commit to netdisco") - [Pat Thoyts (@patthoyts)](https://github.com/patthoyts "2 total commits to the home-assistant organization, 2 commits to netdisco") - [Patrick Aikens (@duckpuppy)](https://github.com/duckpuppy "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Patrick Easters (@patrickeasters)](https://github.com/patrickeasters "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") @@ -692,18 +691,18 @@ This page contains a list of people who have contributed in one way or another t - [Petr Vraník (@konikvranik)](https://github.com/konikvranik "11 total commits to the home-assistant organization, 6 commits to home-assistant, 5 commits to home-assistant.github.io") - [pezinek (@pezinek)](https://github.com/pezinek "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Phil (@godloth)](https://github.com/godloth "10 total commits to the home-assistant organization, 10 commits to home-assistant.github.io") -- [Phil Cole (@filcole)](https://github.com/filcole "8 total commits to the home-assistant organization, 5 commits to home-assistant.github.io, 3 commits to home-assistant") +- [Phil Cole (@filcole)](https://github.com/filcole "9 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 3 commits to home-assistant") - [Phil Elson (@pelson)](https://github.com/pelson "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Phil Frost (@bitglue)](https://github.com/bitglue "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Phil Hawthorne (@philhawthorne)](https://github.com/philhawthorne "24 total commits to the home-assistant organization, 18 commits to home-assistant.github.io, 6 commits to home-assistant") -- [Phil Kates (@philk)](https://github.com/philk "7 total commits to the home-assistant organization, 7 commits to home-assistant") +- [Phil Kates (@philk)](https://github.com/philk "11 total commits to the home-assistant organization, 8 commits to home-assistant, 3 commits to home-assistant.github.io") - [Philip Hofstetter (@pilif)](https://github.com/pilif "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io") - [Philip Howard (@Gadgetoid)](https://github.com/Gadgetoid "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Philip Kleimeyer (@philklei)](https://github.com/philklei "4 total commits to the home-assistant organization, 4 commits to home-assistant") - [Philip Lundrigan (@philipbl)](https://github.com/philipbl "65 total commits to the home-assistant organization, 56 commits to home-assistant, 9 commits to home-assistant.github.io") - [Philip Rosenberg\-Watt (@PhilRW)](https://github.com/PhilRW "10 total commits to the home-assistant organization, 7 commits to home-assistant, 3 commits to home-assistant.github.io") - [Philipp Hellmich (@runningman84)](https://github.com/runningman84 "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") -- [Philipp Schmitt (@pschmitt)](https://github.com/pschmitt "37 total commits to the home-assistant organization, 24 commits to home-assistant, 11 commits to home-assistant.github.io, 1 commit to appdaemon, 1 commit to hassio-build") +- [Philipp Schmitt (@pschmitt)](https://github.com/pschmitt "38 total commits to the home-assistant organization, 25 commits to home-assistant, 11 commits to home-assistant.github.io, 1 commit to hassio-build, 1 commit to appdaemon") - [Phill Price (@phillprice)](https://github.com/phillprice "11 total commits to the home-assistant organization, 11 commits to home-assistant.github.io") - [PhracturedBlue (@PhracturedBlue)](https://github.com/PhracturedBlue "33 total commits to the home-assistant organization, 20 commits to home-assistant, 12 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Pierre Ståhl (@postlund)](https://github.com/postlund "49 total commits to the home-assistant organization, 32 commits to home-assistant, 11 commits to home-assistant.github.io, 4 commits to netdisco, 2 commits to home-assistant-polymer") @@ -715,24 +714,26 @@ This page contains a list of people who have contributed in one way or another t - [rbflurry (@rbflurry)](https://github.com/rbflurry "16 total commits to the home-assistant organization, 13 commits to home-assistant.github.io, 3 commits to home-assistant") - [Reed Riley (@reedriley)](https://github.com/reedriley "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Rendili (@Rendili)](https://github.com/Rendili "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Rene Nulsch (@ReneNulschDE)](https://github.com/ReneNulschDE "19 total commits to the home-assistant organization, 13 commits to home-assistant, 6 commits to home-assistant.github.io") +- [Rene Nulsch (@ReneNulschDE)](https://github.com/ReneNulschDE "21 total commits to the home-assistant organization, 14 commits to home-assistant, 7 commits to home-assistant.github.io") - [Rene Tode (@ReneTode)](https://github.com/ReneTode "38 total commits to the home-assistant organization, 38 commits to appdaemon") - [Reza Moallemi (@moallemi)](https://github.com/moallemi "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [rhooper (@rhooper)](https://github.com/rhooper "27 total commits to the home-assistant organization, 25 commits to home-assistant, 2 commits to hadashboard") - [Riccardo Canta (@commento)](https://github.com/commento "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Richard Arends (@Mosibi)](https://github.com/Mosibi "8 total commits to the home-assistant organization, 8 commits to home-assistant") - [Richard Cox (@Khabi)](https://github.com/Khabi "15 total commits to the home-assistant organization, 9 commits to home-assistant, 6 commits to home-assistant.github.io") -- [Richard Leurs (@R1chardTM)](https://github.com/R1chardTM "13 total commits to the home-assistant organization, 6 commits to home-assistant, 6 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") +- [Richard Leurs (@R1chardTM)](https://github.com/R1chardTM "13 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 6 commits to home-assistant, 1 commit to home-assistant-polymer") - [Richard Lucas (@lucasweb78)](https://github.com/lucasweb78 "9 total commits to the home-assistant organization, 9 commits to home-assistant") - [Richard Niemand (@rniemand)](https://github.com/rniemand "1 total commits to the home-assistant organization, 1 commit to example-custom-config") - [Rick (@rcuddy)](https://github.com/rcuddy "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [rkabadi (@rkabadi)](https://github.com/rkabadi "17 total commits to the home-assistant organization, 17 commits to home-assistant") - [Rob Capellini (@capellini)](https://github.com/capellini "3 total commits to the home-assistant organization, 3 commits to home-assistant") +- [Rob Cranfill (@RobCranfill)](https://github.com/RobCranfill "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Rob Slifka (@rslifka)](https://github.com/rslifka "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") -- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "1317 total commits to the home-assistant organization, 646 commits to home-assistant-iOS, 259 commits to home-assistant, 249 commits to home-assistant.github.io, 92 commits to homebridge-homeassistant, 15 commits to home-assistant-polymer, 9 commits to hubot-home-assistant, 8 commits to Analytics-Receiver, 6 commits to netdisco, 3 commits to scenegen, 3 commits to hadashboard, 3 commits to appdaemon, 3 commits to home-assistant-js, 3 commits to organization, 3 commits to home-assistant-js-websocket, 3 commits to hassbot, 2 commits to LabelBot, 2 commits to micropython-home-assistant, 2 commits to fabric-home-assistant, 2 commits to home-assistant-notebooks, 2 commits to lambda-home-assistant-github, 2 commits to home-assistant-assets") +- [Robbie Trencheny (@robbiet480)](https://github.com/robbiet480 "1317 total commits to the home-assistant organization, 646 commits to home-assistant-iOS, 259 commits to home-assistant, 249 commits to home-assistant.github.io, 92 commits to homebridge-homeassistant, 15 commits to home-assistant-polymer, 9 commits to hubot-home-assistant, 8 commits to Analytics-Receiver, 6 commits to netdisco, 3 commits to hassbot, 3 commits to appdaemon, 3 commits to scenegen, 3 commits to organization, 3 commits to home-assistant-js-websocket, 3 commits to hadashboard, 3 commits to home-assistant-js, 2 commits to LabelBot, 2 commits to lambda-home-assistant-github, 2 commits to fabric-home-assistant, 2 commits to home-assistant-notebooks, 2 commits to micropython-home-assistant, 2 commits to home-assistant-assets") - [Robert (@metbril)](https://github.com/metbril "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Robert Schütz (@dotlambda)](https://github.com/dotlambda "2 total commits to the home-assistant organization, 1 commit to appdaemon, 1 commit to netdisco") -- [Robin (@robmarkcole)](https://github.com/robmarkcole "30 total commits to the home-assistant organization, 20 commits to home-assistant.github.io, 9 commits to home-assistant, 1 commit to home-assistant-assets") +- [Robert Schütz (@dotlambda)](https://github.com/dotlambda "2 total commits to the home-assistant organization, 1 commit to netdisco, 1 commit to appdaemon") +- [Robert Svensson (@Kane610)](https://github.com/Kane610 "40 total commits to the home-assistant organization, 24 commits to home-assistant, 14 commits to home-assistant.github.io, 1 commit to home-assistant-polymer, 1 commit to netdisco") +- [Robin (@robmarkcole)](https://github.com/robmarkcole "42 total commits to the home-assistant organization, 27 commits to home-assistant.github.io, 14 commits to home-assistant, 1 commit to home-assistant-assets") - [Robin Laurén (@llauren)](https://github.com/llauren "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [Roddie Hasan (@eiddor)](https://github.com/eiddor "6 total commits to the home-assistant organization, 6 commits to home-assistant.github.io") - [Roi Dayan (@roidayan)](https://github.com/roidayan "6 total commits to the home-assistant organization, 6 commits to home-assistant") @@ -746,13 +747,12 @@ This page contains a list of people who have contributed in one way or another t - [rubund (@rubund)](https://github.com/rubund "4 total commits to the home-assistant organization, 4 commits to home-assistant") - [Ruslan Kiyanchuk (@zoresvit)](https://github.com/zoresvit "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [Russ K (@rkubes)](https://github.com/rkubes "2 total commits to the home-assistant organization, 2 commits to pi-gen") -- [Russell Cloran (@rcloran)](https://github.com/rcloran "30 total commits to the home-assistant organization, 26 commits to home-assistant, 4 commits to homebridge-homeassistant") +- [Russell Cloran (@rcloran)](https://github.com/rcloran "31 total commits to the home-assistant organization, 27 commits to home-assistant, 4 commits to homebridge-homeassistant") - [Ryan Bahm (@rdbahm)](https://github.com/rdbahm "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") -- [Ryan Borstelmann (@SlothCroissant)](https://github.com/SlothCroissant "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Ryan Daigle (@rwdaigle)](https://github.com/rwdaigle "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Ryan Jarvis (@Cabalist)](https://github.com/Cabalist "1 total commits to the home-assistant organization, 1 commit to hassbian-scripts") - [Ryan Kraus (@rmkraus)](https://github.com/rmkraus "193 total commits to the home-assistant organization, 163 commits to home-assistant, 15 commits to home-assistant.github.io, 14 commits to home-assistant-polymer, 1 commit to home-assistant-notebooks") -- [Ryan McLean (@ryanm101)](https://github.com/ryanm101 "92 total commits to the home-assistant organization, 70 commits to hassio-cli, 16 commits to home-assistant, 6 commits to home-assistant.github.io") +- [Ryan McLean (@ryanm101)](https://github.com/ryanm101 "96 total commits to the home-assistant organization, 74 commits to hassio-cli, 16 commits to home-assistant, 6 commits to home-assistant.github.io") - [Ryan Turner (@turnrye)](https://github.com/turnrye "6 total commits to the home-assistant organization, 6 commits to home-assistant") - [Sabesto (@Sabesto)](https://github.com/Sabesto "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Sacha Telgenhof (@stelgenhof)](https://github.com/stelgenhof "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") @@ -765,10 +765,10 @@ This page contains a list of people who have contributed in one way or another t - [Scott Reston (@ih8gates)](https://github.com/ih8gates "9 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 1 commit to home-assistant-polymer") - [Sean Dague (@sdague)](https://github.com/sdague "75 total commits to the home-assistant organization, 52 commits to home-assistant, 14 commits to home-assistant.github.io, 5 commits to home-assistant-polymer, 3 commits to netdisco, 1 commit to home-assistant-js") - [Sean Gollschewsky (@gollo)](https://github.com/gollo "17 total commits to the home-assistant organization, 10 commits to home-assistant, 4 commits to home-assistant.github.io, 3 commits to hassio-build") -- [Sean Wilson (@swilson)](https://github.com/swilson "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer") -- [Sebastian (@sebk-666)](https://github.com/sebk-666 "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") +- [Sean Wilson (@swilson)](https://github.com/swilson "5 total commits to the home-assistant organization, 4 commits to home-assistant, 1 commit to home-assistant-polymer") +- [Sebastian (@sebk-666)](https://github.com/sebk-666 "5 total commits to the home-assistant organization, 5 commits to home-assistant.github.io") - [Sebastian (@sgso)](https://github.com/sgso "3 total commits to the home-assistant organization, 3 commits to libcoap") -- [Sebastian Muszynski (@syssi)](https://github.com/syssi "97 total commits to the home-assistant organization, 58 commits to home-assistant, 36 commits to home-assistant.github.io, 2 commits to home-assistant-polymer, 1 commit to netdisco") +- [Sebastian Muszynski (@syssi)](https://github.com/syssi "115 total commits to the home-assistant organization, 69 commits to home-assistant, 42 commits to home-assistant.github.io, 2 commits to home-assistant-polymer, 2 commits to netdisco") - [Sebastian von Minckwitz (@teodoc)](https://github.com/teodoc "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Semir Patel (@analogue)](https://github.com/analogue "2 total commits to the home-assistant organization, 2 commits to appdaemon") - [Sergey Isachenko (@zabuldon)](https://github.com/zabuldon "9 total commits to the home-assistant organization, 9 commits to home-assistant") @@ -786,6 +786,7 @@ This page contains a list of people who have contributed in one way or another t - [Stefan Jonasson (@stefan-jonasson)](https://github.com/stefan-jonasson "12 total commits to the home-assistant organization, 8 commits to home-assistant, 4 commits to home-assistant.github.io") - [Stefano Scipioni (@scipioni)](https://github.com/scipioni "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Steltek (@Steltek)](https://github.com/Steltek "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") +- [stephanerosi (@stephanerosi)](https://github.com/stephanerosi "7 total commits to the home-assistant organization, 7 commits to home-assistant") - [Stephen Edgar (@ntwb)](https://github.com/ntwb "1 total commits to the home-assistant organization, 1 commit to fabric-home-assistant") - [Stephen Yeargin (@stephenyeargin)](https://github.com/stephenyeargin "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Steve Easley (@SteveEasley)](https://github.com/SteveEasley "3 total commits to the home-assistant organization, 3 commits to home-assistant") @@ -796,7 +797,7 @@ This page contains a list of people who have contributed in one way or another t - [Sytone (@sytone)](https://github.com/sytone "7 total commits to the home-assistant organization, 6 commits to home-assistant.github.io, 1 commit to hassio-build") - [Sören Oldag (@soldag)](https://github.com/soldag "15 total commits to the home-assistant organization, 8 commits to home-assistant.github.io, 7 commits to home-assistant") - [Tabakhase (@tabakhase)](https://github.com/tabakhase "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") -- [tadly (@tadly)](https://github.com/tadly "3 total commits to the home-assistant organization, 3 commits to home-assistant") +- [tadly (@tadly)](https://github.com/tadly "4 total commits to the home-assistant organization, 4 commits to home-assistant") - [tango-foxtrot (@tango-foxtrot)](https://github.com/tango-foxtrot "1 total commits to the home-assistant organization, 1 commit to netdisco") - [Taylor Peet (@RePeet13)](https://github.com/RePeet13 "9 total commits to the home-assistant organization, 9 commits to home-assistant.github.io") - [Teagan Glenn (@Teagan42)](https://github.com/Teagan42 "59 total commits to the home-assistant organization, 49 commits to home-assistant, 9 commits to home-assistant.github.io, 1 commit to home-assistant-js") @@ -808,19 +809,20 @@ This page contains a list of people who have contributed in one way or another t - [Tentoe (@Tentoe)](https://github.com/Tentoe "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Theb-1 (@Theb-1)](https://github.com/Theb-1 "5 total commits to the home-assistant organization, 5 commits to home-assistant") - [thecynic (@thecynic)](https://github.com/thecynic "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [TheFrogDaddy (@TheFrogDaddy)](https://github.com/TheFrogDaddy "1 total commits to the home-assistant organization, 1 commit to appdaemon") - [themanieldaniel (@themanieldaniel)](https://github.com/themanieldaniel "8 total commits to the home-assistant organization, 8 commits to home-assistant.github.io") - [Theodor Lindquist (@theolind)](https://github.com/theolind "25 total commits to the home-assistant organization, 25 commits to home-assistant") - [Thiago Oliveira (@chilicheech)](https://github.com/chilicheech "4 total commits to the home-assistant organization, 4 commits to home-assistant") -- [Thibault Cohen (@titilambert)](https://github.com/titilambert "44 total commits to the home-assistant organization, 31 commits to home-assistant, 13 commits to home-assistant.github.io") +- [Thibault Cohen (@titilambert)](https://github.com/titilambert "47 total commits to the home-assistant organization, 34 commits to home-assistant, 13 commits to home-assistant.github.io") - [Thibault Maekelbergh (@thibmaek)](https://github.com/thibmaek "4 total commits to the home-assistant organization, 3 commits to home-assistant.github.io, 1 commit to hassio-addons") -- [Thijs de Jong (@bakedraccoon)](https://github.com/bakedraccoon "19 total commits to the home-assistant organization, 15 commits to home-assistant, 4 commits to home-assistant.github.io") +- [Thijs de Jong (@bakedraccoon)](https://github.com/bakedraccoon "20 total commits to the home-assistant organization, 16 commits to home-assistant, 4 commits to home-assistant.github.io") - [ThinkPadNL (@ThinkPadNL)](https://github.com/ThinkPadNL "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [Thom Troy (@ttroy50)](https://github.com/ttroy50 "13 total commits to the home-assistant organization, 7 commits to home-assistant.github.io, 6 commits to home-assistant") - [Thomas Petazzoni (@tpetazzoni)](https://github.com/tpetazzoni "1 total commits to the home-assistant organization, 1 commit to libcoap") - [Thomas Phillips (@thomas-phillips-nz)](https://github.com/thomas-phillips-nz "2 total commits to the home-assistant organization, 2 commits to pi-gen") - [Thomas Purchas (@thomaspurchas)](https://github.com/thomaspurchas "1 total commits to the home-assistant organization, 1 commit to homebridge-homeassistant") - [Thomas Pötsch (@thp-comnets)](https://github.com/thp-comnets "7 total commits to the home-assistant organization, 7 commits to libcoap") -- [thrawnarn (@thrawnarn)](https://github.com/thrawnarn "8 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to netdisco") +- [thrawnarn (@thrawnarn)](https://github.com/thrawnarn "9 total commits to the home-assistant organization, 5 commits to home-assistant, 3 commits to home-assistant.github.io, 1 commit to netdisco") - [ThUnD3r\|Gr33n (@thundergreen)](https://github.com/thundergreen "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [tijuca (@tijuca)](https://github.com/tijuca "106 total commits to the home-assistant organization, 106 commits to libcoap") - [Tim Wilbrink (@TWilb)](https://github.com/TWilb "15 total commits to the home-assistant organization, 15 commits to home-assistant-iOS") @@ -829,12 +831,12 @@ This page contains a list of people who have contributed in one way or another t - [TJ Rana (@tjrana)](https://github.com/tjrana "1 total commits to the home-assistant organization, 1 commit to pi-gen") - [tleegaard (@tleegaard)](https://github.com/tleegaard "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Tobie Booth (@tobiebooth)](https://github.com/tobiebooth "4 total commits to the home-assistant organization, 3 commits to home-assistant, 1 commit to home-assistant-polymer") -- [Toby Gray (@tobygray)](https://github.com/tobygray "3 total commits to the home-assistant organization, 3 commits to home-assistant") -- [Tod Schmidt (@tschmidty69)](https://github.com/tschmidty69 "22 total commits to the home-assistant organization, 17 commits to home-assistant, 4 commits to home-assistant.github.io, 1 commit to hassio-addons") +- [Toby Gray (@tobygray)](https://github.com/tobygray "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [Tod Schmidt (@tschmidty69)](https://github.com/tschmidty69 "26 total commits to the home-assistant organization, 20 commits to home-assistant, 5 commits to home-assistant.github.io, 1 commit to hassio-addons") - [toddeye (@toddeye)](https://github.com/toddeye "20 total commits to the home-assistant organization, 20 commits to home-assistant") - [Tom Dickman (@tdickman)](https://github.com/tdickman "3 total commits to the home-assistant organization, 3 commits to home-assistant") - [Tom Duijf (@tomduijf)](https://github.com/tomduijf "70 total commits to the home-assistant organization, 53 commits to home-assistant, 9 commits to home-assistant.github.io, 6 commits to home-assistant-polymer, 2 commits to netdisco") -- [Tom Harris (@teharris1)](https://github.com/teharris1 "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [Tom Harris (@teharris1)](https://github.com/teharris1 "5 total commits to the home-assistant organization, 5 commits to home-assistant") - [Tom Hoover (@tomhoover)](https://github.com/tomhoover "3 total commits to the home-assistant organization, 3 commits to home-assistant.github.io") - [Tom Matheussen (@Tommatheussen)](https://github.com/Tommatheussen "13 total commits to the home-assistant organization, 6 commits to home-assistant, 4 commits to home-assistant-polymer, 3 commits to home-assistant.github.io") - [Tom Usher (@tomusher)](https://github.com/tomusher "1 total commits to the home-assistant organization, 1 commit to netdisco") @@ -862,7 +864,7 @@ This page contains a list of people who have contributed in one way or another t - [Victor Cerutti (@victorcerutti)](https://github.com/victorcerutti "3 total commits to the home-assistant organization, 3 commits to home-assistant-polymer") - [Viet Dzung (@dzungpv)](https://github.com/dzungpv "1 total commits to the home-assistant organization, 1 commit to home-assistant-polymer") - [Vignesh Venkat (@vickyg3)](https://github.com/vickyg3 "9 total commits to the home-assistant organization, 5 commits to home-assistant, 4 commits to home-assistant.github.io") -- [Ville Skyttä (@scop)](https://github.com/scop "38 total commits to the home-assistant organization, 18 commits to home-assistant, 9 commits to home-assistant.github.io, 4 commits to netdisco, 3 commits to hassio-addons, 2 commits to hassio-build, 2 commits to home-assistant-polymer") +- [Ville Skyttä (@scop)](https://github.com/scop "40 total commits to the home-assistant organization, 19 commits to home-assistant, 10 commits to home-assistant.github.io, 4 commits to netdisco, 3 commits to hassio-addons, 2 commits to hassio-build, 2 commits to home-assistant-polymer") - [viswa-swami (@viswa-swami)](https://github.com/viswa-swami "9 total commits to the home-assistant organization, 9 commits to home-assistant") - [Vlad Korniev (@vkorn)](https://github.com/vkorn "1 total commits to the home-assistant organization, 1 commit to hassio-build") - [vllungu (@vllungu)](https://github.com/vllungu "3 total commits to the home-assistant organization, 3 commits to libcoap") @@ -879,10 +881,10 @@ This page contains a list of people who have contributed in one way or another t - [wind-rider (@wind-rider)](https://github.com/wind-rider "5 total commits to the home-assistant organization, 5 commits to home-assistant") - [wokar (@wokar)](https://github.com/wokar "12 total commits to the home-assistant organization, 8 commits to home-assistant, 4 commits to home-assistant.github.io") - [Wolf\-Bastian Pöttner (@BastianPoe)](https://github.com/BastianPoe "7 total commits to the home-assistant organization, 4 commits to home-assistant, 3 commits to home-assistant.github.io") -- [Wolfgang Malgadey (@wmalgadey)](https://github.com/wmalgadey "4 total commits to the home-assistant organization, 4 commits to home-assistant") +- [Wolfgang Malgadey (@wmalgadey)](https://github.com/wmalgadey "5 total commits to the home-assistant organization, 5 commits to home-assistant") - [XECDesign (@XECDesign)](https://github.com/XECDesign "138 total commits to the home-assistant organization, 138 commits to pi-gen") - [Xorso (@Xorso)](https://github.com/Xorso "22 total commits to the home-assistant organization, 21 commits to home-assistant, 1 commit to hassio-addons") -- [Yannick POLLART (@ypollart)](https://github.com/ypollart "8 total commits to the home-assistant organization, 4 commits to home-assistant.github.io, 4 commits to home-assistant") +- [Yannick POLLART (@ypollart)](https://github.com/ypollart "8 total commits to the home-assistant organization, 4 commits to home-assistant, 4 commits to home-assistant.github.io") - [Yasin Soliman (@yasinS)](https://github.com/yasinS "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") - [yingzong (@yingzong)](https://github.com/yingzong "1 total commits to the home-assistant organization, 1 commit to warrant") - [Zen Tormey (@xehn)](https://github.com/xehn "4 total commits to the home-assistant organization, 4 commits to home-assistant.github.io") @@ -894,4 +896,4 @@ This page contains a list of people who have contributed in one way or another t This page is irregularly updated using the [`credits_generator` tool](https://github.com/home-assistant/home-assistant.github.io/tree/next/credits_generator). If you think that you are missing, please let us know. -This page was last updated Saturday, March 31st 2018, 9:09:02 am UTC. +This page was last updated Sunday, April 29th 2018, 4:35:15 pm UTC. From 19722e8ede1d670ac3ce484f5aff6fc319fb1d76 Mon Sep 17 00:00:00 2001 From: Gerard Date: Mon, 30 Apr 2018 00:02:33 +0200 Subject: [PATCH 188/241] Add device_tracker component (#5272) The `device_tracker` is added in Home Assistant 0.68 but missing in the list of components. CC @cdce8p --- source/_components/homekit.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index d84658d945..0736cdddff 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -200,6 +200,7 @@ The following components are currently supported: | cover | WindowCovering | All covers that support `set_cover_position`. | | cover | WindowCovering | All covers that support `open_cover` and `close_cover` through value mapping. (`open` -> `>=50`; `close` -> `<50`) | | cover | WindowCovering | All covers that support `open_cover`, `stop_cover` and `close_cover` through value mapping. (`open` -> `>70`; `close` -> `<30`; `stop` -> every value in between) | +| device_tracker | Sensor | Support for `occupancy` device class. | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | | lock | DoorLock | Support for `lock / unlock`. | | sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement` or `temperature` as their `device_class`. | From 8ec44c00dd9c496867a461db75afe28debfea171 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 30 Apr 2018 14:07:31 -0400 Subject: [PATCH 189/241] Release 0.68.1 --- _config.yml | 6 ++-- source/_posts/2018-04-27-release-68.markdown | 32 ++++++++++++++++++++ 2 files changed, 35 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index ea4d3c06f1..502ae90635 100644 --- a/_config.yml +++ b/_config.yml @@ -140,13 +140,13 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 68 -current_patch_version: 0 -date_released: 2018-04-27 +current_patch_version: 1 +date_released: 2018-04-30 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. # Major release: -patch_version_notes: "#release-0671---april-17" +patch_version_notes: "#release-0681---april-30" # Minor release (Example #release-0431---april-25): # Date we moved to Discourse for comments diff --git a/source/_posts/2018-04-27-release-68.markdown b/source/_posts/2018-04-27-release-68.markdown index 4ac9d1f460..924546f866 100644 --- a/source/_posts/2018-04-27-release-68.markdown +++ b/source/_posts/2018-04-27-release-68.markdown @@ -39,6 +39,18 @@ Another cool new platform, also by [@mjg59], is support for Eufy devices. Eufy i - Support Garage Doors in HomeKit ([@marthoc] - [#13796]) ([homekit docs]) (new-feature) - Support basic covers with open/close/stop services HomeKit ([@nickw444] - [#13819]) ([homekit docs]) (new-feature) +## {% linkable_title Release 0.68.1 - April 30 %} + +- Fix color setting of tplink lights ([@amelchio] - [#14108]) ([light.tplink docs]) +- Improve precision of Hue color state ([@amelchio] - [#14113]) ([light.hue docs]) +- Revert Hue color state to be xy-based ([@amelchio] - [#14154]) +- Fix Python 3.6 compatibility for HomeKit controller ([@mjg59] - [#14160]) ([homekit_controller docs]) +- Added CONF_IP_ADDRESS to HomeKit ([@cdce8p] - [#14163]) ([homekit docs]) +- Do not sync entities with an empty name ([@balloob] - [#14181]) ([google_assistant docs]) +- Improve chromecast disconnection logic ([@OttoWinter] - [#14190]) ([media_player.cast docs]) +- Fix poorly formatted automations ([@balloob] - [#14196]) +- Disable eliqonline requirement ([@balloob] - [#14156]) + ## {% linkable_title If you need help... %} ...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. @@ -499,3 +511,23 @@ Experiencing issues introduced by this release? Please report them in our [issue [vacuum.xiaomi_miio docs]: /components/vacuum.xiaomi_miio/ [weather.yweather docs]: /components/weather.yweather/ [zha docs]: /components/zha/ +[#14108]: https://github.com/home-assistant/home-assistant/pull/14108 +[#14113]: https://github.com/home-assistant/home-assistant/pull/14113 +[#14154]: https://github.com/home-assistant/home-assistant/pull/14154 +[#14160]: https://github.com/home-assistant/home-assistant/pull/14160 +[#14163]: https://github.com/home-assistant/home-assistant/pull/14163 +[#14181]: https://github.com/home-assistant/home-assistant/pull/14181 +[#14190]: https://github.com/home-assistant/home-assistant/pull/14190 +[#14196]: https://github.com/home-assistant/home-assistant/pull/14196 +[#14156]: https://github.com/home-assistant/home-assistant/pull/14156 +[@OttoWinter]: https://github.com/OttoWinter +[@amelchio]: https://github.com/amelchio +[@balloob]: https://github.com/balloob +[@cdce8p]: https://github.com/cdce8p +[@mjg59]: https://github.com/mjg59 +[google_assistant docs]: /components/google_assistant/ +[homekit docs]: /components/homekit/ +[homekit_controller docs]: /components/homekit_controller/ +[light.hue docs]: /components/light.hue/ +[light.tplink docs]: /components/light.tplink/ +[media_player.cast docs]: /components/media_player.cast/ \ No newline at end of file From 77a14ad9d9087e4ae0024fcccbf1ca1bb4963dea Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 30 Apr 2018 16:52:16 -0400 Subject: [PATCH 190/241] Add room to google assistant config (#5274) --- source/cloud/google_assistant.markdown | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/source/cloud/google_assistant.markdown b/source/cloud/google_assistant.markdown index 1cdced7984..85b8950829 100644 --- a/source/cloud/google_assistant.markdown +++ b/source/cloud/google_assistant.markdown @@ -37,6 +37,7 @@ cloud: aliases: - bright lights - entry lights + room: living room ``` {% configuration cloud %} @@ -84,5 +85,8 @@ google_actions: description: Aliases that can also be used to refer to this entity required: false type: list + room: + description: Hint for Google Assistant in which room this entity is. + required: false + type: string {% endconfiguration %} - From 692fd52678bb49b7d398d7881f95a850bcf9f157 Mon Sep 17 00:00:00 2001 From: PhyberApex Date: Mon, 30 Apr 2018 22:53:46 +0200 Subject: [PATCH 191/241] Fixing recursive call in cookbook (#5279) Recursive calling is not allowed in home assistant. Splitting the script up was necessary. --- source/_cookbook/automation_flashing_lights.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_cookbook/automation_flashing_lights.markdown b/source/_cookbook/automation_flashing_lights.markdown index df14121307..5a55323eac 100644 --- a/source/_cookbook/automation_flashing_lights.markdown +++ b/source/_cookbook/automation_flashing_lights.markdown @@ -97,6 +97,14 @@ script: service: homeassistant.turn_off data: entity_id: switch.REL1 + - alias: loop_room1 + service: script.turn_on + data: + entity_id: script.flash_loop + + flash_loop: + alias: Flash loop + sequence: - delay: # time for flash light off seconds: 1 From 3ffe30f777b637f17e3a39033296c90a75c1f64c Mon Sep 17 00:00:00 2001 From: Diogo Gomes Date: Mon, 30 Apr 2018 22:09:37 +0100 Subject: [PATCH 192/241] fix broken link (#5273) * fix broken link * Fix links --- source/_components/homekit_controller.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/homekit_controller.markdown b/source/_components/homekit_controller.markdown index 319f505ef1..bdd80d24af 100644 --- a/source/_components/homekit_controller.markdown +++ b/source/_components/homekit_controller.markdown @@ -13,12 +13,12 @@ ha_release: 0.68 ha_iot_class: "Local Polling" --- -[HomeKit](https://developer.apple.com/homekit/) controller integration for Home Assistant allows you to connect HomeKit accessories to Home Assistant. This component should not be confused with the [HomeKit](homekit) component, which allows you to control Home Assistant devices via HomeKit. +[HomeKit](https://developer.apple.com/homekit/) controller integration for Home Assistant allows you to connect HomeKit accessories to Home Assistant. This component should not be confused with the [HomeKit](/components/homekit/) component, which allows you to control Home Assistant devices via HomeKit. There is currently support for the following device types within Home Assistant: -- [Light](../light.homekit_controller) -- [Switch](../switch.homekit_controller) +- [Light](/components/light.homekit_controller/) +- [Switch](/components/switch.homekit_controller/) The component will be automatically configured if the [`discovery:`](components/discovery/) component is enabled and an enable entry added for HomeKit: From 7aee40a482038032ed82ae5979cb5aa97ad2be5c Mon Sep 17 00:00:00 2001 From: DubhAd Date: Mon, 30 Apr 2018 22:12:56 +0100 Subject: [PATCH 193/241] Adding note about mDNS (#5280) For when mDNS doesn't work, people are stuck. Adding a note about how to work around that. --- source/hassio/installation.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/hassio/installation.markdown b/source/hassio/installation.markdown index b29e39251d..08a2744aed 100644 --- a/source/hassio/installation.markdown +++ b/source/hassio/installation.markdown @@ -30,6 +30,10 @@ Hass.io images are available for all available Raspberry Pi and Intel NUC platfo - You will be able to reach your installation at [http://hassio.local:8123][local]. - Enable either the [Samba add-on][samba] or the [SSH add-on][ssh] to manage your configuration in `/config/` (From the UI choose **Hass.io** which is located in the sidebar). +

    +If your router doesn't support mDNS then you'll have to use the IP address of your Pi, instead of `hassio.local`, for example `http://192.168.0.9:8123`. You should be able to find the IP address of your Pi from the admin interface of your router. +

    +

    Please remember to ensure you're using an [appropriate power supply](https://www.raspberrypi.org/help/faqs/#powerReqs) with your Pi. Mobile chargers may not be suitable since some are designed to only provide the full power with that manufacturer's handsets.

    From 4c405c8e977e73078aed64ee61c1ef6909eab8c0 Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Tue, 1 May 2018 04:14:21 +0200 Subject: [PATCH 194/241] Added CONF_IP_ADDRESS to HomeKit (#5281) --- source/_components/homekit.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 0736cdddff..f0723ba4ac 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -39,6 +39,10 @@ The `HomeKit` component allows you to forward entities from Home Assistant to Ap required: false type: int default: 51827 + ip_address: + description: The local network IP address. Only necessary if the default from Home Assistant does not work. + required: false + type: string filter: description: Filter entities to available in the `Home` app. ([Configure Filter](#configure-filter)) required: false From 4133cc0196f264e29521c89e664feef2f216a729 Mon Sep 17 00:00:00 2001 From: DubhAd Date: Tue, 1 May 2018 19:13:28 +0100 Subject: [PATCH 195/241] Calling out that devices are still added (#5284) It's a common source of confusion that with `track_new_devices: False` devices are still added to `known_devices.yaml`. This adds a note to say that this is to be expected. --- source/_components/device_tracker.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/device_tracker.markdown b/source/_components/device_tracker.markdown index a66d78b716..b595407d13 100644 --- a/source/_components/device_tracker.markdown +++ b/source/_components/device_tracker.markdown @@ -40,6 +40,10 @@ The following optional parameters can be used with any platform. However device | `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`) | | `new_device_defaults`| | Default values for new discovered devices. Available options `track_new_devices` (default: `True`), `hide_if_away` (default: `False`) | +

    + Note that setting `track_new_devices: False` will still result in new devices being recorded in `known_devices.yaml`, but they won't be tracked (`track: no`). +

    + The extended example from above would look like the following sample: ```yaml From 222d9483d9c423e389fb13881c56b47107695fb6 Mon Sep 17 00:00:00 2001 From: Jan Willhaus Date: Tue, 1 May 2018 20:14:42 +0200 Subject: [PATCH 196/241] Fix faulty link to AVM homepage (#5283) --- source/_components/fritzbox.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/fritzbox.markdown b/source/_components/fritzbox.markdown index 9b69d05831..351f63e35d 100644 --- a/source/_components/fritzbox.markdown +++ b/source/_components/fritzbox.markdown @@ -13,7 +13,7 @@ ha_release: 0.68 ha_iot_class: "Local Polling" --- -The [AVM](www.avm.de) Fritzbox component for Home Assistant allows you to integrate the switch and climate devices. +The [AVM](https://en.avm.de) Fritzbox component for Home Assistant allows you to integrate the switch and climate devices. #### {% linkable_title Tested Devices %} From 5e7c31b16c51ce0233dad996b59f5fe1261a4ed2 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Tue, 1 May 2018 14:21:34 -0400 Subject: [PATCH 197/241] Fix styling --- source/_docs/installation/docker.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_docs/installation/docker.markdown b/source/_docs/installation/docker.markdown index bc7369f415..4245f1069c 100644 --- a/source/_docs/installation/docker.markdown +++ b/source/_docs/installation/docker.markdown @@ -16,15 +16,15 @@ Installation with Docker is straightforward. Adjust the following command so tha ```bash $ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/home-assistant -```​ +``` ### {% linkable_title Raspberry Pi 3 (Raspbian) %} ```bash - $ docker run -d --name="home-assistant" -v /path/to/your/config:/config -v /etc/localtime:/etc/localtime:ro --net=host homeassistant/raspberrypi3-homeassistant:0.XX.x ``` -The Docker container for Raspberry Pi 3 does not have a 'latest' tag so the version number must be specified explicitly, i.e. 0.68.0 or whatever version is desired. This goes for both CLI and Docker Compose. + +The Docker container for Raspberry Pi 3 does not have a 'latest' tag so the version number must be specified explicitly, i.e. 0.68.0. This goes for both CLI and Docker Compose. ### {% linkable_title macOS %} From dcda30e25bdee92b1eb0dda2f582a0e41982c7cf Mon Sep 17 00:00:00 2001 From: Otto Winter Date: Tue, 1 May 2018 20:33:26 +0200 Subject: [PATCH 198/241] Add Template Sensor device_class support (#5220) * Add Template Sensor device_class support * Update battery templates * Update track battery level example --- .../device_tracker.owntracks_http.markdown | 15 ++------------- source/_components/sensor.template.markdown | 5 +++++ source/_cookbook/track_battery_level.markdown | 18 +++--------------- 3 files changed, 10 insertions(+), 28 deletions(-) diff --git a/source/_components/device_tracker.owntracks_http.markdown b/source/_components/device_tracker.owntracks_http.markdown index cadf1f4589..64df68dd04 100644 --- a/source/_components/device_tracker.owntracks_http.markdown +++ b/source/_components/device_tracker.owntracks_http.markdown @@ -32,7 +32,7 @@ Open OwnTracks and go to Connection preferences: - Mode: Select **Private HTTP** - Host: [Home Assistant URL]:[port]/api/owntracks/[your name]/[device name] - Identification: Turn **Authentication** on, username `homeassistant` and password is your API password that you use to login to Home Assistant. - + Host example: If I host my Home Assistant at `https://example.duckdns.org`, my name is Paulus and my phone is a Pixel I would set the host to be `https://example.duckdns.org/api/owntracks/paulus/pixel`. This will result in an entity with an ID of `device_tracker.paulus_pixel`. You can pick any name for the user and the device. Since the battery data is available as an attribute of the device tracker entity, it can be tracked with a [`template` sensor](/components/sensor.template/). @@ -47,17 +47,6 @@ sensor: friendly_name: Pixel of Paulus unit_of_measurement: "%" value_template: '{{ states.device_tracker.paulus_pixel.attributes.battery|int }}' - icon_template: >- - {% set battery_level = states.device_tracker.paulus_pixel.attributes.battery|default(0)|int %} - {% set battery_round = (battery_level / 10) |int * 10 %} - {% if battery_round >= 100 %} - mdi:battery - {% elif battery_round > 0 %} - mdi:battery-{{ battery_round }} - {% else %} - mdi:battery-alert - {% endif %} - entity_id: - - device_tracker.paulus_pixel + device_class: battery ``` {% endraw %} diff --git a/source/_components/sensor.template.markdown b/source/_components/sensor.template.markdown index 9d1ec23a0c..8ef5a5dc44 100644 --- a/source/_components/sensor.template.markdown +++ b/source/_components/sensor.template.markdown @@ -69,6 +69,11 @@ sensor: description: Defines a template for the entity picture of the sensor. required: false type: template + device_class: + description: The type/class of the sensor to set the icon in the frontend. + required: false + type: device_class + default: None {% endconfiguration %} ## {% linkable_title Considerations %} diff --git a/source/_cookbook/track_battery_level.markdown b/source/_cookbook/track_battery_level.markdown index b623f46b04..13eca37354 100644 --- a/source/_cookbook/track_battery_level.markdown +++ b/source/_cookbook/track_battery_level.markdown @@ -12,7 +12,7 @@ ha_category: Automation Examples ### {% linkable_title iOS Devices %} -If you have a device running iOS (iPhone, iPad, etc), The [iCloud](/components/device_tracker.icloud/) is gathering various details about your device including the battery level. To display it in the Frontend use a [template sensor](/components/sensor.template/). You can also use the icon template option to create a dynamic icon that changes with the battery level. +If you have a device running iOS (iPhone, iPad, etc), The [iCloud](/components/device_tracker.icloud/) is gathering various details about your device including the battery level. To display it in the Frontend use a [template sensor](/components/sensor.template/). You can also the `battery` [sensor device class](/components/sensor/#device-class) to dynamically change the icon with the battery level. {% raw %} ```yaml @@ -21,8 +21,6 @@ sensor: sensors: battery_iphone: friendly_name: iPhone Battery - # "entity_id:" ensures that this sensor will only update when your device tracker does. - entity_id: device_tracker.iphone unit_of_measurement: '%' value_template: >- {%- if states.device_tracker.iphone.attributes.battery %} @@ -30,21 +28,10 @@ sensor: {% else %} {{ states.sensor.battery_iphone.state }} {%- endif %} - icon_template: > - {% set battery_level = states.sensor.battery_iphone.state|default(0)|int %} - {% set battery_round = (battery_level / 10) |int * 10 %} - {% if battery_round >= 100 %} - mdi:battery - {% elif battery_round > 0 %} - mdi:battery-{{ battery_round }} - {% else %} - mdi:battery-alert - {% endif %} + device_class: battery ``` {% endraw %} -The `else` part is used to have the sensor keep its last state if the newest [iCloud](/components/device_tracker.icloud/) update doesn't have any battery state in it (which happens sometimes). Otherwise the sensor will be blank. - ### {% linkable_title Android and iOS Devices %} While running the [Owntracks](/components/device_tracker.owntracks/) device tracker you can retrieve the battery level with a MQTT sensor. Replace username with your MQTT username (for the embedded MQTT it's simply homeassistant), and deviceid with the set Device ID in Owntracks. @@ -57,5 +44,6 @@ sensor: name: "Battery Tablet" unit_of_measurement: "%" value_template: '{{ value_json.batt }}' + device_class: battery ``` {% endraw %} From 76b908b033359661a5db2b39b61391c4833e369a Mon Sep 17 00:00:00 2001 From: Otto Winter Date: Tue, 1 May 2018 22:25:45 +0200 Subject: [PATCH 199/241] Sensor device class docs (#5219) * Sensor device class docs * Fix binary_sensor copy * Fix headings * Add icons screenshot * Add Empty device_class * Grammar * Update customizing-devices.markdown * Add periods --- plugins/configuration.rb | 2 +- source/_components/binary_sensor.markdown | 2 ++ source/_components/sensor.markdown | 14 +++++++++++++- .../configuration/customizing-devices.markdown | 3 ++- .../screenshots/sensor_device_classes_icons.png | Bin 0 -> 15305 bytes 5 files changed, 18 insertions(+), 3 deletions(-) create mode 100644 source/images/screenshots/sensor_device_classes_icons.png diff --git a/plugins/configuration.rb b/plugins/configuration.rb index 52bcf87fb9..30a5196d72 100644 --- a/plugins/configuration.rb +++ b/plugins/configuration.rb @@ -2,7 +2,7 @@ module Jekyll class ConfigurationBlock < Liquid::Block TYPE_LINKS = { 'action' => '/docs/scripts/', - 'device_class' => '/components/%{component}/#device_class', + 'device_class' => '/components/%{component}/#device-class', 'template' => '/docs/configuration/templating/', } diff --git a/source/_components/binary_sensor.markdown b/source/_components/binary_sensor.markdown index 5826f9c147..fe8f4a5107 100644 --- a/source/_components/binary_sensor.markdown +++ b/source/_components/binary_sensor.markdown @@ -11,6 +11,8 @@ footer: true Binary sensors gather information about the state of devices which have a "digital" return value (either 1 or 0). These can be switches, contacts, pins, etc. These sensors only have two states: **0/off/low/closed/false** and **1/on/high/open/true**. Knowing that there are only two states allows Home Assistant to represent these sensors in a better way in the frontend according to their functionality. +### {% linkable_title Device Class %} + The way these sensors are displayed in the frontend can be modified in the [customize section](/getting-started/customizing-devices/). The following device classes are supported for binary sensors: - **None**: Generic on/off. This is the default and doesn't need to be set. diff --git a/source/_components/sensor.markdown b/source/_components/sensor.markdown index 57ee8300bb..d973c2442e 100644 --- a/source/_components/sensor.markdown +++ b/source/_components/sensor.markdown @@ -9,8 +9,20 @@ sharing: true footer: true --- -Sensors are gathering information about states and conditions. +Sensors are gathering information about states and conditions. Home Assistant currently supports a wide range of sensors. They are able to display information which are provides by Home Assistant directly, are gathered from web services, and, of course, physical devices. Please check the sidebar for a full list of supported sensor platforms. +### {% linkable_title Device Class %} +The way these sensors are displayed in the frontend can be modified in the [customize section](/docs/configuration/customizing-devices/). The following device classes are supported for sensors: + +- **None**: Generic sensor. This is the default and doesn't need to be set. +- **battery**: Percentage of battery that is left. +- **humidity**: Percentage of humidity in the air. +- **temperature**: Temperature in °C or °F. + +

    + +Example of various device class icons for sensors. +

    diff --git a/source/_docs/configuration/customizing-devices.markdown b/source/_docs/configuration/customizing-devices.markdown index c3cc8cc441..a76c1ed2aa 100644 --- a/source/_docs/configuration/customizing-devices.markdown +++ b/source/_docs/configuration/customizing-devices.markdown @@ -71,9 +71,10 @@ homeassistant: ### {% linkable_title Device Class %} -Device class is currently supported by the following platforms: +Device class is currently supported by the following components: * [Binary Sensor](/components/binary_sensor/) +* [Sensor](/components/sensor/) * [Cover](/components/cover/) ### {% linkable_title Reloading customize %} diff --git a/source/images/screenshots/sensor_device_classes_icons.png b/source/images/screenshots/sensor_device_classes_icons.png new file mode 100644 index 0000000000000000000000000000000000000000..58e115250ca2630b6c0738f3301c65152b60787e GIT binary patch literal 15305 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 U36jH=e^y9dR^?-jv{}f10Xu Date: Tue, 1 May 2018 22:26:02 +0200 Subject: [PATCH 200/241] MQTT Sensor Device Class Docs (#5252) * MQTT Sensor Device Class * Remove formatting * Other small fix --- source/_components/sensor.mqtt.markdown | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index 5f36c9de1d..b6e5c4b0d2 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -81,9 +81,14 @@ json_attributes: reqired: false type: list, string unique_id: - description: "An id that uniquely identifies this sensor. If 2 sensors have the same unique id, Home Assistant will raise an exception.**" + description: "An ID that uniquely identifies this sensor. If two sensors have the same unique ID, Home Assistant will raise an exception." required: false type: string +device_class: + description: The type/class of the sensor to set the icon in the frontend. + required: false + type: device_class + default: None {% endconfiguration %} ## {% linkable_title Examples %} From 851f0f29ddeafd21690016962a73e38abd8a7a30 Mon Sep 17 00:00:00 2001 From: GoSpursGoNL Date: Tue, 1 May 2018 22:42:15 +0200 Subject: [PATCH 201/241] Update deconz.markdown I found that the credentials are no longer stored in deconz.conf but instead in .config_entries.json --- source/_components/deconz.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/deconz.markdown b/source/_components/deconz.markdown index ad79ab5225..d1fde01521 100644 --- a/source/_components/deconz.markdown +++ b/source/_components/deconz.markdown @@ -34,7 +34,7 @@ ha_iot_class: "Local Push" Home Assistant will automatically discover deCONZ presence on your network, if `discovery:` is present in your `configuration.yaml` file. -If you don't have the API key, you can generate an API key for deCONZ by using the one-click functionality similar to Philips Hue. Go to **Menu** -> **Settings** -> **Unlock Gateway** in deCONZ and then use the deCONZ configurator in Home Assistant frontend to create an API key. When you've generated the API key from Home Assistant, the API key will be stored in `deconz.conf` inside the `.homeassistant` folder. +If you don't have the API key, you can generate an API key for deCONZ by using the one-click functionality similar to Philips Hue. Go to **Menu** -> **Settings** -> **Unlock Gateway** in deCONZ and then use the deCONZ configurator in Home Assistant frontend to create an API key. When you've generated the API key from Home Assistant, the API key will be stored in `.config_entries.json` inside the `.homeassistant` folder. You can add the following to your configuration.yaml file if you are not using the `discovery:` component: From fd5f1fc725042a4226526821b2531ae9f5cf45a9 Mon Sep 17 00:00:00 2001 From: giangvo Date: Thu, 3 May 2018 12:39:04 +1000 Subject: [PATCH 202/241] add document for fan template (#5296) --- source/_components/fan.template.markdown | 96 ++++++++++++++++++++++++ 1 file changed, 96 insertions(+) create mode 100644 source/_components/fan.template.markdown diff --git a/source/_components/fan.template.markdown b/source/_components/fan.template.markdown new file mode 100644 index 0000000000..2b7a984508 --- /dev/null +++ b/source/_components/fan.template.markdown @@ -0,0 +1,96 @@ +--- +layout: page +title: "Template Fan" +description: "Instructions how to setup the Template fans within Home Assistant." +date: 2018-05-03 09:00 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: Fan +ha_release: 0.69 +ha_iot_class: "Local Push" +logo: home-assistant.png +--- + +The `template` platform creates fans that combine components and provides the +ability to run scripts or invoke services for each of the turn_on, turn_off, set_speed, and +set_oscillating commands of a fan. + +To enable Template Fans in your installation, add the following to your +`configuration.yaml` file: + +{% raw %} +```yaml +# Example configuration.yaml entry +fan: + - platform: template + fans: + bedroom_fan: + friendly_name: "Bedroom fan" + value_template: "{{ states('input_boolean.state') }}" + speed_template: "{{ states('input_select.speed') }}" + oscillating_template: "{{ states('input_select.osc') }}" + turn_on: + service: script.fan_on + turn_off: + service: script.fan_off + set_speed: + service: script.fan_speed + data_template: + speed: "{{ speed }}" + set_oscillating: + service: script.fan_oscillating + data_template: + oscillating: "{{ oscillating }}" + speeds: + - '1' + - '2' + - '3' +``` +{% endraw %} + +{% configuration %} + fans: + description: List of your fans. + required: true + type: map + keys: + friendly_name: + description: Name to use in the frontend. + required: false + type: string + value_template: + description: "Defines a template to get the state of the fan. Valid value: 'on'/'off' + required: true + type: template + speed_template: + description: Defines a template to get the speed of the fan. + required: false + type: template + oscillating_template: + description: Defines a template to get the osc state of the fan. Valid value: True/False + required: false + type: template + turn_on: + description: Defines an action to run when the fan is turned on. + required: true + type: action + turn_off: + description: Defines an action to run when the fan is turned off. + required: true + type: action + set_speed: + description: Defines an action to run when the fan is given a speed command. + required: false + type: action + set_oscillating: + description: Defines an action to run when the fan is given a osc state command. + required: false + type: action + speeds: + description: List of speeds the fan is capable of running at. + required: false + type: string list + default: ['low', 'medium', 'high'] +{% endconfiguration %} From 39720a4de26328632d1ec34d7d6e51ed4faadafc Mon Sep 17 00:00:00 2001 From: Ian Date: Thu, 3 May 2018 07:23:52 -0500 Subject: [PATCH 203/241] Create configuration_yaml_by_apocrathia.markdown (#5291) Adding my own Home Assistant configuration repository to the cookbook. --- .../configuration_yaml_by_apocrathia.markdown | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 source/_cookbook/configuration_yaml_by_apocrathia.markdown diff --git a/source/_cookbook/configuration_yaml_by_apocrathia.markdown b/source/_cookbook/configuration_yaml_by_apocrathia.markdown new file mode 100644 index 0000000000..6ac2ccd329 --- /dev/null +++ b/source/_cookbook/configuration_yaml_by_apocrathia.markdown @@ -0,0 +1,12 @@ +--- +layout: page +title: "Configuration.yaml by Apocrathia" +description: "" +date: 2018-05-02 12:40 +sidebar: true +comments: false +sharing: true +footer: true +ha_category: Example configuration.yaml +ha_external_link: https://github.com/Apocrathia/home-assistant-config/ +--- From 8f8e2e9a3dc60c9eb8fdf72382e4a0127ec51d6d Mon Sep 17 00:00:00 2001 From: Greg Stevenson Date: Thu, 3 May 2018 13:29:43 +0100 Subject: [PATCH 204/241] Update URL to Lets Encrypt blog (#5295) The current link takes you to a page which tells you it is outdated. --- .../ecosystem/certificates/tls_self_signed_certificate.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown b/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown index d7c145fe8b..2aab9deb6d 100644 --- a/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown +++ b/source/_docs/ecosystem/certificates/tls_self_signed_certificate.markdown @@ -11,7 +11,7 @@ redirect_from: /cookbook/tls_self_signed_certificate/ --- 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]({{site_root}}/blog/2015/12/13/setup-encryption-using-lets-encrypt/) will only work if you have a DNS entry and remote access is allowed. +[Let's encrypt]({{site_root}}/blog/2017/09/27/effortless-encryption-with-lets-encrypt-and-duckdns/) 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 complain about the security. If you have a CA then this will not be an issue. To create a certificate locally, you need the [OpenSSL](https://www.openssl.org/) command-line tool. From 04a3b83a53b80ed58678209aa890ea291631bcfe Mon Sep 17 00:00:00 2001 From: Tod Schmidt Date: Thu, 3 May 2018 14:21:34 -0400 Subject: [PATCH 205/241] Update snips.markdown (#5293) * Update snips.markdown Added new examples and link to discord and new documentation * Update snips.markdown * Fix formatting --- source/_components/snips.markdown | 94 ++++++++++++++++++++++++++----- 1 file changed, 81 insertions(+), 13 deletions(-) diff --git a/source/_components/snips.markdown b/source/_components/snips.markdown index da7ed21417..cc2aa3248c 100644 --- a/source/_components/snips.markdown +++ b/source/_components/snips.markdown @@ -2,7 +2,7 @@ layout: page title: "Snips" description: "Instructions on how to integrate Snips within Home Assistant." -date: 2017-06-22 12:00 +date: 2018-05-02 12:00 sidebar: true comments: false sharing: true @@ -14,7 +14,7 @@ ha_release: 0.48 The [Snips Voice Platform](https://www.snips.ai) allows users to add powerful voice assistants to their Raspberry Pi devices without compromising on privacy. It runs 100% on-device, and does not require an internet connection. It features Hotword Detection, Automatic Speech Recognition (ASR), Natural Language Understanding (NLU) and Dialog Management. -The latest documentation can be found here: [Snips Platform Documentation](https://github.com/snipsco/snips-platform-documentation/wiki). +The latest documentation can be found here: [Snips Platform Documentation](https://snips.gitbook.io/documentation/). ![Snips Modules](/images/screenshots/snips_modules.png) @@ -166,11 +166,11 @@ SetTimer: ``` {% endraw %} -### Sending TTS Notifications +### {% linkable_title Sending TTS Notifications %} You can send TTS notifications to Snips using the snips.say and snips.say_action services. Say_action starts a session and waits for user response, "Would you like me to close the garage door?", "Yes, close the garage door". -#### {% linkable_title Service `snips/say` %} +#### {% linkable_title Service `snips.say` %} | Service data attribute | Optional | Description | |------------------------|----------|--------------------------------------------------------| @@ -178,7 +178,7 @@ You can send TTS notifications to Snips using the snips.say and snips.say_action | `site_id` | yes | Site to use to start session. | | `custom_data` | yes | custom data that will be included with all messages in this session. | -#### {% linkable_title Service `snips/say_action` %} +#### {% linkable_title Service `snips.say_action` %} | Service data attribute | Optional | Description | |------------------------|----------|--------------------------------------------------------| @@ -188,19 +188,48 @@ You can send TTS notifications to Snips using the snips.say and snips.say_action | `can_be_enqueued` | yes | If True, session waits for an open session to end, if False session is dropped if one is running. | | `intent_filter` | yes | Array of Strings - A list of intents names to restrict the NLU resolution to on the first query. | -#### Configuration Examples + +### {% linkable_title Snips Support %} + +There is an active [discord](https://discordapp.com/invite/3939Kqx) channel for further support. + +### {% linkable_title Configuration Examples %} + +#### {% linkable_title Turn on a light %} ```yaml -script: +intent_script: turn_on_light: - sequence: - service: script.turn_on_light - service: snips.say - data: - text: 'OK, the light is now on' + speech: + type: plain + text: 'OK, closing the garage door' + action: + service: light.turn_on +``` +##### {% linkable_title Open a Garage Door %} + +```yaml +intent_script: + OpenGarageDoor: + speech: + type: plain + text: 'OK, opening the garage door' + action: + - service: cover.open_cover + data: + entity_id: garage_door +``` + +##### {% linkable_title Intiating a query %} + +Here is a more complex example. The automation is triggered if the garage door is open for more than 10 minutes. +Snips will then ask you if you want to close it and if you respond with something like "Close the garage door" it +will do so. Unfortunately there is no builtin support for yes and no responses. + +```yaml automation: - query_garage_door: + garage_door_has_been_open: trigger: - platform: state entity_id: binary_sensor.my_garage_door_sensor @@ -224,3 +253,42 @@ intent_script: action: - service: script.garage_door_close ``` + +##### {% linkable_title Weather %} + +So now you can open and close your garage door, let's check the weather. Add the Weather by Snips Skill to your assistant. + +Create a weather sensor, in this example (Dark Sky)[/components/sensor.darksky/] and the api_key in the secrets file. + +```yaml +- platform: darksky + name: "Dark Sky Weather" + api_key: !secret dark_sky_key + update_interval: + minutes: 10 + monitored_conditions: + - summary + - hourly_summary + - temperature + - temperature_max + - temperature_min +``` + +Then create this intent_script.yaml file in your config directory + +{% raw %} +```yaml +intent_script: + searchWeatherForecast: + speech: + type: plain + text: > + The weather is currently + {{ states('sensor.dark_sky_weather_temperature') | round(0) }} + degrees outside and {{ states('sensor.dark_sky_weather_summary') }}. + The high today will be + {{ states('sensor.dark_sky_weather_daily_high_temperature') | round(0)}} + and {{ states('sensor.dark_sky_weather_hourly_summary') }} +``` +{% endraw %} + From b3288f13cdb66aae8fde8580ac4935acb3c9d859 Mon Sep 17 00:00:00 2001 From: Louis Orleans Date: Thu, 3 May 2018 12:00:02 -0700 Subject: [PATCH 206/241] Add specific instructions for Meraki device tracker (#5297) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * 📝 add specific instructions for Meraki device tracker The current instructions aren't really complete, and require you to have both an understanding of how the Home Assistant API works, as well as be able to read through the code for the Meraki component to find the API endpoint you're supposed to use. * Update formatting --- .../device_tracker.meraki.markdown | 22 ++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/source/_components/device_tracker.meraki.markdown b/source/_components/device_tracker.meraki.markdown index a88aa1d713..cbe481d39e 100644 --- a/source/_components/device_tracker.meraki.markdown +++ b/source/_components/device_tracker.meraki.markdown @@ -11,8 +11,21 @@ logo: meraki.png ha_category: Presence Detection ha_release: "0.60" --- -Use your `Meraki AP` as device tracker. Note that Meraki will see all devices, not only connected to the network. -Follow instructions [here](https://meraki.cisco.com/technologies/location-analytics-api) how to enable Location Analytics. + +Use your Meraki AP as device tracker. Note that Meraki will see all devices, not only connected to the network. + +### {% linkable_title Prerequisites %} + +1. Go to Network-wide/General page, and find the Location and scanning section. +1. Make sure analytics and Scanning API are both enabled. +1. Make note of the Validator string, which will be used in the `device_tracker` configuration. +1. Click **Add a Post URL**: + 1. Set the Post URL to `https://YOUR_HOSTNAME/api/meraki?api_password=YOUR_HASS_PASSWORD` + 1. Set the Secret to a randomly generated string, and make note of it for the `device_tracker` configuration. + 1. Make sure the API Version is set to `2.0`. + 1. Hit **Save** in the bottom right of the page. + +## {% linkable_title Configuration %} After you configure access to the Meraki CMX API, add the following to your `configuration.yaml` file: @@ -24,14 +37,13 @@ device_tracker: validator: meraki_validator ``` - {% configuration %} secret: - description: Secret code added in Meraki + description: Secret code added in Meraki. required: true type: string validator: - description: Validation string from Meraki + description: Validation string from Meraki. required: true type: string {% endconfiguration %} From fe352e7dd60558a9292bfd2453da86793b6743ac Mon Sep 17 00:00:00 2001 From: escoand Date: Thu, 3 May 2018 21:00:17 +0200 Subject: [PATCH 207/241] Add description of discovery (#5286) * Add description of discovery * Fix copy&paste * Update link --- source/_components/media_player.volumio.markdown | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/source/_components/media_player.volumio.markdown b/source/_components/media_player.volumio.markdown index f8945adc88..26053822e8 100644 --- a/source/_components/media_player.volumio.markdown +++ b/source/_components/media_player.volumio.markdown @@ -12,12 +12,11 @@ ha_category: Media Player ha_release: 0.41 --- -The `Volumio` platform allows you to control a [Volumio](http://volumio.org) media player -from Home Assistant. +The `Volumio` platform allows you to control a [Volumio](http://volumio.org) media player from Home Assistant. +The preferred way to set up the Volumio platform is by enabling the [discovery component](/components/discovery/). -To add a Volumio player to your installation, add the following to -your `configuration.yaml` file. +In case the discovery does not work, or you need specific configuration variables, you can add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry From bc01c98712599057c74dbb08555e0f91848dd096 Mon Sep 17 00:00:00 2001 From: Robin Date: Thu, 3 May 2018 20:05:52 +0100 Subject: [PATCH 208/241] Adds info on whitelist_external_dirs (#5213) whitelist_external_dirs needs to be mentioned --- source/_components/folder_watcher.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_components/folder_watcher.markdown b/source/_components/folder_watcher.markdown index 88b19937e0..df9041ed35 100644 --- a/source/_components/folder_watcher.markdown +++ b/source/_components/folder_watcher.markdown @@ -13,13 +13,14 @@ ha_iot_class: "Local Polling" ha_release: 0.67 --- -This component adds [Watchdog](https://pythonhosted.org/watchdog/) file system monitoring, publishing events on the Home Assistant bus on the creation/deletion/modification of files. The monitored `event_type` are: +This component adds [Watchdog](https://pythonhosted.org/watchdog/) file system monitoring, publishing events on the Home Assistant bus on the creation/deletion/modification of files within configured folders. The monitored `event_type` are: + * `created` * `deleted` * `modified` * `moved` -Note that by default folder monitoring is recursive, meaning that the contents of sub-folders are also monitored. +Configured folders must be added to [whitelist_external_dirs](/docs/configuration/basic/). Note that by default folder monitoring is recursive, meaning that the contents of sub-folders are also monitored. To enable the Folder Watcher component in your installation, add the following to your `configuration.yaml` file: From 334a06b4d666c5880c08703e9e8d0b9b0804a60b Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 3 May 2018 22:01:32 +0200 Subject: [PATCH 209/241] Various fixes (#5302) --- .../alarm_control_panel.alarmdecoder.markdown | 4 +- .../_components/binary_sensor.hive.markdown | 9 +-- .../_components/binary_sensor.random.markdown | 2 + .../binary_sensor.workday.markdown | 2 +- source/_components/calendar.google.markdown | 6 +- source/_components/climate.hive.markdown | 12 ++-- source/_components/google_assistant.markdown | 2 + source/_components/hive.markdown | 6 +- source/_components/light.hive.markdown | 11 ++-- .../_components/media_player.onkyo.markdown | 2 + source/_components/notify.clicksend.markdown | 5 +- source/_components/sensor.hive.markdown | 9 +-- source/_components/sensor.sht31.markdown | 2 + .../sensor.thethingsnetwork.markdown | 4 ++ source/_components/switch.hive.markdown | 7 ++- source/_components/switch.rainbird.markdown | 2 + source/_components/switch.rest.markdown | 4 +- source/_components/tts.amazon_polly.markdown | 63 ++++++++++++++----- 18 files changed, 106 insertions(+), 46 deletions(-) diff --git a/source/_components/alarm_control_panel.alarmdecoder.markdown b/source/_components/alarm_control_panel.alarmdecoder.markdown index 476773df3e..98810aaa2a 100644 --- a/source/_components/alarm_control_panel.alarmdecoder.markdown +++ b/source/_components/alarm_control_panel.alarmdecoder.markdown @@ -27,7 +27,9 @@ The Alarm Decoder component gives you access to several services for you to cont - `alarm_disarm`: Disarms the alarm from any state. Also clears a `check_zone` flag after an alarm was triggered. - `alarmdecoder_alarm_toggle_chime`: Toggles the alarm's chime state. -**Note**: `alarm_arm_custom_bypass` and `alarm_trigger`, while available in the services list in Home Assistant, are not currently implemented in the Alarm Decoder component. +

    +`alarm_arm_custom_bypass` and `alarm_trigger`, while available in the services list in Home Assistant, are not currently implemented in the Alarm Decoder platform. +

    ### {% linkable_title Attributes %} diff --git a/source/_components/binary_sensor.hive.markdown b/source/_components/binary_sensor.hive.markdown index ffba6e29d1..49486d62d7 100644 --- a/source/_components/binary_sensor.hive.markdown +++ b/source/_components/binary_sensor.hive.markdown @@ -14,11 +14,12 @@ ha_iot_class: "Cloud Polling" --- -The 'hive' binary sensor component integrates your Hive sensors into Home Assistant. +The `hive` binary sensor component integrates your Hive sensors into Home Assistant. -The Hive binary sensor component supports the following Hive products: -- **Hive Window or Door Sensor** -- **Hive Motion Sensor** +The platform supports the following Hive products: + +- Hive Window or Door Sensor +- Hive Motion Sensor

    diff --git a/source/_components/binary_sensor.random.markdown b/source/_components/binary_sensor.random.markdown index d8a0129120..b1208681a8 100644 --- a/source/_components/binary_sensor.random.markdown +++ b/source/_components/binary_sensor.random.markdown @@ -16,6 +16,8 @@ ha_release: 0.57 The `random` binary sensor platform is creating random states (`True`, 1, `on` or `False`, 0, `off`). This can be useful if you want to test automation rules. It generates a new state every time it is polled. +## {% linkable_title Configuration %} + To enable the random binary sensor, add the following lines to your `configuration.yaml`: ```yaml diff --git a/source/_components/binary_sensor.workday.markdown b/source/_components/binary_sensor.workday.markdown index b63d8f778d..1ba1f8bd8c 100644 --- a/source/_components/binary_sensor.workday.markdown +++ b/source/_components/binary_sensor.workday.markdown @@ -26,7 +26,7 @@ To enable the `workday` sensor in your installation, add the following to your ` binary_sensor: - platform: workday country: DE - workdays: [ mon, wed, fri ] + workdays: [mon, wed, fri] ``` Configuration variables: diff --git a/source/_components/calendar.google.markdown b/source/_components/calendar.google.markdown index 5999dc48ac..9825c5f9cc 100644 --- a/source/_components/calendar.google.markdown +++ b/source/_components/calendar.google.markdown @@ -16,7 +16,7 @@ ha_release: 0.33 The `google` calendar platform allows you to connect to your [Google Calendars](https://calendar.google.com) and generate binary sensors. The sensors created can trigger based on any event on the calendar or only for matching events. When you first setup this component it will generate a new configuration file `google_calendars.yaml` that will contain information about all of the calendars you can see. -### {% linkable_title Prerequisites %} +## {% linkable_title Prerequisites %} Generate a Client ID and Client Secret on [Google Developers Console](https://console.developers.google.com/start/api?id=calendar). @@ -30,7 +30,7 @@ Generate a Client ID and Client Secret on [Google Developers Console](https://co 1. Save the client ID and secret as you will need to put these in your `configuration.yaml` file. 1. Click on "Library", search for "Google Calendar API" and enable it. -### {% linkable_title Basic Setup %} +## {% linkable_title Configuration %} To integrate Google Calendar in Home Assistant, add the following section to your `configuration.yaml` file: @@ -61,7 +61,7 @@ The next steps will require you to have Home Assistant running. After you have it running complete the Google authentication that pops up. It will give you a URL and a code to enter. This will grant your Home Assistant service access to all the Google Calendars that the account you authenticate with can read. This is a Read-Only view of these calendars. -### {% linkable_title Calendar Configuration %} +## {% linkable_title Calendar Configuration %} Editing the `google_calendars.yaml` file. diff --git a/source/_components/climate.hive.markdown b/source/_components/climate.hive.markdown index dd3fd41ca5..12f4688553 100644 --- a/source/_components/climate.hive.markdown +++ b/source/_components/climate.hive.markdown @@ -14,13 +14,15 @@ ha_iot_class: "Cloud Polling" --- -The 'hive' climate component integrates your Hive thermostat and hot water into Home Assistant, enabling control of setting the **mode** and setting the **target temperature**. +The `hive` climate platform integrates your Hive thermostat and hot water into Home Assistant, enabling control of setting the **mode** and setting the **target temperature**. + A short boost for Hive Heating or Hive Hot water can be set by using the **Aux Heat** function, this will turn on the boost feature for Hive Heating or Hive Hot water for 30 minutes at 0.5 degrees higher than the current temperature. -The Hive climate component supports the following Hive products: -- **Hive Active Heating** -- **Hive Multizone** -- **Hot water control** +The platform supports the following Hive products: + +- Hive Active Heating +- Hive Multizone +- Hot water control

    diff --git a/source/_components/google_assistant.markdown b/source/_components/google_assistant.markdown index f196288c7a..edd0b8ebb1 100644 --- a/source/_components/google_assistant.markdown +++ b/source/_components/google_assistant.markdown @@ -25,6 +25,8 @@ The Google Assistant component requires a bit more setup than most due to the wa To use Google Assistant, your Home Assistant configuration has to be externally accessible with a hostname and SSL certificate. If you haven't already configured that, you should do so before continuing.

    +## {% linkable_title Configuration %} + To enable this, add the following lines to your `configuration.yaml` file: ```yaml diff --git a/source/_components/hive.markdown b/source/_components/hive.markdown index fbe0d5b17f..16f2a77ac4 100644 --- a/source/_components/hive.markdown +++ b/source/_components/hive.markdown @@ -14,11 +14,13 @@ ha_iot_class: "Cloud Polling" --- -This Hive component is the main component to set up and integrate all supported Hive devices. Once configured with the minimum required details it will detect and add all your Hive devices into Home Assistant, including support for multizone heating. +The `hive` component is the main component to set up and integrate all supported Hive devices. Once configured with the minimum required details it will detect and add all your Hive devices into Home Assistant, including support for multizone heating. This component uses the unofficial API used in the official Hive website [https://my.hivehome.com](https://my.hivehome.com), and you will need to use the same Username and Password you use on the Hive website to configure this Hive component in Home Assistant. -To add your Hive devices into your Home Assistant installation, using the default scan_interval, add the following to your 'configuration.yaml' file: + + +To add your Hive devices into your Home Assistant installation, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry diff --git a/source/_components/light.hive.markdown b/source/_components/light.hive.markdown index 78daeb5641..44221f6371 100644 --- a/source/_components/light.hive.markdown +++ b/source/_components/light.hive.markdown @@ -14,12 +14,13 @@ ha_iot_class: "Cloud Polling" --- -The 'hive' light component integrates your Hive lights into Home Assistant, enabling control of various settings, depending on the model light. +The `hive` light platform integrates your Hive lights into Home Assistant, enabling control of various settings, depending on the model light. -The Hive light component supports the following Hive products: -- **Hive Active Light Dimmable** -- **Hive Active Light Cool to Warm White** -- **Hive Active Light Color Changing** +The platform supports the following Hive products: + +- Hive Active Light Dimmable +- Hive Active Light Cool to Warm White +- Hive Active Light Color Changing

    diff --git a/source/_components/media_player.onkyo.markdown b/source/_components/media_player.onkyo.markdown index 0c6dc4d2d3..13a50152dc 100644 --- a/source/_components/media_player.onkyo.markdown +++ b/source/_components/media_player.onkyo.markdown @@ -16,6 +16,8 @@ ha_iot_class: "Local Polling" The `onkyo` platform allows you to control a [Onkyo](http://www.onkyo.com/) and some recent [Pioneer](http://www.pioneerelectronics.com) receivers from Home Assistant. Please be aware that you need to enable "Network Standby" for this component to work in your Hardware. +## {% linkable_title Configuration %} + To add an Onkyo or Pioneer receiver to your installation, add the following to your `configuration.yaml` file: ```yaml diff --git a/source/_components/notify.clicksend.markdown b/source/_components/notify.clicksend.markdown index a5f9d587fd..8d619617b4 100644 --- a/source/_components/notify.clicksend.markdown +++ b/source/_components/notify.clicksend.markdown @@ -15,9 +15,12 @@ ha_release: 0.48 The `clicksend` platform uses [ClickSend](https://clicksend.com) to deliver notifications from Home Assistant. -### Get your ClickSend API Credentials +## {% linkable_title Prerequisites %} + Go to your [ClickSend Dashboard](https://dashboard.clicksend.com) section and create your new project. After creating your project, you should now be able to obtain your `username` and `api_key`. +## {% linkable_title Configuration %} + To add ClickSend to your installation, add the following to your Home Assistant `configuration.yaml` file: ```yaml diff --git a/source/_components/sensor.hive.markdown b/source/_components/sensor.hive.markdown index 4fa0221f31..0d4d087516 100644 --- a/source/_components/sensor.hive.markdown +++ b/source/_components/sensor.hive.markdown @@ -14,11 +14,12 @@ ha_iot_class: "Cloud Polling" --- -The 'hive' sensor component exposes hive data as a sensor. +The `hive` sensor component exposes Hive data as a sensor. -The Hive sensor component exposes the following sensors: -- **Hive Hub Online Status** -- **Hive Outside Temperature** +The platform exposes the following sensors: + +- Hive Hub Online Status +- Hive Outside Temperature

    Full configuration details can be found on the main [Hive component](/components/hive/) page. diff --git a/source/_components/sensor.sht31.markdown b/source/_components/sensor.sht31.markdown index 73660bbbdc..7adbfc2cee 100644 --- a/source/_components/sensor.sht31.markdown +++ b/source/_components/sensor.sht31.markdown @@ -15,6 +15,8 @@ ha_iot_class: "Local Polling" The `sht31` sensor platform allows you to get the current temperature and humidity from a Sensirion SHT31 device. +## {% linkable_title Configuration %} + To use your SHT31 sensor in your installation, add the following to your `configuration.yaml` file: ```yaml diff --git a/source/_components/sensor.thethingsnetwork.markdown b/source/_components/sensor.thethingsnetwork.markdown index cce7aad569..faeb8b7e65 100644 --- a/source/_components/sensor.thethingsnetwork.markdown +++ b/source/_components/sensor.thethingsnetwork.markdown @@ -17,6 +17,8 @@ The `thethingsnetwork` sensor platform allows you to get data from a [The Things This platform requires that the [The Things Network component](/components/thethingsnetwork/) is set up and the [The Things Network Storage Integration](https://www.thethingsnetwork.org/docs/applications/storage/) as well. +## {% linkable_title Prerequisites %} + Visit the [The Things Network Console](https://console.thethingsnetwork.org/) website, log in with your The Things Network credentials, choose your application from **Applications** and go to **Integrations**. Add a new integration. @@ -54,6 +56,8 @@ Select **Devices** to get the ID of your device that you want to use. Devices overview

    +## {% linkable_title Configuration %} + To enable this platform, add the following lines to your `configuration.yaml`: ```yaml diff --git a/source/_components/switch.hive.markdown b/source/_components/switch.hive.markdown index 8f7d867722..e4ea483797 100644 --- a/source/_components/switch.hive.markdown +++ b/source/_components/switch.hive.markdown @@ -14,10 +14,11 @@ ha_iot_class: "Cloud Polling" --- -The 'hive' switch component integrates your Hive plugs into Home Assistant, enabling control of your devices. +The `hive` switch platform integrates your Hive plugs into Home Assistant, enabling control of your devices. -The Hive switch component supports the following Hive products: -- **Hive Active Plug** +The platform supports the following Hive products: + +- Hive Active Plug

    diff --git a/source/_components/switch.rainbird.markdown b/source/_components/switch.rainbird.markdown index 6fba9a2f99..673c4d1928 100644 --- a/source/_components/switch.rainbird.markdown +++ b/source/_components/switch.rainbird.markdown @@ -15,6 +15,8 @@ ha_iot_class: "Local Polling" This `rainbird` switch platform allows interacting with [LNK WiFi](http://www.rainbird.com/landscape/products/controllers/LNK-WiFi.htm) module of the Rain Bird Irrigation system in Home Assistant. +## {% linkable_title Configuration %} + Once you have enabled the [Rain Bird component](/components/rainbird), add the following to your `configuration.yaml` file: ```yaml diff --git a/source/_components/switch.rest.markdown b/source/_components/switch.rest.markdown index 79388ff24b..65f0afcd3e 100644 --- a/source/_components/switch.rest.markdown +++ b/source/_components/switch.rest.markdown @@ -15,6 +15,8 @@ ha_iot_class: "Local Polling" The `rest` switch platform allows you to control a given endpoint that supports a [RESTful API](https://en.wikipedia.org/wiki/Representational_state_transfer). The switch can get the state via GET and set the state via POST on a given REST resource. +## {% linkable_title Configuration %} + To enable this switch, add the following lines to your `configuration.yaml` file: ```yaml @@ -93,7 +95,7 @@ switch: resource: http://IP_ADDRESS/led_endpoint body_on: '{"active": "true"}' body_off: '{"active": "false"}' - is_on_template: '{{value_json.is_active}}' + is_on_template: '{{ value_json.is_active }}' headers: Content-Type: application/json ``` diff --git a/source/_components/tts.amazon_polly.markdown b/source/_components/tts.amazon_polly.markdown index 6561bc6d09..8be1fdc0a5 100644 --- a/source/_components/tts.amazon_polly.markdown +++ b/source/_components/tts.amazon_polly.markdown @@ -15,6 +15,8 @@ ha_release: 0.37 The `amazon_polly` text-to-speech platform that works with [Amazon Polly](https://aws.amazon.com/polly/) to create the spoken output. Polly is a paid service via Amazon Web Services. There is a [free tier](https://aws.amazon.com/polly/pricing/) for the first 12 months and then a charge per million characters afterwards. +## {% linkable_title Configuration %} + To get started, add the following lines to your `configuration.yaml` (example for Amazon Polly): ```yaml @@ -23,33 +25,62 @@ tts: - platform: amazon_polly aws_access_key_id: AWS_ACCESS_KEY_ID aws_secret_access_key: AWS_SECRET_ACCESS_KEY - profile_name: AWS_PROFILE - region_name: 'us-east-1' - voice: Joanna ``` -Configuration variables: +{% configuration %} +aws_access_key_id: + description: "Your AWS Access Key ID. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_secret_access_key` and must **not** provide a `profile_name`." + required: true + type: string +aws_secret_access_key: + description: "Your AWS Secret Access Key. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_access_key_id` and must **not** provide a `profile_name`." + required: true + type: string +profile_name: + description: A credentials profile name. For more information, please see the [boto3 Documentation](http://boto3.readthedocs.io/en/latest/guide/configuration.html#shared-credentials-file) for more information. + required: false + type: string +region_name: + description: "The region identifier to connect to. The default is `us-east-1`. See the [AWS Regions and Endpoints Reference](https://docs.aws.amazon.com/general/latest/gr/rande.html#pol_region) for available regions." + required: false + type: string or list +name: + description: "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`." + required: false + type: string +text_type: + description: "Specify wherever to use text (default) or ssml markup by default." + required: false + type: string + default: text +voice: + description: "Voice name to be used. See the [Amazon Documentation](http://docs.aws.amazon.com/polly/latest/dg/voicelist.html) for available voices." + required: false + type: string +output_format: + description: "Override the default output format, e.g., `mp3`, `ogg_vorbis` or `pcm`." + required: false + type: string + default: mp3 +sample_rate: + description: "Override the default sample rate, defaults to 22050 for MP3 and Ogg Vorbis, 16000 for pcm." + required: false + type: string +{% endconfiguration %} -| Parameter | Value | Description | -|---------------------|----------|-------------| -| `aws_access_key_id` | Required | Your AWS Access Key ID. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_secret_access_key` and must **not** provide a `profile_name` | -| `aws_secret_access_key` | Required | Your AWS Secret Access Key. For more information, please read the [AWS General Reference regarding Security Credentials](http://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html). If provided, you must also provide an `aws_access_key_id` and must **not** provide a `profile_name`. | -| `profile_name` | Optional | A credentials profile name. For more information, please see the [boto3 Documentation](http://boto3.readthedocs.io/en/latest/guide/configuration.html#shared-credentials-file) for more information. | -| `region_name` | Optional | The region identifier to connect to. The default is `us-east-1`. See the [AWS Regions and Endpoints Reference](https://docs.aws.amazon.com/general/latest/gr/rande.html#pol_region) for available regions. | -| `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`. | -| `text_type` | text/ssml | text or ssml: Specify wherever to use text (default) or ssml markup by default. | -| `voice` | Optional | Voice name to be used. See the [Amazon Documentation](http://docs.aws.amazon.com/polly/latest/dg/voicelist.html) for available voices. | -| `output_format` | mp3/ogg_vorbis/pcm | Override the default output format, defaults to MP3. | -| `sample_rate` | 8000/16000/22050 | Override the default sample rate, defaults to 22050 for MP3 and Ogg Vorbis, 16000 for pcm. | -## Usage +## {% linkable_title Usage %} + Say to all `media_player` device entities: + ```yaml - service: tts.amazon_polly_say data_template: message: 'Hello from Amazon Polly' ``` + or + ```yaml - service: tts.amazon_polly_say data_template: From d7fcb153de9f791bfbfa83db9ee459498120a94b Mon Sep 17 00:00:00 2001 From: Aaron Bach Date: Thu, 3 May 2018 14:56:01 -0600 Subject: [PATCH 210/241] Adds docs for RainMachine component/hub (#5251) * Adds docs for RainMachine component/hub * Removing references to remote API * Collaborator-requested changes * Adding new info (per home-assistant/home-assistant#14225) * Collaborator-requested changes * Collaborator-requested changes * Revert "Collaborator-requested changes" This reverts commit 34f75ffab911dcd9a9ae3163645c7c6e9dbf54ee. * I think I got it this time... * Collaborator-requested changes * Collaborator-requested changes * Small tweak --- source/_components/rainmachine.markdown | 71 +++++++++++++++ .../_components/switch.rainmachine.markdown | 88 +++---------------- 2 files changed, 85 insertions(+), 74 deletions(-) create mode 100644 source/_components/rainmachine.markdown diff --git a/source/_components/rainmachine.markdown b/source/_components/rainmachine.markdown new file mode 100644 index 0000000000..e416c7f626 --- /dev/null +++ b/source/_components/rainmachine.markdown @@ -0,0 +1,71 @@ +--- +layout: page +title: "RainMachine" +description: "Instructions on how to integrate RainMachine units within Home Assistant." +date: 2018-04-25 20:32 +sidebar: true +comments: false +sharing: true +footer: true +logo: rainmachine.png +ha_category: Hub +ha_release: 0.69 +ha_iot_class: "Cloud Polling" +--- + +The `rainmachine` component is the main component to integrate all platforms +related to [RainMachine smart Wi-Fi sprinkler controllers](http://www.rainmachine.com/). + +## {% linkable_title Base Configuration %} + +To connect to your RainMachine device, add the following to your +`configuration.yaml` file: + +```yaml +rainmachine: + ip_address: 192.168.1.100 + password: YOUR_PASSWORD +``` + +To configure switch-related functionality, add configuration options beneath +a `switches` key within the `rainmachine` sections of `configuration.yaml` +as below: + +```yaml +rainmachine: + ip_address: 192.168.1.100 + password: YOUR_PASSWORD + switches: + # switch configuration options... +``` + +{% configuration %} +ip_address: + description: the IP address or hostname of your RainMachine unit + required: optional + type: string +password: + description: your RainMachine password. + required: true + type: string +port: + description: the TCP port used by your unit for the REST API + required: false + type: int + default: 8080 +ssl: + description: whether communication with the local device should occur over HTTPS + required: false + type: boolean + default: true +switches: + description: switch-related configuration options + required: false + type: map + keys: + zone_run_time: + description: the default number of seconds that a zone should run when turned on + required: false + type: int + default: 600 +{% endconfiguration %} diff --git a/source/_components/switch.rainmachine.markdown b/source/_components/switch.rainmachine.markdown index 26b73e0aa8..f37ce0fbd5 100644 --- a/source/_components/switch.rainmachine.markdown +++ b/source/_components/switch.rainmachine.markdown @@ -13,84 +13,24 @@ ha_iot_class: "Cloud Polling" ha_release: 0.51 --- -The `rainmachine` switch platform allows you to control programs and zones within a [RainMachine smart Wi-Fi sprinkler controller](http://www.rainmachine.com/). - -## {% linkable_title Configuring the Platform %} - -The platform allows for either local (i.e., directly across the LAN) or remote (i.e., through RainMachine's cloud API) access; the route you choose will dictate what your configuration should look like. - -For local access, specify the IP address/hostname of your RainMachine unit, your RainMachine password, and optionally, the device's HTTP port: - -```yaml -switch: - platform: rainmachine - ip_address: 192.168.1.100 - password: YOUR_PASSWORD -``` - -For remote access, specify your RainMachine username/email and password: - -```yaml -switch: - platform: rainmachine - email: user@host.com - password: YOUR_PASSWORD -``` - -{% configuration %} -password: - description: Your RainMachine password. - required: true - type: string -email: - description: "Your RainMachine username/email. Cannot be used with the `ip_address` parameter." - required: false - type: string -ip_address: - description: "The IP address of your RainMachine unit; cannot be used with the `email` parameter." - required: optional - type: string -port: - description: The TCP port used by your unit for the REST API. - required: false - type: int - default: 8080 -ssl: - description: Whether communication with the local device should occur over HTTPS. - required: false - type: boolean - default: true -zone_run_time: - description: The number of seconds that a zone should run when turned on. - required: false - type: int - default: 600 -{% endconfiguration %} +The `rainmachine` switch platform allows you to control programs and zones +within a [RainMachine smart Wi-Fi sprinkler controller](http://www.rainmachine.com/). +

    +You must have the [RainMachine component](https://www.home-assistant.io/components/rainmachine/) +configured to use this switch. After configuring that component, switches will +automatically appear. +

    ## {% linkable_title Controlling Your Device %} -After Home Assistant loads, you will see new switches for every enabled program and zone. These work as expected: +After Home Assistant loads, new switches will be added for every enabled +program and zone. These work as expected: - Program On/Off: starts/stops a program -- Zone On/Off: starts/stops a zone (using the `zone_run_time` parameter to determine how long to run for) +- Zone On/Off: starts/stops a zone (using the `zone_run_time` parameter to +determine how long to run for) -Programs and zones are linked. If a program is running its final zone, you will see both the program and zone switches turned on; turning either one off will turn the other one off (just like in the web app). - -## {% linkable_title Weblink %} - -If you would like to see and control more detailed information, create an [iFrame](/components/panel_iframe/) that renders the RainMachine web app: - -```yaml -panel_iframe: - rainmachine: - title: RainMachine - url: "https://my.rainmachine.com/s//ui/" - icon: mdi:water-pump -``` - -You can find `` by logging into [https://my.rainmachine.com](https://my.rainmachine.com ) and taking note of the URL. - -## {% linkable_title For Awareness %} - -The remote RainMachine API currently has two broken operations (i.e., they return error codes): starting a program and stopping a program. Please note that starting/stopping programs with the remote API is disabled until RainMachine can fix the issue. +Programs and zones are linked. While a program is running, you will see both +the program and zone switches turned on; turning either one off will turn the +other one off (just like in the web app). From f02495713b5b8cfdc9c2169812c602ee69e19e25 Mon Sep 17 00:00:00 2001 From: DubhAd Date: Fri, 4 May 2018 08:19:02 +0100 Subject: [PATCH 211/241] Re-ordered the automation blocks (#5305) The automations were as the editor produces them, so not logically ordered or clear to read. I've re-written them to match the rest of the documentation. --- source/_components/timer.markdown | 25 ++++++++++++------------- 1 file changed, 12 insertions(+), 13 deletions(-) diff --git a/source/_components/timer.markdown b/source/_components/timer.markdown index 9f28b2ec7a..eb6db877f3 100644 --- a/source/_components/timer.markdown +++ b/source/_components/timer.markdown @@ -107,30 +107,29 @@ timer: ```yaml # Example automations.yaml entry -- action: - - service: timer.start - entity_id: timer.test - alias: Timerswitch +- alias: Timerswitch id: 'Timerstart' - -# Timer is started when the switch pumprun is set to on. + # Timer is started when the switch pumprun is set to on. trigger: - platform: state + - platform: state entity_id: switch.pumprun to: 'on' + action: + - service: timer.start + entity_id: timer.test # When timer is stopped, the time run out, another message is sent -- action: - - service: notify.nma - data: - message: "Timer stop" - alias: Timerstop +- alias: Timerstop id: 'Timerstop' trigger: - platform: event + - platform: event event_type: timer.finished event_data: entity_id: timer.test + action: + - service: notify.nma + data: + message: "Timer stop" ``` ### {% linkable_title Control a timer from the frontend %} From 49c697004a4c81e7acec37eea9810c8e0f6b0d1c Mon Sep 17 00:00:00 2001 From: DubhAd Date: Fri, 4 May 2018 08:20:00 +0100 Subject: [PATCH 212/241] Added explicit call out about Z-Wave (#5294) * Added explicit call out about Z-Wave Called out the need to disable the auto-start when you're using Z-Wave * Included details about `discovery:` --- source/_components/homekit.markdown | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index f0723ba4ac..a28655751b 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -81,6 +81,9 @@ The `HomeKit` component allows you to forward entities from Home Assistant to Ap default: '' {% endconfiguration %} +

    + If you use Z-Wave, or `discovery:` you'll need to disable auto-start, see the [section below](#disable-auto-start) for details on how to do this. You'll then need to start the HomeKit component once Z-Wave is ready, or an appropriate delay to allow your entities to be discovered. +

    ## {% linkable_title Setup %} @@ -120,7 +123,7 @@ A common situation might be if you decide to disable parts of the configuration Depending on your individual setup, it might be necessary to disable `Auto Start` for all accessories to be available for `HomeKit`. Only those entities that are fully setup when the `HomeKit` component is started, can be added. To start `HomeKit` when `auto_start: False`, you can call the service `homekit.start`. -This can be automated using an `automation`. +If you have Z-Wave entities you want exposed to HomeKit then you'll need to disable auto start and then start it after the Z-Wave mesh is ready. This is because the Z-Wave entities won't be fully set up until then. This can be automated using an automation: {% raw %} ```yaml @@ -138,6 +141,8 @@ automation: ``` {% endraw %} +For a general delay where your component doesn't generate an event, you can also do: + {% raw %} ```yaml # Example using a delay after start of Home Assistant From cb8cdf34529f2c309c4b7ea7c52aaa142e91755e Mon Sep 17 00:00:00 2001 From: Tod Schmidt Date: Fri, 4 May 2018 03:43:51 -0400 Subject: [PATCH 213/241] Update snips.markdown (#5292) * Update snips.markdown Updated to reference latest add on. * Update snips.markdown * Fix escaping --- source/_addons/snips.markdown | 96 ++++++++++++++++++++++++----------- 1 file changed, 65 insertions(+), 31 deletions(-) diff --git a/source/_addons/snips.markdown b/source/_addons/snips.markdown index 55a1dca239..2160608694 100644 --- a/source/_addons/snips.markdown +++ b/source/_addons/snips.markdown @@ -2,7 +2,7 @@ layout: page title: "Snips.ai" description: "Enhance your Hass.io installation with a local voice assistant." -date: 2018-03-22 13:28 +date: 2018-05-02 13:28 sidebar: true comments: false sharing: true @@ -25,42 +25,17 @@ Open garage door What is on my shopping list ``` -To get started creating your own configuration, follow [their tutorial](https://github.com/snipsco/snips-platform-documentation/wiki/2.-Create-an-assistant-using-an-existing-bundle) to create an assistant and download the training data. You can add the HomeAssistant bundle to your assistant to enable the built-in intents, and add or create your own intents to do more complex tasks. +To get started creating your own configuration, follow [their tutorial](https://snips.gitbook.io/documentation/console) to create an assistant and download the training data. You can also add the HomeAssistant Skill to your assistant to enable the built-in intents, and add or create your own intents to do more complex tasks. -Now install and activate the [Samba] add-on so you can upload your training data. Connect to the "share" Samba share and copy your training data over. Name the file `assistant.zip`. - -Now it's time to start Snips for the first time. When the Snips add-on starts, it will output your audio devices. If you are using a USB mic and the raspberry pi output, you won't need to change anything: - -```text -**** List of PLAYBACK Hardware Devices **** -card 0: ALSA [bcm2835 ALSA], device 0: bcm2835 ALSA [bcm2835 ALSA] - Subdevices: 8/8 - Subdevice #0: subdevice #0 - Subdevice #1: subdevice #1 - Subdevice #2: subdevice #2 - Subdevice #3: subdevice #3 - Subdevice #4: subdevice #4 - Subdevice #5: subdevice #5 - Subdevice #6: subdevice #6 - Subdevice #7: subdevice #7 -card 0: ALSA [bcm2835 ALSA], device 1: bcm2835 ALSA [bcm2835 IEC958/HDMI] - Subdevices: 1/1 - Subdevice #0: subdevice #0 -``` - -You need to use this information to point the add-on at the right speakers and microphone. The information describes different cards and devices. On a Raspberry Pi 3, card 0 - device 0 is the built-in headset port, card 0 - device 1 is the HDMI port. In the example above, the USB microphone showed up as card 1 - device 0. - -Find the microphone and speakers that you want to use and note down their device and card number. We will need that to configure the add-on options `mic` (microphone to use) and `speaker` (speaker to use). The format for these options is `,`. Change the configuration options and click save. +Now install and activate the [Samba] add-on so you can upload your training data. Connect to the "share" Samba share and copy your assistant over. Name the file `assistant.zip` or whatever you have configured in the configuration options. +Now it's time to start Snips for the first time. You can configure the microphone and sound card using the addon gui. Now start the add-on. ### Add-On configuration ```json { - "mic": "1,0", - "speaker": "1,0", - "assistant": "assistant.zip", "mqtt_bridge": { "active": true, "host": "172.17.0.1", @@ -68,23 +43,82 @@ Now start the add-on. "user": "", "password": "" }, + "assistant": "assistant.zip", + "language": "en", + "custom_tts": false, + "tts_platform": "amazon_polly" } ``` Configuration variables: - **mqtt_bridge** : Snips uses MQTT to communicate and defaults to their own broker. Use this config option to bridge their broker to your the Mosquitto add-on. -- **mic**: This is the hardware address of your microphone. Look at the Snips output if you are using different hardware. +- **assistant** : The name of your custom assistant in /share. If no assistant is found a default assistant will be used. +- **language** : Language. This is used to select the default custom assistant, Currently en, de, and fr are supported. +- **custom_tts** : Whether to use a TTS provider from Home Assistant for a variety of voices +- **tts_platform** : Which tts platform to use. ### {% linkable_title Home Assistant configuration %} -Use the Home Assistant [Snips.ai component][comp] to integrate the add-on into Home Assistant. +A simple configuration just requires this. Consult [Snips.ai component][comp] for more options ```yaml snips: ``` +### {% linkable_title Home Assistant configuration %} + +There is an active [discord](https://discordapp.com/invite/3939Kqx) channel for further support. + +### Examples + +So now you can turn lights on and off, let's check the weather. Log on to the [console](https://console.snips.ai/). If this is your first time, create a new assistant and add the Home Assistant skill, along with the Weather skill by snips. Download your assistant manually and copy it to the /share folder on your HassIO installation using the Samba addon. + +Next create a weather sensor, I happen to use (Dark Sky)[/components/sensor.darksky/] and have my api_key in my secrets file. + +```yaml +- platform: darksky + name: "Dark Sky Weather" + api_key: !secret dark_sky_key + update_interval: + minutes: 10 + monitored_conditions: + - summary + - hourly_summary + - temperature + - temperature_max + - temperature_min +``` +Next add this to your configuration.yaml to reference a new intent_script component. +This is a good practice to split your config files up. + +```yaml +intent_script: !include intent_script.yaml +``` + +Finally, create this intent_script.yaml file in your config directory + +{% raw %} +```yaml +searchWeatherForecast: + speech: + type: plain + text: > + The weather is currently + {{ states('sensor.dark_sky_weather_temperature') | round(0) }} + degrees outside and {{ states('sensor.dark_sky_weather_summary') }}. + The high today will be + {{ states('sensor.dark_sky_weather_daily_high_temperature') | round(0)}} + and {{ states('sensor.dark_sky_weather_hourly_summary') }} +``` +{% endraw %} + +Now just restart HassIO and ask it what the weather is like! + + + [Snips.ai]: https://snips.ai/ [their tutorial]: https://github.com/snipsco/snips-platform-documentation/wiki/2.-Create-an-assistant-using-an-existing-bundle [Samba]: /addons/samba/ [comp]: /components/snips/ + From c66bde18435b54313308e14f70eeba70ff77370e Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Fri, 4 May 2018 09:52:24 +0200 Subject: [PATCH 214/241] Fix formatting and some sentences --- source/_addons/snips.markdown | 41 +++++++++++++------------------ source/_components/snips.markdown | 8 +++--- 2 files changed, 20 insertions(+), 29 deletions(-) diff --git a/source/_addons/snips.markdown b/source/_addons/snips.markdown index 2160608694..851afd8e7d 100644 --- a/source/_addons/snips.markdown +++ b/source/_addons/snips.markdown @@ -9,7 +9,7 @@ sharing: true footer: true --- -[Snips.ai] is an AI-powered voice assistant that runs on the Raspberry Pi 3 and x86 platforms. It runs on-device and is Private by Design. +[Snips.ai](https://snips.ai/) is an AI-powered voice assistant that runs on the Raspberry Pi 3 and x86 platforms. It runs on-device and is Private by Design. The Snips add-on depends on the Mosquitto add on to bridge to Home Assistant, so make sure that is installed. @@ -17,7 +17,7 @@ HomeAssistant comes with certain Intents builtin to handle common tasks. A compl The Snips addon by default comes with an assistant that allows you to turn on lights or switches, open covers, or add and list items to a shopping list if that component is enabled. -If using a USB microphone and speakers plugged into the raspberry pi output, Snips will work without any change to the configuration. Trying saying things like: +If using a USB microphone and speakers plugged into the Raspberry Pi output, Snips will work without any change to the configuration. Trying saying things like: ``` Turn on kitchen light @@ -27,12 +27,11 @@ What is on my shopping list To get started creating your own configuration, follow [their tutorial](https://snips.gitbook.io/documentation/console) to create an assistant and download the training data. You can also add the HomeAssistant Skill to your assistant to enable the built-in intents, and add or create your own intents to do more complex tasks. -Now install and activate the [Samba] add-on so you can upload your training data. Connect to the "share" Samba share and copy your assistant over. Name the file `assistant.zip` or whatever you have configured in the configuration options. +Now install and activate the [Samba](/addons/samba/) add-on so you can upload your training data. Connect to the "share" Samba share and copy your assistant over. Name the file `assistant.zip` or whatever you have configured in the configuration options. -Now it's time to start Snips for the first time. You can configure the microphone and sound card using the addon gui. -Now start the add-on. +Now it's time to start Snips for the first time. You can configure the microphone and sound card using the Add-on interface. Now start the add-on. -### Add-On configuration +### {% linkable_title Add-On configuration %} ```json { @@ -52,15 +51,15 @@ Now start the add-on. Configuration variables: -- **mqtt_bridge** : Snips uses MQTT to communicate and defaults to their own broker. Use this config option to bridge their broker to your the Mosquitto add-on. -- **assistant** : The name of your custom assistant in /share. If no assistant is found a default assistant will be used. -- **language** : Language. This is used to select the default custom assistant, Currently en, de, and fr are supported. -- **custom_tts** : Whether to use a TTS provider from Home Assistant for a variety of voices -- **tts_platform** : Which tts platform to use. +- **mqtt_bridge**: Snips uses MQTT to communicate and defaults to their own broker. Use this config option to bridge their broker to your the Mosquitto add-on. +- **assistant**: The name of your custom assistant in `/share`. If no assistant is found then a default assistant will be used. +- **language**: Language. This is used to select the default custom assistant, Currently `en`, `de` and `fr` are supported. +- **custom_tts**: Whether to use a TTS provider from Home Assistant for a variety of voices. +- **tts_platform**: Which TTS platform to use. ### {% linkable_title Home Assistant configuration %} -A simple configuration just requires this. Consult [Snips.ai component][comp] for more options +A simple configuration just requires this. Consult [Snips.ai component](/components/snips/) for more options. ```yaml snips: @@ -70,11 +69,11 @@ snips: There is an active [discord](https://discordapp.com/invite/3939Kqx) channel for further support. -### Examples +### {% linkable_title Examples %} -So now you can turn lights on and off, let's check the weather. Log on to the [console](https://console.snips.ai/). If this is your first time, create a new assistant and add the Home Assistant skill, along with the Weather skill by snips. Download your assistant manually and copy it to the /share folder on your HassIO installation using the Samba addon. +So now you can turn lights on and off, let's check the weather. Log on to the [console](https://console.snips.ai/). If this is your first time, create a new assistant and add the Home Assistant skill, along with the Weather skill by snips. Download your assistant manually and copy it to the `/share` folder on your HassIO installation using the Samba addon. -Next create a weather sensor, I happen to use (Dark Sky)[/components/sensor.darksky/] and have my api_key in my secrets file. +Next create a weather sensor, e.g., one for (Dark Sky)[/components/sensor.darksky/] and put the `api_key` in your `secrets.yaml` file. ```yaml - platform: darksky @@ -89,14 +88,13 @@ Next create a weather sensor, I happen to use (Dark Sky)[/components/sensor.dark - temperature_max - temperature_min ``` -Next add this to your configuration.yaml to reference a new intent_script component. -This is a good practice to split your config files up. +Next add this to your `configuration.yaml` file to reference a new `intent_script` component. This is a good practice to [split your configuration files](/docs/configuration/splitting_configuration/) up. ```yaml intent_script: !include intent_script.yaml ``` -Finally, create this intent_script.yaml file in your config directory +Finally, create this `intent_script.yaml` file in your configuration directory. {% raw %} ```yaml @@ -113,12 +111,7 @@ searchWeatherForecast: ``` {% endraw %} -Now just restart HassIO and ask it what the weather is like! +Now just restart HassIO and ask it what the weather is like. - - -[Snips.ai]: https://snips.ai/ [their tutorial]: https://github.com/snipsco/snips-platform-documentation/wiki/2.-Create-an-assistant-using-an-existing-bundle -[Samba]: /addons/samba/ -[comp]: /components/snips/ diff --git a/source/_components/snips.markdown b/source/_components/snips.markdown index cc2aa3248c..e7086ac9dc 100644 --- a/source/_components/snips.markdown +++ b/source/_components/snips.markdown @@ -97,7 +97,7 @@ followed by a command, e.g. > Set the lights to green in the living room -As the Snips Platform parses this query into an intent, it will be published on MQTT, on the `hermes/intent/` topic. The Snips Home Assistant component subscribes to this topic, and handles the intent according to the rules defined in `configuration.yaml`, as explained below. +As the Snips Platform parses this query into an intent, it will be published on MQTT, on the `hermes/intent/` topic. The Snips Home Assistant component subscribes to this topic, and handles the intent according to the rules defined in `configuration.yaml` file, as explained below. #### {% linkable_title Optional: specifying an external MQTT broker %} @@ -256,9 +256,7 @@ intent_script: ##### {% linkable_title Weather %} -So now you can open and close your garage door, let's check the weather. Add the Weather by Snips Skill to your assistant. - -Create a weather sensor, in this example (Dark Sky)[/components/sensor.darksky/] and the api_key in the secrets file. +So now you can open and close your garage door, let's check the weather. Add the Weather by Snips Skill to your assistant. Create a weather sensor, in this example (Dark Sky)[/components/sensor.darksky/] and the `api_key` in the `secrets.yaml` file. ```yaml - platform: darksky @@ -274,7 +272,7 @@ Create a weather sensor, in this example (Dark Sky)[/components/sensor.darksky/] - temperature_min ``` -Then create this intent_script.yaml file in your config directory +Then create this `intent_script.yaml` file in your configuration directory. {% raw %} ```yaml From 05916670688398ef9afb55416f2ac3d7e8cedd60 Mon Sep 17 00:00:00 2001 From: lbouriez Date: Fri, 4 May 2018 04:20:20 -0400 Subject: [PATCH 215/241] fix yaml example (#5275) * fix yaml example * Fix configuration sample --- source/_components/device_tracker.google_maps.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/device_tracker.google_maps.markdown b/source/_components/device_tracker.google_maps.markdown index 5b16f3c785..d05c9e35d2 100644 --- a/source/_components/device_tracker.google_maps.markdown +++ b/source/_components/device_tracker.google_maps.markdown @@ -29,9 +29,9 @@ To integrate Google Maps Location Sharing in Home Assistant, add the following s ```yaml # Example configuration.yaml entry device_tracker: - platform: google_maps - username: example@gmail.com - password: password + - platform: google_maps + username: YOUR_USERNAME + password: YOUR_PASSWORD ``` {% configuration %} From 99b142470d51393ed2b6dd8e7ba09ab3ec53ba1c Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Sat, 5 May 2018 15:38:37 +0200 Subject: [PATCH 216/241] Updated sensor device_classes (#5306) * Updated sensor device_classes * Removed lux * Changed device_class name * Updated homekit doc --- source/_components/homekit.markdown | 2 +- source/_components/sensor.markdown | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index 631ddf592c..c50ce9b6be 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -206,7 +206,7 @@ The following components are currently supported: | sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` or `humidity` as their `device_class`. | | sensor | AirQualitySensor | All sensors that have `pm25` as part of their `entity_id` or `pm25` as their `device_class` | | sensor | CarbonDioxideSensor | All sensors that have `co2` as part of their `entity_id` or `co2` as their `device_class` | -| sensor | LightSensor | All sensors that have `lm`/`lux` as their `unit_of_measurement` or `light` as their `device_class` | +| sensor | LightSensor | All sensors that have `lm` or `lx` as their `unit_of_measurement` or `illuminance` as their `device_class` | | switch / remote / input_boolean / script | Switch | All represented as switches. | diff --git a/source/_components/sensor.markdown b/source/_components/sensor.markdown index d973c2442e..647f0e7ab0 100644 --- a/source/_components/sensor.markdown +++ b/source/_components/sensor.markdown @@ -20,6 +20,7 @@ The way these sensors are displayed in the frontend can be modified in the [cust - **None**: Generic sensor. This is the default and doesn't need to be set. - **battery**: Percentage of battery that is left. - **humidity**: Percentage of humidity in the air. +- **illuminance**: The current light level in lx or lm. - **temperature**: Temperature in °C or °F.

    From 69405f1edc24dfea0342bc10b0c90678acedb6e8 Mon Sep 17 00:00:00 2001 From: Lukas Barth Date: Sat, 5 May 2018 19:05:15 +0200 Subject: [PATCH 217/241] Add matrix documentation (#5019) * Add matrix documentation * Try to use new config tags * Use new config tag * :arrow_up: Added ha_version tag * :arrow_up: ha_release -> 0.68 * update version number --- source/_components/matrix.markdown | 136 ++++++++++++++++++++++ source/_components/notify.matrix.markdown | 10 +- 2 files changed, 138 insertions(+), 8 deletions(-) create mode 100644 source/_components/matrix.markdown diff --git a/source/_components/matrix.markdown b/source/_components/matrix.markdown new file mode 100644 index 0000000000..1047d54053 --- /dev/null +++ b/source/_components/matrix.markdown @@ -0,0 +1,136 @@ +--- +layout: page +title: "Matrix" +description: "Matrix chatbot support" +date: 2018-03-25 18:50 +sidebar: true +comments: false +sharing: true +footer: true +logo: matrix.png +ha_category: Hub +ha_version: 0.69 +--- + +This component allows you to send messages to matrix rooms, as well as to react to messages in matrix rooms. Reacting to commands is accomplished by firing an event when one of the configured commands is triggered. + +```yaml +# Example configuration.yaml entry +matrix: + homeserver: https://matrix.org + username: "@my_matrix_user:matrix.org" + password: supersecurepassword + rooms: + - "#hasstest:matrix.org" + commands: + - word: my_command + name: my_command +``` + +Configuration variables: + +{% configuration %} +username: + description: "The matrix username that home assistant should use to log in. *Note*: You must specify a full matrix ID here, including the homeserver domain, e.g. '@my_matrix_bot:matrix.org'. Please note also that the '@' character has a special meaning in YAML, so this must always be given in quotes." + required: true + type: string +password: + description: The password for your Matrix account. + required: true + type: string +homeserver: + description: "The full URL for your homeserver. If you use the defauls matrix.org homeserver, this is 'https://matrix.org'." + required: true + type: string +verify_ssl: + description: Verify the homeservers certificate. + required: false + type: string + default: true +rooms: + description: "The list of rooms that the bot should join and listen for commands (see below) in. While you can limit the list of rooms that a certain command applies to on a per-command basis (see below), you must still list all rooms here that commands should be received in. Rooms can be given either by their internal ID (e.g., '!cURbafjkfsMDVwdRDQ:matrix.org') or any of their aliases (e.g., '#matrix:matrix.org')." + required: false + type: [string] + default: empty +commands: + description: "A list of commands that the bot should listen for. If a command is triggered (via its *word* or *expression*, see below), an event is fired that you can handle using automations. Every command consists of these possible configuration options:" + required: false + type: map + default: empty + keys: + word: + description: "Specifies a word that the bot should listen for. If you specify 'my_command' here, the bot will react to any message starting with '!my_command'." + required: false + type: string + expression: + description: "Specifies a regular expression (in python regexp syntax) that the bot should listen to. The bot will react to any message that matches the regular expression." + required: false + type: string + name: + description: "The name of the command. This will be an attribute of the event that is fired when this command triggers." + required: true + type: string + rooms: + description: "A list of rooms that the bot should listen for this command in. If this is not given, the *rooms* list from the main config is used. Please note that every room in this list must also be in the main *room* config." + required: false + type: [string] + default: empty +{% endconfiguration %} + +### {% linkable_title Event Data %} + +If a command is triggered, a `matrix_command` event is fired. The event contains the name of the command in the `name` field. If the command is a word command that has no name set, the `name` field contains the word instead. + +If the command is a word command, the `data` field contains a list of the command's arguments, i.e., everything that stood behind the word, split at spaces. If the command is an expression command, the `data` field contains the [group dictionary](https://docs.python.org/3.6/library/re.html?highlight=re#re.match.groupdict) of the regular expression that matched the message. + +### {% linkable_title Comprehensive Configuration Example %} + +This example also uses the [matrix `notify` platform](/components/notify.matrix/). + +```yaml +# The Matrix component +matrix: + homeserver: https://matrix.org + username: "@my_matrix_user:matrix.org" + password: supersecurepassword + rooms: + - "#hasstest:matrix.org" + - "#someothertest:matrix.org" + commands: + - word: testword + rooms: + - "#someothertest:matrix.org" + - expression: "My name is (?P.*)" + name: introduction + +notify: + - name: matrix_notify + platform: matrix + default_room: "#hasstest:matrix.org" + +automation: + - alias: 'React to !testword' + trigger: + platform: event + event_type: matrix_command + event_data: + command: testword + action: + service: notify.matrix_notify + data: + message: 'It looks like you wrote !testword' + - alias: 'React to an introduction' + trigger: + platform: event + event_type: matrix_command + event_data: + command: introduction + action: + service: notify.matrix_notify + data_template: + message: "Hello {{trigger.event.data.name}}" +``` + +This configuration will: +- Listen for "!testword" in the room "#someothertest:matrix.org" (and *only*) there. If such a message is encountered, it will answer with "It looks like you wrote !testword" into the "#hasstest:matrix.org" channel. +- Listen in both rooms for any message matching "My name is " and answer with "Hello " into "#hasstest:matrix.org". diff --git a/source/_components/notify.matrix.markdown b/source/_components/notify.matrix.markdown index 2d9aff6a04..29890d46c8 100644 --- a/source/_components/notify.matrix.markdown +++ b/source/_components/notify.matrix.markdown @@ -17,27 +17,21 @@ The `matrix` platform allows you to deliver notifications from Home Assistant to ## {% linkable_title Configuration %} -To enable Matrix notifications in your installation, add the following to your `configuration.yaml` file: +To enable Matrix notifications in your installation, you first need to configure +the [Matrix component](/components/matrix/). Then, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry notify: - name: NOTIFIER_NAME platform: matrix - homeserver: HOMESERVER - username: YOUR_USERNAME - password: YOUR_PASSWORD default_room: ROOM_ID_OR_ALIAS ``` 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`. -- **homeserver** (*Required*): The base URL of the homeserver, where the notifier account is registered (e.g., `https://matrix.org`). -- **username** (*Required*): The username of the notifying Matrix account. -- **password** (*Required*): The password for the given Matrix account. - **default_room** (*Required*): The room all messages will be sent to, when no other target is given. -- **verify_ssl** (*Optional*): Verify the homeservers certificate. Defaults to `true`. The target room has to be precreated, the room id can be obtained from the rooms settings dialog. Rooms by default have a canonical id of the form `"!:homeserver.tld"`, but can also be allocated aliases like `"#roomname:homeserver.tld"`. Make sure to use quotes around the room id or alias to escape special characters (`!`, and `#`) in YAML. The notifying account may need to be invited to the room, depending on the individual rooms policies. From ba630fb068bec34736d3a9e8cf4135d1dfa48223 Mon Sep 17 00:00:00 2001 From: cdce8p <30130371+cdce8p@users.noreply.github.com> Date: Sat, 5 May 2018 19:05:49 +0200 Subject: [PATCH 218/241] Updated Sensor device_class requirement - HomeKit (#5304) * HomeKit - sensor device_class requirement * Limit breaking change to Humidity Sensor --- source/_components/homekit.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/homekit.markdown b/source/_components/homekit.markdown index c50ce9b6be..bb2b4649f8 100644 --- a/source/_components/homekit.markdown +++ b/source/_components/homekit.markdown @@ -202,8 +202,8 @@ The following components are currently supported: | cover | WindowCovering | All covers that support `open_cover`, `stop_cover` and `close_cover` through value mapping. (`open` -> `>70`; `close` -> `<30`; `stop` -> every value in between) | | light | Light | Support for `on / off`, `brightness` and `rgb_color`. | | lock | DoorLock | Support for `lock / unlock`. | -| sensor | TemperatureSensor | All sensors that have `Celsius` and `Fahrenheit` as their `unit_of_measurement` or `temperature` as their `device_class`. | -| sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` or `humidity` as their `device_class`. | +| sensor | TemperatureSensor | All sensors that have `Celsius` or `Fahrenheit` as their `unit_of_measurement` or `temperature` as their `device_class`. | +| sensor | HumiditySensor | All sensors that have `%` as their `unit_of_measurement` and `humidity` as their `device_class`. | | sensor | AirQualitySensor | All sensors that have `pm25` as part of their `entity_id` or `pm25` as their `device_class` | | sensor | CarbonDioxideSensor | All sensors that have `co2` as part of their `entity_id` or `co2` as their `device_class` | | sensor | LightSensor | All sensors that have `lm` or `lx` as their `unit_of_measurement` or `illuminance` as their `device_class` | From 8187c4aebe4fc0edc551ed2f508ec15748e89bbc Mon Sep 17 00:00:00 2001 From: Mick Vleeshouwer Date: Sat, 5 May 2018 19:06:14 +0200 Subject: [PATCH 219/241] Add sensor.postnl documentation (#5231) * Add sensor.postnl documentation * Update ha_release --- source/_components/sensor.postnl.markdown | 47 ++++++++++++++++++++++ source/images/supported_brands/postnl.png | Bin 0 -> 190385 bytes 2 files changed, 47 insertions(+) create mode 100644 source/_components/sensor.postnl.markdown create mode 100644 source/images/supported_brands/postnl.png diff --git a/source/_components/sensor.postnl.markdown b/source/_components/sensor.postnl.markdown new file mode 100644 index 0000000000..3087ce4b01 --- /dev/null +++ b/source/_components/sensor.postnl.markdown @@ -0,0 +1,47 @@ +--- +layout: page +title: PostNL Sensor +description: "Instructions on how to set up PostNL sensors within Home Assistant." +date: 2017-04-22 08:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: postnl.png +ha_category: Sensor +ha_release: 0.69 +ha_iot_class: "Cloud Polling" +--- + +The `postnl` platform allows one to track deliveries by [PostNL](https://www.postnl.nl) (Dutch Postal Services). To use this sensor, you need a [PostNL Account](https://jouw.postnl.nl). It is possible to add multiple accounts to your Home Assistant configuration. + +## {% linkable_title Configuration %} + +To enable this sensor, add the following lines to your `configuration.yaml`: + +```yaml +sensors: + - platform: postnl + username: POSTNL_USERNAME + password: POSTNL_PASSWORD +``` + +{% configuration %} +name: + description: Sensor name + required: false + default: "postnl" + type: string +username: + description: Account username of jouw.postnl.nl + required: true + type: string +password: + description: Account password of jouw.postnl.nl + required: true + type: string +{% endconfiguration %} + +

    +This component is not affiliated with PostNL and retrieves date from the endpoints of the mobile application. Use at your own risk. +

    diff --git a/source/images/supported_brands/postnl.png b/source/images/supported_brands/postnl.png new file mode 100644 index 0000000000000000000000000000000000000000..93d54db18c92d5d4513e65a159d7a9074266aeb6 GIT binary patch literal 190385 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%0A-a$wDl-R6sc!u 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 Date: Sat, 5 May 2018 19:06:35 +0200 Subject: [PATCH 220/241] Netgear: doc for tracking devices on APs, URL support and autodetection (#4958) --- .../_components/device_tracker.netgear.markdown | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/source/_components/device_tracker.netgear.markdown b/source/_components/device_tracker.netgear.markdown index f8dace0e12..8bdcacc8cd 100644 --- a/source/_components/device_tracker.netgear.markdown +++ b/source/_components/device_tracker.netgear.markdown @@ -13,7 +13,6 @@ ha_iot_class: "Local Polling" ha_release: pre 0.7 --- - This platform allows you to detect presence by looking at connected devices to a [Netgear](http://www.netgear.com/) device. To use this device tracker in your installation, add the following to your `configuration.yaml` file: @@ -29,10 +28,18 @@ device_tracker: Configuration variables: -- **host** (*Optional*): The IP address of your router, e.g., `192.168.1.1`. If not provided `routerlogin.net` will be used. -- **username** (*Optional*): The username of an user with administrative privileges. If not provided `admin` will be used. -- **port** (*Optional*): The port your router communicates with (defaults to `5000`, but `80` is also known to be used on some models). +- **url** (*Optional*): The base URL, e.g., `http://routerlogin.com:5000` for example. If not provided `host` and `port` are used. If none provided autodetection of the URL will be used. +- **host** (*Optional*): The IP address of your router, e.g., `192.168.1.1`. +- **port** (*Optional*): The port your router communicates with. +- **username** (*Optional*): The username of a user with administrative privileges. If not provided `admin` will be used. - **password** (*Required*): The password for your given admin account. +- **devices** (*Optional*): If provided only specified devices will be reported. Can be MAC address or the device name as reported in the Netgear UI. +- **exclude** (*Optional*): Devices to exclude from the scan. +- **accesspoints** (*Optional*): Also track devices on the specified APs. Only supports MAC address. + +When `accesspoints` is specified an extra device will be reported for each device connected to the APs specified here, as `MY-LAPTOP on RBS40`. `Router` will be reported as AP name for the main AP. Only tested with Orbi. + +The use of `devices` or `exclude` is recommended when using `accesspoints` to avoid having a lot of entries. List of models that are known to use port 80: - Nighthawk X4S - AC2600 (R7800) From 65ab88cd5d5b8af9bb3b478da9793ea426d4abc9 Mon Sep 17 00:00:00 2001 From: Mohamad Tarbin Date: Sat, 5 May 2018 13:07:24 -0400 Subject: [PATCH 221/241] Add Socialblade Markdown (#5237) * Adding markdown and imagie for USCIS sensor * Update the markdown * Update sensor.uscis.markdown * Update sensor.uscis.markdown * Update sensor.uscis.markdown * Minor changes * Add :markdown for social blade * Update links * Update links * Update sensor.uscis.markdown * Remove USCIS docmenetation from this branch * Update sensor.socialblade.markdown * Update sensor.socialblade.markdown --- .../_components/sensor.socialblade.markdown | 37 ++++++++++++++++++ .../images/supported_brands/socialblade.png | Bin 0 -> 4952 bytes 2 files changed, 37 insertions(+) create mode 100644 source/_components/sensor.socialblade.markdown create mode 100644 source/images/supported_brands/socialblade.png diff --git a/source/_components/sensor.socialblade.markdown b/source/_components/sensor.socialblade.markdown new file mode 100644 index 0000000000..cf106c9133 --- /dev/null +++ b/source/_components/sensor.socialblade.markdown @@ -0,0 +1,37 @@ +--- +layout: page +title: Social Blade Sensor +description: "Instructions on how to set up Social Blade Sensor within Home Assistant." +date: 2018-04-23 08:00 +sidebar: false +comments: false +sharing: true +footer: true +logo: socialblade.png +ha_category: Sensor +ha_release: 0.69 +ha_iot_class: "Cloud Polling" +--- + +The `socialblade` sensor component allows you get updates on a youtube channel using your social blade channel id. The sensor gets the subscribers and total views count from [Social Blade Website]( https://socialblade.com/) + +to get the channel id you can go to [Social Blade Website]( https://socialblade.com/) and search for youtube channel by username, then select the channel and grab the id from the url. +The channel id will be the last part of the url : +https://socialblade.com/youtube/channel/{channel_id} + +## Example for `configuration.yaml` : + +```yaml +sensor: + - platform: socialblade + channel_id: YOUR_CHANNEL_NUMBER +``` + +{% configuration %} +channel_id: + description: channel id number optained from the URL when you access Social Blade web client. + required: true + type: string +{% endconfiguration %} + +All the data will be fetch from [Social Blade]( https://socialblade.com/). diff --git a/source/images/supported_brands/socialblade.png b/source/images/supported_brands/socialblade.png new file mode 100644 index 0000000000000000000000000000000000000000..3e2de38de204215a25dc517c58b69b4706d21250 GIT binary patch literal 4952 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 literal 0 HcmV?d00001 From 5a9d5c54275cdd5bf8d39ab0b948e03eeead3d7e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jens=20=C3=98stergaard=20Nielsen?= Date: Sat, 5 May 2018 19:11:47 +0200 Subject: [PATCH 222/241] Added update_interval to maxcube (#5265) * Added update_interval to maxcube * Renamed update_interval to scan_interval * Update maxcube.markdown --- source/_components/maxcube.markdown | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/source/_components/maxcube.markdown b/source/_components/maxcube.markdown index 69713a6469..7439d2d19f 100644 --- a/source/_components/maxcube.markdown +++ b/source/_components/maxcube.markdown @@ -58,4 +58,9 @@ maxcube: required: false type: int default: 62910 + scan_interval: + description: The update interval in seconds + required: false + type: int + default: 300 {% endconfiguration %} From 78f19d989a247e2bcb3b368a85ac94ff067ef25b Mon Sep 17 00:00:00 2001 From: Jason Kingsbury Date: Sat, 5 May 2018 18:12:10 +0100 Subject: [PATCH 223/241] Add max_volume option to Onkyo media player (#5153) * Update media_player.onkyo.markdown * onkyo: removed optional value from sample config, update max_volume documentation to include required volume range --- source/_components/media_player.onkyo.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/media_player.onkyo.markdown b/source/_components/media_player.onkyo.markdown index 13a50152dc..19854cfe60 100644 --- a/source/_components/media_player.onkyo.markdown +++ b/source/_components/media_player.onkyo.markdown @@ -39,6 +39,10 @@ name: description: Name of the device. (*Required if host is specified*) required: false type: string +max_volume: + description: Maximum volume. Defaults to 80. + required: false + type: number sources: description: A list of mappings from source to source name. Valid sources can be found below. A default list will be used if no source mapping is specified. required: false From 50775dc3b172d1ac7fa32735cc8b3af9cdb41e55 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sat, 5 May 2018 13:34:58 -0400 Subject: [PATCH 224/241] Add blog post 0.69 draft --- _config.yml | 8 +- source/_posts/2018-05-11-release-69.markdown | 437 +++++++++++++++++++ 2 files changed, 441 insertions(+), 4 deletions(-) create mode 100644 source/_posts/2018-05-11-release-69.markdown diff --git a/_config.yml b/_config.yml index 502ae90635..45147f16ca 100644 --- a/_config.yml +++ b/_config.yml @@ -139,14 +139,14 @@ social: # Home Assistant release details current_major_version: 0 -current_minor_version: 68 -current_patch_version: 1 -date_released: 2018-04-30 +current_minor_version: 69 +current_patch_version: 0 +date_released: 2018-05-11 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. # Major release: -patch_version_notes: "#release-0681---april-30" +patch_version_notes: "#" # Minor release (Example #release-0431---april-25): # Date we moved to Discourse for comments diff --git a/source/_posts/2018-05-11-release-69.markdown b/source/_posts/2018-05-11-release-69.markdown new file mode 100644 index 0000000000..988d2b6cca --- /dev/null +++ b/source/_posts/2018-05-11-release-69.markdown @@ -0,0 +1,437 @@ +--- +layout: post +title: "0.69: TBD - Update date" +description: "TBD." +date: 2018-05-05 00:01:00 +date_formatted: "May 11, 2018" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Release-Notes +og_image: /images/blog/2018-05-0.69/components.png +--- + + + +## {% linkable_title New Platforms %} + +- New sensor domain expiry ([@masarliev] - [#14067]) ([sensor.domain_expiry docs]) (new-platform) +- Support Xiaomi Mijia Bluetooth Wireless Temperature and Humidity Sensor ([@ratcashdev] - [#13955]) ([sensor.mitemp_bt docs]) (new-platform) +- Move RainMachine to component/hub model ([@bachya] - [#14085]) ([rainmachine docs]) ([switch.rainmachine docs]) (breaking change) (new-platform) +- Foundation for users ([@balloob] - [#13968]) ([auth docs]) ([http docs]) (new-platform) +- Add Social Blade Sensor ([@meauxt] - [#14060]) ([sensor.socialblade docs]) ([sensor.uscis docs]) (new-platform) +- Add PostNL sensor (Dutch Postal Services) ([@iMicknl] - [#12366]) ([sensor.postnl docs]) (new-platform) +- Issue/add template fans ([@giangvo] - [#12027]) ([fan.template docs]) (new-platform) +- Matrix Chatbot ([@tinloaf] - [#13355]) ([matrix docs]) ([notify docs]) (breaking change) (new-platform) + +## {% linkable_title If you need help... %} + +...don't hesitate to use our very active [forums](https://community.home-assistant.io/) or join us for a little [chat](https://discord.gg/c5DvZ4e). The release notes have comments enabled but it's preferred if you use the former communication channels. Thanks. + +## {% linkable_title Reporting Issues %} + +Experiencing issues introduced by this release? Please report them in our [issue tracker](https://github.com/home-assistant/home-assistant/issues). Make sure to fill in all fields of the issue template. + + +## {% linkable_title Breaking Changes %} + +- Pollen.com: Added attributes on top 3 allergens ([@bachya] - [#14018]) ([sensor.pollen docs]) (breaking change) +- Add Sonos device attribute with grouping information ([@amelchio] - [#13553]) ([media_player.sonos docs]) (breaking change) +- Re-implement HomematicIP cloud to async ([@mxworm] - [#13468]) ([homematicip_cloud docs]) ([sensor.homematicip_cloud docs]) (breaking change) +- Move RainMachine to component/hub model ([@bachya] - [#14085]) ([rainmachine docs]) ([switch.rainmachine docs]) (breaking change) (new-platform) +- System log: make firing event optional ([@balloob] - [#14102]) ([system_log docs]) (breaking change) +- Disable eliqonline requirement ([@balloob] - [#14156]) ([sensor.eliqonline docs]) (breaking change) +- Custom component loading cleanup ([@balloob] - [#14211]) (breaking change) +- Converts RainMachine to hub model (part 2) ([@bachya] - [#14225]) ([rainmachine docs]) ([switch.rainmachine docs]) (breaking change) +- Homekit: Changed device_class requirement Humidity Sensor ([@cdce8p] - [#14277]) ([homekit docs]) (breaking change) +- Sensor device classes ([@cdce8p] - [#14282]) ([sensor docs]) (breaking change) +- Matrix Chatbot ([@tinloaf] - [#13355]) ([matrix docs]) ([notify docs]) (breaking change) (new-platform) + +## {% linkable_title All changes %} + +- Pollen.com: Added attributes on top 3 allergens ([@bachya] - [#14018]) ([sensor.pollen docs]) (breaking change) +- Expose the condition code on condition sensors ([@maddox] - [#14011]) ([sensor.yweather docs]) +- upgrade rfxtrx lib, dimming support for Lighting3 ([@danielhiversen] - [#14026]) ([rfxtrx docs]) +- Add Accuracy to Google Location Sharing ([@rdbahm] - [#14039]) ([device_tracker docs]) +- bump gogogate2 version ([@dlbroadfoot] - [#14044]) ([cover.gogogate2 docs]) +- device_tracker.ubus: catch ConnectionError ([@stintel] - [#14045]) ([device_tracker docs]) +- Show a notification when a config entry is discovered ([@balloob] - [#14022]) +- deCONZ use forward entry setup ([@Kane610] - [#13990]) ([binary_sensor docs]) ([deconz docs]) ([scene docs]) ([sensor docs]) ([binary_sensor.deconz docs]) ([light.deconz docs]) ([scene.deconz docs]) ([sensor.deconz docs]) +- Bump pyEight version to update API & reduce connection issues ([@mezz64] - [#14058]) ([eight_sleep docs]) +- Bump locationsharinglib to 1.2.2 ([@thelittlefireman] - [#14070]) ([device_tracker docs]) +- Remove excessive debugging in webostv module ([@stephanerosi] - [#14056]) ([media_player.webostv docs]) +- Support new Xiaomi Aqara device model names and LAN protocol 2.0 ([@ileler] - [#13540]) ([xiaomi_aqara docs]) ([binary_sensor.xiaomi_aqara docs]) ([light.xiaomi_aqara docs]) ([sensor.xiaomi_aqara docs]) ([switch.xiaomi_aqara docs]) +- Add devices to Tahoma ([@bakedraccoon] - [#14075]) ([tahoma docs]) ([cover.tahoma docs]) ([sensor.tahoma docs]) +- New sensor domain expiry ([@masarliev] - [#14067]) ([sensor.domain_expiry docs]) (new-platform) +- Modify weather components for "new" frontend card ([@c727] - [#14076]) ([weather.buienradar docs]) ([weather.darksky docs]) ([weather.openweathermap docs]) +- Add Sonos device attribute with grouping information ([@amelchio] - [#13553]) ([media_player.sonos docs]) (breaking change) +- Re-implement HomematicIP cloud to async ([@mxworm] - [#13468]) ([homematicip_cloud docs]) ([sensor.homematicip_cloud docs]) (breaking change) +- Update pyhomematic to 0.1.42 ([@danielperna84] - [#14095]) ([homematic docs]) +- Adds update file_path service to local_file camera ([@robmarkcole] - [#13976]) ([camera.local_file docs]) +- Zone component config entry support ([@Kane610] - [#14059]) ([zone docs]) +- Improve MQTT topic validation ([@OttoWinter] - [#14099]) ([mqtt docs]) +- Fix the optional friendly name of the Yeelight (Closes: #14088) ([@syssi] - [#14110]) ([light.yeelight docs]) +- Update QNAP lib to 0.2.6; handle null temps gracefully ([@colinodell] - [#14117]) ([sensor.qnap docs]) +- Support Xiaomi Mijia Bluetooth Wireless Temperature and Humidity Sensor ([@ratcashdev] - [#13955]) ([sensor.mitemp_bt docs]) (new-platform) +- Upgrade colorlog to 3.1.4 ([@fabaff] - [#14132]) +- Move RainMachine to component/hub model ([@bachya] - [#14085]) ([rainmachine docs]) ([switch.rainmachine docs]) (breaking change) (new-platform) +- Add support for light sensors with 'lx' unit to HomeKit ([@bieniu] - [#14131]) ([homekit docs]) +- Upgrade restrictedpython to 4.0b3 ([@fabaff] - [#14140]) ([python_script docs]) +- Logitech Pop support for emulated_hue component ([@dgraye] - [#12833]) ([emulated_hue docs]) +- Bump pyvizio to 0.0.3 ([@cgarwood] - [#14147]) ([media_player.vizio docs]) +- System log: make firing event optional ([@balloob] - [#14102]) ([system_log docs]) (breaking change) +- Upgrade pylast to 2.2.0 ([@fabaff] - [#14139]) ([sensor.lastfm docs]) +- Upgrade sqlalchemy to 1.2.7 ([@fabaff] - [#14138]) +- Upgrade tapsaff to 0.2.0 ([@fabaff] - [#14137]) ([binary_sensor.tapsaff docs]) +- Upgrade python-telegram-bot to 10.0.2 ([@fabaff] - [#14144]) +- Upgrade youtube_dl to 2018.04.25 ([@fabaff] - [#14136]) ([media_extractor docs]) +- Clean up HomeKit accessory information characteristics ([@schmittx] - [#14114]) ([homekit docs]) +- Upgrade psutil to 5.4.5 ([@fabaff] - [#14135]) +- Fixed datetime values ([@gives1976] - [#14153]) ([sensor.sql docs]) +- deluge-components-update ([@engrbm87] - [#14016]) ([sensor.deluge docs]) ([switch.deluge docs]) +- Light mqtt_json: Add HS color support ([@OttoWinter] - [#14029]) ([light.mqtt_json docs]) +- Convert more files to async/await syntax ([@OttoWinter] - [#14142]) +- Disable eliqonline requirement ([@balloob] - [#14156]) ([sensor.eliqonline docs]) (breaking change) +- deCONZ allow unloading of config entry ([@Kane610] - [#14115]) ([binary_sensor docs]) ([deconz docs]) ([scene docs]) ([sensor docs]) +- Upgrade netdisco to 1.4.0 ([@fabaff] - [#14152]) +- Add precipitation to OpenWeatherMap forecast ([@escoand] - [#13971]) ([weather.openweathermap docs]) +- Allow transitioning to colour temp for tradfri ([@Hate-Usernames] - [#14157]) +- Added update_interval to maxcube ([@dingusdk] - [#14143]) ([maxcube docs]) +- zha: Support remotes/buttons ([@rcloran] - [#12528]) ([zha docs]) ([binary_sensor.zha docs]) +- Upgrade numpy to 1.14.3 ([@fabaff] - [#14187]) ([binary_sensor.trend docs]) ([image_processing.opencv docs]) +- Updating darksky default update interval to 5 mins ([@msubra] - [#14195]) ([sensor.darksky docs]) +- Fix TypeError on round(self.humidity) (fixes #13116) ([@mvn23] - [#14174]) ([weather docs]) +- Add room hint support to Google Assistant cloud ([@balloob] - [#14180]) +- Update CODEOWNERS ([@pschmitt] - [#14214]) +- Fixes #14169 (Upgrade pyupnp-async to 0.1.0.2) ([@dgomes] - [#14210]) ([upnp docs]) +- zha: Clean up binary_sensor listener registration/state updates ([@rcloran] - [#14197]) +- HomematicIP cloud: Add logic to check accesspoint connection state ([@sander76] - [#14203]) ([homematicip_cloud docs]) +- Foundation for users ([@balloob] - [#13968]) ([auth docs]) ([http docs]) (new-platform) +- Allow easy extension of websocket API ([@balloob] - [#14186]) ([frontend docs]) ([websocket_api docs]) +- Change the divisor for total consumption output ([@CM000n] - [#14215]) ([switch.fritzbox docs]) +- Upgrade mypy to 0.590 ([@fabaff] - [#14207]) +- Template Sensor add device_class support ([@OttoWinter] - [#14034]) ([sensor.template docs]) +- Add more parameters for DSMR sensor ([@rubenvandeven] - [#13967]) ([sensor.dsmr docs]) +- Support setting explicit mute value for Panasonic Viera TV ([@blackwind] - [#13954]) ([media_player.panasonic_viera docs]) +- Allow to set a desired update interval for camera_proxy_stream view ([@NovapaX] - [#13350]) ([camera docs]) +- panasonic_viera: Provide unique_id from SSDP UDN, if available ([@scop] - [#13541]) ([media_player.panasonic_viera docs]) +- Custom component loading cleanup ([@balloob] - [#14211]) (breaking change) +- Buienradar improvements: continuous sensors and unique ID's ([@corneyl] - [#13249]) ([sensor.buienradar docs]) +- add volumio discovery ([@escoand] - [#14220]) ([media_player.volumio docs]) +- Converts RainMachine to hub model (part 2) ([@bachya] - [#14225]) ([rainmachine docs]) ([switch.rainmachine docs]) (breaking change) +- Add MQTT Sensor device_class ([@OttoWinter] - [#14033]) ([sensor.mqtt docs]) +- Allow independent control of white level on flux_led component ([@oblogic7] - [#13985]) ([light.flux_led docs]) +- Add Social Blade Sensor ([@meauxt] - [#14060]) ([sensor.socialblade docs]) ([sensor.uscis docs]) (new-platform) +- UPnP code cleanup ([@dgomes] - [#14235]) ([upnp docs]) ([sensor.upnp docs]) +- Improve config schema of the blackbird component ([@syssi] - [#14007]) ([media_player.blackbird docs]) +- Add support for tracking devices on Netgear access points ([@MatMaul] - [#13331]) ([device_tracker docs]) +- WUnderground unique ids ([@OttoWinter] - [#13311]) ([sensor.wunderground docs]) +- Add PostNL sensor (Dutch Postal Services) ([@iMicknl] - [#12366]) ([sensor.postnl docs]) (new-platform) +- python_openzwave update config service ([@perosb] - [#12060]) ([zwave docs]) +- Add unique_id to zwave node entity ([@andrey-git] - [#14201]) ([zwave docs]) +- Add prereqs for HomeKit Controller ([@marthoc] - [#14172]) +- Restores switch state, case the switch is optimistic ([@dgomes] - [#14151]) ([switch.mqtt docs]) +- Issue/add template fans ([@giangvo] - [#12027]) ([fan.template docs]) (new-platform) +- HomeKit - Climate: power state on/off support ([@roiff] - [#14082]) ([homekit docs]) +- Demo Sensor - Added device_class support ([@cdce8p] - [#14269]) ([sensor.demo docs]) +- Re-enable eliqonline requirement ([@molobrakos] - [#14265]) ([sensor.eliqonline docs]) +- Add fetching camera thumbnails over websocket ([@balloob] - [#14231]) ([camera docs]) ([frontend docs]) ([image_processing docs]) ([microsoft_face docs]) ([websocket_api docs]) +- Allow fetching media player covers via websocket connection ([@balloob] - [#14233]) ([media_player docs]) +- Fix ZWave light brightness ([@cdce8p] - [#14261]) ([light.zwave docs]) +- fix check config not working after #14211 ([@fanthos] - [#14259]) +- Issue Template Fix CRLF ([@OttoWinter] - [#14283]) +- Upgrade attrs to 18.1.0 ([@fabaff] - [#14281]) +- Update HAP-python to 2.0.0 ([@cdce8p] - [#14278]) ([homekit docs]) +- Upgrade holidays to 0.9.5 ([@fabaff] - [#14274]) ([binary_sensor.workday docs]) +- Homekit: Changed device_class requirement Humidity Sensor ([@cdce8p] - [#14277]) ([homekit docs]) (breaking change) +- HomeKit: Support triggered state for alarm_control_panel ([@schmittx] - [#14285]) ([homekit docs]) +- Upgrade astral to 1.6.1 ([@fabaff] - [#14297]) +- BOM Weather throttle fix ([@nickw444] - [#14234]) ([sensor.bom docs]) +- Publish attributes unconditionally ([@blackwind] - [#14179]) ([mqtt_statestream docs]) +- Sensor device classes ([@cdce8p] - [#14282]) ([sensor docs]) (breaking change) +- Matrix Chatbot ([@tinloaf] - [#13355]) ([matrix docs]) ([notify docs]) (breaking change) (new-platform) +- deCONZ add new device without restart ([@Kane610] - [#14221]) ([deconz docs]) ([binary_sensor.deconz docs]) ([light.deconz docs]) ([sensor.deconz docs]) +- Add alarmdotcom sensor status ([@jnewland] - [#14254]) ([alarm_control_panel.alarmdotcom docs]) +- Add domain to labels and count state changes to Prometheus ([@jnewland] - [#14253]) ([prometheus docs]) +- Add support for max_volume ([@relvacode] - [#13822]) ([media_player.onkyo docs]) +- Refactor ImageProcessingFaceEntity ([@robmarkcole] - [#14296]) ([image_processing docs]) ([image_processing.demo docs]) ([image_processing.dlib_face_detect docs]) ([image_processing.dlib_face_identify docs]) ([image_processing.microsoft_face_detect docs]) ([image_processing.microsoft_face_identify docs]) +- Onkyo: SUPPORT_VOLUME_STEP ([@rsmeral] - [#14299]) ([media_player.onkyo docs]) +- Add All-Linking capabilities ([@teharris1] - [#14065]) ([insteon_plm docs]) ([binary_sensor.insteon_plm docs]) ([fan.insteon_plm docs]) ([light.insteon_plm docs]) ([sensor.insteon_plm docs]) ([switch.insteon_plm docs]) + +[#12027]: https://github.com/home-assistant/home-assistant/pull/12027 +[#12060]: https://github.com/home-assistant/home-assistant/pull/12060 +[#12366]: https://github.com/home-assistant/home-assistant/pull/12366 +[#12528]: https://github.com/home-assistant/home-assistant/pull/12528 +[#12833]: https://github.com/home-assistant/home-assistant/pull/12833 +[#13249]: https://github.com/home-assistant/home-assistant/pull/13249 +[#13311]: https://github.com/home-assistant/home-assistant/pull/13311 +[#13331]: https://github.com/home-assistant/home-assistant/pull/13331 +[#13350]: https://github.com/home-assistant/home-assistant/pull/13350 +[#13355]: https://github.com/home-assistant/home-assistant/pull/13355 +[#13468]: https://github.com/home-assistant/home-assistant/pull/13468 +[#13540]: https://github.com/home-assistant/home-assistant/pull/13540 +[#13541]: https://github.com/home-assistant/home-assistant/pull/13541 +[#13553]: https://github.com/home-assistant/home-assistant/pull/13553 +[#13822]: https://github.com/home-assistant/home-assistant/pull/13822 +[#13954]: https://github.com/home-assistant/home-assistant/pull/13954 +[#13955]: https://github.com/home-assistant/home-assistant/pull/13955 +[#13967]: https://github.com/home-assistant/home-assistant/pull/13967 +[#13968]: https://github.com/home-assistant/home-assistant/pull/13968 +[#13971]: https://github.com/home-assistant/home-assistant/pull/13971 +[#13976]: https://github.com/home-assistant/home-assistant/pull/13976 +[#13985]: https://github.com/home-assistant/home-assistant/pull/13985 +[#13990]: https://github.com/home-assistant/home-assistant/pull/13990 +[#14007]: https://github.com/home-assistant/home-assistant/pull/14007 +[#14011]: https://github.com/home-assistant/home-assistant/pull/14011 +[#14016]: https://github.com/home-assistant/home-assistant/pull/14016 +[#14018]: https://github.com/home-assistant/home-assistant/pull/14018 +[#14022]: https://github.com/home-assistant/home-assistant/pull/14022 +[#14026]: https://github.com/home-assistant/home-assistant/pull/14026 +[#14029]: https://github.com/home-assistant/home-assistant/pull/14029 +[#14033]: https://github.com/home-assistant/home-assistant/pull/14033 +[#14034]: https://github.com/home-assistant/home-assistant/pull/14034 +[#14039]: https://github.com/home-assistant/home-assistant/pull/14039 +[#14044]: https://github.com/home-assistant/home-assistant/pull/14044 +[#14045]: https://github.com/home-assistant/home-assistant/pull/14045 +[#14056]: https://github.com/home-assistant/home-assistant/pull/14056 +[#14058]: https://github.com/home-assistant/home-assistant/pull/14058 +[#14059]: https://github.com/home-assistant/home-assistant/pull/14059 +[#14060]: https://github.com/home-assistant/home-assistant/pull/14060 +[#14065]: https://github.com/home-assistant/home-assistant/pull/14065 +[#14067]: https://github.com/home-assistant/home-assistant/pull/14067 +[#14070]: https://github.com/home-assistant/home-assistant/pull/14070 +[#14075]: https://github.com/home-assistant/home-assistant/pull/14075 +[#14076]: https://github.com/home-assistant/home-assistant/pull/14076 +[#14082]: https://github.com/home-assistant/home-assistant/pull/14082 +[#14085]: https://github.com/home-assistant/home-assistant/pull/14085 +[#14095]: https://github.com/home-assistant/home-assistant/pull/14095 +[#14099]: https://github.com/home-assistant/home-assistant/pull/14099 +[#14102]: https://github.com/home-assistant/home-assistant/pull/14102 +[#14110]: https://github.com/home-assistant/home-assistant/pull/14110 +[#14114]: https://github.com/home-assistant/home-assistant/pull/14114 +[#14115]: https://github.com/home-assistant/home-assistant/pull/14115 +[#14117]: https://github.com/home-assistant/home-assistant/pull/14117 +[#14131]: https://github.com/home-assistant/home-assistant/pull/14131 +[#14132]: https://github.com/home-assistant/home-assistant/pull/14132 +[#14135]: https://github.com/home-assistant/home-assistant/pull/14135 +[#14136]: https://github.com/home-assistant/home-assistant/pull/14136 +[#14137]: https://github.com/home-assistant/home-assistant/pull/14137 +[#14138]: https://github.com/home-assistant/home-assistant/pull/14138 +[#14139]: https://github.com/home-assistant/home-assistant/pull/14139 +[#14140]: https://github.com/home-assistant/home-assistant/pull/14140 +[#14142]: https://github.com/home-assistant/home-assistant/pull/14142 +[#14143]: https://github.com/home-assistant/home-assistant/pull/14143 +[#14144]: https://github.com/home-assistant/home-assistant/pull/14144 +[#14147]: https://github.com/home-assistant/home-assistant/pull/14147 +[#14151]: https://github.com/home-assistant/home-assistant/pull/14151 +[#14152]: https://github.com/home-assistant/home-assistant/pull/14152 +[#14153]: https://github.com/home-assistant/home-assistant/pull/14153 +[#14156]: https://github.com/home-assistant/home-assistant/pull/14156 +[#14157]: https://github.com/home-assistant/home-assistant/pull/14157 +[#14172]: https://github.com/home-assistant/home-assistant/pull/14172 +[#14174]: https://github.com/home-assistant/home-assistant/pull/14174 +[#14179]: https://github.com/home-assistant/home-assistant/pull/14179 +[#14180]: https://github.com/home-assistant/home-assistant/pull/14180 +[#14186]: https://github.com/home-assistant/home-assistant/pull/14186 +[#14187]: https://github.com/home-assistant/home-assistant/pull/14187 +[#14195]: https://github.com/home-assistant/home-assistant/pull/14195 +[#14197]: https://github.com/home-assistant/home-assistant/pull/14197 +[#14201]: https://github.com/home-assistant/home-assistant/pull/14201 +[#14203]: https://github.com/home-assistant/home-assistant/pull/14203 +[#14207]: https://github.com/home-assistant/home-assistant/pull/14207 +[#14210]: https://github.com/home-assistant/home-assistant/pull/14210 +[#14211]: https://github.com/home-assistant/home-assistant/pull/14211 +[#14214]: https://github.com/home-assistant/home-assistant/pull/14214 +[#14215]: https://github.com/home-assistant/home-assistant/pull/14215 +[#14220]: https://github.com/home-assistant/home-assistant/pull/14220 +[#14221]: https://github.com/home-assistant/home-assistant/pull/14221 +[#14225]: https://github.com/home-assistant/home-assistant/pull/14225 +[#14231]: https://github.com/home-assistant/home-assistant/pull/14231 +[#14233]: https://github.com/home-assistant/home-assistant/pull/14233 +[#14234]: https://github.com/home-assistant/home-assistant/pull/14234 +[#14235]: https://github.com/home-assistant/home-assistant/pull/14235 +[#14253]: https://github.com/home-assistant/home-assistant/pull/14253 +[#14254]: https://github.com/home-assistant/home-assistant/pull/14254 +[#14259]: https://github.com/home-assistant/home-assistant/pull/14259 +[#14261]: https://github.com/home-assistant/home-assistant/pull/14261 +[#14265]: https://github.com/home-assistant/home-assistant/pull/14265 +[#14269]: https://github.com/home-assistant/home-assistant/pull/14269 +[#14274]: https://github.com/home-assistant/home-assistant/pull/14274 +[#14277]: https://github.com/home-assistant/home-assistant/pull/14277 +[#14278]: https://github.com/home-assistant/home-assistant/pull/14278 +[#14281]: https://github.com/home-assistant/home-assistant/pull/14281 +[#14282]: https://github.com/home-assistant/home-assistant/pull/14282 +[#14283]: https://github.com/home-assistant/home-assistant/pull/14283 +[#14285]: https://github.com/home-assistant/home-assistant/pull/14285 +[#14296]: https://github.com/home-assistant/home-assistant/pull/14296 +[#14297]: https://github.com/home-assistant/home-assistant/pull/14297 +[#14299]: https://github.com/home-assistant/home-assistant/pull/14299 +[@CM000n]: https://github.com/CM000n +[@Hate-Usernames]: https://github.com/Hate-Usernames +[@Kane610]: https://github.com/Kane610 +[@MatMaul]: https://github.com/MatMaul +[@NovapaX]: https://github.com/NovapaX +[@OttoWinter]: https://github.com/OttoWinter +[@amelchio]: https://github.com/amelchio +[@andrey-git]: https://github.com/andrey-git +[@bachya]: https://github.com/bachya +[@bakedraccoon]: https://github.com/bakedraccoon +[@balloob]: https://github.com/balloob +[@bieniu]: https://github.com/bieniu +[@blackwind]: https://github.com/blackwind +[@c727]: https://github.com/c727 +[@cdce8p]: https://github.com/cdce8p +[@cgarwood]: https://github.com/cgarwood +[@colinodell]: https://github.com/colinodell +[@corneyl]: https://github.com/corneyl +[@danielhiversen]: https://github.com/danielhiversen +[@danielperna84]: https://github.com/danielperna84 +[@dgomes]: https://github.com/dgomes +[@dgraye]: https://github.com/dgraye +[@dingusdk]: https://github.com/dingusdk +[@dlbroadfoot]: https://github.com/dlbroadfoot +[@engrbm87]: https://github.com/engrbm87 +[@escoand]: https://github.com/escoand +[@fabaff]: https://github.com/fabaff +[@fanthos]: https://github.com/fanthos +[@giangvo]: https://github.com/giangvo +[@gives1976]: https://github.com/gives1976 +[@iMicknl]: https://github.com/iMicknl +[@ileler]: https://github.com/ileler +[@jnewland]: https://github.com/jnewland +[@maddox]: https://github.com/maddox +[@marthoc]: https://github.com/marthoc +[@masarliev]: https://github.com/masarliev +[@meauxt]: https://github.com/meauxt +[@mezz64]: https://github.com/mezz64 +[@molobrakos]: https://github.com/molobrakos +[@msubra]: https://github.com/msubra +[@mvn23]: https://github.com/mvn23 +[@mxworm]: https://github.com/mxworm +[@nickw444]: https://github.com/nickw444 +[@oblogic7]: https://github.com/oblogic7 +[@perosb]: https://github.com/perosb +[@pschmitt]: https://github.com/pschmitt +[@ratcashdev]: https://github.com/ratcashdev +[@rcloran]: https://github.com/rcloran +[@rdbahm]: https://github.com/rdbahm +[@relvacode]: https://github.com/relvacode +[@robmarkcole]: https://github.com/robmarkcole +[@roiff]: https://github.com/roiff +[@rsmeral]: https://github.com/rsmeral +[@rubenvandeven]: https://github.com/rubenvandeven +[@sander76]: https://github.com/sander76 +[@schmittx]: https://github.com/schmittx +[@scop]: https://github.com/scop +[@stephanerosi]: https://github.com/stephanerosi +[@stintel]: https://github.com/stintel +[@syssi]: https://github.com/syssi +[@teharris1]: https://github.com/teharris1 +[@thelittlefireman]: https://github.com/thelittlefireman +[@tinloaf]: https://github.com/tinloaf +[alarm_control_panel.alarmdotcom docs]: /components/alarm_control_panel.alarmdotcom/ +[auth docs]: /components/auth/ +[binary_sensor docs]: /components/binary_sensor/ +[binary_sensor.deconz docs]: /components/binary_sensor.deconz/ +[binary_sensor.insteon_plm docs]: /components/binary_sensor.insteon_plm/ +[binary_sensor.tapsaff docs]: /components/binary_sensor.tapsaff/ +[binary_sensor.trend docs]: /components/binary_sensor.trend/ +[binary_sensor.workday docs]: /components/binary_sensor.workday/ +[binary_sensor.xiaomi_aqara docs]: /components/binary_sensor.xiaomi_aqara/ +[binary_sensor.zha docs]: /components/binary_sensor.zha/ +[camera docs]: /components/camera/ +[camera.local_file docs]: /components/camera.local_file/ +[cover.gogogate2 docs]: /components/cover.gogogate2/ +[cover.tahoma docs]: /components/cover.tahoma/ +[deconz docs]: /components/deconz/ +[device_tracker docs]: /components/device_tracker/ +[eight_sleep docs]: /components/eight_sleep/ +[emulated_hue docs]: /components/emulated_hue/ +[fan.insteon_plm docs]: /components/fan.insteon_plm/ +[fan.template docs]: /components/fan.template/ +[frontend docs]: /components/frontend/ +[homekit docs]: /components/homekit/ +[homematic docs]: /components/homematic/ +[homematicip_cloud docs]: /components/homematicip_cloud/ +[http docs]: /components/http/ +[image_processing docs]: /components/image_processing/ +[image_processing.demo docs]: /components/image_processing.demo/ +[image_processing.dlib_face_detect docs]: /components/image_processing.dlib_face_detect/ +[image_processing.dlib_face_identify docs]: /components/image_processing.dlib_face_identify/ +[image_processing.microsoft_face_detect docs]: /components/image_processing.microsoft_face_detect/ +[image_processing.microsoft_face_identify docs]: /components/image_processing.microsoft_face_identify/ +[image_processing.opencv docs]: /components/image_processing.opencv/ +[insteon_plm docs]: /components/insteon_plm/ +[light.deconz docs]: /components/light.deconz/ +[light.flux_led docs]: /components/light.flux_led/ +[light.insteon_plm docs]: /components/light.insteon_plm/ +[light.mqtt_json docs]: /components/light.mqtt_json/ +[light.xiaomi_aqara docs]: /components/light.xiaomi_aqara/ +[light.yeelight docs]: /components/light.yeelight/ +[light.zwave docs]: /components/light.zwave/ +[matrix docs]: /components/matrix/ +[maxcube docs]: /components/maxcube/ +[media_extractor docs]: /components/media_extractor/ +[media_player docs]: /components/media_player/ +[media_player.blackbird docs]: /components/media_player.blackbird/ +[media_player.onkyo docs]: /components/media_player.onkyo/ +[media_player.panasonic_viera docs]: /components/media_player.panasonic_viera/ +[media_player.sonos docs]: /components/media_player.sonos/ +[media_player.vizio docs]: /components/media_player.vizio/ +[media_player.volumio docs]: /components/media_player.volumio/ +[media_player.webostv docs]: /components/media_player.webostv/ +[microsoft_face docs]: /components/microsoft_face/ +[mqtt docs]: /components/mqtt/ +[mqtt_statestream docs]: /components/mqtt_statestream/ +[notify docs]: /components/notify/ +[prometheus docs]: /components/prometheus/ +[python_script docs]: /components/python_script/ +[rainmachine docs]: /components/rainmachine/ +[rfxtrx docs]: /components/rfxtrx/ +[scene docs]: /components/scene/ +[scene.deconz docs]: /components/scene.deconz/ +[sensor docs]: /components/sensor/ +[sensor.bom docs]: /components/sensor.bom/ +[sensor.buienradar docs]: /components/sensor.buienradar/ +[sensor.darksky docs]: /components/sensor.darksky/ +[sensor.deconz docs]: /components/sensor.deconz/ +[sensor.deluge docs]: /components/sensor.deluge/ +[sensor.demo docs]: /components/sensor.demo/ +[sensor.domain_expiry docs]: /components/sensor.domain_expiry/ +[sensor.dsmr docs]: /components/sensor.dsmr/ +[sensor.eliqonline docs]: /components/sensor.eliqonline/ +[sensor.homematicip_cloud docs]: /components/sensor.homematicip_cloud/ +[sensor.insteon_plm docs]: /components/sensor.insteon_plm/ +[sensor.lastfm docs]: /components/sensor.lastfm/ +[sensor.mitemp_bt docs]: /components/sensor.mitemp_bt/ +[sensor.mqtt docs]: /components/sensor.mqtt/ +[sensor.pollen docs]: /components/sensor.pollen/ +[sensor.postnl docs]: /components/sensor.postnl/ +[sensor.qnap docs]: /components/sensor.qnap/ +[sensor.socialblade docs]: /components/sensor.socialblade/ +[sensor.sql docs]: /components/sensor.sql/ +[sensor.tahoma docs]: /components/sensor.tahoma/ +[sensor.template docs]: /components/sensor.template/ +[sensor.upnp docs]: /components/sensor.upnp/ +[sensor.uscis docs]: /components/sensor.uscis/ +[sensor.wunderground docs]: /components/sensor.wunderground/ +[sensor.xiaomi_aqara docs]: /components/sensor.xiaomi_aqara/ +[sensor.yweather docs]: /components/sensor.yweather/ +[switch.deluge docs]: /components/switch.deluge/ +[switch.fritzbox docs]: /components/switch.fritzbox/ +[switch.insteon_plm docs]: /components/switch.insteon_plm/ +[switch.mqtt docs]: /components/switch.mqtt/ +[switch.rainmachine docs]: /components/switch.rainmachine/ +[switch.xiaomi_aqara docs]: /components/switch.xiaomi_aqara/ +[system_log docs]: /components/system_log/ +[tahoma docs]: /components/tahoma/ +[upnp docs]: /components/upnp/ +[weather docs]: /components/weather/ +[weather.buienradar docs]: /components/weather.buienradar/ +[weather.darksky docs]: /components/weather.darksky/ +[weather.openweathermap docs]: /components/weather.openweathermap/ +[websocket_api docs]: /components/websocket_api/ +[xiaomi_aqara docs]: /components/xiaomi_aqara/ +[zha docs]: /components/zha/ +[zone docs]: /components/zone/ +[zwave docs]: /components/zwave/ From e46a4d4f3f1fa5b67021e89bd11dbc25f3bcad8f Mon Sep 17 00:00:00 2001 From: Tom Harris Date: Sat, 5 May 2018 15:08:41 -0400 Subject: [PATCH 225/241] Describe the new services added (#5239) * Describe the new services added * Edits per review * UTF-8 error * UTF-8 Error * Convert to utf-8 --- source/_components/insteon_plm.markdown | 55 ++++++++++++++++++------- 1 file changed, 41 insertions(+), 14 deletions(-) diff --git a/source/_components/insteon_plm.markdown b/source/_components/insteon_plm.markdown index 58a1bad12c..9e15bb0f7d 100644 --- a/source/_components/insteon_plm.markdown +++ b/source/_components/insteon_plm.markdown @@ -63,26 +63,52 @@ a responder or a controller. In order for any two Insteon devices to talk with one another, they must be linked. For an overview of device linking please read the Insteon page on -[understanding linking]. Currently Insteon PLM does not support software -linking of devices. If you need software that can link your devices (if you -are using a USB Stick PLM for example), you can download [HouseLinc] which runs -on any Windows PC, or you can use [Insteon Terminal] which is open source and -runs on most platforms. HouseLinc is no longer supported by SmartHome but it -still works. Insteon Terminal is a very useful tool but please read the -disclaimers carefully, they are important. +[understanding linking]. The Insteon PLM module supports All-Linking through +[Development Tools] service calls. The following services are available: + +In order for any two Insteon devices to talk with one another, they must be +linked. For an overview of device linking, please read the Insteon page on +[understanding linking]. The Insteon PLM module supports All-Linking through +[Development Tools] service calls. The following services are available: +- **insteon_plm.add_all_link**: Tells the Insteon Modem (IM) start All-Linking +mode. Once the IM is in All-Linking mode, press the link button on the device +to complete All-Linking. +- **insteon_plm.delete_all_link**: Tells the Insteon Modem (IM) to remove an +All-Link record from the All-Link Database of the IM and a device. Once the IM +is set to delete the link, press the link button on the corresponding device +to complete the process. +- **insteon_plm.load_all_link_database**: Load the All-Link Database for a +device. WARNING - Loading a device All-Link database is very time consuming +and inconsistent. This may take a LONG time and may need to be repeated to +obtain all records. +- **insteon_plm.print_all_link_database**: Print the All-Link Database for a +device. Requires that the All-Link Database is loaded into memory. +- **insteon_plm.print_im_all_link_database**: Print the All-Link Database for +the INSTEON Modem (IM). + +If you are looking for more advanced options, you can use the +[insteonplm_interactive] command line tool that is distributed with the +[insteonplm] Python module. Please see the documentation on the [insteonplm] +GitHub site. Alternatively, you can download [HouseLinc] which runs on any +Windows PC, or you can use [Insteon Terminal] which is open source and runs +on most platforms. SmartHome no longer supports HouseLinc, but it still +works. Insteon Terminal is a very useful tool but please read the disclaimers +carefully, they are important. [understanding linking]: http://www.insteon.com/support-knowledgebase/2015/1/28/understanding-linking +[Development Tools]: https://www.home-assistant.io/docs/tools/dev-tools/ [HouseLinc]: https://www.smarthome.com/houselinc.html [Insteon Terminal]: https://github.com/pfrommerd/insteon-terminal +[insteonplm_interactive]: https://github.com/nugget/python-insteonplm#command-line-interface ### {% linkable_title Customization %} -The only configuration item that is absolutely necessary is the port so that -Home Assistant can connect to the PLM. This will expose all the supported INSTEON -devices which exist in the modem's ALL-Link database. However, devices will -only be shown by their INSTEON hex address (e.g., "1A.2B.3C") which can be a bit -unwieldy. As you link and unlink devices using the 'Set' buttons, they'll be -added and removed from Home Assistant automatically. +The only configuration item that is absolutely necessary is the port so that +Home Assistant can connect to the PLM. This will expose all the supported +INSTEON devices which exist in the modem’s ALL-Link database. However, devices +will only be shown by their INSTEON hex address (e.g., “1A.2B.3C”) which can +be a bit unwieldy. As you link and unlink devices using the ‘Set’ buttons, +they’ll be added and removed from Home Assistant automatically. You can use the normal Home Assistant [device customization] section of your configuration to assign friendly names and special icons to your devices. This @@ -123,7 +149,9 @@ insteon_plm: cat: 0x10 subcat: 0x11 ``` + ### {% linkable_title What NOT to do %} + Insteon PLM is a top level component and device discovery will identify the Home Assistant platform the device belongs in. As such, do not declare Insteon devices in other platforms. For example, this configuration @@ -134,4 +162,3 @@ light: - platform: insteon_plm address: 1a2b3c ``` - From 669b736ac16f32df427afa631258303d84c71a10 Mon Sep 17 00:00:00 2001 From: Tom Harris Date: Sat, 5 May 2018 15:08:41 -0400 Subject: [PATCH 226/241] Describe the new services added (#5239) * Describe the new services added * Edits per review * UTF-8 error * UTF-8 Error * Convert to utf-8 --- source/_components/insteon_plm.markdown | 55 ++++++++++++++++++------- 1 file changed, 41 insertions(+), 14 deletions(-) diff --git a/source/_components/insteon_plm.markdown b/source/_components/insteon_plm.markdown index 58a1bad12c..9e15bb0f7d 100644 --- a/source/_components/insteon_plm.markdown +++ b/source/_components/insteon_plm.markdown @@ -63,26 +63,52 @@ a responder or a controller. In order for any two Insteon devices to talk with one another, they must be linked. For an overview of device linking please read the Insteon page on -[understanding linking]. Currently Insteon PLM does not support software -linking of devices. If you need software that can link your devices (if you -are using a USB Stick PLM for example), you can download [HouseLinc] which runs -on any Windows PC, or you can use [Insteon Terminal] which is open source and -runs on most platforms. HouseLinc is no longer supported by SmartHome but it -still works. Insteon Terminal is a very useful tool but please read the -disclaimers carefully, they are important. +[understanding linking]. The Insteon PLM module supports All-Linking through +[Development Tools] service calls. The following services are available: + +In order for any two Insteon devices to talk with one another, they must be +linked. For an overview of device linking, please read the Insteon page on +[understanding linking]. The Insteon PLM module supports All-Linking through +[Development Tools] service calls. The following services are available: +- **insteon_plm.add_all_link**: Tells the Insteon Modem (IM) start All-Linking +mode. Once the IM is in All-Linking mode, press the link button on the device +to complete All-Linking. +- **insteon_plm.delete_all_link**: Tells the Insteon Modem (IM) to remove an +All-Link record from the All-Link Database of the IM and a device. Once the IM +is set to delete the link, press the link button on the corresponding device +to complete the process. +- **insteon_plm.load_all_link_database**: Load the All-Link Database for a +device. WARNING - Loading a device All-Link database is very time consuming +and inconsistent. This may take a LONG time and may need to be repeated to +obtain all records. +- **insteon_plm.print_all_link_database**: Print the All-Link Database for a +device. Requires that the All-Link Database is loaded into memory. +- **insteon_plm.print_im_all_link_database**: Print the All-Link Database for +the INSTEON Modem (IM). + +If you are looking for more advanced options, you can use the +[insteonplm_interactive] command line tool that is distributed with the +[insteonplm] Python module. Please see the documentation on the [insteonplm] +GitHub site. Alternatively, you can download [HouseLinc] which runs on any +Windows PC, or you can use [Insteon Terminal] which is open source and runs +on most platforms. SmartHome no longer supports HouseLinc, but it still +works. Insteon Terminal is a very useful tool but please read the disclaimers +carefully, they are important. [understanding linking]: http://www.insteon.com/support-knowledgebase/2015/1/28/understanding-linking +[Development Tools]: https://www.home-assistant.io/docs/tools/dev-tools/ [HouseLinc]: https://www.smarthome.com/houselinc.html [Insteon Terminal]: https://github.com/pfrommerd/insteon-terminal +[insteonplm_interactive]: https://github.com/nugget/python-insteonplm#command-line-interface ### {% linkable_title Customization %} -The only configuration item that is absolutely necessary is the port so that -Home Assistant can connect to the PLM. This will expose all the supported INSTEON -devices which exist in the modem's ALL-Link database. However, devices will -only be shown by their INSTEON hex address (e.g., "1A.2B.3C") which can be a bit -unwieldy. As you link and unlink devices using the 'Set' buttons, they'll be -added and removed from Home Assistant automatically. +The only configuration item that is absolutely necessary is the port so that +Home Assistant can connect to the PLM. This will expose all the supported +INSTEON devices which exist in the modem’s ALL-Link database. However, devices +will only be shown by their INSTEON hex address (e.g., “1A.2B.3C”) which can +be a bit unwieldy. As you link and unlink devices using the ‘Set’ buttons, +they’ll be added and removed from Home Assistant automatically. You can use the normal Home Assistant [device customization] section of your configuration to assign friendly names and special icons to your devices. This @@ -123,7 +149,9 @@ insteon_plm: cat: 0x10 subcat: 0x11 ``` + ### {% linkable_title What NOT to do %} + Insteon PLM is a top level component and device discovery will identify the Home Assistant platform the device belongs in. As such, do not declare Insteon devices in other platforms. For example, this configuration @@ -134,4 +162,3 @@ light: - platform: insteon_plm address: 1a2b3c ``` - From e9aad886413c9c8a5018a8410616c7c9ffe9def2 Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 6 May 2018 08:54:51 -0400 Subject: [PATCH 227/241] Fix broken templating --- source/_components/fan.template.markdown | 2 +- source/_docs/configuration/templating.markdown | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_components/fan.template.markdown b/source/_components/fan.template.markdown index 2b7a984508..9868a85639 100644 --- a/source/_components/fan.template.markdown +++ b/source/_components/fan.template.markdown @@ -61,7 +61,7 @@ fan: required: false type: string value_template: - description: "Defines a template to get the state of the fan. Valid value: 'on'/'off' + description: "Defines a template to get the state of the fan. Valid value: 'on'/'off'" required: true type: template speed_template: diff --git a/source/_docs/configuration/templating.markdown b/source/_docs/configuration/templating.markdown index 9eafdece87..dfcd8bddce 100644 --- a/source/_docs/configuration/templating.markdown +++ b/source/_docs/configuration/templating.markdown @@ -140,7 +140,7 @@ With strings ```text {% raw %}{% set tracker_name = "paulus"%} - + {% if states("device_tracker." + tracker_name) != "unknown" %} {{ state_attr("device_tracker." + tracker_name, "battery")}} {% else %} From 3ca0be1d3fca38a08b97658eaaca031c5a7cc6be Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 6 May 2018 10:15:03 -0400 Subject: [PATCH 228/241] Another yaml mistake --- source/_components/fan.template.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/fan.template.markdown b/source/_components/fan.template.markdown index 9868a85639..5ebd666594 100644 --- a/source/_components/fan.template.markdown +++ b/source/_components/fan.template.markdown @@ -69,7 +69,7 @@ fan: required: false type: template oscillating_template: - description: Defines a template to get the osc state of the fan. Valid value: True/False + description: "Defines a template to get the osc state of the fan. Valid value: True/False" required: false type: template turn_on: From 536ed8557fd5d513d5942f7ea825a7b5c245bd51 Mon Sep 17 00:00:00 2001 From: Otto Winter Date: Sun, 6 May 2018 23:15:58 +0200 Subject: [PATCH 229/241] Change to advertise esphomeyaml (#5318) --- source/_docs/mqtt/discovery.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_docs/mqtt/discovery.markdown b/source/_docs/mqtt/discovery.markdown index e238c1777f..27b588f015 100644 --- a/source/_docs/mqtt/discovery.markdown +++ b/source/_docs/mqtt/discovery.markdown @@ -56,7 +56,7 @@ The `` level can be used by clients to only subscribe to their own (com The following firmware for ESP8266, ESP32 and Sonoff unit has built-in support for MQTT discovery: - [Sonoff-Tasmota](https://github.com/arendst/Sonoff-Tasmota) (starting with 5.11.1e) -- [esphomelib](https://github.com/OttoWinter/esphomelib) +- [esphomeyaml](https://esphomelib.com/esphomeyaml/index.html) - [ESPurna](https://github.com/xoseperez/espurna) - [Arilux AL-LC0X LED controllers](https://github.com/mertenats/Arilux_AL-LC0X) From 68aa5a339ffb0bcf4d20e155200d8c63be1254a9 Mon Sep 17 00:00:00 2001 From: MithrasPan <31153922+MithrasPan@users.noreply.github.com> Date: Sun, 6 May 2018 16:16:23 -0500 Subject: [PATCH 230/241] Update remember_the_milk.markdown (#5317) small typo (Rember->Remember) --- source/_components/remember_the_milk.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/remember_the_milk.markdown b/source/_components/remember_the_milk.markdown index 62d7deab2a..70abbed77e 100644 --- a/source/_components/remember_the_milk.markdown +++ b/source/_components/remember_the_milk.markdown @@ -51,7 +51,7 @@ Configuration variables: ### {% linkable_title Step 2: registering your account %} -After saving the configuration, you need to (re-)start Home Assistant. On the first start you will notice a new "Configuration" panel appearing on the Home Assistant page. After opening the configuration page, follow the link "Remember The Milk login". This will take you to a login page where you have to log in with your normal Rember The Milk credentials. This will authorize Home Assistant to access your Remember The Milk account. +After saving the configuration, you need to (re-)start Home Assistant. On the first start you will notice a new "Configuration" panel appearing on the Home Assistant page. After opening the configuration page, follow the link "Remember The Milk login". This will take you to a login page where you have to log in with your normal Remember The Milk credentials. This will authorize Home Assistant to access your Remember The Milk account. After that click on the "login completed" button. This will tell Home Assistant that you have completed the login process on the Remember The Milk page and Home Assistant should try to register with this account. From c46f152d8deb25bbf0fa131c6bd10f60a56010aa Mon Sep 17 00:00:00 2001 From: stephanerosi Date: Sun, 6 May 2018 23:58:57 +0200 Subject: [PATCH 231/241] Add help on converation/process service (#5320) --- source/_components/conversation.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_components/conversation.markdown b/source/_components/conversation.markdown index d9dff87aa5..e9bb86aaab 100644 --- a/source/_components/conversation.markdown +++ b/source/_components/conversation.markdown @@ -87,3 +87,9 @@ intent_script: - "{% if color == 'blue' %}255{% else %}0{% endif %}" {% endraw %} ``` + +#### {% linkable_title Service `conversation.process` %} + +| Service data attribute | Optional | Description | +|------------------------|----------|--------------------------------------------------| +| `text` | yes | Transcribed text | From b749b17ed225f6043dc544d5bf31e44190133b7c Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Mon, 7 May 2018 10:05:23 -0400 Subject: [PATCH 232/241] Update blog post --- source/_posts/2018-05-11-release-69.markdown | 26 ++++++++++++++++++-- 1 file changed, 24 insertions(+), 2 deletions(-) diff --git a/source/_posts/2018-05-11-release-69.markdown b/source/_posts/2018-05-11-release-69.markdown index 988d2b6cca..4063660e8c 100644 --- a/source/_posts/2018-05-11-release-69.markdown +++ b/source/_posts/2018-05-11-release-69.markdown @@ -47,11 +47,20 @@ Experiencing issues introduced by this release? Please report them in our [issue - Sensor device classes ([@cdce8p] - [#14282]) ([sensor docs]) (breaking change) - Matrix Chatbot ([@tinloaf] - [#13355]) ([matrix docs]) ([notify docs]) (breaking change) (new-platform) +## {% linkable_title Beta Fixes %} + +- Add missing 'sensor' to ABODE_PLATFORMS ([@jloutsenhizer] - [#14313]) ([abode docs]) (beta fix) +- Add debounce to move_cover ([@cdce8p] - [#14314]) ([homekit docs]) (beta fix) +- Fix module names for custom components ([@balloob] - [#14317]) (beta fix) +- Revert custom component loading logic ([@balloob] - [#14327]) (beta fix) +- fix(hbmqtt): partial packets breaking hbmqtt ([@graffic] - [#14329]) ([mqtt docs]) (beta fix) +- Fix Yeelight naming ([@syssi]) + ## {% linkable_title All changes %} - Pollen.com: Added attributes on top 3 allergens ([@bachya] - [#14018]) ([sensor.pollen docs]) (breaking change) - Expose the condition code on condition sensors ([@maddox] - [#14011]) ([sensor.yweather docs]) -- upgrade rfxtrx lib, dimming support for Lighting3 ([@danielhiversen] - [#14026]) ([rfxtrx docs]) +- upgrade rfxtrx lib, dimming support for Lighting3 ([@Danielhiversen] - [#14026]) ([rfxtrx docs]) - Add Accuracy to Google Location Sharing ([@rdbahm] - [#14039]) ([device_tracker docs]) - bump gogogate2 version ([@dlbroadfoot] - [#14044]) ([cover.gogogate2 docs]) - device_tracker.ubus: catch ConnectionError ([@stintel] - [#14045]) ([device_tracker docs]) @@ -157,6 +166,11 @@ Experiencing issues introduced by this release? Please report them in our [issue - Refactor ImageProcessingFaceEntity ([@robmarkcole] - [#14296]) ([image_processing docs]) ([image_processing.demo docs]) ([image_processing.dlib_face_detect docs]) ([image_processing.dlib_face_identify docs]) ([image_processing.microsoft_face_detect docs]) ([image_processing.microsoft_face_identify docs]) - Onkyo: SUPPORT_VOLUME_STEP ([@rsmeral] - [#14299]) ([media_player.onkyo docs]) - Add All-Linking capabilities ([@teharris1] - [#14065]) ([insteon_plm docs]) ([binary_sensor.insteon_plm docs]) ([fan.insteon_plm docs]) ([light.insteon_plm docs]) ([sensor.insteon_plm docs]) ([switch.insteon_plm docs]) +- Add missing 'sensor' to ABODE_PLATFORMS ([@jloutsenhizer] - [#14313]) ([abode docs]) (beta fix) +- Add debounce to move_cover ([@cdce8p] - [#14314]) ([homekit docs]) (beta fix) +- Fix module names for custom components ([@balloob] - [#14317]) (beta fix) +- Revert custom component loading logic ([@balloob] - [#14327]) (beta fix) +- fix(hbmqtt): partial packets breaking hbmqtt ([@graffic] - [#14329]) ([mqtt docs]) (beta fix) [#12027]: https://github.com/home-assistant/home-assistant/pull/12027 [#12060]: https://github.com/home-assistant/home-assistant/pull/12060 @@ -266,7 +280,13 @@ Experiencing issues introduced by this release? Please report them in our [issue [#14296]: https://github.com/home-assistant/home-assistant/pull/14296 [#14297]: https://github.com/home-assistant/home-assistant/pull/14297 [#14299]: https://github.com/home-assistant/home-assistant/pull/14299 +[#14313]: https://github.com/home-assistant/home-assistant/pull/14313 +[#14314]: https://github.com/home-assistant/home-assistant/pull/14314 +[#14317]: https://github.com/home-assistant/home-assistant/pull/14317 +[#14327]: https://github.com/home-assistant/home-assistant/pull/14327 +[#14329]: https://github.com/home-assistant/home-assistant/pull/14329 [@CM000n]: https://github.com/CM000n +[@Danielhiversen]: https://github.com/Danielhiversen [@Hate-Usernames]: https://github.com/Hate-Usernames [@Kane610]: https://github.com/Kane610 [@MatMaul]: https://github.com/MatMaul @@ -284,7 +304,6 @@ Experiencing issues introduced by this release? Please report them in our [issue [@cgarwood]: https://github.com/cgarwood [@colinodell]: https://github.com/colinodell [@corneyl]: https://github.com/corneyl -[@danielhiversen]: https://github.com/danielhiversen [@danielperna84]: https://github.com/danielperna84 [@dgomes]: https://github.com/dgomes [@dgraye]: https://github.com/dgraye @@ -296,8 +315,10 @@ Experiencing issues introduced by this release? Please report them in our [issue [@fanthos]: https://github.com/fanthos [@giangvo]: https://github.com/giangvo [@gives1976]: https://github.com/gives1976 +[@graffic]: https://github.com/graffic [@iMicknl]: https://github.com/iMicknl [@ileler]: https://github.com/ileler +[@jloutsenhizer]: https://github.com/jloutsenhizer [@jnewland]: https://github.com/jnewland [@maddox]: https://github.com/maddox [@marthoc]: https://github.com/marthoc @@ -329,6 +350,7 @@ Experiencing issues introduced by this release? Please report them in our [issue [@teharris1]: https://github.com/teharris1 [@thelittlefireman]: https://github.com/thelittlefireman [@tinloaf]: https://github.com/tinloaf +[abode docs]: /components/abode/ [alarm_control_panel.alarmdotcom docs]: /components/alarm_control_panel.alarmdotcom/ [auth docs]: /components/auth/ [binary_sensor docs]: /components/binary_sensor/ From ee59dbd06227372fe4eaffc3e8c9cee6a62a0c55 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 8 May 2018 08:49:44 +0200 Subject: [PATCH 233/241] Add HackSpace article --- source/help/index.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/help/index.markdown b/source/help/index.markdown index d1573cd86e..105bf91613 100644 --- a/source/help/index.markdown +++ b/source/help/index.markdown @@ -50,6 +50,7 @@ Looking for [talking points](/help/talking-points/) or [trivia](/help/trivia)? Don't miss the regular [Home Assistant podcasts](https://hasspodcast.io/). +- [HackSpace magazine #6](https://s3-eu-west-1.amazonaws.com/rpi-magazines/issues/full_pdfs/000/000/013/original/HS_6_Digital_Optimised.pdf?1524495009) - May 2018 - [The winners of the Thomas-Krenn-Awards 2018](https://www.thomas-krenn.com/de/tkmag/allgemein/die-gewinner-des-thomas-krenn-awards-2018-stehen-fest/) - March 2018 - [Hausautomations-Schaltzentrale Home Assistant auf Python-Basis](https://www.heise.de/ct/ausgabe/2017-26-Hausautomations-Schaltzentrale-Home-Assistant-3909532.html) - December 2017 - [Using Home Assistant the ARTIK Cloud](https://developer.artik.io/documentation/developer-guide/wireless-iot/hass.html) - September 2017 From 17e65feefa0d1002e14df8cc57d45ede2d41c764 Mon Sep 17 00:00:00 2001 From: Dale Higgs Date: Tue, 8 May 2018 01:54:01 -0500 Subject: [PATCH 234/241] Fix Templates URL and other minor format issues (#5327) * Fix Templates URL and other minor format issues * Update template example --- source/_components/sensor.mqtt.markdown | 42 ++++++++++++------------- 1 file changed, 21 insertions(+), 21 deletions(-) diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index 5f36c9de1d..cb5ae80742 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -19,7 +19,7 @@ This `mqtt` sensor platform uses the MQTT message payload as the sensor value. I To use your MQTT sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: mqtt state_topic: "home/bedroom/temperature" @@ -92,17 +92,17 @@ In this section you find some real life examples of how to use this sensor. ### {% linkable_title JSON attributes configuration %} -The example sensor below shows a configuration example which uses JSON in the state topic to add extra attributes. It also makes use of the availability topic. Attributes can then be extracted in [Templates](configuration/templating/#attributes); Example to extract data from the sensor below {% raw %}'{{ states.sensor.bs_client_name.attributes.ClientName }}'{% endraw %}. +The example sensor below shows a configuration example which uses JSON in the state topic to add extra attributes. It also makes use of the availability topic. Attributes can then be extracted in [Templates](/docs/configuration/templating/#attributes). For example, to extract the `ClientName` attribute from the sensor below, use a template similar to: {% raw %}`{{ state_attr('sensor.bs_rssi', 'ClientName') }}`{% endraw %}. {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: mqtt - state_topic: "HUISHS/BunnyShed/NodeHealthJSON" name: "BS RSSI" - unit_of_measurement: "dBm" - value_template: '{{ value_json.RSSI }}' + state_topic: "HUISHS/BunnyShed/NodeHealthJSON" + unit_of_measurement: 'dBm' + value_template: "{{ value_json.RSSI }}" availability_topic: "HUISHS/BunnyShed/status" payload_available: "online" payload_not_available: "offline" @@ -118,7 +118,7 @@ sensor: ### {% linkable_title Get battery level %} -If you are using the [Owntracks](/components/device_tracker.owntracks/) and enable the reporting of the battery level then you can use a MQTT sensor to keep track of your battery. A regular MQTT message from Owntracks looks like this: +If you are using the [OwnTracks](/components/device_tracker.owntracks/) and enable the reporting of the battery level then you can use a MQTT sensor to keep track of your battery. A regular MQTT message from OwnTracks looks like this: ```bash owntracks/tablet/tablet {"_type":"location","lon":7.21,"t":"u","batt":92,"tst":144995643,"tid":"ta","acc":27,"lat":46.12} @@ -128,13 +128,13 @@ Thus the trick is extracting the battery level from the payload. {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: mqtt - state_topic: "owntracks/tablet/tablet" name: "Battery Tablet" - unit_of_measurement: "%" - value_template: '{{ value_json.batt }}' + state_topic: "owntracks/tablet/tablet" + unit_of_measurement: '%' + value_template: "{{ value_json.batt }}" ``` {% endraw %} @@ -154,18 +154,18 @@ Then use this configuration example to extract the data from the payload: {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: mqtt - state_topic: 'office/sensor1' - name: 'Temperature' + name: "Temperature" + state_topic: "office/sensor1" unit_of_measurement: '°C' - value_template: '{{ value_json.temperature }}' + value_template: "{{ value_json.temperature }}" - platform: mqtt - state_topic: 'office/sensor1' - name: 'Humidity' + name: "Humidity" + state_topic: "office/sensor1" unit_of_measurement: '%' - value_template: '{{ value_json.humidity }}' + value_template: "{{ value_json.humidity }}" ``` {% endraw %} @@ -190,10 +190,10 @@ The configuration will look like the example below: {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: mqtt - state_topic: 'home/bathroom/analog/brightness' - name: Brightness + name: "Brightness" + state_topic: "home/bathroom/analog/brightness" ``` {% endraw %} From fc56ec7921345ab0889a758544a3f93b859fe9f6 Mon Sep 17 00:00:00 2001 From: wbradmoore Date: Tue, 8 May 2018 03:21:57 -0400 Subject: [PATCH 235/241] Update sqlite query for new device names (#5328) The new Xiaomi vacuums show up with different names, e.g "Roborock Vacuum" --- source/_components/vacuum.xiaomi_miio.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/vacuum.xiaomi_miio.markdown b/source/_components/vacuum.xiaomi_miio.markdown index c8f9f7c872..9fa8cbe3da 100644 --- a/source/_components/vacuum.xiaomi_miio.markdown +++ b/source/_components/vacuum.xiaomi_miio.markdown @@ -127,7 +127,7 @@ The following table shows the units of measurement for each attribute:

    As per [python-miio issue 185](https://github.com/rytilahti/python-miio/issues/185) the Mi-Home app no longer stores the token within the database (it's retrieved from Xiaomi servers from version 5.0.31+). Currently the only known fix is to uninstall, then install a downgraded version of the apk. Apkmirror is a trusted source for older versions of the app. [Mi-Home version 5.0.0](https://www.apkmirror.com/apk/xiaomi-inc/mihome/mihome-5-0-0-release/) is confirmed as working for the following Android methods. -This token (32 hexadecimal characters) is required for the Xiaomi Mi Robot Vacuum, Xiaomi Philips Lights and Xiaomi IR Remote. The Xiaomi Gateway uses another security method and requires a `key` (16 alphanumeric chars), which can be obtained +This token (32 hexadecimal characters) is required for the Xiaomi Mi Robot Vacuum, Mi Robot 2 (Roborock) Vacuum, Xiaomi Philips Lights and Xiaomi IR Remote. The Xiaomi Gateway uses another security method and requires a `key` (16 alphanumeric chars), which can be obtained easily via a hidden menu item at the Mi-Home app or using the `miio` command line tool.

    @@ -203,7 +203,7 @@ To fetch the token follow these instructions depending on your mobile phone plat 6. Download the 'ADB Backup Extractor' from [here](https://sourceforge.net/projects/adbextractor/files/latest/download) 7. Extract the data from the backup: `java -jar Android\ Backup\ Utilities/Android\ Backup\ Extractor/android-backup-extractor-20171005-bin/abe.jar unpack backup.ab unpacked.tar` (enter the password, if prompted) 8. Untar the unpacked data: `tar -xvf unpacked.tar` -9. `sqlite3 apps/com.xiaomi.smarthome/db/miio2.db 'select token from devicerecord where name = "Mi Robot Vacuum";'` returns the token for your Xiaomi vacuum bot. +9. `sqlite3 apps/com.xiaomi.smarthome/db/miio2.db 'select token from devicerecord where name like "%Vacuum%";'` returns the token for your Xiaomi vacuum bot. #### {% linkable_title Linux and Android (rooted!) %} @@ -245,7 +245,7 @@ To fetch the token follow these instructions depending on your mobile phone plat 8. Install [DB Browser for SQLite](http://sqlitebrowser.org/). 9. Open DB Browser and load the `.sqlite` file you saved from your backup. 10. Click on the `Execute SQL` tab. -11. Input and run this query: `SELECT ZTOKEN FROM ZDEVICE WHERE ZNAME = "Mi Robot Vacuum"` +11. Input and run this query: `SELECT ZTOKEN FROM ZDEVICE WHERE ZNAME LIKE "%Vacuum%"` 12. Copy the returned 32-digit hexadecimal string to your clipboard. 13. Open `Terminal` and execute this command: `echo '0: ' | xxd -r -p | openssl enc -d -aes-128-ecb -nopad -nosalt -K 00000000000000000000000000000000` 14. Use the resulting string as your token. From 49ea67b97e5c49e973372d00a0f6bbd879a1c07a Mon Sep 17 00:00:00 2001 From: DubhAd Date: Tue, 8 May 2018 08:22:50 +0100 Subject: [PATCH 236/241] Added note about tabs (#5325) --- source/_docs/configuration/yaml.markdown | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/source/_docs/configuration/yaml.markdown b/source/_docs/configuration/yaml.markdown index 9398ec30bd..68503dab96 100644 --- a/source/_docs/configuration/yaml.markdown +++ b/source/_docs/configuration/yaml.markdown @@ -93,3 +93,15 @@ lights: !include lights.yaml ``` More information about this feature can also be found at [splitting configuration](/docs/configuration/splitting_configuration/). + +## {% linkable_title Common Issues %} + +### {% linkable_title found character '\t' %} + +If you see the following message: + +``` +found character '\t' that cannot start any token +``` + +This means that you've mistakenly entered a tab character, instead of spaces. From e1ccd79776e7c7424e0366fbbf5458311543e31c Mon Sep 17 00:00:00 2001 From: DubhAd Date: Tue, 8 May 2018 08:28:16 +0100 Subject: [PATCH 237/241] Added note about instant updates (#5308) Added note about instant updates and the Controlled command classes that are required for it to work. --- source/_docs/z-wave.markdown | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/_docs/z-wave.markdown b/source/_docs/z-wave.markdown index c6a68fb3c6..6ee6a284fa 100644 --- a/source/_docs/z-wave.markdown +++ b/source/_docs/z-wave.markdown @@ -37,3 +37,9 @@ There are 12 different regions for Z-Wave devices, which relates to the frequenc You'll now need to connect your [controller](/docs/z-wave/controllers/), [configure](/docs/z-wave/installation) the Z-Wave component, then [add some devices](/docs/z-wave/adding) using the [control panel](/docs/z-wave/control-panel). [This explains](/docs/z-wave/devices/) about devices, and how [entities are named](/docs/z-wave/entities). You can get more information on the [available services](/docs/z-wave/services/) and [events](/docs/z-wave/events/), what the [query stages](/docs/z-wave/query-stage) of battery powered devices are, as well as details on configuring [specific devices](/docs/z-wave/device-specific/). + +## {% linkable_title Instant status updates %} + +When you toggle a switch or control a light locally you may find that it takes some time for that to be reflected in Home Assistant. That's because Lutron had patents on the status updates using the *Hail* command class, the traditional way of allowing devices to tell the controller that something happened locally. The same result can be achieved through the *Association* command class, or *Central Scene* command class (though, *Central Scene* isn't [fully supported](https://github.com/OpenZWave/open-zwave/pull/1125) in OpenZWave). + +If you search [the Z-Wave products database](http://products.z-wavealliance.org/) for your product and it lists one of those in the **Controlled** command classes (not the **Supported** command classes), then your device will be able to report state changes when they happen. If it doesn't then updates may either happen eventually, or you may need to (carefully) [enable polling](https://www.home-assistant.io/docs/z-wave/control-panel/#entities-of-this-node). From 243d1587e8d3c3375eeaee439e82f1120a44194d Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 8 May 2018 09:34:28 +0200 Subject: [PATCH 238/241] Fix typos in file name (#5330) --- .../_components/binary_sensor.modbus.markdown | 6 ++-- .../_components/binary_sensor.mqtt.markdown | 2 +- .../binary_sensor.pilight.markdown | 4 ++- source/_components/climate.modbus.markdown | 13 +++---- source/_components/cover.gogogate2.markdown | 2 +- source/_components/cover.mqtt.markdown | 10 ++++-- source/_components/cover.myq.markdown | 4 ++- .../_components/device_tracker.fritz.markdown | 2 ++ source/_components/discoverable.markdown | 2 +- source/_components/fan.mqtt.markdown | 6 ++-- source/_components/fritzbox.markdown | 34 +++++++++---------- source/_components/juicenet.markdown | 4 ++- source/_components/light.mochad.markdown | 7 ++-- source/_components/light.mqtt.markdown | 10 +++--- source/_components/lock.mqtt.markdown | 2 +- source/_components/mochad.markdown | 18 ++++++++-- source/_components/modbus.markdown | 2 ++ source/_components/pilight.markdown | 2 ++ .../sensor.fritzbox_callmonitor.markdown | 15 ++++---- source/_components/sensor.gitter.markdown | 20 +++++++---- source/_components/sensor.modbus.markdown | 4 ++- source/_components/sensor.mqtt.markdown | 2 ++ source/_components/sensor.mqtt_room.markdown | 2 ++ source/_components/sensor.mvglive.markdown | 4 ++- source/_components/sensor.openevse.markdown | 4 ++- source/_components/sensor.pilight.markdown | 4 ++- source/_components/sensor.qnap.markdown | 4 ++- source/_components/sensor.radarr.markdown | 4 ++- source/_components/sensor.sonarr.markdown | 4 ++- .../_components/sensor.synologydsm.markdown | 6 ++-- source/_components/switch.fritzdect.markdown | 20 ++++++++--- source/_components/switch.mochad.markdown | 6 +++- source/_components/switch.modbus.markdown | 4 ++- source/_components/switch.mqtt.markdown | 8 +++-- source/_components/switch.pilight.markdown | 2 ++ .../_components/switch.wake_on_lan.markdown | 7 ++-- ...mped-ui-and-improved-distribution.markdown | 4 +-- 37 files changed, 172 insertions(+), 82 deletions(-) diff --git a/source/_components/binary_sensor.modbus.markdown b/source/_components/binary_sensor.modbus.markdown index 55450b908e..62f5765dd3 100644 --- a/source/_components/binary_sensor.modbus.markdown +++ b/source/_components/binary_sensor.modbus.markdown @@ -15,10 +15,12 @@ ha_iot_class: "Local Push" The `modbus` binary sensor allows you to gather data from [Modbus](http://www.modbus.org/) coils. +## {% linkable_title Configuration %} + To use your Modbus binary sensors in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry binary_sensor: - platform: modbus coils: @@ -39,7 +41,7 @@ Configuration variables: It's possible to change the default 30 seconds scan interval for the sensor updates as shown in the [Platform options](/docs/configuration/platform_options/#scan-interval) documentation. -### {% linkable_title Full example %} +## {% linkable_title Full example %} Example a sensor with a 10 seconds scan interval: diff --git a/source/_components/binary_sensor.mqtt.markdown b/source/_components/binary_sensor.mqtt.markdown index 1c6a6d87ef..92ac12ccb0 100644 --- a/source/_components/binary_sensor.mqtt.markdown +++ b/source/_components/binary_sensor.mqtt.markdown @@ -133,7 +133,7 @@ The configuration will look like the example below: {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry binary_sensor: - platform: mqtt name: Bathroom diff --git a/source/_components/binary_sensor.pilight.markdown b/source/_components/binary_sensor.pilight.markdown index 7d2ccf976b..ee7a729196 100644 --- a/source/_components/binary_sensor.pilight.markdown +++ b/source/_components/binary_sensor.pilight.markdown @@ -15,10 +15,12 @@ ha_iot_class: "Local Polling" The `pilight` binary sensor platform implement the [pilight hub](/components/pilight/) binary sensor functionality. Two type of Pilight binary sensor configuration available. A normal sensor which send the on and off state cyclical and a trigger sensor which send only a trigger when an event happened (for example lots of cheap PIR motion detector). + + To enable a Pilight binary sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry binary_sensor: - platform: pilight variable: 'state' diff --git a/source/_components/climate.modbus.markdown b/source/_components/climate.modbus.markdown index f489d27a4b..eeb376ef8e 100644 --- a/source/_components/climate.modbus.markdown +++ b/source/_components/climate.modbus.markdown @@ -14,20 +14,20 @@ ha_iot_class: "Local Polling" --- -The `modbus` thermostat allows you to use a sensor value (current temperature) -and target value (target temperature) from [Modbus](http://www.modbus.org/) -registers. +The `modbus` thermostat allows you to use a sensor value (current temperature) and target value (target temperature) from [Modbus](http://www.modbus.org/) registers. + +## {% linkable_title Configuration %} To use your Modbus thermostat in your installation, add the following to your `configuration.yaml` file: ```yaml +# Example configuration.yaml entry climate: - platform: modbus name: Watlow F4T slave: 1 target_temp_register: 2782 current_temp_register: 27586 - ``` {% configuration %} @@ -49,17 +49,18 @@ current_temp_register: type: int data_type: description: Response representation (int, uint, float, custom). If float selected, value will converted to IEEE 754 floating point format. - Default float. required: false type: string + default: float count: description: Number of registers to read. required: false type: int precision: - description: Number of valid decimals, default 0. + description: Number of valid decimals. required: false type: int + default: 0 {% endconfiguration %} diff --git a/source/_components/cover.gogogate2.markdown b/source/_components/cover.gogogate2.markdown index bf6d62d37b..a24ef1fd02 100644 --- a/source/_components/cover.gogogate2.markdown +++ b/source/_components/cover.gogogate2.markdown @@ -20,7 +20,7 @@ The `gogogate2` cover platform lets you control Gogogate2-Enabled garage doors t To use your Gogogate2 cover in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry cover: - platform: gogogate2 username: email@email.com diff --git a/source/_components/cover.mqtt.markdown b/source/_components/cover.mqtt.markdown index 8af2d728aa..81358f8776 100755 --- a/source/_components/cover.mqtt.markdown +++ b/source/_components/cover.mqtt.markdown @@ -15,6 +15,8 @@ ha_release: 0.18 The `mqtt` cover platform allows you to control an MQTT cover (such as blinds, a rollershutter, or a garage door). +## {% linkable_title Configuration %} + The device state (`open` or `closed`) will be updated only after a new message is published on `state_topic` matching `state_open` or `state_closed`. If these messages are published with the `retain` flag set, the cover will receive an instant state update after subscription and Home Assistant will display the correct state on startup. Otherwise, the initial state displayed in Home Assistant will be `unknown`. There is an attribute that stores the relative position of the device, where 0 means the device is `closed` and all other intermediate positions means the device is `open`. @@ -164,7 +166,7 @@ In this section you will find some real life examples of how to use this platfor The example below shows a full configuration for a cover without tilt. ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry cover: - platform: mqtt name: "MQTT Cover" @@ -188,8 +190,9 @@ cover: The example below shows a full configuration for a cover. +{% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry cover: - platform: mqtt name: "MQTT Cover" @@ -206,7 +209,7 @@ cover: payload_available: "online" payload_not_available: "offline" optimistic: false - value_template: '{% raw %}{{ value.x }}{% endraw %}' + value_template: '{{ value.x }}' tilt_command_topic: 'home-assistant/cover/tilt' tilt_status_topic: 'home-assistant/cover/tilt-state' tilt_min: 0 @@ -214,6 +217,7 @@ cover: tilt_closed_value: 70 tilt_opened_value: 180 ``` +{% endraw %} To test, you can use the command line tool `mosquitto_pub` shipped with `mosquitto` or the `mosquitto-clients` package to send MQTT messages. This allows you to operate your cover manually: diff --git a/source/_components/cover.myq.markdown b/source/_components/cover.myq.markdown index 160b4f75f7..419e65ef7a 100644 --- a/source/_components/cover.myq.markdown +++ b/source/_components/cover.myq.markdown @@ -15,10 +15,12 @@ ha_iot_class: Cloud Polling The `myq` cover platform lets you control MyQ-Enabled garage doors through Home Assistant. Device names in Home Assistant are generated based on the names defined in your MyQ Device mobile app. +## {% linkable_title Configuration %} + To use your MyQ cover in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry cover: - platform: myq username: YOUR_USERNAME diff --git a/source/_components/device_tracker.fritz.markdown b/source/_components/device_tracker.fritz.markdown index 66ed60a157..3e4a745d99 100644 --- a/source/_components/device_tracker.fritz.markdown +++ b/source/_components/device_tracker.fritz.markdown @@ -15,6 +15,8 @@ ha_release: "0.10" The `fritz` platform offers presence detection by looking at connected devices to a [AVM Fritz!Box](http://avm.de/produkte/fritzbox/) based router. +## {% linkable_title Configuration %} +

    It might be necessary to install additional packages: $ sudo apt-get install libxslt-dev libxml2-dev python3-lxml If you are working with the All-in-One installation, you may also need to execute also within your virtual environment the command pip install lxml; be patient this will take a while.

    diff --git a/source/_components/discoverable.markdown b/source/_components/discoverable.markdown index 49e9f82111..12c170a1ee 100644 --- a/source/_components/discoverable.markdown +++ b/source/_components/discoverable.markdown @@ -23,7 +23,7 @@ for state in hass.states(): To enable `discovery` in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry discoverable: expose_password: yes ``` diff --git a/source/_components/fan.mqtt.markdown b/source/_components/fan.mqtt.markdown index 94a02b1a9e..45fa55d41b 100644 --- a/source/_components/fan.mqtt.markdown +++ b/source/_components/fan.mqtt.markdown @@ -15,6 +15,8 @@ ha_iot_class: depends The `mqtt` fan platform lets you control your MQTT enabled fans. +## {% linkable_title Configuration %} + In an ideal scenario, the MQTT device will have a `state_topic` to publish state changes. If these messages are published with a `RETAIN` flag, the MQTT fan will receive an instant state update after subscription and will start with the correct state. Otherwise, the initial state of the fan will be `false` / `off`. When a `state_topic` is not available, the fan will work in optimistic mode. In this mode, the fan will immediately change state after every command. Otherwise, the fan will wait for state confirmation from the device (message from `state_topic`). @@ -24,7 +26,7 @@ Optimistic mode can be forced even if a `state_topic` is available. Try to enabl To enable MQTT fans in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry fan: - platform: mqtt command_topic: "bedroom_fan/on/set" @@ -155,7 +157,7 @@ In this section you find some real life examples of how to use this fan. The example below shows a full configuration for a MQTT fan. ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry fan: - platform: mqtt name: "Bedroom Fan" diff --git a/source/_components/fritzbox.markdown b/source/_components/fritzbox.markdown index 351f63e35d..a5ca0a5f68 100644 --- a/source/_components/fritzbox.markdown +++ b/source/_components/fritzbox.markdown @@ -35,21 +35,21 @@ fritzbox: ``` {% configuration %} - devices: - description: A list of Fritzbox devices. - required: true - type: map - keys: - host: - description: The hostname or IP address of the Fritzbox. - required: true - type: optional - username: - description: The username for Smart Home access. - required: true - type: string - password: - description: The password of the user. - required: true - type: string +devices: + description: A list of Fritzbox devices. + required: true + type: map + keys: + host: + description: The hostname or IP address of the Fritzbox. + required: true + type: optional + username: + description: The username for Smart Home access. + required: true + type: string + password: + description: The password of the user. + required: true + type: string {% endconfiguration %} diff --git a/source/_components/juicenet.markdown b/source/_components/juicenet.markdown index 5df8b274e6..74cc2fdb89 100644 --- a/source/_components/juicenet.markdown +++ b/source/_components/juicenet.markdown @@ -15,10 +15,12 @@ ha_release: 0.47 The `juicenet` sensor platform pulls data from a [JuiceNet](https://emotorwerks.com/products/juicenet/) charging station equipped with a wifi connection. It will access and make available all of the devices attached to your account. +## {% linkable_title Configuration %} + To enable the platform in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry juicenet: access_token: ACCESS_TOKEN ``` diff --git a/source/_components/light.mochad.markdown b/source/_components/light.mochad.markdown index fdd288113f..9721e9d6c9 100644 --- a/source/_components/light.mochad.markdown +++ b/source/_components/light.mochad.markdown @@ -11,13 +11,14 @@ ha_category: Light ha_release: 0.51 --- -The `mochad` light platform lets you control an X10 enabled dimmer/light -device. +The `mochad` light platform lets you control an X10 enabled dimmer/light device. + + To enable this sensor, you first have to set up the [mochad component](/components/mochad/) and then add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry light: - platform: mochad devices: diff --git a/source/_components/light.mqtt.markdown b/source/_components/light.mqtt.markdown index 13e1cd9f86..8b8a67393e 100644 --- a/source/_components/light.mqtt.markdown +++ b/source/_components/light.mqtt.markdown @@ -14,6 +14,8 @@ ha_iot_class: depends The `mqtt` light platform lets you control your MQTT enabled lights. It supports setting brightness, color temperature, effects, flashing, on/off, RGB colors, transitions, XY colors and white values. +## {% linkable_title Configuration %} + In an ideal scenario, the MQTT device will have a state topic to publish state changes. If these messages are published with a `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 switch will be `false` / `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 the device (message from `state_topic`). @@ -21,7 +23,7 @@ When a state topic is not available, the light will work in optimistic mode. In Optimistic mode can be forced, even if the `state_topic` is available. Try to enable it, if experiencing incorrect light operation. ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry light: - platform: mqtt command_topic: "office/rgb1/light/switch" @@ -206,7 +208,7 @@ To enable a light with brightness and RGB support in your installation, add the {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry light: - platform: mqtt name: "Office Light RGB" @@ -231,7 +233,7 @@ light: To enable a light with brightness (no RGB version) in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry light: - platform: mqtt name: "Office light" @@ -250,7 +252,7 @@ light: To enable a light that sends only brightness topics to turn it on, add the following to your `configuration.yaml` file. The `command_topic` is only used to send an off command in this case: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry light: - platform: mqtt name: "Brightness light" diff --git a/source/_components/lock.mqtt.markdown b/source/_components/lock.mqtt.markdown index b0669cfb7f..ff8eb05170 100644 --- a/source/_components/lock.mqtt.markdown +++ b/source/_components/lock.mqtt.markdown @@ -24,7 +24,7 @@ Optimistic mode can be forced, even if state topic is available. Try to enable i To enable MQTT locks in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry lock: - platform: mqtt command_topic: "home/frontdoor/set" diff --git a/source/_components/mochad.markdown b/source/_components/mochad.markdown index df42020a21..bf0617cefb 100644 --- a/source/_components/mochad.markdown +++ b/source/_components/mochad.markdown @@ -13,6 +13,8 @@ ha_release: 0.32 The `mochad` component is the main component to integrate all X10 platforms being controlled by [mochad](https://sourceforge.net/projects/mochad/). Besides this component you will have to setup your X10 devices separately. +## {% linkable_title Configuration %} + To integrate your Mochad units with Home Assistant, add the following section to your `configuration.yaml` file: ```yaml @@ -20,10 +22,20 @@ To integrate your Mochad units with Home Assistant, add the following section to mochad: ``` -Configuration variables: +{% configuration %} +host: + description: The host that mochad is running on. + required: false + type: string + default: localhost +port: + description: The port that mochad is running on. + required: false + type: int + default: 1099 +{% endconfiguration %} -- **host** (*Optional*): The host that mochad is running on. Defaults to `localhost`. -- **port** (*Optional*): The port that mochad is running on. Defaults to `1099`. +## {% linkable_title Example %} A full configuration sample could look like the one below: diff --git a/source/_components/modbus.markdown b/source/_components/modbus.markdown index 30a2b62382..dcccf0ede6 100644 --- a/source/_components/modbus.markdown +++ b/source/_components/modbus.markdown @@ -16,6 +16,8 @@ ha_iot_class: "Local Push" [Modbus](http://www.modbus.org/) is a serial communication protocol to control PLCs (Programmable logic controller). It currently supports sensors and switches which can be controlled over serial, TCP, and UDP connections. +## {% linkable_title Configuration %} + To add modbus to your installation, add the following to your `configuration.yaml` file: For a network connection: diff --git a/source/_components/pilight.markdown b/source/_components/pilight.markdown index 2e7e1b0150..45e9832381 100644 --- a/source/_components/pilight.markdown +++ b/source/_components/pilight.markdown @@ -19,6 +19,8 @@ This pilight hub connects to the [pilight-daemon](https://manual.pilight.org/pro The received and supported RF codes are put on the event bus of Home Assistant and are therefore directly usable by other components (e.g., automation). Additionally a send service is provided to send RF codes. +## {% linkable_title Configuration %} + To integrate pilight into Home Assistant, add the following section to your `configuration.yaml` file: ```yaml diff --git a/source/_components/sensor.fritzbox_callmonitor.markdown b/source/_components/sensor.fritzbox_callmonitor.markdown index 85643e2dff..dd57677a9c 100644 --- a/source/_components/sensor.fritzbox_callmonitor.markdown +++ b/source/_components/sensor.fritzbox_callmonitor.markdown @@ -14,10 +14,11 @@ ha_iot_class: "Local Polling" --- -The `fritzbox_callmonitor` sensor monitors the call monitor exposed by [AVM Fritz!Box](http://avm.de/produkte/fritzbox/) routers -on TCP port 1012. It will assume the values `idle`, `ringing`, `dialing`, or `talking` with the phone numbers involved contained in the state attributes. +The `fritzbox_callmonitor` sensor monitors the call monitor exposed by [AVM Fritz!Box](http://avm.de/produkte/fritzbox/) routers on TCP port 1012. It will assume the values `idle`, `ringing`, `dialing` or `talking` with the phone numbers involved contained in the state attributes. It can also access the internal phone book of the router to look up the names corresponding to the phone numbers and store them in the state attributes. +## {% linkable_title Configuration %} + To activate the call monitor on your Fritz!Box, dial #96\*5\* from any phone connected to it. To use the Fritz!Box call monitor in your installation, add the following to your `configuration.yaml` file: @@ -44,7 +45,7 @@ Configuration variables: The example below shows a full configuration for a call monitor with phone book support. ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: fritzbox_callmonitor name: Phone @@ -61,8 +62,9 @@ sensor: This example shows how to send notifications whenever the sensor's state changes. You will get notified both when you receive a call and also when a call is placed. +{% raw %} ```yaml -# Example configuration.yml entry. +# Example configuration.yaml entry. automation: - alias: "Notify about phone state" trigger: @@ -73,7 +75,7 @@ automation: data: title: "Phone" message: >- - {% raw %}{% if is_state("sensor.phone", "idle") %} + {% if is_state("sensor.phone", "idle") %} Phone is idle {% elif is_state("sensor.phone", "dialing") %} Calling {{ states.sensor.phone.attributes.to_name }} ({{ states.sensor.phone.attributes.to }}) @@ -81,5 +83,6 @@ automation: Incoming call from {{ states.sensor.phone.attributes.from_name }} ({{ states.sensor.phone.attributes.from }}) {% else %} Talking to {{ states.sensor.phone.attributes.with_name }} ({{ states.sensor.phone.attributes.with }}) - {% endif %}{% endraw %} + {% endif %} ``` +{% endraw %} diff --git a/source/_components/sensor.gitter.markdown b/source/_components/sensor.gitter.markdown index a114887f97..72f3c4b7dc 100644 --- a/source/_components/sensor.gitter.markdown +++ b/source/_components/sensor.gitter.markdown @@ -15,19 +15,27 @@ ha_release: 0.47 This `gitter` sensor allows one to monitor a [Gitter.im](https://gitter.im) chatroom for unread messages. +## {% linkable_title Configuration %} + Visit [Gitter Developer Apps](https://developer.gitter.im/apps) to retrieve your "Personal Access Token". To use a Gitter sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: gitter api_key: YOUR_API_TOKEN ``` -Configuration variables: - -- **api_key** (*Required*): Your Gitter.im API token. -- **room** (*Optional*): Gitter room to monitor. Defaults to `home-assistant/home-assistant` - +{% configuration %} +api_key: + description: Your Gitter.im API token. + required: true + type: string +room: + description: Gitter room to monitor. + required: false + type: string + default: home-assistant/home-assistant +{% endconfiguration %} diff --git a/source/_components/sensor.modbus.markdown b/source/_components/sensor.modbus.markdown index a94d711fda..5868888488 100644 --- a/source/_components/sensor.modbus.markdown +++ b/source/_components/sensor.modbus.markdown @@ -16,10 +16,12 @@ ha_iot_class: "Local Push" The `modbus` sensor allows you to gather data from [Modbus](http://www.modbus.org/) registers. +## {% linkable_title Configuration %} + To use your Modbus sensors in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: platform: modbus registers: diff --git a/source/_components/sensor.mqtt.markdown b/source/_components/sensor.mqtt.markdown index cb5ae80742..5db0e56393 100644 --- a/source/_components/sensor.mqtt.markdown +++ b/source/_components/sensor.mqtt.markdown @@ -16,6 +16,8 @@ ha_iot_class: depends This `mqtt` sensor platform uses the MQTT message payload as the sensor value. If messages in this `state_topic` are published with *RETAIN* flag, the sensor will receive an instant update with last known value. Otherwise, the initial state will be undefined. +## {% linkable_title Configuration %} + To use your MQTT sensor in your installation, add the following to your `configuration.yaml` file: ```yaml diff --git a/source/_components/sensor.mqtt_room.markdown b/source/_components/sensor.mqtt_room.markdown index 598dafefb1..96aaa9dc7d 100644 --- a/source/_components/sensor.mqtt_room.markdown +++ b/source/_components/sensor.mqtt_room.markdown @@ -16,6 +16,8 @@ ha_iot_class: depends The `mqtt_room` sensor platform allows you to detect the indoor location of devices using MQTT clients. +## {% linkable_title Configuration %} + To use this device tracker in your installation, add the following to your `configuration.yaml` file: ```yaml diff --git a/source/_components/sensor.mvglive.markdown b/source/_components/sensor.mvglive.markdown index 16ee5f4a5e..7d613d8598 100644 --- a/source/_components/sensor.mvglive.markdown +++ b/source/_components/sensor.mvglive.markdown @@ -16,6 +16,8 @@ ha_iot_class: "Cloud Polling" The `mvglive` sensor will give you the departure time of the next bus, tram, subway, or train at the next station or stop in the Munich public transport network. Additional details such as the line number and destination are present in the attributes. +## {% linkable_title Configuration %} + To enable this sensor, add the following lines to your `configuration.yaml` file: ```yaml @@ -42,7 +44,7 @@ Configuration variables: The example below shows a full configuration with three sensors that showcase the various configuration options. ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: mvglive nextdeparture: diff --git a/source/_components/sensor.openevse.markdown b/source/_components/sensor.openevse.markdown index 04568f0459..e9df04e8da 100644 --- a/source/_components/sensor.openevse.markdown +++ b/source/_components/sensor.openevse.markdown @@ -16,10 +16,12 @@ ha_iot_class: "Local Polling" This `openevse` sensor platform pulls data from an [OpenEVSE](https://www.openevse.com/) Charging station equipped with an ESP8266-based wifi connection. +## {% linkable_title Configuration %} + To enable this sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: openevse host: IP_ADDRESS diff --git a/source/_components/sensor.pilight.markdown b/source/_components/sensor.pilight.markdown index cae336b6d8..2a33cc2a1d 100644 --- a/source/_components/sensor.pilight.markdown +++ b/source/_components/sensor.pilight.markdown @@ -16,10 +16,12 @@ ha_iot_class: depends This `pilight` sensor platform for 433 MHz devices uses a value in the message payload as the sensor value. Unique identifiers (e.g., _uuid_) can be set to distinguish between multiple pilight devices. To use a pilight sensor the pilight Home Assistant hub has to be set up. +## {% linkable_title Configuration %} + To use your sensor via pilight, make sure it is [supported](https://wiki.pilight.org/doku.php/protocols) and add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: pilight variable: temperature diff --git a/source/_components/sensor.qnap.markdown b/source/_components/sensor.qnap.markdown index 66dd99404b..3814f37bd0 100644 --- a/source/_components/sensor.qnap.markdown +++ b/source/_components/sensor.qnap.markdown @@ -16,10 +16,12 @@ ha_iot_class: "Local Polling" This `qnap` sensor allows getting various statistics from your [QNAP NAS](https://www.qnap.com/en-us/). +## {% linkable_title Configuration %} + To use the `qnap` sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: qnap host: IP_ADDRESS_OF_QNAP_NAS diff --git a/source/_components/sensor.radarr.markdown b/source/_components/sensor.radarr.markdown index 42294c8628..94a4665548 100644 --- a/source/_components/sensor.radarr.markdown +++ b/source/_components/sensor.radarr.markdown @@ -15,10 +15,12 @@ ha_release: 0.47 This `radarr` sensor platform pulls data from a given [Radarr](https://radarr.video/) instance. +## {% linkable_title Configuration %} + To use your Radarr sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: radarr api_key: YOUR_API_KEY diff --git a/source/_components/sensor.sonarr.markdown b/source/_components/sensor.sonarr.markdown index 0257c70b55..13a4944fea 100644 --- a/source/_components/sensor.sonarr.markdown +++ b/source/_components/sensor.sonarr.markdown @@ -16,10 +16,12 @@ ha_iot_class: "Local Polling" This `sonarr` sensor platform pulls data from a given [Sonarr](https://sonarr.tv/) instance. +## {% linkable_title Configuration %} + To use your Sonarr sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: sonarr api_key: YOUR_API_KEY diff --git a/source/_components/sensor.synologydsm.markdown b/source/_components/sensor.synologydsm.markdown index d9f4dddf51..0b4b4ba197 100644 --- a/source/_components/sensor.synologydsm.markdown +++ b/source/_components/sensor.synologydsm.markdown @@ -16,10 +16,12 @@ ha_iot_class: "Local Polling" The `synologydsm` sensor platform allows getting various statistics from your [Synology NAS](https://www.synology.com). +## {% linkable_title Configuration %} + To use the `synologydsm` sensor in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry sensor: - platform: synologydsm host: IP_ADDRESS_OF_SYNOLOGY_NAS @@ -33,7 +35,7 @@ sensor: Configuration variables: -- **host** (*Required*): The IP address of the Synology NAS to monitor +- **host** (*Required*): The IP address of the Synology NAS to monitor. - **port** (*Optional*): The port number on which the Synology NAS is reachable. Defaults to `5000`. - **username** (*Required*): An user to connect to the Synology NAS (a separate account is advised, see the Separate User Configuration section below for details). - **password** (*Required*): The password of the user to connect to the Synology NAS. diff --git a/source/_components/switch.fritzdect.markdown b/source/_components/switch.fritzdect.markdown index cceeffaef3..380deebdaf 100644 --- a/source/_components/switch.fritzdect.markdown +++ b/source/_components/switch.fritzdect.markdown @@ -35,11 +35,21 @@ switch: password: YOUR_PASSWORD ``` -Configuration variables: - -- **username** (*Required*): The username for your Fritz!Box. -- **password** (*Required*): The password for your Fritz!Box. -- **host** (*Optional*): The IP address/hostname of your Fritz!Box. Defaults to `fritz.box`. +{% configuration %} +username: + description: The username for your Fritz!Box. + required: true + type: string +password: + description: The password for your Fritz!Box. + required: true + type: string +host: + description: The IP address/hostname of your Fritz!Box. + required: false + type: string + default: fritz.box +{% endconfiguration %} It is recommended to create a dedicated user for Home Assistant and only allow access to "Smart Home". diff --git a/source/_components/switch.mochad.markdown b/source/_components/switch.mochad.markdown index 5ffbdb3bf2..a1d7569ec1 100644 --- a/source/_components/switch.mochad.markdown +++ b/source/_components/switch.mochad.markdown @@ -14,10 +14,12 @@ ha_release: 0.32 The `mochad` switch platform lets you control an X10 enabled switch device. +## {% linkable_title Configuration %} + To enable this sensor, you first have to set up the [mochad component](/components/mochad/) and then add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry switch: - platform: mochad devices: @@ -31,3 +33,5 @@ Configuration variables: - **name** (*Optional*): The name of the switch. Default is: x10_switch_dev_*address*. - **comm_type** (*Optional*): pl (powerline) or rf (radio frequency). Default is pl. + + diff --git a/source/_components/switch.modbus.markdown b/source/_components/switch.modbus.markdown index 201e7b5daa..3bf176c125 100644 --- a/source/_components/switch.modbus.markdown +++ b/source/_components/switch.modbus.markdown @@ -16,10 +16,12 @@ ha_iot_class: "Local Push" The `modbus` switch platform allows you to control [Modbus](http://www.modbus.org/) coils or registers. +## {% linkable_title Configuration %} + To use your Modbus switches in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry switch: platform: modbus slave: 1 diff --git a/source/_components/switch.mqtt.markdown b/source/_components/switch.mqtt.markdown index d440902e7e..295ae106db 100644 --- a/source/_components/switch.mqtt.markdown +++ b/source/_components/switch.mqtt.markdown @@ -15,6 +15,8 @@ ha_iot_class: depends The `mqtt` switch platform lets you control your MQTT enabled switches. +## {% linkable_title Configuration %} + In an ideal scenario, the MQTT device will have a `state_topic` to publish state changes. If these messages are published with a `RETAIN` flag, the MQTT switch will receive an instant state update after subscription, and will start with the correct state. Otherwise, the initial state of the switch will be `false` / `off`. When a `state_topic` is not available, the switch will work in optimistic mode. In this mode, the switch will immediately change state after every command. Otherwise, the switch will wait for state confirmation from the device (message from `state_topic`). @@ -24,7 +26,7 @@ Optimistic mode can be forced, even if the `state_topic` is available. Try to en To enable this switch in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry switch: - platform: mqtt command_topic: "home/bedroom/switch1/set" @@ -106,7 +108,7 @@ In this section you will find some real life examples of how to use this sensor. The example below shows a full configuration for a switch. ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry switch: - platform: mqtt name: "Bedroom Switch" @@ -140,7 +142,7 @@ The configuration will look like the example below: {% raw %} ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry switch: - platform: mqtt name: bathroom diff --git a/source/_components/switch.pilight.markdown b/source/_components/switch.pilight.markdown index ffeeb1a947..ca2c837986 100644 --- a/source/_components/switch.pilight.markdown +++ b/source/_components/switch.pilight.markdown @@ -19,6 +19,8 @@ Additionally, RF commands can be defined that trigger this switch to turn on and 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. +## {% linkable_title Configuration %} + To define a Pilight switch, add the following lines to your `configuration.yaml`: ```yaml diff --git a/source/_components/switch.wake_on_lan.markdown b/source/_components/switch.wake_on_lan.markdown index f30f120134..161cfcd1b5 100644 --- a/source/_components/switch.wake_on_lan.markdown +++ b/source/_components/switch.wake_on_lan.markdown @@ -15,6 +15,8 @@ ha_iot_class: "Local Polling" The `wake_on_lan` (WOL) switch platform allows you to turn on a [WOL](https://en.wikipedia.org/wiki/Wake-on-LAN) enabled computer. +## {% linkable_title Configuration %} +

    The WOL switch can only turn on your computer and monitor the state. There is no universal way to turn off a computer remotely. The `turn_off` variable is there to help you call a script when you have figured out how to remotely turn off your computer. See below for suggestions on how to do this. @@ -23,7 +25,7 @@ See below for suggestions on how to do this. To enable this switch in your installation, add the following to your `configuration.yaml` file: ```yaml -# Example configuration.yml entry +# Example configuration.yaml entry switch: - platform: wake_on_lan mac_address: "00-01-02-03-04-05" @@ -42,7 +44,8 @@ Configuration variables: Here are some real life examples of how to use the **turn_off** variable. ### {% linkable_title Suspending Linux %} -Suggested recipe for letting the turn_off script suspend a Linux computer (the **target**) + +Suggested recipe for letting the `turn_off` script suspend a Linux computer (the **target**) from Home Assistant running on another Linux computer (the **server**). 1. On the **server**, log in as the user account Home Assistant is running under. (I'm using `hass` in this example) diff --git a/source/_posts/2015-08-31-version-7-revamped-ui-and-improved-distribution.markdown b/source/_posts/2015-08-31-version-7-revamped-ui-and-improved-distribution.markdown index 19ab9e50a6..37178a2d66 100644 --- a/source/_posts/2015-08-31-version-7-revamped-ui-and-improved-distribution.markdown +++ b/source/_posts/2015-08-31-version-7-revamped-ui-and-improved-distribution.markdown @@ -61,12 +61,12 @@ __MQTT Sensors and Switches__ [mqtt-switch]: /components/switch.mqtt/ ```yaml -# Example configuration.yml entr +# Example configuration.yaml entry sensor: platform: mqtt name: "MQTT Sensor" state_topic: "home/bedroom/temperature" - unit_of_measurement: "ºC" + unit_of_measurement: "°C" switch: platform: mqtt From 9dce793b65e4c3d82850714193945520f7445daf Mon Sep 17 00:00:00 2001 From: Evgeniy <592652+evgeniy-khatko@users.noreply.github.com> Date: Tue, 8 May 2018 14:45:03 -0700 Subject: [PATCH 239/241] Improving icloud device tracker (#5240) * Improving icloud device tracker Updating documentation for new pull request to main HA codebase: "Improving icloud device tracker" * Update device_tracker.icloud.markdown --- source/_components/device_tracker.icloud.markdown | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/source/_components/device_tracker.icloud.markdown b/source/_components/device_tracker.icloud.markdown index f2f902bd30..a57ba44d4b 100644 --- a/source/_components/device_tracker.icloud.markdown +++ b/source/_components/device_tracker.icloud.markdown @@ -33,9 +33,11 @@ Configuration variables: - **username** (*Required*): The username for the iCloud account. - **password** (*Required*): The password for your given username. - **account_name** (*Optional*): The friendly name for the account_name. If this isn't given, it will use the account_name of the username (so the part before the `@` in the email address). +- **max_interval** (*Optional*): Maximum interval in minutes between subsequent location upates. This tracker uses dynamic intervals for requesting location updates. When iphone is stationary, interval will eventually be set to `max_interval` to save battery. When iphone starts moving again interval will be dynamically updated to 1 min. Note that updating interval to 1 min might be delayed by maximum `max_interval` minutes. Default is 30 min. Minimum value is 1 min. +- **gps_accuracy_threshold** (*Optional*): iCloud location updates come with some gps_accuracy varying from 10 to 5000 meters. This setting defines the accuracy threshold in meters for a location update. Less accurate updates will be discarded by this tracker. This allows more precise location monitoring and fewer false positive zone changes. Default is 1000 meters.

    -This may cause battery drainage as it wakes up your device to get the current location. +Low `max_interval` may cause battery drainage as it wakes up your device to get the current location.

    @@ -48,7 +50,7 @@ To disable the drainage of the battery, a dynamic interval is being used for eac 2 Factor Authentication is the improved version of 2 Steps Authentication, this is still not supported by the pyicloud library. Therefore it's not possible to use it with the device_tracker yet. 4 services are available for this component: -- **icloud_update**: This service can be used to ask for an update of a certain iDevice. The `account_name` and `device_name` are optional. +- **icloud_update**: This service can be used to ask for an update of a certain iDevice. The `account_name` and `device_name` are optional. Request will result in new Home Assistant [state_changed](/docs/configuration/events/#event-state_changed) event describing current iphone location. Can be used in automations when manual location update is needed, e.g. to check if anyone is home when door's been opened. - **icloud_lost_iphone**: This service will play the Lost iPhone sound on a certain iDevice. The `account_name` and `device_name` are optional. - **icloud_set_interval**: This service will change the dynamic interval of an iDevice. The `account_name` and `device_name` are optional. If `interval` is used in the service_data, the iDevice will be updated with that new interval. That interval will be fixed until the iDevice changes zone or if this service is called again. If `interval` isn't used in the service_data, the interval for that iDevice will revert back to its default dynamic interval based on its current zone, its distance towards home and its battery level. - **icloud_reset_account**: This service can be used to reset an iCloud account. This is helpful when not all devices are being found by the component or if you have added a new iDevice to your account. The `account_name` is optional. From e06c9adce7ff4166cd22b20616e910d4d761f780 Mon Sep 17 00:00:00 2001 From: Mario Di Raimondo Date: Wed, 9 May 2018 00:35:12 +0200 Subject: [PATCH 240/241] Waze Travel Time: optional inclusive/exclusive filters (#5208) * Waze Travel Time: optional inclusive/exclusive filters documentation update about the new optional filtering params * Update --- source/_components/sensor.waze_travel_time.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/sensor.waze_travel_time.markdown b/source/_components/sensor.waze_travel_time.markdown index 2440930b9f..db3e3f0418 100644 --- a/source/_components/sensor.waze_travel_time.markdown +++ b/source/_components/sensor.waze_travel_time.markdown @@ -48,4 +48,12 @@ name: required: false default: "Waze Travel Time" type: string +incl_filter: + description: A substring that has to be present in the description of the selected route (a simple case-insensitive matching). + required: false + type: string +excl_filter: + description: A substring that has to be NOT present in the description of the selected route (a simple case-insensitive matching). + required: false + type: string {% endconfiguration %} From a17ecf7a2f594013e0c1c992e5b621e230b7b99c Mon Sep 17 00:00:00 2001 From: Jeena Paradies Date: Wed, 9 May 2018 01:06:33 +0200 Subject: [PATCH 241/241] Add link to a video of a talk at foss-north 2018 I gave a talk at foss-north, which is a free / open source conference covering both software and hardware from the technical perspective. They recorded it and put it on YouTube. This patch adds a link to that talk on the help page under "Videos, talks, workshops and alike". --- source/help/index.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/help/index.markdown b/source/help/index.markdown index 105bf91613..881204f047 100644 --- a/source/help/index.markdown +++ b/source/help/index.markdown @@ -31,6 +31,7 @@ Have you found an issue in your Home Assistant installation? Please report it. R ### {% linkable_title Videos, talks, workshops and alike %} +- [Automate your home with Home Assistant](https://www.youtube.com/watch?v=SSrgi4iHGbs) at [foss-north 2018](http://foss-north.se/2018/speakers-and-talks.html#jparadies) - March 2018 - [Home Assistant](https://github.com/home-assistant/home-assistant-assets/tree/master/english/2017-qecampX) at QECampX 2017 - October 2017 - [Open Source Heimautomation mit Home Assistant](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2017-maker-faire-zurich) at [Mini Maker Faire Zurich 2017](https://www.makerfairezurich.ch/en/) - September 2017 - [Why we can't have the Internet of Nice Things: A home automation primer](https://www.openwest.org/custom/description.php?id=92) at [OpenWest 2017](https://www.openwest.org) - July 2017