Using the Quick LD editor
 Utilização do editor Quick LD

A linguagem LD permite a representação gráfica das equações booleanas. Os operadores booleanos AND, OR, NOT estão explicitamente representados pela topologia do diagrama. As variáveis Booleanas de entrada estão vinculadas aos contatos. As variáveis de saída estão vinculadas às bobinas. O editor Quick LD ISaGRAF permite a elaboração rápida e fácil de um diagrama LD utilizando ou o teclado ou o mouse. Os elementos são automaticamente ligados e arrumados pelo editor Quick LD. Nenhuma conexão é desenhada manualmente pelo usuário. O editor Quick LD também arruma os elementos do diagrama de modo a otimizar o espaço gráfico ocupado.

Fundamentos da linguagem LD

Inserindo um diagrama LD

Trabalhando em um diagrama existente

Opções de vídeo

Comandos do menu "Ferramentas"

Chamando outras ferramentas ISaGRAF

Parâmetros do programa

Outros comandos do menu "Arquivo"

Atualização do arquivo de diário do programa

Seleção de uma variável do dicionário


Basics of the LD language
Fundamentos da linguagem LD

Um programa LD é um conjunto de equações chamadas lógicas nas quais os contatos e as bobinas estão arrumados. A seguir, os componentes básicos de um diagrama LD:

Início de lógica (barra de energia à esquerda)

Contatos

Bobinas

Blocos de função

Fim de lógica (barra de energia à direita)

Símbolo de desvio

Símbolo de retorno

A entrada "EN"

A saída "ENO"

Limitações do editor Quick LD


Rung head (left power rail)
Início de lógica (barra de energia à esquerda)

Cada lógica começa com uma barra de energia à esquerda que representa o estado inicial "TRUE". O editor Quick LD ISaGRAF cria automaticamente a barra de energia à esquerda quando o primeiro contato da lógica é posicionado pelo usuário. Cada lógica pode ter um nome lógico que pode ser utilizado como um rótulo nas instruções de desvio.


Contacts
Contatos

Um contato modifica o fluxo de dados booleanos de acordo com o estado da variável booleana. O nome da variável é mostrada sobre o símbolo do contato. Os seguintes tipos de contatos são suportados pelo editor Quick LD ISaGRAF:

contato normalmente aberto (NA)

contato normalmente fechado (NF)

contato com detecção de borda de subida

contato com detecção de borda de descida


Coils
Bobina

Uma bobina representa uma ação. A variável associada à bobina é forçada para o estado da lógica (estado da ligação à esquerda da bobina). O nome da variável é mostrado sobre o símbolo da bobina. Os seguintes tipos de bobina são suportados pelo editor Quick LD ISaGRAF :

bobina direta

bobina inversa

bobina liga

bobina desliga

bobina com detecção de borda de subida

bobina com detecção de borda de descida


Function blocks
Blocos de função

Um bloco em um diagrama LD pode representar um operador, uma função, um subprograma ou um bloco de função. Seus primeiros parâmetros de entrada e de saída estão conectados à lógica. Os outros parâmetros de entrada e de saída são escritos fora do bloco.


Rung end (right power rail)
Fim de lógica (barra de energia à direita)

Uma lógica termina com uma barra de energia à direita. Utilizando o editor Quick LD, a barra de energia à direita é automaticamente ligada a cada bobina posicionada pelo usuário.


Jump symbol
Símbolo de desvio

Um símbolo de desvio sempre se refere a um rótulo (nome da lógica) definido dentro do mesmo diagrama LD. O símbolo de desvio está posicionado no fim de uma lógica. Quando o estado da lógica é TRUE, a execução do diagrama é desviada diretamente para o rótulo destino. Note que os desvios para trás são perigosos já que podem bloquear o ciclo automático ("loop") em alguns casos.


Return symbol
Símbolo de retorno

Um símbolo "Return" é posicionado no fim de uma lógica. Indica que a execução do programa deve ser interrompida se o estado da lógica é TRUE. Um símbolo "Return" é equivalente a um desvio após a última lógica do diagrama.


The "EN" input
A entrada "EN"

