Actualizado el 22 de enero de 2026
En el corazón de cualquier sistema de domótica, y especialmente en Home Assistant, se encuentra el concepto de entidad. Si te preguntas qué es una entidad en Home Assistant, piensa en ella como la representación digital de cualquier cosa que quieras monitorizar o controlar: una luz, un interruptor, una persona o, como veremos hoy, un sensor. Los sensores son, sin duda, los pilares sobre los que construimos la inteligencia de nuestro hogar, proporcionando los datos que alimentan nuestras automatizaciones.
Un sensor en Home Assistant es una entidad de solo lectura que nos proporciona información específica sobre el estado de algo. Esta información se compone de un valor (el estado o state) y, opcionalmente, una unidad de medida. Desde la temperatura de una habitación hasta el consumo eléctrico instantáneo de la casa, los sensores son nuestros ojos y oídos digitales.
Atributos Fundamentales de un Sensor en Home Assistant
Para crear y entender un sensor en Home Assistant, es crucial conocer sus propiedades o atributos. Estos definen no solo qué información muestra, sino también cómo se comporta y se visualiza en la interfaz. A diferencia de versiones antiguas, en 2026 es fundamental que estos atributos se obtengan de la memoria y no realicen operaciones de E/S (como llamadas a una red). Para la obtención de datos, se deben implementar las funciones update() o async_update() en el código de la integración.
Los principales atributos de un sensor en Home Assistant son:
| Nombre | Tipo | Descripción |
|---|---|---|
state | string | number | (Requerido) El valor actual del sensor. Puede ser un texto (ej: «Limpiando») o un número (ej: 21.5). |
unit_of_measurement | string | La unidad en la que se expresa el valor del sensor (ej: «°C», «W», «%»). Es vital para que Home Assistant interprete y grafique los datos correctamente. |
device_class | string | Define el tipo de sensor. Esto afecta directamente al icono que se muestra en la interfaz y al tipo de gráfico que se genera. |
state_class | string | Indica el tipo de valor que reporta el sensor. Es esencial para las estadísticas a largo plazo, permitiendo a Home Assistant realizar cálculos como medias, máximos o consumos acumulados. |
last_reset | datetime.datetime | Se usa en sensores acumulativos (como un contador de energía). Indica la última vez que el contador se puso a cero. Si nunca se reinicia, se debe establecer en la fecha de inicio de la era Unix: homeassistant.util.dt.utc_from_timestamp(0). |
La Importancia de device_class: Más que un Icono
Asignar una device_class correcta es uno de los pasos más importantes. No solo hace que tu panel de control sea más intuitivo (mostrando un termómetro para la temperatura o una gota para la humedad), sino que también informa a Home Assistant sobre la naturaleza del dato, permitiendo agrupaciones y visualizaciones más inteligentes.
Por ejemplo, un sensor con device_class: temperature y unit_of_measurement: '°C' se mostrará con un icono de termómetro y una gráfica de línea a lo largo del tiempo. Un sensor con device_class: power y unit_of_measurement: 'W' mostrará un rayo y también será candidato a incluirse en el panel de energía.
Estos son algunos de los tipos de sensores en Home Assistant más comunes definidos por su device_class en 2026:
| Device Class | Unidad de Medida | Descripción |
|---|---|---|
apparent_power | VA | Potencia aparente. |
aqi | Índice de Calidad del Aire. | |
battery | % | Porcentaje de batería restante. |
carbon_dioxide | ppm | Concentración de CO₂. |
carbon_monoxide | ppm | Concentración de CO. |
current | A | Corriente eléctrica. |
data_rate | bit/s, kbit/s, Mbit/s, etc. | Velocidad de datos. |
data_size | B, kB, MB, GB, etc. | Tamaño de datos. |
energy | Wh, kWh, MWh | Energía consumida o producida. |
gas | m³, ft³ | Volumen de gas. |
humidity | % | Humedad relativa. |
illuminance | lx, lm | Nivel de iluminancia. |
monetary | ISO 4217 (ej: EUR, USD) | Valor monetario con su divisa. |
power | W, kW | Potencia activa. |
power_factor | % | Factor de potencia. |
pressure | Pa, hPa, mbar, inHg | Presión atmosférica. |
signal_strength | dB, dBm | Intensidad de la señal. |
temperature | °C, °F | Temperatura. |
timestamp | ISO 8601 (ej: 2026-01-22T10:30:00+00:00) | Una fecha y hora específicas. |
voltage | V | Voltaje. |
water | L, gal, m³, ft³ | Volumen de agua. |
state_class: El Motor de las Estadísticas a Largo Plazo
Si quieres que Home Assistant almacene datos históricos de un sensor de forma eficiente y te muestre análisis detallados (mínimos, máximos, medias, sumas), es imprescindible definir su state_class.
| State Class | Descripción y Ejemplo de Uso |
|---|---|
measurement | Representa una medición puntual en el tiempo. No es una suma ni un total. Ideal para valores como la temperatura actual, la humedad, la potencia instantánea o la presión. Home Assistant guardará su valor y calculará medias, máximos y mínimos. |
total_increasing | Para sensores cuyo valor solo aumenta (o se reinicia a cero), como un contador de kWh de la compañía eléctrica, el total de agua consumida o los datos acumulados de una tarifa de internet. Home Assistant calculará el incremento en cada periodo. Requiere el atributo last_reset. |
total | Similar a total_increasing, pero el valor puede aumentar o disminuir. Un ejemplo podría ser la energía neta exportada a la red (que puede ser positiva si exportas y negativa si importas en un periodo). |
El Poder de la Personalización: Crear un Sensor de Plantilla (Template Sensor)
Una de las herramientas más potentes para crear un sensor en Home Assistant es, sin duda, la plataforma de plantillas (Templates). Esto te permite crear una nueva entidad de sensor a partir del estado o los atributos de otras entidades existentes. Las posibilidades son casi infinitas.
Imagina que tienes un sensor meteorológico que te da la temperatura como un atributo y no como el estado principal. Podrías querer extraer ese valor para usarlo más fácilmente en tus automatizaciones. Con una plantilla de sensor en Home Assistant, esto es muy sencillo. De hecho, tengo una guía completa sobre cómo crear un sensor a partir de un atributo que profundiza en este tema.
Desde las versiones más recientes de 2025, la forma recomendada de configurar estos sensores es a través de la clave template: en tu archivo configuration.yaml.
Ejemplo: Convertir Vatios (W) a Kilovatios (kW)
Supongamos que tienes un sensor sensor.consumo_total_casa_w que mide la potencia en vatios, pero prefieres verlo en kilovatios para el panel de energía.
# configuration.yaml
template:
- sensor:
- name: "Consumo Total Casa kW"
unique_id: consumo_total_casa_kw_template
state: "{{ (states('sensor.consumo_total_casa_w') | float(0) / 1000) | round(2) }}"
unit_of_measurement: "kW"
device_class: "power"
state_class: "measurement"
availability: "{{ states('sensor.consumo_total_casa_w') not in ['unknown', 'unavailable'] }}"
Este código crea un nuevo sensor llamado «Consumo Total Casa kW» que toma el valor del sensor original, lo divide por 1000, lo redondea a 2 decimales y le asigna los atributos correctos para su correcta visualización y almacenamiento histórico.
Preguntas Frecuentes (FAQ) sobre Sensores en Home Assistant
¿Cuál es la diferencia entre un sensor y un binary_sensor?
Es una duda muy común. La diferencia clave está en los valores que pueden tomar:
- Un sensor puede tener múltiples estados o un rango de valores numéricos (ej: 21.5, 500, «Cargando», «Nublado»).
- Un binary_sensor solo puede tener dos estados:
on(encendido, abierto, detectado, verdadero) ooff(apagado, cerrado, sin detectar, falso). Es ideal para sensores de puerta/ventana, detectores de movimiento o de presencia.
Mi sensor muestra el estado `unavailable` o `unknown`, ¿cómo lo soluciono?
El estado unavailable (no disponible) o unknown (desconocido) es un problema frecuente. En mi experiencia, las causas suelen ser:
- Problemas de Conectividad: El dispositivo físico (el sensor Zigbee, la bombilla WiFi, etc.) ha perdido la conexión con tu red o se ha quedado sin batería. Comprueba que el dispositivo esté online. Para dispositivos Zigbee, una buena red mallada con coordinadores potentes como el SMLIGHT SLZB-06 y extensores es clave.
- Fallo de la Integración: La integración que gestiona el sensor ha dejado de funcionar. Revisa los registros de Home Assistant (en Ajustes > Sistema > Registros) en busca de errores relacionados. A veces, un simple reinicio de la integración o de Home Assistant lo soluciona.
- Error en Plantilla: Si es un sensor de plantilla, la entidad de origen de la que extrae los datos podría estar en estado
unavailable. La propiedadavailabilityen la configuración de la plantilla, como mostré en el ejemplo anterior, es una buena práctica para gestionar esto. - Reinicio de Home Assistant: Es normal que, justo después de reiniciar, muchos sensores aparezcan como
unknownhasta que reciben su primera actualización de estado.
Conclusión
Dominar la entidad sensor en Home Assistant es fundamental para llevar tu domótica al siguiente nivel. Entender cómo funcionan sus atributos, especialmente device_class y state_class, no solo hará que tu interfaz sea más clara y útil, sino que también desbloqueará todo el potencial del registro de datos y las estadísticas a largo plazo. Ya sea utilizando los sensores que proporcionan tus integraciones o creando los tuyos propios con plantillas, son la base sobre la que construirás un hogar verdaderamente inteligente en 2026.