diff --git a/source/getting-started/installation-vagrant.markdown b/source/getting-started/installation-vagrant.markdown
new file mode 100644
index 00000000000..6f965b0d3c3
--- /dev/null
+++ b/source/getting-started/installation-vagrant.markdown
@@ -0,0 +1,92 @@
+---
+layout: page
+title: "Installation on Vagrant"
+description: "Instructions to run Home Assistant on a Vagrant VM."
+date: 2016-05-28 10:00
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+A `Vagrantfile` is avalable into `virtualization/vagrant` folder for quickly spinning up a Linux virtual machine running Home Assistant. This can be beneficial for those who want to experiment with Home Assistant and/or developers willing to easily test local changes and run test suite against them.
+
+
+Vagrant is intended for testing/development only. It is NOT recommended for permanent installations.
+
+
+## Install Vagrant
+
+You must have [Vagrant](https://www.vagrantup.com/downloads.html) and [Virtualbox](https://www.virtualbox.org/wiki/Downloads) installed on your workstation.
+
+## Get Home Assistant source code
+
+Download the home-assistant source code by either downloading the .zip file from [GitHub releases page](https://github.com/home-assistant/home-assistant/releases), or by using [Git](https://git-scm.com/)
+
+```bash
+git clone https://github.com/home-assistant/home-assistant.git
+cd home-assistant/virtualization/vagrant
+```
+
+
+The following instructions will assume you changed your working directory to be home-assistant/virtualization/vagrant. This is mandatory because Vagrant will look for informations about the running VM inside that folder and won't work otherwise
+
+
+## Create the Vagrant VM and start Home Assistant
+
+```bash
+vagrant up
+```
+
+This will download + start a virtual machine using Virtualbox, which will internally setup the development environment necessary to start Home Assistant process and run test suite as well. After the VM has started succesfully, Home Assistant frontend will be accessible locally from your browser at [http://localhost:8123](http://localhost:8123)
+
+## Stopping Vagrant
+
+To shutdown the Vagrant host:
+
+```bash
+vagrant halt
+```
+
+To start it again, just run `vagrant up`
+
+## Restarting Home Assistant process to test changes
+
+The root `home-assistant` directory on your workstation will be mirrored with `/home-assistant` inside the VM. In `virtualization/vagrant` there's also a `config` folder that you can use to drop configuration files ([here](https://home-assistant.io/getting-started/configuration/) you can find more information on how to configure HASS).
+
+Any changes made to the local directory on your workstation will be available from the Vagrant host, so to apply your changes to the HASS process, just restart it:
+
+```bash
+touch restart ; vagrant provision
+```
+
+## Run test suite (Tox)
+
+To run tests against your changes:
+
+```bash
+touch run_tests ; vagrant provision
+```
+
+## Cleanup
+
+To completely remove the VM:
+
+```bash
+rm setup_done ; vagrant destroy -f
+```
+
+You can now recreate a completely new Vagrant host with `vagrant up`
+
+
+### {% linkable_title Troubleshooting %}
+
+If you run into any issues, please see [the troubleshooting page](/getting-started/troubleshooting/). It contains solutions to many of the more commonly encountered issues.
+
+In addition to this site, check out these sources for additional help:
+
+ - [Forum](https://community.home-assistant.io) for Home Assistant discussions and questions.
+ - [Gitter Chat Room](https://gitter.im/home-assistant/home-assistant) for real-time chat about Home Assistant.
+ - [GitHub Page](https://github.com/home-assistant/home-assistant/issues) for issue reporting.
+
+### [Next step: Configuring Home Assistant »](/getting-started/configuration/)
\ No newline at end of file
From e8420d6a581c7c14b8dc5b1caff051108960f770 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Tue, 7 Jun 2016 22:53:05 -0700
Subject: [PATCH 02/23] Add blog post 0.21
---
source/_components/lirc.markdown | 95 ++++++++++++++++++
.../sensor.dte_energy_bridge.markdown | 21 ++++
source/_components/switch.flux.markdown | 4 +-
...06-08-super-fast-web-enocean-lirc.markdown | 74 ++++++++++++++
source/images/supported_brands/lirc.gif | Bin 0 -> 2783 bytes
5 files changed, 192 insertions(+), 2 deletions(-)
create mode 100644 source/_components/lirc.markdown
create mode 100644 source/_components/sensor.dte_energy_bridge.markdown
create mode 100644 source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown
create mode 100644 source/images/supported_brands/lirc.gif
diff --git a/source/_components/lirc.markdown b/source/_components/lirc.markdown
new file mode 100644
index 00000000000..9316575446c
--- /dev/null
+++ b/source/_components/lirc.markdown
@@ -0,0 +1,95 @@
+---
+layout: page
+title: "LIRC"
+description: "Instructions how to integrate IR remotes with LIRC into Home Assistant."
+date: 2016-05-22 19:59
+sidebar: true
+comments: false
+sharing: true
+footer: true
+logo: lirc.gif
+ha_category: Automation
+featured: false
+ha_release: 0.21
+ha_iot_class: "Local Push"
+---
+
+[LIRC](http://www.lirc.org/) integration for Home Assistant allows you to receive signals from an infrared remote control and control actions based on the buttons you press. You can use them to set scenes or trigger any other [automation](https://home-assistant.io/components/automation/).
+
+Sending IR commands is not supported in this component (yet), but can be accomplished using the [shell_command component](https://home-assistant.io/components/shell_command/) in conjunction with the `irsend` command.
+
+### {% linkable_title Installation %}
+
+To allow Home Assistant to talk to your IR receiver, you need to first make sure you have the correct dependencies installed:
+
+```bash
+$ sudo apt-get install lirc
+```
+
+
+If you are configuring on a Raspberry Pi, there are excellent instructions with GPIO schematics and driver configurations [here](http://alexba.in/blog/2013/01/06/setting-up-lirc-on-the-raspberrypi/). Consider following these.
+
+
+
+Now teach LIRC about your particular remote control by preparing a lircd configuration file (`/etc/lirc/lircd.conf`). Search the [LIRC remote database](http://lirc.sourceforge.net/remotes/) for your model. If you can't find it, then you can always use the `irrecord` program to learn your remote. This will create a valid configuration file. Add as many remotes as you want by pasting them into the file. If `irrecord` doesn't work (e.g. for some air conditioner remotes), then the `mode2` program is capable of reading the codes in raw mode, followed by `irrecord -a` to extract hex codes.
+
+Next, you have to make a `~/.lircrc` file that maps keypresses to system actions. [The configuration](http://www.lirc.org/html/configure.html) is a bit tedious but it must be done. Use the `prog = home-assistant` for all keys you want to be recognized by Home Assistant. The values you set for `button` must be the same as in the `lircd.conf` file and the values you put for `config` entry will be the sensor value in Home Assistant when you press the button. An example may look like this:
+
+```bash
+begin
+ remote = SONY
+ button = KEY_1
+ prog = home-assistant
+ config = KEY_1
+end
+begin
+ remote = SONY
+ button = KEY_2
+ prog = home-assistant
+ config = KEY_2
+end
+begin
+ remote = SONY
+ button = KEY_3
+ prog = home-assistant
+ config = KEY_3
+end
+```
+
+Test your LIRC installation before proceeding by running:
+
+```bash
+$ irexec -n home-assistant
+```
+
+and pressing some buttons on the remote.
+
+
+### {% linkable_title Configuration %}
+
+```yaml
+# Example configuration.yaml entry
+lirc:
+```
+
+
+#### {% linkable_title Events %}
+
+The LIRC component fires `ir_command_received` events on the bus. You can capture the events and respond to them in automation scripts like this:
+
+```yaml
+# Example configuration.yaml automation entry
+automation:
+- alias: Off on Remote
+ trigger:
+ platform: event
+ event_type: ir_command_received
+ event_data:
+ button_name: KEY_0
+ action:
+ service: homeassistant.turn_off
+ entity_id: group.a_lights
+
+```
+
+The `button_name` data values (e.g. `KEY_0`) are set by you in the `.lircrc` file.
diff --git a/source/_components/sensor.dte_energy_bridge.markdown b/source/_components/sensor.dte_energy_bridge.markdown
new file mode 100644
index 00000000000..68cf9cc6cf6
--- /dev/null
+++ b/source/_components/sensor.dte_energy_bridge.markdown
@@ -0,0 +1,21 @@
+---
+layout: page
+title: "DTE Energy Bridge"
+description: "Instructions how to setup DTE Energy Bridge with Home Assistant."
+date: 2016-06-07 08:10
+sidebar: true
+comments: false
+sharing: true
+footer: true
+ha_category: Sensor
+ha_release: 0.21
+ha_iot_class: "Cloud Polling"
+---
+
+A sensor for the DTE Energy Bridge
+
+```yaml
+sensor:
+ platform: dte_energy_bridge
+ ip: 192.168.1.11
+```
diff --git a/source/_components/switch.flux.markdown b/source/_components/switch.flux.markdown
index 23b1a645ce7..25213c21180 100644
--- a/source/_components/switch.flux.markdown
+++ b/source/_components/switch.flux.markdown
@@ -29,14 +29,14 @@ If you don't wish to have flux update on 30 second intervals, you can leave the
switch turned off and use automation rules that call the service `switch.flux_update`
whenever you want the lights updated.
-Example `configuration.yaml`:
```yaml
+# Example configuration.yaml entry
switch:
platform: flux
lights:
- light.desk
- light.lamp
- name: Fluxer # optional, default Flux
+ name: Fluxer # optional, default Flux
start_time: 7:00 # optional, default sunrise
stop_time: 23:00 # optional, default 22:00
start_colortemp: 4000 # optional, default 4000
diff --git a/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown b/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown
new file mode 100644
index 00000000000..58aec47ecb2
--- /dev/null
+++ b/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown
@@ -0,0 +1,74 @@
+---
+layout: post
+title: "0.21: Improved Web and support for EnOcean, LIRC and Osram Lightify"
+description: "This new release of Home Assistant is lightning fast with the new web stack and progressive web application. On top of that a handful of new components and platforms for EnOcean, LIRC and Osram Lightify support."
+date: 2016-06-08 01:06:00 +0000
+date_formatted: "June 8, 2016"
+author: Paulus Schoutsen
+author_twitter: balloob
+comments: true
+categories: Release-Notes
+---
+
+It's time for release 0.21 and it contains massive core improvements: replacement of our home grown HTTP stack with a standardized WSGI stack. This will improve performance, speed, security and make future development of advanced HTTP features a breeze.
+
+This work was driven by the amazing Josh Wright. His knowledge, high standards and drive for security has helped improve Home Assistant a lot ever since he started helping out. Hip hip hurray for Josh!
+
+Alright, time for the changes:
+
+
+
+ - New HTTP stack based on WSGI ([@JshWright], [@balloob])
+ - Frontend: lots of performance improvements ([@balloob])
+ - Initial support for EnOcean [lights][en-lights], [sensors][en-sensors] and [switches][en-switches] added ([@rubund])
+ - Light: [Osram Lightify] is now supported ([@olimpiurob])
+ - Light: [Insteon Hub] now supports brightness ([@wkonkel])
+ - Add support for adding HA as Windows 10 tile ([@fabaff])
+ - Condition: [time condition] can now cross midnight ([@jaharkes])
+ - Template based sensors should now throw less warnings ([@Bart247])
+ - New [LIRC component] allows receiving IR commands ([@partofthething])
+ - The [Feedreader] component will now persist data to disk to prevent duplicate events ([@shaftoe])
+ - Sun: azimuth attribute added ([@fabaff])
+ - New [Flux like switch platform] to change light intensity in the evening ([@nkgilley])
+ - We no longer crash if you live in a part of the world where the sun never sets ([@balloob])
+ - Rollershutter: [RFXTRX] now supported ([@jacobtomlinson])
+ - Switch: [Template switches] can now execute scripts ([@kellerza])
+ - Z-Wave: automatically heal the network at midnight ([@infamy])
+ - Sensor: [DTE Energy Bridge] now supported ([@kylehendricks])
+ - Media Player: [Kodi] now supports different turn off commands ([@armills])
+
+### Breaking Changes
+
+ - Our work in the WSGI stack is not fully done yet. We still have a minor issues where retrieving the error log in the about screen can raise an encoding error
+ - The API used to incorrectly accept a JSON body with form-url-encoded headers. Our cURL examples on the website used to be wrong and have [been updated].
+
+[@armills]: https://github.com/armills
+[@balloob]: https://github.com/balloob
+[@Bart247]: https://github.com/Bart247
+[@fabaff]: https://github.com/fabaff
+[@infamy]: https://github.com/infamy
+[@jacobtomlinson]: https://github.com/jacobtomlinson
+[@jaharkes]: https://github.com/jaharkes
+[@JshWright]: https://github.com/JshWright
+[@kellerza]: https://github.com/kellerza
+[@kylehendricks]: https://github.com/kylehendricks
+[@nkgilley]: https://github.com/nkgilley
+[@olimpiurob]: https://github.com/olimpiurob
+[@partofthething]: https://github.com/partofthething
+[@rubund]: https://github.com/rubund
+[@shaftoe]: https://github.com/shaftoe
+[@wkonkel]: https://github.com/wkonkel
+[DTE Energy Bridge]: /components/sensor.dte_energy_bridge/
+[en-lights]: /components/light.enocean/
+[en-sensors]: /components/sensor.enocean/
+[en-switches]: /components/switch.enocean/
+[Feedreader]: /components/feedreader/
+[Flux like switch platform]: /components/switch.flux/
+[Insteon Hub]: /components/insteon_hub/
+[Kodi]: /components/media_player.kodi/
+[LIRC component]: /components/lirc/
+[Osram Lightify]: /components/light.osramlightify/
+[RFXTRX]: /components/rfxtrx/
+[Template switches]: /components/switch.template/
+[time condition]: /getting-started/scripts-conditions/#time-condition
+[been updated]: /developers/rest_api/
diff --git a/source/images/supported_brands/lirc.gif b/source/images/supported_brands/lirc.gif
new file mode 100644
index 0000000000000000000000000000000000000000..ada4c1578e2f9cc33a695725f7135becb9762327
GIT binary patch
literal 2783
zcmb8oi6avV0|4;Z!OYCmD!E!kXr_gT?qkkj&+X+*-}n6q-|rvzUHi=hPjFEc$^b-4004kUC^Qm@OpuaFz+!0xLbjP%
zv8`>Tt1B}wu;tmamZG9>U%&E4Mpjo>w}1WrPVa(+U;rRM^}iF~es{UdMUJ3QBconK$Hd0PCnP2%zf4I@OMjJ-Nqe0|&(6us
z%P%PWv#3}H1QCV7;FVQyv2tMu$Q{zq_^zqZ^nL3GRvSc((cakxz6BN)LrC;;xP2T1
z941_U@7rjf>DVN1ilYXZo}aHA9JT_(#Q6)Nf?I1d*Z$oZo83M5Hn4dOiCc(92oW*6
z&62YX4+}aVB2+Yq&&dWsB#RZA9hi4IlE9}CDn!XyLJIV7T}4x66{5$yuX+>yzv%kkcM?JR9*a5K_@>uH^Z5;ecQ!%eZ~(2zzxita@AQcL84CD;WzmN03U*!zwkF!yhLQ)lirNl7
zlcuh<$Dg!>+t|>QTm$U_21lR&xy_gA+x(eyJq>MgvYT#Q=WB2FBe37s@tV>M#!yNi
zAed@3?rUwt{+WF_v(@ClfAmq8b$}9QUMAuK^ziXypo;-B5C4<9b_y@ljsxg3nf|Bs
z;pmug5`4ft*NkoLCI4!G~lgWO|dYJ{i8juj14;&^x-Q0RbkQt9sf_CGuloY-htvYJBv_^ALb1HNW-Cz-DmQswWJ
zqek|!0=_(=t(38(nB}TRDPwtL7EEZBz5cyWh5BY%cK~QXHe!D)>bn8UE5&loBN$j8
zW$*GiXHoCcuH)|?+Ry9O1w|y*)>Ry9bg%`?<)i`1K=Kss}E}!YxZw
z^}kKsJ3yK@%m59;s`L-bet_N-?ha`)zFtgg393_)>aun)-`M;Me)ay6(YWE*7uBKj
zrh18eSOCm!`eNfY@s-~&9?yyTyT$-Jbyu%v^QqA3QRxPlB-?#XotvK5-HqYkM6t~V@!*N660&SkogTKKOj;1`y+RQFT3u`;LXvj$2%gN>zhd3I%
z6jtTEF8Tb%2boV+Eb~-n=11v?m~kl5Tlr8+#?=#S&I|3W0%Rh?NXd*F=d@KQ^@VY0
za+%Fd$|wMo`=VUFNwv~lSqJ5rZe;pw;
z%~n!Cv|ZG#9pRNed~Om++>-;;1QIIAC!Fin`&`!Sgtmf9fk0w^T@tUV!oLIx3mGcMn*81s$`}FQ#mrf8S1r}csJ5UZ2?x{ZQ*iS;t}Q1@UBnCH8Jp-iD?#fP
zR!CF5Z}OA2iF5}J8Qk#BaO9&x>$&Wz+m`pnJw6udBy(3H4ZNoEvB#Pf$emGgX~Uha
z-(w3xX>SjkUMWj(@S?A7aEsSXG=x;#MJD8>OvJb}Ur<
zN$S
zXps(zqHWO&7{!AMI}*(?m9zhtISh2pZ$6pm@sSsyfw?y~9)=|L+nGP*geRRZ?`W{Q
z{LNt?K+o63XK(bfU~kNQvA)8Xr|k{h8}D#m#pI^?x;5-qn0|c`)DMYwH*~~uGFD!d
zRz7s-K}wgF8Gl&+?AsBd)6VnT^z2%02)ITXbT3d#XZ#^hynAsFJz3EF<*FcKh7LX}
zF@-BK%%+8F*BZXd{<7FICvK-bt2en;;w*PK9DXUI+T21j^5-buFI=X|@OR685A4)F
zD+F9Se;2cKe{tAp1zm5>ESahdaOl;kB|M4dROf8k_eU-!CBPk1Mt+-qJ6>k-^hxCX
z
zb{n(2>*~h(j^ELVJEJ1*`fg!j0P%9YseR9r{GhMbJvgmYvS<@p@`FS6g^ItWkK6fN
zN_exK;MkIvET=2-X~>uh$r=WdVgU_kA^o}Q2~Ip$xk-_?Y72q!0*~-L0jo8Q$o^TX
zHn8Vp54p+bA`*f=Jf5@Gx?oh3;QoFidv99=uyo?;Y7yc?$;m~f@SRB8jc9SOvX}r#
z{?1nftvL`+N1U~ZxSkQQ!oM!R6M>eZoWWBR94Y5W6lEIad?Q75h@!Sb!AVio@l;Jm
Xsuqcgr%|;Vsk%c{y%@@A06^zInK^7E
literal 0
HcmV?d00001
From 89239db0631a26e928f0f80105dc641ebc23ff58 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Tue, 7 Jun 2016 23:14:14 -0700
Subject: [PATCH 03/23] Update demo
---
source/demo/index.html | 2 +-
source/demo/manifest.json | 3 +--
2 files changed, 2 insertions(+), 3 deletions(-)
diff --git a/source/demo/index.html b/source/demo/index.html
index cdac510057f..093351d1ce3 100644
--- a/source/demo/index.html
+++ b/source/demo/index.html
@@ -31,7 +31,7 @@
left: 0;
right: 0;
bottom: 0;
- margin-bottom: 97px;
+ margin-bottom: 83px;
font-family: Roboto, sans-serif;
font-size: 0pt;
transition: font-size 2s;
diff --git a/source/demo/manifest.json b/source/demo/manifest.json
index 4454a923df9..e4dfb6f3312 100644
--- a/source/demo/manifest.json
+++ b/source/demo/manifest.json
@@ -7,8 +7,7 @@
{
"src": "\/static\/favicon-192x192.png",
"sizes": "192x192",
- "type": "image\/png",
- "density": "4.0"
+ "type": "image\/png"
}
]
}
From 5ee7544ca128cee5d47207cb020ddca387034652 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Tue, 7 Jun 2016 23:33:44 -0700
Subject: [PATCH 04/23] Update 2016-06-08-super-fast-web-enocean-lirc.markdown
---
source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown b/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown
index 58aec47ecb2..110d6f789b2 100644
--- a/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown
+++ b/source/_posts/2016-06-08-super-fast-web-enocean-lirc.markdown
@@ -25,7 +25,7 @@ Alright, time for the changes:
- Light: [Insteon Hub] now supports brightness ([@wkonkel])
- Add support for adding HA as Windows 10 tile ([@fabaff])
- Condition: [time condition] can now cross midnight ([@jaharkes])
- - Template based sensors should now throw less warnings ([@Bart247])
+ - Template based sensors should now throw less warnings ([@Bart274])
- New [LIRC component] allows receiving IR commands ([@partofthething])
- The [Feedreader] component will now persist data to disk to prevent duplicate events ([@shaftoe])
- Sun: azimuth attribute added ([@fabaff])
@@ -44,7 +44,7 @@ Alright, time for the changes:
[@armills]: https://github.com/armills
[@balloob]: https://github.com/balloob
-[@Bart247]: https://github.com/Bart247
+[@Bart274]: https://github.com/Bart274
[@fabaff]: https://github.com/fabaff
[@infamy]: https://github.com/infamy
[@jacobtomlinson]: https://github.com/jacobtomlinson
From be014fe399409e03aa39b1c5a1d17bad91c864c0 Mon Sep 17 00:00:00 2001
From: Bart274
Date: Wed, 8 Jun 2016 17:55:36 +0200
Subject: [PATCH 05/23] Add information about entity_id config option (#540)
---
source/_components/sensor.template.markdown | 1 +
1 file changed, 1 insertion(+)
diff --git a/source/_components/sensor.template.markdown b/source/_components/sensor.template.markdown
index ca42bcaf90f..925cec40b11 100644
--- a/source/_components/sensor.template.markdown
+++ b/source/_components/sensor.template.markdown
@@ -35,6 +35,7 @@ Configuration variables:
- **unit_of_measurement** (*Optional*): Defines the units of measurement of the sensor, if any.
- **value_template** (*Optional*): Defines a [template](/topics/templating/) to extract a value from the payload.
- **warnings** (*Optional*): Turn off warnings (useful if the sensor is loaded before devices it depends on).
+ - **entity_id** (*Optional*): Add a list of entity_ids so the sensor only reacts to state changes of these entities. This will reduce the number of times the sensor will try to update it's state.
## {% linkable_title Examples %}
From 84cfe998e47155ccd353699fe1ba134677e41cd5 Mon Sep 17 00:00:00 2001
From: Bart274
Date: Wed, 8 Jun 2016 17:55:44 +0200
Subject: [PATCH 06/23] Add information about entity_id config option (#541)
---
source/_components/switch.template.markdown | 1 +
1 file changed, 1 insertion(+)
diff --git a/source/_components/switch.template.markdown b/source/_components/switch.template.markdown
index 21057e58786..7ddf487bf16 100644
--- a/source/_components/switch.template.markdown
+++ b/source/_components/switch.template.markdown
@@ -42,6 +42,7 @@ Configuration variables:
- **value_template** (*Required*): Defines a [template](/topics/templating/) to set the state of the switch.
- **turn_on** (*Required*): Defines an [action](/getting-started/automation/) to run when the switch is turned on.
- **turn_off** (*Required*): Defines an [action](/getting-started/automation/) to run when the switch is turned off.
+ - **entity_id** (*Optional*): Add a list of entity_ids so the sensor only reacts to state changes of these entities. This will reduce the number of times the sensor will try to update it's state.
## {% linkable_title Examples %}
From 5176845133ae5482b75e06f9e6cfba63fceb1704 Mon Sep 17 00:00:00 2001
From: Bart274
Date: Wed, 8 Jun 2016 17:55:52 +0200
Subject: [PATCH 07/23] Add information about entity_id config option (#539)
---
source/_components/binary_sensor.template.markdown | 1 +
1 file changed, 1 insertion(+)
diff --git a/source/_components/binary_sensor.template.markdown b/source/_components/binary_sensor.template.markdown
index 440c5a82592..0aa9b4797b4 100644
--- a/source/_components/binary_sensor.template.markdown
+++ b/source/_components/binary_sensor.template.markdown
@@ -31,6 +31,7 @@ Configuration variables:
- **sensor_class** (*Optional*): The [type/class](/components/binary_sensor/) of the sensor to set the icon in the frontend.
- **value_template** (*Optional*): Defines a [template](/topics/templating/) to extract a value from the payload.
- **warnings** (*Optional*): Turn off warnings (useful if the sensor is loaded before devices it depends on).
+ - **entity_id** (*Optional*): Add a list of entity_ids so the sensor only reacts to state changes of these entities. This will reduce the number of times the sensor will try to update it's state.
## {% linkable_title Examples %}
From 0777750978b38ba7e41f6f4187749216c8c147ca Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Wed, 8 Jun 2016 22:08:21 -0700
Subject: [PATCH 08/23] Move Z-Wave around
---
source/_components/zwave.markdown | 208 +-----------------
.../asides/getting_started_navigation.html | 8 +
source/_topics/z-wave.markdown | 37 ----
.../z-wave-controllers.markdown | 31 +++
.../z-wave-device-specific.markdown | 84 +++++++
.../getting-started/z-wave-settings.markdown | 14 ++
source/getting-started/z-wave.markdown | 142 ++++++++++++
7 files changed, 281 insertions(+), 243 deletions(-)
delete mode 100644 source/_topics/z-wave.markdown
create mode 100644 source/getting-started/z-wave-controllers.markdown
create mode 100644 source/getting-started/z-wave-device-specific.markdown
create mode 100644 source/getting-started/z-wave-settings.markdown
create mode 100644 source/getting-started/z-wave.markdown
diff --git a/source/_components/zwave.markdown b/source/_components/zwave.markdown
index c448ff35401..5615187a21f 100644
--- a/source/_components/zwave.markdown
+++ b/source/_components/zwave.markdown
@@ -12,210 +12,6 @@ ha_category: Hub
featured: true
---
-[Z-Wave](http://www.z-wave.com/) integration for Home Assistant allows you to observe and control connected Z-Wave devices. Z-Wave support requires a [supported Z-Wave USB stick](https://github.com/OpenZWave/open-zwave/wiki/Controller-Compatibility-List) to be plugged into the host.
+Please see the [getting started section] for in-depth documentation on how to use the Z-Wave component.
-There is currently support for switches, lights and sensors. All will be picked up automatically after configuring this platform.
-
-### {% linkable_title Installation %}
-
-To allow Home Assistant to talk to your Z-Wave USB stick you will have to compile the OpenZWave library and install the related [python-OpenZWave package](https://github.com/OpenZWave/python-openzwave). This can be done as follows. _(Note: The Home Assistant docker image has support for Z-Wave built-in)_
-
-Make sure you have the correct dependencies installed before running the script:
-
-```bash
-$ sudo apt-get install cython3 libudev-dev python3-sphinx python3-setuptools
-```
-
-Make sure you have at least version 0.23 of cython.
-
-```bash
-$ sudo pip3 install --upgrade cython
-```
-
-Then get the OpenZWave files and switch to the `python3` branch:
-
Do not use root to build python-openzwave as it will surely fail.
-```bash
-$ git clone https://github.com/OpenZWave/python-openzwave.git
-$ cd python-openzwave
-$ git checkout python3
-$ PYTHON_EXEC=$(which python3) make build
-$ sudo PYTHON_EXEC=$(which python3) make install
-```
-
-Instead of `make install`, you can alternatively build your own python-openzwave package which can be easily uninstalled:
-
-```$ sudo PYTHON_EXEC=$(which python3) checkinstall --pkgname python-openzwave --pkgversion 1.0 --provides python-openzwave```
-
-
-
-With this installation, your `config_path` needed below will resemble:
-
-```bash
-/usr/local/lib/python3.4/dist-packages/libopenzwave-0.3.0b8-py3.4-linux-x86_64.egg/config
-```
-
-
-### {% linkable_title Configuration %}
-
-```yaml
-# Example configuration.yaml entry
-zwave:
- usb_path: /dev/ttyUSB0
- config_path: /usr/local/share/python-openzwave/config
- polling_interval: 60000
- customize:
- sensor.greenwave_powernode_6_port_energy_10:
- polling_intensity: 1
-```
-
-Configuration variables:
-
-- **usb_path** (*Required*): The port where your device is connected to your Home Assistant host.
-- **config_path** (*Optional*): The path to the Python Open Z-Wave configuration files.
-- **autoheal** (*Optional*): Allows disabling auto ZWave heal at midnight. Defaults to True.
-- **polling_interval** (*Optional*): The time period in milliseconds between polls of a nodes value. Be careful about using polling values below 30000 (30 seconds) as polling can flood the zwave network and cause problems.
-- **customize** (*Optional*): This attribute contains node-specific override values:
- - **polling_intensity** (*Optional*): Enables polling of a value and sets the frequency of polling (0=none, 1=every time through the list, 2-every other time, etc). If not specified then your device will not be polled.
-
-To find the path of your Z-Wave stick, run:
-
-```bash
-$ ls /dev/ttyUSB*
-```
-
-Or, on some other systems (such as Raspberry Pi), use:
-
-```bash
-$ ls /dev/ttyACM*
-```
-
-
-Depending on what's plugged into your USB ports, the name found above may change. You can lock in a name, such as `/dev/zwave`, by following [these instructions](http://hintshop.ludvig.co.nz/show/persistent-names-usb-serial-devices/).
-
-
-#### {% linkable_title Events %}
-
-Some devices can also trigger scene activation events, which can be used in automation scripts (for example the press of a button on a wall switch):
-
-```yaml
-# Example configuration.yaml automation entry
-automation:
- - alias: Turn on Desk light
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: zwaveme_zme_wallcs_secure_wall_controller_8
- scene_id: 11
-```
-
-The *entity_id* and *scene_id* of all triggered events can be seen in the console output.
-
-#### {% linkable_title Services %}
-
-The Z-Wave component exposes four services to help maintain the network.
-
-| Service | Description |
-| ------- | ----------- |
-| add_node | Put the zwave controller in inclusion mode. Allows one to add a new device to the zwave network.|
-| remove_node | Put the zwave controller in exclusion mode. Allows one to remove a device from the zwave network.|
-| heal_network | Tells the controller to "heal" the network. Bascially asks the nodes to tell the controller all of their neighbors so the controller can refigure out optimal routing. |
-| soft_reset | Tells the controller to do a "soft reset". This is not supposed to lose any data, but different controllers can behave differently to a "soft reset" command.|
-| test_network | Tells the controller to send no-op commands to each node and measure the time for a response. In theory, this can also bring back nodes which have been marked "presumed dead".|
-
-The soft_reset and heal_network commands can be used as part of an automation script
-to help keep a zwave network running relliably. For example:
-
-```yaml
-# Example configuration.yaml automation entry
-automation:
- - alias: soft reset at 2:30am
- trigger:
- platform: time
- after: '2:30:00'
- action:
- service: zwave.soft_reset
-
- - alias: heal at 2:31am
- trigger:
- platform: time
- after: '2:31:00'
- action:
- service: zwave.heal_network
-```
-
-#### {% linkable_title Device Specific Notes & Configuration %}
-
-##### {% linkable_title Aeon Minimote %}
-
-Here's a handy configuration for the Aeon Labs Minimote that defines all possible button presses. Put it into `automation.yaml`.
-
-```yaml
-- alias: Minimote Button 1 Pressed
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 1
-
-- alias: Minimote Button 1 Held
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 2
-
-- alias: Minimote Button 2 Pressed
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 3
-
-- alias: Minimote Button 2 Held
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 4
-
-- alias: Minimote Button 3 Pressed
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 5
-
-- alias: Minimote Button 3 Held
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 6
-
-- alias: Minimote Button 4 Pressed
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 7
-
-- alias: Minimote Button 4 Held
- trigger:
- platform: event
- event_type: zwave.scene_activated
- event_data:
- entity_id: aeon_labs_minimote_1
- scene_id: 8
-```
-
-##### {% linkable_title Aeotec MultiSensor 6 %}
-
-In order for Home Assistant to recognize well the motion sensor, you will need to change its configuration from `Basic Set (default)` to `Binary Sensor report`. Currently there's no way to do this in Home Assistant but you can use ozwcp (OpenZWave control panel), Domoticz or similar to do it
+[getting started section]: /getting-started/z-wave/
diff --git a/source/_includes/asides/getting_started_navigation.html b/source/_includes/asides/getting_started_navigation.html
index edaff4fa797..46383b0136a 100644
--- a/source/_includes/asides/getting_started_navigation.html
+++ b/source/_includes/asides/getting_started_navigation.html
@@ -45,6 +45,14 @@
diff --git a/source/_topics/z-wave.markdown b/source/_topics/z-wave.markdown
deleted file mode 100644
index b341cb66f39..00000000000
--- a/source/_topics/z-wave.markdown
+++ /dev/null
@@ -1,37 +0,0 @@
----
-layout: page
-title: "Z-Wave"
-description: "Extended instructions how to setup Z-Wave."
-date: 2016-03-24 08:49 -0700
-sidebar: false
-comments: false
-sharing: true
-footer: true
----
-
-Z-Wave is a popular home automation protocol that is not always straightforward to setup. This page will try to help you make sense of it all.
-
-
-Upon first run, the z-wave component will take time to initialize entities and entities may appear with incomplete names. Running a network heal may expidite this proccess.
-
-
-## {% linkable_title Supported Z-Wave Sticks %}
-
-| Device | Works on Linux | Works on Windows | Works on OSX | Comments |
-|-------------------------|----------------|------------------|--------------|-----------|
-| Aeotec Z-Stick Series 2 | X | | | |
-| Aeotec Z-Stick Series 5 | X | | | |
-| Razberry GPIO Module | X | | | |
-
-
-## {% linkable_title Stick Alternatives %}
-
-The alternative to a stick is a hub that supports Z-Wave. Home Assistant supports the following hubs with Z-Wave support:
-
- - [Vera](/components/vera/)
-
-
-## {% linkable_title Modifying Zwave Device Settings %}
-You may wish to modify the zwave settings ozw*.xml file in your .homeassistant root folder, or certain situations/devices may require it (i.e. Aeon Multisensor 6). To do this, utilize [Open-Zwave Control Panel](https://github.com/OpenZWave/open-zwave-control-panel). Alternatively, use [Domoticz](https://www.domoticz.com/), which incorporates the Open-Zwave Control Panel project into an easy to use Raspberry Pi image.
-
-The reasoning for using these tools is that your Zwave controller stores the values and data that are used to control the network. The XML file in the .homeassistant folder acts as a settings/values cache for the zwave network, so modifying it directly won't change the network values. The Open-Zwave Control Panel writes values directly to the network, and will provide you with an updated .xml file to overwrite in your .homeassistant folder. This is the most foolproof way to make modifications to your zwave devices.
diff --git a/source/getting-started/z-wave-controllers.markdown b/source/getting-started/z-wave-controllers.markdown
new file mode 100644
index 00000000000..44d5495b3d5
--- /dev/null
+++ b/source/getting-started/z-wave-controllers.markdown
@@ -0,0 +1,31 @@
+---
+layout: page
+title: "Z-Wave USB Controllers"
+description: "Extended instructions how to setup Z-Wave."
+date: 2016-03-24 08:49 -0700
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+Z-Wave is a popular home automation protocol that is not always straightforward to setup. This page will try to help you make sense of it all.
+
+
+Upon first run, the z-wave component will take time to initialize entities and entities may appear with incomplete names. Running a network heal may expidite this proccess.
+
+
+## {% linkable_title Supported Z-Wave Sticks %}
+
+| Device | Works on Linux | Works on Windows | Works on OSX |
+|-------------------------|----------------|------------------|--------------|
+| Aeotec Z-Stick Series 2 | ✓ | | |
+| Aeotec Z-Stick Series 5 | ✓ | | |
+| Razberry GPIO Module | ✓ | | |
+
+
+## {% linkable_title Stick Alternatives %}
+
+The alternative to a stick is a hub that supports Z-Wave. Home Assistant supports the following hubs with Z-Wave support:
+
+ - [Vera](/components/vera/)
diff --git a/source/getting-started/z-wave-device-specific.markdown b/source/getting-started/z-wave-device-specific.markdown
new file mode 100644
index 00000000000..df0d7363c00
--- /dev/null
+++ b/source/getting-started/z-wave-device-specific.markdown
@@ -0,0 +1,84 @@
+---
+layout: page
+title: "Z-Wave Device Specific Settings"
+description: "Extended instructions how to setup Z-Wave."
+date: 2016-03-24 08:49 -0700
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+##### {% linkable_title Aeon Minimote %}
+
+Here's a handy configuration for the Aeon Labs Minimote that defines all possible button presses. Put it into `automation.yaml`.
+
+```yaml
+- alias: Minimote Button 1 Pressed
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 1
+
+- alias: Minimote Button 1 Held
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 2
+
+- alias: Minimote Button 2 Pressed
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 3
+
+- alias: Minimote Button 2 Held
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 4
+
+- alias: Minimote Button 3 Pressed
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 5
+
+- alias: Minimote Button 3 Held
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 6
+
+- alias: Minimote Button 4 Pressed
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 7
+
+- alias: Minimote Button 4 Held
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: aeon_labs_minimote_1
+ scene_id: 8
+```
+
+##### {% linkable_title Aeotec MultiSensor 6 %}
+
+In order for Home Assistant to recognize well the motion sensor, you will need to change its configuration from `Basic Set (default)` to `Binary Sensor report`. Currently there's no way to do this in Home Assistant but you can use ozwcp (OpenZWave control panel), Domoticz or similar to do it
diff --git a/source/getting-started/z-wave-settings.markdown b/source/getting-started/z-wave-settings.markdown
new file mode 100644
index 00000000000..ff23871c919
--- /dev/null
+++ b/source/getting-started/z-wave-settings.markdown
@@ -0,0 +1,14 @@
+---
+layout: page
+title: "Z-Wave Settings"
+description: "Extended instructions how to setup Z-Wave."
+date: 2016-03-24 08:49 -0700
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+You may wish to modify the zwave settings ozw*.xml file in your .homeassistant root folder, or certain situations/devices may require it (i.e. Aeon Multisensor 6). To do this, utilize [Open-Zwave Control Panel](https://github.com/OpenZWave/open-zwave-control-panel). Alternatively, use [Domoticz](https://www.domoticz.com/), which incorporates the Open-Zwave Control Panel project into an easy to use Raspberry Pi image.
+
+The reasoning for using these tools is that your Zwave controller stores the values and data that are used to control the network. The XML file in the .homeassistant folder acts as a settings/values cache for the zwave network, so modifying it directly won't change the network values. The Open-Zwave Control Panel writes values directly to the network, and will provide you with an updated .xml file to overwrite in your .homeassistant folder. This is the most foolproof way to make modifications to your zwave devices.
diff --git a/source/getting-started/z-wave.markdown b/source/getting-started/z-wave.markdown
new file mode 100644
index 00000000000..c188aa3b11f
--- /dev/null
+++ b/source/getting-started/z-wave.markdown
@@ -0,0 +1,142 @@
+---
+layout: page
+title: "Z-Wave"
+description: "Instructions how to integrate your existing Z-Wave within Home Assistant."
+date: 2016-02-27 19:59
+sidebar: true
+comments: false
+sharing: true
+footer: true
+---
+
+[Z-Wave](http://www.z-wave.com/) integration for Home Assistant allows you to observe and control connected Z-Wave devices. Z-Wave support requires a [supported Z-Wave USB stick](https://github.com/OpenZWave/open-zwave/wiki/Controller-Compatibility-List) to be plugged into the host.
+
+There is currently support for switches, lights and sensors. All will be picked up automatically after configuring this platform.
+
+### {% linkable_title Installation %}
+
+To allow Home Assistant to talk to your Z-Wave USB stick you will have to compile the OpenZWave library and install the related [python-OpenZWave package](https://github.com/OpenZWave/python-openzwave). This can be done as follows. _(Note: The Home Assistant docker image has support for Z-Wave built-in)_
+
+Make sure you have the correct dependencies installed before running the script:
+
+```bash
+$ sudo apt-get install cython3 libudev-dev python3-sphinx python3-setuptools
+```
+
+Make sure you have at least version 0.23 of cython.
+
+```bash
+$ sudo pip3 install --upgrade cython
+```
+
+Then get the OpenZWave files and switch to the `python3` branch:
+
Do not use root to build python-openzwave as it will surely fail.
+```bash
+$ git clone https://github.com/OpenZWave/python-openzwave.git
+$ cd python-openzwave
+$ git checkout python3
+$ PYTHON_EXEC=$(which python3) make build
+$ sudo PYTHON_EXEC=$(which python3) make install
+```
+
+Instead of `make install`, you can alternatively build your own python-openzwave package which can be easily uninstalled:
+
+```$ sudo PYTHON_EXEC=$(which python3) checkinstall --pkgname python-openzwave --pkgversion 1.0 --provides python-openzwave```
+
+
+
+With this installation, your `config_path` needed below will resemble:
+
+```bash
+/usr/local/lib/python3.4/dist-packages/libopenzwave-0.3.0b8-py3.4-linux-x86_64.egg/config
+```
+
+
+### {% linkable_title Configuration %}
+
+```yaml
+# Example configuration.yaml entry
+zwave:
+ usb_path: /dev/ttyUSB0
+ config_path: /usr/local/share/python-openzwave/config
+ polling_interval: 60000
+ customize:
+ sensor.greenwave_powernode_6_port_energy_10:
+ polling_intensity: 1
+```
+
+Configuration variables:
+
+- **usb_path** (*Required*): The port where your device is connected to your Home Assistant host.
+- **config_path** (*Optional*): The path to the Python Open Z-Wave configuration files.
+- **autoheal** (*Optional*): Allows disabling auto ZWave heal at midnight. Defaults to True.
+- **polling_interval** (*Optional*): The time period in milliseconds between polls of a nodes value. Be careful about using polling values below 30000 (30 seconds) as polling can flood the zwave network and cause problems.
+- **customize** (*Optional*): This attribute contains node-specific override values:
+ - **polling_intensity** (*Optional*): Enables polling of a value and sets the frequency of polling (0=none, 1=every time through the list, 2-every other time, etc). If not specified then your device will not be polled.
+
+To find the path of your Z-Wave stick, run:
+
+```bash
+$ ls /dev/ttyUSB*
+```
+
+Or, on some other systems (such as Raspberry Pi), use:
+
+```bash
+$ ls /dev/ttyACM*
+```
+
+
+Depending on what's plugged into your USB ports, the name found above may change. You can lock in a name, such as `/dev/zwave`, by following [these instructions](http://hintshop.ludvig.co.nz/show/persistent-names-usb-serial-devices/).
+
+
+#### {% linkable_title Events %}
+
+Some devices can also trigger scene activation events, which can be used in automation scripts (for example the press of a button on a wall switch):
+
+```yaml
+# Example configuration.yaml automation entry
+automation:
+ - alias: Turn on Desk light
+ trigger:
+ platform: event
+ event_type: zwave.scene_activated
+ event_data:
+ entity_id: zwaveme_zme_wallcs_secure_wall_controller_8
+ scene_id: 11
+```
+
+The *entity_id* and *scene_id* of all triggered events can be seen in the console output.
+
+#### {% linkable_title Services %}
+
+The Z-Wave component exposes four services to help maintain the network.
+
+| Service | Description |
+| ------- | ----------- |
+| add_node | Put the zwave controller in inclusion mode. Allows one to add a new device to the zwave network.|
+| remove_node | Put the zwave controller in exclusion mode. Allows one to remove a device from the zwave network.|
+| heal_network | Tells the controller to "heal" the network. Bascially asks the nodes to tell the controller all of their neighbors so the controller can refigure out optimal routing. |
+| soft_reset | Tells the controller to do a "soft reset". This is not supposed to lose any data, but different controllers can behave differently to a "soft reset" command.|
+| test_network | Tells the controller to send no-op commands to each node and measure the time for a response. In theory, this can also bring back nodes which have been marked "presumed dead".|
+
+The soft_reset and heal_network commands can be used as part of an automation script
+to help keep a zwave network running relliably. For example:
+
+```yaml
+# Example configuration.yaml automation entry
+automation:
+ - alias: soft reset at 2:30am
+ trigger:
+ platform: time
+ after: '2:30:00'
+ action:
+ service: zwave.soft_reset
+
+ - alias: heal at 2:31am
+ trigger:
+ platform: time
+ after: '2:31:00'
+ action:
+ service: zwave.heal_network
+```
From 8a9e983745196d73498b4043bd777e868607741f Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Wed, 8 Jun 2016 22:40:32 -0700
Subject: [PATCH 09/23] Update automation-templating.markdown
---
source/getting-started/automation-templating.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/getting-started/automation-templating.markdown b/source/getting-started/automation-templating.markdown
index e80b973d3ce..f365047fd85 100644
--- a/source/getting-started/automation-templating.markdown
+++ b/source/getting-started/automation-templating.markdown
@@ -32,7 +32,7 @@ automation 2:
topic: /notify/+
action:
service_template: >{% raw %}
- notify.{{ trigger.topic.split('/')[-1] }}
+ notify.{{ trigger.topic.split('/')[-1] }}{% endraw %}
data_template:
message: {% raw %}{{ trigger.payload }}{% endraw %}
```
From b16449a93f0de76b2fe67b436350375b558ba72e Mon Sep 17 00:00:00 2001
From: Kyle Hendricks
Date: Thu, 9 Jun 2016 01:59:30 -0400
Subject: [PATCH 10/23] Polling is done by polling a local device. (#544)
---
source/_components/sensor.dte_energy_bridge.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/_components/sensor.dte_energy_bridge.markdown b/source/_components/sensor.dte_energy_bridge.markdown
index 68cf9cc6cf6..f135b0864d9 100644
--- a/source/_components/sensor.dte_energy_bridge.markdown
+++ b/source/_components/sensor.dte_energy_bridge.markdown
@@ -9,7 +9,7 @@ sharing: true
footer: true
ha_category: Sensor
ha_release: 0.21
-ha_iot_class: "Cloud Polling"
+ha_iot_class: "Local Polling"
---
A sensor for the DTE Energy Bridge
From 645deec7e9b2efdedf7c477aab16ed664219f4dc Mon Sep 17 00:00:00 2001
From: Fabian Affolter
Date: Thu, 9 Jun 2016 08:18:35 +0200
Subject: [PATCH 11/23] Add updating section back till the frontend is updated
---
source/getting-started/index.markdown | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown
index b48d8943d37..644d38c6f0c 100644
--- a/source/getting-started/index.markdown
+++ b/source/getting-started/index.markdown
@@ -31,6 +31,10 @@ If you prefer to watch a video tutorial, [tktino](https://github.com/tktino) has
- [Mac OS X](https://www.youtube.com/watch?v=hej6ipN86ls)
- [Ubuntu 14.04](https://www.youtube.com/watch?v=SXaAG1lGNH0)
+### {% linkable_title Updating %}
+
+To update Home Assistant to the latest release check the [Updating section](/getting-started/updating/) section.
+
### {% linkable_title Troubleshooting %}
If you run into any issues, please see [the troubleshooting page](/getting-started/troubleshooting/). It contains solutions to many of the common encountered issues.
From 6e4e6d1c9985df5e94391cf5acb6fc10f0e2bfe3 Mon Sep 17 00:00:00 2001
From: Fabian Affolter
Date: Thu, 9 Jun 2016 08:32:16 +0200
Subject: [PATCH 12/23] Move updates to one place and add note about user
---
source/getting-started/troubleshooting.markdown | 7 -------
source/getting-started/updating.markdown | 15 +++++++++++++++
2 files changed, 15 insertions(+), 7 deletions(-)
diff --git a/source/getting-started/troubleshooting.markdown b/source/getting-started/troubleshooting.markdown
index eda34e41dfc..f5d2b7c6d7c 100644
--- a/source/getting-started/troubleshooting.markdown
+++ b/source/getting-started/troubleshooting.markdown
@@ -69,11 +69,4 @@ Android Chrome
chrome -> settings -> site settings -> storage -> search for your URL for home assistant-> "clear & reset"
-#### {% linkable_title Run the development version %}
-If you want to stay on top of the development of Home Assistant then you can upgrade to the `dev` branch. This can result in an unstable system, loss of data, etc. etc.
-
-```bash
-$ pip3 install --upgrade git+git://github.com/balloob/home-assistant.git@dev
-```
-
### [« Back to Getting Started](/getting-started/)
diff --git a/source/getting-started/updating.markdown b/source/getting-started/updating.markdown
index 649b6fe3539..b726cf6bbb7 100644
--- a/source/getting-started/updating.markdown
+++ b/source/getting-started/updating.markdown
@@ -18,3 +18,18 @@ $ pip3 install --upgrade homeassistant
After updating, restart Home Assistant for the changes to take effect. This means that you have to restart `hass` itself or the [autostarting](/getting-started/autostart/) daemon if you use any.
+
+
+ The upgrade needs to be run as the same user as the installation was done to avoid permission errors.
+
+
+#### {% linkable_title Run the development version %}
+If you want to stay on top of the development of Home Assistant then you can upgrade to the `dev` branch.
+
+
+ This can result in an unstable system, loss of data, etc. etc.
+
+
+```bash
+$ pip3 install --upgrade git+git://github.com/home-assistant/home-assistant.git@dev
+```
From d144acb9bfab18b697bbc7120670785d29383f5b Mon Sep 17 00:00:00 2001
From: Fabian Affolter
Date: Thu, 9 Jun 2016 09:47:38 +0200
Subject: [PATCH 13/23] remove duplicate
---
source/getting-started/index.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown
index 644d38c6f0c..320dd88be9f 100644
--- a/source/getting-started/index.markdown
+++ b/source/getting-started/index.markdown
@@ -33,7 +33,7 @@ If you prefer to watch a video tutorial, [tktino](https://github.com/tktino) has
### {% linkable_title Updating %}
-To update Home Assistant to the latest release check the [Updating section](/getting-started/updating/) section.
+To update Home Assistant to the latest release check the [Updating section](/getting-started/updating/).
### {% linkable_title Troubleshooting %}
From 322b1e44696b9660b4980458b78ff2ef4243286e Mon Sep 17 00:00:00 2001
From: Fabian Affolter
Date: Thu, 9 Jun 2016 09:55:09 +0200
Subject: [PATCH 14/23] Minor updates
---
source/_components/binary_sensor.apcupsd.markdown | 4 ++--
.../_components/sensor.dte_energy_bridge.markdown | 14 +++++++++++---
2 files changed, 13 insertions(+), 5 deletions(-)
diff --git a/source/_components/binary_sensor.apcupsd.markdown b/source/_components/binary_sensor.apcupsd.markdown
index e2e1db42d4c..4b3b3f0005d 100644
--- a/source/_components/binary_sensor.apcupsd.markdown
+++ b/source/_components/binary_sensor.apcupsd.markdown
@@ -19,8 +19,8 @@ To enable this sensor, add the following lines to your `configuration.yaml` file
```yaml
# Example configuration.yaml entry
binary_sensor:
- - platform: apcupsd
- name: UPS Online
+ platform: apcupsd
+ name: UPS Online
```
Configuration variables:
diff --git a/source/_components/sensor.dte_energy_bridge.markdown b/source/_components/sensor.dte_energy_bridge.markdown
index f135b0864d9..1c2d7999f0f 100644
--- a/source/_components/sensor.dte_energy_bridge.markdown
+++ b/source/_components/sensor.dte_energy_bridge.markdown
@@ -12,10 +12,18 @@ ha_release: 0.21
ha_iot_class: "Local Polling"
---
-A sensor for the DTE Energy Bridge
+A sensor platform for the [DTE](https://www.dteenergy.com/) Energy Bridge.
+
+To enable this sensor, add the following lines to your `configuration.yaml` file:
```yaml
+# Example configuration.yaml entry
sensor:
- platform: dte_energy_bridge
- ip: 192.168.1.11
+ platform: dte_energy_bridge
+ ip: 192.168.1.11
```
+
+Configuration variables:
+
+- **ip** (*Required*): The IP address of your bridge.
+
From 289e5457aee6b46194262a1bf8a878690649a329 Mon Sep 17 00:00:00 2001
From: Galtwise
Date: Thu, 9 Jun 2016 22:39:44 -0600
Subject: [PATCH 15/23] Update scripts-service-calls.markdown (#546)
Added info on how to use the Services Developer Tool
---
source/getting-started/scripts-service-calls.markdown | 11 +++++++++++
1 file changed, 11 insertions(+)
diff --git a/source/getting-started/scripts-service-calls.markdown b/source/getting-started/scripts-service-calls.markdown
index 1090dc741ed..2f9e4b07a10 100644
--- a/source/getting-started/scripts-service-calls.markdown
+++ b/source/getting-started/scripts-service-calls.markdown
@@ -54,6 +54,17 @@ service_template: >
entity_id: switch.ac
```
+### {% linkable_title Using the Services Developer Tool %}
+
+You can use the Services Developer Tool to test data to pass in a service call.
+For example, you may test turning on or off a 'group' (See [groups] for more info)
+
+To turn a group on or off, pass the following info:
+Domain: `homeassistant`
+Service: `turn_on`
+Service Data: `{ "entity_id": "group.kitchen" }`
+
+
### {% linkable_title Use templates to determine the attributes %}
Templates can also be used for the data that you pass to the service call.
From e5c88ef8518b3f19c1ddce66c765d8dac8a16e09 Mon Sep 17 00:00:00 2001
From: Pascal Vizeli
Date: Fri, 10 Jun 2016 12:55:50 +0200
Subject: [PATCH 16/23] Update sensor.openweathermap.markdown (#548)
Fix configuration variable monitored_conditions
---
source/_components/sensor.openweathermap.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/_components/sensor.openweathermap.markdown b/source/_components/sensor.openweathermap.markdown
index 6c8a4f85c69..01673022dc4 100644
--- a/source/_components/sensor.openweathermap.markdown
+++ b/source/_components/sensor.openweathermap.markdown
@@ -40,7 +40,7 @@ Configuration variables:
- **api_key** (*Required*): Your API key for http://openweathermap.org/.
- **forecast** (*Optional*): Enables the forecast. The default is to display the current conditions.
-- **display_conditions** array (*Required*): Conditions to display in the frontend.
+- **monitored_conditions** array (*Required*): Conditions to display in the frontend.
- **weather**: A human-readable text summary.
- **temperature**: The current temperature.
- **wind_speed**: The wind speed.
From 128b712ef7c9ff99b8cc3709fe7ab4f2a689c3e4 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Fri, 10 Jun 2016 08:40:45 -0700
Subject: [PATCH 17/23] Update thermostat.zwave.markdown
---
source/_components/thermostat.zwave.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/_components/thermostat.zwave.markdown b/source/_components/thermostat.zwave.markdown
index 17821dc3ea6..01b09de3cf9 100644
--- a/source/_components/thermostat.zwave.markdown
+++ b/source/_components/thermostat.zwave.markdown
@@ -15,7 +15,7 @@ ha_release: 0.17
To get your Z-Wave thermostat working with Home Assistant, follow the instructions for the general [Z-Wave component](/components/zwave/).
-If your thermostat support fan modes or different operating modes, it should be considered a [HVAC component](components/hvac/), and will also be detected as one. Thermostat component does not support setting fan or operation mode. This is controlled via the HVAC component.
+If your thermostat support fan modes or different operating modes, it should be considered a [HVAC component](/components/zwave.hvac/), and will also be detected as one. Thermostat component does not support setting fan or operation mode. This is controlled via the HVAC component.
If the thermostat support different operationg modes, you will get one thermostat entity for each mode. These can be hidden with settings using the customize setting in the `configuration.yaml` file.
From ed3b413d4813cd6acc3fe2f4678d63806443dc4e Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Fri, 10 Jun 2016 08:41:34 -0700
Subject: [PATCH 18/23] Update thermostat.zwave.markdown
---
source/_components/thermostat.zwave.markdown | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/source/_components/thermostat.zwave.markdown b/source/_components/thermostat.zwave.markdown
index 01b09de3cf9..0ae7f181421 100644
--- a/source/_components/thermostat.zwave.markdown
+++ b/source/_components/thermostat.zwave.markdown
@@ -15,7 +15,7 @@ ha_release: 0.17
To get your Z-Wave thermostat working with Home Assistant, follow the instructions for the general [Z-Wave component](/components/zwave/).
-If your thermostat support fan modes or different operating modes, it should be considered a [HVAC component](/components/zwave.hvac/), and will also be detected as one. Thermostat component does not support setting fan or operation mode. This is controlled via the HVAC component.
+If your thermostat support fan modes or different operating modes, it should be considered a [HVAC component](/components/hvac.zwave/), and will also be detected as one. Thermostat component does not support setting fan or operation mode. This is controlled via the HVAC component.
If the thermostat support different operationg modes, you will get one thermostat entity for each mode. These can be hidden with settings using the customize setting in the `configuration.yaml` file.
From b45f71d8fae7df832463e77705f9bc465c0bba47 Mon Sep 17 00:00:00 2001
From: Paulus Schoutsen
Date: Sat, 11 Jun 2016 13:39:18 -0700
Subject: [PATCH 19/23] Update lirc.markdown
---
source/_components/lirc.markdown | 6 +++++-
1 file changed, 5 insertions(+), 1 deletion(-)
diff --git a/source/_components/lirc.markdown b/source/_components/lirc.markdown
index 9316575446c..bacf8b3cb1f 100644
--- a/source/_components/lirc.markdown
+++ b/source/_components/lirc.markdown
@@ -30,6 +30,7 @@ $ sudo apt-get install lirc
If you are configuring on a Raspberry Pi, there are excellent instructions with GPIO schematics and driver configurations [here](http://alexba.in/blog/2013/01/06/setting-up-lirc-on-the-raspberrypi/). Consider following these.
+### {% linkable_title Configuring LIRC %}
Now teach LIRC about your particular remote control by preparing a lircd configuration file (`/etc/lirc/lircd.conf`). Search the [LIRC remote database](http://lirc.sourceforge.net/remotes/) for your model. If you can't find it, then you can always use the `irrecord` program to learn your remote. This will create a valid configuration file. Add as many remotes as you want by pasting them into the file. If `irrecord` doesn't work (e.g. for some air conditioner remotes), then the `mode2` program is capable of reading the codes in raw mode, followed by `irrecord -a` to extract hex codes.
@@ -65,13 +66,16 @@ $ irexec -n home-assistant
and pressing some buttons on the remote.
-### {% linkable_title Configuration %}
+### {% linkable_title Configuration Home Assistant %}
```yaml
# Example configuration.yaml entry
lirc:
```
+
+If you are on a Debian based system (like Raspberry Pi) and are having issues loading the component due to it being unable to install python-lirc, install it manually using `apt-get install python3-lirc`.
+