Using the Library Manager
 Utilizando o gerenciador de biblioteca

As bibliotecas ISaGRAF fornecem uma interface padrão entre o desenvolvimento de automação e a capacidade de software e hardware do sistema destino ISaGRAF. Existe uma biblioteca para cada tipo ou interface. O Gerenciador de Biblioteca do Ambiente de trabalho ISaGRAF é dedicado ao fornecedor de hardware, ou ao engenheiro de software. Ele utiliza o gerenciador de biblioteca para descrever a interface de programação dos objetos que cria.

Gerenciando elementos da biblioteca

Configurações de E/S

Equipamentos complexos de E/S

Placas de E/S

Funções e blocos escritos em linguagens IEC

Funções "C" e blocos de função

Funções de conversão

Arquivando elementos de biblioteca

O Gerenciador de Biblioteca do Ambiente de trabalho ISaGRAF mostra os elementos de uma das bibliotecas ISaGRAF. Na área à esquerda da janela está a lista de elementos da biblioteca selecionada. Na área à direita está a observação técnica (manual do usuário) do elemento selecionado no momento na lista de elementos. Os menus do gerenciador de biblioteca contém comandos para criar, definir ou modificar elementos da biblioteca ativa. O comando "Arquivo / Outra biblioteca" permite a seleção de uma das bibliotecas ISaGRAF. A caixa de seleção à esquerda da barra de ferramentas também pode ser utilizada para selecionar uma biblioteca:


Managing library elements
Gerenciando elementos da biblioteca

Utilize os comandos do menu "Arquivo" para criar elementos e trabalhar nos elementos já existentes na biblioteca aberta

Criando um novo elemento

Trabalhando com elementos existentes

Proteção por senha

Compilando funções e blocos de função

Observações técnicas

Parâmetros

Código fonte


Creating a new element
Criando um novo elemento

O comando "Novo do menu "Arquivo" cria um novo elemento na biblioteca selecionada. O nome do novo elemento é inserido, baseado nas seguintes regras de nomenclatura:

•	o tamanho máximo de um nome é 8 caracteres

•	o primeiro caractere deve ser uma letra

•	os caracteres seguintes devem ser letras, números ou o caractere '_'

•	a nomenclatura de um elemento da biblioteca não é sensível a maiúsculas e minúsculas.

Um comentário de texto é associado ao cada elemento da biblioteca. Este comentário é inserido na criação do elemento. Quando um novo elemento é criado, as seguintes informações devem ser fornecidas:

•	sua definição, para uma configuração de E/S,

•	seus parâmetros, para uma placa de E/S

•	sua interface, para uma função ou bloco de função

Quando uma conversão "C", função "C", ou bloco de função "C" ;é criado, um esqueleto completo do seu código fonte é gerado.


Working on existing elements
Trabalhando com elementos existentes

O comando "Arquivo / Renomear" permite ao usuário alterar o nome ou o comentário do elemento selecionado na lista de elementos. O comando "Arquivo / Copiar" permite ao usuário copiar o elemento em destaque na biblioteca ativa ou outro elemento na mesma biblioteca. Se o elemento de destino já existe, seu conteúdo é sobrescrito. Se o elemento de destino não existe, ele é automaticamente criado. O comando "Arquivo / Apagar" remove o elemento selecionado da biblioteca ativa. Os seguintes componentes do elemento são manipulados pelos comandos "Renomear", "Copiar" e "Apagar":

•	observação técnica

•	definição completa para uma configuração de E/S

•	parâmetros para uma placa de E/S ou equipamento complexo

•	definição da interface para uma função ou bloco de função

•	código fonte para função ou bloco de função escrito em linguagem IEC

•	código fonte para uma conversão C, uma função ou um bloco de função

se o elemento é uma conversão "C", função "C" ou bloco de função "C", seu nome não é automaticamente atualizado no código fonte associado por um comando "Renomear" ou "Copiar".

se o elemento é uma função escrita em linguagem IEC, o parâmetro de retorno não é alterado por um comando "Renomear" ou "Copiar".


Setting password protection
Proteção por senha

O comando "Arquivo / Determinar senha" permite ao usuário definir proteção por senha para o elemento selecionado na biblioteca aberta. Refira-se à seção "Proteção de dados" ao final da primeira parte deste manual para maiores informações sobre níveis de senha e proteção de dados. Senhas são relativas apenas ao elemento selecionado. Elas não têm influência em outros elementos de bibliotecas ISaGRAF.


