Creating AVEVA InTouch HMI Access Names

Tech Note: ISS-TD 001
Published Date: October 12, 2022
Primary Product: InTouch HMI
Revision Date:

This Training Document is avaiable for public viewing. Access to our full library of training documents is included with any current Industrial Software Solutions Training Subscription.

To learn more about ISS Training Subscriptions and pricing, please contact us.
CONTACT US


SUMMARY

AVEVA InTouch HMI uses Access names to reference real-time I/O data. Each Access name is associated with an I/O source (such as an AVEVA OI Server) that must be on the same network as the InTouch application node.

This training document will walk you thought the steps to set up an Access Name in a Stand Alone AVEVA InTouch HMI application.

APPLIES TO

  • InTouch HMI (all versions)

PROCEDURE

Section 1 – Creating the Access Name

  1. In InTouch WindowMaker, open your application. One the Special menu, select Access Names.
  1. Click Add.
  1. In the Add Access Name window, you enter the appropriate values into the fields shown below:
OPTION PURPOSE
Access Name The Access name must be unique for each I/O source.
Node Name The Node Name is the computer name or IP address of the computer on the network which is hosting the I/O source (typically an AVEVA OI Server). A blank Node Name implies the I/O source is running on the local node.
Application Name The Application Name is the process or executable running on the remote computer, which InTouch will connect to. Note: Do not enter the “.exe” extension portion of the program name.
Topic Name The Topic Name is the device group, scan group, or channel used by one or more items (PLC memory addresses) that will be polled at a specific frequency or rate. The OI Server must contain the same spelling of the topic name in its device group list configuration.
Which Protocol to use Select DDE (local node only) for support of older I/O servers, or connections to Microsoft Office products; or SuiteLink (proprietary network protocol).
When to advise server

Advise all items: Select if the server program is to poll for all data whether or not it is in visible windows, alarmed, logged, trended or used in a script. Selecting this option impacts performance and is not recommended.

Advise only active items: Select if the server program is to poll only points in visible windows and points that are alarmed, logged, trended, or used in any script. An InTouch Pushbutton action script is not polled unless it opens in a visible window.

In our example, we are using the following values:

Access Name: ModbusPLC
Node Name: InTouchPC
Application Name: MBTCP
Topic Name: Normal
Which Protocol to use: SuiteLink
When to advise server: Advise only active items
  1. Click OK. The new item will now appear in the Access Names
  1. Click Close.

Section 2 – Adding Access Names to InTouch I/O Tags

In order for InTouch I/O tags to collect values from an I/O source, it must be associated with an Access name. An Access name defines a communication link with another I/O data source. Each Access name specifies an external I/O source consisting of a node name, an application name, and a topic. When you create I/O tags, you must associate them with an Access name in the definition of the tag.

  1. On the Special menu, select Tagname Dictionary.
  2. In the Tagname Dictionary window, click New.
  3. In the Tagname field, enter an appropriate tagname.  Our example uses “Mixer100_Level_PV”.
  1. Click Type and select the appropriate I/O tag type (our example uses I/O Integer) and click OK.

Note that when an I/O tag type is selected, an additional panel appears to configure the I/O details.

  1. Click Access Name. The Access Name window appears.
  2. Select the Access name you want to use and click OK.

Notice the tagname has been copied into the Item field, but it is grayed out so it cannot be edited. This field indicates the item that will be requested from the I/O source.  The Item name can be edited by changing the name of the tag. Otherwise, you must uncheck Use Tagname as Item Name to edit the Item field or create a Device Items list in the OI Server as detailed in the next section.

Section 3 – Create an OI Server Device Items List

The Item Name is used to determine which data value is retrieved from the I/O source.  In some instances, the item name in the I/O source may be different than the Tagname being used in the InTouch application (such as a PLC that uses numerical addresses instead of tags).  In these cases, you can either A) uncheck the Use Tagname as Item Name option for the tag and edit the Item Name field with the correct I/O source reference or B) you can create a list of all references on the Device Items tab of the OI Server configuration.

  1. In the System Platform Management Console, expand the Configuration section of the OI Server until you reach the PLC configuration. Our example is using the MBTCP OI Server.
  1. Select the Device Items tab. Right-click in the table area and select Add.
  1. In the Name field, enter the Tagname from the InTouch application. In our example, we are using the Mixer100_Level_PV tag.
  2. In the Item Reference field, enter the item in the PLC that you want to use for the listed tag. In our example, we are referencing the value at the 300001 address.
  1. When you have entered all the needed references, click on the save icon in to top right corner to save the configuration.

Once the Device Items list is saved, if any client (e.g. InTouch) requests the value for an item that is on the list, it will return the value of the configured reference in the PLC.  In our example, requesting the value of Mixer100_Level_PV from the MBTCP OI Server will return the value at address 300001 in the PLC.


All Industrial Software Solutions Training Documents are provided "as is" without warranty of any kind.