A primeira entrada de certos operadores, blocos de funções ou funções não podem ser do tipo booleano e nem podem ser conectados a uma linha LD booleana. Como a primeira entrada deve sempre estar conectada a uma lógica, outra entrada é automaticamente inserida na primeira posição chamada "EN". O bloco é executado somente se a entrada EN recebe um TRUE. A seguir,  um exemplo do bloco comparador e seu equivalente em ST:

	IF rung_state THEN    q := (value1 > value 2); ELSE    q := FALSE; END_IF; (* continue rung with q state *)


The "ENO" output
A saída "ENO"

A primeira saída de certos operadores, blocos de funções ou funções não podem ser do tipo booleano e nem podem ser conectadas a uma linha LD booleana. Portanto, para estes blocos, uma saída suplementar booleana é vinculada como primeiro parâmetro de saída. Esta saída tem o nome "ENO". A saída ENO sempre está no estado da primeira entrada do bloco. A seguir, um exemplo do bloco AVERAGE e seu equivalente em ST:

	AVERAGE(rung_state, Signal, 100); OutSignal := AVERAGE.XOUT; eno := rung_state; (* continue rung with eno state *)

Em alguns casos, os dois parâmetros EN e ENO são requeridos. A seguir, um exemplo com um operador aritmético e seu equivalente em ST:

	IF rung_state THEN    result := (value1 + value2); END_IF; eno := rung_state; (* continue rung with eno state *)


Limitations of Quick LD editor
Limitações do editor Quick LD

O editor Quick LD ISaGRAF não permite continuar uma lógica (inserção de outros contatos ou bobinas) à direita de uma bobina. Se diversas saídas devem ser atribuídas na mesma lógica, as bobinas correspondentes devem ser colocadas em paralelo.


Entering an LD diagram
Inserindo um diagrama LD

Todos os comandos propostos para o editor Quick LD podem ser realizados ou pelo teclado ou com o mouse.

A grade de edição

Criando uma nova lógica

Introduzindo um comentário de lógica

Introduzindo um nome de lógica

Introduzindo símbolos de lógica

Introduzindo nomes de variáveis

Modificando o tipo de contatos e bobinas

Inserindo uma lógica em um diagrama


The editing grid
A grade de edição

O diagrama LD é inserido em uma matriz lógica. Cada célula da matriz pode conter até um símbolo LD (contato ou bobina). Utilize as setas do teclado, ou clique sobre a célula para mover a seleção atual. A célula selecionada é marcada em vídeo reverso. Para algumas operações ( recortar/copiar/colar), é possível selecionar diversas células. Para isto, com o mouse arraste o cursor no diagrama. Com o teclado, utilize as teclas de seta em conjunto com a tecla SHIFT pressionada.


Starting a new rung
Criando uma nova lógica

Para acrescentar uma nova lógica a um diagrama, mova a seleção após a última lógica existente e insira um contato (pressione F2 ou o botão correspondente na barra de ferramentas LD). Uma nova lógica com um contato e uma bobina é criada.


Entering the rung comment
Introduzindo um comentário de lógica

Cada lógica pode ser documentada com até duas linhas de texto. Para introduzir um texto de comentário de lógica, mova a seleção na célula sobre a lógica e pressione a tecla ENTER ou clique duas vezes sobre esta célula com o mouse:


Entering the rung label
Introduzindo um nome de lógica

Cada lógica pode ser identificada por um nome. Este nome pode ser utilizado como um rótulo designado para operações de desvio. Para introduzir ou modificar o rótulo de um lógica, mova a seleção sobre a início de lógica e pressione a tecla ENTER ou clique duas vezes sobre esta célula com o mouse:

O editor ISaGRAF Quick LD mantém a memória dos nomes de lógica que você já introduziu, quer tenha sido especificado para um nome de lógica ou uma operação de desvio. A caixa de diálogo "Salto/Rótulo"' lhe dá a possibilidade para introduzir um novo nome ou selecionar um existente.

Se você introduz um novo nome, este será automaticamente acrescentado à lista. O botão "Remover" é utilizado para remover o nome selecionado da lista. Não remove o nome de lógica que você selecionou no diagrama. Para fazer isto, basta pressionar OK quando a caixa de edição estiver vazia.


Inserting symbols on a rung
Introduzindo símbolos de lógica

