Genies, Supergenies e Dispositivos

Prévia do material em texto

Capítulo 8: Páginas de Popup e Super Genies 
 
Vista Geral 
 
 
Introdução As páginas de popup e os super genies são páginas dinâmicas que você pode 
utilizar para passar informações quando as páginas são exibidas durante o modo 
de execução (runtime). Você pode utilizá- las como controladores do tipo pop-up 
ou como equipamentos isolados da planta. E é possível reutilizar a mesma página 
com um outro conjunto de tags. Por exemplo, você pode configurar uma página 
gráfica com diversas bombas, e então usar um super genie como controlador tipo 
pop-up para cada uma das bombas da página. Na maioria dos casos em que uma 
página de popup for utilizada, ela estará associada a um genie. 
 
 
Índice Este capítulo contém os tópicos abaixo: 
 
Tópico Página 
Ø Criando Páginas de Popup 
Ø Chamando Páginas de Popup a partir dos Símbolos 
Ø Chamando Páginas de Popup a partir dos Genies 
Ø Criando Super Genies 
8-2 
8-8 
8-9 
8-11 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-1 
 
Criando Páginas de Popup 
 
 
As páginas de popup e os super genies são páginas dinâmicas que você pode 
utilizar para passar informações quando a página for exibida no modo de 
execução (runtime). Entretanto, se você for um integrador e trabalhar com muitos 
sites diferentes, é possível salvar um arquivo Super Genie com extensão *.ctm e 
copiá-lo com facilidade para outros projetos. 
 
 
Antes de mais nada, crie e salve uma página em branco. Esta página pode estar 
anexada a um genie ou pode ser chamada diretamente de uma página. Em um 
caso ou no outro, será preciso usar uma função de super genie para abrir a página 
de popup durante o modo de execução (runtime). 
 
 
Existem diversas funções que podem ser utilizadas para chamar e modificar um 
super genie (consulte o Citect Help Topics » Index - Super Genies: Cicode Functions). 
Essas funções podem ser usadas a partir de páginas ou de genies para abrir e 
modificar uma página de super genie durante o modo de execução (runtime), e 
muitas delas podem conter uma lista de nomes de tag que devem ser passados 
para o super genie. 
 
Exemplo – 
 
A função, 
 
AssPopUp(“sgPage”,”Tag1”,”Tag2”,”Tag3”) 
 
chama a página de super genie sgPage e associa três tags à página. A ordem dos 
tags aqui será a ordem pela qual eles serão referenciados na página de super genie 
usando sintaxe de genie. 
 
Treinamento Adicional: 
Técnicas Avançadas de Supergenies e de páginas de Popup serão abordadas de 
maneira detalhada Curso de Conceitos Avançados de Configuração 
CitectHMI/SCADA. 
 
 
 
 
 
 
 
 
 
 
8-2 
Super Genies e 
Páginas Popup 
– Qual é a 
Diferença? 
 
Criando uma 
Página Popup 
 
Funções Super 
Genie 
 
Criando Páginas de Popup, Continuação 
 
 
É possível substituir nomes de tags, durante o modo de execução (runtime), por 
uma série de nomes substitutos com a sintaxe abaixo: 
 
?type number? 
 
onde number é a posição do tag na lista existente na função super genie que foi 
chamada para abrir a página de super genie. Não é rigorosamente necessário usar 
tipo na sintaxe de supergenie. Entretanto, se você desejar usar, trata-se do tipo de 
dado do tag (por ex.: string, int, real ou digital). 
 
Exemplo – 
 
No exemplo anterior de AssPopUp(), se os tags fossem, respectivamente, uma 
string, um inteiro e digital, então eles poderiam ser referenciados em qualquer 
lugar do super genie como: 
 
?string 1? Strings devem ter o tipo definido 
?int 2? ou ?2? 
?digital 3? ou ?3? 
 
 
Se uma função de super genie tal como AssPopUp() for usada em um genie, então 
uma parte ou todos os nomes de tag passados podem ser especificados como 
substitutos de genies. A vantagem é que, se todos os tags de um projeto seguem 
uma mesma convenção de nomes, então somente uma parte do nome precisará ser 
passada para o genie. 
 
