Devices (grupo BUILDING de la barra lateral) es donde se crea y se cablea cada widget de la instalación. Un dispositivo (widget) es lo que el residente ve y controla en la aplicación; detrás hay uno o varios objetos de comunicación: los valores individuales (estado de un interruptor, posición, temperatura, …) que se conectan con el mundo físico mediante un protocolo.
Qué necesitas: al menos una sala y una categoría (consulta «Building Structure & Categories»), el protocolo correspondiente activado (consulta «Services & Protocols») y una conexión para él (consulta «Connections»). El enlace específico de cada protocolo se describe por protocolo: KNX (consulta «KNX Integration»), Home Assistant (consulta «Home Assistant Integration»), Modbus (consulta «Modbus TCP Integration»), HTTP (consulta «HTTP Integration»), MQTT (consulta «MQTT Integration»), BACnet/IP (consulta «BACnet/IP Integration»), TCP/UDP (consulta «TCP/UDP Integration»), Sonos (consulta «Devices Library & Sonos Binding»).
💡 Consejo: Antes de cablear un dispositivo objeto por objeto, búscalo en la Devices Library (consulta «Devices Library & Sonos Binding»). Para un inversor, contador, cargador, relé o altavoz compatible, la biblioteca crea los widgets con todos los objetos ya enlazados: solo hay que escribir una dirección.
El espacio de trabajo Devices
La página tiene tres columnas:
- Columna izquierda: exploración. Filtra la lista de dispositivos por Rooms, Categories, Device Types o Protocols, cada uno con el número de dispositivos. La columna también ofrece accesos directos integrados: Add Room, Add Category, Add Floor, Add Protocol.
- Centro: la lista de dispositivos. Búsqueda, filtros y una fila por dispositivo. La cabecera de la página contiene un botón redondo con icono y sin texto (su información emergente dice Health; abre la página Health, consulta «Value Transformations & Health»), después Categories (gestionar categorías, consulta «Building Structure & Categories»), Add from library (la Devices Library, consulta «Devices Library & Sonos Binding») y Add Device.
- Columna derecha: Communication objects. El material de origen para enlazar, en dos pestañas: KNX muestra el árbol de direcciones de grupo (consulta «KNX Integration»), Home Assistant muestra las entidades (consulta «Home Assistant Integration»). La columna no depende del dispositivo seleccionado. Si está oculta, vuelve a abrirla con el botón Show communication objects junto al campo de búsqueda de dispositivos.

En cada fila de dispositivo puedes:
- Cambiar su icono: haz clic en la ficha de icono al principio de la fila.
- Activar o desactivar Visible in the app: ocultar un dispositivo sin eliminarlo (útil para dispositivos que solo alimentan lógica o registro).
- Abrir su Activity (consulta «Device Activity Log»).
- Edit Device: cambiar el nombre, la descripción, la sala, la categoría, el protocolo, el tipo o el subtipo. Lee la advertencia de «Widget types & sub-types» más abajo antes de cambiar el tipo o el subtipo.
- Show objects: desplegar la fila para mostrar los objetos de comunicación del dispositivo.
- Delete del dispositivo (con confirmación; no se puede deshacer).
Chips e iconos resumen la configuración de un vistazo. En la propia fila del dispositivo:
| Chip | Significado |
|---|---|
| Chip de protocolo | El protocolo (conexión) que usa el dispositivo. |
| NO GLOBAL | El dispositivo está excluido de los comandos globales (consulta «Alarm PIN & Global-Command Exclusions»). |
Despliega el dispositivo para ver el resto. Una leyenda sobre la lista de objetos nombra los cuatro iconos que pueden aparecer al final de cada fila de objeto:
| Legend | Significado |
|---|---|
| LOGGED | Un icono de base de datos: este objeto registra su histórico (consulta «Object Settings, Logging & Notifications»). |
| GRAFANA | Un botón de gráfico, solo en objetos registrados: abre el constructor de paneles de Grafana (consulta «Object Settings, Logging & Notifications»). |
| TRANSFORMS | El botón redondo que abre la cadena de transformación del objeto (consulta «Value Transformations & Health»). |
| SETTINGS | El engranaje que abre los ajustes del objeto (Edit Object, consulta «Object Settings, Logging & Notifications»). |
En un dispositivo de alarma, la tarjeta PIN CODE sobre los objetos muestra PIN SET o NO PIN (consulta «Alarm PIN & Global-Command Exclusions»).
Añadir un dispositivo
- Haz clic en Add Device.
- Introduce el Device Name.
- Elige el Type de widget y, donde aparezca un campo Subtype, el subtipo (consulta «Widget types & sub-types» más abajo).
- Elige un Icon y, opcionalmente, introduce una Description.
- Elige la Room y la Category.
- Elige el Protocol: es la conexión que usa el dispositivo (consulta «Connections»). Los tipos cámara, videoportero y vista web no tienen campo Protocol.
- Haz clic en Create Device.
El nuevo dispositivo tiene sus objetos, pero ninguno está enlazado todavía: un guion en la columna de enlace significa que el objeto no está conectado al equipo.
Para crear varios dispositivos similares a la vez, activa Add Multiple Devices (solo se ofrece al añadir un dispositivo, no al editarlo). En Additional Device Names, escribe el segundo nombre y haz clic en Add another device por cada nombre adicional. Se crea un dispositivo por nombre con los mismos ajustes; una línea vacía se omite y el cuadro de diálogo no comprueba si hay nombres duplicados. El botón pasa a ser Create Devices.

Widget types & sub-types
El Type de widget lo decide todo sobre un dispositivo: qué controles muestra la aplicación y qué objetos de comunicación existen. Los objetos se crean automáticamente a partir del tipo de dispositivo; nunca se añaden objetos a mano. Muchos tipos ofrecen un Subtype que varía el conjunto de controles. Para una persiana, SHUTTER tiene las lamas y BLIND solo la posición. La lista Type tiene un campo de búsqueda e imprime los nombres con mayúsculas iniciales, por ejemplo Analog Input y Analog Output.
Cada objeto tiene:
- una dirección: si el valor entra (del dispositivo a HyperVisu), sale (comandos al dispositivo) o ambas cosas;
- un tipo de dato: booleano, número, texto, etc.
Elige el tipo que corresponda a la función física, no al protocolo: una luz controlada por KNX y una luz de Home Assistant usan el mismo tipo de widget de luz. El catálogo completo de tipos, subtipos y sus objetos está en la referencia de tipos de widget (consulta «Widget Types Overview»).
⚠️ Advertencia: Elige con cuidado el tipo y el subtipo. Si más adelante cambias el Type o el Subtype en Edit Device, se sustituyen todos los objetos del dispositivo por los del nuevo tipo y se pierden todos los enlaces. El cuadro de diálogo no muestra ninguna advertencia ni pide confirmación. Cambiar el nombre, el icono, la sala o la categoría conserva los objetos.