Entidad sensor en Home Assistant

Un sensor es una entidad de solo lectura que proporciona cierta información. La información tiene un valor y, opcionalmente, una unidad de medida.

Esto es una novedad de la versión 2021.8 de Home Assistant

Propiedades

Las propiedades siempre solo deben devolver información de la memoria y no realizar E / S (como solicitudes de red). Implementar update()o async_update()recuperar datos.

Nombre	Escribe	Defecto	Descripción
estado	cuerda	Requerido	El valor del sensor.
device_class	cuerda	`None`	Tipo de sensor.
last_reset	`datetime.datetime`	`None`	El momento en que se inicializó un sensor de acumulación, como un medidor de uso de electricidad, un medidor de gas, un medidor de agua, etc. Si el momento de la inicialización es desconocida y el medidor no se restablece, listo para Unix Epoch 0: `homeassistant.util.dt.utc_from_timestamp(0)`. Tenga en cuenta que lo `datetime.datetime`devuelto por la `last_reset`propiedad se convertirá a una cadena con formato ISO 8601 cuando se actualicen los atributos de estado de la entidad. Al cambiar `last_reset`, `state`debe ser un número válido.
state_class	cuerda	`None`	Tipo de estado.
unidad de medida	cuerda	`None`	La unidad de medida en la que se expresa el sensor.

Clases de dispositivos disponibles

Si especifica una clase de dispositivo, su entidad de sensor también deberá devolver la unidad de medida correcta.

Escribe	Unidad	Descripción
batería	%	% de batería que queda.
dióxido de carbono	ppm	partes por millón de concentración de dióxido de carbono
monóxido de carbono	ppm	partes por millón de concentración de monóxido de carbono
humedad	%	% de humedad en el aire.
iluminancia	lx / lm	Nivel de luz.
Intensidad de señal	dB / dBm	Intensidad de señal.
la temperatura	° C / ° F	La temperatura.
marca de tiempo	ISO8601	Marca de tiempo.
poder	W, kW	Poder.
presión	hPa, mbar	Presión.
Actual	A	Actual.
energía	Wh, kWh	Energía.
Factor de potencia	%	Factor de potencia.
Voltaje	V	Voltaje.
monetario	ISO 4217	Valor monetario con moneda

Clases estatales disponibles

Escribe Descripción

medición El estado representa una medida en el tiempo presente , no una agregación histórica como las estadísticas o una predicción del futuro. Ejemplos de lo que se debe clasificar measurementson: temperatura actual, consumo de energía acumulado, costo acumulado. Ejemplos de lo que no debe clasificarse como measurement: temperatura prevista para mañana, consumo de energía de ayer o cualquier otra cosa que no incluya la medición actual .

Escribe	Descripción
medición	El estado representa una medida en el tiempo presente , no una agregación histórica como las estadísticas o una predicción del futuro. Ejemplos de lo que se debe clasificar `measurement`son: temperatura actual, consumo de energía acumulado, costo acumulado. Ejemplos de lo que no debe clasificarse como `measurement`: temperatura prevista para mañana, consumo de energía de ayer o cualquier otra cosa que no incluya la medición actual .

Estadísticas a largo plazo

Home Assistant tiene soporte para almacenar sensores como estadísticas a largo plazo si la entidad tiene las propiedades correctas. Un requisito para optar por las estadísticas es que el sensor se haya state_classconfigurado en measurement. Eso significa que el valor actual representa el valor actual.

Entidades medidas

Las entidades medidas tienen un valor que sigue aumentando hasta que se reinicia, como el consumo de energía o la producción. Para que Home Assistant rastree esta entidad, debe incluir una last_resetpropiedad .

Home Assistant hará un seguimiento del crecimiento durante el período de estadísticas para las entidades con medidor.

Entidades de valor

Home Assistant rastrea el valor mínimo, máximo y medio durante el período de estadísticas.

Todos los sensores con una unidad de medida de %se rastrean automáticamente. Otras entidades optan por participar en función de su device_class.