Modbus BR

Driver Modicon Modbus Master (ASC/RTU/TCP)
Nome do Arquivo
Fabricante
Equipamentos
Protocolo
Verso
ltima Atualizao
Plataforma
Dependncias
Leitura com Superblocos
Nvel
MODBUS.DLL
Modicon
Qualquer equipamento compatvel com o protocolo Modbus v1.1b
Modbus v1.1b
3.0.11
29/05/2015
Win32 e Windows CE (Pocket PC ARM, HPC2000 ARM, HPC2000 X86 e
HPC2000 MIPS)
Sem dependncias
Sim
0
Introduo
Este Driver implementa o protocolo Modbus, permitindo a uma aplicao Elipse comunicar com qualquer
equipamento escravo que implemente este protocolo nos modos ASCII, RTU ou TCP.
Este Driver atua sempre como mestre da rede Modbus. Se houver necessidade de que o Driver comunique
com dispositivos mestre, necessrio utilizar o Driver Modbus Slave da Elipse, que pode ser baixado no site
da empresa.
O Driver Modbus, a partir da verso 2.00, passou a ser desenvolvido com a biblioteca IOKit da Elipse. Esta
biblioteca responsvel por implementar o acesso ao meio fsico (Serial, Ethernet, Modem ou RAS). Para
obter informaes sobre a configurao do IOKit, consulte o Manual do Usurio do IOKit.
Recomenda-se que para o correto funcionamento do Driver sejam lidos, nesta ordem, os captulos
Adicionando o Driver em uma Aplicao Elipse e Configurao.
Se o equipamento perfeitamente aderente ao protocolo Modbus padro definido pela Organizao Modbus
(modbus.org), e se h necessidade de apenas ler ou escrever bits e registros do equipamento, no
necessitando dos recursos mais avanados do Driver, recomenda-se iniciar a leitura pelo tpico Guia de
Configurao Rpida.
Para a criao de aplicaes de grande porte, recomenda-se tambm a leitura do tpico Dicas de
Otimizao.
Caso no conhea o protocolo, consulte os tpicos a seguir:
O Protocolo Modbus
Sites Recomendados
Funes Suportadas
Funes Especiais
Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.
Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11
O Protocolo Modbus
O protocolo Modbus foi desenvolvido inicialmente pela Modicon em 1979, sendo hoje um padro aberto,
mantido pela Organizao Modbus (modbus.org), tendo sido implementado por centenas de fabricantes em
milhares de equipamentos. A Schneider Electric, atual controladora da Modicon, transferiu os direitos do
protocolo para a Organizao Modbus em abril de 2004, firmando o compromisso de manter o protocolo
aberto. A especificao pode ser obtida gratuitamente no site da Organizao (www.modbus.org), e a
utilizao do protocolo livre de taxas de licenciamento.
O protocolo baseado em mensagens de comando e resposta, posicionado no nvel 7 do modelo OSI
(camada de aplicao), que possibilita comunicao cliente e servidor entre equipamentos conectados a
diferentes tipos de redes. Oferece servios com funes definidas por um cdigo de oito bits. Existem trs
categorias de cdigos de funes:
Cdigos de funes pblicas: Funes bem definidas pelo protocolo, com garantia de unicidade,
validadas pela comunidade Modbus e publicamente documentadas em MB IETF RFC. Podem assumir
valores de 1 a 64, de 73 a 99 e de 111 a 127.
Cdigos de funes definidas pelo usurio: Funes no padronizadas, que no precisam de
aprovao da Modbus.org, sem qualquer garantia de unicidade, podendo ser livremente
implementadas. Podem assumir valores nas faixas de 65 a 72 e de 100 a 110.
Cdigos de funes reservadas: Cdigos com valores dentro da faixa de funes pblicas, atualmente
usados por alguns fabricantes em produtos antigos, e no mais disponveis para uso pblico. So
exemplos os cdigos 9, 10, 13, 14, 41, 42, 90, 91, 125, 126 e 127. Para mais informaes, consulte o
Anexo A da especificao do protocolo (verso 1.1b), que est disponvel no site oficial do protocolo.
Este Driver implementa 11 das 19 funes pblicas previstas na verso atual (1.1b) da especificao do
protocolo, bem como algumas funes especficas de fabricantes ou relacionadas a recursos especficos do
Driver, denominadas Funes Especiais. As funes pblicas implementadas so descritas no tpico Funes
Suportadas. As seguintes funes pblicas do protocolo ainda no so suportadas:
Funo 08: Diagnostic
Funo 11: Get Com event counter
Funo 12: Get Com Event Log
Funo 17: Report Slave ID
Funo 22: Mask Write Register
Funo 23: Read/Write Multiple Registers
Funo 24: Read FIFO queue
Funo 43: Read Device Identification
Caso identifique a necessidade de implementar alguma destas funes, entre em contato com o
departamento comercial da Elipse.
Sites Recomendados
O Driver Modbus da Elipse est disponvel para download (sem custos) no site da Elipse, na rea de
download de Drivers.
Maiores informaes referentes ao protocolo Modbus podem ser obtidas no site www.modbus.org, site
oficial do protocolo.
O Simulador Modbus Slave Modsim, provavelmente o mais conhecido da categoria, pode ser adquirido em
www.win-tech.com/html/modsim32.htm. Este software emula o equipamento, permitindo a comunicao
com o Driver.
Existe tambm a alternativa gratuita Free Modbus PLC Simulator, disponvel para download no site
www.plcsimulator.org.
Outras alternativas de simuladores e outras ferramentas de software relacionadas ao protocolo podem ser
encontradas no site oficial do protocolo.
Funes Suportadas
As funes do protocolo Modbus suportadas por este Driver esto descritas a seguir.
Funes de leitura
01: Leitura de Bit (Read Coil Status - 0x)
02: Leitura de Bit (Read Input Status - 1x)
03: Leitura de Words (Read Holding Registers - 4x)
04: Leitura de Words (Read Input Registers - 3x)
07: Leitura de Status (Read Exception Status)
20: Leitura de Registro de Arquivo (Read File Register - 6x)
Funes de escrita
05: Escrita de Bit (Force Single Coil - 0x)
06: Escrita de Word Simples (Preset Single Register - 4x)
15: Escrita de Bits (Force Multiple Coils - 0x)
16: Escrita de Words (Preset Multiple Registers - 4x)
21: Escrita de Registro de Arquivo (Write File Register - 6x)
Alm das funes padro do protocolo, como j referido, o Driver tambm implementa funes especiais, no
definidas pelo protocolo, em geral relacionadas leitura da memria de massa. A lista das funes especiais
suportadas pode ser conferida no tpico Funes Especiais. A configurao completa do Driver est descrita
no tpico Configurao. Caso identifique a necessidade de adicionar suporte a alguma funo nova neste
Driver, entre em contato com o departamento comercial da Elipse.
Funes Especiais
As funes especiais de leitura e escrita so funes deste Driver que no so definidas pelo protocolo
Modbus padro. Foram desenvolvidas para atender particularidades exclusivas de determinados

equipamentos, ou tambm para disponibilizar, de forma padronizada pelo Driver, recursos no disponveis no
protocolo padro. O Driver Modbus, na atual verso, inclui as seguintes funes especiais:
Funes de leitura
65 03: Leitura da Memria de Massa (ABB MGE 144). Vista em maiores detalhes no tpico Leitura de
Registros da Memria de Massa de Medidores ABB MGE 144.
GE SOE: Leitura de eventos (GE PAC RX7 Systems). Mais informaes so fornecidas no tpico Leitura
de Buffer de Eventos em Controladores GE PAC RX7.
SP SOE: Leitura de eventos (rels Schneider Electric srie SEPAM). Esta funo detalhada mais
adiante no tpico Leitura de Eventos de Rels Schneider Electric SEPAM 20, 40 e 80.
GenSOE: Leitura de SOE com algoritmo genrico, implementado pelo software residente no
equipamento escravo (CLP). A funo discutida em maiores detalhes no tpico Algoritmo de Leitura
de SOE Genrico da Elipse.
Funes de escrita
65 01: Reinicializa (executa o Reset) o medidor de energia (ABB MGE 144). O comando enviado como
um simples comando de escrita (Write) do Tag. O campo Valor do Tag ignorado pelo Driver, e pode
ser deixado em zero. Para mais informaes, consulte o manual do equipamento.
65 02: Zera a memria de mximos e mnimos (ABB MGE 144). O comando enviado com um simples
comando de escrita (Write) do Tag. O campo Valor do Tag ignorado pelo Driver, e pode ser deixado
em zero. Para mais informaes, consulte o manual do equipamento.
Note que as funes especiais neste Driver, com exceo da funo de escrita 65 01, esto relacionadas
direta ou indiretamente leitura de registros de memria de massa dos respectivos equipamentos. Para mais
informaes, consulte o tpico Leitura de Memria de Massa. Para a descrio da configurao de
operaes e Tags usando estas funes, leia o tpico Configurao.
Adicionando o Driver em uma Aplicao Elipse

Esta seo descreve como adicionar o Driver Modbus em aplicaes Elipse Power ou E3 e Elipse SCADA.
Elipse E3 ou Power
Atravs do Organizer, selecione o item Objetos de Servidor e ento Drivers e OPC. Com o boto direito do
mouse, selecione a opo Inserir Driver de Comunicao em e selecione o projeto desejado.
Adicionar um Driver a uma aplicao E3 ou Elipse Power
Na janela aberta, selecione o Driver desejado (o arquivo deve ser descompactado em uma pasta no
computador que est sendo utilizado) e clique em Abrir.
Janela Localizar Driver
Na janela de configurao do Driver que se abre, configure o Driver conforme a necessidade.
Aba Operations
No segundo passo do tpico Guia de Configurao Rpida apresentado o procedimento para a

configurao bsica do Driver, para os casos de uso mais comuns. No tpico Propriedades a configurao
apresentada em detalhes.
A janela de configurao do Driver pode sempre ser aberta, posteriormente, clicando-se em
driver, conforme mostrado na figura a seguir.
Configurar o
Janela de configurao do Driver no Organizer

Aps a configurao das propriedades do Driver, clique em OK para que o E3 abra a janela do Tag Browser,
permitindo inserir na aplicao Tags pr-definidos, com base nas operaes configuradas. A figura a seguir
mostra a janela do Tag Browser. Para adicionar Tags, arraste-os da lista direita (Tags disponibilizados pelo
Driver) para a lista esquerda (Tags do projeto corrente).
Janela do Tag Browser
Note que os Tags so, por padro, nomeados com o prefixo "Op", seguido do nmero da operao que ele
representa e do tipo de dados configurado para a operao entre os caracteres "<" e ">". O nome pode ser
alterado posteriormente, no Organizer da aplicao.
NOTA: O Driver j apresenta sete operaes pr-definidas, das quais a mais comumente usada a
operao 01. Se houver necessidade de apenas ler e escrever um tipo Word usando as funes 03 e 16, as
mais largamente utilizadas do protocolo, e se o equipamento aderente ao protocolo Modbus padro no
que se refere ao byte order (veja o tpico Aba Operations), ento no preciso alterar a configurao das
operaes, bastando definir Tags com N2/B2 = 1 (veja o tpico Configurando um Tag de Comunicao).
Neste caso, pode-se usar o Tag pr-definido Op1<word> como modelo para os demais Tags da aplicao.
Elipse SCADA
Atravs do Organizer, selecione o item Drivers e clique em Novo.
Adicionar novo Driver ao Elipse SCADA
Na janela que se abre, selecione o Driver desejado (o arquivo deve ser descompactado em uma pasta no
computador que est sendo utilizado) e clique em Abrir.
Selecionar Driver
O Driver ento adicionado na aplicao.
Driver no Organizer
Para que o Driver funcione corretamente, ainda preciso configur-lo em sua janela de configurao. Para
abrir esta janela, mostrada na figura a seguir, clique em Extras.
Janela de configurao do Driver
O segundo passo do Guia de Configurao Rpida mostra como configurar o Driver para os casos de uso
mais comuns, para equipamentos que aderem aos requisitos do protocolo Modbus padro. No tpico
Propriedades a configurao descrita em detalhes, incluindo os recursos avanados de configurao.
Configurao
Esta seo descreve como configurar o Driver Modbus. So abordados os seguintes tpicos:
Propriedades
Configurando Tags
Leitura de Memria de Massa
Propriedades
As propriedades do Driver podem ser configuradas em tempo de configurao (design time) ou em tempo de
execuo (run time). A configurao em tempo de execuo (run time) tambm chamada de Configurao
em Modo Offline, e descrita em um tpico especfico.
Em tempo de configurao, o Driver pode ser configurado por meio de sua janela de configurao, mostrada
na figura a seguir.
Janela de configurao do Driver
Para abrir a janela de configurao do Driver no E3 ou no Elipse Power, selecione o objeto Driver no
Organizer e clique em Configurar o driver, conforme mostrado na figura a seguir.
Janela de configurao do Driver no Organizer
J no Elipse SCADA, a janela de configurao do Driver pode ser aberta clicando-se em Extras, no Organizer
da aplicao.
A janela de configurao dividida em vrias abas, sendo algumas para a configurao do IOKit, e outras
especficas para o Driver. No caso do Driver Modbus, as abas Operations, Modbus e Gen SOE so
especficas. As demais so abas de configurao do IOKit, e no so descritas neste Manual. Para
informaes sobre a configurao do IOKit, consulte o Manual do Usurio do IOKit.
Os tpicos a seguir descrevem as abas especficas do Driver, e tambm a configurao em tempo de
execuo, no chamado Modo Offline, utilizando scripts.
Aba Operations
Aba Modbus
Aba Gen SOE
Configurao em Modo Offline
Aba Operations
Este tpico descreve a configurao da aba Operations da janela de configurao do Driver, onde so
definidas as operaes utilizadas nos Tags de Comunicao, mostrada na figura a seguir.
Aba Operations
Operaes
Para o correto funcionamento deste Driver, necessrio definir quais as funes Modbus de leitura ou
escrita so utilizadas para cada Tag de Comunicao. Para isto, deve-se selecionar a aba Operations na
janela de configuraes.
Para este Driver, so chamadas Operaes as configuraes que definem como cada Tag de Comunicao
executa a leitura e a escrita de dados no equipamento.
Uma operao nada mais do que a definio de um par de funes do protocolo, uma para escrita e
outra para a leitura, e a especificao de converses adicionais no formato dos dados, que podem ser
associados aos Tags da aplicao, ou seja, no Driver Modbus os parmetros N ou B dos Tags de
Comunicao no referenciam diretamente as funes do protocolo, mas sim operaes pr-configuradas,
que por sua vez no s informam as funes (nativas do protocolo ou mesmo especiais) a serem usadas na
comunicao, como tambm a forma como os dados nativos do protocolo devem ser interpretados.
A configurao dos parmetros dos Tags de Comunicao descrita mais adiante neste Manual, no tpico
Configurando um Tag de Comunicao. A seguir descrita a configurao das operaes, que mais tarde
devem ser associadas a cada Tag de Comunicao.
NOTA: As operaes funcionam apenas como modelos, ou templates, para a configurao de Tags de
Comunicao, sendo possvel, e em geral necessrio, atribuir uma mesma operao a diversos Tags, que
tm em comum o mesmo valor em seus parmetros N2/B2.
Funes
O protocolo Modbus define funes de leitura e escrita, as quais podem acessar espaos de endereamento
distintos no equipamento, e com tipos de dados especficos. As funes 3 e 16, por exemplo, as mais usadas
do protocolo, so responsveis respectivamente pela leitura e escrita de Holding Registers, que nada mais
so do que valores inteiros sem sinal de 16 bits (Word).
As funes do protocolo Modbus padro fornecem dados apenas em formatos bsicos de Bit e Word de 16
bits. No existem formatos de dados adicionais na especificao do protocolo.
A lista das funes Modbus suportadas pelo Driver, e que podem ser atribudas s operaes configuradas,
pode ser conferida no tpico Funes Suportadas.
Alm das funes do protocolo, o Driver tambm contm algumas Funes Especiais, que no fazem parte do
protocolo padro, de formato proprietrio, utilizadas em geral para a leitura de eventos (SOE).
Formatao de dados
Alm de permitir a associao das funes (do protocolo ou especiais) a Tags especficos, as operaes
tambm permitem a definio de formatao adicional a ser aplicada aos dados, possibilitando o suporte a
tipos de dados adicionais, no especificados pelo protocolo, como por exemplo valores de ponto flutuante de
32 bits (Float) e 64 bits (Double). Os tipos suportados so descritos no tpico Tipos de Dados Suportados.
importante observar que, quando tipos de 32 e 64 bits forem definidos nas operaes, necessrio definir
funes do protocolo que trabalhem com registros de 16 bits. Desta forma, a leitura de dados com mais de 16
bits resulta na leitura de vrios registros Modbus de 16 bits do equipamento, ou seja, para a leitura de um
Tag associado a uma operao que defina o tipo de dado Float de 32 bits, o Driver precisa ler dois registros
consecutivos de 16 bits do equipamento, concaten-los, e realizar a converso para o formato Float.
Tambm possvel definir tipos de dados de oito bits (Byte, Int8 ou Char) nas operaes. Note que, uma vez
que as funes do protocolo no permitem a leitura e escrita de bytes isolados, para cada dois Elementos de
Bloco de tipos de oito bits o Driver obrigado a acessar um registro distinto de 16 bits no equipamento. Por
este motivo, o Driver no permite a escrita de tipos de oito bits em Tags, Elementos isolados de Bloco, ou
Blocos de tamanho mpar ou unitrio. A escrita de tipos de oito bits deve ser realizada sempre em Blocos de
tamanho par.
Tipos definidos pelo usurio
Alm dos tipos pr-definidos (tipos nativos ou built-in) descritos no tpico Tipos de Dados Suportados, este
Driver permite tambm tipos definidos pelo usurio. Estes tipos devem ser declarados em janela especfica,
clicando-se em User Defined Types, na parte inferior da aba. Tais tipos consistem em estruturas criadas a
partir dos tipos pr-definidos. Para mais informaes sobre os tipos definidos pelo usurio, consulte o tpico
Tipos Definidos pelo Usurio.
Byte order
Alm das funes de leitura e escrita do protocolo e do tipo de dado utilizado, cada operao permite
tambm atribuir manipulaes adicionais aos bytes, relacionadas ao chamado byte order, ou seja, a ordem
dos bytes dentro de cada valor. So as chamadas opes de swap (Swap Bytes, Swap Words e Swap
DWords). Tais opes somente necessitam ser habilitadas no caso de equipamentos que no respeitam o
byte order padro do protocolo.
O protocolo Modbus define que seus valores de 16 bits utilizam sempre o byte order chamado de big endian,
tambm conhecido como Motorola, por ser utilizado por este fabricante. O padro big endian define sempre a
ordem dos bytes de tal forma que o byte mais significativo de cada valor venha sempre antes. Desta forma,
como exemplo, na leitura do valor hexadecimal 1234h, o equipamento envia primeiro o byte mais
significativo 12h, e logo a seguir o menos significativo, 34h.
No caso de equipamentos que no implementem o byte order padro do protocolo, e que utilizem o chamado
little endian ou Intel, os dados so enviados com os bytes menos significativos antes. preciso ento
habilitar as opes de swap para inverter a ordem dos bytes.
H ainda equipamentos que usam byte orders diferentes para tipos de 32 e 16 bits. No caso, por exemplo, de
equipamentos que usem o byte order padro do Modbus (big endian) para tipos de 16 bits, porm forneam
dados de 32 bits com o Word menos significativo vindo primeiro (little endian), necessrio habilitar apenas
a opo Swap Words, deixando desmarcada a opo Swap Bytes. Em suma, pode-se ter basicamente trs
situaes:
Caso o equipamento fornea dados usando o byte order padro do protocolo Modbus (Motorola ou big
endian), com os bytes mais significativos vindo antes, deve-se deixar as opes de swap todas
desabilitadas. Esta a situao mais comum.
Caso o equipamento use outro padro de byte order, com os bytes menos significativos vindo antes
(little endian), necessrio habilitar-se todas as opes de swap referentes ao tipo usado, ou seja,
para tipos de 16 bits, habilite a opo Swap Bytes. Para tipos de 32 bits, habilite as opes Swap Bytes
e Swap Words. Para tipos de 64 bits, as trs opes de swap devem ser habilitadas.
No caso menos comum, de equipamentos que usem byte orders diferentes para tamanhos de dados
diferentes, fornecendo por exemplo o byte mais significativo de cada Word primeiro, porm o Word
menos significativo de cada DWord primeiro, ser preciso avaliar em qual caso cada opo de permuta
ou swap precisar ser habilitada, de forma a converter o valor retornado pelo equipamento para o
formato big endian padro do protocolo.
NOTA: As opes de swap citadas no tm efeito para tipos de dados Bit ou tipos com tamanho de oito bits
(Byte, Char e Int8). A permuta ocorre dentro de cada tipo de dado, ou seja, a opo Swap Words no tem
efeito para tipos de dados de 16 bits, assim como a opo Swap DWords no tem efeito para tipos de
dados de 32 bits. Os tipos BCD tambm no permitem swaps.
Para saber se o equipamento utiliza algum formato diferenciado de byte order, consulte a documentao do
fabricante. Caso a informao no seja encontrada na documentao, o suporte tcnico do fabricante deve
ser contactado.
O tpico Dvidas Mais Frequentes deste Manual contm dicas de configuraes de byte order para alguns
equipamentos, para os quais j se sabe ser necessrio utilizar as opes de swap.
Mscara de bits
A opo Use Bit Mask um recurso avanado, utilizada em casos mais especficos e raros em que o usurio
deseja ler somente um bit do valor retornado pelo equipamento, mas no possvel usar o mapeamento de
bits da aplicao.
Para a maioria dos usurios, os campos de mapeamento de bits da aplicao so a melhor alternativa para o
acesso mscaras de bits, no sendo preciso recorrer a este recurso do Driver.
Este recurso foi criado originalmente para permitir a leitura de bits de Holding Registers por bibliotecas
especializadas do E3, em situaes que impediam o uso do mapeamento de bits da aplicao.
Neste caso, o Driver l normalmente o valor do equipamento e ento o mascara, de forma a retornar ao
campo Valor do Tag apenas o bit especificado (0 ou 1). A definio do nmero do bit a ser retornado feita
no parmetro N3/B3 do Tag de Comunicao.
A opo Use Bit Mask somente pode ser utilizada com tipos inteiros de 16 bits ou mais (Int16, Int32, Word
ou DWord). Alm disto, operaes que habilitam esta opo podem ser utilizadas apenas para a leitura. A
funo Modbus de escrita (Write) de operaes que utilizam esta opo de mscara podem ser definidas
como None (nenhuma).
Operaes padro do Driver
Por padro, quando um novo Driver adicionado aplicao, este Driver j criado com sete operaes
padro, descritas na tabela a seguir.
Operaes padro
OPERAO
1
FUNO DE LEITURA FUNO DE ESCRITA

