Driver Siemens M-PROT

Nome do Arquivo MPROT.DLL

Fabricante Siemens, Vipa
Equipamentos Modelos de PLCs S7-200, S7-300, S7-400 e S7-1200 da Siemens; Speed7 da Vipa
e demais equipamentos compatveis com algum protocolo do Driver
Protocolo PPI e MPI (Serial); MPI encapsulado em Ethernet e ISO sobre TCP (RFC1006 ou
S7-TCP/IP em interface Ethernet)
Verso 3.1.2
ltima Atualizao 12/05/2015
Plataforma Win32
Dependncias IOKit v2.00
Leitura com Superblocos Sim
Nvel 0

Introduo
O Driver Siemens multiprotocolo (M-Prot) comunica com os PLCs S7-200, S7-300, S7-400 e S7-1200 da
Siemens e Speed7 da VIPA usando os protocolos Siemens PPI, MPI, ISOTCP e MPI encapsulados em Ethernet
(IBHLink).

O protocolo PPI deve ser usado somente para a linha S7-200 usando o cabo conversor RS232-PPI/MPI
fornecido pela Siemens.

O protocolo MPI pode ser usado para as linhas S7-300 e S7-400 atravs de cabo conversor RS232-PPI/MPI
fornecido pela Siemens, ou tambm para a linha Speed7 da VIPA na porta MPI usando um cabo RS232
comum.

O protocolo ISOTCP (que tambm pode ser chamado como ISO sobre TCP, RFC1006 ou S7-TCP/IP em diversos
materiais dos fabricantes de hardware) pode ser usado para os modelos S7-300 ou S7-400 da Siemens
atravs do uso de um carto Ethernet CP-3XX, CP-433 ou CP-443; para o modelo S7-1200, e tambm para a
linha Speed7 da VIPA, diretamente na porta Ethernet da CPU. Para o modelo S7-200, h uma variao
especial do protocolo ISOTCP para ser usado em conjunto com a interface CP-243. Este protocolo
denominado ISOTCP243.

Para os PLCs que no possuem porta Ethernet, uma alternativa pode ser o uso de um conversor Ethernet/MPI
IBHLink, fornecido pelas empresas IBH Softec ou Hilscher, que atua no nvel FDL. A vantagem deste conversor
que a velocidade nominal mais alta, chegando a 187 kbps na rede MPI, ao passo que pelo conversor
serial de 38,4 kbps. O uso deste conversor uma alternativa ao uso das placas CP5611 ou similares.

Outra alternativa semelhante o cabo conversor NETLink PRO Eth da Softing, que converte de ISOTCP para
MPI.

Este Driver no suporta o uso de adaptadores Siemens PPI/MPI por interface USB.

Este Driver no suporta o uso de interfaces CP5611 ou similares para o acesso rede MPI. Para comunicar

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
com estas placas deve ser usado o driver S7Functions ou ainda o SIMATIC.NET da Siemens, atravs do
servidor OPC j incluso.

NOTA: M-Prot um nome criado pela Elipse Software com a finalidade de especificar um Driver que suporta
mltiplos protocolos. No existe relao alguma com nomes de equipamentos, protocolos ou padres
definidos pelos fabricantes supracitados.

Parmetros de Configurao do Driver

Os parmetros [P] de configurao do Driver no so utilizados. Todas as configuraes so executadas na
janela de configuraes do Driver, mostrada na figura a seguir.

Aba MProt

As opes disponveis para o grupo General esto descritas na tabela a seguir.

Opes disponveis no grupo General
OPO DESCRIO
Default Slave Address Pode ser utilizado como o endereo padro para
qualquer Tag, basta deixar o parmetro N1 em 0
(zero) para que seja substitudo pelo endereo
padro.
Network Seleo do protocolo: PPI, MPI, ISOTCP, ISOTCP para
CPU 243 ou MPI para conversor IBHLink. Os grupos
PPI, MPI ou ISOTCP/ISOTCP243 nesta aba so
habilitados ou desabilitados conforme a seleo do
protocolo.
Local Address Endereo do Driver na rede. Pode ser selecionado
arbitrariamente.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
As opes disponveis para o grupo PPI esto descritas na tabela a seguir.

Grupo PPI

Opes disponveis no grupo PPI

OPO DESCRIO
PPI Multi Master Informa ao Driver que existem outros Mestres na
rede.
Application Timeout (ms) Tempo mximo de comunicao para cada Tag, em
milissegundos. Disponvel apenas quando
multimestre.
Operation delay (ms) Tempo de parada para o intervalo entre operaes de
comunicao, em milissegundos. Selecione a opo
only for write para indicar a aplicao do intervalo
apenas para operaes de escrita (veja a nota a
seguir).