Exemplo – 
 
A função abaixo associa os dois tags Pump1_Valve1 e Pump1_Valve2 à página de 
super genie sgPage: 
 
AssPopUp(“sgPage”,”Pump1_Valve1”,”Pump1_Valve2”); 
 
Esta função pode ser substituída por: 
 
AssPopUp(“sgPage”,”%Pump%_Valve1”,”%Pump%_Valve2”); 
 
e, quando o genie for colado em uma página gráfica, o CitectHMI/SCADA só vai 
pedir o nome da bomba, que será Pump1. Este genie passará a funcionar com 
todas as bombas que tenham um critério de atribuição de nomes de tag que siga 
aquele da bomba 1. 
 
 
 
 
8-3 
Sintaxe de 
Super Genie 
Nomes 
Estruturados 
de Tags 
 
Criando Páginas de Popup, Continuação 
 
 
Exercício 8-1 Vamos agora criar uma página de popup para abrir e fechar as válvulas da página 
do Pasteurizador. 
 
Passo Ação 
1 Criar uma página de popup nova conforme indicado, chamada 
!Válvula que possa ser utilizada para abrir e fechar qualquer 
válvula. 
 
 
 
i. Clique no botão New no Citect Graphics Builder. 
 
2 Clique no botão Page, quando a janela abaixo for exibida: 
 
 
 
 
 
 
 
 
 
8-4 
Criando Páginas de Popup, Continuação 
 
 
Exercício 8-1 (continuação) 
 
Passo Ação 
2 
(cont.) 
i. Escolha a template de página blank quando o padrão 
abaixo for exibido. 
 
 
 
ii. Desenhe os três botões perto do canto superior esquerdo 
da página, com as propriedades abaixo: 
 
Appearance 
(General) 
Text/Symbol 
Input (Touch) 
Up Command 
Access(General) 
Tool Tip 
ABRIR ?1?=1 Botão ABRIR 
FECHAR ?1?=0 Botão FECHAR 
CSV_icons_ 
disabled_01_xp 
WinFree() Fechar Janela 
 
 
Nota: O super genie acima tem apenas uma substituição (que 
aparece entre as interrogações ?number?) para um tag 
digital, que é utilizado em mais de um lugar no super genie. 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-5 
Criando Páginas de Popup, Continuação 
 
 
Exercício 8-1 (continuação) 
 
Passo Ação 
2 
(cont.) 
iii. Desenhe os dois símbolos de lâmpadas usando a 
ferramenta Symbol Set. Ajuste as propriedades 
conforme abaixo: 
 
Object ON symbol 
when 
Symbols 
Indicação 
Aberto 
?1?=1 OFF lights_square_medium.grey 
ON lights_square_medium.green 
Indicação 
Fechado 
?1?=0 OFF lights_square_medium.grey 
ON lights_square_medium.green 
 
 
3 Exercício Opcional 
 
i. Desenhe um retângulo preenchido na parte superior da 
página para ser a barra de título. 
 
ii. Acrescente este símbolo na barra de título. 
 
Símbolo Input (Touch) 
Up Command 
Access 
(General) 
Tool Tip 
ces_system. 
close_button 
CSV_Nav_CloseWindow() Fecha 
 
 
4 Continue com a configuração do popup. 
i. Posicione o ponteiro no canto inferior direito dos botões. 
Isto é para indicar o tamanho necessário para a página 
de popup. 
 
ii. A barra de status na parte de baixo da tela vai mostrar a 
posição do ponteiro a partir do canto superior esquerdo 
da página. 
 
 
 
 
 
 
 
 
8-6 
Criando Páginas de Popup, Continuação 
 
 
Exercício 8-1 (continuação) 
 