Compiling functions and function blocks
Compilando funções e blocos de funções

Quando a biblioteca de funções ou blocos de função escritos em linguagens IEC é selecionada, o comando "Verificar (compilar)" do menu "Arquivo" é utilizado para checar a sintaxe do elemento selecionado e criar o seu código objeto. Funções e blocos escritos em linguagens IEC têm que ser compilados sem erros antes que possam ser utilizados em projetos ISaGRAF. Este comando não tem efeito se outra biblioteca é selecionada


Technical notes
Observações técnicas

O comando "Editar / Observação técnica" permite ao usuário inserir a observação técnica do elemento selecionado na biblioteca ativa. A observação técnica de um elemento é o seu guia do usuário. Ela será consultada pelo usuário do elemento durante a sua integração com o editor de texto ISaGRAF. A observação técnica deve conter a descrição da sua função principal, a explicação detalhada da sua interface de programação e parâmetros, e seu contexto e limites.

O comando "Ferramentas / Formatação de observação padrão" permite ao usuário definir um formato de texto padrão para todos os elementos da biblioteca selecionada no momento. Na edição da observação técnica para um novo elemento, este formato é utilizado como esqueleto. Isto permite ao usuário a otimização da edição de observações técnicas.


Parameters
Parâmetros

Os parâmetros de um elemento descrevem a interface entre as operações computacionais fornecidas pelo elemento e o uso deste elemento em uma aplicação ISaGRAF. Parâmetros têm significados diferentes para cada tipo de elemento da biblioteca.

Os parâmetros para uma configuração de E/S definem o conjunto completo de placas de E/S da configuração, e nomes de variáveis padrão utilizadas para canais de E/S. Os parâmetros de uma placa de E/S ou equipamento complexo definem a configuração física e lógica da placa. Os parâmetros de uma função ou bloco de função definem a interface do elemento, de acordo com as convenções de chamada de função da linguagem ST. Não existe parâmetro para funções de conversão porque elas utilizas uma interface padrão predefinida.


Source code
Código fonte

O Ambiente de trabalho ISaGRAF permite ao programador gerenciar o código fonte de uma conversão, função ou bloco de função de uma biblioteca. O código fonte de uma função ou um bloco escrito em linguagem IEC é um texto ou diagrama descrito com a linguagem associada à função. O código fonte de componentes "C" (funções "C", blocos de função "C" e funções de conversão) é dividido em dois arquivos separados: um cabeçalho do fonte (header) que contém a definição exata da interface, de acordo com a definição de parâmetros do elemento e um arquivo de código fonte que contém a implementação das operações do elemento

O Ambiente de trabalho ISaGRAF gera o arquivo de código fonte quando um novo elemento da biblioteca é criado. Ele também cria e atualiza o header do fonte, baseado na definição dos parâmetros. O programador pode utilizar o editor de texto ISaGRAF para completar o arquivo de código fonte.


I/O Configurations
Configurações de E/S

A biblioteca de configuração de E/S ISaGRAF fornece uma maneira fácil de inicializar novo projetos ISaGRAF com configurações de E/S predefinidas. Uma configuração de E/S define:

•	um conjunto de placas de E/S

•	valores padrão para parâmetros de placas de E/S

•	nomes padrão para canais de E/S

Quando um novo projeto ISaGRAF é criado com uma configuração de E/S da biblioteca, as conexões correspondentes de E/S são automaticamente feitas, e as variáveis de E/S correspondentes aos nomes dos canais são automaticamente declaradas no dicionário do projeto.

 A definição de uma configuração de E/S é feita com a Ferramenta de Conexão E/S ISaGRAF (a mesma ferramenta utilizada dentro de um projeto). Veja a seção "Conexão de E/S" neste manual para maiores informações sobre como utilizar esta ferramenta. Na inserção de uma nova placa de E/S na configuração todos os canais da nova placa são declarados com nomes padrão. O nome padrão de um canal de E/S tem o seguinte formato:

<direção><tipo><número_do_slot>_<número_do_canal>

O primeiro caractere indica a direção do canal de E/S:

"I"	canal de entrada

"O"	canal de saída

O segundo caractere indica o tipo do canal de E/S:

"X"	booleano

"D"	analógico

"M"	mensagem

Abaixo estão exemplos de nomes padrão para canais de E/S:

IX0_7	entrada booleana - placa #0 - canal #7

QD2_4	entrada inteira - placa #2 - canal #4

