-
A Sierra Monitor Company
Driver Manual
(Supplement to the FieldServer Instruction Manual)
FS-8700-128 Safetran SCS-128
APPLICABILITY & EFFECTIVITY
Effective for all systems manufactured after May 1, 2001
Driver Version:
1.00
Document Revision: 6
FS-8700-128 Safetran SCS-128 Manual
Page 3 of 15
1.
Safetran-SCS-128 Description
The Safetran-SCS-128 driver allows the transfer of data to and from devices over RS-232 SCS-
128 protocol. Vital Harmon Logic Controller (VHLC) supports SCS-128 protocol. SCS-128
80938-098 Rev A04 is the basis of the Safetran-SCS-128 driver. The FieldServer can act as a
Client or a Server.
Max Nodes Supported
FieldServer Mode
Nodes
Comments
Only 1 virtual client per port allowed on multidrop systems, which
can poll 127 Server devices
Client
1
Server
127
This is a protocol limit, maximum devices can be polled by Client
FS-8700-128 Safetran SCS-128 Manual
Page 4 of 15
2.
Driver Scope of Supply
2.1. Supplied by FieldServer Technologies for this driver
FieldServer Technologies
PART #
Description
FS-8915-10
FS-8917-04
FS-8700-128
UTP cable (7 foot) for RS-232 use
RJ45 to DB25F connector adapter
Driver Manual.
2.2.
2.2.1.
Provided by the Supplier of 3rd Party Equipment
Required 3rd Party Configuration
If the FieldServer is configured as a Server, then the SCS-128 client must be configured
to use ‘recall’ for indication status polling.
FS-8700-128 Safetran SCS-128 Manual
Page 5 of 15
3.
Hardware Connections
The FieldServer is connected to the VHLC as shown in connection drawing.
FS-8915-10
Tx
8917-04
2
8
7
6
5
4
3
2
1
GND
7
Port C VHLC RS-232
Interface Module P2
DB25F
Rx
3
RJ45
FieldServer
VHLC
Client
(408)-262-2299
FIELDSERVER
Safetran SCS-128
CONNECTION DIAGRAM
BASE NAME: FS8700-128
FILE NAME:
DATE: 4/25/08
BY: MC
FS-8700-128 Safetran SCS-128 Manual
Page 6 of 15
4.
Configuring the FieldServer as a Safetran-SCS-128 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 Safetran-SCS-128 Server.
4.1.
Data Arrays/Descriptors
The configuration file tells the FieldServer about its interfaces, and the routing of data
required. In order to enable the FieldServer for Safetran-SCS-128 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.
Section Title
Data_Arrays
Column Title
Function
Legal Values
Up to 15 alphanumeric
characters
Data_Array_Name
Provide name for Data Array
Provide data format. Each Data Array Float, Bit, UInt16, SInt16,
Data_Array_Format
Data_Array_Length
can only take on one format.
Byte,
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,
DA_DI_01,
DA_DO_01,
DA_8I_01,
DA_8O_01,
DA_16I_01,
DA_16O_01,
DA_32I_01,
DA_32O_01,
Data_Array_Format,
Bit,
Bit,
Byte,
Data_Array_Length
256
256
32
32
16
16
8
Byte,
Uint16,
Uint16,
Uint32,
Uint32,
8
FS-8700-128 Safetran SCS-128 Manual
Page 7 of 15
4.2.
Client Side Connection Descriptions
Section Title
Connections
Column Title
Function
Legal Values
Specify which port the device is connected
to the FieldServer
P1-P81
Port
SCS-128
SCS128
Safetran SCS-128
75, 150, 300 ,600, 1200, 2400, 9600
(Vendor limitation)
Protocol
Baud*
Specify protocol used
Specify baud rate
Parity*
Data_Bits*
Stop_Bits*
Specify parity
Specify data bits
Specify stop bits
Even (Vendor limitation)
8 (Vendor limitation)
1 (Vendor limitation)
Handshaking* Specify hardware handshaking
None
Poll_Delay*
Time between internal polls
0-32000 seconds, 0.05 seconds
Example
// Client Side Connections
Connections
Port,
P8,
Protocol,
SCS-128,
Baud,
9600,
Parity,
Even,
Handshaking,
None,
Poll_Delay
0.100s
4.3.
Client Side Node Descriptors
Section Title
Nodes
Column Title
Function
Provide name for Node
Legal Values
Up to 32 alphanumeric
characters
Node_Name
Node_ID
SCS-128 station address of physical Server Node
Specify protocol used
1-127
SCS-128
SCS128
Protocol
Safetran SCS-128
Specify which port the device is connected to the
FieldServer
P1-P81
Connection
If ON, Ack will be sent to Server upon receipt of every
indication response
SCS128_Ack*
OFF, ON
Example
// Client Side Nodes
Nodes
Node_Name,
NODE_A,
Node_ID,
1,
Protocol,
SCS-128,
Connection,
P8,
SCS128_Ack
OFF
1
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-128 Safetran SCS-128 Manual
Page 8 of 15
4.4.
4.4.1.
Client Side Map Descriptors
FieldServer Related Map Descriptor Parameters
Column Title
Function
Legal Values
to 32 alphanumeric
Up
characters
Name of Data Array where data One of the Data Array names
Map_Descriptor_Name Name of this Map Descriptor
Data_Array_Name
is to be stored in the FieldServer
from “Data Array” section above
0 to maximum specified in “Data
Array” section above
Data_Array_Offset
Function
Starting location in Data Array
Function of Client Map Descriptor Rdbc, Wrbc, Wrbx
4.4.2.
Driver Related Map Descriptor Parameters
Column Title
Function
Legal Values
One of the Node
names specified in
Node_Name
Name of Node to fetch data from
“Client
Node
Descriptor” above
For
Descriptors :
Recall, 2, Poll, 1,
For
Descriptors :
Controls, 3
Cutoff, 5, 6
Read
Map
Specify Poll_type
‘Recall’ or 2 always poll for current indications
‘Poll’ or 1 request for indications if changed
‘Controls’ or 3 writes controls to target device
‘Cutoff’ or 5 or 6 send ‘cutoff’ command to
target device
SCS128_Poll_Type*
Write
Map
‘Flag’ - each byte of Indication statuses will be
stored in 8 consecutive locations in the Data
Array. On write; one Control byte will be
composed from 8 consecutive locations.
‘Byte’- each byte of Indication statuses will be
stored as an 8 Bit Integer at the specified
location. On Write; one Control byte will be
composed from a single location.
‘Register’ - two bytes of Indication statuses will
be stored as a 16 Bit integer at the specified
location. On Write; two Control bytes will be
composed from a single location.
Flag, Byte, Register,
32-Bit_Reg
Data_Type*
’32-Bit_Reg’ four bytes of Indication statuses
will be stored as 32 Bit integers at the
specified location. On Write, four Control bytes
will be composed from a single location.
Refer to Appendix A
Flag: 8-256, 16
Byte: 1-32, 2
Register: 1-16, 1
32-Bit_Reg: 1-8, 1
Length of Map Descriptor
Number of indications to store or number of
controls to write as per Data_Type.
Length*
4.4.3.
Timing Parameters
Column Title
Scan_Interval
Function
Rate at which data is polled
Legal Values
≥0.001s
FS-8700-128 Safetran SCS-128 Manual
Page 11 of 15
5.
Configuring the FieldServer as a Safetran-SCS-128 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” sample files
provided with the FieldServer).
This section documents and describes the parameters necessary for configuring the FieldServer
to communicate with a Safetran-SCS-128 Client. When configured as a Server, the FieldServer
is unable to keep synchronism with other Servers and Clients on the network if it is being polled
using ‘Poll’ Function (i.e. single byte message). Therefore the FieldServer must be polled with
‘Recall’ request for indication statuses. The FieldServer will always respond with the current
statuses.
The configuration file tells the FieldServer about its interfaces, and the routing of data required.
In order to enable the FieldServer for Safetran-SCS-128 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.
Server Side Connection Descriptors
Section Title
Connections
Column Title
Function
Specify which port the device is connected to the
FieldServer
Legal Values
P1-P82
Port
SCS-128
SCS128
Protocol
Specify protocol used
Safetran SCS-128
75, 150, 300 ,600,
Baud*
Parity*
Specify baud rate
Specify parity
1200,
(Vendor limitation)
Even
limitation)
2400,
9600
(Vendor
Data_Bits*
Specify data bits
Specify stop bits
Specify hardware handshaking
8 (Vendor limitation)
1 (Vendor limitation)
None
Stop_Bits*
Handshaking*
Specifies time FieldServer will reserve Server
Server_Hold_Timeout side connection while waiting for the Client side to >1.0s
update data in Data_Array (if necessary)
2
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-128 Safetran SCS-128 Manual
Example
Page 12 of 15
// Server Side Connections
Connections
Port,
P8,
Protocol,
SCS-128,
Baud,
9600,
Parity,
None,
Handshaking
None
5.2.
Server Side Node Descriptors
Section Title
Nodes
Column Title
Function
Provide name for Node
Legal Values
Up
to
32
Node_Name
Node_ID
alphanumeric
characters
1-255
SCS-128
SCS128
Modbus station address of physical Server Node
Specify protocol used
Protocol
Safetran SCS-128
Specifies time FieldServer will reserve Server side
Server_Hold_Timeout connection while waiting for the Client side to update >1.0s
data in Data_Array (if necessary)
Example
// Server Side Nodes
Nodes
Node_Name,
PLC 1,
∗
Node_ID,
1,
Protocol
SCS-128
∗ Note that no connection information is necessary on Server side
FS-8700-128 Safetran SCS-128 Manual
Page 13 of 15
5.3.
5.3.1.
Server Side Map Descriptors
FieldServer Specific Map Descriptor Parameters
Column Title
Function
Legal Values
Up to 32 alphanumeric
characters
Map_Descriptor_Name Name of this Map Descriptor
One of the Data Array
names from “Data Array”
section above
Name of Data Array where data is to be
stored in the FieldServer
Data_Array_Name
0 to maximum specified
in “Data Array” section
above
Data_Array_Offset
Function
Starting location in Data Array
Function of Server Map Descriptor
Specifies time FieldServer will reserve
Server side connection while waiting for
the Client side to update data in
Data_Array (if necessary)
Server
Server_Hold_Timeout
>1.0s
5.3.2.
Driver Specific Map Descriptor Parameters
Column Title
Function
Legal Values
One of the Node
names specified in
Node_Name
Name of Node to fetch data from
“Client
Node
Descriptor” above
Specify type of requests to handle from client.
SCS128_Poll_Type ‘Indications’ Handle all read requests from client. Indications, Controls
‘Controls’ Handle all write requests from client
‘Flag’ each byte of Controls will be stored in 8
consecutive locations in the Data Array.
Similarly while responding Indications; status
byte will be composed with data from 8
consecutive locations.
‘Byte’ each byte of Controls will be stored as 8
Bit Integer at specified location. Similarly while
responding Indications; status byte will be
composed with data from single location.
‘Register’ every two bytes of Controls will be
stored as 16 Bit integer at specified location.
Similarly while responding indications; two
Control bytes will be composed with data from
single location.
Flag, Byte, Register,
32-Bit_Reg
Data_Type
’32-Bit_Reg’ every four Control bytes will be
stored as 32 Bit integer at specified location.
Similarly while responding indications; four
Control bytes will be composed with data from
single location.
Refer to Appendix A
Flag: 8-256, 16
Byte: 1-32, 2
Register: 1-16, 1
32-Bit_Reg: 1-8, 1
Length of Map Descriptor
Number of indications to serve or number of
controls to store as per Data_Type.
Length
Address
Irrelevant parameter for this driver
FS-8700-128 Safetran SCS-128 Manual
Page 15 of 15
Appendix A. Advanced Topics
Appendix A.1. Data Format
•
•
LSB bit in Indication/Control Byte is the1st status/control value
Suppose Data_Type is ‘Byte’ and only the 1st and 2nd indication status values are 1 (out
of 8 statuses), all others being zero, Driver will store a numeric value of 3 in Data Array.
Suppose Data_Type is ‘Register’ and only the 1st and 9th indication statuses values are 1
(out of 16 statuses), all others being zero, Driver will store numeric value of 257 in the
Data Array.
•
•
Suppose Data_Type is ’32-Bit_Reg’ and only the 1st 9th and 17th indication statuses
values are 1 (out of 32 statuses), all others being zero, Driver will store the numeric
value 65793 in the Data Array.
|