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

Site updated at 2017-08-25 06:50:40 UTC

Browse source
This commit is contained in:
Travis CI 2017-08-25 06:50:40 +00:00
parent c86e94813a
commit e7b8b398f5
27 changed files with 57 additions and 48 deletions
Download patch file Download diff file Expand all files Collapse all files

21
components/device_tracker.tado/index.html
View file

@ -75,8 +75,7 @@
</header>
<hr class="divider">
<p>The <code class="highlighter-rouge">tado</code> device tracker is using the <a href="https://www.tado.com/">Tado Smart Thermostat</a> and it’s support for person presence detection based on smartphone location by geofencing.</p>
<p>This tracker uses the Tado API to determine if a mobile device is at home.
It tracks all devices in your home that Tado knows about.</p>
<p>This tracker uses the Tado API to determine if a mobile device is at home. It tracks all devices in your home that Tado knows about.</p>
<p>To use the Tado platform in your installation, add the following to your <code class="highlighter-rouge">configuration.yaml</code> file:</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example configuration.yaml entry for Tado</span>
<span class="s">device_tracker</span><span class="pi">:</span>
@ -94,12 +93,22 @@ It tracks all devices in your home that Tado knows about.</p>
</ul>
<p>After configuration, your device has to be at home at least once before showing up as <em>home</em> or <em>away</em>.
Polling Tado API for presence information will happen at most once every 30 seconds.</p>
<p>See the <a href="/components/device_tracker/">device tracker component page</a> for instructions how to configure the people to be tracked. Beware that the tado (v2) API does not provide GPS location of devices, only a bearing, therefore home assistant only uses home/not-home status.</p>
<p>See the <a href="/components/device_tracker/">device tracker component page</a> for instructions how to configure the people to be tracked. Beware that the Tado (v2) API does not provide GPS location of devices, only a bearing, therefore Home Assistant only uses <code class="highlighter-rouge">home</code>/<code class="highlighter-rouge">not-home</code> status.</p>
<h3><a class="title-link" name="finding-your-home_id" href="#finding-your-home_id"></a> Finding your <code class="highlighter-rouge">home_id</code></h3>
<p>Find your <code class="highlighter-rouge">home_id</code> by browsing to <code class="highlighter-rouge">https://my.tado.com/api/v2/me?username=YOUR_USERNAME&amp;password=YOUR_PASSWORD</code>. There you’ll see something like the following:</p>
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="nt">"name"</span><span class="p">:</span><span class="s2">"Mark"</span><span class="p">,</span><span class="nt">"email"</span><span class="p">:</span><span class="s2">"your@email.tld"</span><span class="p">,</span><span class="nt">"username"</span><span class="p">:</span><span class="s2">"your@email.tld"</span><span class="p">,</span><span class="w">
</span><span class="nt">"homes"</span><span class="p">:[{</span><span class="nt">"id"</span><span class="p">:</span><span class="mi">12345</span><span class="p">,</span><span class="nt">"name"</span><span class="p">:</span><span class="s2">"Home Sweet Home"</span><span class="p">}],</span><span class="nt">"locale"</span><span class="p">:</span><span class="s2">"en_US"</span><span class="p">,</span><span class="w">
</span><span class="nt">"mobileDevices"</span><span class="p">:[]}</span><span class="w">
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Mark"</span><span class="p">,</span><span class="w">
</span><span class="nt">"email"</span><span class="p">:</span><span class="w"> </span><span class="s2">"your@email.tld"</span><span class="p">,</span><span class="w">
</span><span class="nt">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"your@email.tld"</span><span class="p">,</span><span class="w">
</span><span class="nt">"homes"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
</span><span class="p">{</span><span class="w">
</span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="mi">12345</span><span class="p">,</span><span class="w">
</span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Home Sweet Home"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">],</span><span class="w">
</span><span class="nt">"locale"</span><span class="p">:</span><span class="w"> </span><span class="s2">"en_US"</span><span class="p">,</span><span class="w">
</span><span class="nt">"mobileDevices"</span><span class="p">:</span><span class="w"> </span><span class="p">[]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
<p>In this example <code class="highlighter-rouge">12345</code> is the <code class="highlighter-rouge">home_id</code> you’ll need to configure.</p>

6
components/notify.facebook/index.html
View file

@ -85,12 +85,12 @@
</div>
<p>Configuration variables:</p>
<ul>
<li><strong>page_access_token</strong> (<em>Required</em>): Access token for your facebook page. Checkout <a href="https://developers.facebook.com/docs/messenger-platform/guides/setup">Facebook Messenger Platform</a> for more information.</li>
<li><strong>page_access_token</strong> (<em>Required</em>): Access token for your Facebook page. Checkout <a href="https://developers.facebook.com/docs/messenger-platform/guides/setup">Facebook Messenger Platform</a> for more information.</li>
<li><strong>name</strong> (<em>Optional</em>): Setting the optional parameter <code class="highlighter-rouge">name</code> allows multiple notifiers to be created. The default value is <code class="highlighter-rouge">notify</code>. The notifier will bind to the service <code class="highlighter-rouge">notify.NOTIFIER_NAME</code>.</li>
</ul>
<h3><a class="title-link" name="usage" href="#usage"></a> Usage</h3>
<p>With Facebook notify service, you can send your notifications to your facebook messenger with help of your facebook page. You have to create a <a href="https://developers.facebook.com/docs/messenger-platform/guides/quick-start">Facebook Page and App</a> for this service. You can control it by calling the notify service <a href="/components/notify/">as described here</a>. It will send a message on messenger to user specified by <strong>target</strong> on behalf of your page. See the <a href="https://developers.facebook.com/docs/messenger-platform/guides/quick-start">quick start</a> guide for more information.
The phone number used in <strong>target</strong> should be registered with facebook messenger. Phone number of the recipient should be in +1(212)555-2368 format. If your app is not approved by facebook then the recipient should by either admin, developer or tester for your facebook app. <a href="https://developers.facebook.com/docs/messenger-platform/send-api-reference#phone_number">More…</a></p>
<p>With Facebook notify service, you can send your notifications to your Facebook messenger with help of your Facebook page. You have to create a <a href="https://developers.facebook.com/docs/messenger-platform/guides/quick-start">Facebook Page and App</a> for this service. You can control it by calling the notify service <a href="/components/notify/">as described here</a>. It will send a message on messenger to user specified by <strong>target</strong> on behalf of your page. See the <a href="https://developers.facebook.com/docs/messenger-platform/guides/quick-start">quick start</a> guide for more information.
The phone number used in <strong>target</strong> should be registered with Facebook messenger. Phone number of the recipient should be in +1(212)555-2368 format. If your app is not approved by Facebook then the recipient should by either admin, developer or tester for your Facebook app. <a href="https://developers.facebook.com/docs/messenger-platform/send-api-reference#phone_number">More information</a> about the phone number.</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="c1"># Example automation notification entry</span>
<span class="s">automation</span><span class="pi">:</span>
<span class="pi">-</span> <span class="s">alias</span><span class="pi">:</span> <span class="s">Evening Greeting</span>