Saltar para o conteúdo
Elausys

HyperVisu / Configuração do dispositivo

Biblioteca de dispositivos e integração Sonos

Crie widgets pré-configurados a partir de um catálogo de inversores, contadores, carregadores, relés e colunas — e associe zonas Sonos.

elausys · 21 julho 2026
Nesta página

A Biblioteca de dispositivos

A Biblioteca de dispositivos é um catálogo de modelos prontos a usar para equipamentos já mapeados: contadores de energia, inversores solares, baterias domésticas, carregadores de VE, relés inteligentes, leitores multimédia e colunas Sonos. Seleciona o modelo, preenche alguns campos — habitualmente pouco mais do que o endereço do dispositivo — e a biblioteca cria os widgets com todos os seus objetos de comunicação já associados: registos, tópicos, caminhos, tipos de dados, fatores de escala e unidades incluídos. Um trabalho que normalmente exigiria uma tarde a consultar um manual de registos fica concluído num minuto.

Aceda através de Dispositivos → Adicionar da biblioteca.

O que é necessário: o dispositivo na rede com um endereço fixo (uma reserva DHCP), as opções necessárias ativadas na sua própria configuração — o Modbus TCP vem desativado por defeito na maioria dos inversores — e o protocolo ativado em Serviços (consulte “Serviços e Protocolos”).

Cada modelo é apresentado num cartão com a marca, o modelo, o indicador do protocolo e uma descrição sucinta. Filtre a lista através de:

  • campo de pesquisa — marca, modelo, nome do dispositivo ou descrição; o contador à direita apresenta correspondentes / total;
  • botões de categoria — um por cada categoria existente no catálogo (atualmente Iluminação, Sombreamento, Energia e Áudio / Vídeo);
  • menus suspensos de Marca e Protocolo.
Catálogo da Biblioteca de dispositivos: pesquisa com contador correspondentes/total, filtros de categoria, marca e protocolo, e cartões de modelos.

Equipamentos abrangidos. O catálogo é fornecido com o servidor e expandido a cada atualização. Atualmente integra 83 modelos de 49 marcas:

Família de dispositivosMarcas suportadas
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)
Baterias domésticas e armazenamentoMarstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE)
Gestores de energia e dataloggersHuawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog
Contadores de energiaHomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S)
Carregadores 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 iluminação e estoresShelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 estores)
Áudio / vídeoSonos (qualquer zona) · AUDAC (XMP44)

A maioria dos dispositivos de energia comunica por Modbus TCP. Os módulos Shelly estão disponíveis via HTTP e MQTT — dois cartões; selecione o correspondente à configuração do dispositivo. O HomeWizard utiliza HTTP, o AUDAC TCP/UDP, e a Sonos o seu protocolo dedicado (consulte “Integração Sonos”).

📘 Nota: Um modelo abrange uma família de produtos e não uma referência isolada: o modelo Sonos aplica-se a qualquer zona e o modelo Shelly Plus 1 aplica-se ao 1 e ao 1PM. Sempre que o fabricante alterou o mapa de registos entre gerações, foram criados cartões distintos (Shelly Gen1 e Shelly Plus).

Criar um dispositivo a partir de um modelo

  1. Clique no cartão do modelo. A página de configuração abre com a descrição e, se aplicável, um painel de Requisitos de instalação. Leia-o atentamente — lista as pré-condições no dispositivo: conta de instalador, ativação de Modbus, ou inversores de resposta lenta que requerem um intervalo de leitura (poll) superior.
  2. Introduza o Nome do dispositivo. Serve de prefixo para todos os widgets gerados pelo modelo, pelo que "Garagem" resultará em "Garagem — Rede", "Garagem — Solar", etc.
  3. Preencha os parâmetros do modelo — exigidos pelos próprios widgets: um Unit ID Modbus, a variante do modelo num menu suspenso, a zona Sonos. O formulário não solicita o endereço IP: este pertence à ligação e é introduzido no passo 4.
  4. Aceda a Ligação. A lista apresenta apenas as ligações do protocolo do modelo. Selecione a ligação do dispositivo ou — para equipamentos com IP próprio (inversor, wallbox, coluna) — escolha Criar uma nova ligação…: a janela Adicionar ligação abre-se com o protocolo e o nome preenchidos. Introduza o endereço IP do dispositivo e clique em Criar ligação; a nova ligação fica selecionada sem necessidade de aceder previamente à página de Ligações. Se já existir uma ligação para esse endereço, a biblioteca alerta e reutiliza-a sem criar duplicados. Modelos para infraestruturas partilhadas — como um broker MQTT — assumem a ligação existente por defeito.
  5. Selecione a Divisão e a Categoria para os widgets. Ambos os campos são obrigatórios.
  6. O painel Widgets a criar apresenta a pré-visualização em tempo real.
