diff --git a/atom.xml b/atom.xml index 46b740d7c0..590d543d50 100644 --- a/atom.xml +++ b/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/announcements/atom.xml b/blog/categories/announcements/atom.xml index f61b8f8954..897e024e04 100644 --- a/blog/categories/announcements/atom.xml +++ b/blog/categories/announcements/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Announcements | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/community/atom.xml b/blog/categories/community/atom.xml index bb6dc5d1b9..ea0b445071 100644 --- a/blog/categories/community/atom.xml +++ b/blog/categories/community/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Community | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/device-tracking/atom.xml b/blog/categories/device-tracking/atom.xml index 3c119538ed..ae93baf156 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/esp8266/atom.xml b/blog/categories/esp8266/atom.xml index 1336607c11..9ae725c57e 100644 --- a/blog/categories/esp8266/atom.xml +++ b/blog/categories/esp8266/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: ESP8266 | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/how-to/atom.xml b/blog/categories/how-to/atom.xml index 89c3340faf..a4e9e22dd8 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/ibeacons/atom.xml b/blog/categories/ibeacons/atom.xml index cb3351bcb9..88e9681c11 100644 --- a/blog/categories/ibeacons/atom.xml +++ b/blog/categories/ibeacons/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: iBeacons | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+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 e724e4047c..a60aa058b3 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/iot-data/atom.xml b/blog/categories/iot-data/atom.xml index 10a1543aed..6547706455 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/media/atom.xml b/blog/categories/media/atom.xml index da3331e0cd..1cf5a615ad 100644 --- a/blog/categories/media/atom.xml +++ b/blog/categories/media/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Media | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/merchandise/atom.xml b/blog/categories/merchandise/atom.xml index 99f046e38b..64be4df572 100644 --- a/blog/categories/merchandise/atom.xml +++ b/blog/categories/merchandise/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Merchandise | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/micropython/atom.xml b/blog/categories/micropython/atom.xml index 3f071631b9..4ab32cd42c 100644 --- a/blog/categories/micropython/atom.xml +++ b/blog/categories/micropython/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Micropython | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/mqtt/atom.xml b/blog/categories/mqtt/atom.xml index 4401cde79c..7839443fca 100644 --- a/blog/categories/mqtt/atom.xml +++ b/blog/categories/mqtt/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: MQTT | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/organisation/atom.xml b/blog/categories/organisation/atom.xml index 842aec0379..0631178635 100644 --- a/blog/categories/organisation/atom.xml +++ b/blog/categories/organisation/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Organisation | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/owntracks/atom.xml b/blog/categories/owntracks/atom.xml index 92d7fd9eb3..1b3993f927 100644 --- a/blog/categories/owntracks/atom.xml +++ b/blog/categories/owntracks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: OwnTracks | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/presence-detection/atom.xml b/blog/categories/presence-detection/atom.xml index ed3793ee9d..88ef9d06e0 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+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 8252f9ec18..05b1f25957 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/release-notes/atom.xml b/blog/categories/release-notes/atom.xml index a8b6eabda3..a092a19d92 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/survey/atom.xml b/blog/categories/survey/atom.xml index 5bfcc38ec7..ecc75277af 100644 --- a/blog/categories/survey/atom.xml +++ b/blog/categories/survey/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Survey | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/talks/atom.xml b/blog/categories/talks/atom.xml index 0d11bfdc46..4ac5e318d1 100644 --- a/blog/categories/talks/atom.xml +++ b/blog/categories/talks/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Talks | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/technology/atom.xml b/blog/categories/technology/atom.xml index 626b531107..1c6fd67df7 100644 --- a/blog/categories/technology/atom.xml +++ b/blog/categories/technology/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Technology | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/user-stories/atom.xml b/blog/categories/user-stories/atom.xml index a9a80b147c..362c5191c2 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]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/video/atom.xml b/blog/categories/video/atom.xml index ee9611482f..73e06679d9 100644 --- a/blog/categories/video/atom.xml +++ b/blog/categories/video/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Video | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/blog/categories/website/atom.xml b/blog/categories/website/atom.xml index 397b0fc00b..1bcd103d5e 100644 --- a/blog/categories/website/atom.xml +++ b/blog/categories/website/atom.xml @@ -4,7 +4,7 @@ <![CDATA[Category: Website | Home Assistant]]> - 2017-12-16T12:45:02+00:00 + 2017-12-16T14:08:48+00:00 https://home-assistant.io/ diff --git a/components/sensor.mqtt/index.html b/components/sensor.mqtt/index.html index 5b208018cc..024398d5fc 100644 --- a/components/sensor.mqtt/index.html +++ b/components/sensor.mqtt/index.html @@ -82,15 +82,43 @@ state_topic: "home/bedroom/temperature" -

Configuration variables:

-
    -
  • state_topic (Required): The MQTT topic subscribed to receive sensor values.
    • -
  • name (Optional): The name of the sensor. Default is ‘MQTT Sensor’.
    • -
  • qos (Optional): The maximum QoS level of the state topic. Default is 0.
    • -
  • unit_of_measurement (Optional): Defines the units of measurement of the sensor, if any.
    • -
  • expire_after (Optional): Defines the number of seconds after the value expires if it’s not updated. Default is 0 (=never expire).
    • -
  • value_template (Optional): Defines a template to extract a value from the payload.
    • -
+
+

Configuration Variables

+
+
state_topic
+
+

(string)(Required)The MQTT topic subscribed to receive sensor values.

+
+
name
+
+

(string)(Optional)Name of the MQTT sensor.

+

Default value: MQTT Sensor

+
+
qos
+
+

(int)(Optional)The maximum QoS level of the state topic.

+

Default value: 0

+
+
unit_of_measurement
+
+

(string)(Optional)Defines the units of measurement of the sensor, if any.

+
+
expire_after
+
+

(int)(Optional)Defines the number of seconds after the value expires if it’s not updated.

+

Default value: 0

+
+
value_template
+
+

(template)(Optional)Defines a template to extract the value.

+
+
force_update
+
+

(boolean)Sends update events even if the value hasn’t changed. Useful if you want to have meaningful value graphs in history.

+

Default value: false

+
+
+

Examples

In this section you find some real life examples of how to use this sensor.

Get battery level

diff --git a/sitemap.xml b/sitemap.xml index 1887a2b4fe..9d49abfb0d 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -3750,7 +3750,7 @@ https://home-assistant.io/components/switch.hook/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/cookbook/automation_for_rainy_days/ @@ -4426,99 +4426,99 @@ https://home-assistant.io/docs/autostart/init.d/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/api/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/configuration/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/example_apps/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/installation/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/operation/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/reboot/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/running/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/tutorial/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/updating/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/appdaemon/windows/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/certificates/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/hadashboard/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/hass-configurator/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/ios/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/nginx/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/notebooks/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/scenegen/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/ecosystem/synology/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/tools/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/tools/dev-tools/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/tools/hass/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/docs/tools/scripts/ -2017-12-16T12:45:02+00:00 +2017-12-16T14:08:48+00:00 https://home-assistant.io/faq/after-upgrading/ @@ -5642,62 +5642,62 @@ https://home-assistant.io/demo/frontend.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/index.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-event.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-info.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-service.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-state.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-dev-template.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-history.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-iframe.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-logbook.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/demo/panels/ha-panel-map.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/googlef4f3693c209fe788.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/static/fonts/roboto/DESCRIPTION.en_us.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/static/fonts/robotomono/DESCRIPTION.en_us.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00 https://home-assistant.io/static/mdi-demo.html -2017-12-16T12:44:02+00:00 +2017-12-16T14:08:05+00:00