Passo Ação 
4 
(cont.) 
iii. Vá à guia File » Properties » Appearance e digite o 
tamanho do retângulo em Width e Height. Isto definirá 
o tamanho da página de popup. Se você quiser, é 
possível também alterar aqui a Cor de fundo da página. 
 
 
 
iv. Clique no botão Salvar e salve a página com o nome 
!Válvula. 
 
Nota: A colocação de um ponto de exclamação (!) no início 
do nome da página significa que a página não pode ser 
escolhida a partir da janela Select Page do Pagemenu no 
modo de execução ( runtime). Ver PageSelect() no Help. 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-7 
Chamando Páginas de Popup a Partir dos Símbolos 
 
 
Exercício 8-2 Use a página de popup que você acaba de criar e anexe-a a um símbolo existente. 
 
Passo Ação 
1 Chame a página !Valvula a partir de um símbolo existente. 
i. Vá até a página do Pasteurizador e abra as propriedades 
da Válvula de Refrigeração 
 
ii. Adicione as propriedades abaixo ao símbolo. 
 
Input (Touch) 
Up Command 
AssWin("!Valvula",145,330,1+8+512,
"VALVE_Cool_CMD") 
Tool Tip ABRE/FECHA Válvula de Refrigeração 
 
 
Nota: O nome do tag nesta função deve ser inserido entre 
parênteses “ ”. Se não estiver entre parênteses, então é o valor 
do tag que é passado para a função e não o nome do tag. 
 
2 Salvea página. 
3 Compile e rode o projeto e teste as suas modificações. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-8 
Chamando Páginas de Popup a Partir de Genies 
 
 
Exercício 8-3 Crie um genie para chamar a página de popup 
 
Passo Ação 
1 Crie um genie chamado ControleValvula com um botão para 
chamar a página !Valvula. 
i. Clique no botão New no Citect Graphics Builder. 
 
ii. Clique no botão Genie.Uma página em branco será 
exibida, com um Ponto Localizador de Genie. 
 
iii. Desenhe um botão perto do Localizador, com as 
seguintes propriedades: 
 
Text %Valvula%^nValve 
Input(Touch) 
Up Command 
AssWin("!Valvula",%OrigemX%, 
%OrigemY%,1+8+512, 
"VALVE_%Valvula%_CMD") 
Tool Tip ABRE/FECHA %Valvula% Valve 
 
iv. Vá até as propriedades Access (General) do botão. 
Desmarque a caixa perto de No privilege restrictions e 
digite %PRIVILEGIO% no campo Privilege level. 
Usaremos esta propriedade em um capítulo posterior 
para ver segurança em modo de execução (runtime). 
 
v. Vá até a guia Access (Disable). Marque a caixa 
Disable on insufficient area or privilege. Escolha 
Hidden no Disable Style. 
 
vi. Clique em Save e salve o genie com o nome 
ControleValvula na biblioteca treinamento do seu 
projeto Tratamento_Leite. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-9 
Chamando Páginas de Popup a Partir de Genies, Continuação 
 
 
Exercício 8-3 (continuação) 
 
Passo Ação 
2 Cole o genie ControleValvula na sua página do Pasteurizador, 
perto das válvulas. 
i. Preencha os campos do genie conforme indicado abaixo 
(deixe o campo PRIVILEGIO em branco, por enquanto): 
 
Object Origem X Origem Y Válvula 
Válvula 
Refrigeração 
145 330 Cool 
Válvula Água 
Quente 
660 160 HW 
Válvula Vazão 360 160 Flow 
 
ii. Você precisará alterar as coordenadas da Origem X e 
Origem Y para a sua própria página. 
 
 
3 Compile e rode o projeto, e teste as suas modificações. 
4 Feche o projeto. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-10 
Criando Super Genies 
 
 
Exercício Crie um super genie para abrir e fechar as válvulas da página do 
Avançado Pasteurizador. 
 
Passo Ação 
1 Crie uma página de super genie nova conforme indicado 
abaixo, chamada “!AdValvula”, que será usada para abrir e 
fechar qualquer válvula. 
 
