Manual do Software

Fundao Centros de Referncia em Tecnologias Inovadoras

Financiadora de Estudos e Projetos
Servio de Apoio s Micro e Pequenas Empresas
Conselho Nacional de Desenvolvimento Cientfico e Tecnolgico

ScadaBR 0.7
Sistema Open-Source para Superviso e Controle

Manual do Software
Outubro de 2010

2/70
Sumrio

1. Introduo.....................................................................................................5
1.1. Sobre o documento ..................................................................................5
1.2. Sistemas SCADA......................................................................................5
1.3. ScadaBR .................................................................................................6
2. Instalao .....................................................................................................7
2.1. JDK (Java Development Kit) ......................................................................7
2.1.1. Instalando a JDK ...............................................................................7
2.1.2. Configurando a JAVA_HOME ...............................................................7
2.2. Instalando o ScadaBR manualmente ..........................................................8
2.3. Instalando o ScadaBR via Instalador ..........................................................8
3. Operando o ScadaBR ......................................................................................9
3.1. Apresentao ..........................................................................................9
3.1.1. Menu principal ......................................................................................9
3.1.2. Tipos de dados......................................................................................9
3.1.3. Data sources ...................................................................................... 10
3.1.4. Data points......................................................................................... 11
3.1.5. Monitoramento ................................................................................... 11
3.1.6. Controle............................................................................................. 12
3.1.7. Eventos.............................................................................................. 12
3.1.8. cones da Aplicao ............................................................................. 12
3.1.9. Sons de Alarmes ................................................................................. 13
3.1.10. Graficos ........................................................................................... 14
3.2. Adicionando Data Sources e Data Points ................................................... 15
3.3. Visualizando os dados: Watch List e Grficos............................................. 17
3.4. Definindo Eventos .................................................................................. 20
3.5. Representaes Grficas ......................................................................... 22
4. Data Sources ............................................................................................... 25
4.1. Modbus ................................................................................................ 25
4.1.1. Viso geral ..................................................................................... 25
4.1.2. Configurao bsica......................................................................... 25
4.1.3. Configurao do data point............................................................... 27
4.2. OPC DA ................................................................................................ 28

3/70
 4.2.1. Viso geral ..................................................................................... 28
4.2.2. Configurao bsica............................................................................. 28
4.2.3. Configurao do data point................................................................... 28
5. Relatrios .................................................................................................... 30
5.1. Introduo ............................................................................................ 30
5.2. Gerando relatrios no ScadaBR................................................................ 30
5.2.1. Configurando um novo modelo de relatrio ............................................ 30
5.2.2. Agendamento de Relatrios .................................................................. 31
5.2.3. Envio de relatrios por e-mail ............................................................... 31
5.2.4. Gerenciamento de modelos .................................................................. 33
5.2.5. Fila de relatrios ................................................................................. 33
5.3. Gerando relatrios utilizando softwares de terceiros. .................................. 34
5.3.1. Pentaho: Configurando a base de dados do ScadaBR ............................... 34
5.3.2. Pentaho: Exemplo de criao de um relatrio ......................................... 38
5.3.3. iReport: Configurando a base de dados do ScadaBR ................................ 45
5.3.4. iReport: Selecionando os dados da base a serem utilizados ...................... 48
6. Scripts ........................................................................................................ 50
6.1. Introduo ............................................................................................ 50
6.2. Criando o Data Source e os Data Points .................................................... 50
6.3. 6.3. Criando um Meta Data Source e seus Data Points................................ 55
6.4. Criando Point Links ................................................................................ 61
7. Watchdog .................................................................................................... 62
7.1. Como funciona ...................................................................................... 62
7.2. Configurao ......................................................................................... 62
7.3. Como executar ...................................................................................... 63
8. Dicas .......................................................................................................... 64
8.1. Como alterar o banco de dados? .............................................................. 64
9. Glossrio ..................................................................................................... 66

4/70
1. Introduo

1.1. Sobre o documento

Este tutorial tem como propsito auxiliar os usurios no uso do software ScadaBR.
Informaes adicionais sobre as funcionalidades disponveis no software podem ser
encontradas no menu principal clicando no cone .
Informaes mais especficas sobre cada funcionalidade tambm esto disponveis nas
telas de configurao de cada uma delas, clicando no cone similar .

1.2. Sistemas SCADA

A sigla SCADA uma sigla do ingls para Supervisory Control And Data Acquisition, o
que significa Controle Supervisrio e Aquisio de Dados. Sistemas SCADA servem como
interface entre o operador e processos dos mais variados tipos, como mquinas
industriais, controladores automticos e sensores dos mais variados tipos. Com sistemas
SCADA so construdos desde aplicativos simples de sensoreamento e automao, at
os famosos "Painis de Controle" em empresas de gerao e distribuio de energia
eltrica, centrais de controle de trfego e assim por diante.
Um SCADA tpico deve oferecer drivers de comunicao com equipamentos, um sistema
para registro contnuo de dados ("datalogger") e uma interface grfica para usurio,
conhecida como "IHM" ou Interface Homem-Mquina. Na IHM so disponibilizados
elementos grficos como botes, cones e displays, representando o processo real que
est sendo monitorado ou controlado. Entre algumas das funes mais utilizadas em
sistemas SCADA esto:
- Gerao de grficos e relatrios com o histrico do processo;
- Deteco de alarmes e registro de eventos em sistemas automatizados;
- Controle de processos incluindo envio remoto de parmetros e set-points, acionamento
e comando de equipamentos;
- Uso de linguagens de script para desenvolvimento de lgicas de automao
("receitas").

5/70
1.3. ScadaBR

O software ScadaBR desenvolvido em modelo "open-source", possuindo licena

gratuita. Toda a documentao e o cdigo-fonte do sistema esto disposio, inclusive
sendo permitido modificar e re-distribuir o software se necessrio.
O ScadaBR uma aplicao multiplataforma baseada em Java, ou seja, PCs rodando o
Windows, Linux e outros sistemas operacionais e podem executar o software a partir de
um servidor de aplicaes (sendo o Apache Tomcat a escolha padro).
Ao executar o aplicativo, ele pode ser acessado a partir de um navegador de Internet,
preferencialmente o Firefox ou o Chrome. A interface principal do ScadaBR de fcil
utilizao e j oferece visualizao das variveis, grficos, estatsticas, configurao dos
protocolos, alarmes, construo de telas tipo HMI e uma srie de opes de
configurao.
Aps configurar os protocolos de comunicao com os equipamentos e definir as
variveis (entradas e sadas, ou "tags") de uma aplicao automatizada, possvel
montar interfaces de operador Web utilizando o prprio navegador. Tambm possvel
criar aplicativos personalizados, em qualquer linguagem de programao moderna, a
partir do cdigo-fonte disponibilizado ou de sua API "web-services".
Em nosso site encontra-se um vdeo demonstrativo que aborda exemplos com as
funcionalidades bsicas do ScadaBR.

6/70
2. Instalao

2.1. JDK (Java Development Kit)

O Tomcat exige do sistema uma JDK, com a varivel de ambiente JAVA_HOME

devidamente declarada. Certifique-se de que voc possui uma JDK 1.6 (ou maior)
instalada em seu sistema e de que a varivel JAVA_HOME esteja corretamente
configurada digitando: java -version em um console.

2.1.1. Instalando a JDK

Faa o download da JDK no site da Sun:

