OPC Server Setup
OPC Server Setup
Configure window.
The OPC server is configured in the Configure window with a unique resource ID.
OPC server is downloaded to the Process station.
3BDD012511R0401_Eng_Manual_OPC_Server_F
19
Configure window.
ABB_config_OPC
Select > Start > Programs >ABB Industrial IT > Freelance V9.2 > Configure
20
3BDD012511R0401_Eng_Manual_OPC_Server_F
Select > Start >Programs >ABB Industrial IT > Freelance V9.2> ABB
Configure> OPC- Server Options > New resource ID
New resource ID
Current version of the OPC server is downloaded to the process station with the
unique resource ID.
The Resource ID for the OPC Server is set in Configure. In order to start the OPC
Tunnel the PROG ID for the server has to be configured in ABB OPC Tunnel
Configurator as Freelance2000OPCServer.xxx, where xxx is the Resource ID of
the OPC Server(s)
Select > Start > Programs >ABB Industrial IT > Freelance> OPC Tunnel >
Configurator
ABB OPC Tunnel Configurator appears as an icon in the right bottom side of the
system. ABB OPC Tunnel Configurator provides Restart server to restart the
Server.
3BDD012511R0401_Eng_Manual_OPC_Server_F
21
22
3BDD012511R0401_Eng_Manual_OPC_Server_F
op004us.bmp
Name
Short text
max. 12 characters
Version
3BDD012511R0401_Eng_Manual_OPC_Server_F
23
Port number
Short comment Enter the short comment, see Engineering Manual System
Configuration.
op005us.bmp
Read only
Access
24
3BDD012511R0401_Eng_Manual_OPC_Server_F
op009us.bmp
Network addresses
Within the hardware editor, the stations' IP addresses and resource IDs are
configured under Network. The values specified here must correspond to the
parameters defined during the installation of the OPC server software.
3BDD012511R0401_Eng_Manual_OPC_Server_F
25
In station view (Tag list or Variable list > Station view), the permitted access modes
through a gateway can be defined for each list entry. The station accesses that have
been defined are indicated in the variable list and tag list by single letters:
R
Read
Write
A double-click with the left mouse button in a gateway column or positioning the
cursor in a line and choosing the menu item Edit /Station access... brings up the
dialog for configuring the access rights. The station access for more than one list
entry can be changed at the same time: select more than one entry in the list by
means of Shift + arrow keys before choosing (Station access...) from the menu.
op021us.bmp
Left-hand column
List of all the operator stations and gateway stations that have been
set up; in the variable list only the gateway stations are shown;
26
Read
Write
3BDD012511R0401_Eng_Manual_OPC_Server_F
3BDD012511R0401_Eng_Manual_OPC_Server_F
27
Initiating communication
op050gr.bmp
OPC access
OPC short nameThe parameter is not addressed in the OPC gateway by the
component name in the Name column, but by the name entered
here. This name must be unique within an object.
The components of a Profibus object which are available via an OPC gateway are
defined by means of these dialogs. The gateway station through which this data can
be accessed is configured in the tag list for the object.
Initiating communication
An OPC server is started automatically when requested by an OPC client.
It can be started manually by calling the command window in Windows from the
installation default directory, e.g. c:\Program Files\ABB
IndustrialIT\Freelance\Control Builder F\EXE\... :
OPCSRV.EXE /xx
xx = assign resource ID no., e.g. 45 as in Setup
28
3BDD012511R0401_Eng_Manual_OPC_Server_F
When an OPC server has started, the following icon appears in the Windows
taskbar:
op010us.bmp
TIC123/Wi
The component and parameter names of the user-defined function blocks can be
found in the class definition of the block. All the elements of the block interface that
reside in the process station can be accessed through the OPC server.
3BDD012511R0401_Eng_Manual_OPC_Server_F
29
The component names of the Profibus objects can be modified, see Enabling
Profibus parameters for OPC access on page 27. The current names can be found in
the associated configuration dialogs.
The OPC interface is case-sensitive. The variable names must therefore be
identical in OPC and in the Control Builder F project.
30
Data type in
Control Builder F/
Freelance
up to V5
up to V5
BOOL
VT_BOOL
Boolean
BYTE
VT_UI1
Byte
WORD
VT_I2
VT_UI2
Integer
Long
UINT
VT_I2
VT_UI2
Integer
Long
INT
VT_I2
DWORD
VT_I4
VT_UI4
Long
Single
UDINT
VT_I4
VT_UI4
Long
Single
since V6
since V6
Integer
3BDD012511R0401_Eng_Manual_OPC_Server_F
Data type in
Control Builder F/
Freelance
up to V5
up to V5
DINT
VT_I4
Long
REAL
VT_R4
Single
TIME
VT_I4
Long
DT
VT_DATE
Date
STRING8.. STRING256
VT_BSTR
String
since V6
since V6
The AC 800 F, AC 700F, Freelance data types are described in the Engineering
Manual IEC 61131-3 Programming, Variables, Overview of Data Types.
Data requests with a specific data type (requested data type) were always accepted
in versions up to 6.1 as long as it was in principle possible to convert the AC 800 F
/AC 700F, Freelance data type into the requested data type. If it was ascertained
during this process that one or more values lay outside the range of valid values,
then the value concerned was sent out with the attribute Bad Quality.
In version V6.2 and later versions, only data types in which it is always possible to
perform a conversion are accepted. The possible combinations are shown in the
table below:
Conversion is possible to VT_xx
DAT
E
UI2
UI4
I1
I2
I4
R4
R8
BOOL
BYTE
WORD
UINT
INT
DWORD
X
X
3BDD012511R0401_Eng_Manual_OPC_Server_F
BSTR
31
DINT
REAL
TIME
DT
UI2
UI4
I1
I2
I4
STRINGx
DAT
E
R4
R8
X
X
BSTR
X
X
The system response with regard to the data type conversion requested can be set in
the registry:
[HKEY_LOCAL_MACHINE\SOFTWARE\Hartmann & Braun\Freelance
\OPCServer]
With the setting OptimisticDataConversion = 1 the OPC Server behaves as in
the earlier versions.
With the setting OptimisticDataConversion = 0 (Default setting from version
6.2) the more restrictive form of data conversion is implemented.
32
3BDD012511R0401_Eng_Manual_OPC_Server_F
The priorities of the AC 800 F / Freelance messages are mapped to the following
severity values:
AC 800 F / Freelance
Prio
Type
OPC
Severity
System S1
900
System S2
500
System S3
100
Fault
1000
Fault
800
Fault
600
Switch
400
Hint
200
3BDD012511R0401_Eng_Manual_OPC_Server_F
33
The system messages are transmitted in the language in which the OPC server was
installed. All other text, e.g. conditions and subconditions, are available only in
English.
Depending on the message category, various attributes of the OPC message are
supplied with current data from the AC 800 F / Freelance system.
RateOfChange
Category
Hint
Hint text
VT_BSTR
WaveFile
WAV file
VT_BSTR
LongText
Long text
ShortText
Short text
VT_BSTR
CV
Current value
VT_VARIANT X
Dimension
Dimension
VT_BSTR
AcknowledgeRule
Acknowledgement
rule
VT_BSTR
ResourceID
Resource ID
VT_I2
ObjectNumber
Object number
VT_I2
AlarmIndex
Index of message
point
VT_I2
VT_BSTR
ConditionSubType
ErrorString
34
Error text
VT_BSTR
System
Limit
VT_BSTR
User
System area
Discrete
Area
Duration
Data type
Deviation
Description
Level
Attribute
3BDD012511R0401_Eng_Manual_OPC_Server_F
RateOfChange
Category
VT_BSTR
System
X
Limit
VT_I4
User
Error number
Discrete
ErrorCode
Duration
Data type
Deviation
Description
Level
Attribute
3BDD012511R0401_Eng_Manual_OPC_Server_F
35
op025us.bmp
VersionControlDepthRead / Write
Specifies the differences between process stations and gateway
stations that produce a version error.
0: No version control,
1: Project names are checked,
2: Project names + MajorVersionNo are checked,
3: Project names + MajorVersionNo + MinorVersionNo are
checked,
4: Project names + MajorVersionNo + MinorVersionNo +
PatchVersionNo are checked.
The default value is 3, i.e. the name, MajorVersionNo and
MinorVersion-No of the project must be identical on the process
station and the gateway in order to avoid having a version error
reported when a variable is accessed.
VersionReadFlag / WriteFlag
Defines the response when a version error is detected (corresponds
to the VersionControlDepth setting).
36
3BDD012511R0401_Eng_Manual_OPC_Server_F
Condition:
<Name of PS in P-tree>_CONNECTION_STATE_0
ESTABLISHING_CONNECTIO
N
PROJECT_VERSION_ERROR
3BDD012511R0401_Eng_Manual_OPC_Server_F
37
MAJOR_VERSION_ERROR
MINOR_VERSION_ERROR
Condition :
<Name of PS in P-tree>_READ_WRITE_STATE_1
NO_WRITE_ACCESS
NO_ACCESS
Condition :
OPC_SERVER_OFFLINE
38
3BDD012511R0401_Eng_Manual_OPC_Server_F
[HKEY_LOCAL_MACHINE\SOFTWARE\Hartmann &
Braun\Freelance\OPCServer]
RedToggleQualityGood = 0 Disconnection is reported immediately,
RedToggleQualityGood = 1 Disconnection is only reported after a timeout
(default setting)
The length of the timeout can likewise be set in the registry:
[HKEY_LOCAL_MACHINE\SOFTWARE\Hartmann &
Braun\Freelance\OPCServer]
RedToggleTimeOut Value in seconds (default setting = 4)
op010gr.bmp
A dialog for monitoring the various sequences of the OPC server can be started in
the context menu of this entry. The trace dialog is invoked by means of Trace...
from the context menu or from the start menu via ... / Control Builder F / OPC
Server / OPC Server Trace:
3BDD012511R0401_Eng_Manual_OPC_Server_F
39
op500gr.bmp
OPC Server
Computer name, Res-ID
The linked OPC server is described by means of the two entries.
The two fields can be edited after actuation of the Disconnect
button. A connection to the registered OPC server is established by
means of the Connect button.
Keyword trace
The various functions of the OPC server can be hierarchically
selected in the left-hand half of the dialog. Depending on the entries
selected, the respective function calls in the OPC server are
recorded together with the current parameters.
As a result, it is possible to track specifically defined functions or
functional groups of the OPC server. See Appendix C, OPC
Keyword Tracing.
Trace level
Trace file
Path
40
3BDD012511R0401_Eng_Manual_OPC_Server_F
Size [KByte]
The maximum size of the trace file in KBytes.
If the size of the trace file reaches maximum, the file is renamed
opc<Res-ID>.bak and a new opc<Res-ID>.trc file is created.
Apply Settings The settings for directory and size of the trace file are transferred.
Show File
Clear File
The current trace file is deleted. the *.bak file is not affected by this
action.
Server dump
Dump Configuration
All the configuration data of the OPC server is written to the trace
file.
The entries are marked with the text Dumping configuration
data... and ...configuration dump finished.
Dump Connections
An entry is generated in the trace file for all active connections.
The entries are marked with the text Dumping server objects... and
...server object dump finished.
Dump Groups
An entry is generated in the trace file for all installed groups of the
OPC server.
The entries are marked with the text Dumping group objects... and
...group object dump finished.
Save Settings All settings of the dialog are stored and preset on the start of a new
trace dialog or restart of the OPC server.
Example of a trace file
3BDD012511R0401_Eng_Manual_OPC_Server_F
41
op028gr.bmp
42
3BDD012511R0401_Eng_Manual_OPC_Server_F
op402us.bmp
Chart display
Once the data sources have been defined, the current values are displayed in a chart.
The display parameters can be set in the Properties the performance monitor
dialog.
3BDD012511R0401_Eng_Manual_OPC_Server_F
43
General variables
Name
Description
% Communication buffers
Communication buffers
% Connections
Connections
% DMS-Handles
DMS-Handles
% SEG-Handles
SEG-Handles
Process-ID
Station-Number
OPC variables
44
Name
Description
Item No
Event No
3BDD012511R0401_Eng_Manual_OPC_Server_F
Name
Description
Client connections
Groups
Active items
Pending jobs
Acyclic reads/second
Acyclic writes/second
3BDD012511R0401_Eng_Manual_OPC_Server_F
45