Devices e Interfaces

Os dispositivos no Action.NET são qualquer fonte de dados ao vivo em tempo real. Normalmente, um dispositivo é um PLC, outro projeto Action.NET, um servidor OPC, um Asset Manager ou Historian Server externo ou qualquer equipamento que tenha um protocolo de comunicação.

Devices and Interfaces

The devices in the Action.NET are any source of live data in real time. Typically, one device is a PLC, another design Action.NET, an OPC server, an external Asset Manager or Historian Server, or any equipment that has a communication protocol.

Data sources are connected through Channels. Each channel has an interface type (for example, RS-232, TCP/IP) e um protocolo específico do dispositivo. Um canal pode acessar várias estações (por exemplo, dispositivos) usando um protocolo comum.

Cada estação é chamada de Nó. Cada nó possui um ou mais pontos de dados. Os pontos de dados fornecem os valores de dados específicos a serem acessados ​​por meio de tags. Cada ponto de dados está vinculado a uma tag específica.

Finalmente, cada ponto de dados é associado a um Tipo de Acesso. Isso define as regras para leitura e gravação de valores neste ponto de dados, como taxa de pesquisa, se uma leitura é realizada na inicialização e se a entrada não solicitada é aceita.

Em resumo, a configuração do Módulo de Dispositivo é executada em 3 etapas:

1. Defina o equipamento (e protocolos) que o projeto usará em Editar → Dispositivos → Canais.

2. Definiu os nós, ou estações PLC relacionadas a cada canal, em Editar → Dispositivos → Nós

3. Mapeie os Tags em seu modelo de dados para endereços nos dispositivos, em Editar → Dispositivos → Pontos.

Opcionalmente, você pode personalizar ou criar novos AccessTypes, mapeando grupos de Tags de requisitos de comunicação semelhantes para o mesmo AccessType.

Para agilizar a configuração, o Action.NET fornece muitos Assistentes de importação que criarão automaticamente os tags e mapeamento de dispositivos usando a configuração do PLC ou outra fonte de informação disponível.

Veja o Apendice - Drivers de Comunicação para uma lista completa de protocolos de comunicação disponíveis no Action.NET.

Configurando Canais

Canais em Action.NET são os objetos que implementam meios de comunicação utilizados para a comunicação do ambiente do SCADA com os PLCs e outros IEDs. Muitos protocolos internos estão disponíveis. Você deve configurar pelo menos um canal para cada protocolo que você precisa usar.

Para configurar canais:

1. Vá para Edit > Devices > Channels

2. Clique em Create New.

   • É mostrada a janela de criação de novo canal (figura a seguir)

Image Removed

• Digite ou selecione as informações, conforme necessário.

Coluna

Descrição

Channel Name

Digite um nome para o canal. O sistema indicará se o nome não é válido, mostrando a célula com o contorno vermelho.

Protocol

Selecione o protocolo que vai utilizar neste canal. Se você não vê um protocolo que você precisa, clique em Mais para fornecer informações para um novo protocolo.

Interface

Selecione o tipo de interface para este canal.

• Serial-Use para configurar os parâmetros seriais para redes RS232/485.

• MultiSerial-Use para configurações com várias portos RS-232.

• TCPIP-Use para Ethernet ou redes sem fio.
  Para mais informações sobre a configuração de protocolos comuns, clique em Help na parte superior da aba.

Description

Digite uma descrição para este canal.

• Clique OK.

• O canal é adicionado como uma nova linha na tabela.

• Digite ou selecione as informações para o novo Canal, conforme necessário.

Para mostrar ou esconder uma coluna, clique com o botão direito na área de cabeçalho da coluna e marque ou desmarque colunas.

Coluna

Descrição

Name

Digite um nome para o canal. O sistema indicará se o nome não é válido, mostrando a célula com o contorno vermelho.

Protocol

Mostra o protocolo que foi selecionado

ProtocolOptions

Configure as opções específicas para este protocolo.

Interface

Mostra a interface física usada por este canal.

Settings

Configure as definições para este canal. Os valores disponíveis dependem da interface que o canal está usando.
Nota: As configurações aqui devem corresponder às configurações do dispositivo mestre ou escravo com o qual o canal vai conectar.

• Para a interface serial, normalmente manter os padrões.

• Para uma interface MultiSerial, digite o número de portas RS-232 para usar no campo Portas.

