Saltar al contenido
Elausys

HyperVisu / Configuración del dispositivo

Biblioteca de dispositivos y vinculación Sonos

Cree widgets vinculados listos para usar desde un catálogo de inversores, contadores, cargadores, relés y altavoces, y vincule zonas Sonos.

elausys · 21 julio 2026
En esta página

La biblioteca de dispositivos

La biblioteca de dispositivos es un catálogo de plantillas de dispositivos listas para usar correspondientes a equipos previamente asignados: contadores de energía, inversores solares, baterías domésticas, cargadores de VE, relés inteligentes, reproductores multimedia y altavoces Sonos. Seleccione el modelo, complete un par de campos (normalmente poco más que la dirección del dispositivo) y la biblioteca creará los widgets con todos sus objetos de comunicación vinculados: registros, topics, rutas, tipos de datos, escalado y unidades incluidos. Un trabajo que de otro modo requeriría una tarde con el manual de registros se completa en un minuto.

Ábrala desde Dispositivos → Añadir desde la biblioteca.

Requisitos: el dispositivo accesible en la red con una dirección fija (reserva DHCP), la opción requerida activada en su propia configuración (Modbus TCP viene desactivado por defecto en la mayoría de inversores) y el protocolo habilitado en Servicios (consulte «Servicios y protocolos»).

Cada plantilla es una tarjeta que muestra la marca, el modelo, el distintivo del protocolo y una descripción breve. Filtre la lista mediante:

  • el campo de búsqueda: marca, modelo, nombre del dispositivo o descripción; el contador situado a la derecha muestra coincidentes / total;
  • los selectores de categoría: uno por cada categoría presente en el catálogo (actualmente Iluminación, Protección solar, Energía y Audio / Vídeo);
  • los menús desplegables Marca y Protocolo.
El catálogo de la biblioteca de dispositivos: búsqueda con contador coincidentes/total, selectores de categoría, filtros de marca y protocolo, y las tarjetas de plantillas.

Cobertura de la biblioteca. El catálogo se incluye con el servidor y se amplía con cada actualización. Actualmente contiene 83 plantillas de 49 marcas:

Familia de dispositivosMarcas cubiertas
Inversores solares e híbridosSMA · Huawei (SUN2000) · SolarEdge · Sungrow · GoodWe · Growatt · FoxESS · Solax · Deye · SAJ · SofarSolar · Solplanet · Solinteg · SolarMax · M-TEC · Senergy · IBC Solar · Anker (SOLIX X1) · EcoFlow (PowerOcean)
Baterías y almacenamientoMarstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE)
Gestores energéticos y dataloggersHuawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog
Contadores de energíaHomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S)
Cargadores de VEKEBA · Mennekes · Schneider (EVlink Pro) · Phoenix Contact (CHARX, EM-CP-PP-ETH, EV-SER) · Heidelberg · go-e · Bender · Peblar · EM2GO · OBO Bettermann · openWB · Stark in Strom
Relés de iluminación y persianasShelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 persiana)
Audio / vídeoSonos (cualquier zona) · AUDAC (XMP44)

La mayoría de los dispositivos de energía se comunican mediante Modbus TCP. Las unidades Shelly se ofrecen tanto por HTTP como por MQTT (dos tarjetas disponibles; elija la que coincida con la configuración del dispositivo). HomeWizard utiliza HTTP, AUDAC TCP/UDP, y Sonos su propio protocolo (consulte «Integración de Sonos»).

📘 Nota: Una plantilla cubre una familia de productos, no una referencia individual: la plantilla de Sonos es válida para cualquier zona, y la plantilla Shelly Plus 1 sirve para el 1 y el 1PM. En los casos en que el fabricante ha modificado el mapa de registros entre generaciones, estas se presentan en tarjetas independientes (Shelly Gen1 y Shelly Plus).

Crear un dispositivo desde una plantilla

  1. Haga clic en la tarjeta de la plantilla. Se abrirá la página de configuración con la descripción de la plantilla y, si procede, el panel Requisitos de configuración. Léalo primero: detalla los requisitos previos en el dispositivo (cuenta de instalador, opción Modbus que se debe activar o un inversor con respuesta lenta que requiere un intervalo de lectura superior).
  2. Introduzca el Nombre del dispositivo. Se utiliza como prefijo en cada widget creado por la plantilla; por ejemplo, «Garaje» generará «Garaje — Red», «Garaje — Solar», etc.
  3. Complete los parámetros de la plantilla necesarios para los propios widgets: ID de unidad Modbus, variante del modelo en el desplegable o la zona Sonos. El formulario no solicita la dirección IP: esta se gestiona en la conexión y se introduce en el paso 4.
  4. Abra Conexión. La lista solo muestra las conexiones compatibles con el protocolo de la plantilla. Seleccione la conexión de este dispositivo o, para equipos con dirección propia (un inversor, un wallbox o un altavoz), seleccione Crear una nueva conexión…: se abrirá el diálogo Añadir una conexión con el protocolo y el nombre predefinidos. Introduzca allí la dirección IP del dispositivo y haga clic en Crear conexión; la nueva conexión quedará seleccionada sin necesidad de ir antes a la página Conexiones. Si ya existe una conexión asociada a esa dirección, la biblioteca lo indicará y la reutilizará en lugar de duplicarla. Las plantillas para infraestructura compartida (como un broker MQTT) seleccionan por defecto la conexión existente.
  5. Seleccione la Estancia y la Categoría de destino para los widgets. Ambos campos son obligatorios.
  6. El panel Widgets que se crearán muestra una vista previa interactiva del resultado.
