Configuring the DDESuitelink Client Object in the ArchestrA IDE

Legacy Number# 615
Doc ID: TN259
Version: 7.0
Last Modified: 06/24/2015

SUMMARY
 This Tech Note is provided courtesy of Wonderware PacWest.
This Tech Note details the procedure used to configure DDE (Data Dynamic Exchange) and Wonderware Suitelink client connections using Wonderware Application Server and the ArchestrA IDE (Integrated
Development Environment). The DDESuiteLinkClient object available in Archestra IDE provides a client connection to DDE or Suitelink servers so that data can be read and written to external data sources such as
a PLC (Programmable Logic Controller).
This Tech Note consists of three parts:

1.  The first part details the process of configuring and deploying a new instance of the $DDESuiteLinkClient object template to communicate with a data source.
2.  The second part details testing of the deployed DDESuiteLinkClient object.
3.  The third part builds on the previous steps and configures an automation object in order to reference data from the DDESuiteLinkClient object. Specifically, this example details the procedure for
connecting Wonderware Application Server to a DAServer (Data Access Server) using the DDESuitelinkClient object.

SITUATION
Contents

Creating, Configuring and Deploying a New DDESuiteLinkClient Object Instance
Testing the Deployed DDESuiteLinkClient Object
Configuring an Application Object to Reference DDESuiteLinkClient Object Data
 

Application Versions

Wonderware Application Server 2.x, 3.x
Wonderware DAServer/IOServer

Creating, Configuring and Deploying a New DDESuiteLinkClient Object Instance
1.  Open the ArchestrA IDE application by clicking Start -> All Programs -> Wonderware -> ArchestrA IDE. Then connect to the appropriate Galaxy. For this tech note the galaxy's name is Testing. 

 
Figure 1: Connect to Testing Galaxy

A deployed Platform, Engine and Area are necessary for this example (Figure 2 below).

Figure 2: Platform > Engine > Area

2.  Click the Template Toolbox tab and locate the $DDESuiteLinkClient object template.
3.  Right-click the object template and select New > Instance to create a new instance of the DDESuiteLinkClient object.

Legal Information | Privacy Policy
 Figure 3: New Object Instance 

You should now see a new instance of this object in the Unassigned Host area of the Deployment View (Figure 4 below).

Figure 4: New Object Instance in Unassigned Host Area

4.  Double-click the newly created instance to open its configuration editor.
5.  On the General tab type the Server Node and the DA Server name.

Figure 5: Type Server Node Name and DA Server Name

• Server node field: Type the node name or IP address where the I/O or DAServer is located. In this example the DAServer is located on a host called MARKB2.
• Server name field: Type the application name of the DDE or Suitelink server. In this example the application name is DASABCIP. If the required application name for the data source is not known, refer
to the product documentation.
6.  Next configure the rest of the fields for this object:

• Detect connection alarm: Generates an alarm upon connection loss 
• Communication protocol: Determines whether DDE or Wonderware SuiteLink protocol is used. 
• DDE login: Allows a specific Windows user account to be used for DDE/NetDDE communication. 
• Reconnect security: Determines the security classification required to be able to force a reconnection to the data source.
7.  Click the Topic tab. Click on the blue plus (+) sign above the topic list to add a new topic. In this example, our topic name is PLC1.

Legal Information | Privacy Policy
 Figure 6: Add a New Topic

This topic name needs to exactly match the topic or device group that has been configured in the I/O or DAServer. If the required topic name is unknown, review the configuration of the associated I/O or
DAServer (below is an example of the DASABCIP device group configuration).

Figure 7: Topic Name for DAServer
 
8.  Save your changes, and check in the configured DDESuiteLinkClient object. Assign your object to an Engine from the Deployment View.
 
9.  Make sure the I/O or DAServer being used is started before you deploy it.
10.  Right-click the object and select Deploy. Click the OK button to confirm deployment. 

Figure 8: Deploy the Object

Figure 9: Successful Deployment
 

Testing the Deployed DDESuiteLinkClient Object
1.  Right-click the deployed DDESuiteLinkClient object and click View in Object Viewer. This will open the Object Viewer window. 

The Object Viewer window displays object attributes for the DDESuiteLinkClient object.
2.  Locate ConnectionStatus and confirm its value is Connected.

 
Figure 10: ConnectionStatus displays Connected

If the ConnectionStatus is not Connected, review the the DDESuitelinkClient object configuration for errors, and make sure that the associated I/O or DAServer is running and connected to the network.

Note: The values listed in the Object Viewer are not automatically updated. To update the current value of an attribute, either click and highlight the attribute in the list, or right click on the appropriate attribute and
add it to the watch window.
Configuring an Application Object to Reference DDESuiteLinkClient Object Data

Legal Information | Privacy Policy
1.  Select an appropriate Application Object from the Template Toolbox. Right-click on this object and select New > Instance. In this example, the $Boolean object template is used.

Figure 11: Create a $Boolean Object Instance

Move this new instance from the Unassigned Host area to an Area instance in Deployment View. 

 
Figure 12: Boolean Instance in Area

2.  Double-click this new object instance to open its configuration editor.
3.  On the General tab type the I/O reference in the PV Input Source field.

Figure 13: PV input source Value

Use the following format for the PV input source:

<DINetworkObject_Name>.<Topic_Name>.<Item/Register> 

Where: 
<DINetworkObject_Name>: The instance name of the DDESuiteLinkClient object 
<Topic_Name>: the exact topic name configured in the DDESuiteLinkClient object 
<Item/Register>: the data item from the data source, typically a PLC register or tagname

For example: DDESuitelinkClient_001.PLC1.$SYS$Status
4.  Save and check-in this object.
5.  Next, right-click on this object, select Deploy, then OK.
6.  After the object is deployed, right-click it and select View in Object Viewer from the menu.
7.  Locate the PV attribute in the list and confirm that both its value is correct, and the quality is C0:Good.

Legal Information | Privacy Policy
  
Figure 14: PV Value is Good

If the value is not correct and/or the quality is not good, confirm that the configuration for this item is correct and it is a valid data point in the PLC.

M. Boisvert

Legal Information | Privacy Policy