NOTA: A opo Operation delay adiciona um tempo mnimo de espera que deve haver entre o fim de uma
operao de leitura ou escrita e o incio de outra operao. Utilize algum valor diferente de 0 (zero) nesta
configurao apenas se estiver enfrentando falhas de comunicao ocasionadas pela inrcia de
processamento do PLC. As operaes de escrita so as mais prejudicadas, pois normalmente so aleatrias.
Por isto existe a opo only for write. Se ela no estiver selecionada, a espera se aplica operaes de
leitura e de escrita. Se estiver selecionada, se aplica apenas s operaes de escrita (recomendado). Note
que o acrscimo de um tempo de espera pode diminuir o desempenho da aplicao.

As opes disponveis para o grupo MPI esto descritas na tabela a seguir.

Grupo MPI

Opes disponveis no grupo MPI

OPO DESCRIO
Highest Station Address Indica o maior endereo disponvel na rede, para que
nos modos PPI e MPI o Driver encontre outros
possveis Mestres na rede. Devem ser inseridas
apenas as opes 15, 31 ou 63.
Profibus Speed Velocidade nominal da rede Profibus.

As opes disponveis para o grupo ISOTCP / ISOTCP243 esto descritas na tabela a seguir.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 Grupo ISOTCP / ISOTCP243

Opes disponveis no grupo ISOTCP / ISOTCP243

OPO DESCRIO
Extra Connections Nmero de conexes TCP adicionais que podem ser
criadas para melhorar o desempenho da
comunicao.
Source Ref. (hex) Nmero formado por um Word em hexadecimal que
identifica a referncia local (source reference) no
protocolo. Somente liberada quando a opo Use
default Source Ref estiver desmarcada.
Source TSAP (hex) Nmero formado por um Word em hexadecimal que
identifica o TSAP local no protocolo. Somente
liberada quando a opo Use default TSAPs estiver
desmarcada.
Connection type Tipo da conexo: PG, OP ou PC. Deve ser
selecionada de acordo com o que foi configurado na
CPU.
Rack Nmero do rack da CPU de destino.
Slot Nmero do slot da CPU de destino.
Enable CPU backup Habilita a entrada de valores de rack e slot da CPU
de backup, para uso em sistemas com redundncia
que sejam de valores diferentes da CPU principal.

Para que a comunicao deste Driver funcione com o modelo de PLC Siemens S7-1200, necessrio
selecionar a opo ISOTCP, desmarcar a opo Use default TSAPs, configurar a propriedade Source TSAP
(hex) para o valor "0100" e definir a opo Connection type como "PG", Rack com o valor 0 (zero) e Slot com
o valor 1 (um).

NOTAS:
Ao selecionar os protocolos ISOTCP ou ISOTCP243, todos os Tags que estiverem no objeto Driver devem
ter o parmetro N1 (ou B1) em 0 (zero) e o parmetro Default Slave Address tambm em 0 (zero).
Os parmetros Source Ref e Source TSAP devem ser considerados apenas em casos muito particulares.
Devido execues bem sucedidas em uma enorme gama de topologias, recomenda-se que se mantenha
a opo Use default Source Ref sempre selecionada e o valor de Source TSAP sempre em "0100".
Quando a opo Use Default TSAPs est selecionada em conjunto com o protocolo ISOTCP, o valor de
Source TSAP "0100" e o valor de Destination TSAP utilizado "0202".
TSAP vem do ingls Transport Service Access Point, e uma terminologia utilizada no protocolo ISO.
Quando se utiliza adaptadores seriais PC - PPI/MPI, tem sido bastante usual a necessidade de configurar
o handshaking na aba Serial da janela de configuraes do Driver. Apenas o controle de RTS deve ser
configurado em ON. Havendo insucesso de comunicao nos testes iniciais com este Driver, convm
experimentar esta mudana (RTS Control configurado como ON) e refazer o teste.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
Parmetros de Configurao de Strings
Esta aba util caso haja necessidade de declarar Strings com tamanho mximo definido, individualmente ou
genericamente.

Aba S7 Strings

As opes disponveis na aba S7 Strings esto descritas na tabela a seguir.

Opes disponveis na aba S7 Strings
OPO DESCRIO
Keep support for legacy strings Mantm o suporte para Strings antigas, anteriores
verso 2.10. A opo selecionada mantm o formato
antigo de String implementado em verses
anteriores, evitando transtornos em uma migrao de
verso do Driver.
Recomenda-se selecionar esta opo apenas em
caso de migrao de um projeto cuja verso do
Driver seja 2.09 ou anterior. Caso o projeto utilize
Strings aps uma migrao de verso ter ocorrido, os
Tags de tipo String retornam erros de leitura do PLC.
O formato de Strings legado possui uma reserva de
32 bytes de espao a partir do offset configurado.
Caso esteja trabalhando com um projeto novo, deixe
esta opo desmarcada.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 OPO DESCRIO
Standard maximum string length Tamanho mximo padro das Strings. Preencha um
valor padro configurado na memria do PLC para
Strings sem tamanho mximo declarado. Por
exemplo, nos PLCs S7-200 este valor igual a "254".
Isto significa que os pedidos por Strings com
tamanhos no declarados contm e indicam uma
extenso fixa de 254 caracteres.