Página de configuração de um modelo de inversor: parâmetros, ligação, divisão e categoria, requisitos de instalação expandidos e pré-visualização.

A pré-visualização e ajustes manuais

Cada widget na pré-visualização apresenta o seu nome, tipo de widget e um contador N / M objetos associados. O modelo define quais os widgets previamente selecionados — por norma, aqueles comuns a qualquer instalação. Os restantes surgem desselecionados por dependerem de equipamento adicional: o modelo Huawei seleciona a produção solar e deixa a rede e a bateria desmarcadas para ativação posterior à instalação do Smart Power Sensor. Consulte os requisitos e selecione apenas o que existe na instalação. Antes de criar, é possível:

  • selecionar ou desselecionar cada widget — uma instalação puramente solar não requer a criação do widget de bateria;
  • renomear um widget diretamente;
  • expandir o contador de objetos para inspecionar cada um: número, nome, endereço resolvido e tipo de dados. Os objetos intencionalmente deixados em aberto pelo modelo apresentam-se sem endereço.

Se faltar algum parâmetro ou se este for inválido, surge uma mensagem vermelha no lugar da lista de widgets indicando a correção necessária; o botão de criação permanece inativo até à sua resolução.

Clique em Criar N widget(s). A página de relatório confirma os elementos criados e respetivos objetos, eventuais falhas com o respetivo motivo, e disponibiliza Adicionar outro dispositivo para executar a biblioteca novamente. Este é o fluxo habitual para uma instalação Sonos ou multisala, aplicando o mesmo modelo a cada zona.

📘 Nota: Os widgets são guardados mas não ficam imediatamente operacionais. Clique em Aplicar alterações na barra lateral e confirme na janela Aplicar alterações de configuração (consulte “Apresentação do Painel de Administração”) para reiniciar os protocolos e distribuir as alterações pelos clientes.

Página de relatório após criação a partir de modelo, com contagem de objetos e aviso de Aplicar alterações ativo.

Pós-criação

A partir deste momento, os widgets comportam-se como dispositivos normais — podem ser renomeados, mudar de ícone, ser movidos entre divisões, ter registo de dados ativado e ser utilizados em vistas, cenários e automações. As associações são totalmente editáveis: abra um objeto e ajuste-o tal como faria numa configuração manual (consulte “Integração Modbus TCP”, “Integração MQTT”).

Os contadores criados por modelos de energia incluem a sua função pré-definida — rede, solar, bateria, carregador, consumo — permitindo o funcionamento imediato do módulo de Energia e dos seus balanços sem parametrização adicional (consulte “Dispositivos de Energia”, “Visão Geral de Energia”).

Importação e exportação de modelos

A biblioteca suporta modelos personalizados: ficheiros .yaml ou .yml até 256 KB, estruturados no mesmo formato dos modelos integrados. O painel de administração não inclui editor de modelos: um modelo personalizado é um ficheiro de texto criado ou editado num editor de texto externo.

  • Importar modelo (canto superior direito) envia o ficheiro. A estrutura é validada previamente — ficheiros com erros são rejeitados com indicação do número de problemas e detalhes, sem nada ser gravado. Os modelos importados apresentam a etiqueta importado no cartão.
  • Um modelo importado com o mesmo identificador de um modelo de fábrica substitui-o, surgindo com a indicação substitui integrado. Ao eliminar o ficheiro importado, a versão de fábrica é restaurada.
  • Os modelos importados podem ser exportados (Exportar como YAML) e eliminados (Eliminar modelo) através dos ícones visíveis ao passar o cursor sobre o cartão. Eliminar modelo remove-o de imediato, sem pedido de confirmação.
  • Os modelos de fábrica não podem ser exportados nem eliminados: não dispõem desses ícones. São nativos do servidor e repostos a cada atualização. Para criar um modelo de raiz, exporte um modelo existente ou escreva o ficheiro conforme a especificação.

⚠️ Aviso: Eliminar um modelo não afeta os dispositivos já criados a partir dele. Estes continuam totalmente funcionais — apenas o modelo de origem é removido.


Integração Sonos

Os objetos Sonos são associados a uma zona e não a um endereço estático manual. Defina o protocolo do dispositivo como Sonos — ou utilize o modelo da biblioteca — e a edição de cada objeto disponibiliza:

CampoDescrição
Zona SonosA zona controlada por este widget, selecionada a partir da lista de zonas ativas no sistema. O identificador interno mantém-se mesmo se a divisão for renomeada na aplicação Sonos ou se o endereço IP for alterado.
Atuar em todo o grupoNos dois objetos de comando, Valor de Volume e Mute Ligado/Desligado: se a zona estiver agrupada, o comando atua sobre o grupo e não apenas sobre esta coluna. Pode ser configurado de forma independente em cada um, permitindo ajustar o volume de todo o grupo mantendo o controlo de mute individual. O seletor surge também em Feedback de Volume e Feedback de Mute, onde não tem efeito prático: o feedback reporta sempre o estado individual da zona.

Todos os objetos do widget partilham a mesma zona; o número do objeto define a sua função — volume, mute, reproduzir/pausa, fonte, anterior/seguinte, título da faixa, artista, capa do álbum. A função Ligar/Desligar Zona não tem aplicação em colunas Sonos e permanece não associada, razão pela qual o modelo da biblioteca utiliza o subtipo de áudio sem zonas.

Clique em Guardar objeto, seguido de Aplicar alterações na barra lateral e confirme (consulte “Apresentação do Painel de Administração”).

📘 Nota: O emparelhamento e desagregação de grupos é realizado na aplicação Sonos; o HyperVisu não efetua essa gestão. As aplicações cliente também não exibem o estado do agrupamento: cada zona mantém-se como um dispositivo de áudio independente com o seu próprio controlo de volume e mute, e a barra deslizante reflete sempre o volume dessa zona específica, mesmo quando configurada para comandar o grupo. Para verificar que zonas estão agrupadas, consulte a aplicação Sonos ou a secção Zonas nesta instalação na ligação Sonos (consulte “Integração Sonos”). Os comandos de reproduzir, pausa, seguinte e anterior são sempre enviados ao coordenador do grupo.

Editor de objetos para o comando de volume Sonos: cartão de associação Sonos, identificador de zona e seletor de grupo.

Fontes são favoritos Sonos. Acima da lista de objetos do widget encontra-se o painel Fontes Sonos. Clique em Sincronizar favoritos Sonos e o servidor lê a instalação: primeiro as entradas físicas da coluna (TV numa barra de som, Line-In nos modelos equipados), seguidas dos favoritos guardados na aplicação Sonos. Os nomes e a contagem são atribuídos ao widget, e as aplicações desenham um botão de fonte por entrada.

A lista é apenas de leitura — a gestão é exclusiva da Sonos. Sincronize novamente após adicionar, remover ou renomear favoritos na aplicação Sonos, caso contrário as interfaces mantêm os botões anteriores.

Painel de fontes Sonos acima da lista de objetos do widget, com nomes sincronizados e botão de sincronização.

💡 Sugestão: A partir de seis fontes, as aplicações apresentam um menu suspenso em vez de botões individuais, mantendo a interface desimpedida em sistemas com muitos favoritos.

Perguntas frequentes

O que é configurado automaticamente por um modelo da biblioteca?

Cria os widgets selecionados com as associações de protocolo, tipos de dados, escalas e unidades já preenchidos. Apenas necessita de introduzir os parâmetros obrigatórios e a ligação.

Por que razão alguns widgets aparecem desmarcados na pré-visualização?

Podem depender de hardware opcional que não existe em todas as instalações, como um sensor de rede ou baterias. Selecione apenas o que está efetivamente instalado.

Por que razão o novo dispositivo da biblioteca ainda não está operacional?

A criação na biblioteca grava os widgets, mas é obrigatório clicar em Aplicar alterações para ativar os protocolos e enviar a configuração para os clientes.

Posso utilizar os meus próprios modelos?

Sim. Pode importar um modelo YAML validado. Um modelo importado com o mesmo identificador de um nativo substitui essa entrada do catálogo; eliminá-lo restaura a versão de fábrica.

Eliminar um modelo remove os dispositivos criados a partir dele?

Não. Os dispositivos existentes mantêm a sua parametrização e continuam a funcionar normalmente.

Como atualizo os botões de seleção de fonte Sonos?

Clique em Sincronizar favoritos Sonos acima da lista de objetos do widget após alterar os favoritos na aplicação Sonos. A lista de favoritos é gerida na aplicação Sonos.

Continuar a explorar

Encontre os outros guias deste produto na documentação.

Voltar a Configuração do dispositivo