TIPO DE DADO
3 - Read Holding
16 - Write Multiple Word
Registers
Registers
3 - Read Holding
Registers
16 - Write Multiple
Registers
DWord
3 - Read Holding
Registers
16 - Write Multiple
Registers
Int16
3 - Read Holding
Registers
16 - Write Multiple
Registers
Int32
3 - Read Holding
Registers
16 - Write Multiple
Registers
Float
3 - Read Holding
Registers
15 - Write Multiple
Coils
Bit
FINALIDADE
Para ler e escrever
inteiros de 16 bits
sem sinal
Para ler e escrever
inteiros de 32 bits
sem sinal
Para ler e escrever
inteiros de 16 bits
com sinal
Para ler e escrever
inteiros de 32 bits
com sinal
Para ler valores com
ponto flutuante de
32 bits
Para ler e escrever
bits
OPERAO
7

TIPO DE DADO
2 - Read Discrete
None
Bit
Inputs
FINALIDADE
Para ler bits do
bloco de dados de
Entradas Discretas
(Discrete Inputs)
Estas operaes so as mais comumente usadas, sendo a operao 1 a mais comum. Para a maior parte
dos equipamentos, basta selecionar as operaes necessrias entre as j fornecidas por padro, no sendo
necessrio criar novas operaes ou alterar a configurao das operaes padro.
Definio de novas operaes
Para adicionar uma nova operao no Driver, clique em Add.
Adicionar operao
Conforme a figura anterior, aps clicar em Add necessrio configurar a nova operao. Deve-se selecionar
um nmero para esta operao (este nmero utilizado no parmetro N2/B2 dos Tags de Comunicao), qual
funo deseja-se utilizar para leitura e qual funo deseja-se utilizar para escrita, alm de informar o tipo de
dado que lido ou escrito pelo Driver. Note que, ao clicar em Add, o Driver j sugere um valor que ainda no
esteja em uso para a nova operao.
Para mais informaes sobre os tipos de dados suportados, veja o tpico Tipos de Dados Suportados. Os
demais campos devem ser configurados conforme a necessidade. A tabela a seguir contm a descrio
destes campos.
Opes de campos
OPO
DESCRIO
Deve ser informado o tamanho em bytes de cada
elemento do tipo de dado selecionado. Este campo
preenchido automaticamente para tipos de dados
com tamanho fixo, como os tipos Byte, Word e
Int16, devendo ser preenchido para dados de tipo
String e BCD. No caso de Strings, este tamanho
define exatamente o nmero de bytes enviados ou
recebidos para cada valor String, isto , para cada
Tag ou Elemento de Bloco. Se a String lida ou escrita
tiver um tamanho menor, o restante dos bytes
preenchido com zeros, de forma a completar o
tamanho configurado. O tipo String neste Driver no
possui um limite mximo de tamanho definido, sendo
este limite o mximo permitido pelo protocolo
para a rea de dados do frame de uma determinada
funo.
Indica que o Driver deve inverter a ordem dos bytes
um a um, para obter o valor.
dois a dois (em Words) para obter o valor.
quatro a quatro (em DWords) para obter o valor.
Habilita o mascaramento de bits de registradores,
atravs do parmetro N3/B3. Esta opo afeta
apenas a leitura e pode ser usada apenas com tipos
inteiros, com ou sem sinal, com pelo menos 16 bits
de tamanho (Int16, Int32, Word ou DWord).
Operaes com esta opo habilitada no podem ser
usadas para escrita. Para a maioria dos usurios,
recomenda-se usar o mapeamento de bits da
aplicao, deixando esta opo desmarcada (veja
a seo especfica).
Size
Swap Bytes
Swap Words
Swap DWords
Use Bit Mask
As funes do protocolo que podem ser configuradas nos campos Read e Write das operaes esto
descritas no tpico Funes Suportadas. A tabela a seguir descreve cada uma das opes disponveis.
Opes disponveis na aba Operations
OPO
Import Configuration
DESCRIO
Esta opo permite importar configuraes de
operaes de verses anteriores 2.0 do Driver
Modbus Master/Slave, que armazenavam estas
configuraes em um arquivo modbus.ini. Este Driver
no utiliza mais arquivos INI para armazenar tais
configuraes, que agora so armazenadas no
prprio arquivo da aplicao. Para maiores detalhes,
consulte o tpico Importao e Exportao de
Operaes.
OPO
DESCRIO
Esta opo executa a operao inversa da anterior,
gerando um arquivo INI contendo as configuraes
de operaes, no formato atual ou no mesmo
formato das verses anteriores deste Driver. Desta
forma, possvel guardar em um arquivo as
configuraes de operaes de um determinado
equipamento, que podem ser utilizadas em outras
aplicaes. Para maiores detalhes, consulte o tpico
Importao e Exportao de Operaes.
Adiciona uma nova operao lista.
Atualiza a operao selecionada na lista (equivale a
clicar duas vezes no item).
Remove a operao selecionada na lista.
Export Configuration
Add
Edit
Remove
NOTA: As opes Swap Bytes, Swap Words e Swap DWords, conforme j explicado, foram acrescentadas
para permitir compatibilidade com equipamentos que no seguem o padro do protocolo Modbus na
codificao dos dados (byte order). Se estas opes permanecerem desabilitadas, o comportamento do
Driver corresponde ao padro do protocolo, sendo esta a opo recomendada para a maioria dos
equipamentos.
Tipos de Dados Suportados
A tabela a seguir relaciona os tipos de dados nativos do Driver, que podem ser definidos na configurao de
operaes. Conforme j explicado no tpico Aba Operations, o protocolo Modbus em si tem suporte apenas
aos tipos Bit e Word (16 bits). Todos os demais tipos so implementados pelo Driver, e so convertidos para
Word no nvel do protocolo, para a leitura ou escrita no equipamento ou dispositivo escravo.
Vale lembrar que este Driver tambm suporta os Tipos Definidos pelo Usurio, definidos como estruturas
com elementos compostos com os tipos nativos da tabela a seguir.
Na tabela a seguir os tipos so designados pelo nome apresentado na caixa de seleo Data, na janela de
configurao do Driver (Aba Operations). Em alguns casos, denominaes alternativas frequentes so
apresentadas entre parnteses.
Opes disponveis para tipos de dados
TIPO
FAIXA
Char
-128 a 127
Byte
0 a 255
Int8
-128 a 127
Int16
Int32
Word (ou UInt)
DWord (ou ULong)
-32768 a 32767
-2147483648 a 2147483647
0 a 65535
0 a 4294967295
DESCRIO
Palavra de oito bits, caractere. A
escrita deve ocorrer sempre em
blocos de tamanho par (Words).
Palavra de oito bits sem sinal. A
Palavra de oito bits com sinal. A
Inteiro de 16 bits com sinal.
Inteiro de 32 bits com sinal.
Inteiro de 16 bits sem sinal.
Inteiro de 32 bits sem sinal
(Double Word).
TIPO
Float
FAIXA
-3.4E38 a 3.4E38
Float_GE
-1.427E+45 a 1.427E+45
Double (ou Real)
-1.7E308 a 1.7E308
String
No se aplica
BCD
Ver descrio
DESCRIO
Ponto flutuante de 32 bits (IEEE
754) (quatro bytes: EXP F2 F1 0).
Ponto flutuante de 32 bits usado
pela GE, no compatvel com IEEE
754. usado em equipamentos GE
GEDE UPS, com expoente de oito
bits 2[-128 ... + 127] e 24 bits de
mantissa [-223 ... + (223 - 1)].
(quatro bytes: EXP F2 F1 F0). Para
mais informaes, consulte a
documentao do equipamento.
Ponto flutuante de 64 bits (IEEE
754).
Texto em formato ANSI, com
nmero determinado de caracteres
ASCII de oito bits (Chars).
Valor numrico BCD (Decimal
Codificado em Binrio). Ao utilizar
este tipo, a aplicao deve
fornecer um valor decimal positivo
e inteiro, a ser enviado no formato
BCD, respeitando o tamanho
especificado. O campo Size, no
caso do tipo BCD, refere-se ao
nmero de bytes a serem enviados
para representar o valor. Uma vez
que na codificao BCD cada
algarismo convertido em um
nibble, tem-se que os valores
permitidos devem possuir um
nmero mximo de algarismos
igual ao dobro do valor
especificado no campo Size, ou
seja, se for selecionado o valor
dois para o campo Size, o mximo
valor que pode ser enviado 9999.
J se Size igual a quatro, o valor
mximo 99999999. Os valores
permitidos para o campo Size no
caso de tipos BCD so dois (Word)
e quatro (Double Word). Para
maiores detalhes sobre a
codificao BCD, consulte o tpico
Codificao BCD.
TIPO
FAIXA
GE_events
Ver descrio
Bit
0 (zero) ou 1 (um)
SP_events
Ver descrio
DESCRIO
Tipo de dado utilizado na leitura
do buffer de eventos (SOE) de CLP
GE PAC RX7. Sua definio
permitida apenas em operaes
que utilizem a funo especial de
leitura GE SOE. Estes eventos so
retornados como blocos de dois
Elementos, com timestamps
definidos pelo controlador. Para
mais informaes, veja o tpico
Leitura de Buffer de Eventos em
controladores GE PAC RX7.
Este tipo selecionado
automaticamente quando uma
funo de acesso a bits
selecionada. As funes de acesso
a bits so 01, 02, 05 e 15. O
campo Size no usado para tipos
Bit. Quando este tipo usado,
cada Tag ou Elemento de Tag
Bloco passa a representar um bit.
Tipo de dado utilizado na leitura de
eventos (SOE) de rels Schneider
Electric das sries SEPAM 20, 40 e
80. Sua definio s permitida
quando a operao utilizar como
funo de leitura a funo
especial SP SOE. Estes eventos
so retornados como um Bloco de
trs Elementos, com timestamp
fornecido pelo equipamento. Para
mais informaes, veja o tpico
Leitura de Eventos de Rels
Schneider Electric SEPAM 20, 40
e 80.
TIPO
GenTime
FAIXA
1/1/1970 00:00 a 31/12/2035
23:59:59.999 (ver nota a seguir)
Sp_time
1/1/1970 00:00 a 31/12/2035

UTC64d
1/1/1970 00:00 a 31/12/2035

UTC32
1/1/1970 00:00 a 31/12/2035

DESCRIO
Tipo data e hora composto por uma
estrutura de oito bytes, criado
originalmente para ser utilizado na
leitura de eventos que usam o
algoritmo de SOE Genrico
(GenSOE). Este tipo pode ser
utilizado com as demais funes
do protocolo Modbus, alm da
GenSOE. Como este formato lido
internamente como uma estrutura
de Words e a nica funo de
swap vlida para este tipo Swap
Bytes. A representao deste tipo
na memria do CLP descrita no
tpico Tipo GenTime. Para mais
informaes sobre este tipo,
consulte o tpico Algoritmo de
Leitura de SOE Genrico da
Elipse.
Tipo data e hora composto por uma
estrutura de oito bytes, utilizado
por rels Schneider Electric das
sries SEPAM 20, 40 e 80,
geralmente para representar um
timestamp. Para mais informaes,
consulte a documentao do
equipamento.
Tipo data e hora representado em
formato Double (IEEE 754 64 bits),
com os segundos desde 1/1/1970
00:00.
Tipo data e hora representado em
formato inteiro sem sinal de 32
bits (DWord ou UInt), com os
segundos desde 1/1/1970 00:00.
Neste formato no so
representados os milissegundos,
sendo considerados sempre 0
(zero).
NOTA: Embora a representao em si dos tipos data e hora da tabela anterior possa representar datas
superiores a 31/12/2035, este limite mostrado na tabela pelo fato de os aplicativos da Elipse no
possurem suporte, atualmente, para faixas de valores superiores a este limite em estampas de tempo
(timestamps).
Tipo GenTime
O tipo GenTime um tipo data e hora definido e adicionado originalmente ao Driver para uso com o
Algoritmo de Leitura de SOE Genrico da Elipse. Trata-se entretanto de um tipo genrico, que pode ser
usado com praticamente qualquer CLP, de forma simples.
Na aplicao do supervisrio, ou seja, nos valores dos Tags e Elementos de Bloco de Tags Bloco, bem como
no campo Timestamp dos Tags, este tipo, como alis todos os demais tipos data e hora do Driver,
representado por um tipo data e hora nativo da aplicao. Para mais informaes sobre os demais tipos data
e hora suportados pelo Driver, consulte o tpico Tipos de Dados Suportados. Para mais informaes sobre
os tipo data e hora da aplicao, consulte o respectivo manual do usurio (existem algumas diferenas do
Elipse SCADA para o VBScript utilizado no E3 e Elipse Power).
No CLP ou dispositivo escravo, este tipo representado por uma estrutura composta por quatro registradores
de 16 bits (oito bytes), conforme mostrado na tabela a seguir.
Estrutura dos registradores
OFFSET
CONTEDO
Ano
Dia / Ms
Hora / Minuto
Segundo / Milissegundo
MAPA DE BITS (16 BITS)

AAAAAAAA AAAAAAAA
DDDDDDDD
MMMMMMMM
HHHHHHHH
MMMMMMMM
SSSSSSMM
MMMMMMMM
FAIXA (DECIMAL)
Entre 0 e 65535
Entre 0 e 65535
Entre 0 e 65535
Entre 0 e 65535
Ou seja, o endereo base (offset 0), a ser atribudo no parmetro N4/B4 do Tag que acessa o dado contm o
ano. O registro seguinte (offset 1) tem o dia como byte mais significativo e o ms como o byte menos
significativo. J no offset 2 tem-se a hora representada no byte mais significativo e os minutos no byte menos
significativo. O quarto registro tem os quatro bits mais significativos do Word representando os segundos, e
os bits restantes (os dois menos significativos do byte mais significativo e o byte menos significativo inteiro)
representando os milissegundos.
Note que cada Tag que referencie este tipo fora o Driver a ler um bloco de quatro registros Modbus no
equipamento para representar o valor de cada Tag ou Elemento de Bloco para retornar um valor vlido.
As vantagens deste tipo so sua simplicidade ( fcil de gerar no ladder do CLP), sua preciso de
milissegundos e sua relativa compactao, no precisando ser suportado de forma nativa pelo CLP ou
dispositivo escravo.
NOTA: Embora o tipo GenTime em si tenha tamanho de oito bytes (quatro Words), a nica opo de swap
que tem efeito sobre ele Swap Bytes. Isto porque, conforme visto neste tpico, o tipo estruturado na
memria do CLP como tendo quatro Words, no sendo ele mesmo um tipo nativo do equipamento, e sim do
Driver. Mais informaes sobre as opes de swap (byte order) podem ser encontradas no tpico Aba
Operations.
Tipos Definidos pelo Usurio
Os tipos definidos pelo usurio, ou estruturas, aps configurados na janela de configurao User Defined
Types, podem ser usados nas operaes do Driver da mesma forma que os tipos pr-definidos.
Estes tipos so na verdade estruturas cujos elementos podem ter tipos nativos diferentes, ou seja, um tipo
definido pelo usurio nada mais do que uma estrutura definida a partir dos tipos j pr-definidos pelo
Driver (tipos nativos ou built-in), permitindo ao usurio configurar Tags Bloco onde cada Elemento pode ter
um tipo nativo diferente.
O usurio pode utilizar praticamente todos os tipos pr-definidos pelo Driver em suas estruturas. Somente
no so permitidos os tipos Bit, os tipos de oito bits, os tipos de tamanho varivel, como String e BCD, e
tipos de evento associados funes especficas de SOE.
Uma vez tendo definido um tipo, o usurio pode associ-lo a qualquer operao, desde que ela utilize
funes Modbus que suportem Words, ou seja, no permitida a associao de um tipo definido pelo
usurio a uma operao que defina como funo de leitura (Read) a funo 01, por exemplo, uma vez que
esta l apenas bits.
Alm da definio dos elementos da estrutura, cujos valores so retornados em Elementos de Bloco, o
usurio pode tambm definir o tipo do timestamp do Tag, bem como o endereo padro para a estrutura,
endereo que usado para o parmetro B4 dos Tags disponveis via Tag Browser do E3.
Aplicaes
Os tipos definidos pelo usurio foram originalmente implementados para uso em conjunto com a Rotina de
SOE Genrico do Driver Modbus (Gen SOE), uma vez que esta rotina executa a leitura de tabelas de
estruturas de dados.
Alm de poder ser utilizado com a rotina genrica de SOE, este recurso pode tambm ser usado para agrupar
dados de tipos diferentes em um mesmo Tag Bloco, otimizando a comunicao em aplicaes que no
contam com o recurso de Superblocos, caso do Elipse SCADA, ou caso o equipamento em uso por algum
motivo no permita o uso de Superblocos (veja o tpico Leitura por Superblocos).
Configurao de Tipos Definidos pelo Usurio
A configurao de tipos definidos pelo usurio realizada em janela especfica, clicando em User Defined
Types na Aba Operations da janela de configuraes do Driver, conforme a figura a seguir.
Aba Operations
A janela de configurao dos tipos definidos pelo usurio permite a edio do arquivo de configurao das
estruturas. Ao abrir a janela pela primeira vez, mostrado o arquivo de configurao padro (com
comentrios), e que define trs tipos de exemplo, que aparecem comentados por comentrios de mltiplas
linhas ("/*" e "*/"), conforme explicado a seguir.