Listagem de tamanhos mximos de Strings

Esta aba tambm mostra uma lista selecionvel com Strings declaradas com tamanhos j determinados. A
lista aparece em branco caso no existam Strings configuradas. As Strings podem ser declaradas na
memria do PLC de duas formas:

Sem especificar o tamanho mximo na declarao. Exemplo:

STRING var;

A String alocada automaticamente com a extenso mxima padro do PLC.

Especificando o tamanho mximo na declarao. Exemplo:

STRING var[50];

No exemplo anterior, a String alocada com tamanho mximo "50". Devido a esta segunda forma que a
listagem de tamanho de Strings se mostra importante.

Para determinar o tamanho de uma nova String declarada, preciso preencher corretamente todos os
campos, conforme descrito na tabela a seguir.
Opes disponveis para a configurao do tamanho mximo de Strings
OPO DESCRIO
Device Endereo do PLC. Preencha com o mesmo valor do
parmetro N1/B1 do Tag (veja o tpico
Endereamento Padro).
DB Number Informe o valor do nmero do DB onde a String est
localizada.
Offset Informe o valor do offset no DB onde a String est
localizada.
Length Preencha com o valor mximo de tamanho da String,
conforme declarado na programao do PLC.

Caso j exista alguma String declarada na lista com mesmo valor de Device, DB Number e Offset, esta
automaticamente apontada na tabela e seus valores so carregados em todos os campos de edio.

Trs opes destinam-se manipulao dos dados das Strings da lista:

Add: Adiciona novos parmetros

Update: Altera parmetros j listados

Remove: Remove totalmente uma linha de parmetros

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
Clique em OK para confirmar todas as configuraes listadas e fechar a janela. Clique em Remove All para
remover todos os dados da lista.

NOTA: Se for escolhido declarar Tags com parmetros de Endereamento Simblico, no h necessidade de
preencher a lista com declaraes de Strings. O tamanho pode ser especificado no prprio parmetro de
smbolo disponvel no Tag.

Referncia de Tags
Esta seo contm informaes de configurao de Tags por Endereamento Simblico e por
Endereamento Padro (parmetros N/B). Tambm contm referncias aos Tags da Interface em Conexes
ISOTCP Extras.

Configurao por Parmetros Sintticos

Utilize a sintaxe a seguir para cada campo presente no E3 ou Elipse Power:

Dispositivo: Insira o endereo do equipamento na rede. Se for igual a 0 (zero) e protocolo diferente de
ISOTCP ou ISOTCP243, substitudo pelo Default Slave Address. Se o protocolo for ISOTCP ou
ISOTCP243, este valor deve ser deixado em 0 (zero). O campo Dispositivo tambm pode ficar vazio,
desde que seja inserido no campo Item antes do smbolo de dois pontos.

Item: Este campo deve obedecer alguma das sintaxes a seguir.

Use a sintaxe geral a seguir, se a rea no for igual a DB. Valores entre colchetes so opcionais:
<[Dispositivo:]><rea><[Tipo]><Endereo>[.Bit]

Onde:

Dispositivo: Endereo do PLC conforme exposto no item Dispositivo, caso no tenha sido informado
naquele campo.

rea: rea de dados dentro do PLC. As seguintes opes podem ser utilizadas:

SM

AI (Analog Input)

AQ (Analog Output)

C (Counter)

T (Timer)

I (Digital Input)

Q (Digital Output)

M (Memory)

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 HC (High Speed Counter)

Tipo: Tipo de dado a ser lido. A tabela a seguir mostra os possveis smbolos para os tipos.
Opes disponveis para tipos
TIPO SIGNIFICADO
X Usado para extrair um bit de um byte
B Byte
W Word
D DWord
F Float
S String
S5T S5Time

Endereo: Endereo numrico a ser lido.

Bit: Opcional que informa o bit de uma palavra a ser lido ou escrito (entre 0 e 31).

Exemplo:
(PLC 4, bit 1 da memria do endereo 10)
Device: Vazio - Item 4:M10.1

Se a rea for igual a DB (tambm conhecida como V), use a sintaxe a seguir. Valores entre colchetes so
opcionais:
<[Dispositivo:]>DB<NumeroDB>:<Tipo><Endereo><[.Bit]>

Dispositivo: Refere-se ao mesmo item opcional da sintaxe geral.