A inserção de símbolos (contatos, bobinas, blocos...) em um lógica existente sempre é feito de acordo com a seleção atual. Você tem que selecionar uma posição de célula válida dentro da lógica e pressionar uma das seguintes teclas de função, para inserir:

F2	um contato antes do símbolo selecionado (à esquerda)

F3	um contato depois do símbolo selecionado (à direita)

F4	um contato em paralelo com o símbolo selecionado

F6	um bloco antes do símbolo selecionado (à esquerda)

F7	um bloco depois do símbolo selecionado (à direita)

F8	um bloco em paralelo com o símbolo selecionado

Os comandos a seguir são válidos quando a seleção estiver na saída de lógica (bobina):

F5	adiciona um bobina em paralelo com a selecionada

F9	adiciona um símbolo de "Desvio" em paralelo com a selecionada

Shift+F9	adiciona um símbolo de "Retorno" em paralelo com a selecionada

Para inserção paralela (F4/F8), se diversos contatos de uma lógica são selecionados em conjunto, o símbolo é inserido em paralelo com o grupo de elementos selecionados. A seguir, um exemplo:

Para inserir símbolos no diagrama, você também pode utilizar os comandos do menu "Inserir". Com o mouse, você pode clicar na barra de ferramenta LD, sobre o tipo de símbolo que você deseja inserir:


Entering symbols
Introduzindo nomes de variáveis

Para associar um símbolo de variável a um contato ou a uma bobina, selecione e pressione a tecla ENTER. Com o mouse, clique duas vezes sobre o contato ou sobre a bobina. Uma caixa de seleção de variável é apresentada. Refira-se ao capítulo "Mais sobre Editores de Programa" neste documento para informação adicional sobre como usar esta caixa. Para associar uma função, bloco de função ou operador a um bloco, pressione a tecla ENTER quando a seleção estiver na parte interna do seu retângulo. Para associar um símbolo de variável a um parâmetro de bloco de entrada ou de saída, a seleção deve estar sobre o local correspondente, do lado de fora do retângulo do bloco.

Caixas de diálogo incluindo listas de seleção de variável ou de bloco normalmente são utilizadas para a introdução de texto. Se o modo "Entrada manual pelo teclado" é verificado no menu "Opções", os símbolos de variáveis e os nomes de blocos são introduzidos diretamente em uma única caixa de edição de texto. Entre com o texto novo e pressione a tecla "Enter" para validá-lo, ou pressione "Esc" para encerrar a modificação e fechar a caixa de edição de texto. A caixa de edição de texto utilizada no modo "manual de entrada via teclado" não pode ser fechada com o mouse.


Changing the type of contacts and coils
Modificando o tipo de contatos e bobinas

A opção "Editar / Alterar tipo de bobina/contato" modifica o tipo de contato ou de bobina selecionado. Um contato pode ser normalmente aberto (NA), normalmente fechado (NF), com detecção de borda de subida ou com detecção de borda de descida. Um bobina pode ser direta, inversa, liga ou desliga, com detecção de borda de subida ou de descida. Pressionando a barra de espaço (SPACE) obtém-se o mesmo efeito.


Inserting a rung in a diagram
Inserindo uma lógica em um diagrama

O comando "Editar / Inserir lógica" insere uma nova lógica no diagrama, antes da selecionada. A lógica é iniciada com um contato e um bobina.


Working on an existing diagram
Trabalhando em um diagrama existente

Os comandos do menu "Editar" para alterar ou completar um diagrama existente. A maioria destes comandos agem sobre o elemento atualmente selecionado no diagrama.

Corrigindo um diagrama

Copiando símbolos

Gerenciando lógicas

Localizar e substituir


Correcting a diagram
Corrigindo um diagrama

A tecla DEL pode ser utilizada para remover os elementos selecionados. Não é possível remover bobinas, um desvio ou um símbolo de retorno quando for a única saída de uma lógica. Utilize o comando "Editar / Desfazer" para restaurar elementos após um comando DEL. O comando DEL também pode ser aplicado a um grupo de elementos selecionado no diagrama. O comando DEL pode ser utilizado quando seleção estiver sobre o texto de comentário de lógica para reinicializá-la. O comando DEL, utilizado quando a seleção estiver sobre o início de lógica, remove-a por inteiro.