• Para a interface TCPIP:

  • AcceptUnsolicited - Aceitar mensagem não solicitada de escravo.

  • ListeningPort- Porta TCP, onde o dispositivo escravo está ligado (o padrão é 502).

  • NodeConnection-Número de pedidos paralelos enviados para cada nó (comunicação assíncrona).

  • MaxSimultaneousConnections - Máximo número de conexões simultâneas.

  • ShareNodeSameIP-Um endereço IP único e vários escravos conectados. Por exemplo, RS485/Ethernet ou Terminal Servers.

Timeout

Configure as opções de tempo limite para este canal. Normalmente, mantenha o valor padrão.

IntialState

Selecione o estado inicial para este canal. Habilitado (Enabled) ou não (Disabled).Em qualquer destes casos a task do protocolo será disparada, podendo ser controlada em tempo real (habilitar ou desabilitar). Uma terceira opção Remote, é utilizada para disparo de canais cujos executáveis que vão controlar um objeto em outro servidor. A ultima opção Reserved deve ser utilizada para desabilitar completamente um canal (sem o disparo do driver) .

Remote Settings

No caso de se estar executando com o InitialState Remote, nesta coluna podem ser definidos os endereçõs IPs primário e de backup dos servidores nos quais será executado o módulo de comunicação deste canal.: PrimaryIP e BackupIP.

Description

Digite um texto com uma descrição para este canal.

[Outras colunas]

Para definições de outras colunas que estão disponíveis em muitas tabelas, consulte "Descrição de colunas comuns"

• Continue adicionando quantos canais você precisa.

• Se necessário, clique com o botão direito em uma linha para cortar, copiar, colar ou excluir uma linha

Configurando Nós

Os nós ou Nodos no Action.NET são os objetos que coincidem com os dispositivos IEDs, ou CLPs com os quais a aplicação deve se comunicar no canal em que estão conectados.
Você também pode importar as configurações de um servidor OPC ou de outra fonte de dados. Consulte "Importando de um Servidor OPC"  e "Importando endereços de PLCs".

Para configurar os nós:

1. Vá para Edit > Devices > Nodes.

2. Digite ou selecione as informações, conforme necessário.

   • Para mostrar ou esconder uma coluna, clique com o botão direito na área de cabeçalho da coluna e marque ou desmarque colunas.

Coluna

Descrição

Name

Digite um nome para o nó. O sistema indicará se o nome não é válido, mostrando a célula com o contorno vermelho.

Channel

Selecione o canal para este nó. Para mais informações sobre a configuração de protocolos comuns, clique em Help na parte superior da aba.

Insira as informações necessárias para acessar o nó principal, com base no protocolo selecionado.

Para o protocolo Modbus:

Para uma interface TCPIP:

BackupStation

Insira as informações necessárias para acessar o nó de backup, com base no protocolo selecionado. Quando definido, e uma falha de comunicação ocorre na estação principal, o sistema automaticamente tenta estabelecer
comunicação com a estação de Backup.

Description

Descrição Digite uma descrição para este nó.

• Continue adicionando tantos novos nós quantos você precisar.

Importando de um Servidor OPC

Depois de criar um nó de comunicação OPC, você pode selecionar o nó e clicar em Importar para importar o banco de dados do Servidor OPC para o projeto. O Action.NET cria automaticamente os Tags e os pontos de comunicação (tabela Points).
Depois de ter utilizado a ferramenta de importação, pela primeira vez, o sistema irá salvar as configurações utilizadas, de modo que o botão mostrará a partir de então a palavra SYNC, o que significa que na próxima vez que você usá-lo, será executada uma sincronização, verificando quais endereços já foram importados previamente e quais os novos.

Importando endereços de PLCs

Ao criar os nós de comunicação e pontos de comunicação (Points), você pode importá-los se eles são definidos em outra fonte de dados das seguintes formas:

• Você pode copiar e colar o conteúdo de uma tabela de Excel. As tabelas podem ter diferentes colunas ou ordem, desde que você inclua o título das colunas nas operações de copiar e colar. O sistema irá colocar os dados nas colunas esperadas, mesmo que a ordem seja diferente nas tabelas de origem e de destino.

• Você pode importar os dados de arquivos CSV.

• Para dispositivos Rockwell ControlLogix, você pode importar arquivos de definição L5K.

• Para dados OSIsoft PI ®, existe uma versão Action.NET para compartilhar definições.

• Está disponível também uma API de programação que pode ser usada para escrever scripts preencher as tabelas de Points, até mesmo em tempo de execução, quando é necessário.

Se o dispositivo PLC ou outro IED tem um banco de dados aberto ou arquivo com os endereços disponíveis, e você gostaria de ter uma forte integração para fazer essa configuração e carga de endereços Action.NET, contate o suporte.