i. Clique no botão New no Citect Graphics Builder. 
 
ii. Clique no botão Super Genie quando a janela a seguir 
for exibida: 
 
 
 
Será exibida, no canto superior esquerdo, uma página 
vazia limitada por uma linha pontilhada – esta é a área que 
estará visível quando o super genie for mostrado. 
 
Nota: Uma nova página de super genie terá os pontos de 
animação An1 e An2 já colocados. An1 é onde a entrada de 
teclado ecoará, e An2 é onde a informação de prompt é 
exibida. Esses Pontos de Animação não devem ser 
apagados. 
 
iii. Mova An1 e An2 para fora da área limitada pela linha 
pontilhada. Não precisamos deles no nosso super 
genie, mas vamos deixá-los definidos, de modo que 
não possamos criar acidentalmente objetos novos com 
nenhum desses dois números de animação. 
 
8-11 
Criando Super Genies, Continuação 
 
 
Exercício Avançado (Opcional) (continuação) 
 
Passo Ação 
1 
(cont.) 
iv. Abra a página de popup !Valvula. Selecione e copie os 
objetos da página. 
 
v. Volte à página do super genie e cole os objetos. Mova 
os objetos para o canto superior esquerdo da página. 
 
vi. Vá até as propriedades do super genie, selecionando o 
menu File » Properties. Na propriedade Appearance, 
mude a View Area para um tamanho que seja 
adequado à sua página. 
 
vii. Clique em OK. 
 
viii. Clique no botão Save e salve o super genie com o 
nome !AdValvula na biblioteca Treinamento do seu 
projeto Tratamento_Leite. 
 
2 Crie um genie chamado AdControleValvula com um botão para 
chamar o super genie !AdValvula. 
i. Clique no botão New no Citect Graphics Builder. 
 
ii. Clique no botão Genie.Uma página em branco será 
exibida, com um Ponto Localizador de Genie. 
 
iii. Desenhe um botão perto do ponto Localizador, com as 
seguintes propriedades: 
 
 
 
 
 
 
 
 
 
Dicas e Toques: 
Procure no Citect Help Topics pela função AssWin(), para descobrir 
quais parâmetros podem ser passados para esta função. 
 
 
 
 
 
 
 
8-12 
Text %Valvula%^nValvula 
Input (Touch) 
Up Command 
AssWin("!AdValvula",%OrigemX%, 
%OrigemY%,1+8+512, 
"VALVE_%Valvula%_CMD"); 
WinTitle(“%Valvula% Valvula”) 
Tool Tip ABRE/FECHA %Valvula% 
 
Criando Super Genies, Continuação 
 
 
Exercício Avançado (Opcional) (continuação) 
 
Passo Ação 
2 
(cont.) 
iv. Vá até as propriedades Access (General) do botão. 
Desmarque a caixa perto de No privilege restrictions e 
digite %PRIVILEGIO% no campo Privilege level. 
Usaremos esta propriedade em um capítulo posterior 
sobre segurança em modo de execução (runtime). 
 
v. Selecione Edit » Attach Super Genies… no menu. Vai 
aparecer a janela abaixo: 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-13 
Criando Super Genies, Continuação 
 
 
Exercício Avançado (Opcional) (continuação) 
 
Passo Ação 
2 
(cont.) 
vi. Clique em Add para selecionar o seu super genie 
!AdValvula na biblioteca de treinamento: 
 
 
 
vii. A janela Attach Super Genies deve ter a seguinte 
aparência: 
 
 
 
Clique em OK. 
 
viii. Clique em Save e salve o genie com o nome de 
AdControleValvula na biblioteca de treinamento do 
seu projeto Tratamento_Leite. 
 
 
 
8-14 
Criando Super Genies, Continuação 
 
 
Exercício Avançado (Opcional) (continuação) 
 
Passo Ação 
3 Cole o genie ControleValvula na sua página do Pasteurizador, 
perto da Válvula de Refrigeração, Válvula de Água Quente e 
Válvula de Fluxo. Preencha os campos do genie conforme 
indicado abaixo (deixe o campo PRIVILEGIO em branco por 
enquanto): 
 
