Appendix A. Reference ........................................................................................................................................ 15
Appendix A.1. How Client Stores Data: ................................................................................................................... 15
Appendix A.1.1. Data_Type is Ana_Input or not specified ............................................................................... 15
Appendix A.1.2. Data_Type is Digi_Input ......................................................................................................... 16
Appendix A.2. How Server expects Data: ................................................................................................................ 17
Appendix A.2.1. Data_Type is Ana_Input or not specified ............................................................................... 17
Appendix A.2.2. Data_Type is Digi_Input ......................................................................................................... 17
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FS-8700-127 Hanning & Kahl HCS-R Manual Page 3 of 17
FieldServer Mode
Nodes
Comments
Client
1
Only 1 virtual client per port allowed on multidrop systems.
Server
1
This is a protocol limit, maximum devices that can be polled by Client
FieldServer Technologies PART #
Description
FS-8915-10
UTP cable (7 foot) for RS-232 use
1 HANNING & KAHL HCS-R DESCRIPTION
The Hanning & Kahl HCS-R driver allows the transfer of data from devices over RS-232 HCS-R protocol. Data is read
from HCS-R and current data stored in a specified memory area. The driver can store the data with its loop data
status distinct memory areas depending on wheter the data is on loop or from loop. The driver is based on section
10.5 of Hanning & Kahl - part number 40801121. The FieldServer can act as a Client or Server.
Max Nodes Supported
2 DRIVER SCOPE OF SUPP LY
2.1 Supplied by FieldServer Technologies for this driver
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FS-8700-127 Hanning & Kahl HCS-R Manual Page 5 of 17
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.
Float, Bit, UInt16,
SInt16, Byte.
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
// Data Arrays
Data_Arrays
Data_Array_Name
, Data_Array_Format
, Data_Array_Length
DA_CURRENT
, Uint16
, 22
DI_FromLoop01
, Bit
, 22
DI_OnLoop01
, Bit
, 22
DI_FromLoop02
, Bit
, 22
DI_OnLoop02
, Bit
, 22
DI_FromLoop03
, Bit
, 22
DI_OnLoop03
, Bit
, 22
DI_FromLoop014
, Bit
, 22
DI_OnLoop04
, Bit
, 22
4 DATA ARRAY PARAMETER S
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.
Example
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FS-8700-127 Hanning & Kahl HCS-R Manual Page 6 of 17
Section Title
Connections
Column Title
Function
Legal Values
Port
Specify which port the device is connected to the FieldServer
P1-P81
Protocol
Specify protocol used
HCS-R
HCSR
H&K HCS-R
Baud*
Specify baud rate
9600 (Vendor limitation)
Parity*
Specify parity
None (Vendor limitation)
Data_Bits*
Specify data bits
8 (Vendor limitation)
Stop_Bits*
Specify stop bits
1 (Vendor limitation)
Poll_Delay*
Time between internal polls
0-32000 seconds, 0.05 seconds
// Client Side Connections
Connections
Port
, Protocol
, Baud
, Parity
, Poll_Delay
P1
, HCS-R
, 9600
, None
, 0.100s
5 CONFIGURING THE FIELDSERVER AS A HCS-R 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 HCS-R Server.
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable
the FieldServer for HCS-R 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 Parametes
Example
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.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FS-8700-127 Hanning & Kahl HCS-R Manual Page 8 of 17
Column Title
Function
Legal Values
Node_Name
Name of Node to fetch data from
One of the Node Names
specified in Section 5.2.
HCSR_OnFrom
For Passive_Client Map Descriptor specify whether data
From Loop or On Loop or both should be stored.
On, From, OnFrom
HCSR_Loop
For Passive_Client Map Descriptor specify loop number for
which data should be stored.
1,2,3,4
Length*
Length of Map Descriptor
22 (min) for RDBC Map Descriptor:
24 if data_type is Dig_Input
21 for Passive_Client Map Descriptor.
It also depends upon HCSR_Data_Stages parameter
Refer to Appendix A.
22 or 24, 21
Data_Type*
Specify how data will be stored. Refer to Appendix A.1
Ana_Input
Digi_Input
HCSR_Data_Stages*
Specify the number of stages to keep history of data
changes. 0 and 1 means no history
0,1,2,3
Column Title
Function
Legal Values
Scan_Interval
Rate at which data is polled
≥0.001s
5.3.2 Driver Specific Map Descriptor Parameters
5.3.3 Timing Parameters
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
RDBC Map Descriptors are used to poll for data, Passive_Client Map Descriptors are used to store the data for various loops. Refer to Appendix A.1 for data
storage format.
Map_Descriptors
Map_Descriptor_Name
, Data_Array_Name
, Data_Array_Offset
, Function
, Node_name
, Length
, Scan_Interval
CMD_DI_HCSR_01
, DA_CURRENT
, 0
, RDBC
, Node_A
, 22
, 5 Map_Descriptors
Map_Descriptor_Name
Data_Array_Name
Data_Array_Offset
Function
Node_name
Length
HCSR_Onfrom
HCSR_Loop
CMD_FromLoop_01
DI_FromLoop01
0
Passive_Client
Node_A
21
From 1 CMD_OnLoop_01
DI_OnLoop01
0
Passive_Client
Node_A
21
On 1 CMD_FromLoop_02
DI_FromLoop02
0
Passive_Client
Node_A
21
From 2 CMD_OnLoop_02
DI_OnLoop02
0
Passive_Client
Node_A
21
On 2 CMD_FromLoop_03
DI_FromLoop03
0
Passive_Client
Node_A
21
From 3 CMD_OnLoop_03
DI_OnLoop03
0
Passive_Client
Node_A
21
On 3 CMD_FromLoop_4
DI_FromLoop04
0
Passive_Client
Node_A
21
From 4 CMD_OnLoop_04
DI_OnLoop04
0
Passive_Client
Node_A
21
On
4
The CMD_DI Map Descriptor polls
HCS-R Node_A every 5 seconds.
Function must be RDBC to
enable polling.
Data Array name
defined in
Section 4
Starting offset
in Data Array to
hold data
Maximum number of
placeholders for data storage.
Passive_Client Map
Descriptors are used to
store data returned by
response.
Page 10
FS-8700-127 Hanning & Kahl HCS-R Manual Page 10 of 17
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
5.5 Map Descri ptor E xample: Read Data a nd Ke ep His tory
This Map Descriptor allows the storage of data history. The driver divides the Data Array into sections corresponding to the number of HCSR_Data_Stages.
Current data (stage1) will be stored in the first section and oldest (last stage) data will be stored in the last section in the Data array. Data will be shifted to
next Stage only on change.
Map_Descriptors
Map_Descriptor_Name
, Data_Array_Name
, Data_Array_Offset
, Function
, Node_Name
, Length
, Scan_Interval
, HCSR_Data_Stages
CMD_DI_HCSR_01
, DA_CURRENT
, 0
, RDBC
, Node_A
, 72
, 5
, 3
Map_Descriptors
Map_Descriptor_Name
, Data_Array_Name
, Data_Array_Offset
, Function
, Node_Name
, Length
, HCSR_Onfrom
, HCSR_Loop
, HCSR_Data_Stages
CMD_FromLoop_01
, DI_FromLoop01
, 0
, Passive_Client
Node_A
, 63
, From
, 1
, 3
CMD_OnLoop_01
, DI_OnLoop01
, 0
, Passive_Client
Node_A
, 63
, On
, 1
, 3
CMD_FromLoop_02
, DI_FromLoop02
, 0
, Passive_Client
Node_A
, 63
, From
, 2
, 3
CMD_OnLoop_02
, DI_OnLoop02
, 0
, Passive_Client
Node_A
, 63
, On
, 2
, 3
CMD_FromLoop_03
, DI_FromLoop03
, 0
, Passive_Client
Node_A
, 63
, From
, 3
, 3
CMD_OnLoop_03
, DI_OnLoop03
, 0
, Passive_Client
Node_A
, 63
, On
, 3
, 3
CMD_FromLoop_4
, DI_FromLoop04
, 0
, Passive_Client
Node_A
, 63
, From
, 4
, 3
CMD_OnLoop_04
, DI_OnLoop04
, 0
, Passive_Client
Node_A
, 63
, On
, 4
, 3
The number of data
stages (data changes) to
be kept as history.
Page 11
FS-8700-127 Hanning & Kahl HCS-R Manual Page 11 of 17
Section Title
Connections
Column Title
Function
Legal Values
Port
Specify which port the device is connected to the
FieldServer
P1-P83
Protocol
Specify protocol used
HCS-R
HCSR
H&K HCS-R
Baud*
Specify baud rate
9600 (Vendor Limitation)
Parity*
Specify parity
None (Vendor Limitation)
Data_Bits*
Specify data bits
8 (Vendor Limitation)
Stop_Bits*
Specify stop bits
1 (Vendor Limitation)
Server_Hold_Timeout*
Specifies the time that the FieldServer will reserve the
Server side connection while waiting for the Client side to
update data in Data_Array (if necessary)
>1.0s, 2.0s// Server Side Connections
Connections
Port
, Protocol
, Baud
, Parity
P8
, HCS-R
, 9600
, None
6 CONFIGURING THE FIELDSERVER AS A HCS-R 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 Hanning & Kahl HCS-R Client.
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable
the FieldServer for HCS-R 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 Con nection Parameters
Example
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.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FS-8700-127 Hanning & Kahl HCS-R Manual Page 12 of 17
Section Title
Nodes
Column Title
Function
Legal Values
Node_Name
Provide name for Node
Up to 32
alphanumeric
characters
Node_ID
Station address of physical server Node
240
Protocol
Specify protocol used
HCS-R
HCSR
H&K HCS-R
Server_Hold_Timeout*
Specifies the time that the FieldServer will reserve the Server
side connection while waiting for the Client side to update data
in Data_Array (if necessary)
>1.0s, 2.0s
// Server Side Nodes
Nodes
Node_Name
, Node_ID
, Protocol
HCSR_01
, 240
, HCS-R
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
0 to (Data_Array_Length-1) as
specified in Section 4.
Data_Array_Offset
Starting location in Data Array
0 to (Data_Array_Length-1) as
specified in Section 4.
Function
Function of Server Map Descriptor
Passive
Server_Hold_Timeout*
Specifies the time that the FieldServer will reserve the
Server side connection while waiting for the Client
side to update data in Data_Array (if necessary)
>1.0s, 2.0s
6.2 Server Side No de Parameters
Example
6.3 Server Side Map Descriptor Parameters
6.3.1 FieldServer Related Map Descriptor Parameters
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
6.3.3 Map Descriptor Examp l e. - SM D _HCSR _01 Map Descriptor to S erve H CS-R c lients.
// Server Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name
, Data_Array_Name
, Data_Array_Offset
, Function
, Node_Name
, Length
, Scada_Hold_Timeout
SMD_HCSR_01
, DA_HCSR
, 0
, Passive
, HCSR_01
, 22
, 5
The starting location
of data to serve within
the Data Array
The number of items within the Data
Array which will be used to prepare the
response to the HCS-R Client
Data Array name
defined in
Section 4
Page 15
FS-8700-127 Hanning & Kahl HCS-R Manual Page 15 of 17
Data Array Offset
Description
Current Data
0 - 18
Data bits ( 0 - 1 )
19
Receipt ok ( 0 ), Disturbance ( 1 )
20
From Loop ( 0 ), On Loop ( 1 )
21
Loop Number (1,2,3,4) as integer
2nd (Previous) Data
24 – 42
Data bits ( 0 – 1 )
43
Receipt ok ( 0 ), Disturbance ( 1 )
44
From Loop ( 0 ), On Loop ( 1 )
45
Loop Number (1,2,3,4) as integer
3rd (Prior to previous) Data
48 – 66
Data bits ( 0 – 1 )
67
Receipt ok ( 0 ), Disturbance ( 1 )
68
From Loop ( 0 ), On Loop ( 1 )
69
Loop Number (1,2,3,4) as integer
Appendix A. Reference
Appendix A.1. How Client Stores Data:
The HCS will be polled by an RDBC Map Descriptor and data will be stored in the DA_Current Data Array in the
following fashion if parameter HCSR_Data_Stages >1:
New data is stored as current data. If data is changed, last current data is moved to 2
data is lost.
When a vehicle has HCS-R equipment installed, Byte 7 (Status of the loop) is equivalent to the “From Loop (0),
On Loop (1) byte listed in Appendix A.1.1. The 20th offset will hold whether data is From Loop or On Loop. To
achieve this, the FieldServer should be configured to store On-Loop and From-Loop data in the same Data
Array. i.e. Map Descriptor Parameter HSCR_Onfrom should be set to Onfrom. Refer to Section 5.3.2
Appendix A.1.1. Data_Typ e is Ana _Input o r not s p ecified
nd
Stage, 2nd Stage data is moved to 3rd stage and 3rd stage
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com