A figura a seguir mostra a janela de configurao de tipos definidos pelo usurio, com um pequeno arquivo
definindo os trs tipos de exemplo.
Caixa de dilogo de configurao de estruturas
Note que os comentrios de linha iniciam sempre com "//", identificando tudo o que vier direita, na mesma
linha, como comentrio, seguindo o padro dos comentrios de linha da linguagem de programao C/C++.
Tambm so suportados comentrios de mltiplas linhas, seguindo novamente a mesma sintaxe do C/C++,
iniciando por "/*" e terminando com "*/". Note que o arquivo exemplo, que vem com o Driver, j aplica esta
forma de comentrio a seus tipos de exemplo, deixando-os comentados por padro.
medida que o texto do arquivo de configurao alterado, a barra de status mostra o resultado da anlise
sinttica do arquivo, em tempo real. Esta barra de status mostra a mensagem "Status: OK!" se no forem
detectados erros no arquivo.
A cada momento, a linha e a coluna da posio do cursor na caixa de edio so sempre mostradas no lado
direito da barra de status. Os erros mostrados na barra de status sempre referenciam ao nmero da linha e
da coluna onde ele foi detectado.
A verificao pode ser feita na ntegra tambm clicando-se em Verify e, em caso de erro, o cursor j
posicionado automaticamente na linha do erro.
A definio de cada tipo tem a seguinte sintaxe (os elementos entre colchetes so opcionais):
struct <Nome do Tipo>
{
[timestamp = <tipo data e hora>;]
[DefaultAddress = <endereo>;]
<tipo> [nome do elemento 1];
[...]
<tipo> [nome do elemento n];
}
Onde:
struct: Palavra-chave, em letras minsculas, que inicia a definio do tipo definido pelo usurio.
<Nome do Tipo>: Nome pelo qual o novo tipo identificado pelo Driver. Este o nome mostrado na
caixa de seleo Data, na configurao das operaes. Deve ter no mximo seis caracteres.
timestamp: Campo opcional que indica que a estrutura tem um timestamp definido pelo dispositivo,
que deve ser retornado no campo Timestamp do Tag. Cada estrutura pode ter no mximo um
timestamp. A ordem em que aparece na estrutura influencia a posio em que o campo lido no frame
retornado pelo equipamento (note que nos Tags este valor retornado somente no campo Timestamp).
Podem ser definidos quaisquer tipos data e hora suportados pelo Driver. Na verso atual, o Driver
suporta os tipos data e hora GenTime, Sp_time, UTC64d e UTC32. Para mais informaes sobre tipos
de dados, consulte o tpico Tipos de Dados Suportados pelo Driver.
DefaultAddress: Campo opcional que especifica um valor de endereo padro, usado para preencher o
parmetro B4 dos Tags no Tag Browser que referenciem as operaes contendo a estrutura definida.
Os valores de endereo podem ser fornecidos em decimal ou em hexadecimal. Para usar este ltimo,
preciso preceder o nmero com o prefixo "0x" (por exemplo, usar "0x10" para codificar o valor decimal
16 em hexadecimal).
<tipo data e hora>: Tipos data e hora pr-definidos pelo Driver, que podem ser utilizados como
timestamp pelo dispositivo escravo. Na atual verso do Driver, so aceitos os tipos nativos GenTime,
Sp_time, UTC32 e UTC64d.
<tipo>: Tipo do elemento. Deve ser definido como um dos tipos pr-definidos pelo Driver, e escrito da
mesma forma que aparece na caixa de seleo Data, no frame de configurao dos parmetros das
operaes, considerando letras maisculas e minsculas. No so permitidos tipos Bit, tipos de oito
bits e nem tipos de tamanho varivel, como BCD e String.
[nome do elemento]: Parmetro opcional que define o nome de cada Elemento do Bloco. Se definido,
determina o nome dos Elementos de Bloco nos Tags presentes no Tag Browser do E3. Se no for
definido na declarao da estrutura, o Driver atribui nomes padro aos Elementos no Tag Browser, com
a palavra-chave "Element" seguida do valor do ndice do Elemento dentro do Bloco ("Element1",
"Element2", etc.).
Importao e Exportao
As opes Import File e Export File permitem importar e exportar o arquivo de configurao de tipos do
usurio para arquivos texto em disco. Podem ser utilizados para a realizao de cpias de segurana do
arquivo, ou para compartilh-lo entre vrios Drivers. O arquivo sempre gravado e lido no formato ANSI
padro do Windows (Charset Windows-1252). Futuras verses do Driver podem suportar outros formatos.
Alm de copiar o arquivo para o disco, pode-se tambm usar as teclas de atalho CTRL + A (Selecionar Tudo),
CTRL + C (Copiar) e CTRL + V (Colar) para copiar e colar o contedo do arquivo em outro editor de texto.
A opo Load Default Configuration carrega novamente no editor o arquivo padro de configurao, o
mesmo que j vem carregado no editor quando a janela de configurao aberta pela primeira vez.
NOTA: Ao clicar em Cancel, todas as alteraes realizadas no arquivo so descartadas pelo Driver.
Clicando-se em OK, o arquivo armazenado na aplicao. Esta operao realiza a verificao completa do
arquivo e se for identificado algum erro, este mostrado e a janela no fechada. Se for preciso salvar
alteraes com erros ainda pendentes, exporte o arquivo ou copie-o e cole-o em outro editor.
Utilizando Tipos Definidos pelo Usurio
Aps a definio dos novos tipos no arquivo de configurao na janela User-Defined Types, estes tipos esto
disponveis para uso nas operaes do Driver. Lembre-se que somente as operaes que utilizam funes
Modbus para acesso a registradores de 16 bits, como por exemplo as funes 03, 04, 06 e 16, permitem tipos
definidos pelo usurio.
A figura a seguir mostra a configurao de uma nova operao que utiliza o tipo definido pelo usurio
(estrutura) de nome TYPE3, mostrado no exemplo acima, aps o usurio clicar em Add.
Adicionar tipo definido pelo usurio
NOTA: As opes de swap para tipos definidos pelo usurio tm efeito apenas nos elementos da estrutura
definida, e no na estrutura inteira, ou seja, se for habilitada a opo Swap Words, todos os elementos
com mais de 16 bits tm seus Words permutados. Os elementos de 16 bits, entretanto, no so alterados.
Aps a definio da nova operao, usando o novo tipo TYPE3, defina um Tag Bloco com o mesmo tipo e com
tamanho igual ao nmero de elementos da estrutura, conforme mostrado na figura a seguir.
Declarao de Tags usando estruturas no E3 ou Elipse Power
Se foi definido o nome para cada elemento da estrutura, possvel utilizar o Tag Browser do E3 para incluir
um Tag Bloco referente ao tipo desejado na aplicao, sem precisar digitar novamente. A figura a seguir
ilustra o procedimento.
Uso do Tag Browser para definir Tags usando estruturas
Como a figura sugere, clique em

para abrir o Tag Browser e arrastar o tipo desejado da lista de Tags do
Driver para a lista de Tags do projeto corrente.
Leitura Reportada a Eventos