Copying symbols
Copiando símbolos

Os comandos "Recortar", "Copiar", "Colar" do menu "Editar" são utilizados para mover ou copiar elementos selecionados. Estes comandos não atuam sobre os comentários de lógica. O comando "Editar / Colar especial" lhe dá a escolha para inserir os elementos colados:

•	antes do elemento selecionado (à esquerda)

•	depois do elemento selecionado (à direita)

•	em paralelo com o elemento selecionado


Managing entire rungs
Gerenciando lógicas

Todos os comandos de edição (apagar, copiar, recortar...) atuam sobre toda a lógica se a seleção estiver sobre o início de lógica (barra de energia esquerda). Fornece assim um modo fácil de organizar as lógicas no diagrama, só movendo a seleção na primeira coluna. Também é possível estender a seleção verticalmente de forma que isto inclui diversos inícios de lógica. Neste caso, os comandos de edição podem ser aplicados a uma lista inteira de lógicas.


Find and replace
Localizar e substituir

Os comandos do menu "Editar / Localizar" e "Editar / Substituir" são utilizados para localizar e substituir textos no diagrama. Somente nomes completos podem ser localizados. A localização atua sobre os contatos, as bobinas, os nomes de bloco, os parâmetros de bloco e rótulos de execução. Não pode ser utilizado para localizar uma cadeia em um comentário de lógica. O comando "Substituir" não pode ser utilizado para mudar o tipo de um bloco. A pesquisa pode ser para cima ou para ou para baixo, começando da posição da seleção atual. Executa um "loop" quando os limites do diagrama são alcançados. Os seguintes atalhos também estão disponíveis para pesquisa rápida de nomes variáveis:

ALT+F2	localiza o próximo elemento com o mesmo nome de variável do elemento atualmente selecionado. Este recurso também pode ser aplicado aos blocos de funções e nomes de lógica.

ALT+F5	localiza a próxima bobina com o mesmo nome de variável do elemento atualmente selecionado. Este recurso é principalmente utilizado no modo depurar para rapidamente localizar as lógicas que forçam uma variável duvidosa.


Display options
Opções de vídeo

São utilizados os comandos do menu "Opções" para personalizar o desenho do diagrama LD na tela e esconder ou exibir alguns tipos de informação.

Comentários de lógicas

Nomes e alias

Opções de desenho


Rung comments
Comentários de lógicas

Utilize o comando "Opções / Comentários de Lógicas" para esconder ou exibir os comentários de  lógica em todo o diagrama. Pode ser necessário esconder os comentários de lógica para uma visão mais condensada de um diagrama muito grande, já que cada comentário consome uma linha na matriz de edição. Esta opção não afeta os conteúdos dos comentários de lógica existentes e pode ser trocado a qualquer hora.


Names and aliases
Nomes e alias

Cada variável, quando associada a um contato, uma bobina ou um parâmetro de bloco E/S é identificado por seu nome simbólico. O editor ISaGRAF Quick LD também introduz a noção ou "alias" (nome suposto) para cada variável. O alias da variável é o texto de comentário variável, truncado antes do primeiro caractere ':', e limitado a 16 caracteres. A seguir, exemplos:

variable comment:	alias:

short text	short text

long text with no separator	long text with n

short text: long description	short text

Alias não tem nenhum efeito na execução do diagrama LD e deve ser considerado como comentário para o ponto de vista sintático. Um alias de variável é extraído automaticamente do comentário de variável quando o nome é selecionado na lista de variável. Não pode ser modificado manualmente. Utilize os comandos "Opções / Contatos e bobinas" para selecionar um modo de exibição para identificação de variável. O seguinte modo está disponível:

•	exibir só os nomes de variáveis

•	exibir só os alias de variáveis

•	exibir nomes e alias

O editor Quick LD não atualiza automaticamente documentos LD quando alias de variáveis são modificados no dicionário. Utilize o comando "Opções / Contatos e bobinas / Atualizar aliases" para atualizar todos os alias no diagrama editado. Você também pode fixar a opção "Sempre atualizar ao Abrir" de "Opções / Contatos e bobinas" para solicitar ao ISaGRAF que atualize todos os alias utilizados automaticamente toda vez que um programa Quick LD está aberto. Aviso: Configuração desta opção pode aumentar significativamente o tempo gasto para abrir um programa..


