Uso de PLC code display para monitoramento de lógica do PLC

Transcrição

1 WinCC V1X Uso de PLC code display para monitoramento de lógica do PLC Denilson Pegaia Objetivo: indicar os passos necessários para configurar o objeto PLC code display no WinCC Professional V1X de modo a visualizar a lógica do PLC. Aviso: Este documento apresenta dicas e exemplos sobre o produto e supõe que o leitor possua conhecimento básico prévio sobre o mesmo. Para informações completas e atualizadas, deve-se consultar o manual do produto. O intuito deste texto é meramente didático, podendo ser alterado pela Siemens sem aviso prévio. Os exemplos devem ser adaptados ao uso final e exaustivamente testados antes de utilizados em projetos reais. Índice 1. Introdução Procedimento de configuração Referências Suporte técnico e treinamento Introdução A partir da versão 13 do WinCC Professional Runtime, está disponível o objeto PLC code display. Este objeto permite que se visualize a lógica do PLC online em aplicações de WinCC Professional Runtime sem a necessidade do software de configuração do PLC (STEP 7). 24/01/2017 Página 1 / 19

2 Configuração Na janela de inspeção é possível fazer algumas configurações básicas, como estilos e cores. Visualização da lógica do PLC O objeto PLC code display permite que se visualizem lógicas do PLC feitas em linguagem de contatos (LAD) e blocos (FBD). É possível também ver lógicas sequencias (S7-GRAPH). Apenas um conjunto restrito de tipos de instruções pode ser visualizado pelo objeto PLC code display. A tabela a seguir indica estas instruções: Conjunto de instruções que podem ser visualizadas pelo objeto PLC code display Em linguagem de contatos (LAD) Contato normalmente aberto Contato normalmente fechado NOT SET RESET Atribuição de valor FLIP FLOP Em linguagem de blocos (FBD) AND OR OU Exclusivo NOT SET RESET Atribuição de valor FLIP FLOP A seleção de que parte da lógica do PLC será vai ser apresentada é determinada através de chamada de funções específicas (via C script): OpenViewerIECPLByAssigment: ajusta o objeto PLC code display para apresentar a parte da lógica que atribui valor a uma determinada variável, dentro de um bloco de programação. Se a variável recebe valores em mais de um ponto da lógica, será apresentado a primeira destas atribuições. Através dos botões do objeto é possível ao usuário navegar entre as diferentes atribuições. OpenViewerIECPLByCall: ajusta o objeto PLC code display para apresentar a parte da lógica que atribui valor a uma determinada entrada (pino) na chamada de um bloco. Notas O objeto "PLC Code Display" não pode ser usado em grupos ou faceplates. Após a alteração do programa do PLC é recomendado reiniciar a execução do WinCC runtime. 24/01/2017 Página 2 / 19

3 2. Procedimento de configuração. A configuração é feita nos seguintes passos: 1.1. Inserir o objeto na tela O objeto PLC code display está disponível no menu à direita ( Toolbox ) na divisão Controls : 1.2. Criar script A seleção de que parte da lógica do PLC vai ser apresentada é determinada através de chamada de funções específicas (via C script). Os scripts podem ser criados diretamente em objetos (por exemplo, no evento On Click de um botão), ou criados como funções / sub-rotinas para serem chamados nestes objetos, com passagem de parâmetros. A criação de scripts como funções / sub-rotinas, tem a vantagem de centralizar o algoritmo num único ponto, facilitando a manutenção e o desenvolvimento do projeto. Nos tópicos seguintes serão mostrados exemplos de funções / sub-rotinas Monitorando variável de saída O objetivo desta sub-rotina é criar um ambiente adequado e padronizado para a chamada da função OpenViewerIECPLByAssigment. Ao criar uma função / sub-rotina, podem-se especificar parâmetros que vão ser passados na chamada. Esta definição é feita na janela de inspeção. 24/01/2017 Página 3 / 19

4 Os parâmetros definidos neste exemplo são: ScreenName: string que descreve o nome da tela onde está o objeto PLC code display a ser endereçado. ObjectName: string que descreve o nome do objeto PLC code display a ser endereçado. CPUName: string que descreve o nome da CPU a ser acessada pelo objeto PLC code display. BlockName: string que descreve o nome do bloco a ser monitorado pelo objeto PLC code display. OperandName: string que descreve o nome da variável de saída que deverá ser monitorada. 24/01/2017 Página 4 / 19

