Site updated at 2017-10-29 00:07:46 UTC

This commit is contained in:
Travis CI 2017-10-29 00:07:47 +00:00
parent 065116d821
commit 17b5b61441
31 changed files with 161 additions and 109 deletions

View file

@ -4,7 +4,7 @@
<title><![CDATA[Home Assistant]]></title>
<link href="https://home-assistant.io/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Announcements | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/announcements/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Community | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/community/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Device-Tracking | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/device-tracking/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: ESP8266 | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/esp8266/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: How-To | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/how-to/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: iBeacons | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/ibeacons/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Internet-of-Things | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/internet-of-things/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: IoT-Data | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/iot-data/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Media | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/media/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Merchandise | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/merchandise/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Micropython | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/micropython/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: MQTT | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/mqtt/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Organisation | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/organisation/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: OwnTracks | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/owntracks/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Presence-Detection | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/presence-detection/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Public-Service-Announcement | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/public-service-announcement/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Release-Notes | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/release-notes/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Survey | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/survey/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Talks | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/talks/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Technology | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/technology/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: User-Stories | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/user-stories/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Video | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/video/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -4,7 +4,7 @@
<title><![CDATA[Category: Website | Home Assistant]]></title>
<link href="https://home-assistant.io/blog/categories/website/atom.xml" rel="self"/>
<link href="https://home-assistant.io/"/>
<updated>2017-10-28T23:36:19+00:00</updated>
<updated>2017-10-28T23:52:30+00:00</updated>
<id>https://home-assistant.io/</id>
<author>
<name><![CDATA[Home Assistant]]></name>

View file

@ -86,7 +86,7 @@
<ul>
<li><strong>max_gps_accuracy</strong> (<em>Optional</em>): Sometimes Owntracks can report GPS location with a very low accuracy (few kilometers). That can trigger false zoning in your Home Assistant installation. With the parameter, you can filter these GPS reports. The number has to be in meter. For example, if you put 200 only GPS report with an accuracy under 200 will be take in account.</li>
<li><strong>waypoints</strong> (<em>Optional</em>): Owntracks users can define <a href="http://owntracks.org/booklet/features/waypoints/">waypoints</a> (a.k.a regions) which are similar in spirit to Home Assistant zones. If this configuration variable is <code class="highlighter-rouge">True</code>, the Owntracks users who are in <code class="highlighter-rouge">waypoint_whitelist</code> can export waypoints from the device and Home Assistant will import them as zone definitions. Defaults to <code class="highlighter-rouge">True</code>.</li>
<li><strong>waypoint_whitelist</strong> (<em>Optional</em>): A list of user names (as defined for <a href="/components/device_tracker.owntracks/">Owntracks</a>) who can export their waypoints from Owntracks to Home Assistant. Defaults to all users who are connected to Home Assistant via Owntracks.</li>
<li><strong>waypoint_whitelist</strong> (<em>Optional</em>): A list of user names (as defined for <a href="/components/device_tracker.owntracks/">Owntracks</a>) who can export their waypoints from Owntracks to Home Assistant. This would be the <code class="highlighter-rouge">username</code> portion of the Base Topic Name, (e.g. owntracks/<strong>username</strong>/iPhone). Defaults to all users who are connected to Home Assistant via Owntracks.</li>
<li><strong>secret</strong> (<em>Optional</em>): <a href="http://owntracks.org/booklet/features/encrypt/">Payload encryption key</a>. This is usable when communicating with a third-party untrusted server or a public server (where anybody can subscribe to any topic). By default the payload is assumed to be unencrypted (although the communication between Home Assistant and the server might still be encrypted). This feature requires the <code class="highlighter-rouge">libsodium</code> library to be present.</li>
</ul>
<p>A full sample configuration for the <code class="highlighter-rouge">owntracks</code> platform is shown below:</p>

View file