La página de configuración de una plantilla de inversor: parámetros, conexión, estancia y categoría, los requisitos de configuración desplegados y la vista previa interactiva.

La vista previa y opciones editables

Cada widget en la vista previa muestra su nombre, tipo de widget y el contador N / M objetos vinculados. La plantilla define qué widgets aparecen marcados por defecto, habitualmente los presentes en cualquier instalación. El resto se muestran desmarcados al depender de hardware adicional: la plantilla de Huawei marca el contador solar y deja desmarcados los contadores de red y batería para activarlos cuando se instale el Smart Power Sensor. Revise los requisitos de configuración y marque solo los elementos realmente instalados. Antes de la creación definitiva es posible:

  • marcar o desmarcar cada widget (una instalación exclusivamente solar no requiere crear la batería);
  • renombrar un widget directamente en la lista;
  • desplegar el contador de objetos para examinar cada objeto: número, nombre, dirección asignada y tipo de datos. Los objetos que la plantilla deja sin asignar de forma deliberada muestran sin dirección.

Si falta algún parámetro o está fuera de rango, un mensaje en rojo sustituirá la lista de widgets indicando el campo que debe corregirse; el botón de creación permanecerá desactivado hasta que se resuelva.

Haga clic en Crear N widget(s). La página de resultados indicará los elementos creados con su recuento de objetos, los errores y su causa, y ofrecerá Añadir otro dispositivo para volver a utilizar la biblioteca. Este es el procedimiento habitual en viviendas con Sonos o sistemas multizona, aplicando la misma plantilla una vez por zona.

📘 Nota: Los widgets quedan guardados pero aún no están operativos. Haga clic en Aplicar cambios en la barra lateral y luego confirme en el diálogo Aplicar cambios de configuración (consulte «Recorrido por el panel de administración») para reiniciar los protocolos y enviar la configuración a todos los clientes.

Página de resultados tras la creación desde una plantilla, con los recuentos de objetos y el aviso Aplicar cambios activo.

Tras la creación

A partir de ese momento, los widgets funcionan como dispositivos convencionales: puede renombrarlos, cambiar iconos, moverlos de estancia, activar el registro de datos y utilizarlos en vistas, escenas y automatizaciones. Las vinculaciones son igualmente editables: abra cualquier objeto y modifíquelo como uno creado manualmente (consulte «Integración Modbus TCP», «Integración MQTT»).

Los contadores creados mediante plantillas de energía se configuran automáticamente con su función (red, solar, batería, cargador o consumo), lo que permite que la sección de Energía y el balance energético funcionen sin ajustes adicionales (consulte «Dispositivos de energía», «Visión general de energía»).

Importar y exportar plantillas

La biblioteca permite utilizar plantillas personalizadas: archivos .yaml o .yml de un máximo de 256 KB, con el mismo formato que las integradas en el sistema. El panel de administración no incluye editor de plantillas: una plantilla personalizada es un archivo de texto que se edita con cualquier editor de texto externo.

  • Importar plantilla (arriba a la derecha) permite cargar el archivo. Se valida previamente: si contiene errores, se rechazará indicando el número y detalle de incidencias sin guardar cambios. Las plantillas importadas muestran el distintivo importada en su tarjeta.
  • Si una plantilla importada utiliza el mismo identificador que una integrada, reemplaza a esta última y su tarjeta mostrará reemplaza integrada. Al eliminarla, se restaura la versión de fábrica.
  • Las plantillas importadas se pueden exportar (Exportar como YAML) y eliminar (Eliminar plantilla) mediante los iconos visibles al situar el cursor sobre la tarjeta. Eliminar plantilla realiza el borrado de inmediato, sin pedir confirmación.
  • Las plantillas integradas no se pueden exportar ni eliminar; sus tarjetas no muestran dichos iconos. Se suministran con el servidor y se restauran en cada actualización. Para crear una plantilla propia, exporte una previamente importada o escriba el archivo desde cero.

⚠️ Advertencia: Eliminar una plantilla no altera los dispositivos ya creados a partir de ella. Estos seguirán funcionando con normalidad; solo se elimina la plantilla de origen.


Vinculación de Sonos

Los objetos de Sonos se vinculan a una zona, no a una dirección IP manual. Ajuste el protocolo del dispositivo a Sonos (o deje que la biblioteca lo configure) y el editor de cada objeto mostrará los siguientes campos:

CampoDescripción
Zona SonosLa zona que controla este widget, seleccionada de la lista de zonas activas del sistema. El identificador guardado se mantiene aunque se cambie el nombre de la habitación en la app Sonos o se modifique su dirección IP.
Actuar en todo el grupoEn los dos objetos de comando, Consigna de volumen y Silencio On/Off: si la zona está agrupada con otras, la orden actúa sobre el grupo completo en lugar de sobre este altavoz individual. Se configura de forma independiente en cada uno, permitiendo regular el volumen en grupo manteniendo el silencio individual. Este selector también aparece en Estado de volumen y Estado de silencio, donde no tiene efecto: el estado siempre refleja los valores propios de la zona.

Todos los objetos del widget hacen referencia a la misma zona; el número de objeto define su función: volumen, silencio, reproducción/pausa, fuente, pista anterior/siguiente, título de pista, artista y carátula. La función Zona On/Off no aplica a un altavoz Sonos y permanece sin vincular, motivo por el cual la plantilla de la biblioteca utiliza el subtipo de audio sin zonas.

Haga clic en Guardar objeto, después en Aplicar cambios en la barra lateral y confirme la acción (consulte «Recorrido por el panel de administración»).

📘 Nota: Los grupos se crean y gestionan desde la app Sonos; HyperVisu no realiza agrupaciones. Las apps tampoco muestran el estado de agrupación: cada zona permanece como un dispositivo de audio independiente con su propio control de volumen y botón de silencio, y el deslizador sigue indicando el volumen individual de la zona incluso cuando las órdenes se envían al grupo. Para comprobar qué zonas están agrupadas, consulte la app Sonos o el apartado Zonas en este hogar dentro de la conexión Sonos (consulte «Integración de Sonos»). Las órdenes de reproducción, pausa, siguiente y anterior se envían siempre al coordinador del grupo.

El editor de objetos para el volumen de un widget Sonos: la tarjeta de vinculación Sonos, el identificador de zona y la opción de grupo.

Las fuentes corresponden a los favoritos de Sonos. Sobre la lista de objetos del widget se encuentra el panel Fuentes Sonos. Al pulsar Sincronizar favoritos de Sonos, el servidor lee el sistema: primero las entradas físicas del altavoz (TV en barras de sonido, Line-In en modelos compatibles) y a continuación los favoritos guardados en la app Sonos. Sus nombres y cantidad se asignan al widget, y las apps generan un botón de fuente por cada entrada.

Esta lista es de solo lectura en la interfaz, ya que se gestiona desde Sonos. Vuelva a sincronizar tras añadir, eliminar o renombrar favoritos en la aplicación de Sonos; de lo contrario, las apps seguirán mostrando los botones antiguos.

El panel Fuentes Sonos sobre la lista de objetos de un widget, con los nombres de fuentes sincronizados y el botón Sincronizar.

💡 Consejo: A partir de seis fuentes, las aplicaciones muestran un menú desplegable en lugar de botones individuales, manteniendo la interfaz optimizada en instalaciones con muchos favoritos.

Preguntas frecuentes

¿Qué configura automáticamente una plantilla de la biblioteca?

Crea los widgets seleccionados con las vinculaciones de protocolo, tipos de datos, escalado y unidades ya asignados. Solo debe indicar los parámetros requeridos y la conexión.

¿Por qué algunos widgets aparecen desmarcados en la vista previa?

Pueden requerir hardware adicional no presente en todas las instalaciones, como un contador de red o una batería. Seleccione únicamente lo que esté realmente instalado.

¿Por qué mi nuevo dispositivo de la biblioteca aún no está activo?

La creación desde la biblioteca guarda los widgets, pero es necesario pulsar Aplicar cambios para activarlos y transferir la configuración a los clientes.

¿Puedo utilizar mis propias plantillas?

Sí. Puede importar plantillas YAML validadas. Si una plantilla importada utiliza el mismo identificador que una integrada, sustituirá a la del catálogo; al eliminarla, se restaura la versión integrada.

¿Eliminar una plantilla borra los dispositivos creados a partir de ella?

No. Los dispositivos existentes conservan su configuración y siguen funcionando con normalidad.

¿Cómo se actualizan los botones de fuentes de Sonos?

Utilice Sincronizar favoritos de Sonos sobre la lista de objetos del widget tras modificar los favoritos en Sonos. La lista se gestiona directamente desde la app Sonos.

Seguir explorando

Encuentre las demás guías de este producto en la documentación.

Volver a Configuración del dispositivo