O comando "Canectar canais de E/S" do Editor de Conexões de E/S é utilizado para modificar o nome padrão associado a um canal de E/S.


I/O complex equipments
Equipamentos complexos de E/S

Todos os canais de uma única placa têm o mesmo tipo (booleano, analógico ou mensagem) e direção (entrada ou saída). Um equipamento complexo de E/S representa um dispositivo de E/S com canais de diferentes tipos e direções. Um equipamento complexo de E/S é representado por uma lista de placas de E/S individuais. Ele utiliza apenas um slot na lista de conexões de E/S do rack.

 Para definir um equipamento complexo de E/S, o usuário tem que definir uma lista de placas individuais que definem o equipamento de E/S. Ele também deve fornecer os parâmetros detalhados de cada placa individual. A lista de placas individuais é fornecida através de uma caixa de diálogo.

O pressionamento do botão "Adicionar" permite ao usuário adicionar uma placa ao final da lista corrente. O botão "Inserir" é utilizado para inserir uma nova placa antes da que está selecionada na lista no momento. O botão "Apagar" remove a placa selecionada da lista. Os botões "Renomear " e "Parâmetros" são utilizados para alterar o nome e os parâmetros da placa individual selecionada. Veja a seção seguinte para uma explicação completa sobre os parâmetros de uma placa individual. O nome da placa (dentro de um equipamento de E/S) não pode exceder 8 caracteres.


I/O boards
Placas de E/S

A biblioteca de placas de E/S ISaGRAF define uma interface padrão entre as variáveis da aplicação e o hardware destino. Durante a descrição da aplicação, todas as variáveis de E/S são conectadas aos canais de placas de E/S alvo. Uma placa de E/S ISaGRAF é definida por um nome e um "OEM key" (chave código OEM) que identifica o seu fornecedor. Outros parâmetros de E/S descrevem a topologia das placas de E/S (número de canais, direção e tipo dos canais), e sua configuração de hardware e software.

Parâmetros de placas de E/S

Os parâmetros OEM


I/O board parameters
Parâmetros de placas de E/S

Existem dois tipos de parâmetros para uma placa de E/S: parâmetros comuns que são definidos para todas as placas da biblioteca ISaGRAF , e parâmetros OEM que são específicos da implementação da placa, fornecidos pelo fabricante do hardware. Parâmetros comuns são inseridos na parte superior da caixa de diálogo de definição de parâmetros de placas de E/S. Estes parâmetros (mais o nome da placa de E/S) identificam a interface padrão de placa de E/S ISaGRAF.

O "OEM key " é um número simples que define o fornecedor de hardware. Todas as placas definidas pelo mesmo fornecedor devem ter o mesmo OEM key code. O OEM key code é uma word sem sinal de 16 bits, expressa em formato hexadecimal. O OEM key code reservado pela CJ International é "1".

Os parâmetros principais definem a topologia da placa E/S. O número de canais. define o número de canais disponíveis na placa. O tipo da placa é o tipo das variáveis que podem ser conectadas aos canais da placa. A direção define se as variáveis conectadas na placa são de entrada ou saída.

Observação:	Variáveis de E/S de tipos ou direções diferentes não podem ser agrupadas na mesma placa de E/S ISaGRAF. Esta característica requer um equipamento complexo de E/S.


The OEM parameters
Os parâmetros OEM

Os parâmetros OEM são fornecidos na parte inferior da caixa de diálogo de definição de parâmetros de placa de E/S. Estes parâmetros são definidos pelo fornecedor de hardware de E/S e são específicos à placa. Existem no máximo 16 parâmetros OEM para uma placa. O gerenciador de biblioteca ISaGRAF permite ao fornecedor do hardware definir a identificação e o formato de cada parâmetro, e a maneira que o programador de automação os insere.

A caixa à esquerda contém a lista dos parâmetros de OEM. Cada parâmetro é identificado por um nome e um número lógico, de 0 a 15. A área à direita contém a descrição detalhada do parâmetro selecionado na lista. Um parâmetro deve ser selecionado na lista para se ter acesso à sua descrição completa. O pressionamento do botão "Limpar" limpa a descrição do parâmetro e o remove da lista.. Advertência: este comando não pode ser "desfeito".

O nome de um parâmetro é utilizado para identificar o campo de entrada correspondente durante a conexão à placa de E/S se o campo for definido pelo operador de automação. O nome de um parâmetro deve seguir as seguintes regras:

•	o comprimento máximo de um nome é 16 caracteres

