2.Driver Scope of Supply..........................................................................................................................................................2
2.1Supplied by FieldServer Technologies for this driver.............................................................................................2
2.2Provided by user .............................................................................................................................................................2
4.Configuring the FieldServer as a GE-SRTP Driver Client ..............................................................................................4
4.2Client Side Connections................................................................................................................................................5
4.3Client Side Nodes...........................................................................................................................................................5
4.4Client Side Map Descri ptors........................................................................................................................................5
4.4.1FieldServer Specific Map Descriptor Parameters............................................................................................5
4.4.2Driver Specific Map Descriptor Parameters ..................................................................................................... 6
4.4.4Map Descriptor Example 1 – Simple Read......................................................................................................7
4.4.5Map Descriptor Example 2 – Simple Write .....................................................................................................8
4.4.6Map Descriptor Example 3 – Handling Bits. ...................................................................................................9
5.Configuring the FieldServer as a GE-SRTP Driver Server ........................................................................................... 10
5.2Server Side Connections.............................................................................................................................................11
5.3Server Side Nodes ........................................................................................................................................................12
5.4Server Side Map Descriptors......................................................................................................................................12
5.4.1FieldServer Specific Map Descriptor Parameters..........................................................................................12
5.4.2Driver Specific Map Descriptor Parameters ................................................................................................... 13
The GE -SRTP driver allows the FieldServer to transfer data to and from devices over Ethernet
using GE -SRTP Driver protocol. There are two Ethernet ports standard on the FieldServer. The
FieldServer can emulate either a Server or Client.
The GE -SRTP driver is capable of read & writing the data tables of a GE series 90 PLC which is
equipped with an Ethernet port.
The driver is capable of exposing its communication statistics so that they can be monitored by a
downstream device.
Make sure the device IP_address is configured to be on the same IP network as on the
FieldServer. Use a crossover cable if the FieldServer is connected directly to the PLC
device. Use a straight cable if the FieldServer is connected to a hub.
4. Configuring the FieldServer as a GE- SRTP Driver Client
For a detailed discussion on FieldServer configuration, please refer to the instruction manual for the
FieldServer. The information that follows describes how to expand upon the factory defaults
provided in the configuration files included with the FieldServer (See “.csv” files on the driver
diskette).
This section documents and describes the parameters necessary for configuring the FieldServer to
communicate with a GE -SRTP Driver Server.
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In
order to enable the FieldServer for GE -SRTP Driver communications, the driver independent
FieldServer buffers need to be declared in the “Data Arrays” section, the destinatio n device
addresses need to be declared in the “Client Side Nodes” section, and the data required from the
servers needs to be mapped in the “Client Side Map Descriptors” section. Details on how to do this
can be found below.
Note that in the tables, * indicates an optional parameter, with the bold legal value being the
default.
4.1 Data Arrays
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array Up to 15 alphanumeric
characters
Data_Format Provide data format. Each data array can only
take on one format.
Data_Array_Length Number of Data Objects. Must be larger than
the data storage area required for the data
being placed in this array.
Node_Name Name of Node to fetch data from One of the node names specified in
Data_Type Data type
Use one of the Data Types specified in brackets.
Length Length of Map Descriptor
Ensure that the length does not exceed the table length
in the PLC.
Address Starting address of read block / write block
The 1st element of each Data type Table is referred to
as address one.
Format Use to override the default format for obtaining data.
Bit tables are by default read by reading whole bytes
at a time (If the Length is 10 then 10 bytes of data are
read and placed in 10 data array locations)
If you wish to read bits instead then use this parameter
. (If the Length is 10 then 10 bits are read and each bit
is stored in its own location.)
This example provides a map descriptor to read 10 bytes of Discrete Input states, starting at the very first Discrete Input. The data is stored in a data array
called DA_DI and the first input is stored at location 100 in the array (101st element). The PLC is polled every 2 seconds
This example writes data from the Fieldserver data array called DA_AO to the PLC identified as NODE1. The write is repeated every 5 seconds. Ten word
values are written to the PLC’s %AQ Data Table starting at location 20.
This example shows how to read 1 couple of bits from a data table rather than reading a whole byte. The bits can cross byte boundaries. Here we read 2 bits
from table %T starting at bit 8. This is most useful when writing to the PLC in cases where you want to turn one particular bit on or off.
Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Scan_Interval, node_name, Address, Length, Data_Type, Format
The format parameter tells the
driver to override the default data
type and to specifically read bits. In
this case the bit states are stored in
the data array in two separate
elements at DA_T[100] and
DA_T[101]
5. Configuring the FieldServer as a GE- SRTP Driver Server
For a detailed discussion on FieldServer configuration, please refer to the instruction manual for the
FieldServer. The information that follows describes how to expand upon the factory defaults
provided in the configuration files included with the FieldServer (See “.csv” files on the driver
diskette).
This section documents and describes the parameters necessary for configuring the FieldServer to
communicate with a GE -SRTP Driver Client
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In
order to enable the FieldServer for GE -SRTP Driver communications, the driver independent
FieldServer buffers need to be declared in the “Data Arrays” section, the FieldServer virtual node(s)
needs to be declared in the “Server Side Nodes” section, and the data to be provided to the clients
needs to be mapped in the “Server Side Map Descriptors” section. Details on how to do this can be
found below.
Note that in the tables, * indicates an optional parameter, with the bold legal value being the
default.
5.1 Data Arrays
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array Up to 15 alphanumeric
characters
Data_Format Provide data format. Each data array can only
take on one format.
Data_Array_Length Number of Data Objects. Must be larger than
the data storage area required for the data
being placed in this array.
Ensure that the length does not
exceed the table length in the PLC.
Address Starting address of read block /
write block
The 1st element of each Data type
Table is referred to as address one.
Format Has no meaning on the server as
the driver responds based on the
nature of the request
The map descriptors should be
considered to be the definitions of
data tables in a PLC. Thus one map
descriptor can be used to respond
to bit or byte requests.
Discrete Inputs (%I)
Discrete Outputs (%Q)
Discrete Temporaries (%T)
Discrete Internals (%M)
Genius Global Data (%G)
Analog Inputs (%AI)
Analog Outputs (%AQ)
Registers (%R)
%SA Discrete
%SB Discrete
%SC Discrete
%S Discrete (%S)
1 - 1000
1 , 2 , 3
Positive whole numbers
N/A
5.4.3 Timing Parameters
Column Title Function Legal Values
Scada_Hold_Timeout Specifies time server side waits
before responding to client that
node is offline on FieldServer
client side.
The statistics recorded by the GE -SNPX Serial Driver are slightly different from the way that
Fieldserver driver normally record statistics. This difference arises from the fact that this driver is
not a simple poll response driver. Bare in mind that a single poll can generate a large number of
response fragments.
Fragment Ack/nack messages are NOT counted as message but the bytes sent/rcvd are counted.
Connection messages are counted as messages and the bytes sent/rcvd are counted.
This driver can expose these and additional statistics by writing data to a data array.
A special map descriptor is required. The driver recognizes the map descriptor by its name which
must be "SRTP-stats" .
The following example shows how this special map descriptor can be configured.
When the driver sees this map descriptor it uses the data array SRTP _STATS (in this example)
to store driver specific statistics. Only one of these map descriptors may be specified (per tier) per
FieldServer.
The driver stores the following stats for each port.. The offset into the data a rray can be found by
multiplying the port number by 50
The following messages are produced by the driver and written to the error log which can be viewed using
the RUInet utility program or logged using the RUIdebug utility program.
Messages marked with a *, are only printed once and then suppressed to prevent the error log being filled
with repetitive messages.
SRTP:#1 FYI. The MapDesc called <%s> is too short.
You have define a map descriptor to expose driver statistics but the length parameter must be at
least 500 long. Ensure the Data array is this long too. Edit the CSV, correct he problem and reset
the Fieldserver.
SRTP:#2 FYI. You could have used a mapDesc called <%s> to expose diagnostic info.
You may safely ignore this message. Read section 6.3 for information on how to expose the
drivers communication statistics using a data array.
SRTP:#3 Error. MapDesc=<%s> has bad data type.
You must edit the CSV file, correct the problem and then reset the FieldServer to correct this
problem. Read the manual to get a list of valid data types.
SRTP:#4 Err. Address < 1 for MapDesc=<%s>.
GE references its data elements starting at one. You have a map descriptor with an address less
than 1. The driver will assume you meant an address of one until you edit the CSV file and reset
the FieldServer.
*SRTP:#5 FYI. Capability is non-zero
This message requires no user action. It is intended for Fieldserver support engineers.
*SRTP:#6 FYI. Connect remaining bytes non-zero
This message requires no user action. It is intended for Fieldserver support engineers.
*SRTP:#7 Err. Destination request not supported.
*SRTP:#8 Err. De stination response not supported.
The driver has received a message that it cannot respond to. The message received is not normally
associated with reading / writing table memory and can be ignored by this driver. There is no
corrective action that you can take. If you wish, take a log file using RUIdebug and contact
Fieldserver support.
SRTP:#9 Err. Driver des not support unconfirmed messages.
The driver has been polled using a method which does not require confirmation. The driver does
not support this m ethod. A panic is produced by this message. There is no corrective action that
you can take. If you wish, take a log file using RUIdebug and contact Fieldserver support.
SRTP:#10 Err. Session Mbox bad type. Act/Exp=%x/c0
SRTP:#11 Err. Session Mbox bad SR code. Act/Exp=%x/4f
SRTP:#12 Err. Session SR bad param. Act/Exp=%x/01
If this error occurs repeatedly or frequently then take a log using RUIdebug and contact support. If
infrequent then it indicate an occasional corrupt message. There is no corrective action you can
take to eliminate this error.
SRTP:#13 Err. Cant Process ServiceRQst=%x(h)
The driver cannot process this service request. It can only read/write table memory. There is no
corrective action you can take when this message is printed. If you wish, take a log file using
RUIdebug and contact Fieldserver support. The message is followed by a buffer dump. Recording
the buffer may be useful to Fieldserver support engineers.
SRTP:#14 Err. Cant Process Mbox=%x(h)
The driver cannot process this type of Mailbox message or a valild mailbox message was received
in an invalid context. If this message occurs frequently, take a log file using RUIdebug and contact
Fieldserver support. The message is followed by a buffer dump. Recording the buffer may be
useful to Fieldserver support engineers.
SRTP:#15 Err. Cant Process PDU=%x(h)
The driver can only process ‘connect’ and ‘data request’ PDU’s. . There is no corrective action
you can take when this message is printed. If you wish, take a log file using RUI debug and contact
Fieldserver support. The message is followed by a buffer dump. Recording the buffer may be
useful to Fieldserver support engineers.
6.3 Scaling
The driver only supports scaling fro the following data types
Analog Inputs (%AI)
Analog Output s (%AQ)
Registers (%R)
The scaling is only applied when the driver acts as a client.
When using scaling on an active map descriptor which writes data to a PLC ensure that the scaling
produces a number in the range 0-65536 ( an unsigned short integer).