Professional Documents
Culture Documents
Section 1. Introduction
1-1. Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1-2. Contents of Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
1-3. Reference Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
1-1. Overview
The Ovation Link Controller GE Speedtronic Mark IV Interface (hereafter referred
to as the LC/Mark4 interface) provides communication between an Ovation Link
Controller (LC) Module and a GE Speedtronic Mark IV turbine controller.
The Mark IV interfaces with the LC Module via RS-232 serial communication. The
Mark IV sends messages in the Mark III/Mark IV protocol to the LC Module;
however, the LC module does not reply. The interface software interprets the
messages and puts the content data in memory for access by SLC algorithms in the
Ovation Controller.
The LC/Mark4 interface replaces the WDPF Station Interface Unit (SIU) GE
Speedtronic interface. The interface software runs on both the Ovation Link
Controller Module and the WDPF Q-line Serial Link Controller (QLC) card.
Document
Number Title Description
R3-1100 Ovation Algorithms Reference Manual Describes algorithms available for use with
the Ovation Controller.
R3-1140 Ovation Record Types Reference Lists and describes Ovation Record Types.
Manual
R3-1150 Ovation I/O Reference Manual Describes Ovation I/O modules.
U3-1021 Ovation Link Controller (LC) User’s Describes the use and functions of the
Guide Ovation Link Controller module.
GEH-5558A “Steam Turbine Control RS-232 GE interface document
Computer Interface”
MDS 10846 “Specification MDS 10846 for a GE protocol document
simple data dump to a remote com-
puter over a serial link”
• The Personality module (Part 1C31169G01). Only the Group One personality
module is appropriate for the Mark IV since it conforms to RS-232
communications standards.
• The Base Unit which provides field termination via screw terminals.
The cable shield should be grounded only at one end to avoid ground loops. If it is
necessary to ground the cable shield at the personality module, electrically connect
the cable shield to the connector shell.
The cable length cannot exceed fifty feet, which is the defined standard for all RS-
232 connections.
• LC Module utilities
Note
channel 1
offset 0 point S0000 type int8
offset 1 point S0003 type int8
offset 2 point S0006 type int8
offset 3 point S0009 type int8
offset 4 point S0012 type int8
offset 5 point S0015 type int8
offset 6 point S0018 type float
offset 10 point S0021 type float
offset 14 point S0024 type float
offset 18 point S0027 type float
pt_timeout = 10000
channel 3
offset 0 bit 0 point D0050 type digital
offset 0 bit 1 point D0051 type digital
offset 0 bit 2 point D0052 type digital
offset 0 bit 3 point D0053 type digital
offset 0 bit 4 point D0054 type digital
offset 0 bit 5 point D0055 type digital
offset 0 bit 6 point D0056 type digital
offset 0 bit 7 point D0057 type digital
offset 1 bit 0 point D0058 type digital
offset 1 bit 1 point D0059 type digital
offset 1 bit 2 point D0060 type digital
offset 1 bit 3 point D0061 type digital
offset 1 bit 4 point D0062 type digital
offset 1 bit 5 point D0063 type digital
offset 1 bit 6 point D0064 type digital
offset 1 bit 7 point D0065 type digital
offset 2 bit 0 point D0066 type digital
The first line is a comment line as indicated by the “*” comment introducer.
The first section of the configuration file specifies overall operating parameters. The
platform RLC line tells the interface to accommodate the Ovation LC module
hardware. It could also be set to QLC for the WDPF QLC card or PC for testing
on a PC compatible computer.
The line timeout_action = quality tells the interface to set the Ovation
points to bad quality when no message has been received within five seconds as
specified in the line pt_timeout = 5000 where the timeout is specified in
milliseconds.
The remainder of the example file maps Mark IV data fields to Ovation LC Module
registers, and hence to Ovation process points using SLC algorithms. The Mark IV
protocol provides for eight channels of data, each with up to 253 bytes of data. This
section maps byte offsets within each channel message to LC module registers.
First in the mapping section is the mapping for channel 1. All the lines following
pertain to channel one until the next channel specification. The first specifier
within this channel offset 0 point S000 type int8 maps byte offset 0
to an analog value with status at LC module register 0. The Mark IV type
specification for this field is int8 meaning a one byte (eight bit) signed integer
value.
The next line maps byte offset 1 to S0003, also of type int8. The analog with
status point type consumes three registers, hence S0003 follows S0000.
At byte offset 6, the Mark IV type changes to float. Four consecutive bytes
from channel one’s message will be interpreted as an IEEE floating point number.
This is why the next offset specified is 10, four bytes more than the previous.
The entirety of channel three in this example is mapped as digital points. The least
significant bit of byte offset 0 is mapped to LC module register D0050. Bit 1 is
mapped to D0051, and, at the end of the channel, bit 0 of byte offset 2 is
mapped to D0066.
3. Many of the keywords and values have aliases (see Table 3-1)
4. Comments may be inserted in the file using an asterisk “*”. All text from the
asterisk to the end of the line is ignored.
5. Commas, equal signs, tabs, spaces, and line breaks, are separators for parameter
keywords and values.
7. The configuration file format is as follows: Overall parameters at the top of the
file followed by the Channel/Offset specific parameters.
The type specifier for each Channel/Offset tells the interface software which of
several Mark IV data types is associated with that Channel/Offset. The Mark IV
data types supported by the LC/Mark4 interface are described in Table 3-3.
Table 3-3. Mark IV Type Specifiers
Specifier Description
int8 Treat a single byte as an eight-bit signed integer in the range –128 through +127.
uint8 Treat a single byte as an eight-bit unsigned integer in the range 0 through 255.
int16 Treat two bytes as a sixteen-bit signed integer in the range –32768 through +32767.
uint16 Treat two bytes as a sixteen-bit unsigned integer in the range 0 through 65535.
int32 Treat four bytes as a 32-bit signed integer in the range –2147483648 through +2147483647.
uint32 Treat four bytes as a 32-bit unsigned integer in the range 0 through 4294967295.
float Treat four bytes as an IEEE format floating point number in the range 3.4E±38.
digital Treat an individual bit of the byte as a digital state (used in conjunction with bit parameter).
The point parameter for each Channel/Offset is entered as though it was an Ovation
point name (a pseudo point name). Analog values and digital states are exchanged
between the Ovation controller and the Ovation LC module through a shared
memory region which is thought of as consisting of 16-bit registers.
The point reference consists of an initial letter which indicates the type of reference,
and a four digit number which specifies an LC register address, or offset into the
shared memory region. This is described in Table 3-5.
Table 3-4. LC Module Point Names
Point Name Point # LC Value Type Read Algorithm and Write Algorithm and
Type Regs Format 1 Format 1
D0000 to D2047 Digital 1 SLCDIN 2 SLCDOUT 2
I0000 to I2047 Analog 1 integer SLCAIN - 0 format 3 SLCAOUT - 0 format 3
F0000 to F2046 Analog 2 float (IEEE) SLCAIN - 1 format 4 SLCAOUT - 1 format 4
S0000 to S2045 Analog 3 float (IEEE) SLCAIN - SLCAOUT -
2 or 3 format 5 2 or 3 format 5
1 Refer to “Ovation Algorithm Reference Manual” (R3-1100) for more information about the SLC
algorithms and their formats.
2 The interface software and algorithm use a single 16 bit word to represent the digital status word as
described in “Ovation Record Types” (R3-1140). The state of the point is represented as the least
significant bit of the word. When reading a digital using the SLCDIN algorithm, some of the remaining
bits of the digital status word are used to set the quality of the point.
3 When using the SLCAIN or SLCAOUT algorithm with format 0 and an I0000 style point designator, the
interface software and algorithm pass a single 16 bit word treated as a signed integer.
4 When using the SLCAIN or SLCAOUT algorithm with format 1 and an F0000 style point designator, the
interface software and algorithm pass a four byte (two word or two register) IEEE format floating point
value.
5 The interface software and algorithm pass a 16 bit word which represents the Analog Status Word
followed by a four byte (two word or two register) IEEE format floating point value. A single S0000 style
point uses three LC registers, this must be taken into account when laying out the data.
• The first line sets an environment variable that informs the run-time library that
the module has no floating-point coprocessor:
Set NO87=<text string>
where <text string> can be any text string.
• The second line invokes the interface executable program and specifies the
configuration file name:
Mark4 –f <configuration filename> <options>
set NO87=project
Mark4 –f proj.cfg -d
Several command line options are available for debugging purposes. They are
described in Table 3-5.
Table 3-5. Command Line Options
Option Description
-f Specifies the name of the configuration file. This parameter is required.
-p Specifies the platform on which the interface is loaded: PC, QLC, or RLC.
-d Enables display of the LC module registers. The register display slows down the operation
of the interface and should be used only while debugging.
-a Enables display of the Mark IV format messages sent to the LC module. The message
display slows down the operation of the interface and should be used only while debugging.
-e Specifies the level of the syslogging parameter, that is sets the debug message level: 1 - 7.
-t Enables test mode where simulation of the Mark IV is available. See Section 6.
The external Personal Computer host program formats the LC’s RAM disk (if
needed), loads DOS (if needed) and copies any desired files to the Link
Controller RAM disk. Allows the LC to receive commands from the computer
and to write information to the PC’s CRT.
Note
COM1 or
COM2
Connector
J1 Port in
LC Module
Once the LC is initialized, the external personal computer can be removed, and the
LC operates as a stand-alone IBM-compatible microcomputer.
Note
4-3.1. Procedure 1
Typically, LC modules have DOS 5.0 installed and tested at the factory, and are
configured to boot from the local RAM disk before they are shipped to the field.
These modules can be initialized by Procedure 1.
However, if the LC module does not have DOS 5.0 installed on it, or its RAM
memory has become corrupted, use Procedure 2 described in Section 4-3.2 to
initialize the LC module.
Note
3. Connect an applicable cable from the LC module (J1 Programming Port) to the
personal computer (COM1 or COM2). (See Section 2 for additional
information on the cable to be used.)
4. Copy the following programs and files from Drive C on the PC to the floppy
disk in Drive A.
— MARK4.EXE
5. Run RLCEXTPC.EXE from Drive A, using the command line syntax shown
below:
where:
Note
If the port and baud rate are not specified, the default values will apply
(port = COM1, baud = 19200).
6. Reset the LC module by removing it from its Base Unit, waiting five seconds,
and then replacing it.
7. The LC module will perform a set of self-test diagnostics. Figure 4-1 illustrates
the diagnostic LEDs on the LC Electronics module.
PCEI 12345678
Status LEDs
Electronics Module
Figure 4-1. Link Controller Module LED Positions (Top View)
— Each of the set of eight LEDs (1 - 8) will be individually lit and then turned
off in sequence starting with LED 1. When this test is completed, all LEDs
(except P and C) should be off.
— The 640 Kbytes of user RAM will be tested. The amount tested will be
displayed on the external personal computer. If the test encounters an error,
LED 1 will be lit and an error message will be written to the external
personal computer.
9. Copy the programs and files necessary for the operation of the LC application
to Drive A from Drive B. For example: copy b:MARK4.EXE a:
— MARK4.EXE.
10. Enter the following command to save the current configuration of the LC’s
internal disk:
B:\>RLCFLASH
OR
B:\>A:\RLCFLASH
Caution
11. To auto-start the application, reboot the LC by removing it from the Base Unit
and then replacing it, or by pressing Control-Shift-Delete.
13. To exit the RLCEXTPC.EXE program at the external personal computer, press
Control-Break.
4-3.2. Procedure 2
LC Module Not Containing DOS 5.0, or LC Module with a Corrupted RAM Disk
Note
3. Connect an applicable cable from the LC module (J1 Programming Port) to the
personal computer (COM1 or COM2). (See Section 2 for additional
information on the cable to be used.)
4. Format a floppy disk as a DOS 5.0 bootable floppy by doing the following:
Place the disk into a floppy drive at the PC and type the following command
(assuming the disk is in Drive A):
C:\>FORMAT A: /S
5. Copy the following programs and files from Drive C on the PC to the floppy
disk in Drive A.
7. The baud rate for the Programming Port defaults to 19200 (no jumper installed).
Note
8. Set the floppy drive as the default disk by typing the following command
(assuming the disk is in Drive A):
C:\>A:
where:
For example, the following command line specifies that the LC is linked to
COM1 and that the baud rate is 19200:
If the port and baud rate are not specified, the default values will apply
(port = COM1, baud = 19200).
10. Reset the LC module by removing it from its Base Unit, waiting five seconds,
and then replacing it. This will cause the LC to initialize itself and then to load
DOS from the floppy disk.
11. When power is applied, the LC board will perform a set of self-test diagnostics.
Figure 4-2 illustrates the diagnostic LEDs on the LC Electronics module.
PCEI 12345678
Status LEDs
Electronics Module
— Each of the set of eight LEDs (1 - 8) will be individually lit and then turned
off in sequence starting with LED 1. When this test is completed, all LEDs
(except P and C) should be off.
— The 640 Kbytes of user RAM will be tested. The amount tested will be
displayed on the external personal computer. If the test encounters an error,
LED 1 will be lit and an error message will be written to the external
personal computer.
— The LC will now enter its bootstrap routine. If the LC is configured to boot
from the external disk, and it cannot communicate with the external personal
computer, LED2 will be lit. If this occurs, check the cabling.
If no errors occur, when the LC has completed its start-up routine, only LEDs P
(Power OK) and C (Communication OK) will be lit.
13. After the LC card has been booted from the external PC, format Drive B as a
system disk by entering the following command:
A:\>FORMAT B: /S
14. Copy any programs and files necessary for the operation of the LC application
to the LC disk (Drive B). These may include the following:
— MARK4.EXE.
15. Enter the following command to save the current configuration of the LC’s
internal disk:
B:\>RLCFLASH
OR
B:\>A:\RLCFLASH
Caution
16. At this time, remove the wire jumper between C7 and C8 on the LC Base Unit
terminal block. This tells the LC to boot from the internal disk.
Reboot the LC by removing it from the Base Unit and then replacing it.
17. Once DOS is loaded to the RAM disk, the LC operates as an IBM-compatible
personal computer. Executable files which are copied to (or created on) the
RAM disk can be executed by entering the program name.
18. To exit the RLCEXTPC.EXE program at the external personal computer, press
Control-Break.
This section describes the operation and diagnostics of the Ovation LC/Mark4
interface.
The interface software reads and interprets the configuration file, and builds a
database in memory that represents the configuration. The interface software
conditions the serial port as directed in the configuration file and awaits messages
from the Mark IV.
• “Specification MDS 10846 for a simple data dump to a remote computer over a
serial link”, Rev. 3, dated 7/88.
The Mark IV sends data messages to the LC module that consist of a buffer of 8
data-bit bytes. Up to 253 data bytes can be sent in a message. The format of the
messages is this:
Table 5-1. Mark IV Message to LC Module
where:
Table 5-2. The Fields of a Mark IV Message
Occurrences of AA16 other than the flag are subject to transparency (that is, are sent
as AA16AA16). The second AA16 is discarded and is not included in the count or
the checksum calculation.
The Ovation LC module does not reply to the messages from the Mark IV. There is
no mechanism for acknowledging successful receipt of a message.
5-4. Diagnostics
There are several types of diagnostic information available during the operation of
the LC/Mark4 interface:
• Operating statistics are kept and made available to the Ovation Controller as
point values and the interface can be made to generate values for use with the
SLCSTATUS algorithm.
The statistics are not placed in memory if the parameters are not specified in the
configuration file.
The parameter keyword link_stat_reg should be set to the same value as the entry
REG1 of the SLCSTATUS algorithm. The interface software will place status
values in the LC module memory at that register (plus the next three) to indicate the
status of operation. These values will be held in memory for the amount of time
specified with status_hold_time parameter keyword. After that time, the interface
software zeroes out four registers so that the operator can clear the drop fault.
drop_timeout is used to specify how long the link must be idle before a timeout is
indicated to the controller.
The Drop Faults are displayed in the Drop Details Display diagram. The following
conventions are used in this diagram.
On startup the interface displays only error messages which describe serious
problems with the interface operation. Increasing or decreasing the system logging
priority using the (+) and (-) keys causes more or less severe messages to be
displayed. For example, at the default priority, if the communication is operating
correctly, no messages are displayed. Turning up the syslog priority by pressing the
+ key several times results in the display of more messages about normal
communication progress.
The “a” key can be used to cause the interface software to display the content of the
messages it receives from the Mark IV.
The “t” key can be used to cause the interface software to display the contents of the
LC module registers. Options allow the display to be in decimal notation,
hexadecimal, etc. The values of registers can be entered at the keyboard. Refer to
Table 5-4.
Key Action
ESC Exit the LC/Mark4 interface program in an orderly fashion.
t Toggle display of registers.
This section describes the setup and operation of the Mark IV simulation.
Using the same configuration file on both the target LC module and the simulator
PC allows the simulating software to prompt you for the correct data types. For
example, if the LC module command line is:
Mark4 –f stmtrb.cfg
Mark4 –f stmtrb.cfg –t
A: Mark4 -f stmtrb.cfg -t
WDPF-QLC/Ovation-LC module/RS232/GE Speedtronic Mark IV Interface Version 0ß
Copyright (C) 2001 by Westinghouse Process Control Inc.
Starting in test (simulator) mode, use "l" to enter simulator menu
simulation menu keys:
e - enter channel/offset data
s - send message
q - leave simulation menu
m4sim> e
m4sim> enter channel (1-8): 1
m4sim: entries will apply to channel 1.
m4sim: to change channel, exit entry loop by entering offset = -1.
m4sim> enter offset (<=253, -1 to return to sim_menu): 0
m4sim> enter 8 bit unsigned value (0 - 255): 59
m4sim: setting ch <1> off <0> pt <S0000> to <59.000000>
m4sim> enter offset (<=253, -1 to return to sim_menu): 14
m4sim> enter floating point value (3.4E 38):323.2
m4sim: setting ch <1> off <14> pt <S0018> to <323.200012>
m4sim> enter offset (<=253, -1 to return to sim_menu): 162
m4sim> enter 0 or 1 for bit 0: 1
m4sim: setting ch <1> off <162> bit <0> pt <D0500> to <1>
m4sim> enter 0 or 1 for bit 1: 0
m4sim: setting ch <1> off <162> bit <1> pt <D0501> to <0>
m4sim> enter 0 or 1 for bit 2: 1
m4sim: setting ch <1> off <162> bit <2> pt <D0502> to <1>
m4sim> enter 0 or 1 for bit 3: 0
m4sim: setting ch <1> off <162> bit <3> pt <D0503> to <0>
m4sim> enter 0 or 1 for bit 4: 1
m4sim: setting ch <1> off <162> bit <4> pt <D0504> to <1>
m4sim> enter 0 or 1 for bit 5: 0
m4sim: setting ch <1> off <162> bit <5> pt <D0505> to <0>
m4sim> enter 0 or 1 for bit 6: 1
m4sim: setting ch <1> off <162> bit <6> pt <D0506> to <1>
m4sim> enter offset (<=253, -1 to return to sim_menu): -1
simulation menu keys:
e - enter channel/offset data
s - send message
q - leave simulation menu
m4sim> s
m4sim> enter channel (1-8): 1
m4sim: sending channel <1>
aa0101a93b000000000000000000000000009a99a143000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
000000000000550000000000005203
m4sim> q
operator exit.
A:
The simulation begins with the entry at the A: prompt of the command line with the
–t option. The program displays the copyright banner and a message that indicates
that the interface is in simulation mode. The user presses the “l” key (which is not
echoed to the screen) and a simulation menu is displayed.
In preparation for sending a message, the user enters values for some of the channel/
offsets. After pressing the “e” key, the user is prompted for a channel number. The
user enters “1”; the remainder of the entries will correspond to channel 1 until the
user exits the entry loop.
The software prompts the user for an offset number, the user enters “0”. The
software checks the configuration for channel 1 offset 0 as it was read from the
configuration file at startup and prompts the user for the appropriate type and range
of data (channel 0 in this example was configured as “uint8”). The user enters the
value “59” and its stored for later transmission.
Next, the user enters offset 14 which in this example was configured as float. The
user enters “323.2” and its stored for that channel/offset. Then the user enter offset
“162” seven bits of which have been configured as digital. The user is prompted for
bit states (0 or 1) for these seven bits, and the entries are stored for later
transmission.
Finally, the user enters an offset of –1 to end the entry sequence. Next, the user types
an “s” for send, is prompted for a channel number, enters “1”, and the appropriate
message is sent. The message is displayed on the PC screen and can be verified to
conform to the protocol described in Section 5-3.
The message is sent to the LC module, which receives it, interprets the data, and
stores it in memory for the SLC algorithms to read.
A J
AUTOEXEC.BAT file 3-1, 3-8, 4-6 J1 programming port 4-2
command line options 3-8
example 3-8 L
LEDs 4-5
C Link Controller module
Cabling 2-2 initialization 1-1, 4-1
Configuration LEDs 4-5
AUTOEXEC.BAT file 3-8
hardware 2-1 M
Sample file 3-2 MARK4.EXE 4-3
sample file analysis 3-3 copy to LC module 4-6
Configuration File 3-1
copy to LC module 4-6 O
copy to PC 4-3 Operating Statistics 5-2, 5-3
parameters 3-4
rules 3-4 P
Connections Parameters 3-4
PC to LC module 4-2 channel 3-6
list 3-4, 3-6
D offset 3-6
Diagnostics 5-2 point 3-7
drop fault codes 5-4 specifiers 3-6
external host 5-4 Point 3-7
LEDs 4-5 name 3-7
message 5-2 reference 3-7
operating statistics 5-3 Protocol 3-3
protocol 5-1
SLC Drop Fault 5-3 R
SLCSTATUS Algorithm 5-3 Reference Documents 1-2
startup 5-1 RLCEXTPC.EXE 4-1, 4-3, 4-7
RLCFLASH.EXE 4-1, 4-3, 4-7
E copy to LC module 4-6
External Host Diagnostics 5-4
S
H Sample Configuration File 3-2
Hardware Configuration 2-1 analysis 3-2
Simulation 6-1
I menu 6-1
Initialization –t command 6-1
LC module 4-1 SLC Drop Fault 5-3
procedure 1 (DOS already installed) 4-3 SLCAIN algorithm 3-7
procedure 2 (DOS not installed) 4-7 SLCAOUT algorithm 3-7
RLCEXTPC.EXE 4-1 SLCDIN algorithm 3-7
RLCFLASH.EXE 4-1 SLCSTATUS algorithm 5-3
Interface Connection 2-2 Software 3-1, 4-1
Startup 5-1
message 5-2