5 Exemplo de script comentado Comentários iniciais: 0001 /* This fuction call OpenViewerIECPLByAssignment with correct eviroment / parameters OpenViewerIECPLByAssignment is used for the LAD and FBD languages by Code Viewer object It shows the assignment to an operator (program related to a "coil") */ 0009 Inclusão de definições padrão (default para aplicações com WinCC Professional): 0010 #include "GlobalDefinitions.h" // add standard deffinitions Definição do cabeçalho: sem variável de retorno (não é necessário), definição de variáveis a serem passadas para a rotina conforme propriedades definidas na janela de inspeção void C_OpenCodeViewer_Assig(char* ScreenName, char* ObjectName, char* CPUName, char* BlockName, char* OperandName) 0012 { 0013 Início da rotina: Inclusão de biblioteca própria para uso do objeto PLC code display 0014 // add libraries 0015 #pragma code("kopapi.dll") 0016 #include "kopapi.h" 0017 #pragma code() /01/2017 Página 5 / 19

6 Definição de variáveis internas: no geral, os parâmetros são copiados para variáveis internas por questão de organização. A variável error retorna informações de erro na chamada da função. A função OpenViewerIECPLByAssigment retorna 1 se houve erro em sua execução (a variável result coleta esta informação) // Variable definitions for fuction call 0020 char* pserverprefix = NULL; 0021 char* pcpuname = CPUName; // CPU's name to be monitored 0022 char* pcontainingblock = BlockName; // Block's name to be monitored //(OB, FC, DB, Instance DB) 0023 char* poperand = OperandName; // Operand's name to be monitored 0024 CMN_ERROR error; // Error description BOOL result; // 0 means that the fuction was executed without errors 0027 Chamada da função OpenViewerIECPLByAssigment: as variávies do cabeçalho são passadas para a função // function call 0029 result = OpenViewerIECPLByAssignment(0, // DWFLAGS: Bit array, 0 by default (i.e open TIA in online mode). KOPAPI_FLAG_TIAPORTAL_SUPPRE SS_PROGRAM_STATUS=0x0004: Open TIA in offline mode pserverprefix, // Server Prefix: NULL 0031 ScreenName, // Screen Name where Code Viewer object is used 0032 ObjectName, // Name of Code Viewer object 0033 pcpuname, // PLC name to be monitored 0034 pcontainingblock, // Name of the Block to be monitored 0035 poperand, // Operand to be monitored 0036 &error); // Error description 0037 Diagnósticos de falha: esta parte do programa é opcional. Caso haja alguma falha durante a execução, a variável result retornará o valor 1. Estando result com o valor 1, será impresso (função printf) no objeto um texto fixo mais os valores de detalhes do erro, conforme variável error // check for errors, and print a log if necessary 0039 if(!result) 0040 { 0041 // there are only few reasons why the call to OpenViewerIECPLByAssignment will 0042 // fail, in most cases the viewer control could not be found 0043 // most of the errors have to be handled in the OnError event of the viewer 0044 printf("openvieweriecplbyassignment failed: err1=%ld, err2=%ld, err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r \n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerror- Text); 0045 } 24/01/2017 Página 6 / 19

7 } Fim da rotina: Monitorando entrada de bloco O objetivo desta sub-rotina é criar um ambiente adequado e padronizado para a chamada da função OpenViewerIECPLByCall. Ao criar uma função / sub-rotina, podem-se especificar parâmetros que vão ser passados na chamada. Esta definição é feita na janela de inspeção. Os parâmetros definidos neste exemplo são: screenname: string que descreve o nome da tela onde está o objeto PLC code display a ser endereçado. objectname: string que descreve o nome do objeto PLC code display a ser endereçado. cpuname: string que descreve o nome da CPU a ser acessada pelo objeto PLC code display. containingblock: string que descreve o nome do bloco a ser monitorado pelo objeto PLC code display. 24/01/2017 Página 7 / 19

8 calledblock: string o bloco que esta sendo chamado dentro do containingblock e que servirá de ponto focal para a monitoração. pinname: string que define o nome da variável de entrada que do bloco definido em calledblock e que servirá de ponto focal para a monitoração. 24/01/2017 Página 8 / 19

9 Exemplo de script comentado Comentários iniciais: 0001 /* This fuction call OpenViewerIECPLByCall with correct eviroment / parameters OpenViewerIECPLByCall is used for the LAD and FBD languages by Code Viewer object It shows the assignment to an operator (program related to a called block's input) */ 0009 Inclusão de definições padrão (default para aplicações com WinCC Professional): 0010 #include "GlobalDefinitions.h" Definição do cabeçalho: sem variável de retorno (não é necessário), definição de variáveis a serem passadas para a rotina conforme propriedades definidas na janela de inspeção void C_OpenCodeViewe_Call(char* screenname, char* objectname, char* cpuname, char* containingblock, char* calledblock, char* pinname) 0012 { 0013 Início da rotina: Inclusão de biblioteca própria para uso do objeto PLC code display // add libraries 0016 #pragma code("kopapi.dll") 0017 #include "kopapi.h" 0018 #pragma code() /01/2017 Página 9 / 19