@ -111,6 +111,7 @@
<li>U6300 (port must be set to 8001, and <code class="highlighter-rouge">pip3 install websocket-client</code> must be executed)</li>
<li>K6500AF (port must be set to 8001)</li>
<li>KS8005 (port must be set to 8001, and <code class="highlighter-rouge">pip3 install websocket-client</code> must be executed)</li>
<li>KS7502 (port must be set to 8001, and <code class="highlighter-rouge">pip3 install websocket-client</code> must be executed, turn on doesnt work, turn off works fine)</li>
<li>K5600AK (partially supported, turn on works but state is not updated)</li>
</ul>
<p>Currently tested but not working models:</p>

View file

@ -94,7 +94,7 @@
</code></pre>
</div>
<h3><a class="title-link" name="get-details-about-services-events-and-entitites" href="#get-details-about-services-events-and-entitites"></a> Get details about services, events, and entitites</h3>
<p>The output from this is similar to the output youd find via the frontend, using the DevTools console.</p>
<p>The output from this is similar to the output youd find via the frontend, using the <a href="/docs/tools/dev-tools/">Developer Tools</a>.</p>
<div class="language-python highlighter-rouge"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">homeassistant.remote</span> <span class="kn">as</span> <span class="nn">remote</span>
<span class="n">api</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">API</span><span class="p">(</span><span class="s">'127.0.0.1'</span><span class="p">,</span> <span class="s">'YOUR_PASSWORD'</span><span class="p">)</span>
@ -120,12 +120,11 @@
<div class="language-python highlighter-rouge"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">homeassistant.remote</span> <span class="kn">as</span> <span class="nn">remote</span>
<span class="n">api</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">API</span><span class="p">(</span><span class="s">'127.0.0.1'</span><span class="p">,</span> <span class="s">'YOUR_PASSWORD'</span><span class="p">)</span>
<span class="n">office_temperature</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="s">'sensor.office_temperature'</span><span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="s">'{} is {} {}.'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">office_temperature</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
<span class="n">office_temperature</span><span class="o">.</span><span class="n">state</span><span class="p">,</span>
<span class="n">office_temperature</span><span class="o">.</span><span class="n">attributes</span><span class="p">[</span><span class="s">'unit_of_measurement'</span><span class="p">]</span>
<span class="p">)</span>
<span class="p">)</span>
<span class="n">office_temp</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="s">'sensor.office_temperature'</span><span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="s">'{} is {} {}.'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
<span class="n">office_temp</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">office_temp</span><span class="o">.</span><span class="n">state</span><span class="p">,</span>
<span class="n">office_temp</span><span class="o">.</span><span class="n">attributes</span><span class="p">[</span><span class="s">'unit_of_measurement'</span><span class="p">])</span>
<span class="p">)</span>
</code></pre>
</div>
<p>This outputs the details which are stored for this entity, ie:</p>
@ -137,10 +136,9 @@
<span class="n">api</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">API</span><span class="p">(</span><span class="s">'127.0.0.1'</span><span class="p">,</span> <span class="s">'YOUR_PASSWORD'</span><span class="p">)</span>
<span class="n">switch_livingroom</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="s">'switch.livingroom_pin_2'</span><span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="s">'{} is {}.'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">switch_livingroom</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
<span class="n">switch_livingroom</span><span class="o">.</span><span class="n">state</span>
<span class="p">)</span>
<span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="s">'{} is {}.'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
<span class="n">switch_livingroom</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">switch_livingroom</span><span class="o">.</span><span class="n">state</span><span class="p">)</span>
<span class="p">)</span>
</code></pre>
</div>
<h3><a class="title-link" name="set-the-state-of-an-entity" href="#set-the-state-of-an-entity"></a> Set the state of an entity</h3>
@ -213,6 +211,49 @@ longer timeout.</p>
<span class="n">remote</span><span class="o">.</span><span class="n">call_service</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="n">domain</span><span class="p">,</span> <span class="s">'jabber'</span><span class="p">,</span> <span class="n">data</span><span class="p">)</span>
</code></pre>
</div>
<h2><a class="title-link" name="examples" href="#examples"></a> Examples</h2>
<p>This section contains a couple of sample scripts.</p>
<h3><a class="title-link" name="list-all-sensors-and-their-value" href="#list-all-sensors-and-their-value"></a> List all sensors and their value</h3>
<p>If you want to see, export or list all sensor states then an easy way to do it, is to get all entities and filter for the one you are looking for.</p>
<div class="language-python highlighter-rouge"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">homeassistant.remote</span> <span class="kn">as</span> <span class="nn">remote</span>
<span class="n">api</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">API</span><span class="p">(</span><span class="s">'127.0.0.1'</span><span class="p">,</span> <span class="s">'YOUR_PASSWORD'</span><span class="p">)</span>
<span class="n">entities</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">get_states</span><span class="p">(</span><span class="n">api</span><span class="p">)</span>
<span class="k">for</span> <span class="n">entity</span> <span class="ow">in</span> <span class="n">entities</span><span class="p">:</span>
<span class="k">if</span> <span class="n">entity</span><span class="o">.</span><span class="n">entity_id</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s">'sensor'</span><span class="p">):</span>
<span class="n">data</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="n">entity</span><span class="o">.</span><span class="n">entity_id</span><span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="s">'{}: {}'</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">data</span><span class="o">.</span><span class="n">attributes</span><span class="p">[</span><span class="s">'friendly_name'</span><span class="p">],</span> <span class="n">data</span><span class="o">.</span><span class="n">state</span><span class="p">))</span>
</code></pre>
</div>
<h3><a class="title-link" name="show-difference-between-last_changed-and-last_updated" href="#show-difference-between-last_changed-and-last_updated"></a> Show difference between <code class="highlighter-rouge">last_changed</code> and <code class="highlighter-rouge">last_updated</code></h3>
<p>The documentation about the <a href="/docs/configuration/state_object/">State Objects</a> describes the
<code class="highlighter-rouge">last_changed</code> and <code class="highlighter-rouge">last_updated</code> fields. This example shows how it works in practice.</p>
<div class="language-python highlighter-rouge"><pre class="highlight"><code><span class="kn">import</span> <span class="nn">time</span>
<span class="kn">from</span> <span class="nn">prettytable</span> <span class="kn">import</span> <span class="n">PrettyTable</span>
<span class="kn">import</span> <span class="nn">homeassistant.remote</span> <span class="kn">as</span> <span class="nn">remote</span>
<span class="n">api</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">API</span><span class="p">(</span><span class="s">'127.0.0.1'</span><span class="p">,</span> <span class="s">'YOUR_PASSWORD'</span><span class="p">)</span>
<span class="n">ACTIONS</span> <span class="o">=</span> <span class="p">{</span>
<span class="s">'Create sensor'</span><span class="p">:</span> <span class="p">[</span><span class="mi">21</span><span class="p">,</span> <span class="s">'Test'</span><span class="p">],</span>
<span class="s">'No new sensor value'</span><span class="p">:</span> <span class="p">[</span><span class="mi">21</span><span class="p">,</span> <span class="s">'Test'</span><span class="p">],</span>
<span class="s">'New sensor value'</span><span class="p">:</span> <span class="p">[</span><span class="mi">22</span><span class="p">,</span> <span class="s">'Test'</span><span class="p">],</span>
<span class="s">'Update attribute'</span><span class="p">:</span> <span class="p">[</span><span class="mi">22</span><span class="p">,</span> <span class="s">'Test1'</span><span class="p">],</span>
<span class="p">}</span>
<span class="n">output</span> <span class="o">=</span> <span class="n">PrettyTable</span><span class="p">([</span><span class="s">'Action'</span><span class="p">,</span> <span class="s">'Last changed'</span><span class="p">,</span> <span class="s">'Last updated'</span><span class="p">])</span>
<span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">ACTIONS</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
<span class="n">remote</span><span class="o">.</span><span class="n">set_state</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="s">'sensor.test'</span><span class="p">,</span> <span class="n">new_state</span><span class="o">=</span><span class="n">value</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span>
<span class="n">attributes</span><span class="o">=</span><span class="p">{</span><span class="s">'friendly_name'</span><span class="p">:</span> <span class="n">value</span><span class="p">[</span><span class="mi">1</span><span class="p">]})</span>
<span class="n">data</span> <span class="o">=</span> <span class="n">remote</span><span class="o">.</span><span class="n">get_state</span><span class="p">(</span><span class="n">api</span><span class="p">,</span> <span class="s">'sensor.test'</span><span class="p">)</span>
<span class="n">output</span><span class="o">.</span><span class="n">add_row</span><span class="p">([</span><span class="n">key</span><span class="p">,</span> <span class="n">data</span><span class="o">.</span><span class="n">last_changed</span><span class="p">,</span> <span class="n">data</span><span class="o">.</span><span class="n">last_updated</span><span class="p">])</span>
<span class="n">time</span><span class="o">.</span><span class="n">sleep</span><span class="p">(</span><span class="mi">2</span><span class="p">)</span>
<span class="k">print</span><span class="p">(</span><span class="n">output</span><span class="p">)</span>
</code></pre>
</div>
</article>
</div>
<aside id="sidebar" class="grid__item one-third lap-one-whole palm-one-whole">

