diff --git a/source/_components/alexa.markdown b/source/_components/alexa.markdown index 6725d322fcf..d66913e751d 100644 --- a/source/_components/alexa.markdown +++ b/source/_components/alexa.markdown @@ -12,7 +12,7 @@ ha_category: Voice featured: false --- -The Alexa component allows you to integrate Home Assistant into Alexa/Amazon Echo. This component will allow you to query information within Home Assistant by using your voice. There are no supported sentences out of the box as of now, you will have to define them all yourself. This component does not yet allow the control of devices connected to Home Assistant. +The Alexa component allows you to integrate Home Assistant into Alexa/Amazon Echo. This component will allow you to query information and call services within Home Assistant by using your voice. There are no supported sentences out of the box as of now, you will have to define them all yourself.
@@ -102,6 +102,10 @@ alexa: {% endif %} LocateIntent: + action: + service: notify.notify + data: + message: Your location has been queried via Alexa. speech: type: plaintext text: > diff --git a/source/_components/binary_sensor.rpi_gpio.markdown b/source/_components/binary_sensor.rpi_gpio.markdown index 98e5f967c13..4bc2f7581c4 100644 --- a/source/_components/binary_sensor.rpi_gpio.markdown +++ b/source/_components/binary_sensor.rpi_gpio.markdown @@ -8,7 +8,7 @@ comments: false sharing: true footer: true logo: raspberry-pi.png -ha_category: DIY +ha_category: Sensor --- diff --git a/source/_components/input_boolean.markdown b/source/_components/input_boolean.markdown new file mode 100644 index 00000000000..2e66c928787 --- /dev/null +++ b/source/_components/input_boolean.markdown @@ -0,0 +1,26 @@ +--- +layout: component +title: "Input Boolean" +description: "Instructions how to integrate the Input Boolean component into Home Assistant." +date: 2016-01-17 16:58 +sidebar: true +comments: false +sharing: true +footer: true +logo: home-assistant.png +ha_category: Automation +--- + +The input boolean component allows the user to define boolean values that can be controlled via the frontend and can be used within conditions of automation. This can for example be used to disable or enable certain automations. + +```yaml +# Example configuration.yaml entry +input_boolean: + notify_home: + # Optional, friendly name of entry + name: Notify when someome arrives home + # Optional, value when Home Assistant starts + initial: off + # Optional, icon for entry + icon: mdi:car +``` diff --git a/source/_components/light.hue.markdown b/source/_components/light.hue.markdown index 3575bdb96af..8789a5d3322 100644 --- a/source/_components/light.hue.markdown +++ b/source/_components/light.hue.markdown @@ -14,7 +14,7 @@ featured: true -Philips Hue support is integrated into Home Assistant as a light platform. The preferred way to setup the Philips Hue platform is by enabling the [the discovery component]({{site_root}}/components/discovery/). +Philips Hue support is integrated into Home Assistant as a light platform. The preferred way to setup the Philips Hue platform is by enabling the [the discovery component](/components/discovery/). If you want to enable the light component directly, add the following lines to your `configuration.yaml`: @@ -23,4 +23,6 @@ If you want to enable the light component directly, add the following lines to y light: platform: hue host: DEVICE_IP_ADDRESS + # Optional, make this unique if specifying multiple Hue hubs + filename: my_hue_hub_token.conf ``` diff --git a/source/_components/mysensors.markdown b/source/_components/mysensors.markdown new file mode 100644 index 00000000000..83482b97904 --- /dev/null +++ b/source/_components/mysensors.markdown @@ -0,0 +1,44 @@ +--- +layout: component +title: "MySensors" +description: "Instructions how to integrate MySensors sensors into Home Assistant." +date: 2015-05-14 21:57 +sidebar: true +comments: false +sharing: true +footer: true +logo: mysensors.png +ha_category: Hub +featured: true +--- + +The [MySensors](https://www.mysensors.org) project combines Arduino boards with NRF24L01 radio boards to build sensor networks. The component will automatically add all available switches and sensors to Home Assistant. + +Integrate your Serial MySensors Gateway by adding the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +mysensors: + gateways: + - port: '/dev/ttyUSB0' + persistence_file: 'path/mysensors.json' + - port: '/dev/ttyACM1' + persistence_file: 'path/mysensors2.json' + debug: true + persistence: true + version: '1.5' +``` + +Configuration variables: + +- **port** (*Required*): The port where your board is connected to your Home Assistant host. +- **debug** (*Optional*): Enable or disable verbose debug logging. +- **persistence** (*Optional*): Enable or disable local persistence of sensor information. If this is disabled, then each sensor will need to send presentation messages after Home Assistant starts. +- **persistence_file** (*Optional*): Path to a file to save sensor information. The file extension determines the file type. Currently supported file types are 'pickle' and 'json'. +- **version** (*Optional*): Specifies the MySensors protocol version to use (ex. 1.4, 1.5). + +If you are using an original Arduino the port will be named `ttyACM*`. The exact number can be determined with the command shown below. + +```bash +$ ls /dev/ttyACM* +``` diff --git a/source/_components/notify.free_mobile.markdown b/source/_components/notify.free_mobile.markdown index 938d1afc5c0..a3d6c53f574 100644 --- a/source/_components/notify.free_mobile.markdown +++ b/source/_components/notify.free_mobile.markdown @@ -39,11 +39,3 @@ Configuration variables: - **username** (*Required*): This is the id given by FreeMobile to access to your online account. - **access_token** (*Required*): You can get this token by activating the SMS API in your online account. - -#### Example service payload - -```json -{ - "message": "Hello World" -} -``` diff --git a/source/_components/sensor.mysensors.markdown b/source/_components/sensor.mysensors.markdown index d4580c676fb..26538464526 100644 --- a/source/_components/sensor.mysensors.markdown +++ b/source/_components/sensor.mysensors.markdown @@ -1,40 +1,17 @@ --- layout: component -title: "MySensors sensor" +title: "MySensors sensors" description: "Instructions how to integrate MySensors sensors into Home Assistant." -date: 2015-05-14 21:57 +date: 2016-01-17 15:49 sidebar: true comments: false sharing: true footer: true logo: mysensors.png ha_category: Sensor -featured: true +featured: false --- +Integrates MySensors sensors into Home Assistant. See the [main component] for configuration instructions. -The [MySensors](https://www.mysensors.org) project combines Arduino boards with NRF24L01 radio boards to build sensor networks. The mysensors platform support sensors connected to the MYSensors Gateway. - -Integrate your Serial MYSensors Gateway by adding the following to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -sensor: - platform: mysensors - port: /dev/ttyACM0 -``` - -Configuration variables: - -- **port** (*Required*): The port where your board is connected to your Home Assistant host. -- **debug** (*Optional*): Enable or disable verbose debug logging. -- **persistence** (*Optional*): Enable or disable local persistence of sensor information. If this is disabled, then each sensor will need to send presentation messages after Home Assistant starts. -- **persistence_file** (*Optional*): Path to a file to save sensor information. The file extension determines the file type. Currently supported file types are 'pickle' and 'json'. -- **version** (*Optional*): Specifies the MySensors protocol version to use (ex. 1.4, 1.5). - -If you are using an original Arduino the port will be named `ttyACM*`. The exact number can be determined with the command shown below. - -```bash -$ ls /dev/ttyACM* -``` - +[main component]: /components/mysensors/ diff --git a/source/_components/sensor.nest.markdown b/source/_components/sensor.nest.markdown index 7882c04cd4d..ef22e305d07 100644 --- a/source/_components/sensor.nest.markdown +++ b/source/_components/sensor.nest.markdown @@ -2,7 +2,8 @@ layout: component title: "Nest thermostat" description: "Instructions how to integrate Nest thermostats sensors within Home Assistant." -date: 2016-01-13 19:59 +# Year set to 2017 to unpublish till 0.12 release +date: 2017-01-13 19:59 sidebar: true comments: false sharing: true diff --git a/source/_components/sensor.tellduslive.markdown b/source/_components/sensor.tellduslive.markdown new file mode 100644 index 00000000000..9874f868a25 --- /dev/null +++ b/source/_components/sensor.tellduslive.markdown @@ -0,0 +1,17 @@ +--- +layout: component +title: "Telldus Live sensors" +description: "Instructions how to integrate Telldus Live sensors into Home Assistant." +date: 2016-01-17 15:49 +sidebar: true +comments: false +sharing: true +footer: true +logo: telldus.png +ha_category: Sensor +featured: false +--- + +Integrates Telldus Live sensors into Home Assistant. See the [main component] for configuration instructions. + +[main component]: /components/tellduslive/ diff --git a/source/_components/switch.mysensors.markdown b/source/_components/switch.mysensors.markdown new file mode 100644 index 00000000000..00b90022d5b --- /dev/null +++ b/source/_components/switch.mysensors.markdown @@ -0,0 +1,17 @@ +--- +layout: component +title: "MySensors switches" +description: "Instructions how to integrate MySensors switches into Home Assistant." +date: 2016-01-17 15:49 +sidebar: true +comments: false +sharing: true +footer: true +logo: mysensors.png +ha_category: Switch +featured: false +--- + +Integrates MySensors switches into Home Assistant. See the [main component] for configuration instructions. + +[main component]: /components/mysensors/ diff --git a/source/_components/switch.rpi_gpio.markdown b/source/_components/switch.rpi_gpio.markdown index 1bcae5a6ba9..284352994b1 100644 --- a/source/_components/switch.rpi_gpio.markdown +++ b/source/_components/switch.rpi_gpio.markdown @@ -1,14 +1,14 @@ --- layout: component title: "Raspberry PI GPIO switch" -description: "Instructions how to integrate the GPIO of a Raspberry PI into Home Assistant." +description: "Instructions how to integrate the GPIO of a Raspberry PI into Home Assistant as a switch." date: 2015-08-07 14:00 sidebar: true comments: false sharing: true footer: true logo: raspberry-pi.png -ha_category: DIY +ha_category: Switch --- diff --git a/source/_components/switch.tellduslive.markdown b/source/_components/switch.tellduslive.markdown new file mode 100644 index 00000000000..ac38ab5f01f --- /dev/null +++ b/source/_components/switch.tellduslive.markdown @@ -0,0 +1,17 @@ +--- +layout: component +title: "Telldus Live switches" +description: "Instructions how to integrate Telldus Live switches into Home Assistant." +date: 2016-01-17 15:49 +sidebar: true +comments: false +sharing: true +footer: true +logo: telldus.png +ha_category: Switch +featured: false +--- + +Integrates Telldus Live switches into Home Assistant. See the [main component] for configuration instructions. + +[main component]: /components/tellduslive/ diff --git a/source/_components/tellduslive.markdown b/source/_components/tellduslive.markdown new file mode 100644 index 00000000000..9effddbb502 --- /dev/null +++ b/source/_components/tellduslive.markdown @@ -0,0 +1,30 @@ +--- +layout: component +title: "Telldus Live" +description: "Instructions how to integrate Telldus Live into Home Assistant." +date: 2016-01-17 16:00 +sidebar: true +comments: false +sharing: true +footer: true +logo: telldus.png +ha_category: Hub +featured: false +--- + +[Telldus Live] is a cloud platform that connects to your Tellstick connected gear at home. + +[Telldus Live]: https://live.telldus.com + +To get started using Telldus Live, you will have to obtain developer keys from [here][developer-keys]. + +[developer-keys]: https://api.telldus.com/keys/index + +```yaml +# Example configuration.yaml entry +tellduslive: + public_key: XX + private_key: XX + token: XX + token_secret: XX +``` diff --git a/source/_posts/2016-12-17-extended-support-for-diy-solutions.markdown b/source/_posts/2016-12-17-extended-support-for-diy-solutions.markdown new file mode 100644 index 00000000000..ba2eb9a3077 --- /dev/null +++ b/source/_posts/2016-12-17-extended-support-for-diy-solutions.markdown @@ -0,0 +1,85 @@ +--- +layout: post +title: "0.11: Extended support for DIY solutions" +description: "Home Assistant 0.11 has been released with extended support for making your own home automation components using a Raspberry Pi and MySensors." +date: 2016-01-17 15:20:00 -0800 +date_formatted: "January 17, 2015" +author: Paulus Schoutsen +author_twitter: balloob +comments: true +categories: Release-Notes +--- + +First release of 2016 and we are on 🔥! The [main repository][github-ha] has passed 2500 ⭐ on GitHub (2596 ⭐ as of now). This release also has a [record number][release-pr] of 20 contributors all working on improving and extending Home Assistant. With the continued growth, I am very excited to see what 2016 will bring us 🤘. + +[github-ha]: https://github.com/balloob/home-assistant/ +[release-pr]: https://github.com/balloob/home-assistant/pull/883#partial-users-participants + + + + - [MySensors] revamped and switch support added ([@MartinHjelmare][@MartinHjelmare]) + - Full refactor of [RPi GPIO]. Now includes [binary sensor][rpi-bs] and [switch][rpi-s] + - Sensor: [YR] platform added ([@danielhiversen]) + - Device Tracker: Geofancy platform has been renamed to [Locative] ([@philipbl]) + - Automation: Add [sun condition] ([@philipbl]) + - Switch: [command_switch] can now poll for state ([@happyleavesaoc][@happyleavesaoc]) + - Switch: [wemo] now uses subscription to states instead of polling ([@pavoni][@pavoni]) + - [Telldus Live] support added ([@molobrakos]) + - [Vera] now uses subscription to states instead of polling ([@pavoni]) + - New [template helper method] `is_state_attr(entity_id, name, value)` added ([@andythigpen]) + - Device tracker: [OwnTracks] transition events now supported ([@xifle]) + - Light: [Philips Hue] platform now supports multiple hubs ([@rhooper]) + - Notify: [Free Mobile] platform added ([@HydrelioxGitHub]) + - New [MQTT Eventstream] component to connect two Home Assistant instances over MQTT ([@moonshot]) + - Media player: [Cast] huge stability improvements ([@rmkraus]) + - Media Player: [Universal media player] added to combine multiple media players ([@rmkraus]) + - Sensor: [Netatmo] platform added ([@HydrelioxGitHub]) + - Alarm Control Panel: [Alarm.com] platform added ([@Xorso]) + - Thermostat: [Proliphix] platform added ([@sdague]) + - New component [input_boolean] will allow for customizing automation ([@balloob]) + - Support calling services via [Amazon Echo] ([@balloob]) + +[MySensors]: /components/mysensors/ +[YR]: /components/sensor.yr/ +[Locative]: /components/device_tracker.locative/ +[sun condition]: /components/automation/#sun-condition +[command_switch]: /components/switch.command_switch/ +[wemo]: /components/switch.wemo/ +[Telldus Live]: /components/tellduslive/ +[Vera]: /components/vera/ +[template helper method]: /getting-started/templating/#home-assistant-template-extensions +[OwnTracks]: /components/device_tracker.owntracks/ +[Philips Hue]: /components/light.hue/ +[Free Mobile]: /components/notify.free_mobile/ +[MQTT Eventstream]: /components/mqtt_eventstream/ +[Cast]: /components/media_player.cast/ +[Universal media player]: /components/media_player.universal/ +[Netatmo]: /components/sensor.netatmo/ +[Alarm.com]: /components/alarm_control_panel.alarmdotcom/ +[Proliphix]: /components/thermostat.proliphix/ +[rpi-bs]: /components/binary_sensor.rpi_gpio/ +[rpi-s]: /components/switch.rpi_gpio/ +[input_boolean]: /components/input_boolean/ +[MySensors sensor platform]: /components/sensor.mysensors/ +[Amazon Echo]: /components/alexa/ + +### Deprecations + - The [RPi.GPIO sensor platform][rpi-bs] has been moved to the `binary_sensor` component. + - [MySensors sensor platform] now requires the [MySensors] component to be configured. + - Geofancy platform has been renamed to [Locative]. + +[@MartinHjelmare]: https://github.com/MartinHjelmare +[@danielhiversen]: https://github.com/danielhiversen +[@philipbl]: https://github.com/philipbl +[@happyleavesaoc]: https://github.com/happyleavesaoc +[@pavoni]: https://github.com/pavoni +[@molobrakos]: https://github.com/molobrakos +[@andythigpen]: https://github.com/andythigpen +[@xifle]: https://github.com/xifle +[@rhooper]: https://github.com/rhooper +[@HydrelioxGitHub]: https://github.com/HydrelioxGitHub +[@moonshot]: https://github.com/moonshot +[@rmkraus]: https://github.com/rmkraus +[@Xorso]: https://github.com/Xorso +[@sdague]: https://github.com/sdague +[@balloob]: https://github.com/balloob \ No newline at end of file diff --git a/source/getting-started/templating.markdown b/source/getting-started/templating.markdown index 925221519ee..af5b863919c 100644 --- a/source/getting-started/templating.markdown +++ b/source/getting-started/templating.markdown @@ -61,6 +61,7 @@ Home Assistant adds extensions to allow templates to access all of the current s - `states.sensor.temperature` returns state object for `sensor.temperature` - `states('device_tracker.paulus')` will return the state string (not the object) of given entity or `unknown` if it doesn't exist. - `is_state('device_tracker.paulus', 'home')` will test if given entity is specified state. + - `is_state_attr('device_tracker.paulus', 'battery', 40)` will test if given entity is specified state. - Filter `multiply(x)` will convert input to number and multiply it with `x` - Filter `round(x)` will convert input to number and round it to `x` decimals. diff --git a/source/images/supported_brands/free_mobile.png b/source/images/supported_brands/free_mobile.png index 579fd194ab3..7353cecb498 100644 Binary files a/source/images/supported_brands/free_mobile.png and b/source/images/supported_brands/free_mobile.png differ diff --git a/source/images/supported_brands/proliphix.png b/source/images/supported_brands/proliphix.png index 6dc3769f56e..d370d0b3222 100644 Binary files a/source/images/supported_brands/proliphix.png and b/source/images/supported_brands/proliphix.png differ diff --git a/source/images/supported_brands/telldus.png b/source/images/supported_brands/telldus.png new file mode 100644 index 00000000000..c3c42c51198 Binary files /dev/null and b/source/images/supported_brands/telldus.png differ