diff --git a/atom.xml b/atom.xml index be29644897..7cd2bee17c 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index ae8c703cb1..4c0eacd3b8 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 5f6061dd4c..c14add9e0a 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index b834766ba4..e948aaeb96 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 58ff22659a..7bd22a05e5 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index 718e913b0f..d98e649c3f 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+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 78779aa5b4..0581ec4486 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index ed9d2de6a4..e26670d40e 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 10cb59cc0f..bd40d1c797 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 0b3ee0e9c0..ac16ffb5f5 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index ecbd51a942..85fcc73ea8 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index c168e62118..e474eddcab 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index 97b441f70f..e82ed64807 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+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 552fa2313c..a44ae840ee 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index 260d08ba37..d32d088e43 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index 92f2e78b21..b0c82042cf 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 434d0e4df9..590aa7d8bd 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 0cf9caad66..39ed84fc16 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index 8141a9fb4f..d349786d03 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-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index 2baccafb8e..9b0e1c2642 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index e9b47ab507..a9a448a910 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2016-12-27T12:31:45+00:00 + 2016-12-27T19:34:07+00:00 https://home-assistant.io/ diff --git a/components/lock.mqtt/index.html b/components/lock.mqtt/index.html index b133ecae53..b98903aa80 100644 --- a/components/lock.mqtt/index.html +++ b/components/lock.mqtt/index.html @@ -148,7 +148,7 @@ Make sure that your topic match exact. some-topi -

Keep an eye on ratining messages to keep the state as you don’t want to unlock your door by accident when you restart something.

+

Keep an eye on retaining messages to keep the state as you don’t want to unlock your door by accident when you restart something.

For a check you can use the command line tools mosquitto_pub shipped with mosquitto to send MQTT messages. This allows you to operate your lock manually:

diff --git a/components/switch.mqtt/index.html b/components/switch.mqtt/index.html index 7e8576f238..6e0afeca14 100644 --- a/components/switch.mqtt/index.html +++ b/components/switch.mqtt/index.html @@ -92,9 +92,9 @@

The mqtt switch platform let you control your MQTT enabled switch.

-

In an ideal scenario, the MQTT device will have a state topic to publish state changes. If these messages are published with RETAIN flag, the MQTT switch will receive an instant state update after subscription and will start with correct state. Otherwise, the initial state of the switch will be false/off.

+

In an ideal scenario, the MQTT device will have a state_topic to publish state changes. If these messages are published with RETAIN flag, the MQTT switch will receive an instant state update after subscription and will start with correct state. Otherwise, the initial state of the switch will be false/off.

-

When a state topic is not available, the switch will work in optimistic mode. In this mode, the switch will immediately change state after every command. Otherwise, the switch will wait for state confirmation from device (message from state_topic).

+

When a state_topic is not available, the switch will work in optimistic mode. In this mode, the switch will immediately change state after every command. Otherwise, the switch will wait for state confirmation from device (message from state_topic).

Optimistic mode can be forced, even if state topic is available. Try to enable it, if experiencing incorrect switch operation.

@@ -115,7 +115,7 @@
  • command_topic (Required): The MQTT topic to publish commands to change the switch state.
  • payload_on (Optional): The payload that represents enabled state. Default is “ON”.
  • payload_off (Optional): The payload that represents disabled state. Default is “OFF”.
  • -
  • optimistic (Optional): Flag that defines if switch works in optimistic mode. Default is true if no state topic defined, else false.
  • +
  • optimistic (Optional): Flag that defines if switch works in optimistic mode. Default is true if no state_topic defined, else false.
  • qos (Optional): The maximum QoS level of the state topic. Default is 0 and will also be used to publishing messages.
  • retain (Optional): If the published message should have the retain flag on or not.
  • value_template (Optional): Defines a template to extract a value from the payload.
  • @@ -147,7 +147,7 @@ Make sure that your topic match exact. some-topi -

    For a check you can use the command line tools mosquitto_pub shipped with mosquitto to send MQTT messages. This allows you to operate your cover manually:

    +

    For a check you can use the command line tools mosquitto_pub shipped with mosquitto to send MQTT messages. This allows you to operate your switch manually:

    $  mosquitto_pub -h 127.0.0.1 -t home/bedroom/switch1set -m "ON"
     
    diff --git a/cookbook/python_component_basic_state/index.html b/cookbook/python_component_basic_state/index.html index 0921c6f2b4..61c26ead51 100644 --- a/cookbook/python_component_basic_state/index.html +++ b/cookbook/python_component_basic_state/index.html @@ -184,22 +184,20 @@ The component will only write a log message. Keep in mind for later that you hav
    -

    Thanks to DEFAULT_TEXT variable the component will launch even if no text: field is used in the configuration.yaml file. Quite often there are variables which are required. It’s important to check if all mandatory configuration variables are provided. If not, the setup should fail. We will use the validate_config function as a helper to achive this. The next listing shows the essential parts.

    +

    Thanks to DEFAULT_TEXT variable the component will launch even if no text: field is used in the configuration.yaml file. Quite often there are variables which are required. It’s important to check if all mandatory configuration variables are provided. If not, the setup should fail. We will use voluptuous as a helper to achive this. The next listing shows the essential parts.

    -
    from homeassistant.helpers import validate_config
    +
    import voluptuous as vol
    +
    +import homeassistant.helpers.config_validation as cv
     [...]
    -    if not validate_config(config, {DOMAIN: [CONF_TEXT]}, _LOGGER):
    -        return False
    +PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({
    +    vol.Required(CONF_TEXT): cv.string,
    +})
     

    If text: is missing, there will be a warning in the log file.

    -
    16-03-12 14:37:37 ERROR (MainThread) [custom_components.hello_state] Missing required configuration items in hello_state: text
    -16-03-12 14:37:37 ERROR (MainThread) [homeassistant.bootstrap] component hello_state failed to initialize
    -
    -
    -

    After a start or a restart of Home Assistant the component will be visible in the frontend if the configuration.yaml file is up-to-date.

    diff --git a/sitemap.xml b/sitemap.xml index d6af1c2f1e..0ac4406da5 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -2499,62 +2499,62 @@ https://home-assistant.io/demo/frontend.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/index.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00 https://home-assistant.io/static/mdi-demo.html -2016-12-27T12:30:53+00:00 +2016-12-27T19:33:24+00:00