ElipseDocsDocumentação
PDF

Configuração das Propriedades

Os parâmetros de configuração para efetuar comunicação com o sistema Metasys, estão disponíveis na Janela de Propriedades do Driver.

clip0001.png

PROPRIEDADE DESCRIÇÃO
Metasys Server Nome DNS ou endereço IP do Servidor Metasys ou concentrador NAE
User/Password Nome do usuário e senha para Login
User2/Password2 Nome do usuário e senha para Login alternativo, em caso de falha do primeiro usuário (depois de 2 retentativas de login)
Cache File Path Nome de diretório onde serão salvos e lidos os arquivos de cache e dos significados das Enums. Ao total são 3 tipos de arquivos:
- Arquivo de GUID´s (MetasysGUID.txt) contém os códigos internos de cada objeto Metasys, que são armazenados em arquivo cache pelo driver para acelerar o processo de inicialização
- Arquivos de Cache de Comandos e Estados (DeviceName_MetasysStateCache.txt) contém a descrição do signficado de estados e comandos dos objetos marcados com N1>0, que são armazenados em um arquivo de cache por controladora NAE, para acelerar o processo de inicialização e tradução dos significados para valores numéricos 0 e 1.
- Arquivos de nomes de estados (MetasysState0.txt e MetasysState1.txt) contém os nomes dos diversos estados que correspondem ao valor 0 e ao valor 1 respectivamente.
Se não for informado um diretório, os arquivos serão salvos na mesma pasta onde está a dll do driver.
Force New Login After (s) Força um novo login independente da data de expiração do token. Deixe em 0 para desabilitar.
Protocol Version V3: Utiliza apenas leitura por polling
V4: Permite a leitura por polling e por eventos (assinaturas)
Read Method Polling: realiza a leitura dos tags por polling, pode ser usado na V3 e V4;
Events: realiza a leitura dos tags por assinaturas, pode ser usado apenas na V4;
ByTag(N2): permite escolher a cada tag, no parametro N2, se vai ser lido por polling ou por eventos. Pode ser usado apenas na V4, sendo que N2=0 (polling) e N2=1 (eventos).
Subscription Renew (s) Quando usado o método de leitura de um tag via eventos, caso o valor do tag não mude dentro deste intervalo máximo em segundos, será feita uma nova assinatura, o que força a atualização do tag. Caso o valor recebido seja identico ao existente, o tag não será atualizado, exceto se a propriedade EnableDeadBand estiver em FALSE.
Polling Options Opções relacionadas ao funcionamento via polling
Items per Read Request Indica quantos itens podem ser solicitados no máximo a cada pedido de comunicação. O valor mínimo é 1. Esta opção também é usada nas assinaturas de eventos para definir quantos items podem ser assinados na mesma mensagem.
Inter-Request Delay (ms) Informa um tempo padrão em milisegundos de atraso entre pedidos de leitura para todas as NAEs. Será usado caso uma NAE não tenha seu proprio delay informado no tag InterReqDelayMS.
Force New Login After Consec Errors Força um novo login depois de um numero de erros de leitura consecutivos. Deixe em 0 para desabilitar.
Force New Login with Read Error Rate > % Força um lovo login se a taxa média de erros (em porcentagem) for maior do que a informada neste campo. Deixe em 0 para desabilitar.
Read Ahead After Cmd - Wait Time (s) Tempo de espera para realizar a leitura de um tag de status associado a um comando. Esta associação é feita através do arquivo MetasysReadAhead.txt
Full Logs Informa se os logs do driver (quando habilitados) serão gerados com informações detalhadas da comunicação.

Além da Janela de Propriedades, estas configurações também podem ser definidas em tempo de execução nas aplicações NaN ou Elipse Power. Para isto, inicialize o Driver em modo Offline, ou seja, execute a aplicação com a opção Start driver OFFLINE habilitada, configurável na aba Setup da Janela de Propriedades. As opções de configuração deste Driver estão descritas na tabela a seguir.

Opções de configuração do Driver JCI Metasys

Parâmetro String da Propriedade Offline Tipo de Dado Descrição
Metasys Server Metasys.UseChecksum Texto Nome do Servidor Metasys
User Metasys.User Texto Usuário para Login
Password Metasys.Password Texto Senha para Login
Cache File Path Metasys.GUIDPath Texto Diretório de Cache
Items per Read Request Metasys.MaxItemsRead Texto Numero máximo de items por pedido de leitura
Protocol Version Metasys.APIVersion DWord 3 ou 4
Read Method Metasys.ReadConfig DWord 0 = polling, 1 =Eventos, 2 = by Tag
Inter Request Delay Metasys.InterReqDelay Dword Delay entre leituras
Force New Login after (s) Metasys.ForceLoginTime Dword Forçar novo login após x segundos
Force New Login after consec errors Metasys.ForceLoginConsecErrors Dword Forçar novo login após x erros consecutivos
Force New Login with read error rate Metasys.ForceLoginReadErrorRate Dword Forçar novo login se taxa de falha for superior a x
Read Ahead After Cmd - Wait Time Metasys.ReadAheadWaitTime Dword Tempo de espera para leitura de status após comando
Full Logs Metasys.FullLogs Int Habilita Logs completos

Estas propriedades podem ser escritas através de um tag com os parâmetros N1 igual a -1 (menos um), N2 igual a 0 (zero), N3 igual a 0 (zero) e N4 igual a 3 (três).