FieldServer FS-8700-31 User Manual

A Sierra Monitor Company

Driver Manual

(Supplement to the FieldServer Instruction Manual)

FS-8700-31 Siemens TIWAY I

APPLICABILITY & EFFECTIVITY

Effective for all systems manufactured after May 1, 2001

Driver Version 1.01b

Document revision Rev 1

FS-8700-31 Siemens TIWAY I Index

TABLE OF CONTENTS

1. Siemens TIWAY I Driver Description............................................................................... 1

2. Driver Scope of Supply..................................................................................................... 2

2.1. Supplied by FieldServer Technologies for this driver ...................................................2

2.2. Provided by the Supplier of 3rd Party Equipment..........................................................2

2.2.1. Hardware...................................................................................................................2

2.2.2. Required 3rd Party Software ...................................................................................... 2

2.2.3. Required 3rd Party Configuration ...............................................................................2

2.2.4. Optional Items ........................................................................................................... 2

3. Hardware Connections .....................................................................................................3

3.1. Hardware Connection Tips / Hints................................................................................ 3

4. Configuring the FieldServer as a TIWAY Client .............................................................3

4.1. Data Arrays/Descriptors ...............................................................................................3

4.2. Client Side Connection Descriptions ............................................................................4

4.3. Client Side Node Descriptors .......................................................................................5

4.4. Client Side Map Descriptors .........................................................................................5

4.4.1. FieldServer Related Map Descriptor Parameters...................................................... 5

4.4.2. Driver Related Map Descriptor Parameters ..............................................................6

4.4.3. Timing Parameters ....................................................................................................7

4.4.4. Reading TIWAY data map descriptor examples .......................................................8

4.4.4.1. Reading data from contiguous PLC data memory locations............................... 8

4.4.4.2. Reading data from random PLC data memory locations .................................... 8

4.4.4.3. Reading Drum_Count_Preset data from contiguous PLC data memory
locations 8

4.4.4.4. Reading Drum_Count_Preset data from random PLC data memory locations .. 9

4.4.4.5. Reading secondary PLC status ..........................................................................9

4.4.5. Writing TIWAY data map descriptor examples........................................................ 10

4.4.5.1. Writing data to contiguous PLC data memory locations ...................................10

4.4.5.2. Writing data to random PLC data memory locations ........................................10

4.4.5.3. Writing the same value to a block of contiguous PLC data memory locations .11

4.4.5.4. Writing Drum_Count_Preset data to contiguous PLC data memory locations .11

4.4.5.5. Writing Drum_Count_Preset data to random PLC data memory locations.......11

4.4.6. TIWAY host adapter command map descriptor examples ......................................12

4.4.6.1. Read Secondary Log ........................................................................................12

4.4.6.2. Report HIU Configuration .................................................................................12

4.4.6.3. Report Adapter Configuration ...........................................................................13

4.4.6.4. Report Network Manager Configuration ...........................................................13

4.4.6.5. Soft Reset .........................................................................................................14

4.4.6.6. Reset Adapter...................................................................................................15

4.4.6.7. Disconnect Secondaries ...................................................................................15

4.4.6.8. Connect Secondaries .......................................................................................15

5. Configuring the FieldServer as a TIWAY Server ..........................................................17

5.1. Server Side Connection Descriptors...........................................................................17

5.2. Server Side Node Descriptors ....................................................................................18

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-31 Siemens TIWAY I Index

5.3.

Server Side Map Descriptors...................................................................................... 19

5.3.1. FieldServer Specific Map Descriptor Parameters ...................................................19

5.3.2. Driver Specific Map Descriptor Parameters ............................................................19

5.3.3. Serving TIWAY data map descriptor example ........................................................21

5.3.4. Serving Drum_Count_Preset TIWAY data map descriptor example....................... 21

5.3.5. Serving PLC status data map descriptor example .................................................. 21

6. Advanced Topics ............................................................................................................22

7. Driver Notes.....................................................................................................................22

8. Troubleshooting tips ......................................................................................................22

8.1. Connection Tips & Hints .............................................................................................22

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-31 Siemens TIWAY I Page 1 of 23

1. Siemens TIWAY I Driver Description

The Siemens TIWAY I driver allows the FieldServer to transfer data to and from devices
over RS-
emulate either a Server or Client.

Max Nodes Supported

Client 1 Only 1 client node allowed

Server 254 Up to 254 secondary PLCs

The FieldServer Siemens TIWAY I driver, hereafter simply referred to as the TIWAY driver,
can be used to emulate the host side of a Siemens Unilink Host Adaptor (UHA) using BDLC
“Host Command Protocol”. The original Siemens UHA device was used to interface other
host devices to a TIWAY I network as shown below:

232C using TIWAY BDLC “Host Adapter Command” protocol. The FieldServer can

FieldServer Mode Nodes Comments

The original Siemens UHA is really a protocol bridge in itself. It speaks “Host Command
Protocol” on the host interface which may contain embedded TIWAY primitives (commands)
and speaks Siemens TIWAY I protocol on its secondary interface. The FieldServer TIWAY I
driver emulates the UHA’s host interface when used in the server mode, however the
FieldServer does not speak Siemens TIWAY protocol and therefore cannot be used to
connect to legacy TIWAY devices directly. The driver’s use is primarily as a server to allow
legacy SCADA systems speaking “Host Command Protocol” containing TIWAY primitives to
communicate with modern PLCs speaking Modbus or other industrial protocols. The
accompanying FieldServer client driver in a configuration setup will typically be Modbus or
some other industrial protocol. The TIWAY driver’s use as a client is limited to emulating a
host to a UHA or for testing purposes.

The TIWAY driver operates in the Master Host Interface Unit ( MHIU ) mode and only
supports a limited selected set of Host Adapter commands and TIWAY primitives which are

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-31 Siemens TIWAY I Page 2 of 23

listed under the Supported Host Adaptor Commands and Primitives section of the driver
factsheet.

2. Driver Scope of Supply

2.1. Supplied by FieldServer Technologies for this driver

FieldServer Technologies

PART #

Description

FS-8915-10 UTP cable (7 foot) for Ethernet connection
FS-8915-10 UTP cable (7 foot) for RS232 use
FS-8917-02 RJ45 to DB9F connector adapter
FS-8917-01 RJ45 to DB25M connection adapter

- Driver Manual.

2.2. Provided by the Supplier of 3rd Party Equipment

2.2.1. Hardware

Part # Description

2.2.2. Required 3rd Party Software

SCADA TIWAY Unilink adapter client software such as Intellution’s FIX
driver.

2.2.3. Required 3rd Party Configuration

The BDLC protocol has to be selected on any 3rd party client.

2.2.4. Optional Items

PART # Vendor/Manufacturer Description

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-31 Siemens TIWAY I Page 3 of 23

3. Hardware Connections

The FieldServer is connected to the SCADA system as shown below.

Configure the SCADA system according to manufacturer’s instructions.

3.1. Hardware Connection Tips / Hints

To be updated from testing feedback.

4. Configuring the FieldServer as a TIWAY Client

For a detailed discussion on FieldServer configuration, please refer to the FieldServer

instruction

upon the factory defaults provided in the configuration files included with the FieldServer
(See “.csv” sample files provided with the FS).

This section documents and describes the parameters necessary for configuring the
FieldServer to communicate with a TIWAY Server. The driver is normally used in the server
mode, but may be configured as a client for testing purposes.

Configuration mManual. The information that follows describes how to expand

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 TIWAY 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

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-31 Siemens TIWAY I Page 4 of 23

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

Up to 15 alphanumeric
characters
Float, Bit, UInt16, SInt16,

Data_Array_Format

Provide data format. Each Data Array
can only take on one format.

Packed_Bit, Byte,
Packed_Byte,
Swapped_Byte

Number of Data Objects. Must be

Data_Array_Length

larger than the data storage area
required by the map descriptors for

1-10,000

the data being placed in this array.

Example

// Data Arrays

Data_Arrays

Data_Array_Name, Data_Format, Data_Array_Length,

RAW16_Data, UInt16, 20

RAW8_Data, Byte, 20

Float_Data, Float, 20

4.2. Client Side Connection Descriptions

Section Title

Connections

Column Title Function Legal Values

Specify which port the device

Port

Protocol Specify protocol used TIWAY, TIWAY_BDLC

Baud* Specify baud rate

Parity* Specify parity Even, Odd, None, Mark, Space
Data_Bits* Specify data bits 7, 8
Stop_Bits* Specify stop bits
Handshaking* Specify hardware handshaking RTS, RTS/CTS, None
Poll _Delay* Time between internal polls 0-32000 seconds, 1 second

is connected to the
FieldServer

P1-P8

110 – 115200, standard
baudrates only

1

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

FS-8700-31 Siemens TIWAY I Page 5 of 23

Example

// Client Side Connections

Connections
Port, Protocol, Baud, Parity, Handshaking, Poll_Delay
P1, TIWAY_BDLC, 9600, None, None, 0.100s

4.3. Client Side Node Descriptors

Section Title

Nodes

Column Title Function Legal Values

Node_Name Provide name for node

Node_ID

Protocol Specify protocol used TIWAY, TIWAY_BDLC

Connection

Example

// Client Side Nodes

Nodes
Node_Name, Node_ID, Protocol, Port
PLC_01, 01, TIWAY_BDLC, P1

Secondary PLC station address to
communicate with

Specify which port the device is
connected to the FieldServer

Up to 32 alphanumeric
characters

1-254

P1-P8

4.4. Client Side Map Descriptors

4.4.1. FieldServer Related Map Descriptor Parameters

Section Title

Map Descriptors

Column Title Function Legal Values

Map_Descriptor_Name

Data_Array_Name

Data_Array_Offset

Function

FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com

Tel: [phone] Fax: [phone] Toll_Free: 888-509-1970 email: [e-mail]

Name of this Map
Descriptor
Name of Data Array
where data is to be stored
in the FieldServer
Starting location in Data
Array
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, WRBC, WRBX, AWT