SCP User Guide
SCP User Guide
User Guide
SimSci
November 3, 2014
Invensys, Active Factory, AIM* Historian, ArchestrA, DYNSIM, Foxboro, FoxSelect,
FoxView, I/A Series, SimSci, and Wonderware are trademarks of Invensys plc, its
subsidiaries, and affiliates.
Before using the Invensys Systems, Inc. supplied software supported by this
documentation, you should read and understand the following information concerning
copyrighted software.
The license provisions in the software license for your system govern your
obligations and usage rights to the software described in this documentation. If
any portion of those license provisions is violated, Invensys Systems, Inc. will no
longer provide you with support services and assumes no further responsibilities
for your system or its operation.
All software issued by Invensys Systems, Inc. and copies of the software that you
are specifically permitted to make, are protected in accordance with Federal
copyright laws. It is illegal to make copies of any software media provided to you
by Invensys Systems, Inc. for any purpose other than those purposes mentioned
in the software license.
User Guide Overview
Table of Contents
User Guide Overview 4
Purpose ............................................................................................................ 4
Getting More Information ................................................................................. 4
Glossary ........................................................................................................... 5
I/A Series and Foxboro Evo Control Updates 9
Introduction to SCP Software 10
Foxboro Evo Functional Description with SCP 12
Architectural Overview of a Foxboro Evo Process Automation System ........ 12
Control System Network Architecture 13
Control System Hardware Architecture ......................................................... 14
I/A Series and SCP Software Architecture .................................................... 14
SCP Standalone Components 17
SCP Engine 18
SCP Application and Launcher 20
SCP Application ............................................................................................. 20
SCP Launcher ................................................................................................ 20
SCP Launcher Toolbar .................................................................................. 21
Creating a new Simulation Configured System ....................................... 21
Opening an Existing Simulation .............................................................. 22
Starting an SCP Instance ........................................................................ 23
SCP Console messages ......................................................................... 23
SCP Instance Options ............................................................................. 24
Multiple SCP instance Startup Shutdown scenarios ............................... 25
Viewing the Console Window .................................................................. 26
Creating a batch file to start multiple SCPs using Export ....................... 26
Delete Local Checkpoint ......................................................................... 27
Settings Menu.......................................................................................... 27
Accessing the Help Menu ........................................................................ 27
Shutting Down or Rebooting an SCP Application ................................... 27
Enhanced Graphical User Interface Features 29
Graphical User Interface ................................................................................ 30
System Health Monitor ................................................................................... 31
Snapshot Update ........................................................................................... 31
Engine Malfunction Tools............................................................................... 32
Scenario Record and Playback ..................................................................... 32
Cross Reference Database............................................................................ 34
Introduction .............................................................................................. 34
Invoking the Cross Reference Generation tool ....................................... 35
Database Structure ................................................................................. 37
Analog Points .................................................................................... 37
Digital Points ..................................................................................... 38
I/O Control Blocks ............................................................................. 39
Initialize .......................................................................................................... 93
Upload ............................................................................................................ 94
Download / Deploy / Checkpoint .................................................................... 94
Loading the Control Database using the ICC 95
Loading Controls through the ICC ................................................................. 95
Loading Controls through the API Command Line ........................................ 97
Saving the Control Database Using the ICC 98
Overview ........................................................................................................ 98
Saving the Control Configuration through the ICC ........................................ 98
Saving the Control Configuration with an API Command .............................. 99
Configuring the IACC 100
Installing the IACC ....................................................................................... 100
Starting the Application ................................................................................ 102
Exporting an IACC Database ....................................................................... 103
Importing a Pre-existing IACC Database Export File .................................. 104
Validating and Downloading CPs in IACC ................................................... 107
Checkpointing CPs in IACC ......................................................................... 109
Uploading CPs in IACC ................................................................................ 109
Foxboro Evo Engineering Environment 111
System Definition Committal through Foxboro Evo ArchestrA IDE ............. 113
Creating an Equipment Unit ......................................................................... 113
Deploying the Equipment Unit ..................................................................... 113
Importing SaveAll Controls .......................................................................... 114
Importing an Automation Object .................................................................. 115
Synchronizing Unit Equipment Deployment State ....................................... 116
Compiling PLBs and Sequence Logic ......................................................... 116
Controls Loading Checklist 117
Supported Foxboro Evo Control Blocks 118
Input/Output ................................................................................................. 118
Device Control ............................................................................................. 121
Regulatory Control ....................................................................................... 122
Selection, Ramping, and Dynamic Compensation ...................................... 124
Computation, Logic, and Conversion ........................................................... 124
Alarm ............................................................................................................ 126
Sequence ..................................................................................................... 127
Data Storage ................................................................................................ 128
Unsupported Control Blocks and Platforms 129
FD / Gateway blocks .................................................................................... 130
I/O Gate blocks ............................................................................................ 131
Scan blocks .................................................................................................. 132
Foxboro Evo Software Helpful Hints 133
Uploading Controls in the ICC ..................................................................... 133
Multiple PLB blocks configured to same ECB device .................................. 133
Packing FoxView Graphics .......................................................................... 133
SOM ............................................................................................................. 134
Purpose
This User Guide provides an overview of I/A Series®/Control Core Services software as it relates to SCP. It
includes descriptions of common procedures associated with configuring a simulator for controls checkout and
details of specific SCP features.
SCP software is a uniquely comprehensive I/A Series Foxboro EvoTM Control Core Services control system
checkout and simulation tool. SCP software functions as a perfect double to an I/A Series/Control Core Services
Control Processor, enabling faster control system commissioning, superior system design quality, reliable
operator training, and cost-effective system retrofits. The SCPEngine that replaces the control processor is tied to
a “lite” version of the DYNSIM® process-modeling package. The instrument and control signals that link the two
pieces together are managed with the cross-reference database utility built into the DYNSIM Graphical User
Interface (GUI). This guide contains an overview of the Foxboro Evo control system as it relates to the SCP
process-modeling package, including common procedures such as loading and saving controls, typical simulation
use cases, and features in the DYNSIM Graphical User Interface environment that relate to SCP software.
The SCP User Guide and SCP Installation Guide are available on the product installation CDs.
SCP-specific documentation can be accessed In PDF format when the software is installed, or from the Global
Customer Support (GCS) website Support tab: https://support.ips.invensys.com/home.asp
Additional SimSciTM specific documentation and downloadable software is available at the SimSci Electronic
Software Download website: http://www2.simsci.com/sim4me/esd/login.asp
Foxboro® specific documents are available on the I/A Series Electronic Documentation DVD. The latest revisions
are available through the GCS webpage: http://support.ips.invensys.com.
Glossary
Glossary
aqPKG File extension for a file exported from the ArchestrA® IDE that may
contain control logic, graphics, or other templates.
Checkpoint file The control database that resides on the host workstation, which is
downloaded to the FCP270/FCP280/ZCP270
Control Block Data structure in the operating system kernel containing information
need to manage a particular process. Examples include AI, PLB, and
CALCA. See Page 118 for a list of supported Foxboro Evo control
blocks and their definitions.
Control Database The I/A Series control system database processed by the control
software. This database consists of compounds and blocks, and is
configured using the I/A Series control system database configurator,
such as the ICC, IACC, or FCS
ICC Driver Task A set of useful scripts to generate reports, load/save controls, or modify
controls in the ICC using API calls. Uses a library to interpret
commands from a user-specified input file.
I/O Input / Output represents the physical communication to and from the
Control System and plant thermocouples, pressure transmitters,
actuators, etc. that control plant operation.
LoadAll An ICC Driver (iccdrvr) task command used to load controls to the ICC
via an API call.
LR Local/Remote
MA Manual / Auto
MESH The network between every machine with Foxboro Evo software
installed.
OS Operating System
Peer-to-Peer (P2P) The control block mechanism that uses OM lists to refresh its block
Connection inputs with data from a remote station. That data connects CIO, OM, or
AO objects. For most control strategies, peer-to-peer connections exist
between CIO objects. The “sink” block requests data from the “source”
block. A block connection is normally local to another block that exists
in the same CP. However, the full path name defined for a block
parameter can connect to a CIO object that is in another CP. This
remote type of connection is referred to as a peer-to-peer block
connection.
Save All ICC Driver Task (iccdrvr) command used to save controls from the ICC
via an API call
Station (Control The ‘virtual’ controller which runs as one or two CP modules. For
Station) example, the station may exist on both fault-tolerant modules, but the
station itself is considered a single entity.
Process Alarms Alarm Manager InTouch alarm control InTouch alarm control
Alarm Historian AIM* Historian SQL Server database SQL Server database
software
Distributed I/A Series I/A Series software Foxboro Evo Control Core
Control System / software Services
Process
Automation
System
The control system configuration from the plant loads directly into the SCP application running
FCP/ZCP stations, using the same procedures used to download a configuration to an actual CP.
This occurs regardless of whether using the Integrated Control Configurator (ICC), I/A Series
Configuration Component (IACC), or Foxboro Evo.
SCP optionally connects to the DYNSIM Dynamic Simulation Suite (DSS) infrastructure for
simple-tieback or process modeling capabilities. This DSS infrastructure and a “lite” modeling
engine, DYNSIM-L, is provided and licensed with SCP. DYNSIM software features operator
training and engineering analysis capabilities as standard, such as Freeze/Run, and Save/Restore
of snapshots. Additional library sets or other simulator engines can be included to extend the
simulator for high-fidelity simulator training and optimization.
Standalone, in which the SCP instances run in real time, just like real CPs (No DSS
infrastructure required)
On multiple computers, for large projects that require more than 25 CPs (in which a
multi-computer configuration with two or more SCP computers is designed to replicate
the actual plant HMI and configuration), with or without the DSS infrastructure.
The Operator or Engineering Workstation computer (AW/WSTA) provides the primary operator
interface to the control system emulation for configuration, monitoring, and interaction with the
controls, while the SCP computer provides the interface to the control emulation and the process
model. The figure below displays a typical simulator configuration for a Foxboro Evo system.
WARNING! The SCP and DYNSIM simulation computers should never be connected to a
production Mesh network. In addition, it is recommended that the simulation system is not
connected to any corporate or business network.
The SCP computer executes the SCP Engine on either Windows 7 64-bit (Professional or
Enterprise) or Windows Server 2008 R2 64-bit (Standard).
The DSS environment, or Instructor Station, can reside on several Windows Operating System
(OS) environments. Review the DYNSIM Release Notes for specific supported OS details. In a
multi-computer configuration, the host WSTA is connected to the SCP. CPs deploy through the
control configurator (ICC/IACC/Foxboro Evo). The control configurator (or WSTA) provides the
primary operator interface to the control system emulation for configuration, monitoring, and
interaction with the controls. The CPs within the SCP computer communicate with each other
through Foxboro Evo software.
Warning: Do not switch between login users while using SCP software, as the files created by
one user cannot be used by others.
The Foxboro Evo Process Automation System (PAS) is comprised of a suite of Control Stations
and other devices interconnected through a MESH network. Control Stations can include
WSTA70/ WSVR70 that hosts CPs, Historical Database servers and collectors, or, in the case of
Foxboro Evo, a Galaxy repository. Operator Stations are used to control plant processes
predefined in control system strategies, compounds, and blocks that reside on CPs.
CPs connect to the MESH network and to one or more Fieldbus Modules (FBMs) to perform
logic, sequential control, data acquisition, alarm detection, and alarm notification. CPs execute
control algorithms composed of control blocks. These control blocks are organized into a
container called a compound. Multiple compounds can reside simultaneously on a single CP. If
using Foxboro Evo, related compounds are grouped to form a strategy.
An FBM is a simple processor that connects a number of process sensors or actuators to a CP.
The FBM allows CPs to communicate with remote FBMs for further geographical distribution of
functions in the field.
For SCP, both the CPs and the FBMs are removed from the offline system and replaced with one
or more SCP computers. SCP emulates the FBM logic.
For the simulation, the physical CPs are replaced by SCP. Additionally, the redundancy is
removed: only one switch is required between the Foxboro Evo systems and the SCP(s).
Networked Foxboro Evo stations can include WSTAs, Host Workstations, CPs, Historian
Server(s), Historical Data Collector(s), Galaxy Database Repository Server(s), or a primary
domain controller. A WSTA or an Operator Station monitors processes; displays real-time data,
trends and alarms; and acts as the primary HMI machine. A real plant may include dozens of
WSTAs, but the simulation suite may combine the functionality of several WSTAs to reduce
simulation suite costs/size.
The Host Workstation hosts the Foxboro Evo Control Stations. It can act as an HMI as well as an
Engineering Workstation and can be used to create or modify displays, view and manage alarms,
configure control blocks, and monitor the health of the control system.
Historian Servers contain either the AIM* or WonderwareHistorian software. The Historian
Server is typically dedicated solely for this purpose (and not combined with other functionality)
to ensure that historical data is accurately time-stamped. For smaller simulations, the historian
server may reside on WSTA.
With the Wonderware Historian, Historical Data Collectors are WSTAs, but typically reside on
computers separate from the Historian Server and are not used for any other purpose (e.g.
controlling the plant). In a simulator, this functionality can combine on to a reduced set of
WSTAs.
The Galaxy Database is associated with Foxboro Evo. In an actual PAS, this machine is used
solely for this purpose and is not combined with any other functionality, such as the Historian
Server or Operator Station. In a simulator, this functionality can combine on to a reduced set of
WSTAs.
SCP software interacts with Foxboro Evo stations through the Object Manager (OM), Alarm
Manager, Historian processes, and other compound processor tasks.
The Foxboro Evo control program is stored as a set of “compounds,” which are containers for a
collection of blocks that perform control strategies. Compound functions include process alarm
priority, sequence status notification, and phasing to level processor loading. Blocks are
predefined process functions or algorithms that perform calculations. Blocks contain parameters
that have values of types Real, Boolean, String, etc. and have one or more input/output. Block
examples include ladder logic, sequential control, or I/O.
When a new control configuration or strategy is loaded, the Compound Summary Access (CSA)
task (CSA_Server) residing on the Host WSTA checks to ensure compound name uniqueness, and
then creates a unique Configurator Database for each Control Station. The Host WSTA also
includes a Station Manager Application Task (smat) that checks the system health and station
status.
The remaining tasks described in the following paragraphs are threaded tasks within the SCP
application unless otherwise noted. The DB_Query (dbquery) task performs several types of
queries on the Compound Database on behalf of a remote client. Queries are typically performed
through FoxSelect/BlockSelect.
As the controls are loaded, DB_Install (dbinstl) copies the Configurator Database to control
memory, installing the specified Compound Database on behalf of a remote client. This database
downloads to the appropriate CP at the request of the ICC/IACC/Foxboro Evo.
The Compound Processor (cio_cp) executes the control strategies, input/output (I/O)
implementation, timing, regulatory, and feedback applications. It performs most device I/O, and
controls block processing. This process is associated with simulation time. In simulation, this
process pauses execution when the simulation freezes or is shut down. If the simulator runs in
“fast time,” cio_cp runs at the same “fast time” speed. This process must run through a block
cycle when initially loading controls. For this reason, after loading controls, checklist-type
instructions always tell the user to run the simulator.
Download (downld) is the first task called when the CP initializes. It establishes communication
between the CP and the hosting WSTA. As with a real CP, the SCP copies the checkpoint file
into control memory at startup. After the System Manager detects the CP, the Download process
terminates.
Compounds and blocks reside in the control database, which is the CP memory resident database
that resides on each CP in the SCP computer. The checkpoint file is associated with this database.
When a CP reboots, it automatically restores the CP database using the checkpoint file. As with a
real CP, an SCP instance automatically restores a checkpoint file when it starts.
Data from field devices and FBMs interface the control blocks through Equipment Control
Blocks (ECBs). An ECB is a data structure that holds the field data and its status. A Compound
Processor processes all input ECBs, executes the compounds and their associated blocks, and
then processes the output ECBs. I/O control blocks read or write their I/O values directly to and
from ECBs.
SCP processing stops at the ECB level. For this reason, it is not possible to fail FBMs for
hardware test purposes using the standard Graphical User Interface. However, FBM failure can
be simulated through the DYNSIM interface. Additionally, some blocks (i.e., AI/AO/DI/DO)
obtain status directly from the FBM. For SCP software, this status is always reported as good or
unknown. The SCP software includes an emulation of several blocks and ECBs that execute
directly in their FBMs, including PLB, MDACT, GDEV, and DCI output blocks.
External to the SCP application, the Foxboro Evo alarm tasks run on every system running
FoxViewTM (foxview). Foxboro Evo Control HMI alarm tasks differ and are not covered in this
manual (refer to the Foxboro Evo Simulation User Guide). The main server process is the Alarm
Manager (am). An alarm message is generated whenever the block detects a value has gone
beyond the specified limit. Alarm messages can cause the Alarm key to flash, be logged by the
Historian, and be printed, depending on the assignments made for the block's alarm group
parameter and the group/device compound parameters. Alarm limits can be assigned from the
Configurator or from the Block Detail Display.
In the SCP application, the Msg_Proc (msgproc) task monitors control memory for alarm
message formatting in control blocks and calls Alarm Print to dispatch the message. The Alarm
Print (aprint) task dispatches alarm messages to various alarm logging devices, workstations,
historians, and applications. External to the SCP, the Alarm Alert (aaserver) is responsible for
reporting the local CP availability to the Device Monitor. The Alarm Alert subsystem manages
the Keyboard Annunciator Panel and handles the current alarm state. Three possible alarm states
include acknowledged, unacknowledged, and normal.
A standalone application, in which an SCP replaces a real CP and executes in real time
An engine that connects to the DSS infrastructure, where simulation time is controlled
and simulation engine execution is coordinated with other applications or engines.
SCP application
SCP Launcher
SCPEngine
FAIM Engine
SimSync Engine
SCP Engine
The following options control the behavior of SCPEngine:
Directory path The directory where SCPEngine stores the Blank: SCPEngine
for initial database files for an IC stores the IC data
condition (IC) in the simulation
files directory
Path to Scenario The directory where SCPEngine looks for the Blank.
watch point file. scenario file.
Debug Level 1
(0,1,2,3)
Disable 0
Processing SCP
Malfunctions
(1=yes)
Number of 3
publishing rounds
to find SCPs
SCP Application
The SCP application (SCPapp) performs identically to that of a real CP. It executes the control
strategies, sends and receives data, and controls and regulates processing time. The tasks
described in the previous section are contained in this application.
The SCP application starts and stops from SCP Launcher. Each instance of the SCP application is
equivalent to a real CP. Currently, 40 instances of SCP can execute on a single SCP computer
platform.
SCP Launcher
SCPLauncher is a user interface that manages SCP instances. Features include Start, Shutdown,
Reboot, FastLoad, Logging, and Local Checkpoint. Each of these functions is described in detail
in the following sections.
Through this GUI, create a new SCP configuration system (as an .xml file) and save this list to a
permanent location. The application loads an IIF.prm file to obtain the list of SCPs configured as
part of the Foxboro Evo System Definition (SysDef). This file can be found on the WSTA in the
D:\usr\fox\sp directory.
The Play button launches SCP from the SCP Launcher and brings it to “Active”
state.
The Shutdown button stops SCP and changes its state from “Active” to “Available.”
The Reboot button restarts SCP. The SCP goes to “Rebooting” state and comes back
to “Active” state.
The Export button exports the list of selected SCPs and creates a batch file under a
custom path. Using this batch file the list of SCPs can be launched even without SCP
Launcher GUI.
The Delete button deletes the local checkpoint file of the SCP, which is in Shutdown
or Available state. The checkpoint file is available at the following path C:\ Users\
<User> \Documents \SimSci \SCP \1FP001.
1. Click the New button in the GUI, or choose New SCP Configured System from the
File menu. The Create New Simulation window appears.
2. Enter a name in the SCP Configured System Name text field to identify this
configuration.
3. Enter the IIF.prm location by clicking the ellipsis (…) button to browse to the location
containing the file (pictured below). Select the IIF.prm file, and then click Open.
4. Browse to the IIF.prm file (copied from the WSTA machine), and then click Open. The file
path updates in the Create New Simulation window.
5. Click Save. This creates a new simulation file (in this case, Test1.xml) under the default
directory “C:\Users\<User Name>\Documents\SimSci\SCP\Data”.
1. Click the drop-down button in the Launcher as shown below, and select the appropriate file
from the list of already saved XML files. The launcher will open the file you have selected.
The XML files are invoked from C:\Users\<User Name>\Documents\SIMSCI\SCP\Data.
button. The status of the CP you select must be “Available” for a successful launch.
An instance of SCP appears when Show Window is clicked on the Settings menu. On the
SCPLauncher, the Start button becomes unavailable if the CP is being launched or has already
been launched.
The first message gives the summary of the SCP Type, Letterbug, MAC address, launch date, and
launch time of the SCP.
The next message gives the Loading Details of the Checkpoint file. The Checkpoint file is loaded
from the CP host or from the Local checkpoint saved in the SCP machine, based on the option
selected in the SCPLauncher GUI.
Once the blocks are downloaded, SCP goes online and displays the message below.
Once the “SCP is simulation ready” message appears, the SCP starts running in the “Real time”
mode. Until SCP is hooked to a simulation, it continues running in the “Real time” mode.
Default Settings:
The Default Settings will start an SCP instance identically to a real CP: it takes about four minutes for
the CP to start all peer-to-peer, or Object Manager (OM), connections that are found are connected.
Restarting the CP will restore the checkpoint file from the CP host (not a local copy). Use the default
settings when building a new control system.
FastLoad:
Local Checkpoint:
A local Checkpoint file will be saved on the SCP machine under “C:\Users\<User
Name>\Documents\SimSci\SCP\<CPName>\ DBFC<CPName>.UC
The SCP application will be launched from the local checkpoint file and not from the
remote CP Host machine.
Logging:
To shut down multiple SCP instances, select them from the SCPLauncher list and click the
Shutdown button. Verify that the console windows of each SCPapp disappear, and the SCPs’
“Status” has changed to “Available.”
In SCPlauncher, open the XML file, which is configured with the correct IIF.prm file, from the
following location: “C:\ Users\<User>\ Documents\ SimSci\ SCP\ Data.” Select the SCPs that
need to be launched with the appropriate option: Fast Load, Logging and Local Checkpoint; and
then click the Export button. ( ). A batch file is created and an explorer window opens that
points to the ..\Data path where the xml files are stored. The batch file has the default name as
that of the XML file, which can be modified as per the user requirement.
The saved batch file can be used to launch multiple SCPs even without opening the
SCPLauncher. You may modify the batch file to improve readability. Refer to the sample shown
below.
The sample image below stops the SCP application from a batch file.
in “Available” state, then select the SCP and click Delete . The following message
appears as a confirmation of the deletion.
Settings Menu
On the Settings menu, you can set options such as Themes, Show Windows, and Logging.
Themes provides 3 options: Dark, Light, and Window. The look and feel of the Launcher
changes based on the settings.
Dark Theme gives a dark background to the SCPLauncher and highlights the selections
with the green color.
Light Theme gives a grey background and highlights the selections with the grey color.
Show Window shows the Console window of the SCPapp when an SCP is launched. Turn off the
Show Window option to hide the console window.
Logging logs the events captured in the SCPapp console window into a text file at the following
path: C:\Users\<User>\Documents\SimSci\SCP\Logs\<SCPname>.txt. Do not enable logging
unless you suspect a problem with the software.
To access the help documents, on the SCP Launcher menu, click the help button .
On a Shutdown or Reboot action, the console window of the SCP will disappear and the SCP’s
Status will change to Available or Rebooting, respectively. In addition, every reboot action
deletes the local checkpoint (if there is a local checkpoint file in SCP) and you are shown the
following message.
DYNSIM-L engine Configure a DYNSIM-L engine for simple tieback and flow
network modeling capability.
The SCP standalone components are covered in the previous section. This section covers SCP
configuration as an engine to the DSS infrastructure, including data transfer through the cross
reference list and the graphical user interface.
Several guides are available that provide an introduction to the DSS GUI, how to generate a low,
medium, or high fidelity process model. GUI functionality that is unique to SCP is covered in the
remainder of this section.
The “System Health Monitor” feature of DYNSIM software is not packaged with the Control
Emulation “typical” install of DYNSIM 5.2. Navigate to Program and Features >
SimSci DYNSIM 5.2 > Change to add this feature post-installation.
Note:
Perform the above steps to make “System Health Monitor” feature work with DYNSIM-L engine.
See System Health Monitor section in “Dynamic Simulation Suite User Guide” to use this feature
for SCP.
Snapshot Update
After controls are modified, ensure that the update appears in FoxView and functions as expected,
then verify that the CP has been checkpointed. When restoring a snapshot taken before the
update, SCP will keep the new, updated checkpoint file, but populate the dynamic data, or the
settable and connectable parameters in to the new checkpoint file. The user should re-save the
snapshot when satisfied that it functions as desired.
Unlike former product features, the snapshot update feature does not depend on a specific
DYNSIM or Foxboro Evo version. You can update snapshots from SCP v1 to future SCP
versions. Moving to a different hardware suite that might contain different computer names will
not impact snapshot restore.
Note 1 – A limitation for CALC / CALCA / MATH / LOGIC related control parameters:
The memory (M01 to M24) parameters can be edited in the configurator and can be set during
run time operation. In this case, the update will copy the memory values from the original
snapshot to the target snapshot because changes made in the configurator are lost. Two
workarounds exist:
Restore each snapshot, manually change the value directly in the Detail Display, and
resave each snapshot.
For more details about the Connectable/Settable parameters of a block, refer to the Integrated
Control Block Descriptions Vol. 1-3 (B0193AX) and for each block open the Parameters Section
Table’s Accessibility column.
SCP Malfunction is performed using the DYNSIM GUI. The purpose of this section is to
describe the SCP Malfunctionable features using Engine Malfunction Tool. The SCP FBM
Malfunction feature includes two failure modes:
For the basics of setting up and using Engine Malfunction Tool please refer to the Malfunctions
section in the SCP Getting Started Guide
SCP engine Scenario Recording requires a pre-existing file (for example, scpeng.sce) populated
with Foxboro Evo watch points. The default filename, scpeng.sce, is modifiable through the SCP
engine configuration window. This name should match with the name of the file physically
available in current working directory on the machine where the SCP engine resides (e.g.
C:\SIMSCI\DSS5x\Simulations\<simulation name>).
The Foxboro Evo points entered in this file record when specific conditions are met, as explained
below.
The scenario-enhanced feature considers the auto/manual & local/remote states of the current
point. Points record if the specified options in the scpeng.sce file match the current block state.
The syntax for the Foxboro Evo point entry in the scpeng.sce file is shown below:
FIELD1,[FIELD2],[FIELD3],[FIELD4]
FIELD1 – The point name to be recorded
FIELD2 – Tolerance
FIELD3 – Auto/manual option (A or M)
FIELD4 – Local/Remote option (L or R)
Note: Any entry other than the above produces the “Invalid Option Specified” error.
DEMO:B5.PNT, 0.1, A, L
If any value for Local/Remote or Auto/Manual does not match the state of the corresponding
block, the point is not recorded. For instance, if DEMO:B5.PNT is in manual, the point is not
recorded.
The following table provides possible combinations for the Foxboro Evo points in scpeng.sce file
with DEMO SaveAll.
Demo:B5.MEAS,0.0 Point with Tolerance 0.01 Valid point, recorded both in Auto
(default Tolerance) , no & Manual, recorded both in Local
Auto/Manual, no & Remote
Local/Remote
Demo:B5.MEAS, 0.5, A, Point with Auto, no Valid point, recorded in Auto only,
Local/Remote recorded both in Local & Remote
Demo:B5.MEAS, 0.5, M Point with only Manual Valid point, recorded in Manual
only
Demo:B5.MEAS, 0.5, A Point with only Auto Valid point, recorded in Auto only
Demo:B5.MEAS, 0.5, M, Point with Manual only, Valid point, recorded in Manual &
L Local only al
Demo:B5.PNT,0.5, A, L Point with Auto only, Local Valid point, recorded in Auto &
only Local
Demo:B5.PNT,0.5, M, R Point with Manual only, Valid point, recorded in Manual &
Remote only Remote
Demo:B5.PNT,0.5, A, R Point with Auto only, Valid point, recorded in Auto &
Remote only Remote
Demo:B5.PNT,0.5, ,L Point with Local only Valid point, recorded in Local only,
recorded both in Auto & Manual
Notes:
If the scpeng.sce file is modified, restart the recording to re-read the file.
SCP engine logging action does not start recording a Scenario if scpeng.sce is empty or if
any points are invalid.
If a Scenario is manually created, then add a WAIT statement of at least 5 seconds after
an MA or LR point in the Scenario.
There may be a time delay on starting, recording or playback for the first time after
loading a simulation with large scpeng.sce files.
When saving Snapshots, add RUN and WAIT commands after the SAVE command. The
WAIT statement value should be sufficient for the Snapshot to save .
Introduction
The Cross Reference feature allows communication between simulation engines. It represents the
actual wires from a field device (or transmitter) to the control system, and acts as a conduit
between various engines.
The cross reference database acts like an I/O cabinet, tying model values to Foxboro Evo I/O
blocks (AIN, AOUT, etc.). The cross reference database contains (among other things) the
definition of each model variable, the scaling factors, and the control point referenced by each
variable. For the SCP implementation, the cross-reference data is obtained directly from the
controls configuration after it has been downloaded to the SCP computers.
2. In the Cross Reference Update dialog box, select the SCP engine name and
select the process model engine (Default Engine)
3. Review and update the appropriated checkboxes and radio buttons, and then click
Update.
Database Structure
Cross Reference data entries for analog points differ slightly from those for digital points. Each
point type is presented separately in the tables below.
Analog Points
Disabled Selecting the disabled option disables this line. After disabling Optional
the line, reload the cross reference database.
From Engine The Engine name from which the controls/object Required
points/parameters are cross referenced.
From Symbol The variable, model object parameter, or control point cross Required
referenced from an Engine specified in the “From Engine” field. unless a
conversion
Model object parameters are accessed using the syntax: equation is
ObjectName.Parameter specified
From Val Some control emulators and interfaces use this entry for Optional
Info reference purposes only.
To Symbol The parameter or control point, which receives cross reference Required
values from “From Symbol.”
To Val Info Some control emulators and interfaces use this entry for Optional
references purposes only.
Note : When multiple engines are configured in DYNSIM (a mix of DYNSIM and non
DYNSIM engines), it is possible to have the same point names. This does not affect the Cross
Reference table. The "From Symbol" can have duplicate names, but from different engines.
Digital Points
Column Required
Description
Name /Optional
Disabled Selecting the disabled option disables this line. After disabling Optional
the line, reload the cross reference database.
From The variable or model object parameters or control point cross Required unless
Symbol referenced from an Engine specified in the “From Engine” a conversion
field. equation is
specified
For a digital input, it might be set to the name of a model
variable name from DYNSIM-L engine. For a digital output, it
might be set to the Compound:Block.Parameter name.
From Val Some control emulators and interfaces use this entry for Optional
Info references purposes only.
To Symbol The parameter or control point, which receives cross reference Required
values from “From Symbol.”
To Val Some control emulators and interfaces use this entry for Optional
Info references purposes only.
In most cases, access to the Foxboro Evo I/O control blocks is normally obtained using the
standard “Compound:Block.Parameter” (C:B.P) format. Some blocks include internal parameters
that do not appear in the Detail Display. To facilitate access to the block’s parameters, “pseudo-
parameter” naming is used to access the block’s I/O data. Some of the parameter names match
that of a Foxboro Evo block parameter, while others are available only in the SCP environment.
The parameter names are automatically appended through the Automatic Cross Reference
Generation Tool available through the GUI or through a command line batch file.
Note: Cross referencing to points other than actual I/O may cause the simulator to behave
differently than an actual control system.
The points listed below are actual I/O. Requirements for automatic cross reference generation are
listed in this table.
AI Controls Configuration:
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT
AO Controls Configuration:
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog From Symbol Compound:Block.OUT
Controls Configuration:
AOUT
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Analog From Symbol Compound:Block.OUT
Controls Configuration:
AOUTR
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Analog From Symbol Compound:Block.POINT
Controls Configuration:
BIN
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN
Controls Configuration:
BINR
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN
Controls Configuration:
BOUT
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT
Controls Configuration:
BOUTR
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT
Controls Configuration:
CIN
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN
Controls Configuration:
CINR
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN
Controls Configuration:
COUT
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT
Controls Configuration:
COUTR
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT
Controls Configuration:
DI
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.FBCIN
Controls Configuration:
DO
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog From Symbol Compound:Block.COUT
Controls Configuration:
DPIDA
IOM_ID must be set to a valid ECB device
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT
Analog To Symbol Compound:Block.MEAS01
Analog To Symbol Compound:Block.MEAS02
Analog To Symbol Compound:Block.MEAS03
Analog From Symbol Compound:Block.OUT
Controls Configuration:
EVENT
IOM_ID must be set to a valid ECB device
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN_1 to _32
Controls Configuration, Input:
GDEV
IOM_ID must be set to a valid ECB device
IP_FBM 1
Cross Reference Configuration, Input:
Analog To Symbol Compound:Block.FBDEVLM1 for
closed/stopped
Analog To Symbol Compound:Block.FBDEVLM2 for
open/running
Controls Configuration, Output:
OP_FBM 1
Two Wire (PLSOPT 0) for sustained, single output
Three Wire (PLSOPT 1) for pulse, dual output
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT_1 (sustained,
for PLSOPT 0)
Digital From Symbol Compound:Block.COUT_1 (start pulse,
for PLSOPT
Digital From Symbol Compound:Block.COUT_2 (stop pulse,
for PLSOPT 1)
Controls Configuration:
IIN
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT
Controls Configuration:
IINR
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT_1 and
POINT_2
Controls Configuration:
IOUT
IOMID1, 2, 3 must be set to a valid ECB device
II1_PT, 2_PT, 3PT must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.LOUT
Controls Configuration:
MAIN
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
SCI type required for conversion from raw counts to
conditioned value
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT_1 to POINT_8
Controls Configuration:
MAI
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.PV1 to PV8
Controls Configuration:
MAO
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog From Symbol Compound:Block.IN_1 to IN_8
Controls Configuration:
MCIN
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN_1 to FBCIN_32
Controls Configuration:
MCOUT
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Digital From Symbol Compound:Block.CO_1 to CO_16
Controls Configuration:
MDACT
IOM_ID must be set to a valid ECB device
For ECB Type 34, Feedback lag
For ECB Type 36, Pulse Width Modulation
Cross Reference Configuration
Analog To Symbol Compound:Block.POINT
Digital To Symbol Compound:Block.FBLIMINC state of
increase limit switch (true, at the increase limit)
Digital To Symbol Compound:Block.FBLIMDEC state of
decrease limit switch (true, at the decrease limit)
Digital To Symbol Compound:Block.FBDIHOLD block in
hold mode
Analog From Symbol Compound:Block.UPMDAC (ranges
between 0 and 100%)
Analog From Symbol Compound:Block.DNMDAC (ranges
between 0 and 100%)
Controls Configuration:
MDI
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT_1 to POINT_8
Controls Configuration:
MDO
IOM_ID must be set to a valid ECB device
CHANNL must be unique for IOM_ID
SIMOPT must be 0 (false)
Cross Reference Configuration:
Analog From Symbol Compound:Block.IN_D1 to IN_D8
Controls Configuration, Input:
MOVLV
IOM_ID must be set to a valid ECB device
IOMOPT must be set to 1
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT_1
Digital From Symbol Compound:Block.COUT_2
Controls Configuration, Input:
MTR
IOM_ID must be set to a valid ECB device
IOMOPT must be set to 1
Two Wire (OUTOP 0) for sustained, single output
Three Wire (OUTOP 1) for pulse, dual output
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT_1 (sustained,
for OUTOP 0)
Digital From Symbol Compound:Block.COUT_1 (start pulse,
for OUTOP 1)
Digital From Symbol Compound:Block.COUT_2 (stop pulse,
for OUTOP 1)
Controls Configuration:
PAKIN
IOM_ID must be set to a valid ECB device
SIMOPT must be 0 (false)
Cross Reference Configuration
Analog To Symbol Compound:Block.FBPAKCIN
Controls Configuration:
PAKINR
IOMID1, 2, 3 must be set to a valid ECB device
PK1_PT, PK2_PT, PK3_PT
SIMOPT must be 0 (false)
Cross Reference Configuration
Analog To Symbol Compound:Block.FBPAKCINP,
Analog To Symbol Compound:Block.FBPAKCINS and
Analog To Symbol Compound:Block.FBPAKCINT
Controls Configuration:
PAKOUT
IOM_ID must be set to a valid ECB device
SIMOPT must be 0 (false)
Cross Reference Configuration
Analog From Symbol Compound:Block.FBPAKCO
Controls Configuration:
PLB
IOM_ID must be set to a valid ECB device
PLB controls must be loaded from a diskette device (not an
ICC driver task) to assure the cross reference points are
generated automatically from the DYNSIM GUI
SIMOPT must be set to 0
Cross Reference Configuration:
Digital To Symbol Compound:Block.FBCIN_1 to FBCIN_32
Digital From Symbol Compound:Block.CO_1 to CO_16
Controls Configuration:
PLSOUT
IOM_ID must be set to a valid ECB device
Two Wire (OUTOP 0) for sustained, single output
Three Wire (OUTOP 1) for pulse, dual output
SIMOPT must be set to 0
Cross Reference Configuration:
Digital From Symbol Compound:Block.COUT_1
Digital From Symbol Compound:Block.COUT_2
Controls Configuration:
RIN
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
SCI type required for conversion from raw counts to
conditioned value
PNT_NO must be unique for IOM_ID
SIMOPT must be false (0)
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT
Controls Configuration:
RINR
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
SCI type required for conversion from raw counts to
conditioned value
PNT_NO must be unique for IOM_ID
SIMOPT must be false (0)
Cross Reference Configuration:
Analog To Symbol Compound:Block.POINT
Controls Configuration:
ROUT
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be false (0)
Cross Reference Configuration:
Analog From Symbol Compound:Block.OUT
Controls Configuration:
ROUTR
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
SIMOPT must be false (0)
Cross Reference Configuration:
Analog From Symbol Compound:Block.OUT
Controls Configuration:
VLV
IOMOPT must be set to 1
IOM_ID must be set to a valid ECB device
PNT_NO must be unique for IOM_ID
Cross Reference Configuration:
Analog From Symbol Compound:Block.COUT
Field Device System Integrator Modules (FDSI) Triconex Integrator Driver integrates Triconex
Tricon/Trident controller modules with Foxboro Evo FBMs 232/233 through a Triconex System
Access Application (TSAA) protocol that reads and writes to TriStation tag names or Modbus
aliases from an operator interface. The SCP/ TRISIM Automatic Cross Reference Merge utility
tool is an application to configure equivalent communication between controls executing within
SCPEngine and TRISIM engines. DYNSIM 5.2 and later install this utility with the Control
Emulations option selected during install. After successful installation of the utility, complete
the following procedure to set a cross reference between SCPEngine and TRISIM I/O. This tool
can be invoked when the simulation is loaded into memory and contains both SCP and TRISIM
engines.
1. Deploy the SCP controls. Depending on the configuration of the controls, refer to the
following sections for details of loading controls:
Loading Controls through the ICC
Validating and Downloading CPs in IACC
Deploying controls in Foxboro Evo
2. From DYNSIM GUI, load the Simulation with DYNSIM-L engine, SCP engine, and
TRISIM Engine.
3. Load the simulation, run it for a few seconds (to process the controls), and freeze it.
Generate a Cross Reference list. A related procedure is available in the SCP Getting
Started Guide in the Cross Referencing section. This step will automatically generate a
file, CrossRef.txt, in the simulation directory where the SCP engine is running.
4. Review CrossRef.txt and search for IP Addresses listed in Extra Column 5. These IP
Addresses correspond to the Triconex PT2 file IP Addresses.
7. In the DYNSIM GUI, edit each TRISIM engine’s configuration and verify that the Path
and file to X-Ref Auto-gen output is set to the name and location of the file generated in
the previous step. If a change is made, shutdown and restart the simulation.
9. Select the Merge SCP TRISIM checkbox and select the Merge new data with
existing XREF radio button.
10. The Cross Reference Merge graphical user interface appears as shown below.
11. In FSIM XRef Data, browse to the cross reference output file(CrossRef.txt) that contains
the SCP engine I/O. The application automatically displays the available SCP engines in
the text box next to the FSIM Xref Data field.
12. From the TRISIM Engine drop-down menu, select the name corresponding to the
equivalent Triconex PT2 file IP address (determined in step 4).
13. In the TRISIM Tag Declaration Data text box, browse to the Tag Export file that is
generated from the TriStation Application (determined in step 5).
14. In the Merged XRef Data text box, provide the output file path.
16. The SCPEngine-TRISIM cross reference file is generated in the path mentioned in the
Merged XRef Data text box.
Once the above message appears, reboot the SCP from the SCPLauncher manually to complete
the reboot command issued from the System Manager.
Note: Ensure that the “Reboot” option is selected in the SCPLauncher and NOT in the Start
menu.
Overview
SCP software provides support for emulating the AIM*Historian package with the SCP
AIM*Historian (FAIM) within the simulation environment.
Convert and download historian configurations from the I/A Series legacy historian.
Save the complete state of the historian database in an Initial Condition snapshot.
FAIM also provides networked AIM*API services, thereby allowing AW/WSTA software such
as FoxView access to CSA and OM data for browsing.
FAIM needs to be installed on all AW workstations, even though there is only one FAIM instance
running in the simulator.
For the basics of setting up and using FAIM, see SCP AIM*Historian Support section in the SCP
Getting Started Guide.
If required for the Foxboro Evo environment, InSQLSim replaces InSQL. Refer to the Foxboro
Evo Simulation User Guide for details.
FAIM supports historical trending in FoxView / Display Manager and alarm history in FoxAlert.
Additionally, it supports the browser interfaces in FoxDraw, Message Manager Configuration,
and other similar applications.
FAIM does not provide the complete implementation of AIM*API and does not support the
AIM* client applications such as AIM*Explorer and AIM*DataLink, and the AIM*Historian
tools such as the Historian Configurator.
Users who need AIM* client applications in a simulation environment should use the actual
AIM* Historian and its associated applications. In this instance, management of trend and alarms
for snapshots and time synchronization with the simulation cannot be supported.
Note: It is not possible to have FAIM and AIM*Historian running on the same workstation at the
same time. If you need both the applications installed on the same machine, refer to the “SCP
Installation Guide” for complete procedure.
Principles of Operation
FAIM is designed to provide support for historical data storage and retrieval within the
framework simulation environment only; therefore, it has different operational requirements from
a historian designed to be used on a PAS.
For example, for simulation, users are concerned only with the recent history. They are not
concerned with reviewing the data several days or weeks old for the trip analysis.
1. RTP data is only stored for a fixed (but configurable) number of simulation hours. By
default, FAIM stores RTP data for eight hours of simulation run-time.
For RTP data, FAIM maintains a number of RTP database files. Each database file contains data
for exactly one hour of simulation time. The number of files created and maintained by FAIM
depend on the number of hours of history required, and the number of backtracks and the
backtrack interval. The duration of available historical data is defined by the maxhist engine
configuration parameter. For more information, see Configuring FAIM Engine.
For alarms, FAIM maintains a single database file that contains First-in First-out queue of alarm
messages. By default, FAIM stores 5000 alarms, which is the default number of alarms displayed
on the Alarm History display in FoxAlert. The number of alarms that the queue contains is
specified by the maxalarm engine configuration parameter. For more information, see
Configuring FAIM Engine.
Initial Conditions
When saving Initial Conditions, FAIM makes a copy of all of its database files and thereby saves
the complete historian state and data. On restoration of an IC, FAIM replaces the current database
files with the files in the IC.
The time taken to save and restore an IC and the data storage requirements for an IC are directly
related to the size and number of database files that FAIM maintains. Therefore, configuring
FAIM to maintain the minimum amount of data required for your simulation is recommended.
Backtracks
Backtracks in FAIM are handled differently from those in ICs, especially the backtracks that
FAIM does not store any RTP data files for. FAIM stores a pointer into the RTP database files
representing when the backtrack occurred. When a backtrack restores, FAIM uses this pointer to
revert the ‘current’ RTP database files to the state they were in when the backtrack occurred. It is
important to remember this point because it means that the backtracks are valid only within the
single simulation execution run. Therefore, if you are restoring the simulator to a defined state at
a later date, use an IC.
Timestamping
In FAIM, internally whole data is time stamped in seconds. When data is presented to external
applications the internal time stamp is converted into a ‘wall clock’ time.
Historian Instances
Each historian entity is called a historian instance and each instance has a logical name that must
be unique on the Foxboro Evo system. For example, hist01.
The logical names used in FAIM must match those in the configuration files downloaded into
FAIM from AIM or legacy historian, and those used in the Foxboro Evo system configuration for
trends, alarm history destination etc. For the Foxboro Evo applications to function correctly, the
historian logical names must be six characters long and should have all letters in lower case.
In FAIM, each historian instance is maintained by an instance of the FAIM simulation engine,
which means a FAIM engine process is equivalent to an AIM histmain process. The logical name
for a FAIM engine is an engine configuration option.
Remote Collectors
In AIM, each instance can use one or more remote collectors. Remote collectors are used to
distribute the AIM historian architecture or to obtain data from sources other than Foxboro Evo
controllers (e.g. via OPC) or both.
In FAIM, remote collectors have no real meaning. FAIM supports distributed data collection via
the simulation network and is capable of storing data from non-Foxboro Evo sources directly.
By default, FAIM attempts to locate and store data for every RTP in a historian instance
configuration, regardless of its configured collector, using the NAMEINCOL parameter of a point
configuration as a symbol lookup into the current simulation.
In most circumstances, the default functionality is acceptable, but in some, the data collection for
all RTPs in one instance is not required. For example, when one off-platform AIM*Historian
instance is configured to retrieve data from multiple Foxboro Evo systems, but only one of the
Foxboro Evo systems is being simulated. To support this situation, FAIM supports disabling data
collection for specifically named remote collectors. Configuration of collectors is disabled via the
ignorecol engine configuration parameter.
FAIM historian instances are configured through configuration input batch files obtained from
AIM*Historian instances via the AIM utilities histsave and histcsave, or from the I/A Series
Legacy Historian through the leg2fh conversion tool.
Note: At this time, FAIM does not support a graphical or interactive configuration tool.
A Save As dialog box opens with the Batch Configuration input file as the selected file
type. The file extention of the Batch Configuration file is .inp.
4. Specify the name and location of the file, and click Save.
The Progress Status area of the histsave window shows the instance name, the location of
the file, the number of lines in the file, and the status of the task.
Newer versions of histsave generate two .inp files in the specified location. One contains only the
active points, and the other contains both the active and deleted points. For FAIM only active
points are needed.
Note: Historian batch configuration files generated on both Solaris and Windows NT/XP systems
can be used with FAIM. The files are ASCII based, and therefore, are transferrable between
systems without conversion.
For more information on generating historian batch configuration input files from existing
AIM*Historian instances, refer to the AIM*Historian User Guide, B0193YL.
The resulting process display should include hist_srv, hr_fetch, and hs_fetch.
2. If these programs are not running, start the I/A Series Historian.
a. Run the migration program:
leg2fh <Historian> <Output> <Max RTPs>
Where:
<Historian> specifies the Historian instance to convert.
<Output> specifies the full path and name of the resulting AIM*Historian
configuration file. Typically, the file name is the name of the AIM*Historian
instance. Include the extension .inp, as in the following example: hist01.inp.
Mostly, FAIM uses only a subset of the information available in an AIM batch configuration file,
but in some cases, it overrides the settings in the configuration file. The modifiable settings are
listed below:
Instance Component
MAXPTS Maximum number of RTPs: Set this value to the maximum number of Real
Time Points expected with FAIM. This value determines the size of the database
files maintained by FAIM; therefore, it directly effects the storage requirements
for ICs and the time taken to save and restore the state. In AIM, this value can be
set significantly larger than the number of configured RTPs; therefore, reduce it
to a value slightly larger than the number of actual RTPs.
ARCHSIZE Archive size: This value is ignored by FAIM. All RTP database files are created
at a fixed size as configured in the Engine Configuration dialog box for the
FAIM engine. See FAIM Engine Configuration below.
RTTIME Database retention time: This value is ignored by FAIM. All RTP database
files have a retention time of 3600 seconds (1 hour). FAIM expires and rolls over
an RTP database file every 3600 seconds of simulation time. An RTP database
file in FAIM never rolls over on size if it becomes full before it contains 3600
seconds of data. It grows to create additional space.
IATIME Foxboro Evo Time vs. UTC: This value is ignored by FAIM and forced to
IATIME=NO. Whole data stored by FAIM is time stamped to the simulation
clock, and the timestamps returned by FAIM to external applications are
specified as UTC.
The operations of each FAIM engine (historian instance) are controlled through the options
available on it.
2. Select the FAIM engine instance and click the Edit button. The Engine
Configuration dialog box appears.
Historian logical The historian logical name must be specified <not specified>
name to associate it with the FAIM engine instance.
Default RTP data The initial size of an RTP database file (at 10
file size (in MB) creation time)
Directory path The directory where FAIM should store the Blank: It means
for historian data ‘current’ historian database files. FAIM stores the
files data in the
simulation specific
directory
Directory path The directory where FAIM should store the Blank: It means
for initial database files for an IC FAIM stores the IC
condition (IC) data in the
files simulation specific
directory
Directory path The directory where FAIM should store Blank: It means
for backtrack files backtrack files FAIM stores data
in the simulation
directory
4. When specifying non-default locations for historian database files and IC files,
ensure that the locations are unique for each simulation, to prevent different
simulations from attempting to utilize the same database files.
FAIM Batch
FAIM comes with a batch configuration application that provides the same functionality as
histbatch does for AIM.
With FAIMBatch, download the batch configuration input files obtained from the AIM*Historian
instances or legacy historian instances (via leg2fh,) or download the files that have been manually
created.
To download a configuration file into FAIM, add an instance of FAIMEngine to the simulation,
set the historian logical name for the instance in the engine configuration, and reload the
simulations so that the FAIMEngine process can start.
The first time a new FAIMEngine process starts, it has no configuration because nothing
downloads from FAIMBatch. Hence, it cannot do anything meaningful. When FAIMEngine has
no configuration, it displays the following error message on startup.
Once the engine has started and this error message has been displayed for a particular instance,
download the configuration for that instance with FAIMBatch.
Start FAIMBatch by navigating to Start > Programs > SIMSCI > SCP > FAIM
Batch.The FAIMBatch window appears:
To download a configuration, click the Get File Name and Start Batch
Configuration button, and then browse and select the required batch configuration file in the
window that appears.
Note: To download the configuration successfully, the historian instance name in the batch file
must match the historian logical name specified in the FAIMEngine configuration. If the two do
not match, or if the FAIMEngine has not started, FAIMBatch cannot open a configuration session
and the following message appears:
If the configuration is downloaded successfully, FAIMBatch indicates that the session has been
committed:
When a session is cancelled, a log file gets generated, which is viewable by clicking the enabled
histbatch.lst button. This step launches Notepad and displays the log file:
The histbatch.lst log file shows a message indicating the reason for the failure and the line in the
configuration file that generated the error (line 151 in the above example).
Once the configuration is downloaded into a FAIM historian instance, instruct FAIM to read the
configuration either by restarting the FAIMEngine or by selecting the Load Full Model option in
the DSS GUI.
Note: If the FAIM Options dialog box does not appear, change the UAC settings to Never,
reboot the computer, and try again. To modify the UAC settings, click Start, type
UAC in the provided text box, and press Enter. The User Account Control Settings
dialog box will appear. After completing this section, return UAC to the original
settings.
4. Select the “Check if you want to start FAIM processes at boot” option.
Note: The following processes run in Task Manager upon reboot: FAIMHistSrv.exe,
FAIMHrFetch.exe, FAIMHsFetch.exe, and FAIMIpchisti.exe.
FAIMSpy
FAIM is supplied with a diagnostics tool called FAIMSpy to view the FAIM database files. Start
FAIMSpy by navigating to Start > Programs > SIMSCI > SCP > FAIM Spy
The upper-left workspace pane displays a tree view of FAIM instances in the current running
simulation. If no FAIMEngine is running in the simulation or if FAIMSpy was started when no
simulation was loaded, no FAIM Instances are displayed in the workspace pane. Synchronize the
FAIMSpy to the current simulation at any time without restarting by using the New
Simulation option on the File menu.
Under the FAIM Instance in the tree view, icons appear for the following items:
Instance Cfg
RTP Cfg
RTP Database
EventMsg Database
When you select any of these icons, the corresponding information is displayed in the main
window pane.
Note: Maxhist differs from the maximum history option specified on the engine because
the Maxhist value contains the files necessary to handle the file rollover and backtracks.
Rtp_file_nr: The current RTP file number – the file where data is currently being stored.
Maxalarm: The maximum number of alarms that FAIM stores, as specified on the engine.
timeStart: The wallclock (UNIX®) time when simulation was started or IC was restored.
For details on how time synchronization is performed, see The Principals of Operation
section.
timeSim: The total execution time (seconds) for the running simulation.
Below these fields in the Instance Cfg are the index records for each RTP database file (maxhist
files). The index records give timestamps for the start and end of each RTP database file.
Double-click an RTP in the RTP CFG view to see all the attributes for the selected RTP.
Note: FAIM stores only a subset of the attributes that AIM maintains for an RTP.
If an RTP data file exists, it is displayed in the main view pane along with its start and end
timestamps:
Double-click an existing RTP data file to display the data for each RTP:
In the RTP CFG, locate the Idx column in the RTP index for a particular RTP. If values exist for
that RTP in the data file, the corresponding value appears in the offset to the first value field.
Selecting an RTP displays the values in the data file for that RTP in the bottom panel. All value
timestamps change to the current simulation ‘wall clock’ time from the internal (seconds)
timestamp. As data moves dynamically into the files, the Refresh button becomes available to
refresh the display without having to close and re-open the dialog box.
Select EventMsg Database in the FAIM instances tree to see the alarm message database:
The header records in the message database show the maximum number of alarms that can be
saved, the number of alarms already saved, and the index to the next free entry in the alarm
database queue.
If the alarm messages have already been saved, they are listed below the header record and have a
message icon for themselves.
Viewing IC data
Select an instance or one of the options under it in the FAIM Instances tree to see a list of
ICs created in the simulation for that instance under the ICs folder, under FAIM Snapshots.
FAIM stores a copy of all database files except RTP Cfg in the IC. View the data files in the IC
by clicking the required option under a specific IC.
If one or more required files are missing in an IC, it appears dim in the list and cannot be restored
into the simulation. However, the files that do exist in FAIMSpy are viewable.
FAIM does not store RTP data for a backtrack, instead it just stores a record of the time when the
backtrack occurred. Therefore, for backtracks only, the option to view the backtrack time stamp
and the EventMsg Database is listed.
The first tab, Historian.log, shows information, warning, and error messages from FAIM.
These messages come from any FAIMEngine or associated application running on the local
machine.
The second tab, Histbatch.lst, shows the results of the last FAIM Batch configuration
session.
The final tab, Invalid RTP’s, shows a list of the RTP points that could not be located in the
running simulation.
FAIM determines which RTP points are valid when the simulation is first run, or when the
simulation is run after a configuration change.
Refresh the logs displayed in FAIMSpy by clicking Refresh Logs on the View menu or by
clicking the following button on the toolbar:
Refresh Logs
Delete the Historian.log file in FAIMSpy by clicking Clear Historian Log on the View
menu or by clicking the following button on the toolbar:
If required, preview the printed output by clicking Print Preview on the File menu or by
clicking the following button on the toolbar:
Print Preview
Optimizing FAIM
Optimize the performance of FAIM in terms of disk, memory usage, and speed through the
engine configuration file. The relevant engine parameters are listed below.
This parameter should be set to the smallest value possible for the simulation requirements.
Setting this parameter to a high value increases the storage requirements for ICs and the time
taken to save and restore a snapshot.
Never set this parameter to a value higher than the number of viewable alarms on the Alarm
History Display (AHD) in FoxAlert. By default, AHD displays up to 5000 alarms in Foxboro Evo
V8.2 and later systems.
If FAIM stores a large number of alarms, more memory and disk space is utilized and longer time
is taken for backtrack / IC save and restore operations.
Even if AHD is configured to display a large number of alarms, configure FAIM to store and
provide fewer alarms to improve the performance.
By default, FAIM creates each RTP database file with a size of 10MB. 10MB is a sufficient file
size for most of the circumstances. However, increase it for large historians and decrease it for
small historians.
If the specified size of the RTF file is not sufficient to store one-hour long RTP data, FAIM
automatically increases it. When the file size increases beyond the configured size, messages are
logged to the Historian log file indicating that an increase in size was required. If these messages
frequently appear in the historian log, increase the parameter value. While FAIM can dynamically
resize the file, this process is time consuming and causes the simulator to ‘pause’. Therefore, it is
not recommended to let FAIM perform this operation.
SimSyncEngine
The SimSyncEngine controls the time, trending, and alarms on all the Foxboro Evo workstations.
With FoxView or InTouch, Foxboro Evo trends do not flatline when the simulation is frozen,
trending ramp rates do not vary when the simulation speed increases or decreases, and the alarms
are archived (the alarm state is saved in the snapshot).
SimSyncEngine provides the connection to the DYNSIM Simulation Executive to control the
simulation time (freeze/run), save and restore the snapshots (tags, trends, alarms), and coordinate
the data transfer (cross referencing between engines).
If you are using InTouch, you will need an additional software for using SimSyncEngine. Refer
to the Foxboro Evo Simulation documentation for details. When the SimSyncEngine is running,
the InTouch internal time tags, clocks, trend time scale, timers, and alarm times are managed
through simulation. Animations and scripts execute with the simulation time — they do not
execute if the simulation is frozen and execute at the simulation rate when the simulation is
running. For example, if the simulator runs at 50%, animations and scripts execute at 50%.
The SimSyncEngine uses Windows memory mapped file technology to share simulation time
with the “attached” applications, such as InTouch® and Wonderware Historian Client, and to
provide snapshot triggers.
Note: While configuring a simulation, multiple instances of SimSyncEngine are required. They
should be available on every computer where InTouch, Wonderware Historian Client, InSQLSim,
or Foxboro Evo software has been installed. The computer can be:
An Operator Workstation
A CP Host machines
The DSS infrastructure for each computer must be manually modified to point to a single
Simulation Executive Host machine. This procedure is available in Simulation Suite Network
Configuration section of the “SCP Installation Guide.”
Configure the SimSyncEngine through the Simulation Configuration dialog box. In the
Simulation Configuration dialog box, select the required SimSyncEngine instance and click the
Edit button. The Engine Configuration dialog box appears:
Directory Determines the directory where simulation IC files are stored. When Blank
path for the no path is specified, the default snapshot storage location is used. The
initial default snapshot location is: <root install> \ Simulations \
condition <simulationame>
(IC) files
(for example, C: \ SIMSCI \ DSS5x \ Simulations \ Simple_Flowsheet)
Directory Determines the directory where simulation backtrack files are stored. Blank
path for the When no path is specified, the default backtrack storage location is
backtrack used. The default backtrack location is one directory above the
files simulation directory: <root install> \ Simulations \
Simulation Determines the time increment used by the SimExecutive to run the 1
time step engine. Data send/receive from other engines occurs at this interval.
The simulation freezes, runs, saves, or restores a snapshot at this
interval.
Number of The actual HMI application may typically run at a finer time step. 10
time steps InTouch time-based scripts often run as fast as 100 milliseconds per
per second time step. The engine runs specified number of times per second. If the
(resolution) simulation time step and the number of time steps per second do not
match, the application adjusts the value automatically and warns the
user.
The number of time steps (slices) per second parameter is configured in the SimSyncEngine’s
initial setup to synchronize its time with the SimExecutive. The default value is 1for Simulation
time step and 10 for Number of time step (resolution). These default values produce 10 slices of
approximately 100 ms each. Adjust these values, if needed, but ensure that they are integers. The
engine tries to space the number of steps per second equally. For example, if a configured engine
is set to 10 steps per second at 100% simulation speed, each step is 100 ms. If the simulation
speed increases to 200%, each step is 50 ms. Upon each step, the simulation updates the time step
based on the calculated time step. With the simulation set to 10 steps per second, the updated time
is 100 ms per step. At 20 steps per second, the updated time is 50 ms per step.
As the simulation speed increases, the possibility of overruns (when the calculation steps are not
completed in the set time) increases. The SimSyncEngine is designed to limit the engine from
performing constant overruns. The minimum sleep time increases until the rate of overruns
occurring is less than 1 per 30 seconds. The minimum simulation speed of the engine is 100% at a
requested 100% or greater simulation speed.
Note: For standard Foxboro Evo applications that make use of FoxView, the number of time
steps per second should be changed to 1. This precision matches that of the Foxboro Evo alarm
server and optimizes simulation performance. For InTouch applications, the number of time steps
should be 10 to match their update rates.
SCP Utilities
Devices that do not exist in the Foxboro Evo hardware suite connected to the SCP computer may
be referenced in the PAS controls. If referenced devices do not exist, alarms will not display in
the Current Alarm Display (CAD) and historian data will not be saved. Map these devices to
known, or existing and online, devices using SCP Device Mapping Tool.
2. Click SCP Device Mapping Tool. The Device Map tool launches, displaying all
active CPs.
3. Select a CP, and then click Read. A tabular grid appears, displaying details for the
referenced devices of the selected CP.
Note: If there are no devices for the selected CP, or if the map file contains nonexistent
devices and no device exists in the selected CP, then a dialog box error displays.
4. Enter a new existing Device Name for each old device. If you wish to deactivate an old
device, leave its Device Name blank.
3. If there is a reason to remap any device for a CP, you must create a device map.
4. All valid devices must be named in the “new device” column to be active.
5. Leave the device name in the “new device” column blank for devices no longer being
used. This allows the CP to discard any messages intended for the old device.
SCPResetOM Tool
Updating the SCP controller checkpoint file can be done manually by checkpointing the
controllers using respective configurators like ICC, IACC or Foxboro Evo. This utility performs
an automatic OM rebuild for all the controllers or a single controller from the command line
window.
If the letterbug is provided, the command performs an OMRebuild for the single
controller specified.
If a letterbug is not provided, the tool does an OMRebuild for all active SCPs on the SCP
computer.
Note: The OMRebuild will only function for active controllers. Upon completion, the
“OMRebuild successful” message displays in the system monitor window.
If there are multiple SCP stations, run the SCP OMReset tool from each station to ensure
successful rebuilds of peer-peer connections.
The command line can be added to the end of a CP startup batch file that can be generated
through the SCP Launcher. Refer to Creating a batch file to start multiple SCPs using Export in
this document under SCP Launcher Toolbar.
The SCP Communication Diagnostics Tool can be found in the programs -> SIMSCI -> SCP start
menu. The purpose of this tool is to diagnose network data transfer with individual SCP running
on the computer platform.
The total data received group displays the breakdown of packets received by the driver. Unicast
packets are packets meant for one SCP. Local unicast are packets received from another SCP
located on the SCP computer. Remote packets are packets received from the outside network
(WSTAs, Historian, or another SCP computer.) Multicast are broadcast packets received for all
SCPs.
Actions Menu
The actions menu provides an option to refresh all of the packet data, and an option to reset
packet counters (only total data received) and SCP connection data.
The SCP Control Analysis Tool displays CP details related to system health, OM connections,
free memory within a CP, communication between CPs, and string count. Use this tool when
analyzing new controls to avoid overloading a single CP or to debug unusual behavior such as
failure to communicate between CPs.
1. Click Start, point to All Programs, then SIMSCI, then SCP.
2. Click SCP Control Analysis Tool. The tool opens, displaying a list of all active CPs in a
tree-view structure.
3. Click a CP to view details on System Summary, String Pool summary, DBVU Reports,
and Compounds/Blocks loaded with OM connections.
4. Expand a CP and click its System Summary listing to view details on Packet/Block
count usage, BPC value, Station type, number of peer-to-peer connections, number of
Compounds/Blocks/ECBs, and other detailed information.
5. To view a CP’s String Pool, expand it and click its String Pool listing. To manage a CP’s
memory usage, all strings are indexed and saved in a string pool, which consists of the
CP’s string, string count (usage), and string length.
6. To view various reports on a CP, expand it and click its DBVU Reports listing. Among
its sub-reports, this section contains:
Remote Links: Details the block’s OM connections (Disconnected, Deleted & Not
Found) including source path, sink path and OM status.
Phase Period Report: Displays a tabular form of number of blocks falling under a
particular Phase-Period combination.
C:B Phase Period Report: Lists Period and Phase of each Compound:Block loaded into
the CP.
Block Type Phase Period: Lists Period and Phase values of each Block Type. It also
displays number of blocks per Block Type.
Compound/Block Error: Lists blocks loaded with any Error/Warning, with the
error/warning code and description.
7. To view a CP’s compounds and controls, expand it and its Compound / Blocks section.
This section provides information such as links, link type, OM, and status for connectable
parameters.
The SCP application can be configured with a specific port number from 1025 to 65482 in order
to avoid port conflicts. This tool is copied to “C:\Program Files (x86)\SIMSCI\SCP” when SCP is
installed. Be sure to specify a port so that there are at least 45 free ports after the starting port. For
example, if you specify port 4000, be sure that ports 4000 through 4045 are free. You should
select a starting port that has at least 45 ports free after the starting port.
Usage:
SCPPortTool.exe <port>
Note: The SCP starting Port should be set before launching SCPLauncher.
SCPTool
The SCPTool Utility is used to Set and Get the Foxboro Evo control values loaded in SCP. Using
this tool, the user can set SCP to OFFLINE or ONLINE mode. This tool is copied to “C:\Program
Files (x86)\SIMSCI\SCP” when SCP is installed.
Usage:
Note: SCPTool cannot be used for Simulation related commands, such as Snapshot Save and
Restore.
LoadAll
The LoadAll process is valid only in the ICC environment. The command is located under the
MAINT pulldown menu. It loads the entire contents of a diskette into the currently selected
buffer: paste, volume, or station. A command line ICC Driver Task LoadAll performs the same
operation. If a duplicate compound is found in another CP or library volume, LoadAll stops
processing and moves on to the next compound, which would result in an incomplete
configuration load. With ICC, while performing a LoadAll, the configuration immediately
downloads to the CP.
SaveAll
The SaveAll process is valid only in the ICC environment. The command is located under the
MAINT pulldown menu. It saves all of the compounds in a controls station, volume, or paste
buffer to a diskette, or, if necessary, multiple diskettes. A command line ICC Driver Task
SaveAll performs the same operation. This routine has no impact on the CP database. If changes
have been made to the CP database through the Detail Display, the SaveAll command would not
automatically pick up these changes until an Upload has been performed.
Shrink
This operation compresses the current ICC database to save disk space. It only impacts the Host
WSTA, not the CP and is valid only in the ICC environment.
Initialize
This operation clears the contents of the CSA memory. Perform this operation either when
loading a new set of controls into the CP or when the database has become corrupted and
unusable.
When Initialize is selected through the Configurator, the user is prompted to reboot the CP.
For a real FCP270/ZCP270, the stations must be rebooted after performing an Initialize. For
SCP, on the SCPLauncher, highlight the SCP instance and click the Reboot button. The actual
SCP computer does not need to be rebooted.
Upload
Upload reads unconnected, settable parameters from the control station’s RAM and stores them
in the Configurator Database for the control station.
Download is the process of updating the CP database to the controls configuration that was
saved during the last checkpoint operation. Compounds and blocks are downloaded or deployed
to the CP. On completion of the download, the CSA and the checkpoint file on the CP’s host
workstation are updated. Selecting Checkpoint from the Configurator downloads controls
changes in the Configurator to the CP database.
The downld.exe process runs for a short time after a CP starts up, then stops. It establishes
communication with the host WSTA (SMDH turns from red to yellow or white). On a real self-
hosting CP, the CP requests a copy of the checkpoint file from the download server (the host
WSTA). This file is then copied into the control station’s flash memory. The same behavior
occurs with SCP.
Deploy is valid for IACC and Foxboro Evo environments. As with ICC, compounds and blocks
are downloaded. For Foxboro Evo, two additional targets are updated: Security access settings
and Wonderware History application objects. If an object is later modified in Foxboro Evo, re-
deploy implements the changes in the runtime environment and only modified parameters are
downloaded. Foxboro Evo provides flexibility to deploy just a strategy, just a compound, or, with
cascade deploy, an entire controller.
No underlying mapping updates are needed to deploy to an SCP application. A Galaxy with
multiple CPs can be used as is and deployed in to the SCP computer under each individual CP.
For OTS Engine mode, if the simulation is frozen when Deploy/re-Deploy occurs, blocks will not
process and the Checkpoint file will not be valid. Typical feedback for unprocessed blocks might
include cyan-colored blocks in the Detail Display that have no warning messages, or a large
number of blocks in Manual in a refreshed FoxSelect/BlockSelect. Run the simulation, freeze,
and re-Checkpoint each CP where the controls have changed.
Note: IACC and Foxboro Evo configurator instructions are included in subsequent sections
within this document.
Note: The process of loading controls in a SCP is exactly the same as the real CP. The system
definition of a plant can be used as is, and therefore the contents of each real CP gets downloaded
to the corresponding SCP.
If running in standalone mode, the checkpoint file is valid. If using an SCP Engine connected to
the DSS infrastructure, once the modifications are complete, run the simulation in order for the
changes to take effect. After completing a control configuration modification, and running the
simulation through a cycle, perform a Checkpoint through the ICC.
Once the simulation is loaded and “Frozen,” take the following steps to load controls using the
ICC.
If a simulation is open and loaded, then put the simulation in FREEZE mode until the completion
of the steps below.
2. Click Config in the main menu bar in FoxView. (It may be necessary to change the
environment in order to access this menu option.) From the pulldown menu, select
Control_Cfg, and then select CIO_Config.
3. The ICC window displays with the Compound Selection window inside the ICC
window. Click the Vol button at the bottom of the Compound Selection window.
4. The Compound Selection window is replaced with the Select Station Type
to Edit window. Click Edit Station.
5. The Select Station Type to Edit window is replaced with the Select a
Control Processor to Configure window. Select the name (letterbug) of the
SCP.
8. A prompt appears to select the device for the LoadAll procedure. It should automatically
select the correct host name and diskette drive. Continue with the load by selecting
DONE.
Note! Error messages encountered during the loading process are written to a log file located on
the WSTA at d:/opt/fox/ciocfg/ld< letterbug>.log, where < letterbug> is the
letterbug ID of the SCP station (CP270/CP280). This file is overwritten, as each new diskette is
inserted and loaded.
1. Repeat the previous step for each SaveAll diskette. For each subsequent diskette, the
following dialog box displays on the ICC screen:
E
CB’sarealreadypresent.
Appendn ewECB’s
?
Y
es N
o
FSIMP00
4
4. After the control configuration load is complete, run the simulation, and then freeze it.
The simulation should run through the longest period/phase of your controls. This
duration can vary from 0.5 sec to 30 minutes. Typically, 10 seconds is sufficient.
5. Compile IND, MON, DEP, and EXC blocks. When complete, run, and then freeze the
simulator.
In this section, we’ll load the control configuration through the command line LoadAll.
Once the modifications are complete, run the simulation in order for the changes to take effect.
After completing a control configuration modification, run the model, and then, perform a
Checkpoint through the ICC. Save the process model to ensure the checkpoint file is saved to
the backup S4M file. Then, perform the following steps.
1. Place the simulation in FREEZE mode until the completion of the steps below.
5. Place the files in a directory and copy the controls to this location (or make a note of the
location and replace the directory path as needed).
mkdir d:/opt/esscor/saveallfile
cp –r a:* d:/opt/esscor/saveallfile
cd d:/opt/fox/ciocfg/api
7. Load the controls, replacing “ESSSCP” with your CP letterbug name, and the directory
shown with the directory containing your controls.
If errors are logged, error messaging directs the user to check an error file.
8. Refresh FoxSelect / BlockSelect and verify that the compounds are turned on and address
any cyan block issues.
9. Compile PLB, IND, MON, DEP, and EXC blocks. When complete, run, and then freeze
the simulator.
10. Run the process model through the longest period/phase (anywhere from 0.5 sec to 10
minutes, depending on the controls set).
Overview
If making changes to the control system, periodically perform a SaveAll. This step provides a
backup that can later be used as the input to the LoadAll utility. Two methods are available.
Either perform a SaveAll through the ICC to a diskette or use the command line utility,
SaveAll, to save the information to the hard drive.
Before performing a SaveAll, ensure that the CP Database and the Configurator Database are
identical. Then, perform the following steps.
1. If a simulation is open and loaded, then put the simulation in FREEZE mode until the
completion of the steps below.
2. Invoke the ICC. Click Config in the main menu bar in FoxView. (If needed, change
environment in order to access this menu option.)
3. From the pulldown menu, select Control_Cfg, and then select CIO_Config.
4. The ICC window displays with the Compound Selection window inside the ICC
window. Click the Vol button at the bottom of the Compound Selection window.
5. The Compound Selection window is replaced with the Select Station Type to Edit
window. Click Edit Station.
6. The Select Station Type to Edit window is replaced with the Select a
Control Processor to Configure window. Select the name (letterbug) of the
SCP.
8. In the ICC window, click MAINT and then select SaveAll w/Fmt from the pulldown
menu. This step first performs a format on the diskette and then performs a SaveAll of
the current control configuration.
9. Perform the above steps for each SCP that is present in the network.
10. A prompt appears to select the device for the LoadAll procedure. It should automatically
select the correct host name and diskette drive. Continue with the load by selecting
DONE. Multiple diskettes may be needed.
1. Before performing a command line SaveAll, ensure that that the CP Database and the
Configurator Database are identical (perform an UPLOAD if needed). Then, perform the
following steps.
2. If a simulation is open and loaded, then put the simulation in FREEZE mode until the
completion of the steps below.
6. Create a directory.
mkdir d:/opt/esscor/saveallfile
cd d:/opt/fox/ciocfg/api
8. Save the controls, replacing “ESSSCP” with your CP letterbug name, and the directory
shown with the directory containing your controls.
Refer to the I/A Series System Configuration Component (IACC) User’s Guide (B0400BP) for
complete operation details of this application. The IACC can be installed on any computer, or
multiple computers. Network the computers. The IACC takes up a significant amount of resident
memory and may impact the performance of the simulator.
2. If the I/A Series processes are running, complete this step, otherwise continue on to step
three:
d. In the Startup Options for Reboot, click the Autologon radio button in the I/A
Series Off group.
e. Click OK.
5. Install the default selections, or follow the IACC User’s Guide to configure the system as
desired.
6. When prompted, select install the Client and the Server, if desired. Refer to the IACC
User’s Guide for details.
8. Turn on I/A Series processes after the IACC has completed its installation.
a. See Step 2, but select the I/A Series On Autologon radio button.
10. Reboot.
2. Select Start, then All Programs, and then IACC / IACC Studio.
4. If no printer is installed, a warning dialog box appears. Click OK to dismiss the dialog
box.
If the actual plant controls have been developed using the IACC, transfer these controls using one
of two methods:
The first method, IACC Export, is preferred. Although the entire database can be copied, it only
works if both the plant IACC version and the simulator IACC version are identical. Complete the
steps below to export a pre-existing IACC database.
2. In the Available Formats dialog box, select Export to IACC Format and
then click Next.
3. In the IACC Export File Name window, change the name (if desired) and click
Next.
If the actual plant controls have been developed using the IACC, transfer these controls using one
of two methods.
4. In the Import window, click the Select All button and then click the Replace
radio button.
5. Click Next.
Note: This step may take several minutes (20 minutes for a 150 MB .ida file).
8. Review the panes at the bottom of the IACC application for failures and other issues.
Individually download each CP to the SCP station(s). If validation errors occur, such as a
requirement to compile PLBs, or assign the correct WSTA host, the IACC application provides
feedback.
2. Within the IACC, click the Network pane, expand the tree, and navigate to a CP.
3. Right-click the CP. From the context menu, select Validate/Download, and then
click Download.
6. In the Control Station Download window, click the Select All button, and
then click Next.
9. Run the process model for several seconds to allow each block to process, and then
freeze.
10. Refresh FoxSelect / BlockSelect and verify all compounds are turned on. If not, turn them
on, and then run/freeze.
11. Within FoxSelect / BlockSelect, sort on Block Status to verify that the blocks are good.
First, verify that the compounds are turned on, the blocks are valid, and the simulation has run
through a complete cycle to verify each block has processed at least once. Freeze the simulation
before performing a checkpoint operation.
1. Within the IACC, click the Network pane, expand the tree, and navigate to a CP.
If modifications were made using Detail Display, upload the changes to the IACC. Verify that the
simulator has run through a cycle after the modifications took place,.
1. Within the IACC, click the Network pane, expand the tree, and navigate to a CP
2. Right-click the CP, and then click Upload and Compare To CP.
4. The Upload and Compare Utility displays that the upload is in progress.
5. When complete, review the changes and click Update IACC (see PBAND below
differs).
Refer to the Foxboro Evo documentation for complete details on any topics covered in this
section. Specifically, the Foxboro Evo Process Automation System Deployment Guide
(B0750BA) covers most concepts in detail. The Wonderware Industrial Application Server
installation CD includes the Industrial Application Server User’s Guide, which covers major
topics regarding the IDE.
To connect, click Start, then Programs, then Wonderware/ArchestrA IDE. Select the
Galaxy, and then click Connect.
Foxboro Evo extends the standard ArchestrA IDE. Primarily, it includes objects in the Template
Toolbox that are specific to Foxboro Evo.
Work Area When an object is opened for editing, this area is used for
modification
If you are restoring an existing Galaxy database, you can create the commit disk using Foxboro
Evo. Complete these steps:
2. Verify that you have a valid Equipment Unit object and that the desired switches,
WSTAs, CPs, and other peripherals are contained within this object.
5. Click Network/Validate.
6. Review and resolve any errors and repeat the previous step if needed.
7. Click Network/Commit.
8. Use the Media #10091 diskette provided with the Foxboro Evo install media.
An Equipment Unit is an object used for logical grouping within an application that represents a
portion of your plant. If a system is built without an Equipment Unit, it will not deploy. An
Equipment Unit object will contain switches, CPs, WSTAs, and peripheral devices.
1. In the Network pane, drag your physical devices under your equipment Unit.
5. Click Deploy.
You might import SaveAll Controls, or controls saved in an existing Foxboro Evo systems, if you
are migrating to Foxboro Evo. If so, complete these steps. Refer to Foxboro Evo Process
Automation System Bulk Data Editor User’s Guide (B0750AF), for additional details.
Note: If you plan to recommit your system with additional CPs that may be imported through an
Automation Object, you should change your Committal status from “Not Yet Installed” to
“Software Installed” prior to performing these steps.
7. In the Import Bulk Data Wizard (Step 1 of 2), under Select input
source type, select I/A Series Saveall (Control only).
8. In the Input Source Details, click the Browse button and navigate to the location
of the controls.
11. In the Import Bulk Data Wizard (Step 2 of 2), click Create
matching entries for CPs, FBMs, FCMs, and, if desired, Search all
subdirectories for SaveAll images. Leave the other defaults selected, and
then click Finish. The imported strategies appear.
12. In the derived template, under the Control tab, click the Compound button.
13. If the CP name differs from the CP name in the committed system, manually change each
instance to the desired name.
14. If the Compound references a Station that does not exist, rename the nonexistent Station
references to existing ones.
16. Change the Station to one or more of the CPs listed in the commit.
17. Click the Modules button and notice the Parent is now your real CP270/CP280.
19. Since we manually modified the Stations, we need to add only the ECBs. Click All
under Modules, and then click Generate.
20. Check the results in the Output View (click View, and then Output View, if it is not
visible).
21. Click the Control tab, then the Compound button, and then Generate. If you do not
see your FCP/ZCP, you missed a step above.
23. In the Bulk Generation Wizard (Step 2 of 6), verify that the CP name is
and the blocks are correct.
25. View the Output View pane to verify that Generate was successful.
To move controls between Galaxy Databases, export an Automation object from one Database,
Then, import into another by completing these steps:
Note: If you plan to recommit your system with additional CPs that may be imported through an
Automation Object, you should change your Committal status from “Not Yet Installed” to
“Software Installed” prior to performing these steps.
Note: If the imported devices do not exist in your committal, reassign the associated
strategies/hardware to existing items.
If the restored Galaxy Database was in the “deployed” state, you need to change the state to
“undeployed” using the Deploy Utility’s “Synchronize Deploy Status” option. Note that this
process can be quite time consuming. We recommend that you perform this step individually on
each piece of equipment first, then select the main Equipment Unit, deselect all equipment that
was previously synchronized, and synchronize the Equipment Unit as described below.
3. Verify that all equipment is checked in (look for red checkmarks). If the object was
checked out in a different session, right-click it and then click Check In.
4. In the Network Pane, locate any equipment that is marked as deployed or partially
deployed. Right-click on the equipment, select Deploy Utilities, and then click
Synchronize Deploy Status.
If you restored the Galaxy Database, you cannot redeploy until PLBs and Sequence logic are
compiled. When attempting to deploy a CP, you will receive warning messages.
2. In the Strategy pane, locate and click on the compile shortcut button on the right hand
side .
Input/Output
STRIN String Input block receives a string input from an The DYNSIM
external device for input to a Foxboro Evo control infrastructure has
station via a DCI. no support for
strings, so cross-
referencing these
parameters is not
possible.
STROUT String Output block sends a string output from a The DYNSIM
Foxboro Evo control station to an external device infrastructure has
via a DCI. no support for
strings, so cross-
referencing these
parameters is not
possible.
Device Control
UNIVFF Universal Interface Block supports FF CIF and acts as The block loads
an interface to an FF Resource Block, Transducer but does not
Block or Function Block. process any
algorithm
Regulatory Control
PIDE PID with EXACT Tuning block provides PID with the
EXACT self-tuning algorithm.
Alarm
TRISOE Triconex Sequence of Events blocks capture SOE data The block loads,
and send the events to the FoxGuard SOE application but it has no
program. They which identify the event variables to ability to receive
be used in the Triconex SOE block configuration. and process some
messages from a
Triconex system.
Sequence
Data Storage
MROUT The Multiple Real Output block sends up to eight real Loads in to
values to the group address of the PLC memory but does
not function
MVC / MVL The Multivariable Controller (MVC) block and the Does not load in
Multivariable Loop (MVL) block, support an to memory
Embedded MVC application running in the CP. These
blocks support the multivariable control algorithm and
form the interface to other CP blocks. The MVL block
gets Controlled Variable (CV) and Feedforward
Variable (FV) measurements from blocks such as the
AIN and writes the Manipulated Variable (MV)
supervisory set points to other regulatory blocks
(PIDA, DPIDA, or RATIO).
FD / Gateway blocks
FDIIN The Foreign Device Integer Input block is used for the
conversion and storage of up to eight integer foreign
device values.
FDRIN The Foreign Device Real Input block is used for the
conversion and storage of up to eight floating-point
foreign device values.
FDROUT The Foreign Device Real Output block is used for the
interface between the Foxboro Evo network and the
foreign device. The values in the block are converted
to the foreign device’s format and sent to the device
on a change-driven or demand basis.
FROUT The Foreign Device Real Output block sends the real
value received from the Foxboro Evo control strategy
to its applicable field device, only when it receives a
changed value.
Scan blocks
An Upload copies the values of all block parameters from the CP database to the Configurator
Database. During this time, access to the ICC is disabled.
Parameters have been changed through the Select or FoxSelect / BlockSelect screen
An IC restore was performed from an IC that has different control parameters than those
currently in the Configurator Database and you want to replace the Configurator
Database parameters
3. After the upload is complete, exit the ICC by clicking EXIT on the ICC menu bar.
If multiple PLB blocks are connected to same ECB device, follow the steps below to generate
valid cross references to the PLB points.
1. Copy the PLB compiled files for the respective compounds from the CPHost machine (in
“D:\opt\fox\ciocfg\<COMPOUND>”) to the SCP machine (in
“C:\Users\<User>\Documents\SimSci\SCP\PLB”).
2. Regenerate the Cross Reference list. This will map only the valid points to the respective
PLB blocks.
If the Foxboro Evo graphics screens have lost their connection to the control point, resulting in
displays showing cyan for all the values, the graphics may require packing. Packing the
graphics re-establishes the link from the display to the control point.
c. Click OK.
3. Change to the graphics directory. For example, if the graphics were located in the
“d:/opt/disp” directory, type the following command.
cd d:/opt/disp
4. If the CPHost runs FoxView, pack the graphics by performing the following two
commands. According to the number of displays in this directory, this process may be
quite time consuming (sometimes up to one hour).
d:/usr/fox/wp/bin/tools/fdf_g *.fdf
d:/usr/fox/wp/bin/tools/g_fdf *.g
SOM
The Foxboro Evo SOM utility, which monitors the utilization of the Foxboro Evo OM subsystem,
can provide insight into resolving peer-to-peer issues. This application is available on every SCP
station in the “d:/opt/fox/bin/tools” directory.
o hit <return> or <enter> to continue (view more in open database command after
typing)