FieldServer FS-8700-03 DF1 Release note

Driver Version:
1.02
Document Revision:
1
A Sierra Monitor Company
APPLICABILITY & EFFECTIVITY
Effective for all systems manufactured after December 2011
Driver Manual
(Supplement to the FieldServer Instruction Manual)
FS-8700-03 DF1

FS-8700-03 DF1 Driver Manual Table of Contents
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
TABLE OF CONTENTS
1Allen Bradley DF1 Description ........................................................................................................................ 3
2Driver Scope of Supply ................................................................................................................................... 3
2.1 Supplied by FieldServer Technologies for this driver.....................................................................................3
2.2 Provided by the Supplier of 3rd Party Equipment ..........................................................................................3
3Hardware Connections................................................................................................................................... 4
4Data Array Parameters................................................................................................................................... 5
5Configuring the FieldServer as a DF1 Client .................................................................................................... 6
5.1 Client Side Connection Parameters ...............................................................................................................6
5.2 Client Side Node Parameters .........................................................................................................................7
5.3 Client Side Map Descriptor Parameters.........................................................................................................8
5.3.1 FieldServer Related Map Descriptor Parameters ...................................................................................8
5.3.2 Driver Related Map Descriptor Parameters ...........................................................................................8
5.3.3 Map Descriptor Example........................................................................................................................9
6Configuring the FieldServer as a DF1 Server ................................................................................................. 10
6.1 Server Side Connection Parameters ............................................................................................................10
6.2 Server Side Node Parameters ......................................................................................................................11
6.3Server Side Map Descriptor Parameters......................................................................................................11
6.3.1 FieldServer Specific Map Descriptor Parameters .................................................................................11
6.3.2 Driver Specific Map Descriptor Parameters .........................................................................................12
6.3.3 Map Descriptor Example......................................................................................................................13
Appendix A. Troubleshooting .............................................................................................................................. 14
Appendix A.1. Continuous Map Descriptors............................................................................................................14
Appendix A.2. Checksum .........................................................................................................................................14
Appendix A.3. Reading B File Types.........................................................................................................................14
Appendix B. Reference ........................................................................................................................................ 15
Appendix B.1. Command Support ...........................................................................................................................15
Appendix B.2. Error Messages .................................................................................................................................15

FS-8700-03 DF1 Driver Manual Page 3 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
1ALLEN BRADLEY DF1 DESCRIPTION
The DF1 driver allows the FieldServer to transfer data to and from devices over RS-232 using DF1 protocol. The
FieldServer can emulate either a Server or Client.
The information that follows describes how to expand upon the factory defaults provided in the configuration files
included with the FieldServer.
2DRIVER SCOPE OF SUPPLY
2.1 Supplied by FieldServer Technologies for this driver
FieldServer Technologies PART #
Description
FS-8915-10
UTP cable (7 foot) for RS-232 use
FS-8917-06
RJ45 to DB9M connection adapter
2.2 Provided by the Supplier of 3rd Party Equipment
Part #
Description
AB DF1 compatible PLC, e.g. SLC5/03, PLC 5/40, etc. 1
DF1 Client, e.g. Wonderware, Intellution FIX, GE Cimplicity, etc. 2
1
If FieldServer used as Allen Bradley DF1 Client
2
If FieldServer used as Allen Bradley DF1 Server

FS-8700-03 DF1 Driver Manual Page 4 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
3HARDWARE CONNECTIONS
It is possible to connect an Allen Bradley PLC to any of the RS-232 ports. These ports simply need to be configured
for an Allen Bradley PLC in the configuration file.
FieldServer P1
18
Allen Bradley PLC
COMM 2
FS8917-06
RJ45 CAT 5 Cable
FS8915-10
FS-8917-06 Pinouts
FS Function
RJ45 Pin#
DB9F Pin#
Color
RX
1
3
White
GND
4
5
Green
TX
8
2
Blue

FS-8700-03 DF1 Driver Manual Page 5 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
4DATA ARRAY PARAMETERS
Data Arrays are “protocol neutral” data buffers for storage of data to be passed between protocols. It is necessary
to declare the data format of each of the Data Arrays to facilitate correct storage of the relevant data.
Section Title
Data_Arrays
Column Title
Function
Legal Values
Data_Array_Name
Provide name for Data Array
Up to 15
alphanumeric
characters
Data_Array_Format
Provide data format. Each Data Array can only take on one
format.
INT16, INT32, BIT,
FLOAT
Data_Array_Length
Number of Data Objects. Must be larger than the data storage
area required by the Map Descriptors for the data being placed in
this array.
1-10, 000
Example
// Data Arrays
Data_Arrays
Data_Array_Name
, Data_Array_Format
, Data_Array_Length
DA_AI_01
, Float
, 200
DA_AO_01
, Float
, 200
DA_DI_01
, Bit
, 200
DA_DO_01
, Bit
, 200

FS-8700-03 DF1 Driver Manual Page 6 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
5CONFIGURING THE FIELDSERVER AS A DF1 CLIENT
For a detailed discussion on FieldServer configuration, please refer to the FieldServer Configuration Manual. The
information that follows describes how to expand upon the factory defaults provided in the configuration files
included with the FieldServer (See “.csv” sample files provided with the FieldServer).
This section documents and describes the parameters necessary for configuring the FieldServer to communicate
with a DF1 Server
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable
the FieldServer for DH+ communications, the driver independent FieldServer buffers need to be declared in the
“Data Arrays” section, the destination 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.
5.1 Client Side Connection Parameters
Section Title
Connections
Column
Title
Function
Legal Values
Port
Specify which port the device is connected to the
FieldServer
P1-P83
Baud*
Specify baud rate
300 to 115200; 9600
Parity*
Specify parity
Even, Odd, None
Data_Bits*
Specify data bits
8
Stop_Bits*
Specify stop bits
1, 2
Protocol
Specify protocol used
DF1_FD, DF1_HD_MASTER,
DF1_HD_SLAVE
Checksum
Specify Checksum –refer to Appendix A.2
BCC, CRC-16
Example
// Client Side Connections
Connections
Port
, Protocol
, Baud
, Parity
, Data_Bits
, Stop_Bits
P1
, DF1_FD
, 38400
, None
, 8
, 1
3
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction manual for details of the ports available
on specific hardware.

FS-8700-03 DF1 Driver Manual Page 7 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
5.2 Client Side Node Parameters
Section Title
Nodes
Column Title
Function
Legal Values
Node_Name
Provide name for node
Up to 32 alphanumeric characters
Node_ID
Node ID of physical Server node (PLC)
1-255
Protocol
Specify protocol used
DF1_FD, DF1_HD_MASTER,
DF1_HD_SLAVE
Port
Specify which port the device is connected to the
FieldServer
P1-P84
PLC_Type
Specify PLC
Communications type.
PLC3, PLC5, SLC5, Control_Logix
Example
// Client Side Nodes
Nodes
Node_Name
, Node_ID
, Protocol
, PLC _Type
, Port
PLC_01
, 1
, DF1_FD
, SLC5
, P1
4
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction manual for details of the ports available
on specific hardware.

FS-8700-03 DF1 Driver Manual Page 8 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
5.3 Client Side Map Descriptor Parameters
5.3.1 FieldServer Related Map Descriptor Parameters
Column Title
Function
Legal Values
Map_Descriptor_Name
Name of this Map Descriptor
Up to 32 alphanumeric characters
Data_Array_Name
Name of Data Array where data is to be
stored in the FieldServer
One of the Data Array names from
Section 4.
Data_Array_Offset
Starting location in Data Array
0 to (Data_Array_Length-1) as specified
in Section 4.
Function
Function of Client Map Descriptor
Rdbc, Wrbc, Wrbx
5.3.2 Driver Related Map Descriptor Parameters
Column Title
Function
Legal Values
Node_Name
Name of Node to fetch data from
One of the Node names specified in Section 5.2
File_Type
File type in PLC
N, F, B, I, O5
File_Number
File Number in PLC
0-255
Address
Starting address of read block
0 –255
Length
Length of read block
1-255
Scan_Interval
Rate at which data is polled
0-32000s, 1.0s
Data_Array_Low_Scale*
Scaling zero in Data Array
-32767 to 32767, 0
Data_Array_High_Scale*
Scaling max in Data Array
-32767 to 32767, 100
Node_Low_Scale*
Scaling zero in Connected Node
-32767 to 32767, 0
Node_High_Scale*
Scaling max in Connected Node
-32767 to 32767, 100
5
Not all PLC’s can support all File_Types. Refer to DFS for further information.

FS-8700-03 DF1 Driver Manual Page 9 of 16s
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [email protected]m
5.3.3 Map Descriptor Example
// Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name
, Data_Array_Name
, Data_Array_Offset
, Function
, Node_Name
, File_Type
, File_Number
, Address
, Length
, Scan_Interval
CMD_AI_01
, DA_AI_01
, 0
, Rdbc
, PLC 1
, N
, 10
, 0
, 16
, 1.0s
CMD_AO_01
, DA_AO_01
, 0
, Rdbc
, PLC 1
, N
, 11
, 0
, 16
, 1.0s
CMD_DI_01
, DA_DI_01
, 0
, Rdbc
, PLC 1
, B
, 12
, 0
, 16
, 1.0s
CMD_DO_01
, DA_DO_01
, 0
, Rdbc
, PLC 1
, B
, 13
, 0
, 16
, 1.0s

FS-8700-03 DF1 Driver Manual Page 10 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
6CONFIGURING THE FIELDSERVER AS A DF1 SERVER
For a detailed discussion on FieldServer configuration, please refer to the FieldServer Configuration Manual. The
information that follows describes how to expand upon the factory defaults provided in the configuration files
included with the FieldServer (See “.csv” files provided with the FieldServer).
This section documents and describes the parameters necessary for configuring the FieldServer to communicate
with a DF1 Client.
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable
the FieldServer for DF1 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.
6.1 Server Side Connection Parameters
Section Title
Connections
Column
Title
Function
Legal Values
Port
Specify which port the device is connected to the
FieldServer
P1-P86
Baud*
Specify baud rate
300 to 115200; 9600
Parity*
Specify parity
Even, Odd, None
Data_Bits*
Specify data bits
8
Stop_Bits*
Specify stop bits
1, 2
Protocol
Specify protocol used
DF1_FD, DF1_HD_MASTER,
DF1_HD_SLAVE
Checksum
Specify Checksum –refer to Appendix A.2
BCC, CRC-16
Example
// Server Side Connections
Connections
Port
, Protocol
, Baud
, Parity
, Data_Bits
, Stop_Bits
P1
, DF1_FD
, 38400
, None
, 8
, 1
6
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction manual for details of the ports available
on specific hardware.

FS-8700-03 DF1 Driver Manual Page 11 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
6.2 Server Side Node Parameters
Section Title
Nodes
Column Title
Function
Legal Values
Node_Name
Provide name for node
Up to 32 alphanumeric characters
Node_ID
Node ID of physical Server node
1-255
Protocol
Specify protocol used
DF1_FD, DF1_HD_MASTER, DF1_HD_SLAVE
PLC_Type
Specify PLC Communications type.
PLC3, PLC5, SLC5
Example
// Server Side Nodes
Nodes
Node_Name
, Node_ID
, Protocol
, PLC_Type
DF1_Srv_11
, 11
, DF1_FD
, SLC5
6.3 Server Side Map Descriptor Parameters
6.3.1 FieldServer Specific Map Descriptor Parameters
Section Title
Map_Descriptors
Column Title
Function
Legal Values
Map_Descriptor_Name
Name of this Map Descriptor
Up to 32 alphanumeric characters
Data_Array_Name
Name of Data Array where data is to be
stored in the FieldServer
One of the Data Array names from
Section 4.
Data_Array_Offset
Starting location in Data Array
0 to (Data_Array_Length-1) as specified
in Section 4.
Function
Function of Client Map Descriptor
Passive

FS-8700-03 DF1 Driver Manual Page 12 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
6.3.2 Driver Specific Map Descriptor Parameters
Section Title
Map_Descriptors
Column Title
Function
Legal Values
Node_Name
Name of Node to fetch data from
One of the node names specified in Section 6.2
File_Type
File type in PLC
N, F, B, I, O7
File_Number
File number in PLC
0-255
Address
Starting address of read block
0 - 255
Length
Length of read block
1 - 255
Data_Array_Low_Scale*
Scaling zero in Data Array
-32767 to 32767, 0
Data_Array_High_Scale*
Scaling max in Data Array
-32767 to 32767, 100
Node_Low_Scale*
Scaling zero in Connected Node
-32767 to 32767, 0
Node_High_Scale*
Scaling max in Connected Node
-32767 to 32767, 100
7
Not all PLC’s can support all File_Types. Refer to DFS for further information.

FS-8700-03 DF1 Driver Manual Page 13 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [email protected]m
6.3.3 Map Descriptor Example
// Server Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name
, Data_Array_Name
, Data_Array_Offset
, Function
, Node_Name
, File_Type
, File_Number
, Address
, Length
SMD_AI_01
, DA_AI_01
, 0
, Passive
, DF1_Srv_11
, N
, 10
, 0
, 200
SMD_AO_01
, DA_AO_01
, 0
, Passive
, DF1_Srv_11
, N
, 11
, 0
, 200
SMD_DI_01
, DA_DI_01
, 0
, Passive
, DF1_Srv_11
, B
, 12
, 0
, 200
SMD_DO_01
, DA_DO_01
, 0
, Passive
, DF1_Srv_11
, B
, 13
, 0
, 200

FS-8700-03 DF1 Driver Manual Page 14 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
Appendix A. Troubleshooting
Appendix A.1. Continuous Map Descriptors
The Driver is not able to split data between 2 Data Arrays when writing, or to read a Server mapping that is
discontinuous.
For example, on the Server Side:
If:
Server map 1: N21: 0-31
Server map 2: N21: 32-100
This will panic the FieldServer and crash RS view as the DH+ will attempt to map N21: 0-100. If set up as Server
Map 1: N21: 0-100, no problems are experienced.
Similarly on the Client Side, it is not possible to read sections e.g. 32bits to one array and then 16bits from the
same file type to another array etc. Read Blocks must be contiguous.
Appendix A.2. Checksum
It is possible to specify a checksum parameter for the serial connection.
Example
// Client Side Connections
Connections
Port
, Protocol
, Baud
, Parity
, Data_Bits
, Stop_Bits
, Checksum
P1
, DF1_FD
, 38400
, None
, 8
, 1
, CRC-16
Appendix A.3. Reading B File Types
It is advisable to read all data from one B type file into the same data array in one contiguous read if possible.
Doing otherwise may result in problems when reading these points.

FS-8700-03 DF1 Driver Manual Page 15 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]
Appendix B. Reference
Appendix B.1. Command Support
The following commands are supported by the FieldServer for the various PLC types:
PLC_Type
File_Type
FNC
Read
FNC
Write
Typical
Command
PLC3
N
1
Range Read
0
Range Write
N7: 3, L5
F
1
Range Read
0
Range Write
F12: 3, L5
B
1
Range Read
2
Bit Write
B3/4: 5, l5
PLC5
N
1
Range Read
0
Range Write
N7: 3 , L5
F
1
Range Read
67
Typed Write
F12: 3, L5
B
1
Range Read
26
Read Modify Write
B3/4: 5, L5
SLC5
N
A2
Protected Typed Logical
Read
AA
Protected Typed Logical
Write
N7: 3, L5
F
A2
Protected Typed Logical
Read
AA
Protected Typed Logical
Write
B3/4: 5, L7
B
A2
Protected Typed Logical
Read
AB
Protected Typed Logical
Write
B3/4: 5, L8
I
A2
Protected Typed Logical
Read
-
-
I: 13, L5
O
A2
Protected Typed Logical
Read
-
-
O: 13, L5
Appendix B.2. Error Messages
DF1 Rem STS err F0-> Extended error code –Refer to following table.

FS-8700-03 DF1 Driver Manual Page 16 of 16
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web: www.fieldserver.com
Tel: [phone] Fax: [phone] Toll Free: [phone] email: [e-mail]