Artículo / Automatización
SCADA/HMI

Una vista de edificio que distingue apagado de no disponible

Relacioná entidades Home Assistant con habitaciones y componentes sin confundir un estado desconocido con una puerta cerrada o una luz apagada.

Publicado: · ING-MC LAB
Plano ilustrativo con luz apagada, temperatura y sensor de puerta no disponible.
Plano ilustrativo original, no una vivienda de un cliente. Los nombres de entidades son ejemplos didácticos.

Un plano muestra la puerta cerrada cuando su sensor inalámbrico deja de reportar. La imagen se ve ordenada, pero la conclusión es incorrecta. Una visualización útil debe distinguir una condición observada de una observación ausente, tanto en un plano 2D como en una casa 3D.

Empezá por la entidad, no por el color

Asociá el componente con un ID estable como light.office, no con su nombre amigable. Los nombres pueden cambiar o repetirse. Por cada asociación, definí dominio esperado, estados admitidos, atributos, unidades y criterio de disponibilidad.

Home Assistant conserva estado y atributos en un objeto. Su documentación de estados distingue unknown y unavailable de los estados ordinarios. El primero indica un valor no conocido; el segundo, que la entidad no puede proporcionarlo en ese momento. Ninguno equivale a off ni a un cero medido.

Definí un contrato pequeño para la vista

Para temperatura, transportá juntos valor, unidad y calidad. Un modelo de presentación ilustrativo puede ser:

{
  "componentId": "room-office",
  "entityId": "sensor.office_temperature",
  "value": 21.5,
  "unit": "°C",
  "quality": "valid"
}

Si la entidad deja de estar disponible, conservá el valor anterior únicamente con una indicación clara de “Última lectura”. No enviés 0 como relleno al renderer: cero grados es una condición real, no una marca de dato ausente.

Convertí explícitamente si la integración usa otra unidad. No apliqués el mismo rango de colores a °C y °F. Para una puerta, verificá el significado del dominio y su clase de dispositivo: una entrada numérica, una cerradura y un sensor de apertura no deben compartir una conversión booleana a ciegas.

Un valor estable puede seguir vigente

Home Assistant diferencia el momento en que cambió el estado del momento en que se actualizó o reportó. No usés solo “último cambio” para declarar vencida una temperatura estable. También importa cómo reporta la integración: algunos equipos publican únicamente cuando cambia el valor.

Elegí el criterio de disponibilidad según la integración, no mediante una edad universal. Un sensor a batería puede reportar poco; un medidor de energía muestreado con frecuencia requiere otra expectativa. Si el origen ya indica que la entidad no está disponible, respetá esa condición en vez de inferir salud porque se abrió una conexión recientemente.

Separá observación y comandos

Una vista de solo lectura puede mostrar estados sin ofrecer control. Si después se aprueba controlar, usá otra ruta autorizada y distinguí solicitud, aceptación y resultado observado. Cambiar el dibujo inmediatamente después de pulsar un botón no demuestra que se encendió la lámpara física.

No coloqués tokens Home Assistant en JavaScript público ni conectés el LAB abierto a una vivienda privada. Una integración futura necesita un límite de servidor revisado y permisos adecuados. Esta guía no publica una conexión real a un edificio.

Probá los casos incómodos

Comprobá off, on, unknown, unavailable, entidad ausente, texto de estado inesperado y cambio de unidad. Probá modificar solo un atributo mientras el estado principal permanece igual. Mostrá texto además de color para reconocer una lectura no disponible sin depender del tono.

En una escena 3D, asociá habitación o equipo con un ID estable y mové la tarjeta sin desplazar su ancla física. La guía de anotaciones explica esa separación. El render de una casa aporta valor cuando conserva correctamente el significado de sus estados.

Marcador de superficie asociado a J5 y tarjeta Vacuum_OK independiente unidos por una línea guía.
Artículo

Anotaciones 3D que siguen una junta del robot

Guardá el ancla de superficie en coordenadas de su nodo semántico y el desplazamiento de tarjeta por separado para que la articulación no desprenda la etiqueta.