NumeroDB: Coloque o nmero do DB. Caso a memria contenha um bloco DB nico ou no

especificado, preencha com o valor 1 (um).

Endereo: Endereo numrico (offset) a ser lido.

Bit: Valor opcional que informa o bit do tipo a ser lido ou escrito (entre 0 e 31).

Opes disponveis para tipos rea DB

TIPO SIGNIFICADO
DBX Usado para extrair um bit de um byte em um DB
DBB Usado para ler ou escrever um byte em um DB
DBW ou DW Usado para ler ou escrever um Word em um DB
DBD ou DD Usado para ler ou escrever um Double Word em um
DB
DBF ou DF Usado para ler ou escrever um Floating Point (real
de 32 bits) em um DB
DBS ou DS Usado para acessar uma String em um DB
DBS5T Usado para acessar um timer do tipo S5Time em um
DB

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
Exemplos:
(PLC 2, Word comeando no endereo 20 do DB1)
Device: 2 - Item: DB1:DW20
(Mesmo do anterior, porm DMuevice foi informado no campo Item)
Device: Vazio - Item: 2:DB1:DW20
(PLC 7, DB 5, bit 2 do byte 7)
Device: Vazio - Item: 7:DB5:DBX7.2

A sintaxe para tipos String em rea DB a seguinte:

<[Dispositivo:]>DB<NumeroDB>:DBS<Endereo><[Tamanho mximo]>

Onde:

Device, NumeroDB e Endereo: Referem-se aos mesmos itens da sintaxe geral.

Tamanho mximo: Opcional que informa o tamanho mximo declarado na String. Se no informado,
considerado o tamanho mximo padro da String como foi preenchido na janela de configurao de
Strings.

Exemplos de sintaxe para Strings:

(PLC 2, String comeando no endereo 16 do DB17,
usando o tamanho padro mximo do PLC)
Device: 2 - Item: DB17:DBS16
(mesmo do anterior, porm Device foi informado no campo Item
e com tamanho mximo alocado de 25 caracteres)
Device: Vazio - Item: 2:DB17:DBS16[25]
(PLC 4, String comeando no endereo 100 do DB10,
com tamanho mximo alocado de 50 caracteres)
Device: Vazio - Item 4:DB10:DS100[50]

Configurao por Parmetros Numricos (N/B)

Use a sintaxe padro descrita na tabela a seguir para todos os Tags e Blocos.
Sintaxe padro para Tags e Blocos
PARMETRO DESCRIO
N1/B1 Endereo do PLC. Se for igual a 0 (zero) e protocolo
diferente de ISOTCP ou ISOTCP243, substitudo
pelo Default Slave Address. Se for protocolo ISOTCP
ou ISOTCP243, este valor deve ser deixado em 0
(zero).
N2/B2 Tipo de dado e rea (veja as tabelas a seguir). O
valor deve ser composto pelo tipo de dado
multiplicado por 100 mais a rea (a frmula N2/B2
= TipoData 100 + rea).
N3/B3 Se a rea selecionada for V (DB), preencha com o
nmero do bloco DB. Caso contrrio, deixe em 0
(zero). Caso a memria contenha um bloco DB nico
ou no especificado, preencha com o valor 1 (um).

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 PARMETRO DESCRIO
N4/B4 Endereo na rea ou offset do bloco DB. Para usar
tipos de dados que ocupam mais de um byte, devem
ser colocados endereos mltiplos de dois para tipos
de dois bytes (16 bits com e sem sinal) e mltiplos
de quatro para tipos de quatro bytes (32 bits com e
sem sinal e ponto flutuante de 32 bits).

Opes disponveis para Tipos de dados

TIPO SIGNIFICADO
0 Padro da rea
1 BOOL (Booleano)
2 BYTE (oito bits sem sinal)
3 WORD (16 bits sem sinal)
4 INT (16 bits com sinal)
5 DWORD (32 bits com sinal)
6 DINT (32 bits com sinal)
7 REAL (32 bits de ponto flutuante - IEEE 754)
8 STRING (ver nota a seguir)
12 S5TIME (tempo em segundos, 32 bits de ponto
flutuante - IEEE 754, ver nota a seguir)

Opes disponveis para reas

REA SIGNIFICADO
0 S
1 SM
2 AI (Analog Input)
3 AQ (Analog Output)
4 C (Counter)
5 T (Timer)
6 I (Digital Input)
7 Q (Digital Output)
8 M (Memory)
9 V (DB)
10 HC (High Speed Counter)

