Controllers

A controller corresponds to a programmable logic controller. Add controllers to existing projects.
Specify these properties for controllers:
Property
Description
Code
Code For Simulation
Produce code for simulation for an application
Compiler Options
Each controller has defined compiler options. The Code Generator uses these parameters to to build and optimize the controller code. In the Compilation Options for a controller, select the type of code to generate according to corresponding equipment and set up the optimizer parameters according to the expected compilation and run-time requirements. The general compiler options are:
  • Check Array Index
    - (Read-only) Verify array indices
  • Dump Configuration Files
    - Generate controller level files containing debugging information and place them at the root of the controller folder. Names the files using the controller name as a prefix with .ttc and .tws as extensions.
  • Dump Network
    - Generate network and controller level files containing debugging information. Places the files at the root of the network folder and at the root of the controller folder. The files in the network folder are named "NetworkConf" and have the extensions .ttc and .tws. The files in the controller folder are named using the controller name as a prefix and have .ttc and .tws as extensions.
  • Dump POU Files
    - Generate controller-level files containing debugging information and place these at root of the controller folder. Names the files using the controller name as a prefix, the program organization unit (POU) name as a suffix, and the extensions .ttc and .tws. Names other files using the POU name with .lst and .unc as extensions.
  • Enable Compiler Verification
    - Validate the compilation process for all POUs of a controller. Comparison errors display in the
    Output
    window.
  • Function Internal State Enable
    - Produce internal state information for functions. Functions containing no internal state information denote that the invocation of a function with the same arguments always yields the same values.
  • Generate Map File
    - Generate controller-level files containing debugging information. Places the files at the root of the controller folder and names these using the controller name as a prefix with .ttc, .tws, and .map as extensions.
TIC Code
(Read-only) Compiler produces TIC code
General
Battery Alarm
For the 9110 processor module, enables the battery alarm informing of a low voltage for the battery and need for replacement. For standard and mixed controllers, the default value is enabled. For Eurocard controllers, the default value is disabled.
Remote Fault Reset
Resets faulty processors from a remote location and joins processors to a running system. To enable, enter a non-zero hexadecimal value matching the value of the control integer
Allow Remote Fault Reset
. Possible values range from 0x1 to 0xFFFFFFFF, or 0x0 to disable.
Hardware
Memory IO Structures
Memory space allocated for I/O structures. The default value is 150000 bytes.
Memory Size
Space reserved for monitoring variables, constants, and temporary compiler variables
Target
(Read-only) Target type to which is attached the controller
Update I/O Device Online
For targets supporting online changes, enables modifying I/O devices and structures while running an application online.
After an update, the module is configured but not connected. Press
Fault Reset
on the AADvance controller or perform a remote fault reset from
AADvance-Trusted SIS Workstation software
to connect the I/O module to the running system. The faults disappear and the connection is successful.
Info
Comment
Plain text
Compilation Version
(Read-only) Compilation version number
Description
Rich text
Full Name
(Read-only) Full name of the controller indicating the project to which it belongs
Last Compilation Date
(Read-only) Date of the last compilation of the controller code
Name
(Read-only) Name of the controller. Controller are limited to 128 characters beginning with a letter followed by letters, digits, and single underscores. The last character for a controller name must be a letter or digit; controller names cannot end with an underscore character. Reserved words, defined words, or data types such as, elementary, structures, or arrays are not valid names. The same type of elements within a scope must have unique names.
Number
Unique number identifying the controller within the project. Also known as the resource number in
AADvance Discover
. This number is automatically assigned. When changing the number, assign a value that is unique within the project. The resource number identifies the physical AADvance controller that runs the application code.
Password Protected
(Read-only) Controller is protected by a password controlling its access
Path
(Read-only) Complete path where the controller files are stored on the computer. The path is automatically assigned to a controller folder within the project folder.
Memory Size for Online Changes
Code Size
Defines the amount of memory that is reserved for all updates on the controller. The
Code Size
value can be increased up to 1441640 bytes.
The total usage of the controller memory space is the sum of the
Code Size
value and the length of the controller name, project name, and POU names.
For example, controller memory space usage can consist of these values:
  • Project name with 8 characters
  • Controller name with 11 characters
  • POU name with 5 characters
  • Code Size
    value of up to 1441640 bytes
Or
  • Project name with 32 characters
  • Controller name with 24 characters
  • POU name with 21 characters
  • Code Size
    value of up to 1441384 bytes