Configurando endereços de pontos

A aba Points do espaço Devices é utilizada para definir os tags que serão adquiridos por este canal e node. Nela são especificados os tipos de pontos (conforme o protocolo) e os
identificadores (com os endereços) utilizados pelo protocolo para o mapeamento dos dados dentro dos IEDs.
O número de pontos de dados que você pode configurar está relacionada tanto ao ProductModel configurado para o projeto e sua licença para Action.NET. Para obter informações sobre os modelos de produtos, consulte "Família e Modelo do Produto" .

Para configurar os pontos de dados:

1. Vá para Edit > Devices > Points.

   • Você pode copiar e colar as etiquetas da aba Tag> Objetos.

2. Digite ou selecione as informações, conforme necessário.

   • Para adicionar ou remover uma coluna, clique com o botão direito na área de cabeçalho da coluna e marque ou desmarque colunas.

Coluna

Descrição

TagName

Digite um nome de tag ou clique ... para selecionar um tag. Você também pode criar uma nova tag neste ponto.

Node

Selecione o nó para este ponto de dados.

Address

Digite o endereço de registro, com base no PLC e protocolo para este ponto de dados e tag.
 
NOTA - As opções de protocolo são dependentes do protocolo selecionado. Selecione o protocolo na caixa de combinação na parte superior da página e pressione o botão HELP do seu lado para acessar a documentação do protocolo específico

DataType

Selecione o tipo de dados que você deseja usar. A maioria dos protocolos deve usar a opção nativa. Quando nativo é usado, o protocolo vai tratar automaticamente a conversão de dados.
Selecionando um diferentes tipos de dados substitui os padrões. Algumas opções podem não ser aplicáveis ao nó selecionado. Verifique se você sabe os tipos de dados aplicáveis.

Modifiers

Se o PLC usa uma ordem de byte diferente, selecione as opções desejadas. Você pode alterar a posição de bit, byte, Word ou DWORD dos dados que são usados na comunicação.

AccessType

Selecione o tipo de acesso para este ponto. Você pode configurar os tipos de acesso. Veja .em "Configurando Tipos de Acessos" .

Scaling

Se você quiser manipular o valor do tag, de alguma forma, selecione as opções desejadas. None, Linear,Equation, tagMinMax TagScaleMinMax
Para a opção Equation será aplicada quando da leitura dos dados:

• Div-O sistema irá dividir o valor recebido com o que você entra aqui.

• Add- O sistema irá adicionar a quantidade que você entra aqui como uma compensação para o resultado da divisão.

• Para uma operação de escrita, os cálculos são o oposto (multiplica o valor em Div, e em seguida, subtrair o valor Add).

Outras colunas

Para definições de outras colunas que estão disponíveis em colunas] muitas tabelas, consulte "Descrição de colunas comuns".

• Continue adicionando tantos pontos quantos você precisa.

Configurando Tipos de Acessos

Na aba de Tipos de Acesso (Access Types) são definidos os procedimentos de leitura e escrita, com tempos de amostragem, eventos não solicitados e outras propriedades, que serão utilizados no tratamento de cada um dos tags definidos na aba Points.
Você pode configurar os tipos de acesso que controlam ler, escrever e outras configurações quando o aplicativo acessa dados do PLC ou IED..
O Action.NET vem com alguns tipos de acesso predefinidos que você pode usar, ou você pode criar outros próprios, sempre de acordo com as possibilidades existentes no protocolo em questão,

Para configurar os tipos de acesso:

1. Vá para Edit > Devices > AccessTypes..

2. Siga um dos seguintes procedimentos:

   • Para editar um tipo de acesso existente, clique duas vezes em um campo.

   • Para criar um novo tipo de acesso, clique em Create New .

3. Digite ou selecione as informações, conforme necessário.

Coluna

Descrição

Name

Digite um nome para este tipo de acesso

Read

ReadPolling

PollingRate

Digite o período de amostragem em milissegundos

ReadTrigger

Digite uma propriedade de objeto para informar ao sistema quando deve ler o valor, por evento.

OnStartup

Quando selecionado, o sistema faz uma leitura na inicialização.

Write
WriteEnable

WriteEvent

Selecione o evento que vai disparar a escrita do valor: Pode escolher entre Change, ChangeUp ou ChangeDown ocorrido no valor.

WriteTrigger

Digite uma propriedade de objeto para informar ao sistema quando escrever o valor.

Settings
AcceptUnsolicited 

Quando selecionado, o sistema aceita valores de PLC, mesmo se o tempo de amostragem não tenha expirado.

