FS-8700-127 Hanning & Kahl HCS-R Manual Page 3 of 17
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
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 can be polled by Client
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
4. 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.
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 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.
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array
Data_Array_Format
Data_Array_Length
Provide data format. Each Data Array can
only take on one format.
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.
FS-8700-127 Hanning & Kahl HCS-R Manual Page 8 of 17
4.4. Client Side Map Descriptors
4.4.1. FieldServer Related Map Descriptor Parameters
Column Title Function Legal Values
Map_Descriptor_Name Name of this Map Descriptor
Name of Data Array where data
Data_Array_Name
Data_Array_Offset Starting location in Data Array
Function
is to be stored in the
FieldServer
Function of Client Map
Descriptor
Up to 32 alphanumeric
characters
One of the Data Array names
from “Data Array” section above
0 to maximum specified in
“Data Array” section above
RDBC, Passive_Client
4.4.2. Driver Related Map Descriptor Parameters
Column Title Function Legal Values
One of the Node Names
Node_Name Name of Node to fetch data from
For Passive_Client Map Descriptor
HCSR_OnFrom
HCSR_Loop
Length
Data_Type*
HCSR_Data_Stages*
specify whether data From Loop or
On Loop should be stored.
For Passive_Client Map Descriptor
specify loop number for which data
should be stored.
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
Specify how data will be stored.
Refer to Appendix A
Specify the number of stages to
keep history of data changes.
0 and 1 means no history
specified in “Client Node
Descriptor” above
On, From, OnFrom
1,2,3,4
22 or 24, 21
Ana_Input
Digi_Input2
0,1,2,3
4.4.3. Timing Parameters
Column Title Function Legal Values
Scan_Interval Rate at which data is polled ≥0.001s
2
Default for Digi_Input
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
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
data
FS-8700-127 Hanning & Kahl HCS-R Manual Page 11 of 17
5. 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.
Specify which port the device is
connected to the FieldServer
Specify protocol used
Specify data bits
Specify stop bits
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)
FS-8700-127 Hanning & Kahl HCS-R Manual Page 12 of 17
5.2. Server Side Node Descriptors
Section Title
Nodes
Column Title Function Legal Values
Node_Name Provide name for Node
Node_ID
Protocol Specify protocol used
Server_Hold_Timeout*
Station address of physical server
Node
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)
FS-8700-127 Hanning & Kahl HCS-R Manual Page 13 of 17
5.3. Server Side Map Descriptors
5.3.1. FieldServer Specific Map Descriptor Parameters
Column Title Function Legal Values
Map_Descriptor_Name Name of this Map Descriptor
Name of Data Array where
Data_Array_Name
Data_Array_Offset Starting location in Data Array
Function
Server_Hold_Timeout*
data is to be stored in the
FieldServer
Function of Server Map
Descriptor
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)
Up to 32 alphanumeric
characters
One of the Data Array names
from “Data Array” section
above
0 to maximum specified in
“Data Array” section above
Server
>1.0s, 2.0s
5.3.2. Driver Specific Map Descriptor Parameters
Column Title Function Legal Values
Node_Name
Length Length of Map Descriptor 22
Data_Type*
Name of Node to fetch data
from
Specify format of the data to
serve.
Refer to Appendix A
One of the Node names
specified in “Client Node
Descriptor” above
Digi_Input
Ana_Input
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.FieldServer.com
FS-8700-127 Hanning & Kahl HCS-R Manual Page 15 of 17
Appendix A. Advanced Topics
Appendix A.1. 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 2nd Stage, 2nd Stage data is moved
to 3rd stage and 3rd stage data is lost.
Appendix A.1.1. Data_Type is Ana_Input or not specified
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.1.2. Data_Type is Digi_Input
Data Array Offset (Say 0) Description
Current Data
0 - 18 Data bits ( 0 - 1 )
19 Receipt ok ( 0 ), Disturbance ( 1 )
20 From Loop ( 0 ), On Loop ( 1 )
21,22,23 3 bits for Loop Number