Depois de criado o primeiro administrador, o painel de administração oferece o assistente de configuração na caixa de diálogo Your setup wizard is ready — clique em Start setup. O assistente acompanha-o na colocação em serviço: que tipo de projeto, onde se situa, como acede ao bus KNX, que serviços estão ativos e o que o edifício contém. Também o pode abrir mais tarde com o botão Setup wizard da página System.
Como funciona o assistente
- Nada é escrito no servidor até à aplicação final. Todos os passos anteriores apenas guardam um rascunho.
- O rascunho mantém-se após recarregar a página — fica guardado no navegador que está a utilizar, pelo que pode fechar a página e voltar no mesmo computador; as suas respostas continuam lá.
- Save & exit, no cabeçalho, sai do assistente e guarda o rascunho para mais tarde. Skip setup — configure later, por baixo da lista de passos, sai do assistente e elimina o rascunho. Ambos conduzem à página System.
- Navegue com Back e Continue. O cabeçalho mostra o progresso («Step 2 of 7» — o percurso ETS tem um passo adicional, pelo que chega a 8).
Passo 1 — Modo de configuração
«How do you want to build this project?» Três opções:
- Import an ETS project (Fastest route) — carregue o ficheiro
.knxprojda instalação e o HyperVisu reconstrói a visualização a partir do que o ETS já conhece: edifícios e divisões tornam-se pisos e divisões, os endereços de grupo chegam com nome e tipo, as funções ETS tornam-se dispositivos com os respetivos objetos de grupo já atribuídos. - Configure manually (No file needed) — descreva o edifício por si. Ideal quando não há um projeto ETS à mão, ou quando a visualização não deve segui-lo.
- Restore a HyperVisu backup instead — uma cópia de segurança repõe um servidor completo (divisões, dispositivos, utilizadores e serviços), pelo que o resto do assistente não é necessário. Choose a file não abre um seletor de ficheiros: sai do assistente e abre a página Backup & Restore, onde restaura o ficheiro em Restore from file (ver «Backup & Restore»). Aí não lhe é pedida palavra-passe nem a seleção de serviços — o ficheiro é restaurado na íntegra e substitui o que está no servidor, incluindo o administrador que acabou de criar.
📘 Nota: Pode mudar de ideias mais tarde — ao mudar de modo regressa ao passo 4, porque os dois ecrãs seguintes pertencem ao outro percurso. O que introduziu no percurso abandonado é mantido, caso volte a ele.
Passo 2 — Projeto e localização
«Name the project and place it on the map.»
| Campo | Finalidade |
|---|---|
| Project name | Forma como esta instalação é identificada |
| Installer reference | O seu próprio número de projeto |
| App language | O idioma em que as aplicações móvel e web abrem; cada utilizador pode alterá-lo |
| City → Get coordinates | Escreva a cidade e deixe o servidor obter a latitude e a longitude |
| Latitude / Longitude | Preenchidas pela pesquisa, ou introduzidas à mão |
| Timezone | O relógio em que o servidor funciona |
As coordenadas e o fuso horário determinam as horas do nascer e do pôr do sol, as automatizações programadas e todas as marcas temporais que o servidor escreve — defina-os com rigor.
Passo 3 — Interface do bus KNX
«Connect to the bus.» O assistente procura uma vez na rede interfaces KNX/IP quando o passo abre e apresenta o que respondeu sob a forma de cartões com o nome da interface, o tipo (Interface ou Router), o endereço e o número de série. Clique em Scan again para repetir a pesquisa.
Se nada responder, ou se a interface estiver noutra sub-rede ou atrás de uma VPN, utilize Enter an address manually: escreva o endereço e a porta no mesmo campo, por exemplo 192.168.1.20:3671. Sem porta, é utilizada a 3671.
Defina também:
- Connection type — Tunnel (UDP, para uma interface KNX/IP) ou Multicast (para um router KNX/IP). Ao selecionar um cartão detetado, o tipo é definido automaticamente; para um endereço introduzido à mão, defina-o você.
- HyperVisu physical address — o endereço individual que o próprio servidor assume no bus. Vem preenchido com
1.1.250e tem de estar livre no bus.
O teste de ligação. Clique em Run connection test para ver até onde a ligação chega. Surgem cinco resultados:
| Resultado | O que indica |
|---|---|
| Host reachable | A interface responde na rede (yes, com o tempo de resposta, ou no). |
| Port 3671 / UDP | Se a interface respondeu a um pedido de descrição. Pode indicar not answered enquanto o túnel está aberto — algumas interfaces só respondem a uma ligação real. Não é uma avaria. |
| Tunnel | Se foi possível abrir um túnel (yes ou no). |
| Assigned address | O endereço que a interface atribuiu ao túnel de teste. |
| Telegrams seen | Quantos telegramas chegaram enquanto o teste escutava o bus. |
Quando o túnel abre, o painel mostra Tunnel open e o rodapé indica «Tunnel open — the bus answers.»
Um túnel aberto prova a ligação; só Telegrams seen prova tráfego real no bus. Depois de o túnel abrir, o teste escuta durante cerca de cinco segundos, pelo que 0 num bus silencioso não é uma avaria. Para ver tráfego, clique em Test again e acione de imediato um interruptor de parede, enquanto o teste decorre.
📘 Nota: Quando volta a executar o assistente num servidor que já está ligado ao bus, o teste não abre um segundo túnel, porque isso poderia derrubar a ligação em funcionamento. Indica a ligação ativa e não conta telegramas.
Se o túnel não abrir, o painel mostra No response e o assistente sugere verificar três coisas: o tunneling ativado na interface, nenhum outro cliente ETS a ocupar todos os canais, e o servidor e a interface na mesma VLAN.
Este passo nunca bloqueia: pode continuar sem testar, ou depois de um teste falhado, e corrigir a ligação mais tarde.
Ainda sem bus no local? Clique em I'll configure KNX later. O assistente aplica sem ligação ao bus — divisões, dispositivos e serviços são criados normalmente, e tudo o que estiver associado ao KNX permanece inativo até ser definida uma interface em Connections (ver «Connections»).
Passo 4 — Serviços
«Which services should run?» Os interruptores estão agrupados em três secções, as mesmas da página Services. Cada secção tem uma etiqueta que indica o que custa uma alteração nela:
| Secção | Etiqueta | Significado |
|---|---|---|
| Services | Changes need a restart | Os serviços opcionais que este servidor oferece, como a base de dados de histórico, os dashboards, o Node-RED, o streaming de câmaras e o Home Assistant. Só arrancam ou param quando o servidor reinicia — o assistente propõe o reinício depois da aplicação (ver «Final step — Review & apply» abaixo). |
| Communication protocols | Applied immediately | Os protocolos com que o servidor comunica com os dispositivos. |
| Application services | no restart needed | Meteorologia, preços da energia e e-mail. |
Ativos por predefinição: os protocolos KNX e Virtual, e o InfluxDB (a base de dados de histórico). O botão acima dos cartões mostra quantos estão ativos e repõe estes valores predefinidos.
Um cartão com o selo API key needed requer também uma chave ou credenciais: complete-as na página Services depois do assistente (ver «Services & Protocols»).
Ative apenas o que este projeto utiliza — cada serviço consome memória e tempo de arranque. Tudo pode ser ativado mais tarde em Services & protocols.
Percurso manual — Estrutura do edifício
(Os passos 5–6 dependem do modo de configuração. Este ecrã e o seguinte surgem no percurso manual.)
«List the floors and their rooms.»
- O assistente começa com um Ground floor (nível 0). Para adicionar outro piso, escreva o nome na linha Add a floor e prima Enter.
- Escreva o nome de uma divisão e prima Enter para adicionar a seguinte — uma divisão por linha, o mais depressa que conseguir escrever.
- Para adicionar muitas de uma vez, utilize Add several rooms at once: escolha o piso, escreva os nomes separados por vírgulas («Bedroom 2, Bedroom 3, Dressing») e clique no botão de adicionar.
- Os ícones são opcionais por agora — a aplicação usa o nome da divisão até definir um.
- Clique em Continue to categories. O botão permanece desativado enquanto não existir pelo menos uma divisão.
📘 Nota: O assistente não consegue definir o nível de um piso. Os pisos são numerados 0, 1, 2… pela ordem em que os adiciona, pelo que uma cave adicionada aqui recebe um nível positivo. Para lhe dar um nível negativo depois, abra Building → Floors, edite o piso e altere o Floor Number (ver «Building Structure & Categories»).
Percurso manual — Categorias
«Decide how the app groups devices.» As categorias tornam-se os mosaicos do ecrã inicial da aplicação e os filtros de cada divisão; um dispositivo pertence a uma categoria e a uma divisão.
O assistente cria sete categorias predefinidas: Lighting, Shutters, Heating, Sockets, Scenes, Energy, Security.
- Clique num nome para o alterar.
- Remova uma categoria de que o projeto não precise.
- Add a category própria (nome + ícone), por exemplo «Home cinema».
Em seguida, clique em Review everything para passar ao passo final (ver «Final step — Review & apply» abaixo).
📘 Nota: O percurso manual não cria dispositivos. Adicione-os por divisão a partir da página Devices depois da configuração (ver «The Devices Workspace»).
Percurso ETS — Seleção da importação
(Este ecrã substitui o anterior quando escolheu «Import an ETS project».)
«Choose what to import.»
- Largue o ficheiro
.knxproj(exportação de projeto ETS 5 ou ETS 6) na área Drop the .knxproj file here, ou clique nessa área para escolher o ficheiro. Não existe um botão de procura separado. - Se o projeto estiver protegido por palavra-passe no ETS, introduza a Project password e clique em Unlock and read. A palavra-passe é usada para ler o ficheiro e nunca é guardada.
- O assistente lê o projeto e propõe três partes selecionáveis, cada uma com contagens reais do seu ficheiro:
- Building structure — os pisos e divisões que o projeto ETS descreve («3 floors · 14 rooms»).
- Group addresses — a tabela completa de endereços, para que o monitor de bus e o seletor de endereços conheçam cada endereço pelo nome; são indicadas as contagens de tipificados e não tipificados.
- Devices from ETS functions — cada função ETS torna-se um dispositivo, já associado aos seus endereços de grupo.
- Desmarque o que não pretende e clique em Continue to categories. Mantenha Building structure marcada: sem ela não há divisões onde arquivar os dispositivos, e nada é criado a partir do projeto.
O percurso ETS apresenta então o ecrã Categories com as categorias que o projeto produziu — uma por tipo de dispositivo descrito. Altere os nomes, mude os ícones ou adicione uma que o projeto não cubra, como no ecrã Categories do percurso manual. Uma categoria que ainda tenha dispositivos não pode ser eliminada até esses dispositivos serem movidos para outra categoria no ecrã de revisão. Clique em Review rooms and devices para avançar para a revisão (ver «ETS branch — Review import» abaixo).
Percurso ETS — Revisão da importação
«Check what we found.» Esta é a passagem de correção sobre tudo o que a importação vai criar, organizada como uma árvore de pisos, divisões e dispositivos. Antes de aplicar pode:
- Renomear divisões e dispositivos que ainda pareçam etiquetas do ETS — o nome original do ETS permanece visível («was … in ETS»), com a ação Revert.
- Alterar o tipo de widget de um dispositivo quando a importação se enganou — os endereços associados limitam os tipos possíveis.
- Mover dispositivos para outra divisão ou categoria, ou Exclude os que a aplicação não deve mostrar.
- Confirmar os tipos de datapoint inferidos — os endereços sem DPT no ETS recebem um tipo inferido, marcado para confirmação.
- Tratar o grupo «No room found»: dispositivos reais cuja divisão não foi possível determinar. Mova cada um para uma divisão; o que ficar é criado sem divisão.
📘 Nota: Se o projeto não declarar funções ETS, o assistente deduz os dispositivos a partir dos canais dos atuadores e assinala cada um como guessed — verifique divisões, nomes e tipos antes de continuar.
Os filtros («Needs attention», «Renamed»), a pesquisa e o atalho «Next room with an issue» ajudam a percorrer rapidamente projetos grandes. Pode aplicar com problemas por resolver e corrigi-los mais tarde em Devices. Quando terminar, clique em Review everything.
Passo final — Revisão e aplicação
«Project Review» resume tudo em seis cartões — modo de configuração e projeto, localização e hora, bus KNX, serviços, edifício, dispositivos e endereços — cada um com uma ligação Edit que regressa ao respetivo passo.
Os problemas bloqueantes são listados acima dos cartões (por exemplo «No coordinates — the apply will stop on the settings stage», «No rooms — the app will open empty»). Corrija-os, ou confirme que são intencionais.
O que a aplicação faz, por ordem:
- Escreve as definições do servidor — localização, fuso horário, interface de bus e os serviços que ativou.
- Cria a estrutura — pisos, divisões, categorias e, no percurso ETS, dispositivos e endereços de grupo.
- Reinicia a ponte KNX — uma reconexão; o bus em si não é afetado.
Clique em Apply and finish. Um painel de progresso em direto acompanha as etapas e mostra o tempo decorrido. Quando indicar Setup complete, o assistente fecha e abre-se a página System.
📘 Nota: Se ativou ou desativou um serviço da secção Services (ver «Step 4 — Services» acima), surge em vez disso a caixa de diálogo Reboot to finish setup: estes serviços só arrancam ou páram quando o servidor reinicia, o que demora cerca de dois minutos. Clique em Reboot now, ou em Later e reinicie a partir da página System quando lhe convier.
Se algo correr mal: a execução pára na etapa que falhou e indica-o. O que as etapas anteriores escreveram mantém-se; Retry executa todas as etapas de novo, pelo que, se a falha ocorreu tarde, verifique primeiro o edifício na página System. Se o servidor reiniciou a meio da aplicação, o assistente indica que a tarefa se perdeu — verifique o resultado na página System e volte a executar o assistente se a estrutura estiver em falta.