Escolar Documentos
Profissional Documentos
Cultura Documentos
Manual ScadaBR PDF
Manual ScadaBR PDF
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
.
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.
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
10/70
11/70
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
<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
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
16/70
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
19/70
Para:
20/70
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
22/70
Navegue at o cone adicionado sobre a figura e clique sobre a segunda opo: Editar
configuraes de componente de ponto.
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
Modbus 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
27/70
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.
30/70
31/70
32/70
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
abre uma nova janela do navegador
softwares de planilha eletrnica. O cone
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.
34/70
35/70
Agora, criamos uma nova Connection, basta clicar no cone + ao lado de Edit Security
36/70
37/70
38/70
Clique em OK.
A segunda para pegar os dados dos usurios do sistema ScadaBR:
39/70
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
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
43/70
Page Footer
Nessa parte adicionamos um label.
Para visualizar um preview do relatrio, clique no cone destacado com um X.
44/70
45/70
Clique em New.
Escolha a opo Database JDBC connection.
46/70
47/70
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.
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.
50/70
51/70
52/70
53/70
54/70
55/70
Script_Clima
=
=
=
=
=
"Clima
"Clima
"Clima
"Clima
"Clima
Quente e Hmido";
Quente e Seco";
Frio e Hmido";
Frio e Seco";
Atual";
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
57/70
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
60/70
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
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
67/70
68/70
69/70
70/70