jeena/home-assistant.github.io
1
0
Fork 0
Code Issues Pull requests Projects Packages Wiki Activity Actions

Add 0.12 release blog post

Browse source
This commit is contained in:
Paulus Schoutsen 2016-01-30 00:27:38 -08:00
parent a4a1edf5bd
commit 4ed80fe2a0
16 changed files with 204 additions and 66 deletions
Download patch file Download diff file Expand all files Collapse all files

24
source/_components/automation.markdown
View file

@ -161,22 +161,30 @@ automation:
#### {% linkable_title Time trigger %}
Time can be triggered in many ways. The most common is to specify `after` and trigger at a specific point in time each day. Alternatively, you can also match if the hour, minute or second of the current time has a specific value. For example, by only setting minutes in the config to 5 it will trigger every hour when it is 5 minutes past whole. You cannot use `after` together with hour, minute or second.
Time can be triggered in many ways. The most common is to specify `after` and trigger at a specific point in time each day. Alternatively, you can also match if the hour, minute or second of the current time has a specific value. You can prefix the value with a `/` to match whenever the value is divisible by that number. You cannot use `after` together with hour, minute or second.
```yaml
automation:
trigger:
platform: time
# All following are optional.
# When 'after' is used, you cannot also match on hour, minute, seconds.
# Military time format.
# after: '15:32:00'
hours: 0
# Matches every hour at 5 minutes past whole
minutes: 5
seconds: 0
```
The above example will trigger every hour on the 5 (2:05, 3:05, 4:05, etc).
automation 2:
trigger:
platform: time
# When 'after' is used, you cannot also match on hour, minute, seconds.
# Military time format.
after: '15:32:00'
automation 3:
trigger:
platform: time
# You can also match on interval. This will match every 5 minutes
minutes: '/5'
seconds: 0
```
#### {% linkable_title Zone trigger %}

9
source/_components/binary_sensor.nest.markdown
View file

@ -1,7 +1,7 @@
---
layout: component
title: "Nest thermostat sensor"
description: "Instructions how to integrate Nest thermostats sensors within Home Assistant."
title: "Nest binary sensor"
description: "Instructions how to integrate Nest binary sensors within Home Assistant."
date: 2016-01-26 08:00
sidebar: true
comments: false
@ -12,7 +12,7 @@ ha_category: Binary Sensor
---
The `nest` binary sensor platform let you monitor various states of a thermostat from [Nest](https://nest.com).
The Nest binary sensor platform let you monitor various states of a thermostat from [Nest](https://nest.com).
To set it up, add the following information to your `configuration.yaml` file:
@ -35,5 +35,4 @@ Configuration variables:
- **monitored_conditions** array (*Required*): States to monitor.
You must have the [Nest Thermostat](https://home-assistant.io/components/thermostat.nest/) entity configured to use this sensor.
<p class='note'>You must have the [Nest component](https://home-assistant.io/components/nest/) configured to use this sensor.</p>

26
source/_components/device_tracker.owntracks.markdown
View file

@ -27,29 +27,29 @@ device_tracker:
There is no further configuration needed for tracking Owntracks devices.
#####Using Owntracks with other device trackers
### {% 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.
######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/)
### {% 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/)
Home Assistant will use the enter and leave messages to set your zone location. Your location will be set to the center of zone when you enter. Location updates from OwnTracks will be ignored while you are inside a zone.
Home Assistant will use the enter and leave messages to set your zone location. Your location will be set to the center of zone when you enter. Location updates from OwnTracks will be ignored while you are inside a zone.
When you exit a zone, Home Assistant will start using location updates to track you again. To make sure that Home Assistant correctly exits a zone (which it calculates based on your GPS co-ordinates), you may want to set your Zone radius in HA to be slightly smaller that the Owntracks region radius.
When you exit a zone, Home Assistant will start using location updates to track you again. To make sure that Home Assistant correctly exits a zone (which it calculates based on your GPS co-ordinates), you may want to set your Zone radius in HA to be slightly smaller that the Owntracks region radius.
#####Using Owntracks regions - forcing Owntracks to update using iBeacons
When run in the usual `significant changes mode` (which is kind to your phone battery), Owntracks sometimes doesn't update your location as quickly as you'd like when you arrive at a zone. This can be annoying if you want to trigger an automation when you get home. You can improve the situation using iBeacons.
### {% linkable_title Using Owntracks regions - forcing Owntracks to update using %}iBeacons
When run in the usual `significant changes mode` (which is kind to your phone battery), Owntracks sometimes doesn't update your location as quickly as you'd like when you arrive at a zone. This can be annoying if you want to trigger an automation when you get home. You can improve the situation using iBeacons.
iBeacons are simple bluetooth devices that send out an 'I'm here' message. They are supported by IOS and some Android devices. Owntracks explain more [here] (http://owntracks.org/booklet/guide/beacons/)
iBeacons are simple bluetooth devices that send out an "I'm here" message. They are supported by IOS and some Android devices. Owntracks explain more [here](http://owntracks.org/booklet/guide/beacons/)
When you enter an iBeacon region, Owntracks will send a `region enter` message to HA as described above. So if you want to have an event triggered when you arrive home, you can put an iBeacon outside your front door. If you set up an OwnTracks iBeacon region called `home` then getting close to the beacon will trigger an update to HA that will set your zone to be `home`.
When you exit an iBeacon region HA will switch back to using GPS to determine your location. Depending on the size of your zone, and the accuracy of your GPS location this may change your HA zone.
Sometimes Owntracks will lose connection with an iBeacon for a few seconds. If you name your beacon starting with `-` Owntracks will wait longer before deciding it has exited the beacon zone. HA will ignore the `-` when it matches the Owntracks region with Zones. So if you call your Owntracks region `-home` then HA will recognise it as `home`, but you will have a more stable iBeacon connection.
Sometimes Owntracks will lose connection with an iBeacon for a few seconds. If you name your beacon starting with `-` Owntracks will wait longer before deciding it has exited the beacon zone. HA will ignore the `-` when it matches the Owntracks region with Zones. So if you call your Owntracks region `-home` then HA will recognise it as `home`, but you will have a more stable iBeacon connection.
#####Using Owntracks iBeacons to track devices
iBeacons don't need to be stationary. You could put one on your key ring, or in your car.
### {% linkable_title Using Owntracks iBeacons to track devices %}
iBeacons don't need to be stationary. You could put one on your key ring, or in your car.
When your phone sees a mobile iBeacon that it knows about, it will tell HA the location of that iBeacon. If your phone moves while you are connected to the iBeacon, HA will update the location of the iBeacon. But when your phone loses the connection, HA will stop updating the iBeacon location.
@ -57,6 +57,6 @@ To use mobile iBeacons with HA, you just set up a region that doesn't match your
This allows you to write zone automations for devices that can't track themselves (for example `alert me if I leave the house and my keys are still at home`). Another example would be `open the gates if my car arrives home`.
#####Using mobile and fixed iBeacons together
You can use iBeacons of both types together, so if you have a Zone `drive` with an iBeacon region called `-drive` and you arrive home with a mobile iBeacon called '-car', then `device_tracker.beacon_car' will be set to a state of 'drive'.
### {% linkable_title Using mobile and fixed iBeacons together %}
You can use iBeacons of both types together, so if you have a Zone `drive` with an iBeacon region called `-drive` and you arrive home with a mobile iBeacon called `-car`, then `device_tracker.beacon_car` will be set to a state of `drive`.