Maximum Extra POUs
Maximum number of POUs (other than SFC) that can be added while performing updates
SFC States Mem Size
The memory space allocated for step and transition structures. A step requires 40 bytes and a transition requires 20 bytes.
User Variable Size
For updates, the amount of memory reserved for adding variables data. When generating monitoring symbols information for a POU, the same amount of memory is also reserved for the POU.
Safety
Process Safety Time
The maximum time, in milliseconds, that the controller outputs remain in the ON state after detecting important diagnostic or application faults. The outputs go into their specified safe states when exceeds the defined PST. Set the PST for the controller. The default value for the controller is 2500 ms. By default, each group of I/O modules inherits the PST from the controller. Also set an alternate PST for each I/O group.
Settings
Cycle Time
Amount of time given to each cycle. If a cycle is completed within the cycle timing period, the system waits until this period has elapsed before starting a new cycle. The cycle consists of scanning the physical inputs of the process to drive, executing the POUs of the controller, then updating physical outputs. The virtual machine executes the controller code according to the execution rules.
Cycle Time Units
Unit of measure for the cycle time. Possible values are ms (milliseconds) or µs (microseconds). To use µs, the equipment must support this unit of measure.
Detect Errors
Store errors. Define
Nb Stored Errors
.
Memory for Retain
Location where retained values are stored (the required syntax depends on the implementation).
TIP: Do not edit the
Memory for Retain
property.
Nb Stored Errors
Number of entries. For example, the size of the queue (FIFO) in which detected errors are stored
Start Simulation Mode
Controller executes in real time or cycle-to-cycle. Real-time mode is the run time normal execution mode where the cycle timing triggers the controller cycles. In cycle-to-cycle mode, the virtual machine loads the controller code but does not execute it until execute one cycle or activate real-time mode. When generating debug information for POUs, the controller automatically switches to step-by-step mode when the application encounters a breakpoint.
Trigger Cycles
Controller cycle executes according to the defined
Cycle Time
SFC Dynamic Behavior Limits
Gain Factor
For Sequential Function Chart (SFC), specifies factor of dynamic behavior limits determining the amount of memory, allocated by a controller at initialization time, designated to manage token moving. The amount of allocated memory is calculated as a linear relation with the number of SFC POUs:
Alloc Mem (bytes) = N * NbElmt * sizeof(typVa)
NbElmt = GainFactor * NbOfSFC + OffsetFactor
Offset Factor
For SFC, specifies factor of dynamic behavior limits determining the amount of memory, allocated by a controller at initialization time, designated to manage token moving. The amount of allocated memory is calculated as a linear relation with the number of SFC POUs:
Alloc Mem (bytes) = N * NbElmt * sizeof(typVa)
NbElmt = GainFactor * NbOfSFC + OffsetFactor
System
System Type
Type of the controller. Possible values are:
  • Standard, (AADvance controller) configuring 48 empty IOB IO slots for I/O modules (IOB IO Bus 1 and IO Bus 2)
  • Eurocard, configuring 18 empty slots on IOB Bus 1
  • Mixed, configuring 48 empty IOB IO slots for I/O modules (IOB Bus 1 and IO Bus 2).
Perform these tasks for controllers:
Task
Procedure
Add a controller
  • In the
    Application View
    , right-click the project element, point to
    Add
    , and then select
    New Controller
    .
Export a controller
Export controllers as exchange files (*.pxf).
  1. In the
    Application View
    , right-click the controller and then select
    Export...
    .
  2. In the
    Save Controller As
    dialog box, browse for the location in which to store the exchange file, then select
    Save
    .
Add an existing controller from an exchange file
  1. In the
    Application View
    , right-click the
    Project
    element, point to
    Add
    , and then select
    Existing Controller...
    .
  2. In the
    Select Exchange File
    dialog box, locate the exchange file containing the controller, and then select
    Open
    .
  3. In the
    Add Existing Controller
    dialog box, select the element to import, and then select
    Import
    .
    TIP:
    • The SNCP binding links for the controller are not imported.
    • After importing a controller, select one element only in the
      Application
      View
      before performing a check-in.
    • Avoid renaming program organization units (POUs) in the
      Import
      dialog box when importing. Renaming may cause a loss of function block references. Rename the POU from the
      Application
      View
      .
    • Importing
      AADvance Workbench
      version 2.0 .pxf exchange files does not import CIP bindings and generates build errors in the Error List. Recreate CIP bindings in
      AADvance-Trusted SIS Workstation software
      or import a project from an .mdb file.
Set properties for a controller
  • In the
    Application View
    , right-click the controller, and then select
    Properties
    .
Copy and paste a controller
  1. In the
    Application View
    , right-click the controller, and then select
    Copy
    .
  2. Right-click the project element and then select
    Paste
    .
Rename a controller
  • In the
    Application View
    , right-click the controller, then select
    Rename
    , and then type a name for the controller.
Delete a controller
If a
CIP
consumer link is defined for a controller and the controller is deleted before adding
CIP
links to other controllers, close and then reopen
AADvance-Trusted SIS Workstation software
.
  • In the
    Application View
    , right-click the controller, then select
    Delete
    .
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal