Informação Geral

Apresentação

Este documento apresenta as principais características da Extensão de Action.NET para o cadastramento de Equipamentos em um projeto de gateway de comunicação de Equipamentos. Neste formato de projeto, cada equipamento será um objeto de dados, incluído em um ATIVO que define a subestação e o alimentador em que o religado está conectado.

Esta customização inclui a geração de objetos de dados, telas de supervisão, canais de comunicação com os Equipamentos e com um centro de operações clientes, definição dos pontos e seus endereços, definição de itens de alarme e de dados para historiador.

Para a execução desta customização foi criada uma extensão de aplicativo, Gateway de Equipamentos com o objetivo de permitir ao usuário final a utilização de uma janela de entrada de dados, em que é feita a definição do nome e de outras características do equipamento e de parâmetros para a comunicação. necessários a implementação

Características principais

Inicialmente foi criado um projeto completo com diversas telas para mostrar o estado atual dos Equipamentos e dos dados, como medidas, estados dos Equipamentos e janelas para o comando.

O projeto base já tem definidos:

• Diversos modelos de dados com tags para supervisionar e comandar Equipamentos de diferentes fabricantes;

• Símbolos gráficos para representar os Equipamentos e seus estados principais em telas.

• Arquivos CSV, um para cada tipo de equipamento com parametrização adequada para a criação de canais e nodes de comunicação, bem como os pontos e seu endereçamento.

• A extensão receberá os dados do equipamento a ser criado, nome, nível de localização, tipo – fabricante, e endereços para comunicação (ied e tcpIp)

• A extensão criará o objeto equipamento, itens de alarme, itens de historiador.

• A extensão criará também no projeto a lista de pontos com seus endereços para a aquisição de dados e envio de comandos dos Equipamentos utilizando os protocolos DNP3 e IEC104.

• Para a funcionalidade de gateway com o centro de operações serão criados os pontos para os canais de comunicação, e nodes deste tipo de comunicação.

Modelo de Dados

A extensão utilizada para o cadastramento de Equipamentos no Gateway se baseia na arquitetura e no modelo de dados utilizado para o desenvolvimento do projeto com base no Action.NET.

Basicamente é utilizada a funcionalidade de ATIVOS para a separação e hierarquização dos OBJETOS. Cada equipamento por sua vez, será definido como sendo um objeto de dados e estará alocado em um destes ativos.

Cada tipo de equipamento utilizará um template próprio, segundo seu mapa de dados, e terá suas características definidas em um arquivo de configuração próprio.

Cada equipamento fará a comunicação com o Gateway através de um NODE de comunicação.

Os Canais de comunicação poderão acomodar vários Nodes.

Ativos (Níveis)

Os ATIVOS ou níveis serão utilizados para representar as Subestações e os alimentadores de cada subestação. Os Equipamentos estarão alocados nestes alimentadores.

A figura a seguir exemplifica esta alocação. Há uma Subestação cuja sigla é AGF, são mostrados dois de seus alimentadores. A01I7 e A01S4. Nestes alimentadores estão os objetos que representam os Equipamentos.

A medida que novos Equipamentos de subestações ainda não incluídas no projeto precisam ser cadastrados, estas subestações e seus alimentadores devem ter suas siglas incluídas nesta arvore, antes da inclusão do equipamento propriamente.

Image Removed

Objetos e Tipos

Os objetos de dados, no Action.NET contém as representações dos dados de um equipamento equipamento.

Para Equipamentos de modelos diferentes foram construídos protótipos de dados compatíveis com o mapa de dados do equipamento.

Alguns modelos de dados (Tipos) servem para mais do que um único equipamento.

A figura a seguir mostra um exemplo de Equipamentos, os Ativos em que estão contidos e seu tipo de dados (protótipo utilizado)

Image Removed

Na figura seguinte temos um exemplo de um tipo utilizado para um religador é o tipo REL_BASE2

Que tem seus dados incluídos em quatro subtipos: Parte de Comunicação (INT), Comandos (CMD), Medições (MED), Proteções (PROT) e estados (STA).

Image Removed

Cada um destes subtipos contém os pontos de fato, com tipos básicos, que são os que realmente estão no mapa de dados dos Equipamentos. A figura mostra um exemplo de subtipo STA.

Image Removed

Arquivos de configuração

Funcionalidade

Cada equipamento a ser cadastrado tem seu mapa de pontos, tem seu template próprio (tipo), pode ter protocolos de comunicação e parâmetros de comunicação diferentes.

Para simplificar este cadastramento criou-se arquivos simples de texto com a parametrização, um para cada tipo de equipamento.

Assim a extensão Gateway de Equipamentos se utiliza destes arquivos para fazer o cadastramento do objeto equipamento e dos itens de endereçamento de pontos. Quando o usuário for cadastrar um equipamento, definirá o nome do equipamento e seu tipo. Com a indicação do tipo, a extensão acessa o arquivo de parametrização apropriado e faz a geração dos dados no projeto.

Estes arquivos tem o nome REL_XXXX.CSV, onde XXXX é o nome atribuído a este tipo de equipamento. Devem ser colocados no mesmo diretório em que está o projeto Action.NET Gateway.

Para cada tipo de equipamento deverá também ser criada uma categoria com o mesmo nome do arquivo, no caso REL_XXXX. EStas categorias serão atribuídas aos tag objects criados, para que possam ser pesquisados em tempo real por estes agrupamentos.

A extensão verifica os arquivos existentes e apresenta ao usuário uma lista de tipos de Equipamentos criada a partir destes arquivos existentes. A figura mostra um exemplo de diretório com os arquivos de parametrização.

Image Removed

Para este conjunto de arquivos a extensão irá mostra para o usuário escolher o tipo de equipamento a ser criado, a lista da figura a seguir:

Image Removed

Conteúdo dos arquivos de parametrização

A figura a seguir apresenta uma parte de um dos arquivos de parametrização. Este é o arquivo utilizado para a parametrização do equipamento tipo NOJA. Também estão no arquivo a parametrização para a criação dos objetos CANAL e NODE (Nó) dentro do canal.

O nome do Canal a ser criado terá o prefixo CHA_ seguido do nome do equipamento, se não for indicado especificamente na tela de parametrização.

O nome do node a ser criado terá o prefixo NOD_ seguido do nome do equipamento. Se se desejar outro prefixo ou sem prefixo pode ser definido no parâmetro PrefixNode dentro do arquivo de Equipamentos, explicado abaixo

O conteúdo possui chaves em cada linha sendo descrito a seguir:

Template: O nome do template que deve ser utilizado na criação do objeto que vai representar este equipamento. No caso o template REL_BASE.

Protocol: O nome do protocolo de comunicação utilizado por este equipamento. No caso DNP3V2. Este nome de protocolo será utilizado pela extensão para criar o registro de Canal (DeviceChannel) no projeto Action.NET.

PrefixNode: O nome a ser usado para o NODE será este prefixo aqui definido seguido do nome do equipamento. Se o prefixo for vazio, o nome do node será o mesmo do equipamento.

ProtocolOptions: É o texto que será definido na criação do canal para a sua parametrização. Pode ser incluído no arquivo em várias linhas, que serão concatenadas pela extensão e colocadas no campo ProtocolOptions do DeviceChannel.

Timeout: É o texto que será utilizado para o campo Timeout da parametrização do DeviceChannel

TagForCommStatus: Deve conter o formato do nome do tag a ser utilizado para conter o status de comunicação do node, quando em tempo real. No exemplo, RE_NOME.INT.COM. A extensão ao cria o NODE colocará este texto no parâmetro do Node que indica o Tag de status de comunicação. O texto RE_NOME será substituído pelo nome real do equipamento sendo criado.

PrimaryStation: O texto que segue deve ser o mesmo que se teria ao criar um node para o canal em questão. O nome do node a ser criado terá o prefixo NOD_ seguido do nome do equipamento. A extensão ao criar este node trocará os textos “IP.IP.IP.IP”, PORT e IED respectivamente pelo endereço IP, Porta e endereço do IED que serão digitados pelo usuário ao entrar os dados na janela da extensão. A palavra TAGCOMM será substituída pelo nome do tag de status de comunicação, indicado acima.

BackupStation: O mesmo que o PrimaryStation para a segunda estação ou rede.

Tabela POINTS - TagName Node Address – Base para o node cliente para o equipamento

As linhas seguintes são o conjunto de linhas que deveriam ser criadas na tabela POINTS para a comunicação com o equipamento. Apenas as colunas TagName e Node devem ter estes nomes RE_NOME para o nome do tag e NODE para o nome do Node. A extensão fará a substituição pelo nome do equipamento e do node específicos para o equipamento sendo cadastrado. As colunas de tipo, endereço e scalling devem conter os conteúdos corretos para cada um dos pontos do mapa do equipamento

Image Removed

Base para o node Servidor para o Centro

Neste mesmo arquivo, após todos os pontos para comunicação com o equipamento, haverá mais um conjunto de pontos a serem utilizados para a comunicação com o centro de operações através do protocolo IEC 60870-104. A figura a seguir mostra alguns destes pontos. Eles seguem a palavra-chave ServerNode. Da mesma, estas descrições devem ser feitas através de cópia de um primeiro protótipo cadastrado neste node da tabela POINTS.

Endereçamento no IEC 104

Por default, O aplicativo de extensão utilizará para cada equipamento a faixa de endereços de 1000, a ser somada aos endereços definidos no arquivo de parametrização. Para cada novo equipamento um novo milhar: O primeiro 1000, o segundo 2000 e assim por diante.

Image Removed

Alternativamente o endereçamento pode ser sequencial por tipo de ponto. A cada novo equipamento serão utilizados endereços sequencias, por tipo de ponto, a partir dos endereços mais altos existentes até então. Para se usar esta opção deve-se incluir, após o texto ServerMode, o texto AddressByType, como mostrado na figura seguinte.

Image Removed

Endereçamento para equipamentos no protocolo IEC61850

Para a descrição das tabelas de pontos de nodes clientes em protocolo IEC 61850, se se desejar que o campo Address fique mais genérico , facilitando a inclusão da definição do Logical Node, deve-se iniciar o campo endereço com o texto TYPE:<LOGICALDEVICE>.

Ao especificar o nome do equipamento a ser gerado, deve-se incluir a definição do Logical Node que corresponderá , seguindo ao nome na forma NOME\LOGICALNODE. O tipo de ponto será automaticamente gerado para o IEC 61850, de acordo coma Functional Constraint incluída no endereço, no exemplo MX.

General Information

Presentation

This document presents the main characteristics of the Action.NET Extension for the registration of Equipment in an Equipment communication gateway project. In this project format, each equipment will be a data object, included in an ASSET that defines the substation and the feeder to which the reconnected is connected.

This customization includes the generation of data objects, supervision screens, communication channels with the Equipment and with a customer operations center, definition of points and their addresses, definition of alarm items and data for the historian.

To perform this customization, an application extension was created, Equipment Gateway with the objective of allowing the end user to use a data entry window, in which the name and other characteristics of the equipment and parameters for communication are defined. necessary for implementation

Key features

Initially, a complete project was created with several screens to show the current state of the Equipment and data, such as measurements, equipment statuses and windows for the command.

The base project has already defined:

• Several data models with tags to supervise and command Equipment from different manufacturers;

• Graphic symbols to represent the Equipment and its main states on screens.

• CSV files, one for each type of equipment with adequate parameterization for the creation of communication channels and nodes, as well as the points and their addressing.

• The extension will receive the data of the equipment to be created, name, location level, type – manufacturer, and addresses for communication (ied and tcpIp)

• The extension will create the Equipment object, alarm items, historian items.

• The extension will also create in the project the list of points with their addresses for the acquisition of data and sending commands from the Equipment using the DNP3 and IEC104 protocols.

• For the gateway functionality with the operations center, points will be created for the communication channels, and nodes of this type of communication.

Data Model

The extension used for the registration of Equipment in the Gateway is based on the architecture and data model used for the development of the project based on the Action.NET.

Basically, the ASSETS functionality is used for the separation and hierarchization of OBJECTS. Each piece of equipment, in turn, will be defined as a data object and will be allocated to one of these assets.

Each type of equipment will use its own template, according to its data map, and will have its characteristics defined in its own configuration file.

Each equipment will communicate with the Gateway through a communication node.

Communication Channels will be able to accommodate multiple Nodes.

Assets (Levels)

The ASSETS or levels will be used to represent the Substations and feeders of each substation. The equipment will be allocated to these feeders.

The following figure exemplifies this allocation. There is a Substation whose acronym is AGF, two of its feeders are shown. A01I7 and A01S4. In these feeders are the objects that represent the Equipment.

As new substation equipment not yet included in the project needs to be registered, these substations and their feeders must have their acronyms included in this tree, before the inclusion of the equipment itself.

Image Added

Objects and Types

Data objects in the Action.NET contain the representations of the data of a piece of equipment.

For equipment of different models, data prototypes compatible with the equipment data map were built.

Some data models (Types) are used for more than a single piece of equipment.

The following figure shows an example of Equipment, the Assets in which it is contained and its data type (prototype used)

Image Added

In the following figure we have an example of a type used for a recloser is type REL_BASE2

Which has its data included in four subtypes: Communication Part (INT), Commands (CMD), Measurements (MED), Protections (PROT) and States (STA).

Image Added

Each of these subtypes contains the fact points, with basic types, which are the ones that are actually in the Equipment data map. The figure shows an example of an STA subtype.

Image Added

Configuration files

Functionality

Each equipment to be registered has its map of points, has its own template (type), can have communication protocols and different communication parameters.

To simplify this registration, simple text files were created with the parameterization, one for each type of equipment.

So the extension Equipment Gateway uses these files to register the equipment object and the point addressing items. When the user is going to register a piece of equipment, he will define the name of the equipment and its type. With the type indication, the extension accesses the appropriate parameterization file and generates the data in the project.

These files have the name REL_XXXX.CSVwhere XXXX is the name given to this type of equipment. They must be placed in the same directory as the Action.NET Gateway project.

For each type of equipment, a category must also be created with the same name as the file, in this case REL_XXXX. These categories will be assigned to the created tag objects, so that they can be searched in real time by these groups.

The extension scans the existing files and presents the user with a list of Equipment types created from these existing files. The figure shows an example directory with the parameterization files.

Image Added

For this set of files, the extension will show the user to choose the type of equipment to be created, the list in the following figure:

Image Added

Contents of the parameterization files

The following figure shows a portion of one of the parameterization files. This is the file used for the parameterization of the type equipment NOJA. Also in the file are the parameterization for the creation of the CHANNEL and NODE objects within the channel.

The name of the Channel to be created will have the prefix CHA_ followed by the name of the equipment, if it is not specifically indicated on the parameterization screen.

The name of the node to be created will have the prefix NOD_ followed by the name of the equipment. If you want another prefix or no prefix can be defined in the parameter PrefixNode within the Equipment file, explained below

The content has curly brackets on each line and is described as follows:

Template: The name of the template that should be used in the creation of the object that will represent this equipment. In this case, the template REL_BASE.

Protocol: The name of the communication protocol used by this equipment. In this case DNP3V2. This protocol name will be used by the extension to create the Channel record (DeviceChannel) in the Action.NET project.

PrefixNode: The name to be used for the NODE will be this prefix defined herein followed by the name of the equipment. If the prefix is empty, the name of the node is the same as the name of the equipment.

ProtocolOptions: It is the text that will be defined in the creation of the channel for its parameterization. It can be included in the file on multiple lines, which will be concatenated by the extension and placed in the ProtocolOptions field of the DeviceChannel.

Timeout: This is the text that will be used for the Timeout field of the DeviceChannel parameterization

TagForCommStatus: It must contain the format of the tag name to be used to contain the communication status of the node, when in real time. In the example, RE_NOME.INT.COM. The extension to create the NODE will place this text in the Node parameter that indicates the Communication Status Tag. The text RE_NOME will be replaced with the actual name of the equipment being created.

PrimaryStation: The text that follows should be the same as if you created a node for the channel in question. The name of the node to be created will have the prefix NOD_ followed by the name of the equipment. The extension when creating this node will swap the texts "IP. IP. IP. IP", PORT and IED respectively by the IP address, Port and IED address that will be entered by the user when entering the data in the extension window. The word TAGCOMM will be replaced with the name of the communication status tag, indicated above.

BackupStation: Same as PrimaryStation for the second station or network.

POINTS Table - TagName Node Address – Base for the client node for the equipment

The following rows are the set of rows that should be created in the POINTS table for communication with the equipment. Only the TagName and Node columns should have these names RE_NOME for the tag name and NODE for the Node name. The extension will replace it with the name of the equipment and the specific node for the equipment being registered. The type, address and scalling columns must contain the correct content for each of the points on the equipment map

Image Added

Base for the Server node for the Center

In this same file, after all the points for communication with the equipment, there will be another set of points to be used for communication with the operations center through the IEC 60870-104 protocol. The following figure shows some of these points. They follow the keyword ServerNode. In the same way, these descriptions must be made by copying a first prototype registered in this node of the POINTS table.

Addressing in IEC 104

By default, the extension application will use for each device the address range of 1000, to be added to the addresses defined in the parameterization file. For each new piece of equipment a new thousand: The first 1000, the second 2000 and so on.

Image Added

Alternatively, addressing can be sequential by point type. For each new equipment, sequential addresses will be used, by type of point, from the highest addresses existing until then. To use this option, you must include, after the text ServerMode, The text AddressByType, as shown in the following figure.

Image Added

Addressing for equipment in the IEC61850 protocol

For the description of the point tables of client nodes in protocol IEC 61850, if you want the field Address to become more generic, facilitating the inclusion of the Logical Node definition, the address field should be started with the text TYPE:<LOGICALDEVICE>.

When specifying the name of the equipment to be generated, you must include the definition of the Logical Node that will correspond, following the name in the form NAME\LOGICALNODE. The point type will be automatically generated for IEC 61850, according to Functional Constraint included in the address, In the example MX.

Equipment Gateway

Extension

For the customization of a project, the extension Action.NET – Equipment Gateway de Equipamentos.

Com o projeto aberto vá em With the project open, go to Run > Extensions e clique no símbolo de Gateway de Equipamentosand click the Equipment Gateway.

Será mostrada a janela de parametrização para a criação das facilidades para supervisionar e controlar um novo equipamento, entre os tipos predefinidos, veja item seguinte.

A extensão obtém estes tipos a partir da verificação dos nomes de arquivos CSV de parametrização de Equipamentos existentes no diretório do projeto (descrição do conteúdo destes arquivos é apresentada em itens anteriores).

Janela de Parametrização

A figura mostra a janela de parametrização apresentada pela extensão Gateway de Equipamentos

Configuração individual

O usuário que está querendo cadastrar um novo equipamento deverá preencher os campos mostrados. Veja os significados a seguir.

Nome do equipamento – Preencher com o nome que será atribuído ao equipamento. Este é o Tagname do objeto. Assim este nome deve ser normalizado com as regras do Action.NET. Iniciar por letra e conter apenas letras, números e o caractere “underscore” (_ ).

Ativo – Escolher um dos pares Sigla de Subestação e sigla de Alimentador mostrados na lista.

Tipo - escolher um dos tipos disponíveis de equipamento, correspondente ao que está sendo cadastrado.

Endereço Ied – Endereço utilizado pelo IED para o protocolo em questão.

Comunicação – Marcar a opção se deve ser definido um novo canal para este IED ou se será utilizado um canal já existente.

• New Channel - Se for marcada esta opção deve-se preencher o campo seguinte com o nome do canal.

• Canal Existente - Neste segundo caso, deverá ser escolhido na lista a seguir o nome do canal já existente em que o novo node deve ser incluído;

Ip Primario / Porta - Preencher com o endereço IP da estação ou rede principal de comunicação.

Ip Secundário / Porta - Preencher com o endereço IP da estação ou rede secundária de comunicação.

Serial - A direita dos campos de IP e Porta há uma opção para uso de comunicação serial. Se for esta a forma de comunicação , escolha a porta serial a ser utilizada.

Image Removed

ServerNode – Escolher o nome de node servidor IEC104 em que devem ser incluídos os pontos deste equipamento, para serem servidos ao centro de operações. Estes canais deverão ser criados manualmente pelo usuário. Esta extensão não faz este serviço.

Após esta configuração pressione o botão CRIAR, para realizar o cadastramento do equipamento. Durante esta atividade algumas mensagens aparecem no campo acima do botão mostrando o progresso da execução.

.

Image Removed

Veja na tabela de Objetos os novos tags criados. Nas tabelas de AlarmItens, Historian e de Points, veja os itens criados. Também são criados convenientemente os Canais e Nodes.

Configuração de vários Equipamentos

Nesta mesma janela pode-se também disparar a configuração de vários Equipamentos de uma única vez. Para isto deve-se fazer um arquivo texto de configuração com os dados para cada equipamento a ser criado.

Coloca-se então este arquivo no diretório de projetos e clicando o botão ao lado do campo Arquivo de Configuração, aparece uma janela para a escolha do arquivo.

Image Removed

Após isto pressione o botão CRIAR. A extensão inicia o trabalho lendo cada linha do arquivo de configuração. Aparecerá nos campos da janela os textos encontrados no arquivo. Serão criados um a um todos os Equipamentos definidos no arquivo.

Conteúdo do Arquivo

O arquivo deve ter uma linha para cada equipamento. A linha de cabeçalho indica os campos que devem ser preenchidos separados por virgulas. Pode-se inclui linhas de comentários iniciado por “//”.

A palavra NEW: deve ser utilizada antes do nome do canal sempre que de desejar a criação de novo canal. Em caso contrário o nome do canal em que o node deve ser incluído.

Image Removed

Parametrizações alternativas

A utilização normal desta extensão para a geração de projetos é a que foi apresentada no item Modelo de Dados. Isto é, cada equipamento gera um tag objeto, tem um template próprio, uma arquivo de definição de suas características basicamente do no de comunicação, e gera um no de comunicação que pode ser colocado em um canal próprio ou compartilhado com outros nós.

A utilização desta extensão para configurações alternativas tem sido feita mediante a incorporação de novos parâmetros que definem estas funcionalidades adicionais ou alternativas. Os itens a seguir apresentam estas parametrizações.

Arquivo de Definição do Equipamento

Image Removed

NodeUnique: - Este parâmetro permite que se defina que o nó a ser gerado por este equipamento não seja um novo, mas um mesmo para todos os equipamentos que forem definidos para um mesmo canal.

pode ser definido: NodeUnique:Channel - Informando que o equipamento deve ter seus pontos criados em um nó com o mesmo nome do canal para o qual foi especificado, sem este parâmetro o no será definido com o nome do próprio equipamento. Também poderá ser utilizado NomeUnique:<Nomedeumcanal> , neste caso o nome do nó será fixo, usando o nome atribuído de canal.

Nos dois casos o nome do nó será o do canal trocando o prefixo CHA_ por NOD_ (ou pelo texto definido em PrefixNode, explicado anteriormente.

AddressStepByIed:- deve ser usado em conjunto com o parâmetro anterior, pois se vários equipamentos de mesmo tipo forem criados os seus mapas de endereços serão iguais. Este parâmetro define como deslocar o endereçamento para cada novo equipamento. Se um único tipo de ponto for usado, basta colocar este valor de deslocamento neste parâmetro. Se houver deslocamentos diferentes conforme o tipo, isto será especificado na sequencia.

O formato da definição é este: <tipo>=<deslocamento>;<tipo>=<deslocamento>;…

Exemplos

The parameterization window for the creation of facilities to supervise and control a new equipment will be displayed, among the predefined types, see the next item.

The extension obtains these types by checking the names of existing Equipment parameterization CSV files in the project directory (description of the contents of these files is presented in previous items).

Parameterization Window

The figure shows the parameterization window presented by the extension Equipment Gateway

Individual configuration

The user who wants to register a new equipment must fill in the fields shown. See the meanings below.

Equipment Name – Fill in the name that will be assigned to the equipment. This is the Tagname of the object. Thus, this name should be normalized with the rules of the Action.NET. Start with a letter and contain only letters, numbers, and the "underscore" (_ ) character.

Active– Choose one of the Substation Acronym and Feeder Acronym pairs shown in the list.

Kind- choose one of the available types of equipment, corresponding to the one being registered.

Address Ied – Address used by the IED for the protocol in question.

Communication– Select the option whether a new channel is to be defined for this IED or whether an existing channel is to be used.

• New Channel - If this option is checked, the following field must be filled in with the name of the channel.

• Existing Channel - In this second case, the name of the existing channel in which the new node should be included should be chosen from the following list;

Primary Ip/Port - Fill in the IP address of the main communication station or network.

Secondary Ip/Port - Fill in the IP address of the secondary communication station or network.

Serial- To the right of the IP and Port fields is an option for using serial communication. If this is the form of communication, choose the serial port to use.

Image Added

ServerNode – Choose the IEC104 server node name in which the points of this equipment should be included, to be served to the operations center. These channels must be created manually by the user. This extension does not do this service.

After this setting press the CREATE to register the equipment. During this activity, some messages appear in the field above the button showing the progress of the execution.

.

Image Added

See the table of Objects the new tags created. In the tables of AlarmItens, Historian and Points, View the items created. Also conveniently created are the Channels and Nodes.

Multi-Device Configuration

In this same window you can also trigger the configuration of several Equipment at once. For this, a configuration text file must be made with the data for each equipment to be created.

This file is then placed in the project directory and by clicking the button next to the Configuration File field, a window appears to choose the file.

Image Added

After this press the CREATE button. The extension starts the job by reading each line of the configuration file. The texts found in the file will appear in the fields of the window. All the Equipment defined in the file will be created one by one.

File Contents

The file must have one line for each piece of equipment. The header row indicates the fields that must be filled in separated by commas. You can include comment lines beginning with "//".

The word NEW: should be used before the channel name whenever you want to create a new channel. Otherwise, the name of the channel in which the node should be included.

Image Added

Alternative parameterizations

The normal use of this extension for project generation is the one presented in the Data Model item. That is, each piece of equipment generates an object tag, has its own template, a file defining its characteristics, basically the communication node, and generates a communication node that can be placed in its own channel or shared with other nodes.

The use of this extension for alternative configurations has been done by incorporating new parameters that define these additional or alternative features. The following items present these parameterizations.

Equipment Definition File

Image Added

NodeUnique:- This parameter allows you to define that the node to be generated by this equipment is not a new one, but the same one for all equipment that is defined for the same channel.

can be defined: NodeUnique:Channel - Informing that the equipment must have its points created on a node with the same name as the channel for which it was specified, without this parameter the node will be defined with the name of the equipment itself. It can also be used UniqueName:<Nomedeumcanal> , in this case the node name will be fixed, using the assigned channel name.

In both cases, the name of the node will be that of the channel by changing the prefix CHA_ by NOD_ (or by the text defined in PrefixNode, explained earlier.

AddressStepByIed:- It should be used in conjunction with the previous parameter, because if several devices of the same type are created, their address maps will be the same. This parameter defines how to shift the addressing to each new device. If a single point type is used, simply put this offset value in this parameter. If there are different offsets depending on the type, this is specified in the sequence.

The format of the definition is this: <tipo>=<deslocamento>;<tipo>=<deslocamento>;...

Category - Os tag objetos criados nesta geração normalmente o são com a categoria definida para seu tipo, igual ao nome de arquivo de parâmetro do equipamento. Caso se deseja que além desta categoria também sejam colocadas outras categorias, também já existentes no projeto, os nomes desta categorias devem ser definidos neste parâmetro.

Category - Object tags created in this generation are typically with the category defined for their type, equal to the parameter file name of the equipment. If it is desired that in addition to this category other categories are also placed, also existing in the project, the names of these categories must be defined in this parameter.

Arquivo de Configuração (lista de equipamentos a serem criados)

Configuration File (list of equipment to be created)

Some of the configurations presented here cannot be made when generating a single device, using the Extension Configuration Dialog.

description - Este campo não existe na Janela de Configuração. Pode seu utilizado para incluir um texto à coluna Description da definição de um tag object. Saõ acaeitas as seguintes alternativas:

<texto qualquer> Este texto será colocado na coluna description;

LEVEL - Se colocada esta palavra, será incluído o nome do LEVEL, (asset) na coluna de descrição

LEVELNAME - Se colocada esta palavra, será incluído o nome do LEVEL, (asset) seguido de “;” e do nome da tag na coluna de descrição

Assets (levels sem definição previa) - Na utilização da geração através deste arquivo, os LEVEL (assets) atribuídos poderão ainda não existir no projeto. Serão então automaticamente criados antes da incliusão do tag object

Objetos (equipamentos ou bays) sem Comunicação - Pode-se também utilizar este arquivo para a geração de objetos com tipos (templates) que não tem nenhum ponto de comunicação. Neste caso não precisa existir o Arquivo de Definição do equipamento. É o caso da linha na figura acimaThis field does not exist in the Configuration Dialog. You can use it to include text in the Description column of an object tag's definition. The following alternatives are accepted:

<any text> This text will be placed in the description column;

LEVEL - If you enter this word, the name of the LEVEL, (asset) will be included in the description column

LEVELNAME - If you enter this word, the name of the LEVEL, (asset) followed by ";" and the name of the tag in the description column will be included

Assets (levels without prior definition) - When using generation through this file, the assigned LEVEL (assets) may not yet exist in the project. They will then be automatically created before the object tag is included

Objects (equipment or bays) without Communication - You can also use this file to generate objects with templates that have no communication point. In this case, there is no need for the equipment's Definition File. This is the case of the line in the figure above, ST_STATE,MePDCL,SDSF que define ser criado um tag object com o tipo SDSFm no Asset MePDCL, com o nome that defines to create an object tag with the type SDSFm in Asset MePDCL, with the name ST_STATE.

Bays (ou equipamentosor equipment) repetidos - Para o caso de criação de vários bays com um mesmo nome seguido apenas de um numero para sua caracterização como Alimentador1, Alimentador2, etc, em que todas as características são as mesmas, apenas com esta diferenciação, pode-se repetir as várias linhas alterando os nomes ou pode-se utilizar o qualificados *N no final do nome do equipamento.

Exemplo:

repeated - In the case of creating several bays with the same name followed only by a number for its characterization as Feeder1, Feeder2, etc, in which all the characteristics are the same, only with this differentiation, one can repeat the various lines by changing the names or one can use the qualified *N at the end of the equipment name.