UseStaticBlocks

Description

Digite uma descrição para o tipo de acesso.

[Outras colunas]

Para definições de outras colunas que estão disponíveis em muitas tabelas, consulte "Descrição de colunas comuns"

Objetos runtime Devices

O namespace Device é o ponto de entrada para todos os objetos relacionados com o módulo de dispositivos ou Devices.
O objeto Device.Channel lista todos os canais configurados e suas propriedades em tempo de execução.
O objeto Device.Node lista todos os nós configurados e suas propriedades em tempo de execução
O objeto Device.AccessType lista os tipos de acesso definidos e tem opções para executar chamadas síncronas sobre a leitura e a escrita para o dispositivo.
As seguintes propriedades de tags são atualizados com base no módulo de dispositivo:
tag.tagname.DevicePoint: endereço no ponto de dispositivos conectados com esta tag
Veja and a device-specific protocol. A channel can access multiple stations (for example, devices) using a common protocol.

Each station is called Knot. Each node has one or more stitches data. Data points provide the specific data values to be accessed through tags. Each data point is linked to a specific tag.

Finally, each data point is associated with an Access Type. This defines the rules for reading and writing values at this data point, such as search rate, whether a read is performed at startup, and whether unsolicited input is accepted.

In summary, the Device Module configuration is performed in 3 steps:

1. Set the equipment (and protocols) that the project will use in Edit → Devices → Channels.

2. Defined the nodes, or PLC stations related to each channel, in Edit → Devices → Nodes

3. Map the Tags in your data model for addresses on devices, in Edit → Devices → Points.

Optionally, you can customize or create new AccessTypes, mapping groups of similar communication requirements tags to the same AccessType.

To speed up the setup, the Action.NET provides many import wizards that will automatically create tags and device mapping using the PLC configuration or other available source of information.

See the Appendix - Communication Drivers for a complete list of communication protocols available in the Action.NET.

Setting Up Channels

Channels in Action.NET are the objects that implement media used to communicate the SCADA environment with PLCs and other IEDs. Many internal protocols are available. You must configure at least one channel for each protocol that you need to use.

To set up channels:

1. Go to Edit > Devices > Channels

2. Click Create New.

   • The new channel creation window is shown (figure below)

Image Added

• Enter or select the information as needed.

• Click OK.

• The channel is added as a new row in the table.

• Enter or select the information for the new Channel as needed.

To show or hide a column, right-click the column header area and check or uncheck columns.

• Keep adding as many channels as you need.

• If necessary, right-click a line to cut, copy, paste, or delete a line

Configuring Nodes

Nodes or Nodes in Action.NET are objects that match the IEDs devices, or PLC with which the application must communicate on the channel in which they are connected.
You can also import settings from an OPC server or other data source. See "Importing from an OPC Server"  and "Importing PLCs addresses."

To configure nodes:

1. Go to Edit > Devices > Nodes.

2. Enter or select the information as needed.

   • To show or hide a column, right-click the column header area and check or uncheck columns.

• Keep adding as many new nodes as you need.

Importing from an OPC Server

After you create an OPC communication node, you can select the node and click Import to import the opc server database into the project. The Action.NET automatically creates tags and communication points (Points table).
Once you have used the import tool for the first time, the system will save the settings used, so that the button will then show the word SYNC, which means that the next time you use it, a synchronization will be performed, checking which addresses have already been previously imported and which ones will be new.

Importing PLCs Addresses

When you create communication nodes and communication points (Points), you can import them if they are defined in another data source in the following ways:

• You can copy and paste the contents of an Excel table. Tables can have different columns or order, as long as you include the column title in the copy and paste operations. The system will place the data in the expected columns, even if the order is different in the source and target tables.

• You can import the data from CSV files.

• For Rockwell ControlLogix devices, you can import L5K definition files.

• For OSIsoft PI data ®, there is a Action.NET to share definitions.

• A programming API is also available that can be used to write scripts to populate points tables, even at run time, when needed.

If the PLC device or other IED has an open database or file with the available addresses, and you would like to have a strong integration to do this configuration and charge of Action.NET addresses, contact support.

Configuring point addresses

The tab Points from space Devices is used to define the tags that will be acquired by this channel and node. It specifies the types of points (according to the protocol) and the
identifiers (with the addresses) used by the protocol for mapping the data within the IEDs.
The number of data points that you can configure is related to both the ProductModel configured for the project and its license to Action.NET. For information about product models, see "Family and Product Model" .

To set up data points:

1. Go to Edit > Devices > Points.

   • You can copy and paste the tags from the Tag tab> Objects.

