From 76719a2957fc8039357b1c501aaf649aafa689cf Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Wed, 7 Dec 2016 13:26:31 -0500 Subject: [PATCH 01/42] Update light.lifx.markdown (#1551) * Update light.lifx.markdown * Update light.lifx.markdown --- source/_components/light.lifx.markdown | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/_components/light.lifx.markdown b/source/_components/light.lifx.markdown index be536f4f694..f326e3cb95e 100644 --- a/source/_components/light.lifx.markdown +++ b/source/_components/light.lifx.markdown @@ -19,9 +19,12 @@ The `lifx` platform allows you to integrate your [LIFX](http://www.lifx.com) int # Example configuration.yaml entry light: - platform: lifx + - broadcast: 192.168.1.255 ``` Configuration variables: - **server** (*Optional*): Your server address. Only needed if using more than one network interface. Omit if you are unsure. - **broadcast** (*Optional*): The broadcast address, set to reach all LIFX bulbs. +If there is an issue with lights not showing up when Home Assistant is restarted, add broadcast to your configuration. + From 7cb2fbfb04163691ebc2ba13ccffe74c658aa8ba Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 8 Dec 2016 23:01:17 -0800 Subject: [PATCH 02/42] Mention websocket upgrade --- source/_posts/2016-12-03-remote-websockets-sonarr.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_posts/2016-12-03-remote-websockets-sonarr.markdown b/source/_posts/2016-12-03-remote-websockets-sonarr.markdown index 607397c921e..de9362b6bd5 100644 --- a/source/_posts/2016-12-03-remote-websockets-sonarr.markdown +++ b/source/_posts/2016-12-03-remote-websockets-sonarr.markdown @@ -124,7 +124,7 @@ We are working on a better solution for 0.35. - The [HomeMatic][homematic] component now uses a different syntax for hosts and the `set_value` service has been renamed. - All [RFXtrx][rfxtrx] sensors will get a new entity ID. -- If you are using NGINX, you will have to [adapt your configuration][nginx]. +- The frontend now uses websockets. If you run a server in front of Home Assistant, you will have to update your config (example [nginx][nginx]) - [Nest][nest] contains changes which will require your attention. ### {% linkable_title If you need help... %} From 57afb8e8c985214f5279a6753303fc181dbedf4d Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 8 Dec 2016 23:01:41 -0800 Subject: [PATCH 03/42] Add edit github links --- source/_ecosystem/hadashboard.markdown | 2 -- source/_ecosystem/hadashboard/dash_config.markdown | 2 -- source/_ecosystem/hadashboard/hapush.markdown | 2 -- source/_ecosystem/hadashboard/installation.markdown | 2 -- source/_ecosystem/hadashboard/reboot.markdown | 2 -- source/_ecosystem/hadashboard/updating.markdown | 2 -- source/_ecosystem/ios.markdown | 2 -- source/_ecosystem/ios/notifications/examples.markdown | 0 source/_ecosystem/scenegen.markdown | 2 -- 9 files changed, 16 deletions(-) delete mode 100644 source/_ecosystem/ios/notifications/examples.markdown diff --git a/source/_ecosystem/hadashboard.markdown b/source/_ecosystem/hadashboard.markdown index ef98ab0ae59..799468d0e6a 100644 --- a/source/_ecosystem/hadashboard.markdown +++ b/source/_ecosystem/hadashboard.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- HADashboard is a dashboard for [Home Assistant](https://home-assistant.io/) that is intended to be wall mounted, and is optimized for distance viewing. diff --git a/source/_ecosystem/hadashboard/dash_config.markdown b/source/_ecosystem/hadashboard/dash_config.markdown index 02e5786d041..3e76aba4019 100755 --- a/source/_ecosystem/hadashboard/dash_config.markdown +++ b/source/_ecosystem/hadashboard/dash_config.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- (All installations) diff --git a/source/_ecosystem/hadashboard/hapush.markdown b/source/_ecosystem/hadashboard/hapush.markdown index 8b4a96dca82..78ffc8e07ba 100755 --- a/source/_ecosystem/hadashboard/hapush.markdown +++ b/source/_ecosystem/hadashboard/hapush.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- (Not necessary if you are using Docker) diff --git a/source/_ecosystem/hadashboard/installation.markdown b/source/_ecosystem/hadashboard/installation.markdown index 49659a09fda..2b2c2801ae0 100755 --- a/source/_ecosystem/hadashboard/installation.markdown +++ b/source/_ecosystem/hadashboard/installation.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- Installation can be performed using Docker (Contributed by [marijngiesen](https://github.com/marijngiesen)) or manually if Docker doesn't work for you. We also have a Raspberry PI version of Docker contributed by [snizzleorg](https://community.home-assistant.io/users/snizzleorg/activity) diff --git a/source/_ecosystem/hadashboard/reboot.markdown b/source/_ecosystem/hadashboard/reboot.markdown index 243347fef5a..17ca88d8af0 100755 --- a/source/_ecosystem/hadashboard/reboot.markdown +++ b/source/_ecosystem/hadashboard/reboot.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- To run Dashing and `hapush` at reboot, I have provided sample init scripts in the `./init` directory. These have been tested on a Raspberry PI - your mileage may vary on other systems. diff --git a/source/_ecosystem/hadashboard/updating.markdown b/source/_ecosystem/hadashboard/updating.markdown index 0f957044d57..748cca6341f 100755 --- a/source/_ecosystem/hadashboard/updating.markdown +++ b/source/_ecosystem/hadashboard/updating.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- To update the dashboard after new code has been released, just run the following command to update your copy: diff --git a/source/_ecosystem/ios.markdown b/source/_ecosystem/ios.markdown index 49dc72fbf54..234eef7a9d4 100644 --- a/source/_ecosystem/ios.markdown +++ b/source/_ecosystem/ios.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- 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: diff --git a/source/_ecosystem/ios/notifications/examples.markdown b/source/_ecosystem/ios/notifications/examples.markdown deleted file mode 100644 index e69de29bb2d..00000000000 diff --git a/source/_ecosystem/scenegen.markdown b/source/_ecosystem/scenegen.markdown index 77c3590ecbf..0d8a8d047a7 100644 --- a/source/_ecosystem/scenegen.markdown +++ b/source/_ecosystem/scenegen.markdown @@ -7,8 +7,6 @@ sidebar: true comments: false sharing: true footer: true -regenerate: true -hide_github_edit: true --- Scenegen is a scene generation tool for [Home Assistant](https://home-assistant.io/) home automation software. It creates scenes by example, by reading the current states of devices and outputting a corresponding scene. Scenegen is written in python using Home Assistant's RESTFul API so can be run from anywhere. It currently supports lights and switches only. From 6c7c07cad55bbddfc22cec23ac861eeaf784adfb Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 8 Dec 2016 23:03:11 -0800 Subject: [PATCH 04/42] Add synology stub --- source/_ecosystem/synology.markdown | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 source/_ecosystem/synology.markdown diff --git a/source/_ecosystem/synology.markdown b/source/_ecosystem/synology.markdown new file mode 100644 index 00000000000..93002049f71 --- /dev/null +++ b/source/_ecosystem/synology.markdown @@ -0,0 +1,24 @@ +--- +layout: page +title: "Synology" +description: "Instructions how to get Home Assistant up and running on Synology" +release_date: 2016-12-07 15:00:00 -0500 +sidebar: true +comments: false +sharing: true +footer: true +--- + +Synology NAS are the perfect companion to running Home Assistant. + +### {% linkable_title HTTP Configuration %} + +Synology will require some extra configuration to get the Home Assistant frontend working. + +- Copy the Home Assistant specific Reverse Proxy settings from the existing `/etc/nginx/app.d/server.ReverseProxy.conf` to `/usr/local/etc/nginx/conf.d/http.HomeAssistant.conf` +- Include these lines in the location declaration: + +``` + proxy_set_header Upgrade $http_upgrade; + proxy_set_header Connection "upgrade"; +``` From b592e9f4eed1beb6bbec1921dc285aff651861bf Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Thu, 8 Dec 2016 23:11:09 -0800 Subject: [PATCH 05/42] Update browsers.markdown --- source/getting-started/browsers.markdown | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/source/getting-started/browsers.markdown b/source/getting-started/browsers.markdown index a45460a227f..b2035b6b599 100644 --- a/source/getting-started/browsers.markdown +++ b/source/getting-started/browsers.markdown @@ -9,9 +9,7 @@ sharing: true footer: true --- -Home Assistant requires a web browser to show the frontend. Not all browsers include features which are needed to use the Home Assistant frontend. If you are running into trouble, check the list below. - -We don't test the web interface against all available browsers but this page tracks different browsers on various operating systems and should help you to pick a browser which works. +Home Assistant requires a web browser to show the frontend and supports all major modern browsers. We don't test the web interface against all available browsers but this page tracks different browsers on various operating systems and should help you to pick a browser which works. We would appreciate if you help to keep this page up-to-date and add feedback. @@ -19,8 +17,8 @@ We would appreciate if you help to keep this page up-to-date and add feedback. | Browser | Release | State | Comments | | :------------------------ |:---------------|:-----------|:-------------------------| -| Internet Explorer ([IE]) | 11 | partially | Streaming updates not working. Display issues | -| Microsoft [Edge] | deli. Win 10 | partially | Streaming updates not working. | +| Internet Explorer ([IE]) | 11 | Not supported | Does not support promises. | +| Microsoft [Edge] | deli. Win 10 | works | Streaming updates not working. | | [Chrome] | 50.0.2661.102 | works | | | [Firefox] | 43.0.1 | works | | | [Iridium] | 48.2 | works | | @@ -52,8 +50,8 @@ We would appreciate if you help to keep this page up-to-date and add feedback. | Browser | Release | State | Comments | | :-------------------- |:---------------|:-----------|:-------------------------| -| [Chrome] | 50.0.2661.89 | works | | -| [Firefox] | 46.0.1 | works | | +| [Chrome] | 50.0.2661.89 | works | Can also be added to desktop | +| [Firefox] | 46.0.1 | works | Can also be added to desktop | ## {% linkable_title iOS %} From 0bca33a7eb76cc8e9f01ab3ba790bcf53832f467 Mon Sep 17 00:00:00 2001 From: Thomas Redmer Date: Fri, 9 Dec 2016 10:18:33 +0100 Subject: [PATCH 06/42] Update sensor.fritzbox_callmonitor.markdown (#1561) Escape asterisks in dialcode to suppress automatic formatting. --- source/_components/sensor.fritzbox_callmonitor.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.fritzbox_callmonitor.markdown b/source/_components/sensor.fritzbox_callmonitor.markdown index f792d0a3291..50ad6f2d2ed 100644 --- a/source/_components/sensor.fritzbox_callmonitor.markdown +++ b/source/_components/sensor.fritzbox_callmonitor.markdown @@ -17,7 +17,7 @@ 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. -To activate the call monitor on your Fritz!Box, dial #96*5* from any phone connected to it. +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: From 6662d15d1ca84d218ba59f5b477dfbb12aa233ea Mon Sep 17 00:00:00 2001 From: David Date: Fri, 9 Dec 2016 10:19:09 +0100 Subject: [PATCH 07/42] Update HTTP component page (#1567) clarify what values are accepted for the configuration variable use_x_forwarded_for --- source/_components/http.markdown | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/source/_components/http.markdown b/source/_components/http.markdown index 63ecfe19ab5..89463c89801 100644 --- a/source/_components/http.markdown +++ b/source/_components/http.markdown @@ -32,7 +32,7 @@ Configuration variables: - **ssl_certificate** (*Optional*): Path to your TLS/SSL certificate to serve Home Assistant over a secure connection. - **ssl_key** (*Optional*): Path to your TLS/SSL key to serve Home Assistant over a secure connection. - **cors_allowed_origins** (*Optional*): A list of origin domain names to allow [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) requests from. Enabling this will set the `Access-Control-Allow-Origin` header to the Origin header if it is found in the list, and the `Access-Control-Allow-Headers` header to `Origin, Accept, X-Requested-With, Content-type, X-HA-access`. You must provide the exact Origin, i.e. `https://home-assistant.io` will allow requests from `https://home-assistant.io` but __not__ `http://home-assistant.io`. -- **use_x_forwarded_for** (*Optional*): Enable parsing of the `X-Forwarded-For` header, passing on the client's correct IP address in proxied setups. You should only enable this in a trustworthy network environment, as clients passing that header could easily spoof their source IP address. +- **use_x_forwarded_for** (*Optional*): Enable parsing of the `X-Forwarded-For` header, passing on the client's correct IP address in proxied setups. You should only enable this in a trustworthy network environment, as clients passing that header could easily spoof their source IP address. Defaults to False. - **trusted_networks** (*Optional*): List of trusted networks, consisting of IP addresses or networks, that are allowed to bypass password protection when accessing Home Assistant. - **ip_ban_enabled** (*Optional*): Flag indicating whether additional IP filtering is enabled. Defaults to False. - **login_attempts_threshold** (*Optional*): Number of failed login attemt from single IP after which it will be automatically banned if `ip_ban_enabled` is True. Defaults to -1, meaning that no new automatic bans will be added. @@ -49,6 +49,7 @@ http: cors_allowed_origins: - https://google.com - https://home-assistant.io + use_x_forwarded_for: True trusted_networks: - 127.0.0.1 - ::1 @@ -81,4 +82,4 @@ After a ban is added a Persistent Notification is populated to the Home Assistan

Please note, that sources from `trusted_networks` won't be banned automatically. -

\ No newline at end of file +

From ea78823c05bc737b683313e089e4f30b2a41c792 Mon Sep 17 00:00:00 2001 From: heytcass Date: Fri, 9 Dec 2016 11:44:18 -0500 Subject: [PATCH 08/42] Fixes broken nmap link. (#1571) Changed nmap_scanner to nmap_tracker to prevent 404. --- source/_components/device_tracker.owntracks.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.owntracks.markdown b/source/_components/device_tracker.owntracks.markdown index ca806f3c2d4..c02973b6e77 100644 --- a/source/_components/device_tracker.owntracks.markdown +++ b/source/_components/device_tracker.owntracks.markdown @@ -46,7 +46,7 @@ device_tracker: ``` ### {% linkable_title Using Owntracks with other device trackers %} -Owntracks can also be used with other device trackers, such as [Nmap](/components/device_tracker.nmap_scanner/) or [Netgear](/components/device_tracker.netgear/). To do this, fill in the `mac` field to the Owntracks entry in `known_devices.yaml` with the MAC address of the device you want to track. This way the state of the device will be determined by the source that reported last. The naming convention for known device list is `_` and could be set in app configuration. More details about this config can found in [device tracker](/components/device_tracker/). +Owntracks can also be used with other device trackers, such as [Nmap](/components/device_tracker.nmap_tracker/) or [Netgear](/components/device_tracker.netgear/). To do this, fill in the `mac` field to the Owntracks entry in `known_devices.yaml` with the MAC address of the device you want to track. This way the state of the device will be determined by the source that reported last. The naming convention for known device list is `_` and could be set in app configuration. More details about this config can found in [device tracker](/components/device_tracker/). ### {% linkable_title Using Owntracks regions %} Owntracks can track regions, and send region entry and exit information to Home Assistant (HA). You set up a region in the Owntracks app which you should name the same as your HA Zone, and then make sure to turn on the `share` option for the region in the owntracks app. Please see the [owntracks documentation](http://owntracks.org/booklet/guide/waypoints/). From 89fb4a3946d5ed8f5848c03bf27b6b9b7a008647 Mon Sep 17 00:00:00 2001 From: Carlo Costanzo Date: Fri, 9 Dec 2016 16:23:37 -0500 Subject: [PATCH 09/42] added example of changing input boolean. (#1566) * added example of changing input boolean. Setting it programmatically. * Update input_boolean.markdown --- source/_components/input_boolean.markdown | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/source/_components/input_boolean.markdown b/source/_components/input_boolean.markdown index 68d26181d13..541582d4795 100644 --- a/source/_components/input_boolean.markdown +++ b/source/_components/input_boolean.markdown @@ -50,3 +50,11 @@ automation: title: "" message: "Honey, I'm home!" ``` + +You can also set or change the status of an `input_boolean` by using `input_boolean.turn_on` and `input_boolean.turn_off` in your automations. + +```yaml + - service: input_boolean.turn_on + data: + entity_id: input_boolean.notify_home +``` From 97c07a63bfa5ce19759db7f3b367739f4c55f19a Mon Sep 17 00:00:00 2001 From: thrust15 Date: Sat, 10 Dec 2016 13:00:00 +0100 Subject: [PATCH 10/42] Update media_player.samsungtv.markdown --- 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 a34d316963a..4bf4eed838f 100644 --- a/source/_components/media_player.samsungtv.markdown +++ b/source/_components/media_player.samsungtv.markdown @@ -52,6 +52,7 @@ Currently tested but not working models: - KU6300 - Shows in GUI but unable to control. - H6400 - Shows in GUI but unable to control. +- J5200 - Unable to see state and unable to control If your model is not on the list then give it a test, if everything works correctly then add it to the list on [GitHub](https://github.com/home-assistant/home-assistant.github.io/tree/current/source/_components/media_player.samsungtv.markdown). The first letter (U, P, L, H & K) represent the screen type, e.g. LED or Plasma. The second letter represents the region, E is Europe, N is North America and A is Asia & Australia. The two numbers following that represent the screen size. From 5b0fbb0efd85931ea0b51f33b094fb3a9dc174cd Mon Sep 17 00:00:00 2001 From: Joseph Hassell Date: Sat, 10 Dec 2016 16:14:49 -0600 Subject: [PATCH 11/42] Added D6300SF to the working model list (#1578) I would create a new section ("Currently known partially supported models") for the D6300SF as I am able to control state, play/pause, media_next_track, media_previous_track, volume_down, volume_up, volume_mute; HOWEVER, there are no controls for changing input/source, or up down left right(D-pad) with enter, or channel buttons. --- 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 4bf4eed838f..be9dd04a1a5 100644 --- a/source/_components/media_player.samsungtv.markdown +++ b/source/_components/media_player.samsungtv.markdown @@ -47,6 +47,7 @@ Currently known supported models: - EH5600 - F6400AF - D6505 +- D6300SF Currently tested but not working models: From 488374e79a16f297eeea92a65c8f067f37170a87 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20H=C3=B8yer=20Iversen?= Date: Sat, 10 Dec 2016 23:15:37 +0100 Subject: [PATCH 12/42] Update sensor.miflora.markdown (#1575) --- source/_components/sensor.miflora.markdown | 1 + 1 file changed, 1 insertion(+) diff --git a/source/_components/sensor.miflora.markdown b/source/_components/sensor.miflora.markdown index 66b6c932bce..682ec04dd9e 100644 --- a/source/_components/sensor.miflora.markdown +++ b/source/_components/sensor.miflora.markdown @@ -31,6 +31,7 @@ sensor - light - temperature - conductivity + - battery ``` - **mac** (*Required*): The MAC address of your sensor. You can find this be running `hcitool lescan` from command line. From 0f563bc3358d8fb91f2ff3fd7b06be09410c3942 Mon Sep 17 00:00:00 2001 From: Tobias Hutterer Date: Sat, 10 Dec 2016 23:16:03 +0100 Subject: [PATCH 13/42] spell check (#1573) --- source/_components/light.hue.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.hue.markdown b/source/_components/light.hue.markdown index 4114def7367..a779480853d 100644 --- a/source/_components/light.hue.markdown +++ b/source/_components/light.hue.markdown @@ -81,7 +81,7 @@ The Hue API doesn't activate Scenes directly, only on a Hue Group (typically Rooms, especially if using the 2nd gen app). But Hue Scenes don't actually reference their group. So heuristic matching is used. -Neither Group names or Scene names are guarunteed unique in Hue. If +Neither Group names or Scene names are guaranteed unique in Hue. If you are getting non deterministic behavior, adjust your Hue scenes via the App to be more identifying. From cfc789687c8ceab9e2ea1bd1e867e36d45f28da2 Mon Sep 17 00:00:00 2001 From: Rob Cranfill Date: Sat, 10 Dec 2016 14:16:37 -0800 Subject: [PATCH 14/42] Clarification of hardware interfaces (#1580) Clarification of which hardware interfaces the code will work with. The CM17A does not work - it does not, for example, support the "heyu info" command that this code relies on. --- source/_components/light.x10.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/light.x10.markdown b/source/_components/light.x10.markdown index c8a8b8f5277..19e6dbe43cd 100644 --- a/source/_components/light.x10.markdown +++ b/source/_components/light.x10.markdown @@ -15,7 +15,7 @@ ha_release: 0.25 The `x10` light platform allows you to control your X10 based lights with Home Assistant. -Requires [Heyu x10 interface](http://www.heyu.org). +Requires [Heyu x10](http://www.heyu.org) and a CM11A interface; the CM17A "FireCracker" interface is not supported. To enable those lights, add the following lines to your `configuration.yaml` file: From be9cc2ba25b5d5f5ed7080f70df871dd52d5b13d Mon Sep 17 00:00:00 2001 From: Will Heid Date: Sat, 10 Dec 2016 14:17:29 -0800 Subject: [PATCH 15/42] change port: to broker: to reflect the configuration example above it. (#1572) to reflect the configuration example above it. --- source/_topics/splitting_configuration.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_topics/splitting_configuration.markdown b/source/_topics/splitting_configuration.markdown index 513f86da9aa..5a0d63ac791 100644 --- a/source/_topics/splitting_configuration.markdown +++ b/source/_topics/splitting_configuration.markdown @@ -61,7 +61,7 @@ zwave: mqtt: broker: 127.0.0.1 ``` -As with the core snippet, indentation makes a difference. The component headers (`mqtt:`) should be fully left aligned (aka no indent), and the parameters (`port:`) should be indented two (2) spaces. +As with the core snippet, indentation makes a difference. The component headers (`mqtt:`) should be fully left aligned (aka no indent), and the parameters (`broker:`) should be indented two (2) spaces. While some of these components can technically be moved to a separate file they are so small or "one off's" where splitting them off is superfluous. Also, you'll notice the # symbol (hash/pound). This represents a "comment" as far as the commands are interpreted. Put another way, any line prefixed with a `#` will be ignored. This makes breaking up files for human readability really convenient, not to mention turning off features while leaving the entry intact. (Look at the `zigbee:` entry above and the b entry further down) From c9396253042e29ff9cae13882b5e6d70bdc0d7d3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20H=C3=B8yer=20Iversen?= Date: Sat, 10 Dec 2016 23:19:37 +0100 Subject: [PATCH 16/42] Update templating.markdown (#1576) --- source/_topics/templating.markdown | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/source/_topics/templating.markdown b/source/_topics/templating.markdown index 55fa5c3fddb..10ddbff78d9 100644 --- a/source/_topics/templating.markdown +++ b/source/_topics/templating.markdown @@ -44,13 +44,12 @@ script: msg_who_is_home: sequence: - service: notify.notify - data_template: - message: > - {% raw %}{% if is_state('device_tracker.paulus', 'home') %} - Ha, Paulus is home! - {% else %} - Paulus is at {{ states('device_tracker.paulus') }}. - {% endif %}{% endraw %} + message: > + {% raw %}{% if is_state('device_tracker.paulus', 'home') %} + Ha, Paulus is home! + {% else %} + Paulus is at {{ states('device_tracker.paulus') }}. + {% endif %}{% endraw %} ``` [Jinja2](http://jinja.pocoo.org/) supports a width variety of operations: From 9e56d1d7f9941bb4a35ebb0c939b88a8059ef432 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 10 Dec 2016 23:29:38 +0100 Subject: [PATCH 17/42] Minimize the configuration sample and update layout --- source/_components/sensor.miflora.markdown | 53 ++++++++++++++-------- 1 file changed, 35 insertions(+), 18 deletions(-) diff --git a/source/_components/sensor.miflora.markdown b/source/_components/sensor.miflora.markdown index 682ec04dd9e..e33c8347a23 100644 --- a/source/_components/sensor.miflora.markdown +++ b/source/_components/sensor.miflora.markdown @@ -13,37 +13,54 @@ ha_release: 0.29 ha_iot_class: "Local Polling" --- -The [Mi Flora plant sensor](https://www.open-homeautomation.com/2016/08/23/reverse-engineering-the-mi-plant-sensor/) is a small Bluetooth Low Energy device that monitors not only the moisture, but also light, temperature and -conductivity. As only a single BLE device can be polled at the same time, the library implements locking to make sure this is the case. +The [Mi Flora plant sensor](https://www.open-homeautomation.com/2016/08/23/reverse-engineering-the-mi-plant-sensor/) is a small Bluetooth Low Energy device that monitors not only the moisture, but also light, temperature and conductivity. As only a single BLE device can be polled at the same time, the library implements locking to make sure this is the case. To use your Mi Flora plant sensor in your installation, add the following to your `configuration.yaml` file: ```yaml # Example configuration.yaml entry sensor - platform: miflora - mac: xx:xx:xx:xx:xx:xx - name: Flower 1 - force_update: false - median: 3 - monitored_conditions: - - moisture - - light - - temperature - - conductivity - - battery + - platform: miflora + mac: xx:xx:xx:xx:xx:xx + monitored_conditions: + - temperature ``` - **mac** (*Required*): The MAC address of your sensor. You can find this be running `hcitool lescan` from command line. +- **monitored_conditions** array (*Required*): The paramaters that should be monitored. + - **moisture**: Moisture in the soil. + - **light**: Brightness at the sensor's location. + - **temperature**: Temperature at the sensor's location. + - **conductivity**: Conductivity in the soil. + - **battery**: Battery details. - **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. -- **monitored_conditions** (*Required*): The paramaters that should be monitored. +- **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** (*Optional*): Define cache expiration value in seconds (defaults to 1200 if not defined) -Note that by default the sensor is only polled once every 15 minutes. This means with the median=3 setting, it will take as least 30 minutes before the sensor will report a value after a Home Assistant restart. As the values usually change very slowly, this isn't a big problem. +Note that by default the sensor is only polled once every 15 minutes. This means with the `median: 3` setting will take as least 30 minutes before the sensor will report a value after a Home Assistant restart. As the values usually change very slowly, this isn't a big problem. Reducing polling intervals will have a negative effect on the battery life. + +A full configuration example could looks the one below: + +```yaml +# Example configuration.yaml entry +sensor + - platform: miflora + mac: xx:xx:xx:xx:xx:xx + name: Flower 1 + force_update: false + median: 3 + monitored_conditions: + - moisture + - light + - temperature + - conductivity + - battery +``` + + + + From 0d304ca7e868422b4ee68486a6379e24e0d3d23c Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 10 Dec 2016 23:32:50 +0100 Subject: [PATCH 18/42] Minimize configuration sample --- source/_components/sensor.openweathermap.markdown | 8 -------- 1 file changed, 8 deletions(-) diff --git a/source/_components/sensor.openweathermap.markdown b/source/_components/sensor.openweathermap.markdown index acc9d91e3b8..cdc25f3f97d 100644 --- a/source/_components/sensor.openweathermap.markdown +++ b/source/_components/sensor.openweathermap.markdown @@ -26,13 +26,6 @@ sensor: api_key: YOUR_API_KEY monitored_conditions: - weather - - temperature - - wind_speed - - humidity - - pressure - - clouds - - rain - - snow ``` Configuration variables: @@ -54,4 +47,3 @@ Details about the API are available in the [OpenWeatherMap documentation](http:/ Only metric measurements are supported at the moment. - From 59be089733cdce9c4caf51dafa6061a197f924e4 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 10 Dec 2016 23:48:16 +0100 Subject: [PATCH 19/42] Add warning (fixed #1564) --- source/_components/sensor.nest_weather.markdown | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/source/_components/sensor.nest_weather.markdown b/source/_components/sensor.nest_weather.markdown index c7df23d3366..fd11fbccb68 100644 --- a/source/_components/sensor.nest_weather.markdown +++ b/source/_components/sensor.nest_weather.markdown @@ -12,6 +12,10 @@ ha_category: Weather ha_iot_class: "Cloud Poll" --- +

+**This platform is currently not available. It's possible that `nest_weather` will be removed in the future.** +

+ The `nest` weather sensor platform let you monitor current weather conditions based on the location of your [Nest](https://nest.com) thermostat. From 102adee9e4abe096d267386fb3749c61c31dd25a Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Sat, 10 Dec 2016 23:53:21 +0100 Subject: [PATCH 20/42] Update link to nmap_tracker (fixes #1570) --- source/_components/device_tracker.locative.markdown | 2 +- source/_components/device_tracker.owntracks.markdown | 2 +- .../_posts/2016-09-10-notify-group-reload-api-pihole.markdown | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_components/device_tracker.locative.markdown b/source/_components/device_tracker.locative.markdown index 2379db6bfb9..7409c6960b2 100644 --- a/source/_components/device_tracker.locative.markdown +++ b/source/_components/device_tracker.locative.markdown @@ -34,4 +34,4 @@ To configure Locative, you must set up the app to send a `GET` request to your H When you enter a geofence, your location name in Home Assistant will be set to the name of the geofence in Locative. When you exit a geofence, your location name in Home Assistant will be set to "not home". -To use Locative in combination with another device tracker, such as [nmap](/components/device_tracker.nmap_scanner/) or [Netgear](/components/device_tracker.netgear/), fill in the `mac` field to the Locative entry in `known_devices.yaml` with the MAC address of the device you want to track. The state of the device will be determined by the source that reported last. +To use Locative in combination with another device tracker, such as [nmap](/components/device_tracker.nmap_tracker/) or [Netgear](/components/device_tracker.netgear/), fill in the `mac` field to the Locative entry in `known_devices.yaml` with the MAC address of the device you want to track. The state of the device will be determined by the source that reported last. diff --git a/source/_components/device_tracker.owntracks.markdown b/source/_components/device_tracker.owntracks.markdown index c02973b6e77..a8e6e4989fd 100644 --- a/source/_components/device_tracker.owntracks.markdown +++ b/source/_components/device_tracker.owntracks.markdown @@ -30,7 +30,7 @@ Configuration variables: - **max_gps_accuracy** (*Optional*): Sometimes Owntracks can report GPS location with a very low accuracy (few kilometers). That can trigger false zoning in your Home Assistant installation. With the parameter, you can filter these GPS reports. The number has to be in meter. For example, if you put 200 only GPS report with an accuracy under 200 will be take in account. - **waypoints** (*Optional*): Owntracks users can define [waypoints](http://owntracks.org/booklet/features/waypoints/) (a.k.a regions) which are similar in spirit to Home Assistant zones. If this configuration variable is `True`, the Owntracks users who are in `waypoint_whitelist` can export waypoints from the device and Home Assistant will import them as zone definitions. Defaults to `True`. -- **waypoint_whitelist** (*Optional*): A list of user names (as defined for [Owntracks](https://home-assistant.io/components/device_tracker.owntracks/)) who can export their waypoints from Owntracks to Home Assistant. Defaults to all users who are connected to Home Assistant via Owntracks. +- **waypoint_whitelist** (*Optional*): A list of user names (as defined for [Owntracks](/components/device_tracker.owntracks/)) who can export their waypoints from Owntracks to Home Assistant. Defaults to all users who are connected to Home Assistant via Owntracks. A full sample configuration for the `owntracks` platform is shown below: diff --git a/source/_posts/2016-09-10-notify-group-reload-api-pihole.markdown b/source/_posts/2016-09-10-notify-group-reload-api-pihole.markdown index 36b773715eb..8d3c9c63fea 100644 --- a/source/_posts/2016-09-10-notify-group-reload-api-pihole.markdown +++ b/source/_posts/2016-09-10-notify-group-reload-api-pihole.markdown @@ -147,7 +147,7 @@ The validation of the configuration is still on-going. Approximatly 80 % is done [Temper]: /components/sensor.temper/ [mqtt-fan]: /components/fan.mqtt/ [Xbox]: /components/sensor.xbox_live/ -[Nmap]: /components/device_tracker.nmap_scanner/ +[Nmap]: /components/device_tracker.nmap_tracker/ [automatic]: /components/device_tracker.automatic/ [Owntracks]: /components/device_tracker.owntracks/ [OpenweatherMap]: /components/sensor.openweathermap/ From 766b8742ad51f58769479e764a55617b339e15cb Mon Sep 17 00:00:00 2001 From: Paulus Schoutsen Date: Sun, 11 Dec 2016 22:51:01 -0800 Subject: [PATCH 21/42] Release 0.34.5 --- _config.yml | 6 +++--- .../_posts/2016-12-03-remote-websockets-sonarr.markdown | 8 ++++++++ 2 files changed, 11 insertions(+), 3 deletions(-) diff --git a/_config.yml b/_config.yml index 748dcef8274..9447bcd4cba 100644 --- a/_config.yml +++ b/_config.yml @@ -131,9 +131,9 @@ social: # Home Assistant release details current_major_version: 0 current_minor_version: 34 -current_patch_version: 4 -date_released: 2016-12-07 +current_patch_version: 5 +date_released: 2016-12-12 # Either # or the anchor link to latest release notes in the blog post. # Must be prefixed with a # and have double quotes around it. -patch_version_notes: "#release-0344---december-7" +patch_version_notes: "#release-0345---december-12" diff --git a/source/_posts/2016-12-03-remote-websockets-sonarr.markdown b/source/_posts/2016-12-03-remote-websockets-sonarr.markdown index de9362b6bd5..0f4c1fc5f9b 100644 --- a/source/_posts/2016-12-03-remote-websockets-sonarr.markdown +++ b/source/_posts/2016-12-03-remote-websockets-sonarr.markdown @@ -120,6 +120,13 @@ We are working on a better solution for 0.35. - Fix incorrect ordering of service calls which could cause delays inbetween turning on multiple entities ([@balloob]) - Fix Nest Climate temperature issues ([@technicalpickles]) +### {% linkable_title Release 0.34.5 - December 12 %} + + - Fix Nest sensors doing I/O inside event loop ([@balloob]) + - Fix Nest version bump not triggering re-install ([@R1chardTM]) + - Fix Nest cameras without activity zones ([@technicalpickles]) + - Fix Plex doing I/O inside event loop ([@balloob]) + ### {% linkable_title Breaking changes %} - The [HomeMatic][homematic] component now uses a different syntax for hosts and the `set_value` service has been renamed. @@ -135,6 +142,7 @@ We are working on a better solution for 0.35. 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. +[@R1chardTM]: https://github.com/R1chardTM [@armills]: https://github.com/armills [@jawilson]: https://github.com/jawilson [@rubund]: https://github.com/rubund From 4c4cab025aead33ac42e07a03c6ec387d1b38681 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Mon, 12 Dec 2016 23:20:39 +0100 Subject: [PATCH 22/42] Add workshop@Puzzle ITC --- source/help/index.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/help/index.markdown b/source/help/index.markdown index 7162adf59db..c81778e80ab 100644 --- a/source/help/index.markdown +++ b/source/help/index.markdown @@ -29,11 +29,12 @@ Have you found an issue in your Home Assistant installation? Please report it. R ### {% linkable_title Videos, interviews, talks, and alike %} +- [Home Assistant - Erweiterungen](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016 +- [Automating Your Life - Home Automation](http://slides.com/teagan42/life_automation#/) at Develop Denver 2016 - August - [Building Online Communities: Home Assistant](https://medium.com/@gitter/building-online-communities-home-assistant-8818dff671ad#.och4x4rhx) - July 2016 - [Home Assistant Support 101 - Getting around in Home Assistant](https://www.youtube.com/watch?v=dRfk9JAlPJk) ([Slides](https://docs.google.com/presentation/d/1PUnOpeFZxNj4LEjaohGqH_1hOGQGuS5yRHD1ThHr6nk/edit?usp=sharing)) - June 2016 - [Awaken your home: Python and the Internet of Things](https://www.youtube.com/watch?v=Cfasc9EgbMU&list=PLKsVm4cWHDQB9JBcD7_ZfNcvC6xx47QHT&index=1) at PyCon 2016 - June 2016 - [Automating your Home with Home Assistant](https://www.youtube.com/watch?v=4-6rTwKl6ww&list=PLKsVm4cWHDQB9JBcD7_ZfNcvC6xx47QHT&index=2) at OpenIoT 2016 - March 2016 -- [Automating Your Life - Home Automation](http://slides.com/teagan42/life_automation#/) at Develop Denver 2016 - August Looking for [talking points](/help/talking-points/) or [trivia](/help/trivia)? From 5a3cffd8be8309d1620d435b9397f538e381e80d Mon Sep 17 00:00:00 2001 From: Alok Saboo Date: Tue, 13 Dec 2016 05:40:05 -0500 Subject: [PATCH 23/42] Completed the config (#1586) --- source/_components/climate.honeywell.markdown | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/source/_components/climate.honeywell.markdown b/source/_components/climate.honeywell.markdown index 0e7b0566ff3..82d7a40f81c 100644 --- a/source/_components/climate.honeywell.markdown +++ b/source/_components/climate.honeywell.markdown @@ -20,11 +20,12 @@ To set it up, add the following information to your `configuration.yaml` file: climate: platform: honeywell username: YOUR_USERNAME + password: YOUR_PASSWORD ``` Configuration variables: -- **username** (*Required*: The username of an user with access. +- **username** (*Required*): The username of an user with access. - **password** (*Required*): The password for your given admin account. - **away_temperature** (*optional*): Heating setpoint when away mode is on. If omitted it defaults to 16.0 deg C. - **region** (*optional*): Region identifier (either 'eu' or 'us'). Defaults to 'eu' if not provided. From 4edabe533eac3d9aee292b3d5a06cf9a923d49a6 Mon Sep 17 00:00:00 2001 From: chris-thorn Date: Tue, 13 Dec 2016 11:13:51 +0000 Subject: [PATCH 24/42] Update alexa.markdown (#1585) Changed "but" to "put" on line 293 --- source/_components/alexa.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/alexa.markdown b/source/_components/alexa.markdown index 5b8397a9b90..1c32f9d02fd 100644 --- a/source/_components/alexa.markdown +++ b/source/_components/alexa.markdown @@ -290,7 +290,7 @@ First create a file called `alexa_confirm.yaml` with something like the followin ] | random }} {% endraw %} ``` -Then, wherever you would but some simple text for a response like`OK`, replace it with a reference to the file so that: +Then, wherever you would put some simple text for a response like `OK`, replace it with a reference to the file so that: ``` text: OK From 5493d33fea6ffe01de253630db3007657657e617 Mon Sep 17 00:00:00 2001 From: William Scanlon Date: Tue, 13 Dec 2016 14:34:16 -0500 Subject: [PATCH 25/42] Update feedreader.markdown Added additional example of feedreader automation to explain how to access data form the feed in the automation. --- source/_components/feedreader.markdown | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/source/_components/feedreader.markdown b/source/_components/feedreader.markdown index 099474692a4..b1eee59e2ad 100644 --- a/source/_components/feedreader.markdown +++ b/source/_components/feedreader.markdown @@ -41,6 +41,19 @@ automation: entity_id: script.my_action ``` +```yaml +automation: + - alias: Send notification of RSS feed title when updated + trigger: + platform: event + event_type: feedreader + action: + service: notify.notify + data_template: "{{ trigger.event.data.title }}" +``` + +*Any field under the `` tag in the feed can be used for example `tigger.event.data.content` will get the body of the feed entry. + For more advanced use cases, a custom component registering to the `feedreader` event type could be used instead: ```python From bff06a26374e6ba5accadc995395024af10f014a Mon Sep 17 00:00:00 2001 From: heytcass Date: Wed, 14 Dec 2016 02:07:46 -0500 Subject: [PATCH 26/42] Fixing tense typos. (#1590) --- source/_components/sensor.scrape.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/sensor.scrape.markdown b/source/_components/sensor.scrape.markdown index 1c9de31d49e..e5e3625d936 100644 --- a/source/_components/sensor.scrape.markdown +++ b/source/_components/sensor.scrape.markdown @@ -13,7 +13,7 @@ ha_release: 0.31 --- -The `scrape` sensor platform is scraping information from websites. The sensor loads a HTML page and gives you the option to search and split out a value. As this is not a full-blown web scraper like [scrapy](https://scrapy.org/). It will most likely only works with simple webpage and it can be time-consuming to get the right section. +The `scrape` sensor platform is scraping information from websites. The sensor loads a HTML page and gives you the option to search and split out a value. As this is not a full-blown web scraper like [scrapy](https://scrapy.org/). It will most likely only work with simple webpages and it can be time-consuming to get the right section. To enable this sensor, add the following lines to your `configuration.yaml` file: From ce79bf09b78c3cbbbb7ede804131bc06dd66f3da Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Daniel=20H=C3=B8yer=20Iversen?= Date: Thu, 15 Dec 2016 00:16:10 +0100 Subject: [PATCH 27/42] Update installation-raspberry-pi-image.markdown (#1592) --- source/getting-started/installation-raspberry-pi-image.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/getting-started/installation-raspberry-pi-image.markdown b/source/getting-started/installation-raspberry-pi-image.markdown index f960b150dec..d21b1300180 100644 --- a/source/getting-started/installation-raspberry-pi-image.markdown +++ b/source/getting-started/installation-raspberry-pi-image.markdown @@ -37,7 +37,7 @@ Some extra tips: ### {% linkable_title Technical Details %} - - Home Assistant is installed in a virtual Python environment at `/src/homeassistant/` + - Home Assistant is installed in a virtual Python environment at `/srv/homeassistant/` - Home Assistant will be started as a service run by the user `homeassistant` - The configuration is located at `/home/homeassistant/.homeassistant` From 5313bf3b961242f141797908bfd4b341bc84f523 Mon Sep 17 00:00:00 2001 From: Naren Salem Date: Thu, 15 Dec 2016 11:18:55 -0600 Subject: [PATCH 28/42] Add keyword 'condition' for completeness (#1524) Added the 'condition:' keyword to make it clear that for a basic condition definition, you will need that keyword twice. --- .../scripts-conditions.markdown | 68 ++++++++++--------- 1 file changed, 37 insertions(+), 31 deletions(-) diff --git a/source/getting-started/scripts-conditions.markdown b/source/getting-started/scripts-conditions.markdown index cbf6652398a..dde7f9cf2ef 100644 --- a/source/getting-started/scripts-conditions.markdown +++ b/source/getting-started/scripts-conditions.markdown @@ -74,12 +74,13 @@ For above, the condition passes if `value >= above`. For below, the condition pa You can optionally use a `value_template` to process the value of the state before testing it. ```yaml -condition: numeric_state -entity_id: sensor.temperature -above: 17 -below: 25 -# If your sensor value needs to be adjusted -value_template: {% raw %}{{ float(state.state) + 2 }}{% endraw %} +condition: + condition: numeric_state + entity_id: sensor.temperature + above: 17 + below: 25 + # If your sensor value needs to be adjusted + value_template: {% raw %}{{ float(state.state) + 2 }}{% endraw %} ``` ### {% linkable_title State condition %} @@ -87,14 +88,15 @@ value_template: {% raw %}{{ float(state.state) + 2 }}{% endraw %} Tests if an entity is a specified state. ```yaml -condition: state -entity_id: device_tracker.paulus -state: not_home -# optional: trigger only if state was this for last X time. -for: - hours: 1 - minutes: 10 - seconds: 5 +condition: + condition: state + entity_id: device_tracker.paulus + state: not_home + # optional: trigger only if state was this for last X time. + for: + hours: 1 + minutes: 10 + seconds: 5 ``` ### {% linkable_title Sun condition %} @@ -104,10 +106,11 @@ The sun condition can test if the sun has already set or risen when a trigger oc [sun_trigger]: /getting-started/automation-trigger/#sun-trigger ```yaml -condition: sun -after: sunset -# Optional offset value -after_offset: "-1:00:00" +condition: + condition: sun + after: sunset + # Optional offset value + after_offset: "-1:00:00" ``` ### {% linkable_title Template condition %} @@ -115,8 +118,9 @@ after_offset: "-1:00:00" The template condition will test if the [given template][template] renders a value equal to true. This is achieved by having the template result in a true boolean expression or by having the template render 'true'. ```yaml -condition: template -value_template: '{% raw %}{{ states.device_tracker.iphone.attributes.battery > 50 }}{% endraw %}' +condition: + condition: template + value_template: '{% raw %}{{ states.device_tracker.iphone.attributes.battery > 50 }}{% endraw %}' ``` Within an automation, template conditions also have access to the `trigger` variable as [described here][automation-templating]. @@ -129,14 +133,15 @@ Within an automation, template conditions also have access to the `trigger` vari The time condition can test if it is after a specified time, before a specified time or if it is a certain day of the week ```yaml -condition: time -# At least one of the following is required. -after: '15:00:00' -before: '02:00:00' -weekday: - - mon - - wed - - fri +condition: + condition: time + # At least one of the following is required. + after: '15:00:00' + before: '02:00:00' + weekday: + - mon + - wed + - fri ``` Valid values for `weekday` are `mon`, `tue`, `wed`, `thu`, `fri`, `sat`, `sun`. @@ -147,9 +152,10 @@ Time condition windows can span across the midnight threshold. In the example ab Zone conditions test if an entity is in a certain zone. For zone automation to work, you need to have setup a device tracker platform that supports reporting GPS coordinates. Currently this is limited to the [OwnTracks platform](/components/device_tracker.owntracks/) and the [iCloud platform](/components/device_tracker.icloud/). ```yaml -condition: zone -entity_id: device_tracker.paulus -zone: zone.home +condition: + condition: zone + entity_id: device_tracker.paulus + zone: zone.home ``` ### {% linkable_title Examples %} From 280cf23e69227adf92f6dfc5c1c89a3136437621 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Tue, 13 Dec 2016 10:33:51 +0100 Subject: [PATCH 29/42] Add english translation --- source/help/index.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/help/index.markdown b/source/help/index.markdown index c81778e80ab..21a0bb27e4f 100644 --- a/source/help/index.markdown +++ b/source/help/index.markdown @@ -29,7 +29,7 @@ Have you found an issue in your Home Assistant installation? Please report it. R ### {% linkable_title Videos, interviews, talks, and alike %} -- [Home Assistant - Erweiterungen](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016 +- [Home Assistant - Erweiterungen (Platforms/Components)](https://github.com/home-assistant/home-assistant-assets/tree/master/german/2016-puzzle) at [Puzzle ITC](https://www.puzzle.ch/de/) - December 2016 - [Automating Your Life - Home Automation](http://slides.com/teagan42/life_automation#/) at Develop Denver 2016 - August - [Building Online Communities: Home Assistant](https://medium.com/@gitter/building-online-communities-home-assistant-8818dff671ad#.och4x4rhx) - July 2016 - [Home Assistant Support 101 - Getting around in Home Assistant](https://www.youtube.com/watch?v=dRfk9JAlPJk) ([Slides](https://docs.google.com/presentation/d/1PUnOpeFZxNj4LEjaohGqH_1hOGQGuS5yRHD1ThHr6nk/edit?usp=sharing)) - June 2016 From 57c708713d91730573adc82713ead1efa9699c33 Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 15 Dec 2016 18:38:39 +0100 Subject: [PATCH 30/42] Minor style updates and set titles as linkable --- .../hadashboard/dash_config.markdown | 139 +++++++++--------- source/_ecosystem/hadashboard/hapush.markdown | 15 +- .../hadashboard/installation.markdown | 16 +- .../_ecosystem/hadashboard/updating.markdown | 1 + 4 files changed, 88 insertions(+), 83 deletions(-) diff --git a/source/_ecosystem/hadashboard/dash_config.markdown b/source/_ecosystem/hadashboard/dash_config.markdown index 3e76aba4019..2fb2c4cda55 100755 --- a/source/_ecosystem/hadashboard/dash_config.markdown +++ b/source/_ecosystem/hadashboard/dash_config.markdown @@ -11,9 +11,9 @@ footer: true (All installations) -Hadashboard is a Dashing app, so make sure to read all the instructions on http://dashing.io to learn how to add widgets to your dashboard, as well as how to create new widgets. +Hadashboard is a Dashing application, so make sure to read all the instructions on http://dashing.io to learn how to add widgets to your dashboard, as well as how to create new widgets. -Make a copy of dashboards/example.erb and call it 'main.erb', then edit this file to reference the items you want to display and control and to get the layout that you want. Leave the original example.erb intact and unchanged so that you don't run into problems when trying to update using the git commands mentioned later in "Updating the Dashboard". +Make a copy of `dashboards/example.erb` and call it `main.erb`, then edit this file to reference the items you want to display and control and to get the layout that you want. Leave the original `example.erb` intact and unchanged so that you don't run into problems when trying to update using the git commands mentioned later in "Updating the Dashboard". The basic anatomy of a widget is this: ``` html @@ -32,47 +32,39 @@ The basic anatomy of a widget is this: Note that although it is legal in XML terms to split the inner `
` like this: ``` html -
  • -
    -
    -
    • +
  • +
    +
    +
    • ``` This may break `hapush`'s parsing of the file, so keep to the line format first presented. Please, refer to the Dashing website for instructions on how to change the grid and tile size, as well as more general instructions about widgets, their properties, and how to create new widgets. -# Supported Widgets +## {% linkable_title Supported Widgets %] At this time I have provided support for the following Home Assistant entity types. +- switch: Widget type **Haswitch** +- lock: Widget type **Halock** +- devicetracker: Widget type **Hadevicetracker** +- light: Widget type **Hadimmer** +- cover: Widget type **Hacover** +- input_boolean: Widget type **Hainputboolean** +- scene: Widget type **Hascene** -## switch -Widget type ***Haswitch*** -## lock -Widget type ***Halock*** -## devicetracker -Widget type ***Hadevicetracker*** -## light -Widget type ***Hadimmer*** -## cover -Widget type ***Hacover*** -## input_boolean -Widget type ***Hainputboolean*** -## scene -Widget type ***Hascene*** +- **data-ontime** (optional): The amount of time the scene icon lights up when pressed, in milliseconds, default 1000. -**data-ontime** (optional): The amount of time the scene icon lights up when pressed, in milliseconds, default 1000. - -## script +### {% linkable_title script %} Widget type ***Hascript*** **data-ontime** (optional): The amount of time the scene icon lights up when pressed, in milliseconds, default 1000. -## mode +### {% linkable_title mode %} The `Hamode` widget alows you to run a script on activation and to link it with a specified `input_select` so the button will be highlighted for certain values of that input select. The usecase for this is that I maintain an `input_select` as a flag for the state of the house to simplify other automations. I use scripts to switch between the states, and this feature provides feedback as to the current state by lighting up the appropriate mode button. @@ -83,37 +75,41 @@ A `Hamode` widget using this feature will look like this:
    ``` -**data-changemode**: The value of the `input_select` for which this script button will light up -**data-input**: The `input_select` entity to use (minus the leading entity type) +- **data-changemode**: The value of the `input_select` for which this script button will light up +- **data-input**: The `input_select` entity to use (minus the leading entity type) -## input_select (read only) -Widget type ***Hainputselect*** +### {% linkable_title input_select (read only) %} +Widget type **Hainputselect** -## sensor -Widget type ***Hasensor*** +### {% linkable_title sensor %} +Widget type **Hasensor** Text based output of the value of a particular sensor. -The Hasensor widget supports an additional paramater `data-unit` - this allows you to set the unit to whatever you want - Centigrade, %, lux or whatever you need for the sensor in question. For a temperature sensor you will need to explicitly include the degree symbol like this: +The Hasensor widget supports an additional paramater `data-unit`. This allows you to set the unit to whatever you want: Centigrade, %, lux or whatever you need for the sensor in question. For a temperature sensor you will need to explicitly include the degree symbol like this: + ```html data-unit="°F" ``` + If omitted, no units will be shown. -## sensor -Widget type ***Hameter*** +### {% linkable_title sensor %} +Widget type **Hameter** An alternative to the text based `Hasensor` that works for numeric values only. -The Hameter widget supports an additional paramater `data-unit` - this allows you to set the unit to whatever you want - Centigrade, %, lux or whatever you need for the sensor in question. For a temperature sensor you will need to explicitly include the degree symbol like this: +The Hameter widget supports an additional paramater `data-unit`. This allows you to set the unit to whatever you want: Centigrade, %, lux or whatever you need for the sensor in question. For a temperature sensor you will need to explicitly include the degree symbol like this: + ```html data-unit="°F" ``` + If omitted, no units will be shown. -## binary_sensor -Widget type ***Habinary*** +### {% linkable_title binary_sensor %} +Widget type **Habinary** An icon-based option for generic binary sensors. Useful for things like door contact sensors. In addition to the standard widget parameters, Habinary supports two additional parameters: @@ -122,12 +118,12 @@ An icon-based option for generic binary sensors. Useful for things like door con If no icons are specified, the widget defaults to a flat gray line for "off" and a green bullseye for "on". -## group -Widget type ***Hagroup*** +### {% linkable_title group %} +Widget type **Hagroup**. The Hagroup widget uses the homeassistant/turn_on and homeassistant/turn_off API call, so certain functionality will be lost. For example, you will not be able to use control groups of locks or dim lights. -# Alarm Control Panel +## {% linkable_title Alarm Control Panel %} These widgets allow the user to create a working control panel that can be used to control the Manual Alarm Control Panel component (https://home-assistant.io/components/alarm_control_panel.manual). The example dashboard contains an arrangement similar to this: @@ -136,31 +132,31 @@ These widgets allow the user to create a working control panel that can be used The Alarm Panel

    -Widget type ***Haalarmstatus*** +Widget type **Haalarmstatus** The Haalarmstatus widget displays the current status of the alarm_control_panel entity. It will also display the code as it is being entered by the user. The data-id must be the same as the alarm_control_panel entity_id in Home Assistant. -Widget type ***Haalarmdigit*** +Widget type **Haalarmdigit** The Haalarmdigit widget is used to create the numeric keypad for entering alarm codes. -data-digit holds the numeric value you wish to enter. The special value of "-" creates a 'clear' button which will wipe the code and return the Haalarmstatus widget display back to the current alarm state. +`data-digit` holds the numeric value you wish to enter. The special value of "-" creates a 'clear' button which will wipe the code and return the Haalarmstatus widget display back to the current alarm state. -data-alarmentity holds the data-id of the Haalarmstatus widget, so that the status widget can be correctly updated. It is mandatory for a 'clear' type digit and optional for normal numeric buttons. +`data-alarmentity` holds the data-id of the Haalarmstatus widget, so that the status widget can be correctly updated. It is mandatory for a 'clear' type digit and optional for normal numeric buttons. -Widget type ***Haalarmaction*** +Widget type **Haalarmaction** The Haalarmaction widget creates the arm/disarm/trigger buttons. Bear in mind that alarm triggering does not require a code, so you may not want to put this button near the other buttons in case it is pressed accidentally. data-action must contain one of the following: arm_home/arm_away/trigger/disarm. -# weather (requires dark sky) +### {% linkable_title weather (requires DarkSky) %} -Widget type ***Haweather*** +Widget type **Haweather**. -In order to use the weather widget you must configure the dark sky component, and ensure that you configure at least the following monitored conditions in your Home Assistant sensor config: +In order to use the weather widget you must configure the [DarkSky component](/component/senor.darksky/), and ensure that you configure at least the following monitored conditions in your Home Assistant sensor configuration: - temperature - humidity @@ -174,22 +170,26 @@ In order to use the weather widget you must configure the dark sky component, an The `data-id` of the Haweather widget must be set to `weather` or the widget will not work. -The Hatemp widget supports an additional paramater `data-unit` - this allows you to set the unit to whatever you want - Centigrade, Farenheight or even Kelvin if you prefer ;) You will need to explicitly include the degree symbol like this: +The Hatemp widget supports an additional paramater `data-unit`. This allows you to set the unit to whatever you want: Centigrade, Fahrenheit or even Kelvin if you prefer. You will need to explicitly include the degree symbol like this: + ```html data-unit="°F" ``` + If omitted, no units will be shown. -## news -Widget type ***News*** (contributed by [KRiS](https://community.home-assistant.io/users/kris/activity)) +### {% linkable_title News +Widget type ***News*** (contributed by [KRiS](https://community.home-assistant.io/users/kris/activity)) + +This is an RSS widget that can be used for displaying travel information, news etc. on the dashboard. The RSS feed will update every 60 minutes. To configure this, first it is necessary to add your desired feeds in `homeassistant/lib/ha_conf.rb` in the `$news_feeds` section. By default it comes with 2 sample feeds: -This is an RSS widget that can be used for displaying travel information, news etc. on the dashboard. The RSS feed will update every 6o minutes. To configure this, first it is necessary to add your desired feeds in `homeassistant/lib/ha_conf.rb` in the `$news_feeds` section. By default it comes with 2 sample feeds: ```ruby $news_feeds = { "Traffic" => "http://api.sr.se/api/rss/traffic/2863", "News" => "http://feeds.bbci.co.uk/news/rss.xml", } ``` + You can add as many as you want. The important point is that the key value (e.g. "Traffic" or "News" in the example above is used to tie the feed to your widget in the dashboard file. Here is an example of the Traffic widget that displays the first feed in the list: ```html @@ -199,33 +199,33 @@ You can add as many as you want. The important point is that the key value (e.g. ``` The value of thee `data-id` tag must match the key value in the `$news_feeds` configuration. -- ***data-interval*** (optional) - the time in seconds that each entry in the RSS feed is displayed before the next one is shown, default is 30 seconds. +- **data-interval** (optional): The time in seconds that each entry in the RSS feed is displayed before the next one is shown, default is 30 seconds. -***The follwing widget types have been deprecated in favor of the more flexible `Hasensor` and `Hameter` widgets. They will be removed in a future release.*** +**The follwing widget types have been deprecated in favor of the more flexible `Hasensor` and `Hameter` widgets. They will be removed in a future release.** -## sensor (humidity) -Widget type ***Hahumidity*** +### {% linkable_title sensor (humidity) %} +Widget type **Hahumidity**. -## sensor (humidity) -Widget type ***Hahumiditymeter*** (contributed by [Shiv Chanders](https://community.home-assistant.io/users/chanders/activity)) +### {% linkable_title sensor (humidity) %} +Widget type **Hahumiditymeter** (contributed by [Shiv Chanders](https://community.home-assistant.io/users/chanders/activity)) This is an alternative to the the text based humidity widget above, it display the humidity as an animated meter from 0 to 100%. -## sensor (luminance) -Widget type ***Halux*** +### {% linkable_title sensor (luminance) %} +Widget type **Halux**. +### {% linkable_title sensor (temperature) %} +Widget type **Hatemp**. -## sensor (temperature) -Widget type ***Hatemp*** +The Hatemp widget supports an additional paramater `data-unit`. This allows you to set the unit to whatever you want: Centigrade, Fahrenheit or even Kelvin if you prefer. You will need to explicitly include the degree symbol like this: -The Hatemp widget supports an additional paramater `data-unit` - this allows you to set the unit to whatever you want - Centigrade, Farenheight or even Kelvin if you prefer ;) You will need to explicitly include the degree symbol like this: ```html data-unit="°F" ``` If omitted, no units will be shown. -# Customizing CSS styles +## {% linkable_title Customizing CSS styles %} If you want to customize the styles of your dashboard and widgets, there are two options: 1. You can edit the application.scss file (and the individual widget .scss files) directly (not recommended; if you pull down updates from the master repository, your changes might conflict/be overwritten) @@ -237,13 +237,13 @@ If you want to customize the styles of your dashboard and widgets, there are two __Note: The `_variables.scss` file (and your customizations from `_variables_custom.scss`) get imported into nearly every widget's SCSS file, so it is a best practice to define varaibles for colors in `_variables.scss` or `_variables_custom.scss` and reference those variables in the widget SCSS.__ -# Changes and Restarting +## {% linkable_title Changes and Restarting %} When you make changes to a dashboard, Dashing and `hapush` will both automatically reload and apply the changes without a need to restart. Note: The first time you start Dashing, it can take up to a minute for the initial compilation of the pages to occur. You might get a timeout from your browser. If this occurs, be patient and reload. Subsequent reloads will be a lot quicker. -# Multiple Pages +## {% linkable_title Multiple Pages %} It is possible to have multiple pages within a dashboard. To do this, you can add an arbitary number of gridster divisions (you need at least one). @@ -263,9 +263,10 @@ The divisions are implicitly numbered from 1 so it is a good idea to comment the
    ``` + - ***data-page*** : The name of the page to switch to -# Multiple Dashboards +## {% linkable_title Multiple Dashboards %} You can also have multiple dashboards, by simply adding a new .erb file to the dashboards directory and navigating to the dashboards via `http://:3030/dashboard-file-name-without-extension` For example, if you want to deploy multiple devices, you could have one dashboard per room and still only use one hadashboard app installation. diff --git a/source/_ecosystem/hadashboard/hapush.markdown b/source/_ecosystem/hadashboard/hapush.markdown index 78ffc8e07ba..a821b6504ac 100755 --- a/source/_ecosystem/hadashboard/hapush.markdown +++ b/source/_ecosystem/hadashboard/hapush.markdown @@ -24,18 +24,21 @@ $ sudo pip3 install configobj ``` Some users are reporting errors with `InsecureRequestWarning`: + ``` Traceback (most recent call last): File "./hapush.py", line 21, in from requests.packages.urllib3.exceptions import InsecureRequestWarning ImportError: cannot import name 'InsecureRequestWarning' ``` + This can be fixed with: -``` + +```bash $ sudo pip3 install --upgrade requests ``` -# Configuring hapush (all installation methods) +## {% linkable_title Configuring hapush (all installation methods) %} When you have all the prereqs in place, copy the hapush.cfg.example file to hapush.cfg then edit it to reflect your environment: @@ -53,7 +56,7 @@ logfile = "/etc/hapush/hapush.log" - `dash_dir` is the path on the machine that stores your dashboards. This will be the subdirectory `dashboards` relative to the path you cloned `hadashboard` to. For Docker installs this should be set to `/app/dashboards` - `logfile` is the path to where you want `hapush` to keep its logs. When run from the command line this is not used - log messages come out on the terminal. When running as a daemon this is where the log information will go. In the example above I created a directory specifically for hapush to run from, although there is no reason you can't keep it in the `hapush` subdirectory of the cloned repository. For Docker installs this should be set to `/app/hapush/hapush.log` -# Running hapush +## {% linkable_title Running hapush %} For a manual installation you can then run hapush from the command line as follows: @@ -63,9 +66,9 @@ $ ./hapush.py hapush.cfg For docker installs, hapush will be started automatically when you run the startup command. -If all is well, you should start to see `hapush` responding to events as they occur. For a docker install you should see these messages in hapush/hapush.log +If all is well, you should start to see `hapush` responding to events as they occur. For a docker installation you should see these messages in `hapush/hapush.log`. -``` +```bash 2016-06-19 10:05:59,693 INFO Reading dashboard: /srv/hass/src/hadashboard/dashboards/main.erb 2016-06-19 10:06:12,362 INFO switch.wendy_bedside -> state = on, brightness = 50 2016-06-19 10:06:13,334 INFO switch.andrew_bedside -> state = on, brightness = 50 @@ -86,4 +89,4 @@ If all is well, you should start to see `hapush` responding to events as they oc 2016-06-19 10:06:52,280 INFO sensor.side_multisensor_luminance_25 -> 871.0 2016-06-19 10:07:50,574 INFO sensor.side_temp_corrected -> 70.7 2016-06-19 10:07:51,478 INFO sensor.side_multisensor_relative_humidity_25 -> 52.0 -``` \ No newline at end of file +``` diff --git a/source/_ecosystem/hadashboard/installation.markdown b/source/_ecosystem/hadashboard/installation.markdown index 2b2c2801ae0..5f958061aef 100755 --- a/source/_ecosystem/hadashboard/installation.markdown +++ b/source/_ecosystem/hadashboard/installation.markdown @@ -11,11 +11,11 @@ footer: true Installation can be performed using Docker (Contributed by [marijngiesen](https://github.com/marijngiesen)) or manually if Docker doesn't work for you. We also have a Raspberry PI version of Docker contributed by [snizzleorg](https://community.home-assistant.io/users/snizzleorg/activity) -## Using Docker (Non Raspian) +## {% linkable_title Using Docker (Non Raspian) %} Assuming you already have Docker installed, installation is fairly easy. -### Clone the Repository +### {% linkable_title Clone the Repository %} Clone the **hadashboard** repository to the current local directory on your machine. ``` bash @@ -28,7 +28,7 @@ Change your working directory to the repository root. Moving forward, we will be $ cd hadashboard ``` -### Build the docker image +### {% linkable_title Build the docker image %} ```bash $ docker build -t hadashboard . @@ -48,7 +48,7 @@ By default, the docker instance should pick up your timezone but if you want to -e "TZ=Europe/Amsterdam" ``` -### Docker on Raspberry Pi +### {% linkable_title Docker on Raspberry Pi %} Raspberry pi needs to use a different docker build file so the build command is slightly different: @@ -60,9 +60,9 @@ Apart from that the other steps are identical. *Note - this is pretty slow even on a PI3, be prepared for it to take an hour or two to build all of the extensions and install everything* -## Manual Installation +## {% linkable_title Manual Installation %} -### Clone the Repository +### {% linkable_title Clone the Repository %} Clone the **hadashboard** repository to the current local directory on your machine. ``` bash @@ -75,7 +75,7 @@ Change your working directory to the repository root. Moving forward, we will be $ cd hadashboard ``` -### 2. Install Dashing and prereqs +### {% linkable_title 2. Install Dashing and prereqs %} Essentially, you want to make sure that you have Ruby installed on your local machine. Then, install the Dashing gem: @@ -136,4 +136,4 @@ When you are done, you can start a local webserver like this: $ dashing start ``` -Point your browser to **http://localhost:3030** to access the hadashboard on your local machine.and you should see the supplied default dashboard. \ No newline at end of file +Point your browser to **http://localhost:3030** to access the hadashboard on your local machine.and you should see the supplied default dashboard. diff --git a/source/_ecosystem/hadashboard/updating.markdown b/source/_ecosystem/hadashboard/updating.markdown index 748cca6341f..96d6f9731bd 100755 --- a/source/_ecosystem/hadashboard/updating.markdown +++ b/source/_ecosystem/hadashboard/updating.markdown @@ -16,6 +16,7 @@ $ git pull origin ``` For some releases you may also need to rerun the bundle command: + ``` bash $ bundle ``` From 17d4967916ed20153d67d1de84f9deba50dda7cd Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 15 Dec 2016 18:44:53 +0100 Subject: [PATCH 31/42] Fix liquid error --- source/_ecosystem/hadashboard/dash_config.markdown | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/source/_ecosystem/hadashboard/dash_config.markdown b/source/_ecosystem/hadashboard/dash_config.markdown index 2fb2c4cda55..82a54af87a9 100755 --- a/source/_ecosystem/hadashboard/dash_config.markdown +++ b/source/_ecosystem/hadashboard/dash_config.markdown @@ -16,11 +16,13 @@ Hadashboard is a Dashing application, so make sure to read all the instructions Make a copy of `dashboards/example.erb` and call it `main.erb`, then edit this file to reference the items you want to display and control and to get the layout that you want. Leave the original `example.erb` intact and unchanged so that you don't run into problems when trying to update using the git commands mentioned later in "Updating the Dashboard". The basic anatomy of a widget is this: + ``` html
    • ``` + - **data-row**, **data-col**: The position of the widget in the grid. - **data-sizex**, **data-sizey**: The size of the widget in terms of grid tile. - **data-id**: The homeassitant entity id without the entity type (e.g. `light.office` becomes `office`). @@ -44,7 +46,7 @@ This may break `hapush`'s parsing of the file, so keep to the line format first Please, refer to the Dashing website for instructions on how to change the grid and tile size, as well as more general instructions about widgets, their properties, and how to create new widgets. -## {% linkable_title Supported Widgets %] +## {% linkable_title Supported Widgets %} At this time I have provided support for the following Home Assistant entity types. From adc603a7c2c9fbfa06840e745da1312567779b1f Mon Sep 17 00:00:00 2001 From: Fabian Affolter Date: Thu, 15 Dec 2016 18:45:49 +0100 Subject: [PATCH 32/42] Fix another error --- source/_ecosystem/hadashboard/dash_config.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_ecosystem/hadashboard/dash_config.markdown b/source/_ecosystem/hadashboard/dash_config.markdown index 82a54af87a9..4b238e4c24c 100755 --- a/source/_ecosystem/hadashboard/dash_config.markdown +++ b/source/_ecosystem/hadashboard/dash_config.markdown @@ -180,7 +180,7 @@ data-unit="°F" If omitted, no units will be shown. -### {% linkable_title News +### {% linkable_title News %} Widget type ***News*** (contributed by [KRiS](https://community.home-assistant.io/users/kris/activity)) This is an RSS widget that can be used for displaying travel information, news etc. on the dashboard. The RSS feed will update every 60 minutes. To configure this, first it is necessary to add your desired feeds in `homeassistant/lib/ha_conf.rb` in the `$news_feeds` section. By default it comes with 2 sample feeds: From f1ccc8ea707e7afda3f0a94fdfd66c2898e7d0fe Mon Sep 17 00:00:00 2001 From: Andrew Date: Thu, 15 Dec 2016 21:41:22 -0600 Subject: [PATCH 33/42] Fixed error in now() usage in template --- source/_topics/templating.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_topics/templating.markdown b/source/_topics/templating.markdown index 10ddbff78d9..af1f5f4f52c 100644 --- a/source/_topics/templating.markdown +++ b/source/_topics/templating.markdown @@ -131,7 +131,7 @@ Print out a list of all the sensor states. {{ as_timestamp(states.binary_sensor.garage_door.last_changed) }} -{{ as_timestamp(now) - as_timestamp(states.binary_sensor.garage_door.last_changed) }}{% endraw %} +{{ as_timestamp(now()) - as_timestamp(states.binary_sensor.garage_door.last_changed) }}{% endraw %} ``` ### {% linkable_title Distance examples %} From 331de4eaa2856726443d15faa58f5826d1845888 Mon Sep 17 00:00:00 2001 From: Albert Lee Date: Fri, 16 Dec 2016 01:04:01 -0600 Subject: [PATCH 34/42] Add away mode for Radio Thermostat/3M Filtrete (#1552) --- source/_components/climate.radiotherm.markdown | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/source/_components/climate.radiotherm.markdown b/source/_components/climate.radiotherm.markdown index 4a8bb020f05..960f4a26455 100644 --- a/source/_components/climate.radiotherm.markdown +++ b/source/_components/climate.radiotherm.markdown @@ -1,7 +1,7 @@ --- layout: page -title: "Radiotherm Thermostat" -description: "Instructions how to integrate Radiotherm thermostats within Home Assistant." +title: "Radio Thermostat (3M Filtrete) Thermostat" +description: "Instructions how to integrate Radio Thermostat (3M Filtrete) thermostats within Home Assistant." date: 2015-10-18 17:15 sidebar: true comments: false @@ -12,7 +12,7 @@ ha_category: Climate --- -The `radiotherm` climate platform let you control a thermostat from [Radio Thermostat](http://www.radiothermostat.com/). +The `radiotherm` climate platform let you control a thermostat from [Radio Thermostat](http://www.radiothermostat.com/) or [3M Filtrete](http://www.radiothermostat.com/filtrete/products/). Your thermostat must have the Wi-Fi module installed and connected to your network. The underlying library supports: @@ -32,11 +32,15 @@ climate: Configuration variables: - **host** (*Optional*): List of your Radiotherm thermostats. If not provided the thermostats will be auto-detected. +- **away_temperature_heat** (*Optional*): Target heating temperature in Fahrenheit for away mode. This is separate from away mode in the app. Defaults to '60'. +- **away_temperature_cool** (*Optional*): Target cooling temperature in Fahrenheit for away mode. This is separate from away mode in the app. Defaults to '85'. - **hold_temp** (*Optional*): Boolean to control if Home Assistant temperature adjustments hold (`True`) or are temporary (`False`). Defaults to `False`. -Temperature settings from Home Assistant will be sent to thermostat and then hold at that temperature. Set to `False` if you set a thermostat schedule on the thermostat itself and just want Home Assistant to send temporary temperature changes. +Set `hold_temp: True` if you want temperature settings from Home Assistant to override a thermostat schedule on the thermostat itself. Otherwise Home Assistant will perform temporary temperature changes. -Multiple thermostats could be assigned by using `host:` if auto-detection is not used. +The away mode functions similarly to the away mode feature of the website and apps, but cannot detect if you set away mode outside of Home Assistant. + +Multiple thermostats can be assigned by using `host:` if auto-detection is not used. ```yaml climate: From 917e6c57ddbccbe9ab82a41fcdf3d85955ca9dd6 Mon Sep 17 00:00:00 2001 From: William Scanlon Date: Fri, 16 Dec 2016 21:27:28 -0500 Subject: [PATCH 35/42] Update device_tracker.bluetooth_le_tracker.markdown --- source/_components/device_tracker.bluetooth_le_tracker.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.bluetooth_le_tracker.markdown b/source/_components/device_tracker.bluetooth_le_tracker.markdown index 22299aedb60..ba2fdb72881 100644 --- a/source/_components/device_tracker.bluetooth_le_tracker.markdown +++ b/source/_components/device_tracker.bluetooth_le_tracker.markdown @@ -17,7 +17,7 @@ This tracker discovers new devices on boot and in regular intervals and tracks b Devices discovered are stored with 'BLE_' as the prefix for device mac addresses in `known_devices.yaml`.

    -Requires PyBluez. If you are on Raspbian, make sure you first install `bluetooth` and `libbluetooth-dev` by running `sudo apt install bluetooth libbluetooth-dev` +Requires PyBluez. If you are on Raspbian, run the following command to install the needed dependencies. `sudo apt install bluetooth libbluetooth-dev pkg-config libboost-python-dev libboost-thread-dev libglib2.0-dev python-dev`

    From d15116cc0a71745cb7cbbb1c575d95891221fea2 Mon Sep 17 00:00:00 2001 From: pgenera Date: Sat, 17 Dec 2016 03:35:39 -0500 Subject: [PATCH 36/42] s/sensor/switch/ in relevant docs (#1610) This appears to be a copy & paste error; it does need to both switch and sensor stanzas to work in my installation. --- source/_components/switch.mfi.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/switch.mfi.markdown b/source/_components/switch.mfi.markdown index 4ff90c19871..9ea004c17eb 100644 --- a/source/_components/switch.mfi.markdown +++ b/source/_components/switch.mfi.markdown @@ -18,7 +18,7 @@ To add this platform to your installation, add the following to your `configurat ```yaml # Example configuration.yaml entry -sensor: +switch: - platform: mfi host: IP_ADDRESS username: USERNAME From de4956111cfefce692066b9fb9f3c839cf27cbee Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Sat, 17 Dec 2016 11:31:08 -0500 Subject: [PATCH 37/42] Update group.markdown (#1617) --- source/_components/group.markdown | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/source/_components/group.markdown b/source/_components/group.markdown index 6bd24c8572c..c07cb4e38a8 100644 --- a/source/_components/group.markdown +++ b/source/_components/group.markdown @@ -23,6 +23,7 @@ group: default_view: view: yes entities: + - group.kitchen - group.awesome_people - group.climate kitchen: @@ -38,11 +39,26 @@ group: - camera.demo_camera - device_tracker.demo_paulus - group.garden + climate: + name: Climate + view: no + entities: + - sensor.bedroom_temp + - sensor.porch_temp + - sensor.bathroom_humidity + awesome_people: + name: Awesome People + view: no + entities: + - device_tracker.dad_smith + - device_tracker.mom_smith + - device_tracker.dog_smith + ``` Configuration variables: -- **view** (*Optional*): If yes then the entry will be shown as a view (tab). +- **view** (*Optional*): If yes then the entry will be shown as a view (tab) at the top. - **name** (*Optional*): Name of the group. - **icon** (*Optional*): If the group is a view, this icon will show at the top in the frontend instead of the name. If it's not a view, then the icon shows when this group is used in another group. - **entities** (*Required*): array or comma delimited string, list of entities to group. From 0a072b57897c12ab1908e011f6ddef8d5c092529 Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Sat, 17 Dec 2016 11:31:31 -0500 Subject: [PATCH 38/42] Update group.markdown (#1616) --- source/_components/group.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/group.markdown b/source/_components/group.markdown index c07cb4e38a8..57b0d6260f7 100644 --- a/source/_components/group.markdown +++ b/source/_components/group.markdown @@ -15,7 +15,7 @@ Groups allow the user to combine multiple entities into one. A group can be prom Check the **Set State** page from the **Developer Tools** and browse the **Current entities:** listing for all available entities. -By default, every group appears in the HOME tab. If you name a group `default_view` it will REPLACE the contents of the HOME tab so you can customize it as you wish. +By default, every group appears in the HOME tab. If you create a group `default_view` it will REPLACE the contents of the HOME tab so you can customize the HOME tab as you wish. ```yaml # Example configuration.yaml entry From 4d847c6c62bde525e0c02fd3746e6109498a6297 Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Sat, 17 Dec 2016 11:32:36 -0500 Subject: [PATCH 39/42] Update group.markdown (#1615) --- source/_components/group.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/group.markdown b/source/_components/group.markdown index 57b0d6260f7..f88e55db0da 100644 --- a/source/_components/group.markdown +++ b/source/_components/group.markdown @@ -11,7 +11,7 @@ logo: home-assistant.png ha_category: Organization --- -Groups allow the user to combine multiple entities into one. A group can be promoted to a **view** by setting the `view` option to `yes`. This will make the group available as a new tab in the frontend. +Groups allow the user to combine multiple entities into one. A group can be promoted to a **view** by setting `view: yes` under the group definition. This will make the group available as a new tab in the frontend. Check the **Set State** page from the **Developer Tools** and browse the **Current entities:** listing for all available entities. From b74efc17b1ef1167d243e3c142dcc7d1bcca1f60 Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Sat, 17 Dec 2016 11:33:08 -0500 Subject: [PATCH 40/42] Update device_tracker.owntracks.markdown (#1614) --- source/_components/device_tracker.owntracks.markdown | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/source/_components/device_tracker.owntracks.markdown b/source/_components/device_tracker.owntracks.markdown index a8e6e4989fd..3e9b2da076a 100644 --- a/source/_components/device_tracker.owntracks.markdown +++ b/source/_components/device_tracker.owntracks.markdown @@ -48,6 +48,18 @@ device_tracker: ### {% linkable_title Using Owntracks with other device trackers %} Owntracks can also be used with other device trackers, such as [Nmap](/components/device_tracker.nmap_tracker/) or [Netgear](/components/device_tracker.netgear/). To do this, fill in the `mac` field to the Owntracks entry in `known_devices.yaml` with the MAC address of the device you want to track. This way the state of the device will be determined by the source that reported last. The naming convention for known device list is `_` and could be set in app configuration. More details about this config can found in [device tracker](/components/device_tracker/). +An example showing the inclusion of the `mac` field for multiple component tracking. The `mac` field will need to be added to the `owntracks` device and will enable tracking by all components that track via the `mac` address. + +```yaml +_: + name: Friendly Name + mac: EA:AA:55:E7:C6:94 + picture: https://home-assistant.io/images/favicon-192x192.png + gravatar: test@example.com + track: yes + hide_if_away: no + ``` + ### {% linkable_title Using Owntracks regions %} Owntracks can track regions, and send region entry and exit information to Home Assistant (HA). You set up a region in the Owntracks app which you should name the same as your HA Zone, and then make sure to turn on the `share` option for the region in the owntracks app. Please see the [owntracks documentation](http://owntracks.org/booklet/guide/waypoints/). From 68324d15071a19971741b8df0eb8c37cca948faf Mon Sep 17 00:00:00 2001 From: Mark Huson Date: Sat, 17 Dec 2016 11:33:59 -0500 Subject: [PATCH 41/42] Update device_tracker.markdown (#1613) --- source/_components/device_tracker.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/device_tracker.markdown b/source/_components/device_tracker.markdown index b1120fbb482..25691c3fb6d 100644 --- a/source/_components/device_tracker.markdown +++ b/source/_components/device_tracker.markdown @@ -49,7 +49,7 @@ device_tracker: track_new_devices: yes ``` -Multiple device trackers can be used in parallel, such as [Owntracks](/components/device_tracker.owntracks/) and [Nmap](/components/device_tracker.nmap_tracker/). The state of the device will be determined by the source that reported last. +Multiple device trackers can be used in parallel, such as [Owntracks](/components/device_tracker.owntracks/#using-owntracks-with-other-device-trackers) and [Nmap](/components/device_tracker.nmap_tracker/). The state of the device will be determined by the source that reported last. # {% linkable_title `known_devices.yaml` %} From c13e584876db1c408bf0f6a75799a56cc34d7db4 Mon Sep 17 00:00:00 2001 From: lwad Date: Sat, 17 Dec 2016 11:34:32 -0500 Subject: [PATCH 42/42] Update input_boolean.markdown (#1612) sample automation code had platform: state under condition. it should be condition: state --- source/_components/input_boolean.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_components/input_boolean.markdown b/source/_components/input_boolean.markdown index 541582d4795..28b053296b3 100644 --- a/source/_components/input_boolean.markdown +++ b/source/_components/input_boolean.markdown @@ -41,7 +41,7 @@ automation: entity_id: binary_sensor.motion_garage to: 'on' condition: - platform: state + condition: state entity_id: input_boolean.notify_home state: 'on' action: