home-assistant.io/source/components/sensor.mqtt.markdown
2015-08-30 23:41:08 -07:00

948 B

layout, title, description, date, sidebar, comments, sharing, footer
layout title description date sidebar comments sharing footer
page MQTT Sensor support Instructions how to integrate MQTT sensors within Home Assistant. 2015-05-30 23:21 false false true true
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.
# Example configuration.yml entry
sensor:
  platform: mqtt
  name: "MQTT Sensor"
  state_topic: "home/bedroom/temperature"
  unit_of_measurement: "ºC"

state_topic: The MQTT topic subscribed to receive sensor values. Required

name: The name of the sensor. Default is 'MQTT Sensor'. Optional

unit_of_measurement: Defines the units of measurement of the sensor, if any. Optional