Os tipos definidos pelo usurio ou estruturas so comumente utilizados para a definio de eventos na
memria do CLP, podendo ser usados com o Algoritmo de Leitura de SOE Genrico da Elipse. Se entretanto
for necessrio ler eventos organizados na memria do CLP, como uma sequncia de estruturas, em uma
operao que utilize apenas funo pblica de leitura do protocolo, ou seja, sem o emprego de funes
especiais com algoritmo de SOE, tal procedimento pode ser realizado de duas formas:
Leitura em Bloco: Crie um Bloco com um nmero de Elementos que seja mltiplo do nmero de
elementos das estruturas de dados do usurio. Por exemplo, um tipo de usurio ou estrutura com dois
elementos que represente eventos acumulados em um arranjo na memria do CLP. Caso se deseje ler
em bloco cinco eventos, necessrio definir um Tag Bloco contendo 10 Elementos. Assim, uma nica
leitura neste Tag traz todos os eventos de uma s vez.
Leitura Reportada a Evento: Usa uma sequncia de eventos OnRead do Tag para ler o bloco de dados.
Com isto, considerando o exemplo do item anterior, ao invs de criar um Tag com 10 Elementos, o
usurio precisa criar apenas um nico Tag Bloco com dois Elementos, configurando o parmetro B3 com
o valor "5". Desta forma, ao realizar a leitura do Tag, o E3 chama cinco vezes o evento OnRead do Tag,
e em cada chamada os Elementos e propriedades do Tag Bloco contm dados relativos a um evento
especfico. O uso mais comum dos Tags reportados a evento o armazenamento dos eventos lidos
diretamente na base de dados de histrico. Isto facilmente executado atravs do mtodo
WriteRecord do objeto Histrico previamente associado ao Tag, dentro do evento OnRead do Tag
reportado a evento. Para mais informaes, consulte o tpico sobre Tags Reportados a Eventos no
Manual do Usurio do E3.
Em outras palavras, todo Tag de Comunicao que use estruturas e que utilize uma funo pblica de
leitura do protocolo (este recurso no funciona para funes especiais de SOE), torna-se um Tag Reportado
a Eventos se o seu parmetro B3 for configurado com um valor no nulo.
No caso de funes especiais de SOE, como a funo Gen SOE, o retorno reportado a eventos definido pelo
prprio algoritmo proprietrio da funo.
Para mais informaes a respeito da configurao de Tags de Comunicao, consulte o tpico Configurando
um Tag de Comunicao.
IMPORTANTE: Ao ler eventos de memria de massa em Tags reportados a eventos no E3, desabilite a
banda morta no Tag (propriedade EnableDeadBand configurada como Falso) e tambm no objeto Histrico
associado (propriedade DeadBand igual a zero), para evitar a perda de eventos com valores prximos.
Tambm importante desabilitar o histrico por varredura (no E3, propriedade ScanTime igual a zero). Com
isto, garante-se que novos eventos s so armazenados atravs do mtodo WriteRecord, executado no
evento OnRead do Tag, evitando a duplicao de eventos.
Importao e Exportao de Operaes
A importao e exportao de operaes pode ser realizada na aba Operations do Driver, clicando em
Import Configuration ou em Export Configuration, conforme mostrado na figura a seguir.
Opes de importao e exportao de configuraes
Estas opes tornam possvel importar e exportar a configurao de operaes mostrada no quadro Modbus
Operations para arquivos INI.
Nas verses anteriores 2.00 deste Driver, a configurao das operaes era executada no arquivo
modbus.ini, que era carregado no momento da inicializao do objeto Driver. Os arquivos modbus.ini destas
verses antigas ainda podem ser carregados na verso atual do Driver, utilizando a opo de importao.
NOTA: As operaes do Driver eram chamadas de Funes do Driver nas verses iniciais. Esta
denominao foi posteriormente alterada para Operaes do Driver devido a casos observados em que
havia confuso com as Funes do Protocolo.
Importao
A importao de arquivos de configurao bastante simples. Clique em Import Configuration e selecione o
arquivo INI. O Driver deve carregar as configuraes de operaes, que aparecem imediatamente no quadro
Modbus Operations. Este Driver permite a importao de arquivos gerados pelas suas verses anteriores.
Exportao
A exportao de arquivos de configurao de operaes pode ser realizada para compartilhar a mesma
configurao de operaes em diferentes objetos Driver, bem como para a eventual realizao de cpia de
segurana (backup) da configurao de operaes de um determinado equipamento.
Outra possvel utilidade a exportao das configuraes para um arquivo modbus.ini compatvel com
verses anteriores do Driver, permitindo carregar as configuraes nesta verso anterior. Trata-se de uma
prtica pouco recomendada mas que, caso seja inevitvel em aplicaes legadas, requer as consideraes
feitas a seguir.
Ao clicar em Export Configuration, abre-se uma janela com duas opes, conforme a figura a seguir.
Opes de exportao
Nesta janela deve-se selecionar entre exportar conforme o novo padro (New format with type
mnemonics), com os tipos exibidos sendo definidos com Strings (mnemnicos), ou no formato antigo (Old
format with types' numeric codes), em que os tipos eram identificados por um valor numrico,
correspondente posio em que apareciam na caixa de seleo Data na aba Operations.
O formato novo mais legvel, facilitando a depurao, e utilizado nas prximas verses deste Driver,
sendo a opo mais recomendada.
J o formato antigo deve ser selecionado somente se for imprescindvel exportar para verses anteriores
verso 2.08 deste Driver.
Note que, para exportar com sucesso arquivos modbus.ini a serem carregados em verses anteriores
verso 2.00, as operaes no podem definir nenhum tipo de dado novo que no tenha sido implementado
pela verso de destino, e nem tampouco ter operaes que utilizem o parmetro Use bit mask, caso contrrio
a importao pode falhar.
De maneira geral, recomenda-se evitar a exportao de configuraes para verses anteriores, priorizando
sempre a atualizao do Driver.
Aba Modbus
A aba Modbus permite a configurao de parmetros do Driver e do protocolo, conforme a figura a seguir.
Aba Modbus
A tabela a seguir descreve as opes de configurao presentes nesta aba.

Opes disponveis na aba Modbus
OPO
Modbus Mode
DESCRIO
Nessa caixa de seleo possvel selecionar o modo
do protocolo a ser utilizado. Os modos do protocolo so
variaes definidas pela norma para melhor adapt-lo
a diferentes meios fsicos (Serial, Ethernet TCP/IP,
RAS, etc.). So trs as opes disponveis:
Modo RTU: Modo padro para uso em comunicao
serial. Inclui CRC de 16 bits.
Modo ASCII: Tambm usado em comunicao serial,
utilizado em equipamentos mais simples, que no
suportam os requisitos do modo RTU. Utiliza
caracteres ASCII para transmisso, onde cada byte
contm dois caracteres ASCII (um por nibble), sendo
por isto menos eficiente que o modo RTU e mais
raramente encontrado no mercado. Usa LRC
(Longitudinal Redundancy Checking) para a
verificao de erros.
Modo ModbusTCP: Usado para comunicao em
TCP/IP. Inclui campo para verificao de transao e
no possui sistema de verificao de erros. O campo
de transao permite descartar respostas atrasadas,
evitando assim que o Driver assuma como resposta
vlida para o comando atual os frames de resposta a
comandos anteriores. Esta situao pode ocorrer se
os modos anteriores forem encapsulados em TCP/IP.
OPO
Customize Max. PDU Size
Enable CMS Addressing
DESCRIO
Se habilitada, esta opo permite definir um tamanho
mximo personalizado para o PDU (Protocol Data Unit).
O PDU a parte do protocolo que no varia entre os
modos (ModbusTCP, ASCII e RTU) e que contm a rea
de dados. O nmero de bytes de dados suportados em
cada comunicao dado por este valor menos os
bytes de cabealho, que dependem da funo Modbus
utilizada. Se desabilitada, o tamanho mximo
considerado o valor padro definido pelo
protocolo Modbus verso 1.1b, de 253 bytes, sendo
esta a opo recomendada para a maioria dos
equipamentos.
Esta opo deve ser usada apenas em equipamentos
que suportem o protocolo TeleBUS. Se habilitada, o
Driver passa a aceitar um Word de 16 bits como
endereo do escravo, ou seja, passa a ser possvel
definir valores acima de 255 e abaixo de 65535 como
endereo do escravo. Neste caso, o endereo do
escravo passa a ser definido no protocolo por trs
bytes. Alm disto, a opo Default Slave Address
passa a no funcionar mais.
OPO
Data Address Model Offset
DESCRIO
Esta opo habilita ou desabilita o offset de dados
padro do protocolo, de uma unidade. As opes
disponveis so:
Data is addressed from 1 (padro): O endereo
fornecido no parmetro N4/B4 decrementado em 1
(um) antes de ser enviado ao equipamento.
Data is addressed from 0: O endereo fornecido pelo
usurio usado nas requisies do protocolo, sem
alteraes.
Como regra geral, selecione a primeira opo caso o
mapa de registradores do equipamento inicie em 1
(um), e a segunda caso inicie em 0 (zero). Verifique
tambm se o fabricante usa offsets adicionais da
antiga Modbus Convention. NOTA: No modelo de
dados padro do protocolo, so definidos quatro blocos
de dados (ou espaos de endereamento): Discrete
Inputs, Coils, Input Registers e Holding Registers. Em
cada um destes blocos, os elementos de dados so
endereados iniciando em 1 (um). Por outro lado, a
especificao do frame de comunicao define um
PDU contendo endereos que podem variar entre 0
(zero) e 65535. A relao entre o endereo fornecido no
PDU e o endereo dos elementos de dados, portanto,
possui um deslocamento (offset) de 1 (um), ou seja, se
no PDU de uma requisio constar o endereo 0 (zero),
o elemento de dado acessado o endereo 1 (um).
Com esta opo, o usurio pode escolher se deseja que
o Driver ajuste o valor automaticamente, de forma a
permitir o uso do endereo do elemento de dado nos
Tags (opo padro), ou se deseja que o valor enviado
no PDU seja o mesmo valor fornecido na configurao
dos Tags (parmetro N4/B4). Existem equipamentos
que seguem o padro Modbus em seus mapas de
endereos (iniciando em um), e outros que mapeiam
seus dados sem o offset padro, usando diretamente o
valor de endereo presente no frame de comunicao
(iniciando em zero). Alm deste offset unitrio, existem
ainda equipamentos que utilizam o antigo padro de
offsets utilizado pela Modicon, empresa que criou
inicialmente o protocolo, padro conhecido como
Modbus Convention, detalhado no tpico Dicas de
Endereamento deste Manual. Consulte no manual do
equipamento o mapa de registradores para verificar o
padro utilizado. Em caso de dvidas, consulte o
suporte do fabricante.
NOTA: A opo Data Address Model Offset era denominada Use Older Address nas verses anteriores
verso 2.03, onde Data is addressed from 1 equivale antiga opo Use Older Address habilitada, e Data
is addressed from 0 equivale opo Use Older Address desabilitada.
DICA: Evite usar o modo RTU do protocolo encapsulado em meio Ethernet TCP/IP. Caso seja necessrio
encapsular a comunicao serial de equipamentos que utilizem o Modbus RTU em TCP/IP, existem
gateways disponveis no mercado que no somente encapsulam a comunicao serial em Ethernet TCP/IP,
como tambm convertem o Modbus RTU em Modbus TCP. Em ltimo caso, se for inevitvel a utilizao de
Modbus RTU em meio Ethernet TCP/IP, no deixe de habilitar a opo Reconnect after Timeout, descrita
na tabela a seguir.
Outras opes disponveis na aba Modbus
OPO
Default Slave Address
Wait Silence on error
Reconnect after Timeout (Ethernet only)
DESCRIO
Este recurso permite configurar um endereo padro
de escravos, pra que no seja necessrio configurlos em cada Tag. Para utilizar este recurso, configure
o parmetro N1/B1 em 1000, ou seja, todos os Tags
com N1/B1 igual a 1000 tm este valor substitudo
pelo valor configurado na caixa de edio Default
Slave Address. Tambm possvel forar o uso do
endereo padro em todos os Tags, independente do
valor configurado em N1/B1, selecionando-se a
opo Use Default Address.
Se esta opo estiver habilitada, aps cada erro de
comunicao o Driver permanece em loop, recebendo
dados at ocorrer um timeout. Isto limpa o canal de
recepo, impedindo que ocorram problemas em
futuras comunicaes devido recepo de bytes
atrasados que ainda estejam trafegando no momento
do erro, e que possam ser confundidos com uma
resposta a um novo comando.
Com esta opo habilitada, aps qualquer erro de
timeout na recepo de frames do equipamento, o
Driver promove a desconexo e a reconexo da
camada fsica, limpando a conexo de possveis
frames atrasados que estejam em trfego e que
possam afetar futuras requisies. Esta opo deve
sempre ser habilitada caso seja inevitvel o uso de
Modbus RTU em meio Ethernet TCP/IP em sistemas
legados, uma vez que o modo RTU no possui
controle de transao, no sendo sempre possvel
distinguir um frame de resposta correto de um outro
atrasado, resultante de leitura anterior,
possivelmente de outro endereo, e que tenha
falhado por timeout. Para novos projetos,
recomenda-se fortemente que NO sejam utilizados
Modbus RTU ou Modbus ASC em meio Ethernet
TCP/IP. Note que preciso manter habilitada a
opo Retry failed connection every da aba Setup
do IOKit para que o Driver se reconecte aps o
timeout. Caso contrrio, o timeout apenas gera uma
desconexo e cabe aplicao o gerenciamento
desta nova conexo.
NOTA: A antiga opo Swap Address Delay foi removida da janela de configurao na verso 2.08. O
Driver ainda mantm suporte a esta opo em aplicaes pr-existentes, e permite habilit-la por scripts
(veja o tpico Configurao em Modo Offline). Para aplicaes novas, recomenda-se utilizar a opo
Inter-frame Delay da aba Serial do IOKit, que substitui esta antiga opo com vantagens.
Aba Gen SOE
O objetivo desta aba concentrar opes de configurao para o Algoritmo de Leitura de SOE Genrico da
Elipse. A figura a seguir mostra as opes desta aba.
Aba Gen SOE
Na verso atual existe apenas uma opo de configurao:

Enable control and data registers grouping (padro Verdadeiro): Habilita o agrupamento de
registros de controle e registros de dados, de forma a realizar o mnimo de leituras possvel. Se esta
opo estiver habilitada, o Driver inicia a leitura de tabelas j tentando ler o mximo de registros
permitidos pelo protocolo, tanto registros de controle como de dados, e se possvel j lendo a tabela
inteira em uma nica leitura. Tal procedimento em geral otimiza a varredura dos Tags da mesma forma
que os Superblocos, pois o tempo demandado para a leitura de blocos grandes em geral bem menor
do que o tempo necessrio para realizar vrias leituras da mesma quantidade de dados, embora isto
possa depender do CLP. Os CLPs ATOS no permitem a leitura agrupada dos registros de controle e de
estruturas de dados, exigindo que esta opo seja desabilitada.
Configurao em Modo Offline
As configuraes do Driver tambm podem ser acessadas em tempo de execuo se o Driver for iniciado no
modo Offline, conforme explicado no Manual do Usurio do IOKit, utilizando-se os parmetros de tipo
String mostrados na tabela a seguir.
Parmetros disponveis
PARMETRO
ModiconModbus.ModbusMode
TIPO
Inteiro:
0: Modbus RTU
1: Modbus ASCII
2: Modbus TCP
ModiconModbus.Olderaddr
Booleano (0 ou 1):
0: Dado endereado a partir de 0 (zero)
1: Dado endereado a partir de 1 (um)
ModiconModbus.UseDefaultSlaveAddress
Booleano (0 ou 1)
ModiconModbus.DefaultSlaveAddress
Inteiro sem sinal
ModiconModbus.UseSwapAddressDelay
Booleano (0 ou 1)
ModiconModbus.SwapAddressDelay
Inteiro, com o intervalo de delay em milissegundos.
NOTA: Opo obsoleta e mantida por compatibilidade.
Para aplicaes novas, use a opo Inter-frame delay
da aba Serial do IOKit
ModiconModbus.WaitSilenceOnError
Booleano (0 ou 1)
ModiconModbus.EnableCMSAddressing
Booleano (0 ou 1)
ModiconModbus.EnCustomizeMaxPDUSize
Booleano (0 ou 1)
ModiconModbus.MaxPDUSize
Inteiro
ModiconModbus.ConfigFile
String contendo o arquivo de configurao com as
operaes do Driver. Este arquivo pode ser exportado e
importado na aba Operations da janela de
configuraes do Driver
ModiconModbus.EnableReconnectAfterTimeout Booleano (0 ou 1):
0: O timeout no gera desconexo do meio fsico
1: Em caso de timeout, quando em meio fsico
Ethernet, o Driver promove a desconexo e
reconexo do meio fsico
ModiconModbus.UserTypesConfigFile
String de configurao dos tipos definidos pelo
usurio (estruturas). Trata-se do mesmo arquivo de
configurao que pode ser acessado na janela de
configurao do Driver (User-Defined Types)
ModiconModbus.EnableGenSOERegGrouping
Booleano (0 ou 1):
0: O algoritmo de leitura de eventos primeiro l os
registros de controle e, em seguida, os dados de
eventos
1: A leitura de SOE genrico agrupada ao mximo,
com a primeira leitura lendo no s os registradores
de controle, mas tambm o mximo de eventos
possveis
Para maiores informaes sobre a configurao Offline em tempo de execuo, consulte o Manual do
Usurio do IOKit.
Configurando Tags
Este tpico descreve a configurao dos diversos tipos de Tags suportados por este Driver. Os Tags so
divididos em duas categorias, descritas nos seguintes tpicos:
Configurando um Tag de Comunicao

Configurando Tags Especiais
Configurando um Tag de Comunicao
Os Tags de Comunicao do Driver so os Tags que fazem referncia a operaes previamente configuradas
na janela de configurao.
Os Tags de Comunicao permitem ler e escrever em registros Modbus nos equipamentos escravos, usando
as funes do protocolo Modbus, ou mesmo funes especiais. Este Driver no faz distino entre Tags
Bloco e Tags simples, no caso de Tags de Comunicao, ou seja, os Tags de Comunicao funcionam da
mesma forma que Tags Bloco com apenas um Elemento.
Os dados so lidos do equipamento utilizando os formatos suportados pelo protocolo, ou seja, registros de
valores inteiros de 16 bits ou conjuntos de bits, dependendo da funo do protocolo utilizada. Para maiores
informaes sobre as funes do protocolo, consulte a especificao no site oficial do protocolo.
Operaes
Conforme j explicado no tpico Aba Operations, o Driver possui suporte a outros tipos de dados alm dos
tipos nativos do protocolo. Por este motivo, foi criado o conceito de Operao no Driver.
Nas operaes utilizando as funes Modbus que lem e escrevem bits, como as funes 1, 5 e 15 do
protocolo, o Driver mapeia sempre os valores binrios de cada bit para os Elementos de Bloco, onde cada
Elemento representa o valor de um bit especfico.
As operaes com tipos de dados de oito bits, como o tipo Byte, implicam sempre, obviamente, na leitura de
pelo menos dois bytes (um registro Modbus de 16 bits). Para prevenir surpresas para o usurio, o Driver exige
que a escrita de dados de oito bits seja realizada sempre aos pares, ou seja, como escritas de Blocos com
nmero par de Elementos. As operaes devem ser referenciadas atravs dos parmetros N2/B2 dos Tags de
Comunicao, conforme descrito a seguir.
Parmetros de Configurao dos Tags de Comunicao
A configurao a seguir se aplica tanto aos parmetros N dos Tags de Comunicao quanto aos parmetros B
dos Tags Bloco de Comunicao.
N1/B1: Endereo do equipamento escravo (CLP) na rede (Slave Id). Este endereo usado em redes
seriais e pode variar de 1 a 247. Pode-se ainda configurar este parmetro com o valor 0 (zero). Com
isto, este Tag trabalha em modo Broadcast, enviando a mensagem para todos os equipamentos
escravos (CLP) que estiverem na rede. Em Ethernet (modo Modbus TCP), o endereo geralmente
utilizado apenas o endereo IP, porm o Slave Id pode ainda ser usado quando o endereo IP
referencia um gateway ligado a uma rede de equipamentos (geralmente rede RS485, com Modbus RTU,
usando gateway capaz de realizar a converso de Modbus TCP para Modbus RTU).
NOTA: No modo Broadcast com N1 igual a 0 (zero) no possvel realizar leituras, apenas escritas. Neste
modo todos os equipamentos na rede so endereados, recebendo o valor escrito e no retornando
qualquer resposta, de forma a evitar conflitos na rede.
N2/B2: Cdigo da operao. Referencia uma operao adicionada na janela de configuraes do Driver
(veja o tpico Aba Operations).
N3/B3: Parmetro adicional. Este parmetro em geral no usado e pode ser deixado em 0 (zero). S
usado em quatro situaes:
Funes Modbus 20 e 21: No caso de operaes que utilizem estas funes de acesso a arquivo
(funes 20 e 21), o parmetro N3/B3 especifica o arquivo a ser acessado.
Use Bit Mask: Para Tags referenciando operaes com a opo Use Bit Mask habilitada, o
parmetro N3/B3 especifica o nmero do bit a ser acessado (veja o tpico Aba Operations).
Tipos Definidos pelo Usurio: Para operaes que usem estruturas, se o parmetro B3 for maior
que 0 (zero), define o retorno de um array de blocos reportado a eventos, por meio de uma
sequncia de eventos OnRead do Tag (veja o tpico Tipos Definidos pelo Usurio).
Funo Especial Gen SOE: Em operaes que utilizem a funo especial de leitura Gen SOE, o
parmetro N3/B3 indica o tamanho da tabela associada na memria do CLP ou dispositivo escravo,
em nmero mximo de eventos comportados (veja o tpico Algoritmo de Leitura de SOE Genrico
da Elipse).
N4/B4: Endereo do registrador, varivel ou bit no equipamento ou dispositivo escravo (CLP) em que se
deseja ler ou escrever, conforme o mapa de registradores do equipamento (verifique o manual do
equipamento). importante ajustar corretamente a opo Data Address Model Offset (veja o tpico
Aba Modbus) e verificar se a documentao do fabricante no usa offsets utilizados por equipamentos
Modbus antigos, da chamada Modbus Convention.
Tamanho/ndice (somente Tags Bloco): Cada Elemento de Bloco representa o valor de um dado de
tipo definido na operao utilizada (parmetro N2/B2). Note que o protocolo s suporta tipos Bit ou
Word. Desta forma, se a operao selecionar o tipo DWord (32 bits) para cada Elemento de Bloco, o
Driver necessita ler dois registros consecutivos do equipamento.
Tags Especiais
Alm dos Tags de Comunicao (Tags que referenciam operaes), existem tambm Tags especiais para
executar funes especficas do Driver. Estes Tags so descritos no tpico Configurando Tags Especiais.
Dicas de Endereamento (Modbus Convention)
No tpico Configurando um Tag de Comunicao, o endereamento dos Tags (parmetro N4/B4) descrito
com base na especificao mais recente do protocolo Modbus (verso 1.1b). Entretanto, h equipamentos
que ainda utilizam a antiga conveno de endereamentos com offsets conhecida como Modbus
Convention, que acrescenta offsets ao endereo. Este tpico explica como enderear os Tags caso o mapa
de registradores do equipamento ainda siga esta conveno antiga, originria da especificao inicial da
Modicon, no mais includa na especificao atual.
Conforme explicado no tpico Configurando um Tag de Comunicao, o endereo do registro ou bit a ser
acessado deve ser fornecido no parmetro N4/B4 dos Tags de Comunicao. Este endereo enviado no
frame de requisio do protocolo ao equipamento, acrescido ou no do offset padro de 1 (um), requerido
pelo Modbus Data Model especificado pelo protocolo, conforme configurao do campo Data Model Offset,
na aba Modbus da janela de configuraes do Driver.
Alm deste offset padro de 1 (um), definido na norma Modbus atual (verso 1.1b), alguns fabricantes
utilizam ainda o padro antigo da Modicon, conhecido como Modbus Convention, com um offset que pode
ser acrescentado ao endereo, cujo valor depende da funo Modbus utilizada, ou mais especificamente, de
qual espao de endereamento (address space) esta funo acessava originalmente. Tal offset adicional deve
ser ignorado ao definir o endereo dos Tags neste Driver (parmetros N4/B4). Mais adiante so fornecidos
alguns exemplos. A tabela a seguir lista os offsets utilizados pelo padro Modbus Convention.
Offsets do padro Modbus Convention
TIPO DE DADO (STANDARD DATA
FUNES MODBUS
MODEL)
Coils
01: Read Coils (0x)
05: Write Single Coil (0x)
15: Write Multiple Coils (0x)
Discrete Inputs
02: Read Discrete Inputs (1x)
Input Registers
04: Read Input Registers (3x)
Holding Registers
03: Read Holding Registers (4x)
06: Write Single Register (4x)
16: Write Multiple Registers (4x)
File Register (antiga Extended
20: Read General Reference (6x)
Memory file)
21: Write General Reference (6x)
OFFSET (MODBUS CONVENTION)

000000
10000
30000
40000
60000
Se o mapa de registradores do equipamento utiliza esta conveno, deve-se seguir este procedimento para
determinar os endereos a serem atribudos aos parmetros N4 ou B4 dos Tags:
1. Na aba Modbus, selecione a opo Data is addressed from 1.
2. Subtraia do endereo mostrado no manual do equipamento o offset mostrado na tabela anterior para a
funo Modbus utilizada. DICA: Remova o quinto dgito da direita para a esquerda.
Note que, em equipamentos que utilizam esta antiga conveno, pode-se determinar quais funes Modbus
devem ser usadas para acessar cada registro ou bit atravs do offset empregado em seu endereo.
Exemplos
ENDEREO COM OFFSET
(MANUAL DO EQUIPAMENTO)
01234
N4/B4 DO TAG DE COMUNICAO
11234
31234
41234
1234
1234
1234
45789
5789
65789
5789
1234
FUNES MODBUS
01: Read Coils
05: Write Single Coil
15: Write Multiple Coils
02: Read Discrete Inputs
04: Read Input Registers
03: Read Holding Registers
06: Write Single Register
16: Write Multiple Registers
03: Read Holding Registers
06: Write Single Register
16: Write Multiple Registers
20: Read General Reference
21: Write General Reference
Partio Automtica de Blocos
A partir da verso 2.00, o Driver Modbus passa a contar com o recurso de Partio Automtica de Blocos.
Com este recurso, o Driver passa a gerenciar sozinho a diviso de blocos maiores que os limites do
protocolo. Assim, o usurio no precisa se preocupar em exceder o limite mximo de tamanho de blocos,
pois o prprio Driver se encarrega de dividir os blocos nos tamanhos corretos no momento da comunicao
com o equipamento, caso algum Tag Bloco exceda o tamanho mximo permitido.
A partir da verso 2.01, o Driver passou tambm a suportar Leitura por Superblocos. Com este recurso
habilitado, o usurio no precisa mais agrupar variveis em Tags Bloco objetivando melhoria de
desempenho, sendo possvel usar apenas Tags sem quaisquer prejuzos de performance. E como o algoritmo
de Superblocos j leva em considerao o tamanho mximo de blocos permitido pelo protocolo, quando este
recurso for utilizado o Driver tambm no necessita usar o recurso de Partio Automtica.
Nos casos em que, devido peculiaridades do equipamento (veja o tpico Leitura por Superblocos), no
seja possvel habilitar a propriedade EnableReadGrouping no E3 ou Elipse Power (propriedade que habilita
os Superblocos), ou caso se esteja utilizando o antigo Elipse SCADA, que no possui o recurso de
agrupamento (Superblocos), preciso contar com a Partio Automtica de Blocos para que no seja
necessrio observar os limites do protocolo.
IMPORTANTE: Tanto o agrupamento dos Superblocos no E3 e no Elipse Power como a Partio Automtica
de Blocos do Driver requerem que o equipamento suporte os limites estabelecidos pelo Modbus padro
(veja o tpico Limite Mximo para o Tamanho dos Blocos Suportado pelo Protocolo). H equipamentos,
entretanto, que suportam limites inferiores. Para que a diviso automtica de blocos e o prprio
agrupamento dos Superblocos funcione nestes casos, a partir da verso 2.03 o Driver permite customizar o
limite mximo suportado para o PDU (Protocol Data Unit). Para isto, na janela de configuraes do Driver,
aba Modbus, habilite a opo Customize Max. PDU Size e configure o tamanho mximo de bytes suportado
para o PDU pelo equipamento. Caso o equipamento possua limites diferentes para cada funo, pode ser
necessrio realizar o agrupamento manualmente (veja o tpico Leitura por Superblocos).
O artigo KB-23112 do Elipse Knowledgebase apresenta um resumo das questes relativas ao agrupamento de
Tags e dimensionamento de blocos no Driver Modbus, discutidas neste e em outros tpicos (veja os tpicos
Leitura por Superblocos e Dicas de Otimizao).
Leitura por Superblocos (Agrupamento)
A partir da verso 2.01, o Driver passa a suportar o recurso de Leitura por Superblocos. Este recurso
suportado pelo E3 e pelo Elipse Power, podendo ser habilitado atravs da propriedade EnableReadGrouping
do objeto Driver no Organizer. Com esta propriedade em Verdadeiro, o usurio no precisa se preocupar com
o dimensionamento dos blocos.
Com este recurso, torna-se possvel (e em geral recomendvel) criar aplicaes contendo apenas Tags
simples (Tags PLC no Elipse SCADA) sem prejuzo de desempenho, pois a otimizao do agrupamento na
leitura feita automaticamente no momento da comunicao. A figura a seguir mostra a configurao da
propriedade EnableReadGrouping no E3 ou Elipse Power.
Propriedade EnableReadGrouping
O Elipse SCADA no possui suporte a Superblocos. O comportamento da leitura de Tags no Elipse SCADA
idntico ao do E3 e do Elipse Power quando a opo EnableReadGrouping estiver configurada como Falso.
Em ambos os casos, o Driver conta com a Partio Automtica de Blocos, podendo dividir blocos com
tamanhos superiores ao limite do protocolo em blocos menores no momento da comunicao. Nestes
casos, o usurio precisa levar em considerao o agrupamento ao definir os Tags da aplicao, como visto
mais adiante neste tpico.
NOTA: O agrupamento automtico realizado com base nos Tags em advise da aplicao. Sempre que
novos Tags entrarem em advise ou sarem de advise, o algoritmo de Superblocos redefine o agrupamento,
ou seja, os Superblocos a serem lidos de forma automtica, em tempo de execuo, incluindo apenas os
Tags que estiverem em advise.
IMPORTANTE: Tanto o agrupamento dos Superblocos no E3 como a Partio Automtica de Blocos do
Driver requerem que o equipamento suporte os limites estabelecidos pelo Modbus padro (veja o tpico
Limite Mximo para o Tamanho dos Blocos Suportado pelo Protocolo). H equipamentos, entretanto,
que suportam limites inferiores. Para que a diviso automtica de blocos e o prprio agrupamento dos
Superblocos funcione nestes casos, a partir da verso 2.03, o Driver permite customizar o limite mximo
suportado para o PDU (Protocol Data Unit). Para isto, na janela de configuraes do Driver, aba Modbus,
habilite a opo Customize Max. PDU Size e configure o tamanho mximo de bytes suportado para o PDU
pelo equipamento. Caso o equipamento suporte limites diferentes para cada tipo de funo, necessrio
realizar o agrupamento manual (veja mais adiante neste tpico), observando os limites descritos na
documentao do fabricante.
Identificao de equipamentos que no suportam agrupamento automtico (Superblocos)
O algoritmo de Superblocos leva em conta os limites e espaos de endereamento definidos pelo protocolo
Modbus padro. Nos casos de equipamentos que implementem o protocolo Modbus com pequenas variaes,
podem ser necessrias configuraes avanadas adicionais para que seja possvel utilizar o recurso de
Superblocos, caso seu uso se mostre vivel. Nestes casos, necessrio desabilitar o agrupamento
automtico (propriedade EnableReadGrouping configurada para Falso), realizando o agrupamento de forma
manual. As seguintes condies podem tornar impossvel a utilizao de Superblocos, ou requerer
configuraes avanadas adicionais:
Equipamentos que definem limites mximos de tamanho de bloco inferiores ao limite padro do
protocolo (limite de 253 bytes para o PDU). Soluo: Ajuste a opo Customize Max. PDU Size, na
aba Modbus.
NOTA: H equipamentos cujos limites de PDU variam conforme a funo Modbus utilizada. Nesses casos,
se for necessrio usar funes com limites diferentes, tambm preciso desabilitar os Superblocos
(propriedade EnableReadGrouping configurada para Falso), agrupando os Tags manualmente (veja mais
adiante neste tpico).
Equipamentos com descontinuidades (intervalos de endereos no definidos intercalados com
intervalos vlidos) no mapa de registradores. Soluo: Uma vez que impossvel informar ao algoritmo
de Superblocos quais intervalos no podem ser inseridos em blocos, em geral no possvel usar
Superblocos. Desabilite os Superblocos (propriedade EnableReadGrouping configurada para Falso) e
agrupe os Tags manualmente.
Equipamentos que no suportam a leitura em blocos. Soluo: Desabilite os Superblocos (propriedade
EnableReadGrouping configurada para Falso) e defina Tags simples.
Equipamentos que s permitem a definio de blocos em endereos pr-determinados e com tamanhos
fixos. Soluo: Desabilite os Superblocos (propriedade EnableReadGrouping configurada para Falso) e
defina Tags simples (Tags PLC no Elipse SCADA) ou Blocos de acordo com o especificado para o
equipamento.
Agrupamento manual
Em geral, quanto maior for o agrupamento das variveis em blocos, menor o nmero de requisies de
leitura necessrias para completar o ciclo de varredura (scan) dos Tags da aplicao, aumentando assim a
velocidade de atualizao dos Tags. Por este motivo, se no for possvel usar o agrupamento automtico
(Superblocos), prefervel criar Tags Bloco contendo o maior nmero possvel de variveis ao invs de criar
Tags simples (Tags PLC no Elipse SCADA).
Note que, devido ao recurso de Partio Automtica de Blocos, no necessrio cuidar para que os limites
mximos do protocolo sejam excedidos, desde que o equipamento suporte os limites mximos padro do
protocolo. Se o equipamento no suportar estes limites, mas definir limites fixos, vlidos para todas as
funes Modbus suportadas, deve-se configurar a opo Customize Max. PDU Size, na aba Modbus.
Caso o equipamento suporte limites diferentes para cada funo suportada, pode ser invivel contar tambm
com o particionamento automtico. Nestes casos, o desenvolvedor da aplicao precisa levar em conta os
limites do equipamento, e definir seus blocos tomando cuidado para respeitar estes limites.
Para o agrupamento manual, o uso de Tipos Definidos pelo Usurio pode ampliar as possibilidades de
agrupamento, por permitir reunir em um mesmo Tag Bloco variveis do mesmo espao de endereamento, ou
seja, uma mesma funo Modbus, porm com tipos de dados diferentes (a estrutura definida pode ter
elementos com tipos diversos).
Para mais dicas, consulte o tpico Dicas de Otimizao. O artigo KB-23112 do Elipse Knowledgebase
apresenta um resumo das questes relativas ao agrupamento de Tags e dimensionamento de blocos no
Driver Modbus, discutidas neste e em outros tpicos.
Configurando Tags Especiais
Alm dos Tags de Comunicao, este Driver suporta tambm alguns Tags Especiais que permitem
aplicao acionar recursos que no esto relacionados leitura e escrita de dados. Ao contrrio dos Tags de
Comunicao, os Tags Especiais no referenciam operaes do Driver. Os tpicos a seguir detalham os

Tags Especiais suportados, descritos na tabela a seguir.
Tags Especiais
N2/B2
9001
9999
DESCRIO
Fora a execuo de um Wait Silence (veja o tpico
Forar Wait Silence).
Leitura da ltima exceo (veja o tpico Leitura do
Cdigo da ltima Exceo).
Forar Wait Silence
Tag Especial utilizado para descartar todos os dados pendentes da comunicao at encontrar um timeout,
indicando que no h mais dados a serem recebidos.
Este mesmo servio pode ser configurado na aba Modbus, para ocorrer sempre que algum erro de
comunicao for detectado. Com este Tag, entretanto, possvel executar o servio a qualquer momento
pela aplicao.
Este Tag Especial executado atravs de um comando de escrita de Tag, com parmetro N2 igual a "9001".
O valor em si, escrito no Tag, ignorado.
N1: No usado (pode ser deixado em zero)
N2: 9001
Valor: No usado (pode ser deixado em zero)
Leitura do Cdigo da ltima Exceo
Conforme j mencionado neste Manual, os Tags Especiais para leitura do cdigo da ltima exceo so
utilizados para ler o ltimo cdigo de exceo enviado por um determinado equipamento escravo.
Tais cdigos so armazenados automaticamente pelo Driver em registradores internos, que podem ser
acessados por meio deste Tag. Alm disto, a cada comunicao bem sucedida com determinado
equipamento onde nenhuma exceo for retornada, o Driver zera automaticamente o registrador associado.
Cdigos de Exceo
Os cdigos de exceo so usados pelo dispositivo escravo (CLP) para informar uma falha ao executar uma
determinada funo. Os dispositivos ou equipamentos escravos no retornam excees no caso de falhas de
comunicao, situao em que estes simplesmente no respondem. Os cdigos de exceo so retornados
pelos escravos em situaes em que a solicitao do mestre (no caso do Driver) foi recebida com sucesso,
porm no pde ser executada por algum motivo, como por exemplo a tentativa de ler ou escrever em um
registrador inexistente. Neste caso, o cdigo de exceo retornado indica o tipo de erro ocorrido, ou seja, o
motivo pelo qual a requisio do Driver, embora recebida corretamente, no pde ser executada.
A especificao do protocolo Modbus define nove cdigos de exceo. A lista de excees padro do
protocolo pode ser consultada no tpico Lista de Excees Padro do Protocolo. Alm destes cdigos,
alguns fabricantes definem cdigos adicionais, especficos de seus equipamentos. Tais cdigos devem estar
documentados no manual do equipamento. Caso no estejam, deve-se consultar o suporte do fabricante.

Configurao
A configurao dos Tags Especiais para Leitura de Cdigos de Exceo deve ser executada da seguinte
forma:
B1: Endereo do dispositivo escravo (Slave Id)
B2: 9999
B3: No usado (pode ser deixado em zero)
B4: No usado (pode ser deixado em zero)
Valores dos Elementos de Bloco retornados:
Elemento 1 (ndice 0): Cdigo da exceo retornada pelo equipamento (veja o tpico Lista de Excees
Padro do Protocolo)
Elemento 2 (ndice 1): Parmetro N2/B2 do Tag de Comunicao que teria gerado a exceo
Elemento 5 (ndice 4): Parmetro Size do Tag de Comunicao que teria gerado a exceo
Utilizao do Tag Especial
A utilizao mais comum deste Tag durante o scan normal dos Tags de funes atravs de um evento
OnRead do Tag de exceo. Neste caso, o script deve antes de tudo rejeitar valores nulos, pois estes indicam
o no recebimento de excees. Em seguida, pode-se tratar a exceo executando os procedimentos
adequados, conforme o cdigo recebido. uma boa prtica zerar o registrador de exceo ao sair do script,
de forma a indicar que a exceo j foi tratada. Veja o exemplo a seguir, escrito em Elipse Basic (Elipse
SCADA):
// Evento OnRead do Tag TagExc
// Obs.: Para este exemplo, considere TagExc
// com leitura e escrita automtica habilitadas
If TagExc == 0
Return
EndIf
If TagExc == 1
... // Trata a exceo 1
ElseIf TagExc == 2
... // Trata a exceo 2
Else
... // Trata as demais excees
EndIf
TagExc = 0 // Zera o registrador de excees
A seguir outro exemplo, escrito em VBScript (Elipse E3 e Elipse Power):

' Evento OnRead do Tag TagExc
' Obs.: Para este exemplo, considere TagExc
' com leitura e escrita automtica habilitadas
Sub TagExc_OnRead()
If Value = 0 Then
Exit Sub
End If
If Value = 1 Then
... ' Trata a exceo 1
ElseIf Value = 2 Then
... ' Trata a exceo 2
Else
... ' Trata as demais excees
End If
Value = 0 ' Zera o registrador de excees
End Sub
J nas operaes de escrita por script, em que seja preciso testar o retorno de excees logo aps o envio do
comando, deve-se primeiramente zerar o registrador de excees. Isto evita que uma eventual exceo
provocada pelo comando de escrita seja confundida com outra pr-existente. Executa-se ento a operao de
escrita e testa-se o valor do Tag Especial, que deve retornar 0 (zero) caso nenhuma exceo tenha sido
recebida. Caso retorne um valor diferente de 0 (zero), pode-se ento tratar apropriadamente a exceo
recebida. Veja o exemplo a seguir, escrito em Elipse Basic (Elipse SCADA):
// Obs: Para este exemplo, considere TagExc
// com leitura e escrita automtica habilitadas
// e TagVal com escrita automtica desabilitada.
TagExc = 0 // Zera o registrador de excees
TagVal.WriteEx(10) // Escreve o valor 10
If TagExc <> 0
... // Trata a exceo
EndIf
A seguir outro exemplo, escrito em VBScript (Elipse E3 e Elipse Power):
' Obs: Para este exemplo, considere TagExc

' com leitura e escrita automtica habilitadas
' e TagVal com escrita automtica desabilitada.
' Zera o registrador de excees
Application.GetObject("Tags.TagExc").Value = 0
' Escreve o valor 10
Application.GetObject("Tags.TagVal").WriteEx(10)
If Application.GetObject("Tags.TagExc").Value <> 0 Then
... ' Trata a exceo
End If
NOTA: O Tag Especial B2 = 9999 retorna, alm do cdigo da exceo (retornado no Elemento zero), tambm
os parmetros do Tag cuja comunicao teria provocado a exceo. Caso estas informaes no sejam
necessrias, pode-se perfeitamente ler o mesmo registro atravs de um Tag com N2 = 9999. Neste caso, os
procedimentos recomendados permanecem os mesmos.
Leitura de Memria de Massa

Este Driver permite definir, nas operaes, funes especiais de leitura para a coleta de memria de massa
de dispositivos escravos. Tais funes no existem no protocolo, e implicam no uso de algoritmos especficos
de leitura de eventos dos equipamentos, que podem eventualmente ler ou escrever em diversos registros,
utilizando-se de uma ou mais funes do protocolo.
Leitura por Callbacks
A partir da verso 2.08, este Driver passou a implementar a leitura por callbacks, recurso disponvel no E3 (a
partir da verso 3.0) e no Elipse Power, que otimiza o desempenho de leituras de memria de massa. Com
este recurso disponvel, a aplicao delega ao Driver a varredura dos Tags de leitura de eventos de memria
de massa. Em outras palavras, a aplicao no precisa mais estar constantemente interrogando o Driver a
cada perodo de varredura. Ao invs disto, o Driver realiza a verificao de novos eventos no equipamento e
coleta eventos sempre que estiverem disponveis, tomando a iniciativa de envi-los aplicao.
Funes Especiais para Leitura de Memria de Massa
Na atual verso do Driver, as seguintes funes de leitura de sequncias de eventos (SOE) so suportadas:
GE SOE: Realiza a coleta de eventos de CLP GE PAC RX7. Para mais informaes, consulte o tpico
Leitura de Buffer de Eventos em Controladores GE PAC RX7.
SP SOE: Coleta eventos de rels Schneider Electric SEPAM sries 20, 40 e 80. Para mais informaes,
consulte o tpico Leitura de Eventos de Rels Schneider Electric SEPAM 20, 40 e 80.
GenSOE: Esta funo usa o Algoritmo genrico criado pela Elipse, o Elipse Modbus SOE, que pode ser
usado pela maioria dos Controladores Programveis. Exige a criao de procedimento anlogo na
programao do CLP (ladder). Para mais informaes, consulte o tpico Algoritmo de Leitura de SOE
Genrico da Elipse.
65 03: Funo especial para a leitura de eventos de memria de massa de medidores ABB MGE 144.
Para mais informaes, consulte o tpico Leitura de Registros da Memria de Massa de Medidores
ABB MGE 144.
Leitura de Buffer de Eventos em Controladores GE PAC RX7

Para a leitura do buffer de eventos (SOE) de controladores GE PAC RX7 deve ser definida, na janela de
configurao do Driver, uma operao que use como funo de leitura a funo especial GE SOE. O tipo de
dado deve ser definido como GE_events.
O buffer de eventos pode ser lido atravs de trs tipos de Tags: Tags reportados por eventos, Tags
reportados por eventos por ponto e Tags de tempo real.
Tags reportados por eventos
Os Tags reportados por eventos retornam, a cada operao de leitura, todos os eventos acumulados no
buffer interno do Driver. Os seguintes parmetros devem ser utilizados:
B1: Slave ID
B2: Cdigo da Operao definida com a funo GE SOE
B3: 0 (zero)
B4: Endereo base da pilha de eventos no CLP
A cada scan neste Tag, o Driver verifica se existem eventos no buffer do controlador. Se houver eventos, o
Driver inicia uma thread de leitura de eventos, que executada em segundo plano, no bloqueando a
varredura dos demais Tags. Aps o trmino da leitura do buffer pelo Driver, este Tag reportado por eventos
retorna o conjunto de eventos lidos na varredura.
Os eventos retornados geram uma sucesso de eventos OnRead neste Tag. Para cada evento lido, o E3
atualiza os campos do Tag (valores de Elementos e timestamp) com os valores de um determinado evento, e
chama uma vez o evento OnRead. O script do evento chamado deve ser definido pelo usurio, sendo
geralmente usado para inserir os dados do Tag no Histrico.
Cada evento representado por um Bloco de dois Elementos, com o campo timestamp lido do equipamento.
Os campos do respectivo Tag Bloco de leitura so mostrados na tabela a seguir.
Campos do Tag Bloco
OFFSET
0
1
SIGNIFICADO
Identificao do ponto
Status do ponto
TIPO DE DADO
Byte
Byte
FAIXA DE VALORES
Entre 0 e 15
Entre 0 e 1
Para mais informaes sobre Tags reportados por evento, consulte o tpico especfico no Manual do Usurio
do E3.
banda morta do Tag (propriedade EnableDeadBand configurada para Falso) e tambm do objeto Histrico
Tags reportados por eventos por ponto
A partir da verso 2.5 do Driver possvel utilizar um novo Tag para o download de eventos de um ponto
especfico.
Este Tag funciona de forma idntica ao anterior, exceto pelo fato de retornar apenas os eventos de um ponto
especfico.
Ao contrrio do anterior, o valor retornado possui apenas um Elemento com o valor do status do ponto, de
forma que pode-se utilizar apenas um Tag. Este Tag deve ser configurado da seguinte forma:
N1: Slave ID
N2: Cdigo da Operao definida com a funo GE SOE
N3: 200 + ndice do Ponto (por exemplo, para o ponto 2, configure N3 como 202)
N4: Endereo base da pilha de eventos no CLP
Para mais informaes sobre Tags reportados por evento, consulte o tpico especfico no Manual do Usurio
do E3.
Tags de tempo real
Estes Tags retornam o evento mais recente j lido para um ponto especfico. Estes eventos so armazenados
na memria interna do Driver a cada leitura de eventos do CLP, com seus respectivos timestamps lidos do
equipamento. Este Tag utiliza os seguintes parmetros:
N1: Slave ID
N2: Cdigo da Operao
N3: 100 + ndice do ponto
N4: Endereo base da pilha de eventos no CLP
Valor: Status do ponto
Leitura de Eventos de Rels Schneider Electric SEPAM 20, 40 e 80
Para a leitura do buffer de eventos (SOE) de controladores Schneider Electric SEPAM sries 20, 40 e 80 deve
ser definida, na aba Operations, uma operao que use como funo de leitura a funo especial SP SOE. O
tipo de dado definido automaticamente como SP_events, assim que a funo de leitura SP SOE for
selecionada.
Para a leitura de rels SEPAM, o modelo de offset de endereamento deve ser configurado como Data is
addressed from 0, na aba Modbus. A leitura de eventos realizada com a utilizao de dois tipos bsicos de
Tags:
Tag de coleta de todos os eventos da tabela (obrigatrio): Realiza a coleta de todos os eventos da
tabela de uma determinada zona na memria do equipamento. Este Tag, alm de retornar todos os
eventos lidos aplicao reportados a evento, ainda acumula os eventos lidos no buffer interno do
Driver, para serem retirados atravs de leituras nos Tags de leitura de evento nico, descritos a seguir.
Tag de leitura de evento nico (opcional): Retorna eventos recebidos do rel especificado, com
determinado endereo, tipo e zona. Este Tag no realiza a leitura direto do equipamento, mas sim
retorna os eventos do buffer interno do Driver, alimentado durante a leitura do Tag de coleta de todos
os eventos, descrito anteriormente, ou seja, para que seja possvel ler eventos com este tipo de Tag,
um Tag do tipo Coleta de todos os eventos deve j estar previamente ativo, com sua varredura (scan)
habilitada. Este Tag til quando o usurio precisa obter eventos de um tipo e de uma fonte
especficas (rel, zona, endereo e tipo). Um exemplo de utilizao seria a associao a objetos de
Tela, mostrando o status de determinado endereo de evento. Embora este Tag retorne as mesmas
informaes j retornadas pelo Tag anterior, seu uso poupa o usurio de ter que implementar filtros,
clusulas Select Case em VBScript ou algum outro mtodo para separar os diversos tipos de eventos
retornados pelo Tag de coleta de todos os eventos por script na aplicao.
A aplicao deve necessariamente implementar um Tag de coleta de todos os eventos para cada tabela ou
zona de eventos a ser coletada em cada rel, pois durante a leitura deste Tag que os eventos de fato so
coletados do equipamento. A seguir descrita a configurao destes dois Tags.
Tag de coleta de todos os eventos da tabela (zona de eventos)
Este Tag reportado a eventos. Sua aplicao tpica a insero de eventos em um objeto Histrico
associado, atravs do mtodo WriteRecord do Histrico, chamado no evento OnRead do Tag. A cada leitura,
ou seja, a cada perodo de varredura do Tag, o Driver pode coletar at quatro novos eventos do equipamento.
Este o nmero mximo de eventos que cada zona de eventos do rel dispe a cada requisio de leitura.
Como durante a leitura deste Tag que os eventos so de fato coletados do equipamento, mesmo que seus
dados no sejam utilizados diretamente, ou seja, mesmo que no seja preciso armazenar todos os eventos
coletados em Histrico, sua implementao obrigatria para que os Tags de evento nico possam retornar
dados. O Tag de coleta de todos os eventos deve ser configurado como um Tag Bloco com trs Elementos, e
com os seguintes parmetros:
B1: 1000 + Endereo do escravo (rel) na rede (entre 1 e 247)
B2: Cdigo da Operao configurada com a funo de leitura especial SP SOE
B3: 0 (zero)
B4: Zona ou Tabela de Eventos (1 ou 2)
A tabela a seguir descreve o significado dos trs Elementos de Bloco, que tem seus valores retornados como
reportados a eventos.
Significados dos Elementos de Bloco
OFFSET
0
SIGNIFICADO
Tipo de evento
TIPO DE DADO
Word
Endereo do evento
Word
Borda de subida ou de
descida
Word
FAIXA DE VALORES
De 0 a 65535 (800H para
Remote Annunciation,
Internal Data e Logic Input)
Referencia endereos de bits
de 1000H a 105FH
00: Borda de descida
01: Borda de subida
Para mais informaes sobre Tags reportados a eventos, veja o tpico Tags Reportados a Eventos do
Manual do Usurio do E3.
banda morta do Tag (propriedade EnableDeadBand configurada para Falso) e tambm no objeto Histrico
Tag de leitura de evento nico
Este Tag tambm reportado a eventos, sendo possvel tambm usar seu evento OnRead para
armazenamento em Histrico. Note que nada impede, entretanto, que ele seja tratado como um Tag normal
(Tag de tempo real), caso s interesse o seu valor mais recente. Como este Driver apenas l um buffer
interno, sugere-se definir um tempo de varredura bem baixo, at menor que o do outro tipo de Tag. O
consumo de CPU de cada varredura pode ser considerado desprezvel. Sugere-se a metade do perodo de
varredura do Tag de coleta de todos os eventos.
Como j comentado, este Tag utilizado para obter o status de determinado endereo de evento, sem
precisar separar ou realizar filtros nos eventos que chegam pelo Tag anterior, por script ou outro meio. Uma
aplicao tpica seria a associao a objetos de Tela.
O Tag de leitura de evento nico, como j mencionado, no faz a leitura de eventos do equipamento, mas sim
de um buffer interno do Driver, previamente preenchido durante a leitura do Tag de coleta de todos os
eventos. O Tag retorna apenas um Elemento, reportado a eventos, podendo ser configurado como Tag
simples (no precisa ser um Tag Bloco). O Driver aceita no mximo oito eventos acumulados por ponto de
evento, ou seja, para cada combinao de rel, zona, tipo e endereo do evento, em seu buffer interno. Se
ocorrer overflow, ou seja, se mais de oito eventos de um mesmo ponto forem retornados sem que nenhum
Tag de evento nico os colete, o Driver passa a descartar os eventos mais antigos. A configurao adequada
do tempo de varredura pode evitar a perda de eventos.
DICA: Recomenda-se configurar a varredura (scan) dos Tags de evento nico com um valor equivalente
metade do configurado para o Tag de coleta de todos os eventos associados, evitando-se assim a perda de
eventos por overflow do buffer interno do Driver.
Deve ser configurado com os seguintes parmetros:
N1: Endereo do escravo (rel) na rede (entre 1 e 247)
N2: Cdigo da Operao configurada com a funo especial SP SOE
N3: Tipo do evento (800H por padro, segundo documentao do fabricante)
N4: Endereo do evento (Event Bit Address) + Events Zone Offset*, conforme descrito na tabela a
seguir
Opes para o endereo do evento
ZONA DE EVENTOS
1
2
EVENTS ZONE OFFSET*

0
8000H (8000 em hexadecimal)
Exemplos:
Endereo do Evento: 102FH, Zona de Evento = 1 N4 = 102FH + 0 = 102FH

Endereo do Evento: 102FH, Zona de Evento = 2 N4 = 102FH + 8000H = 902FH
NOTA: Para representar valores em hexadecimal no Elipse E3 e no Elipse Power, deve-se usar o prefixo
'&H' (por exemplo, &H10 = 16). No Elipse SCADA, use o sufixo 'h' (por exemplo, 10h = 16). Neste Manual,
entretanto, usado o sufixo 'H' maisculo para denotar valores no formato hexadecimal.
Valor: Retorna a borda de subida ou descida, conforme a tabela a seguir
Opes disponveis para Valor
VALOR
00
01
SIGNIFICADO
Borda de descida
Borda de subida
Timestamp: A propriedade Timestamp representa a data e hora em que o evento foi de fato lido do
rel, durante a leitura do Tag de leitura de todos os eventos descrito anteriormente
Para maiores informaes sobre os eventos do rel, seus significados e endereamento, consulte a
documentao do fabricante. Para mais informaes sobre Tags reportados a eventos, veja o tpico Tags
Reportados a Eventos do Manual do Usurio do E3.
Algoritmo de Leitura de SOE Genrico da Elipse
O protocolo Modbus no define um mtodo padro de leitura de eventos do equipamento. Por este motivo,
comum fabricantes criarem seus prprios algoritmos de leitura de eventos em equipamentos com suporte ao
protocolo Modbus.
O algoritmo de Sequenciamento de Eventos (SOE) genrico deste Driver (Elipse Modbus SOE) foi
desenvolvido pela Elipse com o objetivo de prover uma alternativa padro para a leitura de eventos de
controladores programveis que no contem com este recurso de forma nativa, desde que estes atendam a
alguns requisitos bsicos de espao de memria e recursos de programao, e que permitam criar as tabelas
e registros de controle descritos a seguir.
Com este algoritmo torna-se possvel armazenar e ler eventos de praticamente qualquer controlador
programvel, de forma otimizada, valendo-se de recursos j implementados e validados no Driver Modbus.
A leitura de eventos no Driver Modbus segue o procedimento padro, definido pela Elipse, lendo eventos de
tabelas montadas na memria do CLP ou de dispositivos escravos pelo seu software residente ou aplicativo
(ladder).
Para utilizar este algoritmo, preciso definir a operao utilizando a funo especial Gen SOE. Para
operaes usando esta funo, o Driver usa sempre a funo Modbus 03 (Read Holding Register) na leitura
de registros do equipamento, durante a leitura de eventos usando este algoritmo. J para a funo de escrita
utilizada na atualizao dos registros de controle, usada a funo Modbus selecionada no campo Write da
operao, na aba Modbus. Podem ser selecionadas as funes 06 (Write Single Registers) ou 16 (Write
Multiple Registers). Uma vez que o algoritmo no precisa nunca escrever blocos de registros, sugere-se
selecionar a funo 6 (Write Single Registers), caso ela seja suportada pelo equipamento (a funo 16
mais comum, suportada por um nmero maior de equipamentos no mercado).
O software residente do CLP (ladder ou equivalente) deve manter atualizados os registradores de controle
que fornecem informaes ao Driver, como o nmero de eventos disponveis para a leitura e o endereo do
ltimo registro a ler.

O equipamento pode manter mais de uma tabela de eventos, em diferentes endereos de memria,
contendo tipos diferentes. Cada tabela deve ser precedida pelos seus respectivos registradores de controle,
em endereos adjacentes. A tabela em si constituda por um buffer circular em endereos contguos,
acumulando os eventos ou dados a serem coletados pelo Driver a cada procedimento de coleta (download de
eventos).
O usurio pode definir formatos distintos de dados (eventos) para cada uma das tabelas definidas, os quais
so geralmente definidos como uma estrutura de dados, podendo conter o campo de estampa de tempo do
evento (timestamp). Os eventos podem tambm ser definidos usando um tipo nativo do Driver. Neste caso,
no possvel definir um campo Timestamp no CLP (o timestamp vem com a data da leitura), e o evento tem
somente um campo, podendo ser representado por um Tag simples (Tag PLC no Elipse SCADA).
NOTA: O algoritmo de SOE sempre usa a funo 03 (Read Holding Registers) do protocolo Modbus para a
leitura de registros do equipamento, sempre que a funo especial Gen SOE for selecionada para a
operao. Para a escrita de registros possvel selecionar, na definio da operao a funo 06 (Write
Single Register) ou a funo 16 (Write Multiple Registers). Recomenda-se escolher a primeira (Write Single
Register) sempre que possvel. A funo 16, entretanto, aceita por um nmero maior de equipamentos no
mercado, e pode ser usada sem qualquer problema, caso a funo 06 no seja suportada pelo equipamento.
Os tpicos a seguir descrevem de forma detalhada o algoritmo, sua implementao no software do CLP
(ladder), e como realizar sua leitura usando os Tags do Driver:
Tabela de Eventos
Procedimento de Aquisio no CLP
Procedimento de Aquisio na Aplicao
Tabela de Eventos
Como j mencionado no tpico Algoritmo de Leitura de SOE Genrico da Elipse, cada tabela de eventos
mantm os eventos em um buffer circular. O buffer circular de cada tabela definido pelo seu endereo
inicial, ou endereo base, contguo aos registradores de controle, e por seu nmero mximo de registros, que
define seu limite final. A tabela a seguir ilustra a disposio dos eventos dentro do buffer circular de uma
tabela.
Disposio de eventos do buffer circular
N EVENTO
TIMESTAMP
ELEMENTO1
ELEMENTO2
ELEMENTO3
...
ELEMENTON
1
2
3
4
5
...
N
Cada linha da tabela anterior representa um evento armazenado, normalmente representado por uma
estrutura, ou por Tipos Definidos pelo Usurio.
Note que, no exemplo da tabela anterior, o primeiro elemento da estrutura dos eventos o timestamp. Este
campo, cuja presena no obrigatria, e que no necessariamente precisa aparecer na primeira posio,
define a propriedade Timestamp do Tag, no sendo retornado em seus Elementos (para mais informaes,
veja o tpico Tipos Definidos pelo Usurio).
possvel tambm definir eventos com tipos nativos do Driver, e neste caso tem-se apenas um Elemento de
dado em cada evento, sem timestamp.
Os eventos devem ser inseridos no buffer circular em ordem crescente, retornando ao endereo base aps
atingir o limite superior do buffer circular. Os seguintes registros de controle devem ser definidos para cada
tabela:
Status da tabela: Deve ser mantido pelo CLP, indicando o nmero de eventos disponveis para a leitura
no buffer circular. Deve ser atualizado pelo dispositivo sempre que novos eventos forem adicionados
ao buffer circular, ou aps a concluso da coleta de eventos pela aplicao, o que pode ser detectado
pelo Status da aquisio.
Ponteiro de gravao: Este valor indica o ndice, comeando em 0 (zero), da posio onde o dispositivo
deve inserir o prximo evento. Deve ser incrementado pelo dispositivo a cada nova insero de eventos
no buffer circular, voltando ao endereo base aps alcanar o limite superior do buffer. Note que este
valor no deve ser fornecido em unidades de registradores Modbus, mas sim em posies de eventos,
devendo ser incrementado em uma unidade a cada novo evento inserido, independente do nmero de
registradores Modbus ocupados para cada evento no buffer circular. Com isto, o valor mximo
permitido para este ponteiro pode ser dado pela frmula MaxWritePtr = (Tamanho do buffer
circular / Tamanho da estrutura de evento) - 1.
Status da aquisio: Indica o nmero de registros j lidos pelo Driver a cada leitura individual de
eventos. Aps cada leitura, o Driver escreve neste registro o nmero de registros que conseguiu ler. O
aplicativo residente no escravo (ladder) deve ento imediatamente subtrair o valor escrito pelo Driver
do Status da tabela e ento zerar o Status da aquisio.
Reservado: Este registrador atualmente no utilizado. Pode ser usado em futuras verses do Driver,
podendo ser deixado em 0 (zero) na verso atual.
Conforme j mencionado, o endereo base do buffer circular, ou seja, o endereo onde inicia a tabela de
eventos, deve ser contguo aos registradores de controle.
J os registradores de controle devem estar dispostos tambm em endereos contguos, na ordem
apresentada anteriormente, permitindo sua leitura em uma nica operao, ou seja, supondo-se que o
endereo base dos registradores de controle para uma determinada tabela seja 100, tem-se os seguintes
endereos para os demais registradores:
Endereos de registradores
REGISTRADOR DE CONTROLE
Status da Tabela
Ponteiro de Gravao
Status da Aquisio
Reservado
Endereo Base do Buffer Circular
ENDEREO
100
101
102
103
104
No tpico Procedimento de Aquisio no CLP descrito passo a passo o procedimento ou algoritmo de

aquisio sob o ponto de vista do equipamento escravo (CLP). No tpico seguinte, Procedimento de
Aquisio na Aplicao, discutido como configurar a aplicao para a aquisio dos eventos da tabela.
Procedimento de Aquisio no CLP
Neste tpico discute-se o algoritmo de coleta de eventos sob o ponto de vista do CLP ou dispositivo escravo.
O objetivo deixar claro ao desenvolvedor o que preciso ser implementado no software residente do CLP
(ladder).
O dispositivo deve iniciar a insero dos eventos no sentido crescente, a partir do endereo base da tabela,
ou seja, do buffer circular. A cada novo evento inserido, o Ponteiro de Gravao deve ser incrementado,
passando a apontar para a prximo posio disponvel do buffer.
O Driver realiza 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 realiza mltiplas leituras em bloco, atualizando aps a concluso do processo o valor
do Status da Aquisio com o nmero total de eventos lidos.
NOTA: Caso o equipamento no respeite o limite padro de 253 bytes para o PDU, preciso configurar a
opo Customize Max. PDU Size, na aba Modbus, de acordo com os limites suportados, que devem estar
descritos na documentao do fabricante.
Ao detectar um valor no nulo escrito pelo Driver no Status da Aquisio, o aplicativo do dispositivo ou CLP
deve imediatamente subtrair o valor do Status da Aquisio do valor do Status da Tabela e em seguida zerar o
Status da Aquisio. Com o Status da Aquisio novamente zerado, o Driver pode iniciar nova aquisio a
qualquer momento.
O CLP pode inserir novos eventos na tabela durante o processo de aquisio pelo CLP, desde que no ocorra
overflow do buffer circular, ou seja, desde que o ponteiro de escrita no ultrapasse o de leitura,
incrementando o Status da Tabela.
O procedimento de coleta ou download de eventos concludo quando o Status da Tabela for zerado. Os
eventos coletados so ento disponibilizados aplicao por meio de Tags reportados a evento,
procedimento visto no tpico a seguir.
A seguir apresentado um pequeno fluxograma, em formato de Diagrama de Atividade UML, com sugesto
de implementao para a lgica do CLP. Note que so possveis algumas variaes, como por exemplo
descartar o evento mais antigo em caso de overflow, que podem ser avaliadas pelo desenvolvedor,
dependendo do contexto.
Diagrama de Atividade UML (CLP)
Estampa de tempo
Conforme j mencionado, cada evento composto por uma estrutura contendo um ou mais elementos de
dados (geralmente, porm no necessariamente, representados por Tipos Definidos pelo Usurio).
Se forem usadas estruturas (Tipos Definidos pelo Usurio), possvel associar a cada evento uma estampa
de tempo (timestamp) fornecida pelo CLP. Neste caso, o valor do campo Timestamp deve ser provido em um
campo da estrutura, na memria do CLP, na ordem em que declarado no arquivo de configurao, e seu
valor no mostrado em nenhum Elemento de Bloco, sendo retornado apenas na propriedade Timestamp do
Tag associado.
Conforme explicado no tpico Tipos Definidos pelo Usurio, qualquer tipo data e hora suportado pelo Driver
pode ser usado. O tipo GenTime, entretanto, foi criado especialmente para uso com o Elipse Modbus SOE,
devido facilidade de definio no software residente (ladder) do CLP.
Caso no seja necessria uma preciso de milissegundos, outra opo a considerar o tipo UTC32 do Driver,
representado como um inteiro de apenas 32 bits (4 bytes) com os segundos desde 1/1/1970, sem a
representao dos milissegundos, considerados como 0 (zero).
No tpico seguinte, Procedimento de Aquisio na Aplicao, descreve-se como configurar o supervisrio
para a coleta dos eventos acumulados no CLP ou dispositivo escravo programvel.
Procedimento de Aquisio na Aplicao
Neste tpico detalhada a configurao da aplicao do supervisrio para a aquisio dos eventos
acumulados no CLP ou dispositivo escravo programvel, sob o ponto de vista da aplicao do supervisrio.
A leitura dos eventos no supervisrio realizada por meio de Tags que referenciam operaes com a funo
especial de leitura Gen SOE, configurados na aba Operations. O tipo de dados definido no campo Data na
operao define a estrutura dos eventos armazenados na tabela do equipamento. Se for definido um tipo de
dado nativo do Driver (built-in type), cada evento tem apenas um elemento deste tipo, sem timestamp
fornecido pelo CLP (o timestamp representa o momento da coleta dos eventos). Por outro lado, se forem
usados Tipos Definidos pelo Usurio, possvel definir estruturas para os eventos, incluindo timestamps. A
figura a seguir mostra um exemplo de operao utilizando a funo especial Gen SOE, com o tipo de dados
Word.
Funo especial Gen SOE
Note que foi selecionada a funo 16 (Write Multiple Registers) como funo de escrita, que a funo mais
comum. No entanto, recomenda-se o uso da funo 06 (Write Single Register) sempre que ela for suportada
pelo equipamento.
A figura a seguir mostra a mesma operao com o tipo definido pelo usurio TYPE3 (veja o tpico Tipos
Definidos pelo Usurio), que um tipo definido no arquivo de configurao exemplo, disponvel com o Driver
e que usado como exemplo neste tpico.
Configurao usando a funo Gen SOE e um tipo definido pelo usurio
O tipo TYPE3 est definido da seguinte forma no arquivo de exemplo do Driver:

// This type has an UTC32-type timestamp
// and a few named elements
struct TYPE3
{
DefaultAddress = 0x101;
timestamp = UTC32;
float Va;
float Vb;
float Vc;
float Ia;
float Ib;
float Ic;
}
Trata-se, portanto, de um tipo de dados estrutura com seis campos de dados e timestamp, e com endereo
padro (parmetro B4 do Tag) igual a "101H" (257 em decimal). Para sua leitura, ento, preciso definir um
Tag Bloco com seis Elementos, e a seguinte configurao:
B1: Endereo do dispositivo escravo (CLP) na rede (Slave Id)
B2: 8 (operao definida anteriormente com a funo especial Gen SOE)
B3: N (tamanho da tabela no dispositivo, em nmero mximo de eventos comportados)
B4: 100 (endereo do primeiro registro de controle, usando o valor definido na tabela exemplo do
tpico Tabela de Eventos)
Size: 6
NOTA: O parmetro B3 informa o tamanho da tabela em nmero mximo de eventos suportados, e no em
registros Modbus. Em conjunto com o parmetro B4, informa indiretamente o endereo final ou limite
superior da tabela. O tamanho da rea de dados da tabela, portanto, em nmero de registros Modbus, o
produto de B3 pelo tamanho de cada evento em nmero de registros Modbus, ou seja, em Words de 16
bits.
Note que, caso o Tag Browser do E3 seja usado para inserir o Tag na aplicao, os Elementos do Tag j so
nomeados conforme o nome dado aos elementos da estrutura em sua declarao.
Uma vez tendo definido o Tag (ou Tags) apropriado, habilite sua varredura e deixe ao Driver a tarefa de
coletar os eventos da respectiva tabela, sempre que novos eventos forem detectados.
O Tag associado funo Gen SOE sempre reportado a eventos. Isto significa, conforme j explicado no
tpico Tipos Definidos pelo Usurio, que possvel ao Driver retornar vrios eventos em uma nica
operao de leitura, ou seja, em um nico intervalo da varredura do Tag. O Driver retorna o conjunto de
eventos (neste caso, conjuntos de blocos com seis campos de dados e timestamp) de uma s vez, o que
produz uma sequncia de eventos OnRead no Tag, um para cada evento (bloco com seis campos de dados e
timestamp) retornado pelo Driver. A forma usual de tratar Tags reportados a evento inserir em seu evento
OnRead o mtodo WriteRecord em Histrico previamente associado ao Tag, garantindo assim a gravao de
todos os eventos que cheguem ao Histrico. Neste caso, o Histrico deve ser configurado sem banda morta
(propriedade DeadBand igual a zero), e desabilitando o histrico por scan (no E3, propriedade ScanTime
igual a zero). A propriedade EnableDeadBand do Tag tambm deve ser configurada para Falso.
banda morta do Tag (propriedade EnableDeadBand configurada como Falso) e tambm no objeto Histrico
Tambm importante desabilitar o histrico por varredura (no E3, propriedade ScanTime igual a zero).
Com isto, garante-se que novos eventos s so armazenados atravs do mtodo WriteRecord, executado
no evento OnRead do Tag, evitando a duplicao de eventos.
Otimizao e Compatibilidade
Alguns equipamentos, como os CLP da marca ATOS, no suportam a leitura em blocos de tipos de estruturas
diferentes. Na prtica, isto impede que o Driver leia em bloco nico dados de registradores de controle e de
eventos. Para coletar eventos de CLP com estas restries, preciso desabilitar a opo Enable Control and
Data Registers Grouping na aba Gen SOE.
Leitura de Registros da Memria de Massa de Medidores ABB MGE 144
Para a leitura de registros de memria de massa de medidores ABB MGE 144, deve-se configurar a operao
usando a funo especial de leitura 65 03, conforme exemplo mostrado na figura a seguir.
Configurando de operao com a funo especial 65 03
A funo especial 65 03 proprietria da ABB e praticamente idntica funo 03 padro do protocolo

(Read Holding Registers), diferindo apenas nos dados retornados, referentes memria de massa do medidor
ABB.
Os dados so retornados em Word (como na funo 03), com o byte order padro do protocolo (big endian).
Com isto, no necessrio habilitar qualquer uma das funes de swap (Swap Bytes, Swap Words ou Swap
DWords).
O mapa dos registradores do medidor, especificando os dados que podem ser lidos, bem como sua correta
configurao, devem ser consultados no manual do medidor fornecido pelo fabricante.
Este Driver tambm conta com duas funes especiais de escrita especficas deste medidor, as funes 65
01 e 65 02. Para mais informaes sobre estas funes especiais de escrita, consulte o tpico Funes
Especiais e tambm o manual do equipamento.
Guia de Configurao Rpida

Este tpico descreve os passos necessrios para configurar o Driver Modbus para a comunicao com
equipamentos aderentes ao protocolo padro definido pela Organizao Modbus, considerando as opes de
configurao mais comuns.
Se o equipamento perfeitamente aderente ao protocolo padro, e se deseja-se apenas ler ou escrever
registros ou bits, os trs passos a seguir provavelmente so suficientes para a configurao do Driver:
Inserindo o Driver
Configurando o Driver
Configurando Tags de Comunicao
Inserindo o Driver
Se estiver utilizando o Elipse E3 ou o Elipse Power, leia o tpico Adicionando o Driver em uma Aplicao
Elipse - Elipse E3 e Elipse Power.
Se estiver utilizando o Elipse SCADA, leia o tpico Adicionando o Driver em uma Aplicao Elipse - Elipse
SCADA.
Depois, leia o passo seguinte deste Manual, que ensina como configurar o Driver em sua janela de
configurao para os casos mais comuns.
Configurando o Driver
Aps a insero do Driver na aplicao, deve-se abrir a janela de configuraes do Driver, conforme j
explicado nos tpicos Elipse E3 ou Power ou Elipse SCADA. Com a janela de configurao aberta, siga estes
passos:
1. Configure a camada fsica de comunicao:
a. Na aba Setup, selecione a camada fsica (Serial, Ethernet, Modem ou RAS) a ser utilizada na conexo
com o equipamento.
b. Configure a camada fsica selecionada na aba correspondente (Serial, Ethernet, Modem ou RAS).
c. Se precisar de mais informaes sobre a configurao da camada fsica, consulte o Manual do
Usurio do IOKit.
2. Na aba Modbus, selecione o modo do protocolo (RTU, ASCII ou TCP) utilizado pelo equipamento. Como
regra geral, deve-se selecionar RTU ou ASC (para a maioria dos equipamentos RTU) para meio fsico
Serial ou Modem, ou TCP para meio fsico Ethernet ou RAS. As demais opes em geral podem ser
deixadas em suas configuraes padro. Caso precise de mais informaes sobre as opes desta aba,
consulte o tpico Aba Modbus.
NOTA: Em novas aplicaes, recomenda-se fortemente evitar o uso de ModbusRTU (modo RTU)
encapsulado em meio Ethernet TCP/IP. Entretanto, se por algum motivo, para aplicaes legadas, for
necessrio usar ModbusRTU encapsulado em TCP/IP, no deixe de habilitar a opo Reconnect after
Timeout, descrita no tpico Aba Modbus deste Manual.
3. Na aba Operations, observe as sete operaes padro j pr-configuradas no Driver. Estas operaes, j
disponveis quando o Driver aberto pela primeira vez, so as mais comumente necessrias. Avalie as
funes de leitura e escrita e o tipo de dados usado por cada operao, e verifique quais delas so
necessrias para a aplicao. Caso as operaes pr-definidas no se enquadrem nas necessidades, leia o
tpico Aba Operations. A tabela a seguir lista as sete operaes pr-definidas.
Operaes pr-definidas
OPERAO
1

TIPO DE DADO
3: Read Holding
16: Write Multiple
Word
Registers
Registers
3: Read Holding
Registers
16: Write Multiple

Registers
DWord
FINALIDADE
Para ler e escrever
inteiros de 16 bits
sem sinal
Para ler e escrever
inteiros de 32 bits
sem sinal
OPERAO
3

TIPO DE DADO
3: Read Holding
16: Write Multiple
Int16
Registers
Registers
3: Read Holding
Registers
16: Write Multiple

Registers
Int32
3: Read Holding
Registers
16: Write Multiple

Registers
Float
3: Read Holding
Registers
2: Read Discrete
Inputs
15: Write Multiple

Coils
None
Bit
Bit
FINALIDADE
Para ler e escrever
inteiros de 16 bits
com sinal
Para ler e escrever
inteiros de 32 bits
com sinal
Para ler valores com
ponto flutuante de
32 bits
Para ler e escrever
bits
Para ler bits de um
bloco de dados de
Entradas Discretas
(Discrete Inputs)
NOTA: As sete operaes padro esto configuradas partindo do princpio que o equipamento segue o
ordenamento de bytes (byte order) padro do protocolo Modbus, o padro big endian, no qual os bytes mais
significativos vm antes. Se o equipamento no segue este padro, consulte o tpico Aba Operations para
informaes sobre como configurar operaes para byte orders diferentes.
Para informaes detalhadas sobre a configurao do Driver, leia o tpico Configurao. No passo seguinte
visto como configurar Tags de Comunicao com base nas operaes pr-definidas.
Configurando Tags de Comunicao

A seguir so descritas a configurao dos Tags de Comunicao no E3 e Elipse Power e no antigo Elipse
SCADA para os usos mais comuns.
Configurao de Tags no Elipse E3 e no Elipse Power
No caso do E3 ou do Elipse Power, possvel usar o Tag Browser para criar Tags com as operaes prdefinidas, conforme j explicado no tpico Inserindo o Driver. A janela do Tag Browser, mostrada na figura a
seguir, aberta ao clicar-se em OK na janela de configuraes do Driver.
Tag Browser do E3 ou Elipse Power
Para adicionar um novo Tag aplicao, siga estes passos:

1. Arraste os Tags da lista Tags disponibilizados pelo driver para a lista Tags do projeto corrente,
conforme descrito no tpico Inserindo o Driver. Para muitos equipamentos, a operao 1, a mais comum,
j deve ser suficiente, bastando arrastar para a lista dos Tags de projeto o Tag Op1<word>. Note que,
supondo que sejam necessrios vrios Tags com a mesma operao, o que geralmente o caso, pode-se
arrastar o mesmo Tag diversas vezes (perceba que a aplicao acrescenta nmeros sequenciais ao nome
padro). Pode-se tambm acrescentar um Tag de cada operao e fazer cpias mais tarde, no Organizer.
2. Feche o Tag Browser e configure o parmetro N4/B4 de cada Tag com o endereo de registro ou bit a ser
lido ou escrito, conforme o mapa de registradores do equipamento. Este mapa de endereos deve constar
na documentao do fabricante. Em caso de dvida, consulte o tpico Dicas de Endereamento.
3. Configure tambm o parmetro N1/B1 de cada Tag com o endereo do equipamento (Slave Id) a ser
acessado em cada caso. Este parmetro em geral configurvel no equipamento e, para determin-lo,
consulte a documentao ou suporte do fabricante, em caso de dvida.
4. Renomeie os Tags, se desejar, com um nome que seja mais significativo para a aplicao.
Configure preferencialmente Tags simples (chamados de Tags PLC no antigo Elipse SCADA) ao invs de Tags
Bloco, mantendo o recurso de Superblocos habilitado (propriedade EnableReadGrouping configurada como
Verdadeiro), deixando aplicao e ao Driver a otimizao do agrupamento. Para mais detalhes, veja o
tpico Leitura por Superblocos.
NOTA: Na verso atual, este Driver no utiliza os campos Dispositivo e Item do E3 ou do Elipse Power.
Toda a configurao dos Tags deve ser realizada atravs de seus parmetros N e B.
Configurao de Tags no Elipse SCADA
O Elipse SCADA no possui suporte ao Tag Browser, sendo necessrio configurar manualmente os Tags de
Comunicao. Deve-se criar Tags com a seguinte configurao:
N1/B1: Endereo do Equipamento (Slave Id)
N2/B2: Cdigo da Operao
N3/B3: No usado. Pode ser deixado em 0 (zero)
N4/B4: Endereo do registro Modbus ou bit
Note que, para este Driver, os parmetros N dos Tags simples tm o mesmo significado dos parmetros B
dos Tags Bloco, sendo por isto descritos em conjunto.
Em caso de dvida sobre qual valor atribuir ao parmetro N4/B4, consulte o tpico Dicas de Endereamento.
Uma vez que o Elipse SCADA no possui suporte a Superblocos, recomenda-se dar prioridade criao de
Tags Bloco, agrupando registros adjacentes ou prximos, de forma a ler o mximo de registros no menor
nmero de requisies do protocolo.
Note tambm que, uma vez que o equipamento suporte os limites padro do protocolo para o tamanho do
frame de comunicao, devido ao recurso de Partio Automtica de Blocos, no preciso se preocupar
em exceder o tamanho mximo de bloco que o protocolo suporta, pois o Driver j cria as subdivises
apropriadas no momento da comunicao.
Consideraes finais
Se tudo o que se precisa utilizar as operaes padro do Driver, e se o equipamento segue o protocolo
Modbus padro definido pela Organizao Modbus, os trs passos apresentados neste Guia de Configurao
Rpida devem ser suficientes para configurar o Driver.
Para aplicaes de maior porte, recomenda-se tambm ler o tpico Dicas de Otimizao.
Maiores detalhes sobre a configurao de Tags de Comunicao so fornecidos no tpico Configurando um
Tag de Comunicao deste Manual.
Apndice
Este apndice contm os seguintes tpicos:
Dicas de Otimizao
Dvidas Mais Frequentes
Lista de Equipamentos que Comunicam com o Modbus
Lista de Excees Padro do Protocolo
Limite Mximo para o Tamanho dos Blocos Suportado pelo Protocolo
Codificao BCD
Dicas de Otimizao
Este tpico enumera algumas dicas de otimizao para a comunicao com os dispositivos escravos.
Dicas de configurao do Driver para o E3 e o Elipse Power
Use Superblocos sempre que possvel, dando preferncia criao de Tags simples (Tags PLC no Elipse
SCADA) ao invs de Tags Bloco (veja o tpico Leitura por Superblocos).
Se no for possvel usar Superblocos, d preferncia criao de Tags Bloco, agrupando o maior
nmero possvel de variveis no menor nmero de blocos (veja o texto sobre o agrupamento manual no
tpico Leitura por Superblocos).
Considere as recomendaes do artigo Dicas de Performance para o E3, no Elipse Knowledgebase.
No caso de redes com alta latncia, banda reduzida ou perda de pacotes, leia tambm o artigo
Configuraes de rede do E3 para redes com alta latncia, banda reduzida e/ou perda de pacotes.
Em redes de alta latncia, configure timeouts mais elevados, levando em conta a latncia esperada.
Lembre-se que o tempo de timeout s tem efeito no caso de atrasos, no interferindo no desempenho
em situaes normais de uso.
Dicas de configurao do Driver para o Elipse SCADA
D preferncia criao de Tags Bloco, agrupando o maior nmero possvel de variveis no menor
nmero de blocos (veja o texto sobre o agrupamento manual no tpico Leitura por Superblocos).
Leve em considerao as recomendaes do artigo Desenvolvendo aplicativos para que tenham o
melhor desempenho possvel, tambm disponvel no Elipse Knowledgebase.
Em redes de alta latncia, configure timeouts mais altos, levando em conta a latncia esperada.
Lembre-se que o tempo de timeout s tem efeito no caso de atrasos, no interferindo no desempenho
em situaes normais de uso.
Dicas para a configurao ou programao do equipamento
Se possvel, agrupe as variveis definidas pela aplicao residente (ladder) que possuam menor tempo
de varredura (scan), em endereos contguos na memria do CLP. O tempo total de varredura dos Tags
depende muito da capacidade de agrupamento das variveis em blocos de comunicao.

Particularidades conhecidas do equipamento Twido da empresa Schneider
Est tentando ler um valor do tipo Float, porm no est conseguindo. O valor mostrado no CLP est
totalmente diferente do mostrado na aplicao para o mesmo endereo.
Resposta: Deve-se habilitar a opo Swap Words nas configuraes das operaes do Driver
Modbus. Para mais informaes, consulte a documentao do fabricante e a seo Byte Order no
tpico Aba Operations.
Est tentando ler as entradas e sadas do CLP, porm no est conseguindo.
Resposta: Este equipamento no permite leitura ou escrita nas variveis de entrada e sada, sendo
necessrio utilizar variveis internas ao CLP para realizar esta leitura, isto , cria-se um espelho das
entradas e sadas em uma rea onde o Driver consiga acessar. Deve-se ainda ter o cuidado de criar
uma rotina no CLP para verificar quando o valor de uma sada for alterada pela aplicao para que
ela seja realmente ativada ou desativada no CLP.
Particularidades conhecidas do equipamento MPC 6006 da empresa Atos - Schneider
Est tentando ler um valor do tipo DWord, porm o valor correto no est chegando. A aplicao
apresenta valores diferentes daqueles que constam no CLP.
Resposta: Consulte o artigo Utilizando drivers Modbus Master (ASC/RTU/TCP) com controladores
ATOS no Elipse Knowledgebase. Consulte tambm o tpico Aba Operations deste Manual,
sobretudo a seo Byte Order.
Como juntar dois valores do tipo Int16 (que esto no CLP) em um valor do tipo Int32 (na aplicao
Elipse)?
Tenho um nmero de 32 bits que est armazenado em dois registradores de 16 bits cada um no CLP.
Como devo fazer para mostrar na tela da aplicao Elipse este nmero como um nico registro de 32
bits?
Resposta: Deve-se criar, na janela de configuraes do Driver, uma operao com o tipo de dados
de 32 bits desejado, como por exemplo os tipos Float, DWord ou Int32. Note que, na janela de
configurao (Aba Operations), os tipos de dados de 32 bits so sempre mostrados com tamanho
(campo Size) de quatro bytes (veja o tpico Tipos de Dados Suportados). Na configurao do Tag
de Comunicao, deve-se utilizar esta operao e informar o primeiro endereo das variveis no CLP
(veja o tpico Configurando um Tag de Comunicao). Com isto, o Driver une dois registros de 16
bits do equipamento em um nico valor de 32 bits do tipo selecionado na operao, retornado no
campo valor do Tag ou no Elemento de Tag Bloco.
J tenho minha aplicao desenvolvida, porm quero saber como juntar os valores de dois Words em
um nico Tag.
Resposta: possvel realizar esta unio atravs do uso de scripts, criando um inteiro de 32 bits sem
sinal. Para isto, deve-se multiplicar o Word que contm a parte mais alta da palavra por 65536 e
ento somar o Word que contm a parte mais baixa da palavra. Por exemplo, UInt32 = (HighWord
65536) + LowWord.
Preciso ler valores do tipo Float. Configurei a funo de leitura como sendo 03 e escrita 16 com tipo de
dados Float. Porm, a aplicao E3 ou Elipse Power mostra um valor que no condiz com o valor que
est no equipamento.
Resposta: O protocolo Modbus oficial usa o ordenamento de bytes (byte order) padro big endian,
com os bytes mais significativos de cada valor vindo antes. Se o Driver estiver lendo valores
absurdos, mesmo com a configurao correta do endereo, muito provvel que o equipamento
utilize um byte order diferente do padro do protocolo. Neste caso, necessrio configurar as
opes de swap. Consulte a seo Byte Order do tpico Aba Operations para mais informaes
sobre como utilizar as opes de swap.
Como devo fazer para comunicar com mais de um equipamento em minha rede de comunicao Serial?
Tenho mais de um equipamento na minha rede serial, cada um com endereo nico. Como devo fazer
para comunicar com cada um deles?

Resposta: Deve-se ter cuidado apenas com o parmetro N1/B1 de cada Tag de Comunicao, pois
neste campo que deve-se indicar com qual equipamento deseja-se comunicar. Pode-se usar as
mesmas operaes para Tags de diversos equipamentos.
Tenho mais de uma porta serial em meu computador. Como devo configurar o Driver para comunicar
com os equipamentos que esto ligados em cada uma das portas?
Resposta: Neste caso, como existe mais de um meio fsico diferente (Serial 1, Serial 2, etc.), so
necessrios tantos Drivers de comunicao quantas portas existirem. As configuraes das
operaes e dos Tags do Driver podem ser as mesmas para todos os objetos (instncias) do Driver.
A nica diferena que um Driver deve ser configurado para comunicar pela Serial 1, outro Driver
configurado para comunicar pela Serial 2, e assim por diante.
Como comunicar com mais de um equipamento em minha rede de comunicao Serial com conversor
para RS485?
Tenho uma rede RS485 com vrios equipamentos comunicando atravs de um conversor RS232-RS485
pela porta Serial. Sempre ocorre a troca de endereo (Slave ID), ou seja, quando o Driver vai solicitar
dados de outro equipamento, ocorre um timeout. Aps retentar a mesma mensagem, o equipamento
responde normalmente. Existe alguma forma de evitar este timeout durante a troca do endereo (Slave
ID)?
Resposta: Alguns conversores RS232-RS485 requerem um intervalo de tempo para chavearem, ou
seja, comutarem do modo de transmisso para recepo, ou vice-versa. Para contornar esta
limitao, pode-se utilizar a opo Inter-frame delay na aba Serial do IOKit, disponvel na janela de
configuraes. Este campo define um intervalo de tempo entre mensagens. O valor exato do
intervalo depende do conversor utilizado mas, em caso de incerteza, recomenda-se iniciar
experimentando valores entre 50 ms e 300 ms.
NOTA: A opo Inter-frame delay do IOKit pode trazer significativo prejuzo de performance em algumas
aplicaes, devendo ser utilizada apenas quando absolutamente necessrio. Certifique-se de que o
conversor est em boas condies, e se ele de fato exige a utilizao deste delay. Se necessrio, contate o
suporte do fabricante.
Como devo fazer para comunicar com mais de um equipamento em minha rede de comunicao
Ethernet?
Tenho mais de um equipamento ligado em minha rede Ethernet, cada um com um endereo IP nico.
Como devo fazer para comunicar com cada um deles?
Resposta: Atualmente, para cada endereo IP, necessrio tantos Drivers de Comunicao quantos
endereos IP deseja-se comunicar. A configurao referente s operaes e aos Tags do Driver
pode ser a mesma para todos os Drivers. A nica diferena que um Driver deve ser configurado
para comunicar com o endereo IP 1 (um), outro Driver configurado para comunicar com o endereo
IP 2 (dois), e assim por diante. O parmetro N1/B1 (Slave Id) pode ainda ser utilizado em modo
Modbus TCP para diferenciar equipamentos conectados a um gateway, no mesmo endereo IP. O
endereo IP deve ser configurado na aba Ethernet do IOKit, na janela de configuraes do Driver.
DICA: Evite usar o modo RTU ou ASC do protocolo encapsulado em meio TCP/IP. Caso seja necessrio
encapsular a comunicao serial de equipamentos que utilizem o Modbus RTU em TCP/IP, existem
gateways disponveis no mercado que no somente encapsulam a comunicao serial em Ethernet TCP/IP
(camadas fsica, de rede e transporte), como tambm convertem o Modbus RTU em Modbus TCP (camada
de aplicao). Em ltimo caso, se for inevitvel a utilizao de Modbus RTU em meio Ethernet TCP/IP, no
deixe de habilitar a opo Reconnect after Timeout, previamente descrita no tpico Aba Modbus deste
Manual.
Software simulador Modbus
Existe algum software que simule o protocolo Modbus e que possa ser utilizado para testes junto com o
Driver?
Resposta: Sim, existem diversas alternativas. O software Modsim uma das mais antigas e
conhecidas alternativas para emular um dispositivo Modbus escravo. Ele pode ser adquirido em
http://www.win-tech.com/html/modsim32.htm. Alm dele, existe tambm a alternativa gratuita
Free Modbus PLC Simulator, disponvel em www.plcsimulator.org. Existem ainda outras
alternativas. Uma lista de outros softwares pode ser encontrada no site da Modbus.org.
Como configurar o parmetro N4/B4 dos Tags de Comunicao?
Qual endereo devo utilizar no parmetro N4/B4 do Tag de Comunicao?
Resposta: Este endereo varia de equipamento para equipamento. Para saber qual o endereo
exato a ser utilizado, consulte o manual do equipamento ou entre em contato com o suporte
tcnico.
Quando utilizar os controles de RTS e DTR (que aparecem na aba Serial da janela de configuraes do
Driver)?
Estou comunicando com o equipamento ligado direto na porta serial RS232 do PC. Como devo
configurar o RTS e o DTR?
Resposta: Deve-se consultar a documentao do equipamento ou o suporte do fabricante para
saber a configurao correta.
Estou comunicando com o equipamento atravs de um conversor RS232-RS485 ligado porta serial
RS232 do computador. Como devo configurar o RTS e o DTR?
Resposta: Na comunicao com equipamentos usando conversores RS232-RS485, tais configuraes
dependem do conversor. O equipamento (Slave) no tem influncia, j que estes sinais s existem
no lado serial RS232, no tendo equivalentes no meio serial RS485. O RTS geralmente utilizado
em conversores mais antigos para o chaveamento entre os modos de transmisso e recepo (o
RS485 half-duplex), devendo nestes casos em geral ser configurado no modo Toggle (existem
alguns raros equipamentos que exigem outras configuraes). Na maioria dos conversores mais
recentes, entretanto, o chaveamento entre transmisso e recepo automtico, e estes sinais em
geral no so mais usados, podendo ser ignorados. Em caso de dvidas, consulte o manual do
conversor ou o suporte do fabricante.
Quando utilizar as funes de Swap Bytes, Swap Words e Swap Dwords?
Essas opes devem ser usadas para tipos de 16, 32 ou 64 bits, cuja ordem dos bytes do valor fornecido pelo
equipamento no corresponde ordem padro do protocolo Modbus, onde os bytes mais significativos vm
sempre antes (padro big endian, tambm chamado Motorola). Se o Driver est lendo valores absurdos ou
diferentes dos valores armazenados no CLP, possvel que esteja utilizando um byte order diferente do
padro do protocolo. Para mais informaes, consulte a seo Byte Order no tpico Aba Operations, bem
como a documentao do equipamento.
Estou tentando ler um valor Word, porm o valor vem diferente do que est configurado no CLP. Se no
CLP configurado o valor 1 (um), na aplicao aparece 256.
Resposta: Um em hexadecimal 0001H e 256 em hexadecimal corresponde a 0100H. Seu
equipamento possui um byte order diferente do padro do protocolo. Deve-se habilitar a opo
Swap Bytes para ler o valor correto. Para mais informaes sobre byte order, consulte o tpico Aba
Operations.
Tenho um Tag configurado para ler um valor DWord, mas o valor lido pela aplicao Elipse diferente
do valor armazenado no CLP. Se atribuo 258, por exemplo, ao registro no CLP, na aplicao Elipse
aparece o valor absurdo 16908288.
Resposta: 258 em hexadecimal 00000102H e 16908288 em hexadecimal corresponde a
01020000H. Seu equipamento possui um byte order diferente do padro do protocolo, onde o Word
menos significativo vem antes. Neste caso, deve-se habilitar a opo Swap Words para ler o valor
correto. Para mais informaes sobre byte order, consulte o tpico Aba Operations.
Como ler corretamente tipos Float em CLPs WEG TPW-03?
Resposta: Na aba de configurao das operaes do Driver, deve-se habilitar a opo Swap Words na
operao de leitura e escrita utilizada.
Particularidades conhecidas dos equipamentos da famlia ABB Advant Controller 31 series 90 (por
exemplo, CLP ABB 07KT97)
Usando o E3 ou o Elipse Power, estou tentando ler registros ou bits do CLP, mas sempre ocorrem erros.
Resposta: Os equipamentos desta srie no permitem o uso de Superblocos do E3 ou do Elipse
Power por dois motivos:
Existem descontinuidades no mapa de endereos de registradores dos equipamentos, com
intervalos de endereos no definidos.
O tamanho mximo do PDU diferente do estabelecido pelo padro do protocolo, sendo
definido como um tamanho que suporte 96 Words ou Bits. Uma vez que o protocolo agrupa oito
bits em cada byte de dados, isto resulta em tamanhos mximos de PDU diferentes para as
funes de leitura de Bits e Words, o que impossibilita o uso da customizao do tamanho
mximo do PDU permitida pelo Driver, que no permite configurar limites diferentes para cada
funo do protocolo.
Soluo: Siga estes passos:
1. Desabilite a leitura por Superblocos, configurando a propriedade EnableReadGrouping do
Driver para Falso.
2. D preferncia definio de Tags Bloco, agrupando o maior nmero possvel de variveis no
menor nmero de Blocos, respeitando o limite do equipamento de 96 Words ou 96 Bits em
cada Bloco (para mais informaes, leia a seo sobre Agrupamento Manual no tpico
Leitura por Superblocos).
NOTA: Pode ainda ser possvel utilizar o agrupamento automtico (Superblocos) se no for preciso ler
Words e Bits no mesmo objeto Driver, dependendo obviamente do intervalo de endereos que se precise
ler (mais especificamente, se este intervalo possui ou no descontinuidades). Neste caso, de qualquer
forma, necessrio configurar a propriedade Customize Max. PDU Size na Aba Modbus, de acordo com o
limite de 96 Words (96 2 = 192 bytes) ou 96 Bits (96 / 8 = 12 bytes). Tal possibilidade pode ser avaliada
com cuidado, caso a caso, pelo desenvolvedor da aplicao.
Estou tentando ler valores Float, e a seguinte mensagem aparece no log do driver: "Warning:
denormalized float number! Returning zero". O que devo fazer?
Resposta: O aparecimento desta mensagem no indica erro de comunicao ou de configurao.
Recomenda-se apenas que o usurio verifique na programao do CLP por que ele est retornando
valores no normalizados.
Informaes Adicionais: Tal mensagem indica que o equipamento enviou ao Driver um valor de ponto
flutuante (Float) no formato IEEE 754, porm no normalizado. Tais valores podem resultar de
operaes aritmticas com resultados que extrapolem as possibilidades de representao deste
formato, como as condies de overflow, underflow, +infinito e -infinito, etc. Os valores no
normalizados esto previstos na norma IEEE 754, no devendo em tese gerar problemas para o Driver
ou para a aplicao. Entretanto, devido deteco de erros no passado relacionados a hardwares
especficos, o Driver passou a retornar 0 (zero) para a aplicao ao receber valores no normalizados do
equipamento, registrando esta mensagem em log.
Lista de Equipamentos que Comunicam com o Modbus

A seguir, uma pequena lista de equipamentos, separados por fabricante, para os quais j existe alguma
experincia na comunicao com o protocolo Modbus.
Para uma lista mais completa de equipamentos j validados com o protocolo, consulte o Modbus Device
Directory, mantido pela Organizao Modbus.
Equipamentos que comunicam com o Modbus
FABRICANTE
ABB
Altus
Areva
EQUIPAMENTO
ETE30
MGE 144
KT97
KT98
Praticamente todos os equipamentos da Altus
possuem Modbus, exceto alguns modelos da linha
Piccolo
MiCOM P127
Rel P632
FABRICANTE
Atos
BCM
Ciber Brasil
Contemp
Deep Sea
Embrasul
Eurotherm
Fatek
GE
Gefran
Hitachi
Honeywell
Horner APG
Koyo
Kron
LG
LG / LSIS
EQUIPAMENTO
Os CLP ATOS suportam o protocolo Modbus RTU com
pequenas variaes relativas ao tamanho mximo dos
frames e byte order. Para mais informaes sobre as
variaes, consulte o artigo Utilizando o driver Modbus
Master com controladores ATOS, no Elipse
Knowledgebase
BCM1088
BCM1086
BCM-GP3000
BCM2085
Medidor Multivarivel de Grandezas eltricas
UDP200
Medidor Multivarivel de Grandezas eltricas
UDP600
CPM45
DSE5210
DSE5310
DSE5310M
DSE5320
DSE5510
DSE5510M
DSE5520
DSE7310
DSE7320
Medidor MD4040
2500 Intelligent Data Acquisition and Precision
Multi-Loop PID Control
FB - 14MCU
GE PAC RX7
GE GEDE UPS
CLP Gefran Gilogk II
Gefran 600RDR21
Hitachi HDL17264
PLC HC-900
Equipamentos da srie XLe/XLt all-in-one control
devices
CLP CPU 260
Medidor MKM-120
DMT40U
LG Master K120 S
LG XGB - XBM
FABRICANTE
EQUIPAMENTO
Moeller
XC100 - Porta Serial 232

XC200 - Porta Serial 232/422/485 (mdulo de
comunicao XIO-SER) e Porta Ethernet
XV200 - Porta Serial 232 e Porta Ethernet
XVH300 - Porta Serial 232 e Porta Ethernet
XV400 - Porta Serial 232 e Porta Ethernet
N1100
N1500
N2000
N3000
Twido
A340
CLP M340
Srie Premium
Conversores de frequncia e soft starter
Disjuntores de MT e BT
Rels de proteo de BT e MT
Rels SEPAM Sries 20, 40 e 80
Controladores Zelio logic com final "BD"
V120
TP 03
Clic 02
V1000
Novus
Schneider
Telemecanique
Unitronics
Weg
Yaskawa
Lista de Excees Padro do Protocolo

A tabela a seguir lista as excees padro, definidas pela especificao do protocolo Modbus (verso 1.1b).
As excees so registradas no log do Driver, sempre que detectadas, e podem ser lidas pela aplicao
atravs da Leitura do Cdigo da ltima Exceo.
Note que, alm das excees listadas aqui, o equipamento pode definir outras excees proprietrias. Neste
caso, espera-se que elas sejam descritas na documentao do fabricante do equipamento.
Cdigos de exceo padronizados pelo protocolo Modbus
CDIGO (EM HEXADECIMAL)
01
NOME
ILLEGAL FUNCTION
02
ILLEGAL DATA ADDRESS
SIGNIFICADO
O cdigo de funo recebido no
vlido. Isto pode indicar que a
funo no est implementada ou
que o Escravo encontra-se em um
estado inadequado para processla.
O endereo de dados recebido no
um endereo vlido. Mais
especificamente, a combinao do
endereo de referncia e a
quantidade de dados a serem
transferidos invlida.
CDIGO (EM HEXADECIMAL)

03
04
05
06
08
0A
0B
NOME
ILLEGAL DATA VALUE
SIGNIFICADO
O valor presente na requisio do
Mestre no vlido. Isto indica
uma falha na estrutura de dados
remanescente de uma requisio
complexa, como quando o tamanho
informado para o bloco de dados
no est correto. Esta exceo no
indica que os valores submetidos
para escrita estejam fora do
escopo esperado pela aplicao,
uma vez que tal informao no
acessvel ao protocolo.
SLAVE DEVICE FAILURE
Ocorreu um erro irrecupervel
durante o processamento da
funo solicitada.
ACKNOWLEDGE
Usado com comandos de
programao. O Escravo aceitou a
mensagem e a est processando.
Porm, este processamento
demanda um longo tempo. Esta
exceo previne um timeout no
Mestre. O fim da requisio deve
ser testado por um processo de
polling.
SLAVE DEVICE BUSY
Usado com comandos de
programao. Indica que o Escravo
est processando um outro
comando de longa durao e que a
solicitao deve ser retransmitida
mais tarde, quando o Escravo
estiver novamente disponvel.
MEMORY PARITY ERROR
Usado em conjunto com as
funes 20 e 21, reference type 6,
para indicar que a rea estendida
de arquivos falhou em um teste de
consistncia. O equipamento
Escravo pode estar precisando de
manuteno.
GATEWAY PATH UNAVAILABLE
Usado em conjunto com gateways,
para indicar que o gateway no foi
capaz de alocar um caminho
interno para o processamento da
solicitao. Geralmente indica que
o gateway est desconfigurado ou
sobrecarregado.
GATEWAY TARGET DEVICE FAILED Usado em conjunto com gateways,
TO RESPOND
para indicar que no foi recebida
nenhuma resposta do equipamento
de destino. Geralmente indica que
tal equipamento no est presente
na rede.
Limite Mximo para o Tamanho dos Blocos Suportado pelo Protocolo

Neste tpico so apresentados os limites mximos de tamanho de bloco suportados pelo protocolo Modbus,
na atual verso 1.1b de sua especificao (veja a especificao no site oficial do protocolo).
Note que, devido aos recursos de Leitura por Superblocos e Partio Automtica de Blocos, presentes na
verso atual do Driver, dificilmente o usurio necessita levar em conta estes limites em uma aplicao, uma
vez que o Driver j realiza automaticamente as otimizaes necessrias no momento da comunicao.
Entretanto, uma vez que existem equipamentos que no suportam os limites padro estabelecidos pelo
protocolo, pode ser necessrio ao usurio conhecer os limites do protocolo, e sobretudo saber avaliar os
limites do equipamento, caso seja obrigado a realizar o agrupamento de forma manual (veja o tpico Leitura
por Superblocos). Nestes casos, a informao deste tpico pode se mostrar til.
Limites suportados pelo protocolo
O protocolo Modbus define uma unidade de dados simples denominada PDU (Protocol Data Unit), que se
mantm inalterada nos diversos modos do protocolo e nas diversas camadas de comunicao.
O frame de comunicao completo, incluindo a PDU e os demais campos adicionais de cabealho, chamado
ADU (Application Data Unit).
Limites suportados pelo protocolo
Segundo a especificao do protocolo, o frame Modbus completo (ADU) pode ter um PDU com tamanho
mximo de 253 bytes.
Sendo assim, dependendo do tipo de dado ou funo Modbus que utilizado na comunicao, o protocolo
impe os limites de elementos do bloco em cada comunicao descritos na tabela a seguir.
Limites de elementos de bloco
FUNO MODBUS
03, 04
16
01, 02
15
20
21
DESCRIO
Leitura de mltiplos registros de 16
bits
Escrita de mltiplos registros de 16
bits (Holding Registers)
Leitura de mltiplos bits
Escrita de mltiplos bits
Leitura de registros de arquivo
Escrita de registros de arquivo
LIMITE
125 registros (250 bytes)
2000 bits (250 bytes)
1968 bits (247 bytes)
Mais informaes podem ser obtidas no site oficial do protocolo.
O artigo KB-23112: Tamanho ideal de um Bloco de Comunicao usando o driver Modbus no Elipse
Knowledgebase apresenta uma sntese das questes relativas ao agrupamento de Tags e dimensionamento
de blocos neste Driver, discutidas neste e em outros tpicos.
Codificao BCD
A Codificao BCD (Binary Coded Decimal, ou Decimal Codificado em Binrio) foi originalmente concebida
para contornar limitaes quanto ao nmero mximo de dgitos passveis de serem representados nos
formatos mais tradicionais de armazenamento de valores. Formatos como a representao de nmeros reais
em ponto flutuante mostram-se normalmente aceitveis para clculos matemticos e cientficos. Porm,
erros de aproximao causados pela existncia de algarismos que no possam ser representados por
problemas de overflow ou underflow podem no ser admissveis em certas aplicaes, como em
procedimentos financeiros. Para superar este tipo de limitao, foi desenvolvida a codificao BCD, que
permite a representao de nmeros at o ltimo algarismo.
Nessa representao, cada algarismo decimal representado isoladamente em formato binrio, sem
limitaes no que se refere ao nmero de algarismos.
A tabela a seguir mostra os algarismos decimais e seus valores correspondentes em BCD (valores em
binrio).
Algarismos decimais em codificao BCD
DECIMAL
0
1
2
3
4
BCD
0000b
0001b
0010b
0011b
0100b
DECIMAL
5
6
7
8
9
BCD
0101b
0110b
0111b
1000b
1001b
A fim de melhorar a eficincia desta codificao, comum representar-se dois algarismos por byte. Note que,
na tabela acima, cada dgito decimal requer apenas quatro bits, ou meio byte, para a sua representao.
Tal representao com dois dgitos em cada byte chamada de BCD Comprimido (Packed BCD), e a
representao utilizada por este Driver, ou seja, os pacotes enviados por este Driver com valores BCD
utilizam um byte de dados para cada dois algarismos do valor decimal representado. Por isto o campo Size,
no caso de tipos de dados BCD, deve ser definido como a metade do nmero mximo de algarismos
representados nos valores a serem lidos ou escritos.
Exemplo
Como exemplo, suponha que se pretenda enviar o valor 84 em decimal (0x54 em hexa), usando a codificao
BCD, comprimido em um byte, o formato usado por este Driver.
O primeiro passo separar os dois dgitos decimais que compem o valor em sua representao decimal:
Dgito 1 = 8
Dgito 2 = 4
Se fossemos enviar o valor ao equipamento sem a codificao BCD, o valor enviado ao protocolo seria o
prprio valor 84, que seria representado em hexadecimal pelo valor 0x54, ou ainda 01010100b em binrio.
Usando o formato BCD comprimido, entretanto, representaremos os dois dgitos decimais separadamente em
cada metade, ou nibble, do byte a ser enviado:
BCD = 0x84 = 10000100b
Note que, se interpretssemos por engano este valor 0x84 em BCD como um valor hexadecimal sem esta
codificao, e este valor fosse convertido para decimal, obteramos o valor de 132, valor sem significado
algum.
A tabela a seguir apresenta mais alguns exemplos de valores decimais entre 0 (zero) e 99, e suas respectivas
representaes no formato BCD Comprimido em um byte, apresentados nos formatos hexadecimal e binrio.
Algarismos decimais em codificao BCD Comprimido
DECIMAL
10
0
99
81
45
HEXADECIMAL
0x0A
0x00
0x63
0x51
0x2D
BCD (HEXADECIMAL)
0x10
0x00
0x99
0x81
0x45
BCD (BINRIO)
00010000b
00000000b
10011001b
10000001b
01000101b
Histrico de Revises do Driver

VERSO
3.0.11
DATA
29/05/2015
AUTOR
A. Quites
COMENTRIOS
Migrao do Driver para o
IOKit 2.0 (Case 13891).
Corrigido problema na
janela de configurao de
operaes, em que a
remoo de uma operao
da tabela poderia falhar
(Case 14874).
Corrigido erro no qual o
Driver poderia apresentar
comportamentos estranhos
com a opo Reconnect
after timeout habilitada,
quando lendo Tags de
leitura de SOE por
callbacks. Este erro
poderia, em situaes
raras, permitir que o Driver
tentasse desconectar
mltiplas vezes
consecutivas, e ento se
reconectar tambm
mltiplas vezes
consecutivas (Case 14775).
Corrigido vazamento de
handles no download de
eventos do controlador GE
PAC RX7 (Case 16404).
Corrigido erro no recurso
de Use Bit Mask quando
usado com Superblocos
habilitados (Case 18340).
Corrigido erro na leitura
de Strings com tamanho
mpar, em que os ltimos
caracteres poderiam ser
truncados caso as opes
de swap estivessem
habilitadas (Case 16744).
VERSO
2.8.17
DATA
19/10/2012
AUTOR
A. Quites
COMENTRIOS
Implementado o Elipse
Modbus SOE, recurso que
padroniza a leitura de SOE
para a maioria dos CLPs
(Case 12038).
Adicionados os tipos ou
estruturas definidos pelo
usurio, como parte da
implementao do recurso
de SOE Genrico (Case
12038).
Implementada a leitura de
SOE para rels Schneider
Electric sries SEPAM 20,
40 e 80 (Case 12106).
Adicionado o novo tipo
Sp_time para a
representao de
estampas de tempo
(timestamps) de rels
Schneider Electric sries
SEPAM (Case 12106).
Adicionados os tipos de
data e hora GenTime,
UTC64d e UTC32, que
podem ser usados para a
representao de
estampas de tempo
(timestamp) (Case 12038).
Adicionada a leitura por
callbacks para Tags de
leitura de SOE (Case
12464).
Adicionada opo de
reconexo em caso de
ocorrncia de timeout na
recepo de frames,
quando utilizada a camada
fsica Ethernet (Case
12537).
Remodelada a janela de
configurao para permitir
a adio das novas opes
de configurao, com a
criao de nova aba
Operations (Case 12038).
VERSO
DATA
AUTOR
COMENTRIOS
Removida a opo Swap
Address Delay da janela
de configurao do Driver.
Esta opo, tornada
obsoleta pela opo Interframe delay do IOKit,
continua disponvel como
configurao offline,
mantendo compatibilidade
com aplicaes legadas
(Case 13285).
Removida a opo Reverse
Frame da caixa de dilogo
de configurao das
operaes do Driver, por
obsolescncia. A opo
continua sendo suportada
em aplicaes legadas
(Case 12443).
Adicionadas informaes
sobre a configurao de
tipos Float para
controladores WEG TPW03 (Case 12546).
Adicionada informao
sobre a configurao do
Driver para o controlador
ABB 07KT97 e para todos
os controladores da famlia
ABB Advant Controller 31
series 90 (Case 12667).
Adicionado o CLP ATOS
lista de equipamentos que
suportam o protocolo
Modbus (Case 13247).
Adicionadas informaes
sobre o recurso de partio
automtica de blocos,
disponvel a partir da
verso 2.00 (Case 11594).
Adicionado o CLP WEG Clic
02 lista de equipamentos
suportados (Case 11602).
Revisado o texto do tpico
de introduo para deixar
claro que este Driver
trabalha como Mestre na
rede Modbus, permitindo a
comunicao com
dispositivos Escravos (Case
12035).
VERSO
2.7.1
DATA
30/06/2010
AUTOR
A. Quites
COMENTRIOS
Adicionado tpico sobre
Superblocos (propriedade
EnableReadGrouping)
(Case 13287).
Adicionado tpico sobre
particionamento
automtico de blocos
(Case 13288).
Adicionado tpico com
dicas de otimizao (Case
13287).
Adicionada ao tpico
a questo sobre a
mensagem referente
recepo de valores Float
no normalizados (Case
13295).
Atualizada a lista de
equipamentos que
comunicam usando o
protocolo Modbus, levando
em conta equipamentos
registrados nos suportes
atendidos mais
recentemente (Case
13298).
Adicionado o tpico Guia
de Configurao Rpida,
com o passo a passo para
a configurao do Driver
nos casos de uso mais
comuns (Case 13301).
Solucionado erro ao
carregar arquivo de
configurao no Windows
CE ARM HPC2000 (Case
12352).
Solucionado erro na escrita
de valores float_GE (Case
12298).
Solucionado erro no qual o
ltimo caractere de String
lida, com tamanho mpar
de caracteres, poderia
deixar de ser retornado
aplicao (Case 12466).
Ajustes na recepo dos
dados para descartar
possveis bytes invlidos
(Case 11394).
VERSO
DATA
AUTOR
C. Mello
2.6.3
26/11/2009
A. Quites
C. Mello
2.5.12
30/06/2009
A. Quites
COMENTRIOS
Atualizado o tpico Leitura
do Cdigo da ltima
Exceo (Case 11233).
Atualizado o tpico
(Case 11316).
Removida a mensagem de
erro falsa no arquivo de
log para leitura de dados
de memria com endereo
zero (Case 10654).
Otimizada a leitura do tipo
Bit via Superblocos (Case
10971).
Modificada a rotina de
Wait Silence para ser
executada em qualquer
erro que ocorrer no Driver.
O usurio tambm pode
executar a rotina Wait
Silence manualmente pelo
novo Tag Especial N2 =
9001 (Case 10850).
Adicionada
compatibilidade com a
plataforma Windows CE
(Case 10914).
Corrigido erro na opo
Swap Address Delay (Case
10425).
Atualizado o valor padro
para o tamanho mximo do
PDU, conforme verso
mais recente do padro
Modbus (Case 10274).
Solucionado erro nos Tags
especiais de ltima
exceo, que poderiam
no reportar algumas
excees (Case 10337).
Corrigido erro no retorno
do ano para registros de
SOE com o dia atual do
controlador GE PAC RX7
(Case 10382).
Corrigido erro na funo 20
(Read File Record) (Case
10312).
VERSO
DATA
AUTOR
M. Ludwig
2.4.10
17/02/2009
A. Quites
2.3.22
02/09/2008
C. Mello
COMENTRIOS
Criado novo Tag para ler
eventos de SOE de pontos
especficos do GE PAC RX7
(Case 10370).
Corrigido erro na leitura de
tipos Bit com Superblocos
(Case 10100).
Implementada leitura do
evento GE SOE mais
recente (Case 10178).
Criadas operaes padro
para os tipos de funes
mais comuns (Case 9185).
Adicionado novo tipo de
dado Float_GE (Case
9427).
VERSO
2.2
DATA
11/05/2007
AUTOR
A. Quites
A. Quites
COMENTRIOS
Corrigido erro na
configurao offline do
parmetro
ModiconModbus.Modbus
Mode (Case 9831).
mscaras de bits de
registradores (Case 9682).
buffer de eventos em
controladores GE PAC RX7
(Case 9523).
Implementada a
possibilidade de configurar
um limite mximo para o
PDU (Case 9154).
Corrigido erro nos recursos
de reordenamento de
bytes (Swap Byte, Swap
Word, Swap DWord e
Rev. Frame) na leitura de
tipos Word com
Superblocos habilitados
(Case 9220).
Implementada a opo
Enable CMS Addressing
(Case 8665).
Revises e testes em
funes Modbus pouco
usadas (Case 8730).
Melhorada a consistncia
de dados escritos atravs
da funo Modbus 06
(Write Single Register)
(Case 8663).
blocos de tipos no Word
com Superblocos
habilitados (Case 8243).
VERSO
2.1
DATA
23/01/2007
AUTOR
A. Quites
2.0
10/11/2006
A. Quites
1.0
R. Farina
COMENTRIOS
Implementado o recurso de
Superblocos (Case 6185).
Melhorada a consistncia
de parmetros N2/B2 de
Tags de acesso a registros
(Case 7714).
blocos de dados do tipo
BCD de tamanho quatro
(Case 7728).
blocos de Strings (Case
7804).
Verso original com IOKit
(Case 3339).
Todas as verses
anteriores ao controle de
revises.
Matriz
Rua 24 de Outubro, 353 - 10 andar
90510-002 Porto Alegre
Fone: (+55 51) 3346-4699
Fax: (+55 51) 3222-6226
E-mail: elipse-rs@elipse.com.br
Filial SP
Rua dos Pinheiros, 870 - Conj. 141/142
05422-001 So Paulo - SP
Fone: (+55 11) 3061-2828
Fax:(+55 11) 3086-2338
E-mail: elipse-sp@elipse.com.br
Filial PR
Av. Sete de Setembro, 4698/1705
80240-000 Curitiba - PR
Fone: (+55 41) 4062-5824
E-mail: elipse-pr@elipse.com.br
Filial MG
Rua Antnio de Albuquerque, 156
7 andar Sala 705
30112-010 Belo Horizonte - MG
Fone: (+55 31) 4062-5824
E-mail: elipse-mg@elipse.com.br
Filial RJ
Praia de Botafogo, 300/525
22250-044 Rio de Janeiro - RJ
Fone: (+55 21) 2158-1015
Fax: (+55 21) 2158-1099
E-mail: elipse-rj@elipse.com.br
USA
2501 Blue Ridge Road, Suite 250
Raleigh - NC - 27607 USA
Fone: (+1 252) 995-6885
Fax: (+1 252) 995-5686
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

Modbus BR

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Modbus BR

Transféré par

Droits d'auteur :

Formats disponibles

Driver Modicon Modbus Master (ASC/RTU/TCP)

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Modbus padro. Foram desenvolvidas para atender particularidades exclusivas de determinados

Adicionando o Driver em uma Aplicao Elipse

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Adicionar um Driver a uma aplicao E3 ou Elipse Power

Janela Localizar Driver

Na janela de configurao do Driver que se abre, configure o Driver conforme a necessidade.

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

No segundo passo do tpico Guia de Configurao Rpida apresentado o procedimento para a

Janela de configurao do Driver no Organizer

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Janela do Tag Browser

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Adicionar novo Driver ao Elipse SCADA

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

O Driver ento adicionado na aplicao.

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Janela de configurao do Driver

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Janela de configurao do Driver

Janela de configurao do Driver no Organizer

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

FUNO DE LEITURA FUNO DE ESCRITA

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

FUNO DE LEITURA FUNO DE ESCRITA

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Double (ou Real)

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Copyright 2001-2015 Elipse Software Ltda. Todos os direitos reservados.

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

1/1/1970 00:00 a 31/12/2035

1/1/1970 00:00 a 31/12/2035

1/1/1970 00:00 a 31/12/2035

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

MAPA DE BITS (16 BITS)

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

linhas ("/*" e "*/"), conforme explicado a seguir.

Caixa de dilogo de configurao de estruturas

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

Adicionar tipo definido pelo usurio

Driver Modicon Modbus Master (ASC/RTU/TCP) v3.0.11

linhas ("/" e "/"), conforme explicado a seguir.