Objeto Valvula OrigemX OrigemY 
Válvula de 
Refrigeração 
Cool 160 320 
Válvula de 
Água Quente 
HW 730 180 
Válvula de 
Fluxo 
Flow 380 160 
 
 
4 Compile e rode o projeto e teste as suas modificações. 
5 Feche o projeto. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8-15 
 
Capítulo 9: Dispositivos 
 
Vista Geral 
 
 
Introdução Um Dispositivo é um utilitário que transfere dados de alto nível (tais como um 
relatório, um registro de comando ou um registro de alarme) entre o 
CitectHMI/SCADA e outros elementos (tais como uma impressora, uma base de 
dados, um arquivo RTF ou um arquivo ASCII) no seu sistema 
CitectHMI/SCADA. 
Os Dispositivos são semelhantes aos Dispositivos de I/O, na medida em que 
ambos permitem ao CitectHMI/SCADA trocar dados com outros componentes no 
seu sistema de controle e monitoração. 
 
 
Índice Este capítulo contém os seguintes tópicos: 
 
Tópico Página 
Ø O que são Dispositivos? 
Ø Configurando Dispositivos 
Ø Usando os Arquivos Históricos do Dispositivo 
Ø Configuração de um Dispositivo 
9-2 
9-4 
9-5 
9-7 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9-1 
O que São Dispositivos? 
 
 
Vista Geral Você pode utilizar Dispositivos para uma série de propósitos, por exemplo, para 
enviar um relatório para uma impressora, ou para escrever em uma base de dados. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9-2 
 
O que São Dispositivos? Continuação 
 
 
Vista Geral 
Ø Com a utilização de um Dispositivo, você pode escrever dados em: 
 
• Arquivos RTF 
• Arquivos ASCII 
• Bases de Dados dBASE 
• Bases de Dados SQL (através de drivers compatíveis com ODBC) 
• Impressoras (conectadas ao seu computador ou em uma rede) 
 
Ø Com a utilização de um Dispositivo (e funções cicode), você também 
consegue ler dados de: 
 
• Arquivos ASCII 
• Bases de Dados dBASE 
• Bases de Dados SQL 
 
Você consegue configurar uma quantidade qualquer de Dispositivos, embora 
um Dispositivo seja um recurso comum. Você pode, por exemplo, configurar 
um único Dispositivo que envie a saída de todos os seus relatórios 
CitectHMI/SCADA para uma mesma impressora (quando eles são solicitados). 
 
 
 
9-3 
Configurando Dispositivos 
 
 
VistaGeral Cada dispositivo do CitectHMI/SCADA tem um registro separado que define o 
formato dos dados transferidos para ou do dispositivo, e o nome do dispositivo. 
 
Como Fazer 
Ø Para Definir um Dispositivo: 
 
No Citect Explorer, abra a pasta System no projeto selecionado e clique duas 
vezes no ícone Devices : 
 
ou 
 
No Citect Project Editor, selecione o menu System » Devices 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9-4 
Usando Arquivos Históricos do Dispositivo 
 
 
Vista Geral Se você usar um dispositivo para gravar dados em um arquivo para armazenagem 
de longo prazo, você deve especificar o número de arquivos históricos do 
dispositivo. O CitectHMI/SCADA usa um sistema de arquivos históricos rotativos 
para armazenar dados históricos. Os dados são armazenados em diversos 
arquivos, conforme ilustrado na figura abaixo: 
 
 
 
 
Por default, o CitectHMI/SCADA usa 10 arquivos (caso os arquivos históricos 
tenham sido especificados). É possível mudar o default, bastando especificar o 
número de arquivos que serão usados. Você pode também especificar o período 
entre os arquivos (isto é, quando um arquivo histórico novo será usado), bem 
como em que horário deve ser feita a sincronia dos arquivos históricos. 
 
 
9-5 
 
