Professional Documents
Culture Documents
9720115-004 Triconex Emulator Users Guide v1.2.0
9720115-004 Triconex Emulator Users Guide v1.2.0
9720115-004 Triconex Emulator Users Guide v1.2.0
User’s Guide
Triconex Emulator
Version 1.2.0
Invensys, the Invensys logo, Triconex, Tricon, Trident, and TriStation are trademarks of Invensys plc, its
subsidiaries and affiliates. All other brands may be trademarks of their respective owners.
Preface v
New Features in Triconex Emulator v1.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Summary of Sections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Product and Training Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
We Welcome Your Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .vii
Index 55
The Triconex® Emulator is a software that allows you to emulate, execute, and test
TriStation™ 1131 applications without connecting to a Tricon™, Trident™, or Triconex General
Purpose (Tri-GP) controller.
Summary of Sections
• Chapter 1, Getting Started— Describes Emulator functionality and features, and
provides instructions for updating an existing Emulator installation.
• Chapter 2, Configuring the Emulator—Explains how to configure Emulator settings.
• Chapter 3, Testing Applications on the Emulator—Explains how to test applications on
the Emulator, including downloading applications, monitoring variables, forcing
system status changes, and disabling points.
Related Documents
• TriStation 1131 Developer’s Guide
• TriStation 1131 Libraries Reference
• SOE Recorder User’s Guide
• DDE Server User’s Guide
• Enhanced Diagnostic Monitor User’s Guide
• Communication Guide for Tricon v9-v10 Systems
• Communication Guide for Trident Systems
• Communication Guide for Tri-GP Systems
• Product Release Notices for specific Tricon, Trident, Tri-GP, and TriStation 1131 versions
Web Site
http://www.iom.invensys.com
Technical Support
Customers in the U.S. and Canada can obtain technical support from the Invensys Global
Customer Support (GCS) center at the numbers below. International customers should contact
their regional support center.
Requests for support are prioritized as follows:
• Emergency requests are given the highest priority
• Requests from customers with a support agreement and customers with purchase
order or charge card authorization are given next priority
• All other requests are handled on a time-available basis
If you require emergency or immediate response and do not have a support agreement, you
may incur a charge. Please have a purchase order or credit card available for billing.
Telephone
Toll-free number 866-746-6477, or
Toll number 508-549-2424 (outside U.S.)
Fax
Toll number 508-549-4999
Web Site
http://support.ips.invensys.com/ (registration required)
E-mail
iom.support@invensys.com
P2P
Tricon, Trident
or Tri-GP
Controller
TSAA
External DDE
Servers
Third-Party
Process
Triconex Simulation
TriStation 1131
Emulator Packages
DDE
Emulator Modbus Modbus
Control Panel Master or
Slave
TSAA
SOE
Recorder
When simulating a safety or process control system that includes multiple Triconex controllers,
as well as third-party DCS and control systems, multiple Emulator instances can be running at
the same time, communicating with each other via the Peer-to-Peer (P2P) protocol. If you are
using the DDE server built into the Emulator, the simulation application must be running on the
same PC as the Emulator; if you are using an external DDE server (as shown above), the
simulation application can run on a different PC.
The following figure shows how multiple Emulator instances can be used to simulate a more
complex safety or process control system.
Triconex
Emulator
Tricon, Trident
or Tri-GP
Simulation Triconex P2P P2P Controller
Interface Emulator
TSAA
Simulation Triconex P2P SOE
Interface Emulator Recorder
Network Communication
The Emulator supports redundant TSAA network communication, so that if the IP address you
identify as the primary server goes offline, the Emulator will automatically switch over to the
IP address you identify as the redundant server.
You can emulate multiple communication protocols (such as Modbus TCP and Peer-to-Peer)
simultaneously in one application running on the Emulator, as long as separate ports are
configured for each protocol. See Configuring the Emulator’s Settings on page 16 for
configuration information.
TSAA Protocol
The Emulator supports the TSAA protocol, allowing you to simulate communication between
a Triconex controller and clients using TSAA (such as DDE Server and SOE Recorder). Only the
following TSAA protocol commands are supported for emulation:
• TRICON_DATA_REQ • READ_TRICON_CLOCK
• WRITE_TRICON_DATA • ADJUST_TRICON_CLOCK
• READ_TRICON_DATA • TRICON_CPSTATUS_REQ
• SET_TRICON_CLOCK • TRICON_SOE_REQ
• TRICON_GET_SYMBOL_REQ
Events can be retrieved from the Emulator by using the Triconex SOE Recorder software.
You can use the Emulator to test the SOE blocks configured in your application, verifying that
event collection is enabled and ensuring the correct retrieval of events by your SOE client. If you
have SOE blocks configured in your application, SOE functionality will be available in the
Emulator automatically after you download your application. No additional configuration in
the Emulator is necessary. See Testing SOE Communication on page 32 for more information.
Peer-to-Peer Communication
Peer-to-Peer communication allows Triconex controllers to send and receive information from
each other. Peer-to-Peer communication is performed through Send and Receive function
blocks included in the application.
If you will be using Peer-to-Peer communication in your application, you can test it via the
Emulator. However, only one Peer-to-Peer configuration can be used by the Emulator.
If redundant communication modules are installed in a single logical slot, prior to downloading
your application to the controller, you need to select the physical module (LEFT or RIGHT) with
the Peer-to-Peer configuration you want to use. This module selection is made in the Emulator
Project Options dialog box; see Specifying Emulator Project Options on page 10 for more
information.
See Testing Peer-to-Peer Communication on page 34 for more information.
• ALARM_DEVIATION_DINT • ALARM_RATEOFCHANGE_REAL
• ALARM_DEVIATION_REAL • ALARM_TRIP
• ALARM_LEVEL_DINT • BYPASS_DINT
• ALARM_LEVEL_REAL • BYPASS_REAL
• ALARM_RATEOFCHANGE_DINT • BYPASS_BOOL
For detailed information about these function blocks, please see the TriStation 1131 Libraries
Reference.
The Emulator also supports the following I/O status function blocks for emulation:
For instructions on changing the value of the output parameters you want to emulate for each
I/O module, see Testing the Impact of I/O Status Changes on page 47.
Note For detailed information about the MP and I/O status function blocks, please see the
TriStation 1131 Libraries Reference.
Disabling Points
When a point is disabled, inputs from field instruments do not change the value of the point,
and the application running on the controller (or the Emulator) will not write to the point.
Disabling points is typically used when field instruments need to be replaced or repaired.
An application running on a controller should not contain disabled points unless there is a
specific reason for disabling them, such as initial testing or maintenance. Testing your
application on the Emulator allows you to freely disable points so that you can assess the impact
of disabling those points in an application before downloading and running it on the controller.
For instructions on disabling points, see Disabling Points on page 53.
System Requirements
The following are the minimum system requirements for the Triconex Emulator:
• PC running one of the following Windows® operating systems:
— Windows XP Professional
— Windows 7 Professional/Enterprise (32-bit and 64-bit)
— Windows Server® 2003
— Windows Server 2008 R2 (32-bit or 64-bit)
• 233 MHz processor with 128 MB RAM
• 125 MB free hard drive space
• CD-ROM drive
• Network adapter card
• SVGA monitor running at 1024 x 768 resolution with 64,000 colors
Procedure
1 Log on as an administrator or as a user with administrator privileges.
2 Close all open applications.
3 Insert the Triconex Emulator CD in the CD-ROM drive.
The installation should start automatically. If it does not, browse to locate the setup.exe
file on the CD, and then double-click setup.exe to start the installation.
4 Follow the InstallShield Wizard instructions.
5 When prompted, select the version of TriStation 1131 you want to associate with this
installation of the Emulator, and then click Next.
Only versions of TriStation 1131 (v4.7.0 or later) currently installed on your PC can be
selected. If you do not select a TriStation 1131 version, installation will be cancelled.
6 Click Install.
The Emulator must be installed in the default destination folder, which is: C:\Program
Files\Triconex\TriStation 1131 <x.x.x>\Programs, where <x.x.x> is the version
of TriStation 1131 you selected in step 5.
Note For 64-bit Windows systems (Windows 7 or Windows 2008 Server R2), the
default folder is: C:\Program Files(x86)\Triconex\TriStation 1131
<x.x.x>\Programs.
7 To complete the installation, click Finish.
You are not required to restart your PC before running the Emulator.
Procedure
1 Start TriStation 1131, and open the project with the programs you want to run on the
Emulator.
2 On the Project menu, click Project Options, and then click the Emulator tab.
Property Action
Number of Select how many instances of the Emulator you want to be able to
Instances run at any one time.
If this option is set to Multiple, more than one instance of the
Emulator can be running at the same time. If this option is set to
Single, only one instance of the Emulator can be running at any one
time.
Single Emulator instances are terminated when the TriStation 1131
disconnects from the Emulator, but multiple Emulator instances
must be terminated manually.
The default is Single.
Emulator Timeout Select the timeout value for the connection to the Emulator.
During a Download All or Download Changes operation on the
Emulator, the processing time required for applications with a very
large number of variables (symbols) may exceed the default
Emulator timeout value of 4 seconds.
If you receive a “download aborted” message when downloading
an application to the Emulator, disconnect from the Emulator,
increase the Emulator timeout value, reconnect to the Emulator, and
then try downloading again.
Note: In most cases, you should not have to change this value. The
default timeout value should be adequate for the majority of
applications.
The valid range is from 0 to 65,535 seconds. The default is 4 seconds.
Emulator File Select the files you want generated each time you download the
Generation application to the Emulator.
• Select the BT2 check box if you want a backup project file (.BT2)
generated (not recommended).
• Select the SOE check box if you want an SOE definition file
(.SOE) generated. If you want to be able to test your SOE
configuration with the Emulator, you must select this option.
If selected, the .BT2 file and/or .SOE file are generated in the same
directory where the TriStation 1131 project is located. The default
setting is for the files to not be generated.
Note: These files will look just like the .BT2 and .SOE files
generated by the TriStation 1131 software when you
download an application to the controller. You will not be
able to distinguish between files generated by a
download to the Emulator, and files generated by a
download to the controller. You may want to make a note
of the date and time each time you download the
application to the Emulator, so you can compare that
timestamp to the date/time of the generated files.
Property Action
Communication Optional. Required only if you want to test Peer-to-Peer
Modules (CMs) communication using the Emulator.
for Peer-to-Peer Select the communication module you want to get Peer-to-Peer
configuration information from and then select the network that the
communication module you selected is connected to. The default is
NET 1.
Note: If no CM modules are listed, you have not configured any
communication modules for Peer-to-Peer communication in
your project.
The Peer-to-Peer configuration from the selected communication
module will be used by the Emulator so that you can test your Peer-
to-Peer functionality using emulated nodes.
Only one Peer-to-Peer configuration can be used by the Emulator. If
redundant communication modules are installed in a single logical
slot, you must select the physical communication module (LEFT or
RIGHT) with the configuration you want to use. The default is
LEFT.
See Testing Peer-to-Peer Communication on page 34 for more
information about using Peer-to-Peer communication with the
Emulator.
Communication Optional. Required only if you want to test Modbus communication
Modules (CMs) using the Emulator.
for Modbus Select the communication module you want to get Modbus
configuration information from and then select the network that the
CM you selected is connected to. The default is NET 1.
Note: If no CM modules are listed, you have not configured any
communication modules for Modbus communication in
your project.
The Modbus configuration from the selected communication
module will be used by the Emulator so that you can test your
Modbus functionality using emulated nodes.
Only one Modbus configuration can be used by the Emulator. If
redundant communication modules are installed in a single logical
slot, you must select the physical communication module (LEFT or
RIGHT) with the configuration you want to use. The default is
LEFT.
See Testing Modbus TCP Communication on page 35 for more
information about using Modbus communication with the
Emulator.
If you have Triconex DDE Server or SOE Recorder running on the same
CAUTION PC as the Emulator, they must be configured to use different UDP port
numbers (1500 for Emulator, 1501 for DDE Server, and 1509 for SOE
Recorder). Prior to connecting to the Emulator, verify that you have
configured the UDP ports correctly.
Please note that the Emulator will not be able to communicate with a
Triconex DDE Server or SOE Recorder application running on the same
PC as the Emulator. To test DDE and SOE communication with the
Emulator, the DDE and SOE clients must be running on a separate PC.
Procedure
1 Start TriStation 1131, and open the project with the programs you want to run on the
Emulator.
2 Open the Controller workspace, expand the Configuration tree, and double-click
Emulator Panel.
3 Click Connect . The Emulator configuration dialog box opens in the background.
4 Go to Chapter 2, Configuring the Emulator for instructions on configuring Emulator
settings.
If you have Triconex DDE Server or SOE Recorder running on the same
CAUTION PC as the Emulator, they must be configured to use different UDP port
numbers (1500 for Emulator, 1501 for DDE Server, and 1509 for SOE
Recorder). Prior to connecting to the Emulator, verify that you have
configured the UDP ports correctly.
Please note that the Emulator will not be able to communicate with a DDE
Server or SOE Recorder application running on the same PC as the
Emulator. To test DDE and SOE communication with the Emulator, the
DDE and SOE clients must be running on a separate PC.
Procedure
1 In the Windows taskbar, click the TRxEMCodeEmulator button.
The TRxEMCodeEmulator dialog box appears.
The dialog box name differs, depending on the controller type and the Emulator options
settings:
• For Tricon applications, the dialog box is named TR1EMCodeEmulator.
• For Trident or Tri-GP applications, the dialog box is named TRDEMCodeEmulator.
• For Tricon, Trident, and Tri-GP applications, if the multiple Emulator instances
option is enabled (see Specifying Emulator Project Options on page 10), the dialog
box is named the same as the node name defined on the TriStation Communication
screen (the default is TRINODEx, where x is the node number configured in the
application).
2 Do one of the following:
• If you have previously configured the Emulator for use with this application, and
you saved the Emulator settings to a file, go to Loading the Emulator Configuration
from a File on page 21.
• If you have not configured the Emulator for use with this application before, or you
do not want to use saved configuration settings, go to the next step.
3 Specify the following properties.
Note Only the Node Number and Server IP Address properties are required. All other
properties are optional. You do not need to specify properties that do not apply
to your desired testing scenario. For example, if you will not be using TSAA
functionality, you do not need to configure the TSAA properties.
4 Once you have configured all the settings required for your testing scenario, you are
ready to download the application to the Emulator. Do one of the following:
• If you will NOT be testing Peer-to-Peer communication, go to Chapter 3, Testing
Applications on the Emulator.
• If you will be testing Peer-to-Peer communication, go to Configuring Peer-to-Peer
Communication for Testing on page 22 to verify that Peer-to-Peer communication
has been configured correctly in your application before downloading the
application to the Emulator.
The Emulator’s settings are NOT saved automatically. Once you disconnect from the Emulator
(or click End in the TRxEMCodeEmulator dialog box), all settings are cleared and reset to the
default values the next time you connect to the Emulator. To save these settings to a file for
future use, see Saving the Emulator Configuration to a File on page 20.
Procedure
1 In the TRxEMCodeEmulator dialog box, under Set Configuration File, click Browse. The
Open dialog box appears.
2 Browse to the location where you want to save the Emulator configuration file.
3 In the File Name field, enter a name for the Emulator configuration file. You can use any
naming convention that you like.
4 Click Open. The Open dialog box closes and you are returned to the
TRxEMCodeEmulator dialog box.
5 Click Save Configuration. The configuration information you entered for the Emulator
is saved to the file you created.
Procedure
1 In the TRxEMCodeEmulator dialog box, under Set Configuration File, click Load
Configuration.
The Open dialog box appears.
2 Browse to the location where you previously saved the Emulator configuration file.
3 Select the configuration file and then click Open.
The Open dialog box closes and you are returned to the TRxEMCodeEmulator dialog
box.
4 Click Load Configuration.
5 When asked to confirm that you want to load configuration information from the
selected file, click OK.
The configuration information from the selected file is copied into the Emulator
configuration dialog box.
6 Verify the Emulator settings loaded from the file are correct.
7 Once you have verified all the settings required for your testing scenario are correct, you
are ready to download the application to the Emulator. Do one of the following:
• If you will NOT be testing Peer-to-Peer communication, go to Chapter 3, Testing
Applications on the Emulator.
• If you will be testing Peer-to-Peer communication, go to Configuring Peer-to-Peer
Communication for Testing on page 22 to verify that Peer-to-Peer communication
has been configured correctly in your application before downloading the
application to the Emulator.
Procedure
1 In TriStation 1131, expand the Controller tree, and double-click Configuration.
2 On the Configuration tree, click TriStation Communication.
Node Number
3 Locate the number entered in the Node Number field. For the TCM, this is the number
represented by the Network Node Address setting on the MP front panel.
You may want to write this number down, so you can compare it to the Emulator’s node
number in the next step.
4 Verify the node number entered on the Emulator configuration screen matches the node
number entered on the TriStation Communication screen.
See Configuring the Emulator’s Settings on page 16 for instructions on accessing the
Emulator configuration screen.
Procedure
1 In TriStation 1131, expand the Controller tree, double-click Configuration, and expand
Hardware Allocation.
2 Double-click the slot where the TCM or CM module is installed, and then click Setup.
The TCM Setup (Tricon) or CM Setup (Trident/Tri-GP) dialog box appears.
3 Click the Peer-to-Peer tab.
4 Under Slot Selection, select the module you want to configure Peer-to-Peer ports for.
Property Action
Destination UDP Port Enter the UDP port number for each controller to be
communicated with on the Peer-to-Peer network. This must
be the same number that the controller uses as its UDP Base
Port Number.
The default is 1503.
Network Click the network port that the TCM or CM uses to
communicate with the selected Peer-to-Peer node. The default
is NET 1.
NET 2 is not available for model 4353 and 4354 TCMs.
IP Address Enter the IP address for the controller.
6 Click Update to save the new settings for the selected node.
If you forget to click Update before selecting another node, your settings will be lost.
7 Repeat steps 4 through 6 for each node to be included in the network.
Note If you need to start over for any reason, click Reset All to reset all node settings
for the selected slot to their default, unconfigured state.
8 Once all nodes have been configured, specify these properties (applicable to all nodes on
the Peer-to-Peer network).
Property Action
UDP Base Port Number For each network port, enter the UDP base port number for
the controller. Enter 0 to disable Peer-to-Peer over UDP/IP on
the network.
The default is 1503 on both NET 1 and NET 2 (meaning Peer-
to-Peer is enabled on both ports). UDP port numbers do not
need to be unique, as long as the IP addresses for each port is
unique. See the TriStation 1131 Developer’s Guide for reserved
values.
Available only for NET 1 on model 4353 and 4354 TCMs.
Enable Communication Select the check box to enable communication with Tricon
with Tricon V8 and V9 version 8 and 9 systems on the NET 1 port. The default is
Peer-to-Peer Systems on cleared.
NET 1 (TCM Only) Available only for a module installed in the left slot.
Enable Communication Select the port — NET 1 or NET 2 — on which you want to
with Tricon V8, Tricon enable Peer-to-Peer communication with Tricon version 8
V9, and Trident v1 Peer- and 9 systems, and/or Trident version 1 systems. The default
to-Peer Systems is None.
(Trident 2.x or Tri-GP Available only for a module installed in the left slot.
CM Only)
The default value for these properties is zero (0). If Maximum Number of
CAUTION Peer-to-Peer Receives and Maximum Number of Peer-to-Peer Sends are
both set to zero, Peer-to-Peer communication is NOT enabled in your
application, and you will not see any Peer-to-Peer messages sent, even if
Peer-to-Peer communication is configured on the TCM or CM.
The maximum number does not have to be the same for Sends and Receives. For example, a
TriStation 1131 application might need to send messages to three applications, but need to
receive messages from only one application.
A change in Peer-to-Peer allocation requires a Download All.
Procedure
1 In the TriStation 1131, expand the Application tree, double-click Implementation, and
then click Peer-to-Peer Configuration.
• Multiple instances of the Emulator are allowed. See Specifying Emulator Project
Options on page 10 for instructions on enabling multiple instances.
• Instances of the Emulator may be running on the same PC, or on different PCs.
• Each instance of the Emulator can emulate only one Tricon, Trident, or Tri-GP
controller at a time.
• For SOE data, a maximum of 63 controllers can be emulated. Nodes 1-31 can be Tricon,
Trident, or Tri-GP controllers, while nodes 32-63 can be Trident or Tri-GP controllers
only. (However, since SOE Recorder can only retrieve events from up to 16 controllers
simultaneously, you don’t need to emulate more than 16 controllers.) Each controller
being emulated requires a separate instance of the Emulator. For example, if you are
emulating two Tricon controllers and three Trident controllers, you’ll need to have five
instances of the Emulator running.
• The maximum number of Emulator instances you can run simultaneously on a single
PC is dependent upon the size and complexity of your application, and the amount of
memory you have installed in your PC. The bigger and/or more complex your
application, the more memory you will need for multiple instances.
• Single Emulator instances are terminated when the TriStation 1131 software
disconnects from the Emulator, but multiple Emulator instances must be terminated
manually.
Events can be retrieved from a Triconex controller or the Emulator. You can use the Emulator
to test the SOE blocks configured in your application, verifying that event collection is enabled
and ensuring the correct retrieval of events by your SOE client. If you have SOE blocks
configured in your application, SOE functionality will be available in the Emulator
automatically after you download your application. No additional configuration in the
Emulator is necessary.
Each instance of the Emulator can simulate a Tricon, Trident, or Tri-GP controller that is
generating SOE data. Multiple Emulator instances allow you to test SOE event retrieval from
multiple controllers. See Specifying Emulator Project Options on page 10 for instructions on
enabling multiple instances.
Note SOE clients must be running on a different PC than the Emulator. The Emulator cannot
communicate with an SOE client that is running on the same PC, even if the UDP ports
are different.
When you download your application to the Emulator, an SOE definition file (.SOE) is
generated in TriStation 1131 (only if you selected the SOE file generation option; see Specifying
Emulator Project Options on page 10). The .SOE file is created in the same directory where the
corresponding TriStation project is located. SOE configuration information is then extracted
from that file and downloaded to the Emulator.
The .SOE file generated by TriStation 1131 for use with the Emulator
CAUTION cannot be used for SOE event retrieval on a controller. If this file is used
for event retrieval on a controller, events will not be collected. After you
have completed testing SOE on the Emulator, delete this file from the
SoeConfig folder on the SOE Recorder PC.
When you run your program, the Emulator generates SOE data based on state changes in the
following variables:
• Discrete Input
• Discrete Memory Read/Write
• Discrete Memory Read Only
Note SOE data generation is available when the Emulator is using the primary server IP
address only. If the Emulator switches to the redundant server IP address, SOE data
generation will stop. See Configuring the Emulator’s Settings on page 16 for information
on the primary and redundant server IP addresses.
Alias-to-Bin Offset
SOE requests are sent for specific SOE block numbers; tagnames are assigned to each block.
Each tagname is associated with a unique alias number. However, the Emulator’s SOE
simulation accesses discrete variables (tagnames) using TSAA bin and offset instead of alias
numbers. The following tables show how alias numbers are translated to bin/offset numbers in
the Emulator.
For more information about SOE, see the SOE Recorder User’s Guide and the Communication
Guide for your controller.
Application
with Triconex
Modbus TCP Emulator
Configured
The following are guidelines for using the Emulator to test Modbus TCP communication:
• Only one Modbus TCP configuration can be used by the Emulator. If redundant
communication modules are installed in a single logical slot, prior to downloading
your application to the controller, you need to select the physical module (LEFT or
RIGHT) with the Modbus configuration you want to use. This module selection is
made in the Emulator Project Options dialog box; see Specifying Emulator Project
Options on page 10 for more information.
• The network selected in the Emulator Project Options dialog box (NET 1 or NET 2)
must be the same as the network selected in the Modbus TCP configuration in the
application. If these do not match, Modbus emulation will not work.
• A maximum of 63 nodes are supported. Nodes 1-31 can be Tricon, Trident, or Tri-GP
controllers. Nodes 32-63 can be Trident or Tri-GP controllers only.
• Emulated Modbus TCP functions support all features (including scaling) of Modbus
TCP functions when executed on a Triconex controller.
• The Emulator will check for Modbus TCP messages on both the master and slave every
10 milliseconds (ms).
For more information about using the Modbus protocol, see the TriStation 1131 Developer’s
Guide, the TriStation 1131 Libraries Reference, and the Communication Guide for your controller.
Note For detailed information about using the Download Changes command on the
controller, see the TriStation 113 Developer’s Guide.
The Download Changes command will be unavailable for the Emulator if any of the following
situations applies:
• You have not yet performed a Download All of the project to the Emulator. The
Download Changes command is not enabled for the Emulator until after a Download
All has been completed.
• You used the Change State to Download All command in TriStation 1131 to change the
project’s state to Download All for the controller. The Download Changes command in
the Emulator will be unavailable until you perform another Download All to the
Emulator.
• The Emulator downloaded project version has a major or minor value less than the last
controller downloaded project version. Only a Download All to the Emulator is
allowed in this situation. See Changes to the Project Version After Downloading on
page 39 for more detailed information.
Procedure
1 Verify you have connected to the Emulator and configured the settings as described in
Configuring the Emulator’s Settings on page 16.
2 If you want to test Peer-to-Peer and/or Modbus communication with the Emulator,
verify you have selected the CM with the Peer-to-Peer and/or Modbus configuration
information you want to use. See Specifying Emulator Project Options on page 10 for
more information.
Note If you selected a CM module during an earlier download to the Emulator, and
want to use the same CM’s configuration information, you do not need to select
it again. The Emulator will automatically use the configuration information from
the previously selected CM.
3 If you want an SOE definition file (.SOE) or project backup file (.BT2) generated, verify
you have selected the appropriate file generation project options. See Specifying
Emulator Project Options on page 10 for more information.
These files will look just like the .BT2 and .SOE files generated by
CAUTION TriStation 1131 when you download an application to the controller. You
will not be able to distinguish between files generated by a download
to the Emulator, and files generated by a download to the controller.
You may want to make a note of the date and time each time you
download the application to the Emulator, so you can compare that
timestamp to the date/time of the generated files.
Note If a communication module is found in the application being downloaded, but it has not
been configured for Peer-to-Peer or Modbus communication, warning message(s) will
appear in the Messages pane. These messages will also appear if you have an EICM,
NCM, or a Trident v1.x CM configured in the application being downloaded. If you
don’t want to test Peer-to-Peer or Modbus communication with the Emulator, ignore
these messages.
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
3 In the Windows taskbar, click the TRxEMCodeEmulator button.
The TRxEMCodeEmulator dialog box appears.
Note The dialog box name differs, depending on the controller type and the
Emulator’s options settings. See Configuring the Emulator’s Settings on page 16
for more information.
4 View the following properties at the top of the dialog box:
Property Description
Req Scan Displays the requested scan time for the application running on
the Emulator. The requested scan time is the time specified in the
project.
Real Scan Displays the actual scan time for the application running on the
Emulator. The actual scan time is the actual length of time
required by the Emulator to complete the last scan. The actual scan
time is equal to or greater than the requested scan time.
Exec Time Displays the execution time for the programs in the application
that is running on the Emulator, as specified in the program
execution list.
Status Displays the current state of the application running on the
Emulator.
Possible states are OFFLINE, IDLE, RUNNING, HALTED, and
PAUSED.
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
3 On the Emulator tree, expand Programs, and click the program you want to monitor.
Monitoring Variables
This procedure explains how to monitor and test values for variables in an application running
on the Emulator.
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
3 Run a program, as described in Monitoring a Program’s Execution on page 42.
4 If needed, drag variables to be tested onto the Emulator sheet.
5 Double-click a variable to view its Item Properties dialog box and make changes to its
value.
6 For the Set Value property, enter a test value and click Confirm. The value is applied to
the selected variable.
7 Continue to monitor the program execution.
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
3 If you want to use previously saved changes to the MP system status function block
parameters, load the configuration file with the settings you want to use. See Loading
the Emulator Configuration from a File on page 21.
4 On the Emulator tree, expand Programs, and click the program with the MP system
status function blocks you want to test.
8 Click the MP System Status tab. A list of the input and output parameters available for
the MP system status function block appears.
Parameter Status
MPMAIN FALSE
MPBAD FALSE
IOMAIN FALSE
IOBAD FALSE
For detailed information about these function blocks, please see the TriStation 1131 Libraries
Reference.
State transitions and/or changes to the controller’s I/O module(s) status can impact the
application running on the controller. This procedure explains how to force changes to the I/O
status function blocks running on the Emulator, so you can test how your application reacts to
I/O status changes.
As long as you save your configuration before you disconnect from the Emulator, changes you
make to the I/O module status function block parameters will be saved as part of the Emulator
configuration file. This means you do not need to reconfigure these parameter settings each time
you download an application to the Emulator. See Saving the Emulator Configuration to a File
on page 20.
Note The Emulator will not validate any logic when emulating the I/O module status
function blocks. It is up to you to use a valid combination of output parameter settings.
See the TriStation 1131 Libraries Reference for assistance in determining valid
combinations of parameter settings.
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
3 If you want to use previously saved changes to the I/O module status function block
parameters, load the configuration file with the settings you want to use. See Loading
the Emulator Configuration from a File on page 21.
4 On the Emulator tree, expand Programs, and click the program with the I/O module
status function blocks you want to test.
Note The dialog box name differs, depending on the controller type and Emulator
options settings. See Configuring the Emulator’s Settings on page 16 for more
information.
8 Click the I/O Status tab.
9 Select the I/O module you want to change status parameters for. Changes can only be
made to the parameters for one module at a time.
Note The module selection list includes only the I/O modules that are configured in
the application currently running on the Emulator. For an explanation of the
module addresses provided in the list, see Interpreting the I/O Module Address
and Description on page 49.
A list of the parameters available for the selected module’s I/O status function block
appears.
PASS TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
FAIL FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE
ACTIVE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
LOADFUSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE
INSTALLED TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
VOTER_FAULT FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE
OVD_ENABLED TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NOGOOD FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE
TMR TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
GE_DUAL TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
GE_SINGLE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NO_FLTS TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
LOGIC_PWR1_OK TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
LOGIC_PWR2_OK TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
PASS_LEFT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
ACTIVE_LEFT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
INSTALLED_LEFT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
LOCKED_LEFT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NO_ACTIVE_FLTS TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
PASS_RIGHT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
ACTIVE_RIGHT FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE FALSE
INSTALLED_RIGHT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
LOCKED_RIGHT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NO_FLD_ALARM_LEFT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NO_FLD_ALARM_RIGHT TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
FLD_PWR1_OK TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
FLD_PWR2_OK TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NO_FLD_FLTS TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
NO_VOTER_FLTS TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE TRUE
FLD_OK_01 —a — — TRUE — — — — — —
FLD_OK_02 — — — TRUE — — — — — —
FLD_OK_03 — — — TRUE — — — — — —
FLD_OK_04 — — — TRUE — — — — — —
SIGNAL_PRESENT_1 — — — — — — — — TRUE —
SIGNAL_PRESENT_2 — — — — — — — — TRUE —
SIGNAL_PRESENT_3 — — — — — — — — TRUE —
SIGNAL_PRESENT_4 — — — — — — — — TRUE —
SIGNAL_PRESENT_5 — — — — — — — — TRUE —
SIGNAL_PRESENT_6 — — — — — — — — TRUE —
INPUT_STABLE_1 — — — — — — — — TRUE —
INPUT_STABLE_2 — — — — — — — — TRUE —
INPUT_STABLE_3 — — — — — — — — TRUE —
INPUT_STABLE_4 — — — — — — — — TRUE —
INPUT_STABLE_5 — — — — — — — — TRUE —
INPUT_STABLE_6 — — — — — — — — TRUE —
SPRVSD_ON_01_16 — — — — — — — 0xFFFF — —
a. A dash (—) indicates that the parameter does not apply to this module.
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
3 Run a program, as described in Monitoring a Program’s Execution on page 42.
4 If needed, drag variables to be tested onto the sheet.
5 Double-click a variable, and select the Annotate check box on the Variable tab.
Annotate
check box
7 Click the Macros button to change the macro identified with the annotation.
8 Do one or more of the following:
• To copy a macro, click the macro name and press Ctrl+C.
• To paste the macro, close the Edit Macros dialog box, click in the Annotation area,
and press Ctrl+V.
• If desired, enter text with the macros.
9 Continue testing, as needed.
Disabling Points
While your program is running on the Emulator, you can disable points so that you can assess
the impact of disabling those points in an application running on the controller.
Disabling points on the Emulator is completely separate from disabling points on the controller.
Points that are disabled in the program running on the Emulator will NOT also be disabled in
the application that is currently running on (or will be downloaded to) the controller.
When a point is disabled, it holds its last value. Inputs from field instruments or the application
running on the Emulator do not change the value of the point. Disabling points is typically used
when field instruments need to be replaced or repaired. Disabling points can increase the scan
time.
For Tricon v9.x controllers, a maximum of 64 points can be disabled at any one time. For Tricon
v10.x controllers, a maximum of 256 points can be disabled. There is no maximum to the
number of points that can be disabled for Trident or Tri-GP controllers.
When you disable one or more points, the number of disabled points output parameter
(POINTS_DISABLED) in the TR_PROGRAM_STATUS (Tricon) or SYS_MP_EXT_STATUS
(Trident/Tri-GP) function block is updated on the Emulator. Additionally, the alarm state for
disabled points is also changed to TRUE in the TR_SHUTDOWN (Tricon) or SYS_SHUTDOWN
(Trident/Tri-GP) function block. See the TriStation 1131 Libraries Reference for more information
about these function blocks.
In order to disable points in the Emulator, the Allow Disabling of Points property must be
selected on the TriStation 1131 Operating Parameters screen. Enabling this property can
increase the scan time, regardless of whether any points are actually disabled. See the TriStation
1131 Developer’s Guide for more information.
The disabling (and subsequent re-enabling) of points is saved to the TriStation 1131 Project
History. To view information about when a point was disabled, and who disabled it, from the
Project menu, select View Project History.
Topics include:
• Disabling Points on the Emulator on page 53
• Viewing Disabled Points on the Emulator on page 54
• Re-enabling Disabled Points on the Emulator on page 54
Procedure
1 Connect to and configure the Emulator, as described in Configuring the Emulator’s
Settings on page 16.
2 Download an application, as described in Downloading to the Emulator on page 36.
Procedure
1 Click Run to execute the application on the Emulator.
2 From the Commands menu, select List Disabled Points.
3 If desired, select the points you want to enable, and then click OK.
O rules 39
offset, alias-to-bin 33 protocols
operating systems supported 8 emulating 4
supported 2
options, setting 10
R
P
READ_TRICON_CLOCK command, TSAA 4
P2P UDP Port Number property 18
READ_TRICON_DATA command, TSAA 4
parameters
redundant communication 4
APP_LOCKED 46
I/O module status 50 Redundant IP Address property 19
MP status 46 redundant server 19
POINTS_DISABLED 53 re-enabling points 54
REMOTE_WRT_ENABLE 46
REMOTE_WRT_ENABLE parameter 46
Peer-to-Peer
rules
allocating memory 26
communication 30
configuring in application 22
project versioning 39
downloading configuration 12, 38
Emulator UDP port 18 running a program 42
function blocks 27
functions supported 34 S
guidelines for emulation 34 saving Emulator configuration 20
multiple instances for 34
node number 22 scan time, monitoring 41
overview 6 Server IP Address property 17
port numbers 26 SET_TRICON_CLOCK command, TSAA 4
Send/Receive properties 26 SOE
TCM port configuration 24 alias-to-bin offset 33
testing 34 controllers emulated 31
Trident 2.x port configuration 24 definition file (.SOE) 11, 32, 38
Tri-GP port configuration 24 function blocks supported 4, 32
warning messages 38 testing 32
points variables, data for 32
disabling 7, 53
SOECLR function block 4, 32
forcing 53
re-enabling 54 SOESTAT function block 4, 32
viewing disabled 54 SOESTOP function block 4, 32
POINTS_DISABLED parameter 53 SOESTRT function block 4, 32
port numbers starting the Emulator 13
Peer-to-Peer 18, 24, 25, 26 stopping a program 42
UDP 18, 25
Support TSAA Protocol property 18
POUs 38
SYS_AI32_STATUS 7, 47
process alarm function blocks 6
SYS_AO04_STATUS 7, 47
program execution, monitoring 42
SYS_DI16_AI16_STATUS 7, 47
program organizational units 38
SYS_DI32_STATUS 7, 47
program, running on Emulator 42
SYS_DO16_STATUS 7, 47
project options 10
SYS_IO_STATUS 7, 47
project state 39
SYS_MP_EXT_STATUS 53
project version
SYS_MP_STATUS 6, 44, 46
changes 39
downloaded 39, 40 SYS_PI06_STATUS 7, 47