E-Terracontrol 3.9 Reference Manual - Interfaces To Field Devices
E-Terracontrol 3.9 Reference Manual - Interfaces To Field Devices
This document describes the modeling and configuration activities for e-terracontrol.
e-terracontrol includes several applications that provide interfaces to field devices,
including the CFE Reader, the OPC DA Client, the PLC Reader, the TrueTime Reader,
and Relay Reader applications.
NOTE: CONTAINS PROPRIETARY INFORMATION OWNED BY ALSTOM GRID INC. AND/OR ITS
AFFILIATES. DO NOT COPY, STORE IN A RETRIEVAL SYSTEM, REPRODUCE, DISTRIBUTE,
TRANSMIT OR DISCLOSE TO ANY THIRD PARTY WITHOUT PRIOR WRITTEN PERMISSION FROM
ALSTOM GRID INC.
__________________________________________________________________
Trademarks
“ESCA” and “HABITAT” are registered trademarks of ALSTOM Grid Inc. “eterra” is a registered
trademark and/or service mark of E-Terra, LLC, licensed for use by ALSTOM Grid Inc. in connection with
its e-terra family of products and services.
Other product and company names in these materials may be trademarks or registered trademarks of
other companies, and are the property of their respective owners. They are used only for explanation and
to the respective owners’ benefit, without intent to infringe.
Contents
About This Document ............................................................................................... xi
Purpose of This Document ............................................................................................ xi
Who Should Use This Document .................................................................................. xi
Structure of This Document .......................................................................................... xi
For More Information.................................................................................................... xii
Conventions ................................................................................................................ xiii
Change Summary ....................................................................................................... xiii
Figures
Figure 1. CFE Reader Data Hierarchy ............................................................................ 4
Figure 2. CFE Logging Features ..................................................................................... 6
Figure 3. CFE Reader User Interface ............................................................................ 13
Figure 4. CFE Reader Data Set Dialog Box .................................................................. 14
Figure 5. Accumulator Type Dialog Box ........................................................................ 16
Figure 6. CFE Event Log Window ................................................................................. 18
Figure 7. CFE Configuration Data Window ................................................................... 19
Figure 8. PCL Records Window .................................................................................... 19
Figure 9. CFE Statistics Window ................................................................................... 21
Figure 10. PCLTXT Records Window ........................................................................... 23
Figure 11. CFE Data Set Display – Event Log Tab ....................................................... 24
Figure 12. CFE Data Set Display – Event Log per Port Tab ......................................... 25
Figure 13. CFE Data Set Display – Line Analyzer Tab.................................................. 25
Figure 14. CFE Data Set Display – Socket Trace Tab .................................................. 26
Figure 15. Bucket Data Set Dialog Box ......................................................................... 27
Figure 16. Time Device Data Set Dialog Box ................................................................ 28
Figure 17. Port Data Set Dialog Box ............................................................................. 29
Figure 18. Port Communication Statistics Dialog Box ................................................... 31
Figure 19. RTU Data Set Dialog Box............................................................................. 33
Figure 20. RTU Communication Statistics Dialog Box .................................................. 36
Figure 21. RTU Detailed Error Counts Dialog Box ........................................................ 37
Figure 22. Table View of Point Data Window ................................................................ 38
Figure 23. Scan Group Data Set Dialog Box ................................................................. 39
Figure 24. Scan Group Data Set Dialog Box ................................................................. 40
Figure 25. Scan Group Detailed Error Count Dialog Box .............................................. 41
Figure 26. Card Data Set Dialog Box ............................................................................ 42
Figure 27. Measurement Display Dialog Box ................................................................ 45
Figure 28. CFE Reader – Log Tab ................................................................................ 46
Figure 29. CFE Reader – Communication Log Tab ...................................................... 47
Figure 30. CFE Reader – Configuration Tab ................................................................. 48
Figure 31. Communication Diagnostic Tab ................................................................... 54
Figure 32. Logging Control Tab ..................................................................................... 55
Figure 33. Log Tab ........................................................................................................ 57
Figure 34. Relationships Among the Components in the Line Analyzer ........................ 59
Figure 35. Line Analyzer Server Display without a Client Connection ........................... 60
Figure 36. Line Analyzer Server Display with a Client Connection ................................ 60
Figure 37. Line Analyzer Client Login Display ............................................................... 61
Figure 38. Line Analyzer Client Display......................................................................... 62
Tables
Table 1. Modules and Associated Codes ...................................................................... 20
Table 2. OPC Quality to e-terracontrol SCADA Quality Mapping ................................ 121
Table 3. Basic Conformance Statement ...................................................................... 192
Table 4. ACSI Models Conformance Statement .......................................................... 193
Table 5. ACSI Service Conformance Statement ......................................................... 194
Table 6. MiCOM P40 ................................................................................................... 199
Table 7. MiCOM P30 ................................................................................................... 203
Table 8. MiCOM P20 ................................................................................................... 205
Table 9. Alstom Grid.................................................................................................... 207
Table 10. Other IEDs................................................................................................... 209
Table 11. S and X in a Single Scan ............................................................................. 214
Table 12. S and X in Different Scans .......................................................................... 214
Table 13. S X X S S X in Single Scan ......................................................................... 215
Table 14. S X, X S, and S X in Different Scans ........................................................... 215
Table 15. S X X S S and X in Different Scans ............................................................. 216
Table 16. S X S and X S X in Different Scans ............................................................. 216
Table 17. S X S S in Single Scan ................................................................................ 217
Conventions
The e-terracontrol applications support the keyboard and mouse operations common to
the Microsoft Windows interface.
Any additions to, enhancements of, or departures from standard Windows conventions
are noted in this document.
Change Summary
The following changes were made to this document for e-terracontrol 3.9:
• Updated section 1.5.7 ScadaPort.
• Added section 1.5.10 UseErrorCntToDisconnect.
• Updated section 1.8.1.7 Scan Group Data Set.
• Added section 1.12.21 -PSTRMS_W_ REQUEST_SKIP _0799.
• Added section 1.12.22 -PSTRMS_E_RTUPOL_0800.
• Added section 3.3 cfeperfdata.txt File Format.
• Added a description of the "Scada database name" argument in section 7.1
TrueTime Reader Command-Line Arguments.
• Added chapter 13 Double Point Processing.
For e-terraplatform users, the bold lines represent the data that is downloaded directly
to the CFE Reader application.
CFE
#6
RTU Comm.
#4
#7 Serial
#1: Log Message to SMP
#9 #8
network #2: Log States Changes
#10
B2B and Digi Log Control Requests
Terminal Server Log Timers
#3: CFE control log
#4: CFE communication log
#11 #5: CFE SPY
#6: CFE event log
#7: Line monitor
RTU RTU #8: Socket trace
#9: Port monitor
#10: Wireshark
#11. Other tools
1.5.2 Host(s)
By default, the CFE Reader connects to the SCADA application running on the local
computer. However, in a case where the CFE Reader application does not reside on the
same machine as the SCADA server, the address of the SCADA server must be passed
in the Host1 argument. In a dual-state environment, the Host2 argument is used to pass
the address of the secondary SCADA server. The two SCADA servers must store the
same data source to which the CFE Reader is dedicated. In cases where the host
machines have more than one NIC card, the Host3 and Host4 arguments can be used
to specify the additional IP addresses:
Host1=<HostName, Host2=<HostName2, Host3=<HostName3, Host4=<HostName4>
This argument is optional.
1.5.4 Enable/Disable
The Enable (or Disable) argument forces a number of additional log options, essentially
related to the communications with the SCADA application. For more details about
these options, refer to section 1.8.4 CFE Reader Configuration Tab.
The possible log options are:
• SmpLogState: Logs data set state changes
• SmpLogControl: Logs control requests
• SmpLogTimers: Logs timers
• SmpLogConnections: Logs connections and disconnections with SCADA
• SmpLogRefresh: Logs refresh (i.e., demand scan) requests
• SmpLogMessages: Logs messages from the CFE Reader to e-terracontrol
• CrashOption: If enable=CrashOption is configured, the CFE Reader aborts when
there is a problem in a third-party device driver resulting in a non-functional port-
handling thread within the CFE Reader. The problem port number as well as the
1.5.7 ScadaPort
ScadaPort is the value to identify which TCP/IP port the CFE Reader application uses to
communicate with SCADA:
ScadaPort=<portvalue>
where:
• portvalue is the port number through which CFE Reader communicates with
SCADA. The default value is 5020 for NTLM/Kerberos authentication and 7000 for
Certificate-based authentication.
• portvalue should match the port number on which the SCADA server is listening.
Note: If this parameter is configured, the SOE log file will be generated in a
subdirectory named using the port number. This is to separate SOE files for different
Scada instances, if there are multiple Scada instances running.
1.5.8 CFGDIR
CFGDIR specifies the directory where the CFE Reader stores/retrieves the CFE Reader
configuration files such as <datasource>_local_items.cfg and alarmconfig.dat.
1.5.9 /exceptionhandler=XXX
where XXX = fulldump or minidump
Allows the Process Starter to generate the fulldump or minidump file when the
CFE Reader crashes for any known/unknown reason.
1.5.10 UseErrorCntToDisconnect
Skip the RTU line disconnection message at the driver level and instead wait for the
error count to reach its maximum value before disconnecting the RTU.
Caution: Alstom Grid does not recommend using this parameter because it violates
the DNP3 protocol.
Example:
UseErrorCntToDisconnect=true
This argument is optional; default value is false.
Note: Prior to adding a process to an existing group, you must end all processes
by clicking Stop on the Process Starter toolbar, or via the Actions menu item (see
“Process Starter Console Toolbar” and “Process Starter Console Menu Bar” in the
e-terracontrol Reference Manual: Applications).
4. To create a new Process Starter group, select Processes > Add Process.
The Configuration tab for Processes opens.
5. In the Name, Program, Params, and Directory text boxes, enter the required
information. If you do not know the location of the CFEReader.exe file, click the
Ellipsis button (…) next to the Program text box to browse for the file. Sample values
are as follows:
Name: CFE Reader
Program: C:\eterra\e_terracontrol\bin\cfereader.exe
Params: datasource=Cfereader_Bmtfe_a,host1=PC883,host2=PC354
Directory: C:\eterra\e_terracontrol\bin
6. If desired, select the Minimize check box.
7. If you do not want to see the GUI, uncheck the Visible check box.
8. In the Restart frame, select the On Exit radio button.
9. Click OK, and then save the file.
Note: Sample CFE Reader data sources and data sets are available in the
esca60_rtu.sdb SCADA database located in the ~\eterra\e_terracontrol\samples
folder.
This display provides the ability to configure the hourly communication statistics
functionality. Data set configuration is performed in the SCADA server application (see
“Data Set Dialog Box” in the e-terracontrol Reference Manual: Applications).
The following are included in the CFE Reader Data Set dialog box:
• Current State: Displays the link status (ONLINE, OFFLINE, FAILED, HIER
OFFLINE, INITDONE, or UNKNOWN).
• Heart Beat Rate: Displays the heartbeat rate in seconds. Each heartbeat issues a
periodic scan request to the RTUs.
• Exploratory Rate: Displays the exploratory scan rate on failed devices, in seconds.
• ALE Integrity Rate: Displays the Analog Limit Excursion integrity rate in seconds.
An ALE report is directly transmitted to SCADA as a series of Analog Input changes.
Note: The hourly statistics do not have to be reset for all RTUs at the same time.
The Communication Statistics display enables you to manually reset the statistics
for a single RTU, or for the RTUs of a specific port.
The user-assigned values for the “AccumName_xx” parameter in the CFE Reader data
set are displayed in this window.
The following are included in the Accumulator Type dialog box:
• Key: Displays the name specified as xx in the “AccumName_xx” parameter name
• Freezable: Indicates whether or not a freeze request is issued prior to reading the
measurement
• Reset When Read: Indicates whether or not the accumulator measurement value is
reset to a value of zero after it has been read
• Individual Freeze: Indicates whether the freeze request must be sent to each
accumulator individually, or broadcast to all RTUs on the communication line
For each accumulator, a timer called “xx_Read” (where xx denotes the accumulator
type label) must be defined in the Timers area of the SCADA database. If the Freeze
option is set, an additional timer, “xx_Freeze”, must also be defined.
The freeze and read operations on the accumulators of a given type occur when
SCADA notifies its CFE Readers that the corresponding timer has expired. These
timers must also be assigned to the CFE Reader data set data type in the SCADA
Types subtree of the SCADA database. The assigned relationship name for each
accumulator timer must match the timer name, as described above.
Note: You can only model one CFE data set for each type of CFE.
The CFE display provides the ability to set up the four log options that can be
associated with a given CFE:
• Line Analyzer
• CFE Event Log
• Spy Log
• Socket Trace (TCP/IP only)
The following are included in the upper pane of the display:
• Key: Displays the hierarchical subtree name for the selected CFE
• Current State: Displays the link (ONLINE, OFFLINE, FAILED, HIER OFFLINE,
INITDONE, or UNKNOWN)
• Subscript: Displays the zero-based index value of the CFE within CFE Reader
• CFE Type: Displays the CFE type (WINSTRMS or TSISTRMS). WINSTRMS is the
normal configuration, where the CFE software component runs on the Windows
CPU.
• CFE Server: (TSISTRMS only) – Obsolete
• Firmware Name: (TSISTRMS only) – Obsolete
• Firmware Date: (TSISTRMS only) – Obsolete
• Include in Spy Traffic: Checking this box includes the traffic on this CFE in the spy
buffer.
Note: The Spy Log option must also be enabled on the CFE Reader Configuration
tab (see section 1.8.4 CFE Reader Configuration Tab). If CFE Reader was
launched with the “enable=spylog” command-line argument, this option is enabled
by default.
• Include in Comm Log: This check box can be used to add the CFE to the
Communication Log filter. By default, the Comm Log filter is inactive, which means
that all CFE- or port-level communication events are logged.
In this case, the check box is disabled. If the check box is enabled, the filter is active:
the box must be checked for the Comm log to display the communication events that
relate to this CFE.
• Update Event Log: Updates the statically displayed CFE Event Log window (Figure
6). This button can be identified by the exclamation point icon.
The following button is available at the top of the lower pane (Figure 6):
• Read CFE Event Log: Opens the CFE Event Log display, and sends a DUMP
request to the CFE for displaying the latest events.
The CFE Event log lists events in chronological order.
The Event log is not automatically refreshed. To update the display, select Update
Event Log in the CFE window.
The CFE Configuration Data window can be viewed by selecting View CFE
Configuration from the Tools menu.
The following are included on the Event Log tab (Figure 11):
• Enable Log to Buffer: Enables or disables the CFE’s logging to the internal event
buffer. If disabled, new events are not displayed in the CFE Event Log display. The
Event log is activated by default.
• Enable Log to File: Enables the event buffer to be stored as a file named
“cfe_event_<CFE number>.dat”. If such a file already exists, it is renamed
“cfe_event_<CFE number>.log”. The event buffer contains more data than the Event
log (display or file). This feature is available only to WINSTRMS CFEs.
• Enable Log to Console: Enables the standard output of the CFE that is the
cfecontrol.log file for WINSTRMS CFEs. The CFE Event logs are written to the file.
• Enable/Disable by Severity: You can select which message severities are sent to
the log by checking the box next to each desired level of severity: Success,
Informational, Warning, Error, and Fatal.
• Enable/Disable by Module: You can enable the Event log on individual module(s)
by selecting the boxes next to MUX, RTU, LINE (activated by default since they
constitute the application level), ISR, LISTEN, and TPORT (physical or transport
layers in the OSI model).
The following are included on the Event Log per Port tab:
• Check Box to Enable Event Log for Port: You can select which port(s) are
enabled for event logging.
Line Analyzer Tab
When the CFE line analyzer is enabled, low-level CFE code logs all transmitted and
received RTU data to the Line Analyzer file in the requested format (WINSTRMS CFE).
The following are included in the Time Device Data Set dialog box:
• Key: Displays the hierarchical subtree for the defined item
• Poll Rate: Rate (in seconds) for checking the state of the time device. This field is
the only one in the database tree that is edited from the CFE Reader itself.
• Current Time: Time stamp as polled from the defined device
The following are included in the Port Data Set dialog box:
• Key: Displays the hierarchical subtree for the defined item.
• Current State: Displays the link (ONLINE, OFFLINE, FAILED, HIER OFFLINE,
INITDONE, or UNKNOWN).
• Protocol Name: Displays the protocol name. This name (usually the protocol name
preceded by the letter “P”) must exist in the CFE Reader’s table of supported
protocols. Modification of this parameter requires you to force re-initialization of the
communication path.
• CFE Type – Port Type: This frame details the port configuration according to the
CFE type. For a WINSTRMS CFE, a port can only be serial, dialup, or TCP/IP.
Proprietary – See Copyright Page 29 CFE Reader
e-terracontrol Reference Manual: Interfaces to Field Devices
Modification of this parameter requires you to force re-initialization of the
communication path.
• LineSet: Under a WINSTRMS CFE, it displays whether the port uses a TCP/IP or a
serial connection. Modification of this parameter requires you to force re-initialization
of the communication path.
• Local Data Register: (TSISTRMS only) – Obsolete
• SCC Configuration: (TSISTRMS only) – Obsolete
• SCC Config Parameters: (TSISTRMS only) – Obsolete
• ISR Table: (TSISTRMS only) – Obsolete
• Port Model (WINSTRMS only): Displays the port model type. “Normal” is checked
for a normal (serial or TCP/IP) port. “Dialup Master” is checked for the port that is
used as the parent of all dialup RTUs. “Dialup Modem” is checked for a port that
represents a dialup modem (this port model type has no children RTUs).
• Address (WINSTRMS only): Displays the address of the port. For serial, it is the
com port address (COMx, where x is the port number). For TCP/IP, it is the IP
address, either in full dot notation (xxx.xxx.xxx.xxx) or any recognized name for the
remote host. For a dialup modem port, it is the com port address (COMx) where the
dialup modem is connected. Modification of this parameter requires you to force
re-initialization of the communication path.
• Physical Address: Displays the COM port number that is used for initializing the
SCC chip.
• Port Subscript: Displays the zero-based index value of the port within the subtree.
• Baud Rate: Displays the baud rate in bits per second. Modification of this parameter
requires you to force re-initialization of the communication path.
• Protocol Timeout 1: Displays the protocol-specific timeout #1 in milliseconds.
Modification of this parameter requires you to force re-initialization of the
communication path.
• Protocol Timeout 2: Displays the protocol-specific timeout #2 in milliseconds.
Modification of this parameter requires you to force re-initialization of the
communication path.
• Interbyte Gap Timeout: Displays the interbyte gap, which is the timeout between
two read bytes in milliseconds. Modification of this parameter requires you to force
re-initialization of the communication path.
• Reply Timeout: Displays the No Reply timeout in milliseconds. Modification of this
parameter requires you to force re-initialization of the communication path.
• EOM Delay (bits): Displays the End Of Message delay in bits. This is the number of
bit times to wait before the driver determines that another byte is not arriving.
• Special Support: This function was associated with the obsolete VME-based CFE
(TSISTRMS) configuration.
The following are included in the RTU data set dialog box:
• Key: Displays the hierarchical subtree for the selected data item.
• Current State: Displays the link status (ONLINE, OFFLINE, FAILED, HIER
OFFLINE, INITDONE, or UNKNOWN).
• Skip Integrity Scan After Error: Checked if the integrity scan that is normally done
after an error should be skipped. This is usually set only when scan staggering is
disabled.
The following are included in the RTU Communication Statistics dialog box:
Header
• RTU: Name of the RTU
Column Headings
• Hour of Day
• Attempts: Number of communication attempts for the hour
• No Reply Errors: Number of No Reply errors for the hour
• CRC Errors: Number of Cyclic Redundancy Code errors (also called BCH errors)
for the hour
• Other Errors: Number of miscellaneous errors for the hour
• % Loading: The approximate percent of available communication time (time that the
line is enabled and available for use) that was used for communications
The following are included in the RTU Detailed Error Counts dialog box:
Header
• RTU: RTU name
The following are included in the Table View of Point Data window:
• Point Name: Displays the point name
• Physical Address: Displays the address of the point within the card
The events that originate from the user interface of the CFE Reader are unformatted
text strings. The events that originate from the core component (CfeControl) of the
application follow this syntax:
<Module>_<Event Type>_<Event Number> - <Text>
Where:
• <Module> is the name of a CFE Reader module. CFE Reader is currently
constituted of the following modules: CFECTL (CfeControl), CFE, PORT, RTU,
SCNGRP (Scan Group), CARD, MEAS (Measurement), TIMDEV (Time Device),
BUCKET, SPY, PSTRMS (Pstreams), and CSTRMS (CfeStreams).
• <Event Type> is the type of event: S (Success), I (Informational), W (Warning), E
(Error), or F (Fatal).
• <Event Number> identifies the event among the collection of events for this module.
The Communication log displays up to 400 messages. The messages follow the same
format as the CFE Reader log, except that each message is preceded by the name of
the object it relates to.
Communication messages relate either to CFE objects (CFE Reader to CFE
communications) or Port objects (CFE to RTU communications).
Local Items
Local Items are parameters that the CFE Reader uses to manage its communications
with CFEs, RTUs, and the time device. Unlike the other communication data, these
parameters are local to the application, they can be modified at any time, and they can
be saved as default parameters for the current data source.
• RTS Timeout (msec): Request-to-Send timeout in milliseconds. Value is 60 and
cannot be modified.
• CFE Timeout (heartbeats): The CFE level or Port Level request timeout, in units of
heartbeats.
Note: The size must be specified before you enable the option.
Caution: Selecting to log informational messages can hang the CFE Reader
application due to the large volume of messages.
Communication Log
• Disable Output: Disables the Communication log.
• Log to File: Sends the Communication log output to a file named
“COMMLOG<date>_<time>.log”.
• Limit Length to…MB: Limits the size of the Communication log output file to the
number of megabytes specified in the adjacent text box. After the size limit has been
reached, the CFE Reader closes the file, creates a new file, and resumes logging to
the new file.
Note: The file size must be specified before you enable the option.
• Comm Filter Enabled: If selected, communication messages are logged only if their
origin object is listed in the Communication filter.
• Edit Comm Filter: Opens the Comm Filter Editor window. This display lets you
select or deselect individual CFEs and ports as part of the Communication filter.
Note: CFEs and ports can also be individually selected from their own display.
• Severity Filter:
– Success: If selected, completion messages are included in the log.
– Informational: If selected, informational messages are included in the log.
Spy Log
The Spy log contains diagnostic information about the communication between the CFE
Control and the CFE, in the CFE-to-TFE protocol. The messages are time-stamped and
interpreted. The Spy log is made up of a circular buffer; the only output is in the form of
a text file.
Note that, once activated, the Spy log cannot be deactivated.
• Enable Traffic Dump: Enables the Spy log. The Spy log takes the form of a file
named “Cfe_spy.dat”. If such a file already exists, it is renamed “Cfe_spy.log”.
• Continuous Spy Dump: Select to perform continuous dumps of the Spy log
contents. Each time a message is received by the Spy log, it is automatically written
to the file.
• Single Spy Dump: Select to perform a single dump of the Spy log. The content of
the buffer is only dumped to a file upon your request.
• Dump to File: If the Spy log is configured as Single, dumps the content of the buffer
to the file “Cfe_spy.dat”.
If the Spy Log option has been specified in the CFE Reader command line, the option is
automatically selected for all CFEs.
If the Spy log is enabled by selecting Enable Traffic Dump on the Configuration tab, the
file is created but no CFEs are specified. In this case, the Spy log must be activated
individually on the CFE Data Set display.
Note: Because remote monitoring software (e.g., PcAnywhere) can make it difficult
to issue the CTRL keystroke to the monitored application, the “S” key has the
same effect as the CTRL key.
The following items are included on the CFE Reader Remote Diagnostic
Communication Diagnostic tab:
• Check Box(es) to Enable Line Analyzer: Select which port(s) to enable for the
Line Analyzer by selecting the check box next to the name of the line. The data
retrieved from each line is stored in a separate file named “cfe_line_monitor_<CFE
number>_<Line number>.dat”. Disabling and re-enabling a line causes the Line
Analyzer data to be appended to the file.
• Protocol Interpretation: The protocol interpretation should be selected prior to
enabling the Line Analyzer for any given port. Select from the pull-down menu
whether or not protocol interpretation is to be used. Options are RAW (no protocol
interpretation) and INTERPRETED (protocol interpretation used if available in the
selected protocol).
• Check Box(es) to Enable Socket Trace: Select which port(s) to enable for socket
trace by selecting the check box next to the name of the line. This only applies when
using TCP/IP.
The following items are included on the CFE Reader Remote Diagnostic Logging
Control tab:
CFE Reader Log
• Disable Event Viewer Output: Disables the output to the Event Viewer.
• Log to File: Sends the CFE Reader log output to a file named
“CfeControl<date>_<time>.log”.
• Limit Length to…MB: Limits the size of the CFE Reader log output file to the
number of megabytes specified in the adjacent text box. After the size limit has been
reached, the CFE Reader closes the file, creates a new file, and resumes logging to
the new file.
Note: The size must be specified before you enable the option.
Note: The file size must be specified before you enable the option.
• Severity Filter:
– Success: If selected, completion messages are included in the log.
– Informational: If selected, informational messages are included in the log.
– Warning: If selected, warning messages are included in the log.
– Error: If selected, error messages are included in the log.
– Fatal: If selected, fatal messages are included in the log.
The CFE Reader Remote Diagnostic Log tab displays events relating to the CFE
Reader’s communication with the CFEs.
The Communication log displays up to 400 messages. The messages follow the same
format as the CFE Reader log, except that each message is preceded by the name of
the object it relates to.
In addition, the CFE Reader Remote Diagnostic Log tab also displays communication
messages indicating whether the CFE Reader remote client has been successfully
connected to the CFE Reader server.
Communication messages can relate to the following:
• CFE (CFE Reader to CFE communications)
• Port objects (CFE to RTU communications)
• Status of the communication link between the CFE Reader remote client and the
CFE Reader server
After a client connects to the Line Analyzer server, the display looks like the following:
The “Host name” refers to the computer where the Line Analyzer server is running.
Since the Line Analyzer server and client use TCP/IP communication, the client can be
running on any computer that has access to the Line Analyzer server.
After you enter the User name, Password, Host name, and TCP Port number, the client
sends a connection message to the Line Analyzer server. The server then sends an
Identification Challenge message to the client, and the client sends an
IDENTIFICATION message back to the server.
In the first block, the IDENTIFICATION message contains a key for a symmetrical
algorithm (Rijndael) encoded with the public key RSA of the server. In the second block,
the message contains the identifier, the password, and the unpredictable data
encrypted with this new key.
After the handshake is successful, the Line Analyzer client window opens, and it looks
like the following:
Protocol List
Captured Raw
Messages View
Selected Message
Interpreted View
The Line Analyzer client has two views to monitor two different ports at once.
1.10.5.1 Connect/Disconnect
The Connect/Disconnect toolbar button is used to connect or disconnect communication
with the Line Analyzer server. When connected, the toolbar button looks like the
following:
To disconnect, click the button, which changes to look like the following:
These functions are explained in the order in which they are displayed.
Clear: This toolbar button is used to clear all the messages in the Line Analyzer
Raw View screen and in the interpreted view.
Open: This toolbar button is used to open a saved Line Analyzer Spy Trace file.
Save: This toolbar button is used to save the protocol messages in a spy file. The
spy file is in binary format, and it can only be opened by the Line Analyzer client
program.
Export: This toolbar button is used to export the protocol messages into a text file.
Filter: This toolbar button is used to filter specific protocol bytes, and it can also be
used to color them (text or background). Filtering is explained in more detail in
section 1.10.5.8 Filtering Messages.
Show Incoming Datagrams: This toolbar button is used to enable the Line
Analyzer to show the incoming datagrams.
Note that, if the Hexadecimal dump protocol is selected, the message is not interpreted.
Only the selected text is shown in the Interpreted Messages view.
To open the Filters dialog box, click the Filter button on the toolbar.
To add a new filter rule, click the Add button in the Filters dialog box. A new, blank
Filter line is added, as shown in Figure 46.
In this filter window, the Edit box (shown below) is used to enter the protocol bytes to
which this filter rule is applied.
The Terminale check box is used to enable the focus on the defined rule in
the filter’s Edit box.
The Invisible check box is used to disable the datagrams that match with the
bytes entered in the filter rule.
The Foreground (FG) color box is used to define the foreground color of the
messages if the color matches with the bytes entered in this rule.
The Background (BG) color box is used to define the background color of the
messages if the color matches with the bytes entered in this rule.
The Up/Down arrow buttons are used to change the order of the filter rules if
multiple rules are defined in the filter window.
1.12.1 -CFECONTROL_E_0004
CFEReader state transition is not valid. Previous state = %d to Present state
= %d.
Explanation: Each CFEControl data set has four different states: Offline, Unknown,
Online, and Fail. The state machines of the data set are shown as follows:
1.12.2 -CFECONTROL_E_0021
No reply timeout on CFE Channel Level queue. CFE ""%s"" is set to FAILED.
Message header = %s. Mgeneric = %d
Explanation: There are two queues in CfeControl: the Channel Level queue and the
Port Level queue. Channel Level consists of the following messages:
• Time Sync Init request message
• Time Stamp request message
• SOE Log request message
This error indicates that there is no reply from the CFE module when the CFEControl
module sends out the above request to the CFE module within the CFE timeout period.
Action: Increase the CFE timeout value defined on the CFE Reader display’s
Configuration tab. Also, turn on the CFE spy, CFE event, and CFE line monitor/socket
trace logs. Send those log files to Alstom Grid customer service for further analysis.
1.12.4 -PSTRMS_E_0182
CFE ""%s"" reports an invalid State Change for Measurement ""%s""
Explanation: There are five parameters in the Multiple Change Detection (MCD) bits:
OnSet, OnClear, OnMcd, Always, and Never.
• OnSet: RTU Report MCD Point Change from Set to Clear
• OnClear: RTU Report MCD Point Change from Clear to Set
• OnMcd: RTU Report Multiple MCD Point Change
• Always: RTU Report MCD Anytime Point Change State
• Never: RTU Never Report MCD Change
This error indicates that RTU reports the wrong MCD point change.
For example, the RTU model is set to OnSet. If the point measurement changes from
Set to Clear and the MCD bit does not set, the CFE Reader reports an error for this
invalid state change for this measurement. The final measurement value is forwarded to
the e-terracontrol SCADA server.
Action: Because the final measurement value is always forwarded to the e-terracontrol
SCADA server, it is not necessary for the CFE Reader to report this error. In the latest
version of CFE Reader (version 3.4.0 or later), the CFE Reader does not report this
error at all.
1.12.6 -PSTRMS_E_0042
CFEReader failed to send out the RTU initialization on the RTU ""%s""
dataset. Skip attempt #%d.
Explanation: CFE Reader did not get the reply from the RTU after the number of
attempts to send out RTU initialization requests.
Action: This is a communication problem. Verify that the cables, phone line, modem,
etc., are all properly connected.
1.12.7 -PSTRMS_E_0180
""%s"" returned a zero-length MGENERIC before the end of the Rx Buffer. Hex
dump of last non-zero length MSIRHD: %s.
Explanation: Generally, the reply message from the CFE module to CFECONTROL
contains the scan item response header. For example, in the smart (periodic) scan
response, the reply message has the following format:
|--------------------------------------|
| generic message header (MGENERIC) | msgcod = MSSCAN
|--------------------------------------|
| scan item response |
|--------------------------------------|
.
.
.
|--------------------------------------|
| scan item response |
|--------------------------------------|
/*--------------------------------------------------------------------------
* Codes for 'mrtype' - this identifies the type and format of the scan item
response.
*/
#define MPASS 0x0001 /* Pass-through/error format */
#define MANEXC 0x0002 /* Analog Data - Exception Format */
#define MSTEXC 0x0004 /* Status Data - Exception Format */
#define MSTDMP 0x0005 /* Status Data - Dump Format */
#define MACCUM 0x0006 /* Accumulator Data */
#define MSOE 0x0007 /* SOE Data */
#define MDIRCT 0x0008 /* Direct Control */
#define MSBOSL 0x0009 /* SBO Select */
#define MSBOEX 0x000A /* SBO Execute */
#define MSETPT 0x000B /* Set Point */
#define MBIAS 0x000C /* Time Bias Response */
#define MACK 0x000D /* RTU acknowledge response */
#define MDBG 0x000E /* Debug line analyzer response. */
#define MRDDMP 0x000F /* Raw Data - Dump Format. */
#define MAGDMP 0x0010 /* Analog Group Data - Dump Format. */
#define MINTRSP 0x0011 /* RTU Initialization response. */
#define MSBORE 0x0012 /* SBO control reset */
#define MRLOW 0x0013 /* Pulse output control */
#define MSETSL 0x0014 /* Set point select */
#define MSETEX 0x0015 /* Set point execute */
#define MLOGIT 0x0016 /* Event log scan item report. */
#define MTIMRSP 0x0017 /* Time initialization response. */
#define MTIMSYN 0x0018 /* Time synchronization response. */
#define MPCLRPT 0x0019 /* Report PCLxxx data to Host */
#define MALE 0x001A /* ALE Data */
#define MALFLT 0x001B /* Floating Point Analog */
#define MADJWEL 0x001C /* Adjust wellness check period for RTU */
#define MCTRLR 0x001D /* Control Response */
#define MTESTR 0x001e /* Test message Response */
and the message length (msglen) in the MGENERIC structure should include the length
of the scan item response. The CFE Reader logs this error if msglen does not include
the scan item response length.
Action: This is a coding error. It should be reported to Alstom Grid customer service for
further analysis.
Proprietary – See Copyright Page 79 CFE Reader
e-terracontrol Reference Manual: Interfaces to Field Devices
1.12.8 -PSTRMS_E_0179
""%s"" returned an invalid or unknown response type: %d.
Explanation: As shown above, the scan item response type has 30 values. If, in the
scan response message, the scan item response type does not match with any of the
scan item response type values, the CFE Reader reports this error with the unknown
response type on the data set.
Action: This is a coding error. It should be reported to Alstom Grid customer service for
further analysis.
1.12.9 -PSTRMS_E_0250
The count of outstanding Smart Scans (%d) on port ""%s"" reached the max
Scans value (%d). Skip Scan on this port.
Explanation: If the number of the smart scan request waiting in the pending list of the
Port Level queue is greater than the max scans value (%d) defined in the CFE Reader,
the CFE Reader reports this error to notify the user that the waiting list is full.
Action: Go to the CFE Reader display’s Configuration tab and increase the Max Scans
value. If the problem still persists, report it to Alstom Grid customer service for further
analysis.
1.12.10 -PSTRMS_E_0080
Scan Delay on Port: ScanGroups that were NAKed will be rescanned once before
moving on.
Explanation: For some reason, if the RTU cannot keep up with the CFE Reader polling
rate (i.e., the CFE Reader sends out the request at a rate where the RTU does not have
enough time to form the reply message), the CFE Reader reports this error to indicate
that there is a scan delay on this port.
Action: There are a few options to resolve this problem:
• Reduce the smart (periodic)/integrity scan rate.
• Increase the baud rate.
• Check the status of the RTU.
• Etc.
1.12.11 -PSTRMS_W_0251
CHANEL %d reports the following warning: \n%s.
Explanation: The CFE module reports the following warning error (%s) on channel
(%d).
1.12.12 -PSTRMS_E_0252
CHANEL %d reports the following error: \n%s.
Explanation: The CFE module reports the following error (%s) on channel (%d).
Action: Turn on the CFE Event log to record the errors. Send the log to Alstom Grid
customer service for further analysis.
1.12.13 -PSTRMS_W_0253
CHANEL %d reports the following fatal: \n%s.
Explanation: The CFE module reports the following fatal error (%s) on channel (%d).
Action: Turn on the CFE Event log to record the errors. Send the log to Alstom Grid
customer service for further analysis.
1.12.14 -PSTRMS_W_0146
""%s"" returned a ScanGroup index %d (RTU idx=%d) that is not defined in the
CFEReader database. Fail the CFE. Hex dump of MSIRHD: %s.
Explanation: The RTU with index = %d in the CFE data set %s returns the message
having the Scan Group (%d) not defined in the CFE Reader database. The CFE Reader
fails the channel %s when it receives this message.
Action: Check the RTU configuration to make sure it matches with the CFE Reader
database. Turn on the CFE line monitor, CFE event, and CFE spy logs. Collect the
data, and send it to Alstom Grid customer service for further analysis.
1.12.15 -PSTRMS_W_0147
""%s"" returned an invalid message from RTU index %d that has no ScanGroup
data. Hex dump of MSIRHD: %s.
Explanation: The RTU with Index = %d returns the message having the scan group set
to -1 (ff) and mrtype set to any of the following values: MPASS, MINRSP, MLOGIT,
MTIMSYN, MBIAS, MTIMRSP, MACK, MSOE, MALE, MPCLRPT, or MADJWEL. The
CFE Reader fails the channel %s when it receives this message.
Action: This is a CFE module internal problem. Turn on the CFE event and CFE spy
logs to record the error messages. Send the log files to Alstom Grid customer service
for further analysis.
1.12.18 -PSTRMS_E_0302
Module CFE in port dataset ""%s"" has UP QUEUE FULL. Check the
CFE_PARAM_HIWATER and CFE_PARAM_LOWWATER in cfe_param.h file.
Explanation: The CFE module detected a strong flow of unsolicited messages, which is
causing an overflow of the queue buffer because the HIWATER queue limit is too small.
Action: Check the communication between the RTU and the front end, and, if needed,
increase the increase the HIWATER queue limit.
1.12.19 -PSTRMS_E_0082
CHANEL %d reports following error: ""%s.
Explanation: This message is used by CFE to report an error condition.
Action: Turn on the CFE Event Log to record the errors, and send the log to
Alstom Grid customer support for further analysis.
1.12.20 -PSTRMS_E_0184
CFE "CFE dataset name" failed to enable port "Port1 name" for "Rtu1 name" RTU
Explanation: This message is used by CFE for errors when opening ports. "Failed to
enable" messages in CFEReader are usually related to failed Digi hardware or drivers,
or a failed Monaghan bit-to-byte board, firmware, or power supply.
Action: Check that the FEP can ping the Digi units before power cycling. Cycling power
to these components or reseating cables and cards might help fix the problem. Also,
check the Monaghan power supply voltages (+5V, +12V, and -12V) before power
cycling. The Digi View tool and B2B test tool can be used to check the status of these
devices and run rudimentary tests. Lastly you can try reprogramming or updating the
firmware on these devices.
1.12.22 -PSTRMS_E_RTUPOL_0800
"PCL record ""%s"" does not exist for the rtu ""%s""."
Explanation: This error message is used by CFE Reader to indicate that PCL
parameter 451 is not defined in the RTU data set even though all other configurations
for Timed polling is done.
Action: Define PCL parameter 451 in the RTU data set.
The following are included in the CFE Performance Driver user interface:
Header
• Send Analogs…Per Second: Indicates the number of analogs per second that are
sent from the application to the SCADA server. If left unchecked, the application
does not send any analogs.
• Send Statuses…Per Minute: Indicates the number of statuses per minute that are
sent from the application to the SCADA server. If left unchecked, the application
does not send any statuses.
• Send Accumulators…Per Second: Indicates the number of accumulators per
second that are sent from the application to the SCADA server. If left unchecked, the
application does not send any accumulators.
• Alarms Per Minute: Indicates the number of analog alarms (Limit Exceeding High
and Low alarms) to be generated in SCADA Server per minute. To generate the
alarms, CFE Performance Driver sends values exceeding the limit (high and low).
If the Send Analogs option is not selected, the application will not send any analog
alarms. Also, the cfeperfdata.txt file should be in the working directory
(C:\Eterra\e_terracontrol\bin).
For more information, see section 3.3 cfeperfdata.txt File Format.
The ScanMonitor user interface displays the log messages generated by the
application. This log is also saved into a file under the application working directory with
the name ScanMonitor_<datasourceName>.txt. When the file size is greater than 5 MB,
a new file is created. The old log file is kept in the same directory, but is renamed with a
concatenated timestamp.
1. From the e-terracontrol Start menu, open the Process Starter Console application,
and be sure that the Process Starter service is running.
2. Connect the console to the Process Starter service by clicking the Connect button in
the Process Starter Console toolbar.
3. To create a new Process Starter group, proceed to step 4. To add the OPC Client
application to an existing group, select File > Upload, and choose the desired .psc
file to display the Configuration tab for Processes (see the e-terracontrol Reference
Manual: Applications).
Note: Prior to adding a process to an existing group, you must end all processes
by clicking Stop on the Process Starter toolbar or via the Actions menu item (see
“Process Starter Console Toolbar” and “Process Starter Console Menu Bar” in the
e-terracontrol Reference Manual: Applications).
4. To create a new Process Starter group, select Processes > Add Process.
The Configuration tab for Processes opens (see the e-terracontrol Reference
Manual: Applications).
5. In the Name, Program, Params, and Directory text boxes, enter the required
information. If you do not know the location of the OpcClient.exe file, click the Ellipsis
button (...) next to the Program text box to browse for the file. Sample values are as
follows:
Name: OPC Client
Program: C:\eterra\e_terracontrol\bin32\OpcClient.exe
Params: /host1 smpa /host2 smpb /host3 smpc /host4 smpd /Port <port number>
/sourcename OPCSrc
Directory: C:\eterra\e_terracontrol\bin32
6. If desired, select the Minimize check box.
7. If you do not want to see the GUI, uncheck the Visible check box.
8. In the Restart frame, select the On Exit radio button.
9. Click OK.
10. Save the file.
Figure 51. OPC Client User Interface – Status and Statistics Tab
The Log tab provides a display of the OPC Client application log.
Log filtering is configured on the Settings tab.
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• OPCDataType: OPC item’s data type. The data type list is provided in section
5.6.1.4 OPCItemDS Data Set.
A single OPCGroupDS or OPCItemDS data set can only contain data items that
reference tags of one specific type (the type specified by the “OPCDataType”
parameter). It is not possible to mix types within a single OPCGroupDS or OPCItemDS
data set.
The OPC Client DA implementation supports the retrieval of OPC array data in addition
to individual tag data. Arrays can be retrieved by specifying the appropriate array type
through the “OPCDataType” parameter. The retrieval of array data requires a specific
format for the Data Item Name fields within the OPCGroupDS or OPCItemDS data set
(as discussed in section 5.6.1.5 Data Items).
String data (VT_BSTR) is treated as special. The first four characters of the string are
extracted, converted to an integer value, and added up. That integer value is loaded as
an analog value. The rest of the string is ignored.
Arrays of strings (VT_ARRAY | VT_BSTR) are also treated as special. For each string
array element, the first four characters of the string are extracted, converted to integer
values, and added up. Those integer values are loaded as analog value elements in the
array.
For string conversion details, refer to the table below:
• OPCActiveState: A True or False value as to whether the OPC Client link to the
server is active for the OPCItem.
• OPCAnalogScalingEnabled: True or False value indicating whether scaling and
deadbanding should be applied to analog values loaded from the OPC Client. The
parameter defaults to False.
If the value is True, the OPC Client loads values through an interface that applies
raw to engineering scaling and analog deadbanding per the parameters on the
associated data item.
Note: For controls, the current OPC Client application only supports the values “0”
and “1”. If a data item is modeled with a value other than “0” or “1”, the OPC Client
application throws the error “OnExecuteControlEx event received for the
dataset::Failed to issue OPC Write : Error in Value”.
4. Select the “Computer account” option to manage the certificate. Click Next.
11. Enter the provided password for the certificate. Click Next.
12. Select the “Place all certificates in the following store” option and click the Browse
button to select the store location where the certificate is to be placed. Normally the
selected store path is “Personal”. Click Next.
If the application is started in Test mode, a new menu named “TestMode” appears in
the main menu. Selecting the Test Mode menu invokes a dialog box for configuring the
server’s status and update frequency/min in Test mode.
Selecting the context menu of the selected server brings up a new dialog box. This
dialog box is used for setting the server status and update rate.
This dialog box displays the selected server’s properties. The user can change the
server state from active to inactive, and can also change the update rate.
Note: Prior to adding a process to an existing group, you must end all processes
by clicking Stop on the Process Starter toolbar or via the Actions menu item (see
“Process Starter Console Toolbar” and “Process Starter Console Menu Bar” in the
e-terracontrol Reference Manual: Applications).
4. To create a new Process Starter group, select Processes > Add Process.
The Configuration tab for Processes opens.
5. In the Name, Program, Params, and Directory text boxes, enter the required
information. If you do not know the location of the ModbusReader.exe file, click the
Ellipsis button (…) next to the Program text box to browse for the file. Sample values
are as follows:
Proprietary – See Copyright Page 125 PLC Reader Applications
e-terracontrol Reference Manual: Interfaces to Field Devices
Name: Modbus Reader(Master)
Program: C:\eterra\e_terracontrol\bin\ModbusReader.exe
Params: -n ReliatronicsRTU -u=1000
Directory: C:\eterra\e_terracontrol\bin
6. If desired, select the Minimize check box.
7. If you do not want to see the GUI, uncheck the Visible check box.
8. In the Restart frame, select the On Exit radio button.
9. Click OK.
10. Save the file.
Note: When a data set configuration option is selected via the command-line
argument, this menu is disabled.
Note: When a data set configuration option is selected via the command-line
parameter, this menu item is disabled.
Note: When a data set configuration option is selected via the command-line
argument, this menu item is disabled.
The following are included in the Scan Group Properties dialog box:
• Scan Group Name: The name of the scan group.
• Scan Type: From the drop-down box, select one of the following:
– Status: Reads inputs corresponding to Status objects in SCADA.
– Analog: Reads inputs corresponding to Analog objects in SCADA.
– Accumulator: Reads inputs corresponding to Accumulator objects in SCADA.
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• General Parameters (Serial and Ethernet)
– BitPacking: Enables bit packing. For example, in Modbus Reader, 32 input coils
(bits) from the slave device are packed into two input coils (as 16-bit counters).
Valid values are True and False.
– PlcAddress: Address that the master (Modbus Reader) uses to poll the PLC.
– Protocol: Selected protocol entered as 0–1.
∗ 0 = ASCII
∗ 1 = RTU
– Timeout: Time period that the Modbus Reader waits for the device to respond to
a poll.
– EthernetMode: Enables Ethernet communications.
∗ True = Ethernet
∗ False = Serial
• Serial Only
– BaudRate: Baud rate entered as 0–14.
∗ 0 = 110 Baud
∗ 1 = 300 Baud
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• AlarmArea: Area assigned to a console where an alarm can be issued when an
event is posted.
• AlarmCategory: Default alarm category.
• AlarmException: Unique name defining an exception to the alarm utility.
• AlarmReaderName: Name of the application reading the alarms.
• AlarmPort1: Listening port of the PROXYSRV application on e-terraplatform
system 1.
• AlarmPort2: Listening port of the PROXYSRV application on e-terraplatform
system 2.
• AlarmHost1_1: IP node name or address of the e-terraplatform system 1 – Host 1.
• AlarmHost2_1: IP node name or address of the e-terraplatform system 1 – Host 2.
• AlarmHost3_1: IP node name or address of the e-terraplatform system 1 – Host 3.
• AlarmHost4_1: IP node name or address of the e-terraplatform system 1 – Host 4.
• AlarmHost1_2: IP node name or address of the e-terraplatform system 2 – Host 1.
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• Scan Group Type: Scan group type entered as 0–8.
– 0 = Status
– 1 = Analog
– 2 = Accumulator
– 3 = Control
– 4 = Setpoint
– 5 = OK Timer
– 6 = Set Time
– 7 = Freeze
– 8 = FreezeRead
• TimeBase: Defines the base time (ms) for scanning a scan group.
Note: Prior to adding a process to an existing group, you must end all processes
by clicking Stop on the Process Starter toolbar or via the Actions menu item (see
“Process Starter Console Toolbar” and “Process Starter Console Menu Bar” in the
e-terracontrol Reference Manual: Applications).
4. To create a new Process Starter group, select Processes > Add Process.
The Configuration tab for Processes opens (see the e-terracontrol Reference
Manual: Applications).
5. In the Name, Program, Params, and Directory text boxes, enter the required
information. If you do not know the location of the TIReader.exe file, click the Ellipsis
button (…) next to the Program text box to browse for the file. Sample values are as
follows:
The following are included in the Communication Parameters Configuration dialog box:
• Baud Rate: Select the desired baud rate from the list box.
• Comm Port: Enter the communications port number that the TI Reader should use
to communicate with the PLC.
• Data Bits: Select the data bit convention from the list box.
The following are included in the Scan Group Properties dialog box:
• Scan Group Name: The name of the scan group.
• Scan Type: From the drop-down box, select one of the following:
– Status: Reads inputs corresponding to Status objects in SCADA.
– Analog: Reads inputs corresponding to Analog objects in SCADA.
– Accumulator: Reads inputs corresponding to Accumulator objects in SCADA.
– Control: A set of digital outputs.
– Setpoint: A set of analog outputs.
– OKTimer: A timer input that is incremented by the PLC software. If this stops
incrementing, it indicates that the PLC software is “stuck”, and the TI Reader
marks input measurements as bad quality.
– SetTime: Time output to the PLC. The PLC time is set to be the same as the
telemetry PC time.
Note: Prior to adding a process to an existing group, you must end all processes
by clicking Stop on the Process Starter toolbar or via the Actions menu item (see
“Process Starter Console Toolbar” and “Process Starter Console Menu Bar” in the
e-terracontrol Reference Manual: Applications).
4. To create a new Process Starter group, select Processes > Add Process.
The Configuration tab for Processes opens (see the e-terracontrol Reference
Manual: Applications).
5. In the Name, Program, Params, and Directory text boxes, enter the required
information. If you do not know the location of the TrueTimeReader.exe file, click the
Ellipsis button (…) next to the Program text box to browse for the file. Sample values
are as follows:
Note: The Relay Reader requires a separate license; it is not included in the standard
e-terracontrol delivery. Contact your customer service or sales representative for
delivery of this application. Use of this application also requires that the third-party
SELMASTER.OCX control be installed and registered.
8.2 Host(s)
By default, the Relay Reader connects to the SCADA application running on the local
computer. However, in a case where the Relay Reader application does not reside on
the same machine as the SCADA server, the address of the SCADA server must be
passed in the “Host1” argument. In a dual-state environment, the “Host2” argument is
used to pass the address of the secondary SCADA server. The two SCADA servers
must store the same data source to which the Relay Reader is dedicated.
Host1=<HostName1>,Host2=<HostName2>
This argument is optional.
8.4 Enable/Disable
The “enable” (or “disable”) argument forces a number of additional log options,
essentially related to the communications with the SCADA server application. For more
details about these options, refer to section 8.6 Relay Reader User Interface.
The possible log options are:
• SmpLogState: Logs data set state changes
• SmpLogControl: Logs control requests
• SmpLogTimers: Logs timers
• SmpLogConnections: Logs connections with and disconnections from SCADA
• SmpLogRefresh: Logs refresh (i.e., demand scan) requests
• SmpLogMessages: Logs messages from the Relay Reader to SCADA
These arguments are optional.
Note: Prior to adding a process to an existing group, you must end all processes
by clicking Stop on the Process Starter toolbar or via the Actions menu item (see
“Process Starter Console Toolbar” and “Process Starter Console Menu Bar” in the
e-terracontrol Reference Manual: Applications).
4. To create a new Process Starter group, select Processes > Add Process.
The Configuration tab for Processes opens (see the e-terracontrol Reference
Manual: Applications).
5. In the Name, Program, Params, and Directory text boxes, enter the required
information. If you do not know the location of the RelayReaderVB.exe file, click the
Ellipsis button (…) next to the Program text box to browse for the file. Sample values
are as follows:
Name: Relay Reader(Master)
Program: D:\eterra\e_terracontrol\bin\ RelayReaderVB.exe
Params: datasource = RelayReader
Directory: C:\eterra\e_terracontrol\bin
6. If desired, select the Minimize check box.
7. If you do not want to see the GUI, uncheck the Visible check box.
8. In the Restart frame, select the On Exit radio button.
9. Click OK.
10. Save the file.
The following are included on the Database tab for each relay:
• Key: Used internally.
• Device: Name of the relay data set for the associated relay.
• Failures: Number of failed polls (cumulative).
• Attempts: Number of polls to the relay (cumulative).
• Responses: Number of successful responses from the relay (cumulative).
• Baud: Baud rate of the connection to the relay.
• Data Bits: Number of data bits per byte.
• Stop Bits: 1 or 2 stop bits.
• Parity: 0 = None, 2 = Even, 1 = Odd parity.
• Polling: Enabled or disabled. When polling is disabled, the relay is not polled. The
port can be open or closed.
The following are included on the Configuration tab for each relay:
• Disable Output: Check to disable logging to the Relay Reader log.
• Log to File: Check to enable logging of the Relay Reader log to a file. The file is
named “RelayReader_YYYYMMDD_HHMMSS.log”, where YYYY is the year, MM is
the month, DD is the day, HH is the hour, MM is the minute, and SS is the second
that the file was created. The log file is created in the same directory that the Relay
Reader executable is running in.
• Limit Length To: Check to limit the length of the log file. If the specified maximum
length is going to be exceeded, the file is closed and a new log file is opened.
• S - Success: Check to enable logging of success severity messages.
• I - Informational: Check to enable logging of informational messages.
• W - Warning: Check to enable logging of warning messages.
• E - Error: Check to enable logging of error severity messages.
• F - Fatal: Check to enable logging of fatal severity messages.
• Log State Changes: Check to enable logging of data set state changes from the
SCADA server.
• Log Controls: Check to enable logging of control requests from the SCADA server.
The following are included on the Pass-Through tab for each relay:
• Key: Used internally.
• Device: Name of the relay data set for the associated relay.
• Status: Indicates the status of any connection to a pass-through client.
• Sent: The number of pass-through messages that have been sent to the relay.
• Received: The number of pass-through messages that have been received from the
relay.
• Connect Time: The time that the most-recent connection to a pass-through client
was established.
8.7.1 Defining the Data Set Types for the Relay Reader
As noted above, several data set types must be defined before the data sets for the
Relay Reader data hierarchy can be defined. The types can be manually defined in the
SCADA Types subtree of the SCADA database.
To define a data set type:
1. Using the Insert menu of the e-terracontrol application, select Type from the drop-
down menu.
2. On the next menu, select Data Set Type.
The data set type form appears with two tabs: General and Timers.
3. For each type defined, select the options indicated.
8.7.2 RelayReaderDS
Data set configuration is performed in the SCADA server application (see Figure 88).
For the Relay Reader data set, no parameters should be entered in the Param text box.
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• Baud:
– 1200
– 2400
– 4800
– 9600
– 19200
• PortNum: Communications port number
• DataBits: Data bit conversion type
– 7 = 7 bits
– 8 = 8 bits
• Parity: Parity
– None
– Odd
– Even
• StopBits: Stop bits
– 1 = 1 bit
– 2 = 2 bits
Proprietary – See Copyright Page 169 Relay Reader Application
e-terracontrol Reference Manual: Interfaces to Field Devices
• Exception: Interval for exception checking in msec. Default is 500 msec.
• Statistics: Interval for statistics checking in msec. Default is 10000 (10 seconds).
• Integrity: Interval for integrity checking in msec. A value of 0 disables the integrity
checking. Default is 0.
• InitialRead: Interval to wait for all poll groups to come online before the initial
integrity read of data from the ActiveX control. Default is 60000 (60 seconds).
• TextEventFile: Name and directory path for the file used to store text events.
Normally, this is the same file for all Relay Reader instances. Default to
RelayReaderTextEvents.txt in the current directory.
• TelnetPortBase: The Internet port number that is used to listen for connections from
pass-through clients. The serial port number is added to the TelnetPortBase to
obtain the port number to listen on. If no TelnetPortBase is specified, listen on the
port specified by TelnetPortNum or on the standard telnet port, 23.
• TelnetPortNum: Explicitly specifies the telnet port number used to listen for pass-
through client connection requests. Overrides TelnetPortBase if both are specified.
Default is 23.
• Password: Valid password for a pass-through client. If not specified, no password is
required.
• TelnetMode: Set to ENABLED to enable listening for pass-through connections on
the designated Internet port. If disabled, no pass-through connections are accepted.
Default is DISABLED.
• MaxConnectTime: Maximum number of minutes that a telnet pass-through
connection is allowed to remain connected. It is automatically disconnected at the
end of the maximum time. Default is 10.
• PassThruTMO: Number of minutes that the relay remains in pass-through mode
without user interaction. If this time passes without receiving a command, the relay
drops out of pass-through mode and the normal polling cycle resumes. Default is
1 minute.
• MaxPassWordAttempts: Maximum number of password attempts the client is
allowed before the connection is disconnected due to lack of a valid password.
Default is 2.
• AutoSendInterval: Number of milliseconds to wait after receiving a valid command
to read relay settings before sending the command to the relay even if no
terminating <CR> has been received. Default is 1000 msec.
• PassThruInterval: Number of milliseconds between calls to GetPassThruData to
retrieve pass-through data responses from the Novatech control. Default is 500 ms.
• StatisticsDumpDisabled: Include this parameter to disable the dumping of the
hourly communication statistics. Including this parameter disables the dumping of
the statistics for the port unless the argument for the parameter is “False” or “No”.
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• Model: SEL relay model number
– 311
– 321
– 351
– 351S
– 352
– 387
• Protocol: Communications protocol
• FastMeter
• ASCII
– NoReplyTimeout: Time in milliseconds to wait for a response from a relay while
polling.
– Retries: Number of retries (at poll rate) before the device is declared offline by
the Novatech control.
– LongEventReport: Enable or disable long event reporting. If disabled, the event
files are not generated.
∗ Disable
∗ Enable
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• GroupName: Scan group name
– Meter
– Event (not supported)
– Fast Meter
– History (not supported)
– Peak
– Demand
– Breaker Wear
• Days: Defines the poll frequency in days for the group.
• Hours: Defines the poll frequency in hours for the group.
• Minutes: Defines the poll frequency in minutes for the group.
• ScanRate: Defines the poll frequency in seconds for the group.
• Msec: Defines the poll frequency adjustment for the group in milliseconds.
The following parameters should be entered in the Param text box, with corresponding
values entered in the Value text box:
• Type: Point type
– AI = Analog
– DI = Discrete Status
– DO = Discrete Output
• OutputType: Defines the control type for output points.
– PULSE
– LATCH
Note that the CardDS for output points can be inserted under any of the PollDS data
sets, since the poll rates are ignored for output points.
The details of the points for the Point data set are defined on the Data Items tab. The
name of each data item must match the Point reference address from the relay map.
9.1.2 Host(s)
By default, the IEC61850 client connects to the SCADA application running on the local
computer. However, in a case where the IEC61850 client application does not reside on
the same machine as the SCADA server, the address of the SCADA server must be
passed in the “Host1” argument. In a dual-state environment, the “Host2” argument is
used to pass the address of the secondary SCADA server. The two SCADA servers
must store the same data source to which the IEC61850 client is dedicated.
Host1=<HostName> Host2=<HostName2>
This argument is optional.
9.1.3 Port
By default, the IEC61850 client connects to the SCADA application running on the local
computer with the default port (5020 for NTLM/Kerberos authentication and 7000 for
Certificate-based authentication). A specific port can be set in a command line:
Port=<num port>
This argument is optional.
Individual components of a brick are modeled by adding data items to the data set.
These data items have linkages to measurements. This is the mechanism for mapping
IEC61850 measurements to e-terracontrol measurements.
On the left is a tree display of the IEC61850 devices modeled in the e-terracontrol
database. It displays the remote device and the bricks modeled under it.
By default, the obtained XML file goes into a new IEC61850WORK subfolder of the
e-terracontrol installation location. The integrator cannot override this location.
All servers connected to the IEC61850 client must be defined on the
IEC61850 Server(s) Definition List.
For each server, you must define the name and the IP address of the server. The server
name is equal to the ARName defined in the IEC61850 device data set in the
configuration of the SCADA device.
All information entered is automatically updated in the Lean.cfg located under the
Agency executable folder.
The stop extraction button allows you to interrupt the Model(s) extraction process for the
selected data model in the list.
set ETERRACTRLDATA_DIR="D:\eterra\e_terracontrol\Data"
set XSL_XML_DIR="C:\Program Files\AREVA\PACIS\UCA2Agency\odfoundry\xml"
• WIN32AGENCY_DIR points to the win32agency.exe directory.
This error is explained in the Foundry log, which is in the IEC61850Work directory.
When this file is open, the error can be formed as follows:
**********************************************************
LOGGING STARTED Thu Jan 12 16:13:53 2006
***********************************************************
00.000s SLOGALWAYS (FO_MAIN.C 198) \
Executing "odfoundry"
Input TDL file : "C264N5.odf"
Configuration file: "align.cfg"
Output "C" file : "C264N5.c"
Output "H" file : "C264N5.h"
00.015s SLOGALWAYS (FO_PARSE.C 1496)
Could not find type “VBSTR9”
00.015s MMS_LOG_NERR (MMS_TDEF.C 1102)
Named type VBSTR9 not found
00.015s SLOGALWAYS (FO_PARSE.C 776)
Fatal error! ASN1->RT conversion err, type “BRCB”
Error at input line 424 (424 in file “C264N5.odf”). Terminated.
To resolve this error “Could not find type ‘VBSTR9’”, the VBSTR9 PrimitiveClass needs
to be added to the PrimClass.xml file. The PrimClass.xml file is part of the Agency
installation, and it can be found in the <agency installation
folder>\UCA2Agency\odfoundry\xml folder.
12.1.1 General
The following ACSI conformance statements are used to provide an overview and
details about a device claiming conformance with ACSI:
• ASCI basic conformance statement
• ACSI models conformance statement
• ACSI service conformance statement
To specify the communication features mapped to an SCSM, the “value /comments”
give the e-terracontrol IEC61850 client the currently supported statements.
Note 1: The conformance statements of this annex are abstract in the sense that the
ACSI models and their services are mapped to application layer models, services, and
protocols. Additional details on the conformance are defined in the SCSM.
Note 2: For several features, the conformance requirement is implicitly defined with
the common data class contained in part IEC 61850-7-3 and the compatible
LOGICAL-NODE classes and DATA classes contained in part IEC 61850-7-4. For
example, a TrgOp (trigger option) of the value qchg (quality change) of DataAttribute
requires the support of the TrgOpEna (trigger option enabled) qchg of the BRCB or
URCB.
P141 Feeder
Management Relay
P141
3 42B 42B 42B 42B x
Phase2
P142 Feeder
Management Relay 3 350D 350D 350D 350D x
with Autoreclose
P142
3 42B 42B 42B 42B x
Phase 2
P143 Feeder
Management Relay
with Autoreclose
and Check
Synchronizing
P143
3 42B 42B 42B 42B x
Phase2
P144 Feeder
Management Relay
with Autoreclose
for 2CT and delta
VT application
(LADWP-US)
P341 Interconnection
Protection Relay
P342 Generator
Protection Relay
P343 Generator
Protection Relay
with Generator
Differential
P344 Generator
Protection Relay
with check
synchronization
P345 Generator
Protection Relay
3 33A 33A 33A 33A x
with check
synchronization
P443
Bus-Bar Protection
(Via
P743 3 D2.2 D2.2 D2.2 D2.2
KITZ20401L15CEE
)
P841 Auto-Recloser
P842 Auto-Recloser +
mesch corner
P130 C
P132 Time-Overcurrent
Protection & 2 613.206 613.206 613.206 613.206 x
Control
P139 Time-Overcurrent
Protection & 2 616.213 616.213 616.213 616.213 x
Control Unit
P430 C
P630 C
P638 Railway
Transformer
3 610.00 610.00 610.00 610.00
Differential
Protection
P124D Dual-powered
overcurrent relay
P124S Self-powered
overcurrent relay
P220 Integrated
Protection for
Motors
P821
P925
M220 Measurement
Centre
M230 Measurement
Centre
M231 Measurement
Centre
M300 Measurement
Centre
M301 Measurement
Centre
MS 3000 3 2.22 x
M830 Disturbance
Recorder
M871 PowerServe
NOTE 3 3 610.201 610.201 610.201 610.201 610.201 x
Meter/Recorder
I400 Digital
Transducers
GEMSTART
V4.3
GEMSTARTV5
PS462 Multifunctional
O/C Protection
PS482 Multifunctional
Directional O/C
Protection
BWATCH Monitoring HV
MR TAPCON Voltage
240 regulator
Maschinenfabrik TAPCON Petersen Coil
Reinhausen 3 X X
260 Regulator
SIEMENS 7SA513
SIEMENS 7UT513
ABB INSUM
ABB REL
316_4
ABB RED670 3 X X X x
VA TECH TAU
200
SCHNEIDER SEPAM
1000 S20
SCHNEIDER SEPAM
1000 T87
SCHNEIDER SEPAM
1000 B83
SCHNEIDER SEPAM
M20
SCHNEIDER SEPAM
T20
SCHNEIDER PM500
SCHNEIDER CM4000
GE C60
GE L90
REYROLLE Argus
TAU200
DYNATROL DS32
The scenario in Table 11 shows if S = 0 comes with the Device time and X = 1 comes
without time, the SCADA event list shows CLOSED with the Device time.
The scenario in Table 12 shows that S = 0 comes with the Device time in the first scan;
SCADA combines S with the existing X and shows MIDPOS with the Device time. In the
second scan, X = 1 comes without time. So, SCADA combines X with the existing S and
shows CLOSED with SCADA time. Because S and X come in different scans, SCADA
does not pair them and show two states.
The scenario in Table 15 shows a data change coming in the order S X X S S in one
scan and X in the next scan from the RTU. So, SCADA pairs S and X; for the last S (0)
in the first scan it combines S with the existing X (0) and shows MIDPOS with the
Device time. For the X (1) that comes in the next scan, SCADA combines X with the
existing S (0) and shows CLOSED with SCADA time (because X comes without time).
The scenario in Table 16 shows a data change that comes in the order S X S in one
scan and X S S in the next scan from the RTU. So, SCADA pairs S and X; for the last S
(1) in the first scan it combines S with existing X (1) and shows ERROR with the Device
time. For the last X (1) comes in the second scan, SCADA combines X with existing S
(0) and shows CLOSED with SCADA time (because X comes without time).
The scenario in Table 17 shows a data change that comes in the order S X S S. This is
an invalid scenario. In this case, SCADA pairs S and X (S = 0 and X = 1) and shows
CLOSED with the Device time. After S = 1 there is another S (0) coming, so SCADA
ignores the S = 1 change. For the last S (0), the formed value is CLOSED (S = 0 and
existing X = 1) with Device time. Because the previous value is CLOSED, SCADA
shows nothing.