LOYTEC L-INX - 9.1.3.2 Calendar Object; 9.1.3.3 Alarm Objects

L-INX User Manual 202 LOYTEC
Version 4.0 LOYTEC electronics GmbH
 EmbeddedCal (node): This is an optional OPC node. If present, it contains the OPC
tags for the embedded calendar. The embedded calendar structure is as defined for
calendar objects in Section 9.1.3.2.
9.1.3.2 Calendar Object
The device exposes the calendar objects to OPC XML-DA tags. Each calendar object is
represented by a folder in the OPC name space. In that folder, the following OPC tags shall
be available:
 ServiceType (string, Read-only, const): This is a constant tag of type string, which
contains ―calendar‖. It identifies this folder as a calendar folder. This can be used as an
additional identification to the vendor-specific property of the folder tag.
 Calendar (string, read/write): This tag configures the calendar. The data type is string
and the format is in XML. This document contains the calendarCfg element as the root
element.
 Caps (string, read-only): This tag contains the calendar capabilities. The data type is
string and the format is in XML. The XML document contains the
calendarCapabilities element as the root element.
9.1.3.3 Alarm Objects
The alarm objects on the device provide the alarm summary and can be used to
acknowledge alarms. The alarm objects are exposed to XML-DA tags. Each alarm is
uniquely identified by an XML alarm ID (XAID). The XAID must identify the alarm object
and the alarm ID in that object. The XAID is used in the acknowledge service to identify the
alarm. The XAID can also be transmitted in e-mail notifications.
Each alarm object is represented by a folder in the OPC name space. In that folder, the
following OPC tags shall be available:
 ServiceType (string, Read-only, const): This is a constant tag of type string, which
contains ―alarm‖. It identifies this folder as an alarm folder. This can be used as an
additional identification to the vendor-specific property of the folder tag.
 Summary (string, Read-only): Reading from this tag, the current alarm summary can be
obtained. The data type is string and the tag contains an XML document. This tag
should not be subscribed to as it contains a large document. Subscribe to NotifyCnt
instead, to get notified about new alarms. The root element of the XML document is the
alarmSummary element.
 NotifyCnt (unsigned, Read-only): This tag is updated with an incremented notify count
for each alarm update notification. This is the case for new or cleared alarm conditions,
and for acknowledged alarms. Clients can subscribe to this tag in order to be notified
about changes in the alarm summary. The client has then to read the complete alarm
summary when notifications occur.
 NotifyNewCnt (unsigned, Read-only): This tag is updated with an incremented notify
count each time a new alarm appears. This tag does not update when alarms are
acknowledged or go inactive.
 Ack (string, Write): Writing to this tag acknowledges an alarm. The data type is string.
The written data is an XML document, which contains the alarmAck element. The write
must specify the XAID.