NOTAS:
Para dados de tipo S5Time, o valor a ser preenchido sempre em segundos, com ponto flutuante de 32
bits. A gama de valores diferentes de zero est entre 0,01 e 9990,0 segundos. A base de tempo
preenchida ou interpretada automaticamente.
No protocolo PPI h uma limitao no Bloco de Comunicao para dados em bytes. Para leitura, o mximo
permitido so 224 bytes, e para escrita so 218 bytes. Isto significa, respectivamente, que para dados de
tipo Word (16 bits), o Bloco no pode ultrapassar 112 e 109 Elementos. Para dados de tipo DWord (32
bits), o Bloco no pode ultrapassar 56 e 54 Elementos, e assim por diante.
Caso desconhea a definio de Rack e Slot para endereamento dos Tags em protocolo ISOTCP, consulte
o artigo KB-39019: Configuraes de Rack e Slot no Elipse Knowledgebase.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
Tags da Interface em Conexes ISOTCP Extras
Havendo optado pelo uso de conexes ISOTCP extras com o parmetro Extra Connections na janela de
configuraes do Driver, estas conexes podem ser controladas e monitoradas por trs Tags especficos de
Interface: Physical Layer Status, IPSelect e IPSwitch.

NOTA: Estes Tags no podem ser utilizados quando o parmetro Extra Connections for igual a 0 (zero).
Neste caso, utiliza-se os Tags do IOKit correspondentes, de mesmo nome, cujo uso pode ser consultado no
Manual do Usurio do IOKit.

Physical Layer Status (MProt)

Somente Leitura
Configurao por parmetros numricos
PARMETRO VALOR
N1 -2
N2 0 (zero)
N3 0 (zero)
N4 2

Configurao por parmetros sintticos

PARMETRO VALOR
Item MProt.IO.PhysicalLayerStatus

Este Tag indica o estado da conexo na camada fsica. Seus possveis valores so os seguintes:

0: Camada fsica desconectada

1: Camada fsica conectada

IPSelect (MProt)
Leitura e Escrita
Configurao por parmetros numricos
PARMETRO VALOR
N1 -2
N2 0 (zero)
N3 4
N4 0

Configurao por parmetros sintticos

PARMETRO VALOR
Item MProt.IO.Ethernet.IPSelect

Indica o IP ativo. Seus possveis valores so os seguintes:

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 0: O IP principal est selecionado (ativo)

1: O IP alternativo (backup) est selecionado (ativo)

Se a interface Ethernet estiver conectada, o Tag indica qual dos dois IPs configurados est sendo usado. Se a
interface for desconectada, o Tag indica qual IP usado primeiro na prxima tentativa de conexo.

Durante o processo de conexo, se o IP ativo no estiver disponvel, o IOKit tenta conectar com o outro IP. Se
a conexo com o IP alternativo funcionar, este configurado como o IP ativo (switchover automtico).

Para forar um switchover manual, escreva 1 (um) ou 0 (zero) neste Tag. Isto fora a reconexo com o IP
especificado (0: IP principal e 1: IP de backup) se o Driver estiver atualmente conectado. Se o Driver estiver
desconectado, isto configura o IP ativo para a prxima tentativa de conexo.

IPSwitch (MProt)
Somente Escrita
Configurao por parmetros numricos
PARMETRO VALOR
N1 -2
N2 0 (zero)
N3 4
N4 1

Configurao por parmetros sintticos

PARMETRO VALOR
Item MProt.IO.Ethernet.IPSwitch

Qualquer valor escrito neste Tag fora o switchover manual. Se o IP principal estiver ativo, ento o IP de
backup ativado, e vice-versa. Isto fora a reconexo com o IP especificado se o Driver estiver atualmente
conectado. Se o Driver estiver desconectado, isto configura o IP ativo para a prxima tentativa de conexo.

Coleta SOE
Esta seo contm informaes especficas para Coleta SOE de eventos.

Preparando a Coleta SOE

Antes de utilizar os Tags de Coleta SOE, preciso preparar o CLP com a construo de uma Tabela DB (rea
V) e o desenvolvimento de uma lgica programvel compatvel com os procedimentos de coleta SOE
desenvolvida para este Driver.

Tabela de Eventos do SOE

Esta tabela tem como objetivo dimensionar o tamanho do buffer de eventos e gerenciar a entrada e a sada
destes em uma rotina de buffer circular. Esta tabela constantemente atualizada, tanto pelo CLP quanto pelo
Driver Siemens MProt.