View file

@ -99,7 +99,7 @@
</code></pre>
</div>
<p class="note">
You can append <code class="highlighter-rouge">?api_password=YOUR_PASSWORD</code> to any url to log in automatically.
You can append <code class="highlighter-rouge">?api_password=YOUR_PASSWORD</code> to any URL to log in automatically.
</p>
<p>Successful calls will return status code 200 or 201. Other status codes that can return are:</p>
<ul>
@ -124,33 +124,43 @@ You can append <code class="highlighter-rouge">?api_password=YOUR_PASSWORD</code
</div>
<h4><a class="title-link" name="get-apiconfig" href="#get-apiconfig"></a> GET /api/config</h4>
<p>Returns the current configuration as JSON.</p>
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"components"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
</span><span class="s2">"recorder"</span><span class="p">,</span><span class="w">
</span><span class="s2">"http"</span><span class="p">,</span><span class="w">
</span><span class="s2">"weather.openweathermap"</span><span class="p">,</span><span class="w">
</span><span class="s2">"api"</span><span class="p">,</span><span class="w">
</span><span class="s2">"websocket_api"</span><span class="p">,</span><span class="w">
</span><span class="s2">"frontend"</span><span class="p">,</span><span class="w">
</span><span class="s2">"sensor.time_date"</span><span class="p">,</span><span class="w">
</span><span class="s2">"sun"</span><span class="p">,</span><span class="w">
</span><span class="s2">"device_tracker"</span><span class="p">,</span><span class="w">
</span><span class="s2">"group"</span><span class="p">,</span><span class="w">
</span><span class="s2">"automation"</span><span class="w">
</span><span class="p">],</span><span class="w">
</span><span class="nt">"config_dir"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/home/ha/.homeassistant"</span><span class="p">,</span><span class="w">
</span><span class="nt">"elevation"</span><span class="p">:</span><span class="w"> </span><span class="mi">590</span><span class="p">,</span><span class="w">
</span><span class="nt">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">45.92</span><span class="p">,</span><span class="w">
</span><span class="nt">"location_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Home"</span><span class="p">,</span><span class="w">
</span><span class="nt">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">6.52</span><span class="p">,</span><span class="w">
</span><span class="nt">"time_zone"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Europe/Zurich"</span><span class="p">,</span><span class="w">
</span><span class="nt">"unit_system"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="nt">"length"</span><span class="p">:</span><span class="w"> </span><span class="s2">"km"</span><span class="p">,</span><span class="w">
</span><span class="nt">"mass"</span><span class="p">:</span><span class="w"> </span><span class="s2">"g"</span><span class="p">,</span><span class="w">
</span><span class="nt">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="s2">"\\u00b0C"</span><span class="p">,</span><span class="w">
</span><span class="nt">"volume"</span><span class="p">:</span><span class="w"> </span><span class="s2">"L"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="nt">"version"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.37.0.dev0"</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">"components"</span><span class="p">:[</span><span class="w">
</span><span class="s2">"sensor.cpuspeed"</span><span class="p">,</span><span class="w">
</span><span class="s2">"frontend"</span><span class="p">,</span><span class="w">
</span><span class="s2">"config.core"</span><span class="p">,</span><span class="w">
</span><span class="s2">"http"</span><span class="p">,</span><span class="w">
</span><span class="s2">"map"</span><span class="p">,</span><span class="w">
</span><span class="s2">"api"</span><span class="p">,</span><span class="w">
</span><span class="s2">"sun"</span><span class="p">,</span><span class="w">
</span><span class="s2">"config"</span><span class="p">,</span><span class="w">
</span><span class="s2">"discovery"</span><span class="p">,</span><span class="w">
</span><span class="s2">"conversation"</span><span class="p">,</span><span class="w">
</span><span class="s2">"recorder"</span><span class="p">,</span><span class="w">
</span><span class="s2">"group"</span><span class="p">,</span><span class="w">
</span><span class="s2">"sensor"</span><span class="p">,</span><span class="w">
</span><span class="s2">"websocket_api"</span><span class="p">,</span><span class="w">
</span><span class="s2">"automation"</span><span class="p">,</span><span class="w">
</span><span class="s2">"config.automation"</span><span class="p">,</span><span class="w">
</span><span class="s2">"config.customize"</span><span class="w">
</span><span class="p">],</span><span class="w">
</span><span class="nt">"config_dir"</span><span class="p">:</span><span class="s2">"/home/ha/.homeassistant"</span><span class="p">,</span><span class="w">
</span><span class="nt">"elevation"</span><span class="p">:</span><span class="mi">510</span><span class="p">,</span><span class="w">
</span><span class="nt">"latitude"</span><span class="p">:</span><span class="mf">45.8781529</span><span class="p">,</span><span class="w">
</span><span class="nt">"location_name"</span><span class="p">:</span><span class="s2">"Home"</span><span class="p">,</span><span class="w">
</span><span class="nt">"longitude"</span><span class="p">:</span><span class="mf">8.458853651</span><span class="p">,</span><span class="w">
</span><span class="nt">"time_zone"</span><span class="p">:</span><span class="s2">"Europe/Zurich"</span><span class="p">,</span><span class="w">
</span><span class="nt">"unit_system"</span><span class="p">:{</span><span class="w">
</span><span class="nt">"length"</span><span class="p">:</span><span class="s2">"km"</span><span class="p">,</span><span class="w">
</span><span class="nt">"mass"</span><span class="p">:</span><span class="s2">"g"</span><span class="p">,</span><span class="w">
</span><span class="nt">"temperature"</span><span class="p">:</span><span class="s2">"\u00b0C"</span><span class="p">,</span><span class="w">
</span><span class="nt">"volume"</span><span class="p">:</span><span class="s2">"L"</span><span class="w">
</span><span class="p">},</span><span class="w">
</span><span class="nt">"version"</span><span class="p">:</span><span class="s2">"0.56.2"</span><span class="p">,</span><span class="w">
</span><span class="nt">"whitelist_external_dirs"</span><span class="p">:[</span><span class="w">
</span><span class="s2">"/home/ha/.homeassistant/www"</span><span class="p">,</span><span class="w">
</span><span class="s2">"/home/ha/.homeassistant/"</span><span class="w">
</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>
@ -162,10 +172,10 @@ You can append <code class="highlighter-rouge">?api_password=YOUR_PASSWORD</code
<h4><a class="title-link" name="get-apidiscovery_info" href="#get-apidiscovery_info"></a> GET /api/discovery_info</h4>
<p>Returns basic information about the Home Assistant instance as JSON.</p>
<div class="language-json highlighter-rouge"><pre class="highlight"><code><span class="p">{</span><span class="w">
</span><span class="nt">"base_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://127.0.0.1:8123"</span><span class="p">,</span><span class="w">
</span><span class="nt">"base_url"</span><span class="p">:</span><span class="w"> </span><span class="s2">"http://192.168.0.2:8123"</span><span class="p">,</span><span class="w">
</span><span class="nt">"location_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Home"</span><span class="p">,</span><span class="w">
</span><span class="nt">"requires_api_password"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span><span class="w">
</span><span class="nt">"version"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.20.0.dev0"</span><span class="w">
</span><span class="nt">"version"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.56.2"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre>
</div>

View file

@ -77,7 +77,7 @@
<hr class="divider">
<p>By default, all of your devices will be visible and have a default icon determined by their domain. You can customize the look and feel of your front page by altering some of these parameters. This can be done by overriding attributes of specific entities.</p>
<p class="note">
Be careful not to forget to place <code class="highlighter-rouge">customize</code>, <code class="highlighter-rouge">customize_domain</code>, and <code class="highlighter-rouge">customize_glob</code> inside <code class="highlighter-rouge">homeassistant:</code> or it will fail.
If you implement <code class="highlighter-rouge">customize</code>, <code class="highlighter-rouge">customize_domain</code>, or <code class="highlighter-rouge">customize_glob</code> you must make sure it is done inside of <code class="highlighter-rouge">homeassistant:</code> or it will fail.
</p>
<div class="language-yaml highlighter-rouge"><pre class="highlight"><code><span class="s">homeassistant</span><span class="pi">:</span>
<span class="s">name</span><span class="pi">:</span> <span class="s">Home</span>

View file

@ -108,11 +108,11 @@
</tr>
<tr>
<td><code class="highlighter-rouge">state.last_updated</code></td>
<td>Time the state was written to the state machine. Note that writing the exact same state including attributes will not result in this field being updated. Example: <code class="highlighter-rouge">14:10:03 13-03-2016</code>.</td>
<td>Time the state was written to the state machine. Note that writing the exact same state including attributes will not result in this field being updated. Example: <code class="highlighter-rouge">2017-10-28 08:13:36.715874+00:00</code>.</td>
</tr>
<tr>
<td><code class="highlighter-rouge">state.last_changed</code></td>
<td>Time the state changed. This is not updated when there are only updated attributes. Example: <code class="highlighter-rouge">14:10:03 13-03-2016</code>.</td>
<td>Time the state changed. This is not updated when there are only updated attributes. Example: <code class="highlighter-rouge">2017-10-28 08:13:36.715874+00:00</code>.</td>
</tr>
<tr>
<td><code class="highlighter-rouge">state.attributes</code></td>

View file

@ -3542,7 +3542,7 @@
</url>
<url>
<loc>https://home-assistant.io/components/switch.hook/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/cookbook/automation_for_rainy_days/</loc>
@ -4210,99 +4210,99 @@
</url>
<url>
<loc>https://home-assistant.io/docs/autostart/init.d/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/api/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/configuration/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/example_apps/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/installation/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/operation/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/reboot/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/running/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/tutorial/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/updating/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/appdaemon/windows/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/certificates/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/hadashboard/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/hass-configurator/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/ios/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/nginx/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/notebooks/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/scenegen/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/ecosystem/synology/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/tools/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/tools/dev-tools/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/tools/hass/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/docs/tools/scripts/</loc>
<lastmod>2017-10-28T23:36:19+00:00</lastmod>
<lastmod>2017-10-28T23:52:30+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/faq/after-upgrading/</loc>
@ -5380,62 +5380,62 @@
</url>
<url>
<loc>https://home-assistant.io/demo/frontend.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/index.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-dev-event.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-dev-info.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-dev-service.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-dev-state.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-dev-template.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-history.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-iframe.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-logbook.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/demo/panels/ha-panel-map.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/googlef4f3693c209fe788.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
<url>
<loc>https://home-assistant.io/static/mdi-demo.html</loc>
<lastmod>2017-10-28T23:35:26+00:00</lastmod>
<lastmod>2017-10-28T23:51:36+00:00</lastmod>
</url>
</urlset>