Usando Arquivos Históricos do Dispositivo, Continuação 
 
 
Vista Geral Exemplo – 
(continuação) 
Para os ajustes abaixo: 
 
Hora 6:00:00 
Período Segunda-feira 
 
O CitectHMI/SCADA vai criar um arquivo novo toda Segunda-feira, às 6 horas 
da manhã. Se você iniciar o seu runtime às 7:30 da manhã no Domingo, o seu 
primeiro arquivo vai conter 22,5 horas de dados. 
 
Nota: Se você quiser arquivar os seus dados para armazenagem de longo prazo, 
você deve fazer o backup dos arquivos históricos antes que eles sejam 
sobrescritos. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9-6 
Configuração de um Dispositivo 
 
 
Exercício 9-1 Entradas de mouse ou de teclado podem disparar uma mensagem a ser enviada a 
um dispositivo de registro através do CitectHMI/SCADA MsgLog. O dispositivo 
de registro deve também ser definido com MsgLog como um dos campos de 
formato. Neste exercício, vamos configurar um registro de entrada de teclado para 
algumas válvulas na página do Pasteurizador. 
 
Passo Ação 
1 Defina um dispositivo de texto chamado CommandLog para 
registrar comandos provenientes do CitectHMI/SCADA Message 
Log. 
i. No Citect Project Editor, selecione System » Devices 
no menu. O formulário de dispositivos vai aparecer 
conforme mostrado abaixo: 
 
 
 
 
Dicas e Toques 
Se já houver dispositivos definidos, basta selecionar um e 
modificá-lo. 
Ao terminar, clique em Add para criar um registro novo. 
 
 
 
 
 
 
 
 
 
 
 
9-7 
Configuração de um Dispositivo, Continuação 
 
 
Exercício 9-1 (continuação) 
 
Passo Ação 
1 
(cont.) 
Defina um dispositivo de texto chamado CommandLog para 
registrar comandos provenientes do CitectHMI/SCADA Message 
Log. 
ii. Preencha a definição do dispositivo com as 
propriedades abaixo: 
 
Name LogComandos 
Format {Date,10} {Time,5} {MsgLog,32} 
File Name [DATA]:Com_Log.txt 
Type ASCII_DEV 
No. Files -1 
Comment Arquivo de registro de 
comandos do operador 
 
 
Dicas e Toques 
O ajuste do No. Files em –1 cria um arquivo que receberá todos 
os dados. O ajuste do No. Files em 1 sobrescreve aquele 
arquivo no período e hora default, que é domingo à meia-noite. 
 
O diretório [DATA]: é especificado pelo parâmetro Data (ver os 
Tópicos de Ajuda Citect - CtEdit Data Parameter) 
 
2 Edite o objeto Válvula de Refrigeração na página do 
Pasteurizador, e adicione um comando de registro (log) 
adequado para quando a posição da válvula tiver sido mudada. 
i. Clique duas vezes na Válvula de Refrigeração e vá 
até as propriedades Access (General) e ajuste o Log 
device: 
 
Log Device LogComandos 
 
ii. Em seguida, vá até as propriedades Input (Keyboard 
Commands) e selecione a seqüência de teclas Toggle. 
Ajuste a Log message conforme abaixo: 
 
Log Message VÁLVULA DE REFRIGERAÇÃO 
aberta ou fechada 
 
iii. Salve a sua página. 
 
 
 
 
 
9-8 
Configuração de um Dispositivo, Continuação 
 
 
Exercício 9-1 (continuação) 
 
Passo Ação 
3 Repita a parte 2 deste exercício tanto para a Válvula de Água 
Quente quanto para a Válvula de Fluxo. 
4 Compile e rode o projeto e teste as suas modificações. 
5 Feche o projeto. 
6 Inicialize o Windows Explorer e abra a pasta \CitectSCADA\Data. 
Abra o arquivo Com_Log.txt usando Bloco de Notas, e confirme 
que seus comandos nas teclas estão sendo registradas 
corretamente. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9-9