Introduction to the Wonderware Operations Integration Simulation Server (OI.SIM / DASIM)

Legacy Number#

Doc ID: TN1098

Version: 1.0

Last Modified: 01/29/2016

SUMMARYThe Wonderware Simulation Server (OI.SIM and DASSIM) can simulate any device item name and can be configured to simulate Boolean, Integer, Floating Point, and String values. OI.SIM can also simulateprocess values and setpoints. The simulation server is installed with the OI Core. DASSIM is separate install. This Tech Note describes the configuration for OI.SIM although the configuration for DASSIM issimilar.

ACTIONConfiguring OI.SIMTo configure OI.SIM

1.  Open the IDE and expand Operations Integration Server Manager. 2.  Expand Operations Integration Supervisory Servers/Wonderware – SIM/OI.SIM.1.3.  Right-click Configuration then click Add PORT_TEST Object.

Figure 1: Add Port_Test Object 

4.  Right-click the PORT_TEST object and click Add PLC_TEST Object.

Figure 2: Add PLC_TEST

Legal Information | Privacy Policy © Schneider Electric

PLC_TEST Object Parameters

AlgorithmThere are several types a simulation algorithms that determine the behavior of the values returned by OI.SIM:

Algorithm Comments

NoneThe data value will not change by itself. You canuse it to test and validate your poking values.

Sine Wave The data value will follow a sine wave.

CosineWave

Values returned will create a Cosine Wave

Saw Tooth The data value will follow a sawtooth wave

Toggle Boolean Values will toggle between 1 and 0

Triangular The value value will follow a triangular wave

StringThe data value will have a string with a serialnumber of the syntax "TEST: { SerialNumber }"

Random The data value will be generated randomly

The algorithm used to simulate values can be set globally or on a per-item basis. To globally set the algorithm, change the Algorithm parameter in the PLC_TEST object. To specify the simulation algorithm on aper-item basis, specify one of the following algorithm names as a suffix to the item using / (forward slash) as the delimiter (using an algorithm suffix will override the global algorithm):

NoneSineCosineSawtoothToggleTriangularStringRandom

For example: An item name of "iPumpAmps /random" will return a random integer.

Rate of Change(msec) – The rate of change of the value in milliseconds.Percentage Change PerInterval – The percentage of the range that the value can change per interval.Range/Group – The range of signal values.Force Quality – Forces the simulated value to one of the following OPC Qualities:

GoodBadBad ConfigureNot ConnectedDevice FailSensor FailLast known valueCommfailOut of serviceUncertainLast usable valueSensor not accurateEngineering unitsSubnormalLocal Override

Items Per Message – Specifies the maximum number or items that can be composed into 1 message internally inside OI.SIMUnsolicited Updates – Leave this checked (selected)

Use the Device Groups tab to define a device group or topic.

Figure 3: Device Groups tab

Advising ItemsDefault Item Data TypesBy default the item data types are determined by the first character of the item name. The table below shows the item name configuration to determine the data type returned for that item:

First Character Data Type Example

Legal Information | Privacy Policy © Schneider Electric

i or I 32-bit integer iPumpRunHours

b or B Boolean bPumpStart

f or F 32-bit float fPumpSpeed

d or D 64-bit float dPumpAmps

s or S String sPumpName

You can override the default data types by defining your own item syntax. This is done by specifying the appropriate regular expression in the syntax definition file named TagSyntax.txt. This file is located under“\ProgramData\Wonderware\OI-Server\$Operations Integration Supervisory Servers$\OI.SIM\OI.SIM\”.The TagSyntax.txt file contains examples of the various definitions:

Figure 4: TagSyntax definitions file

To define your own item syntax and data type, enter a regular expression defining the item syntax followed by a comma then the data type. For example:^[fF].* , VT_R4

Character Description

^ Look at the beginning of the string

[fF] Look for f or F

.* Followed by any character(s)

The above example matches any string that starts with f or F. The value returned will be a 32 bit floating point data type. For example, if you advise a tag named “fTag1”, the value returned will be a 32 bit floatingpoint data type.Note: OI.SIM uses the Microsoft ATL regular expression parser for this purpose. For more information on Microsoft ATL regular expressions go to https://msdn.microsoft.com/en-us/library/k3zs4axe(v=vs.80).aspxAdvising Process ValuesProcess values can be simulated using the following item name suffixes:

Suffix Description Default Value Example

/sim.pv The process value for the corresponding tag 70.0 Tag1 /sim.pv

/sim.sp The setpoint for the associated process value 60.0 Tag1 /sim.sp

/sim.dev The maximum deviation the setpoint and process value can have 6.0 Tag1 /sim.dev

/sim.noise The maximum amount of fluctuation the process value can have 3.0 Tag1 /sim.noise

 You can also use an alternate suffix to simulate process values (this alternate suffix is defined in the PVSyntax.txt file):

Suffix Description Default Value Example

.pv The process value for the corresponding tag 70.0 Tag1.pv

.sp The setpoint for the associated process value 60.0 Tag1.sp

.dev The maximum deviation the setpoint and process value can have 6.0 Tag1.dev

.noise  The maximum amount of fluctuation the process value can have 3.0 Tag1.noise

Examples of Reading Simulation items using App ServerIn this example, we will create a DDESuiteLinkClient object and configure it to point to the OI SIM Server:

Legal Information | Privacy Policy © Schneider Electric

Figure 5: DDE SuiteLink using the OI SIM Server

1.  Type the topic information. The topic name in the DDESuiteLinkClient object will match the Device Group name configured in OI SIM server:

Figure 6: Topic information 

2.  Create a UserDefined Application Object and configure several Attributes that will point to simulation items. Here is an example that shows all the example items in the sections above:

Legal Information | Privacy Policy © Schneider Electric

Figure 7: Attributes-to-simulation items

Note: The I/O definition in the example above shows we are reading from the DDESuiteLinkClient named “SIM_SL” through topic “FurnacePLC” and simulation item “fPumpSpeed”. Since we know that anysimulation item that starts with f is a 32 bit floating point data type, we also set the data type for this attribute to a Float.

After deploying our objects, we can then open Object Viewer and put all our attributes in the watch window:

Figure 8: Put object attributes in the Object Viewer Watch Window

The Watch window shows us that all tags are good quality and returning the correct data type.

For the process value simulation items, we can provide a new setpoint for SimTags.Tag1.sp and watch the process value (SimTags.Tag1.pv) follow. Below is an InTouch real time trend demonstratingthe process simulation when changing SimTags.Tag1.sp from 60 to 30:

Legal Information | Privacy Policy © Schneider Electric

Figure 9: InTouch trend on value change

Legal Information | Privacy Policy © Schneider Electric