Open topic with navigation

Retain Variables

What is a retain variable?

A retain variable is a PLC"Programmable Logic Controller" A Programmable Logic Controller, PLC, or Programmable Controller is a digital computer used for automation of industrial processes, such as control of machinery on factory assembly lines. Used to synchronize the flow of inputs from (physical) sensors and events with the flow of outputs to actuators and events variable which:

• is non-volatile: stored in non-volatile controller memory (PDMM, PCMM, or AKC(PAC)). When using KAS Simulator the retain variables are stored in a normal disk file.
• is known by all programs (when its content is changed, the change is propagated to all equations in which this variable is used)
• normally does not contain real-time critical data.

• 
  
• • Retain variables are saved when you stop the PLC. The next time the PLC is started the retained values are used. Additionally, retains are auto-saved every two seconds. This applies to the PDMM, PCMM, and AKC(PAC"Programmable Automation Controller" PAC is a compact controller that combines the features and capabilities of a PC-based control system with that of a typical programmable logic controller (PLC). A PAC thus provides not only the reliability of a PLC, but also the task flexibility and computing power of a PC. Additionally, because they function and communicate over popular network interface protocols, PACs are able to transfer data from the machines they control to other machines and components in a networked control system) models.
  • Variables stored in non-volatile memory that have changed will be updated every two seconds. Unchanged variables are not updated.

Such a variable is used to store application specific data, like for instance to count a cutting-edge cycle in order to stop for its blade replacement after a specific number of iterations.

• On an application “Start”, KAS initializes the retain variables with the value stored in the NVRAM"Non-volatile random access memory" NVRAM is the general name used to describe any type of random access memory which does not lose its information when power is turned off. This is in contrast to the most common forms of random access memory today, which both require continual power in order to maintain their data. NVRAM is a subgroup of the more general class of non-volatile memory types, the difference being that NVRAM devices offer random access, like hard disks. The best-known form of NVRAM memory today is flash memory.
• On an application “Cold Start”, KAS initializes the retain variables with their default value.
• If the declaration of the retain variables is different between the non-volatile memory and the project, the retain variables are also reset to their default value.

Two parameters are checked to identify if the declaration changed:

• The number of variables of each type
• The length of a STRING type variables

• 
  

• The non-volatile memory size is hardware dependent. If the size of the retained variables is larger than the non-volatile storage space, an error will be logged and the data will not be stored in non-volatile memory. See NVRAM for more information.

For the KAS RuntimeIn computer science, runtime (or run-time) describes the operation of a computer program, the duration of its execution, from beginning to termination (compare compile time). Within KAS, runtime also refers to the virtual machine that manage the program written in a computer language while it is running Simulator, the retained variables are saved in a file in your project repository.

• 
  

• The following actions will reset retained value(s) to their Init value(s):

  • Changing the type of a retain variable
  • Changing the length of a string retain variable
  • Changing the size of an array variable
  • Changing any element of a structure variable

• 
  

• Retained variables should not be used as the output of FunctionA function calculates a result according to the current value of its inputs. A function has no internal data and is not linked to declared instances. Blocks. Doing so may cause problems with retaining the value if the FB is executed with the EnableEnable signal for the drive, Hardware-Enable with 24V signal to X8, Software-Enable command by setup Software, fieldbus or permanently set. Both are required for enabling the drive. input off. The output structure can cause it to be conditionally updated to zero or the old value.

  A work-around solution is to use a copy (1 gain) function to selectively enable updating the retain variable from an intermediate variable, which is the output of a function block.
  

  Work-around example

  In the following image ReadActualPositionX is continually reading position feedback from an axis, and the copy block is saving a specific value to a retain variable. ActualPositionX is the intermediate variable and SavedPositionX is the retain variable.

  

Stay Connected with Kollmorgen

Copyright © 2015 Kollmorgen™

Open topic with navigation