The PI Interface for Siemens Spectrum Power TG (SIPowerTG) allows real-time data from the Siemens Spectrum Power TG system to be written to a PI system.
The interface runs on the Siemens Power TG host station and processes data files generated by the Power TG HIS software.
The interface is available for both Windows and Linux (64-bit) platforms, and both versions have the same functionality. There are differences in the installation and configuration of the interfaces. This manual covers the Linux version of the interface.
The interface does not allow data from the PI system to be written to the Siemens Power TG system. The interface does not support UniInt failover. However, by using the Power TG functionality, interface redundancy is supported.
All types supported by the Power TG historian software including alarm and event messages
* See paragraphs below for further explanation.
Source of Timestamps
The data received from the Power TG system includes a UTC timestamp for each event. That timestamp is passed to the PI server with the event values.
The Interface does not explicitly support history recovery. However, if the interface is not running and processing the data files, then the Power TG system will buffer the data in the data files. When the interface is restarted, the buffered data will be processed normally and no events will be lost.
UniInt stands for Universal Interface. UniInt is not a separate product or file; it is an OSIsoftdeveloped template used by developers and is integrated into many interfaces, including this interface. The purpose of UniInt is to keep a consistent feature set and behavior across as many of OSIsoft’s interfaces as possible. It also allows for the very rapid development of new interfaces. In any UniInt-based interface, the interface uses some of the UniIntsupplied configuration parameters and some interface-specific parameters. UniInt is constantly being upgraded with new options and features.
The UniInt Interface User Manual is a supplement to this manual.
The SIPowerTG interface is built with a version of UniInt that supports disconnected start-up. Disconnected start-up is the ability to start the interface without a connection to the PI Server. This functionality is enabled by adding /cachemode to the list of start-up parameters or by enabling disconnected startup using the ICU. Refer to the UniInt Interface User Manual for more details on UniInt disconnected startup.
Functionality has been added to UniInt 220.127.116.11 and later to support health tags. The PISIPowerTG interface is built against a version of UniInt that supports the health tags.
The Health tag with a string point type and the attribute ExDesc = [UI_DEVSTAT], is used to represent the status of the interface. The possible values for this string point are:
“1 | Starting” – The Interface remains in this state until it has successfully collected data from its first scan.
“Good” – The interface is able to collect data. A value of “Good” does not mean that all tags are receiving good values, but it is a good indication that there are no hardware or network problems.
“4 | Intf Shutdown” – The Interface has shut down.
The Interface updates this point whenever the interface is started or stopped.
The interface itself does not support failover. However, the Power TG system does support failover between stations. This means that if an instance of the interface is run on both stations, when the station fails over, the interface on the active station will send events to the PI server. See section Interface Specific Failover for more details.
Power TG Historian (HIS) software version 8.3 SP1or greater is required to generate the event data and message data files used by the interface. The interface runs directly on the Power TG historian machine.
Additional PI Software
Two utilities are included with the interface to allow the input files from the Power TG system to be dumped to stdout and can be used to validate the raw data that the interface will be reading. The utilities are DumpInputFile and DumpAlarmFile.
The utility BufStat is also included to allow the Power TG system to evaluation the status of the connections to the PI Server when bufserv is used.
Device Point Types
The interface can support any measurement point type and field that is encoded in the event data files or any alarm or event message stored in the alarm files produced by the Power TG historian software.