(http://java.sun.com/javase/downloads/index.jsp).
Siga as instrues de instalao padro.

2.1.2. Configurando a JAVA_HOME

- No Windows XP ou 2000
Navegue: Painel de Controle Sistema Avanado Variveis de Ambiente
Clique em adicionar e insira JAVA_HOME com o endereo do diretrio de instalao da
JDK.
Inicie um console e entre com java -version para certificar-se que tudo funcionou
corretamente.

- No Windows Vista ou 7, navegue: Painel de Controle Sistema e segurana

Sistema Configuraes Avanadas do Sistema Avanado Variveis de Ambiente
Clique em adicionar e insira JAVA_HOME com o endereo do diretrio de instalao da
JDK.
Inicie um console e entre com java -version para certificar-se que tudo funcionou
corretamente.

- No Linux
No Ubuntu, edite o arquivo .bashrc (em /home/<seu_usuario>/), inserindo a linha:
export JAVA_HOME=<endereo do diretrio de instalao da JDK>

7/70
Feche o console, abra novamente e entre com java -version para certificar-se que tudo
funcionou corretamente.

2.2. Instalando o ScadaBR manualmente

Faa o download da ltima verso do Apache Tomcat no site oficial

(http://tomcat.apache.org/).
Extraia os arquivos para um diretrio de sua escolha "<tomcat-home>".
Execute o arquivo startup.bat (Windows) ou startup.sh (Linux) do diretrio <tomcat-
home>/bin/ para iniciar o Tomcat.
Em um browser, entre com o endereo: localhost:8080/. Caso a pgina de
configurao do Tomcat inicie, o mesmo est corretamente configurado. Caso contrrio,
certifique-se que todos os passos anteriores (principalmente a instalao da JDK e
configurao da varivel JAVA_HOME) foram executados corretamente.
Para parar o Tomcat, execute o arquivo shutdown.bat (Windows) ou shutdown.sh
(Linux) do diretrio <tomcat-home>/bin/ para iniciar o Tomcat.
Faa o download do arquivo ScadaBR.war
(http://www.scadabr.org.br/?q=webfm).
Coloque este arquivo no diretrio <tomcat-home>/webapps/.
Inicie o Tomcat.
Em um browser, entre com o endereo:
localhost:8080/ScadaBR/ (username: "admin" password: "admin").

2.3. Instalando o ScadaBR via Instalador

Para instalar o ScadaBR via instalador, faa o download do arquivo ScadaBR-Win-

Installer_<ver>.exe e execute-o. Siga os passos clicando em Next..
Ao final dos passos, clique em Install.

Obs.1: Recomenda-se desinstalar todas os Tomcat j instalados na mquina antes de

utilizar o instalador do ScadaBR.
Obs.2: No Windows Vista e no Windows 7, deve-se executar o instalador em modo de
administrador, clicando com o boto direito sobre o arquivo e selecionando Executar
como administrador.

8/70
3. Operando o ScadaBR

3.1. Apresentao

3.1.1. Menu principal

As funcionalidades nesta aplicao so acessadas pelos controles no cabealho.

Dependendo das permisses de sua conta de usurio, vrios cones sero exibidos
abaixo do logotipo da aplicao. Quando o cursor do mouse pairar sobre um cone, ser
exibida um balo de texto com uma descrio resumida da funcionalidade daquele cone.
Alm dos cones de controle, no lado direito do cabealho mostrado o nome de usurio
que est logado no sistema.
Quando sua aplicao tiver um alarme ativo, um cone de uma bandeira ( ) ficar
piscando e ser associada uma descrio do alarme prximo ao centro do cabealho. A
cor da bandeira indicar a severidade do alarme:
Informao
Urgente
Crtico
Risco de Vida
possvel clicar no cone ou na descrio para exibir a lista de alarmes ativos.

3.1.2. Tipos de dados

So suportados cinco tipos de dados:

Valores Binrios (ou booleanos) podem ter apenas dois estados, referidos no
sistema com os valores zero (0) e um (1). possvel utilizar conversores para
exibir os valores binrios em quaisquer rtulos necessrios, como
"ligado/desligado", alto/baixo", "iniciado/parado", etc.
Valores de Estados Mltiplos tm mltiplos estados distintos. Por essa
abordagem, o tipo binrio um caso particular de um estado mltiplo. Valores
so primitivamente representados como inteiros (ex. 0, 1, 2, 7, ...), mas, como
nos valores binrios possvel atribuir rtulos a cada valor como, por exemplo,
"ligado/desligado/desativado", "aquecer/resfriar/desligado", ou quaisquer outros.

9/70
 Valores Numricos (ou analgicos) so valores decimais representados no
sistema com uma varivel de ponto flutuante. Podem ser citados como exemplos
de valores numricos: temperatura, umidade, preo e altitude. Renderizadores de
texto podem ser usados para determinar exibio de caractersticas como nmero
de casas decimais, separao de milhar (com pontos ou vrgulas), exibio de
sufixos (F, kW/h, moles, etc.). Renderizadores de faixas podem ser usados para
converter faixas de valores em rtulos de texto.
Valores Alfanumricos so simplesmente seqncias de caracteres, como a
descrio O/S de uma fonte SNMP.
Valores em Imagens so representaes binrias de dados de imagens. So
armazenados em arquivos no sistema de arquivos do servidor host (e no no
banco de dados) e so guardados em memria. Renderizadores podem ser
usados para criar imagens escaladas, como thumbnails, para exibio.

3.1.3. Data sources

Data sources (fontes de dados) so parte fundamental para a operao desta aplicao.
Um data source um "lugar" de onde os dados so recebidos. Virtualmente, qualquer
coisa pode ser um data source, desde que o protocolo de comunicao seja suportado
pela aplicao. Alguns exemplos:
Se voc tem uma rede Modbus acessvel por RS232, RS485, TCP/IP ou UDP/IP,
voc pode criar um data source Modbus que ir "pollar" (poll) a rede em um
intervalo definido.
Se voc tem equipamentos ou aplicaes que podem enviar dados sobre HTTP,
voc pode iniciar um data source HTTP receiver que ir escutar conexes
recebidas e enviar os dados aos pontos apropriados.
Para hardware qeu suporta SNMP, inicie um data source SNMP. Valores podero
ser "pollados" em intervalos definidos, ou traps podem ser recebidos para report-
on-exception.
Dados podem ser lidos e atualizados em uma base de dados SQL externa ao
sistema.
Dados podem ser gerados randomicamente ou preditivamente usando um data
source Virtual.
Valores de dados recebidos ou coletados por um data source so armazenados em data
points.

10/70
3.1.4. Data points

Um data point uma coleo de valores histricos associados. Por exemplo, um ponto
particular pode ser uma leitura de temperatura de um quarto, enquanto outro ponto
poderia ser a leitura de umidade do mesmo quarto. Pontos tambm podem ser valores
de controle, como um indicador para ligar ou desligar um equipamento.
Existem muitos atributos que so usados para controlar o comportamento de pontos.
Inicialmente existe o conceito de um point locator. Locators so usados por data
sources para determinar como "achar" os dados para o ponto particular. Por exemplo,
um data source SQL tem atributos incluindo onde achar a instncia da base de dados;
point locators para o data source indicam o nome da tabela e dos campos onde podem
ser achados valores especficos. A separao lgica de data source e de data point
dependem do protocolo de comunicao em questo.
Atributos de data points tambm podem determinar muitos outros aspectos do ponto,
como seu nome, como deve ser registrado (todos os dados, apenas mudanas no valor,
ou nenhum), por quanto tempo manter os dados, como formatar os dados para exibio
e como traar um grfico com os valores.
Voc tambm pode configurar data points com detectores de valor, que so usados
para detectar condies de interesse nos valores dos pontos, como por exemplo, se o
valor esteve muito alto por muito tempo, se muito baixo, se muda com freqncia, se
no muda, etc.
Pontos podem ser arranjados em um uma hierarquia, ou rvore, para simplificar sua
gerncia e exibio usando a funcionalidade de Hierarquia.

3.1.5. Monitoramento

Monitoramento de pontos dentro do sistema pode ser feito de duas maneiras. possvel
usar uma watch list para criar listas dinmicas de pontos com seus valores, ltimos
tempos de atualizao, e grficos de informaes histricas (se a configurao do ponto
permitir). Valores e grficos so atualizados em tempo real sem ter que atualizar a
janela do navegador. Grficos de mltiplos pontos tambm podem ser exibidos sob
demanda.
Tambm possvel criar representaes grficas de pontos usando a funcionalidade
drag and drop para posicionar representaes grficas de pontos sobre uma imagem de
fundo arbitrria. Imagens animadas podem ser usadas para criar uma visualizao

11/70
altamente dinmica do comportamento do sistema, e, como as watch lists, valores so
representados em tempo real sem necessitar de atualizao do navegador. Essas
visualizaes podem ser marcadas como "pblicas" para que possam ser utilizadas em
web sites pblicos.

3.1.6. Controle

O controle de sistemas externos pode ser obtido para pontos que podem ser "setados"
(ou que permitem escrita ou sada). Um ponto setvel pode ser "setado" para um valor
definido pelo usurio, como uma configurao de um termostato ou de um controle
interruptor para um equipamento. Ambas watch lists e graphical views proporcionam
meios simples para determinar a entrada de um valor. O point locator para um ponto
"setvel" determina como o data source define o valor no equipamento externo.

3.1.7. Eventos

Um evento a ocorrncia de uma condio definida no sistema. Existem tanto eventos

definidos pelo sistema como definidos pelo usurio. Eventos definidos pelo sistema
incluem erros de operao de data sources, logins de usurios, e inicializao e parada
do sistema. Eventos definidos pelo usurio incluem detectores de valor, eventos
agendados, e eventos compostos que detectam condies sobre pontos mltiplos
usando argumentos lgicos. H tambm os "eventos autidatos" que ocorrem quando
usurios fazem alteraes (adies, modificaes e remoes) que afetam objetos em
tempo de execuo, incluindo data sources, data points, detectores de valor, eventos
agendados, eventos compostos e tratadores de eventos.
Uma vez que um evento foi detectado, manipulado por tratadores. Um tratador de
eventos um comportamento definido pelo usurio que deve ser executado quando um
evento particular ocorre, como envio de email ou "setar" o valor a um ponto setvel.

3.1.8. cones da Aplicao

Data source
Data point
Grfico

12/70
 Set point
Watch list
Representao grfica
Atualizar
Detector de valor
Evento composto
Evento agendado
Tratadores de eventos
Alarme
Usurio
Comentrio de usurio
Relatrio
Listas de envio
Publisher
Aviso
Logout

3.1.9. Sons de Alarmes

O ScadaBR pode executar sons quando alarmes esto ativos. Por definio, sons para
alarmes so executados para alames urgentes, crticos e de risco de vida e no para
alarmes de informao, mas os sons dos alarmes podem ser definidos individualmente.
Para habilitar sons de alarmes particulares, arquivos vlidos no formato mp3 devem ser
colocados em:

<ScadaBR_home>/audio/information.mp3
<ScadaBR_home>/audio/urgent.mp3
<ScadaBR_home>/audio/critical.mp3
<ScadaBR_home>/audio/lifesafety.mp3

Para desabilitar um som, remova o arquivo de som associado. Uma coleo de sons
pode ser achada na pasta <ScadaBR_home>/audio/lib.

13/70
3.1.10. Graficos

O ScadaBR contm uma pequena biblioteca de grficos que pode ser achada na pasta
<ScadaBR_home>/graphics. Cada sub-pasta contm todas as imagens daquela
definio de imagem e um arquivo opcional de propriedades chamado info.txt. Este
arquivo de propriedades contm pares nome/valor para os seguintes atributos (todos
opcionais):

name: O nome que ser usado para descrever a imagem na interface de usurio.
Se no fornecido, a imagem assume por padro o nome da pasta.
width: A largura da imagem. Por padro, todas as imagens so do mesmo
tamanho. Se no fornecido, a largura da primeira imagem ser utilizada.
height: A altura da imagem. Por padro, todas as imagens so do mesmo
tamanho. Se no fornecido, a altura da primeira imagem ser utilizada.
text.x: A posio de texto relativo ao limite esquerdo da imagem, em pixels. Se
no fornecido, o valor padro 5.
text.y: A posico de texto relativo ao limite superior da imagem, em pixels. Se
no fornecido, o valor padro 5.

Uma vez que utilizada uma definio de imagem nas views a pasta no deve
ser renomeada! O nome da pasta usada internamente como o identificador da
definio de imagem.
Arquivos de imagens so arranjados alfabeticamente por nome e so sensveis caixa.
Pares nome/valor so separados por '='. Linhas iniciadas por '#' so consideradas
comentrios. Arquivos 'thumbs.db' so ignorados. Arquivos compactados (zip, gz, tar,
etc) no podem ser usados por que os arquivos de imagens devem ser acessados pelo
web server. As definies de imagens so carregadas na inicializao do sistema, ento
quaisquer alteraes requerem reinicializao.
Para que as futuras verses do ScadaBR tenham mais grficos, por favor fornea os
grficos que voc criar para o projeto ScadaBR.

14/70
3.2. Adicionando Data Sources e Data Points

Este tpico mostra um exemplo de criao de Data Sources e Data Points. Para fins
didticos, criou-se um Data Source do tipo Virtual Data Source, que se trata de um data
source simulado.
No menu principal, escolha a opo DataSources .
Selecione o tipo Virtual Data Source na lista e clique sobre o cone Adicionar .
Preencha como abaixo e salve suas configuraes.

Ao salvar o data source, as opes para incluso de data points sero habilitadas. Clique
em Adicionar e preencha como abaixo e salve suas configuraes.

15/70
Adicione mais alguns pontos de diferentes tipos.

Agora, habilite todos os pontos clicando sobre os cones em cada um deles e habilite
tambm o data source .

16/70
3.3. Visualizando os dados: Watch List e Grficos

Agora que voc possui cadastrado no sistema seus data sources e data points, basta
visualiz-los. No menu principal, escolha a opo Watch List .
Os data points cadastrados encontram-se esquerda. Para monitorar seus valores,
clique sobre cada um para adicion-lo watch list atual.

17/70
Voc pode acessar e editar mais informaes a respeito de cada data point clicando em
Detalhes do data point . Clique no cone citado relativo ao data point numrico e
observe seu histrico e o grfico dos seus valores.

18/70
Ainda possvel editar as propriedades de renderizao de texto.
Em sua watch list, clique em Detalhes do data point .
Na prxima tela, clique em Editar data point .
Na rea Propriedades de renderizao de texto, tem-se diferentes opes de
renderizao. Por exemplo, com as configuraes da figura abaixo:

19/70
Alteramos a renderizao do data point de:

Para:

3.4. Definindo Eventos

Em sua watch list, clique em Detalhes do data point .

Na prxima tela, clique em Editar data point .

20/70
Na lista de Detectores de Eventos, selecione "Limite inferior" e clique em Adicionar
para adicionar um novo detector.
Preencha os campos como abaixo e clique no boto Salvar , no lado direito inferior da
tela.

Pronto. Agora o sistema o informar (na tela de "Alarmes", no menu principal) toda vez
que o valor de seu data point ficar abaixo do limite mnimo (22) por mais de 5
segundos.

21/70
3.5. Representaes Grficas

Para criar visualizaes mais elaboradas dos dados, podemos construir "Representaes
Grficas". No menu principal, escolha a opo Representao grfica .
Clique em Nova representao .
Escolha um nome para sua primeira representao, clique sobre Escolher arquivo,
selecione uma imagem, confirme e clique em Fazer upload de imagem.

Na lista de componentes, selecione Data point simples e clique em Adicionar

componente representao para adicion-lo.

22/70
Navegue at o cone adicionado sobre a figura e clique sobre a segunda opo: Editar
configuraes de componente de ponto.

Escolha um dos seus pontos cadastrados na lista e salve suas configuraes.

Adicione outros componentes, associe aos seus data points cadastrados e posicione-os
sobre a tela.
Clique sobre o boto "Salvar".

23/70
24/70
4. Data Sources
4.1. Modbus

4.1.1. Viso geral

O data source Modbus utilizado para adquirir dados tanto de um equipamento modbus
acessvel por meio de uma rede I/P podendo estar em uma rede local ou intranet, ou
ento estar em qualquer lugar na internet (Modbus IP), quanto de uma rede local
modbus acessvel via RS232 ou RS485 (Modbus Serial). O mecanismo de controle de
acesso do tipo mestre-escravo ou Cliente-Servidor.

4.1.2. Configurao bsica

O campo Nome define o nome do data source, e pode ser qualquer descrio. O
Perodo de atualizao determina a frequencia com que so solicitados os dados do
equipamento Modbus. O campos Timeout e os Retries determinam o comportamento
do sistema no caso de uma solicitao falhar. O data source aguarda por uma resposta
pelo tempo (em milisegundos) definido como timeout. Se no receber resposta, o data
source tentar novamente quantas vezes estiver definido em retries.
A opo Contiguous batches only pode ser usada para especificar que a
implementao de modbus no deve tentar otimizar solicitaes por valores diferentes
numa nica solicitao. Ativando esta opo far com que a implementao somente
realize solicitaes por valores mltiplos quando estes valores formarem um espao
contnuo no registrador.
Pode-se scanear nodos escravos na rede utilizando a funcionalidade Node scan. Esta
funcionalidade itera sobre os escravos de 1 a 240, enviando a cada um um
ReadExceptionStatus (cdigo de funcionamento 7). Se uma resposta for recebida
(considerando as configuraes de timeout e retries), o nodo considerado disponvel.
Note que nem todos os equipamentos suportam este cdigo de funcionamento, ento
falsos-negativos so possveis.
O campo Create slave monitor points faz com que monitoradores de escravos
sejam criados automaticamente. Um monitorador de escravo um ponto binrio que

25/70
indica o atual estado de um escravo. Se uma solicitao de poll a um escravo falhar
devido ao timeout ou a um erro, o escravo considerado off line. Estes pontos podem
ser utilizados para controle como qualquer outro ponto.

Modbus IP

Trs Transport types so suportados. Verifique a documentao do seu equipamento

para determinar qual configurao pode ser usada.
A configurao TCP usa um novo socket TCP a cada poll. O nmero de retries definido
aplica-se quando ocorrem excees na conexo durante a abertura do socket. O timeout
usado para a conexo depende de se a pilha TCP est sendo usada.
A configurao TCP with keep-alive cria uma conexo TCP no primeiro poll, o qual
deixado aberto para re-uso. Se a conexo fechada por algum motivo, uma nova
criada quando necessrio. O comportamento para excees na conexo para esta opo
a mesma para o TCP. Esta a configurao recomendada para a maioria dos usurios,
visto que ela prov uma comunicao eficiente e robusta enquanto evita muitos dos
problemas de configurao tpicos ao UDP.
A configurao UDP utiliza pacotes UDP para comunicao. Esta configurao prov a
maior eficiente de rede, mas tipicamente requer uma configurao maior da rede, visto
que tanto o ScadaBR quanto o equipamento precisam ser visveis na rede (em oposio
ao TCP, no qual o ScadaBR pode estar protegido por uma firewall.
As configuraes de Host e Port determinam como encontrar o equipamento Modbus na
rede. O host pode ser o nome de um domnio ou um endereo IP.

Modbus Serial

A comunincao Serial controlado com os valores de Baud Rate, Flow control in,
Flow control out, Data bits, Stop bits, and Parity. O Echo pode ser usado com a
rede RS485 se for apropriado.
O valor de Encoding determina como as solicitaes Modbus so formatadas. A maioria
parte dos equipamentos utilizam mensagens formatadas em RTU. Verifique a
documentao do seu equipamento Modbus para determinar como configurar este
campo.

26/70
4.1.3. Configurao do data point

Ambos, serial e redes IP, utilizam os mesmos atributos de ponto. O Slave id o id com
o qual o nodo Modbus foi configurado e um nmero entre 1 e 240.
O Register range determina em qual dos quatro ranges o valor ser encontrado.
Consulte a documentao do seu equipamento para determinar qual deve ser usado.

Coil status representa o range hexadecimal de 0x00000 a 0x0FFFF. Cada

registrador contm um nico e configurvel bit. Valores neste range so sempre
Binrios.
Input status representa o range hexadecimal de 0x10000 a 0x1FFFF. Cada
registrador contm um nico e read-only bit. Valores neste range so sempre
Binrios.
Holding register representa o range hexadecimal de 0x40000 a 0x4FFFF. Cada
registrador possui 2 bytes (ou uma palavra) e configurvel. Valores neste
range podem ser Binrios ou Numricos dependendo das demais configuraes.
Input register representa o range hexadecimal de 0x30000 a 0x3FFFF. Cada
registrador possui 2 bytes (ou uma palavra) e read-only. Valores neste range
podem ser Binrios ou Numricos, dependendo das demais configuraes.

Valores de Coil status e Input status so sempre Binrios. Entretanto, fornecedores

de Modbus so frequentemente muito criativos nas maneiras com que os Holding e
Input registers so usados. O campo Modbus data type reflete as vrias maneiras
nas quais os dados podem ser codificados. Consulte a documentao de seu
equipamento Modbus para determinar a configurao apropiada.
Valores especficos esto localizados na configurao do Offset. Este campo um valor
0-indexed, o que significa que sua contagem inicia em 0. Alguns fornecedores de
Modbus fornecem documentao no qual ele 1-indexed, no qual a contagem inicia em
1. Portanto, s vezes necessario subtrair 1 do ndice documentado para determinar o
offset 0-indexed. Quando os registradores incluem seus ranges, como por exemplo,
escrito como 0x30001, 1-indexed est tipicamente implcito. O campo Bit usado
quando valoers binrios so codificados em bits de registradores individuais.
O campo Settable pode ser usado para tornar um ponto, que normalmente seria
configurvel (de acordo com seu range), no configurvel.
Os campos Multiplier e Additive podem ser usados quando converses triviais de

27/70
valores so necessrias. Valores numricos lidos da rede so calculados da seguinte
maneira: (valor bruto) * multiplier + additive. O contrrio aplicado quando um valor
numrico escrito na rede.

4.2. OPC DA

4.2.1. Viso geral

A especificao OPC DA (OPC Data Access) a primeira de um grupo de especificaes

conhecido como OPC Specifications, e nasceu da colaborao de diversos lderes
mundiais em fornecimento de equipamentos de automao trabalhando em cooperao
com a Microsoft.
Originalmente baseado nas tecnologias OLE COM (component object model) e DCOM
(distributed component object model), a especificao define um conjunto padro de
objetos, interfaces e mtodos para utilizar em aplicativos de controle de processos e de
automao de manufaturas para facilitar a interoperabilidade. As tecnologias COM/DCOM
fornecem o framework para os softwares serem desenvolvidos. Atualmente existem
centenas de servidores e clientes OPC DA.

4.2.2. Configurao bsica

O campo Nome define o nome do data source, e pode ser qualquer descrio. O
Perodo de atualizao determina a frequencia com que so solicitados os dados do
servidor OPC DA.
Os campos Host, Domnio, Usurio e Senha definem o endereo e as credenciais do
servidor a ser utilizado. Aps preencher estes campos, clique em Atualizar, e uma lista
com os servidores disponveis no endereo definido ser criada.

4.2.3. Configurao do data point

Aps selecionar o servidor OPC DA, clique em Listar Tags na caixa direita das
configuraes do data source. As tags disponveis no servidor sero listadas, juntamente
com seus tipos, se so configurveis ou no e com um checkbox na coluna Add.
Para adicion-los como data points, basta dar check nas tags desejadas e em seguida

28/70
clicar em Adicionar Tags. As tags selecionadas iro aparecer numa caixa abaixo das
configuraes do data source, podendo ser habilitadas ou desabilitadas.
Obs.1: Antes de adicionar as tags, necessrio salvar o data source.
Obs.2: Tags adicionadas que j foram previamente adicionadas, aparecero na lista
duplicadas.

29/70
5. Relatrios

5.1. Introduo

O ScadaBR possui um gerador de relatrios prprio, alm de ser compatvel com os

principais geradores de relatrios customizados.
Neste item sero abordadas as duas maneiras de gerar relatrios a partir do ScadaBR.

5.2. Gerando relatrios no ScadaBR

5.2.1. Configurando um novo modelo de relatrio

No menu principal, escolha a opo Relatrios .

Modelos de relatrios proporcionam uma definio de como criar instncias de relatrios.
Para adicionar um novo modelo de relatrio, clique em Novo relatrio .

Nesta tela, deve-se definir o modelo do relatrio:

O Nome do modelo usado como uma referncia visual do modelo. Recomenda-se a

utilizao de um nome nico para cada modelo.
Utilize a lista de Data points para selecionar os pontos que devem ser includos no
relatrio. Para adicionar data points, selecione o ponto desejado na lista e clique no
cone . Para remover um ponto existente, clique no cone associado ao ponto.
O valor Faixa de datas utilizado para determinar uma faixa de tempo utilizada para
filtrar valores que sero utilizados no relatrio.

30/70
5.2.2. Agendamento de Relatrios

Relatrios podem ser "agendados" para serem gerados automaticamente. Use a

seleo Executar a cada... para determinar um simples evento de tempo a partir do
qual o relatrio ser gerado, ou defina uma rotina de acordo com o padro cron para
controle mais especfico (veja a documentao de "Cron patterns" para mais
informao). Eventos de tempo ocorrem no incio do perodo compreendido. Um Atraso
de execuo pode ser aplicado se os dados esperados para o relatrio tendem a serem
coletados aps o tempo de execuo absoluto do relatrio.

5.2.3. Envio de relatrios por e-mail

Apesar dos relatrios no poderem ser explicitamente compartilhados pelo sistema,

podem ser implicitamente compartilhados por meio da criao de uma lista de envio de
emails para a qual o sistema enviar instncias de relatrios gerados. O contedo desse
email o mesmo da janela "grfico de relatrio" aberta no painel de Relatrios. Para
incluir o arquivo de exportao com o formato CSV no email, selecione a caixa Incluir
tabela de dados.
Selecione os Destinatrios de email para os quais enviar o email com o relatrio. Os
destinatrios podem ser listas de discusso, usurios do sistema ou endereos de email
digitados. Clique no cone Enviar e-mail de teste para enviar uma mensagem de teste
para os destinatrios selecionados.
Importante: Instncias de relatrios enviadas por email so automaticamente
apagadas depois de serem enviadas.

31/70
32/70
5.2.4. Gerenciamento de modelos

Para salvar um modelo de relatrio clique no cone no canto direito superior do painel de
criao de modelos. Para apagar um modelo existente, clique no cone . Para gerar um
relatrio imediatamente a partir de um modelo, clique em Executar agora. Note que
alguns modelos de relatrios podem incluir uma grande quantidade de informaes e,
por causa disso, podem levar algum tempo para serem gerados. Assim, todos os
relatrios so gerados de maneira assncrona da interface de usurio. Quando um cone
clicado, a instncia de relatrio ser includa em uma fila onde o usurio pode
monitorar seu progresso.

5.2.5. Fila de relatrios

A Fila de relatrios lista todas as instncias de relatrios para o usurio em questo.

Esta lista no atualizada automaticamente. Uma atualizao pode ser invocada ao
clicar em . Alguns eventos, entretanto, tambm iro invocar uma atualizao desta
lista, como a gerao de um relatrio.
Instncias de relatrios em qualquer estado sero listadas, estejam completos ou em
execuo. As colunas da lista iro refletir o estado atual da instncia.
As colunas da lista tm as seguintes definies:
Nome do relatrio: o nome herdado do modelo de relatrio. Uma vez criada a
instncia, o nome do relatrio no alterado mesmo se o nome do modelo
mudar.
Incio da execuo: o momento de tempo em que a instncia comeou a ser
gerada.
Durao da execuo: quanto tempo a gerao da instncia consumiu.
De: o tempo a partir do qual os registros foram selecionados..
At: o tempo at o qual os registros foram selecionados.
Registros: o nmero total de registros selecionados.
A caixa No Descartar permite que usurios previnam que instncias de relatrios
importantes sejam descartadas (veja a documentao "Outras configuraes" para mais
informaes a respeito do processo de descarte de relatrios). Esta funcionalidade deve
apenas ser usada quando estritamente necessria, pois as instncias de relatrios
podem consumir quantidades considerveis de armazenamento.

33/70
A coluna final da tabela oferece controles para o gerenciamento das instncias. O cone
inicia o download de um arquivo CSV com os dados do relatrio, para importao em
softwares de planilha eletrnica. O cone abre uma nova janela do navegador
exibindo informaes da instncia de relatrio, dados estatsticos e uma imagem do
grfico dos dados do relatrio. Clicando no cone , a instncia do relatrio apagada.
Instncias de relatrio particularmente grandes podem levar algum tempo para serem
apagadas.

5.3. Gerando relatrios utilizando softwares de terceiros.

5.3.1. Pentaho: Configurando a base de dados do ScadaBR

Aps fazer o download do RPD, basta descompactar o arquivo e executar o arquivo

report-designer.bat no Windows ou o report-designer.sh no Linux que estar dentro da
pasta descompactada.
A tela inicial do programa ira abrir.

34/70
V em File -> New, para criar um novo Report.
Agora hora de criar um DataSource. O DataSource ser a fonte dos dados utilizados no
Report.
Neste exemplo, ser utilizado o MySQL como DataSource. Para utilizar utilizar o Apacha
Derby, basta trocar a Connection Type.
Ento v em Data Add Data Source JDBC

35/70
Agora, criamos uma nova Connection, basta clicar no cone + ao lado de Edit Security

36/70
Configure conforme figura acima e clique em OK.
Pronto, agora est tudo configurado e a base de dados j pode ser utilizada. A
configurao do Report drag-and-drop, ou seja, basta arrastar e soltar.
Desse modo, basta escolher o que deseja adicionar na paleta, arrastar e soltar no
Report.

37/70
5.3.2. Pentaho: Exemplo de criao de um relatrio

Neste tpico apresentado um passo-a-passo para criar um Report bsico:

Criar um Novo Report

Configurar o MySQL como DataSource usando a base de dados do ScadaBR como
colocado anteriormente
Criar as Queries que sero utilizadas no andamento do Report:
As Queries so as tabelas que estaro disponveis do banco de dados . Para criar uma
nova Query, verique ao lado direito da Janela Principal e v na aba Data:

D dois cliques no Data Set selecionado e ento adicionamos uma Query.

A primeira Query que criamos para pegar o nome do DataSource e a quantidade de
DataPoints pertencente ao DataSource:

38/70
Clique em OK.
A segunda para pegar os dados dos usurios do sistema ScadaBR:

39/70
E, por fim, a terceira para pegar os dados dos DataPoints:

40/70
A Query anterior foi criada para o DataPoint 1, porm criada mais duas Queries para
os outros DataPoints apenas mudando na Query o nmero do data point desejado em:
where dataPointId = <DataPointDesejado>

41/70
A configurao do layout do Report se d da seguinte maneira:
O Layout subdividido em: Page Header, Report Header, Details, Report Footer, Page
Footer. Iniciamos com o Page Header.

Nessa parte adicionamos um label para escrever Report e um image para colocar a
imagem do ScadaBR. Para adicionar bastar puxar o item desejado da paleta e soltar no
local desejado.

Report Header

Nessa parte adicionamos dois label um para DataSource: e outro para Quantidade
de DataPoints: e selecionamos da Query anteriormente criada o nome do DataSource e
a quantidade de datapoints.

Details

42/70
Nessa parte adicionamos trs Sub-Report. O Sub-Report adicionado porque em cada
Report permitido o uso de somente uma Query, ento para utilzarmos mais Queries
adicionamos Sub-Reports.

Nesse Sub-Report so adicionados 5 label : Quantidade, Soma, Mximo, Mnimo e

Mdia. Tambm so adicionados dados da Query DataPoint1.

Nesse Sub-Report so adicionados 5 label : Quantidade, Soma, Mximo, Mnimo e

Mdia. Tambm so adicionados dados da Query DataPoint2.

43/70
Nesse Sub-Report so adicionados cinco label: Quantidade, Soma, Mximo, Mnimo e
Mdia. Tambm so adicionados dados da Query DataPoint3.

Report Footer
Nessa parte adicionamos um Sub-Report.

Nesse Sub-Report so adicionados trs label: Usurio, Email e Fone. Tambm so

adicionados dados da Query Username.

Page Footer

Nessa parte adicionamos um label.

Para visualizar um preview do relatrio, clique no cone destacado com um X.

44/70
5.3.3. iReport: Configurando a base de dados do ScadaBR

Obs.: Se voc estiver utilizando o Derby, necessrio adicionar a lib derby.jar

(ScadaBR\WebContent\WEB-INF\lib\derby.jar) ao Classpath do iReport, em
Ferramentas > Opes, na aba Classpath, Add JAR.
Selecione a opo Report Datasources.

45/70
Clique em New.
Escolha a opo Database JDBC connection.

Defina um nome (p.ex. ScadaBR).

- Caso utilize MySQL

Em JDBC Driver, escolha "MySQL(com.mysql.jdbc.Driver)"
Em JDBC URL, digite: jdbc:mysql://localhost/mango
- Caso utilize Derby
Em JDBC Driver, digite: org.apache.derby.jdbc.EmbeddedDriver
Em JDBC URL, digite: jdbc:derby:<localizao do seu tomcat>/bin/mangoDB

46/70
Deixe os campos JDBC URL Wizard em branco.
Preencha os campos de Username e Password de acordo com a configurao de seu
banco de dados.

Para verificar se voc configurou corretamente, clique em Test. Caso a mensagem

Connection test successful seja mostrada, a base j est pronta para ser utilizada.

47/70
5.3.4. iReport: Selecionando os dados da base a serem utilizados

Selecione Report query

Na aba Report query, voc pode digitar diretamente a query que desejar, ou clicar no
boto Query....
Em Query..., voc pode montar a query visualmente, escolhendo as tabelas, criando
clusulas e selecionando os campos que deseja obter.

Montada a query, clique em Read Fields. Os campos selecionados iro aparecer na

tabela abaixo, com seus tipos j definidos.

48/70
Voc pode clicar em Preview data para verificar se os dados retornados so realmente
aqueles que deseja.
Clique em OK, e os campos sero adicionados a lista de Fields do relatrio, podendo
ento ser utilizados.

49/70
6. Scripts

6.1. Introduo

Para criar scrips no ScadaBR, utiliza-se o Meta Data Source. Ele tem esse nome por sua
capacidade de combinar pontos existentes em novos. Ao invs de obter sua informao
de uma fonte externa, utiliza valores de outros pontos e permite manipulao de
maneiras arbitrrias pelo usurio.
Para conhecer mais funcionalidades de scripts no ScadaBR, busque a Ajuda, no menu
Meta Data Source.
Segue abaixo um exemplo de como criar um script bsico.

6.2. Criando o Data Source e os Data Points

Neste exemplo, criamos 1 Virtual Data Source: Casa e 9 Data Points: Chuva, Clima,
Desumidificador, Humidade, Lareira, Luz, Sol, Temperatura e Ventilador.

50/70
Data Point Chuva

Data Point Clima

51/70
Data Point Desumidificador

Data Point Humidade

52/70
Data Point Lareira

Data Point Luz

53/70
Data Point Sol

Data Point Temperatura

54/70
Data Point Ventilador

6.3. 6.3. Criando um Meta Data Source e seus Data Points

Agora vamos adicionar os Scripts. Para isso, adicionamos 1 Meta Data Source e 5 Data
Points : Script_Clima, Script_Desumidificador, Script_Lareira, Script_Luz e
Script_Ventilador.

55/70
Script_Clima

EmTipo de Dado, escolha Alfanumrico. Em Script Context, escolha os datapoints Casa

Temperatura e Casa Humidade e ento clique no cone para adicion-los ao script.
No campo Var, escolhe-se o nome pelo qual o data point ser referenciado no script.
Neste exemplo, definiu-se temp_var e humi_var para a temperatura e humidade
respectivamente.

No campo Script insira o seguinte cdigo :

a = "Clima Quente e Hmido";

b = "Clima Quente e Seco";
c = "Clima Frio e Hmido";
d = "Clima Frio e Seco";
e = "Clima Atual";

if (temp_var.value > 25 && humi_var.value > 80 )

56/70
 e = a;
if (temp_var.value > 25 && humi_var.value < 80 )
e = b;
if (temp_var.value < 25 && humi_var.value > 80 )
e = c;
if (temp_var.value < 25 && humi_var.value < 80 )
e = d;
return e;

Script_Desumidificador

EmTipo de Dado, escolha Binario. Em Script Context, escolha os datapoints Casa

Humidade e ento clique no cone para adicion-lo ao script. No campo Var, definiu-
se humi_var para a humidade.

No campo Script insira o seguinte cdigo :

57/70
if(humi_var.value > 80)
return true;
return false;

Script_Lareira

EmTipo de Dado, escolha Binario. Em Script Context, escolha os datapoints Casa

Temperatura e ento clique no cone para adicion-lo ao script. No campo Var,
definiu-se temp_var para a humidade.

No campo Script insira o seguinte cdigo :

if(temp_var.value < 10)

return true;
return false;

58/70
Script_Luz

EmTipo de Dado, escolha Binario. Em Script Context, escolha os datapoints Casa Sol e
ento clique no cone para adicion-lo ao script. No campo Var, definiu-se sol_var
para a humidade.

No campo Script insira o seguinte cdigo :

if(sol_var.value == false)
return true;
return false;

59/70
Script_Ventilador

EmTipo de Dado, escolha Binario. Em Script Context, escolha os datapoints Casa

Temperatura e ento clique no cone para adicion-lo ao script. No campo Var,
definiu-se temp_var para a humidade.

No campo Script insira o seguinte cdigo :

if(temp_var.value > 25 )
return true;
return false;

60/70
6.4. Criando Point Links

Depois de inseridos os Data Points e os Scripts vamos inserir os Point Links. Eles iro
fazer a ligao entre a sada do Script com o Data Point em que se quer atuar. Assim,
a entrada do Point Link o Script e a sada o Data Point desejado.
Foram adicionados 5 Point Links, 1 para cada Script, como por exemplo, para Clima e
Script_Clima:

OBS : Em todos os Point Links no campo Script adicionado :

return source.value;

Depois de todos adicionados a pgina de Point Links fica assim :

Pronto, agora basta verificar o funcionamento na Watch List. Verifique que com a
mudana dos estados de alguns Data Points outros so alterados.

61/70
7. Watchdog

7.1. Como funciona

O watchdog verificar periodicamente o status do ScadaBR por meio do mtodo

getStatus de sua API SOAP. Caso o ststus indique alguma falha, o sistema reiniciar o
Tomcat a fim de corrigi-la.
O watchdog finalizar aps um nmero especificado de tentativas consecutivas de
reiniciar o Tomcat.
Obs.: Caso o sistema operacional da mquina seja Microsoft Windows, necessrio
definir a varivel de ambiente CATALINA_HOME, que aponta para o diretrio onde se
encontra o ScadaBR. Por exemplo, se o ScadaBR estiver instalado no diretrio
C:\Arquivo de Programas\ScadaBR, a varivel CATALINA_HOME seria definida
como:
set CATALINA_HOME=C:\\Arquiv~1\\ScadaBR

7.2. Configurao

Para configurar o watchdog, edite o arquivo config.properties. Todas as configuraes

possuem valores padro que sero utilizados caso o arquivo ou o parmetro em questo
no seja especificado.
1. Configure o watchdog no arquivo config.properties. Todas as configuraes possuem
valores padro que sero utilizados caso o arquivo ou o parmetro em questo no seja
especificado.
api.address: Endereo da API do ScadaBR.
catalina.home: Pasta base da instalao do Tomcat onde roda o ScadaBR. Caso
no seja fornecido, o watchdog utilizar a varivel de ambiente
CATALINA_HOME (caso esteja definida).
watchdog.period: Perodo em segundos em que o watchdog verificar o status
do ScadaBR. Seu valor mnimo de 30 segundos e seu valor padro de 60
segundos.
watchdog.retries: Nmero mximo de tentativas consecutivas com que o
watchdog reiniciar o Tomcat a fim de recuperar o ScadaBR.

62/70
 watchdog.fileLogging: para habilitar ou desabilitar o log em arquivo (log.txt).

7.3. Como executar

Caso tenha instalado no diretrio padro do ScadaBR no necessrio editar o

config.properties (arquivo de configurao do watchdog).
Caso tenha instaldo em outro diretrio por favor edite o arquivo config.properties com a
seguinte mudana:
Mude o caminho da catalina.home com o local onde foi instalado o ScadaBR:
Exemplo do caminho para diretrio padro:
catalina.home=C:\\ScadaBR
IMPORTANTE : No esquea de deixar duas "backslashes" entre os nomes do endereo!
Para iniciar o watchdog abra um prompt de comando na pasta onde foi instalado o
ScadaBR e digite:
java -jar watchdog

IMPORTANTE:
- Em Windows, nunca esquea de deixar duas "backslashes" entre os nomes do
endereo:
- Usar CATALINA_HOME sem espaos
- Usar JAVA_HOME sem espaos

63/70
8. Dicas
8.1. Como alterar o banco de dados?

O ScadaBR atualmente suporta dois sistemas gerenciadores de banco de dados: MySQL

e Derby.
O arquivo ScadaBR.war vem por padro configurado com o Derby por questes de
facilidade para o usurio, pois o mesmo roda embarcado e no exige a instalao do
SGBD ou a configurao de parmetros como login e senha.
A alterao dos dados referentes ao banco utilizado prevista para ser realizada durante
a "construo" (building) do sistema, porm, caso seja necessrio, pode-se alter-las de
uma outra maneira a partir do arquivo war disponibilizado:

Descompactar o arquivo ScadaBR.war para um diretrio qualquer <scadabr>. (pode-se

renomear o arquivo para ScadaBR.zip e ento extra-lo, caso desejado).
Abra com um editor de texto o arquivo:
<scadabr>/WEB-INF/classes/env.properties e o edite conforme desejado:

MySQL*:
db.type=mysql
db.url=jdbc:mysql://localhost/scadabr
db.username=root
db.password=
db.pool.maxActive=10
db.pool.maxIdle=10

* Ateno: para utilizar o MySQL, um banco com o nome "scadabr" deve ser criado
antes de iniciar o ScadaBR. (apenas o banco, as tabelas so criadas automaticamente
pelo sistema)

Derby (padro):
db.type=derby
db.url=<pasta_do_bd>**

64/70
db.username=
db.password=

** A pasta onde ficar o banco de dados. Pode ser um caminho relativo, como:
../scadabrDB/.

Salve o arquivo, compacte toda a pasta <scadabr> novamente em um arquivo

ScadaBR.war e realize a instalao.

65/70
9. Glossrio
A
A&E - "Alarms and Events" - Alarmes e Eventos.
Alarmes - Ocorrncias, usualmente assncronas, de uma medio com valor fora
de limites pr-estabelecidos, ou eventos que necessitem ateno de um operador
(por exemplo, visualizar e "reconhecer" o alarme). Alarmes usualmente possuem
um grau de criticidade associado, por exemplo de "0 = warning" at "5 = critical
alert"
API - Application Programming Interface, um conjunto de especificaes que
permite que diferentes softwares (ou diferentes mdulos de um software)
comuniquem-se entre si.
B
Batch - Conhecido tambm como Receita ou Batelada, uma seqncia de aes
a serem executadas sequencialmente para obter um determinado resultado em
processo de manufatura. Por exemplo: uma receita de produto qumico
especificando passos de reaes, destilao, enchimento e esvaziamento de
tanques etc. Nesse caso, cada "composto" ou volume de produo diferente
possui uma receita diferente.
Builder - ver HMI Builder
C
Configurador - no contexto de sistemas SCADA estamos chamando de
"configurador" a um aplicativo, com interface de usurio (no apenas arquivos de
configurao), que permite definir parmetros de comunicao dos protocolos,
configuraes de "tags", perodos de amostragem dos registradores e assim por
diante.
Custom App (ou aplicao personalizada) - qualquer aplicativo externo ao
SCADA que comunique-se com o mesmo obtendo dados ou enviando comandos
atravs de uma API padronizada. Por exemplo, uma nova HMI, um historian
avanado, ou alguma aplicao de terceiros como um ERP, BI (Business
Intelligence) e assim por diante.

D
DA - Data Access - nome comum que se d leitura de tags ou envio de
comandos. "DA" usualmente ocorre em alto nvel, em contraste com o IO que

66/70
 ocorre em baixo nvel; desta forma, o DA referencia variveis fsicas atravs do
nome da TAG, e no em termos de registradores ou endereamento de
barramentos.
DA Server - Software que traduz as solicitaes de alto nvel em requisies
para os drivers de protocolos; o DA server pode ter funes adicionais como
"cache" (manter o ltimo valor em memria) ou "buffer" (permitindo IO no-
bloqueante pelo gerenciamento de filas de alta velocidade, por exemplo).
Datalogger - Registrador de dados, produz "time-series" a serem registradas em
um sistema como SGBD (banco de dados).
Driver - Componente de software que implementa um protocolo de comunicao,
devendo estar compatvel com a API de desenvolvimento definida para o DA
Server.
E
Eventos - so ocorrncias na planta supervisonada que no necessariamente
representam um valor numrico, ocorrendo de maneira assncrona e
"empurrada", ou seja, partindo da dos dispositivos em direo ao software que os
supervisiona. Exemplos de eventos seriam "incio de operao do estgio 1 do
motor", "operao em regime permanente atingida", "rel de proteo XYZ-14
acionado". Eventos diferem-se de alarmes no sentido de no possuirem uma
criticidade associada, nem de exigir uma ao do operador.
EPA - Enhanced Performance Architecture.
F
G
H
HDA - History Data Access, conjunto de funcionalidades relacionadas anlise de
dados registrados. Usualmente refere-se a uma API HDA como sendo um
conjunto de mtodos padronizados para se extrair sries temporais, informando-
se o nome da tag desejada, o perodo de incio e o perodo de fim; tambm pode
oferecer funcionalidades como extrao de mximas/mnimas, mdias e assim
por diante.
Historian - Software capaz de trabalhar com grandes volumes de dados,
atuando como um datalogger avanado com caractersticas como compresso de
dados, armazenamento por deadband etc.

67/70
 HMI - Human Machine Interface, interface de operador onde se pode visualizar
os dados atravs de indicadores grficos ou numricos, e tambm enviar
comandos para os equipamentos como alterar um set-point, por exemplo.
HMI Builder - Interface de desenvolvimento onde um integrador de sistemas
pode desenvolver graficamente (no estilo "wysiwyg") as telas da HMI,
adicionando componentes como indicadores, grficos (plot) e botes de comando.
I
IDE - Integrated Development Environment, um ambiente de desenvolvimento
(similar ao Visual Studio ou Eclipse, por exemplo) onde um integrador de
sistemas encontra tanto funcionalidades de HMI Builder como funcionalidades de
Configurador, permitindo desenvolver todos os aspectos de uma aplicao SCADA
completa.
IEC - International Electrotechnical Commission.
I/O - Input/Output ou Entrada e Sada. Utilizamos esse termo para identificar
operaes de comunicao em baixo nvel, ou no nvel dos protocolos (como
Modbus, Profibus, Fieldbus etc.) No nvel de I/O so importantes as definies
peculiares de cada protocolo, como representao fsica do dado (inteiro, double,
byte[]), taxas de comunicao (baud rate), identificador de porta ou
endereamento de rede, ao contrrio da camada DA que "abstrai" essas
informaes.
J
K
L
M
Mdulo - Um mdulo do ScadaBR ser o nome dado a um componente de
software que tenha uma funo "macro" bem delimitada, como por exemplo:
Mdulo de Histricos, Mdulo de Alarmes, Mdulo de Batch & Scripting e assim
por diante, comunicando-se com o restante do sistema atravs do Middleware
ScadaBR.
Mdulo de Processamento - um componente de software capaz de processar
grandes volumes de informao e gerar novos resultados a partir deles, por
exemplo: calcular a mdia entre duas temperaturas gerando uma "terceira"
temperatura, ou identificar padres de comportamento (formas de onda
especficas, por exemplo) e executar um processo externo.

68/70
 Middleware - conjunto de especificaes ou softwares dedicados especialmente
funo de Interoperabilidade, ou seja, comunicao entre diversos
componentes de software.
Middleware ScadaBR - conjunto de API's para comunicao nos contextos de
DA, HDA e A&E, permitindo que diferentes mdulos do ScadaBR comuniquem-se
entre si e/ou com softwares externos. O Middleware ScadaBR deve "abstrair"
questes de baixo nvel (I/O), sistema operacional ou linguagem de programao,
sendo o mais "neutro" possvel.
N
O
OPC - OLE for Process Control, middleware padro da automao industrial
largamente adotado em indstrias do mundo inteiro; possui APIs DA, HDA, A&E
e outras, implementadas sobre tecnologia DCOM da microsoft. Possui um modelo
de dados que descreve componentes e operaes comuns no ambiente de
manufatura.
OSI - Open System Interconnection.
P
Protocolo - Padronizao de comunicao especificando camada fsica,
transporte, modelo de dados e formato dos pacotes na comunicao entre
equipamentos e o PC onde roda o software SCADA.
Poll - Formato de comunicao do tipo "request-response" onde cada novo dado
solicitado pelo consumidor.
Push - Formato de dados empurrado onde o produtor envia os dados
sequencialmente (de maneira sncrona ou assncrona) para o consumidor.
Q
R
Real-Time - Requisitos de tempo-real, referem-se ao fato de que pode haver
exigncia que determinada operao de comunicao ou processamento ocorra
em uma fatia de tempo determinstica, no tolerando atrasos.
S
SCADA - Supervisory Control and Data Acquisition.
Scripting -Capacidade de inserir lgicas computacionais no SCADA, atuando em
determinadas tags com base no valor de outras. Por exemplo, "se nvel do tanque
acima de 3 metros, abrir vlvula em 70%". Usualmente os scripts so definidos

69/70
 em linguagens interpretadas de alto nvel (como basic, javascript), ou linguagens
grficas padronizadas para o ambiente industrial (como ladder, grafcet)
T
Tag - varivel do sistema supervisionado. Uma tag tem um nome (identificador
exclusivo em todo o sistema) pelo qual referenciado a partir de todos os
mdulos, "escondendo" detalhes de baixo nvel referentes ao protocolo ou
dispositivo. Exemplos de Tags seriam "temperatura1", "tensao_alternador",
"nivel_tanque_A" e assim por diante. Tags podem ser "lidas" (obter ltimo valor
com timestamp) ou "escritas" (enviar comando ou set-point para equipamentos).
Tags podem implementar diversos tipos de dados como numrico inteiro, ponto-
flutuante, string, booleano on/off, binrio 8-bits, 16-bits e assim por diante.
Tempo-Real - ver Real-Time
U
V
W
X
Y
Z

70/70