Home Assistant Unofficial Reference 2024.12.1
homeassistant.components.mqtt.sensor Namespace Reference

Classes

class  MqttSensor
 

Functions

None async_setup_entry (HomeAssistant hass, ConfigEntry config_entry, AddEntitiesCallback async_add_entities)
 
ConfigType validate_sensor_state_and_device_class_config (ConfigType config)
 

Variables

 _LOGGER = logging.getLogger(__name__)
 
 _PLATFORM_SCHEMA_BASE
 
string CONF_EXPIRE_AFTER = "expire_after"
 
string CONF_LAST_RESET_VALUE_TEMPLATE = "last_reset_value_template"
 
string CONF_SUGGESTED_DISPLAY_PRECISION = "suggested_display_precision"
 
bool DEFAULT_FORCE_UPDATE = False
 
string DEFAULT_NAME = "MQTT Sensor"
 
 DISCOVERY_SCHEMA
 
 MQTT_SENSOR_ATTRIBUTES_BLOCKED
 
int PARALLEL_UPDATES = 0
 
 PLATFORM_SCHEMA_MODERN
 

Detailed Description

Support for MQTT sensors.

Function Documentation

◆ async_setup_entry()

None homeassistant.components.mqtt.sensor.async_setup_entry ( HomeAssistant  hass,
ConfigEntry  config_entry,
AddEntitiesCallback  async_add_entities 
)
Set up MQTT sensor through YAML and through MQTT discovery.

Definition at line 124 of file sensor.py.

◆ validate_sensor_state_and_device_class_config()

ConfigType homeassistant.components.mqtt.sensor.validate_sensor_state_and_device_class_config ( ConfigType  config)
Validate the sensor options, state and device class config.

Definition at line 81 of file sensor.py.

Variable Documentation

◆ _LOGGER

homeassistant.components.mqtt.sensor._LOGGER = logging.getLogger(__name__)
private

Definition at line 48 of file sensor.py.

◆ _PLATFORM_SCHEMA_BASE

homeassistant.components.mqtt.sensor._PLATFORM_SCHEMA_BASE
private
Initial value:
1 = MQTT_RO_SCHEMA.extend(
2  {
3  vol.Optional(CONF_DEVICE_CLASS): vol.Any(DEVICE_CLASSES_SCHEMA, None),
4  vol.Optional(CONF_EXPIRE_AFTER): cv.positive_int,
5  vol.Optional(CONF_FORCE_UPDATE, default=DEFAULT_FORCE_UPDATE): cv.boolean,
6  vol.Optional(CONF_LAST_RESET_VALUE_TEMPLATE): cv.template,
7  vol.Optional(CONF_NAME): vol.Any(cv.string, None),
8  vol.Optional(CONF_OPTIONS): cv.ensure_list,
9  vol.Optional(CONF_SUGGESTED_DISPLAY_PRECISION): cv.positive_int,
10  vol.Optional(CONF_STATE_CLASS): vol.Any(STATE_CLASSES_SCHEMA, None),
11  vol.Optional(CONF_UNIT_OF_MEASUREMENT): vol.Any(cv.string, None),
12  }
13 ).extend(MQTT_ENTITY_COMMON_SCHEMA.schema)

Definition at line 66 of file sensor.py.

◆ CONF_EXPIRE_AFTER

string homeassistant.components.mqtt.sensor.CONF_EXPIRE_AFTER = "expire_after"

Definition at line 52 of file sensor.py.

◆ CONF_LAST_RESET_VALUE_TEMPLATE

string homeassistant.components.mqtt.sensor.CONF_LAST_RESET_VALUE_TEMPLATE = "last_reset_value_template"

Definition at line 53 of file sensor.py.

◆ CONF_SUGGESTED_DISPLAY_PRECISION

string homeassistant.components.mqtt.sensor.CONF_SUGGESTED_DISPLAY_PRECISION = "suggested_display_precision"

Definition at line 54 of file sensor.py.

◆ DEFAULT_FORCE_UPDATE

bool homeassistant.components.mqtt.sensor.DEFAULT_FORCE_UPDATE = False

Definition at line 64 of file sensor.py.

◆ DEFAULT_NAME

string homeassistant.components.mqtt.sensor.DEFAULT_NAME = "MQTT Sensor"

Definition at line 63 of file sensor.py.

◆ DISCOVERY_SCHEMA

homeassistant.components.mqtt.sensor.DISCOVERY_SCHEMA
Initial value:
1 = vol.All(
2  _PLATFORM_SCHEMA_BASE.extend({}, extra=vol.REMOVE_EXTRA),
3  validate_sensor_state_and_device_class_config,
4 )

Definition at line 118 of file sensor.py.

◆ MQTT_SENSOR_ATTRIBUTES_BLOCKED

homeassistant.components.mqtt.sensor.MQTT_SENSOR_ATTRIBUTES_BLOCKED
Initial value:
1 = frozenset(
2  {
3  sensor.ATTR_LAST_RESET,
4  sensor.ATTR_STATE_CLASS,
5  }
6 )

Definition at line 56 of file sensor.py.

◆ PARALLEL_UPDATES

int homeassistant.components.mqtt.sensor.PARALLEL_UPDATES = 0

Definition at line 50 of file sensor.py.

◆ PLATFORM_SCHEMA_MODERN

homeassistant.components.mqtt.sensor.PLATFORM_SCHEMA_MODERN
Initial value:
1 = vol.All(
2  _PLATFORM_SCHEMA_BASE,
3  validate_sensor_state_and_device_class_config,
4 )

Definition at line 113 of file sensor.py.