A Tabela de Eventos SOE deve conter registros de controle e de armazenamento dos eventos, com base na
estrutura de dados descrita na tabela a seguir.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 Estrutura de dados
ENDEREO DESCRIO TIPO DE DADO
0.0 STRUCT
+0.0 Status da Tabela WORD (16 bits sem sinal)
+2.0 Ponteiro de Gravao WORD (16 bits sem sinal)
+4.0 Status da Aquisio WORD (16 bits sem sinal)
+6.0 Limite Mximo de Itens do Buffer WORD (16 bits sem sinal)
Circular
+8.0 Buffer Circular ARRAY[1..n] (limite de itens
definido pelo usurio)
+0.0 STRUCT
+0.0 TIMESTAMP_LOLO (Ano) WORD (16 bits sem sinal)
+2.0 TIMESTAMP_LOHI (Dia e Ms) WORD (16 bits sem sinal)
+4.0 TIMESTAMP_HILO (Hora e Minuto) WORD (16 bits sem sinal)
+6.0 TIMESTAMP_HIHI (Segundo e WORD (16 bits sem sinal)
Milissegundo)
+8.0 Valor do Tipo de Evento 1 Tipo de dado do evento (definido
pelo usurio)
+n.0 Valor do Tipo de Evento 2 Repete o mesmo tipo de dado
+n.0 Valor do Tipo de Evento 3 Repete o mesmo tipo de dado
+n.0 Valor do Tipo de Evento n Repete o mesmo tipo de dado
=n.0 END_STRUCT
=n.0 END_STRUCT

Descrio dos registros de controle dos eventos

Status da Tabela: Deve ser mantido exclusivamente pelo CLP, indicando o nmero de eventos
disponveis para a leitura no buffer circular. Deve ser atualizado pelo CLP sempre que novos eventos
forem adicionados ao buffer circular, ou aps a concluso da coleta de eventos pelo supervisrio, o que
pode ser detectado pela mudana no Status da Aquisio.

Ponteiro de Gravao: Deve ser mantido exclusivamente pelo CLP, indicando o ndice, comeando em
zero, da posio onde deve ser inserido o prximo evento. O ndice deve ser incrementado pelo CLP a
cada nova insero de eventos no buffer circular, voltando ao ndice zero aps alcanar o limite mximo
do buffer circular.

Status da Aquisio: Deve ser mantido pelo CLP em conjunto com o Driver MProt, indicando o nmero
de registros j lidos a cada transao. Aps cada coleta, o Driver MProt escreve neste registro o
nmero de eventos que conseguiu ler. Ao detectar esta modificao, o CLP deve imediatamente
descontar este valor escrito pelo Driver MProt do Status da Tabela, e ento zerar o Status da
Aquisio.

Limite Mximo de Itens do Buffer Circular: Valor constante que especifica o limite mximo de eventos
a serem armazenados no buffer circular antes do ponteiro voltar para o ndice 0 (zero). Deve conter
exatamente o valor limite do Array dimensionado para os eventos do buffer circular.

Descrio dos registros de armazenagem dos eventos

TIMESTAMP: Horrio da ocorrncia do evento.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 Valor do Evento: Valor do evento ocorrido, que pode ser composto por um ou n valores (todos com o
mesmo tipo de dado), no qual so agrupados para o mesmo TIMESTAMP gerado na ocorrncia de um
evento.

Formato do TIMESTAMP

O TIMESTAMP representado por quatro Words, conforme a estrutura de dados descrita na tabela a seguir.
Estrutura de dados
WORD CONTEDO INTERVALO
0 Ano Entre 0 e 65535
1 Dia e Ms ddddddddmmmmmmmm
2 Hora e Minuto hhhhhhhhmmmmmmmm
3 Segundos e Milissegundos ssssssmmmmmmmmmm

O primeiro Word contm um valor inteiro referente ao ano.

O segundo Word est dividido em parte alta para representar o dia e em parte baixa para representar o
ms.

O terceiro Word est dividido em parte alta para representar as horas e em parte baixa para
representar os minutos.

O quarto Word usa os seis bits mais altos para representar os segundos e os 10 bits mais baixos para
representar os milissegundos.

Procedimento de Aquisio

O CLP deve iniciar a insero dos eventos no sentido crescente, a partir do endereo base da tabela,
referente ao incio do buffer circular. A cada novo evento inserido, o ponteiro de gravao deve ser
incrementado, passando a apontar para o prximo endereo disponvel do buffer.

O Driver executa a leitura do evento mais antigo para o mais recente. O endereo do incio da leitura
calculado pelo Driver atravs do valor do Ponteiro de Gravao e do Status da Tabela.

Se o nmero de eventos disponveis for maior que o mximo permitido em um nico frame de comunicao
do protocolo, o Driver executa mltiplas leituras em bloco, atualizando o valor do Status da Aquisio no
final do processo com o nmero total de eventos lidos.

Ao detectar que o Driver escreveu um valor maior que 0 (zero) no Status da Aquisio, o CLP deve
imediatamente subtrair o valor do Status da Aquisio do valor do Status da Tabela e zerar o Status da
Aquisio.

O CLP pode inserir novos eventos na tabela durante o processo de aquisio pelo CLP, desde que no ocorra
overflow do buffer circular, incrementando o Status da Tabela.

A figura a seguir apresenta um pequeno fluxograma, em formato de Diagrama de Atividade UML, com uma
sugesto de implementao para a lgica do CLP.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 Fluxograma SOE

Tags de Coleta SOE

A coleta SOE de eventos executada com a utilizao dos Tags descritos a seguir, por meio de uma
comunicao ISOTCP com o CLP.

Tag Bloco de Registro de Controle (Somente leitura)

B1: 0 (zero)

B2: 309 (Tipo de Dado = 3 e rea = 9)

B3: Nmero do bloco DB. Caso a memria contenha um bloco DB nico ou no especificado, preencha
com o valor 1 (um)

B4: No utilizado

O Tag Bloco de consulta dos Registros de Controle deve conter quatro Elementos para retornar os seguintes
valores:

Elemento 1: Status da Tabela

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 Elemento 2: Ponteiro de Gravao

Elemento 3: Status da Aquisio

Elemento 4: Limite Mximo de Itens do Buffer Circular

Para uma descrio de cada um destes Registros de Controle, consulte o tpico Preparando a Coleta SOE.

Tag Bloco de Coleta de Dados (Somente leitura)

B1: 0 (zero)

B2: Tipo de Dado e rea = 90

B3: Nmero do bloco DB. Caso a memria contenha um bloco DB nico ou no especificado, preencha
com o valor 1 (um)

B4: No utilizado

O Tag Bloco de Coleta de Dados deve conter um nmero de Elementos correspondente ao nmero de valores
de tipo de evento n que compem um nico evento. Se o evento for composto por um nico valor, basta
dimensionar o Tag Bloco de Coleta de Dados com apenas um Elemento. Caso o evento seja composto por
dois valores, o Tag Bloco deve ser dimensionado para dois Elementos, e assim por diante. Utilize o
parmetro B2 do Tag Bloco para indicar o tipo de dado associado aos valores do evento.

NOTA: Todos os valores que compem um evento devem ser do mesmo tipo de dado, assim como cada
tabela DB do CLP deve ser preenchida por um mesmo tipo de evento.

Histrico de Revises do Driver

VERSO DATA AUTOR COMENTRIOS
3.1.2 12/05/2015 M. Ludwig Corrigida a negao de
funcionamento da opo
de seleo do protocolo
ISOTCP243 (Case 18675).
3.1.1 19/09/2014 M. Ludwig Implementada a
redundncia de CPU
(seleo automtica de
CPU backup, Rack/Slot
alternativos, com a
conexo ao IP backup,
Case 15782).
Implementada
configurao de Rack, Slot
e tipo de conexo na
janela de propriedades do
Driver (Case 15911).
Adicionados Tags de
interface especficos para
opo de conexes extras
(Case 17221).

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 VERSO DATA AUTOR COMENTRIOS
3.00 20/12/2013 M. Salvador Implementao de
M. Ludwig Superblocos internos em
conexes TCP extras (Case
14025).
Driver portado para o IOKit
2.00 (Case 14019).
2.13 21/08/2012 M. Ludwig Implementada
funcionalidade do campo
PDU REF em protocolo
ISOTCP (Case 13299).
2.12 30/05/2012 C. Mello Adicionado suporte para
Coleta SOE de eventos em
tabelas DB (Case 12483).
2.11 04/08/2011 M. Ludwig Incluso de consistncia
prevista em protocolo MPI
e melhorias de codificao
(Case 12392).
Adicionadas informaes
sobre suporte a PLC
Siemens modelo S7-1200
(Case 12292).
2.10 25/03/2011 M. Ludwig Implementao do
formato S7 String e de
nova janela de
propriedades para
configurao de Strings
(Case 12005).
2.09 25/08/2009 M. Ludwig Correo de falha lendo
variveis de tipo Contador
(Case 10701).
Implementao de
configuraes avanadas
para ISOTCP/ISOTCP243
(Case 10717).
2.08 19/06/2009 M. Ludwig Correo de falha em
desconexo endereando
mltiplos escravos no
protocolo MPI (Case
10595).
2.07 03/06/2009 M. Ludwig Implementao do tipo
S5Time (Case 10413).
2.06 07/01/2009 M. Ludwig Correo de falha em
conexo sob protocolo
ISOTCP (Case 10138).
2.05 04/11/2008 M. Ludwig Melhorias na apresentao
da janela de propriedades
(Case 9994).
Implementao do delay
de operao em PPI (Case
9968).

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 VERSO DATA AUTOR COMENTRIOS
2.04 01/04/2008 M. Ludwig Corrigido problema que
ocorria ao enderear
entradas e sadas
analgicas combinadas
com a propriedade
EnableReadGrouping em
Verdadeiro (Case 8927).
Melhoria e consistncia
para evitar problema de
desconexes do PLC,
relatado no case 8968
(recebimento de valores
aleatrios em variveis de
alarme em ISOTCP).
Corrigida a falta de
tratamento de erro em
recebimento de caracteres
NAK em protocolo MPI, que
ocasionava travamento em
recepo de dados (Case
8981).
Melhoria de consistncia
em recepes do protocolo
MPI (Case 8981).
Retirado byte
desnecessrio no frame,
que ocasionava problemas
em escritas de byte e bit
sob protocolo ISOTCP e
PLC S7-400 (Case 9021).
Corrigida falha de
reconexo automtica em
desconexo fsica no
ISOTCP (Case 9030).
Corrigida a implementao
de recepo de um frame
longo de ACK em PPI (Case
9118).
Implementada a condio
de dados indisponveis em
PPI. Quando a condio
encontrada, retorna uma
lista vazia e OK ao invs
de falha (Case 9232).
Corrigida atribuio errada
de Service Access Point em
protocolo MPI, que
ocasionava falhas de
comunicao com
adaptadores Tecnatron
(Case 9238).

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 VERSO DATA AUTOR COMENTRIOS
2.03 13/09/2007 M. Ludwig Corrigido problema de
reconexo com adaptador
serial quando h
desligamento de PLC (Case
8069).
Implementado
endereamento a mltiplos
escravos no protocolo MPI
(Case 8625).
Porta Ethernet livremente
configurvel (Case 8683).
Driver compilado no
IOKitLib v1.14, de forma a
corrigir erros de leitura e
escrita antes da primeira
conexo (Case 7614).
Documentao atualizada
com informaes sobre
tamanho de Strings,
protocolos e equipamentos
compatveis (Case 8206).
2.02 28/03/2007 M. Ludwig Corrigida a falta de criao
de blob que ocasionava
erros em tempo de
execuo (Case 8015).
Corrigido problema de
troca de nmeros IP em
tempo de execuo (Case
8026).
Desenvolvido suporte a
Windows CE (Case 7504).
Adicionado suporte a
conversores IBHLink (Case
7994).
Corrigido problema de
escrita de Strings (Case
7967).
2.01 10/07/2006 M. Ludwig Correo em parsing de
variveis DB (Case 7172).

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
 VERSO DATA AUTOR COMENTRIOS
