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”).
Explorar o catálogo
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.

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 dispositivos | Marcas suportadas |
|---|---|
| Inversores solares e híbridos | SMA · 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 armazenamento | Marstek (Venus) · Alpha ESS · SAX Power · Siemens (Junelight) · INTILION · Ads-tec · Anker (Solarbank) · SolarMax (MAX STORAGE) |
| Gestores de energia e dataloggers | Huawei (EMMA, SmartLogger) · SMA (Data Manager, WebBox) · Sungrow (iHomeManager) · Ferroamp · OpenEMS / FENECON · Atmoce · Plexlog · Powerdog |
| Contadores de energia | HomeWizard (P1) · Siemens (SENTRON 7KT PAC) · Kostal (Smart Energy Meter) · Acrel · my-PV · Shelly (Plus Plug S) |
| Carregadores de VE | KEBA · 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 estores | Shelly (1 / 1PM, Plus 1 / 1PM, RGBW2, Plus RGBW PM, 2.5 estores) |
| Áudio / vídeo | Sonos (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
- 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.
- 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.
- 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.
- 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.
- Selecione a Divisão e a Categoria para os widgets. Ambos os campos são obrigatórios.
- O painel Widgets a criar apresenta a pré-visualização em tempo real.

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ó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:
| Campo | Descrição |
|---|---|
| Zona Sonos | A 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 grupo | Nos 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.

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.

💡 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.