LIVE DATA INTERFACE USER GUIDE PUBLICATION HSELD-UM023A-EN-E–May 2012 Supersedes Publication HSELD-UM022A-EN-E
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 4 Subscribe to product and service e-mail notifications. Ask questions. World
1 ● Introduction ● ● ● ● ● 5 technical resources. TechConnect service levels are provided at the TechConnect site (http://www.rockwellautomation.co
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 6
Chapter 2 7 Principles of Operation The FactoryTalk Live Data (FTLD) Interface is a FactoryTalk Live Data client that enables process data to be p
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 8 The figure below shows the basic workflow of the FactoryTalk Historian Live Data I
2 ● Principles of Operation ● ● ● ● ● 9 Servicing output points as events arrive. Servicing triggered input points as events arrive. The Hist
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 10 The count of points loaded by the interface. Error messages for points reje
Chapter 3 11 Configuring FactoryTalk Historian Live Data Interface To configure a FactoryTalk Historian Live Data Interface (FTLD), we recommend t
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 12 To open the Interface Configuration Utility (ICU) online help, go to Start > A
3 ● Configuring FactoryTalk Historian Live Data Interface ● ● ● ● ● 13 If you configure an interface in the ICU, the batch file of the interface (F
● ● ● ● ● Copyright ii Contact Rockwell Automation Customer Support Telephone — 1.440.646.3434 Online Support — http://www.rockwellautomation.com/s
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 14 The FTLD Interface configuration is displayed on the General page of the ICU. 6.
3 ● Configuring FactoryTalk Historian Live Data Interface ● ● ● ● ● 15 Note that in this example the API Hostname is localhost, which means that th
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 16 Adding Remote Servers to Connection Manager To add a remote server to the Connect
Chapter 4 17 Point Source The FactoryTalk Historian Live Data Interface uses FTLD as the Point Source. A Point Source is a unique, single- or mult
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 18 Subsystem Point Source character RampSoak 9 Performance Equations C Do not use t
Chapter 5 19 Point Configuration A FactoryTalk Historian point is the basic building block for controlling data flow to and from the FactoryTalk H
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 20 Length The Tag field allows a maximum of 1023 characters. Point Source The Point
5 ● Point Configuration ● ● ● ● ● 21 For more information on the individual point types, refer to the FT Historian SE Server Reference Guide, avail
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 22 Location4 Location4 defines the scan class for the Historian point. The scan clas
5 ● Point Configuration ● ● ● ● ● 23 InstrumentTag InstrumentTag contains the ItemID of the tag. The format of this field depends on the FactoryTal
Contents iii Introduction ... 1 Installation ...
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 24 SourceTag An output point is associated with a trigger point by setting the Sourc
5 ● Point Configuration ● ● ● ● ● 25 available in the Common Files > Rockwell > Help folder in your Program Files directory. Exception Repor
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 26 Trigger Method 1 (Recommended) For Trigger Method 1, a separate trigger point mus
5 ● Point Configuration ● ● ● ● ● 27 Sample Tag Configurations See the following sample tag configurations: Scan Classes (page 27) Polled Tag
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 28 Tag InstrumentTag Loc1 Loc2 Loc3 Loc4 Loc5 OneMin.PV ItemID2 1 0 0 2 0 NinetyMin.
5 ● Point Configuration ● ● ● ● ● 29 If the event_condition is not specified then it defaults to Anychange. The update rate for event items groups
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 30
Chapter 6 31 I/ORates Tag Configuration An I/ORates tag measures the throughput of an FTLD Interface. In particular, the value of an I/ORate point
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 32 To access the I/ORates tag data in ICU, select IO Rate from the left pane of the
6 ● I/ORates Tag Configuration ● ● ● ● ● 33 Suggest In the ICU dialog box, click it if you want the system to suggest the next available Event C
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide iv Point Configuration ... 19 Point A
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 34
Chapter 7 35 Performance Point Configuration Performance Point tags document how long it takes to complete a scan. Due to the architecture of this
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 36
Chapter 8 37 Startup Command File In Windows, command file names have a .bat extension. The Windows continuation character (^) allows for the use
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 38 Required parameters: Parameter Description /ps=Source The /ps parameter specifies
8 ● Startup Command File ● ● ● ● ● 39 Parameter Description /f=SS or /f=SS,SS or /f=HH:MM:SS or /f=HH:MM:SS,hh:mm:ss Required for reading scanbased
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 40 Parameter Description /maxstoptime=stoptime Default = 120 seconds. When an interf
8 ● Startup Command File ● ● ● ● ● 41 Parameter Description /q Default = no queuing. When the /q parameter is present, Snapshots and exceptions are
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 42 Setting File For more flexibility, the FTLD interface can use an INI format file
8 ● Startup Command File ● ● ● ● ● 43 FTLDResponseInterval The FTLDResponseInterval key specifies the time interval during which the FTLD interface
● Contents ● ● ● ● ● v Performance Point Configuration ... 35 Startup Command File ...
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 44
Chapter 9 45 Interface Node Clock Make sure that the time and time zone settings on the computer are correct. Check the settings in the Date and T
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 46
Chapter 10 47 Security The Trust Database must be configured so that the FTLD Interface is allowed to write data to the FactoryTalk Historian serv
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 48
Chapter 11 49 Starting and Stopping the Interface Once you have installed the FTLD interface as a service, you can start and stop it in two ways:
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 50 3. On the tool bar, click . 4. Wait, until the status on the status bar at the
Chapter 12 51 Error and Informational Messages The FTLD Interface is based on the PI-UniInt framework, therefore a few error messages are sent to
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 52 Severity Message text Warning PI point <%s> is refused because of the inval
12 ● Error and Informational Messages ● ● ● ● ● 53 Error Descriptions The descriptions of system and PI errors can be obtained with the pidiag util
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 54
Index 55 Index A Adding Remote Servers to Connection Manager • 16 Advise and Polled Tags • 22 Advise Tags • 28 C Command-line Parameters • 37 C
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 56 PI 3 Server Node Reserved Point Sources • 17 PI 3 Server Nodes • 20 Point Attribu
Chapter 1 1 Introduction The FactoryTalk Historian system uses the PI system as a back end to store tag data. The FactoryTalk Historian Live Data
● ● ● ● ● FactoryTalk Historian Live Data Interface User Guide 2 The complete user documentation on FactoryTalk Historian SE is available in the Co
1 ● Introduction ● ● ● ● ● 3 Related Documentation The following documentation provides additional information related to the FTLD Interface: Fa
Comentarios a estos manuales