update header

This commit is contained in:
sfam 2015-08-20 23:05:51 +01:00
parent c5db42677a
commit 44263752ca

View File

@ -4,7 +4,10 @@ homeassistant.components.sensor.mqtt
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Allows to configure a MQTT sensor. Allows to configure a MQTT sensor.
This generic sensor implementation uses the MQTT message payload as the sensor value. This generic sensor implementation uses the MQTT message payload
as the sensor value. If messages in this state_topic are published
with RETAIN flag, the sensor will receive an instant update with
last known value. Otherwise, the initial state will be undefined.
sensor: sensor:
platform: mqtt platform: mqtt
@ -20,7 +23,7 @@ The name of the sensor. Default is 'MQTT Sensor'.
state_topic state_topic
*Required *Required
The MQTT topic subscribed to receive sensor values. The MQTT topic subscribed to receive sensor values.
unit_of_measurement unit_of_measurement
*Optional *Optional
@ -38,17 +41,18 @@ DEFAULT_NAME = "MQTT Sensor"
DEPENDENCIES = ['mqtt'] DEPENDENCIES = ['mqtt']
# pylint: disable=unused-argument # pylint: disable=unused-argument
def setup_platform(hass, config, add_devices_callback, discovery_info=None): def setup_platform(hass, config, add_devices_callback, discovery_info=None):
""" Add MQTT Sensor """ """ Add MQTT Sensor """
if config.get('state_topic') is None: if config.get('state_topic') is None:
_LOGGER.error("Missing required variable: state_topic") _LOGGER.error("Missing required variable: state_topic")
return False return False
add_devices_callback([MqttSensor( add_devices_callback([MqttSensor(
hass, hass,
config.get('name',DEFAULT_NAME), config.get('name', DEFAULT_NAME),
config.get('state_topic'), config.get('state_topic'),
config.get('unit_of_measurement'))]) config.get('unit_of_measurement'))])
@ -86,4 +90,4 @@ class MqttSensor(Entity):
@property @property
def state(self): def state(self):
""" Returns the state of the entity. """ """ Returns the state of the entity. """
return self._state return self._state