•	o primeiro caractere deve ser uma letra.

•	os caracteres seguintes devem ser letras, números  ou o caractere '_'.

O tipo do parâmetro define o seu formato interno e o seu formato de entrada durante a conexão de E/S da aplicação. Abaixo está a lista dos formatos internos disponíveis:

word	word de 16 bits sem sinal

long	word de 32 bits sem sinal

word hexa	word de 16 bits sem sinal

long hexa	word de 32 bits sem sinal

boolean	word de 16 bits sem sinal (somente o bit menos significativo é utilizado)

character	word de 16 bits sem sinal (somente o byte menos significativo é utilizado)

string	aarray de 16 bytes contendo uma string terminada por null

float	valor de ponto flutuante de 32 bits e precisão simples

Abaixo estão os formatos de entrada disponíveis:

word	word decimal sem sinal

long	word longa decimal

word hexa	word hexadecimal sem sinal

long hexa	word longa hexadecimal sem sinal

boolean	"true" ou "false"

character	caractere único

string	cadeia de caracteres ASCII (máximo de 15 caracteres)

float	valor flutuante de precisão simples.

A caixa de diálogo "Acesso" é utilizada para definir como o parâmetro pode ser acessado pelo usuário final. Se a opção "Definido pelo usuário" é definida, o parâmetro é mostrado como um campo de entrada durante a conexão à placa de E/S. O valor padrão do parâmetro OEM é utilizado como padrão para a edição do parâmetro. Se a opção "Escondido" é ligada, o parâmetro é uma constante e não aparece na caixa de diálogo de conexões de placa de E/S. O valor padrão do parâmetro OEM define o valor do parâmetro constante. A opção "Somente leitura" indica que o parâmetro é visível para o usuário, mas não pode ser modificado. Seu valor padrão é utilizado como um valor constante.


Functions and blocks written in IEC languages
Funções e blocos de função escritos em linguagens IEC

O ISaGRAF manipula uma biblioteca de funções e blocos de função escritos em linguagens IEC. As linguagens disponíveis para descrever tais funções são FBD (Diagrama de blocos de função), LD (Diagrama Ladder), ST (Texto Estruturado) ou IL (Lista de Instruções). Note que as linguagens LD e FBD podem ser misturadas no mesmo diagrama. A linguagem SFC não pode ser utilizada para descrever uma função ou um bloco de na biblioteca. A linguagem associada a um elemento da biblioteca é selecionada quando a função é criada, e não pode ser alterada posteriormente.

Compilando

Inserindo o código fonte

Dicionário de variáveis locais

Definindo a interface


Compiling
Compilando

Funções e blocos definidos na biblioteca devem ser compilados (verificados) antes que eles possam ser utilizados dentro de um projeto ISaGRAF. Nada mais tem que ser alterado na parte de Bibliotecas a respeito de blocos e funções.  Elementos da biblioteca irão aparecer automaticamente no menu de seleção no uso do editor gráfico LD/FBD dentro de um projeto.

Uma função definida na biblioteca pode chamar outras funções da biblioteca. No entanto, o sistema ISaGRAF não suporta recursão na chamada de funções. Um bloco de função escrito em linguagem IEC não pode chamar outros blocos de função (nem em linguagens IEC ou linguagem "C")


Entering source code
Inserindo o código fonte

O código fonte de uma função da biblioteca ou bloco de função é inserido utilizando-se as ferramentas padrão ISaGRAF: editor gráfico para programas LD ou FBD, editor de texto para programas ST ou IL. Veja as seções correspondentes no manual para mais informações a respeito destas ferramentas. O Gerador de Código ISaGRAF pode ser chamado diretamente da janela de edição gráfica ou de texto, para compilar o código fonte de uma função ou bloco da biblioteca.


Dictionary of local variables
Dicionário de variáveis locais

Uma função ou bloco de função da biblioteca pode ter variáveis locais e definições locais. Para acessar a declaração da variável, o usuário deve executar os comandos da opção "Dicionário" do menu "Arquivo" , na janela do editor, quando editando o código da função.

 	Uma função ou bloco de função da biblioteca não pode acessar uma variável ou instância de bloco de função globais. Variáveis locais de uma função devem ser inicializadas no corpo da função.

Variáveis locais a um bloco de função escrito em linguagem IEC são copiadas (instanciadas) cada vez que o bloco é utilizado em um projeto. Variáveis locais de uma instância mantém seus valores de uma chamada para outra.


Defining the interface
Definindo a interface