2.00 13/04/2006 M. Salvador Corrigida falha do
M. Ludwig protocolo PPI Error: Single
DLE in data field (Case
6644).
Retirada a verificao de
endereos. No importa o
tipo de dado, permitida a
entrada de qualquer valor
para N4 (Case 6644).
Corrigido bug de interface
de configurao, onde se
misturavam configuraes
do IBHLink com ISOTCP
(porta 1099 era forada ao
invs da porta 102, Case
6644).
Inserido suporte a
Superblocos e
endereamento simblico
(Case 6644).
1.01 03/11/2005 M. Ludwig Otimizao, padronizao
e reviso do cdigo fonte.
1.00 01/05/2005 M. Salvador Verso original do Driver.

Copyright 2005-2015 Elipse Software Ltda. Todos os direitos reservados. Driver Siemens M-PROT v3.1.2
Matriz Filial SP
Rua 24 de Outubro, 353 - 10 andar Rua dos Pinheiros, 870 - Conj. 141/142
90510-002 Porto Alegre 05422-001 So Paulo - SP
Fone: (+55 51) 3346-4699 Fone: (+55 11) 3061-2828
Fax: (+55 51) 3222-6226 Fax:(+55 11) 3086-2338
E-mail: elipse-rs@elipse.com.br E-mail: elipse-sp@elipse.com.br

Filial PR Filial MG
Av. Sete de Setembro, 4698/1705 Rua Antnio de Albuquerque, 156
80240-000 Curitiba - PR 7 andar Sala 705
Fone: (+55 41) 4062-5824 30112-010 Belo Horizonte - MG
E-mail: elipse-pr@elipse.com.br Fone: (+55 31) 4062-5824
E-mail: elipse-mg@elipse.com.br

Filial RJ USA
Praia de Botafogo, 300/525 2501 Blue Ridge Road, Suite 250
22250-044 Rio de Janeiro - RJ Raleigh - NC - 27607 USA
Fone: (+55 21) 2158-1015 Fone: (+1 252) 995-6885
Fax: (+55 21) 2158-1099 Fax: (+1 252) 995-5686
E-mail: elipse-rj@elipse.com.br E-mail: support@elipse.com.br

Taiwan
9F., No.12, Beiping 2nd St., Sanmin Dist.
807 Kaohsiung City - Taiwan
Fone: (+886 7) 323-8468
Fax: (+886 7) 323-9656
E-mail: evan@elipse.com.br

Consulte nosso website para informaes sobre o representante do seu estado.

www.elipse.com.br
kb.elipse.com.br
elipse@elipse.com.br