From 06f48c63a22102058f36cb7d8d97cb09bf965507 Mon Sep 17 00:00:00 2001 From: Travis CI Date: Wed, 5 Oct 2016 22:06:45 +0000 Subject: [PATCH] Site updated at 2016-10-05 22:06:45 UTC --- atom.xml | 2 +- blog/categories/community/atom.xml | 2 +- blog/categories/device-tracking/atom.xml | 2 +- blog/categories/esp8266/atom.xml | 2 +- blog/categories/how-to/atom.xml | 2 +- blog/categories/ibeacons/atom.xml | 2 +- blog/categories/internet-of-things/atom.xml | 2 +- blog/categories/iot-data/atom.xml | 2 +- blog/categories/micropython/atom.xml | 2 +- blog/categories/mqtt/atom.xml | 2 +- blog/categories/organisation/atom.xml | 2 +- blog/categories/owntracks/atom.xml | 2 +- blog/categories/presence-detection/atom.xml | 2 +- .../public-service-announcement/atom.xml | 2 +- blog/categories/release-notes/atom.xml | 2 +- blog/categories/survey/atom.xml | 2 +- blog/categories/talks/atom.xml | 2 +- blog/categories/technology/atom.xml | 2 +- blog/categories/user-stories/atom.xml | 2 +- blog/categories/video/atom.xml | 2 +- blog/categories/website/atom.xml | 2 +- developers/add_new_platform/index.html | 12 ++++---- sitemap.xml | 30 +++++++++---------- 23 files changed, 42 insertions(+), 42 deletions(-) diff --git a/atom.xml b/atom.xml index 6ac82bb8c8..17fd8e94e3 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index bf09f0955c..67e9347608 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 3cca7f2765..877cbc9cc4 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index b8254d5fee..cd19251a8d 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 69979c466d..cce8145cc5 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 3854507417..27b788c666 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+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 75d8829831..ca6dc4575c 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 649fca7947..1d3fdba9d3 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 2ccf0e9941..ae31419fd2 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index c12728018e..9676743625 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index 958d341e62..ddcedd00ea 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 7fdc67acc0..7b16b46569 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 538d6884a3..213c77819d 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+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 83cfb7f874..3749815cf4 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index edb7bd5e8f..964c94eef9 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index c877e898c0..9e972541c1 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index fee8df48ff..46e325a937 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index fda7de538c..1f1234b99b 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 7831fd9686..c515503ed6 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-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 31b8ed1664..ec5e48676e 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 4897ea7d80..a331998dc5 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2016-10-05T14:09:18+00:00 + 2016-10-05T22:05:02+00:00 https://home-assistant.io/ diff --git a/developers/add_new_platform/index.html b/developers/add_new_platform/index.html index 4d5e0c43f2..0c147153bc 100644 --- a/developers/add_new_platform/index.html +++ b/developers/add_new_platform/index.html @@ -89,11 +89,11 @@
-

Components that interact with devices are called “Entity Components”. They are structured in core- and platform logic. This allows the same logic to handle a light to be used by different brands.

+

Components that interact with devices are called “Entity Components.” They are structured in core and platform logic, which means different brands can use the same logic to handle a light.

-

For example, the built-in switch component consists of various platforms in homeassistant/components/switch/. The file __init__.py contains the core logic of all platform and the vendor_name.py files only the relevant platform code.

+

For example, the built-in switch component consists of various platforms in homeassistant/components/switch/. The file __init__.py contains the core logic of all platforms and the vendor_name.py files contain only the relevant platform code.

-

If you are planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you would like to add:

+

If you’re planning to add support for a new type of device to an existing component, you can get away with only writing platform logic. Have a look at how the component works with other platforms and create a similar file for the platform that you want to add:

  • Example sensor platform: hello world of platforms.
  • @@ -102,13 +102,13 @@

    Interfacing with devices

    -

    One of the rules for Home Assistant is that platform logic should never interface directly with devices but use a third-party Python 3 library to do so. This way Home Assistant is able to share code with the Python community and we can keep the project maintainable.

    +

    One Home Assistant rule is that platform logic should never interface directly with devices. Instead, use a third-party Python 3 library. This way, Home Assistant can share code with the Python community and keep the project maintainable.

    -

    To integrate the third-party library you create an Entity class for your device. Entities are Home Assistant’s representation of lights, switches, sensors, etc. and are derived from the Entity Abstract Class. This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.

    +

    To integrate the third-party library, create an Entity class for your device. Entities are Home Assistant’s representations of lights, switches, sensors, etc. and are derived from the Entity Abstract Class. This abstract class contains logic for integrating most standard features into your entities, such as visibility, entity IDs, updates, and much more.

    Requirements and dependencies

    -

    Platforms can specify dependencies and requirements the same way as a component does:

    +

    Platforms can specify dependencies and requirements the same way as components:

    REQUIREMENTS = ['some-package==2.0.0', 'some-other-package==2.5.0']
     DEPENDENCIES = ['mqtt']
    diff --git a/sitemap.xml b/sitemap.xml
    index 8d765a2c1c..fa0c3a8d45 100644
    --- a/sitemap.xml
    +++ b/sitemap.xml
    @@ -2113,62 +2113,62 @@
     
     
     https://home-assistant.io/demo/frontend.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/index.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-event.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-info.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-service.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-state.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-dev-template.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-history.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-iframe.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-logbook.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/demo/panels/ha-panel-map.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/googlef4f3693c209fe788.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00
     
     
     https://home-assistant.io/static/mdi-demo.html
    -2016-10-05T14:08:39+00:00
    +2016-10-05T22:04:11+00:00