Drawing options
Opções de desenho

O comando "Opções / Layout" abre uma caixa de diálogo onde se agrupa todos os parâmetros e opções relativos à área de trabalho de editor e ao desenho do diagrama LD gráfico.

Utilize as caixas de verificação no grupo de caixas "área de trabalho" para exibir ou esconder a barra de ferramentas de edição, a barra de estados e a barra de ferramentas LD. As opções no grupo de caixas "Documento" permite mostrar ou esconder os pontos da grade de edição e habilitar/desabilitar a utilização de cores para o desenho.

As opções no grupo de caixas "Zoom" permites selecionar a taxa principal de zoom. Você também pode utilizar o botão "zoom" na barra de ferramentas de edição para trocar entre os valores padrões de zoom.

Você também pode personalizar a relação entre eixos X/Y das  células na grade de edição. Esta última opção pode ser utilizada para reduzir a largura de célula padrão, se pequenos nomes são normalmente utilizados para as variáveis. Você também pode utilizar o botão "largura" na barra de ferramenta de edição para modificar a relação entre eixos X/Y sem entrar na caixa de diálogo Layout.

Utilize o comando "Opções / Fonte…" para selecionar o nome da fonte de caractere a ser utilizado em todos os documentos gráficos ISaGRAF. Durante a seleção de fonte, o estilo de fonte e o tamanho não são importantes e não precisam ser especificados. Os editores gráficos ISaGRAF sempre calculam o tamanho da fonte de acordo com a taxa de zoom selecionada.


Calling other ISaGRAF tools
Chamando outras ferramentas ISaGRAF

Verifica (compila) o programa

 	Simular ou depurar o aplicativo

Editando o dicionário de variáveis


Verify (compile) the program
Verifica (compila) o programa

O comando "Arquivo / Verificar" executa o gerador de código ISaGRAF para verificar a sintaxe de programa atualmente editado. No caso de linguagem SFC, ambos nível 1 e 2 são conferidos. Quando a verificação de sintaxe estiver completa, a janela de gerador de código deve ser fechada para continuar o trabalho no programa. Se há só um programa no aplicativo (o editado) o código de aplicativo é gerado se nenhum erro de sintaxe é detectado. O comando "Opções / Opções do compilador" é utilizado para configurar a compilação e otimização de parâmetros. Refira-se ao capítulo "Utilização do gerador de código" neste documento para informação adicional sobre compilação e geração de código.


Simulate or debug the application
 	Simular ou depurar o aplicativo

Os comandos "Arquivo / Simular" e "Arquivo / Depurar" executam o depurador gráfico ISaGRAF ou no modo simulação ou no modo realmente conectado e reabre o programa SFC editado no modo depurar. Utilizado no modo depurar, nenhuma modificação pode ser inserida no programa.


Editing the dictionary of variables
Editando o dicionário de variáveis

O comando "Arquivo / Dicionário" é utilizado para editar o dicionário de variáveis para o aplicativo atual e o programa atual. Também contém os pontos de entrada para editar as palavras definidas pelo usuário. As declarações locais ou palavras definidas referem-se ao programa atualmente editado.


Parameters of the program
Parâmetros do programa

Quando o programa editado é uma função, um bloco de função ou um subprograma, o comando "Arquivo / Parâmetros" é utilizado para definir os seus parâmetros de chamada e de retorno. Este comando não tem nenhum efeito se o programa editado é um programa SFC ou de mais alto nível da seção Início ou Fim.

Subprogramas, funções ou blocos de função podem ter até 32 parâmetros (entrada ou saída). Uma função ou subprograma sempre tem um (e somente um) parâmetro de retorno que tem que ter o mesmo nome da função para conformar com as convenções de escrita de linguagem ST.

A lista no canto superior esquerdo da janela mostra os parâmetros, na ordem do 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 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 parâmetros de nome devem seguir às seguintes regras:

•	o comprimento do nome não pode exceder 16 caracteres

•	o primeiro caractere deve ser uma letra

