Nexto XF – #40 Criar lista de variáveis retentivas

O objetivo deste tutorial é explicar como criar uma lista de variáveis retentivas em um projeto do MasterTool X.

Componentes

Equipamentos: 1 computador/notebook.

Software:  MasterTool X

Seções do Tutorial

1. ARQUITETURA
2. DESENVOLVIMENTO

1. ARQUITETURA

Será necessário a utilização de um computador/notebook para utilizar o Mastertool X.

Figura 1. Computador executando o Mastertool X

2. DESENVOLVIMENTO

Variáveis retentivas são utilizadas quando se deseja que um valor não seja perdido em situações como:

• Desligamento do CLP
• Queda de energia
• Reset controlado da CPU

Ou seja, o valor da variável é mantido na memória não volátil e restaurado quando o controlador volta a operar.

Funcionamento das variáveis RETAIN

• O valor é salvo automaticamente pelo CLP
• Ao reiniciar, o valor anterior é restaurado
• Não é necessário código adicional para manter o valor
• A retenção depende dos recursos do controlador

O uso excessivo de variáveis retentivas pode impactar a memória disponível.

Quando utilizar variáveis retentivas

Utilize variáveis RETAIN para:

• Contadores de produção
• Estados de operação
• Parâmetros ajustados pelo operador
• Histórico essencial do processo

Evite usar RETAIN para:

• Variáveis temporárias
• Sinais instantâneos
• Lógicas que não precisam de histórico

Onde podem ser criadas variáveis retentivas?

As variáveis retentivas podem ser declaradas em qualquer escopo do projeto, sendo:

• Variáveis globais (GVL)
• Variáveis locais (UserPrg, subrotinas, blocos funcionais ou funções)

O ponto mais importante não é onde a variável está, mas a sintaxe correta de declaração.

Sintaxe para variáveis globais retentivas

Para criar variáveis globais retentivas, utilize o bloco:

VAR_GLOBAL RETAIN
    contador_total : DINT;
    estado_sistema : BOOL;
END_VAR

Todas as variáveis declaradas dentro desse bloco terão retenção de valor.

Figura 2. Criação das variáveis globais e retentivas

Sintaxe para variáveis locais retentivas

Em UserPrg, subrotinas, blocos funcionais ou funções:

VAR RETAIN
    tempo_operacao : TIME;
    ciclos_execucao : DINT;
END_VAR

Essas variáveis manterão seus valores mesmo após desligamento ou reset.

Figura 3. Criação das variáveis locais e retentivas

Boas práticas

• Utilize RETAIN apenas quando necessário
• Nomeie claramente variáveis retentivas
• Documente o uso com comentários
• Prefira GVL para dados retentivos compartilhados

Conclusão

As variáveis retentivas (RETAIN) são fundamentais para garantir continuidade e confiabilidade do processo, permitindo que informações importantes sejam preservadas mesmo após desligamentos, desde que utilizadas com critério e boa organização.