Funções ou blocos de função podem ter até 32 parâmetros (de entrada ou saída). Uma função sempre tem um (e apenas um) parâmetro de retorno, que deve ter o mesmo nome que a função, de modo a seguir as convenções da linguagem ST.

A lista no lado superior esquerdo da janela mostras os parâmetros, em ordem de modelo de chamada: primeiro os parâmetros de chamada, por último os parâmetros de retorno. A parte inferior da janela mostra a descrição detalhada do parâmetro selecionado atualmente na lista. Qualquer um dos tipos de dados ISaGRAF pode ser utilizado para um parâmetro. Os parâmetros de retorno devem estar localizados após os parâmetros de chamada na lista. Os nomes dos parâmetros devem seguir as seguintes regras:

•	o tamanho máximo de um nome é 16 caracteres

•	o primeiro caractere deve ser uma letra

•	os caracteres seguintes devem ser letras, números ou o caractere '_'

•	o nome não é sensível a maiúsculas e minúsculas.

O comando "Inserir" é utilizado para inserir um novo parâmetro após o que está selecionado. O comando "Apagar" é utilizado para apagar o parâmetro selecionado. O comando "Organizar" ordena automaticamente os parâmetros, de modo que os parâmetros de retorno sejam colocados ao final da lista.


"C" Functions and function blocks
Funções "C" e blocos de função

As funções "C" e blocos de função são funções de computação chamadas da aplicação de automação, de acordo com a interface de chamada de funções da linguagem ST.

Funções são processos síncronos. A aplicação destino ISaGRAF é suspensa durante a execução da função. Blocos de função associam operações e dados estáticos ocultos. Por exemplo, um bloco de função "counter" representa a operação de contagem, assim como o resultado da contagem. Funções e blocos de função podem ser utilizados para completar as características padrão das linguagens de automação, ou para acessar recursos do sistema.

 A janela de definição de parâmetros é utilizada para definir o nome e o tipo de cada parâmetro de chamada ou retorno da função ou do bloco de função. Uma função pode ter até 31 parâmetros de chamada, e sempre tem um parâmetro de retorno. Um bloco de função pode ter até 32 parâmetros, com qualquer mistura de parâmetros de chamada e retorno. Abaixo está a correspondência entre os tipos ISaGRAF e os tipos "C":

BOOLEANO	unsigned long	word de 32 bits sem sinal: 1=true / 0=false

ANALÓGICO	long	word de 32 bits inteira com sinal

REAL	float	valor flutuante de precisão simples

TEMPORIZADOR	unsigned long	word de 32 bits inteira sem sinal (unidade é 1 ms)

MENSAGEM	char *	cadeia de caracteres.

Quando um valor de mensagem é passado para uma função "C" ou um bloco de função, ele nào pode conter caracteres nulos. A cadeia de caracteres passada para o código "C" é terminada por null.

Veja o Guia do Usuário ISaGRAF para maiores informações sobre como gerenciar código "C" de uma função ou bloco de função, e como integrar um novo elemento ao sistema destino ISaGRAF.


Conversion functions
Funções de conversão

Uma função de conversão é uma função "C" chamada pelo gerenciador de E/S ISaGRAF cada vez que é realizada entrada ou saída de variáveis analógicas.

A função cria a relação entre o valor elétrico da variável (lido no sensor de entrada ou enviado para o dispositivo de saída) e o seu valor físico (utilizado em expressões da aplicação). A função é, portanto, dividida em duas partes: conversão de entrada e conversão de saída. O gerenciador de biblioteca ISaGRAF permite ao usuário controlar o código fonte "C" de uma função de conversão.

Uma conversão pode ser utilizada para uma variável analógica inteira ou real. Isto implica em que a interface da função de conversão seja sempre definida por valores de ponto flutuante. A interface é a mesma para toda função de conversão. A definição "C" desta interface é feita no arquivo de definição "TACN0DEF.H".

Veja o Guia do Usuário ISaGRAF para maiores informações sobre como gerenciar o código fonte "C" de uma função de conversão, e como integrar um novo elemento ao sistema destino ISaGRAF.


Archiving library elements
Arquivando elementos de biblioteca

O comando "Ferramentas / Diretório" do menu executa o Gerenciador de Diretório ISaGRAF para salvar ou restaurar elementos da biblioteca. Primeiramente é necessário selecionar uma biblioteca antes de executar o comando "Diretório". O gerenciador de diretório mostra a lista dos elementos para uma biblioteca por vez.