Configurar Registadores de Dados

Os registadores de dados são a ponte entre o equipamento na sua central e a plataforma Mirox: depois de um registador estar configurado, o Mirox-Agent começa a consultar esse dispositivo de forma agendada, normalizando cada leitura num único vocabulário de métricas e transmitindo-a para a plataforma. Este guia orienta-o na adição de um registador, na associação de um dispositivo descoberto a um adaptador, na confirmação de que este responde com uma sondagem ao vivo e na aplicação das suas alterações — além dos limites do que é integrado automaticamente.

Antes de Começar

Um registador é configurado contra um dispositivo de rede que já tenha sido descoberto na rede da central. Se o dispositivo que pretende ainda não estiver lá, execute primeiro uma análise de descoberta — consulte Gerir Dispositivos de Rede. Também precisa de ter a ligação segura à central ativa; o Agent acede aos dispositivos através do túnel VPN.

Onde Vivem os Registadores de Dados

Cada central tem uma página de Fluxo de dados onde gere os seus registadores e acompanha a chegada dos dados.

Abrir no Mirox: Fluxo de dados — ou abra Os seus parques, escolha um parque e mude para o separador Fluxo de dados.

O cabeçalho da página apresenta mosaicos ao vivo para o estado dos registadores (saudáveis vs. total), a disponibilidade do Agent e o tráfego de rede, para que veja num relance se a recolha está a funcionar. O separador Registadores de Dados é onde adiciona e gere os registadores; o botão Aplicar alterações no canto superior direito envia a sua configuração para o Agent.

Como São Integrados os Registadores de Dados

Adicionar um registador é um fluxo guiado construído em torno de uma conversa real com o dispositivo. A plataforma abre uma ligação temporária só de leitura — uma sondagem — para que possa confirmar que o dispositivo responde e ver as suas leituras ao vivo antes de assumir qualquer compromisso. Há duas formas de entrar no fluxo:

Registadores Possíveis (detetados automaticamente) — quando o fabricante e o tipo de um dispositivo descoberto correspondem a um adaptador conhecido, este aparece na tabela Registadores Possíveis com o adaptador correspondente pré-preenchido. Este é o caminho rápido.
Adicionar Registador (manual) — quando a deteção falha ou classifica incorretamente um dispositivo, o botão Adicionar Registador permite-lhe escolher qualquer dispositivo de rede e um adaptador.

Em qualquer dos casos, executa-se o mesmo assistente e a mesma sondagem ao vivo confirma o dispositivo antes de guardar.

Adicionar um Registador Detetado Automaticamente

Abrir no Mirox: Fluxo de dados (ou escolha o seu parque em Os seus parques e abra o separador Fluxo de dados).
Na tabela Registadores Possíveis, encontre o dispositivo que pretende. Cada linha mostra o nome do dispositivo, o IP, o fabricante/tipo e o adaptador a que a plataforma o associou.
Clique no botão + na linha. O assistente de integração abre com esse dispositivo e adaptador já associados.
Siga os passos do assistente (abaixo) e Guarde o registador.

Adicionar um Registador Manualmente

Na página Fluxo de dados, clique em Adicionar Registador.
No passo Escolher dispositivo, pesquise a lista de dispositivos de rede por nome, IP, fabricante, tipo, modelo ou descrição, e selecione o dispositivo.
Escolha o adaptador a utilizar e, em seguida, clique em Continuar.
Siga os restantes passos do assistente e Guarde o registador.

O Assistente de Integração, Passo a Passo

O assistente é uma única caixa de diálogo com uma barra lateral de passos e uma faixa de registo do agent ao vivo ao longo da parte inferior, para que possa observar o Agent a comunicar com o dispositivo o tempo todo. Um distintivo de ligação junto ao nome do dispositivo indica o estado da sondagem (A ligar, A sondar, Inativo, Erro, Concluído). Os passos que aparecem dependem do adaptador:

Passo	Quando aparece	O que faz
Escolher dispositivo	Apenas na adição manual	Escolher o dispositivo de rede e o adaptador
Identidade	Dispositivos que precisam de configuração	Confirmar que o dispositivo e o adaptador estão corretos
Credenciais	Adaptadores que requerem início de sessão	Introduzir o nome de utilizador e a palavra-passe do dispositivo
Sondagem	Dispositivos sem configuração	Observar as leituras ao vivo que o dispositivo expõe
Mapear valores	Registadores genéricos	Percorrer todos os valores em bruto que o dispositivo expõe e mapear cada um para uma métrica conhecida
Execução de teste	Registadores genéricos	Rever as métricas exatas que o seu mapeamento produziria
Configuração	Dispositivos que precisam de associação manual	Escolher quais as leituras a recolher e o intervalo de consulta
Resumo	Dispositivos que precisam de configuração	Rever e guardar

Credenciais e o Cofre

Se o adaptador precisar de iniciar sessão no dispositivo, o passo Credenciais pede um nome de utilizador e uma palavra-passe. As credenciais que já tiver guardado para esse dispositivo no cofre de credenciais são oferecidas aqui para que não as tenha de voltar a escrever, e o que introduzir pode ser reutilizado mais tarde para acesso por proxy.

Janitza Não Precisa de Credenciais

Os contadores Janitza são integrados sem quaisquer credenciais. Os controladores Huawei SmartLogger e Phoenix Contact precisam de início de sessão no dispositivo, pelo que o passo Credenciais aparece para eles, mesmo que de resto sejam sem configuração.

A Fronius Pode Substituir um Contador de Injeção

Os parques Fronius de pequena dimensão muitas vezes não têm um contador de injeção dedicado. Ao integrar um registador Fronius, ative a opção Utilizar como contador de injeção para publicar a potência combinada de todo o dispositivo e a energia total como a série principal de rede do parque — sem necessidade de um contador separado.

O SMA Power Manager Lista Sozinho os Seus Dispositivos

O SMA Power Manager (o controlador de central SMA Data Manager / ennexOS) é integrado sem configuração: inicie sessão com uma conta de utilizador ennexOS e o gestor reporta automaticamente todos os dispositivos que conhece — ID do componente, nome, produto, número de série, endereço IP e firmware — pelo que não há lista de componentes para escrever. Três interruptores controlam o que é recolhido: recolher totais da central (desative onde um contador de rede dedicado já os mede), recolher séries de inversores e excluir canais de limite. Um inversor já lido diretamente por outro registador é excluído automaticamente — o Power Manager continua a reportar o respetivo motivo de derating, mas não a sua telemetria, para que nada seja publicado em duplicado.

O SMA Sunny Central Mantém a Sua Identidade

O SMA Sunny Central (a interface web clássica por inversor) também é integrado sem configuração. Quando a mesma central tem também um SMA Power Manager configurado, o assistente resolve automaticamente a identidade do Sunny Central a partir da lista de dispositivos do Power Manager, pelo que a unidade mantém o mesmo componente e histórico que já tinha.

A Monitorização de Strings do blue'Log é um Campo do Assistente

Um blue'Log que sirva hardware de monitorização de strings recebe um passo de monitorização de strings: ative ou desative o rastreio, escolha a que inversor pertencem as strings e defina de quantos em quantos ciclos a camada de strings é lida. Se o registador já conhecer o seu inversor, este é preenchido automaticamente; caso contrário, escolhe-o de entre os inversores da central.

O Sungrow Logger É Integrado Sem Configuração

O Sungrow Logger inicia sessão com o mesmo nome de utilizador e palavra-passe da interface web do próprio registador (o comportamento SSL e ping são definições avançadas opcionais). Além das leituras dos seus inversores, também recolhe a lista de falhas ativas do registador como alarmes e reporta automaticamente o número de série, modelo, firmware e potência nominal de cada inversor.

Baterias INTILION: escolha o tipo de equipamento e emparelhe o identificador

Uma central INTILION coloca dois controladores diferentes no mesmo protocolo: um controlador da central para todo o local e um controlador de unidade de bateria por unidade de armazenamento. Escolha qual está a integrar em Tipo de equipamento — nenhum deles tem número de série, pelo que esta é a única indicação que diz à plataforma o que está a ler, e uma escolha errada é recusada em vez de publicada.

Para um controlador de unidade de bateria, atribua à unidade um identificador da unidade de bateria e utilize exatamente o mesmo identificador no relé de proteção da saída de média tensão dessa unidade. O relé mede o lado da rede e o controlador o lado da bateria; identificadores coincidentes tornam-nos uma única unidade de armazenamento em vez de duas medidas pela metade.

Executar a Sondagem ao Vivo

O passo Sondagem abre uma execução de teste de curta duração contra o dispositivo. O Agent lê o que o dispositivo expõe e transmite amostras ao vivo de volta — atualizam-se a cada segundo, e a faixa de registo inferior mostra a troca subjacente.

Aguarde até que apareçam amostras. O distintivo de ligação passa para A sondar e depois estabiliza quando as leituras começam a fluir.
Se nada chegar, o assistente tenta novamente de forma automática algumas vezes. Se mesmo assim não conseguir alcançar o dispositivo, receberá uma mensagem clara e um botão Voltar a ligar para tentar de novo.
Uma sondagem bloqueada significa quase sempre que o dispositivo não está acessível a partir do Agent — verifique se a descoberta ainda o vê e se o túnel VPN está ativo.

A Sondagem É Só de Leitura

A sondagem nunca altera o dispositivo nem guarda nada por si própria. Existe para que possa confirmar que o dispositivo responde e ver os seus valores reais antes de assumir o compromisso do registador.

Mapear os Valores de um Registador Genérico

Alguns registadores são genéricos — expõem uma longa lista de valores em bruto que a plataforma não consegue interpretar por si só (um contador de energia, um piranómetro e uma dúzia de outros canais por trás de um único dispositivo, cada um nomeado no vocabulário próprio do dispositivo). Para estes, o assistente executa um fluxo de mapeamento interativo em vez de uma pré-visualização só de leitura:

No passo Mapear valores, o Agent enumera todos os valores em bruto que o dispositivo expõe e transmite-os de volta com o seu grupo, nome, unidade e uma amostra ao vivo. Obtém uma tabela pesquisável.
Para cada valor em bruto que lhe interessa, escolha na lista pendente a métrica conhecida que ele representa. Deixe os restantes por mapear. Pode inverter um sinal por valor sempre que necessário; os prefixos de unidade (kW, kWh, …) são reescalados automaticamente para SI base.
O passo Execução de teste volta a passar o dispositivo pelo seu mapeamento e mostra as métricas exatas que seriam produzidas — o seu ponto de verificação para aceitar/recusar.
O Resumo confirma o que será guardado.

Definições avançadas por valor

Cada valor mapeado tem um painel Definições avançadas, recolhido por predefinição — a maioria dos valores não precisa dele. Abra-o quando o dispositivo reportar um valor que tem de ser remodelado antes de ser publicado:

Fator — multiplica a leitura (p. ex. um contador de impulsos em que cada impulso vale 200 Wh). Aplicado por cima do reescalonamento automático de unidades.
Limite superior / Limite inferior — rejeita leituras fora deste intervalo em vez de as publicar. Útil para um dispositivo que emite um pico fora de escala quando a sua entrada não é lida.
Ignorar valores — descarta por completo leituras em bruto específicas, separadas por vírgula (p. ex. 0 para um contador que reporta zero enquanto a sua entrada está desligada).
Inverter sinal — troca a direção consumo/injeção.

Um campo deixado vazio não é aplicado de todo. Tudo o que definir é mostrado como um pequeno distintivo (×200 · ≥-10000) na linha do valor e novamente no passo Resumo, para que possa verificar todo o mapeamento antes de guardar.

Apenas os valores que mapear são recolhidos, e cada valor em bruto é mapeado para exatamente uma métrica.

Associar Leituras (Adaptadores com Substituição Manual)

Para dispositivos que não são sem configuração, o passo Configuração mostra todas as leituras que a sondagem encontrou e permite-lhe escolher quais recolher, definir o intervalo de consulta e aplicar correções por leitura (por exemplo, inverter um sinal). Quando continua, a plataforma volta a sondar com a sua configuração para que o passo Resumo mostre os valores exatamente como serão armazenados.

Guardar

No passo final — Resumo para adaptadores manuais, ou o próprio passo Sondagem para dispositivos sem configuração — clique em Guardar registador (ou Adicionar para dispositivos sem configuração). O registador é guardado como uma alteração pendente. Ainda nada chega ao Agent.

Aplicar as Suas Alterações

Novos registadores, edições e remoções ficam em fila até os publicar no Agent num único lote.

Faça todas as alterações de registadores que pretende.
Clique em Aplicar alterações no topo da página Fluxo de dados (lê-se Aplicar N alteração(ões) pendente(s) quando colocou algumas em fila nesta sessão).
O Agent é reimplementado com a nova configuração e começa a recolher pouco depois.

Aplicar É Sempre Seguro

Pode premir Aplicar alterações a qualquer momento — se não houver nada de novo para publicar, não faz nada. Após uma atualização da página, o contador de pendentes é reposto a zero, por isso use Aplicar alterações para se certificar de que a configuração mais recente está ativa.

Gerir Registadores Existentes

A tabela Registadores de Dados lista tudo o que está configurado para a central, com pesquisa, ordenação e estado por registador. O menu de ações ⋮ em cada linha permite-lhe:

Editar registador — ajustar a configuração do registador.
Editar dispositivo de rede — saltar para o dispositivo na página de Rede para alterar o seu IP, credenciais, SNMP ou definições de proxy (estas vivem num único lugar, não estão duplicadas aqui).
Pausar / Retomar — parar temporariamente a recolha durante uma janela escolhida (15 minutos até 24 horas) e retomá-la. Útil durante a manutenção, para que uma interrupção conhecida não gere eventos.
Remover registador — eliminar um registador que adicionou através do assistente.

Remover ou pausar um registador é também uma alteração pendente — lembre-se de Aplicar alterações depois.

O Que Pode Ser Integrado Através do Assistente

Três tipos de dispositivo são integrados através do assistente:

Famílias sem configuração — o adaptador já conhece o conjunto completo de leituras do dispositivo, pelo que só tem de confirmar a sondagem ao vivo e guardar. Hoje, incluem os contadores Janitza (não são necessárias credenciais), o Huawei SmartLogger, os controladores Phoenix Contact, o SMA Sunny Central, o SMA Power Manager e o Sungrow Logger.
Registadores genéricos — dispositivos que expõem valores em bruto arbitrários que a plataforma não consegue interpretar por si só. Estes são integrados através do fluxo interativo Mapear valores → Execução de teste descrito acima, em que associa cada valor em bruto a uma métrica conhecida. O QReader e o blue'Log são integrados desta forma.
Adaptadores de adição manual — uma família que a plataforma lê na íntegra mas sobre a qual nunca deve adivinhar. Hoje é o PLC de alarme WAGO PFC200: lê os contactos do sistema de alarme de um local por Modbus TCP só de leitura e sem credenciais, mas uma WAGO é um controlador em branco que cada integrador programa de forma diferente e nada no fio indica que programa está a correr. Por isso nunca é oferecido em Registadores Possíveis: use Adicionar Registador, escolha o adaptador e defina o perfil de integrador (atualmente abo_uegs), opcionalmente um identificador do sistema de alarme e os contactos que não estejam cablados. A sondagem ao vivo mostra depois o estado de cada contacto antes de guardar.

As famílias de dispositivos fora dos três grupos continuam a funcionar, mas hoje não são integráveis através do assistente: precisam de uma configuração por dispositivo que o Mirox prepara e fornece com o Agent. Trate a automatização da integração como específica do dispositivo, não universal.

O Seu Dispositivo Não Está Listado?

Se o seu equipamento não estiver coberto por um adaptador existente, o Mirox cria um — muitas vezes mesmo para equipamento antigo ou interfaces sem documentação, desde que o dispositivo exponha os seus dados de alguma forma. Clique em Pedir apoio para registadores por baixo da tabela Loggers possíveis (o seletor de adaptadores no assistente liga ao mesmo pedido); os detalhes da central e do dispositivo são anexados automaticamente, e o suporte a novos dispositivos fica normalmente pronto num dia.

Passo a passo: Solicitar uma integração.

Para perceber como os adaptadores falam o protocolo de cada dispositivo, normalizam unidades e descobrem componentes, consulte a página de arquitetura Data Scraper — este guia, deliberadamente, não a repete.

Migrar uma Configuração Escrita à Mão

Um pequeno número de centrais integradas antes de o assistente existir continua a funcionar com uma configuração escrita à mão (uma sobreposição legada) em vez da configuração que a plataforma geraria hoje a partir das suas linhas de registador. Para estas, os administradores de sistema Mirox dispõem de uma vista de migração no separador Fluxo de dados → Configuração do agente da central, que mostra como ficaria a saída da sobreposição antes de qualquer alteração:

a configuração que a plataforma geraria sem a sobreposição legada,
uma comparação (diff) face à sobreposição atualmente ativa na central, e
por registador, se o gerador já consegue produzir uma entrada para ele e o que ainda falta (uma identidade de inversor não resolvida, uma associação de monitorização de strings em falta, um inventário ainda não capturado, e assim por diante).

A partir daqui, um administrador pode voltar a sondar um registador individual para preencher o que falta, limpar a sobreposição e implementar a configuração gerada — sem renomear qualquer componente nem perder o seu histórico. Esta é uma ferramenta de migração interna, não uma definição orientada ao cliente: existe para que as últimas centrais escritas à mão possam passar para a mesma configuração gerada que todas as outras centrais já utilizam.

Guias Relacionados

Gerir Dispositivos de Rede — descobrir e classificar os dispositivos contra os quais um registador é configurado
Configurar Componentes — associar as métricas recolhidas a inversores, strings e caixas de junção
Data Scraper — como os adaptadores recolhem, normalizam e encaminham os seus dados
Solicitar uma Integração — pedir ao Mirox para adicionar um adaptador para um dispositivo não suportado
Utilizar o Proxy — abrir a interface web do próprio dispositivo no navegador usando credenciais guardadas