diff --git a/atom.xml b/atom.xml index 4ed0fc227b..b8e3a3d834 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index c7bbced003..77adf58223 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 1e82b4b7ca..0b5dfca358 100644 --- a/blog/categories/device-tracking/atom.xml +++ b/blog/categories/device-tracking/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Device-Tracking | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index e1c8f8b726..171285c585 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 2162e072af..2489c7f796 100644 --- a/blog/categories/how-to/atom.xml +++ b/blog/categories/how-to/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: How-To | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index e38ff9a30f..c747d741b9 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/internet-of-things/atom.xml b/blog/categories/internet-of-things/atom.xml index 0d08c6c473..bad2dd7d99 100644 --- a/blog/categories/internet-of-things/atom.xml +++ b/blog/categories/internet-of-things/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Internet-of-Things | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 80d6bba5b7..231c378199 100644 --- a/blog/categories/iot-data/atom.xml +++ b/blog/categories/iot-data/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: IoT-Data | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 842b3dcefa..f5f2faf416 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 2e6e08a546..bc3063035c 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index d54188f01f..d32790546e 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 1e32a46ad3..b0b8df97d7 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 75c573dd25..5757b44753 100644 --- a/blog/categories/presence-detection/atom.xml +++ b/blog/categories/presence-detection/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Presence-Detection | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/public-service-announcement/atom.xml b/blog/categories/public-service-announcement/atom.xml index 952fdb2c58..b27821728d 100644 --- a/blog/categories/public-service-announcement/atom.xml +++ b/blog/categories/public-service-announcement/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Public-Service-Announcement | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 641f085f56..e564137350 100644 --- a/blog/categories/release-notes/atom.xml +++ b/blog/categories/release-notes/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Release-Notes | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index c65035f1d5..ba00dfdee8 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 11fdd2629f..42ae77a462 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 6f2f7a436d..b02c7ff8bb 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index d0b9377aae..cd2ffc7ca5 100644 --- a/blog/categories/user-stories/atom.xml +++ b/blog/categories/user-stories/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: User-Stories | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 77153511e5..5ea325d317 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 2346929a04..263dd3d09e 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2016-12-17T16:32:12+00:00 + 2016-12-17T16:35:11+00:00 https://home-assistant.io/ diff --git a/components/device_tracker.owntracks/index.html b/components/device_tracker.owntracks/index.html index daaf705213..777f6afaca 100644 --- a/components/device_tracker.owntracks/index.html +++ b/components/device_tracker.owntracks/index.html @@ -126,43 +126,54 @@

Using Owntracks with other device trackers

Owntracks can also be used with other device trackers, such as Nmap or Netgear. To do this, fill in the mac field to the Owntracks entry in known_devices.yaml with the MAC address of the device you want to track. This way the state of the device will be determined by the source that reported last. The naming convention for known device list is <username>_<device-id> and could be set in app configuration. More details about this config can found in device tracker.

-

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.

+

An example showing the inclusion of the mac field for multiple component tracking. The mac field will need to be added to the owntracks device and will enable tracking by all components that track via the mac address.

-

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.

+

```yaml

+_: + name: Friendly Name + mac: EA:AA:55:E7:C6:94 + picture: https://home-assistant.io/images/favicon-192x192.png + gravatar: test@example.com + track: yes + hide_if_away: no + ``` -

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 +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/). -

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.

+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. -

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.

+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 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.

+### 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. -

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.

+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/). -

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.

+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`. -

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 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. -

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.

+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. -

To use mobile iBeacons with HA, you just set up a region that doesn’t match your Zone names. If HA sees an entry event for a iBeacon region that doesn’t match a Zone name (say keys) - it will start tracking it, calling the device device_tracker.beacon_keys).

+### 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. -

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.

+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. -

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.

+To use mobile iBeacons with HA, you just set up a region that doesn't match your Zone names. If HA sees an entry event for a iBeacon region that doesn't match a Zone name (say `keys`) - it will start tracking it, calling the device `device_tracker.beacon_keys`). -

Importing Owntracks waypoints as zones

-

By default, any Owntracks user connected to Home Assistant can export their waypoint definitions (from the Export - Export to Endpoint menu item) which will then be translated to zone definitions in Home Assistant. The zones will be named <user>-<device> - <waypoint name>. This functionality can be controlled in 2 ways:

+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*. -
    -
  1. The configuration variable waypoints can be set to False which will disable importing waypoints for all users.
  2. -
  3. The configuration variable waypoint_whitelist can contain a list of users who are allowed to import waypoints.
  4. -
+### 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`. + +### Importing Owntracks waypoints as zones +By default, any Owntracks user connected to Home Assistant can export their waypoint definitions (from the *Export - Export to Endpoint* menu item) which will then be translated to zone definitions in Home Assistant. The zones will be named `- - `. This functionality can be controlled in 2 ways: + +1. The configuration variable `waypoints` can be set to `False` which will disable importing waypoints for all users. +2. The configuration variable `waypoint_whitelist` can contain a list of users who are allowed to import waypoints. +
diff --git a/components/device_tracker/index.html b/components/device_tracker/index.html index 463f201d96..c8430bbdd6 100644 --- a/components/device_tracker/index.html +++ b/components/device_tracker/index.html @@ -151,7 +151,7 @@ -

Multiple device trackers can be used in parallel, such as Owntracks and Nmap. The state of the device will be determined by the source that reported last.

+

Multiple device trackers can be used in parallel, such as Owntracks and Nmap. The state of the device will be determined by the source that reported last.

known_devices.yaml

diff --git a/components/group/index.html b/components/group/index.html index d67c556d4f..e7e79b180a 100644 --- a/components/group/index.html +++ b/components/group/index.html @@ -90,11 +90,11 @@
-

Groups allow the user to combine multiple entities into one. A group can be promoted to a view by setting the view option to yes. This will make the group available as a new tab in the frontend.

+

Groups allow the user to combine multiple entities into one. A group can be promoted to a view by setting view: yes under the group definition. This will make the group available as a new tab in the frontend.

Check the Set State page from the Developer Tools and browse the Current entities: listing for all available entities.

-

By default, every group appears in the HOME tab. If you name a group default_view it will REPLACE the contents of the HOME tab so you can customize it as you wish.

+

By default, every group appears in the HOME tab. If you create a group default_view it will REPLACE the contents of the HOME tab so you can customize the HOME tab as you wish.

# Example configuration.yaml entry
 group:
diff --git a/sitemap.xml b/sitemap.xml
index c0033c1599..9815f2c686 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2419,62 +2419,62 @@
 
 
 https://home-assistant.io/demo/frontend.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/index.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-event.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-info.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-service.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-state.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-dev-template.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-history.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-iframe.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-logbook.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/demo/panels/ha-panel-map.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/googlef4f3693c209fe788.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00
 
 
 https://home-assistant.io/static/mdi-demo.html
-2016-12-17T16:31:30+00:00
+2016-12-17T16:34:28+00:00