30
source/_components/group.markdown
View file

@ -11,31 +11,15 @@ logo: home-assistant.png
ha_category: Organization
---
Groups allow the user to combine multiple entities into one.
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.
Check the **Set State** page from the **Developer Tools** and browse the **Current entities:** listing for all available entities.
```yaml
# Example configuration.yaml entry
group:
information:
- sensor.time
living_room:
- binary_sensor.tv
- sensor.living_room_temperature
kitchen:
- switch.kitchen_pin_3
- sensor.oven_temperature
```
With Home Assistant 0.12.0 a new feature **view** was introduced.
```yaml
# Example configuration.yaml entry
group:
kitchen:
name: Kitchen
view: no
entities:
- switch.kitchen_pin_3
upstairs:
@ -54,7 +38,12 @@ Configuration variables:
- **name** (*Optional*): Name of the group.
- **icon** (*Optional*): An optional icon to show in the Frontend.
- **view** (*Optional*): If yes then the entry will be shown as a view.
- **entities** array (*Required*): List of entites to group.
- **entities** array or comma delimited string (*Required*): List of entites to group.
<p class='img'>
<img src='/images/blog/2016-01-release-12/views.png'>
Example of groups shown as views in the frontend.
</p>
If all entities are switches or lights they can be controlled as one with a switch at the top of the card. Grouped states should share the same type of states (ON/OFF or HOME/NOT_HOME).
@ -65,8 +54,5 @@ group:
- light.bowl
- light.ceiling
- light.tv_back_light
children:
- device_tracker.child_1
- device_tracker.child_2
children: device_tracker.child_1, device_tracker.child_2
```