2. Enter or select the information as needed.

   • To add or remove a column, right-click the column header area and check or uncheck columns.

• Keep adding as many points as you need.

Configuring Access Types

In the Access Types (Access Types) are defined the reading and writing procedures, with sampling times, unsolicited events and other properties, which will be used in the treatment of each of the tags defined in the tab Points.
You can configure the types of access that control read, write, and other settings when the application accesses PLC or IED data..
The Action.NET comes with some predefined access types that you can use, or you can create others of your own, always according to the possibilities existing in the protocol in question,

To configure access types:

1. Go to Edit > Devices > AccessTypes..

2. Follow one of the following:

   • To edit an existing access type, double-click a field.

   • To create a new type of access, click Create New .

3. Enter or select the information as needed.

Runtime Devices Objects

The namespace Device is the entry point for all objects related to the devices module or Devices.
The object Device.Channel lists all configured channels and their properties at run time.
The object Device.Node lists all configured nodes and their properties at run time
The object Device.AccessType lists the types of access you set and has options for executing synchronous calls on reading and writing to the device.
The following tag properties are updated based on the device module:
tag.tagname.DevicePoint: address at the point of devices connected with this tag
See http://www.spinengenharia.com.br/help/an-2014/runtime/index.html para a referência de programação completa em objetos de tempo de execução.

Tabelas de Códigos

Códigos de Status

A lista a seguir apresenta códigos utilizados para indicar em tempo real o status de um node ou canal.

for the full programming reference on runtime objects.

Code Tables

Status Codes

The following list displays codes used to indicate in real time the status of a node or channel.

These codes are in real time in

• Device.node. <node name>. Status e emand in

• Device.Channel. <channel name>. Status

Lista de códigosList of codes:

0  Success0ssuccess
-1 BuildCommandException
-2 ParseCommandUnsolicitedException
-3 ParseReplyException
-4 BuildReplyUnsolicitedException
-5 ChannelException
-6 NodeException
-100 Base Send Error
-101 Base SendAndWait Error Base
-102 TCP Create Error 1
-103 TCP Create Error 2
-104 TCP Create SocketError
-105 TCP Connect Callback Error
-106 TCP Receive Error
-107 UDP Create Error
-108 UDP Receive Error
-109 Serial Create Error
-110 Serial Receive Error
-111 TCP NotConnected
-112 Start message timeout
-113 Receiving bytes timeout
-114 End message timeout
-115 Connect timeout
-200 ProtocolError
-201 InvalidProtocol
-202 InvalidStation
-203 InvalidCommand
-204 InvalidMsgSequence
-205 InvalidCheckSum
-206 InvalidAddress
-207 InvalidModifiers

Valores positivos são utilizados como status de erros para protocolos específicos.

Códigos de Qualidade OPC DA

O que indicam os códigos de qualidade do OPC DA? O código de qualidade OPC é composto por Positive values are used as error status for specific protocols.

OPC DA Quality Codes

What do OPC DA quality codes indicate? The OPC quality code consists of 16 bits.

• Os 8 bits altos estão disponíveis para uso específico do fornecedor e devem ser todos de 0 quando não usados.

• Os 8 bits baixos são divididos em três seções.

  • Os dois primeiros bits podem passar o significado Bom, Mau ou Incerto. Se um servidor não suportar códigos de qualidade, um bom valor será sempre passado.

  • Os próximos quatro bits podem ser usados para fornecer informações específicas adicionais sobre a qualidade geral.

  • Os dois últimos bits são usados se as informações de limite forem suportadas pelo servidor. Em VB, estes são retornados como valores Hex que podem ser convertidos em informações significativas.

Os dois códigos de qualidade OPC mais comuns são:

• 192 ou hex C0 é de boa qualidade.

• 0 (decimal ou hexadecimal) é de má qualidade.

Códigos de qualidade de especificação OPC

Image Removed

• • The 8-bit high are available for vendor-specific use and must be all 0 when not used.

  • The 8 low bits are divided into three sections.

    • The first two bits can pass the meaning Good, Bad, or Uncertain. If a server does not support quality code, good value is always passed.

    • The next four bits can be used to provide additional specific information about overall quality.

    • The last two bits are used if the boundary information is supported by the server. In VB, these are returned as Hex values that can be converted to meaningful information.

The two most common OPC quality codes are:

• • 192 or Hex C0 is of good quality.

  • 0 (decimal or hexadecimal) is of poor quality.

OPC specification quality codes

Image Added

For more information, see the OPC specifications. (Note: Not all servers will support all of these codes)