•	os demais caracteres devem ser letras, algarismos ou caractere de sublinha (_)

•	o nome não distingue entre maiúscula/minúscula

O comando "Inserir" é utilizado para inserir um novo parâmetro antes do parâmetro selecionado. O comando "Apagar" é utilizado para apagar o parâmetro selecionado. O comando "Organizar" automaticamente rearranja (classifica) os parâmetros, de forma que os parâmetros de retorno sejam colocados no fim da lista.


Other commands of the "Arquivo" menu
Outros comandos do menu "Arquivo"

Os seguintes comandos estão disponíveis no menu "Arquivo" de todos os editores de programas:

Abrir outro programa

Imprimindo o programa


Open another program
Abrir outro programa

O comando "Arquivo / Abrir" permite ao usuário fechar o programa que está sendo editado e iniciar a edição de outro programa do projeto selecionado com a mesma linguagem. Esta função não pode ser utilizada para editar um programa escrito em outra linguagem. O novo programa selecionado substitui o programa apresentado na janela de edição.


Printing the program
Imprimindo o programa

O comando "Arquivo / Imprimir" imprime o programa editado na impressora. Este comando automaticamente executa o gerador de documento ISaGRAF para imprimir o programa editado e variáveis locais anexadas.


Updating the program diary
Atualização do arquivo de diário do programa

O arquivo de diário atrelado ao programa editado podem ser inserido manualmente utilizando o comando "Arquivo / Diário". O arquivo de diário é atualizado automaticamente com mensagens de saída de verificação de sintaxe sempre que o programa é compilado. Saídas compiladas são completadas com a informação de data e hora da compilação.

Se o modo "Atualizar Diário" é selecionado no menu "Opções" do editor de programas, a seguinte caixa de diálogo é aberta sempre que o programa é salvo em disco.

Se o botão OK é pressionado, a nota de texto inserida é então armazenada no fim do arquivo de diário com informação de data e hora atual. Esta característica é muito útil para manutenção de programas completos, bem como fornece ajuda útil sobre o ciclo de vida de programa.


Selecting a variable from dictionary
Seleção de uma variável do dicionário

 Ao editar um programa texto (ST ou IL) o "Editar / Inserir variável" permite a seleção do nome de uma variável declarada a ser inserida na posição atual do sinal de circunflexo (^). Ao editar programa LD ou FBD, a seleção variável é requerida para a descrição de bobinas de contatos, bloco parâmetros de E/S ou caixas de variáveis FBD. Em ambos os casos, a seguinte caixa de diálogo é aberta para selecionar uma variável declarada:

A caixa de seleção "Escopo" é utilizada para selecionar entre variáveis globais e locais. A caixa de seleção à direita permite a seleção do tipo de dados. Ícones pequenos ao lado da caixa de seleção de tipo são botões que podem ser utilizados como atalhos para selecionar a maioria dos tipos de dados atuais;

Booleano

Inteiro / Real

Hora

Mensagem

Para selecionar uma variável, clique duas vezes sobre o seu nome na lista. São exibidos então o seu nome e o comentário no topo da lista. Pressione então botão "OK" para confirmar sua seleção. Também é possível entrar um nome de variável diretamente dentro do controle de edição sem utilizar a lista.

O controle de edição também pode ser usado para inserir uma expressão constante.


Commands of the "Tools" menu
Comandos do menu "Ferramentas"

Os comandos a seguir estão disponíveis no menu "Ferramentas" de todos os editores de linguagem. São utilizados para apresentar as informações em uma pequena lista texto na parte inferior da janela de edição e utilizada para a navegação pelo programa.

"Exibir saída do compilador"	apresenta na janela de incidentes as mensagens de erro da última compilação do programa editado.

"Localizar em diagrama"	localiza as ocorrências de um texto em todo o programa editado e as apresenta na janela de incidentes. Para as linguagens SFC e FC, este comando procura em todos os programas de nível 2.

"Esconder lista de saída"	fecha a janela de incidentes

Quando mensagens de erro ou ocorrências forem apresentadas na janela de incidentes, clique duas vezes sobre uma linha para mover a seleção diretamente para o local correspondente. Para as linguagens SFC e FC, este comando abre a janela de programação de nível 2 do elemento correspondente.