N1 OPC Data Access Server Advanced Concepts Technical Bulletin

N1 OPC Data Access Server Advanced Concepts Technical Bulletin
Issue Date
110101
TECHNICAL BULLETIN
Appendix B: N1 OPC Data Access Server
Advanced Concepts
Appendix B: N1 OPC Data Access Server Advanced Concepts ........2
Introduction......................................................................................................... 2
Key Concepts...................................................................................................... 3
N1 OPC Data Access Server Overview ...........................................................................3
N1 OPC DAS Configurator ..............................................................................................3
Multiple Site Access ........................................................................................................4
Dial-up Network Support .................................................................................................4
Password Level Support..................................................................................................5
Dormant Points................................................................................................................5
STATDISP Attribute/Values.............................................................................................6
STATUS (OPC) Attribute/Values .....................................................................................7
N1_STATUS Attribute/Values..........................................................................................7
N1OPC.INI File Parameters ............................................................................................8
Metasys Workstation Connection ..................................................................................14
Connection Restoration .................................................................................................14
Mapping Metasys Points to OPC Item IDs.....................................................................15
OPC Attributes and Points Available to Browse.............................................................17
Localization ...................................................................................................................18
Invalid Item IDs..............................................................................................................19
© 2001 Johnson Controls, Inc.
Code No. LIT-643325
www.johnsoncontrols.com
2
Appendix B: N1 OPC Data Access Server Advanced Concepts
Appendix B: N1 OPC Data Access
Server Advanced Concepts
Introduction
This appendix describes advanced concepts for Appendix A: N1 OPC
Data Access Server Technical Bulletin (LIT-643300).
Appendix B: N1 OPC Data Access Server Advanced Concepts
3
Key Concepts
N1 OPC Data Access Server Overview
The N1 OPC Data Access Server (DAS) provides an interface to the
Metasys facility data in the M-Web and M5 Workstations. The
server has the following characteristics:
•
runs on Windows 98 Second Edition (SE), Windows NT, and
Windows 2000 machines connected via Ethernet (using
Transmission Control Protocol/Internal Protocol [TCP/IP]) to the
Metasys Network running on an Operator Workstation (OWS)
•
runs on the standard Personal Computer (PC) platform described in
the Metasys Installation and Platform Requirements Technical
Bulletin (LIT-12012)
Note:
When deciding whether to use the minimum platform or the
recommended platform, remember that larger tag counts may
require a more powerful machine than smaller tag counts.
•
communicates with and accesses data on up to five Metasys N1
networks simultaneously
•
is Object Linking and Embedding (OLE) for Process Controls
(OPC) compliant and supports multiple OPC clients running on the
local machines in the network with communications port support
The N1 OPC DAS provides interfaces for browsing, reading, and
writing for items accessible through the server. Items reference
networks, systems, objects, and fire and zone point attributes.
N1 OPC DAS Configurator
The N1 OPC DAS Configurator, a tool supplied with the N1 OPC
Data Access server, is used to:
•
define, edit, or delete site configuration data to tell the N1 OPC
server where to get Metasys data.
•
enable or disable existing site connections
•
select on-line or off-line browsing
•
define the timeout period for individual dialup connections
•
generate Permanent Object Lists (POLs) for offline browsing of
Metasys databases and improved performance while online
For information on the N1 OPC DAS Configurator tool, please see
Appendix A: N1 OPC Data Access Server Technical Bulletin
(LIT-643300).
4
Appendix B: N1 OPC Data Access Server Advanced Concepts
Multiple Site Access
The N1 OPC DAS accesses data from multiple N1 networks and
connects to multiple Metasys Networks with different IP addresses.
We recommend accessing a maximum of five networks
simultaneously.
The N1 OPC DAS Configurator lists all the sites and the available
IP addresses for connection to Metasys N1 networks.
Note:
Fixed IP addresses are required.
Dial-up Network Support
The N1 OPC Data Access Server accesses data from Metasys dial-up
networks. Dial-up support enables OPC clients to read, write, and
browse items. This requires two special attributes at the Network level:
•
Connect - a write only attribute, a client writes 1 (to connect) or 0
(to disconnect)
Note:
•
There is an automatic connection option that can be set in the
N1 OPC DAS .ini file. See Table 5 for N1 OPC DAS ini file
parameters.
Status - shows the current status (connected, connecting,
disconnecting, or disconnected) of the network
Once connected, all the clients access the data from the dial-up
Network. The server disconnects if:
•
the number of connects and disconnects made by different clients
are equal
•
an active item is not signed up for that network
•
no data has been read since the last timeout period
The N1 OPC DAS Configurator tool defines the timeout period for
idle dial-up connections.
Appendix B: N1 OPC Data Access Server Advanced Concepts
5
Password Level Support
The N1 OPC Data Access password feature restricts user access rights,
depending on the password.
Browse
Metasys systems are associated with Report/Access Groups (RAGs)
through the Metasys password. Browsing to system level objects is
always available. Object level browsing is restricted by access to each
RAG. For instance, in the M-Graphics OPC tag browser, the user only
views the objects in systems included in one of the accessible RAGs.
Table 1 describes scenarios when RAG (System) = RAG (User). If
these do not match, all items are marked as read only.
Table 1: Password Access Level Description
*
Password Access
Level
Readable Attribute
Writable Attribute
1
Yes
Yes
2
Yes
Yes
3
Yes
Yes
4
Yes
No*
5
Yes
No
Return Readable or Writable attributes if command on attribute is valid for Level 4.
Note:
If the UseOWSPassword parameter in the N1OPC.ini file is
set to 0, the read, write, and browse attributes are available
for all levels (UseOWSPassword = 0).
Dormant Points
If a client does not reference a cached point, it goes into a dormant
state. These items remain dormant for the number of minutes defined
in the N1OPC.INI file. When the time expires, the server removes the
dormant items.
If a client references a dormant point, it becomes active immediately.
The first value the client receives may be old, depending on the
defined dormant rate. The maximum age is controlled by the Dormant
Time parameter. If the attribute value is defined as triggerable to
Metasys, it continues to receive trigger updates, even while dormant.
6
Appendix B: N1 OPC Data Access Server Advanced Concepts
STATDISP Attribute/Values
Table 2 lists the STATDISP attribute/values.
Table 2: STATDISP Attribute/Values
Description
Return Value
ALL_NORMAL_STAT
0
SIGNALS_SILENCED_STAT
1
REPORT_LOCKED_STAT
2
TRIGGER_LOCKED_STAT
3
TROUBLE_STAT
4
LOW_WARNING_STAT
5
HIGH_WARNING_STAT
6
LOW_ALARM_STAT
7
HIGH_ALARM_STAT
8
ALARM_STAT
9
SOFTWARE_OVERRIDE_STAT
10
HARDWARE_OVERRIDE_STAT
11
COMM_DISABLED_STAT
12
HARDWARE_DISABLED_STAT
13
UNRELIABLE_STAT
14
OFFLINE_STAT
15
DISCONCT_STAT
16
XTBUS_ERROR_STAT
17
Appendix B: N1 OPC Data Access Server Advanced Concepts
STATUS (OPC) Attribute/Values
Table 3 lists the STATUS (OPC) attributes/values.
Table 3: STATUS (OPC) Attribute/Values
Description
Return Value
Normal
0
Off-Normal
68
Low Warning
72
High Warning
76
Low Alarm
84
High Alarm
88
Alarm
92
Trouble
192
N1_STATUS Attribute/Values
Table 4 lists the N1_STATUS Attribute/Values.
Table 4: N1_STATUS Attribute/Values
Description
Return Value
Normal
0
Trouble
1
Alarm
2
Low Warning
3
Low Alarm
4
High Warning
5
High Alarm
6
7
8
Appendix B: N1 OPC Data Access Server Advanced Concepts
N1OPC.INI File Parameters
Table 5 lists the N1OPC.INI parameters.
Table 5: N1OPC.ini File Parameters
Parameter
Default
Value
Range
Description
[MRS] Section - MRS/IAPI interface related
ConnectionRestore
1
0 (disabled) or
1 (enabled)
TCP/IP Restore
Connection. If enabled, the
N1 OPC DAS attempts to
restore lost Metasys
Remote Server (MRS)
connections.
FastRetryConnectRate
120 seconds
6 to
600 seconds
N1 OPC DAS attempts to
restore lost MRS
connections at a more
rapid rate immediately after
the connection is lost.
FastRetryConnectTime
30 minutes
1 to
5000 minutes
In order to reduce
performance loss during
long MRS outages,
attempts to restore lost
MRS connection drops
from the
FastRetryConnectRate to
the SlowRetryConnectRate
after this period of time
passes.
SlowRetryConnectRate
30 minutes
1 to
120 minutes
The N1 OPC DAS attempts
to restore long term MRS
connection loss at this
slower rate.
SocketPerSite
2 connections
1 to
10 connections
TCP/IP connections per
Metasys Network at each
site defined
MaxPendMsgNCM
3
1 to 100
Maximum outstanding
MRS/IAPI messages per
Network Control Module
(NCM) - helps to balance
NCM loading and N1 OPC
DAS performance. Larger
numbers can cause more
data request messages to
be loaded to the NCM input
buffers.
MaxTrigMsgNCM
5
1 to 1000
Maximum trigger
signup/cancel messages
per second for one NCM helps to balance NCM
loading and N1 OPC DAS
performance. Larger
numbers can cause more
data request messages to
be loaded to the NCM input
buffers.
Continued on next page . . .
User
Defined
Appendix B: N1 OPC Data Access Server Advanced Concepts
Parameter (Cont.)
Default
Value
Range
Description
MaxPendMsgSocket
6
1 to 200
Maximum outstanding
MRS/IAPI messages per
TCP/IP socket - helps to
balance NCM loading and
N1 OPC DAS performance.
Larger numbers can cause
more data request
messages to be loaded to
the NCM input buffers.
PendingTimeOut
100 seconds
91 to
300 seconds
If an MRS request is not
answered within this time
period, it is presumed to be
lost.
WatchdogTime
0
0 (disabled) or
1 to
100 minutes
If WatchdogTime is
enabled, the MRS closes a
TCP/IP socket opened by
N1 OPC DAS if no traffic is
seen for the specified time.
The N1 OPC DAS
generates traffic, if needed,
to keep the socket active.
RetryErrorItems
1
0 (disabled) or
1 (enabled)
If disabled, an OPC tag is
disabled immediately if the
MRS reports an error on
the tag.
AutoDialConnect
1
0 (disabled) or
1 (enabled)
When enabled, a dial-out
connection is automatically
initiated when data on a
dial network is requested.
This assumes a modem is
available. Thus, it is not
necessary to use the
Connect Network attribute
unless manual dial control
is desired.
UseOWSPassword
1
0 (disabled) or
1 (enabled)
When enabled, Metasys
Password access is
enforced.
[POLLRATES] Section - MRS/IAPI interface poll timing and trigger related
UseTriggerSignup
1
0 (disabled) or
1 (enabled)
When enabled, trigger
sign-up to Metasys is used
to improve performance.
TriggerPollRate
120 seconds
1 to
600 seconds
When Metasys trigger
sign-up is enabled, those
tags can be polled at the
specified slower rate since
the NCM automatically
reports changes as they
occur.
MinPollRate
5 seconds
1 to
600 seconds
Minimum object polling
time. No Metasys object
polling can be faster than
this parameter.
Continued on next page . . .
User
Defined
9
10
Appendix B: N1 OPC Data Access Server Advanced Concepts
Parameter (Cont.)
Default
Value
Range
Description
DefaultPollRate
20 seconds
1 to
600 seconds
Default object polling time
XXXPollRate Object
None (use
default object
polling time)
1 to
600 seconds
Object type XXX polling
time - each object type
polling time can be
individually specified using
the object type string as
part of the value ID. XXX is
the object type name string.
User
Defined
[CLIENT] Section - OPC client related
DefaultScanRate
2 seconds
0.5 to
120 seconds
Default OPC client update
rate
MinScanRate
1 second
0.5 to
120 seconds
Minimum OPC client
update rate, in other words,
the fastest rate allowed.
SendChangedData
1
0 (disabled) or
1 (enabled)
Send only changed data in
periodic update to client. If
disabled, all data is sent at
the OPC client update rate.
This can cause high load
on the computer.
UseNativeDataType
1
1 - Use table
data type for
native data
type, or
0 - use string
for all Native
data types
OPC native data type. If an
OPC client specifies use of
the Native data type for a
tag (not recommended),
this parameter allows
selection between strings
for all native data types or
the type called out in the
Metasys attribute database.
Subset
1
0 (disabled) or
1 (enabled)
If enabled, only a subset of
the total possible attributes
is shown when browsing.
This is to provide a simpler
and cleaner display when
not all possible attributes
are required.
9
Any Valid
Directory
Error messages are logged
in this error.dat file.
9
[LOG] Section - Logging related
ERRORLOG
Continued on next page . . .
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server
11
Appendix B: N1 OPC Data Access Server Advanced Concepts
Parameter (Cont.)
Default
Value
Range
Description
TRACELOG
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server
Any Valid
Directory
Trace messages are
logged in this error.dat file.
Trace messages include
parameter settings at N1
OPC DAS load time and
OPC Writes completed.
ErrorLogMaxSize
500 KB
10 KB to
10,000 KB
Maximum file size for the
error log. Up to two files of
this size are allowed: the
currently active file and the
previously active file.
TraceLogMaxSize
500 KB
10 KB to
10,000 KB
Maximum file size for the
trace log. Up to two files of
this size are allowed: the
currently active file and the
previously active file.
ErrMsgFile
N1OPCmsg.txt
file in the same
directory as
N1OPC.exe
In the same
directory as
N1OPC.exe,
or, full path to
file
Major error string file path.
Used for reporting fatal
errors to the PC screen.
Debug
0
0 (disabled) or
1 (enabled)
When enabled, many
operational details are
logged for possible
troubleshooting.
[DATABASE] Section Database and cache related
PolDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
N1OPCPOL.m
db
PolDBTableName
All Data
CommandDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
n1opcsd.mdb
CommandDBTableName
Command
Continued on next page . . .
Any Valid
Directory
Permanent Object List
database path and file. This
file is initially generated by
the N1 OPC DAS
Configuration Tool, and is
updated by the N1 OPC
DAS.
Permanent object list
database table. If null,
server startup fails.
Any Valid
Directory
Command database file. If
null, server startup fails.
This file is part of the N1
OPC DAS install.
Command database table.
If null, server startup fails.
User
Defined
9
12
Appendix B: N1 OPC Data Access Server Advanced Concepts
Parameter (Cont.)
Default
Value
Range
Description
ObjTypesDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
n1opcsd.mdb
Any Valid
Directory
Object type database file. If
null, server startup fails.
This file is part of the N1
OPC DAS install.
ObjTypesDBTableName
OBJ_TYPE
AttribDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
n1opcsd.mdb
AttribDBTableName
Attribute
SitesDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
n1opcfc.mdb
SitesDBTableName
SiteNamesAnd
IPAddresses
AssocAttrListDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
n1opcsd.mdb
AssocATTRListTableName
AssocAttrList
Continued on next page . . .
Object type database table
Any Valid
Directory
Attribute database file. This
file is part of the N1 OPC
DAS install.
Any Valid
Directory
MRS/IAPI connection
database file. This file is
generated by the N1 OPC
DAS Configuration Tool.
Attribute database table
MRS/IAPI connection
database table
Any Valid
Directory
Associated attributes
database file. This file is
part of the N1 OPC DAS
install. It is used to list
attributes that work
together and are needed as
a group when any are
used.
Associated attributes
database file.
User
Defined
Appendix B: N1 OPC Data Access Server Advanced Concepts
Parameter (Cont.)
Default
Value
Range
Description
CommandListDBFileName
C:\Documents
and Settings\
All Users\
Application
Data\ Johnson
Controls\
M-Data\
N1 OPC DA
Server\
n1opcsd.mdb
Any valid
directory
Command list database
file. This file is part of the
N1 OPC DAS install.
CommandListDBTableName
CommandList
PolSave
1
0 (disabled) or
1 (enabled)
Automatically update
Permanent Object List at
shutdown. When enabled,
the N1 OPC DAS updates
the disk copy of POL with
current NCM binding
information each time it is
shut down. This is
recommended for better
performance.
UpDatePolLimit
5
0 (disabled) to
50000
Automatically add
discovered Metasys objects
to Permanent Object List
during runtime each time
this many new Metasys
objects are found. When
enabled, the N1 OPC DAS
adds newly discovered
Metasys objects to the
POL. This is recommended
if a complete ddl generated
POL is not created.
CleanPol
0
0 (disabled) or
1 (enabled)
Delete unused Permanent
Object List entries when
updated. CleanPol is run
once and reset to 0 when
executed.
IMPORTANT: Use with
care. This can be used
once to clean unused
entries from a POL. When
enabled, the N1 OPC DAS
deletes POL entries that
have never been
referenced by a client from
the disk copy of POL. This
happens when N1 OPC
DAS is shut down. The
parameter is changed to
disable automatically after
this is done.
Continued on next page . . .
Command list database file
13
User
Defined
14
Appendix B: N1 OPC Data Access Server Advanced Concepts
Parameter (Cont.)
Default
Value
Range
Description
MaxActivePoints
0 (unlimited)
0 (unlimited) or
100 to 50000
Active OPC tag limit. This
can be used to limit the
number of Active OPC
tags. Use in cases where
too many active tags cause
performance problems.
When set, reaching the
limit means you must close
some client instances
before opening more.
DormantTIme
10 minutes
0 to
5000 minutes
Dormant Point hold time.
Dormant points are purged
if they are not active for the
set time.
User
Defined
Metasys Workstation Connection
The N1 OPC Data Access Server uses TCP/IP sockets to connect to
the Workstation running Metasys OWS. TCP/IP must be available on
both the machine running the Metasys Workstation software and the
machine running the N1 OPC Data Access server to allow
communication. In addition, fixed IP addresses are required for
communications to work. The Metahost task must be running at the
Metasys OWS to handle the socket.
Connection Restoration
If the connection to the Metasys Workstation software is lost, the
N1 OPC Data Access server restores a lost connection and retries
failed connections if connection restoration is enabled. The connection
may be lost because of a forced disconnect from MRS/IAPI, a reboot
of a remote machine, or a temporary closing of MRS/IAPI application.
For example, if a remote OWS connection is lost because the OWS
was rebooted, the N1 OPC Data Access server attempts to restore the
connection. Connection restoration retries are made at a rate specified
by configurable timers indefinitely. The initial default rate is 2 minutes
and, after a time period set by the user, the rate drops to every 30
minutes.
Appendix B: N1 OPC Data Access Server Advanced Concepts
15
Mapping Metasys Points to OPC Item IDs
All Metasys Point data available to N1 OPC clients are requested by
one of four formats: Object attribute, System attribute, Network
attribute, and Fire and Zone Device attributes.
Object Item IDs
Item IDs for Metasys objects are defined as:
Network\System\Object.Attribute
ItemIDs are defined in the OWS. The N1 OPC Data Access server
changes the following two Metasys attributes to be different from
standard OPC attributes of the same name:
•
Metasys Display to OPC N1_Display
•
Metasys Status to OPC N1_Status
Some objects have pseudo attributes, such as N1_DISPLAY_OV, to
support commands with different priorities. Refer to Appendix A: N1
OPC Data Access Server Technical Bulletin (LIT-643300) for details.
All the Johnson Controls standard OPC attributes (for example,
Description, Display, and Present_Value) are available for each object
when appropriate.
When an attribute is not included in the Item ID, the attribute defaults
to Display. Refer to Appendix A: N1 OPC Data Access Server
Technical Bulletin (LIT-643300) for a list of attributes available for a
given object type.
Network Attribute Item IDs
Item IDs for Metasys Network objects are defined as:
Network.Attribute
The following attributes are available at the Network level:
•
Description - expanded name of the network
•
NetworkType - displays the type of network: N1 Direct, Dialup,
or NC Direct
•
NetworkStatus - displays the network status as text: connected,
offline, connecting, disconnected, or disconnecting
•
ConnectedStatus - displays the network status as a numeric value:
0 Disconnected, 1 Connecting, 2 Authenticating (not used at this
time), 3 Connected (PC controls the connection), 4 Connected
(NCM controls the connection), 5 Disconnecting
•
Connect - (dial-up networks only) controls whether the network is
connected or disconnected (Write only)
16
Appendix B: N1 OPC Data Access Server Advanced Concepts
•
Disconnect - text string “N/A”
•
ConnectedBy - in dial-up networks it shows the connection source
of the dialup connection. In all other cases, it displays as “none”.
•
Timeout - displays the network timeout period defined using the
N1 OPC DAS Configurator tool for each IP address specified. This
number is the auto-disconnect time for dial-up when there is no
activity.
•
STATDISP - displays alarm status as a numeric value: 0 Normal,
9 Alarm, 16 Disconnected
•
N1_Display - same as NetworkStatus
•
Object_Type - text string “Network”
•
Alarm - true if any System under the Network has an alarm
•
Status (OPC) - derived from Alarm. 0= Normal and 92 = Alarm
•
Display - same as NetworkStatus
•
Quality - Numeric code describing communication status as
follows: 192 = Good, Non-specific, indicates everything appears to
be working well; 4 = Bad, Configuration Error, indicates that the
Network does not exist; 8 = Bad, Not Connected, indicates that
either dial-up communications is not connected or IP is down;
24 = Bad, Comm Failure, indicates an MRS/IAPI timeout/error.
Metasys System Attribute Item IDs
Metasys System level attributes have the following data sources:
•
Description - expanded name of the Metasys System
•
ARG - Access Report Group number
•
NCName - name of the Network Controller holding the Metasys
system
•
STATDISP - displays alarm status as a numeric value: 0 Normal,
9 Alarm, 16 Disconnected
•
N1_Display - text string indicating Normal or Alarm
•
Object_Type - text string “System”
•
Alarm - If global alarm indicator in Metasys is red on the system
map, then Alarm = true.
•
Status (OPC) - numeric code, 0 = Normal and 92 = Alarm
•
Display - same as N1_Display
Appendix B: N1 OPC Data Access Server Advanced Concepts
17
•
Group_1, Group_2, and Group_3 - from Permanent Object
Lists. If defined, these groups represent Metasys PC groups
generated by the N1 OPC Configurator from global ddl files.
•
Quality - Numeric code describing communication status as
follows: 192 = Good, Non-specific, indicates everything appears to
be working well; 4 = Bad, Configuration Error, indicates that the
Network does not exist; 8 = Bad, Not Connected, indicates that
either dial-up communications is not connected or IP is down;
24 = Bad, Comm Failure, indicates an MRS/IAPI timeout/error.
Metasys Fire and Zone Device Item IDs
Fire and Zone Device Item IDs are defined as:
Network\System\Object.IorO.#DeviceID.Attribute
I or O is either the character I (Input Device) or O (Output Device).
Device ID is a hexadecimal number found on the Metasys Fire or Zone
Input/Output device summary window.
Only a Metasys Fire or Zone object can access fire points.
An example of an entire tag is:
JCHDQTRS\FIRESYS\PANEL1.I.#1620.Present_Value.
The following read-only attributes are supported:
•
Device_ID - IFC-1010 or -2020 device ID (in hex)
•
Present_Value - 0 = Normal, 1 = Trouble, 2 = Alarm
•
Description - Maximum 20 character IFC point name
•
Loop_Number - IFC loop number this device is connected to
•
Device_Type - D means Device, M means Module
•
Address - IFC-1010 or -2020 address on the loop
•
Analog_Reading - (0-255%) of the Alarm threshold value
OPC Attributes and Points Available to Browse
Browsing attributes for object types are determined by the Subset
parameter in the N1OPC.INI file. If only a subset of frequently used
attributes is needed, the attributes marked as True under the Subset
column in the Attribute table in N1OPCSD.MDB appear in browse.
Most Johnson Controls specific OPC attributes appear in subset
browsing. If the Subset parameter is 0, all possible attributes for an
object type are returned.
Note:
Fire Alarm Device and Zone Device Attributes are not
available to browse. Enter these attributes manually in the
data source field.
18
Appendix B: N1 OPC Data Access Server Advanced Concepts
Localization
The N1 OPC Data Access server uses English strings for:
•
Error logs (These are messages logged to an error file in case of
any errors detected in the execution of the N1 OPC Data Access
Server.)
•
Trace logs (These are messages logged to a Trace file to trace
configuration and all commands/writes executed by OPC writes.)
•
all attribute IDs for the objects
•
all command key words (reserved words) used for attributes of
objects
Note:
•
Keywords, such as Auto and Release, are not translated and,
therefore, must be in English. Non-key words used in
engineering units, such as close and open, can be written in
the local language.
text OPC tags that do not correspond to an engineering unit for an
object must be supplied in English.
For the N1 OPC Data Access Server, all attribute IDs and command
reserved word strings are in English only. Localization of the N1 OPC
DAS is not supported. All localized versions of OWS use the same
version of the N1 OPC DAS.
Strings custom defined for the installation, such as object names, units,
and others, are provided and used as defined by the installer in
whatever language was used. Therefore, if you create custom strings in
the local language, those strings must be referenced in the local
language.
N1 OPC Data Access Server supports decimal point character
variations as defined by the Windows Operating System (for
example, 3.400,89). It also supports accented letters and other
international characters, lower case only, as defined in the ASCII
character set (for example, á, ë, ñ). See Table 6 for a list of valid
characters.
Settings for decimal point characters, time delimiter, date delimiter,
and date style must be the same for each PC used as an N1 OPC
platform or OWS connection point in order to read data consistently.
Locale conversion is not performed between the OWS connection
workstations and the N1 OPC DAS.
Appendix B: N1 OPC Data Access Server Advanced Concepts
19
Table 6: Metasys Characters and Symbols
Symbol
Description
a-z
Lower case letters
A-Z
Upper case letters
0-9
Numbers
à, á, â, ä, å, í, î, ß, ñ, ç, ó, ô, ö, è, é, ê, ë,
ù, ú, û, ü
International characters
&
Ampersand
@
At symbol
{ and }
Braces
^
Caret
$
Dollar
!
Exclamation
-
Hyphen or dash
( and )
Parentheses
%
Percent
#
Pound
~
Tilde
_
Underscore
Invalid Item IDs
N1 OPC Data Access Server logs all invalid items in the N1 OPC
Error Logs.
All invalid items should be corrected or eliminated.
Controls Group
507 E. Michigan Street
P.O. Box 423
Milwaukee, WI 53201
www.johnsoncontrols.com
Printed in U.S.A.
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement