BA01304S/00/EN/01.14
71246575

ProductsSolutions

Services

Valid as of software version:
V 01.07.00

Operating Instructions
Fieldgate FXA520/320 OPC Server
User ManualFieldgate

Table of Contents
1

Document information . . . . . . . . . . . . . . 3

1.1
1.2
1.3
1.4
1.5

Target audience for this manual . . . . . . . . . . . . . . . 3
Version history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Acronyms, Abbreviation and Definition . . . . . . . . 3
Document function . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2Basic safety instructions . . . . . . . . . . . . 4

2.1
2.2

Requirements for the personnel . . . . . . . . . . . . . . . 4
IT security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3Installation . . . . . . . . . . . . . . . . . . . . . . . . 5

3.1
3.2
3.3

Required files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Supported Windows version . . . . . . . . . . . . . . . . . . 5
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

4Configuration . . . . . . . . . . . . . . . . . . . . . . 8

4.1
4.2
4.3

Basic OPC Server Configuration . . . . . . . . . . . . . . . 9Start OPC Server . . . . . . . . . . . . . . . . . . . . . . . . . . 11Stop OPC Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 115OPC Data Structure . . . . . . . . . . . . . . . . 126Fieldgate FXA520/320 OPC
Parameter. . . . . . . . . . . . . . . . . . . . . . . . 137Advanced OPC Server Configuration . 16

7.1
7.2
7.3
7.4FieldgateOPC.config . . . . . . . . . . . . . . . . . . . . . . . 16
FIELDGATEOPCLOGGERCONF.xml . . . . . . . . . . . 16
Un-Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Fieldgate OPC Version . . . . . . . . . . . . . . . . . . . . . 17

2

Endress+Hauser

Fieldgate

Document information

1

Document information

1.1

Target audience for this manualThis documents describes installation and user guide for configuration and usage ofFieldgate FXA520/320 OPC DA 3.0 Server.
This guide is for users of Fieldgate FXA520/320 gateway and OPC Servers/Clients. The
intended audience includes Project Engineers and System Administrators.

1.2

Version history

Document version

Valid for SW version

Changes to the previous version

BA01304S/00/EN/01.14

01.07.00

Initial version

1.3

Acronyms, Abbreviation and Definition

Abbreviation

Meaning

OPC

OLE for Process Control
Open Interoperability standards developed by OPC Foundation

OPC DA 3.0

OPC Data Access specification version 3.0 specification

COMComponent Object Model

DCOM

Distributed Component Object Model1.4

Document function

1.4.1

Used symbols

Symbols for certain types of information
SymbolMeaning
Tip
Indicates additional information.
A0011193

Endress+Hauser

1.5

Documentation

1.5.1

Operating instructions

Document number

Instrument

Type of Document

BA01304S/00

Fieldgate FXA520/320 OPC Server

User Manual3Basic safety instructions

Fieldgate2

Basic safety instructions

2.1

Requirements for the personnel

The personnel for installation, commissioning, diagnostics and maintenance must fulfill thefollowing requirements:• Trained, qualified specialists: must have a relevant qualification for this specific function
and task• Are authorized by the plant owner/operator• Are familiar with federal/national regulations• Before beginning work, the specialist staff must have read and understood the instructionsin the Operating Instructions and supplementary documentation as well as in thecertificates (depending on the application)• Following instructions and basic conditions
The operating personnel must fulfill the following requirements:• Being instructed and authorized according to the requirements of the task by the facility'sowner operator• Following the instructions in these Operating Instructions

2.2IT security

We only provide a warranty if the device is installed and used as described in the Operating
Instructions. The device is equipped with security mechanisms to protect it against any
inadvertent changes to the device settings.
IT security measures in line with operators' security standards and designed to provide
additional protection for the device and device data transfer must be implemented by theoperators themselves.
Endress+Hauser can be contacted to provide support in performing this task.

4

Endress+Hauser

Fieldgate

Installation

3

Installation

3.1

Required filesFieldgateOPCServer_Installer.msi: This file contains complete installable for Fieldgate
FXA520/320 OPC Server application.

3.2

Supported Windows version• Windows XP (Service Pack 3)• Windows 7 (32bit/64bit)• Windows Server 2008
On 64-bit machines OPC Server will be installed and run in 32-bit compatibility mode.
i.e. OPC Server will be installed in C:\Program Files(x86) or equivalent location.

3.3

Installation
You need to have administrator access right to install the software.
Install Microsoft .NET Framework 4 or higher before installation.

3.3.1

Install Microsoft .NET Framework 4• Web Installer
http://www.microsoft.com/en-us/download/details.aspx?id=17851• Standalone Installer
http://www.microsoft.com/en-in/download/details.aspx?id=17718

3.3.2

Install Fieldgate FXA520/320 OPC ServerWindows 7Open Command prompt in Administrator mode as shown in below figure:

Endress+Hauser

5Installation

Fieldgate

Go to directory where FieldgateOPCServer_Installer.msi is located and type
FieldgateOPCServer_Installer.msi.

Installation
Follow the below instructions to install.

Press Next to continue.

6

Endress+Hauser

Fieldgate

Endress+Hauser

Installation

7

Configuration

Fieldgate4

Configuration

This section explains some of the basic settings required to configure OPC server.
Windows 7
Configuration files are stored at %ALLUSERSPROFILE%\Endress+Hauser GmbH+Co.
KG\Fieldgate OPC Server\Version_Number \PluginData location. and can also be accessedfrom Start Menu → All Programs → FieldateOPCServer → Configuration.
Fieldgate FXA520/320 OPC server contains OPC server configuration file and Logger
configuration file.
To change any configuration files, user has to follow below steps to make file writable:•Right click on any configuration file and select Properties. Select Security tab andpress Edit button.

• Select Users from Group or User Names tab and press select Full control fromPermissions for Users and press OK.

8Endress+Hauser

Fieldgate

Configuration

Windows XPConfiguration file are stored at %ALLUSERSPROFILE%\Application
Data\Endress+Hauser GmbH+Co. KG\Fieldgate OPC
Server\Version_Number\PluginData.

4.1

Basic OPC Server Configuration

Fieldgate FXA520/320 gateway can be configured by modifying the configuration file
FieldgateOPC.config. User can configure this file manually or using Fieldgate
configuration tool as explained below.

4.1.1

Manual Configuration

A connection can be added using the form of key value pairs as shown in below example:

FieldgateOPCServer_Manual-Config

Endress+Hauser9

Configuration

Fieldgate

In above example 2 Fieldgate FXA520/320 gateways are configured. First Fieldgate
connection required proxy setting but no use name and password but second Fieldgate
required only username and password but no proxy setting.
Configuration elements are explained in detail in chapter "FieldgateOPC.config"(→ ä 16).
In case FieldgateOPC.config file gets damaged then delete this file from abovementioned location, restart OPC server. OPC server will copy back default configuration
file.

4.1.2

Fieldgate configuration tool

Fieldgate Configuration tool (FieldgateOPCConfigTool.exe) can be access from Start Menu
→ All Programs → FieldateOPCServer → Configuration. Open configuration tool asshown below:

Add/modify or remove parameters on GUI and press Submit button to save configuration infieldgateOPC.config file.

Select complete row and press Delete button to delete entry from configuration file.

10Endress+Hauser

Fieldgate

Configuration

Press Restore Default button to get original configuration file.

4.2

Start OPC Server

OPC server will be automatically started after installation. User can also manually start/restart OPC server by executing RegServer.exe.

4.3

Stop OPC Server

OPC server can be stopped by executing UnregServer.exe.
For Windows 7 , to start/stop server open command prompt in Administrator mode,
go to project install directory and type RegServer.exe or UnRegServer.exe.

Endress+Hauser

11

OPC Data Structure

Fieldgate

5OPC Data Structure

Below diagram shows Fieldgate FXA520/320 OPC elements view from OPC Explorer/Client.
Here, text mentioned in blue color are dynamic text and value will be received fromFieldgate. Texts in red color are static text.

FieldgateOPCServer_OPC-Data-Structure

12

Endress+Hauser

Fieldgate

Fieldgate FXA520/320 OPC Parameter6

Fieldgate FXA520/320 OPC Parameter

Below tables give lists of Fieldgate parameters supported in OPC server.
Fieldgate Elements (tag.FXA320_test.ser)
NoTag NameidType

Description

1

ser

5000

stringFieldgate serial number

2

tag5001

stringFieldgate name3type5002

stringFull/partial

4

devices5003

stringAll/single

5

rev_xml

5004

stringXml revision Number

6

time5005

timestamp

Fieldgate timestamp (UTC Time)7timezone5006

uint16Time zone offset in min

8

ff_version

5007

string

H/W and S/W revision9

os_version

5008

string

OS version

10

conf

5009

stringFieldgate H/W configuration

11

ip

5010

stringIP address

12

httpport

5011

uint16HTTPS port number

13

gsmp

5012

string

GSM Provider

14

Gsms

5013

string

GSM signal quality

15

gsmti

5014

timestamp

GSM Timestamp

Fieldgate Device Elements (tag.FXA320_test.PRESSURE.type)

Endress+HauserNoTag Name

id

Type

Description

1_alive5545

stringDevice is active or not ('true/false')

2_time5546

timestamp

Time when entry is generated in OPC

3_unid5500

stringDevice unit Id

4_tag

5501

stringDevice Tag name

5id

5500

stringDevice unit Id

6tag

5501

stringDevice Tag name7type5502

stringType of device (INTRN = data internal, HART =data from device

8

hlsts15503

stringLimit Value Status, channel 1 - PV

9hlsts25504

stringLimit Value Status, channel 2 - SV

10hlsts3

5505

stringLimit Value Status, channel 3 - TV

11hlsts45506

stringLimit Value Status, channel 4 - QV

12hltime1 - hltime45507 5510

timestamp

Status changed timestamp, channel 1-4 PV,SV,TV,QV

13

chn1 - chn45511 5514

int

Channel:01 = HART channel 1,
10 = HART channel 2,
11 = RS485

14

u1 - u45515 5518

stringchannel 1-4 -PV,SV,TV,QV unit

15

v1 - v45519 5522

float

channel 1-4 -PV,SV,TV,QV Value

13

Fieldgate FXA520/320 OPC Parameter

Fieldgate

NoTag NameidType

Description

16vstslvl5523

int

Device error
0: OK1: Warning
2: Error (according to HART6-Spec)

17

vtime

5524

timestampcommand 000 timestamp18

v1_100

5525

float

Primary variable percent of range

19

v1_lc

5526

float

Primary variable loop current

20

fnum

5527

float

HART extended Device type21

datecode

5528

float

Manufacture date of HART device

22

desc

5529

stringdevice description

23

msg

5530

stringUser text (HART)

24

serno

5531

int

HART device serial number

25

hwrev

5532

int

HART device H/W revision

26

swrev

5533

int

S/W revision27

devrev

5534

int

HART device revision number28

cmdrev

5535

int

HART command revision number29

preambl5536

int

number of preambles (HART)

30

stime

5537

timestamp

Timestamp of cmd000 (HART)(brings: Expanded Device Type Code, Revision
Levels, Device ID)

31

pid5538

int

Product identification number (HART)

32

dev

5539

stringDevice designation

33

man

5540

stringDevice manufacturer

34

vsts

5541

string–35

vextsts

5542

string–36

stsext5543

stringExternal module status (FXA520)

37

ctime

5544

timestamp

first 000 command timestamp

Fieldgate Device Parameters (tag.FXA320_test.PRESSURE.param.t1ch)

14No

Tag NameidType

Description

1dch - dch45600 5603

boolean1: Process value in overview, channels 1 - 4: PV,SV, TV and QV

2

p4

5604

float

Output Value at 4.00mA Input Current (internalsensor only)

3

p205605float

Output Value at 20.00mA Input Current (internalsensor only)

4

r

5606

boolean

1: Alarm mail on sensor error

5i - i45607 5610

boolean

1: Alarm mail on leaving limits, channels 1 - 4:
PV, SV, TV and QV

6o - o45611 5614

booleanAlarm mail on returning to limits, channels 1 - 4:
PV, SV, TV and QV

7si - si45615 5618

boolean

1: Send SMS on entering limits (PV)8so - so45619 5622

boolean

1: Send SMS on leaving limits (PV)

9t1ch - t1ch35623 5626

stringAdditional text information line 1, channels 1 - 4:
PV, SV, TV and QVEndress+Hauser

Fieldgate

Fieldgate FXA520/320 OPC Parameter

NoTag Name

idTypeDescription

10t2ch - t2ch45627 5631

stringAdditional text information line 2, channels 1 - 4:
PV, SV, TV and QV

11lo - lo45631 5634

stringLow limit, channels 1 - 4: PV, SV, TV and QV

12ll - ii45635 5638

float

Low Low limit, channels 1 - 4: PV, SV, TV and QV

13hi - hi45639 5643

float

High limit, channels 1 - 4: PV, SV, TV and QV

14hh - hh45643 5646

float

High High limit, channels 1 - 4: PV, SV, TV and QV

15

alt - alt45647 5650

float

Specified limit value for change channels 1-4: PV,SV, TV and QV

16val - val45651 5654

float

last stored value

17max - max45655 5657

float

Max. value reached by process value during
operation, channels 1-4: PV, SV, TV and QV

18

min - min45659 5662

float

Min value reached by process value during
operation, channels 1-4: PV, SV, TV and QV

19hy - hy45663 5666

float

Hysteresis for re-entering limits, channels 1 - 4

20

swl - swl45667 5670

float

Switching level for status display, channels 1 - 4

21

swsts - swsts4

5671 5674

int

Text display switching status, channels 1 - 4: PV,SV, TV and QV

22c5675

string–Note!
• Parameters which are not present in connected Fieldgate are not visible on OPC Server.
• All Parameters are read only.
• If device tag is not present then OPC server uses device id to populate opc tag structure.
• If device tag contains "." (dot) in tag value, OPC server replaces "." with "_" (underscore). I.e.
if device tag value is "4…20mA" then OPC server displays "4___20mA" on OPC Client.

Endress+Hauser

15Advanced OPC Server Configuration

Fieldgate

7

Advanced OPC Server Configuration

7.1

FieldgateOPC.config

Below table describes possible selection of Fieldgate OPC Configuration tag:
XML Tag

Description
OPC Server populates OPC tree based on Tag Structure value• tag – OPC Tag generated with ‘tag’ Text
i.e. tag.<fieldgate_id>.<fieldgate_tag>.param.<parameter>• unid – OPC Tag generated with ‘unid Text
i.e. unid.<fieldgate_serno>.<fielddev_serno>.param.<parameter>

TagStructure

If connection with Fieldgate device is failed then OPC Server try to reconnect Fieldgate
device after Retry interval. Retry interval is in minute.

RetryInterval

Which Time to display on OPC Server• 0 – OPC Server Local Time• 1 – OPC Server UTC Time• 2 – Fieldgate UTC Time• 3 – Fieldgate Local Time (UTC Time + Time zone Offset)

TimeMethod

ScheduleIntervalTime interval to fetch new data from Fieldgate device. Value is in minute

HttpUrl

Fieldgate IP Address or URL complete string
Http connection settings as mentioned below:• 0 – Http connection without proxy and authentication• 1 – Http connection with proxy but without authentication• 2 – Http connection without proxy but with authentication• 3 – Http connection with proxy and authentication

ConnectionType

HttpProxyAddress

Proxy address required only for connection type 1 and 3

HttpProxyPort

Proxy port required only for connection type 1 and 3

UserName

Username required only for connection type 2 and 3

Password

Password required only for connection type 2 and 3

7.2

FIELDGATEOPCLOGGERCONF.xml

Fieldgate OPC Server provides different level of log level to capture variety of messages. OPC
Server supports mainly seven user log level:

16Log Level

Messages captured

FATAL

All Exception and critical messages

ERROR

Error messages and exception messages

WARNING

Warning messages and captures more messages as compare FATAL and ERROR

INFOProvides information messages and captures more messages as compare to above

DEBUG

Provides all debug information

OFFNo user log

ALLCaptures all messages

Endress+Hauser

Fieldgate

Advanced OPC Server Configuration

In normal operation it is not required to change user log level but if OPC server is not working
properly then user can change log level to get more details log information to analyse
problem.

FieldgateOPCServer_FieldgateOPCLoggerConfig-XML

Windows XP:
For windows XP user has to do below changes to enable logger:
1.

DANSrvNet4.exe.config: Change Logger configuration location as mentioned below:

FieldgateOPCServer_FieldgateOPCLoggerConfig-XML_XP

For windows XP user has to do below changes to enable logger:

7.3

Un-Installation

Go to Control Panel → Programs → Uninstall program and select Fieldgate OPC Server.

7.4

Fieldgate OPC Version

Fieldgate OPC Server version can be found from Control Panel → Programs → Uninstall
program as shown in above figure. Here OPC Server version 1.0.0.

Endress+Hauser

1771246575

www.addresses.endress.com