1
source/_components/insteon.markdown → source/_components/insteon_hub.markdown
View file

@ -26,4 +26,3 @@ Configuration variables:
- **username** (*Required*): The username that used to access the Insteon interface.
- **password** (*Required*): The password that used to access the Insteon interface.

27
source/_components/nest.markdown Normal file
View file

@ -0,0 +1,27 @@
---
layout: component
title: "Nest"
description: "Instructions how to integrate Nest into Home Assistant."
date: 2016-01-29 21:57
sidebar: true
comments: false
sharing: true
footer: true
logo: nest_thermostat.png
ha_category: Hub
featured: false
---
The Nest component is the main component to integrate all Nest related platforms. It will setup your thermostats and any connected sensors.
```yaml
# Example configurayion.yaml entry
nest:
username: USERNAME
password: PASSWORD
```
Configuration variables:
- **username** (*Required*): Your Nest username.
- **password** (*Required*): Your Nest password.

37
source/_components/notify.google_voice.markdown Normal file
View file

@ -0,0 +1,37 @@
---
layout: component
title: "Google Voice SMS"
description: "Instructions how to add user notifications to Home Assistant."
date: 2016-01-29
sidebar: true
comments: false
sharing: true
footer: true
logo: google_voice.png
ha_category: Notifications
featured: true
---
[Google Voice](https://www.google.com/voice) is a free service, that allows sending of SMS messages to mobile phones.
### Configuration
```yaml
# Example configuration.yaml entry
notify:
platform: googlevoice
username: YOUR_GOOGLE_EMAIL
password: YOUR_GOOGLE_PASSWORD
# Optional
name: NOTIFIER_NAME
```
Configuration variables:
- **username** (*Required*): Enter your the Google email address you have signed up for Google Voice with. Go to https://www.google.com/voice to setup your Google Voice account.
- **password** (*Required*): Enter the password associated with the above email. Go to https://www.pushbullet.com/ to retrieve your API key.
- **name** (*Optional*): Setting the optional parameter `name` allows multiple notifiers to be created. The default value is `notify`. The notifier will bind to the service `notify.NOTIFIER_NAME`.
### Usage
Google Voice is a notify platform and thus can be controlled by calling the notify service [as described here](/components/notify/). It will send a notification to all devices listed in the notification **target**.

12
source/_components/sensor.nest.markdown
View file

@ -1,7 +1,7 @@
---
layout: component
title: "Nest thermostat sensor"
description: "Instructions how to integrate Nest thermostats sensors within Home Assistant."
title: "Nest sensor"
description: "Instructions how to integrate Nest sensors within Home Assistant."
date: 2016-01-13 19:59
sidebar: true
comments: false
@ -12,7 +12,7 @@ ha_category: Sensor
---
The `nest` sensor platform let you monitor a thermostat from [Nest](https://nest.com). It also includes the ability to monitor things like the state of our HVAC system and the current humidity and temperature.
The Nest sensor platform let you monitor sensors connected to your [Nest](https://nest.com) thermostat.
To set it up, add the following information to your `configuration.yaml` file:
@ -36,8 +36,4 @@ Configuration variables:
- **monitored_conditions** array (*Required*): States to monitor.
You must have the [Nest Thermostat](https://home-assistant.io/components/thermostat.nest/) entity configured to use this sensor.
<p class='img'>
<img src='{{site_root}}/images/screenshots/nest-thermostat-card.png' />
</p>
<p class='note'>You must have the [Nest component](https://home-assistant.io/components/nest/) configured to use this sensor.</p>

11
source/_components/thermostat.nest.markdown
View file

@ -13,22 +13,17 @@ featured: true
---
The nest thermostat platform let you control a thermostat from [Nest](https://nest.com).
The Nest thermostat platform let you control a thermostat from [Nest](https://nest.com).
To set it up, add the following information to your `configuration.yaml` file:
```yaml
thermostat:
platform: nest
username: USERNAME
password: PASSWORD
```
Configuration variables:
- **username** (*Required*): Your Nest username.
- **password** (*Required*): Your Nest password.
<p class='img'>
<img src='{{site_root}}/images/screenshots/nest-thermostat-card.png' />
</p>
<p class='note'>You must have the [Nest component](https://home-assistant.io/components/nest/) configured to use this sensor.</p>