10 Definição de variáveis internas: no geral, os parâmetros são copiados para variáveis internas por questão de organização. A variável error retorna informações de erro na chamada da função. A função OpenViewerIECPLByCall retorna 1 se houve erro em sua execução (a variável result coleta esta informação) // Variable definitions for fuction call char* serverprefix = ""; 0023 CMN_ERROR error; // Error description BOOL result; // 0 means that the fuction was executed without errors Chamada da função OpenViewerIECPLByCall: as variáveis do cabeçalho são passadas para a função result = OpenViewerIECPLByCall(0, // DWFLAGS: Bit array, 0 by default(the complete pin name is compared to lpszpin); IECPLVIEWER_PIN_SUBSTRING_SEARCH= 0x0001: the pin name starts with the string pass in lpszpin serverprefix, // Server Prefix: NULL 0030 screenname, // Screen Name where Code Viewer object is used 0031 objectname, // Name of Code Viewer object 0032 cpuname, // PLC name to be monitored 0033 containingblock,//name of the Block to be monitored 0034 calledblock, // Name of the Block called in the monitored's block 0035 pinname, // Input name of the called Block to be monitored 0036 &error); // Error description Diagnósticos de falha: esta parte do programa é opcional. Caso haja alguma falha durante a execução, a variável result retornará o valor 1. Estando result com o valor 1, será impresso (função printf) no objeto um texto fixo mais os valores de detalhes do erro, conforme variável error if(!result) 0040 { 0041 // there are only few reasons why the call to OpenViewerIECPLByCall will fail, in most cases the viewer control could not be found 0042 // most of the errors have to be handled in the OnError event of the viewer 0043 printf("openvieweriecplbycall failed: err1=%ld, err2=%ld, err3=%ld, err4=%ld, err5=%ld, text=\"%s\"\r\n", result, error.dwerror1, error.dwerror2, error.dwerror3, error.dwerror4, error.dwerror5, error.szerrortext); 0044 } /01/2017 Página 10 / 19

11 0046 Fim da rotina: 0047 } 1.3. Chamada do script Neste exemplo os scripts são chamados a partir de botões Monitorando variável de saída Neste caso usa-se a rotina C_OpenCodeViewer_Assig (vide 1.2.1). Os parâmetros são passados como strings, exceto menção em contrário: Parâmetros: ScreenName: Nome da tela onde o objeto PLC code display. O nome da tela pode ser obtido nas propriedades da tela (General / Name), título das propriedades ou estrutura de diretórios: 24/01/2017 Página 11 / 19

12 Object name: Nome do objeto PLC code display. O nome do objeto pode ser obtido nas propriedades da tela (Miscellaneous / Name) ou título das propriedades: 24/01/2017 Página 12 / 19

13 CPUName: Nome da CPU a ser monitorada. O nome da CPU pode ser obtido da estrutura de diretórios ou nas propriedades da CPU, diretório General / Project Information / Name. BlockName: Nome do bloco a ser monitorado. No caso de FB, usar o nome do instance DB: OperandName: nome da variável de saída a ser monitorada. Ela serve de referência para a representação do segmento (network) a ser monitorado. 24/01/2017 Página 13 / 19

14 Para o caso de variáveis globais, usar o nome simbólico da variável (por exemplo, Tag_1 ). Para o caso de variáveis locais, usar o nome simbólico da variável, precedido de # (por exemplo, #out ). 24/01/2017 Página 14 / 19

15 Monitorando entrada de bloco Neste caso usa-se a rotina C_OpenCodeViewer_Call (vide 1.2.2). Os parâmetros são passados como strings, exceto menção em contrário: Parâmetros: ScreenName: Nome da tela onde o objeto PLC code display. O nome da tela pode ser obtido nas propriedades da tela (General / Name), título das propriedades ou estrutura de diretórios: 24/01/2017 Página 15 / 19

16 Object name: Nome do objeto PLC code display. O nome do objeto pode ser obtido nas propriedades da tela (Miscellaneous / Name) ou título das propriedades: CPUName: Nome da CPU a ser monitorada. O nome da CPU pode ser obtida da estrutura de dirtórios ou nas propriedades da CPU, diretório General / Project Information / Name. 24/01/2017 Página 16 / 19

17 ContainingBlock: Nome do bloco a ser monitorado. No caso de FB, usar o nome do instance DB: CalledBlock: nome do bloco cuja chamada deve ser monitorada. No caso de FB, usar o instance DB. No caso de FB muiltinstance, usar o nome do Multiinstance, precedido por # (por exemplo, #My_Block2_Instance ). 24/01/2017 Página 17 / 19

18 PinName: nome do pino de entrada do bloco cuja chamada deve ser monitorada. 3. Referências Um projeto exemplo pode ser acessado no Fórum Siemens para automação industrial, sob link: D=531865&Language=en&onlyInternet=False#top 24/01/2017 Página 18 / 19

19 4. Suporte técnico e treinamento Suporte Técnico Requisição de suporte: /SR Tel.: Portal de Suporte: Homepage Brasil: Centro de treinamento - SITRAIN Informações: Tel.: /01/2017 Página 19 / 19